@fougere/container 0.6.0-alpha.0 → 0.7.0-alpha.0

package/dist/container.d.ts

@@ -6,42 +6,16 @@ export type Constructor<T = unknown> = new (...args: any[]) => T;
  * Registration options.
  */
 export interface RegisterOptions {
-    /**
-     * Lifetime of the resolved value. Default: 'transient'.
-     *
-     * Two words, because two are used: `Config` is a singleton, every handler,
-     * presenter, collector and provider is transient — a fresh instance per
-     * resolution, which is what keeps one call's state out of the next. A third,
-     * `'scoped'`, was declared and never passed by any caller: {@link Container.createScope}
-     * already answers "one instance per frond, per surface", and two mechanisms for
-     * one need is one too many.
-     */
+    /** Lifetime of the resolved value. */
     lifetime?: 'singleton' | 'transient';
     /** Dependency type names for type-based resolution (from AST scan). */
     deps?: string[];
 }
-/**
- * Anything holding a resource can say so, and disposing the container says it back.
- *
- * Not an interface a class implements — a shape a class happens to have. A handler
- * that opens nothing declares nothing.
- */
+/** Anything holding a resource can say so, and disposing the container says it back. */
 export interface Disposable {
     dispose(): void | Promise<void>;
 }
-/**
- * DI container interface — the only thing application code sees.
- *
- * It is deliberately small, and the reason is that the scan already knows the graph:
- * every class and every dependency is read from source before boot, so there is
- * almost nothing left to bind late. What remains is a Map with a parent chain, plus
- * the two gestures the scan cannot cover — {@link createScope} for isolation, and
- * {@link setFallback} for a frond that lives in another process.
- *
- * Resolution is by name, and the names are TYPE names produced by the AST scan.
- * The container never sees a type; "DI by type" is realized upstream, in the
- * scanner, which is why this file mentions neither.
- */
+/** DI container interface — the only thing application code sees. */
 export interface Container {
     /** Register a class by name. Its `deps` are resolved from this container. */
     register<T>(name: string, ctor: Constructor<T>, options?: RegisterOptions): void;
@@ -51,33 +25,11 @@ export interface Container {
     resolve<T>(name: string): T;
     /** Check if a name is registered (including parent scopes). */
     has(name: string): boolean;
-    /**
-     * A resolver of last resort, consulted when no scope holds the name.
-     *
-     * It exists for one reason: a frond declared in `remotes` registers nothing locally,
-     * so its façade cannot be *found* — it has to be fabricated. Set on the root, inherited
-     * by every scope. Returning `undefined` means "I don't know either", and the miss
-     * throws as before.
-     *
-     * Optional: a container without one behaves exactly as it did.
-     */
+    /** A resolver of last resort, consulted when no scope holds the name. */
     setFallback?(resolve: (name: string) => unknown): void;
     /** Create a child scope. Inherits parent registrations. */
     createScope(): Container;
-    /**
-     * Dispose the container: every instance it KEPT — the singletons — that has a
-     * `dispose` method is told, most recent first, and awaited. A failure does not
-     * silence the rest; they travel out together in an `AggregateError`.
-     *
-     * This used to clear the registry and nothing else, while the doc above it promised
-     * disposal — so `await using app` (which routes here through `app[Symbol.asyncDispose]`)
-     * announced a cleanup that never happened. A container that holds instances is the
-     * only thing that knows they exist; if it stays silent, nobody else can speak.
-     *
-     * What it does NOT dispose: a transient, handed over and forgotten in the same
-     * breath, whose caller is the one who knows when it is done; and a value passed to
-     * {@link registerValue}, which the container did not build.
-     */
+    /** Dispose the container. */
     dispose(): Promise<void>;
 }
 //# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACrC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAEjF,0CAA0C;IAC1C,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/C,oCAAoC;IACpC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAE5B,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B;;;;;;;;;OASG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAEvD,2DAA2D;IAC3D,WAAW,IAAI,SAAS,CAAC;IAEzB;;;;;;;;;;;;;OAaG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACrC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAEjF,0CAA0C;IAC1C,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/C,oCAAoC;IACpC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAE5B,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B,yEAAyE;IACzE,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAEvD,2DAA2D;IAC3D,WAAW,IAAI,SAAS,CAAC;IAEzB,6BAA6B;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/container",
-  "version": "0.6.0-alpha.0",
+  "version": "0.7.0-alpha.0",
   "description": "Fougere's DI container: resolution by type, wired from the AST scan. Zero dependencies.",
   "keywords": [
     "fougere",

package/src/container.ts

@@ -8,44 +8,18 @@ export type Constructor<T = unknown> = new (...args: any[]) => T;
  * Registration options.
  */
 export interface RegisterOptions {
-  /**
-   * Lifetime of the resolved value. Default: 'transient'.
-   *
-   * Two words, because two are used: `Config` is a singleton, every handler,
-   * presenter, collector and provider is transient — a fresh instance per
-   * resolution, which is what keeps one call's state out of the next. A third,
-   * `'scoped'`, was declared and never passed by any caller: {@link Container.createScope}
-   * already answers "one instance per frond, per surface", and two mechanisms for
-   * one need is one too many.
-   */
+  /** Lifetime of the resolved value. */
   lifetime?: 'singleton' | 'transient';
   /** Dependency type names for type-based resolution (from AST scan). */
   deps?: string[];
 }
 
-/**
- * Anything holding a resource can say so, and disposing the container says it back.
- *
- * Not an interface a class implements — a shape a class happens to have. A handler
- * that opens nothing declares nothing.
- */
+/** Anything holding a resource can say so, and disposing the container says it back. */
 export interface Disposable {
   dispose(): void | Promise<void>;
 }
 
-/**
- * DI container interface — the only thing application code sees.
- *
- * It is deliberately small, and the reason is that the scan already knows the graph:
- * every class and every dependency is read from source before boot, so there is
- * almost nothing left to bind late. What remains is a Map with a parent chain, plus
- * the two gestures the scan cannot cover — {@link createScope} for isolation, and
- * {@link setFallback} for a frond that lives in another process.
- *
- * Resolution is by name, and the names are TYPE names produced by the AST scan.
- * The container never sees a type; "DI by type" is realized upstream, in the
- * scanner, which is why this file mentions neither.
- */
+/** DI container interface — the only thing application code sees. */
 export interface Container {
   /** Register a class by name. Its `deps` are resolved from this container. */
   register<T>(name: string, ctor: Constructor<T>, options?: RegisterOptions): void;
@@ -59,34 +33,12 @@ export interface Container {
   /** Check if a name is registered (including parent scopes). */
   has(name: string): boolean;
 
-  /**
-   * A resolver of last resort, consulted when no scope holds the name.
-   *
-   * It exists for one reason: a frond declared in `remotes` registers nothing locally,
-   * so its façade cannot be *found* — it has to be fabricated. Set on the root, inherited
-   * by every scope. Returning `undefined` means "I don't know either", and the miss
-   * throws as before.
-   *
-   * Optional: a container without one behaves exactly as it did.
-   */
+  /** A resolver of last resort, consulted when no scope holds the name. */
   setFallback?(resolve: (name: string) => unknown): void;
 
   /** Create a child scope. Inherits parent registrations. */
   createScope(): Container;
 
-  /**
-   * Dispose the container: every instance it KEPT — the singletons — that has a
-   * `dispose` method is told, most recent first, and awaited. A failure does not
-   * silence the rest; they travel out together in an `AggregateError`.
-   *
-   * This used to clear the registry and nothing else, while the doc above it promised
-   * disposal — so `await using app` (which routes here through `app[Symbol.asyncDispose]`)
-   * announced a cleanup that never happened. A container that holds instances is the
-   * only thing that knows they exist; if it stays silent, nobody else can speak.
-   *
-   * What it does NOT dispose: a transient, handed over and forgotten in the same
-   * breath, whose caller is the one who knows when it is done; and a value passed to
-   * {@link registerValue}, which the container did not build.
-   */
+  /** Dispose the container. */
   dispose(): Promise<void>;
 }