ioc-manifest 0.3.0

package/dist/config/iocConfig.d.ts

@@ -0,0 +1,97 @@
+import type { IocGroupsConfig } from "../groups/resolveGroupPlan.js";
+export type IocLifetime = "singleton" | "scoped" | "transient";
+/** Reserved key under `registrations[ContractName]` for contract-level metadata (not an implementation). */
+export declare const IOC_CONTRACT_CONFIG_KEY: "$contract";
+/**
+ * Contract-level options under `registrations[ContractName][IOC_CONTRACT_CONFIG_KEY]`.
+ * Separate from per-implementation {@link IocOverride} entries.
+ */
+export type IocContractMetadata = {
+    /**
+     * Cradle / default-slot key for this contract (singular exposure). When omitted, derived from the
+     * contract name (e.g. `Knex` → `knex`).
+     */
+    accessKey?: string;
+};
+/**
+ * Per-implementation overrides in `ioc.config` only (never read from factory modules).
+ * `name` sets the Awilix registration key (maps to internal `registrationKey`).
+ */
+export type IocOverride = {
+    /** Awilix/container registration key; applied as `registrationKey` during planning. */
+    name?: string;
+    lifetime?: IocLifetime;
+    default?: boolean;
+};
+export type IocRegistrationsPerContract = Record<string, IocOverride | IocContractMetadata>;
+export declare const parseContractLevelConfig: (entry: unknown, pathForError: string) => IocContractMetadata;
+export declare const getContractLevelConfig: (perContract: IocRegistrationsPerContract | undefined, contractLabel: string) => IocContractMetadata;
+/** True when the value is per-implementation config (not a misplaced `$contract` object). */
+export declare const isIocImplementationOverride: (value: IocOverride | IocContractMetadata) => value is IocOverride;
+export declare const getImplOverrideForImplementation: (perContract: IocRegistrationsPerContract | undefined, implementationName: string) => IocOverride | undefined;
+/** How manifest import specifiers are built when {@link IocScanDirSpec.importPrefix} is set. */
+export type IocScanDirImportMode = "root" | "subpath";
+/**
+ * Maps a workspace source root to the public import specifier used in generated type-only imports
+ * (e.g. `{ root: "packages/lib/src", importBase: "@acme/lib" }`).
+ */
+export type IocWorkspacePackageImportBase = {
+    /**
+     * Directory root (relative to the IoC package root from {@link resolveProjectRootFromIocConfigPath}
+     * unless absolute). If that path does not exist — e.g. `packages/foo` lives at the monorepo root
+     * but `ioc.config.ts` is under `apps/web` — the resolver walks up ancestors until it finds an
+     * existing directory (see {@link resolveWorkspacePackageRoot}).
+     */
+    root: string;
+    /** Bare module specifier for imports (no file extensions). */
+    importBase: string;
+};
+/**
+ * One discovery root with optional workspace/package import mapping.
+ * `importPrefix` + `importMode` control emitted `import` specifiers; omit both for normal relative imports from the generated dir.
+ */
+export type IocScanDirSpec = {
+    path: string;
+    /** Package or path alias (e.g. `@packages/my-package`). Requires `importMode` when set. */
+    importPrefix?: string;
+    /** Required when `importPrefix` is set. */
+    importMode?: IocScanDirImportMode;
+    /**
+     * Default Awilix registration lifetime for factories discovered under this root (unless overridden
+     * by `registrations[Contract][implementation]`).
+     */
+    scope?: IocLifetime;
+};
+/**
+ * - `string`: single directory (relative to package root unless absolute)
+ * - `string[]`: multiple directories
+ * - `IocScanDirSpec[]`: directories with optional `importPrefix` / `importMode` for manifest imports
+ */
+export type IocDiscoveryScanDirs = string | string[] | IocScanDirSpec[];
+export type IocConfig = {
+    discovery: {
+        scanDirs: IocDiscoveryScanDirs;
+        includes?: string[];
+        excludes?: string[];
+        factoryPrefix?: string;
+        /** Output directory relative to the package root unless absolute. Default: `"generated"`. */
+        generatedDir?: string;
+        /**
+         * When a contract type resolves to a file under `root`, emit `importBase` instead of a long
+         * relative path. Longest matching `root` wins. Checked before `scanDirs` importPrefix/subpath
+         * mapping so public entrypoints can win over deep subpath emission.
+         *
+         * Roots are resolved against the IoC package directory (parent of `src` when the config lives
+         * under `src/`). Monorepo `packages/…` paths are found by walking up to the repo root when needed.
+         */
+        workspacePackageImportBases?: IocWorkspacePackageImportBase[];
+    };
+    registrations?: Record<string, IocRegistrationsPerContract>;
+    /**
+     * Group registrations by assignability to a named `baseType` (interface or type alias in the program).
+     * See {@link IocGroupsConfig}.
+     */
+    groups?: IocGroupsConfig;
+};
+export declare const defineIocConfig: (config: IocConfig) => IocConfig;
+//# sourceMappingURL=iocConfig.d.ts.map

