Global Message Converter

React 애플리케이션의 하드코딩된 한국어 텍스트를 자동으로 감지하여 react-intl 형태로 변환하는 CLI 도구입니다.

주요 기능

• 🔍 자동 감지: 한국어 텍스트만 정확히 탐지 및 변환
• 🎛️ 스마트 변환: String Literal, Template Literal, JSX Text 모두 지원
• 🔧 컴포넌트 자동 처리: 함수형/클래스형 컴포넌트 자동 감지
• 📝 메시지 관리: 기존 메시지와 매칭하거나 새 메시지 자동 생성
• 🎨 JSX 속성 지원: label, placeholder, title, alt, aria-label 속성 변환

빠른 시작

설치

npm install -g global-message-converter

실행

gmc convert -t ./src -m ./messages/ko.js

변환 예시

변환 전:

function Welcome() {
    const message = "안녕하세요!";
    return <div>환영합니다</div>;
}

변환 후:

import { FormattedMessage, useIntl } from "react-intl";

function Welcome() {
    const intl = useIntl();
    const message = intl.formatMessage({ id: "new.message.1", defaultMessage: "안녕하세요!" });
    return <div><FormattedMessage id="new.message.2" defaultMessage="환영합니다" /></div>;
}

사용법

기본 명령어

gmc convert -t <대상경로> -m <메시지파일>

옵션

옵션	설명	필수
-t, --target	변환 대상 파일 또는 폴더 경로	✅
-m, --message	기존 메시지 파일 경로 (JSON/JS)	✅
-c, --config	설정 파일 경로	❌
-v, --verbose	상세 로그 출력	❌
-q, --quiet	조용한 모드 (오류만 출력)	❌
--no-colors	색상 출력 비활성화	❌
--no-progress	진행률 표시 비활성화	❌

사용 예시

# 파일 하나 변환
gmc convert -t ./src/components/Header.jsx -m ./messages/ko.js

# 폴더 전체 변환
gmc convert -t ./src/components -m ./messages/ko.js

# 상세 로그와 함께 변환
gmc convert -t ./src -m ./messages/ko.js --verbose

# 설정 파일 사용
gmc convert -t ./src -m ./messages/ko.js --config .gmcrc.json

설정

프로젝트의 변환 동작을 세밀하게 제어할 수 있습니다.

설정 파일 생성

gmc config --init

이 명령어는 .gmcrc.json 파일을 생성하여 기본 설정을 제공합니다.

설정 관리 명령어

# 현재 설정 확인
gmc config --show

# 설정 검증
gmc config --validate

자세한 설정 옵션은 설정 가이드를 참조하세요.

메시지 파일 형식

지원 형식 (JavaScript)

export default {
    "welcome": "환영합니다!",
    "loading": "로딩 중...",
    "error": "오류가 발생했습니다."
}

지원 형식 (JSON)

{
    "welcome": "환영합니다!",
    "loading": "로딩 중...",
    "error": "오류가 발생했습니다."
}

변환 제외 항목

다음과 같은 경우 변환되지 않습니다:

• 한국어가 포함되지 않은 텍스트
• console 함수 호출의 인수 (console.log("디버그"))
• 글꼴 이름 ("맑은 고딕", "나눔고딕" 등)
• URL, 경로, 숫자, 색상코드
• 특정 JSX 속성 (className, style, data-* 등)

시스템 요구사항

• Node.js: >= 14.0.0
• 지원 파일 형식: .js, .jsx, .ts, .tsx

문제해결

Q: 일부 텍스트가 변환되지 않아요

• 한국어가 포함된 텍스트만 변환됩니다
• 지원되는 JSX 속성: label, placeholder, title, alt, aria-label

Q: 변환 후 코드 스타일이 변경돼요

• 변환 후 Prettier나 ESLint를 실행해서 일관된 포맷팅을 적용하세요

라이선스

MIT 라이선스

변경사항

CHANGELOG.md