ioc-manifest 0.3.0

package/dist/groups/resolveGroupPlan.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Builds `IocGroupsManifest` from config `groups` plus assignability against a
+ * named base type. `buildGroupPlan` throws on issues; `analyzeGroupPlan` returns structured errors
+ * for tooling that must not abort the process.
+ */
+import type * as ts from "typescript";
+import { type AssignableImplementationMember, type ContractDefaultGroupMember } from "./baseTypeAssignability.js";
+import { type IocGroupNodeManifest, type IocGroupsManifest } from "../core/manifest.js";
+import type { ResolvedScanDir } from "../generator/manifestPaths.js";
+import type { ResolvedContractRegistration } from "../generator/resolveRegistrationPlan.js";
+/** TypeScript program + paths used to map stored contract type specifiers back to source files. */
+export type GroupDiscoveryBuildContext = {
+    program: ts.Program;
+    generatedDir: string;
+    scanDirs: readonly ResolvedScanDir[];
+};
+export type IocGroupKind = "collection" | "object";
+export type IocGroupDefinition = {
+    kind: IocGroupKind;
+    baseType: string;
+};
+export type IocGroupsConfig = Record<string, IocGroupDefinition>;
+export type GroupPlan = {
+    groupName: string;
+    kind: "collection";
+    baseType: string;
+    members: readonly AssignableImplementationMember[];
+} | {
+    groupName: string;
+    kind: "object";
+    baseType: string;
+    members: readonly ContractDefaultGroupMember[];
+};
+export type GroupPlanIssue = {
+    kind: "groups_not_object";
+} | {
+    kind: "group_invalid_entry";
+    groupName: string;
+} | {
+    kind: "group_unknown_base_type";
+    groupName: string;
+    message: string;
+} | {
+    kind: "group_no_matches";
+    groupName: string;
+    baseType: string;
+} | {
+    kind: "group_duplicate_contract_key";
+    groupName: string;
+    contractKey: string;
+} | {
+    kind: "group_root_key_collision";
+    key: string;
+} | {
+    kind: "group_root_key_reserved_manifest";
+    key: string;
+} | {
+    kind: "group_discovery_missing_context";
+};
+export type GroupPlanResult = {
+    plans: readonly GroupPlan[];
+    manifest: IocGroupsManifest;
+};
+export declare const groupPlanToManifestNode: (plan: GroupPlan) => IocGroupNodeManifest;
+export declare const formatGroupPlanIssue: (issue: GroupPlanIssue) => string;
+export declare const formatGroupPlanIssues: (issues: readonly GroupPlanIssue[]) => string;
+/**
+ * Validates group definitions and emits the manifest subtree for generated `ioc-manifest.ts`.
+ * Requires `discovery` (TypeScript program + `generatedDir` + `scanDirs`) whenever `groups` is set.
+ */
+export declare const buildGroupPlan: (groups: unknown, plans: readonly ResolvedContractRegistration[], discovery: GroupDiscoveryBuildContext | undefined) => GroupPlanResult | undefined;
+export type GroupPlanAnalysis = {
+    ok: true;
+    plans: readonly GroupPlan[];
+    manifest: IocGroupsManifest | undefined;
+    issues: readonly [];
+} | {
+    ok: false;
+    plans: readonly [];
+    manifest: undefined;
+    issues: readonly GroupPlanIssue[];
+};
+/** Non-throwing variant of `buildGroupPlan` for inspectors and CI that collect all issues. */
+export declare const analyzeGroupPlan: (groups: unknown, plans: readonly ResolvedContractRegistration[], discovery: GroupDiscoveryBuildContext | undefined) => GroupPlanAnalysis;
+//# sourceMappingURL=resolveGroupPlan.d.ts.map

package/dist/groups/resolveGroupPlan.d.ts.map

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

package/dist/groups/resolveGroupPlan.js

