Skip to content

feat: VSCode/웹 확장 앱 추가 및 공용 로직 packages/shared 분리#175

Draft
Nohgh wants to merge 26 commits into
dev-five-git:mainfrom
Nohgh:feat/integration-extension
Draft

feat: VSCode/웹 확장 앱 추가 및 공용 로직 packages/shared 분리#175
Nohgh wants to merge 26 commits into
dev-five-git:mainfrom
Nohgh:feat/integration-extension

Conversation

@Nohgh

@Nohgh Nohgh commented Jul 13, 2026

Copy link
Copy Markdown

Summary

  • VSCode 확장 앱(apps/vscode-extension)과 브라우저 확장 앱(apps/web-extension)을 추가합니다.
  • mobile의 공용 로직(braille / translate / clipboard / history)을 packages/shared로 추출해 mobile·vscode·web 앱이 함께 사용하도록 전환합니다.

Changes (내 작업 — 3커밋)

  • refactor(shared): mobile 공용 로직을 packages/shared로 추출
    • apps/mobile/src/lib/* 삭제 → packages/shared/src/로 이동
    • mobile이 워크스페이스 패키지 @braillify/shared를 소비하도록 전환
  • feat(vscode-extension): VSCode 확장 앱 추가 (웹뷰 기반 점역 입력/편집/기록 UI)
  • feat(web-extension): WXT 기반 브라우저 확장 앱 추가 (팝업 UI)

⚠️ Blocked by #166 — 머지 순서 안내

이 PR은 demo-ios-app(모바일/iOS 데모) 작업 위에 얹혀 있어, #166이 먼저 main에 merge되어야 합니다.

현재 comparison에 다수의 커밋/파일이 보이는 것은 #166의 선행 작업이 아직 main에 없기 때문이며, 아래 순서로 정리됩니다.

머지까지의 순서

  1. #166이 main에 merge (선행 조건)
  2. 본 브랜치를 최신 main 위로 rebase → diff를 내 3커밋(shared/vscode/web)만 남김
    git fetch upstream
    git rebase --onto upstream/main c042d9c feat/integration-extension
    git push --force-with-lease origin feat/integration-extension

coom1222 and others added 26 commits May 22, 2026 21:29
## Rust 디코더
- `libs/braillify/src/decoder.rs` 신규 작성
  - 한국 점자 → 한글 상태 머신 디코더 (`Start / GotCho / GotJung`)
  - 약자(을·억·언·얼·연·열·영·옥·온·옹·운·울·은·인) 디코딩
  - 2바이트 특수 약자(성·정·청·것) 디코딩
  - 가나다마바사자카타파하 초성 단독 약자 디코딩
  - Unicode TIndex 종성 값 정확히 반영 (ㄹ=8, ㅇ=21 등)
  - 7개 단위 테스트 전체 통과
- `libs/braillify/src/lib.rs`: `pub fn decode()` 공개 함수 추가

## WASM 바인딩
- `packages/node/src/lib.rs`: `decodeFromUnicode()` JS 함수 노출

## 모바일 앱 UI
- `apps/mobile/src/lib/translate.ts`
  - `translateReverse()` 구현 — `decodeFromUnicode` WASM 연결
- `apps/mobile/src/pages/TranslatorPage.tsx`
  - 정점역 / 역점역 방향 토글 추가
  - 역점역 모드에서 `BrailleInput` 컴포넌트로 전환
- `apps/mobile/src/components/BrailleInput.tsx` 신규 작성
  - 직접 입력/붙여넣기 텍스트 필드 (점자 유니코드)
  - 도트 키보드: `EditableBrailleCell` 재사용, 셀 단위 점 토글
  - 두 입력 방식 실시간 동기화 (`masksToString` / `parseToCells`)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- 모바일 앱 개발에 필요한 스크립트를 추가했습니다.
- Tauri 앱에 있던 템플릿 메타데이터를 Braillify 프로젝트에 맞게 작성했습니다.
- 다음과 같은 문제를 해결:
11번째 번역을 하면 → 가장 오래된 10번째 항목이 자동으로 삭제
PR 리뷰 피드백 반영 (gemini-code-assist Critical).

된소리표 ⠠(32) 뒤의 바이트 패턴이 두 가지임을 확인:
- ㅏ 모음: 된소리표 + 약자/공유 바이트 (까=[32,43], 싸=[32,7])
- 기타 모음: 된소리표 + 초성 바이트 + 별도 중성 (꺼=[32,8,14], 쏘=[32,32,37])

try_choseong_with_double() 함수 추가:
  43|8  → ㄲ(1)  / 10 → ㄸ(4)  / 24 → ㅃ(8)
  7|32  → ㅆ(10) / 40 → ㅉ(13)

Stage::Start, Stage::GotJung 두 곳에서 try_choseong → try_choseong_with_double 교체.
된소리 테스트 8개 추가 (ㅏ 모음 5종 + ㅏ 외 모음 3종 + 단어 2종).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
PR 리뷰 피드백 반영 (gemini-code-assist High Priority).

붙여넣기 시 일반 공백(' ')과 줄바꿈('\n')이 무시되어
단어 경계가 사라지는 문제 수정.
→ 두 문자 모두 0(⠀ U+2800 점자 공백)으로 매핑하여 단어 경계 보존.
PR 리뷰 피드백 반영 (gemini-code-assist Medium Priority).

단음절 테스트만으로는 놓칠 수 있는 케이스를 보완:
- 껐어요: 된소리 + 종성 + 후속 음절
- 아까: 단어 중간에 된소리
- 기쁘다: ㅃ(된소리ㅂ) 포함 단어
PR 리뷰 피드백 반영 (gemini-code-assist Medium Priority).

배열 인덱스를 key로 쓰면 셀 삭제 시 React가 잘못된
컴포넌트를 재사용하는 버그가 생길 수 있음.
counter useRef로 단조 증가 ID를 생성하고 cellIds state에 저장.
- 셀 추가/공백/삭제 시 ID 배열도 함께 업데이트
- 텍스트 붙여넣기로 전체 교체 시 모든 셀에 새 ID 발급
- 방향 전환 등 외부 초기화(cells.length===0) 시 useEffect로 동기화
리뷰어(Nohgh) 피드백 반영.

기존: direction(정점역/역점역) + mode(일반/수학) 두 개의 토글
변경: PageMode('general'|'math'|'reverse') 단일 상태로 통합
→ [일반] [수학] [역점역] 한 줄 토글로 3가지 기능이 명확하게 표시됨

- direction/mode 두 상태 제거, pageMode 하나로 대체
- 수학 점역 기능 유지 확인
feat: 역점역(점자→한글) 기능 구현 및 점자 입력 키보드 추가
feat: Braillify Android 초기 설정 및 UI/UX 정리
- Next.js App Router + 정적 export(output:'export')로 마이그레이션
- @devup-ui/vite-plugin → @devup-ui/next-plugin 교체, WASM(asyncWebAssembly) webpack 설정 이식
- RSC 경계 분리: layout/page는 서버 컴포넌트, 탭 상태만 AppShell client island로 격리
- src/pages → src/views 이동(Next Pages Router 충돌 회피), 상호작용 화면에만 'use client'
- global.css → devup-ui globalCss 이식
- Tauri frontendDist를 ../out(Next export 출력)으로 변경
- Vite 설정/진입점 제거
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants