migrate-barrel-imports 1.5.1 → 1.6.0

package/dist/index.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-import{Command as e}from"commander";import o,{readFileSync as s,writeFileSync as r}from"node:fs";import t from"node:path";import i from"@babel/generator";import{parse as n}from"@babel/parser";import l from"@babel/traverse";import{isVariableDeclaration as a,isIdentifier as c,isFunctionDeclaration as p,isTSEnumDeclaration as g,isTSInterfaceDeclaration as d,isTSTypeAliasDeclaration as u,isClassDeclaration as f,isExportSpecifier as m,isImportSpecifier as h,importDeclaration as $,stringLiteral as x,importSpecifier as S}from"@babel/types";import F from"fast-glob";import k from"micromatch";let w=i.default||i,y=l.default||l,b={sourceType:"module",plugins:["typescript","jsx","decorators-legacy","classProperties","classPrivateProperties","classPrivateMethods","exportDefaultFrom","exportNamespaceFrom","functionBind","functionSent","dynamicImport","nullishCoalescingOperator","optionalChaining","objectRestSpread","asyncGenerators","doExpressions","importMeta","logicalAssignment","moduleBlocks","moduleStringNames","numericSeparator","partialApplication","privateIn","throwExpressions","topLevelAwait"]};async function E(e){return JSON.parse(s(t.join(e,"package.json"),"utf-8"))}async function P({packagePath:e,ignoreSourceFiles:o=[],stats:r}){let i=[];console.log(`Scanning for TypeScript and JavaScript files in: ${e}`);let l=await F("**/*.{ts,tsx,js,jsx}",{cwd:e,ignore:["**/node_modules/**","**/dist/**","**/build/**"]});for(let h of(console.log(`Found ${l.length} files`),l)){let l=o.some(e=>k.isMatch(h,e));l&&(console.log(`File matches ignore pattern but will be preserved: ${h}`),r&&r.sourceFilesSkipped++);let $=t.join(e,h);console.log(`
-Processing file: ${h}`);let x=s($,"utf-8");try{let e=n(x,b);y(e,{ExportNamedDeclaration(e){if(console.log(`Found named export in ${h}`),e.node.source){let o=e.node.source.value;if(o.includes("node_modules")||!o.startsWith(".")){console.log(`Skipping re-export from external package: ${o}`);return}}if(e.node.declaration){var o;let s=(o=e.node.declaration)?a(o)?o.declarations.map(e=>c(e.id)?e.id.name:null).filter(e=>null!==e):p(o)&&o.id||g(o)||d(o)||u(o)||f(o)&&o.id?[o.id.name]:[]:[];s.length>0&&(console.log(`Named exports found: ${s.join(", ")}`),i.push({source:h,exports:s,isIgnored:l}))}let s=e.node.specifiers.map(e=>{if(m(e)){let o=e.exported;return c(o)?o.name:o.value}return null}).filter(e=>null!==e);s.length>0&&(console.log(`Named exports found: ${s.join(", ")}`),i.push({source:h,exports:s,isIgnored:l}))},ExportDefaultDeclaration(e){console.log(`Found default export in ${h}`);let o=e.node.declaration,s=c(o)?o.name:p(o)&&o.id?o.id.name:null;s?(console.log(`Default export name: ${s}`),i.push({source:h,exports:[s],isIgnored:l})):console.log("Default export is not an identifier or named function")}})}catch(e){console.error(`Error parsing ${h}:`,e)}}return console.log(`
-Total exports found: ${i.length}`),i}async function j({packageName:e,monorepoRoot:o}){try{let r=new Set,t=await F(["**/*.{ts,tsx,js,jsx}"],{cwd:o,absolute:!0,ignore:["**/node_modules/**","**/dist/**","**/build/**"],followSymbolicLinks:!1});for(let o of(console.log(`Found ${t.length} files to scan`),t))try{let t=s(o,"utf-8"),i=n(t,b);y(i,{ImportDeclaration(s){let t=s.node.source.value;(t===e||t.startsWith(`${e}/`))&&r.add(o)}})}catch(e){console.error(`Error processing file ${o}:`,e)}let i=Array.from(r);if(i.length>0)for(let o of(console.log(`Found total of ${i.length} files with imports from ${e}`),console.log("Files found:"),i))console.log(`  ${o}`);else console.log(`No files found importing from ${e}`);return i}catch(e){return console.error("Error finding imports:",e),[]}}async function T({filePath:e,packageName:o,exports:t,includeExtension:i=!0,warnings:l,stats:a}){console.log(`
-Processing file: ${e}`);let p=s(e,"utf-8");try{let s=n(p,b),a=!1,g=0,d=new Set;if(y(s,{ImportDeclaration(s){let r=s.node.source.value;if(!d.has(r)&&r===o){g++,console.log(`Found import from ${o}`);let n=s.node.specifiers,p=new Map,u=[],f=!1;for(let s of n)if(h(s)){let r=s.imported,n=c(r)?r.name:r.value,g=t.find(e=>e.exports.includes(n));if(g){if(console.log(`  Found export ${n} in ${g.source}`),g.isIgnored){console.log(`  Keeping original import for ignored file: ${g.source}`),u.push(s);continue}let e=i?`${o}/${g.source}`:`${o}/${g.source.replace(/\.(js|jsx|ts|tsx|mjs|cjs)$/,"")}`;p.has(e)||p.set(e,[]),p.get(e)?.push({local:s.local,imported:s.imported}),a=!0,f=!0}else{if(t.some(e=>e.source.includes("node_modules")||!e.source.startsWith("."))){let o=`Skipping re-export from external package: ${n} in "${e}"`;console.log(`  ${o}`),l&&l.push(o),u.push(s);continue}let o=`Could not find export ${n} in ${e}`;console.log(`  Warning: ${o}`),l&&l.push(o),u.push(s)}}else u.push(s);if(!f){console.log("  Keeping original import due to no direct exports to migrate"),d.add(r);return}let m=[];for(let[e,s]of(u.length>0&&m.push($(u,x(o))),p.entries()))m.push($(s.map(e=>S(e.local,e.imported)),x(e)));s.replaceWithMultiple(m),console.log("  Replaced import with direct imports from source files"),d.add(r)}}}),a){console.log(`Writing changes to ${e}`);let o=w(s,{retainLines:!0,retainFunctionParens:!0},p);r(e,o.code)}else g>0?console.log(`No changes needed for ${g} imports`):console.log("No imports found to update")}catch(o){a&&a.errors++,console.error(`Error processing ${e}:`,o)}}async function N(e){let{sourcePath:r,targetPath:i,ignoreSourceFiles:n,ignoreTargetFiles:l}=e,a={totalFiles:0,filesProcessed:0,filesSkipped:0,importsUpdated:0,filesWithNoUpdates:0,errors:0,totalExports:0,sourceFilesScanned:0,sourceFilesWithExports:0,sourceFilesSkipped:0,targetFilesFound:[],packagesProcessed:0,packagesSkipped:0,warnings:[]},c=await F(r,{cwd:i,absolute:!0,ignore:["**/node_modules/**","**/dist/**","**/build/**","**/target-app/**"],followSymbolicLinks:!1,onlyDirectories:!0}),p=[];for(let e of c){let s=t.join(e,"package.json");try{await o.promises.access(s),p.push(s)}catch{console.log(`No package.json found in ${e}, skipping`)}}for(let o of(console.log(`Found ${p.length} source packages to process`),p))try{let r=t.dirname(o);console.log(`
-Processing package: ${r}`);let c=await E(r),p=await P({packagePath:r,ignoreSourceFiles:n,stats:a});a.totalExports+=p.reduce((e,o)=>e+o.exports.length,0),a.sourceFilesWithExports+=new Set(p.map(e=>e.source)).size,a.sourceFilesScanned+=(await F("**/*.{ts,tsx}",{cwd:r,ignore:["**/node_modules/**","**/dist/**","**/build/**"]})).length;let g=await j({packageName:c.name,monorepoRoot:i});for(let o of(a.totalFiles+=g.length,a.targetFilesFound.push(...g),g)){let r=t.relative(i,o);if(l.some(e=>k.isMatch(r,e))){console.log(`Skipping ignored file: ${o} (matches pattern in ${l.join(", ")})`),a.filesSkipped++;continue}try{let r=s(o,"utf-8");await T({filePath:o,packageName:c.name,exports:p,includeExtension:e.includeExtension,warnings:a.warnings,stats:a});let t=s(o,"utf-8");r!==t?a.importsUpdated++:a.filesWithNoUpdates++,a.filesProcessed++}catch(e){a.errors++,console.error(`Error processing ${o}:`,e)}}a.packagesProcessed++}catch(e){a.packagesSkipped++,console.error(`Error processing package ${o}:`,e)}if(console.log("\nMigration Summary"),console.log(`Source packages found: ${p.length}`),console.log(`Source packages processed: ${a.packagesProcessed}`),console.log(`Source packages skipped: ${a.packagesSkipped}`),console.log(`Source files found: ${a.sourceFilesScanned}`),console.log(`Source files with exports: ${a.sourceFilesWithExports}`),console.log(`Source files skipped: ${a.sourceFilesSkipped}`),console.log(`Exports found: ${a.totalExports}`),console.log(`Target files found: ${a.totalFiles}`),console.log(`Target files processed: ${a.filesProcessed}`),console.log(`Target files with imports updated: ${a.importsUpdated}`),console.log(`Target files with no changes needed: ${a.filesWithNoUpdates}`),console.log(`Target files skipped: ${a.filesSkipped}`),a.warnings.length>0)for(let e of(console.log("\nWarnings:"),a.warnings))console.log(`  - ${e}`);a.errors>0&&console.log(`
-Warning: ${a.errors} errors encountered during processing`)}let v={targetPath:".",ignoreSourceFiles:[],ignoreTargetFiles:[],includeExtension:!1};async function D(){let o=new e;o.name("migrate-barrel-imports").description("CLI tool to migrate barrel files imports to direct imports").argument("<source-path>",'Glob pattern for source packages containing barrel files (e.g. "libs/*")').argument("[target-path]","Path to the directory where imports should be migrated (default: current directory)").option("--ignore-source-files <patterns>","Comma-separated list of file patterns to ignore in source directory").option("--ignore-target-files <patterns>","Comma-separated list of file patterns to ignore in target directory").option("--no-extension","Exclude js|jsx|ts|tsx|mjs|cjs file extensions from import statements").allowUnknownOption(!1).parse(process.argv);let s=o.args;s[0]||(console.error("Error: source-path is required"),process.exit(1));let r=s[0],t=s[1]||v.targetPath,i=o.opts();await N({sourcePath:r,targetPath:t,ignoreSourceFiles:i.ignoreSourceFiles?i.ignoreSourceFiles.split(","):v.ignoreSourceFiles,ignoreTargetFiles:i.ignoreTargetFiles?i.ignoreTargetFiles.split(","):v.ignoreTargetFiles,includeExtension:!1!==i.extension||v.includeExtension})}(async()=>{await D()})();
+import{Command as e}from"commander";import{readFileSync as o,writeFileSync as t}from"node:fs";import s from"node:path";import r from"@babel/generator";import{parse as i}from"@babel/parser";import a from"@babel/traverse";import{isVariableDeclaration as n,isIdentifier as l,isFunctionDeclaration as c,isTSEnumDeclaration as p,isTSInterfaceDeclaration as u,isTSTypeAliasDeclaration as d,isClassDeclaration as g,isExportSpecifier as f,isImportSpecifier as m,isImportDefaultSpecifier as h,isImportNamespaceSpecifier as x,importDeclaration as F,importSpecifier as $,stringLiteral as k}from"@babel/types";import S from"fast-glob";import y from"micromatch";let E=r.default||r,w=a.default||a,P={sourceType:"module",plugins:["typescript","jsx","decorators-legacy","classProperties","classPrivateProperties","classPrivateMethods","exportDefaultFrom","exportNamespaceFrom","functionBind","functionSent","dynamicImport","nullishCoalescingOperator","optionalChaining","objectRestSpread","asyncGenerators","doExpressions","importMeta","logicalAssignment","moduleBlocks","moduleStringNames","numericSeparator","partialApplication","privateIn","throwExpressions","topLevelAwait"]};async function b(e){try{let t=o(e,"utf-8"),s=i(t,P),r=!1;return w(s,{ExportNamedDeclaration(e){e.node.source&&(r=!0)},ExportDefaultDeclaration(){}}),r}catch(o){return console.error(`Error checking if ${e} is a barrel file:`,o),!1}}async function j({packagePath:e,ignoreSourceFiles:t=[],stats:r}){let a=[],m=new Set,h={};console.log(`Scanning for TypeScript and JavaScript files in: ${e}`);let x=await S("**/*.{ts,tsx,js,jsx}",{cwd:e,ignore:["**/node_modules/**","**/dist/**","**/build/**"]});for(let o of(console.log(`Found ${x.length} files`),x)){let t=s.join(e,o);await b(t)&&(m.add(o),console.log(`Identified barrel file: ${o}`))}for(let m of x){let x=t.some(e=>y.isMatch(m,e));x&&(console.log(`File matches ignore pattern but will be preserved: ${m}`),r&&r.sourceFilesSkipped++);let F=s.join(e,m);console.log(`
+Processing file: ${m}`);let $=o(F,"utf-8");try{let e=i($,P),o=[],t={},r={},k=[];w(e,{ExportNamedDeclaration(e){if(e.node.source){let s=e.node.source.value;if(s.includes("node_modules")||!s.startsWith(".")){e.node.specifiers.forEach(e=>{if(f(e)){let i=e.exported,a=l(i)?i.name:i.value;t[a]=s,o.push(a),r[a]=m,h[a]||(h[a]=[]),h[a].push(m)}});return}}if(e.node.declaration){var i;let t=(i=e.node.declaration)?n(i)?i.declarations.map(e=>l(e.id)?e.id.name:null).filter(e=>null!==e):c(i)&&i.id||p(i)||u(i)||d(i)||g(i)&&i.id?[i.id.name]:[]:[];t.length>0&&(o.push(...t),t.forEach(e=>{r[e]=m,h[e]||(h[e]=[]),h[e].push(m)}))}let a=e.node.specifiers.map(o=>{if(f(o)){let t=o.exported,i=l(t)?t.name:t.value;if(e.node.source){let o=e.node.source.value;if(o.startsWith(".")){let e=s.join(s.dirname(m),o);r[i]=e.replace(/\.[^/.]+$/,""),h[i]||(h[i]=[]),h[i].push(m)}}return i}return null}).filter(e=>null!==e);a.length>0&&(o.push(...a),a.forEach(e=>{r[e]||(r[e]=m)}))},ExportDefaultDeclaration(e){let t=e.node.declaration,s=l(t)?t.name:c(t)&&t.id||g(t)&&t.id?t.id.name:"default";o.push(s),r[s]=m,"default"!==s&&k.push(s)}}),(o.length>0||Object.keys(t).length>0)&&(a.push({source:m,exports:o,isIgnored:x,...Object.keys(t).length>0&&{reExports:t},...Object.keys(r).length>0&&{exportSources:r},...k.length>0&&{defaultExportNames:k},...await b(F)&&{isBarrelFile:!0},...Object.keys(h).length>0&&{exportFiles:h}}),o.length>0&&console.log(`Found exports ${o.join(", ")} in ${m}`))}catch(e){console.error(`Error parsing ${m}:`,e)}}return console.log(`
+Total exports found: ${a.length}`),console.log(`Barrel files found: ${m.size}`),a}async function v({packageName:e,targetPath:t,stats:s}){try{let s=new Set,r=await S(["**/*.{ts,tsx,js,jsx}"],{cwd:t,absolute:!0,ignore:["**/node_modules/**","**/dist/**","**/build/**"],followSymbolicLinks:!1});for(let t of(console.log(`Found ${r.length} files to scan`),r))try{let r=o(t,"utf-8"),a=i(r,P);w(a,{ImportDeclaration(o){let r=o.node.source.value;(r===e||r.startsWith(`${e}/`))&&s.add(t)}})}catch(e){console.error(`Error processing file ${t}:`,e)}let a=Array.from(s);if(a.length>0)for(let o of(console.log(`Found total of ${a.length} files with imports from ${e}`),console.log("Files found:"),a))console.log(`  ${o}`);else console.log(`No files found importing from ${e}`);return a}catch(e){return console.error("Error finding imports:",e),[]}}async function D({filePath:e,packageName:s,exports:r,includeExtension:a=!0,warnings:n,stats:c}){console.log(`
+Processing file: ${e}`);let p=o(e,"utf-8"),u=!1;try{let o=i(p,P),n=[];w(o,{ImportDeclaration(e){e.node.source.value.startsWith(s)&&n.push(e.node)}});let d=new Map,g=[];for(let e of n)for(let o of(e.source.value,e.specifiers))if(m(o)){let e=o.imported,t=l(e)?e.name:e.value,i=r.find(e=>e.exports.includes(t));if(i){if(i.isIgnored){g.push(o);continue}if(i.reExports?.[t]){let e=i.reExports[t];if(!e.startsWith(".")){d.has(e)||d.set(e,[]),d.get(e)?.push({local:o.local,imported:o.imported}),u=!0;continue}}if("src/index.ts"===i.source&&i.exports.includes(t)&&!i.reExports?.[t]){if(i.defaultExportNames?.includes(t)){d.has(s)||d.set(s,[]),d.get(s)?.push({local:o.local,imported:o.imported}),u=!0;continue}if("default"!==t){let e=a?`${s}/${i.source}`:`${s}/${i.source.replace(/\.[^/.]+$/,"")}`;d.has(e)||d.set(e,[]),d.get(e)?.push({local:o.local,imported:o.imported}),u=!0;continue}}let e=i.exportFiles?.[t]||[],r=e[0];if(e.length>1){let o=e.filter(e=>!e.includes(".stories.")&&!e.includes(".test.")&&!e.includes(".spec.")&&!e.includes(".stories/")&&!e.includes(".test/")&&!e.includes(".spec/"));o.length>0&&(r=o[0])}if(r){let e=a?`${s}/${r}`:`${s}/${r.replace(/\.[^/.]+$/,"")}`,i=o.local.name!==t,n=Array.from(d.values()).some(e=>e.some(e=>e.imported&&l(e.imported)&&e.imported.name===t));i&&n||(d.has(e)||d.set(e,[]),d.get(e)?.push({local:o.local,imported:o.imported}),u=!0);continue}g.push(o)}else(h(o)||x(o))&&g.push(o)}w(o,{ImportDeclaration(e){e.node.source.value.startsWith(s)&&e.remove()}});let f=[];for(let[e,o]of d)o.length>0&&(f.push(F(o.map(({local:e,imported:o})=>$(e,o)),k(e))),c&&(c.importsMigrated+=o.length));if(g.length>0&&f.push(F(g,k(s))),f.length>0&&(o.program.body.unshift(...f),u=!0),u){let s=E(o,{retainLines:!0,retainFunctionParens:!0},p).code;t(e,s),console.log(`Writing changes to ${e}`),c&&c.importsUpdated++}else c&&c.noChangesNeeded++}catch(o){console.error(`Error updating imports in ${e}:`,o)}}async function T(e){let{sourcePath:o,targetPath:t,includeExtension:s=!0}=e,r={sourcePackagesFound:0,sourcePackagesProcessed:0,sourcePackagesSkipped:0,sourceFilesFound:0,sourceFilesWithExports:0,sourceFilesSkipped:0,exportsFound:0,targetFilesFound:0,targetFilesProcessed:0,importsUpdated:0,noChangesNeeded:0,targetFilesSkipped:0,importsMigrated:0},i=[];try{let e=await I(o);for(let o of(r.sourcePackagesFound=e.length,e)){console.log(`
+Processing package: ${o}`);let e=await j({packagePath:o,stats:r});r.exportsFound=e.reduce((e,o)=>e+o.exports.length,0),r.sourceFilesWithExports=e.length;let a=await N(o),n=await v({packageName:a,targetPath:t,stats:r});for(let o of(r.targetFilesFound=n.length,n))r.targetFilesProcessed++,await D({filePath:o,packageName:a,exports:e,includeExtension:s,warnings:i,stats:r});r.sourcePackagesProcessed++}console.log("\nMigration Summary"),console.log(`Source packages found: ${r.sourcePackagesFound}`),console.log(`Source packages processed: ${r.sourcePackagesProcessed}`),console.log(`Source packages skipped: ${r.sourcePackagesSkipped}`),console.log(`Source files found: ${r.sourceFilesFound}`),console.log(`Source files with exports: ${r.sourceFilesWithExports}`),console.log(`Source files skipped: ${r.sourceFilesSkipped}`),console.log(`Exports found: ${r.exportsFound}`),console.log(`Target files found: ${r.targetFilesFound}`),console.log(`Target files processed: ${r.targetFilesProcessed}`),console.log(`Target files with imports updated: ${r.importsUpdated}`),console.log(`Target files with no changes needed: ${r.noChangesNeeded}`),console.log(`Target files skipped: ${r.targetFilesSkipped}`),console.log(`Total imports migrated: ${r.importsMigrated}`),i.length>0&&(console.log("\nWarnings:"),i.forEach(e=>console.log(`  - ${e}`)))}catch(e){throw console.error("Error during migration:",e),e}}async function N(e){return JSON.parse(o(s.join(e,"package.json"),"utf-8")).name}async function I(e){let o=s.isAbsolute(e)?s.resolve(e):s.join(process.cwd(),e);console.log(`Looking for source packages in: ${o}`);let t=await S("{package.json,**/package.json}",{cwd:o,ignore:["**/node_modules/**","**/dist/**","**/build/**"],absolute:!0});return console.log(`Found ${t.length} package.json files:`),t.forEach(e=>console.log(`  - ${e}`)),t.map(s.dirname)}let W={targetPath:".",ignoreSourceFiles:[],ignoreTargetFiles:[],includeExtension:!1};async function C(){let o=new e;o.name("migrate-barrel-imports").description("CLI tool to migrate barrel files imports to direct imports").argument("<source-path>",'Glob pattern for source packages containing barrel files (e.g. "libs/*")').argument("[target-path]","Path to the directory where imports should be migrated (default: current directory)").option("--ignore-source-files <patterns>","Comma-separated list of file patterns to ignore in source directory").option("--ignore-target-files <patterns>","Comma-separated list of file patterns to ignore in target directory").option("--no-extension","Exclude js|jsx|ts|tsx|mjs|cjs file extensions from import statements").allowUnknownOption(!1).parse(process.argv);let t=o.args;t[0]||(console.error("Error: source-path is required"),process.exit(1));let s=t[0],r=t[1]||W.targetPath,i=o.opts();await T({sourcePath:s,targetPath:r,ignoreSourceFiles:i.ignoreSourceFiles?i.ignoreSourceFiles.split(","):W.ignoreSourceFiles,ignoreTargetFiles:i.ignoreTargetFiles?i.ignoreTargetFiles.split(","):W.ignoreTargetFiles,includeExtension:!1!==i.extension||W.includeExtension})}(async()=>{await C()})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "migrate-barrel-imports",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "A CLI tool to migrate barrel imports in JavaScript/TypeScript monorepos",
   "files": [
     "dist/"