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

package/dist/report-generator.js

@@ -0,0 +1,311 @@
+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.canSave, form.isModified, form.setBaseline(), form.markReady(), form.revert()
+// 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",
+    },
+    "use-assets-migration": {
+        title: "Assets API Migration (useAssets → useAssetsManager)",
+        description: "`useAssets()` and legacy `AssetsHandler` patterns require migration to `useAssetsManager()`. " +
+            "The transform auto-renames `ICommonAsset` → `AssetLike`, but handler wiring/openBlade options often need manual updates.",
+        example: `\`\`\`ts
+// OLD:
+const { upload, remove, edit } = useAssets(imagesRef, uploadPath);
+
+// NEW:
+const assetsManager = useAssetsManager(imagesRef, {
+  uploadPath: () => uploadPath.value,
+  confirmRemove: () => showConfirmation(t("DELETE_CONFIRMATION")),
+});
+
+// For AssetsManager blade:
+openBlade({
+  name: "AssetsManager",
+  options: {
+    manager: markRaw(assetsManager),
+  },
+});
+\`\`\``,
+        guide: "migration/32-use-assets-manager.md",
+    },
+    "manual-migration-audit": {
+        title: "Manual Migration Audit Findings",
+        description: "The audit found patterns that are not safely auto-rewritable (e.g., `useExternalWidgets`, `moment`, `useFunctions`, direct `closeBlade()`). " +
+            "These require targeted manual refactors before final type-check/build.",
+        example: `\`\`\`ts
+// useFunctions() removed:
+// OLD:
+const { debounce } = useFunctions();
+const debounced = debounce(search, 300);
+
+// NEW:
+import { useDebounceFn } from "@vueuse/core";
+const debounced = useDebounceFn(search, 300);
+\`\`\``,
+        guide: "migration/03-moment-to-datefns.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[];