@@ -0,0 +1,215 @@
+import { collectContractDefaultMembersAssignableToBase, collectImplementationMembersAssignableToBase, resolveDeclaredBaseType, shouldIncludeImplInCollectionGroup, } from "./baseTypeAssignability.js";
+import { IOC_GENERATED_CONTAINER_MANIFEST_FIXED_KEYS, } from "../core/manifest.js";
+const collectReservedCradleKeys = (plans) => {
+    const reserved = new Set();
+    for (const plan of plans) {
+        reserved.add(plan.accessKey);
+        if (plan.collectionKey !== undefined) {
+            reserved.add(plan.collectionKey);
+        }
+        for (const implementation of plan.implementations) {
+            reserved.add(implementation.registrationKey);
+        }
+    }
+    return reserved;
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isValidGroupKind = (value) => value === "collection" || value === "object";
+const validateGroupDefinition = (groupName, raw) => {
+    if (!isRecord(raw)) {
+        return { kind: "group_invalid_entry", groupName };
+    }
+    const kind = raw.kind;
+    const baseType = raw.baseType;
+    if (!isValidGroupKind(kind)) {
+        return { kind: "group_invalid_entry", groupName };
+    }
+    if (typeof baseType !== "string" || baseType.length === 0) {
+        return { kind: "group_invalid_entry", groupName };
+    }
+    const extraKeys = Object.keys(raw).filter((key) => key !== "kind" && key !== "baseType");
+    if (extraKeys.length > 0) {
+        return { kind: "group_invalid_entry", groupName };
+    }
+    return undefined;
+};
+export const groupPlanToManifestNode = (plan) => {
+    if (plan.kind === "collection") {
+        return plan.members.map((member) => ({
+            contractName: member.contractName,
+            registrationKey: member.registrationKey,
+        }));
+    }
+    const out = {};
+    for (const member of plan.members) {
+        out[member.contractKey] = {
+            contractName: member.contractName,
+            registrationKey: member.registrationKey,
+        };
+    }
+    return out;
+};
+const buildObjectGroupMembersOrIssue = (groupName, members) => {
+    const seen = new Set();
+    for (const member of members) {
+        if (seen.has(member.contractKey)) {
+            return {
+                ok: false,
+                issue: {
+                    kind: "group_duplicate_contract_key",
+                    groupName,
+                    contractKey: member.contractKey,
+                },
+            };
+        }
+        seen.add(member.contractKey);
+    }
+    return { ok: true, members: [...members] };
+};
+export const formatGroupPlanIssue = (issue) => {
+    switch (issue.kind) {
+        case "groups_not_object":
+            return "[ioc-config] groups must be an object when set";
+        case "group_invalid_entry":
+            return `[ioc-config] groups.${JSON.stringify(issue.groupName)} must be { kind: "collection" | "object", baseType: string }`;
+        case "group_unknown_base_type":
+            return `[ioc-config] groups.${JSON.stringify(issue.groupName)}: ${issue.message}`;
+        case "group_no_matches":
+            return `[ioc-config] groups.${JSON.stringify(issue.groupName)}: no implementations found for base type ${JSON.stringify(issue.baseType)}`;
+        case "group_duplicate_contract_key":
+            return `[ioc-config] groups.${JSON.stringify(issue.groupName)}: duplicate contract key ${JSON.stringify(issue.contractKey)} in object group`;
+        case "group_root_key_collision":
+            return `[ioc-config] groups root key ${JSON.stringify(issue.key)} collides with an existing Awilix registration key`;
+        case "group_root_key_reserved_manifest":
+            return `[ioc-config] groups root key ${JSON.stringify(issue.key)} is reserved for the generated container manifest (use a different group name)`;
+        case "group_discovery_missing_context":
+            return "[ioc-config] groups require TypeScript program context (program, generatedDir, scanDirs). Use the IoC manifest generator or pass GroupDiscoveryBuildContext into buildGroupPlan.";
+        default: {
+            const exhaustive = issue;
+            return String(exhaustive);
+        }
+    }
+};
+export const formatGroupPlanIssues = (issues) => issues.map((issue) => formatGroupPlanIssue(issue)).join("\n");
+const runGroupPlan = (groups, plans, discovery) => {
+    if (!isRecord(groups)) {
+        return { ok: false, issues: [{ kind: "groups_not_object" }] };
+    }
+    if (discovery === undefined) {
+        return { ok: false, issues: [{ kind: "group_discovery_missing_context" }] };
+    }
+    const checker = discovery.program.getTypeChecker();
+    const reserved = collectReservedCradleKeys(plans);
+    const groupPlans = [];
+    const issues = [];
+    const sortedGroupNames = Object.keys(groups).sort((a, b) => a.localeCompare(b));
+    for (const groupName of sortedGroupNames) {
+        if (IOC_GENERATED_CONTAINER_MANIFEST_FIXED_KEYS.has(groupName)) {
+            issues.push({ kind: "group_root_key_reserved_manifest", key: groupName });
+            continue;
+        }
+        if (reserved.has(groupName)) {
+            issues.push({ kind: "group_root_key_collision", key: groupName });
+            continue;
+        }
+        const definitionIssue = validateGroupDefinition(groupName, groups[groupName]);
+        if (definitionIssue !== undefined) {
+            issues.push(definitionIssue);
+            continue;
+        }
+        const entry = groups[groupName];
+        const base = resolveDeclaredBaseType(discovery.program, checker, entry.baseType);
+        if (!base.ok) {
+            issues.push({
+                kind: "group_unknown_base_type",
+                groupName,
+                message: base.message,
+            });
+            continue;
+        }
+        if (entry.kind === "object") {
+            const objectMembers = collectContractDefaultMembersAssignableToBase(checker, discovery.program, discovery.generatedDir, discovery.scanDirs, plans, base.type);
+            if (objectMembers.length === 0) {
+                issues.push({
+                    kind: "group_no_matches",
+                    groupName,
+                    baseType: entry.baseType,
+                });
+                continue;
+            }
+            const built = buildObjectGroupMembersOrIssue(groupName, objectMembers);
+            if (!built.ok) {
+                issues.push(built.issue);
+                continue;
+            }
+            reserved.add(groupName);
+            groupPlans.push({
+                groupName,
+                kind: "object",
+                baseType: entry.baseType,
+                members: built.members,
+            });
+            continue;
+        }
+        const members = collectImplementationMembersAssignableToBase(checker, discovery.program, discovery.generatedDir, discovery.scanDirs, plans, base.type, shouldIncludeImplInCollectionGroup);
+        if (members.length === 0) {
+            issues.push({
+                kind: "group_no_matches",
+                groupName,
+                baseType: entry.baseType,
+            });
+            continue;
+        }
+        reserved.add(groupName);
+        groupPlans.push({
+            groupName,
+            kind: "collection",
+            baseType: entry.baseType,
+            members,
+        });
+    }
+    if (issues.length > 0) {
+        return { ok: false, issues };
+    }
+    const manifest = {};
+    for (const plan of groupPlans) {
+        manifest[plan.groupName] = groupPlanToManifestNode(plan);
+    }
+    return { ok: true, plans: groupPlans, manifest };
+};
+/**
+ * Validates group definitions and emits the manifest subtree for generated `ioc-manifest.ts`.
+ * Requires `discovery` (TypeScript program + `generatedDir` + `scanDirs`) whenever `groups` is set.
+ */
+export const buildGroupPlan = (groups, plans, discovery) => {
+    if (groups === undefined) {
+        return undefined;
+    }
+    const result = runGroupPlan(groups, plans, discovery);
+    if (!result.ok) {
+        throw new Error(formatGroupPlanIssues(result.issues));
+    }
+    return { plans: result.plans, manifest: result.manifest };
+};
+/** Non-throwing variant of `buildGroupPlan` for inspectors and CI that collect all issues. */
+export const analyzeGroupPlan = (groups, plans, discovery) => {
+    if (groups === undefined) {
+        return { ok: true, plans: [], manifest: undefined, issues: [] };
+    }
+    const result = runGroupPlan(groups, plans, discovery);
+    if (!result.ok) {
+        return {
+            ok: false,
+            plans: [],
+            manifest: undefined,
+            issues: result.issues,
+        };
+    }
+    return {
+        ok: true,
+        plans: result.plans,
+        manifest: result.manifest,
+        issues: [],
+    };
+};
+//# sourceMappingURL=resolveGroupPlan.js.map

package/dist/groups/resolveGroupPlan.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public API for **ioc-manifest**: contract-first factory discovery, generated Awilix manifests,
+ * runtime registration, grouped injections, and inspection helpers.
+ *
+ * Typical flow: define IoC config (`defineIocConfig` / `ioc.config.ts`), run
+ * `generateManifest()` (or the `gen:manifest` script), import the emitted manifest module,
+ * then call `registerIocFromManifest(container, iocManifest)` from the runtime entry.
+ */
+export * from "./core/index.js";
+export { defineIocConfig, getContractLevelConfig, getImplOverrideForImplementation, IOC_CONTRACT_CONFIG_KEY, isIocImplementationOverride, parseContractLevelConfig, type IocConfig, type IocContractMetadata, type IocDiscoveryScanDirs, type IocLifetime, type IocOverride, type IocRegistrationsPerContract, type IocScanDirImportMode, type IocScanDirSpec, type IocWorkspacePackageImportBase, } from "./config/iocConfig.js";
+export { parseDiscoveryScanDirs } from "./config/parseDiscoveryScanDirs.js";
+export { loadIocConfig, resolveIocConfigPath, resolveProjectRootFromIocConfigPath, tryLoadIocConfig, } from "./config/loadIocConfig.js";
+export * from "./runtime/index.js";
+export { generateManifest } from "./generator/generateManifest.js";
+export type { ManifestOptions } from "./generator/manifestOptions.js";
+export { DEFAULT_MANIFEST_OPTIONS, defaultManifestPathsFromProjectRoot, mergeManifestOptionsWithIocConfig, resolveManifestOptions, } from "./generator/manifestOptions.js";
+export { computeManifestModuleSpecifier, emitBarePackageSpecifierFromNodeModulesPath, findResolvedScanDirForFile, generatedExcludePatternForScanRoot, mapTypesPackageToRuntimePackage, normalizeEmittedModuleSpecifier, resolveScanDirEntries, resolveWorkspacePackageImportBases, resolveWorkspacePackageRoot, type ComputeManifestModuleSpecifierOptions, type ManifestRuntimePaths, type ResolvedScanDir, type ResolvedWorkspacePackageImportBase, } from "./generator/manifestPaths.js";
+export { analyzeGroupPlan, buildGroupPlan, formatGroupPlanIssue, formatGroupPlanIssues, groupPlanToManifestNode, type GroupDiscoveryBuildContext, type GroupPlan, type GroupPlanAnalysis, type GroupPlanIssue, type GroupPlanResult, type IocGroupDefinition, type IocGroupKind, type IocGroupsConfig, } from "./groups/resolveGroupPlan.js";
+export type { AssignableImplementationMember, ContractDefaultGroupMember, } from "./groups/baseTypeAssignability.js";
+export { shouldIncludeImplInCollectionGroup } from "./groups/baseTypeAssignability.js";
+export { buildDiscoveryReport, buildInspectionReport, formatDiscoveryReport, formatInspectionReport, resolveDiscoveryManifestContext, runDiscoveryAnalysis, validateManifest, type DiscoveryAnalysisResult, type DiscoveryManifestResolution, type DiscoveryReport, type DiscoveryReportInput, type FormatDiscoveryReportOptions, type InspectionReport, type ManifestValidationIssue, } from "./inspection/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,6BAA6B,GACnC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,mCAAmC,EACnC,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,8BAA8B,EAC9B,2CAA2C,EAC3C,0BAA0B,EAC1B,kCAAkC,EAClC,+BAA+B,EAC/B,+BAA+B,EAC/B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,KAAK,qCAAqC,EAC1C,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,kCAAkC,GACxC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAEvF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Public API for **ioc-manifest**: contract-first factory discovery, generated Awilix manifests,
+ * runtime registration, grouped injections, and inspection helpers.
+ *
+ * Typical flow: define IoC config (`defineIocConfig` / `ioc.config.ts`), run
+ * `generateManifest()` (or the `gen:manifest` script), import the emitted manifest module,
+ * then call `registerIocFromManifest(container, iocManifest)` from the runtime entry.
+ */
+export * from "./core/index.js";
+export { defineIocConfig, getContractLevelConfig, getImplOverrideForImplementation, IOC_CONTRACT_CONFIG_KEY, isIocImplementationOverride, parseContractLevelConfig, } from "./config/iocConfig.js";
+export { parseDiscoveryScanDirs } from "./config/parseDiscoveryScanDirs.js";
+export { loadIocConfig, resolveIocConfigPath, resolveProjectRootFromIocConfigPath, tryLoadIocConfig, } from "./config/loadIocConfig.js";
+export * from "./runtime/index.js";
+export { generateManifest } from "./generator/generateManifest.js";
+export { DEFAULT_MANIFEST_OPTIONS, defaultManifestPathsFromProjectRoot, mergeManifestOptionsWithIocConfig, resolveManifestOptions, } from "./generator/manifestOptions.js";
+export { computeManifestModuleSpecifier, emitBarePackageSpecifierFromNodeModulesPath, findResolvedScanDirForFile, generatedExcludePatternForScanRoot, mapTypesPackageToRuntimePackage, normalizeEmittedModuleSpecifier, resolveScanDirEntries, resolveWorkspacePackageImportBases, resolveWorkspacePackageRoot, } from "./generator/manifestPaths.js";
+export { analyzeGroupPlan, buildGroupPlan, formatGroupPlanIssue, formatGroupPlanIssues, groupPlanToManifestNode, } from "./groups/resolveGroupPlan.js";
+export { shouldIncludeImplInCollectionGroup } from "./groups/baseTypeAssignability.js";
+export { buildDiscoveryReport, buildInspectionReport, formatDiscoveryReport, formatInspectionReport, resolveDiscoveryManifestContext, runDiscoveryAnalysis, validateManifest, } from "./inspection/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,GAUzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,mCAAmC,EACnC,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,8BAA8B,EAC9B,2CAA2C,EAC3C,0BAA0B,EAC1B,kCAAkC,EAClC,+BAA+B,EAC/B,+BAA+B,EAC/B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,GAK5B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GASxB,MAAM,8BAA8B,CAAC;AAOtC,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAEvF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,+BAA+B,EAC/B,oBAAoB,EACpB,gBAAgB,GAQjB,MAAM,uBAAuB,CAAC"}

