@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/src/generators/migrate/pnpm.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.catalogMissMessage = exports.sourceRootPackage = exports.sourceCatalogs = exports.resolveCatalogs = exports.pnpmWorkspaceOrNothing = exports.readPnpmWorkspace = void 0;
+const pnpm_yaml_1 = require("./npm-workspaces/pnpm-yaml");
+const source_1 = require("./source");
+const isMap = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const stringEntries = (v) => {
+    const out = {};
+    if (!isMap(v))
+        return out;
+    for (const [k, x] of Object.entries(v))
+        if (typeof x === 'string')
+            out[k] = x;
+    return out;
+};
+const PNPM_READ_KEYS = ['packages', 'catalog', 'catalogs', 'overrides', 'patchedDependencies'];
+/**
+ * pnpm-workspace.yaml, or undefined when the source has none. Throws (naming the file) when it
+ * cannot be read.
+ */
+function readPnpmWorkspace(sourceDir) {
+    const text = (0, source_1.readSourceText)(sourceDir, 'pnpm-workspace.yaml');
+    if (text === undefined)
+        return undefined;
+    let doc;
+    try {
+        doc = (0, pnpm_yaml_1.parsePnpmYaml)(text);
+    }
+    catch (err) {
+        throw new Error(`migrate: cannot read pnpm-workspace.yaml (${err.message}). Simplify that ` +
+            'part of the file and run the import again.');
+    }
+    const packages = Array.isArray(doc['packages'])
+        ? doc['packages'].filter((g) => typeof g === 'string' && g.trim() !== '')
+        : undefined;
+    const catalogs = {};
+    if (isMap(doc['catalogs'])) {
+        for (const [name, entries] of Object.entries(doc['catalogs'])) {
+            catalogs[name] = stringEntries(entries);
+        }
+    }
+    if (isMap(doc['catalog'])) {
+        catalogs['default'] = { ...(catalogs['default'] ?? {}), ...stringEntries(doc['catalog']) };
+    }
+    return {
+        packages,
+        catalogs,
+        overrides: stringEntries(doc['overrides']),
+        patchedDependencies: stringEntries(doc['patchedDependencies']),
+        otherKeys: Object.keys(doc).filter((k) => !PNPM_READ_KEYS.includes(k)),
+    };
+}
+exports.readPnpmWorkspace = readPnpmWorkspace;
+/** pnpm-workspace.yaml when it can be read; undefined when it is missing or broken. */
+function pnpmWorkspaceOrNothing(sourceDir) {
+    try {
+        return readPnpmWorkspace(sourceDir);
+    }
+    catch {
+        return undefined;
+    }
+}
+exports.pnpmWorkspaceOrNothing = pnpmWorkspaceOrNothing;
+const CATALOG = /^catalog:(.*)$/;
+/**
+ * A package.json with its pnpm `catalog:` / `catalog:<name>` specs replaced by the catalog's
+ * versions; the specs that name no entry stay and are listed as "dep (catalog:x)".
+ */
+function resolveCatalogs(pkg, catalogs) {
+    const unresolved = [];
+    const out = { ...pkg };
+    // peerDependencies are never merged, so an unknown entry there does not count.
+    for (const field of [
+        'dependencies',
+        'devDependencies',
+        'optionalDependencies',
+        'peerDependencies',
+    ]) {
+        const deps = pkg[field];
+        if (!deps)
+            continue;
+        const next = {};
+        for (const [name, spec] of Object.entries(deps)) {
+            const m = typeof spec === 'string' ? CATALOG.exec(spec.trim()) : null;
+            if (!m) {
+                next[name] = spec;
+                continue;
+            }
+            const version = catalogs[m[1].trim() || 'default']?.[name];
+            if (version === undefined || version === '' || CATALOG.test(version)) {
+                if (field !== 'peerDependencies')
+                    unresolved.push(`${name} (${spec.trim()})`);
+                next[name] = spec;
+            }
+            else
+                next[name] = version;
+        }
+        out[field] = next;
+    }
+    return { pkg: out, unresolved };
+}
+exports.resolveCatalogs = resolveCatalogs;
+/** Catalogs to resolve `catalog:` specs against: none without a readable pnpm-workspace.yaml. */
+function sourceCatalogs(sourceDir) {
+    return pnpmWorkspaceOrNothing(sourceDir)?.catalogs ?? {};
+}
+exports.sourceCatalogs = sourceCatalogs;
+/**
+ * Like sourceCatalogs, but a pnpm-workspace.yaml that cannot be read throws its parse error
+ * (for preflights, so the refusal names the real problem).
+ */
+function readableCatalogs(sourceDir) {
+    return readPnpmWorkspace(sourceDir)?.catalogs ?? {};
+}
+/**
+ * The source root package.json with `catalog:` specs resolved. Without pnpm catalogs (no
+ * pnpm-workspace.yaml, or Yarn catalogs, which are not read) every `catalog:` spec is unresolved.
+ */
+function sourceRootPackage(sourceDir) {
+    const pkg = (0, source_1.readSourceJson)(sourceDir, 'package.json');
+    if (!pkg)
+        return { pkg, unresolved: [] };
+    return resolveCatalogs(pkg, readableCatalogs(sourceDir));
+}
+exports.sourceRootPackage = sourceRootPackage;
+/** The refusal for `catalog:` specs that name no catalog entry. */
+function catalogMissMessage(owner, misses) {
+    return (`${owner} uses catalog entries that no pnpm-workspace.yaml catalog defines: ` +
+        `${misses.join(', ')}. (Yarn catalogs are not read.)`);
+}
+exports.catalogMissMessage = catalogMissMessage;
+//# sourceMappingURL=pnpm.js.map

