@vc-shell/migrate 2.0.0-alpha.32 → 2.0.0-alpha.33

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [2.0.0-alpha.33](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.32...v2.0.0-alpha.33) (2026-04-14)
+
+
+### Bug Fixes
+
+* **migrate:** fix 7 critical bugs found during real-app testing ([41688a1](https://github.com/VirtoCommerce/vc-shell/commit/41688a164250d397c51b6007953bc112f63ee4b9))
+* **migrate:** improve useBladeForm diagnostic — onBeforeClose must be removed, show closeConfirmMessage example ([274bf9a](https://github.com/VirtoCommerce/vc-shell/commit/274bf9aac965b8c8cecada58d7959d547da7f52b))
+
+
+### Features
+
+* **migrate:** add 4 new transforms (injection-keys, replace-cover, locale-imports, window-globals) ([bbcbc79](https://github.com/VirtoCommerce/vc-shell/commit/bbcbc79530ad237ed4d9bd4519ba164559b125a5))
+* **migrate:** add after field to VersionedTransform for dependency ordering ([a854662](https://github.com/VirtoCommerce/vc-shell/commit/a85466259f908c585161e6db43337c1b1e5d2ece))
+* **migrate:** add defineExpose → exposeToChildren transform + improve widgets diagnostic ([d73352c](https://github.com/VirtoCommerce/vc-shell/commit/d73352c02630f3cf2b046f524769ac8d4cec1f0f))
+* **migrate:** add release-config cleanup and VcTable audits ([23118dd](https://github.com/VirtoCommerce/vc-shell/commit/23118dd74e9bd4387b166bd5e35a341ad81cd6be))
+* **migrate:** declare after dependencies for blade-props, define-options, remove-pathmatch ([90167af](https://github.com/VirtoCommerce/vc-shell/commit/90167afbe8d07fc88a9543eb431edf6b29e5aba9))
+* **migrate:** generate MIGRATION_REPORT.md with automated/manual/uncovered sections ([3d9d2a1](https://github.com/VirtoCommerce/vc-shell/commit/3d9d2a10844ffe940e96a3f74bf40c24ff6e7a71))
+* **migrate:** idempotency guard — second run produces zero modifications ([cd91b25](https://github.com/VirtoCommerce/vc-shell/commit/cd91b250a8a5235543f6a5fe4330a86d530b250a))
+* **migrate:** replace-cover-method — openBlade({ replaceCurrentBlade: true }) → coverWith() ([cb24cd8](https://github.com/VirtoCommerce/vc-shell/commit/cb24cd8353847fd9c7ddc91927f726cba3ada00b))
+* **migrate:** structured migration report with before/after examples and guide links ([2f5c2da](https://github.com/VirtoCommerce/vc-shell/commit/2f5c2da289abb9977464fb8772ddcfe2c3daa17d))
+* **migrate:** topological sort for transform dependency ordering ([24a4446](https://github.com/VirtoCommerce/vc-shell/commit/24a44463fd9e114401b989114aacfc07ddb5250f))
 # [2.0.0-alpha.32](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.31...v2.0.0-alpha.32) (2026-04-02)
 
 **Note:** Version bump only for package @vc-shell/migrate

package/dist/cli.js

@@ -15,6 +15,7 @@ program
     .option("--cwd <path>", "Working directory", ".")
     .option("--update-deps", "Also update dependency versions in package.json", false)
     .option("--exclude <patterns...>", "Additional exclude patterns for files/directories", [])
+    .option("--no-report", "Skip MIGRATION_REPORT.md generation", false)
     .action(async (options) => {
     const cwd = resolve(options.cwd);
     // Pre-flight: dirty working tree check
@@ -42,6 +43,7 @@ program
         list: options.list,
         updateDeps: options.updateDeps,
         exclude: options.exclude ?? [],
+        noReport: options.noReport ?? false,
     });
 });
 program.parse();

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,gBAAgB,EAAE,4CAA4C,CAAC;KACtE,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,CAAC;KAC7D,MAAM,CAAC,WAAW,EAAE,uCAAuC,EAAE,KAAK,CAAC;KACnE,MAAM,CAAC,QAAQ,EAAE,2BAA2B,EAAE,KAAK,CAAC;KACpD,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,eAAe,EAAE,iDAAiD,EAAE,KAAK,CAAC;KACjF,MAAM,CAAC,yBAAyB,EAAE,mDAAmD,EAAE,EAAE,CAAC;KAC1F,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjC,uCAAuC;IACvC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;gBAC5D,GAAG;gBACH,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,yCAAyC;oBACvC,gEAAgE,CACnE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,MAAM,GAAG,CAAC;QACR,GAAG;QACH,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KAC/B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,gBAAgB,EAAE,4CAA4C,CAAC;KACtE,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,CAAC;KAC7D,MAAM,CAAC,WAAW,EAAE,uCAAuC,EAAE,KAAK,CAAC;KACnE,MAAM,CAAC,QAAQ,EAAE,2BAA2B,EAAE,KAAK,CAAC;KACpD,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,eAAe,EAAE,iDAAiD,EAAE,KAAK,CAAC;KACjF,MAAM,CAAC,yBAAyB,EAAE,mDAAmD,EAAE,EAAE,CAAC;KAC1F,MAAM,CAAC,aAAa,EAAE,qCAAqC,EAAE,KAAK,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjC,uCAAuC;IACvC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;gBAC5D,GAAG;gBACH,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,yCAAyC;oBACvC,gEAAgE,CACnE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,MAAM,GAAG,CAAC;QACR,GAAG;QACH,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;KACpC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/dep-updater.d.ts

@@ -0,0 +1 @@
+export declare function updateDependencyVersions(cwd: string, targetVersion: string, dryRun: boolean): string[];

package/dist/dep-updater.js

@@ -0,0 +1,31 @@
+import { join } from "node:path";
+import { readFileSync, existsSync } from "node:fs";
+import writeFileAtomic from "write-file-atomic";
+export function updateDependencyVersions(cwd, targetVersion, dryRun) {
+    const pkgPath = join(cwd, "package.json");
+    if (!existsSync(pkgPath))
+        return [];
+    const pkgRaw = readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(pkgRaw);
+    const changes = [];
+    for (const depType of ["dependencies", "devDependencies"]) {
+        const deps = pkg[depType];
+        if (!deps)
+            continue;
+        for (const name of Object.keys(deps)) {
+            if (name.startsWith("@vc-shell/")) {
+                const oldVersion = deps[name];
+                const newVersion = `^${targetVersion}`;
+                if (oldVersion !== newVersion) {
+                    changes.push(`${name}: ${oldVersion} → ${newVersion}`);
+                    deps[name] = newVersion;
+                }
+            }
+        }
+    }
+    if (changes.length > 0 && !dryRun) {
+        writeFileAtomic.sync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    }
+    return changes;
+}
+//# sourceMappingURL=dep-updater.js.map

package/dist/dep-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-updater.js","sourceRoot":"","sources":["../src/dep-updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,aAAqB,EAAE,MAAe;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAU,EAAE,CAAC;QACnE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,MAAM,UAAU,GAAG,IAAI,aAAa,EAAE,CAAC;gBACvC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,UAAU,MAAM,UAAU,EAAE,CAAC,CAAC;oBACvD,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/file-scanner.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_EXCLUDES: string[];
+export declare function findFiles(dir: string, extensions: string[], excludes: string[]): string[];
+export declare function collectNotifyTypeMap(srcDir: string): Map<string, Record<string, Record<string, string>>>;

package/dist/file-scanner.js

@@ -0,0 +1,102 @@
+import { join } from "node:path";
+import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
+import { parse as parseSFC } from "@vue/compiler-sfc";
+export const DEFAULT_EXCLUDES = ["api_client", "*.generated.ts", "*.d.ts"];
+export function findFiles(dir, extensions, excludes) {
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { encoding: "utf-8" });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry === "node_modules" || entry.startsWith(".") || entry === "dist")
+            continue;
+        if (excludes.includes(entry))
+            continue;
+        const full = join(dir, entry);
+        try {
+            const stat = statSync(full);
+            if (stat.isDirectory()) {
+                results.push(...findFiles(full, extensions, excludes));
+            }
+            else if (extensions.some((ext) => entry.endsWith(ext))) {
+                const excluded = excludes.some((pattern) => {
+                    if (pattern.startsWith("*")) {
+                        return entry.endsWith(pattern.slice(1));
+                    }
+                    return entry === pattern;
+                });
+                if (!excluded) {
+                    results.push(full);
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return results;
+}
+// Scan src/modules/{module}/components/notifications/{file}.vue to build a mapping
+// of notifyType event names to file names, keyed by module directory.
+export function collectNotifyTypeMap(srcDir) {
+    const result = new Map();
+    const modulesDir = join(srcDir, "modules");
+    if (!existsSync(modulesDir))
+        return result;
+    let moduleEntries;
+    try {
+        moduleEntries = readdirSync(modulesDir, { encoding: "utf-8" });
+    }
+    catch {
+        return result;
+    }
+    for (const moduleEntry of moduleEntries) {
+        const moduleDir = join(modulesDir, moduleEntry);
+        try {
+            if (!statSync(moduleDir).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const notifDir = join(moduleDir, "components", "notifications");
+        if (!existsSync(notifDir))
+            continue;
+        const notifications = {};
+        let files;
+        try {
+            files = readdirSync(notifDir, { encoding: "utf-8" });
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".vue"))
+                continue;
+            try {
+                const filePath = join(notifDir, file);
+                const source = readFileSync(filePath, "utf-8");
+                const { descriptor } = parseSFC(source, { filename: filePath });
+                const scriptBlock = descriptor.scriptSetup ?? descriptor.script;
+                if (!scriptBlock)
+                    continue;
+                const match = scriptBlock.content.match(/(?:defineOptions|defineBlade)\s*\(\s*\{[^}]*notifyType\s*:\s*["']([^"']+)["']/s);
+                if (match) {
+                    notifications[match[1]] = file;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        if (Object.keys(notifications).length > 0) {
+            result.set(moduleDir, { "./components/notifications": notifications });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../src/file-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAW,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAE3E,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,UAAoB,EAAE,QAAkB;IAC7E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,cAAc,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,MAAM;YAAE,SAAS;QACpF,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzD,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBACzC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1C,CAAC;oBACD,OAAO,KAAK,KAAK,OAAO,CAAC;gBAC3B,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mFAAmF;AACnF,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkD,CAAC;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,MAAM,CAAC;IAE3C,IAAI,aAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,aAAa,GAAG,WAAW,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAAE,SAAS;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QAEpC,MAAM,aAAa,GAA2B,EAAE,CAAC;QACjD,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC/C,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAChE,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC;gBAChE,IAAI,CAAC,WAAW;oBAAE,SAAS;gBAE3B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CACrC,gFAAgF,CACjF,CAAC;gBACF,IAAI,KAAK,EAAE,CAAC;oBACV,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;gBACjC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,4BAA4B,EAAE,aAAa,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/report-generator.d.ts

@@ -0,0 +1,2 @@
+import type { TransformReport } from "./transforms/types.js";
+export declare function generateMigrationReport(cwd: string, currentVersion: string, targetVersion: string, allReports: TransformReport[], depChanges: string[], sourceFiles: string[]): void;

package/dist/report-generator.js

@@ -0,0 +1,271 @@
+import { readFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import writeFileAtomic from "write-file-atomic";
+/** Migration guides without automated transforms — for "Not Covered" section */
+const UNCOVERED_GUIDES = [
+    { guide: "03-moment-to-datefns", grep: "moment", description: "moment.js → date-fns migration" },
+    {
+        guide: "08-dynamic-views-removal",
+        grep: "DynamicBladeList|DynamicBladeForm",
+        description: "Remove DynamicBladeList/DynamicBladeForm",
+    },
+    { guide: "16-login-form", grep: "useLogin", description: "useLogin composable API changes" },
+    { guide: "29-vc-table-to-data-table", grep: "VcTable\\b", description: "Old VcTable → VcDataTable migration" },
+];
+const MANUAL_TOPICS = {
+    "widgets-migration": {
+        title: "Widget System Rewrite",
+        description: "The old imperative `registerWidget()`/`unregisterWidget()` API is replaced by a declarative `useBladeWidgets()` composable. " +
+            "Widget `.vue` files for standard sidebar items are no longer needed — use headless config objects instead. " +
+            "Create a `useXxxWidgets.ts` composable in your module's `widgets/` directory.",
+        example: `\`\`\`ts
+// OLD: imperative registration in blade page
+const { registerWidget, clearBladeWidgets } = useWidgets();
+const blade = inject(BladeInstance);
+registerWidget({ id: "MyWidget", component: MyWidgetVue, props: { item } }, blade.id);
+onUnmounted(() => clearBladeWidgets(blade.id));
+
+// NEW: declarative composable (create widgets/useMyWidgets.ts)
+import { useBladeWidgets, useBlade } from "@vc-shell/framework";
+
+export function useMyWidgets(options: { item: Ref<MyItem>; isVisible: ComputedRef<boolean> }) {
+  const { openBlade } = useBlade();
+  return useBladeWidgets([
+    {
+      id: "MyWidget",
+      icon: "lucide-tag",
+      title: "MY_MODULE.WIDGETS.MY_WIDGET.TITLE",
+      badge: computed(() => options.item.value?.count ?? 0),
+      isVisible: options.isVisible,
+      onClick: () => openBlade({ name: "MyWidgetBlade" }),
+      onRefresh: () => loadData(),
+    },
+  ]);
+}
+
+// In blade page: const { refreshAll } = useMyWidgets({ item, isVisible: computed(() => !!param.value) });
+\`\`\``,
+        guide: "migration/13-widgets.md",
+    },
+    "use-blade-form": {
+        title: "Form Management with useBladeForm()",
+        description: "`useForm()` (vee-validate) + manual `onBeforeClose()` + `modified` tracking are replaced by a single `useBladeForm()` composable. " +
+            "Remove all three and replace with one call. `useBladeForm` handles close confirmation, modification tracking, and form validation automatically.",
+        example: `\`\`\`ts
+// OLD:
+import { useForm } from "vee-validate";
+const { meta } = useForm({ validateOnMount: false });
+const isModified = computed(() => meta.value.dirty);
+onBeforeClose(async () => {
+  if (isModified.value) {
+    return !(await showConfirmation(t("CLOSE_CONFIRMATION")));
+  }
+});
+
+// NEW:
+import { useBladeForm } from "@vc-shell/framework";
+const form = useBladeForm({
+  data: item,  // your reactive data ref
+  closeConfirmMessage: computed(() => t("CLOSE_CONFIRMATION")),
+});
+// form.modified, form.isValid, form.validate(), form.resetForm(), form.setBaseline()
+// onBeforeClose is handled automatically — DELETE it
+\`\`\``,
+        guide: "migration/37-use-blade-form.md",
+    },
+    "remove-deprecated-aliases": {
+        title: "Injection Key Migration",
+        description: "`inject(BladeInstance)` is removed. Blade context is now provided by `useBlade()` composable — it gives you `param`, `options`, `callParent`, `closeSelf`, etc.",
+        example: `\`\`\`ts
+// OLD:
+const blade = inject(BladeInstance);
+
+// NEW:
+const { param, options, callParent, closeSelf } = useBlade();
+\`\`\``,
+        guide: "migration/21-injection-keys.md",
+    },
+    "nswag-class-to-interface": {
+        title: "NSwag DTO Class → Interface Migration",
+        description: "API client DTOs changed from classes (with `new DtoClass()`) to interfaces (with `{} as DtoClass`). " +
+            "The migrator handles simple cases automatically. Clone-then-mutate patterns (`new X(); x.field = value;`) require manual rewrite.",
+        example: `\`\`\`ts
+// Clone-then-mutate (manual migration):
+// OLD:
+const criteria = new SearchCriteria();
+criteria.take = 20;
+criteria.sort = "name:ASC";
+
+// NEW:
+const criteria = { take: 20, sort: "name:ASC" } as SearchCriteria;
+\`\`\``,
+        guide: "migration/nswag-class-to-interface.md",
+    },
+    "blade-props-simplification": {
+        title: "Reusable Blade Components",
+        description: "Components with blade props (expanded/closable) but no `defineBlade()` were skipped — they are reusable components, not blade pages. " +
+            "If these components pass blade props to child blades, remove the forwarding — child blades should call `useBlade()` directly.",
+        example: `\`\`\`vue
+<!-- OLD: wrapper forwarding blade props -->
+<MyBlade :expanded="expanded" :closable="closable" :param="param"
+  @close:blade="$emit('close:blade')" />
+
+<!-- NEW: wrapper passes only domain props, child calls useBlade() -->
+<MyBlade :config="config" />
+\`\`\``,
+        guide: "migration/11-blade-props.md",
+    },
+    "replace-cover-method": {
+        title: "replaceWith() Semantics Change",
+        description: "`replaceWith()` now truly destroys the old blade. If you relied on the old blade staying alive underneath, use `coverWith()` instead.",
+        example: `\`\`\`ts
+// If old blade should stay alive (e.g. preview):
+const { coverWith } = useBlade();
+await coverWith({ name: "Preview", param: id });
+
+// If old blade should be destroyed (e.g. create → edit):
+const { replaceWith } = useBlade();
+await replaceWith({ name: "EditOrder", param: order.id });
+\`\`\``,
+        guide: "migration/12-replace-cover.md",
+    },
+};
+/**
+ * Classify api.report() messages as informational vs actionable.
+ * Informational messages (stats, "modified", "Found N files") go to a separate section.
+ */
+function isInformational(msg) {
+    return (/^Registry: \d+/.test(msg) ||
+        /^Found \d+ consumer files/.test(msg) ||
+        /: modified$/.test(msg) ||
+        /^Done\. \d+ file/.test(msg) ||
+        /added .* to compilerOptions/.test(msg) ||
+        /standard boilerplate — deleted/.test(msg));
+}
+/** Extract file path from a report message if it starts with one */
+function extractFilePath(msg, cwd) {
+    // Matches absolute paths or src/-relative paths at the start
+    const absMatch = msg.match(/^(\/[^\s:]+)/);
+    if (absMatch)
+        return relative(cwd, absMatch[1]);
+    const relMatch = msg.match(/^(src\/[^\s:]+)/);
+    if (relMatch)
+        return relMatch[1];
+    return null;
+}
+export function generateMigrationReport(cwd, currentVersion, targetVersion, allReports, depChanges, sourceFiles) {
+    const lines = [];
+    const date = new Date().toISOString().split("T")[0];
+    lines.push(`# Migration Report: ${currentVersion} → ${targetVersion}`);
+    lines.push(`Generated: ${date}\n`);
+    // --- Automated changes ---
+    const modified = allReports.filter((r) => r.filesModified.length > 0);
+    const totalModified = allReports.reduce((sum, r) => sum + r.filesModified.length, 0);
+    lines.push(`## Automated Changes (${totalModified} files)\n`);
+    if (modified.length > 0) {
+        for (const r of modified) {
+            lines.push(`- ✅ **${r.name}** — ${r.filesModified.length} file(s)`);
+        }
+    }
+    else {
+        lines.push("_No automated changes applied._");
+    }
+    // --- Manual migration required (structured by topic) ---
+    // Group actionable messages by transform name
+    const actionableByTransform = new Map();
+    const informational = [];
+    for (const r of allReports) {
+        for (const msg of r.reports) {
+            if (isInformational(msg)) {
+                informational.push(msg);
+                continue;
+            }
+            if (!actionableByTransform.has(r.name))
+                actionableByTransform.set(r.name, []);
+            actionableByTransform.get(r.name).push(msg);
+        }
+    }
+    if (actionableByTransform.size > 0) {
+        lines.push(`\n## Manual Migration Required\n`);
+        for (const [transformName, messages] of actionableByTransform) {
+            const topic = MANUAL_TOPICS[transformName];
+            if (topic) {
+                // Structured topic with description and example
+                lines.push(`### ${topic.title}\n`);
+                lines.push(topic.description + "\n");
+                // List affected files
+                const files = new Set();
+                for (const msg of messages) {
+                    const fp = extractFilePath(msg, cwd);
+                    if (fp)
+                        files.add(fp);
+                }
+                if (files.size > 0) {
+                    lines.push("**Affected files:**");
+                    for (const f of files) {
+                        lines.push(`- \`${f}\``);
+                    }
+                    lines.push("");
+                }
+                // Before/after example
+                lines.push(topic.example + "\n");
+                if (topic.guide) {
+                    lines.push(`> See: [${topic.guide}](${topic.guide})\n`);
+                }
+            }
+            else {
+                // Unknown topic — fallback to raw messages
+                lines.push(`### ${transformName}\n`);
+                for (const msg of messages) {
+                    lines.push(`- ${msg}`);
+                }
+                lines.push("");
+            }
+        }
+    }
+    // --- Rolled back ---
+    const rolledBack = allReports.flatMap((r) => r.filesRolledBack.map((f) => ({ transform: r.name, ...f })));
+    if (rolledBack.length > 0) {
+        lines.push(`\n## Rolled Back (parse errors)\n`);
+        for (const item of rolledBack) {
+            lines.push(`- ⟲ **${item.transform}** — \`${item.path}\`: ${item.error}`);
+        }
+    }
+    // --- Dependencies updated ---
+    if (depChanges.length > 0) {
+        lines.push(`## Dependencies Updated\n`);
+        for (const c of depChanges) {
+            lines.push(`- ${c}`);
+        }
+    }
+    // --- Not covered by migrator ---
+    const allSource = sourceFiles
+        .map((f) => {
+        try {
+            return readFileSync(f, "utf-8");
+        }
+        catch {
+            return "";
+        }
+    })
+        .join("\n");
+    const relevant = UNCOVERED_GUIDES.filter((g) => new RegExp(g.grep).test(allSource));
+    if (relevant.length > 0) {
+        lines.push(`\n## Not Covered by Migrator\n`);
+        lines.push("_These migration guides may be relevant — check manually:_\n");
+        for (const g of relevant) {
+            lines.push(`- **${g.guide}** — ${g.description}`);
+            lines.push(`  Check: \`grep -rn "${g.grep}" src/\``);
+        }
+    }
+    // --- Informational log ---
+    if (informational.length > 0) {
+        lines.push(`\n<details>\n<summary>Transform Log (${informational.length} entries)</summary>\n`);
+        for (const msg of informational) {
+            lines.push(`- ${msg}`);
+        }
+        lines.push(`\n</details>`);
+    }
+    writeFileAtomic.sync(join(cwd, "MIGRATION_REPORT.md"), lines.join("\n") + "\n");
+}
+//# sourceMappingURL=report-generator.js.map

package/dist/report-generator.js.map

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

package/dist/runner.d.ts

@@ -1,10 +1,16 @@
+import type { VersionedTransform } from "./transforms/types.js";
 export interface RunOptions {
     cwd: string;
     to?: string;
     transform?: string;
     dryRun: boolean;
     list: boolean;
+    noReport?: boolean;
     updateDeps?: boolean;
     exclude?: string[];
 }
 export declare function run(options: RunOptions): Promise<void>;
+/**
+ * Kahn's algorithm: topological sort with stable ordering for unrelated nodes.
+ */
+export declare function topologicalSort(transforms: VersionedTransform[]): VersionedTransform[];