@codefast/di 0.7.0 → 0.7.1

package/dist/resolution/select/constraints.d.ts

@@ -2,34 +2,50 @@ import type { BindingTag } from "#/core/tag";
 import type { Token } from "#/core/token";
 import type { BindingConstraint, Constructor } from "#/core/types";
 /**
+ * Matches when the direct parent frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenParentIs(token: Token<unknown> | Constructor): BindingConstraint;
 /**
+ * Matches when there is no direct parent frame, or it resolves a different token.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenNoParentIs(token: Token<unknown> | Constructor): BindingConstraint;
 /**
+ * Matches when at least one ancestor frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenAnyAncestorIs(token: Token<unknown> | Constructor): BindingConstraint;
 /**
+ * Matches when no ancestor frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenNoAncestorIs(token: Token<unknown> | Constructor): BindingConstraint;
 /**
+ * Matches when the direct parent slot carries the given name.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenParentNamed(name: string): BindingConstraint;
 /**
+ * Matches when at least one ancestor slot carries the given name.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenAnyAncestorNamed(name: string): BindingConstraint;
 /**
+ * Matches when the direct parent slot carries the given tag pair.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenParentTagged(criterion: BindingTag): BindingConstraint;
 /**
+ * Matches when at least one ancestor slot carries the given tag pair.
+ *
  * @since 0.3.16-canary.0
  */
 export declare function whenAnyAncestorTagged(criterion: BindingTag): BindingConstraint;