package/dist/src/generators/migrate/pnpm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm.js","sourceRoot":"","sources":["../../../../src/generators/migrate/pnpm.ts"],"names":[],"mappings":";;;AAAA,0DAAsE;AACtE,qCAAuE;AAkBvE,MAAM,KAAK,GAAG,CAAC,CAAwB,EAAkC,EAAE,CACzE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,MAAM,aAAa,GAAG,CAAC,CAAwB,EAA0B,EAAE;IACzE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAE/F;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,SAAiB;IACjD,MAAM,IAAI,GAAG,IAAA,uBAAc,EAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAC9D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,GAA8B,CAAC;IACnC,IAAI;QACF,GAAG,GAAG,IAAA,yBAAa,EAAC,IAAI,CAAC,CAAC;KAC3B;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,IAAI,KAAK,CACb,6CAA8C,GAAa,CAAC,OAAO,mBAAmB;YACpF,4CAA4C,CAC/C,CAAC;KACH;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACtF,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,QAAQ,GAA2C,EAAE,CAAC;IAC5D,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE;YAC7D,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;SACzC;KACF;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE;QACzB,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;KAC5F;IACD,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1C,mBAAmB,EAAE,aAAa,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC9D,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;KACvE,CAAC;AACJ,CAAC;AA/BD,8CA+BC;AAED,uFAAuF;AACvF,SAAgB,sBAAsB,CAAC,SAAiB;IACtD,IAAI;QACF,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;KACrC;IAAC,MAAM;QACN,OAAO,SAAS,CAAC;KAClB;AACH,CAAC;AAND,wDAMC;AAED,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC;;;GAGG;AACH,SAAgB,eAAe,CAC7B,GAAM,EACN,QAAgD;IAEhD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IACvB,+EAA+E;IAC/E,KAAK,MAAM,KAAK,IAAI;QAClB,cAAc;QACd,iBAAiB;QACjB,sBAAsB;QACtB,kBAAkB;KACV,EAAE;QACV,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC/C,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtE,IAAI,CAAC,CAAC,EAAE;gBACN,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;gBAClB,SAAS;aACV;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBACpE,IAAI,KAAK,KAAK,kBAAkB;oBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC9E,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;aACnB;;gBAAM,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;SAC7B;QACA,GAAmB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;KACpC;IACD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AA/BD,0CA+BC;AAED,iGAAiG;AACjG,SAAgB,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;AAC3D,CAAC;AAFD,wCAEC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,SAAiB;IAEjB,MAAM,GAAG,GAAG,IAAA,uBAAc,EAAI,SAAS,EAAE,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACzC,OAAO,eAAe,CAAC,GAAG,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3D,CAAC;AAND,8CAMC;AAED,mEAAmE;AACnE,SAAgB,kBAAkB,CAAC,KAAa,EAAE,MAAgB;IAChE,OAAO,CACL,GAAG,KAAK,qEAAqE;QAC7E,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,CACtD,CAAC;AACJ,CAAC;AALD,gDAKC"}