package/dist/inspection/formatReports.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Plain-text rendering of inspection/discovery reports for terminal output (`ioc` CLI).
+ */
+import type { DiscoveryReport, InspectionReport } from "./reports.js";
+import type { ResolvedContractRegistration } from "../generator/resolveRegistrationPlan.js";
+export declare const formatInspectionReport: (report: InspectionReport) => string;
+export type FormatDiscoveryReportOptions = {
+    /** When omitted, uses TTY + NO_COLOR / FORCE_COLOR (same idea as common CLIs). */
+    color?: boolean;
+};
+export declare const formatDiscoveryReport: (report: DiscoveryReport, options?: FormatDiscoveryReportOptions) => string;
+/** Resolved lifetime + source line per implementation (from registration plan; used with `ioc inspect --discovery`). */
+export declare const formatRegistrationLifetimeInspect: (plan: readonly ResolvedContractRegistration[]) => string;
+//# sourceMappingURL=formatReports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatReports.d.ts","sourceRoot":"","sources":["../../src/inspection/formatReports.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AA2D5F,eAAO,MAAM,sBAAsB,GAAI,QAAQ,gBAAgB,KAAG,MA6BjE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,EACvB,UAAU,4BAA4B,KACrC,MA6CF,CAAC;AAEF,wHAAwH;AACxH,eAAO,MAAM,iCAAiC,GAC5C,MAAM,SAAS,4BAA4B,EAAE,KAC5C,MAqBF,CAAC"}

