{"id":47563,"library":"fep-migrator","title":"FEP Migrator","description":"CLI tool for migrating Falconix FEP projects from Element Plus and @element-plus/icons-vue to @falconix/fep and @falconix/icons-vue. Version 1.1.0. Uses AST parsing with oxc-parser and tsdown to transform imports and detect font-family issues. A specialized migration helper for teams adopting the Falconix design system.","status":"active","version":"1.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/tjyuanpeng/fep-migrator","tags":["javascript","falconix","fep","migration","element-plus","ast","oxc-parser","tsdown"],"install":[{"cmd":"npm install fep-migrator","lang":"bash","label":"npm"},{"cmd":"yarn add fep-migrator","lang":"bash","label":"yarn"},{"cmd":"pnpm add fep-migrator","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"AST parsing for source transformation","package":"oxc-parser","optional":false},{"reason":"dependency bundling or transformation","package":"tsdown","optional":false}],"imports":[{"note":"The package is meant to be run via npx; global install is possible but not recommended.","wrong":"npm install -g fep-migrator && fep-migrator","symbol":"cli","correct":"npx fep-migrator <dir>"}],"quickstart":{"code":"npx fep-migrator src/\nnpx fep-migrator . \"!**/node_modules\"\nnpx fep-migrator web mobile","lang":"javascript","description":"Run the migrator on one or more directories, optionally excluding patterns with glob syntax."},"warnings":[{"fix":"Run `git add . && git commit` or copy project before using the tool.","message":"Always backup files before migration; ensure they are committed to git.","severity":"gotcha","affected_versions":"all"},{"fix":"Review font-family declarations after migration and update as needed.","message":"The tool will detect font-family presence and prompt user to manually update.","severity":"gotcha","affected_versions":"all"},{"fix":"Verify that all migrated imports correspond to equivalent Falconix APIs; consult Falconix documentation.","message":"Migration replaces element-plus and @element-plus/icons-vue imports with @falconix/fep and @falconix/icons-vue. Existing code relying on Element Plus APIs may break.","severity":"breaking","affected_versions":"all"}],"env_vars":null,"search_vec":"'/icons-vue':17 '1.1.0':23 'adopt':48 'ast':25,60 'cli':3 'design':51 'detect':37 'element':11,15,58 'element-plus':14,57 'falconix':7,50,54 'falconix/fep':19 'falconix/icons-vue':21 'famili':40 'fep':1,8,55 'font':39 'font-famili':38 'helper':45 'import':35 'issu':41 'javascript':53 'migrat':2,6,44,56 'oxc':29,62 'oxc-pars':28,61 'pars':26 'parser':30,63 'plus':12,16,59 'project':9 'special':43 'system':52 'team':47 'tool':4 'transform':34 'tsdown':32,64 'use':24 'version':22","created_at":"2026-06-07T16:52:09.527939+00:00","updated_at":"2026-06-07T16:52:09.527939+00:00","problems":[{"fix":"Run `npx fep-migrator` instead of `fep-migrator`. If npx fails, ensure Node.js >= 14.","cause":"npx not available or package not installed globally","error":"fep-migrator: command not found"},{"fix":"Use npx to run the tool without global install; it will fetch dependencies automatically.","cause":"Missing dependency when using global install","error":"Cannot find module 'oxc-parser'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/tjyuanpeng/fep-migrator","github":"https://github.com/tjyuanpeng/fep-migrator","docs":null,"changelog":null,"pypi":null,"npm":"fep-migrator","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}