@goodie-ts/transformer 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { CodegenOptions } from './codegen.js';
+export { generateCode } from './codegen.js';
+export type { GraphResult } from './graph-builder.js';
+export { buildGraph } from './graph-builder.js';
+export type { ClassTokenRef, InjectionTokenRef, IRBeanDefinition, IRDependency, IRFieldInjection, IRModule, IRProvides, SourceLocation, TokenRef, } from './ir.js';
+export type { TransformerPlugin, TransformOptions, TransformResult, } from './options.js';
+export type { ResolveResult } from './resolver.js';
+export { resolve } from './resolver.js';
+export type { ScannedBean, ScannedConstructorParam, ScannedFieldInjection, ScannedModule, ScannedModuleImport, ScannedProvides, ScannedTypeArgument, ScanResult, } from './scanner.js';
+export { scan } from './scanner.js';
+export { transform, transformInMemory } from './transform.js';
+export { AmbiguousProviderError, CircularDependencyError, GenericTypeResolutionError, InvalidDecoratorUsageError, MissingProviderError, TransformerError, UnresolvableTypeError, } from './transformer-errors.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":"AAEA,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,cAAc,EACd,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// @goodie-ts/transformer — Phase 2: Compile-time DI transformer
+// Code Generator
+export { generateCode } from './codegen.js';
+// Graph Builder
+export { buildGraph } from './graph-builder.js';
+// Resolver
+export { resolve } from './resolver.js';
+// Scanner
+export { scan } from './scanner.js';
+// Pipeline
+export { transform, transformInMemory } from './transform.js';
+// Errors
+export { AmbiguousProviderError, CircularDependencyError, GenericTypeResolutionError, InvalidDecoratorUsageError, MissingProviderError, TransformerError, UnresolvableTypeError, } from './transformer-errors.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,gEAAgE;AAGhE,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAoBhD,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAYxC,UAAU;AACV,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,SAAS;AACT,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/ir.d.ts