package/dist/config/iocConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iocConfig.d.ts","sourceRoot":"","sources":["../../src/config/iocConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/D,4GAA4G;AAC5G,eAAO,MAAM,uBAAuB,EAAG,WAAoB,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C,MAAM,EACN,WAAW,GAAG,mBAAmB,CAClC,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,EACd,cAAc,MAAM,KACnB,mBA8BF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,aAAa,2BAA2B,GAAG,SAAS,EACpD,eAAe,MAAM,KACpB,mBAYF,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,GACtC,OAAO,WAAW,GAAG,mBAAmB,KACvC,KAAK,IAAI,WAWX,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,aAAa,2BAA2B,GAAG,SAAS,EACpD,oBAAoB,MAAM,KACzB,WAAW,GAAG,SAYhB,CAAC;AAEF,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE;QACT,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,6FAA6F;QAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB;;;;;;;WAOG;QACH,2BAA2B,CAAC,EAAE,6BAA6B,EAAE,CAAC;KAC/D,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC5D;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,KAAG,SAAmB,CAAC"}

package/dist/config/iocConfig.js

@@ -0,0 +1,65 @@
+/** Reserved key under `registrations[ContractName]` for contract-level metadata (not an implementation). */
+export const IOC_CONTRACT_CONFIG_KEY = "$contract";
+export const parseContractLevelConfig = (entry, pathForError) => {
+    if (entry === undefined) {
+        return {};
+    }
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+        throw new Error(`[ioc-config] ${pathForError} must be an object`);
+    }
+    const rec = entry;
+    for (const k of Object.keys(rec)) {
+        if (k !== "accessKey") {
+            throw new Error(`[ioc-config] ${pathForError} has unknown property ${JSON.stringify(k)} (only accessKey is allowed)`);
+        }
+    }
+    const accessKey = rec.accessKey;
+    if (accessKey === undefined) {
+        return {};
+    }
+    if (typeof accessKey !== "string" || accessKey.length === 0) {
+        throw new Error(`[ioc-config] ${pathForError}.accessKey must be a non-empty string when set`);
+    }
+    if (accessKey === IOC_CONTRACT_CONFIG_KEY) {
+        throw new Error(`[ioc-config] ${pathForError}.accessKey cannot be ${JSON.stringify(IOC_CONTRACT_CONFIG_KEY)} (reserved)`);
+    }
+    return { accessKey };
+};
+export const getContractLevelConfig = (perContract, contractLabel) => {
+    if (perContract === undefined) {
+        return {};
+    }
+    const raw = perContract[IOC_CONTRACT_CONFIG_KEY];
+    if (raw === undefined) {
+        return {};
+    }
+    return parseContractLevelConfig(raw, `registrations[${JSON.stringify(contractLabel)}][${JSON.stringify(IOC_CONTRACT_CONFIG_KEY)}]`);
+};
+/** True when the value is per-implementation config (not a misplaced `$contract` object). */
+export const isIocImplementationOverride = (value) => {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if ("name" in value || "lifetime" in value || "default" in value) {
+        return true;
+    }
+    if ("accessKey" in value) {
+        return false;
+    }
+    return true;
+};
+export const getImplOverrideForImplementation = (perContract, implementationName) => {
+    if (perContract === undefined) {
+        return undefined;
+    }
+    if (implementationName === IOC_CONTRACT_CONFIG_KEY) {
+        return undefined;
+    }
+    const raw = perContract[implementationName];
+    if (raw === undefined || !isIocImplementationOverride(raw)) {
+        return undefined;
+    }
+    return raw;
+};
+export const defineIocConfig = (config) => config;
+//# sourceMappingURL=iocConfig.js.map

