fep-migrator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-PRESENT Anthony Fu<https://github.com/antfu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# fep-migrator
+
+@falconix fep 迁移工具
+
+## 安装
+
+```shell
+pnpm i fep-migrator -g
+```
+
+## 使用
+
+```shell
+fep-migrator <...dir>
+```
+
+`dir` 为需要迁移的 fep 项目目录，支持多个目录同时迁移，例如：
+
+```shell
+fep-migrator src1 src2
+```
+
+可以使用glob语法排除掉文件夹，例如：
+
+```shell
+fep-migrator src "!**/public"
+```
+
+`fep-migrator` 会迁移两个包的内容：
+
+- element-plus => @falconix/fep
+
+- @element-plus/icons-vue => @falconix/icons-vue
+
+使用前请备份好文件，确保文件已经提交到git仓库

package/dist/index.mjs

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { cac } from "cac";
+import path from "node:path";
+import fs from "fs-extra";
+import { globbySync } from "globby";
+import MagicString from "magic-string";
+import { parseSync } from "oxc-parser";
+import { parse } from "@vue/compiler-sfc";
+
+//#region src/sfc.ts
+const parseVueSfcFile = (filename) => {
+	const code = fs.readFileSync(filename, { encoding: "utf-8" });
+	const { descriptor } = parse(code, {
+		filename,
+		sourceMap: false
+	});
+	return [code, descriptor];
+};
+const modifySfcCodeByDescriptor = (code, descriptor) => {
+	const ms = new MagicString(code);
+	const { template, script, scriptSetup, styles, customBlocks } = descriptor;
+	const blocks = [
+		template,
+		script,
+		scriptSetup,
+		...styles,
+		...customBlocks
+	].filter((block) => block != null).sort((a, b) => {
+		return a.loc.start.offset - b.loc.start.offset;
+	});
+	blocks.reverse();
+	for (const block of blocks) ms.overwrite(block.loc.start.offset, block.loc.end.offset, block.content);
+	const hasChanged = ms.hasChanged();
+	return [hasChanged, hasChanged ? ms.toString() : code];
+};
+
+//#endregion
+//#region src/replace-fep.ts
+const resolveFep = (code, filename) => {
+	const ms = new MagicString(code);
+	const { program } = parseSync(filename, code, { lang: "tsx" });
+	const imports = program.body.filter((i) => i.type === "ImportDeclaration").reverse();
+	for (const importItem of imports) {
+		const { raw, start, end } = importItem.source;
+		const text = raw ?? "";
+		const epRegex = /^(['"])element-plus/;
+		const iconRegex = /^(['"])@element-plus\/icons-vue/;
+		if (epRegex.test(text)) {
+			const newPath = text.replace(epRegex, (_all, p1) => {
+				return `${p1}@falconix/fep`;
+			});
+			ms.overwrite(start, end, newPath);
+		} else if (iconRegex.test(text)) {
+			const newPath = text.replace(iconRegex, (_all, p1) => {
+				return `${p1}@falconix/icons-vue`;
+			});
+			ms.overwrite(start, end, newPath);
+		}
+	}
+	const hasChanged = ms.hasChanged();
+	return [hasChanged, hasChanged ? ms.toString() : code];
+};
+async function replacer(dirs) {
+	const fileList = globbySync(dirs, {
+		absolute: true,
+		onlyFiles: true,
+		gitignore: true,
+		expandDirectories: { extensions: [
+			"js",
+			"jsx",
+			"ts",
+			"tsx",
+			"vue"
+		] },
+		ignore: [
+			"**/node_modules",
+			"**/*.d.ts",
+			"**/public"
+		]
+	});
+	const statistic = {
+		success: 0,
+		fail: 0,
+		total: fileList.length
+	};
+	for (const file of fileList) try {
+		if (file.endsWith(".vue")) {
+			const [code, descriptor] = parseVueSfcFile(file);
+			let changed = false;
+			if (descriptor.script) {
+				const [hasChanged, newScript] = resolveFep(descriptor.script.content, file);
+				if (hasChanged) {
+					changed = true;
+					descriptor.script.content = newScript;
+				}
+			}
+			if (descriptor.scriptSetup) {
+				const [hasChanged, newScriptSetup] = resolveFep(descriptor.scriptSetup.content, file);
+				if (hasChanged) {
+					changed = true;
+					descriptor.scriptSetup.content = newScriptSetup;
+				}
+			}
+			if (changed) {
+				const [_changed, resolved] = modifySfcCodeByDescriptor(code, descriptor);
+				fs.writeFileSync(file, resolved);
+			}
+		} else {
+			const [hasChanged, resolved] = resolveFep(fs.readFileSync(file, { encoding: "utf-8" }), file);
+			if (hasChanged) fs.writeFileSync(file, resolved);
+		}
+		statistic.success++;
+	} catch (e) {
+		statistic.fail++;
+		console.error(`❌ 处理错误: [${path.relative(process.cwd(), file)}], error:${e}`);
+		throw e;
+	}
+	return statistic;
+}
+var replace_fep_default = replacer;
+
+//#endregion
+//#region src/index.ts
+const cli = cac("fep-migrator");
+cli.version(process.env.npm_package_version ?? "-").command("<...dir>", "处理路径").action(async (dirs) => {
+	console.log("# 开始处理.");
+	const statistic = await replace_fep_default(dirs);
+	console.log(`# 所有文件迁移完成。共处理 ${statistic.total} 个文件，成功 ${statistic.success} 个，失败 ${statistic.fail} 个`);
+});
+cli.help();
+cli.parse();
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["replaceFep"],"sources":["../src/sfc.ts","../src/replace-fep.ts","../src/index.ts"],"sourcesContent":["import type { SFCDescriptor } from '@vue/compiler-sfc'\nimport { parse } from '@vue/compiler-sfc'\nimport fs from 'fs-extra'\nimport MagicString from 'magic-string'\n\nexport const parseVueSfcFile = (filename: string): [string, SFCDescriptor] => {\n  const code = fs.readFileSync(filename, { encoding: 'utf-8' })\n  const { descriptor } = parse(code, {\n    filename,\n    sourceMap: false,\n  })\n\n  return [code, descriptor]\n}\n\nexport const modifySfcCodeByDescriptor = (code: string, descriptor: SFCDescriptor): [boolean, string] => {\n  const ms = new MagicString(code)\n  const {\n    template,\n    script,\n    scriptSetup,\n    styles,\n    customBlocks,\n  } = descriptor\n\n  const blocks = [template, script, scriptSetup, ...styles, ...customBlocks]\n    .filter(block => block != null)\n    .sort((a, b) => {\n      return a.loc.start.offset - b.loc.start.offset\n    })\n  blocks.reverse()\n\n  for (const block of blocks) {\n    ms.overwrite(block.loc.start.offset, block.loc.end.offset, block.content)\n  }\n\n  const hasChanged = ms.hasChanged()\n  return [hasChanged, hasChanged ? ms.toString() : code]\n}\n","import path from 'node:path'\nimport process from 'node:process'\nimport fs from 'fs-extra'\nimport { globbySync } from 'globby'\nimport MagicString from 'magic-string'\nimport { parseSync } from 'oxc-parser'\nimport { modifySfcCodeByDescriptor, parseVueSfcFile } from './sfc'\n\nconst resolveFep = (code: string, filename: string): [boolean, string] => {\n  const ms = new MagicString(code)\n  const { program } = parseSync(filename, code, { lang: 'tsx' })\n  const imports = program.body.filter(i => i.type === 'ImportDeclaration').reverse()\n  for (const importItem of imports) {\n    const { raw, start, end } = importItem.source\n    const text = raw ?? ''\n    const epRegex = /^(['\"])element-plus/\n    const iconRegex = /^(['\"])@element-plus\\/icons-vue/\n    if (epRegex.test(text)) {\n      const newPath = text.replace(epRegex, (_all, p1) => {\n        return `${p1}@falconix/fep`\n      })\n      ms.overwrite(start, end, newPath)\n    } else if (iconRegex.test(text)) {\n      const newPath = text.replace(iconRegex, (_all, p1) => {\n        return `${p1}@falconix/icons-vue`\n      })\n      ms.overwrite(start, end, newPath)\n    }\n  }\n  const hasChanged = ms.hasChanged()\n  return [hasChanged, hasChanged ? ms.toString() : code]\n}\n\nasync function replacer(dirs: string[]) {\n  const fileList = globbySync(dirs, {\n    absolute: true,\n    onlyFiles: true,\n    gitignore: true,\n    expandDirectories: {\n      extensions: ['js', 'jsx', 'ts', 'tsx', 'vue'],\n    },\n    ignore: ['**/node_modules', '**/*.d.ts', '**/public'],\n  })\n  const statistic = {\n    success: 0,\n    fail: 0,\n    total: fileList.length,\n  }\n  for (const file of fileList) {\n    try {\n      if (file.endsWith('.vue')) {\n        const [code, descriptor] = parseVueSfcFile(file)\n        let changed = false\n        if (descriptor.script) {\n          const [hasChanged, newScript] = resolveFep(descriptor.script.content, file)\n          if (hasChanged) {\n            changed = true\n            descriptor.script.content = newScript\n          }\n        }\n        if (descriptor.scriptSetup) {\n          const [hasChanged, newScriptSetup] = resolveFep(descriptor.scriptSetup.content, file)\n          if (hasChanged) {\n            changed = true\n            descriptor.scriptSetup.content = newScriptSetup\n          }\n        }\n        if (changed) {\n          const [_changed, resolved] = modifySfcCodeByDescriptor(code, descriptor)\n          fs.writeFileSync(file, resolved)\n        }\n      } else {\n        const content = fs.readFileSync(file, { encoding: 'utf-8' })\n        const [hasChanged, resolved] = resolveFep(content, file)\n        if (hasChanged) {\n          fs.writeFileSync(file, resolved)\n        }\n      }\n      statistic.success++\n    } catch (e) {\n      statistic.fail++\n      console.error(`❌ 处理错误: [${path.relative(process.cwd(), file)}], error:${e}`)\n      throw e\n    }\n  }\n  return statistic\n}\n\nexport default replacer\n","#!/usr/bin/env node\n\nimport process from 'node:process'\nimport { cac } from 'cac'\nimport replaceFep from './replace-fep'\n\nconst cli = cac('fep-migrator')\ncli\n  .version(process.env.npm_package_version ?? '-')\n  .command('<...dir>', '处理路径')\n  .action(async (dirs) => {\n    console.log('# 开始处理.')\n    const statistic = await replaceFep(dirs)\n    console.log(`# 所有文件迁移完成。共处理 ${statistic.total} 个文件，成功 ${statistic.success} 个，失败 ${statistic.fail} 个`)\n  })\ncli.help()\ncli.parse()\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "fep-migrator",
+  "type": "module",
+  "version": "1.0.0",
+  "packageManager": "pnpm@10.23.0",
+  "description": "@falconix/fep migration helper",
+  "author": "tjyuanpeng <tjyuanpeng@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/tjyuanpeng/fep-migrator",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tjyuanpeng/fep-migrator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tjyuanpeng/fep-migrator/issues"
+  },
+  "keywords": [
+    "falconix",
+    "fep",
+    "migration",
+    "element-plus",
+    "ast",
+    "oxc-parser",
+    "tsdown"
+  ],
+  "bin": {
+    "fep-migrator": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "start": "node dist/index.mjs",
+    "watch": "tsdown --watch --sourcemap",
+    "build": "tsdown --sourcemap",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@vue/compiler-sfc": "^3.5.26",
+    "cac": "^6.7.14",
+    "fs-extra": "^11.3.3",
+    "globby": "^16.1.0",
+    "magic-string": "^0.30.21",
+    "oxc-parser": "^0.108.0"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.7.3",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.6",
+    "eslint": "^9.39.2",
+    "eslint-plugin-format": "^1.2.0",
+    "tsdown": "0.20.0-beta.1",
+    "typescript": "^5.9.3"
+  }
+}