fep-migrator

library1.1.0jsnpmunverified

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.

devops

npm install fep-migrator

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FEP-MIGRATOR

fep-migrator

devopsjavascriptv1.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cli

✓ npx fep-migrator <dir>

✗ npm install -g fep-migrator && fep-migrator

The package is meant to be run via npx; global install is possible but not recommended.

Run the migrator on one or more directories, optionally excluding patterns with glob syntax.

npx fep-migrator src/ npx fep-migrator . "!**/node_modules" npx fep-migrator web mobile

Debug

Known issues

gotchaAlways backup files before migration; ensure they are committed to git.

fix

Run `git add . && git commit` or copy project before using the tool.

affects: all

gotchaThe tool will detect font-family presence and prompt user to manually update.

fix

Review font-family declarations after migration and update as needed.

affects: all

breakingMigration 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.

fix

Verify that all migrated imports correspond to equivalent Falconix APIs; consult Falconix documentation.

affects: all

Errors

Common errors & fixes

fep-migrator: command not found

npx not available or package not installed globally

fix

Run `npx fep-migrator` instead of `fep-migrator`. If npx fails, ensure Node.js >= 14.

Cannot find module 'oxc-parser'

Missing dependency when using global install

fix

Use npx to run the tool without global install; it will fetch dependencies automatically.

Upgrade

Version history

1.1.0latest on npm

Audit

Dependencies

oxc-parserrequiredAST parsing for source transformation

tsdownrequireddependency bundling or transformation

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/tjyuanpeng/fep-migrator ↗

packagefep-migrator ↗

homepagehttps://github.com/tjyuanpeng/fep-migrator ↗