@wyrly/next 1.0.3 → 1.0.5

package/README.md

@@ -0,0 +1,57 @@
+# @wyrly/next
+
+Wyrly DI adapter for Next.js 15+ App Router — route handlers (`withDI`) and Server Components
+(`createServerDI`).
+
+Japanese: [README.ja.md](./README.ja.md)
+
+## Install
+
+```sh
+npm install @wyrly/next @wyrly/core next react
+```
+
+Peer dependencies: **next ^15.0.0**, **react ^19.0.0**.
+
+## Requirements
+
+- Everything required by [`@wyrly/core`](../core/README.md)
+- **Next.js 15+** (App Router)
+
+## Quick start (Route Handler)
+
+```ts
+import { withDI } from "@wyrly/next";
+import { createContainer } from "@wyrly/core";
+
+const container = createContainer();
+
+export const GET = withDI(container, async (_req, { di }) => {
+  const usecase = di.resolve(MyUseCase);
+  return Response.json(await usecase.run());
+});
+```
+
+For Server Components, use `createServerDI` — see
+[API.md](https://github.com/valid-lab/wyrly/blob/main/API.md).
+
+## Documentation
+
+- [@wyrly/core](../core/README.md)
+- [API reference](https://github.com/valid-lab/wyrly/blob/main/API.md)
+- [Monorepo README](https://github.com/valid-lab/wyrly/blob/main/README.md)
+
+## Related packages
+
+| Package          | npm      | Description     |
+| ---------------- | -------- | --------------- |
+| `@wyrly/core`    | yes      | Core DI         |
+| `@wyrly/next`    | yes      | This package    |
+| `@wyrly/express` | yes      | Express adapter |
+| `@wyrly/hono`    | yes      | Hono adapter    |
+| `@wyrly/graphql` | yes      | GraphQL adapter |
+| `@wyrly/fresh`   | JSR only | Fresh 2.x       |
+
+## License
+
+Apache-2.0 — see [LICENSE](https://github.com/valid-lab/wyrly/blob/main/LICENSE).

package/esm/_dnt.shims.d.ts

@@ -1,6 +1,2 @@
-import { Deno } from "@deno/shim-deno";
-export { Deno } from "@deno/shim-deno";
-export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
-    Deno: typeof Deno;
-};
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;
 //# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,gCAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -1,8 +1,4 @@
-import { Deno } from "@deno/shim-deno";
-export { Deno } from "@deno/shim-deno";
-const dntGlobals = {
-    Deno,
-};
+const dntGlobals = {};
 export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
 function createMergeProxy(baseObj, extObj) {
     return new Proxy(baseObj, {

package/esm/core/container.d.ts

@@ -6,14 +6,22 @@ import type { Scope } from "./scope.js";
 import { type RegistryKey } from "./internal_keys.js";
 import { type DependencyGraph } from "./graph.js";
 import { type ValidateOptions, type ValidationResult } from "./validate.js";
+/** Root DI container: registrations, root resolve, scopes, inspect, and validate. */
 export interface Container {
+    /** Registers a provider (or `@Injectable` class when `provider` is omitted). */
     register<T>(token: InjectionToken<T>, provider?: Provider<T>): void;
+    /** Replaces an existing registration (tests and composition roots). */
     override<T>(token: InjectionToken<T>, provider: Provider<T>): void;
+    /** Resolves from the root (singleton / transient only; not scoped). */
     resolve<T>(token: InjectionToken<T>): T;
+    /** Creates a child scope (typically one per HTTP / GraphQL request). */
     createScope(): Scope;
+    /** Exports the dependency graph for tooling and debugging. */
     inspect(): DependencyGraph;
+    /** Runs design-time checks on the provider registry. */
     validate(options?: ValidateOptions): ValidationResult;
 }
+/** Creates a new root container with an empty provider registry. */
 export declare function createContainer(): Container;
 type Disposer = () => void | Promise<void>;
 export declare class ScopeImpl implements Scope {

package/esm/core/container.d.ts.map

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

package/esm/core/container.js

@@ -16,6 +16,7 @@ import { graphNodeId, registryKey } from "./internal_keys.js";
 import { CircularDependencyError, DuplicateProviderError, InvalidProviderError, LifetimeViolationError, ProviderNotFoundError, ScopeDisposedError, } from "./errors.js";
 import { augmentGraphWithInjectableClasses, buildGraph, collectRegisteredProviders, dedupeEdges, } from "./graph.js";
 import { validateNormalizedProviders, } from "./validate.js";
+/** Creates a new root container with an empty provider registry. */
 export function createContainer() {
     return new ContainerImpl();
 }

package/esm/core/errors.d.ts

@@ -2,32 +2,79 @@ import type { InjectionToken } from "./token.js";
 import { type ErrorMessageKind, type Locale } from "./i18n.js";
 /** Dependency chain while resolving (for debugging and error display). */
 export type ResolutionPath = readonly string[];
+/** Optional locale for localized error messages. */
 export interface ErrorLocaleOptions {
+    /** BCP 47 or POSIX tag; normalized to `en` or `ja`. */
     locale?: Locale;
 }
+/** Thrown when no provider is registered for a token. */
 export declare class ProviderNotFoundError extends Error {
+    /** Token that could not be resolved. */
     readonly token: InjectionToken<unknown>;
+    /** Resolution path at failure time. */
     readonly path: ResolutionPath;
+    /**
+     * Creates a provider-not-found error.
+     * @param token Missing token.
+     * @param path Resolution path.
+     * @param options Optional locale.
+     */
     constructor(token: InjectionToken<unknown>, path: ResolutionPath, options?: ErrorLocaleOptions);
 }
+/** Thrown when the dependency graph contains a cycle. */
 export declare class CircularDependencyError extends Error {
+    /** Cycle path including the repeating node. */
     readonly path: ResolutionPath;
+    /**
+     * Creates a circular-dependency error.
+     * @param path Cycle path.
+     * @param options Optional locale.
+     */
     constructor(path: ResolutionPath, options?: ErrorLocaleOptions);
 }
+/** Thrown for invalid provider registration or resolve rules. */
 export declare class InvalidProviderError extends Error {
+    /**
+     * Creates an invalid-provider error.
+     * @param messageOrKind Error kind or custom detail.
+     * @param params Template params and optional locale.
+     */
     constructor(messageOrKind: string | Extract<ErrorMessageKind, "InvalidProvider_class_token_only" | "InvalidProvider_scoped_from_root" | "InvalidProvider_unsupported_provider_type">, params?: Record<string, string> & ErrorLocaleOptions);
 }
+/** Thrown when resolving or registering on a disposed scope. */
 export declare class ScopeDisposedError extends Error {
+    /**
+     * Creates a scope-disposed error.
+     * @param options Optional locale.
+     */
     constructor(options?: ErrorLocaleOptions);
 }
+/** Thrown when a shorter-lived provider depends on a longer-lived one at resolve time. */
 export declare class LifetimeViolationError extends Error {
+    /** Lifetime of the dependent registration. */
     readonly fromLifetime: string;
+    /** Lifetime of the dependency registration. */
     readonly toLifetime: string;
+    /** Resolution path at violation time. */
     readonly path: ResolutionPath;
+    /**
+     * Creates a lifetime-violation error.
+     * @param fromLifetime Dependent lifetime.
+     * @param toLifetime Dependency lifetime.
+     * @param path Resolution path.
+     * @param options Optional locale.
+     */
     constructor(fromLifetime: string, toLifetime: string, path: ResolutionPath, options?: ErrorLocaleOptions);
 }
+/** Thrown when registering the same token twice in one registry. */
 export declare class DuplicateProviderError extends Error {
+    /** Token that was registered again. */
     readonly token: InjectionToken<unknown>;
+    /**
+     * Creates a duplicate-provider error.
+     * @param token Duplicate token.
+     * @param options Optional locale.
+     */
     constructor(token: InjectionToken<unknown>, options?: ErrorLocaleOptions);
 }
 //# sourceMappingURL=errors.d.ts.map

package/esm/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,MAAM,EAGZ,MAAM,WAAW,CAAC;AAEnB,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,SAAS,MAAM,EAAE,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAG5B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB;CAe/B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAU/D;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBAE3C,aAAa,EACT,MAAM,GACN,OAAO,CACP,gBAAgB,EACd,kCAAkC,GAClC,kCAAkC,GAClC,2CAA2C,CAC9C,EACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB;CASvD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,CAAC,EAAE,kBAAkB;CAKzC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAG5B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB;CAgB/B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;gBAE5B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAOzE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,MAAM,EAGZ,MAAM,WAAW,CAAC;AAEnB,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,SAAS,MAAM,EAAE,CAAC;AAE/C,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B;;;;;OAKG;gBAED,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB;CAe/B;AAED,yDAAyD;AACzD,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B;;;;OAIG;gBACS,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAU/D;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C;;;;OAIG;gBAED,aAAa,EACT,MAAM,GACN,OAAO,CACP,gBAAgB,EACd,kCAAkC,GAClC,kCAAkC,GAClC,2CAA2C,CAC9C,EACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB;CASvD;AAED,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C;;;OAGG;gBACS,OAAO,CAAC,EAAE,kBAAkB;CAKzC;AAED,0FAA0F;AAC1F,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B;;;;;;OAMG;gBAED,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB;CAgB/B;AAED,oEAAoE;AACpE,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC;;;;OAIG;gBACS,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAOzE"}

package/esm/core/errors.js

@@ -1,6 +1,13 @@
 import { tokenLabel } from "./internal_keys.js";
 import { errorMessage, lifetimeViolationHint, providerNotFoundHint, resolveLocale, } from "./i18n.js";
+/** Thrown when no provider is registered for a token. */
 export class ProviderNotFoundError extends Error {
+    /**
+     * Creates a provider-not-found error.
+     * @param token Missing token.
+     * @param path Resolution path.
+     * @param options Optional locale.
+     */
     constructor(token, path, options) {
         const locale = resolveLocale(options);
         const label = tokenLabel(token);
@@ -9,12 +16,14 @@ export class ProviderNotFoundError extends Error {
             path: path.join(" -> "),
             hint: providerNotFoundHint(locale),
         }, locale));
+        /** Token that could not be resolved. */
         Object.defineProperty(this, "token", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Resolution path at failure time. */
         Object.defineProperty(this, "path", {
             enumerable: true,
             configurable: true,
@@ -26,12 +35,19 @@ export class ProviderNotFoundError extends Error {
         this.path = path;
     }
 }
+/** Thrown when the dependency graph contains a cycle. */
 export class CircularDependencyError extends Error {
+    /**
+     * Creates a circular-dependency error.
+     * @param path Cycle path.
+     * @param options Optional locale.
+     */
     constructor(path, options) {
         const locale = resolveLocale(options);
         super(errorMessage("CircularDependency", {
             path: path.join(" -> "),
         }, locale));
+        /** Cycle path including the repeating node. */
         Object.defineProperty(this, "path", {
             enumerable: true,
             configurable: true,
@@ -42,7 +58,13 @@ export class CircularDependencyError extends Error {
         this.path = path;
     }
 }
+/** Thrown for invalid provider registration or resolve rules. */
 export class InvalidProviderError extends Error {
+    /**
+     * Creates an invalid-provider error.
+     * @param messageOrKind Error kind or custom detail.
+     * @param params Template params and optional locale.
+     */
     constructor(messageOrKind, params) {
         const locale = resolveLocale(params);
         const text = typeof messageOrKind === "string"
@@ -52,14 +74,27 @@ export class InvalidProviderError extends Error {
         this.name = "InvalidProviderError";
     }
 }
+/** Thrown when resolving or registering on a disposed scope. */
 export class ScopeDisposedError extends Error {
+    /**
+     * Creates a scope-disposed error.
+     * @param options Optional locale.
+     */
     constructor(options) {
         const locale = resolveLocale(options);
         super(errorMessage("ScopeDisposed", {}, locale));
         this.name = "ScopeDisposedError";
     }
 }
+/** Thrown when a shorter-lived provider depends on a longer-lived one at resolve time. */
 export class LifetimeViolationError extends Error {
+    /**
+     * Creates a lifetime-violation error.
+     * @param fromLifetime Dependent lifetime.
+     * @param toLifetime Dependency lifetime.
+     * @param path Resolution path.
+     * @param options Optional locale.
+     */
     constructor(fromLifetime, toLifetime, path, options) {
         const locale = resolveLocale(options);
         super(errorMessage("LifetimeViolation", {
@@ -68,18 +103,21 @@ export class LifetimeViolationError extends Error {
             path: path.join(" -> "),
             hint: lifetimeViolationHint(locale),
         }, locale));
+        /** Lifetime of the dependent registration. */
         Object.defineProperty(this, "fromLifetime", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Lifetime of the dependency registration. */
         Object.defineProperty(this, "toLifetime", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Resolution path at violation time. */
         Object.defineProperty(this, "path", {
             enumerable: true,
             configurable: true,
@@ -92,11 +130,18 @@ export class LifetimeViolationError extends Error {
         this.path = path;
     }
 }
+/** Thrown when registering the same token twice in one registry. */
 export class DuplicateProviderError extends Error {
+    /**
+     * Creates a duplicate-provider error.
+     * @param token Duplicate token.
+     * @param options Optional locale.
+     */
     constructor(token, options) {
         const locale = resolveLocale(options);
         const label = tokenLabel(token);
         super(errorMessage("DuplicateProvider", { label }, locale));
+        /** Token that was registered again. */
         Object.defineProperty(this, "token", {
             enumerable: true,
             configurable: true,

package/esm/core/graph.d.ts

@@ -1,18 +1,29 @@
 import type { Lifetime } from "./lifetime.js";
 import type { NormalizedProvider, ProviderType } from "./provider.js";
 import type { InjectionToken } from "./token.js";
+/** Node in a dependency graph produced by {@link Container.inspect}. */
 export interface DependencyNode {
+    /** Stable node id (token label). */
     id: string;
+    /** Display name for the token or class. */
     name: string;
+    /** Resolved lifetime for this registration. */
     lifetime: Lifetime;
+    /** Kind of provider backing this node. */
     provider: ProviderType;
 }
+/** Directed dependency edge between two graph nodes. */
 export interface DependencyEdge {
+    /** Source node id (dependent). */
     from: string;
+    /** Target node id (dependency). */
     to: string;
 }
+/** Full dependency graph (nodes and edges). */
 export interface DependencyGraph {
+    /** All registered and inferred nodes. */
     nodes: DependencyNode[];
+    /** Dependency edges between nodes. */
     edges: DependencyEdge[];
 }
 export declare function inferLifetimeForToken(dep: InjectionToken<unknown>): Lifetime;

package/esm/core/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/core/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,QAAQ,CAM5E;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC/C,eAAe,CAgCjB;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAUrE;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,GACtD,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAE/B;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GAC9C,eAAe,CAiBjB"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/core/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,sCAAsC;IACtC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,QAAQ,CAM5E;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC/C,eAAe,CAgCjB;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAUrE;AAED,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,GACtD,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAE/B;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GAC9C,eAAe,CAiBjB"}

package/esm/core/graph_format.d.ts

@@ -1,5 +1,7 @@
 import type { DependencyGraph } from "./graph.js";
+/** Options for {@link graphToJson}. */
 export interface GraphToJsonOptions {
+    /** JSON indentation spaces (default `2`). */
     indent?: number;
 }
 /**

package/esm/core/graph_format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_format.d.ts","sourceRoot":"","sources":["../../src/core/graph_format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAYzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAa7D"}
+{"version":3,"file":"graph_format.d.ts","sourceRoot":"","sources":["../../src/core/graph_format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAElE,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAYzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAa7D"}

package/esm/core/i18n.d.ts

@@ -1,6 +1,9 @@
 export type Locale = "en" | "ja";
+/** Default locale when none is resolved from options or environment. */
 export declare const DEFAULT_LOCALE: Locale;
+/** Validation issue codes used by {@link validationMessage}. */
 export type ValidationMessageCode = "unresolved_dependency" | "singleton_depends_on_scoped" | "transient_depends_on_scoped" | "circular_dependency" | "unused_provider";
+/** Runtime error message kinds used by {@link errorMessage}. */
 export type ErrorMessageKind = "ProviderNotFound" | "CircularDependency" | "ScopeDisposed" | "LifetimeViolation" | "DuplicateProvider" | "InvalidProvider_class_token_only" | "InvalidProvider_scoped_from_root" | "InvalidProvider_unsupported_provider_type" | "InvalidProvider_custom";
 /** Normalize BCP 47 / POSIX locale tags to supported `en` | `ja`. */
 export declare function normalizeLocaleTag(tag: string): Locale;
@@ -8,8 +11,12 @@ export declare function normalizeLocaleTag(tag: string): Locale;
 export declare function resolveLocale(options?: {
     locale?: Locale;
 }): Locale;
+/** Builds a localized validation issue message for the given code. */
 export declare function validationMessage(code: ValidationMessageCode, params: Record<string, string>, locale: Locale): string;
+/** Builds a localized runtime error message for the given kind. */
 export declare function errorMessage(kind: ErrorMessageKind, params: Record<string, string>, locale: Locale): string;
+/** Hint appended to {@link ProviderNotFoundError} messages. */
 export declare function providerNotFoundHint(locale: Locale): string;
+/** Hint appended to {@link LifetimeViolationError} messages. */
 export declare function lifetimeViolationHint(locale: Locale): string;
 //# sourceMappingURL=i18n.d.ts.map

package/esm/core/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC,eAAO,MAAM,cAAc,EAAE,MAAa,CAAC;AAE3C,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,6BAA6B,GAC7B,6BAA6B,GAC7B,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,kCAAkC,GAClC,kCAAkC,GAClC,2CAA2C,GAC3C,wBAAwB,CAAC;AAE7B,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAItD;AAUD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA0BnE;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,MAAM,CAsBR;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,MAAM,CA6CR;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI5D"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,MAAa,CAAC;AAE3C,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,6BAA6B,GAC7B,6BAA6B,GAC7B,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,kCAAkC,GAClC,kCAAkC,GAClC,2CAA2C,GAC3C,wBAAwB,CAAC;AAE7B,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAItD;AAqBD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA0BnE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,MAAM,CAsBR;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,MAAM,CA6CR;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI5D"}

package/esm/core/i18n.js

@@ -1,4 +1,6 @@
+/** Supported locales for errors and validation messages. */
 import * as dntShim from "../_dnt.shims.js";
+/** Default locale when none is resolved from options or environment. */
 export const DEFAULT_LOCALE = "en";
 /** Normalize BCP 47 / POSIX locale tags to supported `en` | `ja`. */
 export function normalizeLocaleTag(tag) {
@@ -9,7 +11,20 @@ export function normalizeLocaleTag(tag) {
 }
 function envGet(key) {
     try {
-        return dntShim.Deno.env.get(key);
+        const proc = dntShim.dntGlobalThis
+            .process;
+        const fromProcess = proc?.env?.[key];
+        if (fromProcess !== undefined)
+            return fromProcess;
+    }
+    catch {
+        // ignore
+    }
+    try {
+        const runtime = dntShim.dntGlobalThis;
+        const env = runtime["Deno"]
+            ?.env;
+        return env?.get(key);
     }
     catch {
         return undefined;
@@ -42,6 +57,7 @@ export function resolveLocale(options) {
     }
     return DEFAULT_LOCALE;
 }
+/** Builds a localized validation issue message for the given code. */
 export function validationMessage(code, params, locale) {
     const { fromId, depId, cycle } = params;
     switch (code) {
@@ -65,6 +81,7 @@ export function validationMessage(code, params, locale) {
                 : `${fromId} is not depended on by any other provider (may be unused).`;
     }
 }
+/** Builds a localized runtime error message for the given kind. */
 export function errorMessage(kind, params, locale) {
     const label = params.label ?? "";
     const path = params.path ?? "";
@@ -110,11 +127,13 @@ export function errorMessage(kind, params, locale) {
             return `InvalidProviderError: ${detail}`;
     }
 }
+/** Hint appended to {@link ProviderNotFoundError} messages. */
 export function providerNotFoundHint(locale) {
     return locale === "ja"
         ? "composition root で register() するか、@Injectable() の deps を確認してください。"
         : "Register it in the composition root or check @Injectable() deps.";
 }
+/** Hint appended to {@link LifetimeViolationError} messages. */
 export function lifetimeViolationHint(locale) {
     return locale === "ja"
         ? "singleton は scoped インスタンスに依存できません。scoped にするか、依存を singleton/transient に変更してください。"

package/esm/core/lifetime.d.ts

@@ -1,2 +1,3 @@
+/** Provider instance lifetime within a container or scope. */
 export type Lifetime = "singleton" | "scoped" | "transient";
 //# sourceMappingURL=lifetime.d.ts.map

package/esm/core/lifetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifetime.d.ts","sourceRoot":"","sources":["../../src/core/lifetime.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC"}
+{"version":3,"file":"lifetime.d.ts","sourceRoot":"","sources":["../../src/core/lifetime.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC"}

package/esm/core/metadata.d.ts

@@ -1,8 +1,11 @@
 import type { ClassToken } from "./token.js";
 import type { Lifetime } from "./lifetime.js";
 import type { InjectionToken } from "./token.js";
+/** Options for the {@link Injectable} class decorator. */
 export interface InjectableMetadata {
+    /** Constructor dependency tokens. */
     deps?: InjectionToken<unknown>[];
+    /** Default lifetime when registered via class token only. */
     lifetime?: Lifetime;
 }
 export declare function setInjectableMetadata(ctor: ClassToken<unknown>, meta: InjectableMetadata): void;

package/esm/core/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAOD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GACxB,kBAAkB,GAAG,SAAS,CAEhC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAOD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GACxB,kBAAkB,GAAG,SAAS,CAEhC"}

package/esm/core/mod.d.ts

@@ -1,14 +1,44 @@
+/**
+ * Explicit DI for modern TypeScript — typed tokens, standard decorators, and request scopes.
+ *
+ * @example
+ * ```ts
+ * import { createContainer, Injectable, token } from "@wyrly/core";
+ *
+ * const RepoToken = token<{ findById(id: string): Promise<unknown> }>("Repo");
+ *
+ * @Injectable({ deps: [RepoToken], lifetime: "scoped" })
+ * class GetUser {
+ *   constructor(private readonly repo: { findById(id: string): Promise<unknown> }) {}
+ * }
+ *
+ * const container = createContainer();
+ * container.register(RepoToken, { useValue: { findById: async () => null }, lifetime: "scoped" });
+ * container.register(GetUser);
+ *
+ * const scope = container.createScope();
+ * try {
+ *   scope.resolve(GetUser);
+ * } finally {
+ *   await scope.dispose();
+ * }
+ * ```
+ *
+ * @module
+ */
 export { type ClassToken, type InjectionToken, type Token, token } from "./token.js";
 export type { Lifetime } from "./lifetime.js";
 export { Injectable } from "./decorators.js";
+export type { InjectableMetadata } from "./metadata.js";
+export type { ClassDecoratorContext } from "./types_decorator.js";
 export { type Container, createContainer } from "./container.js";
 export type { Scope } from "./scope.js";
-export type { ClassProvider, ExistingProvider, FactoryProvider, Provider, ValueProvider, } from "./provider.js";
+export type { ClassProvider, ExistingProvider, FactoryProvider, NormalizedProvider, Provider, ProviderType, ValueProvider, } from "./provider.js";
 export type { DependencyEdge, DependencyGraph, DependencyNode } from "./graph.js";
 export { graphToDot, graphToJson, graphToMermaid } from "./graph_format.js";
 export type { GraphToJsonOptions } from "./graph_format.js";
 export type { ValidateOptions, ValidationIssue, ValidationResult } from "./validate.js";
 export { validateNormalizedProviders } from "./validate.js";
 export { DEFAULT_LOCALE, errorMessage, type ErrorMessageKind, lifetimeViolationHint, type Locale, normalizeLocaleTag, providerNotFoundHint, resolveLocale, validationMessage, type ValidationMessageCode, } from "./i18n.js";
-export { CircularDependencyError, DuplicateProviderError, InvalidProviderError, LifetimeViolationError, ProviderNotFoundError, ScopeDisposedError, } from "./errors.js";
+export { CircularDependencyError, DuplicateProviderError, type ErrorLocaleOptions, InvalidProviderError, LifetimeViolationError, ProviderNotFoundError, type ResolutionPath, ScopeDisposedError, } from "./errors.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/core/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/core/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,MAAM,EACX,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/core/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,KAAK,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,MAAM,EACX,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/esm/core/mod.js

@@ -1,3 +1,31 @@
+/**
+ * Explicit DI for modern TypeScript — typed tokens, standard decorators, and request scopes.
+ *
+ * @example
+ * ```ts
+ * import { createContainer, Injectable, token } from "@wyrly/core";
+ *
+ * const RepoToken = token<{ findById(id: string): Promise<unknown> }>("Repo");
+ *
+ * @Injectable({ deps: [RepoToken], lifetime: "scoped" })
+ * class GetUser {
+ *   constructor(private readonly repo: { findById(id: string): Promise<unknown> }) {}
+ * }
+ *
+ * const container = createContainer();
+ * container.register(RepoToken, { useValue: { findById: async () => null }, lifetime: "scoped" });
+ * container.register(GetUser);
+ *
+ * const scope = container.createScope();
+ * try {
+ *   scope.resolve(GetUser);
+ * } finally {
+ *   await scope.dispose();
+ * }
+ * ```
+ *
+ * @module
+ */
 export { token } from "./token.js";
 export { Injectable } from "./decorators.js";
 export { createContainer } from "./container.js";

package/esm/core/provider.d.ts

@@ -2,39 +2,64 @@ import type { Scope } from "./scope.js";
 import type { ClassToken } from "./token.js";
 import type { InjectionToken } from "./token.js";
 import type { Lifetime } from "./lifetime.js";
+/** Registration shape accepted by {@link Container.register}. */
 export type Provider<T> = ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
+/** Registers a class constructor as the implementation. */
 export interface ClassProvider<T> {
+    /** Class to instantiate. */
     useClass: ClassToken<T>;
+    /** Explicit constructor dependencies (overrides `@Injectable` metadata). */
     deps?: InjectionToken<unknown>[];
+    /** Lifetime override (overrides `@Injectable` metadata). */
     lifetime?: Lifetime;
 }
+/** Registers a constant value (singleton only). */
 export interface ValueProvider<T> {
+    /** Pre-built instance. */
     useValue: T;
+    /** Must be `"singleton"` when set. */
     lifetime?: "singleton";
 }
 /**
- * MVP supports synchronous factories only. `Promise<T>` is planned for a future `resolveAsync`.
+ * Registers a factory function (synchronous only in v1).
+ * `Promise<T>` is planned for a future `resolveAsync`.
  */
 export interface FactoryProvider<T> {
+    /** Factory invoked with the active scope. */
     useFactory: (scope: Scope) => T;
+    /** Tokens resolved before the factory runs. */
     deps?: InjectionToken<unknown>[];
+    /** Lifetime for the factory result. */
     lifetime?: Lifetime;
 }
+/** Aliases another registered token. */
 export interface ExistingProvider<T> {
+    /** Token to resolve instead. */
     useExisting: InjectionToken<T>;
+    /** Lifetime for this alias registration. */
     lifetime?: Lifetime;
 }
+/** Normalized provider kind stored in the registry. */
 export type ProviderType = "class" | "value" | "factory" | "existing";
-/** Container-internal representation (normalized after registration) */
+/** Container-internal representation (normalized after registration). */
 export interface NormalizedProvider<T = unknown> {
+    /** Token this provider satisfies. */
     readonly token: InjectionToken<T>;
+    /** Provider kind after normalization. */
     readonly providerType: ProviderType;
+    /** Declared dependency tokens. */
     readonly deps: readonly InjectionToken<unknown>[];
+    /** Effective lifetime. */
     readonly lifetime: Lifetime;
+    /** Label used in graphs and errors. */
     readonly displayName: string;
+    /** Set when `providerType` is `"class"`. */
     readonly useClass?: ClassToken<T>;
+    /** Set when `providerType` is `"value"`. */
     readonly useValue?: T;
+    /** Set when `providerType` is `"factory"`. */
     readonly useFactory?: (scope: Scope) => T;
+    /** Set when `providerType` is `"existing"`. */
     readonly useExisting?: InjectionToken<T>;
 }
 export declare function normalizeProvider<T>(token: InjectionToken<T>, provider: Provider<T>): NormalizedProvider<T>;

package/esm/core/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/core/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C,MAAM,MAAM,QAAQ,CAAC,CAAC,IAClB,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,CAAC,GAChB,eAAe,CAAC,CAAC,CAAC,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAExB,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtE,wEAAwE;AACxE,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,kBAAkB,CAAC,CAAC,CAAC,CAwDvB;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACnB,kBAAkB,CAAC,CAAC,CAAC,CAYvB"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/core/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C,iEAAiE;AACjE,MAAM,MAAM,QAAQ,CAAC,CAAC,IAClB,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,CAAC,GAChB,eAAe,CAAC,CAAC,CAAC,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAExB,2DAA2D;AAC3D,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC;IACZ,sCAAsC;IACtC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,6CAA6C;IAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;IAChC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gCAAgC;IAChC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtE,yEAAyE;AACzE,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,kBAAkB,CAAC,CAAC,CAAC,CAwDvB;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACnB,kBAAkB,CAAC,CAAC,CAAC,CAYvB"}

package/esm/core/scope.d.ts

@@ -1,10 +1,16 @@
 import type { Provider } from "./provider.js";
 import type { InjectionToken } from "./token.js";
+/** Request or nested DI scope; resolves scoped and transient providers. */
 export interface Scope {
+    /** Resolves a provider from this scope (or parent container). */
     resolve<T>(token: InjectionToken<T>): T;
+    /** Registers a provider local to this scope. */
     register<T>(token: InjectionToken<T>, provider: Provider<T>): void;
+    /** Sets a pre-built instance for a token in this scope. */
     set<T>(token: InjectionToken<T>, value: T): void;
+    /** Disposes scoped instances and runs registered disposers. */
     dispose(): Promise<void>;
+    /** Whether {@link dispose} has already been called. */
     isDisposed(): boolean;
 }
 //# sourceMappingURL=scope.d.ts.map

package/esm/core/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/core/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnE,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC;CACvB"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/core/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,2EAA2E;AAC3E,MAAM,WAAW,KAAK;IACpB,iEAAiE;IACjE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnE,2DAA2D;IAC3D,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjD,+DAA+D;IAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,uDAAuD;IACvD,UAAU,IAAI,OAAO,CAAC;CACvB"}

package/esm/core/token.d.ts

@@ -1,12 +1,18 @@
-/** Typed DI token (at runtime only `id` and `name` carry meaning) */
+/** Typed DI token (at runtime only `id` and `name` carry meaning). */
 export interface Token<T> {
+    /** Discriminator for token objects. */
     readonly kind: "token";
+    /** Unique symbol id for this token. */
     readonly id: symbol;
+    /** Human-readable name (used in errors and graphs). */
     readonly name: string;
+    /** Phantom type parameter for compile-time typing only. */
     readonly __type?: T;
 }
-/** Class constructor used as an injection token */
+/** Class constructor used as an injection token. */
 export type ClassToken<T> = abstract new (...args: never[]) => T;
+/** Either a {@link Token} or a class constructor token. */
 export type InjectionToken<T> = Token<T> | ClassToken<T>;
+/** Creates a typed injection token for interface-based dependencies. */
 export declare function token<T>(name: string): Token<T>;
 //# sourceMappingURL=token.d.ts.map

package/esm/core/token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/core/token.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEjE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAEzD,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAM/C"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/core/token.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,oDAAoD;AACpD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEjE,2DAA2D;AAC3D,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAEzD,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAM/C"}

package/esm/core/token.js

@@ -1,3 +1,4 @@
+/** Creates a typed injection token for interface-based dependencies. */
 export function token(name) {
     return {
         kind: "token",

package/esm/core/types_decorator.d.ts

@@ -3,9 +3,13 @@
  * Defined locally so types work in environments without DOM in `lib`.
  */
 export interface ClassDecoratorContext<T extends abstract new (...args: never[]) => unknown = abstract new (...args: never[]) => unknown> {
+    /** Always `"class"` for class decorators. */
     readonly kind: "class";
+    /** Decorated class name, if available. */
     readonly name: string | undefined;
+    /** Decorator metadata bag (standard decorators). */
     readonly metadata: unknown;
+    /** Registers a class instance initializer. */
     addInitializer(initializer: (this: T) => void): void;
 }
 //# sourceMappingURL=types_decorator.d.ts.map

package/esm/core/types_decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types_decorator.d.ts","sourceRoot":"","sources":["../../src/core/types_decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,QAAQ,MAC7D,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,OAAO;IAEZ,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CACtD"}
+{"version":3,"file":"types_decorator.d.ts","sourceRoot":"","sources":["../../src/core/types_decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,QAAQ,MAC7D,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,OAAO;IAEZ,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CACtD"}

package/esm/core/validate.d.ts

@@ -1,15 +1,24 @@
 import type { NormalizedProvider } from "./provider.js";
 import { type Locale } from "./i18n.js";
+/** Single design-time validation finding. */
 export interface ValidationIssue {
+    /** `"error"` blocks `ok`; `"warning"` is informational. */
     severity: "error" | "warning";
+    /** Stable machine-readable code. */
     code: string;
+    /** Localized human-readable message. */
     message: string;
 }
+/** Result of {@link Container.validate} or {@link validateNormalizedProviders}. */
 export interface ValidationResult {
+    /** `true` when no issues have `severity: "error"`. */
     ok: boolean;
+    /** All errors and warnings collected. */
     issues: ValidationIssue[];
 }
+/** Options for validation and localized messages. */
 export interface ValidateOptions {
+    /** Locale for issue messages (`en` or `ja`). */
     locale?: Locale;
 }
 /**

package/esm/core/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,EACL,KAAK,MAAM,EAIZ,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiDD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACxC,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,CAiGlB"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,EACL,KAAK,MAAM,EAIZ,MAAM,WAAW,CAAC;AAEnB,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,EAAE,EAAE,OAAO,CAAC;IACZ,yCAAyC;IACzC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiDD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACxC,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,CAiGlB"}

package/esm/next/mod.d.ts

@@ -1,3 +1,22 @@
+/**
+ * Next.js 15+ adapter for Wyrly DI — route handlers (`withDI`) and Server Components (`createServerDI`).
+ *
+ * @example
+ * ```ts
+ * import { withDI } from "@wyrly/next";
+ * import { createContainer } from "@wyrly/core";
+ *
+ * const container = createContainer();
+ *
+ * export const GET = withDI(container, async (_req, { di }) => {
+ *   const usecase = di.resolve(MyUseCase);
+ *   return Response.json(await usecase.run());
+ * });
+ * ```
+ *
+ * @module
+ */
+export type { ClassProvider, ClassToken, Container, DependencyEdge, DependencyGraph, DependencyNode, ExistingProvider, FactoryProvider, InjectionToken, Lifetime, Locale, Provider, ProviderType, Scope, Token, ValidateOptions, ValidationIssue, ValidationResult, ValueProvider, } from "../core/mod.js";
 export { withDI } from "./with_di.js";
 export { withActionDI } from "./with_action_di.js";
 export { createServerDI } from "./server_di.js";

package/esm/next/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/next/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/next/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,KAAK,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/esm/next/tokens.d.ts

@@ -1,4 +1,5 @@
 import type { NextRequest } from "next/server.js";
+import { type Token } from "../core/mod.js";
 /** Current Next.js `NextRequest` (resolvable only in request scope) */
-export declare const NextRequestToken: import("../core/token.js").Token<NextRequest>;
+export declare const NextRequestToken: Token<NextRequest>;
 //# sourceMappingURL=tokens.d.ts.map

package/esm/next/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/next/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,+CAAoC,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/next/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,gBAAgB,CAAC;AAEnD,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,WAAW,CAAqC,CAAC"}

package/esm/next/types.d.ts

@@ -1,10 +1,14 @@
 import type { Scope } from "../core/mod.js";
-/** Same shape as `after()` from `next/server` (for test substitution) */
+/** Same shape as `after()` from `next/server` (for test substitution). */
 export type AfterScheduler = (callback: () => void | Promise<void>) => void;
+/** Context passed to {@link withDI} route handlers. */
 export interface RouteHandlerContext<TParams extends Record<string, string | string[]>> {
+    /** Request-scoped DI container. */
     di: Scope;
+    /** Route params from Next.js. */
     params: TParams;
 }
+/** Options for {@link withDI} and {@link withActionDI}. */
 export interface WithDIOptions {
     /**
      * Called after scope creation to `scope.set` / `scope.register`.
@@ -12,6 +16,7 @@ export interface WithDIOptions {
      */
     configureScope?: (scope: Scope) => void | Promise<void>;
 }
+/** Options for {@link createServerDI}. */
 export interface CreateServerDIOptions {
     /** For tests. Defaults to `after` from `next/server` when omitted */
     after?: AfterScheduler;

package/esm/next/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/next/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAE5E,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpF,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/next/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAE5E,uDAAuD;AACvD,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpF,mCAAmC;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}

package/package.json

@@ -1,13 +1,30 @@
 {
   "name": "@wyrly/next",
-  "version": "1.0.3",
-  "description": "Wyrly DI adapter for Next.js App Router",
+  "version": "1.0.5",
+  "description": "Wyrly DI adapter for Next.js App Router — withDI and createServerDI",
+  "keywords": [
+    "wyrly",
+    "dependency-injection",
+    "di",
+    "typescript",
+    "inversion-of-control",
+    "ioc",
+    "nextjs",
+    "next.js",
+    "app-router",
+    "react",
+    "server-components"
+  ],
+  "homepage": "https://github.com/valid-lab/wyrly/tree/main/packages/next",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/valid-lab/wyrly.git",
     "directory": "packages/next"
   },
   "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/valid-lab/wyrly/issues"
+  },
   "module": "./esm/next/mod.js",
   "exports": {
     ".": {
@@ -19,15 +36,11 @@
   "dependencies": {
     "next": "15",
     "react": "19",
-    "@deno/shim-deno": "~0.18.0",
-    "@wyrly/core": "^1.0.3"
+    "@wyrly/core": "^1.0.5"
   },
   "peerDependencies": {
     "next": "^15.0.0",
     "react": "^19.0.0"
   },
-  "devDependencies": {
-    "@types/node": "^20.9.0"
-  },
   "_generatedBy": "dnt@dev"
 }