package/dist/resolution/select/constraints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/resolution/select/constraints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAInF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAM/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAMpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,iBAAiB,CAGzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,UAAU,GAAG,iBAAiB,CAG9E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAUtF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAQ3F"}
+{"version":3,"file":"constraints.d.ts","sourceRoot":"","sources":["../../../src/resolution/select/constraints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGnE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAInF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIxF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,iBAAiB,CAIvF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,iBAAiB,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,UAAU,GAAG,iBAAiB,CAG9E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAUtF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAQ3F"}

package/dist/resolution/select/constraints.js

@@ -3,6 +3,8 @@ import { coversTagKeys, tagKeyMaskOf } from "#/core/tag";
 import { tokenName } from "#/core/token";
 import { EmptyTagCriteriaError } from "#/errors/errors";
 /**
+ * Matches when the direct parent frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenParentIs(token) {
@@ -10,6 +12,8 @@ export function whenParentIs(token) {
     return (constraintContext) => constraintContext.parent !== undefined && constraintContext.parent.tokenName === tokenDisplayName;
 }
 /**
+ * Matches when there is no direct parent frame, or it resolves a different token.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenNoParentIs(token) {
@@ -17,6 +21,8 @@ export function whenNoParentIs(token) {
     return (constraintContext) => constraintContext.parent === undefined || constraintContext.parent.tokenName !== tokenDisplayName;
 }
 /**
+ * Matches when at least one ancestor frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenAnyAncestorIs(token) {
@@ -24,6 +30,8 @@ export function whenAnyAncestorIs(token) {
     return (constraintContext) => constraintContext.ancestors.some((ancestorFrame) => ancestorFrame.tokenName === tokenDisplayName);
 }
 /**
+ * Matches when no ancestor frame resolves the given token.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenNoAncestorIs(token) {
@@ -31,24 +39,32 @@ export function whenNoAncestorIs(token) {
     return (constraintContext) => constraintContext.ancestors.every((ancestorFrame) => ancestorFrame.tokenName !== tokenDisplayName);
 }
 /**
+ * Matches when the direct parent slot carries the given name.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenParentNamed(name) {
     return requiringAncestorSlotName((constraintContext) => constraintContext.parent !== undefined && constraintContext.parent.slot.name === name, name, "whenParentNamed");
 }
 /**
+ * Matches when at least one ancestor slot carries the given name.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenAnyAncestorNamed(name) {
     return requiringAncestorSlotName((constraintContext) => constraintContext.ancestors.some((ancestorFrame) => ancestorFrame.slot.name === name), name, "whenAnyAncestorNamed");
 }
 /**
+ * Matches when the direct parent slot carries the given tag pair.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenParentTagged(criterion) {
     return (constraintContext) => constraintContext.parent !== undefined && constraintContext.parent.slot.tags.includes(criterion);
 }
 /**
+ * Matches when at least one ancestor slot carries the given tag pair.
+ *
  * @since 0.3.16-canary.0
  */
 export function whenAnyAncestorTagged(criterion) {

package/dist/resolution/select/constraints.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/di",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -36,6 +36,13 @@
       "./tests/*/index.ts",
       "./tests/*/index.tsx"
     ],
+    "#/examples/*": [
+      "./examples/*",
+      "./examples/*.ts",
+      "./examples/*.tsx",
+      "./examples/*/index.ts",
+      "./examples/*/index.tsx"
+    ],
     "#/*": {
       "source": [
         "./src/*",
@@ -274,12 +281,12 @@
     "@babel/plugin-proposal-decorators": "8.0.2",
     "@rolldown/plugin-babel": "^0.2.3",
     "@types/node": "^26.2.0",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "expect-type": "^1.4.0",
     "tsx": "^4.23.12",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10",
-    "@codefast/typescript-config": "0.7.0"
+    "vitest": "^4.1.11",
+    "@codefast/typescript-config": "0.8.0"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -288,7 +295,7 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "check-types": "tsc --noEmit",
     "clean": "rm -rf dist",
-    "examples": "for file in examples/*/*.ts; do echo \"=== Running $file ===\"; node --import tsx/esm \"$file\"; echo \"\n\" || exit 1; done",
+    "examples": "node examples/run.mjs",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:e2e": "vitest run tests/e2e",

package/src/ambient/active-container.ts

@@ -20,6 +20,8 @@ let activeContainer: Container | undefined;
 let activeResolution: AmbientResolution | undefined;
 
 /**
+ * Runs a callback with the given container installed as the ambient one and returns its result.
+ *
  * @since 0.3.16-canary.0
  */
 export function runWithContainer<Result>(container: Container, fn: () => Result): Result {
@@ -49,6 +51,8 @@ export function runWithAmbientResolution<Result>(
 }
 
 /**
+ * Returns the ambient container for the construction in flight, if one is installed.
+ *
  * @since 0.3.16-canary.0
  */
 export function getActiveContainer(): Container | undefined {

package/src/container/container.ts

@@ -50,6 +50,8 @@ import { DependencyResolver } from "#/resolution/resolver";
 // ── Container interface ──────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The public surface: binding, resolving, modules, lifecycle hooks, child scopes, and disposal.
+ *
  * @since 0.3.16-canary.0
  */
 export interface Container {
@@ -114,6 +116,8 @@ export interface ContainerOptions {
 }
 
 /**
+ * The factory surface the `Container` companion object exposes.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ContainerStatic {
@@ -944,6 +948,8 @@ function throwCollected(errors: ReadonlyArray<unknown>, message: string): void {
 // ── Container static ─────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The companion factory that creates containers, empty or preloaded from modules.
+ *
  * @since 0.3.16-canary.0
  */
 export const Container: ContainerStatic = {

package/src/core/module.ts

@@ -16,6 +16,8 @@ const ASYNC_MODULE_BRAND: unique symbol = Symbol("di:async-module");
 export const MODULE_SETUP: unique symbol = Symbol("di:module-setup");
 
 /**
+ * A named, reusable group of bindings a container applies synchronously via `load()`.
+ *
  * @since 0.3.16-canary.0
  */
 export interface SyncModule {
@@ -25,6 +27,8 @@ export interface SyncModule {
 }
 
 /**
+ * A named group of bindings whose setup is async, applied via `loadAsync()`.
+ *
  * @since 0.3.16-canary.0
  */
 export interface AsyncModule {
@@ -36,6 +40,8 @@ export interface AsyncModule {
 // ── Builder interfaces ───────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The binding surface a sync module's setup callback receives.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ModuleBuilder {
@@ -44,6 +50,8 @@ export interface ModuleBuilder {
 }
 
 /**
+ * The binding surface an async module's setup callback receives; its `import` accepts async modules too.
+ *
  * @since 0.3.16-canary.0
  */
 export interface AsyncModuleBuilder {
@@ -54,6 +62,8 @@ export interface AsyncModuleBuilder {
 // ── Static factories ─────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The companion factory that creates `SyncModule` values.
+ *
  * @since 0.3.16-canary.0
  */
 export const SyncModule = {
@@ -67,6 +77,8 @@ export const SyncModule = {
 };
 
 /**
+ * The companion factory that creates `AsyncModule` values.
+ *
  * @since 0.3.16-canary.0
  */
 export const AsyncModule = {
@@ -82,6 +94,8 @@ export const AsyncModule = {
 // ── Module — unified API ─────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The unified module factory — `create` for sync modules, `createAsync` for async ones.
+ *
  * @since 0.3.16-canary.0
  */
 export const Module = {
@@ -94,6 +108,8 @@ export const Module = {
 };
 
 /**
+ * Narrows a module union to `SyncModule` by checking its brand.
+ *
  * @since 0.3.16-canary.0
  */
 export function isSyncModule(module: SyncModule | AsyncModule): module is SyncModule {

package/src/core/registry.ts

@@ -6,6 +6,8 @@ import type { Token } from "#/core/token";
 import type { BindingIdentifier, Constructor, DependencyKey } from "#/core/types";
 
 /**
+ * One container's binding store, indexed by token, binding id, and slot for fast lookup.
+ *
  * @since 0.3.16-canary.0
  */
 export class BindingRegistry {

package/src/core/token.ts

@@ -3,6 +3,8 @@ import type { Constructor } from "#/core/constructor-type";
 declare const TOKEN_BRAND: unique symbol;
 
 /**
+ * A branded identifier carrying the value type its bindings resolve to.
+ *
  * @since 0.3.16-canary.0
  */
 export interface Token<out Value> {
@@ -11,6 +13,8 @@ export interface Token<out Value> {
 }
 
 /**
+ * Creates a named `Token` for the given value type.
+ *
  * @since 0.3.16-canary.0
  */
 export function token<Value>(name: string): Token<Value> {
@@ -18,6 +22,8 @@ export function token<Value>(name: string): Token<Value> {
 }
 
 /**
+ * Returns the display name of a token or class used as a dependency key.
+ *
  * @since 0.3.16-canary.0
  */
 export function tokenName(dependency: Token<unknown> | Constructor): string {

package/src/core/types.ts

@@ -16,6 +16,8 @@ export type DependencyKey = Token<unknown> | Constructor;
 // ── BindingScope ─────────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The lifetime a binding's instances are cached under.
+ *
  * @since 0.3.16-canary.0
  */
 export type BindingScope = "singleton" | "transient" | "scoped";
@@ -24,6 +26,8 @@ export type BindingScope = "singleton" | "transient" | "scoped";
 
 declare const BINDING_ID_BRAND: unique symbol;
 /**
+ * A branded string that uniquely identifies one binding.
+ *
  * @since 0.3.16-canary.0
  */
 export type BindingIdentifier = string & { readonly [BINDING_ID_BRAND]: true };
@@ -31,6 +35,8 @@ export type BindingIdentifier = string & { readonly [BINDING_ID_BRAND]: true };
 // ── BindingKind ──────────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The strategy a binding produces values with, set by the `to*()` call that created it.
+ *
  * @since 0.3.16-canary.0
  */
 export type BindingKind = "class" | "dynamic" | "dynamic-async" | "resolved" | "resolved-async" | "constant" | "alias";
@@ -38,11 +44,15 @@ export type BindingKind = "class" | "dynamic" | "dynamic-async" | "resolved" | "
 // ── Handlers ─────────────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * A hook that runs after an instance is created and returns the instance to hand out.
+ *
  * @since 0.3.16-canary.0
  */
 export type ActivationHandler<Value> = (ctx: ResolutionContext, instance: Value) => Value | Promise<Value>;
 
 /**
+ * A hook that runs when a cached instance is released from its scope.
+ *
  * @since 0.3.16-canary.0
  */
 export type DeactivationHandler<Value> = (instance: Value) => void | Promise<void>;
@@ -50,6 +60,8 @@ export type DeactivationHandler<Value> = (instance: Value) => void | Promise<voi
 // ── ResolveOptions ───────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * Slot-selection criteria — a name and tags — that narrow which binding a resolve call matches.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ResolveOptions {
@@ -67,6 +79,8 @@ export interface ResolveOptions {
 // ── ResolutionFrame ──────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * One entry of the resolution stack: the token, scope, binding, and slot being resolved.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ResolutionFrame {
@@ -84,6 +98,8 @@ export interface ResolutionFrame {
 // ── ConstraintContext ────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The resolution-time view — path, stack, parent, and ancestors — a `BindingConstraint` inspects.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ConstraintContext {
@@ -105,6 +121,8 @@ export type BindingConstraint = (ctx: ConstraintContext) => boolean;
 // ── ResolutionContext ────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The container view a dynamic factory or activation handler resolves further dependencies through.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ResolutionContext {
@@ -123,6 +141,8 @@ export interface ResolutionContext {
 // ── TokenValue ───────────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The value type a token or class constructor resolves to.
+ *
  * @since 0.3.16-canary.0
  */
 export type TokenValue<Type> =

package/src/decorators/inject.ts

@@ -35,6 +35,8 @@ type ClassAccessorDecorator<This, Value> = (
 ) => ClassAccessorDecoratorResult<This, Value> | void;
 
 /**
+ * Creates a dual-role value: an injection descriptor that also works as a class accessor decorator.
+ *
  * @since 0.3.16-canary.0
  */
 export function inject<Value>(

package/src/decorators/injectable.ts

@@ -7,6 +7,8 @@ import type { ParamMetadata } from "#/metadata/metadata-types";
 // ── AutoRegisterRegistry ─────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * The collector `@injectable` registers a class into, for a container to bind later.
+ *
  * @since 0.3.16-canary.0
  */
 export interface AutoRegisterRegistry {
@@ -15,6 +17,8 @@ export interface AutoRegisterRegistry {
 }
 
 /**
+ * Creates an empty auto-register registry.
+ *
  * @since 0.3.16-canary.0
  */
 export function createAutoRegisterRegistry(): AutoRegisterRegistry {
@@ -32,6 +36,8 @@ export function createAutoRegisterRegistry(): AutoRegisterRegistry {
 // ── InjectableOptions ────────────────────────────────────────────────────────────────────────────────────────────────
 
 /**
+ * Auto-registration options `@injectable` accepts alongside its deps list.
+ *
  * @since 0.3.16-canary.0
  */
 export interface InjectableOptions {
@@ -83,6 +89,8 @@ export function injectable<const Deps extends ReadonlyArray<InjectableDependency
 ) => void;
 
 /**
+ * Writes the declared dependencies into the class's metadata and optionally auto-registers it.
+ *
  * @since 0.6.0
  */
 export function injectable(

package/src/decorators/lifecycle-decorators.ts

@@ -25,6 +25,8 @@ function recordLifecycleMethod(phase: "postConstruct" | "preDestroy"): MethodDec
 }
 
 /**
+ * Marks an instance method to run after the container constructs and wires the instance.
+ *
  * @since 0.3.16-canary.0
  */
 export function postConstruct(): MethodDecorator {
@@ -32,6 +34,8 @@ export function postConstruct(): MethodDecorator {
 }
 
 /**
+ * Marks an instance method to run when the instance's container or scope is disposed.
+ *
  * @since 0.3.16-canary.0
  */
 export function preDestroy(): MethodDecorator {

package/src/errors/errors.ts

@@ -1,6 +1,8 @@
 import type { BindingIdentifier, BindingScope, ResolveOptions } from "#/core/types";
 
 /**
+ * Base class for every error the library throws, each carrying a machine-readable `code`.
+ *
  * @since 0.3.16-canary.0
  */
 export abstract class DiError extends Error {
@@ -13,6 +15,8 @@ export abstract class DiError extends Error {
 }
 
 /**
+ * An internal assertion failure — a library bug, never caller misuse.
+ *
  * @since 0.3.16-canary.0
  */
 export class InternalError extends DiError {
@@ -24,6 +28,8 @@ export class InternalError extends DiError {
 }
 
 /**
+ * A token with no binding at all, even after walking the parent container chain.
+ *
  * @since 0.3.16-canary.0
  */
 export class TokenNotBoundError extends DiError {
@@ -50,6 +56,8 @@ function describeResolveOptions(options: ResolveOptions): string {
 }
 
 /**
+ * A token that has bindings, none of whose slots match the given `ResolveOptions`.
+ *
  * @since 0.3.16-canary.0
  */
 export class NoMatchingBindingError extends DiError {
@@ -69,6 +77,8 @@ export class NoMatchingBindingError extends DiError {
 }
 
 /**
+ * Two or more candidate bindings that matched without the more-specific rule deciding a winner.
+ *
  * @since 0.3.16-canary.0
  */
 export class AmbiguousBindingError extends DiError {
@@ -86,6 +96,8 @@ export class AmbiguousBindingError extends DiError {
 }
 
 /**
+ * A dependency cycle detected along the resolution path, alias chains included.
+ *
  * @since 0.3.16-canary.0
  */
 export class CircularDependencyError extends DiError {
@@ -99,6 +111,8 @@ export class CircularDependencyError extends DiError {
 }
 
 /**
+ * A sync `resolve()` of a token whose factory — or a dependency's factory — is async.
+ *
  * @since 0.3.16-canary.0
  */
 export class AsyncResolutionError extends DiError {
@@ -120,6 +134,8 @@ export class AsyncResolutionError extends DiError {
 }
 
 /**
+ * A sync `unbind()` of a binding whose `onDeactivation` handler is async.
+ *
  * @since 0.3.16-canary.0
  */
 export class AsyncDeactivationError extends DiError {
@@ -133,6 +149,8 @@ export class AsyncDeactivationError extends DiError {
 }
 
 /**
+ * The tokens, scopes, and resolution path describing a captive-dependency violation.
+ *
  * @since 0.3.16-canary.0
  */
 export interface ScopeViolationDetails {
@@ -144,6 +162,8 @@ export interface ScopeViolationDetails {
 }
 
 /**
+ * A captive dependency — a longer-lived binding depending on a shorter-lived one.
+ *
  * @since 0.3.16-canary.0
  */
 export class ScopeViolationError extends DiError {
@@ -251,6 +271,8 @@ export class InvalidMetadataError extends DiError {
 }
 
 /**
+ * A class the container must construct but that carries no `@injectable()` metadata.
+ *
  * @since 0.3.16-canary.0
  */
 export class MissingMetadataError extends DiError {
@@ -266,6 +288,8 @@ export class MissingMetadataError extends DiError {
 }
 
 /**
+ * A sync `load()` given a module that needs async setup.
+ *
  * @since 0.3.16-canary.0
  */
 export class AsyncModuleLoadError extends DiError {
@@ -279,6 +303,8 @@ export class AsyncModuleLoadError extends DiError {
 }
 
 /**
+ * A synchronous disposal attempt on a container whose `onDeactivation` handlers may be async.
+ *
  * @since 0.3.16-canary.0
  */
 export class SyncDisposalNotSupportedError extends DiError {
@@ -292,6 +318,8 @@ export class SyncDisposalNotSupportedError extends DiError {
 }
 
 /**
+ * A `scoped` binding resolved from a container with no child scope context.
+ *
  * @since 0.3.16-canary.0
  */
 export class MissingScopeContextError extends DiError {
@@ -355,6 +383,8 @@ export class ChainNotRegisteredError extends DiError {
 }
 
 /**
+ * A `rebind()` of a token that has no own binding in this container.
+ *
  * @since 0.3.16-canary.0
  */
 export class RebindUnboundTokenError extends DiError {
@@ -410,6 +440,8 @@ export class StaticMemberDecoratorError extends DiError {
 }
 
 /**
+ * An operation attempted on a container that has already been disposed.
+ *
  * @since 0.3.16-canary.0
  */
 export class DisposedContainerError extends DiError {
@@ -421,6 +453,8 @@ export class DisposedContainerError extends DiError {
 }
 
 /**
+ * A `@postConstruct` or `onActivation` hook that returned a `Promise` on a sync resolution path.
+ *
  * @since 0.3.16-canary.0
  */
 export class AsyncActivationError extends DiError {