@vc-shell/migrate 2.0.0-alpha.22 → 2.0.0-alpha.24

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+# [2.0.0-alpha.24](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.23...v2.0.0-alpha.24) (2026-03-25)
+
+
+### Documentation
+
+* **assets-manager:** document blade options breaking change and enhance codemod ([69cc786](https://github.com/VirtoCommerce/vc-shell/commit/69cc7865a5678a093d972e6e39f955d722fcc133))
+
+
+### Features
+
+* **api-client, migrate:** default to Interface for new API clients, add nswag class-to-interface migration ([569a1f7](https://github.com/VirtoCommerce/vc-shell/commit/569a1f79532d5ca2e1a9968e3b249b3d3ffeed71))
+* **codemod:** add use-assets-migration transform ([57022ec](https://github.com/VirtoCommerce/vc-shell/commit/57022ec18d7d3f85e207377316222e32ad142520))
+* **codemod:** register use-assets-migration in transform registry ([83fb018](https://github.com/VirtoCommerce/vc-shell/commit/83fb018a7afbfc924d21e595c312fb536d3d40b5))
+* **codemod:** smart diagnostic for useAssets() migration patterns ([479defe](https://github.com/VirtoCommerce/vc-shell/commit/479defe6c57d6aa335c683e6aeec0f4941158749))
+* **migrate:** add project-scope orchestrator and registry entry for nswag-class-to-interface ([7a8dcd6](https://github.com/VirtoCommerce/vc-shell/commit/7a8dcd66e65b427c9e94bc40aa1a9fbf4a6062f7))
+* **migrate:** add Rules A/B — object literal and variable argument transforms ([0856d45](https://github.com/VirtoCommerce/vc-shell/commit/0856d457a7e3d6a1f9d05d392edea1f34578059b))
+* **migrate:** add Rules D/E — IPrefix rename and import deduplication ([e988d87](https://github.com/VirtoCommerce/vc-shell/commit/e988d87733e023fbc7abbf460cf6b2e174e5edb3))
+* **migrate:** scaffold nswag-class-to-interface core transform with Rule C ([2579e5b](https://github.com/VirtoCommerce/vc-shell/commit/2579e5bfe3840cafd8562ff466e8b58e47794524))
+
+
+### BREAKING CHANGES
+
+* **assets-manager:** notice
+- use-assets-migration codemod: detect openBlade("AssetsManager") with
+  old handler options and missing markRaw()
+# [2.0.0-alpha.23](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.22...v2.0.0-alpha.23) (2026-03-23)
+
+**Note:** Version bump only for package @vc-shell/migrate
+
 # [2.0.0-alpha.22](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.21...v2.0.0-alpha.22) (2026-03-23)
 
 **Note:** Version bump only for package @vc-shell/migrate

package/dist/transforms/nswag-class-to-interface-core.d.ts

@@ -0,0 +1,24 @@
+import type { API, FileInfo, Options } from "jscodeshift";
+import type { Transform } from "./types.js";
+export interface NswagCoreOptions {
+    dtoClassNames: Set<string>;
+    interfaceToClass: Map<string, string>;
+    packageName?: string;
+}
+/**
+ * Returns true if the import source looks like an api_client import.
+ * Matches if source contains "api_client" or starts with the given packageName.
+ */
+export declare function isApiClientImport(source: string, packageName?: string): boolean;
+/**
+ * Collects all imported names from ImportDeclarations that match api_client sources.
+ */
+export declare function collectApiClientImportedNames(root: ReturnType<API["jscodeshift"]>, j: API["jscodeshift"], packageName?: string): Set<string>;
+/**
+ * Core AST transform for nswag-class-to-interface migration.
+ * Rule C: Replace `new DtoClass()` (no args) with `{} as DtoClass`.
+ */
+export declare function coreTransform(fileInfo: FileInfo, api: API, options: Options & NswagCoreOptions): string | null;
+declare const _default: Transform;
+export default _default;
+export declare const parser = "tsx";

package/dist/transforms/nswag-class-to-interface-core.js

@@ -0,0 +1,224 @@
+/**
+ * Returns true if the import source looks like an api_client import.
+ * Matches if source contains "api_client" or starts with the given packageName.
+ */
+export function isApiClientImport(source, packageName) {
+    if (source.includes("api_client"))
+        return true;
+    if (packageName && source.startsWith(packageName))
+        return true;
+    return false;
+}
+/**
+ * Collects all imported names from ImportDeclarations that match api_client sources.
+ */
+export function collectApiClientImportedNames(root, j, packageName) {
+    const names = new Set();
+    root.find(j.ImportDeclaration).forEach((path) => {
+        const source = path.node.source.value;
+        if (typeof source === "string" && isApiClientImport(source, packageName)) {
+            for (const specifier of path.node.specifiers ?? []) {
+                if (specifier.type === "ImportSpecifier" && specifier.local) {
+                    names.add(specifier.local.name);
+                }
+                else if (specifier.type === "ImportDefaultSpecifier" && specifier.local) {
+                    names.add(specifier.local.name);
+                }
+            }
+        }
+    });
+    return names;
+}
+/**
+ * Core AST transform for nswag-class-to-interface migration.
+ * Rule C: Replace `new DtoClass()` (no args) with `{} as DtoClass`.
+ */
+export function coreTransform(fileInfo, api, options) {
+    const j = api.jscodeshift;
+    const root = j(fileInfo.source);
+    const { dtoClassNames, interfaceToClass, packageName } = options;
+    // Collect names actually imported from api_client in this file
+    const importedNames = collectApiClientImportedNames(root, j, packageName);
+    if (importedNames.size === 0)
+        return null;
+    // Effective DTOs: intersection of dtoClassNames and actually-imported names
+    const effectiveDtos = new Set();
+    if (dtoClassNames) {
+        for (const name of importedNames) {
+            if (dtoClassNames.has(name)) {
+                effectiveDtos.add(name);
+            }
+        }
+    }
+    // Effective renames: intersection of interfaceToClass keys and actually-imported names
+    const effectiveRenames = new Map();
+    if (interfaceToClass) {
+        for (const [iName, className] of interfaceToClass) {
+            if (importedNames.has(iName)) {
+                effectiveRenames.set(iName, className);
+            }
+        }
+    }
+    if (effectiveDtos.size === 0 && effectiveRenames.size === 0)
+        return null;
+    let changed = false;
+    // Rule F: .fromJS() / .toJSON() diagnostic
+    root
+        .find(j.CallExpression, {
+        callee: { type: "MemberExpression", property: { type: "Identifier" } },
+    })
+        .forEach((path) => {
+        const prop = path.node.callee.property.name;
+        if (prop === "fromJS" || prop === "toJSON") {
+            api.report(`${fileInfo.path}: .${prop}() called — this method does not exist on interfaces. Manual migration required.`);
+        }
+    });
+    // Rule F: Image DOM conflict warning
+    if (importedNames.has("Image") && effectiveDtos.has("Image")) {
+        api.report(`${fileInfo.path}: 'Image' imported from api_client conflicts with DOM global 'Image'. Consider: import { type Image } or import { Image as ApiImage }.`);
+    }
+    // Rule G: Clone-then-mutate detection — must run before NewExpression handler
+    const excludedVarNames = new Set();
+    root.find(j.VariableDeclarator).forEach((path) => {
+        const init = path.node.init;
+        if (!init || init.type !== "NewExpression" || init.callee.type !== "Identifier")
+            return;
+        if (!effectiveDtos.has(init.callee.name))
+            return;
+        if (path.node.id.type !== "Identifier")
+            return;
+        const varName = path.node.id.name;
+        // Check if parent is VariableDeclaration, and its parent has a body array
+        const declPath = path.parent;
+        const blockPath = declPath.parent;
+        if (!blockPath?.node?.body)
+            return;
+        const stmts = blockPath.node.body;
+        const declIdx = stmts.indexOf(declPath.node);
+        if (declIdx === -1)
+            return;
+        // Look at subsequent statements for x.prop = ...
+        for (let i = declIdx + 1; i < stmts.length && i <= declIdx + 10; i++) {
+            const stmt = stmts[i];
+            if (stmt.type === "ExpressionStatement" &&
+                stmt.expression.type === "AssignmentExpression" &&
+                stmt.expression.left.type === "MemberExpression" &&
+                stmt.expression.left.object.type === "Identifier" &&
+                stmt.expression.left.object.name === varName) {
+                excludedVarNames.add(varName);
+                api.report(`${fileInfo.path}: Clone-then-mutate pattern detected for ${init.callee.name}. Manual migration required.`);
+                break;
+            }
+            else {
+                break; // Stop at first non-mutation statement
+            }
+        }
+    });
+    // Find all NewExpression where callee is an Identifier in effectiveDtos
+    root
+        .find(j.NewExpression, {
+        callee: { type: "Identifier" },
+    })
+        .forEach((path) => {
+        const callee = path.node.callee;
+        if (callee.type !== "Identifier")
+            return;
+        const className = callee.name;
+        if (!effectiveDtos.has(className))
+            return;
+        // Rule G: Skip if this new expression is the init of a clone-then-mutate variable
+        const parentDeclarator = path.parent;
+        if (parentDeclarator.node.type === "VariableDeclarator" &&
+            parentDeclarator.node.id.type === "Identifier" &&
+            excludedVarNames.has(parentDeclarator.node.id.name)) {
+            return; // Skip — Rule G diagnostic emitted
+        }
+        const args = path.node.arguments;
+        let replacement;
+        if (args.length === 0) {
+            // Rule C: no args → `{} as ClassName`
+            replacement = j.tsAsExpression(j.objectExpression([]), j.tsTypeReference(j.identifier(className)));
+        }
+        else {
+            const arg = args[0];
+            if ((arg.type === "Identifier" && arg.name === "undefined") ||
+                arg.type === "NullLiteral" ||
+                (arg.type === "Literal" && arg.value === null)) {
+                // null/undefined literal → Rule C (empty object)
+                replacement = j.tsAsExpression(j.objectExpression([]), j.tsTypeReference(j.identifier(className)));
+            }
+            else if (arg.type === "ObjectExpression") {
+                // Rule A: new Dto({...}) → {...} as Dto
+                replacement = j.tsAsExpression(arg, j.tsTypeReference(j.identifier(className)));
+            }
+            else {
+                // Rule B: new Dto(variable) → { ...variable } as Dto
+                replacement = j.tsAsExpression(j.objectExpression([j.spreadElement(arg)]), j.tsTypeReference(j.identifier(className)));
+            }
+        }
+        // Check parent for TSAsExpression — collapse double-cast
+        const parent = path.parent;
+        if (parent && parent.node.type === "TSAsExpression") {
+            // Parent is already `expr as SomeType`, replace with `{obj} as SomeType` using parent's type
+            parent.replace(j.tsAsExpression(replacement.expression, parent.node.typeAnnotation));
+        }
+        else {
+            path.replace(replacement);
+        }
+        changed = true;
+    });
+    // Rule D/E: Rename IPrefix → ClassName in imports and type references
+    // Collect renames that were applied so we can do text replacement for type positions
+    // (jscodeshift doesn't traverse into TSTypeParameterInstantiation on CallExpressions)
+    const appliedRenames = new Map();
+    if (effectiveRenames.size > 0) {
+        root
+            .find(j.ImportDeclaration)
+            .filter((path) => {
+            const source = path.node.source.value;
+            return typeof source === "string" && isApiClientImport(source, packageName);
+        })
+            .forEach((importPath) => {
+            const specifiers = importPath.node.specifiers ?? [];
+            const toRemove = [];
+            specifiers.forEach((spec, idx) => {
+                if (spec.type !== "ImportSpecifier" || spec.imported.type !== "Identifier")
+                    return;
+                const importedName = spec.imported.name;
+                const targetName = effectiveRenames.get(importedName);
+                if (!targetName)
+                    return;
+                // Rule E: Check if targetName already imported in same declaration
+                const alreadyImported = specifiers.some((s) => s.type === "ImportSpecifier" && s.imported.type === "Identifier" && s.imported.name === targetName);
+                if (alreadyImported) {
+                    toRemove.push(idx); // Remove duplicate IPrefix specifier
+                }
+                else {
+                    // Rule D: Rename the specifier
+                    spec.imported = j.identifier(targetName);
+                    if (spec.local && spec.local.name === importedName) {
+                        spec.local = j.identifier(targetName);
+                    }
+                }
+                appliedRenames.set(importedName, targetName);
+                changed = true;
+            });
+            // Remove deduplicated specifiers (reverse to preserve indices)
+            for (const idx of toRemove.reverse()) {
+                specifiers.splice(idx, 1);
+            }
+        });
+    }
+    if (!changed)
+        return null;
+    // Generate source from AST, then apply text-based renames for type references
+    // that jscodeshift cannot traverse (e.g. TSTypeParameterInstantiation in CallExpression)
+    let output = root.toSource();
+    for (const [oldName, newName] of appliedRenames) {
+        output = output.replace(new RegExp(`\\b${oldName}\\b`, "g"), newName);
+    }
+    return output;
+}
+export default coreTransform;
+export const parser = "tsx";
+//# sourceMappingURL=nswag-class-to-interface-core.js.map

package/dist/transforms/nswag-class-to-interface-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nswag-class-to-interface-core.js","sourceRoot":"","sources":["../../src/transforms/nswag-class-to-interface-core.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,WAAoB;IACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAoC,EACpC,CAAqB,EACrB,WAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QACtC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;YACzE,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;gBACnD,IAAI,SAAS,CAAC,IAAI,KAAK,iBAAiB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;oBAC5D,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;gBAC5C,CAAC;qBAAM,IAAI,SAAS,CAAC,IAAI,KAAK,wBAAwB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;oBAC1E,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,GAAQ,EAAE,OAAmC;IAC7F,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEjE,+DAA+D;IAC/D,MAAM,aAAa,GAAG,6BAA6B,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IAC1E,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,4EAA4E;IAC5E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,uFAAuF;IACvF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,gBAAgB,EAAE,CAAC;YAClD,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,2CAA2C;IAC3C,IAAI;SACD,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE;QACtB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE;KACvE,CAAC;SACD,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,IAAI,GAAI,IAAI,CAAC,IAAI,CAAC,MAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3C,GAAG,CAAC,MAAM,CACR,GAAG,QAAQ,CAAC,IAAI,MAAM,IAAI,kFAAkF,CAC7G,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,qCAAqC;IACrC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,MAAM,CACR,GAAG,QAAQ,CAAC,IAAI,wIAAwI,CACzJ,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QACxF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO;QACjD,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAClC,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI;YAAE,OAAO;QAEnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,OAAO;QAE3B,iDAAiD;QACjD,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACrE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IACE,IAAI,CAAC,IAAI,KAAK,qBAAqB;gBACnC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,sBAAsB;gBAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB;gBAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;gBACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAC5C,CAAC;gBACD,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,GAAG,CAAC,MAAM,CACR,GAAG,QAAQ,CAAC,IAAI,4CAA4C,IAAI,CAAC,MAAM,CAAC,IAAI,8BAA8B,CAC3G,CAAC;gBACF,MAAM;YACR,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,uCAAuC;YAChD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wEAAwE;IACxE,IAAI;SACD,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE;QACrB,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;KAC/B,CAAC;SACD,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QACzC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QAE1C,kFAAkF;QAClF,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;QACrC,IACE,gBAAgB,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB;YACnD,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY;YAC9C,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EACnD,CAAC;YACD,OAAO,CAAC,mCAAmC;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAEjC,IAAI,WAAW,CAAC;QAEhB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,sCAAsC;YACtC,WAAW,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IACE,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAK,GAAW,CAAC,IAAI,KAAK,WAAW,CAAC;gBAChE,GAAG,CAAC,IAAI,KAAK,aAAa;gBAC1B,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAK,GAAW,CAAC,KAAK,KAAK,IAAI,CAAC,EACvD,CAAC;gBACD,iDAAiD;gBACjD,WAAW,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrG,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC3C,wCAAwC;gBACxC,WAAW,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACN,qDAAqD;gBACrD,WAAW,GAAG,CAAC,CAAC,cAAc,CAC5B,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAU,CAAC,CAAC,CAAC,EACjD,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAC3C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpD,6FAA6F;YAC7F,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,sEAAsE;IACtE,qFAAqF;IACrF,sFAAsF;IACtF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEjD,IAAI,gBAAgB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI;aACD,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;aACzB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACtC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9E,CAAC,CAAC;aACD,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YACtB,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;oBAAE,OAAO;gBACnF,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBACtD,IAAI,CAAC,UAAU;oBAAE,OAAO;gBAExB,mEAAmE;gBACnE,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CAC1G,CAAC;gBAEF,IAAI,eAAe,EAAE,CAAC;oBACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,qCAAqC;gBAC3D,CAAC;qBAAM,CAAC;oBACN,+BAA+B;oBAC/B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;oBACzC,IAAI,IAAI,CAAC,KAAK,IAAK,IAAI,CAAC,KAAa,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC5D,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;gBAED,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;gBAC7C,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC,CAAC,CAAC;YAEH,+DAA+D;YAC/D,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,8EAA8E;IAC9E,yFAAyF;IACzF,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,cAAc,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,eAAe,aAA0B,CAAC;AAC1C,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC"}

package/dist/transforms/nswag-class-to-interface.d.ts

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

package/dist/transforms/nswag-class-to-interface.js

@@ -0,0 +1,149 @@
+import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
+import { join, relative } from "node:path";
+import writeFileAtomic from "write-file-atomic";
+import jscodeshift from "jscodeshift";
+import { parse as parseSFC } from "@vue/compiler-sfc";
+import { coreTransform } from "./nswag-class-to-interface-core.js";
+/**
+ * Scans api_client/*.ts files to build a registry of DTO class names
+ * and interface-to-class mappings.
+ */
+function buildDtoRegistry(apiClientDir) {
+    const dtoClassNames = new Set();
+    const interfaceToClass = new Map();
+    let packageName;
+    // Try to read package.json for package name
+    const pkgJsonPath = join(apiClientDir, "package.json");
+    if (existsSync(pkgJsonPath)) {
+        try {
+            const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+            packageName = pkgJson.name;
+        }
+        catch {
+            // ignore
+        }
+    }
+    const regex = /export class (\w+) implements I(\w+)/g;
+    const entries = readdirSync(apiClientDir);
+    for (const entry of entries) {
+        if (!entry.endsWith(".ts"))
+            continue;
+        const filePath = join(apiClientDir, entry);
+        if (!statSync(filePath).isFile())
+            continue;
+        const content = readFileSync(filePath, "utf-8");
+        regex.lastIndex = 0;
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            const className = match[1];
+            // Skip client classes
+            if (className.endsWith("Client"))
+                continue;
+            dtoClassNames.add(className);
+            const interfaceName = `I${match[2]}`;
+            interfaceToClass.set(interfaceName, className);
+        }
+    }
+    return { dtoClassNames, interfaceToClass, packageName };
+}
+/**
+ * Recursively finds consumer .ts and .vue files, skipping api_client dir,
+ * node_modules, dist, and dotfiles.
+ */
+function findConsumerFiles(dir, apiClientDir) {
+    const results = [];
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        if (entry.startsWith("."))
+            continue;
+        if (entry === "node_modules" || entry === "dist")
+            continue;
+        const fullPath = join(dir, entry);
+        const resolvedApiClient = apiClientDir.endsWith("/") ? apiClientDir.slice(0, -1) : apiClientDir;
+        if (fullPath === resolvedApiClient)
+            continue;
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            results.push(...findConsumerFiles(fullPath, apiClientDir));
+        }
+        else if (stat.isFile()) {
+            if (entry.endsWith(".d.ts") || entry.endsWith(".generated.ts"))
+                continue;
+            if (entry.endsWith(".ts") || entry.endsWith(".vue")) {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results;
+}
+const transform = (_fileInfo, api, options) => {
+    const cwd = options.cwd ?? ".";
+    const dryRun = options.dryRun ?? false;
+    const j = jscodeshift.withParser("tsx");
+    const srcDir = join(cwd, "src");
+    const apiClientDir = join(srcDir, "api_client");
+    if (!existsSync(apiClientDir)) {
+        api.report(`No api_client directory found at ${apiClientDir}`);
+        return null;
+    }
+    const { dtoClassNames, interfaceToClass, packageName } = buildDtoRegistry(apiClientDir);
+    api.report(`Registry: ${dtoClassNames.size} DTO classes, ${interfaceToClass.size} interface→class mappings` +
+        (packageName ? `, package: ${packageName}` : ""));
+    if (dtoClassNames.size === 0) {
+        api.report("No DTO classes found in api_client — nothing to migrate.");
+        return null;
+    }
+    const consumerFiles = findConsumerFiles(srcDir, apiClientDir);
+    api.report(`Found ${consumerFiles.length} consumer files to scan.`);
+    let totalModified = 0;
+    for (const filePath of consumerFiles) {
+        try {
+            const source = readFileSync(filePath, "utf-8");
+            const relPath = relative(cwd, filePath);
+            let result = null;
+            const fileApi = {
+                jscodeshift: j,
+                j,
+                stats: () => { },
+                report: api.report,
+            };
+            const coreOptions = {
+                ...options,
+                dtoClassNames,
+                interfaceToClass,
+                packageName,
+            };
+            if (filePath.endsWith(".vue")) {
+                const { descriptor } = parseSFC(source, { filename: filePath });
+                const scriptBlock = descriptor.scriptSetup ?? descriptor.script;
+                if (!scriptBlock)
+                    continue;
+                const scriptResult = coreTransform({ path: relPath, source: scriptBlock.content }, fileApi, coreOptions);
+                if (scriptResult !== null) {
+                    const start = scriptBlock.loc.start.offset;
+                    const end = scriptBlock.loc.end.offset;
+                    result = source.substring(0, start) + scriptResult + source.substring(end);
+                }
+            }
+            else {
+                result = coreTransform({ path: relPath, source }, fileApi, coreOptions);
+            }
+            if (result !== null) {
+                if (!dryRun) {
+                    writeFileAtomic.sync(filePath, result);
+                }
+                api.report(`${relPath}: modified`);
+                totalModified++;
+            }
+        }
+        catch (err) {
+            const relPath = relative(cwd, filePath);
+            api.report(`${relPath}: ERROR — ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    api.report(`Done. ${totalModified} file(s) modified out of ${consumerFiles.length} scanned.`);
+    return null;
+};
+export default transform;
+export const parser = "tsx";
+//# sourceMappingURL=nswag-class-to-interface.js.map

package/dist/transforms/nswag-class-to-interface.js.map

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

package/dist/transforms/registry.js

@@ -133,6 +133,20 @@ export const transforms = [
         diagnosticOnly: true,
         transformPath: t("manual-migration-audit"),
     },
+    {
+        name: "nswag-class-to-interface",
+        description: "Migrate consumer code from NSwag class-based to interface-based DTOs",
+        introducedIn: "2.0.0-alpha.24",
+        scope: "project",
+        transformPath: t("nswag-class-to-interface"),
+    },
+    {
+        name: "use-assets-migration",
+        description: "ICommonAsset → AssetLike + detect useAssets() for manual migration to useAssetsManager()",
+        introducedIn: "2.0.0-alpha.24",
+        migrationGuideSection: "Guide 32",
+        transformPath: t("use-assets-migration"),
+    },
 ];
 export function selectTransforms(currentVersion, targetVersion) {
     const current = semver.parse(currentVersion);

package/dist/transforms/registry.js.map

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

package/dist/transforms/use-assets-migration.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/use-assets-migration.js

@@ -0,0 +1,171 @@
+import { wrapForSFC } from "../utils/vue-sfc-wrapper.js";
+const RENAME_MAP = {
+    ICommonAsset: "AssetLike",
+};
+/**
+ * Detect which useAssets() usage pattern is present and provide specific guidance.
+ *
+ * Known patterns:
+ * 1. "handler-object" — destructure useAssets() + build assetsHandler/defaultImageHandlers object
+ * 2. "single-image"   — useAssets() for a single image (iconUrl, logo, photo), often with computed get/set
+ * 3. "injectable"     — Props accept custom imageHandlers with fallback to default
+ * 4. "composable"     — useAssets() inside a composable (not a .vue file)
+ */
+function detectPattern(source, filePath) {
+    const isVue = filePath.endsWith(".vue");
+    const hasHandlerObject = /(?:assetsHandler|imageHandler|defaultImageHandler)\s*[=:]/.test(source);
+    const hasInjectableProps = /imageHandlers\??\s*[:{]/.test(source) || /props\.imageHandlers/.test(source);
+    const hasSingleImagePattern = /(?:iconUrl|logo|photo|avatar)\s*[=:]/.test(source) && !/\.images\s*[=]/.test(source);
+    if (hasInjectableProps)
+        return "injectable";
+    if (hasSingleImagePattern && !hasHandlerObject)
+        return "single-image";
+    if (hasHandlerObject)
+        return "handler-object";
+    if (!isVue)
+        return "composable";
+    return "handler-object"; // default
+}
+function extractUploadPath(source) {
+    // Match patterns like: upload(files, `some/path/${id}`) or upload(files, "some/path")
+    const match = source.match(/(?:upload|uploadImage)\s*\([^,]+,\s*(`[^`]+`|"[^"]+"|'[^']+')/);
+    return match ? match[1] : null;
+}
+function extractTargetRef(source) {
+    // Match patterns like: offer.value.images = [..., ...uploaded] or item.value.productData.images =
+    const match = source.match(/(\w+\.value(?:\.\w+)*\.(?:images|image|photo|iconUrl|logo))\s*=/);
+    return match ? match[1] : null;
+}
+function hasConfirmation(source) {
+    return /showConfirmation/.test(source) && /remove|delete/i.test(source);
+}
+function formatDiagnostic(filePath, pattern, uploadPath, targetRef, hasConfirm) {
+    const lines = [];
+    lines.push(`  ⚠️  ${filePath}:`);
+    switch (pattern) {
+        case "handler-object":
+            lines.push(`    Pattern: useAssets() + handler object (upload/remove/edit)`);
+            if (targetRef)
+                lines.push(`    Target ref: ${targetRef}`);
+            if (uploadPath)
+                lines.push(`    Upload path: ${uploadPath}`);
+            if (hasConfirm)
+                lines.push(`    Has confirmation: yes`);
+            lines.push(`    → Replace with: useAssetsManager(ref, { uploadPath: () => ..., ${hasConfirm ? "confirmRemove: () => showConfirmation(...)" : ""} })`);
+            lines.push(`    → See migration guide #32, example 1`);
+            break;
+        case "single-image":
+            lines.push(`    Pattern: useAssets() for single image (photo/logo/icon)`);
+            if (targetRef)
+                lines.push(`    Target ref: ${targetRef}`);
+            if (uploadPath)
+                lines.push(`    Upload path: ${uploadPath}`);
+            lines.push(`    → Wrap single value in computed array ref, then use useAssetsManager()`);
+            lines.push(`    → See migration guide #32, example 2`);
+            break;
+        case "injectable":
+            lines.push(`    Pattern: useAssets() + injectable Props.imageHandlers with fallback`);
+            if (targetRef)
+                lines.push(`    Target ref: ${targetRef}`);
+            lines.push(`    → Complex: parent can override handlers. Create useAssetsManager() for defaults,`);
+            lines.push(`      accept optional manager override in Props instead of raw handler functions.`);
+            lines.push(`    → See migration guide #32, example 4`);
+            break;
+        case "composable":
+            lines.push(`    Pattern: useAssets() inside a composable function`);
+            if (targetRef)
+                lines.push(`    Target ref: ${targetRef}`);
+            if (uploadPath)
+                lines.push(`    Upload path: ${uploadPath}`);
+            lines.push(`    → Replace with useAssetsManager(ref, options) inside the composable`);
+            lines.push(`    → Return the manager instance instead of separate upload/remove functions`);
+            lines.push(`    → See migration guide #32, example 3`);
+            break;
+    }
+    return lines.join("\n");
+}
+function coreTransform(fileInfo, api, _options) {
+    const j = api.jscodeshift;
+    const root = j(fileInfo.source);
+    const frameworkImports = root.find(j.ImportDeclaration, {
+        source: { value: "@vc-shell/framework" },
+    });
+    if (frameworkImports.size() === 0)
+        return null;
+    // --- Automatic: rename ICommonAsset → AssetLike ---
+    const renames = [];
+    frameworkImports.find(j.ImportSpecifier).forEach((path) => {
+        const name = path.node.imported.type === "Identifier" ? path.node.imported.name : "";
+        if (RENAME_MAP[name]) {
+            renames.push({ old: name, new: RENAME_MAP[name] });
+        }
+    });
+    if (renames.length > 0) {
+        for (const r of renames) {
+            root.find(j.Identifier, { name: r.old }).forEach((path) => {
+                path.node.name = r.new;
+            });
+        }
+    }
+    // --- Smart diagnostic: detect useAssets() pattern and provide specific guidance ---
+    const hasUseAssets = frameworkImports
+        .find(j.ImportSpecifier)
+        .filter((path) => {
+        const name = path.node.imported.type === "Identifier" ? path.node.imported.name : "";
+        return name === "useAssets";
+    })
+        .size() > 0;
+    if (hasUseAssets) {
+        const source = fileInfo.source;
+        const pattern = detectPattern(source, fileInfo.path);
+        const uploadPath = extractUploadPath(source);
+        const targetRef = extractTargetRef(source);
+        const hasConfirm = hasConfirmation(source);
+        console.log(formatDiagnostic(fileInfo.path, pattern, uploadPath, targetRef, hasConfirm));
+    }
+    // --- Diagnostic: detect AssetsHandler type usage ---
+    frameworkImports.find(j.ImportSpecifier).forEach((path) => {
+        const name = path.node.imported.type === "Identifier" ? path.node.imported.name : "";
+        if (name === "AssetsHandler") {
+            console.log(`  ⚠️  ${fileInfo.path}: AssetsHandler<T> detected — replace with UseAssetsManagerReturn. See migration guide #32.`);
+        }
+    });
+    // --- Diagnostic: detect AssetsManager blade handler options ---
+    const handlerPatterns = ["assetsEditHandler", "assetsUploadHandler", "assetsRemoveHandler"];
+    const source = fileInfo.source;
+    for (const pattern of handlerPatterns) {
+        if (source.includes(pattern)) {
+            console.log(`  ⚠️  ${fileInfo.path}: AssetsManager handler options detected (${pattern}).`);
+            console.log(`    → Replace options.assets/assetsUploadHandler/assetsEditHandler/assetsRemoveHandler`);
+            console.log(`      with options.manager: markRaw(useAssetsManagerInstance). See migration guide #32, example 5.`);
+            break;
+        }
+    }
+    // --- Diagnostic: detect openBlade calls that open AssetsManager/AssetsDetails with old options ---
+    const bladeCallPattern = /name:\s*["']AssetsManager["']/;
+    if (bladeCallPattern.test(source)) {
+        const hasOldOptions = /assetsUploadHandler|assetsEditHandler|assetsRemoveHandler|loading:\s*\w+Loading/.test(source);
+        if (hasOldOptions) {
+            console.log(`  ⚠️  ${fileInfo.path}: openBlade("AssetsManager") uses old handler options.`);
+            console.log(`    → Replace assets/loading/assetsUploadHandler/assetsEditHandler/assetsRemoveHandler`);
+            console.log(`      with { manager: markRaw(useAssetsManagerInstance) }. See migration guide #32, example 5.`);
+        }
+        else if (!source.includes("markRaw") && /manager\s*:/.test(source)) {
+            console.log(`  ⚠️  ${fileInfo.path}: openBlade("AssetsManager") passes manager without markRaw().`);
+            console.log(`    → Wrap with markRaw() to prevent Vue reactive proxy unwrap. See migration guide #32.`);
+        }
+    }
+    const detailsCallPattern = /name:\s*["']AssetsDetails["']/;
+    if (detailsCallPattern.test(source)) {
+        if (/ICommonAsset/.test(source)) {
+            console.log(`  ⚠️  ${fileInfo.path}: openBlade("AssetsDetails") uses ICommonAsset type.`);
+            console.log(`    → Replace ICommonAsset with AssetLike. See migration guide #32, example 6.`);
+        }
+    }
+    if (renames.length === 0)
+        return null;
+    return root.toSource();
+}
+export default wrapForSFC(coreTransform);
+export const parser = "tsx";
+//# sourceMappingURL=use-assets-migration.js.map

package/dist/transforms/use-assets-migration.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vc-shell/migrate",
-  "version": "2.0.0-alpha.22",
+  "version": "2.0.0-alpha.24",
   "type": "module",
   "bin": "./dist/cli.js",
   "main": "./dist/cli.js",