@vc-shell/migrate 2.0.0-alpha.12

package/README.md

@@ -0,0 +1,359 @@
+# @vc-shell/migrate
+
+Automated migration tool for upgrading apps to the latest `@vc-shell/framework` version.
+
+Detects your current framework version, selects applicable code transforms, and rewrites your source code — preserving formatting for unchanged lines.
+
+> **Migrating from a version prior to 1.x?** This tool covers migrations from 1.x to 2.0. For older versions, upgrade to 1.x first, then use this tool.
+
+## Quick start
+
+```bash
+npx @vc-shell/migrate
+```
+
+That's it. The CLI will:
+
+1. Detect your current `@vc-shell/framework` version from `package.json`
+2. Select transforms needed for the upgrade path (e.g., 1.x → 2.0.0)
+3. Apply each transform to your `src/` files (`.ts` and `.vue`)
+4. Print a summary of modified files and any manual action items
+
+## Major changes in 2.0
+
+Before running the migration, review the key breaking changes:
+
+| Change | Impact | Automated? |
+|--------|--------|:----------:|
+| `createAppModule` → `defineAppModule` | All module entry points | Yes |
+| `useBladeNavigation` → `useBlade` | All blade composable usage | Yes |
+| `useNotifications` → `useBladeNotifications` | Notification composable | Yes |
+| Blade Props/Emits boilerplate removal | All blade components | Yes |
+| Import path splitting (ai-agent, extensions) | Imports of moved symbols | Yes |
+| Deprecated injection key renames (6 symbols) | Injection key references | Yes |
+| `useWidgets` → `useBladeWidgets` | Widget registration | Partial* |
+| Composable return type renames (20 types) | Type annotations | Yes |
+| VcBanner variant prop values | Template attributes | Yes |
+| VcSwitch `tooltip` → `hint` | Template attributes | Yes |
+| VcIcon `useContainer` removal | Template attributes | Yes |
+| Font Awesome → Material Symbols icons | Icon class names | Diagnostic |
+| SCSS `@import` → `@use` | Stylesheet imports | Diagnostic |
+| Menu `group`/`groupIcon` → `groupConfig` | Menu configuration | Diagnostic |
+| Manual `.d.ts` shims → `@vc-shell/framework/globals` | tsconfig.json | Yes |
+
+\* `useWidgets` is renamed automatically, but `registerWidget`/`unregisterWidget` calls require manual migration to the declarative `useBladeWidgets([...])` API.
+
+**Diagnostic** transforms report issues but do not modify code. Review the output and fix manually.
+
+> If any of these changes are blockers for your project, we recommend staying on your current version until you're ready for a full upgrade.
+
+## CLI options
+
+```bash
+npx @vc-shell/migrate [options]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--to <version>` | Target framework version | `2.0.0` |
+| `--transform <name>` | Run only a specific transform | all applicable |
+| `--dry-run` | Preview changes without writing files | `false` |
+| `--list` | List all available transforms and exit | |
+| `--cwd <path>` | Working directory (your app root) | `.` |
+
+### Examples
+
+```bash
+# Preview what would change (recommended first step)
+npx @vc-shell/migrate --dry-run
+
+# Migrate to a specific version
+npx @vc-shell/migrate --to 2.0.0-alpha.10
+
+# Run only one transform
+npx @vc-shell/migrate --transform blade-props-simplification --dry-run
+
+# List all transforms with descriptions and version ranges
+npx @vc-shell/migrate --list
+
+# Migrate a specific app in a monorepo
+npx @vc-shell/migrate --cwd apps/vendor-portal
+```
+
+## Recommended workflow
+
+1. **Commit your current work** — make sure your working tree is clean
+2. **Dry run first** — `npx @vc-shell/migrate --dry-run` to preview changes
+3. **Run the migration** — `npx @vc-shell/migrate`
+4. **Review the diff** — `git diff` to inspect all changes
+5. **Fix manual items** — address any warnings printed by diagnostic transforms
+6. **Run your tests** — verify everything works
+7. **Commit** — create a dedicated migration commit
+
+## How it works
+
+### Version-based transform selection
+
+Each transform has an `introducedIn` version — the framework version that introduced the breaking change. The CLI selects transforms where:
+
+- Your current version is **below** the breaking change
+- The target version **includes** the breaking change
+
+```
+Current: 2.0.0-alpha.8  →  Target: 2.0.0
+
+Skipped (already past):
+  define-app-module        (introduced in alpha.5)
+  use-blade-migration      (introduced in alpha.8)
+
+Applied:
+  notification-migration   (introduced in alpha.10)
+  rewrite-imports          (introduced in 2.0.0)
+  ... and 11 more
+```
+
+### Transform categories
+
+| Category | Behavior |
+|----------|----------|
+| **Script transforms** | Modify `<script>` blocks in `.vue` files and `.ts` files using jscodeshift AST manipulation |
+| **Template transforms** | Modify `<template>` blocks in `.vue` files using string-based pattern matching |
+| **Script + Template** | Both (e.g., `blade-props-simplification` removes props from script AND attributes from template) |
+| **Config transforms** | Modify project configuration files like `tsconfig.json` |
+| **Diagnostic** | Report issues via warnings but never modify files — manual action required |
+
+### Format preservation
+
+The tool uses [jscodeshift](https://github.com/facebook/jscodeshift) (built on [recast](https://github.com/benjamn/recast)) for AST transforms. This means:
+
+- **Unchanged lines are preserved exactly** — no reformatting of code you didn't touch
+- Only the specific identifiers, imports, and expressions being migrated are rewritten
+- Your indentation, quotes, trailing commas, and line breaks stay as they were
+
+### Error isolation
+
+Each file is processed independently with per-file error handling:
+
+- If a transform fails on one file, all other files continue processing
+- File writes use atomic operations (write to temp, then rename) — no corrupted files on crash
+- Project-scoped transforms (SCSS scan, tsconfig update) run once per project, not per file
+
+## Available transforms
+
+### `define-app-module` <sup>alpha.5</sup>
+
+Rewrites module entry points from positional arguments to named config object.
+
+```ts
+// Before
+export default createAppModule(pages, locales);
+
+// After
+export default defineAppModule({ pages, locales });
+
+// 3-arg variant (with notifications)
+// Before
+export default createAppModule(pages, locales, notificationTemplates);
+
+// After
+export default defineAppModule({
+  blades: pages,
+  locales: locales,
+  notificationTemplates: notificationTemplates,
+});
+```
+
+### `use-blade-migration` <sup>alpha.8</sup>
+
+Renames `useBladeNavigation()` → `useBlade()` and inverts `onBeforeClose` return values (old: `return false` = prevent close → new: `return true` = prevent close).
+
+```ts
+// Before
+const { openBlade, onBeforeClose } = useBladeNavigation();
+onBeforeClose(() => {
+  return false; // prevent close
+});
+
+// After
+const { openBlade, onBeforeClose } = useBlade();
+onBeforeClose(() => {
+  return !false; // prevent close (inverted)
+});
+```
+
+### `notification-migration` <sup>alpha.10</sup>
+
+Renames `useNotifications` → `useBladeNotifications` in imports and all usages.
+
+### `blade-props-simplification` <sup>2.0.0</sup>
+
+Removes blade boilerplate from Vue components: `expanded`/`closable` props, `close:blade`/`expand:blade`/`collapse:blade`/`parent:call` emits, and corresponding template attributes on `<VcBlade>`. Adds `useBlade()` destructuring for `param`, `options`, `callParent`, `closeSelf`.
+
+```ts
+// Before
+interface Props {
+  expanded?: boolean;
+  closable?: boolean;
+  param?: string;
+  model?: string;
+}
+interface Emits {
+  (e: "parent:call", args: IParentCallArgs): void;
+  (e: "close:blade"): void;
+}
+const props = withDefaults(defineProps<Props>(), { expanded: true, closable: true });
+const emit = defineEmits<Emits>();
+emit("parent:call", { method: "refresh" });
+const id = props.param;
+
+// After
+interface Props {
+  model?: string;
+}
+const props = defineProps<Props>();
+const { callParent, param } = useBlade();
+callParent("refresh");
+const id = param.value;
+```
+
+### `rewrite-imports` <sup>2.0.0</sup>
+
+Moves symbols to sub-entry points: `aiAgentPlugin`, `useAiAgent`, etc. → `@vc-shell/framework/ai-agent`; `defineExtensionPoint`, `useExtensionPoint`, etc. → `@vc-shell/framework/extensions`.
+
+### `remove-deprecated-aliases` <sup>2.0.0</sup>
+
+Renames 6 deprecated injection key aliases:
+
+| Old | New |
+|-----|-----|
+| `navigationViewLocation` | `NavigationViewLocationKey` |
+| `BladeInstance` | `BladeInstanceKey` |
+| `NotificationTemplatesSymbol` | `NotificationTemplatesKey` |
+| `BLADE_BACK_BUTTON` | `BladeBackButtonKey` |
+| `TOOLBAR_SERVICE` | `ToolbarServiceKey` |
+| `EMBEDDED_MODE` | `EmbeddedModeKey` |
+
+### `widgets-migration` <sup>2.0.0</sup>
+
+Renames `useWidgets()` → `useBladeWidgets()`. Emits a warning if `registerWidget`/`unregisterWidget` calls are found — these need manual migration to the declarative `useBladeWidgets([...])` API.
+
+### `composable-return-types` <sup>2.0.0</sup>
+
+Renames 20 composable return type interfaces (e.g., `IUsePermissions` → `UsePermissionsReturn`, `IAppUserAPI` → `UseUserReturn`).
+
+### `banner-variants` <sup>2.0.0</sup>
+
+Updates VcBanner variant prop values: `"light-danger"` → `"danger"`, `"info-dark"` → `"info"`, `"primary"` → `"info"`.
+
+### `switch-tooltip-prop` <sup>2.0.0</sup>
+
+Renames `tooltip` → `hint` prop on `<VcSwitch>` (including `:tooltip` → `:hint`).
+
+### `icon-container-prop` <sup>2.0.0</sup>
+
+Removes the deprecated `useContainer` / `use-container` prop from `<VcIcon>`.
+
+### `shims-to-globals` <sup>2.0.0</sup>
+
+Replaces manual `shims-vue.d.ts` / `vue-i18n.d.ts` files with `@vc-shell/framework/globals` in `tsconfig.json` types. Standard boilerplate shim files are automatically deleted; customized ones trigger a warning.
+
+### `icon-audit` <sup>2.0.0</sup> <kbd>diagnostic</kbd>
+
+Scans for Font Awesome icon class names (`fas fa-check`, etc.) and reports them with suggested Material Symbols replacements. Does not modify files.
+
+### `scss-safe-use` <sup>2.0.0</sup> <kbd>diagnostic</kbd>
+
+Scans `.scss` files for `@import` statements and reports candidates for `@use`/`@forward` migration. Does not modify files.
+
+### `menu-group-config` <sup>2.0.0</sup> <kbd>diagnostic</kbd>
+
+Detects deprecated `group`, `groupIcon`, `inGroupPriority` menu properties and reports them for migration to `groupConfig: { id, title, icon, priority, permissions }`. Does not modify files.
+
+## Troubleshooting
+
+If something goes wrong after migration:
+
+1. **Check the diff** — `git diff` shows exactly what changed. The tool preserves formatting, so real changes are easy to spot.
+
+2. **Run TypeScript check** — `npx tsc --noEmit` catches type errors introduced by renames. Most should be caught by the transforms, but edge cases exist.
+
+3. **Re-run a single transform** — if one specific transform caused issues:
+   ```bash
+   git checkout -- .  # revert all changes
+   npx @vc-shell/migrate --transform define-app-module  # run just that one
+   ```
+
+4. **Check warnings** — the CLI prints `⚠` warnings for patterns that need manual review. Don't ignore these.
+
+5. **Manual fixes for partial automation:**
+   - `useWidgets` → `useBladeWidgets`: The rename is automatic, but converting `registerWidget`/`unregisterWidget` to declarative `useBladeWidgets([...])` config requires manual work. See MIGRATION_GUIDE.md section "Registering Widgets in Blades".
+   - `onBeforeClose` with multiple returns or non-inline callbacks: Prints a warning. Review the logic and invert return values manually.
+   - Custom `.d.ts` shims: If `shims-vue.d.ts` contains custom augmentations beyond the standard boilerplate, it won't be deleted — merge your custom types with the framework globals manually.
+
+6. **File an issue** — if a transform produces incorrect output, [open an issue](https://github.com/AnyOrg/vc-shell/issues) with the before/after code.
+
+## Architecture
+
+```
+@vc-shell/migrate
+├── src/
+│   ├── cli.ts                  # CLI entry point (commander)
+│   ├── runner.ts               # Orchestrator: detect → select → execute → report
+│   ├── version-detector.ts     # Reads framework version from package.json
+│   ├── transforms/
+│   │   ├── types.ts            # Transform/VersionedTransform interfaces
+│   │   ├── registry.ts         # Version-based transform registry
+│   │   ├── define-app-module.ts
+│   │   ├── use-blade-migration.ts
+│   │   ├── ... (15 transforms total)
+│   │   └── shims-to-globals.ts
+│   └── utils/
+│       ├── vue-sfc-wrapper.ts  # SFC handling: wrapForSFC, wrapForSFCTemplate, wrapForSFCBoth
+│       ├── template-transform.ts  # String-based template attribute manipulation
+│       ├── import-rewriter.ts  # Symbol → sub-entry-point mapping
+│       └── test-helpers.ts     # applyTransform, applyTransformWithReports, defineFixtureTest
+└── tests/                      # 90 tests across 18 test files
+```
+
+### Adding a new transform
+
+1. Create `src/transforms/my-transform.ts` following the jscodeshift signature:
+   ```ts
+   import type { API, FileInfo, Options } from "jscodeshift";
+   import { wrapForSFC } from "../utils/vue-sfc-wrapper.js";
+   import type { Transform } from "./types.js";
+
+   function coreTransform(fileInfo: FileInfo, api: API, options: Options): string | null {
+     const j = api.jscodeshift;
+     const root = j(fileInfo.source);
+     // ... find and replace patterns ...
+     return root.toSource(); // or null if no changes
+   }
+
+   export default wrapForSFC(coreTransform) as Transform;
+   export const parser = "tsx";
+   ```
+
+2. Register in `src/transforms/registry.ts`:
+   ```ts
+   {
+     name: "my-transform",
+     description: "What it does",
+     introducedIn: "2.1.0",
+     transformPath: t("my-transform"),
+   },
+   ```
+
+3. Add tests in `tests/transforms/my-transform/transform.test.ts`
+
+4. Run: `npx vitest run`
+
+### Tech stack
+
+- **[jscodeshift](https://github.com/facebook/jscodeshift)** — AST query/manipulation (jQuery-like API for JavaScript/TypeScript ASTs)
+- **[recast](https://github.com/benjamn/recast)** — Format-preserving parser/printer (transitive via jscodeshift)
+- **[@vue/compiler-sfc](https://github.com/vuejs/core)** — Vue Single File Component parser
+- **[write-file-atomic](https://github.com/npm/write-file-atomic)** — Crash-safe file writes
+- **[jsonc-parser](https://github.com/microsoft/node-jsonc-parser)** — JSON with comments parser (for tsconfig.json)
+- **[semver](https://github.com/npm/node-semver)** — Version range comparison
+- **[vitest](https://vitest.dev/)** — Test runner

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import { resolve } from "node:path";
+import { run } from "./runner.js";
+const program = new Command();
+program
+    .name("vc-shell-migrate")
+    .description("Migrate your code to the latest @vc-shell/framework version")
+    .version("1.0.0")
+    .option("--to <version>", "Target framework version (default: latest)")
+    .option("--transform <name>", "Run only a specific transform")
+    .option("--dry-run", "Preview changes without writing files", false)
+    .option("--list", "List available transforms", false)
+    .option("--cwd <path>", "Working directory", ".")
+    .option("--update-deps", "Also update dependency versions in package.json", false)
+    .action(async (options) => {
+    const cwd = resolve(options.cwd);
+    // Pre-flight: dirty working tree check
+    if (!options.dryRun && !options.list) {
+        try {
+            const { execFileSync } = await import("node:child_process");
+            const status = execFileSync("git", ["status", "--porcelain"], {
+                cwd,
+                encoding: "utf-8",
+            });
+            if (status.trim().length > 0) {
+                console.log(chalk.yellow("Warning: You have uncommitted changes. " +
+                    "We recommend committing or stashing before running migrations."));
+            }
+        }
+        catch {
+            // Not a git repo or git not available — skip check
+        }
+    }
+    await run({
+        cwd,
+        to: options.to,
+        transform: options.transform,
+        dryRun: options.dryRun,
+        list: options.list,
+    });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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,CACV,6DAA6D,CAC9D;KACA,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,CACL,eAAe,EACf,iDAAiD,EACjD,KAAK,CACN;KACA,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;KACnB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,8 @@
+export interface RunOptions {
+    cwd: string;
+    to?: string;
+    transform?: string;
+    dryRun: boolean;
+    list: boolean;
+}
+export declare function run(options: RunOptions): Promise<void>;

package/dist/runner.js

@@ -0,0 +1,154 @@
+import chalk from "chalk";
+import { resolve, join } from "node:path";
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import writeFileAtomic from "write-file-atomic";
+import jscodeshift from "jscodeshift";
+import { detectFrameworkVersion } from "./version-detector.js";
+import { selectTransforms, transforms } from "./transforms/registry.js";
+export async function run(options) {
+    if (options.list) {
+        listTransforms();
+        return;
+    }
+    const cwd = resolve(options.cwd);
+    const currentVersion = detectFrameworkVersion(cwd);
+    if (!currentVersion) {
+        console.log(chalk.red("Could not detect @vc-shell/framework version in " + cwd));
+        return;
+    }
+    const targetVersion = options.to ?? "2.0.0";
+    console.log(chalk.blue(`Migrating from ${currentVersion} → ${targetVersion}`));
+    let selected = selectTransforms(currentVersion, targetVersion);
+    if (options.transform) {
+        selected = selected.filter((t) => t.name === options.transform);
+        if (selected.length === 0) {
+            console.log(chalk.yellow(`Transform "${options.transform}" not found or not applicable for this version range.`));
+            return;
+        }
+    }
+    if (selected.length === 0) {
+        console.log(chalk.green("No transforms needed for this version range."));
+        return;
+    }
+    console.log(chalk.blue(`Running ${selected.length} transform(s)${options.dryRun ? " (dry run)" : ""}:`));
+    selected.forEach((t) => console.log(chalk.gray(`  - ${t.name}: ${t.description}`)));
+    // Glob source files for per-file transforms
+    const srcDir = join(cwd, "src");
+    const sourceFiles = findFiles(srcDir, [".ts", ".vue"]);
+    for (const t of selected) {
+        console.log(chalk.blue(`\nRunning: ${t.name}...`));
+        // Dynamic import of transform module
+        const mod = await import(t.transformPath);
+        const transform = mod.default;
+        const parser = mod.parser ?? "tsx";
+        const j = jscodeshift.withParser(parser);
+        const report = {
+            name: t.name,
+            filesModified: [],
+            filesSkipped: [],
+            filesErrored: [],
+            reports: [],
+        };
+        const api = {
+            jscodeshift: j,
+            j,
+            stats: () => { },
+            report: (msg) => report.reports.push(msg),
+        };
+        if (t.scope === "project") {
+            // Project-scoped transforms run once with cwd
+            try {
+                transform({ path: cwd, source: "" }, api, { cwd, dryRun: options.dryRun });
+            }
+            catch (err) {
+                report.filesErrored.push({
+                    path: cwd,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        else {
+            // Per-file transforms
+            for (const filePath of sourceFiles) {
+                try {
+                    const source = readFileSync(filePath, "utf-8");
+                    const result = transform({ path: filePath, source }, api, { cwd });
+                    if (result != null && result !== source) {
+                        if (!options.dryRun) {
+                            writeFileAtomic.sync(filePath, result);
+                        }
+                        report.filesModified.push(filePath);
+                    }
+                    else {
+                        report.filesSkipped.push(filePath);
+                    }
+                }
+                catch (err) {
+                    report.filesErrored.push({
+                        path: filePath,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        // Print report
+        if (report.filesModified.length > 0) {
+            console.log(chalk.green(`  Modified: ${report.filesModified.length} file(s)`));
+        }
+        if (report.reports.length > 0) {
+            report.reports.forEach((w) => console.log(chalk.yellow(`  ⚠ ${w}`)));
+        }
+        if (report.filesErrored.length > 0) {
+            report.filesErrored.forEach((e) => console.log(chalk.red(`  ✗ ${e.path}: ${e.error}`)));
+        }
+    }
+    if (options.dryRun) {
+        console.log(chalk.yellow("\nDry run complete. No files were modified."));
+    }
+    else {
+        console.log(chalk.green("\nAll transforms applied successfully."));
+    }
+}
+function findFiles(dir, extensions) {
+    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;
+        const full = join(dir, entry);
+        try {
+            const stat = statSync(full);
+            if (stat.isDirectory()) {
+                results.push(...findFiles(full, extensions));
+            }
+            else if (extensions.some((ext) => entry.endsWith(ext))) {
+                results.push(full);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return results;
+}
+function listTransforms() {
+    console.log(chalk.blue("Available transforms:\n"));
+    for (const t of transforms) {
+        const tag = t.diagnosticOnly ? chalk.gray(" [diagnostic]") : "";
+        const scopeTag = t.scope === "project" ? chalk.gray(" [project]") : "";
+        console.log(`  ${chalk.bold(t.name)}${tag}${scopeTag}`);
+        console.log(`    ${t.description}`);
+        console.log(`    Introduced in: ${t.introducedIn}`);
+        if (t.migrationGuideSection) {
+            console.log(`    Migration guide: ${t.migrationGuideSection}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/transforms/banner-variants.d.ts

@@ -0,0 +1,4 @@
+import type { Transform } from "./types.js";
+declare const _default: Transform;
+export default _default;
+export declare const parser = "tsx";

package/dist/transforms/banner-variants.js

@@ -0,0 +1,21 @@
+import { wrapForSFCTemplate } from "../utils/vue-sfc-wrapper.js";
+const VARIANT_MAP = {
+    "light-danger": "danger",
+    "info-dark": "info",
+    "primary": "info",
+};
+function templateTransform(template, _filePath) {
+    const tagRe = /(<(?:VcBanner|vc-banner)\b[^>]*?)(variant="(?:light-danger|info-dark|primary)")/gs;
+    const modified = template.replace(tagRe, (_match, before, variantAttr) => {
+        for (const [oldVariant, newVariant] of Object.entries(VARIANT_MAP)) {
+            if (variantAttr === `variant="${oldVariant}"`) {
+                return before + `variant="${newVariant}"`;
+            }
+        }
+        return before + variantAttr;
+    });
+    return { content: modified, changed: modified !== template };
+}
+export default wrapForSFCTemplate(templateTransform);
+export const parser = "tsx";
+//# sourceMappingURL=banner-variants.js.map

package/dist/transforms/banner-variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-variants.js","sourceRoot":"","sources":["../../src/transforms/banner-variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,MAAM,WAAW,GAA2B;IAC1C,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,MAAM;CAClB,CAAC;AAEF,SAAS,iBAAiB,CAAC,QAAgB,EAAE,SAAiB;IAC5D,MAAM,KAAK,GAAG,mFAAmF,CAAC;IAClG,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QACvE,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACnE,IAAI,WAAW,KAAK,YAAY,UAAU,GAAG,EAAE,CAAC;gBAC9C,OAAO,MAAM,GAAG,YAAY,UAAU,GAAG,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,GAAG,WAAW,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,eAAe,kBAAkB,CAAC,iBAAiB,CAAc,CAAC;AAClE,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC"}

package/dist/transforms/blade-props-simplification.d.ts

@@ -0,0 +1,4 @@
+import type { Transform } from "./types.js";
+declare const _default: Transform;
+export default _default;
+export declare const parser = "tsx";