@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/src/generators/migrate/angular-code-scan.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularCodeNotes = void 0;
+/**
+ * Angular 16+ code an Angular 15 workspace cannot compile: template control flow and `@let`,
+ * signal APIs, `@angular/core/rxjs-interop`, and newer providers. Report only: nothing is
+ * rewritten.
+ */
+/** @angular/* exports that Angular 15 does not have, with the version that added them. */
+const NEWER_EXPORTS = {
+    '@angular/core': {
+        signal: 16,
+        computed: 16,
+        effect: 16,
+        untracked: 16,
+        isSignal: 16,
+        DestroyRef: 16,
+        ApplicationConfig: 16,
+        runInInjectionContext: 16,
+        assertInInjectionContext: 16,
+        Signal: 16,
+        WritableSignal: 16,
+        booleanAttribute: 16,
+        numberAttribute: 16,
+        afterRender: 16,
+        afterNextRender: 16,
+        provideZoneChangeDetection: 16,
+        input: 17,
+        output: 17,
+        model: 17,
+        viewChild: 17,
+        viewChildren: 17,
+        contentChild: 17,
+        contentChildren: 17,
+        InputSignal: 17,
+        ModelSignal: 17,
+        OutputEmitterRef: 17,
+        provideExperimentalZonelessChangeDetection: 18,
+        linkedSignal: 19,
+        resource: 19,
+        provideAppInitializer: 19,
+        provideZonelessChangeDetection: 20,
+        provideBrowserGlobalErrorListeners: 20,
+    },
+    '@angular/common/http': { withFetch: 16 },
+    '@angular/router': {
+        withComponentInputBinding: 16,
+        withViewTransitions: 17,
+        RedirectCommand: 18,
+    },
+    '@angular/platform-browser': {
+        provideClientHydration: 16,
+        withEventReplay: 18,
+        withIncrementalHydration: 19,
+    },
+    '@angular/platform-browser/animations/async': { provideAnimationsAsync: 17 },
+};
+/** Packages (entry points) that Angular 15 does not have. */
+const NEWER_PACKAGES = {
+    '@angular/core/rxjs-interop': 16,
+    '@angular/platform-browser/animations/async': 17,
+};
+/** `@if (`, `@for (`, `@switch (`, `@defer {` / `@defer (`, `@let name =`. */
+const CONTROL_FLOW = /(^|[^\w@.])@((if|for|switch)\s*\(|defer\s*[({]|let\s+[A-Za-z_$][\w$]*\s*=)/m;
+const IMPORT = /(?:import|export)\s+(type\s+)?\{([^}]*)\}\s*from\s*['"]([^'"]+)['"]/g;
+const ANY_IMPORT = /(?:from|import)\s*\(?\s*['"]([^'"]+)['"]/g;
+const list = (files, max = 5) => files
+    .slice(0, max)
+    .map((f) => `\`${f}\``)
+    .join(', ') + (files.length > max ? ` and ${files.length - max} more` : '');
+/**
+ * Notes for Angular 16+ code in the copied files (`copied` is relative to `projectRoot`; notes name
+ * workspace paths). `label` prefixes each note (a project name in a workspace migration).
+ */
+function angularCodeNotes(tree, projectRoot, copied, label = '') {
+    const controlFlow = [];
+    const apis = new Map();
+    const packages = new Map();
+    for (const rel of copied) {
+        if (!/\.(ts|html)$/.test(rel) || /\.d\.ts$/.test(rel))
+            continue;
+        const text = tree.read(`${projectRoot}/${rel}`, 'utf8');
+        if (!text)
+            continue;
+        if (rel.endsWith('.html') || /\btemplate\s*:/.test(text)) {
+            const source = rel.endsWith('.html') ? text : inlineTemplates(text);
+            if (CONTROL_FLOW.test(source))
+                controlFlow.push(`${projectRoot}/${rel}`);
+        }
+        if (!rel.endsWith('.ts'))
+            continue;
+        for (const m of text.matchAll(IMPORT)) {
+            const exports = NEWER_EXPORTS[m[3]];
+            if (!exports)
+                continue;
+            for (const spec of m[2].split(',')) {
+                const name = spec
+                    .trim()
+                    .replace(/^type\s+/, '')
+                    .split(/\s+as\s+/)[0]
+                    .trim();
+                if (exports[name] !== undefined) {
+                    const key = `${name}|${exports[name]}`;
+                    apis.set(key, (apis.get(key) ?? new Set()).add(`${projectRoot}/${rel}`));
+                }
+            }
+        }
+        for (const m of text.matchAll(ANY_IMPORT)) {
+            if (NEWER_PACKAGES[m[1]] !== undefined) {
+                packages.set(m[1], (packages.get(m[1]) ?? new Set()).add(`${projectRoot}/${rel}`));
+            }
+        }
+    }
+    const prefix = label ? `${label}: ` : '';
+    const notes = [];
+    if (controlFlow.length > 0) {
+        notes.push(`${prefix}Angular 17 template syntax (\`@if\`, \`@for\`, \`@switch\`, \`@defer\`, \`@let\`) ` +
+            `in ${list(controlFlow.sort())}. Angular 15 does not compile it: rewrite to ` +
+            '`*ngIf`, `*ngFor` and `[ngSwitch]` (`@defer` has no Angular 15 equivalent).');
+    }
+    const byVersion = new Map();
+    for (const [key, files] of apis) {
+        const [name, version] = key.split('|');
+        const v = Number(version);
+        const entry = byVersion.get(v) ?? { names: [], files: new Set() };
+        entry.names.push(name);
+        files.forEach((f) => entry.files.add(f));
+        byVersion.set(v, entry);
+    }
+    for (const [v, { names, files }] of [...byVersion].sort(([a], [b]) => a - b)) {
+        notes.push(`${prefix}Angular ${v}+ APIs ${names
+            .sort()
+            .map((n) => `\`${n}\``)
+            .join(', ')} used in ${list([...files].sort())}. Angular 15 does not have them.`);
+    }
+    for (const [pkg, files] of [...packages].sort(([a], [b]) => (a < b ? -1 : 1))) {
+        notes.push(`${prefix}\`${pkg}\` (Angular ${NEWER_PACKAGES[pkg]}+) imported in ${list([...files].sort())}. Angular 15 does not have it.`);
+    }
+    return notes;
+}
+exports.angularCodeNotes = angularCodeNotes;
+/** The inline `template:` strings of a component file, joined (good enough for a scan). */
+function inlineTemplates(ts) {
+    const out = [];
+    const re = /\btemplate\s*:\s*(`(?:[^`\\]|\\.)*`|'(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*")/g;
+    for (const m of ts.matchAll(re))
+        out.push(m[1].slice(1, -1));
+    return out.join('\n');
+}
+//# sourceMappingURL=angular-code-scan.js.map

package/dist/src/generators/migrate/angular-code-scan.js.map

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

package/dist/src/generators/migrate/angular-config-files.d.ts

@@ -0,0 +1,49 @@
+import type { TsPathClash } from './adapters/types';
+import { PathMapper } from './angular-project-json';
+/**
+ * tsconfig and ESLint config rewrites for a migrated Angular app, as pure functions.
+ * File paths are POSIX and relative to the source repo root (inputs) or the Nx workspace
+ * root (outputs).
+ */
+type Json = Record<string, unknown>;
+/**
+ * The source root tsconfig.json → apps/<name>/tsconfig.json: extends the workspace base,
+ * keeps everything else except baseUrl, paths and outDir.
+ */
+export declare function appRootTsconfig(source: Json, m: PathMapper): Json;
+export interface ProjectTsconfigInput {
+    /** The file's path in the source repo, e.g. "tsconfig.app.json" or "projects/x/tsconfig.app.json". */
+    sourceFile: string;
+    /** The source project root ("" for `ng new`). */
+    sourceRoot: string;
+    /** apps/<name> */
+    projectRoot: string;
+}
+/**
+ * Fixes `extends` and `outDir` of a project tsconfig (tsconfig.app.json, tsconfig.spec.json, …)
+ * for its new location. `extends` pointing at the source root tsconfig.json now points at
+ * apps/<name>/tsconfig.json; `outDir` becomes <workspace>/dist/out-tsc.
+ */
+export declare function fixProjectTsconfig(config: Json, input: ProjectTsconfigInput): {
+    config: Json;
+    warnings: string[];
+};
+export interface TsPathsMerge {
+    /** The merged paths for tsconfig.base.json. */
+    paths: Record<string, string[]>;
+    added: string[];
+    clashes: TsPathClash[];
+}
+/**
+ * Merges the source tsconfig `paths` into the workspace's. Source targets are relative to the
+ * source baseUrl; they are mapped to workspace-root paths. Existing aliases are never
+ * overwritten; an alias mapped to different targets is a clash.
+ */
+export declare function mergeTsPaths(workspace: Record<string, string[]>, source: Record<string, unknown>, sourceBaseUrl: string, m: PathMapper): TsPathsMerge;
+/**
+ * A copied source .eslintrc.json made to extend the workspace root config: no `root`, the root
+ * config first in `extends`, "!**\/*" un-ignoring the app's files (the root ignores everything),
+ * and parserOptions.project paths mapped to the workspace root.
+ */
+export declare function extendRootEslintConfig(config: Json, m: PathMapper): Json;
+export {};

package/dist/src/generators/migrate/angular-config-files.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extendRootEslintConfig = exports.mergeTsPaths = exports.fixProjectTsconfig = exports.appRootTsconfig = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const angular_project_json_1 = require("./angular-project-json");
+const names_1 = require("./names");
+const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** "./x" style relative path from directory `fromDir` to `to` (both workspace-relative). */
+function relativeFrom(fromDir, to) {
+    const r = path.posix.relative(fromDir, to);
+    return r.startsWith('.') ? r : `./${r}`;
+}
+/** compilerOptions the app tsconfig drops: the workspace base owns them. */
+const DROPPED_COMPILER_OPTIONS = ['baseUrl', 'paths', 'outDir'];
+/**
+ * The source root tsconfig.json → apps/<name>/tsconfig.json: extends the workspace base,
+ * keeps everything else except baseUrl, paths and outDir.
+ */
+function appRootTsconfig(source, m) {
+    // Its relative paths were relative to the source repo root; now to apps/<name>.
+    const local = { ...m, warnings: [] };
+    const rebase = (p) => typeof p === 'string' ? relativeFrom(m.projectRoot, (0, angular_project_json_1.mapPath)(p, local)) : p;
+    const out = { extends: `${(0, names_1.upTo)(m.projectRoot)}tsconfig.base.json` };
+    for (const [k, v] of Object.entries(source)) {
+        if (k === 'extends')
+            continue;
+        if (k === 'compilerOptions' && isObject(v)) {
+            const co = {};
+            for (const [o, ov] of Object.entries(v)) {
+                if (DROPPED_COMPILER_OPTIONS.includes(o))
+                    continue;
+                co[o] =
+                    o === 'typeRoots' && Array.isArray(ov)
+                        ? ov.filter((t) => !isNodeModulesTypes(t)).map(rebase)
+                        : ov;
+            }
+            out[k] = co;
+        }
+        else if ((k === 'include' || k === 'files' || k === 'exclude') && Array.isArray(v)) {
+            out[k] = v.map(rebase);
+        }
+        else if (k === 'references' && Array.isArray(v)) {
+            out[k] = v.map((r) => (isObject(r) ? { ...r, path: rebase(r['path']) } : r));
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+exports.appRootTsconfig = appRootTsconfig;
+/** "node_modules/@types" (any spelling): it does not move with the app. */
+function isNodeModulesTypes(p) {
+    return (typeof p === 'string' &&
+        path.posix.normalize(p.replace(/\\/g, '/')).replace(/\/$/, '') === 'node_modules/@types');
+}
+/**
+ * Fixes `extends` and `outDir` of a project tsconfig (tsconfig.app.json, tsconfig.spec.json, …)
+ * for its new location. `extends` pointing at the source root tsconfig.json now points at
+ * apps/<name>/tsconfig.json; `outDir` becomes <workspace>/dist/out-tsc.
+ */
+function fixProjectTsconfig(config, input) {
+    const warnings = [];
+    const out = { ...config };
+    const rel = input.sourceRoot
+        ? path.posix.relative(input.sourceRoot, input.sourceFile)
+        : input.sourceFile;
+    const newFile = `${input.projectRoot}/${rel}`;
+    const newDir = path.posix.dirname(newFile);
+    const ext = config['extends'];
+    if (typeof ext === 'string' && (ext.startsWith('./') || ext.startsWith('../'))) {
+        const resolved = path.posix.normalize(path.posix.join(path.posix.dirname(input.sourceFile), ext));
+        const insideProject = input.sourceRoot === ''
+            ? !resolved.startsWith('../')
+            : resolved.startsWith(`${input.sourceRoot}/`);
+        if (resolved === 'tsconfig.json') {
+            out['extends'] = relativeFrom(newDir, `${input.projectRoot}/tsconfig.json`);
+        }
+        else if (!insideProject) {
+            warnings.push(`${input.sourceFile}: extends "${ext}" is outside the project; left unchanged`);
+        }
+    }
+    const co = config['compilerOptions'];
+    if (isObject(co) && typeof co['outDir'] === 'string') {
+        out['compilerOptions'] = { ...co, outDir: relativeFrom(newDir, 'dist/out-tsc') };
+    }
+    return { config: out, warnings };
+}
+exports.fixProjectTsconfig = fixProjectTsconfig;
+/**
+ * Merges the source tsconfig `paths` into the workspace's. Source targets are relative to the
+ * source baseUrl; they are mapped to workspace-root paths. Existing aliases are never
+ * overwritten; an alias mapped to different targets is a clash.
+ */
+function mergeTsPaths(workspace, source, sourceBaseUrl, m) {
+    const paths = { ...workspace };
+    const added = [];
+    const clashes = [];
+    for (const [alias, targets] of Object.entries(source)) {
+        const list = (Array.isArray(targets) ? targets : [targets]).filter((t) => typeof t === 'string');
+        const mapped = list.map((t) => (0, angular_project_json_1.mapPath)(path.posix.join(sourceBaseUrl || '.', t), m));
+        const existing = paths[alias];
+        if (existing === undefined) {
+            paths[alias] = mapped;
+            added.push(alias);
+        }
+        else if (JSON.stringify(existing) !== JSON.stringify(mapped)) {
+            clashes.push({ alias, workspace: existing, source: mapped });
+        }
+    }
+    return { paths, added, clashes };
+}
+exports.mergeTsPaths = mergeTsPaths;
+/**
+ * A copied source .eslintrc.json made to extend the workspace root config: no `root`, the root
+ * config first in `extends`, "!**\/*" un-ignoring the app's files (the root ignores everything),
+ * and parserOptions.project paths mapped to the workspace root.
+ */
+function extendRootEslintConfig(config, m) {
+    const rest = Object.fromEntries(Object.entries(config).filter(([k]) => k !== 'root'));
+    const out = {};
+    const ext = rest['extends'];
+    const extendsList = Array.isArray(ext) ? [...ext] : typeof ext === 'string' ? [ext] : [];
+    const rootConfig = `${(0, names_1.upTo)(m.projectRoot)}.eslintrc.json`;
+    out['extends'] = [
+        rootConfig,
+        ...extendsList.filter((e) => e !== rootConfig && e !== '../../.eslintrc.json'),
+    ];
+    const ignore = Array.isArray(rest['ignorePatterns']) ? rest['ignorePatterns'] : [];
+    out['ignorePatterns'] = ['!**/*', ...ignore.filter((p) => p !== '!**/*')];
+    for (const [k, v] of Object.entries(rest)) {
+        if (k === 'extends' || k === 'ignorePatterns')
+            continue;
+        out[k] = k === 'overrides' && Array.isArray(v) ? v.map((o) => mapParserProject(o, m)) : v;
+    }
+    if (isObject(rest['parserOptions']))
+        out['parserOptions'] = mapParserProject({ parserOptions: rest['parserOptions'] }, m)['parserOptions'];
+    return out;
+}
+exports.extendRootEslintConfig = extendRootEslintConfig;
+function mapParserProject(override, m) {
+    if (!isObject(override) || !isObject(override['parserOptions']))
+        return override;
+    const po = override['parserOptions'];
+    const project = po['project'];
+    const mapOne = (p) => (typeof p === 'string' ? (0, angular_project_json_1.mapPath)(p, m) : p);
+    if (project === undefined)
+        return override;
+    return {
+        ...override,
+        parserOptions: {
+            ...po,
+            project: Array.isArray(project) ? project.map(mapOne) : mapOne(project),
+        },
+    };
+}
+//# sourceMappingURL=angular-config-files.js.map

package/dist/src/generators/migrate/angular-config-files.js.map

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

package/dist/src/generators/migrate/angular-project-json.d.ts

@@ -0,0 +1,73 @@
+import type { AngularProject } from './adapters/angular-cli';
+export { applicationBuilderTargets } from './angular17';
+export type { ApplicationBuilderTarget } from './angular17';
+/**
+ * angular.json project → Nx project.json, as a pure function (no tree, no fs).
+ *
+ * Paths in angular.json are relative to the Angular workspace root (the source repo root);
+ * in project.json they are relative to the Nx workspace root. The project's files move from
+ * the project `root` ("" for a standalone app) to apps/<name>.
+ */
+export interface PathMapper {
+    /** Source project root ("" for `ng new`), POSIX, no trailing slash. */
+    sourceRoot: string;
+    /** apps/<name> */
+    projectRoot: string;
+    name: string;
+    /**
+     * Whether a path (relative to the source repo root) exists in the source. Used for options
+     * that take either a file or a package name (polyfills, styles, scripts, assets).
+     */
+    exists: (sourceRelPath: string) => boolean;
+    /** Collects paths that could not be mapped (left unchanged). */
+    warnings: string[];
+    /** Other copied projects: source name → new name (for "<project>:<target>" references). */
+    renames?: ReadonlyMap<string, string>;
+}
+/** A path relative to the source repo root → relative to the Nx workspace root. */
+export declare function mapPath(p: string, m: PathMapper): string;
+/** dist/<x>[/rest] → dist/apps/<name>[/rest]; other paths are mapped like any path. */
+export declare function mapOutputPath(p: string, m: PathMapper): string;
+/** "<old project>:<target>[:<config>]" → "<name>:…". Other projects' targets are left alone. */
+export declare function renameTargetRef(value: string, oldProject: string, name: string): string;
+type Json = Record<string, unknown>;
+/** Rewrites the path and target options of one options/configuration object (a copy). */
+export declare function mapOptions(options: Json, oldProject: string, m: PathMapper): Json;
+/** Release configuration name for an Angular build configuration. */
+export declare function releaseConfigName(buildConfiguration: string): string;
+/** release target configurations derived from the build configurations, in build order. */
+export declare function releaseConfigurations(buildConfigurations: string[]): Record<string, {
+    env: string;
+    buildConfiguration: string;
+}>;
+/**
+ * Adds the polystack `release` target (configurations from the build configurations) to
+ * project.json targets, in place. Returns the release configuration names; [] with a warning
+ * when there is already a release target, no build target or no build configurations.
+ */
+export declare function addReleaseTarget(targets: Json, name: string, warnFn: (message: string) => void, projectRoot?: string): string[];
+/** Root npm scripts for a migrated Angular app (same style as `pstack app`). */
+export declare function angularAppNpmScripts(name: string, hasServe: boolean, releaseNames: string[]): Record<string, string>;
+export interface ProjectJsonInput {
+    /** The project's key in angular.json. */
+    sourceProject: string;
+    project: AngularProject;
+    /** The new app/project name. */
+    name: string;
+    exists: (sourceRelPath: string) => boolean;
+    /** Workspace folder (default apps/<name>). */
+    projectRoot?: string;
+    /** Other copied projects: source name → new name. */
+    renames?: ReadonlyMap<string, string>;
+}
+export interface ProjectJsonResult {
+    projectJson: Json;
+    /** Release configuration names (for npm scripts); empty when no release target was added. */
+    releaseConfigurations: string[];
+    /** Targets added by the migration. */
+    addedTargets: string[];
+    warnings: string[];
+    /** Angular 17+ builders converted for Angular 15: what changed or was dropped. */
+    angularNotes: string[];
+}
+export declare function angularProjectJson(input: ProjectJsonInput): ProjectJsonResult;