@goodie-ts/transformer 0.1.0

package/dist/scanner.js

@@ -0,0 +1,386 @@
+import { SyntaxKind, } from 'ts-morph';
+import { InvalidDecoratorUsageError } from './transformer-errors.js';
+/** Names of decorators we recognize from @goodie-ts/decorators. */
+const DECORATOR_NAMES = {
+    Injectable: 'Injectable',
+    Singleton: 'Singleton',
+    Named: 'Named',
+    Eager: 'Eager',
+    Module: 'Module',
+    Provides: 'Provides',
+    Inject: 'Inject',
+    Optional: 'Optional',
+    PreDestroy: 'PreDestroy',
+};
+/** Scan a ts-morph Project for decorated classes. */
+export function scan(project) {
+    const beans = [];
+    const modules = [];
+    const warnings = [];
+    for (const sourceFile of project.getSourceFiles()) {
+        for (const cls of sourceFile.getClasses()) {
+            const decorators = cls.getDecorators();
+            if (decorators.length === 0)
+                continue;
+            const isModule = hasDecorator(decorators, DECORATOR_NAMES.Module);
+            const isInjectable = hasDecorator(decorators, DECORATOR_NAMES.Injectable);
+            const isSingleton = hasDecorator(decorators, DECORATOR_NAMES.Singleton);
+            if ((isModule || isInjectable || isSingleton) && cls.isAbstract()) {
+                const decoratorName = isModule
+                    ? 'Module'
+                    : isSingleton
+                        ? 'Singleton'
+                        : 'Injectable';
+                throw new InvalidDecoratorUsageError(decoratorName, `Cannot apply @${decoratorName}() to abstract class "${cls.getName()}". Abstract classes cannot be instantiated. Remove the decorator or make the class concrete.`, getSourceLocation(cls, sourceFile));
+            }
+            if (isModule) {
+                const scannedModule = scanModule(cls, decorators, sourceFile);
+                if (scannedModule)
+                    modules.push(scannedModule);
+            }
+            else if (isInjectable || isSingleton) {
+                const scannedBean = scanBean(cls, decorators, sourceFile, isSingleton);
+                if (scannedBean)
+                    beans.push(scannedBean);
+            }
+        }
+    }
+    return { beans, modules, warnings };
+}
+function scanBean(cls, decorators, sourceFile, isSingleton) {
+    const className = cls.getName();
+    if (!className)
+        return undefined;
+    const scope = isSingleton ? 'singleton' : 'prototype';
+    const eager = hasDecorator(decorators, DECORATOR_NAMES.Eager);
+    const name = getNamedValue(decorators);
+    const constructorParams = scanConstructorParams(cls);
+    const fieldInjections = scanFieldInjections(cls);
+    const preDestroyMethods = scanPreDestroyMethods(cls);
+    const baseClasses = extractBaseClassChain(cls);
+    return {
+        classDeclaration: cls,
+        classTokenRef: {
+            kind: 'class',
+            className,
+            importPath: sourceFile.getFilePath(),
+        },
+        scope,
+        eager,
+        name,
+        constructorParams,
+        fieldInjections,
+        preDestroyMethods,
+        baseClasses,
+        sourceLocation: getSourceLocation(cls, sourceFile),
+    };
+}
+function scanModule(cls, decorators, sourceFile) {
+    const className = cls.getName();
+    if (!className)
+        return undefined;
+    const moduleDecorator = findDecorator(decorators, DECORATOR_NAMES.Module);
+    const imports = getModuleImports(moduleDecorator);
+    const provides = scanProvidesMethods(cls, sourceFile);
+    return {
+        classDeclaration: cls,
+        classTokenRef: {
+            kind: 'class',
+            className,
+            importPath: sourceFile.getFilePath(),
+        },
+        imports,
+        provides,
+        sourceLocation: getSourceLocation(cls, sourceFile),
+    };
+}
+function scanConstructorParams(cls) {
+    const ctor = cls.getConstructors()[0];
+    if (!ctor)
+        return [];
+    return ctor.getParameters().map((param) => {
+        const typeNode = param.getTypeNode();
+        let typeName;
+        let typeSourceFile;
+        let typeArguments = [];
+        let resolvedBaseTypeName;
+        if (typeNode) {
+            typeName = typeNode.getText();
+            const paramType = param.getType();
+            const typeSymbol = paramType.getSymbol();
+            if (typeSymbol) {
+                const decls = typeSymbol.getDeclarations();
+                if (decls.length > 0) {
+                    typeSourceFile = decls[0].getSourceFile();
+                }
+                resolvedBaseTypeName = typeSymbol.getName();
+            }
+            typeArguments = extractTypeArguments(paramType);
+        }
+        return {
+            paramName: param.getName(),
+            typeName,
+            typeSourceFile,
+            typeArguments,
+            resolvedBaseTypeName,
+            sourceLocation: getSourceLocation(param, param.getSourceFile()),
+        };
+    });
+}
+function scanFieldInjections(cls) {
+    const results = [];
+    for (const prop of cls.getProperties()) {
+        const decorators = prop.getDecorators();
+        const injectDec = findDecorator(decorators, DECORATOR_NAMES.Inject);
+        const optionalDec = findDecorator(decorators, DECORATOR_NAMES.Optional);
+        if (!injectDec && !optionalDec)
+            continue;
+        const hasAccessor = prop.hasAccessorKeyword?.() ?? false;
+        if (!hasAccessor && !injectDec && !optionalDec)
+            continue;
+        let qualifier;
+        if (injectDec) {
+            const args = injectDec.getArguments();
+            if (args.length > 0) {
+                const argText = args[0].getText();
+                // String literal: 'name' or "name"
+                if ((argText.startsWith("'") && argText.endsWith("'")) ||
+                    (argText.startsWith('"') && argText.endsWith('"'))) {
+                    qualifier = argText.slice(1, -1);
+                }
+                else {
+                    // InjectionToken variable reference — store the identifier text
+                    qualifier = argText;
+                }
+            }
+        }
+        const typeNode = prop.getTypeNode();
+        let typeName;
+        let typeSourceFile;
+        let typeArguments = [];
+        let resolvedBaseTypeName;
+        if (typeNode) {
+            typeName = typeNode.getText();
+            const propType = prop.getType();
+            const typeSymbol = propType.getSymbol();
+            if (typeSymbol) {
+                const decls = typeSymbol.getDeclarations();
+                if (decls.length > 0) {
+                    typeSourceFile = decls[0].getSourceFile();
+                }
+                resolvedBaseTypeName = typeSymbol.getName();
+            }
+            typeArguments = extractTypeArguments(propType);
+        }
+        results.push({
+            fieldName: String(prop.getName()),
+            qualifier,
+            optional: optionalDec !== undefined,
+            typeName,
+            typeSourceFile,
+            typeArguments,
+            resolvedBaseTypeName,
+            sourceLocation: getSourceLocation(prop, prop.getSourceFile()),
+        });
+    }
+    return results;
+}
+function scanProvidesMethods(cls, sourceFile) {
+    const results = [];
+    for (const method of cls.getMethods()) {
+        const decorators = method.getDecorators();
+        if (!hasDecorator(decorators, DECORATOR_NAMES.Provides))
+            continue;
+        const returnTypeNode = method.getReturnTypeNode();
+        let returnTypeName;
+        let returnTypeSourceFile;
+        let returnTypeArguments = [];
+        let returnResolvedBaseTypeName;
+        if (returnTypeNode) {
+            returnTypeName = returnTypeNode.getText();
+            const returnType = method.getReturnType();
+            const typeSymbol = returnType.getSymbol();
+            if (typeSymbol) {
+                const decls = typeSymbol.getDeclarations();
+                if (decls.length > 0) {
+                    returnTypeSourceFile = decls[0].getSourceFile();
+                }
+                returnResolvedBaseTypeName = typeSymbol.getName();
+            }
+            returnTypeArguments = extractTypeArguments(returnType);
+        }
+        const params = method.getParameters().map((param) => {
+            const typeNode = param.getTypeNode();
+            let typeName;
+            let typeSourceFile;
+            let typeArguments = [];
+            let resolvedBaseTypeName;
+            if (typeNode) {
+                typeName = typeNode.getText();
+                const paramType = param.getType();
+                const typeSymbol = paramType.getSymbol();
+                if (typeSymbol) {
+                    const decls = typeSymbol.getDeclarations();
+                    if (decls.length > 0) {
+                        typeSourceFile = decls[0].getSourceFile();
+                    }
+                    resolvedBaseTypeName = typeSymbol.getName();
+                }
+                typeArguments = extractTypeArguments(paramType);
+            }
+            return {
+                paramName: param.getName(),
+                typeName,
+                typeSourceFile,
+                typeArguments,
+                resolvedBaseTypeName,
+                sourceLocation: getSourceLocation(param, param.getSourceFile()),
+            };
+        });
+        results.push({
+            methodName: method.getName(),
+            returnTypeName,
+            returnTypeSourceFile,
+            returnTypeArguments,
+            returnResolvedBaseTypeName,
+            params,
+            sourceLocation: getSourceLocation(method, sourceFile),
+        });
+    }
+    return results;
+}
+// ── @PreDestroy scanning ──
+function scanPreDestroyMethods(cls) {
+    const methods = [];
+    for (const method of cls.getMethods()) {
+        const decorators = method.getDecorators();
+        if (hasDecorator(decorators, DECORATOR_NAMES.PreDestroy)) {
+            methods.push(method.getName());
+        }
+    }
+    return methods;
+}
+// ── Base class extraction ──
+/**
+ * Walk the full inheritance chain and return all ancestor classes
+ * (direct parent first, root last).
+ */
+function extractBaseClassChain(cls) {
+    const result = [];
+    const seen = new Set();
+    let current = cls;
+    while (current) {
+        const extendsExpr = current.getExtends();
+        if (!extendsExpr)
+            break;
+        const baseType = extendsExpr.getType();
+        const symbol = baseType.getSymbol();
+        if (!symbol)
+            break;
+        const className = symbol.getName();
+        if (seen.has(className))
+            break; // guard against cycles
+        seen.add(className);
+        let sourceFile;
+        const decls = symbol.getDeclarations();
+        if (decls.length > 0) {
+            sourceFile = decls[0].getSourceFile();
+        }
+        result.push({ className, sourceFile });
+        // Try to get the ClassDeclaration for the parent to continue walking
+        const parentDecl = decls.find((d) => d.getKindName() === 'ClassDeclaration');
+        current = parentDecl;
+    }
+    return result;
+}
+// ── Generic type helpers ──
+/** Extract type arguments from a ts-morph Type, recursively for nested generics. */
+function extractTypeArguments(type) {
+    const typeArgs = type.getTypeArguments();
+    if (typeArgs.length === 0)
+        return [];
+    return typeArgs.map((arg) => {
+        const symbol = arg.getSymbol();
+        let typeSourceFile;
+        if (symbol) {
+            const decls = symbol.getDeclarations();
+            if (decls.length > 0) {
+                typeSourceFile = decls[0].getSourceFile();
+            }
+        }
+        return {
+            typeName: symbol?.getName() ?? arg.getText(),
+            typeSourceFile,
+            typeArguments: extractTypeArguments(arg),
+        };
+    });
+}
+// ── Decorator helpers ──
+function hasDecorator(decorators, name) {
+    return findDecorator(decorators, name) !== undefined;
+}
+function findDecorator(decorators, name) {
+    return decorators.find((d) => d.getName() === name);
+}
+function getNamedValue(decorators) {
+    const dec = findDecorator(decorators, DECORATOR_NAMES.Named);
+    if (!dec)
+        return undefined;
+    const args = dec.getArguments();
+    if (args.length === 0)
+        return undefined;
+    const text = args[0].getText();
+    if ((text.startsWith("'") && text.endsWith("'")) ||
+        (text.startsWith('"') && text.endsWith('"'))) {
+        return text.slice(1, -1);
+    }
+    return text;
+}
+function getModuleImports(decorator) {
+    const args = decorator.getArguments();
+    if (args.length === 0)
+        return [];
+    const arg = args[0];
+    // The argument should be an object literal: { imports: [A, B] }
+    if (arg.getKind() !== SyntaxKind.ObjectLiteralExpression)
+        return [];
+    const objLiteral = arg.asKind(SyntaxKind.ObjectLiteralExpression);
+    if (!objLiteral)
+        return [];
+    const importsProp = objLiteral.getProperty('imports');
+    if (!importsProp)
+        return [];
+    const initializer = importsProp
+        .asKind(SyntaxKind.PropertyAssignment)
+        ?.getInitializer();
+    if (!initializer ||
+        initializer.getKind() !== SyntaxKind.ArrayLiteralExpression)
+        return [];
+    const arrayLiteral = initializer.asKind(SyntaxKind.ArrayLiteralExpression);
+    if (!arrayLiteral)
+        return [];
+    return arrayLiteral.getElements().map((element) => {
+        const text = element.getText();
+        const symbol = element.getType().getSymbol();
+        let sourceFile;
+        if (symbol) {
+            const decls = symbol.getDeclarations();
+            if (decls.length > 0) {
+                sourceFile = decls[0].getSourceFile();
+            }
+        }
+        return { className: text, sourceFile };
+    });
+}
+// ── Source location ──
+function getSourceLocation(node, sourceFile) {
+    const line = node.getStartLineNumber();
+    const start = node.getStart();
+    const { column } = sourceFile.getLineAndColumnAtPos(start);
+    return {
+        filePath: sourceFile.getFilePath(),
+        line,
+        column,
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,UAAU,GAEX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,mEAAmE;AACnE,MAAM,eAAe,GAAG;IACtB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;CAChB,CAAC;AAwFX,qDAAqD;AACrD,MAAM,UAAU,IAAI,CAAC,OAAgB;IACnC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEtC,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YAClE,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1E,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;YAExE,IAAI,CAAC,QAAQ,IAAI,YAAY,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;gBAClE,MAAM,aAAa,GAAG,QAAQ;oBAC5B,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,WAAW;wBACX,CAAC,CAAC,WAAW;wBACb,CAAC,CAAC,YAAY,CAAC;gBACnB,MAAM,IAAI,0BAA0B,CAClC,aAAa,EACb,iBAAiB,aAAa,yBAAyB,GAAG,CAAC,OAAO,EAAE,8FAA8F,EAClK,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnC,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;gBAC9D,IAAI,aAAa;oBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;gBACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;gBACvE,IAAI,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,QAAQ,CACf,GAAqB,EACrB,UAAuB,EACvB,UAAsB,EACtB,WAAoB;IAEpB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,KAAK,GAAU,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE/C,OAAO;QACL,gBAAgB,EAAE,GAAG;QACrB,aAAa,EAAE;YACb,IAAI,EAAE,OAAO;YACb,SAAS;YACT,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE;SACrC;QACD,KAAK;QACL,KAAK;QACL,IAAI;QACJ,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,WAAW;QACX,cAAc,EAAE,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,GAAqB,EACrB,UAAuB,EACvB,UAAsB;IAEtB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,MAAM,eAAe,GAAG,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAE,CAAC;IAC3E,MAAM,OAAO,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAEtD,OAAO;QACL,gBAAgB,EAAE,GAAG;QACrB,aAAa,EAAE;YACb,IAAI,EAAE,OAAO;YACb,SAAS;YACT,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE;SACrC;QACD,OAAO;QACP,QAAQ;QACR,cAAc,EAAE,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAqB;IAErB,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,QAA4B,CAAC;QACjC,IAAI,cAAsC,CAAC;QAC3C,IAAI,aAAa,GAA0B,EAAE,CAAC;QAC9C,IAAI,oBAAwC,CAAC;QAE7C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;gBAC5C,CAAC;gBACD,oBAAoB,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;YAC9C,CAAC;YACD,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;QAED,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE;YAC1B,QAAQ;YACR,cAAc;YACd,aAAa;YACb,oBAAoB;YACpB,cAAc,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;SAChE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAqB;IAChD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;QAExE,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;YAAE,SAAS;QAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,KAAK,CAAC;QACzD,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;YAAE,SAAS;QAEzD,IAAI,SAA6B,CAAC;QAClC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAClC,mCAAmC;gBACnC,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAClD,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAClD,CAAC;oBACD,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,gEAAgE;oBAChE,SAAS,GAAG,OAAO,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,QAA4B,CAAC;QACjC,IAAI,cAAsC,CAAC;QAC3C,IAAI,aAAa,GAA0B,EAAE,CAAC;QAC9C,IAAI,oBAAwC,CAAC;QAE7C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;gBAC5C,CAAC;gBACD,oBAAoB,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;YAC9C,CAAC;YACD,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,SAAS;YACT,QAAQ,EAAE,WAAW,KAAK,SAAS;YACnC,QAAQ;YACR,cAAc;YACd,aAAa;YACb,oBAAoB;YACpB,cAAc,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAqB,EACrB,UAAsB;IAEtB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,CAAC;YAAE,SAAS;QAElE,MAAM,cAAc,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAClD,IAAI,cAAkC,CAAC;QACvC,IAAI,oBAA4C,CAAC;QACjD,IAAI,mBAAmB,GAA0B,EAAE,CAAC;QACpD,IAAI,0BAA8C,CAAC;QAEnD,IAAI,cAAc,EAAE,CAAC;YACnB,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,oBAAoB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;gBAClD,CAAC;gBACD,0BAA0B,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;YACpD,CAAC;YACD,mBAAmB,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,QAA4B,CAAC;YACjC,IAAI,cAAsC,CAAC;YAC3C,IAAI,aAAa,GAA0B,EAAE,CAAC;YAC9C,IAAI,oBAAwC,CAAC;YAE7C,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;gBACzC,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;oBAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;oBAC5C,CAAC;oBACD,oBAAoB,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9C,CAAC;gBACD,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAClD,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE;gBAC1B,QAAQ;gBACR,cAAc;gBACd,aAAa;gBACb,oBAAoB;gBACpB,cAAc,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;aAChE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE;YAC5B,cAAc;YACd,oBAAoB;YACpB,mBAAmB;YACnB,0BAA0B;YAC1B,MAAM;YACN,cAAc,EAAE,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6BAA6B;AAE7B,SAAS,qBAAqB,CAAC,GAAqB;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,IAAI,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8BAA8B;AAE9B;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,GAAqB;IAErB,MAAM,MAAM,GAGP,EAAE,CAAC;IACR,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAiC,GAAG,CAAC;IAEhD,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW;YAAE,MAAM;QAExB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,MAAM;QAEnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,MAAM,CAAC,uBAAuB;QACvD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEpB,IAAI,UAAkC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAEvC,qEAAqE;QACrE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,kBAAkB,CAC9C,CAAC;QACF,OAAO,GAAG,UAA0C,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6BAA6B;AAE7B,oFAAoF;AACpF,SAAS,oBAAoB,CAAC,IAAU;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,cAAsC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE;YAC5C,cAAc;YACd,aAAa,EAAE,oBAAoB,CAAC,GAAG,CAAC;SACzC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0BAA0B;AAE1B,SAAS,YAAY,CAAC,UAAuB,EAAE,IAAY;IACzD,OAAO,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,aAAa,CACpB,UAAuB,EACvB,IAAY;IAEZ,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,UAAuB;IAC5C,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/B,IACE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC5C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAoB;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,gEAAgE;IAChE,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,uBAAuB;QAAE,OAAO,EAAE,CAAC;IAEpE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAG,WAAW;SAC5B,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC;QACtC,EAAE,cAAc,EAAE,CAAC;IACrB,IACE,CAAC,WAAW;QACZ,WAAW,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,sBAAsB;QAE3D,OAAO,EAAE,CAAC;IAEZ,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAC3E,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAE7B,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;QAC7C,IAAI,UAAkC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wBAAwB;AAExB,SAAS,iBAAiB,CACxB,IAA0D,EAC1D,UAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE;QAClC,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/transform.d.ts

@@ -0,0 +1,13 @@
+import { Project } from 'ts-morph';
+import type { TransformOptions, TransformResult } from './options.js';
+/**
+ * Run the full compile-time transform pipeline:
+ *   Source Files → Scanner → Resolver → Graph Builder → Code Generator → output file
+ */
+export declare function transform(options: TransformOptions): TransformResult;
+/**
+ * Run the pipeline in-memory without writing to disk.
+ * Useful for testing and tooling integration.
+ */
+export declare function transformInMemory(project: Project, outputPath: string): TransformResult;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAStE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAqCpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,eAAe,CAejB"}

package/dist/transform.js

@@ -0,0 +1,65 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Project } from 'ts-morph';
+import { generateCode } from './codegen.js';
+import { buildGraph } from './graph-builder.js';
+import { resolve } from './resolver.js';
+import { scan } from './scanner.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_VERSION = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf-8')).version;
+/**
+ * Run the full compile-time transform pipeline:
+ *   Source Files → Scanner → Resolver → Graph Builder → Code Generator → output file
+ */
+export function transform(options) {
+    // 1. Create ts-morph Project
+    const project = new Project({
+        tsConfigFilePath: options.tsConfigFilePath,
+    });
+    // If include patterns are specified, filter source files
+    if (options.include && options.include.length > 0) {
+        project.addSourceFilesAtPaths(options.include);
+    }
+    // 2. Scan
+    const scanResult = scan(project);
+    // 3. Resolve
+    const resolveResult = resolve(scanResult);
+    // 4. Build graph (validate + topo sort)
+    const graphResult = buildGraph(resolveResult);
+    // 5. Generate code
+    const code = generateCode(graphResult.beans, {
+        outputPath: options.outputPath,
+        version: PKG_VERSION,
+    });
+    // 6. Write output
+    const outputDir = path.dirname(options.outputPath);
+    fs.mkdirSync(outputDir, { recursive: true });
+    fs.writeFileSync(options.outputPath, code, 'utf-8');
+    return {
+        code,
+        outputPath: options.outputPath,
+        beans: graphResult.beans,
+        warnings: graphResult.warnings,
+    };
+}
+/**
+ * Run the pipeline in-memory without writing to disk.
+ * Useful for testing and tooling integration.
+ */
+export function transformInMemory(project, outputPath) {
+    const scanResult = scan(project);
+    const resolveResult = resolve(scanResult);
+    const graphResult = buildGraph(resolveResult);
+    const code = generateCode(graphResult.beans, {
+        outputPath,
+        version: PKG_VERSION,
+    });
+    return {
+        code,
+        outputPath,
+        beans: graphResult.beans,
+        warnings: graphResult.warnings,
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,WAAW,GAAW,IAAI,CAAC,KAAK,CACpC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CACrE,CAAC,OAAO,CAAC;AAEV;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC3C,CAAC,CAAC;IAEH,yDAAyD;IACzD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,UAAU;IACV,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjC,aAAa;IACb,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1C,wCAAwC;IACxC,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAE9C,mBAAmB;IACnB,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE;QAC3C,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpD,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,UAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE;QAC3C,UAAU;QACV,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,UAAU;QACV,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;AACJ,CAAC"}

package/dist/transformer-errors.d.ts

@@ -0,0 +1,42 @@
+import type { SourceLocation } from './ir.js';
+/** Base error for all compile-time transformer failures. */
+export declare class TransformerError extends Error {
+    readonly sourceLocation: SourceLocation;
+    readonly hint: string | undefined;
+    constructor(message: string, sourceLocation: SourceLocation, hint: string | undefined);
+}
+/** A required dependency has no registered provider. */
+export declare class MissingProviderError extends TransformerError {
+    readonly tokenDescription: string;
+    readonly requiredBy: string;
+    constructor(tokenDescription: string, requiredBy: string, sourceLocation: SourceLocation);
+}
+/** Multiple providers match a dependency and no qualifier disambiguates. */
+export declare class AmbiguousProviderError extends TransformerError {
+    readonly tokenDescription: string;
+    readonly candidates: string[];
+    constructor(tokenDescription: string, candidates: string[], sourceLocation: SourceLocation);
+}
+/** A constructor parameter or field type cannot be resolved at compile time. */
+export declare class UnresolvableTypeError extends TransformerError {
+    readonly typeDescription: string;
+    constructor(typeDescription: string, sourceLocation: SourceLocation);
+}
+/** A decorator is used in an unsupported position or combination. */
+export declare class InvalidDecoratorUsageError extends TransformerError {
+    readonly decoratorName: string;
+    readonly reason: string;
+    constructor(decoratorName: string, reason: string, sourceLocation: SourceLocation);
+}
+/** A generic type could not be resolved to a canonical form. */
+export declare class GenericTypeResolutionError extends TransformerError {
+    readonly typeName: string;
+    readonly reason: string;
+    constructor(typeName: string, reason: string, sourceLocation: SourceLocation);
+}
+/** Circular dependency detected at compile time with full cycle path. */
+export declare class CircularDependencyError extends TransformerError {
+    readonly cyclePath: string[];
+    constructor(cyclePath: string[], sourceLocation: SourceLocation);
+}
+//# sourceMappingURL=transformer-errors.d.ts.map

package/dist/transformer-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer-errors.d.ts","sourceRoot":"","sources":["../src/transformer-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C,4DAA4D;AAC5D,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,cAAc,EAAE,cAAc;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;gBAFjC,OAAO,EAAE,MAAM,EACN,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,MAAM,GAAG,SAAS;CASpC;AAED,wDAAwD;AACxD,qBAAa,oBAAqB,SAAQ,gBAAgB;IAEtD,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM;gBADlB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAC3B,cAAc,EAAE,cAAc;CASjC;AAED,4EAA4E;AAC5E,qBAAa,sBAAuB,SAAQ,gBAAgB;IAExD,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;gBADpB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAAE,EAC7B,cAAc,EAAE,cAAc;CASjC;AAED,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,gBAAgB;IAEvD,QAAQ,CAAC,eAAe,EAAE,MAAM;gBAAvB,eAAe,EAAE,MAAM,EAChC,cAAc,EAAE,cAAc;CASjC;AAED,qEAAqE;AACrE,qBAAa,0BAA2B,SAAQ,gBAAgB;IAE5D,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACvB,cAAc,EAAE,cAAc;CASjC;AAED,gEAAgE;AAChE,qBAAa,0BAA2B,SAAQ,gBAAgB;IAE5D,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACvB,cAAc,EAAE,cAAc;CASjC;AAED,yEAAyE;AACzE,qBAAa,uBAAwB,SAAQ,gBAAgB;IAEzD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;gBAAnB,SAAS,EAAE,MAAM,EAAE,EAC5B,cAAc,EAAE,cAAc;CASjC"}

package/dist/transformer-errors.js

@@ -0,0 +1,81 @@
+function formatLocation(loc) {
+    return `${loc.filePath}:${loc.line}:${loc.column}`;
+}
+/** Base error for all compile-time transformer failures. */
+export class TransformerError extends Error {
+    sourceLocation;
+    hint;
+    constructor(message, sourceLocation, hint) {
+        const parts = [message, '', `  ${formatLocation(sourceLocation)}`];
+        if (hint) {
+            parts.push('', `  ${hint}`);
+        }
+        super(parts.join('\n'));
+        this.sourceLocation = sourceLocation;
+        this.hint = hint;
+        this.name = 'TransformerError';
+    }
+}
+/** A required dependency has no registered provider. */
+export class MissingProviderError extends TransformerError {
+    tokenDescription;
+    requiredBy;
+    constructor(tokenDescription, requiredBy, sourceLocation) {
+        super(`No provider found for "${tokenDescription}" (required by ${requiredBy})`, sourceLocation, 'Ensure the dependency is decorated with @Injectable(), @Singleton(), or provided by a @Module.');
+        this.tokenDescription = tokenDescription;
+        this.requiredBy = requiredBy;
+        this.name = 'MissingProviderError';
+    }
+}
+/** Multiple providers match a dependency and no qualifier disambiguates. */
+export class AmbiguousProviderError extends TransformerError {
+    tokenDescription;
+    candidates;
+    constructor(tokenDescription, candidates, sourceLocation) {
+        super(`Ambiguous provider for "${tokenDescription}": found ${candidates.join(', ')}`, sourceLocation, 'Use @Named() on the providers and @Inject(name) on the injection point to disambiguate.');
+        this.tokenDescription = tokenDescription;
+        this.candidates = candidates;
+        this.name = 'AmbiguousProviderError';
+    }
+}
+/** A constructor parameter or field type cannot be resolved at compile time. */
+export class UnresolvableTypeError extends TransformerError {
+    typeDescription;
+    constructor(typeDescription, sourceLocation) {
+        super(`Cannot resolve type "${typeDescription}" at compile time`, sourceLocation, 'Use a concrete class type, or use @Inject(token) on an accessor field for interfaces/primitives.');
+        this.typeDescription = typeDescription;
+        this.name = 'UnresolvableTypeError';
+    }
+}
+/** A decorator is used in an unsupported position or combination. */
+export class InvalidDecoratorUsageError extends TransformerError {
+    decoratorName;
+    reason;
+    constructor(decoratorName, reason, sourceLocation) {
+        super(`Invalid usage of @${decoratorName}: ${reason}`, sourceLocation, undefined);
+        this.decoratorName = decoratorName;
+        this.reason = reason;
+        this.name = 'InvalidDecoratorUsageError';
+    }
+}
+/** A generic type could not be resolved to a canonical form. */
+export class GenericTypeResolutionError extends TransformerError {
+    typeName;
+    reason;
+    constructor(typeName, reason, sourceLocation) {
+        super(`Cannot resolve generic type "${typeName}": ${reason}`, sourceLocation, 'Ensure the generic type has concrete type arguments and the base class is importable.');
+        this.typeName = typeName;
+        this.reason = reason;
+        this.name = 'GenericTypeResolutionError';
+    }
+}
+/** Circular dependency detected at compile time with full cycle path. */
+export class CircularDependencyError extends TransformerError {
+    cyclePath;
+    constructor(cyclePath, sourceLocation) {
+        super(`Circular dependency detected: ${cyclePath.join(' → ')}`, sourceLocation, 'Break the cycle by using @Optional() on an accessor field or restructuring your dependencies.');
+        this.cyclePath = cyclePath;
+        this.name = 'CircularDependencyError';
+    }
+}
+//# sourceMappingURL=transformer-errors.js.map

package/dist/transformer-errors.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@goodie-ts/transformer",
+  "version": "0.1.0",
+  "description": "Compile-time TypeScript transformer for goodie-ts dependency injection",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/transformer"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "ts-morph": "^24.0.0",
+    "@goodie-ts/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}