package/dist/src/generators/migrate/report.d.ts

@@ -0,0 +1,21 @@
+import type { Detection, MigrationReportData } from './adapters/types';
+export interface ReportInput {
+    name: string;
+    adapterId: string;
+    adapterLabel: string;
+    detection: Detection;
+    /** Chosen with --adapter. */
+    forced: boolean;
+    /** Single-app imports: the app folder (default apps/<name>). */
+    projectRoot?: string;
+    /** --min-confidence, when given. */
+    minConfidence?: number;
+    /** --source as given on the command line. */
+    source: string;
+    data: MigrationReportData;
+}
+/**
+ * docs/migrations/<name>.md. Deterministic: no timestamps, sorted lists, so re-running the
+ * same migration gives the same file.
+ */
+export declare function renderReport(r: ReportInput): string;

package/dist/src/generators/migrate/report.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReport = void 0;
+const dependencies_1 = require("../../lib/utils/dependencies");
+const adapters_1 = require("./adapters");
+const workspace_source_1 = require("./nx/workspace-source");
+const code = (s) => `\`${s.replace(/`/g, "'")}\``;
+function list(items, empty) {
+    return items.length === 0 ? empty : items.map((i) => `- ${i}`).join('\n');
+}
+/**
+ * docs/migrations/<name>.md. Deterministic: no timestamps, sorted lists, so re-running the
+ * same migration gives the same file.
+ */
+function renderReport(r) {
+    const d = r.data;
+    const ws = 'projects' in d ? d : undefined;
+    const out = [];
+    out.push(`# Migration report: ${r.name}`);
+    out.push(`Generated by \`pstack migrate\` (nx-polystack :migrate). The source was copied, not moved; ` +
+        'it was not modified.');
+    out.push('## Summary');
+    out.push([
+        `- Source: ${code(r.source)}`,
+        `- Adapter: ${code(r.adapterId)} (${r.adapterLabel})`,
+        `- Confidence: ${r.detection.confidence.toFixed(2)}${r.forced
+            ? ' (selected with `--adapter`)'
+            : r.minConfidence !== undefined && r.detection.confidence < adapters_1.MIN_CONFIDENCE
+                ? ` (accepted with --min-confidence=${r.minConfidence})`
+                : ''}`,
+        `- Detection: ${r.detection.reasons.join('; ')}`,
+        ws
+            ? `- Projects: ${ws.projects.length} migrated, ${ws.unsupported.length} not supported`
+            : `- App: ${code(r.name)} in ${code(r.projectRoot ?? `apps/${r.name}`)}`,
+        `- Files copied: ${d.copied}`,
+        `- Paths skipped: ${d.skipped.length}`,
+        `- Possible secrets not copied: ${d.secrets.length}`,
+        `- File list: ${d.gitListed
+            ? 'git (tracked, and untracked but not ignored, files only)'
+            : d.gitignoreUsed
+                ? 'all files except those the source .gitignore files ignore (not a git work tree)'
+                : 'all files (not a git work tree, no .gitignore)'}`,
+    ].join('\n'));
+    if (ws) {
+        out.push('## Projects');
+        out.push((ws.layout === 'apps-libs'
+            ? 'Apps were copied to `apps/<name>` and libraries to `libs/<name>`. Import aliases keep ' +
+                'their names and point at the new folders (library aliases at the library source); ' +
+                'source files are unchanged.\n\n'
+            : 'Copied to the same paths; project names, import aliases and source files are ' +
+                'unchanged (except for `--prefix` renames and the project.json/ESLint updates).\n\n') +
+            table(['Project', 'Kind', 'Root', 'Why'], ws.projects.map((p) => [
+                p.name === p.sourceName
+                    ? code(p.name)
+                    : `${code(p.name)} (source: ${code(p.sourceName)})`,
+                p.kind,
+                code(p.root),
+                p.why,
+            ])));
+        out.push('## Not migrated');
+        out.push(ws.unsupported.length === 0
+            ? 'None.'
+            : 'Kinds nx-polystack cannot migrate yet:\n\n' +
+                table(['Project', 'Kind', 'Root', 'Why'], ws.unsupported.map((u) => [
+                    code(u.name),
+                    u.kind,
+                    code(u.root),
+                    (0, workspace_source_1.unsupportedReason)(u.kind) ?? 'not supported yet',
+                ])));
+    }
+    if (d.secrets.length > 0) {
+        out.push('## Not copied: possible secrets');
+        out.push('Environment files, signing keys, credentials and service configs are never copied. Add ' +
+            'what the app needs by hand, outside version control where it belongs.\n\n' +
+            list([...d.secrets].sort().map(code), 'None.'));
+    }
+    out.push('## Skipped paths');
+    out.push('Not copied (directories end with `/`; build output, caches, VCS data, and workspace-level ' +
+        'files that the migration rewrites into the workspace instead).\n\n' +
+        list([...d.skipped].sort().map(code), 'None.'));
+    if (d.npmProject) {
+        out.push('## Dependencies');
+        out.push('Source dependencies are added to the root `package.json` only when missing; existing ' +
+            'versions are never changed.\n\n' +
+            `Added (${d.dependenciesAdded.length}):\n\n` +
+            list([...d.dependenciesAdded].sort().map(code), 'None.') +
+            '\n\nVersion clashes (the workspace version was kept):\n\n' +
+            (d.dependencyClashes.length === 0
+                ? 'None.'
+                : table(['Package', 'Workspace', 'Source'], [...d.dependencyClashes]
+                    .sort((a, b) => (a.name < b.name ? -1 : 1))
+                    .map((c) => [code(c.name), code(c.workspace), code(c.source)]))));
+    }
+    if (d.angularNotes.length > 0) {
+        out.push('## Angular version');
+        out.push(list(d.angularNotes, 'None.'));
+    }
+    if (d.npmProject) {
+        out.push('## TypeScript path aliases');
+        out.push(`Added to \`tsconfig.base.json\`: ${d.tsPathsAdded.length ? [...d.tsPathsAdded].sort().map(code).join(', ') : 'none'}.\n\n` +
+            'Clashes (the workspace mapping was kept):\n\n' +
+            (d.tsPathClashes.length === 0
+                ? 'None.'
+                : table(['Alias', 'Workspace', 'Source'], [...d.tsPathClashes]
+                    .sort((a, b) => (a.alias < b.alias ? -1 : 1))
+                    .map((c) => [
+                    code(c.alias),
+                    c.workspace.map(code).join(', '),
+                    c.source.map(code).join(', '),
+                ]))));
+        if (d.packageFields.length > 0) {
+            out.push('## Other package.json fields');
+            out.push(d.packageFields
+                .map((f) => `- ${code(f.field)} (${f.handling}): ${f.entries
+                .map(([k, v]) => `${code(k)}: ${code(v)}`)
+                .join(', ')}`)
+                .join('\n'));
+        }
+        out.push('## Source scripts not carried over');
+        const scripts = Object.entries(d.sourceScripts).sort(([a], [b]) => (a < b ? -1 : 1));
+        out.push(scripts.length === 0
+            ? 'None.'
+            : 'Use the root `package.json` scripts and Nx targets instead. The source had:\n\n' +
+                list(scripts.map(([k, v]) => `${code(k)}: ${code(v)}`), 'None.'));
+    }
+    if (d.imports) {
+        out.push('## Imports');
+        out.push(importsBlock(d.imports));
+    }
+    if (d.ionic && d.ionic.length > 0) {
+        out.push('## Ionic');
+        for (const i of d.ionic)
+            out.push(ionicBlock(i));
+    }
+    if (d.notes.length > 0) {
+        out.push('## Check by hand');
+        out.push(list(d.notes, 'None.'));
+    }
+    out.push('## Next steps');
+    out.push([
+        '- [ ] `npm install`',
+        ...d.nextSteps.map((s) => `- [ ] ${s}`),
+        '- [ ] Remove the old repo when you are happy with the migrated app',
+        `- [ ] Undo this migration: \`pstack migrate --rollback=${r.name}\``,
+    ].join('\n'));
+    return out.join('\n\n') + '\n';
+}
+exports.renderReport = renderReport;
+function table(header, rows) {
+    const cells = rows.map((r) => r.map((c) => c.replace(/\|/g, '\\|')));
+    const widths = header.map((h, i) => Math.max(3, h.length, ...cells.map((r) => r[i].length)));
+    const line = (r) => `| ${r.map((c, i) => c.padEnd(widths[i])).join(' | ')} |`;
+    return [line(header), line(widths.map((w) => '-'.repeat(w))), ...cells.map(line)].join('\n');
+}
+const KIND_LABEL = {
+    'cross-project': 'into another moved project',
+    'base-url': 'through the source `baseUrl`',
+    nrwl: '`@nrwl/*` to `@nx/*`',
+    'node-modules': 'into the root `node_modules`',
+};
+/** Compares string tuples element by element (0 on ties, for a deterministic sort). */
+function byKeys(a, b) {
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return a[i] < b[i] ? -1 : 1;
+    }
+    return 0;
+}
+/** The "## Imports" section: rewritten imports by kind, then what was left as it was. */
+function importsBlock(r) {
+    const parts = [];
+    const files = new Set(r.rewritten.map((w) => w.file));
+    parts.push(r.rewritten.length === 0
+        ? 'No imports needed rewriting.'
+        : `Rewrote ${r.rewritten.length} import${r.rewritten.length > 1 ? 's' : ''} in ` +
+            `${files.size} copied file${files.size > 1 ? 's' : ''} (the source was not changed):`);
+    if (r.rewritten.length > 0) {
+        parts.push(table(['File', 'Kind', 'Before', 'After'], [...r.rewritten]
+            .sort((a, b) => byKeys([a.file, a.before, a.kind], [b.file, b.before, b.kind]))
+            .map((w) => [code(w.file), KIND_LABEL[w.kind], code(w.before), code(w.after)])));
+    }
+    if (r.deepImports.length > 0) {
+        parts.push("These imports reach below another project's entry and now use a relative path; export " +
+            'what they need from the library entry and import it through its alias:\n\n' +
+            list([...r.deepImports]
+                .sort((a, b) => byKeys([a.file, a.spec], [b.file, b.spec]))
+                .map((x) => `${code(x.file)}: ${code(x.spec)}`), 'None.'));
+    }
+    if (r.unresolved.length > 0) {
+        parts.push('Left as they were (fix them by hand):\n\n' +
+            list([...r.unresolved]
+                .sort((a, b) => byKeys([a.file, a.spec, a.why], [b.file, b.spec, b.why]))
+                .map((x) => `${code(x.file)}: ${code(x.spec)} (${x.why})`), 'None.'));
+    }
+    if (r.missingPackages.length > 0) {
+        parts.push(`The rewritten imports use ${r.missingPackages.map(code).join(', ')}, which the workspace ` +
+            "does not declare; add them at the workspace's Nx version (`npm i -D <package>@<nx version>`).");
+    }
+    return parts.join('\n\n');
+}
+function ionicBlock(i) {
+    const codes = (xs) => xs.map(code).join(', ');
+    const lines = [`### ${code(i.project)}`, ''];
+    if (i.ionic) {
+        lines.push(`- Ionic: ${code(i.ionic)}${(0, dependencies_1.majorOf)(i.ionic) === 6 ? ' (Ionic 6: works with Angular 15; plan the move to 7)' : ''}`);
+    }
+    if (i.capacitor) {
+        lines.push(`- Capacitor: ${code(i.capacitor)}${(0, dependencies_1.majorOf)(i.capacitor) !== 5
+            ? ' (the workspace generates Capacitor 5 apps; this app keeps its version)'
+            : ''}`);
+    }
+    lines.push(`- Native packages (in ${code(i.packagePath)}): ${i.nativePackages.length > 0 ? codes(i.nativePackages) : 'none'}`);
+    if (i.alsoAtRoot.length > 0) {
+        lines.push(`- Also in the root package.json (the code imports them, so the web build needs them): ${codes(i.alsoAtRoot)}`);
+    }
+    if (i.otherApps.length > 0) {
+        lines.push(`- Left to the other Ionic apps (this app does not import them): ${codes(i.otherApps)}`);
+    }
+    if (i.webDir?.manual === 'not-set') {
+        lines.push(`- \`webDir\` is not set in ${code(i.webDir.file)} (Capacitor then uses \`www\`): add ` +
+            `\`webDir: '${i.webDir.to}'\``);
+    }
+    else if (i.webDir?.manual) {
+        lines.push(`- \`webDir\` in ${code(i.webDir.file)}: set it to ${code(i.webDir.to)} by hand ` +
+            '(it is not a plain string)');
+    }
+    else if (i.webDir) {
+        lines.push(`- \`webDir\` in ${code(i.webDir.file)}: ${code(i.webDir.from ?? '(unset)')} → ${code(i.webDir.to)}`);
+    }
+    if (i.outputPathMoved) {
+        lines.push(`- Build output moved from ${code(i.outputPathMoved)} to the release output`);
+    }
+    lines.push(`- Native platforms copied: ${i.platforms.length > 0
+        ? i.platforms.join(', ')
+        : `none (add them with \`npx nx run ${i.project}:cap-add --platform=android\`)`}`);
+    if (i.cordovaPlugins.length > 0) {
+        lines.push(`- Cordova plugins (check each one works with Capacitor): ${codes(i.cordovaPlugins)}`);
+    }
+    if (i.droppedTargets.length > 0)
+        lines.push(`- Targets dropped: ${codes(i.droppedTargets)}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/src/generators/migrate/report.js.map

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

package/dist/src/generators/migrate/rollback/manifest.d.ts

@@ -0,0 +1,84 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Tree } from '@nx/devkit';
+import type { Originals } from './recording-tree';
+export declare const MIGRATIONS_DIR = "docs/migrations";
+export declare const reportPath: (name: string) => string;
+export declare const manifestPath: (name: string) => string;
+export declare const rollbackNotesPath: (name: string) => string;
+export type JsonKey = string[];
+export type JsonChange = {
+    key: JsonKey;
+    added: unknown;
+} | {
+    key: JsonKey;
+    from: unknown;
+    to: unknown;
+} | {
+    key: JsonKey;
+    removed: unknown;
+}
+/** Arrays of scalars: the elements the run added and removed (so later additions survive). */
+ | {
+    key: JsonKey;
+    arrayAdded: Scalar[];
+    arrayRemoved: Scalar[];
+};
+export type Scalar = string | number | boolean | null;
+export interface CreatedEntry {
+    path: string;
+    sha256: string;
+}
+export interface JsonEntry {
+    path: string;
+    /** Content before the run: restored byte for byte when the file is unchanged since. */
+    previous: string;
+    encoding?: 'base64';
+    /** Hash of the content the run left. */
+    sha256: string;
+    changes: JsonChange[];
+}
+export interface TextEntry {
+    path: string;
+    /** Content before the run (base64 when `encoding` says so). */
+    previous: string;
+    encoding?: 'base64';
+    /** Hash of the content the run left; absent when the run deleted the file. */
+    sha256?: string;
+    deleted?: true;
+}
+export interface Manifest {
+    version: 1;
+    name: string;
+    adapter: string;
+    source: string;
+    plugin: string;
+    /** Ionic app folders (each has its own node_modules, not removed by a rollback). */
+    ionicApps?: string[];
+    created: CreatedEntry[];
+    json: JsonEntry[];
+    text: TextEntry[];
+}
+export interface ManifestMeta {
+    name: string;
+    adapter: string;
+    source: string;
+    plugin: string;
+    ionicApps: string[];
+}
+export declare const isPlainObject: (v: unknown) => v is Record<string, unknown>;
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/** Key-level diff: object keys recurse (sorted); arrays and scalars compare whole. */
+export declare function diffJson(before: unknown, after: unknown, key?: JsonKey): JsonChange[];
+export declare const isScalarArray: (v: unknown) => v is Scalar[];
+/** Elements of `a` not matched in `b`, counting duplicates. */
+export declare function minus(a: Scalar[], b: Scalar[]): Scalar[];
+/** Text between the nx-polystack markers is dropped: every run refreshes it. */
+export declare function stripLlmBlock(text: string): string;
+/** sha256 of a file; a text file with nx-polystack markers is hashed without the managed block. */
+export declare function contentHash(content: Buffer): string;
+/** What the run changed, from the recorded originals and the tree as the run left it. */
+export declare function buildManifest(tree: Tree, originals: Originals, meta: ManifestMeta): Manifest;
+export declare function writeManifest(tree: Tree, manifest: Manifest): void;
+/** The manifest of migration `name`, or null when there is none. */
+export declare function readManifest(tree: Tree, name: string): Manifest | null;