@wyrly/next 1.0.0

package/esm/core/errors.d.ts

@@ -0,0 +1,33 @@
+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[];
+export interface ErrorLocaleOptions {
+    locale?: Locale;
+}
+export declare class ProviderNotFoundError extends Error {
+    readonly token: InjectionToken<unknown>;
+    readonly path: ResolutionPath;
+    constructor(token: InjectionToken<unknown>, path: ResolutionPath, options?: ErrorLocaleOptions);
+}
+export declare class CircularDependencyError extends Error {
+    readonly path: ResolutionPath;
+    constructor(path: ResolutionPath, options?: ErrorLocaleOptions);
+}
+export declare class InvalidProviderError extends Error {
+    constructor(messageOrKind: string | Extract<ErrorMessageKind, "InvalidProvider_class_token_only" | "InvalidProvider_scoped_from_root" | "InvalidProvider_unsupported_provider_type">, params?: Record<string, string> & ErrorLocaleOptions);
+}
+export declare class ScopeDisposedError extends Error {
+    constructor(options?: ErrorLocaleOptions);
+}
+export declare class LifetimeViolationError extends Error {
+    readonly fromLifetime: string;
+    readonly toLifetime: string;
+    readonly path: ResolutionPath;
+    constructor(fromLifetime: string, toLifetime: string, path: ResolutionPath, options?: ErrorLocaleOptions);
+}
+export declare class DuplicateProviderError extends Error {
+    readonly token: InjectionToken<unknown>;
+    constructor(token: InjectionToken<unknown>, options?: ErrorLocaleOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/errors.js

@@ -0,0 +1,109 @@
+import { tokenLabel } from "./internal_keys.js";
+import { errorMessage, lifetimeViolationHint, providerNotFoundHint, resolveLocale, } from "./i18n.js";
+export class ProviderNotFoundError extends Error {
+    constructor(token, path, options) {
+        const locale = resolveLocale(options);
+        const label = tokenLabel(token);
+        super(errorMessage("ProviderNotFound", {
+            label,
+            path: path.join(" -> "),
+            hint: providerNotFoundHint(locale),
+        }, locale));
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "ProviderNotFoundError";
+        this.token = token;
+        this.path = path;
+    }
+}
+export class CircularDependencyError extends Error {
+    constructor(path, options) {
+        const locale = resolveLocale(options);
+        super(errorMessage("CircularDependency", {
+            path: path.join(" -> "),
+        }, locale));
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "CircularDependencyError";
+        this.path = path;
+    }
+}
+export class InvalidProviderError extends Error {
+    constructor(messageOrKind, params) {
+        const locale = resolveLocale(params);
+        const text = typeof messageOrKind === "string"
+            ? errorMessage("InvalidProvider_custom", { detail: messageOrKind }, locale)
+            : errorMessage(messageOrKind, params ?? {}, locale);
+        super(text);
+        this.name = "InvalidProviderError";
+    }
+}
+export class ScopeDisposedError extends Error {
+    constructor(options) {
+        const locale = resolveLocale(options);
+        super(errorMessage("ScopeDisposed", {}, locale));
+        this.name = "ScopeDisposedError";
+    }
+}
+export class LifetimeViolationError extends Error {
+    constructor(fromLifetime, toLifetime, path, options) {
+        const locale = resolveLocale(options);
+        super(errorMessage("LifetimeViolation", {
+            fromLifetime,
+            toLifetime,
+            path: path.join(" -> "),
+            hint: lifetimeViolationHint(locale),
+        }, locale));
+        Object.defineProperty(this, "fromLifetime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "toLifetime", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "path", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "LifetimeViolationError";
+        this.fromLifetime = fromLifetime;
+        this.toLifetime = toLifetime;
+        this.path = path;
+    }
+}
+export class DuplicateProviderError extends Error {
+    constructor(token, options) {
+        const locale = resolveLocale(options);
+        const label = tokenLabel(token);
+        super(errorMessage("DuplicateProvider", { label }, locale));
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = "DuplicateProviderError";
+        this.token = token;
+    }
+}

package/esm/core/graph.d.ts

@@ -0,0 +1,26 @@
+import type { Lifetime } from "./lifetime.js";
+import type { NormalizedProvider, ProviderType } from "./provider.js";
+import type { InjectionToken } from "./token.js";
+export interface DependencyNode {
+    id: string;
+    name: string;
+    lifetime: Lifetime;
+    provider: ProviderType;
+}
+export interface DependencyEdge {
+    from: string;
+    to: string;
+}
+export interface DependencyGraph {
+    nodes: DependencyNode[];
+    edges: DependencyEdge[];
+}
+export declare function inferLifetimeForToken(dep: InjectionToken<unknown>): Lifetime;
+export declare function buildGraph(providers: Iterable<NormalizedProvider<unknown>>): DependencyGraph;
+/** Collapses duplicate edges with the same from/to into one */
+export declare function dedupeEdges(edges: DependencyEdge[]): DependencyEdge[];
+import type { RegistryKey } from "./internal_keys.js";
+export declare function collectRegisteredProviders(registry: Map<RegistryKey, NormalizedProvider<unknown>>): NormalizedProvider<unknown>[];
+/** For inspect: include @Injectable-only classes not registered as tokens */
+export declare function augmentGraphWithInjectableClasses(graph: DependencyGraph, extraClasses: Iterable<InjectionToken<unknown>>): DependencyGraph;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/graph.js

@@ -0,0 +1,75 @@
+import { graphNodeId, tokenLabel } from "./internal_keys.js";
+import { getInjectableMetadata } from "./metadata.js";
+export function inferLifetimeForToken(dep) {
+    if (typeof dep === "function") {
+        const meta = getInjectableMetadata(dep);
+        if (meta?.lifetime)
+            return meta.lifetime;
+    }
+    return "singleton";
+}
+export function buildGraph(providers) {
+    const nodes = new Map();
+    const edges = [];
+    const list = [...providers];
+    for (const p of list) {
+        const id = graphNodeId(p.token);
+        nodes.set(id, {
+            id,
+            name: tokenLabel(p.token),
+            lifetime: p.lifetime,
+            provider: p.providerType,
+        });
+    }
+    for (const p of list) {
+        const id = graphNodeId(p.token);
+        for (const dep of p.deps) {
+            const toId = graphNodeId(dep);
+            if (!nodes.has(toId)) {
+                nodes.set(toId, {
+                    id: toId,
+                    name: tokenLabel(dep),
+                    lifetime: inferLifetimeForToken(dep),
+                    provider: "class",
+                });
+            }
+            edges.push({ from: id, to: toId });
+        }
+    }
+    return { nodes: [...nodes.values()], edges: dedupeEdges(edges) };
+}
+/** Collapses duplicate edges with the same from/to into one */
+export function dedupeEdges(edges) {
+    const seen = new Set();
+    const out = [];
+    for (const e of edges) {
+        const key = `${e.from}\0${e.to}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(e);
+    }
+    return out;
+}
+export function collectRegisteredProviders(registry) {
+    return [...registry.values()];
+}
+/** For inspect: include @Injectable-only classes not registered as tokens */
+export function augmentGraphWithInjectableClasses(graph, extraClasses) {
+    const nodes = new Map(graph.nodes.map((n) => [n.id, n]));
+    const edges = [...graph.edges];
+    for (const t of extraClasses) {
+        if (typeof t !== "function")
+            continue;
+        const id = graphNodeId(t);
+        if (nodes.has(id))
+            continue;
+        nodes.set(id, {
+            id,
+            name: tokenLabel(t),
+            lifetime: inferLifetimeForToken(t),
+            provider: "class",
+        });
+    }
+    return { nodes: [...nodes.values()], edges: dedupeEdges(edges) };
+}

package/esm/core/graph_format.d.ts

@@ -0,0 +1,17 @@
+import type { DependencyGraph } from "./graph.js";
+export interface GraphToJsonOptions {
+    indent?: number;
+}
+/**
+ * Serializes the dependency graph to a JSON string.
+ */
+export declare function graphToJson(graph: DependencyGraph, options?: GraphToJsonOptions): string;
+/**
+ * Converts the dependency graph to Graphviz DOT format.
+ */
+export declare function graphToDot(graph: DependencyGraph): string;
+/**
+ * Converts the dependency graph to Mermaid flowchart format.
+ */
+export declare function graphToMermaid(graph: DependencyGraph): string;
+//# sourceMappingURL=graph_format.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/graph_format.js

@@ -0,0 +1,49 @@
+function escapeDotId(id) {
+    return JSON.stringify(id);
+}
+function escapeMermaidId(id) {
+    return id.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+function nodeLabel(node) {
+    return `${node.name} (${node.lifetime})`;
+}
+/**
+ * Serializes the dependency graph to a JSON string.
+ */
+export function graphToJson(graph, options = {}) {
+    const indent = options.indent ?? 2;
+    return JSON.stringify(graph, null, indent);
+}
+/**
+ * Converts the dependency graph to Graphviz DOT format.
+ */
+export function graphToDot(graph) {
+    const lines = ["digraph DependencyGraph {", '  rankdir="LR";'];
+    for (const node of graph.nodes) {
+        const id = escapeDotId(node.id);
+        const label = JSON.stringify(nodeLabel(node));
+        lines.push(`  ${id} [label=${label}];`);
+    }
+    for (const edge of graph.edges) {
+        lines.push(`  ${escapeDotId(edge.from)} -> ${escapeDotId(edge.to)};`);
+    }
+    lines.push("}");
+    return lines.join("\n");
+}
+/**
+ * Converts the dependency graph to Mermaid flowchart format.
+ */
+export function graphToMermaid(graph) {
+    const lines = ["flowchart TD"];
+    for (const node of graph.nodes) {
+        const id = escapeMermaidId(node.id);
+        const label = nodeLabel(node).replace(/"/g, "'");
+        lines.push(`  ${id}["${label}"]`);
+    }
+    for (const edge of graph.edges) {
+        const from = escapeMermaidId(edge.from);
+        const to = escapeMermaidId(edge.to);
+        lines.push(`  ${from} --> ${to}`);
+    }
+    return lines.join("\n");
+}

package/esm/core/i18n.d.ts

@@ -0,0 +1,15 @@
+export type Locale = "en" | "ja";
+export declare const DEFAULT_LOCALE: Locale;
+export type ValidationMessageCode = "unresolved_dependency" | "singleton_depends_on_scoped" | "transient_depends_on_scoped" | "circular_dependency" | "unused_provider";
+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;
+/** Resolve locale from options, env, Intl, or fall back to `en`. */
+export declare function resolveLocale(options?: {
+    locale?: Locale;
+}): Locale;
+export declare function validationMessage(code: ValidationMessageCode, params: Record<string, string>, locale: Locale): string;
+export declare function errorMessage(kind: ErrorMessageKind, params: Record<string, string>, locale: Locale): string;
+export declare function providerNotFoundHint(locale: Locale): string;
+export declare function lifetimeViolationHint(locale: Locale): string;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/i18n.js

@@ -0,0 +1,122 @@
+import * as dntShim from "../_dnt.shims.js";
+export const DEFAULT_LOCALE = "en";
+/** Normalize BCP 47 / POSIX locale tags to supported `en` | `ja`. */
+export function normalizeLocaleTag(tag) {
+    const primary = tag.trim().split(/[-_]/)[0]?.toLowerCase();
+    if (primary === "ja")
+        return "ja";
+    return "en";
+}
+function envGet(key) {
+    try {
+        return dntShim.Deno.env.get(key);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve locale from options, env, Intl, or fall back to `en`. */
+export function resolveLocale(options) {
+    if (options?.locale)
+        return options.locale;
+    const explicit = envGet("WYRLY_LOCALE");
+    if (explicit)
+        return normalizeLocaleTag(explicit);
+    for (const key of ["LC_ALL", "LC_MESSAGES", "LANG"]) {
+        const v = envGet(key);
+        if (v) {
+            const part = v.split(".")[0] ?? v;
+            return normalizeLocaleTag(part.replace("_", "-"));
+        }
+    }
+    try {
+        const intl = Intl.DateTimeFormat().resolvedOptions().locale;
+        if (intl)
+            return normalizeLocaleTag(intl);
+    }
+    catch {
+        // ignore
+    }
+    if (typeof navigator !== "undefined" && navigator.language) {
+        return normalizeLocaleTag(navigator.language);
+    }
+    return DEFAULT_LOCALE;
+}
+export function validationMessage(code, params, locale) {
+    const { fromId, depId, cycle } = params;
+    switch (code) {
+        case "unresolved_dependency":
+            return locale === "ja"
+                ? `${fromId} が未登録の依存 ${depId} を参照しています。`
+                : `${fromId} references unregistered dependency ${depId}.`;
+        case "singleton_depends_on_scoped":
+            return locale === "ja"
+                ? `${fromId} (singleton) が scoped の依存 ${depId} に依存しています。`
+                : `${fromId} (singleton) depends on scoped dependency ${depId}.`;
+        case "transient_depends_on_scoped":
+            return locale === "ja"
+                ? `${fromId} (transient) が scoped の依存 ${depId} に依存しています。実行コンテキストに注意してください。`
+                : `${fromId} (transient) depends on scoped dependency ${depId}. Mind the execution context.`;
+        case "circular_dependency":
+            return locale === "ja" ? `循環依存: ${cycle ?? ""}` : `Circular dependency: ${cycle ?? ""}`;
+        case "unused_provider":
+            return locale === "ja"
+                ? `${fromId} は他の provider から依存されていません（未使用の可能性があります）。`
+                : `${fromId} is not depended on by any other provider (may be unused).`;
+    }
+}
+export function errorMessage(kind, params, locale) {
+    const label = params.label ?? "";
+    const path = params.path ?? "";
+    const hint = params.hint ?? "";
+    const detail = params.detail ?? "";
+    const fromLifetime = params.fromLifetime ?? "";
+    const toLifetime = params.toLifetime ?? "";
+    const providerType = params.providerType ?? "";
+    switch (kind) {
+        case "ProviderNotFound":
+            return locale === "ja"
+                ? `ProviderNotFoundError: ${label} を解決できません。依存パス: [${path}]。${hint}`
+                : `ProviderNotFoundError: Cannot resolve ${label}. Dependency path: [${path}]. ${hint}`;
+        case "CircularDependency":
+            return locale === "ja"
+                ? `CircularDependencyError: 循環依存を検出しました: ${path}。依存関係を見直してください。`
+                : `CircularDependencyError: Circular dependency detected: ${path}. Review your dependency graph.`;
+        case "ScopeDisposed":
+            return locale === "ja"
+                ? "ScopeDisposedError: すでに dispose 済みのスコープで resolve しようとしました。リクエスト終了後に resolve していないか確認してください。"
+                : "ScopeDisposedError: Attempted to resolve on an already disposed scope. Check for resolve after request end.";
+        case "LifetimeViolation":
+            return locale === "ja"
+                ? `LifetimeViolationError: lifetime ${fromLifetime} が ${toLifetime} に依存しようとしています。パス: [${path}]。${hint}`
+                : `LifetimeViolationError: lifetime ${fromLifetime} cannot depend on ${toLifetime}. Path: [${path}]. ${hint}`;
+        case "DuplicateProvider":
+            return locale === "ja"
+                ? `DuplicateProviderError: ${label} はすでに登録されています。上書きする場合は override() を使ってください。`
+                : `DuplicateProviderError: ${label} is already registered. Use override() to replace it.`;
+        case "InvalidProvider_class_token_only":
+            return locale === "ja"
+                ? "InvalidProviderError: provider を省略できるのはクラストークンのみです。"
+                : "InvalidProviderError: Omitting provider is only allowed for class tokens.";
+        case "InvalidProvider_scoped_from_root":
+            return locale === "ja"
+                ? "InvalidProviderError: scoped のプロバイダは createScope() で得た Scope から resolve() してください。"
+                : "InvalidProviderError: Resolve scoped providers from a Scope created via createScope().";
+        case "InvalidProvider_unsupported_provider_type":
+            return locale === "ja"
+                ? `InvalidProviderError: 未対応の providerType: ${providerType}`
+                : `InvalidProviderError: Unsupported providerType: ${providerType}`;
+        case "InvalidProvider_custom":
+            return `InvalidProviderError: ${detail}`;
+    }
+}
+export function providerNotFoundHint(locale) {
+    return locale === "ja"
+        ? "composition root で register() するか、@Injectable() の deps を確認してください。"
+        : "Register it in the composition root or check @Injectable() deps.";
+}
+export function lifetimeViolationHint(locale) {
+    return locale === "ja"
+        ? "singleton は scoped インスタンスに依存できません。scoped にするか、依存を singleton/transient に変更してください。"
+        : "singleton cannot depend on scoped instances. Use scoped lifetime or change dependencies to singleton/transient.";
+}

package/esm/core/internal_keys.d.ts

@@ -0,0 +1,6 @@
+import type { ClassToken, InjectionToken } from "./token.js";
+export type RegistryKey = symbol | ClassToken<unknown>;
+export declare function registryKey(t: InjectionToken<unknown>): RegistryKey;
+export declare function tokenLabel(t: InjectionToken<unknown>): string;
+export declare function graphNodeId(t: InjectionToken<unknown>): string;
+//# sourceMappingURL=internal_keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal_keys.d.ts","sourceRoot":"","sources":["../../src/core/internal_keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAS,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAEvD,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,WAAW,CAGnE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAK7D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAM9D"}

package/esm/core/internal_keys.js

@@ -0,0 +1,18 @@
+export function registryKey(t) {
+    if (typeof t === "function")
+        return t;
+    return t.id;
+}
+export function tokenLabel(t) {
+    if (typeof t === "function") {
+        return `class:${t.name || "(anonymous)"}`;
+    }
+    return `token:${t.name}`;
+}
+export function graphNodeId(t) {
+    if (typeof t === "function") {
+        return `class:${t.name || "(anonymous)"}`;
+    }
+    const tok = t;
+    return `token:${tok.name}@${String(tok.id)}`;
+}

package/esm/core/lifetime.d.ts

@@ -0,0 +1,2 @@
+export type Lifetime = "singleton" | "scoped" | "transient";
+//# sourceMappingURL=lifetime.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/lifetime.js

@@ -0,0 +1 @@
+export {};

package/esm/core/metadata.d.ts

@@ -0,0 +1,10 @@
+import type { ClassToken } from "./token.js";
+import type { Lifetime } from "./lifetime.js";
+import type { InjectionToken } from "./token.js";
+export interface InjectableMetadata {
+    deps?: InjectionToken<unknown>[];
+    lifetime?: Lifetime;
+}
+export declare function setInjectableMetadata(ctor: ClassToken<unknown>, meta: InjectableMetadata): void;
+export declare function getInjectableMetadata(ctor: ClassToken<unknown>): InjectableMetadata | undefined;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/metadata.js

@@ -0,0 +1,7 @@
+const injectableMetadata = new WeakMap();
+export function setInjectableMetadata(ctor, meta) {
+    injectableMetadata.set(ctor, meta);
+}
+export function getInjectableMetadata(ctor) {
+    return injectableMetadata.get(ctor);
+}

package/esm/core/mod.d.ts

@@ -0,0 +1,14 @@
+export { type ClassToken, type InjectionToken, type Token, token } from "./token.js";
+export type { Lifetime } from "./lifetime.js";
+export { Injectable } from "./decorators.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 { 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";
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +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"}

package/esm/core/mod.js

@@ -0,0 +1,7 @@
+export { token } from "./token.js";
+export { Injectable } from "./decorators.js";
+export { createContainer } from "./container.js";
+export { graphToDot, graphToJson, graphToMermaid } from "./graph_format.js";
+export { validateNormalizedProviders } from "./validate.js";
+export { DEFAULT_LOCALE, errorMessage, lifetimeViolationHint, normalizeLocaleTag, providerNotFoundHint, resolveLocale, validationMessage, } from "./i18n.js";
+export { CircularDependencyError, DuplicateProviderError, InvalidProviderError, LifetimeViolationError, ProviderNotFoundError, ScopeDisposedError, } from "./errors.js";

package/esm/core/provider.d.ts

@@ -0,0 +1,42 @@
+import type { Scope } from "./scope.js";
+import type { ClassToken } from "./token.js";
+import type { InjectionToken } from "./token.js";
+import type { Lifetime } from "./lifetime.js";
+export type Provider<T> = ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
+export interface ClassProvider<T> {
+    useClass: ClassToken<T>;
+    deps?: InjectionToken<unknown>[];
+    lifetime?: Lifetime;
+}
+export interface ValueProvider<T> {
+    useValue: T;
+    lifetime?: "singleton";
+}
+/**
+ * MVP supports synchronous factories only. `Promise<T>` is planned for a future `resolveAsync`.
+ */
+export interface FactoryProvider<T> {
+    useFactory: (scope: Scope) => T;
+    deps?: InjectionToken<unknown>[];
+    lifetime?: Lifetime;
+}
+export interface ExistingProvider<T> {
+    useExisting: InjectionToken<T>;
+    lifetime?: Lifetime;
+}
+export type ProviderType = "class" | "value" | "factory" | "existing";
+/** Container-internal representation (normalized after registration) */
+export interface NormalizedProvider<T = unknown> {
+    readonly token: InjectionToken<T>;
+    readonly providerType: ProviderType;
+    readonly deps: readonly InjectionToken<unknown>[];
+    readonly lifetime: Lifetime;
+    readonly displayName: string;
+    readonly useClass?: ClassToken<T>;
+    readonly useValue?: T;
+    readonly useFactory?: (scope: Scope) => T;
+    readonly useExisting?: InjectionToken<T>;
+}
+export declare function normalizeProvider<T>(token: InjectionToken<T>, provider: Provider<T>): NormalizedProvider<T>;
+export declare function syntheticClassProvider<T>(token: ClassToken<T>): NormalizedProvider<T>;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +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"}