package/dist/inspection/formatReports.js

@@ -0,0 +1,115 @@
+const shouldColorize = () => {
+    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== "") {
+        return false;
+    }
+    if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== "0") {
+        return true;
+    }
+    return process.stdout.isTTY === true;
+};
+const ansi = (enabled) => {
+    if (!enabled) {
+        const id = (s) => s;
+        return {
+            reset: id(""),
+            bold: id(""),
+            dim: id(""),
+            cyan: id(""),
+            green: id(""),
+            red: id(""),
+            yellow: id(""),
+        };
+    }
+    return {
+        reset: "\x1b[0m",
+        bold: "\x1b[1m",
+        dim: "\x1b[2m",
+        cyan: "\x1b[36m",
+        green: "\x1b[32m",
+        red: "\x1b[31m",
+        yellow: "\x1b[33m",
+    };
+};
+const formatManifestIssues = (issues) => {
+    if (issues.length === 0)
+        return "";
+    return [
+        "Manifest validation:",
+        ...issues.map((i) => `  - [${i.code}] ${i.message}`),
+        "",
+    ].join("\n");
+};
+export const formatInspectionReport = (report) => {
+    const lines = [];
+    const header = formatManifestIssues(report.manifestIssues);
+    if (header.length > 0) {
+        lines.push(header.trimEnd());
+        lines.push("");
+    }
+    for (const c of report.contracts) {
+        lines.push(c.contractName);
+        if (c.defaultImplementationName !== undefined) {
+            lines.push(`  default: ${c.defaultImplementationName}`);
+        }
+        else {
+            lines.push(`  default: (unresolved — see manifest validation)`);
+        }
+        lines.push(`  implementations:`);
+        for (const impl of c.implementations) {
+            lines.push(`    - ${impl.implementationName}`);
+            lines.push(`      lifecycle: ${impl.lifecycle}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+};
+export const formatDiscoveryReport = (report, options) => {
+    const color = options?.color !== undefined ? options.color : shouldColorize();
+    const c = ansi(color);
+    const lines = [];
+    for (const file of report.files) {
+        lines.push(`${c.bold}${c.cyan}${file.modulePath}${c.reset}`);
+        for (const row of file.rows) {
+            const isDiscovered = row.status === "discovered";
+            const statusIcon = isDiscovered ? "✔" : "✖";
+            const icon = `${isDiscovered ? c.green : c.red}${statusIcon}${c.reset}`;
+            if (row.exportName === undefined) {
+                lines.push(`  ${icon} ${isDiscovered ? c.green : c.yellow}${row.status}${c.reset}`);
+                if (row.skipReason) {
+                    lines.push(`    ${c.dim}reason:${c.reset} ${row.skipReason}`);
+                }
+                continue;
+            }
+            lines.push(`  ${icon} ${c.bold}${row.exportName}${c.reset}`);
+            if (row.contractName) {
+                lines.push(`    ${c.dim}contract:${c.reset} ${row.contractName}`);
+            }
+            if (row.registrationKey) {
+                lines.push(`    ${c.dim}registrationKey:${c.reset} ${row.registrationKey}`);
+            }
+            if (row.skipReason) {
+                lines.push(`    ${c.dim}reason:${c.reset} ${c.red}${row.skipReason}${c.reset}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+};
+/** Resolved lifetime + source line per implementation (from registration plan; used with `ioc inspect --discovery`). */
+export const formatRegistrationLifetimeInspect = (plan) => {
+    const contracts = [...plan].sort((a, b) => a.contractName.localeCompare(b.contractName));
+    const lines = ["Resolved registration lifetimes:"];
+    for (const c of contracts) {
+        lines.push(`  ${c.contractName}`);
+        const impls = [...c.implementations].sort((a, b) => a.implementationName.localeCompare(b.implementationName));
+        for (const impl of impls) {
+            lines.push(`    - ${impl.implementationName}`);
+            lines.push(`      lifetime: ${impl.lifetime}`);
+            if (impl.lifetimeSource !== undefined) {
+                lines.push(`      lifetimeSource: ${impl.lifetimeSource}`);
+            }
+        }
+    }
+    return lines.join("\n").trimEnd();
+};
+//# sourceMappingURL=formatReports.js.map

package/dist/inspection/formatReports.js.map

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

package/dist/inspection/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Inspection entry: validate manifests, run discovery analysis, format printable reports.
+ */
+export { buildDiscoveryReport, buildInspectionReport, type DiscoveryExportReportRow, type DiscoveryReport, type DiscoveryReportInput, type InspectionContractReport, type InspectionReport, } from "./reports.js";
+export { resolveDiscoveryManifestContext, runDiscoveryAnalysis, type DiscoveryAnalysisResult, type DiscoveryManifestResolution, } from "./runDiscoveryAnalysis.js";
+export { formatDiscoveryReport, formatInspectionReport, formatRegistrationLifetimeInspect, type FormatDiscoveryReportOptions, } from "./formatReports.js";
+export { validateManifest, type ManifestValidationIssue, } from "./validateManifest.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inspection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iCAAiC,EACjC,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/inspection/index.js

@@ -0,0 +1,8 @@
+/**
+ * Inspection entry: validate manifests, run discovery analysis, format printable reports.
+ */
+export { buildDiscoveryReport, buildInspectionReport, } from "./reports.js";
+export { resolveDiscoveryManifestContext, runDiscoveryAnalysis, } from "./runDiscoveryAnalysis.js";
+export { formatDiscoveryReport, formatInspectionReport, formatRegistrationLifetimeInspect, } from "./formatReports.js";
+export { validateManifest, } from "./validateManifest.js";
+//# sourceMappingURL=index.js.map

package/dist/inspection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inspection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAMtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iCAAiC,GAElC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC"}

package/dist/inspection/reports.d.ts

@@ -0,0 +1,40 @@
+import type { IocContractManifest } from "../core/manifest.js";
+import type { IocDiscoveryAnalysisFiles } from "../generator/discoverFactories/discoveryOutcomeTypes.js";
+import type { ManifestValidationIssue } from "./validateManifest.js";
+export type DiscoveryReportInput = IocDiscoveryAnalysisFiles | {
+    discoveryFiles: IocDiscoveryAnalysisFiles;
+};
+export type InspectionContractReport = {
+    contractName: string;
+    defaultImplementationName: string | undefined;
+    defaultRegistrationKey: string | undefined;
+    implementations: readonly {
+        implementationName: string;
+        registrationKey: string;
+        lifecycle: string;
+        modulePath: string;
+        exportName: string;
+        isDefault: boolean;
+    }[];
+};
+export type InspectionReport = {
+    contracts: readonly InspectionContractReport[];
+    manifestIssues: readonly ManifestValidationIssue[];
+};
+export declare const buildInspectionReport: (contracts: IocContractManifest) => InspectionReport;
+export type DiscoveryExportReportRow = {
+    modulePath: string;
+    exportName?: string;
+    status: "discovered" | "skipped";
+    contractName?: string;
+    skipReason?: string;
+    registrationKey?: string;
+};
+export type DiscoveryReport = {
+    files: readonly {
+        modulePath: string;
+        rows: readonly DiscoveryExportReportRow[];
+    }[];
+};
+export declare const buildDiscoveryReport: (analysisOrFiles: DiscoveryReportInput) => DiscoveryReport;
+//# sourceMappingURL=reports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/inspection/reports.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB;IAAE,cAAc,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,eAAe,EAAE,SAAS;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC/C,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpD,CAAC;AA0BF,eAAO,MAAM,qBAAqB,GAChC,WAAW,mBAAmB,KAC7B,gBAkCF,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,SAAS;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,wBAAwB,EAAE,CAAC;KAC3C,EAAE,CAAC;CACL,CAAC;AA2CF,eAAO,MAAM,oBAAoB,GAC/B,iBAAiB,oBAAoB,KACpC,eAgBF,CAAC"}