package/dist/config/iocConfig.js.map

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

package/dist/config/loadIocConfig.d.ts

@@ -0,0 +1,25 @@
+import { type IocConfig } from "./iocConfig.js";
+export declare const loadIocConfig: (absoluteConfigPath: string) => Promise<IocConfig>;
+/**
+ * IoC package root inferred from where `ioc.config` lives: if the config file is under a `src`
+ * directory, the package root is the parent of that `src` (so `discovery.scanDirs` entries stay relative
+ * to the package, not `process.cwd()`). Otherwise the package root is the config file directory.
+ */
+export declare const resolveProjectRootFromIocConfigPath: (absoluteConfigPath: string) => string;
+/**
+ * Resolves the absolute path to `ioc.config.ts`.
+ *
+ * - When `explicitPath` or `IOC_CONFIG` is set, resolves relative to `searchStartDir` if not absolute.
+ * - Otherwise walks upward from `searchStartDir` for `src/ioc.config.ts` / `ioc.config.ts`.
+ * - If none is found upward, searches downward for the shallowest nested `src/ioc.config.ts`
+ *   (glob, excluding `node_modules` and similar). If several are found, throws with a prompt to use
+ *   `--project` / `--config`.
+ * - If still none, returns `searchStartDir/src/ioc.config.ts` (legacy default) for missing-file handling.
+ */
+export declare const resolveIocConfigPath: (searchStartDir: string, explicitPath?: string) => string;
+/**
+ * Returns `undefined` if the file is missing — used when generation should fall back to CLI defaults.
+ * If the file exists, loads it and validates (same as {@link loadIocConfig}).
+ */
+export declare const tryLoadIocConfig: (absoluteConfigPath: string) => Promise<IocConfig | undefined>;
+//# sourceMappingURL=loadIocConfig.d.ts.map

package/dist/config/loadIocConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadIocConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadIocConfig.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAC;AA0QxB,eAAO,MAAM,aAAa,GACxB,oBAAoB,MAAM,KACzB,OAAO,CAAC,SAAS,CAKnB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,oBAAoB,MAAM,KACzB,MAKF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,gBAAgB,MAAM,EACtB,eAAe,MAAM,KACpB,MAwDF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,oBAAoB,MAAM,KACzB,OAAO,CAAC,SAAS,GAAG,SAAS,CAQ/B,CAAC"}

package/dist/config/loadIocConfig.js