@@ -0,0 +1,102 @@
+import type { Scope } from '@goodie-ts/core';
+/** Source location for error messages pointing back to user code. */
+export interface SourceLocation {
+    filePath: string;
+    line: number;
+    column: number;
+}
+/**
+ * Reference to a bean token — either a class constructor or an InjectionToken.
+ *
+ * `kind: 'class'` → the token is the class constructor itself.
+ * `kind: 'injection-token'` → an auto-generated InjectionToken (e.g. from @Provides method name).
+ */
+export type TokenRef = ClassTokenRef | InjectionTokenRef;
+export interface ClassTokenRef {
+    kind: 'class';
+    /** The class name as it appears in user code. */
+    className: string;
+    /** Absolute path to the file that exports this class. */
+    importPath: string;
+}
+export interface InjectionTokenRef {
+    kind: 'injection-token';
+    /** The token description / variable name (e.g. 'dbUrl'). */
+    tokenName: string;
+    /**
+     * If the token comes from a user-declared InjectionToken variable, its import path.
+     * Undefined for auto-generated method-name tokens.
+     */
+    importPath: string | undefined;
+    /**
+     * The original return type annotation for codegen (e.g. 'Repository<User>').
+     * Used to emit typed InjectionToken<T> declarations instead of <unknown>.
+     */
+    typeAnnotation?: string;
+    /**
+     * Map of type name → absolute import path for types referenced in typeAnnotation.
+     * Used to emit correct type-only imports in generated code.
+     */
+    typeImports?: Map<string, string>;
+}
+/** A single dependency of a bean in the IR. */
+export interface IRDependency {
+    tokenRef: TokenRef;
+    optional: boolean;
+    sourceLocation: SourceLocation;
+}
+/** A field injection discovered from @Inject / @Optional on an accessor. */
+export interface IRFieldInjection {
+    fieldName: string;
+    tokenRef: TokenRef;
+    optional: boolean;
+}
+/** A @Provides method discovered inside a @Module class. */
+export interface IRProvides {
+    methodName: string;
+    /** Token for the bean this method produces. */
+    tokenRef: TokenRef;
+    scope: Scope;
+    eager: boolean;
+    /** Dependencies of the method parameters. */
+    dependencies: IRDependency[];
+    sourceLocation: SourceLocation;
+}
+/** A @Module class with its @Provides methods. */
+export interface IRModule {
+    /** The module class itself. */
+    classTokenRef: ClassTokenRef;
+    /** Imported module class refs (from @Module({ imports: [...] })). */
+    imports: ClassTokenRef[];
+    /** @Provides methods defined on this module. */
+    provides: IRProvides[];
+    sourceLocation: SourceLocation;
+}
+/** Full intermediate representation of a single bean. */
+export interface IRBeanDefinition {
+    tokenRef: TokenRef;
+    scope: Scope;
+    eager: boolean;
+    /** Qualifier name from @Named(). */
+    name: string | undefined;
+    /** Constructor parameter dependencies (in order). */
+    constructorDeps: IRDependency[];
+    /** Accessor field injections (in declaration order). */
+    fieldDeps: IRFieldInjection[];
+    /**
+     * How this bean is created:
+     * - 'constructor': `new Class(dep0, dep1)`
+     * - 'provides': `module.method(dep0)` — from a @Provides method
+     */
+    factoryKind: 'constructor' | 'provides';
+    /** For 'provides' beans: the module class and method name. */
+    providesSource: {
+        moduleTokenRef: ClassTokenRef;
+        methodName: string;
+    } | undefined;
+    metadata: Record<string, unknown>;
+    /** All ancestor class tokens (direct parent first, root last). */
+    baseTokenRefs?: ClassTokenRef[];
+    sourceLocation: SourceLocation;
+}
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,qEAAqE;IACrE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gDAAgD;IAChD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qDAAqD;IACrD,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,wDAAwD;IACxD,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,WAAW,EAAE,aAAa,GAAG,UAAU,CAAC;IACxC,8DAA8D;IAC9D,cAAc,EACV;QAAE,cAAc,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACrD,SAAS,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kEAAkE;IAClE,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;CAChC"}

package/dist/ir.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ir.js.map

package/dist/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":""}

package/dist/options.d.ts

