@actabldesign/bellhop-migrate
v0.3.2
Published
Scan and migrate codebases from Bellhop 0.2.x to 0.3.0 (component renames, event normalization, token rewrite, asset renames)
Maintainers
Readme
@actabldesign/bellhop-migrate
Scan and migrate a codebase from Bellhop 0.2.x to 0.3.0.
# report every 0.2.x usage (read-only)
npx @actabldesign/bellhop-migrate
# apply the unambiguous rewrites (run from a clean git state)
npx @actabldesign/bellhop-migrate --fixWhat it handles
| Change | Mode |
| --- | --- |
| Component renames (bh-panel → bh-side-panel, bh-checkbox-group → bh-selection-group) | auto-fix |
| Event normalization (38 renames, e.g. bhDismiss → bhClose) across React props, Angular bindings, and addEventListener | auto-fix |
| Removed bhClick/bhDoubleClick/bhContextMenu → native handlers | auto-fix |
| Token rewrite: 419 --bh-* → three-tier tokens | auto-fix |
| Renamed asset files (avatars, logos, illustrations) | auto-fix |
| bh-notification → bh-alert or bh-toast (per-usage choice) | report |
| Removed tokens with no direct replacement (625) | report |
| Behavior changes (bh-sidebar/bh-logo-box defaults, bh-side-panel bubbling) | report |
| "latest" version ranges on @actabldesign/bellhop-* deps | report |
Exit code is 0 only when nothing needs attention, so it can gate CI.
--json emits machine-readable findings.
The full narrative guide lives in MIGRATION.md at the bellhop repo root.
