@xyo-network/xl1-protocol-sdk 3.0.0 → 3.0.1

package/dist/neutral/CreatableProvider/CreatableProvider.d.ts

@@ -1,6 +1,10 @@
 import type { Creatable, CreatableInstance, CreatableParams, EventData, Labels, WithOptionalLabels } from '@xylabs/sdk-js';
 import type { Provider, ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { Surface } from '../capabilities/Backing.ts';
+import type { TransportKind } from '../config/transports/Transport.ts';
 import type { CreatableProviderContext } from '../model/index.ts';
+/** Connection kinds declared on creatable provider statics (transports plus wallet). */
+export type CreatableProviderConnectionType = TransportKind | 'wallet';
 import type { GetInstanceOptions } from './GetInstanceOptions.ts';
 import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts';
 /** Parameters for CreatableProvider. */
@@ -18,6 +22,7 @@ export type CreatableProviderInstance<TProvider extends Provider<ProviderMoniker
 export type ProviderFactoryScope = 'global' | 'context' | 'local';
 /** CreatableProviderFactory interface. */
 export interface CreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends Omit<CreatableProvider<T>, 'create' | 'createHandler' | 'paramsHandler'> {
+    readonly connectionTypes?: readonly CreatableProviderConnectionType[];
     creatableProvider: CreatableProvider<T>;
     defaultParams: Omit<T['params'], 'context'>;
     readonly dependencies: TDependencies;
@@ -25,6 +30,7 @@ export interface CreatableProviderFactory<T extends CreatableProviderInstance =
     providerName: string;
     resolvedMoniker: string;
     scope: ProviderFactoryScope;
+    readonly surface?: Surface;
     uniqueId: symbol;
     getInstance(this: CreatableProviderFactory<T>, params: T['params'], options?: GetInstanceOptions): Promise<T>;
     tryGetInstance(this: CreatableProviderFactory<T>, params: T['params'], options?: GetInstanceOptions): Promise<T | undefined>;
@@ -37,9 +43,11 @@ export interface LabeledCreatableProvider<T extends CreatableProviderInstance =
 export type ProviderMap<T extends ProviderMoniker = ProviderMoniker> = Partial<Record<T, CreatableProviderInstance<Provider<T>>>>;
 /** CreatableProvider interface. */
 export interface CreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends Creatable<T> {
+    readonly connectionTypes?: readonly CreatableProviderConnectionType[];
     readonly defaultMoniker: ProviderMoniker;
     readonly dependencies: TDependencies;
     readonly monikers: ProviderMoniker[];
+    readonly surface?: Surface;
     factory(dependencies: TDependencies, params: Omit<T['params'], 'context'>): CreatableProviderFactory<T>;
 }
 /**

package/dist/neutral/CreatableProvider/CreatableProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreatableProvider.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/CreatableProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CreatableProvider.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/CreatableProvider.ts"],"names":[],"mappings":"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"}

package/dist/neutral/capabilities/Provider.d.ts

@@ -1,56 +1,31 @@
 import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
-import type { TransportKind } from '../config/transports/Transport.ts';
-import type { CreatableProviderFactory } from '../CreatableProvider/index.ts';
+import type { CreatableProvider, CreatableProviderConnectionType } from '../CreatableProvider/CreatableProvider.ts';
 import type { Surface } from './Backing.ts';
-import type { CapabilityRegistryInstance } from './Capability.ts';
 /**
- * Sidecar metadata for a `CreatableProviderFactory`-producing class. Tells the
- * resolver which capability the provider satisfies, which connections it can use,
- * and how to construct the factory at plan time.
+ * Plan-time candidate for provider resolution (used by `resolveProviders`).
  *
- * Descriptors are deliberately separated from the provider classes themselves
- * so the SDK packages stay un-coupled to the descriptor system — descriptors
- * live alongside the consumer that picks them.
+ * Metadata (`connectionTypes`, `dependencies`, `surface`, `satisfies`) is
+ * derived from `CreatableProvider` class statics via `providerCandidateFromClass`.
+ * Selection is config-only: `providerBindings` + `connections` type matching.
  */
-export interface ProviderDescriptor<TCtx extends ResolutionContext = ResolutionContext> {
+export interface ProviderDescriptor {
     /**
-     * Connection kinds this descriptor can use (e.g. `lmdb`, `rpc`). Empty array
+     * Connection kinds this candidate supports (e.g. `lmdb`, `rpc`). Empty array
      * means wildcard — matches any bound connection type.
      */
-    readonly connectionTypes: readonly TransportKind[];
+    readonly connectionTypes: readonly CreatableProviderConnectionType[];
+    /** Implementation class selected when this candidate wins. */
+    readonly creatableProvider: CreatableProvider;
     /**
      * Monikers this provider resolves at register/create time. Drives plan-time
      * transitive closure and topological ordering.
      */
     readonly dependencies?: readonly ProviderMoniker[];
-    /** Globally-unique key, usually `<className>` — used in snapshots and diagnostics. */
+    /** Globally-unique key, usually the class name — used in snapshots and diagnostics. */
     readonly id: string;
-    /** Capabilities this provider satisfies (typically one moniker, occasionally several). */
+    /** Capabilities this candidate satisfies (typically `monikers` from the class). */
     readonly satisfies: readonly ProviderMoniker[];
-    /**
-     * Which API surface this descriptor's capability is exposed under. Mirrors
-     * the corresponding `Capability.surface`; declared on the descriptor too so
-     * the resolver can filter candidates by surface without a registry lookup.
-     */
+    /** Which API surface this capability is exposed under. */
     readonly surface: Surface;
-    /**
-     * Build the factory args from the resolution context. Returning undefined
-     * signals "skip me at runtime" (preconditions said yes, but a missing optional
-     * resource was discovered during the build).
-     */
-    build(ctx: TCtx): CreatableProviderFactory | undefined;
-    /**
-     * Returns true iff the provider can be constructed in this process given `ctx`.
-     * Pure & sync — must not read DB or do I/O.
-     */
-    preconditions(ctx: TCtx): boolean;
-}
-/**
- * Inputs the resolver hands to descriptors. `capabilities` is the registry
- * the resolver may consult for diagnostics. Subtypes may extend this with
- * live runtime resources that descriptors need at `build()` time.
- */
-export interface ResolutionContext {
-    readonly capabilities: CapabilityRegistryInstance;
 }
 //# sourceMappingURL=Provider.d.ts.map

package/dist/neutral/capabilities/Provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/capabilities/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAEjE;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,iBAAiB,GAAG,iBAAiB;IACpF;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAA;IAClD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAClD,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,wBAAwB,GAAG,SAAS,CAAA;IACtD;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAA;CAClD"}
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/capabilities/Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAA;AACnH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,+BAA+B,EAAE,CAAA;IACpE,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAClD,uFAAuF;IACvF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B"}

package/dist/neutral/capabilities/connectionTypes.d.ts

@@ -1,9 +1,10 @@
 import type { TransportKind } from '../config/transports/Transport.ts';
+import type { CreatableProviderConnectionType } from '../CreatableProvider/CreatableProvider.ts';
 import type { ProviderDescriptor } from './Provider.ts';
 /**
  * Connection types a descriptor supports. An empty array is a wildcard: the
  * descriptor matches any bound connection type (used by in-process memory stubs).
  */
-export declare function descriptorConnectionTypes(descriptor: Pick<ProviderDescriptor, 'connectionTypes'>): readonly TransportKind[];
+export declare function descriptorConnectionTypes(descriptor: Pick<ProviderDescriptor, 'connectionTypes'>): readonly CreatableProviderConnectionType[];
 export declare function descriptorMatchesConnectionType(descriptor: Pick<ProviderDescriptor, 'connectionTypes'>, connectionType: TransportKind): boolean;
 //# sourceMappingURL=connectionTypes.d.ts.map

package/dist/neutral/capabilities/connectionTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectionTypes.d.ts","sourceRoot":"","sources":["../../../src/capabilities/connectionTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACtD,SAAS,aAAa,EAAE,CAE1B;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EACvD,cAAc,EAAE,aAAa,GAC5B,OAAO,CAMT"}
+{"version":3,"file":"connectionTypes.d.ts","sourceRoot":"","sources":["../../../src/capabilities/connectionTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAA;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,GACtD,SAAS,+BAA+B,EAAE,CAE5C;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EACvD,cAAc,EAAE,aAAa,GAC5B,OAAO,CAMT"}

package/dist/neutral/capabilities/index.d.ts

@@ -3,7 +3,10 @@ export * from './Capability.ts';
 export * from './connectionSubsetBySurface.ts';
 export * from './connectionTypes.ts';
 export * from './factoryBrand.ts';
+export * from './locatorFromConfig.ts';
+export * from './needsFromProviderBindings.ts';
 export * from './Provider.ts';
+export * from './providerCandidateFromClass.ts';
 export * from './resolveProviders.ts';
 export * from './surfaceMap.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/capabilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,eAAe,CAAA;AAC7B,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/neutral/capabilities/locatorFromConfig.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
+import type { Config } from '../config/index.ts';
+import { ProviderFactoryLocator } from '../CreatableProvider/ProviderFactoryLocator.ts';
+import type { CreatableProviderContext } from '../model/index.ts';
+import type { ProviderDescriptor } from './Provider.ts';
+import { type ResolutionPlan } from './resolveProviders.ts';
+/** Options for building a locator from config-driven provider resolution. */
+export interface LocatorFromConfigOptions {
+    readonly candidates: readonly ProviderDescriptor[];
+    readonly config: Config;
+    readonly context?: Omit<CreatableProviderContext, 'config' | 'locator'>;
+    readonly needs: ReadonlySet<ProviderMoniker>;
+}
+/**
+ * Resolves which provider classes to register for the given config bindings.
+ * Selection uses only `providerBindings` + `connections` — no runtime preconditions.
+ */
+export declare function resolveProvidersFromConfig(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], config: Config): ResolutionPlan;
+/**
+ * Registers factories for a resolution plan. Params are empty — implementations
+ * are expected to read their bound connection from `context.config` at runtime.
+ */
+export declare function registerFactoriesFromPlan(locator: ProviderFactoryLocator, plan: ResolutionPlan): void;
+/**
+ * Builds a `ProviderFactoryLocator` from config: resolve candidates, then register
+ * winning factories. Connection profiles come from config, not factory params.
+ */
+export declare function locatorFromConfig(options: LocatorFromConfigOptions): ProviderFactoryLocator;
+//# sourceMappingURL=locatorFromConfig.d.ts.map

package/dist/neutral/capabilities/locatorFromConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorFromConfig.d.ts","sourceRoot":"","sources":["../../../src/capabilities/locatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAA;AACvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,KAAK,cAAc,EAAoB,MAAM,uBAAuB,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;CAC7C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,MAAM,EAAE,MAAM,GACb,cAAc,CAMhB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,cAAc,GACnB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,sBAAsB,CAWxB"}

package/dist/neutral/capabilities/needsFromProviderBindings.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
+import type { Config } from '../config/Config.ts';
+import type { TransportKind } from '../config/transports/Transport.ts';
+/** Derives resolution needs from every moniker declared in `providerBindings`. */
+export declare function needsFromProviderBindings(config: Pick<Config, 'providerBindings'>): ReadonlySet<ProviderMoniker>;
+/** Derives needs for monikers whose bound connection matches one of the given types. */
+export declare function needsFromConnectionTypes(config: Pick<Config, 'connections' | 'providerBindings'>, connectionTypes: readonly TransportKind[]): ReadonlySet<ProviderMoniker>;
+//# sourceMappingURL=needsFromProviderBindings.d.ts.map

package/dist/neutral/capabilities/needsFromProviderBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"needsFromProviderBindings.d.ts","sourceRoot":"","sources":["../../../src/capabilities/needsFromProviderBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAEtE,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACvC,WAAW,CAAC,eAAe,CAAC,CAE9B;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC,EACxD,eAAe,EAAE,SAAS,aAAa,EAAE,GACxC,WAAW,CAAC,eAAe,CAAC,CAiB9B"}

package/dist/neutral/capabilities/providerCandidateFromClass.d.ts

@@ -0,0 +1,7 @@
+import type { CreatableProvider } from '../CreatableProvider/CreatableProvider.ts';
+import type { ProviderDescriptor } from './Provider.ts';
+/** Derives a resolution candidate from a `CreatableProvider` implementation class. */
+export declare function providerCandidateFromClass(creatableProvider: CreatableProvider, id?: string): ProviderDescriptor;
+/** Derives resolution candidates from a list of provider implementation classes. */
+export declare function providerCandidatesFromClasses(creatableProviders: readonly CreatableProvider[]): ProviderDescriptor[];
+//# sourceMappingURL=providerCandidateFromClass.d.ts.map

package/dist/neutral/capabilities/providerCandidateFromClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCandidateFromClass.d.ts","sourceRoot":"","sources":["../../../src/capabilities/providerCandidateFromClass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,iBAAiB,EACpC,EAAE,GAAE,MAA+B,GAClC,kBAAkB,CASpB;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,GAC/C,kBAAkB,EAAE,CAEtB"}

package/dist/neutral/capabilities/resolveProviders.d.ts

@@ -1,6 +1,6 @@
 import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
 import type { TransportConfig } from '../config/transports/Transport.ts';
-import type { ProviderDescriptor, ResolutionContext } from './Provider.ts';
+import type { ProviderDescriptor } from './Provider.ts';
 export interface ResolutionPlan {
     /** Capability moniker -> winning descriptor id (for snapshot diffing). */
     readonly bindings: Readonly<Record<ProviderMoniker, string>>;
@@ -45,10 +45,10 @@ export interface ResolveProvidersOptions {
  *
  * 1. Fixpoint-expand monikers from selected descriptor `dependencies`.
  * 2. Require `providerBindings[moniker].connection` for every moniker.
- * 3. Filter candidates by bound connection type and `preconditions(ctx)`.
+ * 3. Filter candidates by bound connection type.
  * 4. Throw when zero or multiple candidates remain.
  * 5. Toposort selected descriptors using `dependencies`.
  */
-export declare function resolveProviders<TCtx extends ResolutionContext>(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor<TCtx>[], ctx: TCtx, options?: ResolveProvidersOptions): ResolutionPlan;
+export declare function resolveProviders(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], options?: ResolveProvidersOptions): ResolutionPlan;
 export {};
 //# sourceMappingURL=resolveProviders.d.ts.map

package/dist/neutral/capabilities/resolveProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../src/capabilities/resolveProviders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,mCAAmC,CAAA;AAEvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAE1E,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;gBAEvB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CAOjE;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE;CAShF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe;CAKrC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM;CAQ7D;AAED,UAAU,mBAAmB;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAC5F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC/C,GAAG,EAAE,IAAI,EACT,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAwBhB"}
+{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../src/capabilities/resolveProviders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,mCAAmC,CAAA;AAEvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;gBAEvB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CAOjE;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE;CAShF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe;CAKrC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM;CAQ7D;AAED,UAAU,mBAAmB;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAC5F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAsBhB"}

package/dist/neutral/config/adaptLegacyConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptLegacyConfig.d.ts","sourceRoot":"","sources":["../../../src/config/adaptLegacyConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAwJnD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CA+CrE"}
+{"version":3,"file":"adaptLegacyConfig.d.ts","sourceRoot":"","sources":["../../../src/config/adaptLegacyConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAmLnD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CA+CrE"}