@webpieces/nx-webpieces-rules 0.3.245 → 0.3.246

package/src/lib/di-graph/angular-analyzer.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Angular DI Analyzer (pass 2, Angular flavor)
+ *
+ * Renders each Angular entry component's injection tree "from the page/root
+ * component on down". Reuses the shared {@link DiDesignBuilder} base (node ids,
+ * leaf/unresolved labeling, provider-table resolution, factory-dep edges, level
+ * assignment) via its `collectInjections` hook — only the front-half (roots,
+ * providers, injection-site discovery) is Angular-specific.
+ *
+ * Angular injection sites per class:
+ *   1. Constructor params — `@Inject(TOKEN)` (capital I), `forwardRef(() => X)`,
+ *      `@Optional`/`@Self`/`@SkipSelf`/`@Host`, or a bare typed param (the class
+ *      itself is the token).
+ *   2. Field initializers calling `inject()` — the standalone pattern
+ *      (`private saveApi = inject(SaveApi)`); the field name is the edge label
+ *      and the declared/token type labels the box.
+ *
+ * Every site is an `angularToken` injection: the provider table is consulted
+ * first, then the token expression is resolved as a bare `@Injectable` class,
+ * else it becomes an `unresolved` node. Generation never fails.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAngularDiGraph = buildAngularDiGraph;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const model_1 = require("./model");
+const bindings_1 = require("./bindings");
+const analyzer_1 = require("./analyzer");
+const angular_providers_1 = require("./angular-providers");
+const angular_roots_1 = require("./angular-roots");
+function hasComponentDecorator(cls) {
+    for (const decorator of (0, bindings_1.classDecorators)(cls)) {
+        if ((0, bindings_1.decoratorName)(decorator) === 'Component')
+            return true;
+    }
+    return false;
+}
+/** Unwrap `forwardRef(() => X)` to its inner `X`; return `expr` unchanged otherwise. */
+function unwrapForwardRef(expr) {
+    if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression) && expr.expression.text === 'forwardRef') {
+        const arrow = expr.arguments[0];
+        if (arrow && ts.isArrowFunction(arrow) && ts.isExpression(arrow.body)) {
+            return arrow.body;
+        }
+    }
+    return expr;
+}
+/** Read a constructor param's `@Inject(TOKEN)` token and `@Optional` flag. */
+class AngularParam {
+    token;
+    optional;
+    constructor(token, optional) {
+        this.token = token;
+        this.optional = optional;
+    }
+}
+function readAngularParam(param) {
+    let token = null;
+    let optional = false;
+    for (const decorator of ts.getDecorators(param) ?? []) {
+        const name = (0, bindings_1.decoratorName)(decorator);
+        const call = (0, bindings_1.decoratorCall)(decorator);
+        if (name === 'Inject' && call?.arguments[0]) {
+            token = unwrapForwardRef(call.arguments[0]);
+        }
+        else if (name === 'Optional') {
+            optional = true;
+        }
+        // @Self/@SkipSelf/@Host change the resolving injector, not the token —
+        // the edge is recorded regardless; the scope nuance is out of scope for v1.
+    }
+    return new AngularParam(token, optional);
+}
+/** `inject(TOKEN)` call in a field initializer → the token expression, else null. */
+function fieldInjectToken(initializer) {
+    if (!initializer || !ts.isCallExpression(initializer))
+        return null;
+    if (!ts.isIdentifier(initializer.expression) || initializer.expression.text !== 'inject')
+        return null;
+    return initializer.arguments[0] ? unwrapForwardRef(initializer.arguments[0]) : null;
+}
+/**
+ * Angular builder: injection sites are constructor params (`@Inject`/bare typed)
+ * plus `inject()` field initializers. Root/reached components render as
+ * `component`; services as `class`.
+ */
+class AngularDesignBuilder extends analyzer_1.DiDesignBuilder {
+    rootKindOf(cls) {
+        return hasComponentDecorator(cls) ? 'component' : 'class';
+    }
+    collectInjections(cls) {
+        const injections = [];
+        const ctor = (0, analyzer_1.findConstructor)(cls);
+        for (const param of ctor?.parameters ?? []) {
+            const info = readAngularParam(param);
+            const paramName = ts.isIdentifier(param.name) ? param.name.text : param.name.getText();
+            const paramType = param.type ? param.type.getText() : '';
+            if (info.token) {
+                injections.push(new analyzer_1.Injection('angularToken', info.token, paramName, paramType, false, info.optional));
+            }
+            else {
+                const typeRef = param.type && ts.isTypeReferenceNode(param.type) && ts.isIdentifier(param.type.typeName)
+                    ? param.type.typeName
+                    : null;
+                if (typeRef) {
+                    injections.push(new analyzer_1.Injection('angularToken', typeRef, paramName, paramType, false, info.optional));
+                }
+            }
+        }
+        for (const member of cls.members) {
+            if (!ts.isPropertyDeclaration(member) || !ts.isIdentifier(member.name))
+                continue;
+            const token = fieldInjectToken(member.initializer);
+            if (!token)
+                continue;
+            const paramName = member.name.text;
+            // The field usually has no explicit type (`= inject(SaveApi)`) — the
+            // token IS the declared type, so label the box with it.
+            const paramType = member.type ? member.type.getText() : token.getText();
+            injections.push(new analyzer_1.Injection('angularToken', token, paramName, paramType));
+        }
+        return injections;
+    }
+}
+/**
+ * Build the full Angular DI graph for one project: one self-contained `DiDesign`
+ * per entry component (bootstrap + routed). `projectRoot` is workspace-relative.
+ */
+function buildAngularDiGraph(program, workspaceRoot, projectRoot, projectName) {
+    const checker = program.getTypeChecker();
+    const table = (0, angular_providers_1.collectAngularProviders)(program, checker, workspaceRoot);
+    const graph = new model_1.DiGraph(projectName);
+    for (const root of (0, angular_roots_1.findAngularRoots)(program, checker, workspaceRoot, projectRoot)) {
+        graph.designs.push((0, analyzer_1.buildDesign)(root, 'component', workspaceRoot, (design) => new AngularDesignBuilder(checker, table, workspaceRoot, design)));
+    }
+    return graph;
+}
+//# sourceMappingURL=angular-analyzer.js.map

