ioc-manifest 0.3.0

package/dist/inspection/reports.js

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Builds structured reports for inspection: manifest contracts → human-oriented rows,
+ * plus discovery-oriented summaries from analyzer inputs.
+ */
+import { selectDefaultImplementationName } from "../core/defaultImplementationSelection.js";
+import { validateManifest } from "./validateManifest.js";
+const pickDefault = (contractName, impls) => {
+    const list = Object.values(impls);
+    if (list.length === 0)
+        return undefined;
+    try {
+        const name = selectDefaultImplementationName(contractName, list.map((m) => ({
+            implementationName: m.implementationName,
+            registrationKey: m.registrationKey,
+            ...(m.default === true ? { default: true } : {}),
+        })));
+        const meta = list.find((m) => m.implementationName === name);
+        return meta ? { name, meta } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const buildInspectionReport = (contracts) => {
+    const manifestIssues = validateManifest(contracts);
+    const contractNames = Object.keys(contracts).sort((a, b) => a.localeCompare(b));
+    const contractsOut = contractNames.map((contractName) => {
+        const impls = contracts[contractName];
+        const implKeys = Object.keys(impls).sort((a, b) => a.localeCompare(b));
+        const selected = pickDefault(contractName, impls);
+        return {
+            contractName,
+            defaultImplementationName: selected?.name,
+            defaultRegistrationKey: selected?.meta.registrationKey,
+            implementations: implKeys.map((k) => {
+                const m = impls[k];
+                return {
+                    implementationName: m.implementationName,
+                    registrationKey: m.registrationKey,
+                    lifecycle: m.lifetime,
+                    modulePath: m.modulePath,
+                    exportName: m.exportName,
+                    isDefault: selected?.name === m.implementationName,
+                };
+            }),
+        };
+    });
+    return { contracts: contractsOut, manifestIssues };
+};
+const outcomeToRows = (modulePath, outcome) => {
+    if (outcome.scope === "file") {
+        return [
+            {
+                modulePath,
+                status: "skipped",
+                skipReason: outcome.skipReason,
+            },
+        ];
+    }
+    if (outcome.status === "discovered") {
+        return [
+            {
+                modulePath,
+                exportName: outcome.exportName,
+                status: "discovered",
+                contractName: outcome.contractName,
+                registrationKey: outcome.registrationKey,
+            },
+        ];
+    }
+    return [
+        {
+            modulePath,
+            exportName: outcome.exportName,
+            status: "skipped",
+            skipReason: outcome.skipReason,
+            contractName: outcome.contractName,
+        },
+    ];
+};
+const isDiscoveryFilesArray = (input) => Array.isArray(input);
+export const buildDiscoveryReport = (analysisOrFiles) => {
+    const discoveryFiles = isDiscoveryFilesArray(analysisOrFiles)
+        ? analysisOrFiles
+        : analysisOrFiles.discoveryFiles;
+    const files = discoveryFiles
+        .slice()
+        .sort((a, b) => a.modulePath.localeCompare(b.modulePath))
+        .map((file) => ({
+        modulePath: file.modulePath,
+        rows: file.outcomes.flatMap((o) => outcomeToRows(file.modulePath, o)),
+    }));
+    return { files };
+};
+//# sourceMappingURL=reports.js.map

package/dist/inspection/reports.js.map

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

package/dist/inspection/runDiscoveryAnalysis.d.ts

@@ -0,0 +1,36 @@
+import type { IocConfig } from "../config/iocConfig.js";
+import type { ResolvedContractRegistration } from "../generator/resolveRegistrationPlan.js";
+import type { DiscoveredFactory } from "../generator/types.js";
+import { type ManifestOptions } from "../generator/manifestOptions.js";
+import type { ManifestRuntimePaths } from "../generator/manifestPaths.js";
+import type { IocDiscoveryAnalysisFiles } from "../generator/discoverFactories/discoveryOutcomeTypes.js";
+export type DiscoveryAnalysisResult = {
+    readonly discoveryFiles: IocDiscoveryAnalysisFiles;
+    readonly contractMap: Map<string, Map<string, DiscoveredFactory>>;
+    readonly acceptedFactories: readonly DiscoveredFactory[];
+    /** Resolved lifetimes (includes `lifetimeSource` when built with scanDirs context). */
+    readonly registrationPlan: readonly ResolvedContractRegistration[];
+};
+export type DiscoveryManifestResolution = {
+    readonly cfgPath: string;
+    readonly config: IocConfig | undefined;
+    readonly options: ManifestOptions;
+};
+export declare const resolveDiscoveryManifestContext: (opts?: {
+    iocConfigPath?: string;
+    /** Directory to start searching upward for `ioc.config.ts` (defaults to `paths.projectRoot` or cwd). */
+    searchStartDir?: string;
+    paths?: Partial<ManifestRuntimePaths>;
+}) => Promise<DiscoveryManifestResolution>;
+/**
+ * Re-runs factory discovery from source (and TypeScript) for inspection / CLI.
+ * Does not read or write the generated manifest.
+ */
+export declare const runDiscoveryAnalysis: (opts?: {
+    iocConfigPath?: string;
+    searchStartDir?: string;
+    paths?: Partial<ManifestRuntimePaths>;
+    /** When set, skips config loading (e.g. after {@link resolveDiscoveryManifestContext}). */
+    reuseResolution?: DiscoveryManifestResolution;
+}) => Promise<DiscoveryAnalysisResult>;
+//# sourceMappingURL=runDiscoveryAnalysis.d.ts.map

package/dist/inspection/runDiscoveryAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDiscoveryAnalysis.d.ts","sourceRoot":"","sources":["../../src/inspection/runDiscoveryAnalysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAE5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAY/D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yDAAyD,CAAC;AAEzG,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACzD,uFAAuF;IACvF,QAAQ,CAAC,gBAAgB,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACpE,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAU,OAAO;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACvC,KAAG,OAAO,CAAC,2BAA2B,CAmBtC,CAAC;AA8CF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAU,OAAO;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtC,2FAA2F;IAC3F,eAAe,CAAC,EAAE,2BAA2B,CAAC;CAC/C,KAAG,OAAO,CAAC,uBAAuB,CAIlC,CAAC"}

package/dist/inspection/runDiscoveryAnalysis.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+import { buildRegistrationPlan } from "../generator/resolveRegistrationPlan.js";
+import { resolveIocConfigPath, resolveProjectRootFromIocConfigPath, tryLoadIocConfig, } from "../config/loadIocConfig.js";
+import { discoverFactories } from "../generator/discoverFactories/discoverFactories.js";
+import { createIocProgramForDiscovery, getDiscoveryTargetFiles, reportDiscoveryProgramDiagnostics, } from "../generator/iocProgramContext.js";
+import { mergeManifestOptionsWithIocConfig, resolveManifestOptions, } from "../generator/manifestOptions.js";
+export const resolveDiscoveryManifestContext = async (opts) => {
+    const searchStart = path.resolve(opts?.searchStartDir ?? opts?.paths?.projectRoot ?? process.cwd());
+    const cfgPath = resolveIocConfigPath(searchStart, opts?.iocConfigPath);
+    const config = await tryLoadIocConfig(cfgPath);
+    const projectRoot = config
+        ? resolveProjectRootFromIocConfigPath(cfgPath)
+        : opts?.paths?.projectRoot ?? searchStart;
+    const base = resolveManifestOptions({
+        paths: {
+            ...opts?.paths,
+            projectRoot,
+        },
+    });
+    const options = config
+        ? mergeManifestOptionsWithIocConfig(base, config)
+        : base;
+    return { cfgPath, config, options };
+};
+const runDiscoveryFromResolution = async (resolved) => {
+    const { config, options } = resolved;
+    const { paths: { projectRoot, scanDirs, generatedDir, workspacePackageImportBases }, includePatterns, excludePatterns, factoryExportPrefix, } = options;
+    const files = await getDiscoveryTargetFiles(scanDirs, includePatterns, excludePatterns, generatedDir);
+    const program = createIocProgramForDiscovery(projectRoot, files);
+    reportDiscoveryProgramDiagnostics(program, projectRoot, files);
+    const { contractMap, acceptedFactories, discoveryFiles } = discoverFactories(files, program, projectRoot, factoryExportPrefix, { projectRoot, scanDirs, generatedDir, workspacePackageImportBases }, config ?? undefined, { collectFileRecords: true });
+    const registrationPlan = buildRegistrationPlan(contractMap, config, { projectRoot, scanDirs });
+    return {
+        discoveryFiles,
+        contractMap,
+        acceptedFactories,
+        registrationPlan,
+    };
+};
+/**
+ * Re-runs factory discovery from source (and TypeScript) for inspection / CLI.
+ * Does not read or write the generated manifest.
+ */
+export const runDiscoveryAnalysis = async (opts) => {
+    const resolved = opts?.reuseResolution ?? (await resolveDiscoveryManifestContext(opts));
+    return runDiscoveryFromResolution(resolved);
+};
+//# sourceMappingURL=runDiscoveryAnalysis.js.map

package/dist/inspection/runDiscoveryAnalysis.js.map

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

package/dist/inspection/validateManifest.d.ts

@@ -0,0 +1,8 @@
+import type { IocContractManifest } from "../core/manifest.js";
+export type ManifestValidationIssue = {
+    code: string;
+    contractName?: string;
+    message: string;
+};
+export declare const validateManifest: (manifestByContract: IocContractManifest) => ManifestValidationIssue[];
+//# sourceMappingURL=validateManifest.d.ts.map

package/dist/inspection/validateManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateManifest.d.ts","sourceRoot":"","sources":["../../src/inspection/validateManifest.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,eAAO,MAAM,gBAAgB,GAC3B,oBAAoB,mBAAmB,KACtC,uBAAuB,EA6CzB,CAAC"}

package/dist/inspection/validateManifest.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Static checks on an in-memory `IocContractManifest` (no filesystem). Complements
+ * runtime registration: catches ambiguous defaults before `container.resolve`.
+ */
+import { selectDefaultImplementationName } from "../core/defaultImplementationSelection.js";
+const collectImpls = (impls) => Object.values(impls);
+export const validateManifest = (manifestByContract) => {
+    const issues = [];
+    for (const [contractName, impls] of Object.entries(manifestByContract)) {
+        const list = collectImpls(impls);
+        if (list.length === 0) {
+            issues.push({
+                code: "contract_no_implementations",
+                contractName,
+                message: `Contract ${JSON.stringify(contractName)} has zero implementations in the manifest.`,
+            });
+            continue;
+        }
+        const defaults = list.filter((meta) => meta.default === true);
+        if (defaults.length > 1) {
+            issues.push({
+                code: "multiple_defaults",
+                contractName,
+                message: `Contract ${JSON.stringify(contractName)} has more than one implementation marked default: true.`,
+            });
+            continue;
+        }
+        try {
+            selectDefaultImplementationName(contractName, list.map((meta) => ({
+                implementationName: meta.implementationName,
+                registrationKey: meta.registrationKey,
+                ...(meta.default === true ? { default: true } : {}),
+            })));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            issues.push({
+                code: "multiple_implementations_no_default",
+                contractName,
+                message,
+            });
+        }
+    }
+    return issues;
+};
+//# sourceMappingURL=validateManifest.js.map

package/dist/inspection/validateManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateManifest.js","sourceRoot":"","sources":["../../src/inspection/validateManifest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAY5F,MAAM,YAAY,GAAG,CACnB,KAAoD,EACnB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,kBAAuC,EACZ,EAAE;IAC7B,MAAM,MAAM,GAA8B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,6BAA6B;gBACnC,YAAY;gBACZ,OAAO,EAAE,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,4CAA4C;aAC9F,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAC9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,YAAY;gBACZ,OAAO,EAAE,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,yDAAyD;aAC3G,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,+BAA+B,CAC7B,YAAY,EACZ,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7D,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qCAAqC;gBAC3C,YAAY;gBACZ,OAAO;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/runtime/bootstrap.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Awilix wiring for generated manifests: register implementation factories, wire
+ * default-slot aliases, plural collection keys, and transient group roots. Resolution errors are
+ * normalized to {@link IocResolutionError} with manifest-aware stack traces.
+ */
+import { type AwilixContainer } from "awilix";
+import { type IocRegisterableManifest } from "../core/manifest.js";
+/**
+ * Registers everything described by a generated container manifest into an Awilix container
+ * (implementation factories, default access-key aliases, plural collection keys, and group roots).
+ */
+export declare const registerIocFromManifest: <TCradle extends object>(container: AwilixContainer<TCradle>, manifest: IocRegisterableManifest) => void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAML,KAAK,uBAAuB,EAE7B,MAAM,qBAAqB,CAAC;AA0V7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,SAAS,MAAM,EAC5D,WAAW,eAAe,CAAC,OAAO,CAAC,EACnC,UAAU,uBAAuB,KAChC,IAiBF,CAAC"}

package/dist/runtime/bootstrap.js

@@ -0,0 +1,259 @@
+/**
+ * @fileoverview Awilix wiring for generated manifests: register implementation factories, wire
+ * default-slot aliases, plural collection keys, and transient group roots. Resolution errors are
+ * normalized to {@link IocResolutionError} with manifest-aware stack traces.
+ */
+import { aliasTo, asFunction, Lifetime, } from "awilix";
+import { IOC_GENERATED_CONTAINER_MANIFEST_FIXED_KEYS, } from "../core/manifest.js";
+import { contractNameToCollectionRegistrationKey, contractNameToDefaultRegistrationKey, } from "../generator/naming.js";
+import { propagateIocResolutionFailure } from "./iocResolutionError.js";
+import { frameFromManifestMeta, popIocResolutionFrame, pushIocResolutionFrame, snapshotIocResolutionStack, } from "./iocResolutionStack.js";
+import { selectDefaultImplementationName } from "../core/defaultImplementationSelection.js";
+import { formatMissingDefaultImplementationMessage, formatMissingFactoryExportMessage, formatMissingModuleImportMessage, } from "./iocRuntimeErrors.js";
+import { buildRegistrationKeyIndex, } from "./registrationKeyIndex.js";
+/** Group-root entries only: strips fixed manifest keys (`moduleImports`, `contracts`). */
+const extractGroupRootsFromContainerManifest = (manifest) => {
+    const out = {};
+    for (const key of Object.keys(manifest)) {
+        if (IOC_GENERATED_CONTAINER_MANIFEST_FIXED_KEYS.has(key)) {
+            continue;
+        }
+        const value = manifest[key];
+        if (value === undefined) {
+            continue;
+        }
+        /* Generated manifests only place `IocGroupNodeManifest` values on non-fixed keys. */
+        out[key] = value;
+    }
+    return out;
+};
+const lifetimeToAwilix = (lifetime) => {
+    switch (lifetime) {
+        case "singleton":
+            return Lifetime.SINGLETON;
+        case "scoped":
+            return Lifetime.SCOPED;
+        case "transient":
+            return Lifetime.TRANSIENT;
+        default: {
+            const _exhaustive = lifetime;
+            return _exhaustive;
+        }
+    }
+};
+const registerPair = (container, pair) => {
+    /* Registration keys come from generated manifests; Awilix types cannot express this map statically. */
+    container.register(pair);
+};
+const isFactoryFunction = (value) => typeof value === "function";
+const invokeResolvedFactory = (factory, cradle, meta, keyIndex) => {
+    if (!isFactoryFunction(factory)) {
+        throw new Error("[ioc] internal error: expected resolver factory function");
+    }
+    /**
+     * Always pass the cradle.
+     *
+     * Why:
+     * - `(deps) => Contract` obviously needs it
+     * - `() => Contract` will safely ignore the extra argument in JS
+     * - relying on `factory.length` is fragile for signatures like `(deps = {}) => ...`,
+     *   which report `.length === 0` even though they conceptually accept dependencies
+     */
+    pushIocResolutionFrame(frameFromManifestMeta(meta));
+    try {
+        return factory(cradle);
+    }
+    catch (cause) {
+        return propagateIocResolutionFailure({
+            cause,
+            keyIndex,
+            stackSnapshot: snapshotIocResolutionStack(),
+        });
+    }
+    finally {
+        popIocResolutionFrame();
+    }
+};
+const collectionLifetimeFromImplementations = (impls) => {
+    /**
+     * The collection resolves and returns concrete implementation instances.
+     * Its lifetime therefore must not outlive any member it captures.
+     *
+     * - if any member is transient, collection must be transient
+     * - else if any member is scoped, collection must be scoped
+     * - else singleton is safe
+     */
+    if (impls.some((meta) => meta.lifetime === "transient")) {
+        return Lifetime.TRANSIENT;
+    }
+    if (impls.some((meta) => meta.lifetime === "scoped")) {
+        return Lifetime.SCOPED;
+    }
+    return Lifetime.SINGLETON;
+};
+const resolveDefaultImplementation = (contractName, implList) => {
+    if (implList.length === 0) {
+        throw new Error(`[ioc] No implementation registered for contract ${JSON.stringify(contractName)} (no factories in the manifest for this contract). Add a discoverable factory and re-run manifest generation.`);
+    }
+    const rows = implList.map((m) => ({
+        implementationName: m.implementationName,
+        registrationKey: m.registrationKey,
+        ...(m.default === true ? { default: true } : {}),
+    }));
+    try {
+        const name = selectDefaultImplementationName(contractName, rows);
+        const defaultImpl = implList.find((m) => m.implementationName === name);
+        if (defaultImpl === undefined) {
+            throw new Error(`[ioc] internal error: selected default ${JSON.stringify(name)} missing from manifest for ${JSON.stringify(contractName)}`);
+        }
+        return defaultImpl;
+    }
+    catch (cause) {
+        if (implList.length > 1) {
+            throw new Error(formatMissingDefaultImplementationMessage({
+                contractName,
+                implementationNames: implList.map((m) => m.implementationName),
+                registrationKeys: implList.map((m) => m.registrationKey),
+            }), { cause });
+        }
+        throw cause;
+    }
+};
+const registerImplementationFactories = (container, manifestByContract, moduleImports, keyIndex) => {
+    for (const impls of Object.values(manifestByContract)) {
+        for (const meta of Object.values(impls)) {
+            const ns = moduleImports[meta.moduleIndex];
+            if (!ns) {
+                throw new Error(formatMissingModuleImportMessage({
+                    moduleIndex: meta.moduleIndex,
+                    modulePath: meta.modulePath,
+                }));
+            }
+            const factory = ns[meta.exportName];
+            if (typeof factory !== "function") {
+                throw new Error(formatMissingFactoryExportMessage({
+                    modulePath: meta.modulePath,
+                    exportName: meta.exportName,
+                    contractName: meta.contractName,
+                    registrationKey: meta.registrationKey,
+                }));
+            }
+            registerPair(container, {
+                [meta.registrationKey]: asFunction((cradle) => invokeResolvedFactory(factory, cradle, meta, keyIndex), { lifetime: lifetimeToAwilix(meta.lifetime) }),
+            });
+        }
+    }
+};
+const resolveManifestAccessKey = (contractName, implList) => {
+    const explicit = implList.find((m) => m.accessKey !== undefined)?.accessKey;
+    if (explicit !== undefined) {
+        return explicit;
+    }
+    return contractNameToDefaultRegistrationKey(contractName);
+};
+const registerContractDefaultAliases = (container, manifestByContract) => {
+    for (const [contractName, impls] of Object.entries(manifestByContract)) {
+        const implList = Object.values(impls);
+        const accessKey = resolveManifestAccessKey(contractName, implList);
+        const defaultImpl = resolveDefaultImplementation(contractName, implList);
+        const hasImplementationAtAccessKey = implList.some((meta) => meta.registrationKey === accessKey);
+        if (accessKey !== defaultImpl.registrationKey &&
+            !hasImplementationAtAccessKey) {
+            registerPair(container, {
+                [accessKey]: aliasTo(defaultImpl.registrationKey),
+            });
+        }
+    }
+};
+/**
+ * Registers the automatic per-contract multi-implementation slot: plural collection key →
+ * **array** of all concrete implementations (sorted by `registrationKey`), independent of
+ * configured group roots in the human manifest.
+ */
+const registerImplementationCollections = (container, manifestByContract, keyIndex) => {
+    for (const [contractName, impls] of Object.entries(manifestByContract)) {
+        const implList = [...Object.values(impls)].sort((a, b) => a.registrationKey.localeCompare(b.registrationKey));
+        if (implList.length <= 1) {
+            continue;
+        }
+        const collectionKey = contractNameToCollectionRegistrationKey(contractName);
+        const collectionLifetime = collectionLifetimeFromImplementations(implList);
+        registerPair(container, {
+            [collectionKey]: asFunction((cradle) => {
+                pushIocResolutionFrame({
+                    contractName,
+                    implementationName: "(collection)",
+                    registrationKey: collectionKey,
+                });
+                try {
+                    return implList.map((meta) => cradle[meta.registrationKey]);
+                }
+                catch (cause) {
+                    return propagateIocResolutionFailure({
+                        cause,
+                        keyIndex,
+                        stackSnapshot: snapshotIocResolutionStack(),
+                    });
+                }
+                finally {
+                    popIocResolutionFrame();
+                }
+            }, { lifetime: collectionLifetime }),
+        });
+    }
+};
+const resolveGroupNodeFromCradle = (cradle, node) => {
+    if (Array.isArray(node)) {
+        return node.map((leaf) => cradle[leaf.registrationKey]);
+    }
+    const out = {};
+    for (const [propKey, leaf] of Object.entries(node)) {
+        out[propKey] = cradle[leaf.registrationKey];
+    }
+    return out;
+};
+const registerGroups = (container, groupsManifest, keyIndex) => {
+    if (groupsManifest === undefined) {
+        return;
+    }
+    const rootKeys = Object.keys(groupsManifest).sort((a, b) => a.localeCompare(b));
+    for (const key of rootKeys) {
+        const node = groupsManifest[key];
+        registerPair(container, {
+            [key]: asFunction((cradle) => {
+                pushIocResolutionFrame({
+                    contractName: key,
+                    implementationName: "(group)",
+                    registrationKey: key,
+                });
+                try {
+                    return resolveGroupNodeFromCradle(cradle, node);
+                }
+                catch (cause) {
+                    return propagateIocResolutionFailure({
+                        cause,
+                        keyIndex,
+                        stackSnapshot: snapshotIocResolutionStack(),
+                    });
+                }
+                finally {
+                    popIocResolutionFrame();
+                }
+            }, { lifetime: Lifetime.TRANSIENT }),
+        });
+    }
+};
+/**
+ * Registers everything described by a generated container manifest into an Awilix container
+ * (implementation factories, default access-key aliases, plural collection keys, and group roots).
+ */
+export const registerIocFromManifest = (container, manifest) => {
+    const { contracts: manifestByContract, moduleImports } = manifest;
+    const groupsManifest = extractGroupRootsFromContainerManifest(manifest);
+    const keyIndex = buildRegistrationKeyIndex(manifestByContract);
+    registerImplementationFactories(container, manifestByContract, moduleImports, keyIndex);
+    registerContractDefaultAliases(container, manifestByContract);
+    registerImplementationCollections(container, manifestByContract, keyIndex);
+    registerGroups(container, groupsManifest, keyIndex);
+};
+//# sourceMappingURL=bootstrap.js.map

package/dist/runtime/bootstrap.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export { registerIocFromManifest } from "./bootstrap.js";
+export { applyIocResolutionErrorMessage, createIocResolutionError, formatIocResolutionErrorMessage, IocResolutionError, type IocResolutionFailureType, isIocResolutionError, mergeAncestorStackIntoResolutionError, mergeFrameSequences, type ResolutionFrame, } from "./iocResolutionError.js";
+export { formatMissingContractImplementationMessage, formatMissingDefaultImplementationMessage, formatMissingDependencyMessage, formatMissingFactoryExportMessage, formatMissingModuleImportMessage, type MissingContractImplementationContext, type MissingDefaultContext, type MissingDependencyContext, type MissingFactoryExportContext, type MissingModuleImportContext, } from "./iocRuntimeErrors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0CAA0C,EAC1C,yCAAyC,EACzC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,4 @@
+export { registerIocFromManifest } from "./bootstrap.js";
+export { applyIocResolutionErrorMessage, createIocResolutionError, formatIocResolutionErrorMessage, IocResolutionError, isIocResolutionError, mergeAncestorStackIntoResolutionError, mergeFrameSequences, } from "./iocResolutionError.js";
+export { formatMissingContractImplementationMessage, formatMissingDefaultImplementationMessage, formatMissingDependencyMessage, formatMissingFactoryExportMessage, formatMissingModuleImportMessage, } from "./iocRuntimeErrors.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EAElB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0CAA0C,EAC1C,yCAAyC,EACzC,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,GAMjC,MAAM,uBAAuB,CAAC"}

package/dist/runtime/iocResolutionError.d.ts

@@ -0,0 +1,54 @@
+import type { IocResolutionFrame } from "./iocResolutionStack.js";
+import type { RegistrationKeyIndex } from "./registrationKeyIndex.js";
+export type ResolutionFrame = {
+    contractName: string;
+    implementationName?: string;
+    modulePath?: string;
+    /** Awilix registration key when known (used to merge stacks without duplicating frames). */
+    registrationKey?: string;
+};
+export type IocResolutionFailureType = "missing" | "threw" | "cyclic" | "lifetime";
+/**
+ * Merges an ancestor IoC stack with frames already on an error so parents appear once at the front.
+ */
+export declare const mergeFrameSequences: (ancestorPrefix: readonly ResolutionFrame[], existing: readonly ResolutionFrame[]) => ResolutionFrame[];
+/**
+ * Builds the final user-facing message from structured data (single formatting site).
+ */
+export declare const formatIocResolutionErrorMessage: (err: IocResolutionError, keyIndex: RegistrationKeyIndex) => string;
+export declare class IocResolutionError extends Error {
+    frames: ResolutionFrame[];
+    readonly failureType: IocResolutionFailureType;
+    cause?: Error;
+    /** Set when failureType === "threw" (plain message, not another IocResolutionError string). */
+    throwDetail?: string;
+    /** Awilix diagnostic when failureType is cyclic or lifetime. */
+    awilixDetail?: string;
+    constructor(init: {
+        frames: ResolutionFrame[];
+        failureType: IocResolutionFailureType;
+        cause?: Error;
+        throwDetail?: string;
+        awilixDetail?: string;
+        message?: string;
+    });
+}
+export declare const isIocResolutionError: (value: unknown) => value is IocResolutionError;
+/**
+ * Normalizes any thrown value into an {@link IocResolutionError} without formatting nested IoC errors as strings.
+ */
+export declare const createIocResolutionError: (cause: unknown, keyIndex: RegistrationKeyIndex, stackSnapshot: readonly IocResolutionFrame[]) => IocResolutionError;
+/**
+ * Merges the current IoC stack into an existing resolution error and refreshes {@link Error.message} once.
+ */
+export declare const mergeAncestorStackIntoResolutionError: (err: IocResolutionError, ancestorStack: readonly IocResolutionFrame[]) => void;
+export declare const applyIocResolutionErrorMessage: (err: IocResolutionError, keyIndex: RegistrationKeyIndex) => void;
+/**
+ * Single entry from factory/collection/group boundaries: structured propagation, no nested string wrapping.
+ */
+export declare const propagateIocResolutionFailure: (params: {
+    cause: unknown;
+    keyIndex: RegistrationKeyIndex;
+    stackSnapshot: readonly IocResolutionFrame[];
+}) => never;
+//# sourceMappingURL=iocResolutionError.d.ts.map

package/dist/runtime/iocResolutionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocResolutionError.d.ts","sourceRoot":"","sources":["../../src/runtime/iocResolutionError.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,CAAC;AAKf;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,gBAAgB,SAAS,eAAe,EAAE,EAC1C,UAAU,SAAS,eAAe,EAAE,KACnC,eAAe,EAqBjB,CAAC;AAiOF;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAC1C,KAAK,kBAAkB,EACvB,UAAU,oBAAoB,KAC7B,MAIF,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE;QAChB,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,WAAW,EAAE,wBAAwB,CAAC;QACtC,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAUF;AAED,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,KACb,KAAK,IAAI,kBAAyD,CAAC;AAsDtE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,EACd,UAAU,oBAAoB,EAC9B,eAAe,SAAS,kBAAkB,EAAE,KAC3C,kBAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qCAAqC,GAChD,KAAK,kBAAkB,EACvB,eAAe,SAAS,kBAAkB,EAAE,KAC3C,IAGF,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,KAAK,kBAAkB,EACvB,UAAU,oBAAoB,KAC7B,IAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC9C,KAAG,KAYH,CAAC"}