@@ -0,0 +1,245 @@
+/**
+ * @fileoverview Loads and validates `ioc.config.ts` (or `--config` / `IOC_CONFIG` overrides).
+ * Fail-fast validation with `[ioc-config]` errors. The loaded module’s default export (or
+ * `iocConfig` / `config`) supplies the raw shape validated into {@link IocConfig}.
+ */
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import fg from "fast-glob";
+import { IOC_CONTRACT_CONFIG_KEY, parseContractLevelConfig, } from "./iocConfig.js";
+import { parseDiscoveryScanDirs } from "./parseDiscoveryScanDirs.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const TOP_LEVEL_KEYS = new Set(["discovery", "registrations", "groups"]);
+const DISCOVERY_KEYS = new Set([
+    "scanDirs",
+    "includes",
+    "excludes",
+    "factoryPrefix",
+    "generatedDir",
+    "workspacePackageImportBases",
+]);
+const IMPL_OVERRIDE_KEYS = new Set(["name", "lifetime", "default"]);
+const assertOnlyKeys = (record, allowed, pathLabel) => {
+    for (const k of Object.keys(record)) {
+        if (!allowed.has(k)) {
+            throw new Error(`[ioc-config] ${pathLabel} has unknown property ${JSON.stringify(k)}`);
+        }
+    }
+};
+const validateWorkspacePackageImportBases = (value, pathLabel) => {
+    if (value === undefined) {
+        return;
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`[ioc-config] ${pathLabel} must be an array when set`);
+    }
+    for (let i = 0; i < value.length; i += 1) {
+        const el = value[i];
+        if (!isRecord(el)) {
+            throw new Error(`[ioc-config] ${pathLabel}[${i}] must be an object`);
+        }
+        assertOnlyKeys(el, new Set(["root", "importBase"]), `${pathLabel}[${i}]`);
+        const root = el.root;
+        if (typeof root !== "string" || root.length === 0) {
+            throw new Error(`[ioc-config] ${pathLabel}[${i}].root must be a non-empty string`);
+        }
+        const importBase = el.importBase;
+        if (typeof importBase !== "string" || importBase.length === 0) {
+            throw new Error(`[ioc-config] ${pathLabel}[${i}].importBase must be a non-empty string`);
+        }
+    }
+};
+const GROUP_KINDS = new Set(["collection", "object"]);
+const IOC_LIFETIMES = new Set(["singleton", "scoped", "transient"]);
+const isIocLifetime = (value) => typeof value === "string" && IOC_LIFETIMES.has(value);
+const validateGroupsShape = (value, pathLabel) => {
+    if (!isRecord(value)) {
+        throw new Error(`[ioc-config] ${pathLabel} must be an object`);
+    }
+    for (const [name, entry] of Object.entries(value)) {
+        if (!isRecord(entry)) {
+            throw new Error(`[ioc-config] ${pathLabel}.${JSON.stringify(name)} must be an object`);
+        }
+        const kind = entry.kind;
+        if (typeof kind !== "string" || !GROUP_KINDS.has(kind)) {
+            throw new Error(`[ioc-config] ${pathLabel}.${JSON.stringify(name)}.kind must be "collection" or "object"`);
+        }
+        const baseType = entry.baseType;
+        if (typeof baseType !== "string" || baseType.length === 0) {
+            throw new Error(`[ioc-config] ${pathLabel}.${JSON.stringify(name)}.baseType must be a non-empty string`);
+        }
+        const allowed = new Set(["kind", "baseType"]);
+        for (const key of Object.keys(entry)) {
+            if (!allowed.has(key)) {
+                throw new Error(`[ioc-config] ${pathLabel}.${JSON.stringify(name)} has unknown property ${JSON.stringify(key)} (only kind and baseType are allowed)`);
+            }
+        }
+    }
+};
+const validateStringArray = (value, pathLabel) => {
+    if (!Array.isArray(value) ||
+        !value.every((item) => typeof item === "string")) {
+        throw new Error(`[ioc-config] ${pathLabel} must be string[] when set`);
+    }
+};
+const validateOptionalNonEmptyString = (value, pathLabel) => {
+    if (value !== undefined &&
+        (typeof value !== "string" || value.length === 0)) {
+        throw new Error(`[ioc-config] ${pathLabel} must be a non-empty string when set`);
+    }
+};
+const validateRegistrationsShape = (registrations, sourceLabel) => {
+    if (registrations === undefined) {
+        return;
+    }
+    if (!isRecord(registrations)) {
+        throw new Error(`[ioc-config] ${sourceLabel} registrations must be an object`);
+    }
+    for (const [contractName, perImplementation] of Object.entries(registrations)) {
+        if (!isRecord(perImplementation)) {
+            throw new Error(`[ioc-config] ${sourceLabel} registrations["${contractName}"] must be an object`);
+        }
+        for (const [implementationName, override] of Object.entries(perImplementation)) {
+            if (!isRecord(override)) {
+                throw new Error(`[ioc-config] ${sourceLabel} registrations["${contractName}"]["${implementationName}"] must be an object`);
+            }
+            if (implementationName === IOC_CONTRACT_CONFIG_KEY) {
+                parseContractLevelConfig(override, `${sourceLabel} registrations["${contractName}"]["${implementationName}"]`);
+                continue;
+            }
+            assertOnlyKeys(override, IMPL_OVERRIDE_KEYS, `${sourceLabel} registrations["${contractName}"]["${implementationName}"]`);
+            if (override.name !== undefined) {
+                if (typeof override.name !== "string" || override.name.length === 0) {
+                    throw new Error(`[ioc-config] ${sourceLabel} registrations["${contractName}"]["${implementationName}"].name must be a non-empty string when set`);
+                }
+            }
+            if (override.lifetime !== undefined &&
+                !isIocLifetime(override.lifetime)) {
+                throw new Error(`[ioc-config] ${sourceLabel} registrations["${contractName}"]["${implementationName}"].lifetime must be singleton | scoped | transient when set`);
+            }
+            if (override.default !== undefined &&
+                typeof override.default !== "boolean") {
+                throw new Error(`[ioc-config] ${sourceLabel} registrations["${contractName}"]["${implementationName}"].default must be a boolean when set`);
+            }
+        }
+    }
+};
+const validateIocConfig = (raw, sourceLabel) => {
+    if (!isRecord(raw)) {
+        throw new Error(`[ioc-config] ${sourceLabel} must export an object`);
+    }
+    assertOnlyKeys(raw, TOP_LEVEL_KEYS, sourceLabel);
+    const discovery = raw.discovery;
+    if (!isRecord(discovery)) {
+        throw new Error(`[ioc-config] ${sourceLabel} is missing discovery`);
+    }
+    assertOnlyKeys(discovery, DISCOVERY_KEYS, `${sourceLabel} discovery`);
+    parseDiscoveryScanDirs(discovery.scanDirs, `${sourceLabel} discovery.scanDirs`);
+    if (discovery.includes !== undefined) {
+        validateStringArray(discovery.includes, `${sourceLabel} discovery.includes`);
+    }
+    if (discovery.excludes !== undefined) {
+        validateStringArray(discovery.excludes, `${sourceLabel} discovery.excludes`);
+    }
+    validateOptionalNonEmptyString(discovery.factoryPrefix, `${sourceLabel} discovery.factoryPrefix`);
+    validateOptionalNonEmptyString(discovery.generatedDir, `${sourceLabel} discovery.generatedDir`);
+    validateWorkspacePackageImportBases(discovery.workspacePackageImportBases, `${sourceLabel} discovery.workspacePackageImportBases`);
+    validateRegistrationsShape(raw.registrations, sourceLabel);
+    if (raw.groups !== undefined) {
+        validateGroupsShape(raw.groups, `${sourceLabel} groups`);
+    }
+    return raw;
+};
+export const loadIocConfig = async (absoluteConfigPath) => {
+    const url = pathToFileURL(absoluteConfigPath).href;
+    const mod = await import(url);
+    const raw = mod.default ?? mod.iocConfig ?? mod.config;
+    return validateIocConfig(raw, absoluteConfigPath);
+};
+const CONFIG_RELATIVE_SEARCH_PATHS = ["src/ioc.config.ts", "ioc.config.ts"];
+/**
+ * IoC package root inferred from where `ioc.config` lives: if the config file is under a `src`
+ * directory, the package root is the parent of that `src` (so `discovery.scanDirs` entries stay relative
+ * to the package, not `process.cwd()`). Otherwise the package root is the config file directory.
+ */
+export const resolveProjectRootFromIocConfigPath = (absoluteConfigPath) => {
+    const configDir = path.dirname(absoluteConfigPath);
+    return path.basename(configDir) === "src"
+        ? path.dirname(configDir)
+        : configDir;
+};
+/**
+ * Resolves the absolute path to `ioc.config.ts`.
+ *
+ * - When `explicitPath` or `IOC_CONFIG` is set, resolves relative to `searchStartDir` if not absolute.
+ * - Otherwise walks upward from `searchStartDir` for `src/ioc.config.ts` / `ioc.config.ts`.
+ * - If none is found upward, searches downward for the shallowest nested `src/ioc.config.ts`
+ *   (glob, excluding `node_modules` and similar). If several are found, throws with a prompt to use
+ *   `--project` / `--config`.
+ * - If still none, returns `searchStartDir/src/ioc.config.ts` (legacy default) for missing-file handling.
+ */
+export const resolveIocConfigPath = (searchStartDir, explicitPath) => {
+    const start = path.resolve(searchStartDir);
+    if (explicitPath !== undefined && explicitPath.length > 0) {
+        return path.isAbsolute(explicitPath)
+            ? explicitPath
+            : path.resolve(start, explicitPath);
+    }
+    const fromEnv = process.env.IOC_CONFIG;
+    if (typeof fromEnv === "string" && fromEnv.length > 0) {
+        return path.isAbsolute(fromEnv)
+            ? fromEnv
+            : path.resolve(start, fromEnv);
+    }
+    let dir = start;
+    const root = path.parse(dir).root;
+    while (true) {
+        for (const rel of CONFIG_RELATIVE_SEARCH_PATHS) {
+            const candidate = path.join(dir, rel);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        if (dir === root) {
+            break;
+        }
+        dir = path.dirname(dir);
+    }
+    const downward = fg.sync("**/src/ioc.config.ts", {
+        cwd: start,
+        absolute: true,
+        onlyFiles: true,
+        unique: true,
+        deep: 15,
+        ignore: [
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/.git/**",
+        ],
+    });
+    const byPathDepth = (a, b) => a.split(path.sep).length - b.split(path.sep).length;
+    const ranked = [...new Set(downward)].sort(byPathDepth);
+    if (ranked.length === 1) {
+        return ranked[0];
+    }
+    if (ranked.length > 1) {
+        throw new Error(`[ioc-config] Multiple src/ioc.config.ts files found under ${start}. Pass --project <path> to the package directory or use --config.`);
+    }
+    return path.join(start, "src", "ioc.config.ts");
+};
+/**
+ * Returns `undefined` if the file is missing — used when generation should fall back to CLI defaults.
+ * If the file exists, loads it and validates (same as {@link loadIocConfig}).
+ */
+export const tryLoadIocConfig = async (absoluteConfigPath) => {
+    try {
+        await fs.access(absoluteConfigPath);
+    }
+    catch {
+        return undefined;
+    }
+    return loadIocConfig(absoluteConfigPath);
+};
+//# sourceMappingURL=loadIocConfig.js.map

package/dist/config/loadIocConfig.js.map

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

package/dist/config/parseDiscoveryScanDirs.d.ts

@@ -0,0 +1,6 @@
+import type { IocScanDirSpec } from "./iocConfig.js";
+/**
+ * Validates and normalizes authoring `scanDirs` into a list of specs (single string → one spec).
+ */
+export declare const parseDiscoveryScanDirs: (raw: unknown, sourceLabel: string) => IocScanDirSpec[];
+//# sourceMappingURL=parseDiscoveryScanDirs.d.ts.map

package/dist/config/parseDiscoveryScanDirs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDiscoveryScanDirs.d.ts","sourceRoot":"","sources":["../../src/config/parseDiscoveryScanDirs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOlE;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,OAAO,EACZ,aAAa,MAAM,KAClB,cAAc,EAsGhB,CAAC"}

package/dist/config/parseDiscoveryScanDirs.js

@@ -0,0 +1,78 @@
+const IOC_LIFETIMES = new Set(["singleton", "scoped", "transient"]);
+const isIocLifetime = (value) => typeof value === "string" && IOC_LIFETIMES.has(value);
+/**
+ * Validates and normalizes authoring `scanDirs` into a list of specs (single string → one spec).
+ */
+export const parseDiscoveryScanDirs = (raw, sourceLabel) => {
+    if (typeof raw === "string") {
+        if (raw.length === 0) {
+            throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs must be a non-empty string when a string is used`);
+        }
+        return [{ path: raw }];
+    }
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs must be a non-empty string, string[], or object[]`);
+    }
+    const out = [];
+    const allowedKeys = new Set(["path", "importPrefix", "importMode", "scope"]);
+    for (let i = 0; i < raw.length; i += 1) {
+        const el = raw[i];
+        if (typeof el === "string") {
+            if (el.length === 0) {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}] must be a non-empty string`);
+            }
+            out.push({ path: el });
+            continue;
+        }
+        if (typeof el !== "object" || el === null || Array.isArray(el)) {
+            throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}] must be a string or an object with path`);
+        }
+        const rec = el;
+        for (const k of Object.keys(rec)) {
+            if (!allowedKeys.has(k)) {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}] has unknown property ${JSON.stringify(k)}`);
+            }
+        }
+        const p = rec.path;
+        if (typeof p !== "string" || p.length === 0) {
+            throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}].path must be a non-empty string`);
+        }
+        const importPrefix = rec.importPrefix;
+        if (importPrefix !== undefined) {
+            if (typeof importPrefix !== "string" || importPrefix.length === 0) {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}].importPrefix must be a non-empty string when set`);
+            }
+        }
+        const importMode = rec.importMode;
+        const scopeRaw = rec.scope;
+        let scope;
+        if (scopeRaw !== undefined) {
+            if (!isIocLifetime(scopeRaw)) {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}].scope must be singleton | scoped | transient when set`);
+            }
+            scope = scopeRaw;
+        }
+        if (importPrefix !== undefined) {
+            if (importMode !== "root" && importMode !== "subpath") {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}].importMode must be "root" or "subpath" when importPrefix is set`);
+            }
+            out.push({
+                path: p,
+                importPrefix,
+                importMode,
+                ...(scope !== undefined ? { scope } : {}),
+            });
+        }
+        else {
+            if (importMode === "root") {
+                throw new Error(`[ioc-config] ${sourceLabel} discovery.scanDirs[${i}].importMode cannot be set to "root" without importPrefix`);
+            }
+            out.push({
+                path: p,
+                ...(scope !== undefined ? { scope } : {}),
+            });
+        }
+    }
+    return out;
+};
+//# sourceMappingURL=parseDiscoveryScanDirs.js.map

package/dist/config/parseDiscoveryScanDirs.js.map

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

package/dist/core/defaultImplementationSelection.d.ts

@@ -0,0 +1,14 @@
+export type ContractDefaultSelectionRow = {
+    readonly implementationName: string;
+    readonly registrationKey: string;
+    readonly default?: boolean;
+};
+/**
+ * Resolves which implementation backs the contract default slot. Precedence:
+ * 1. Exactly one row with `default: true`
+ * 2. Exactly one row whose `registrationKey` equals the contract key (camel-cased contract name)
+ * 3. Exactly one row total
+ * 4. Otherwise throws (ambiguous)
+ */
+export declare const selectDefaultImplementationName: (contractName: string, rows: readonly ContractDefaultSelectionRow[]) => string;
+//# sourceMappingURL=defaultImplementationSelection.d.ts.map

package/dist/core/defaultImplementationSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultImplementationSelection.d.ts","sourceRoot":"","sources":["../../src/core/defaultImplementationSelection.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,GAC1C,cAAc,MAAM,EACpB,MAAM,SAAS,2BAA2B,EAAE,KAC3C,MAkDF,CAAC"}

package/dist/core/defaultImplementationSelection.js

@@ -0,0 +1,47 @@
+import { contractNameToDefaultRegistrationKey } from "../generator/naming.js";
+/**
+ * Resolves which implementation backs the contract default slot. Precedence:
+ * 1. Exactly one row with `default: true`
+ * 2. Exactly one row whose `registrationKey` equals the contract key (camel-cased contract name)
+ * 3. Exactly one row total
+ * 4. Otherwise throws (ambiguous)
+ */
+export const selectDefaultImplementationName = (contractName, rows) => {
+    if (rows.length === 0) {
+        throw new Error(`[ioc] Contract ${JSON.stringify(contractName)} has no implementations.`);
+    }
+    const withDefault = rows.filter((r) => r.default === true);
+    if (withDefault.length > 1) {
+        const names = withDefault
+            .map((r) => r.implementationName)
+            .sort((a, b) => a.localeCompare(b))
+            .map((n) => JSON.stringify(n))
+            .join(", ");
+        throw new Error(`[ioc] Contract ${JSON.stringify(contractName)} has multiple implementations marked default: true after applying ioc.config overrides: ${names}. Mark exactly one with default: true in source or in registrations[${JSON.stringify(contractName)}][implementationName], or reduce to a single implementation.`);
+    }
+    if (withDefault.length === 1) {
+        return withDefault[0].implementationName;
+    }
+    const contractKey = contractNameToDefaultRegistrationKey(contractName);
+    const conventionMatches = rows.filter((r) => r.registrationKey === contractKey);
+    if (conventionMatches.length > 1) {
+        throw new Error(`[ioc] Contract ${JSON.stringify(contractName)} has multiple implementations registered under the contract key ${JSON.stringify(contractKey)}.`);
+    }
+    if (conventionMatches.length === 1) {
+        return conventionMatches[0].implementationName;
+    }
+    if (rows.length === 1) {
+        return rows[0].implementationName;
+    }
+    const names = rows
+        .map((r) => r.implementationName)
+        .sort((a, b) => a.localeCompare(b))
+        .map((n) => JSON.stringify(n))
+        .join(", ");
+    const keys = rows
+        .map((r) => `${r.implementationName}→${JSON.stringify(r.registrationKey)}`)
+        .sort((a, b) => a.localeCompare(b))
+        .join(", ");
+    throw new Error(`[ioc] Contract ${JSON.stringify(contractName)} has ${rows.length} implementations (${names}) but none is selected as the default. Set registrations[${JSON.stringify(contractName)}][implementationName].default: true in ioc.config.ts for exactly one implementation, mark exactly one factory with resolver default: true, register exactly one implementation under the contract key ${JSON.stringify(contractKey)}, or reduce to a single implementation. Registration keys: ${keys}.`);
+};
+//# sourceMappingURL=defaultImplementationSelection.js.map

package/dist/core/defaultImplementationSelection.js.map

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