package/src/lib/di-graph/angular-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-analyzer.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/di-graph/angular-analyzer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Angular DI Analyzer (pass 2, Angular flavor)\n *\n * Renders each Angular entry component's injection tree \"from the page/root\n * component on down\". Reuses the shared {@link DiDesignBuilder} base (node ids,\n * leaf/unresolved labeling, provider-table resolution, factory-dep edges, level\n * assignment) via its `collectInjections` hook — only the front-half (roots,\n * providers, injection-site discovery) is Angular-specific.\n *\n * Angular injection sites per class:\n *   1. Constructor params — `@Inject(TOKEN)` (capital I), `forwardRef(() => X)`,\n *      `@Optional`/`@Self`/`@SkipSelf`/`@Host`, or a bare typed param (the class\n *      itself is the token).\n *   2. Field initializers calling `inject()` — the standalone pattern\n *      (`private saveApi = inject(SaveApi)`); the field name is the edge label\n *      and the declared/token type labels the box.\n *\n * Every site is an `angularToken` injection: the provider table is consulted\n * first, then the token expression is resolved as a bare `@Injectable` class,\n * else it becomes an `unresolved` node. Generation never fails.\n */\n\nimport * as ts from 'typescript';\nimport { DiDesign, DiGraph, DiNodeKind } from './model';\nimport { BindingTable, classDecorators, decoratorCall, decoratorName } from './bindings';\nimport { buildDesign, DiDesignBuilder, findConstructor, Injection } from './analyzer';\nimport { collectAngularProviders } from './angular-providers';\nimport { findAngularRoots } from './angular-roots';\n\nfunction hasComponentDecorator(cls: ts.ClassDeclaration): boolean {\n    for (const decorator of classDecorators(cls)) {\n        if (decoratorName(decorator) === 'Component') return true;\n    }\n    return false;\n}\n\n/** Unwrap `forwardRef(() => X)` to its inner `X`; return `expr` unchanged otherwise. */\nfunction unwrapForwardRef(expr: ts.Expression): ts.Expression {\n    if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression) && expr.expression.text === 'forwardRef') {\n        const arrow = expr.arguments[0];\n        if (arrow && ts.isArrowFunction(arrow) && ts.isExpression(arrow.body)) {\n            return arrow.body;\n        }\n    }\n    return expr;\n}\n\n/** Read a constructor param's `@Inject(TOKEN)` token and `@Optional` flag. */\nclass AngularParam {\n    token: ts.Expression | null;\n    optional: boolean;\n\n    constructor(token: ts.Expression | null, optional: boolean) {\n        this.token = token;\n        this.optional = optional;\n    }\n}\n\nfunction readAngularParam(param: ts.ParameterDeclaration): AngularParam {\n    let token: ts.Expression | null = null;\n    let optional = false;\n    for (const decorator of ts.getDecorators(param) ?? []) {\n        const name = decoratorName(decorator);\n        const call = decoratorCall(decorator);\n        if (name === 'Inject' && call?.arguments[0]) {\n            token = unwrapForwardRef(call.arguments[0]);\n        } else if (name === 'Optional') {\n            optional = true;\n        }\n        // @Self/@SkipSelf/@Host change the resolving injector, not the token —\n        // the edge is recorded regardless; the scope nuance is out of scope for v1.\n    }\n    return new AngularParam(token, optional);\n}\n\n/** `inject(TOKEN)` call in a field initializer → the token expression, else null. */\nfunction fieldInjectToken(initializer: ts.Expression | undefined): ts.Expression | null {\n    if (!initializer || !ts.isCallExpression(initializer)) return null;\n    if (!ts.isIdentifier(initializer.expression) || initializer.expression.text !== 'inject') return null;\n    return initializer.arguments[0] ? unwrapForwardRef(initializer.arguments[0]) : null;\n}\n\n/**\n * Angular builder: injection sites are constructor params (`@Inject`/bare typed)\n * plus `inject()` field initializers. Root/reached components render as\n * `component`; services as `class`.\n */\nclass AngularDesignBuilder extends DiDesignBuilder {\n    protected override rootKindOf(cls: ts.ClassDeclaration): DiNodeKind {\n        return hasComponentDecorator(cls) ? 'component' : 'class';\n    }\n\n    protected collectInjections(cls: ts.ClassDeclaration): Injection[] {\n        const injections: Injection[] = [];\n\n        const ctor = findConstructor(cls);\n        for (const param of ctor?.parameters ?? []) {\n            const info = readAngularParam(param);\n            const paramName = ts.isIdentifier(param.name) ? param.name.text : param.name.getText();\n            const paramType = param.type ? param.type.getText() : '';\n\n            if (info.token) {\n                injections.push(new Injection('angularToken', info.token, paramName, paramType, false, info.optional));\n            } else {\n                const typeRef =\n                    param.type && ts.isTypeReferenceNode(param.type) && ts.isIdentifier(param.type.typeName)\n                        ? param.type.typeName\n                        : null;\n                if (typeRef) {\n                    injections.push(new Injection('angularToken', typeRef, paramName, paramType, false, info.optional));\n                }\n            }\n        }\n\n        for (const member of cls.members) {\n            if (!ts.isPropertyDeclaration(member) || !ts.isIdentifier(member.name)) continue;\n            const token = fieldInjectToken(member.initializer);\n            if (!token) continue;\n            const paramName = member.name.text;\n            // The field usually has no explicit type (`= inject(SaveApi)`) — the\n            // token IS the declared type, so label the box with it.\n            const paramType = member.type ? member.type.getText() : token.getText();\n            injections.push(new Injection('angularToken', token, paramName, paramType));\n        }\n\n        return injections;\n    }\n}\n\n/**\n * Build the full Angular DI graph for one project: one self-contained `DiDesign`\n * per entry component (bootstrap + routed). `projectRoot` is workspace-relative.\n */\nexport function buildAngularDiGraph(\n    program: ts.Program,\n    workspaceRoot: string,\n    projectRoot: string,\n    projectName: string,\n): DiGraph {\n    const checker = program.getTypeChecker();\n    const table: BindingTable = collectAngularProviders(program, checker, workspaceRoot);\n    const graph = new DiGraph(projectName);\n\n    for (const root of findAngularRoots(program, checker, workspaceRoot, projectRoot)) {\n        graph.designs.push(\n            buildDesign(\n                root,\n                'component',\n                workspaceRoot,\n                (design: DiDesign) => new AngularDesignBuilder(checker, table, workspaceRoot, design),\n            ),\n        );\n    }\n\n    return graph;\n}\n"]}

package/src/lib/di-graph/angular-providers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Angular Provider Table (pass 1, Angular flavor)
+ *
+ * The Angular analog of `bindings.ts` (Inversify): scans the program and maps
+ * Angular's provider forms onto the SAME token-keyed {@link BindingTable} the
+ * shared walker consumes, so `angular-analyzer.ts` reuses every downstream
+ * mechanism (leaf labeling, factory-dep edges, unresolved handling).
+ *
+ * Provider sources (v1 flat global table — component-scoped shadowing is an
+ * accepted approximation):
+ *   - Any `providers: [...]` array (ApplicationConfig, `@Component`, `@Directive`)
+ *   - `@Injectable({ providedIn: 'root' | 'platform' | 'any' })` self-registration
+ *
+ * Provider forms per array element:
+ *   - bare class `Foo`                         → to/self binding (implClass=Foo)
+ *   - `{ provide, useClass }`                  → to binding (implClass)
+ *   - `{ provide, useValue }`                  → toConstantValue leaf
+ *   - `{ provide, useFactory, deps: [A, B] }`  → toDynamicValue leaf + factoryDeps
+ *   - `{ provide, useExisting }`               → alias → target impl class
+ *   - `multi: true`                            → multiple bindings per token (fan-out)
+ *
+ * Framework-internal `provideXxx()` calls (`provideRouter`,
+ * `provideZoneChangeDetection`, ...) have no DI leaves and are skipped.
+ */
+import * as ts from 'typescript';
+import { BindingTable } from './bindings';
+/**
+ * Collect every Angular provider in the program into a token-keyed table.
+ * `checker` is required so cross-package class tokens (`SaveApi`, `ClientConfig`)
+ * resolve to the same declaration the injection sites reference.
+ */
+export declare function collectAngularProviders(program: ts.Program, checker: ts.TypeChecker, workspaceRoot: string): BindingTable;

package/src/lib/di-graph/angular-providers.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Angular Provider Table (pass 1, Angular flavor)
+ *
+ * The Angular analog of `bindings.ts` (Inversify): scans the program and maps
+ * Angular's provider forms onto the SAME token-keyed {@link BindingTable} the
+ * shared walker consumes, so `angular-analyzer.ts` reuses every downstream
+ * mechanism (leaf labeling, factory-dep edges, unresolved handling).
+ *
+ * Provider sources (v1 flat global table — component-scoped shadowing is an
+ * accepted approximation):
+ *   - Any `providers: [...]` array (ApplicationConfig, `@Component`, `@Directive`)
+ *   - `@Injectable({ providedIn: 'root' | 'platform' | 'any' })` self-registration
+ *
+ * Provider forms per array element:
+ *   - bare class `Foo`                         → to/self binding (implClass=Foo)
+ *   - `{ provide, useClass }`                  → to binding (implClass)
+ *   - `{ provide, useValue }`                  → toConstantValue leaf
+ *   - `{ provide, useFactory, deps: [A, B] }`  → toDynamicValue leaf + factoryDeps
+ *   - `{ provide, useExisting }`               → alias → target impl class
+ *   - `multi: true`                            → multiple bindings per token (fan-out)
+ *
+ * Framework-internal `provideXxx()` calls (`provideRouter`,
+ * `provideZoneChangeDetection`, ...) have no DI leaves and are skipped.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectAngularProviders = collectAngularProviders;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const model_1 = require("./model");
+const bindings_1 = require("./bindings");
+const token_resolver_1 = require("./token-resolver");
+// Angular injector-scoped providers are effectively singletons at their scope.
+const ANGULAR_SCOPE = 'singleton';
+function isAnalyzableFile(sourceFile) {
+    if (sourceFile.isDeclarationFile)
+        return false;
+    if (sourceFile.fileName.includes('/node_modules/'))
+        return false;
+    return true;
+}
+/** First line of an expression's source text, truncated for leaf labels. */
+function firstLine(text) {
+    const line = text.split('\n')[0].trim();
+    return line.length > 60 ? line.slice(0, 57) + '...' : line;
+}
+/** Pull `{ name: value }` properties out of an object literal into a map. */
+function objectProps(obj) {
+    const props = new Map();
+    for (const prop of obj.properties) {
+        if (ts.isPropertyAssignment(prop) && (ts.isIdentifier(prop.name) || ts.isStringLiteralLike(prop.name))) {
+            props.set(prop.name.text, prop.initializer);
+        }
+    }
+    return props;
+}
+/** Resolve each `deps: [A, B]` element to a token reference for factory-dep edges. */
+function collectDeps(depsExpr, checker, workspaceRoot) {
+    if (!depsExpr || !ts.isArrayLiteralExpression(depsExpr))
+        return [];
+    const deps = [];
+    for (const element of depsExpr.elements) {
+        // Simple token form (`EnvironmentConfig`); the decorated array form
+        // (`[new Optional(), Token]`) is out of scope for v1.
+        if (ts.isIdentifier(element) || ts.isPropertyAccessExpression(element)) {
+            const cls = (0, bindings_1.resolveClassDeclaration)(element, checker);
+            deps.push(cls ? (0, token_resolver_1.classTokenKey)(cls, workspaceRoot) : (0, token_resolver_1.resolveTokenKey)(element, checker, workspaceRoot));
+        }
+    }
+    return deps;
+}
+/** Record one provider-object literal (`{ provide, useX }`) as a binding. */
+function collectProviderObject(obj, checker, workspaceRoot, file, table) {
+    const props = objectProps(obj);
+    const provideExpr = props.get('provide');
+    if (!provideExpr)
+        return;
+    const provideClass = (0, bindings_1.resolveClassDeclaration)(provideExpr, checker);
+    const token = provideClass
+        ? (0, token_resolver_1.classTokenKey)(provideClass, workspaceRoot)
+        : (0, token_resolver_1.resolveTokenKey)(provideExpr, checker, workspaceRoot);
+    const useClass = props.get('useClass');
+    const useValue = props.get('useValue');
+    const useFactory = props.get('useFactory');
+    const useExisting = props.get('useExisting');
+    if (useClass) {
+        const impl = (0, bindings_1.resolveClassDeclaration)(useClass, checker);
+        table.add(new model_1.Binding(token.key, token.display, 'to', ANGULAR_SCOPE, impl, useClass.getText(), file));
+        return;
+    }
+    if (useExisting) {
+        // Alias: T resolves to whatever `useExisting` points at — resolve through
+        // to the target impl class so the walk continues into its dependencies.
+        const impl = (0, bindings_1.resolveClassDeclaration)(useExisting, checker);
+        table.add(new model_1.Binding(token.key, token.display, 'to', ANGULAR_SCOPE, impl, useExisting.getText(), file));
+        return;
+    }
+    if (useFactory) {
+        const deps = collectDeps(props.get('deps'), checker, workspaceRoot);
+        table.add(new model_1.Binding(token.key, token.display, 'toDynamicValue', ANGULAR_SCOPE, null, firstLine(useFactory.getText()), file, deps));
+        return;
+    }
+    if (useValue) {
+        table.add(new model_1.Binding(token.key, token.display, 'toConstantValue', ANGULAR_SCOPE, null, firstLine(useValue.getText()), file));
+        return;
+    }
+    // `{ provide: T }` with no recipe — treat the token itself as the impl class.
+    if (provideClass) {
+        table.add(new model_1.Binding(token.key, token.display, 'to', ANGULAR_SCOPE, provideClass, provideExpr.getText(), file));
+    }
+}
+/** Record one element of a `providers: [...]` array. */
+function collectProviderElement(element, checker, workspaceRoot, file, table) {
+    // Framework-internal `provideRouter(...)` / `provideZoneChangeDetection(...)`.
+    if (ts.isCallExpression(element))
+        return;
+    // Bare class provider: `providers: [MyService]` → useClass: MyService.
+    if (ts.isIdentifier(element) || ts.isPropertyAccessExpression(element)) {
+        const cls = (0, bindings_1.resolveClassDeclaration)(element, checker);
+        if (cls) {
+            const token = (0, token_resolver_1.classTokenKey)(cls, workspaceRoot);
+            table.add(new model_1.Binding(token.key, token.display, 'to', ANGULAR_SCOPE, cls, element.getText(), file));
+        }
+        return;
+    }
+    if (ts.isObjectLiteralExpression(element)) {
+        collectProviderObject(element, checker, workspaceRoot, file, table);
+    }
+}
+/** `@Injectable({ providedIn: 'root' | 'platform' | 'any' })` self-registration. */
+function collectInjectableSelfBinding(cls, checker, workspaceRoot, table) {
+    for (const decorator of (0, bindings_1.classDecorators)(cls)) {
+        if ((0, bindings_1.decoratorName)(decorator) !== 'Injectable')
+            continue;
+        const call = (0, bindings_1.decoratorCall)(decorator);
+        const arg = call?.arguments[0];
+        if (!arg || !ts.isObjectLiteralExpression(arg))
+            return;
+        const providedIn = objectProps(arg).get('providedIn');
+        if (providedIn && ts.isStringLiteralLike(providedIn)) {
+            const token = (0, token_resolver_1.classTokenKey)(cls, workspaceRoot);
+            const file = (0, token_resolver_1.relativeFile)(workspaceRoot, cls.getSourceFile());
+            table.add(new model_1.Binding(token.key, token.display, 'decorator', ANGULAR_SCOPE, cls, '', file));
+        }
+        return;
+    }
+}
+/**
+ * Collect every Angular provider in the program into a token-keyed table.
+ * `checker` is required so cross-package class tokens (`SaveApi`, `ClientConfig`)
+ * resolve to the same declaration the injection sites reference.
+ */
+function collectAngularProviders(program, checker, workspaceRoot) {
+    const table = new bindings_1.BindingTable();
+    for (const sourceFile of program.getSourceFiles()) {
+        if (!isAnalyzableFile(sourceFile))
+            continue;
+        const file = (0, token_resolver_1.relativeFile)(workspaceRoot, sourceFile);
+        const visit = (node) => {
+            if (ts.isClassDeclaration(node)) {
+                collectInjectableSelfBinding(node, checker, workspaceRoot, table);
+            }
+            else if (ts.isPropertyAssignment(node) &&
+                (ts.isIdentifier(node.name) || ts.isStringLiteralLike(node.name)) &&
+                node.name.text === 'providers' &&
+                ts.isArrayLiteralExpression(node.initializer)) {
+                for (const element of node.initializer.elements) {
+                    collectProviderElement(element, checker, workspaceRoot, file, table);
+                }
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+    }
+    return table;
+}
+//# sourceMappingURL=angular-providers.js.map

package/src/lib/di-graph/angular-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-providers.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/di-graph/angular-providers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Angular Provider Table (pass 1, Angular flavor)\n *\n * The Angular analog of `bindings.ts` (Inversify): scans the program and maps\n * Angular's provider forms onto the SAME token-keyed {@link BindingTable} the\n * shared walker consumes, so `angular-analyzer.ts` reuses every downstream\n * mechanism (leaf labeling, factory-dep edges, unresolved handling).\n *\n * Provider sources (v1 flat global table — component-scoped shadowing is an\n * accepted approximation):\n *   - Any `providers: [...]` array (ApplicationConfig, `@Component`, `@Directive`)\n *   - `@Injectable({ providedIn: 'root' | 'platform' | 'any' })` self-registration\n *\n * Provider forms per array element:\n *   - bare class `Foo`                         → to/self binding (implClass=Foo)\n *   - `{ provide, useClass }`                  → to binding (implClass)\n *   - `{ provide, useValue }`                  → toConstantValue leaf\n *   - `{ provide, useFactory, deps: [A, B] }`  → toDynamicValue leaf + factoryDeps\n *   - `{ provide, useExisting }`               → alias → target impl class\n *   - `multi: true`                            → multiple bindings per token (fan-out)\n *\n * Framework-internal `provideXxx()` calls (`provideRouter`,\n * `provideZoneChangeDetection`, ...) have no DI leaves and are skipped.\n */\n\nimport * as ts from 'typescript';\nimport { Binding, DiScope, TokenRef } from './model';\nimport { BindingTable, classDecorators, decoratorCall, decoratorName, resolveClassDeclaration } from './bindings';\nimport { classTokenKey, relativeFile, resolveTokenKey } from './token-resolver';\n\n// Angular injector-scoped providers are effectively singletons at their scope.\nconst ANGULAR_SCOPE: DiScope = 'singleton';\n\nfunction isAnalyzableFile(sourceFile: ts.SourceFile): boolean {\n    if (sourceFile.isDeclarationFile) return false;\n    if (sourceFile.fileName.includes('/node_modules/')) return false;\n    return true;\n}\n\n/** First line of an expression's source text, truncated for leaf labels. */\nfunction firstLine(text: string): string {\n    const line = text.split('\\n')[0].trim();\n    return line.length > 60 ? line.slice(0, 57) + '...' : line;\n}\n\n/** Pull `{ name: value }` properties out of an object literal into a map. */\nfunction objectProps(obj: ts.ObjectLiteralExpression): Map<string, ts.Expression> {\n    const props = new Map<string, ts.Expression>();\n    for (const prop of obj.properties) {\n        if (ts.isPropertyAssignment(prop) && (ts.isIdentifier(prop.name) || ts.isStringLiteralLike(prop.name))) {\n            props.set(prop.name.text, prop.initializer);\n        }\n    }\n    return props;\n}\n\n/** Resolve each `deps: [A, B]` element to a token reference for factory-dep edges. */\nfunction collectDeps(depsExpr: ts.Expression | undefined, checker: ts.TypeChecker, workspaceRoot: string): TokenRef[] {\n    if (!depsExpr || !ts.isArrayLiteralExpression(depsExpr)) return [];\n    const deps: TokenRef[] = [];\n    for (const element of depsExpr.elements) {\n        // Simple token form (`EnvironmentConfig`); the decorated array form\n        // (`[new Optional(), Token]`) is out of scope for v1.\n        if (ts.isIdentifier(element) || ts.isPropertyAccessExpression(element)) {\n            const cls = resolveClassDeclaration(element, checker);\n            deps.push(cls ? classTokenKey(cls, workspaceRoot) : resolveTokenKey(element, checker, workspaceRoot));\n        }\n    }\n    return deps;\n}\n\n/** Record one provider-object literal (`{ provide, useX }`) as a binding. */\nfunction collectProviderObject(\n    obj: ts.ObjectLiteralExpression,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n    file: string,\n    table: BindingTable,\n): void {\n    const props = objectProps(obj);\n    const provideExpr = props.get('provide');\n    if (!provideExpr) return;\n\n    const provideClass = resolveClassDeclaration(provideExpr, checker);\n    const token = provideClass\n        ? classTokenKey(provideClass, workspaceRoot)\n        : resolveTokenKey(provideExpr, checker, workspaceRoot);\n\n    const useClass = props.get('useClass');\n    const useValue = props.get('useValue');\n    const useFactory = props.get('useFactory');\n    const useExisting = props.get('useExisting');\n\n    if (useClass) {\n        const impl = resolveClassDeclaration(useClass, checker);\n        table.add(new Binding(token.key, token.display, 'to', ANGULAR_SCOPE, impl, useClass.getText(), file));\n        return;\n    }\n    if (useExisting) {\n        // Alias: T resolves to whatever `useExisting` points at — resolve through\n        // to the target impl class so the walk continues into its dependencies.\n        const impl = resolveClassDeclaration(useExisting, checker);\n        table.add(new Binding(token.key, token.display, 'to', ANGULAR_SCOPE, impl, useExisting.getText(), file));\n        return;\n    }\n    if (useFactory) {\n        const deps = collectDeps(props.get('deps'), checker, workspaceRoot);\n        table.add(\n            new Binding(token.key, token.display, 'toDynamicValue', ANGULAR_SCOPE, null, firstLine(useFactory.getText()), file, deps),\n        );\n        return;\n    }\n    if (useValue) {\n        table.add(\n            new Binding(token.key, token.display, 'toConstantValue', ANGULAR_SCOPE, null, firstLine(useValue.getText()), file),\n        );\n        return;\n    }\n    // `{ provide: T }` with no recipe — treat the token itself as the impl class.\n    if (provideClass) {\n        table.add(new Binding(token.key, token.display, 'to', ANGULAR_SCOPE, provideClass, provideExpr.getText(), file));\n    }\n}\n\n/** Record one element of a `providers: [...]` array. */\nfunction collectProviderElement(\n    element: ts.Expression,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n    file: string,\n    table: BindingTable,\n): void {\n    // Framework-internal `provideRouter(...)` / `provideZoneChangeDetection(...)`.\n    if (ts.isCallExpression(element)) return;\n\n    // Bare class provider: `providers: [MyService]` → useClass: MyService.\n    if (ts.isIdentifier(element) || ts.isPropertyAccessExpression(element)) {\n        const cls = resolveClassDeclaration(element, checker);\n        if (cls) {\n            const token = classTokenKey(cls, workspaceRoot);\n            table.add(new Binding(token.key, token.display, 'to', ANGULAR_SCOPE, cls, element.getText(), file));\n        }\n        return;\n    }\n\n    if (ts.isObjectLiteralExpression(element)) {\n        collectProviderObject(element, checker, workspaceRoot, file, table);\n    }\n}\n\n/** `@Injectable({ providedIn: 'root' | 'platform' | 'any' })` self-registration. */\nfunction collectInjectableSelfBinding(\n    cls: ts.ClassDeclaration,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n    table: BindingTable,\n): void {\n    for (const decorator of classDecorators(cls)) {\n        if (decoratorName(decorator) !== 'Injectable') continue;\n        const call = decoratorCall(decorator);\n        const arg = call?.arguments[0];\n        if (!arg || !ts.isObjectLiteralExpression(arg)) return;\n        const providedIn = objectProps(arg).get('providedIn');\n        if (providedIn && ts.isStringLiteralLike(providedIn)) {\n            const token = classTokenKey(cls, workspaceRoot);\n            const file = relativeFile(workspaceRoot, cls.getSourceFile());\n            table.add(new Binding(token.key, token.display, 'decorator', ANGULAR_SCOPE, cls, '', file));\n        }\n        return;\n    }\n}\n\n/**\n * Collect every Angular provider in the program into a token-keyed table.\n * `checker` is required so cross-package class tokens (`SaveApi`, `ClientConfig`)\n * resolve to the same declaration the injection sites reference.\n */\nexport function collectAngularProviders(\n    program: ts.Program,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n): BindingTable {\n    const table = new BindingTable();\n\n    for (const sourceFile of program.getSourceFiles()) {\n        if (!isAnalyzableFile(sourceFile)) continue;\n        const file = relativeFile(workspaceRoot, sourceFile);\n\n        const visit = (node: ts.Node): void => {\n            if (ts.isClassDeclaration(node)) {\n                collectInjectableSelfBinding(node, checker, workspaceRoot, table);\n            } else if (\n                ts.isPropertyAssignment(node) &&\n                (ts.isIdentifier(node.name) || ts.isStringLiteralLike(node.name)) &&\n                node.name.text === 'providers' &&\n                ts.isArrayLiteralExpression(node.initializer)\n            ) {\n                for (const element of node.initializer.elements) {\n                    collectProviderElement(element, checker, workspaceRoot, file, table);\n                }\n            }\n            ts.forEachChild(node, visit);\n        };\n        visit(sourceFile);\n    }\n\n    return table;\n}\n"]}

package/src/lib/di-graph/angular-roots.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Angular Roots
+ *
+ * The Angular analog of "@Controller classes are the roots". Finds the entry
+ * components a DI tree is rendered "from the page/root component on down":
+ *
+ *   - Bootstrap root: `bootstrapApplication(AppComponent, appConfig)` in main.ts
+ *     — `arguments[0]` is the root component.
+ *   - Route roots: the `Routes`-typed array (and any array passed to
+ *     `provideRouter(...)`). Each route object contributes its `component` /
+ *     `loadComponent` component, recursing through `children`.
+ *
+ * Each resolved component becomes its own `DiDesign` (one tree per root, like
+ * one-design-per-controller). Roots are de-duplicated by class declaration.
+ */
+import * as ts from 'typescript';
+/**
+ * Find every Angular entry component (bootstrap + routed) in the project, sorted
+ * by class name for deterministic output.
+ */
+export declare function findAngularRoots(program: ts.Program, checker: ts.TypeChecker, workspaceRoot: string, projectRoot: string): ts.ClassDeclaration[];

package/src/lib/di-graph/angular-roots.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Angular Roots
+ *
+ * The Angular analog of "@Controller classes are the roots". Finds the entry
+ * components a DI tree is rendered "from the page/root component on down":
+ *
+ *   - Bootstrap root: `bootstrapApplication(AppComponent, appConfig)` in main.ts
+ *     — `arguments[0]` is the root component.
+ *   - Route roots: the `Routes`-typed array (and any array passed to
+ *     `provideRouter(...)`). Each route object contributes its `component` /
+ *     `loadComponent` component, recursing through `children`.
+ *
+ * Each resolved component becomes its own `DiDesign` (one tree per root, like
+ * one-design-per-controller). Roots are de-duplicated by class declaration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findAngularRoots = findAngularRoots;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const bindings_1 = require("./bindings");
+const token_resolver_1 = require("./token-resolver");
+/** Class declarations under the project root only (roots must be project-owned). */
+function isUnderProject(sourceFile, workspaceRoot, projectRoot) {
+    if (sourceFile.isDeclarationFile)
+        return false;
+    const prefix = projectRoot.endsWith('/') ? projectRoot : projectRoot + '/';
+    return (0, token_resolver_1.relativeFile)(workspaceRoot, sourceFile).startsWith(prefix);
+}
+/** Callee identifier name of a call expression (`bootstrapApplication`, `provideRouter`, ...). */
+function calleeName(call) {
+    if (ts.isIdentifier(call.expression))
+        return call.expression.text;
+    if (ts.isPropertyAccessExpression(call.expression))
+        return call.expression.name.text;
+    return null;
+}
+/**
+ * Resolve an expression to an array literal — either an inline `[...]` or an
+ * identifier (`routes`) whose declaration initializes to an array literal.
+ */
+function asArrayLiteral(expr, checker) {
+    if (ts.isArrayLiteralExpression(expr))
+        return expr;
+    if (ts.isIdentifier(expr)) {
+        let symbol = checker.getSymbolAtLocation(expr);
+        if (symbol && (symbol.flags & ts.SymbolFlags.Alias) !== 0)
+            symbol = checker.getAliasedSymbol(symbol);
+        for (const decl of symbol?.declarations ?? []) {
+            if (ts.isVariableDeclaration(decl) && decl.initializer && ts.isArrayLiteralExpression(decl.initializer)) {
+                return decl.initializer;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * A `loadComponent: () => import('./x').then(m => m.X)` lazy route — resolve the
+ * first property access inside the arrow body that points at a class
+ * declaration (the `m.X`). Returns null when the dynamic import can't be
+ * followed (falls back to no root, never throws).
+ */
+function resolveLazyComponent(arrow, checker) {
+    let found = null;
+    const visit = (node) => {
+        if (found)
+            return;
+        if (ts.isPropertyAccessExpression(node)) {
+            const cls = (0, bindings_1.resolveClassDeclaration)(node, checker);
+            if (cls) {
+                found = cls;
+                return;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(arrow);
+    return found;
+}
+/** Parse a `Routes` array literal, collecting `component`/`loadComponent` roots (recursing `children`). */
+function collectRouteComponents(array, checker, out) {
+    for (const element of array.elements) {
+        if (!ts.isObjectLiteralExpression(element))
+            continue;
+        for (const prop of element.properties) {
+            if (!ts.isPropertyAssignment(prop) || !ts.isIdentifier(prop.name))
+                continue;
+            if (prop.name.text === 'component') {
+                const cls = (0, bindings_1.resolveClassDeclaration)(prop.initializer, checker);
+                if (cls)
+                    out.add(cls);
+            }
+            else if (prop.name.text === 'loadComponent') {
+                const cls = resolveLazyComponent(prop.initializer, checker);
+                if (cls)
+                    out.add(cls);
+            }
+            else if (prop.name.text === 'children') {
+                const nested = asArrayLiteral(prop.initializer, checker);
+                if (nested)
+                    collectRouteComponents(nested, checker, out);
+            }
+        }
+    }
+}
+/**
+ * Find every Angular entry component (bootstrap + routed) in the project, sorted
+ * by class name for deterministic output.
+ */
+function findAngularRoots(program, checker, workspaceRoot, projectRoot) {
+    const roots = new Set();
+    for (const sourceFile of program.getSourceFiles()) {
+        if (!isUnderProject(sourceFile, workspaceRoot, projectRoot))
+            continue;
+        const visit = (node) => {
+            if (ts.isCallExpression(node)) {
+                const name = calleeName(node);
+                if (name === 'bootstrapApplication' && node.arguments[0]) {
+                    const cls = (0, bindings_1.resolveClassDeclaration)(node.arguments[0], checker);
+                    if (cls)
+                        roots.add(cls);
+                }
+                else if (name === 'provideRouter' && node.arguments[0]) {
+                    const array = asArrayLiteral(node.arguments[0], checker);
+                    if (array)
+                        collectRouteComponents(array, checker, roots);
+                }
+            }
+            else if (ts.isVariableDeclaration(node) &&
+                node.type &&
+                ts.isTypeReferenceNode(node.type) &&
+                ts.isIdentifier(node.type.typeName) &&
+                node.type.typeName.text === 'Routes' &&
+                node.initializer &&
+                ts.isArrayLiteralExpression(node.initializer)) {
+                collectRouteComponents(node.initializer, checker, roots);
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+    }
+    return [...roots].sort((a, b) => {
+        const nameA = a.name ? a.name.text : '';
+        const nameB = b.name ? b.name.text : '';
+        if (nameA !== nameB)
+            return nameA < nameB ? -1 : 1;
+        return a.getSourceFile().fileName < b.getSourceFile().fileName ? -1 : 1;
+    });
+}
+//# sourceMappingURL=angular-roots.js.map

package/src/lib/di-graph/angular-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-roots.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/di-graph/angular-roots.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Angular Roots\n *\n * The Angular analog of \"@Controller classes are the roots\". Finds the entry\n * components a DI tree is rendered \"from the page/root component on down\":\n *\n *   - Bootstrap root: `bootstrapApplication(AppComponent, appConfig)` in main.ts\n *     — `arguments[0]` is the root component.\n *   - Route roots: the `Routes`-typed array (and any array passed to\n *     `provideRouter(...)`). Each route object contributes its `component` /\n *     `loadComponent` component, recursing through `children`.\n *\n * Each resolved component becomes its own `DiDesign` (one tree per root, like\n * one-design-per-controller). Roots are de-duplicated by class declaration.\n */\n\nimport * as ts from 'typescript';\nimport { resolveClassDeclaration } from './bindings';\nimport { relativeFile } from './token-resolver';\n\n/** Class declarations under the project root only (roots must be project-owned). */\nfunction isUnderProject(sourceFile: ts.SourceFile, workspaceRoot: string, projectRoot: string): boolean {\n    if (sourceFile.isDeclarationFile) return false;\n    const prefix = projectRoot.endsWith('/') ? projectRoot : projectRoot + '/';\n    return relativeFile(workspaceRoot, sourceFile).startsWith(prefix);\n}\n\n/** Callee identifier name of a call expression (`bootstrapApplication`, `provideRouter`, ...). */\nfunction calleeName(call: ts.CallExpression): string | null {\n    if (ts.isIdentifier(call.expression)) return call.expression.text;\n    if (ts.isPropertyAccessExpression(call.expression)) return call.expression.name.text;\n    return null;\n}\n\n/**\n * Resolve an expression to an array literal — either an inline `[...]` or an\n * identifier (`routes`) whose declaration initializes to an array literal.\n */\nfunction asArrayLiteral(expr: ts.Expression, checker: ts.TypeChecker): ts.ArrayLiteralExpression | null {\n    if (ts.isArrayLiteralExpression(expr)) return expr;\n    if (ts.isIdentifier(expr)) {\n        let symbol = checker.getSymbolAtLocation(expr);\n        if (symbol && (symbol.flags & ts.SymbolFlags.Alias) !== 0) symbol = checker.getAliasedSymbol(symbol);\n        for (const decl of symbol?.declarations ?? []) {\n            if (ts.isVariableDeclaration(decl) && decl.initializer && ts.isArrayLiteralExpression(decl.initializer)) {\n                return decl.initializer;\n            }\n        }\n    }\n    return null;\n}\n\n/**\n * A `loadComponent: () => import('./x').then(m => m.X)` lazy route — resolve the\n * first property access inside the arrow body that points at a class\n * declaration (the `m.X`). Returns null when the dynamic import can't be\n * followed (falls back to no root, never throws).\n */\nfunction resolveLazyComponent(arrow: ts.Expression, checker: ts.TypeChecker): ts.ClassDeclaration | null {\n    let found: ts.ClassDeclaration | null = null;\n    const visit = (node: ts.Node): void => {\n        if (found) return;\n        if (ts.isPropertyAccessExpression(node)) {\n            const cls = resolveClassDeclaration(node, checker);\n            if (cls) {\n                found = cls;\n                return;\n            }\n        }\n        ts.forEachChild(node, visit);\n    };\n    visit(arrow);\n    return found;\n}\n\n/** Parse a `Routes` array literal, collecting `component`/`loadComponent` roots (recursing `children`). */\nfunction collectRouteComponents(\n    array: ts.ArrayLiteralExpression,\n    checker: ts.TypeChecker,\n    out: Set<ts.ClassDeclaration>,\n): void {\n    for (const element of array.elements) {\n        if (!ts.isObjectLiteralExpression(element)) continue;\n        for (const prop of element.properties) {\n            if (!ts.isPropertyAssignment(prop) || !ts.isIdentifier(prop.name)) continue;\n            if (prop.name.text === 'component') {\n                const cls = resolveClassDeclaration(prop.initializer, checker);\n                if (cls) out.add(cls);\n            } else if (prop.name.text === 'loadComponent') {\n                const cls = resolveLazyComponent(prop.initializer, checker);\n                if (cls) out.add(cls);\n            } else if (prop.name.text === 'children') {\n                const nested = asArrayLiteral(prop.initializer, checker);\n                if (nested) collectRouteComponents(nested, checker, out);\n            }\n        }\n    }\n}\n\n/**\n * Find every Angular entry component (bootstrap + routed) in the project, sorted\n * by class name for deterministic output.\n */\nexport function findAngularRoots(\n    program: ts.Program,\n    checker: ts.TypeChecker,\n    workspaceRoot: string,\n    projectRoot: string,\n): ts.ClassDeclaration[] {\n    const roots = new Set<ts.ClassDeclaration>();\n\n    for (const sourceFile of program.getSourceFiles()) {\n        if (!isUnderProject(sourceFile, workspaceRoot, projectRoot)) continue;\n\n        const visit = (node: ts.Node): void => {\n            if (ts.isCallExpression(node)) {\n                const name = calleeName(node);\n                if (name === 'bootstrapApplication' && node.arguments[0]) {\n                    const cls = resolveClassDeclaration(node.arguments[0], checker);\n                    if (cls) roots.add(cls);\n                } else if (name === 'provideRouter' && node.arguments[0]) {\n                    const array = asArrayLiteral(node.arguments[0], checker);\n                    if (array) collectRouteComponents(array, checker, roots);\n                }\n            } else if (\n                ts.isVariableDeclaration(node) &&\n                node.type &&\n                ts.isTypeReferenceNode(node.type) &&\n                ts.isIdentifier(node.type.typeName) &&\n                node.type.typeName.text === 'Routes' &&\n                node.initializer &&\n                ts.isArrayLiteralExpression(node.initializer)\n            ) {\n                collectRouteComponents(node.initializer, checker, roots);\n            }\n            ts.forEachChild(node, visit);\n        };\n        visit(sourceFile);\n    }\n\n    return [...roots].sort((a: ts.ClassDeclaration, b: ts.ClassDeclaration) => {\n        const nameA = a.name ? a.name.text : '';\n        const nameB = b.name ? b.name.text : '';\n        if (nameA !== nameB) return nameA < nameB ? -1 : 1;\n        return a.getSourceFile().fileName < b.getSourceFile().fileName ? -1 : 1;\n    });\n}\n"]}

package/src/lib/di-graph/dot.js

@@ -13,7 +13,8 @@ exports.generateDesignDot = generateDesignDot;
  * Node fill colors by DI node kind.
  */
 const KIND_COLORS = {
-    controller: '#E3F2FD', // light blue — the root/entry class
+    controller: '#E3F2FD', // light blue — the root/entry class (Inversify)
+    component: '#E8F5E9', // light green — the root/entry Angular component
     class: '#F5F5F5', // neutral — plain injectable class
     constant: '#FFF3E0', // light orange — toConstantValue leaf
     dynamic: '#FFF3E0', // light orange — toDynamicValue leaf
@@ -31,7 +32,7 @@ function nodeStatement(node) {
         styles.push('rounded');
     if (node.kind === 'unresolved')
         styles.push('dashed');
-    const penwidth = node.kind === 'controller' ? ', penwidth=2' : '';
+    const penwidth = node.kind === 'controller' || node.kind === 'component' ? ', penwidth=2' : '';
     return `  "${dotEscape(node.id)}" [fillcolor="${color}", style="${styles.join(',')}", label="${label}"${penwidth}];\n`;
 }
 /**
@@ -61,10 +62,12 @@ function generateDesignDot(design) {
         dot += `  { rank=same; ${ids.map((id) => `"${dotEscape(id)}"`).join('; ')}; }\n`;
     }
     dot += '\n';
-    // Constructor-injection edges; labels mirror design.md (mermaid.ts)
+    // Constructor-injection edges; labels are the declared param/field NAME
+    // (B0) — the human-meaningful "why", not the raw token expression. The
+    // token/tokenKey stay in design.json for tooling. Mirrors design.md.
     for (const edge of design.edges) {
-        const token = edge.injection === 'multiInject' ? `multiInject ${edge.token}` : edge.token;
-        const label = token !== '' ? ` [label="${dotEscape(token)}"]` : '';
+        const name = edge.injection === 'multiInject' ? `multiInject ${edge.paramName}` : edge.paramName;
+        const label = name !== '' ? ` [label="${dotEscape(name)}"]` : '';
         dot += `  "${dotEscape(edge.from)}" -> "${dotEscape(edge.to)}"${label};\n`;
     }
     dot += '\n  labelloc="t";\n';