@@ -0,0 +1,31 @@
+import type { IRBeanDefinition } from './ir.js';
+/** Options for the compile-time transform pipeline. */
+export interface TransformOptions {
+    /** Path to the tsconfig.json used to create the ts-morph Project. */
+    tsConfigFilePath: string;
+    /** Absolute path for the generated output file. */
+    outputPath: string;
+    /**
+     * Source file globs to scan (relative to tsconfig root).
+     * Defaults to all .ts files in the project.
+     */
+    include?: string[];
+}
+/** Result returned by the transform pipeline. */
+export interface TransformResult {
+    /** The generated source code. */
+    code: string;
+    /** Absolute path where the file was written. */
+    outputPath: string;
+    /** All discovered bean definitions in topological order. */
+    beans: IRBeanDefinition[];
+    /** Non-fatal warnings encountered during transformation. */
+    warnings: string[];
+}
+/** Stub for future plugin support (Phase 3+). */
+export interface TransformerPlugin {
+    name: string;
+    beforeScan?(): void;
+    afterScan?(beans: IRBeanDefinition[]): IRBeanDefinition[];
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB,SAAS,CAAC,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAAC;CAC3D"}

package/dist/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":""}

package/dist/resolver.d.ts

@@ -0,0 +1,14 @@
+import type { IRBeanDefinition, IRModule } from './ir.js';
+import type { ScanResult } from './scanner.js';
+/** Result of the resolver stage. */
+export interface ResolveResult {
+    beans: IRBeanDefinition[];
+    modules: IRModule[];
+    warnings: string[];
+}
+/**
+ * Resolve scanned AST information into typed IR.
+ * Converts raw type names and source files into TokenRefs.
+ */
+export declare function resolve(scanResult: ScanResult): ResolveResult;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAGhB,QAAQ,EAIT,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAMV,UAAU,EACX,MAAM,cAAc,CAAC;AAGtB,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAgB7D"}

package/dist/resolver.js

@@ -0,0 +1,299 @@
+import { UnresolvableTypeError } from './transformer-errors.js';
+/** Primitive types that cannot be used as constructor tokens. */
+const PRIMITIVE_TYPES = new Set([
+    'string',
+    'number',
+    'boolean',
+    'symbol',
+    'bigint',
+    'undefined',
+    'null',
+    'void',
+    'never',
+    'any',
+    'unknown',
+    'object',
+]);
+/**
+ * Resolve scanned AST information into typed IR.
+ * Converts raw type names and source files into TokenRefs.
+ */
+export function resolve(scanResult) {
+    const warnings = [...scanResult.warnings];
+    const beans = [];
+    const modules = [];
+    // Resolve regular beans
+    for (const scanned of scanResult.beans) {
+        beans.push(resolveBean(scanned, warnings));
+    }
+    // Resolve modules
+    for (const scannedModule of scanResult.modules) {
+        modules.push(resolveModule(scannedModule, warnings));
+    }
+    return { beans, modules, warnings };
+}
+function resolveBean(scanned, _warnings) {
+    const constructorDeps = resolveConstructorParams(scanned.constructorParams, scanned.classTokenRef.className);
+    const fieldDeps = resolveFieldInjections(scanned.fieldInjections, scanned.classTokenRef.className);
+    const baseTokenRefs = scanned.baseClasses
+        .filter((bc) => bc.sourceFile !== undefined)
+        .map((bc) => ({
+        kind: 'class',
+        className: bc.className,
+        importPath: bc.sourceFile.getFilePath(),
+    }));
+    const metadata = {};
+    if (scanned.preDestroyMethods.length > 0) {
+        metadata.preDestroyMethods = scanned.preDestroyMethods;
+    }
+    return {
+        tokenRef: scanned.classTokenRef,
+        scope: scanned.scope,
+        eager: scanned.eager,
+        name: scanned.name,
+        constructorDeps,
+        fieldDeps,
+        factoryKind: 'constructor',
+        providesSource: undefined,
+        metadata,
+        baseTokenRefs: baseTokenRefs.length > 0 ? baseTokenRefs : undefined,
+        sourceLocation: scanned.sourceLocation,
+    };
+}
+function resolveModule(scannedModule, _warnings) {
+    const imports = scannedModule.imports.map((imp) => ({
+        kind: 'class',
+        className: imp.className,
+        importPath: imp.sourceFile?.getFilePath() ?? '',
+    }));
+    // Two-pass provides resolution:
+    // Pass 1: resolve return types to get each method's tokenRef + return type name
+    const providesWithTokens = scannedModule.provides.map((p) => ({
+        scanned: p,
+        tokenRef: resolveProvidesReturnType(p.returnTypeName, p.returnTypeSourceFile, p.returnTypeArguments, p.returnResolvedBaseTypeName, p.methodName, p.sourceLocation),
+    }));
+    // Build a map of return type name → provides entries for primitive param resolution
+    const providesByReturnType = new Map();
+    for (const entry of providesWithTokens) {
+        const returnTypeName = entry.scanned.returnTypeName;
+        if (returnTypeName && isPrimitiveType(returnTypeName)) {
+            const existing = providesByReturnType.get(returnTypeName) ?? [];
+            existing.push({
+                methodName: entry.scanned.methodName,
+                tokenRef: entry.tokenRef,
+            });
+            providesByReturnType.set(returnTypeName, existing);
+        }
+    }
+    // Pass 2: resolve params, wiring primitive params to matching provides
+    const provides = providesWithTokens.map(({ scanned: p, tokenRef }) => {
+        const dependencies = resolveProvidesParams(p.params, `${scannedModule.classTokenRef.className}.${p.methodName}`, providesByReturnType);
+        return {
+            methodName: p.methodName,
+            tokenRef,
+            scope: 'singleton',
+            eager: false,
+            dependencies,
+            sourceLocation: p.sourceLocation,
+        };
+    });
+    return {
+        classTokenRef: scannedModule.classTokenRef,
+        imports,
+        provides,
+        sourceLocation: scannedModule.sourceLocation,
+    };
+}
+/**
+ * Resolve @Provides method parameters, with special handling for primitives.
+ * Primitive-typed params are matched to other @Provides methods that return that type.
+ */
+function resolveProvidesParams(params, ownerName, providesByReturnType) {
+    return params.map((param) => {
+        if (!param.typeName) {
+            throw new UnresolvableTypeError(`parameter "${param.paramName}" of ${ownerName}`, param.sourceLocation);
+        }
+        // Primitive param → look up matching @Provides by return type
+        if (isPrimitiveType(param.typeName)) {
+            const candidates = providesByReturnType.get(param.typeName);
+            if (!candidates || candidates.length === 0) {
+                throw new UnresolvableTypeError(`${param.typeName} (parameter "${param.paramName}" of ${ownerName})`, param.sourceLocation);
+            }
+            if (candidates.length === 1) {
+                return {
+                    tokenRef: candidates[0].tokenRef,
+                    optional: false,
+                    sourceLocation: param.sourceLocation,
+                };
+            }
+            // Multiple providers of same type → disambiguate by param name matching method name
+            const match = candidates.find((c) => c.methodName === param.paramName);
+            if (match) {
+                return {
+                    tokenRef: match.tokenRef,
+                    optional: false,
+                    sourceLocation: param.sourceLocation,
+                };
+            }
+            throw new UnresolvableTypeError(`${param.typeName} (parameter "${param.paramName}" of ${ownerName}) — multiple providers exist, use parameter name matching a @Provides method name to disambiguate`, param.sourceLocation);
+        }
+        // Non-primitive → standard resolution
+        return resolveConstructorParam(param, ownerName);
+    });
+}
+/**
+ * Resolve the return type of a @Provides method to a TokenRef.
+ * - Generic class types → InjectionTokenRef with canonical key
+ * - Non-generic class types → ClassTokenRef
+ * - Primitives/interfaces → InjectionTokenRef with method name
+ */
+function resolveProvidesReturnType(typeName, typeSourceFile, typeArguments, resolvedBaseTypeName, methodName, _sourceLocation) {
+    if (!typeName || isPrimitiveType(typeName)) {
+        // Auto-generate InjectionToken from method name
+        return {
+            kind: 'injection-token',
+            tokenName: methodName,
+            importPath: undefined,
+            typeAnnotation: typeName,
+        };
+    }
+    // Generic return type → InjectionTokenRef with canonical name
+    if (typeArguments.length > 0 && resolvedBaseTypeName && typeSourceFile) {
+        const canonicalName = canonicalizeGenericType(resolvedBaseTypeName, typeArguments);
+        const typeImports = collectTypeImports(resolvedBaseTypeName, typeSourceFile, typeArguments);
+        return {
+            kind: 'injection-token',
+            tokenName: canonicalName,
+            importPath: typeSourceFile.getFilePath(),
+            typeAnnotation: canonicalName,
+            typeImports,
+        };
+    }
+    // If there's a source file for the type, it's a class
+    if (typeSourceFile) {
+        return {
+            kind: 'class',
+            className: resolvedBaseTypeName ?? typeName,
+            importPath: typeSourceFile.getFilePath(),
+        };
+    }
+    // Interface or unresolvable type → use method name as token
+    return {
+        kind: 'injection-token',
+        tokenName: methodName,
+        importPath: undefined,
+        typeAnnotation: typeName,
+    };
+}
+function resolveConstructorParams(params, ownerName) {
+    return params.map((param) => resolveConstructorParam(param, ownerName));
+}
+function resolveConstructorParam(param, ownerName) {
+    if (!param.typeName) {
+        throw new UnresolvableTypeError(`parameter "${param.paramName}" of ${ownerName}`, param.sourceLocation);
+    }
+    if (isPrimitiveType(param.typeName)) {
+        throw new UnresolvableTypeError(`${param.typeName} (parameter "${param.paramName}" of ${ownerName})`, param.sourceLocation);
+    }
+    const tokenRef = resolveTypeToTokenRef(param.typeName, param.typeSourceFile, param.typeArguments, param.resolvedBaseTypeName, param.sourceLocation);
+    return {
+        tokenRef,
+        optional: false,
+        sourceLocation: param.sourceLocation,
+    };
+}
+function resolveFieldInjections(fields, ownerName) {
+    return fields.map((field) => resolveFieldInjection(field, ownerName));
+}
+function resolveFieldInjection(field, ownerName) {
+    let tokenRef;
+    if (field.qualifier) {
+        // @Inject('name') → we'll match against @Named beans later in graph-builder
+        // For now, store as an injection-token with the qualifier as name
+        tokenRef = {
+            kind: 'injection-token',
+            tokenName: field.qualifier,
+            importPath: undefined,
+        };
+    }
+    else if (field.typeName && !isPrimitiveType(field.typeName)) {
+        tokenRef = resolveTypeToTokenRef(field.typeName, field.typeSourceFile, field.typeArguments, field.resolvedBaseTypeName, field.sourceLocation);
+    }
+    else {
+        throw new UnresolvableTypeError(`field "${field.fieldName}" of ${ownerName}`, field.sourceLocation);
+    }
+    return {
+        fieldName: field.fieldName,
+        tokenRef,
+        optional: field.optional,
+    };
+}
+function resolveTypeToTokenRef(typeName, typeSourceFile, typeArguments, resolvedBaseTypeName, _sourceLocation) {
+    // Generic type → always InjectionTokenRef with canonical key
+    if (typeArguments.length > 0 && resolvedBaseTypeName && typeSourceFile) {
+        const canonicalName = canonicalizeGenericType(resolvedBaseTypeName, typeArguments);
+        const typeImports = collectTypeImports(resolvedBaseTypeName, typeSourceFile, typeArguments);
+        return {
+            kind: 'injection-token',
+            tokenName: canonicalName,
+            importPath: typeSourceFile.getFilePath(),
+            typeAnnotation: canonicalName,
+            typeImports,
+        };
+    }
+    if (typeSourceFile) {
+        return {
+            kind: 'class',
+            className: resolvedBaseTypeName ?? typeName,
+            importPath: typeSourceFile.getFilePath(),
+        };
+    }
+    // No source file means we can't find the class declaration — treat as interface
+    return {
+        kind: 'injection-token',
+        tokenName: typeName,
+        importPath: undefined,
+    };
+}
+// ── Generic type canonicalization ──
+/**
+ * Build a canonical type name from a base name and type arguments.
+ * E.g. canonicalizeGenericType('Repository', [{typeName: 'User', ...}]) → 'Repository<User>'
+ */
+function canonicalizeGenericType(baseName, typeArguments) {
+    if (typeArguments.length === 0)
+        return baseName;
+    const args = typeArguments.map(canonicalizeTypeArgument).join(', ');
+    return `${baseName}<${args}>`;
+}
+/** Recursively canonicalize a type argument. */
+function canonicalizeTypeArgument(arg) {
+    if (arg.typeArguments.length === 0)
+        return arg.typeName;
+    const nested = arg.typeArguments.map(canonicalizeTypeArgument).join(', ');
+    return `${arg.typeName}<${nested}>`;
+}
+function isPrimitiveType(typeName) {
+    return PRIMITIVE_TYPES.has(typeName);
+}
+/**
+ * Collect type name → import path mappings from type arguments.
+ * Walks the argument tree recursively.
+ */
+function collectTypeImports(baseTypeName, baseSourceFile, typeArguments) {
+    const imports = new Map();
+    if (baseTypeName && baseSourceFile) {
+        imports.set(baseTypeName, baseSourceFile.getFilePath());
+    }
+    function walk(args) {
+        for (const arg of args) {
+            if (arg.typeSourceFile) {
+                imports.set(arg.typeName, arg.typeSourceFile.getFilePath());
+            }
+            walk(arg.typeArguments);
+        }
+    }
+    walk(typeArguments);
+    return imports;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,87 @@
+import type { Scope } from '@goodie-ts/core';
+import { type ClassDeclaration, type Project, type SourceFile } from 'ts-morph';
+import type { ClassTokenRef, SourceLocation } from './ir.js';
+/** A class decorated with @Injectable or @Singleton (but not @Module). */
+export interface ScannedBean {
+    classDeclaration: ClassDeclaration;
+    classTokenRef: ClassTokenRef;
+    scope: Scope;
+    eager: boolean;
+    name: string | undefined;
+    constructorParams: ScannedConstructorParam[];
+    fieldInjections: ScannedFieldInjection[];
+    /** Method names decorated with @PreDestroy(). */
+    preDestroyMethods: string[];
+    /** All ancestor classes (direct parent first, root last). */
+    baseClasses: Array<{
+        className: string;
+        sourceFile: SourceFile | undefined;
+    }>;
+    sourceLocation: SourceLocation;
+}
+/** A resolved type argument for generic types (recursive for nested generics). */
+export interface ScannedTypeArgument {
+    typeName: string;
+    typeSourceFile: SourceFile | undefined;
+    typeArguments: ScannedTypeArgument[];
+}
+/** A constructor parameter discovered via AST analysis. */
+export interface ScannedConstructorParam {
+    paramName: string;
+    typeName: string | undefined;
+    typeSourceFile: SourceFile | undefined;
+    /** Type arguments if this is a generic type (e.g. Repository<User>). */
+    typeArguments: ScannedTypeArgument[];
+    /** The resolved base type name (e.g. 'Repository' for Repository<User>). */
+    resolvedBaseTypeName: string | undefined;
+    sourceLocation: SourceLocation;
+}
+/** A field injection discovered from @Inject / @Optional on an accessor. */
+export interface ScannedFieldInjection {
+    fieldName: string;
+    /** The qualifier argument from @Inject(qualifier). */
+    qualifier: string | undefined;
+    /** Whether @Optional() is present on this field. */
+    optional: boolean;
+    /** The type annotation of the accessor field. */
+    typeName: string | undefined;
+    typeSourceFile: SourceFile | undefined;
+    /** Type arguments if this is a generic type. */
+    typeArguments: ScannedTypeArgument[];
+    /** The resolved base type name (e.g. 'Repository' for Repository<User>). */
+    resolvedBaseTypeName: string | undefined;
+    sourceLocation: SourceLocation;
+}
+/** A @Module class with its @Provides methods. */
+export interface ScannedModule {
+    classDeclaration: ClassDeclaration;
+    classTokenRef: ClassTokenRef;
+    imports: ScannedModuleImport[];
+    provides: ScannedProvides[];
+    sourceLocation: SourceLocation;
+}
+export interface ScannedModuleImport {
+    className: string;
+    sourceFile: SourceFile | undefined;
+}
+/** A @Provides method inside a @Module. */
+export interface ScannedProvides {
+    methodName: string;
+    returnTypeName: string | undefined;
+    returnTypeSourceFile: SourceFile | undefined;
+    /** Type arguments of the return type if generic. */
+    returnTypeArguments: ScannedTypeArgument[];
+    /** The resolved base type name of the return type. */
+    returnResolvedBaseTypeName: string | undefined;
+    params: ScannedConstructorParam[];
+    sourceLocation: SourceLocation;
+}
+/** Result of scanning source files. */
+export interface ScanResult {
+    beans: ScannedBean[];
+    modules: ScannedModule[];
+    warnings: string[];
+}
+/** Scan a ts-morph Project for decorated classes. */
+export declare function scan(project: Project): ScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

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