file-case-converter

نظرة عامة

A Node.js CLI tool that converts file names across an entire codebase (kebab-case, camelCase, snake_case, PascalCase) and automatically updates all import statements by parsing the source files with an AST — not regex. Supports dry-run mode, ignores node_modules, and works on large projects.

المشكلة

Renaming files in a JavaScript/TypeScript project manually breaks imports. Regex-based find-and-replace is fragile and error-prone on large codebases. This tool solves the problem by using AST-based import analysis to safely rename and update everything in one command.

دوري

Designed and built the tool from scratch. Implemented the AST-based import resolver, file renaming logic, case conversion functions, CLI argument parsing, and dry-run preview mode. Published to npm.

المعمارية

1. 1Node.js CLI entry point
2. 2Case conversion module (kebab, snake, camel, pascal)
3. 3File system traversal (recursive, ignores node_modules)
4. 4AST parser for import path extraction and replacement
5. 5Dry-run mode to preview changes before applying them

القرارات التقنية

• Chose AST parsing over regex to make import updates safe and accurate across different import syntax styles.
• Added dry-run mode as a first-class feature — developers should always be able to preview destructive changes.
• Published as an npx-compatible package so users can run it without installing.

مجموعة التقنيات