[한만욱] 우아한 테크코스 8기 오픈 미션 제출

[manNomi]

🦀 i18nexus-tools: TypeScript → Rust Migration (40% Complete)

📝 Overview

TypeScript/Babel 기반 i18nexus-tools를 Rust/SWC로 마이그레이션을 목표로 잡았습니다.
빌드 타임 성능 최적화와 향후 namespace 자동 분리 기능을 위한 기반 작업입니다.

진행률: ~40% (핵심 변환 로직 완성, AST 노드 교체 및 일부 기능 미완성)

---

✨ What's Done

🎯 Core Achievements

• Wtf8Atom → &str 변환 구현: SWC의 특수 문자열 타입을 Rust의 표준 타입으로 변환하는 핵심 로직 완성
• Deref Coercion 활용: 소스코드 분석을 통해 to_string_lossy() 메서드 발견 및 적용
• 코드베이스 리팩토링: 500줄 단일 파일 → 모듈별 분리 (ast-helpers, ast-transformers, import-manager)
• 테스트 전략 개선: 내부 구조 테스트 → E2E 중심 + 핵심 함수 단위 테스트

🔧 Technical Implementation

// Wtf8Atom → &str 변환 예시
let text = str_lit.value.to_string_lossy(); // Deref coercion 활용
let contains_korean = KOREAN_REGEX.is_match(&text);

---

🚧 What's Not Done Yet

⏳ In Progress

• 실제 AST 노드 교체 (TemplateLiteral, JSXText)
• i18n-ignore 주석 처리
• 이미 래핑된 경우 스킵 기능
• Namespace 자동 분리 (기획 완료, 구현 대기)

💭 Design Decisions

삭제된 기능:

• 외부 파일 import 상수 자동 추출 → 복잡도 vs 가치 trade-off로 제거
• 이유: 재귀적 파일 분석의 성능 저하, 잘못된 추론 가능성

추가 예정 기능:

• Namespace 자동 분리: 파일 경로 기반 자동 할당 (TanStack Router 영감)
• 타입 안전성: TypeScript Template Literal Types 활용

---

📚 Learning Resources

🦀 Rust Practice Projects

새로운 언어를 익숙한 문제로 학습하는 전략을 적용했습니다. 우테코 프리코스 미션을 Rust로 구현하며 소유권 시스템과 에러 핸들링을 체득했습니다.

🔢 Rust Calculator

manNomi/rust-calculator-8

🏎️ Rust Racing Car

manNomi/rust-racingcar-8

📖 Troubleshooting & Deep Dive

Rust로의 마이그레이션 동안 겪었던 문제들과 해결 과정을 정리한 기록입니다.

🔗 Notion Document — RUST i18nexus 마이그레이션 여정

https://second-system-cf4.notion.site/RUST-i18nexus-2a17cf19a36480238fe1e56cee9c02b2

• Wtf8Atom 변환 3일간의 디버깅
• 터보팩 소스코드 분석 경험
• Deref trait 이해 과정
• TypeScript → Rust 개념 매핑