@kimdayoun/hwpx-mcp 0.3.0 → 0.3.3

package/CHANGELOG.md

@@ -0,0 +1,148 @@
+# Changelog
+
+`@kimdayoun/hwpx-mcp` 의 주요 변경 사항을 기록합니다.
+
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 를 따르고,
+버전은 [유의적 버전](https://semver.org/lang/ko/) 을 따릅니다.
+
+## [0.3.3] - 2026-09-24
+
+0.3.2 는 npm 에 게시하지 않았습니다. 게시 전에 윈도우 한/글로 직접 렌더하다가,
+MCP 응답이 성공이고 `analyze_xml` 도 통과하는데 화면이 틀어진 곳을 찾았습니다.
+0.3.2 의 수정은 모두 이 버전에 포함돼 있습니다.
+
+변경 내역은 [#13](https://github.com/Dayoooun/hwpx-mcp/pull/13),
+[#14](https://github.com/Dayoooun/hwpx-mcp/pull/14) 에 있습니다.
+
+### Fixed
+
+- **문단과 표를 섞어 넣으면 저장본 순서가 뒤집히던 문제.** `[제목, 표, 제목, 표]` 로
+  넣었는데 한/글에서는 `[제목, 제목, 표, 표]` 로 보였습니다. 새 문서에서 문단 두 개만
+  넣어도 순서가 바뀌었습니다. 위치를 요소 번호 대신 앞 요소의 id 로 기록하고,
+  삽입·복제·이동을 호출한 순서대로 저장합니다.
+- **다시 연 문서에서 복제한 문단을 고치면 원본이 바뀌던 문제.** 0.3.2 에서 고친 증상이
+  "저장 → 다시 열기 → 복제 → 수정" 경로에는 남아 있었습니다. 수정 대상 문단을
+  저장 시점에 다시 찾습니다. 수정한 뒤 다른 문단을 옮기거나 지워도 그 문단이 바뀝니다.
+- **표 뒤에 넣은 문단이 표 첫 칸 안으로 들어가던 문제.**
+- **표 안 글자가 셀 테두리에 붙던 문제.** 새로 만든 표의 셀 안 여백이 0 이었습니다.
+  한/글로 쟀을 때 글자가 테두리에서 0pt 떨어져 있었고, 이제 왼쪽 5pt, 위 1.4pt 떨어집니다.
+- **표 안 표가 부모 칸을 뚫고 나가던 문제.** 중첩 표 칸 폭이 부모와 상관없이
+  80mm 로 고정돼 있었습니다. 부모 칸 안쪽 폭에 맞추고, 표 위에 생기던 빈 줄도 없앴습니다.
+- **내어쓰기 둘째 줄이 첫 줄 본문보다 오른쪽에서 시작하던 문제.** 마커 폭을 추정식으로
+  계산해 한/글보다 평균 4.14pt 넓게 잡았습니다. 마커 35종을 한/글로 그려 잰 폭으로
+  바꿨고, 오차는 평균 0.04pt 입니다. 함초롬바탕·함초롬돋움만 실측했습니다.
+- **`insert_table_row` 의 `cell_texts` 가 다른 칸으로 들어가던 문제.** 기준 행에 여러 줄
+  칸이 있으면 `['가','나','다']` 가 `['가','나다','']` 로 들어갔고, 새 행이 세 줄 높이가
+  됐습니다.
+
+### 알려진 제한
+
+- run 이 여러 개인 문단을 `update_paragraph_text` 로 고치면 새 글자가 run 사이에
+  흩어지거나 사라질 수 있습니다. 미주·수식이 섞인 문단은 수정이 반영되지 않을 수
+  있습니다. 이 버전 이전부터 있던 문제입니다.
+
+## [0.3.2] - 2026-09-22
+
+외부 사용 리뷰에서 보고된 8건을 MCP stdio 클라이언트로 직접 재현한 뒤 수정했습니다.
+리뷰 대응 내역은 [#10](https://github.com/Dayoooun/hwpx-mcp/pull/10) 에 정리돼 있습니다.
+
+### Fixed
+
+- **표 행·열 삽입이 저장본을 깨뜨리던 문제.** 복제한 행·셀의 본문을 비우는 정규식
+  `<(hp|hs):t([^>]*)>` 에 태그명 뒤 경계가 없어 `<hp:tc>` 를 `<hp:t>` 로 삼켰습니다.
+  `<hp:subList>` 이하가 통째로 사라지고 닫는 태그만 남아 한/글이 파일을 열지 못했습니다.
+  `insert_table_row` · `insert_table_column` 양쪽 해당.
+- **`copy_paragraph` 직후 텍스트를 교체하면 원본까지 바뀌던 문제.** 저장 파이프라인이
+  텍스트 갱신을 문단 복제보다 먼저 적용해, 복제 후 인덱스로 지정한 대상이 복제 전 XML 의
+  원본 문단으로 해석됐습니다. 복제·이동을 모든 텍스트 갱신 앞으로 옮겼습니다.
+  중간에 `save_document` 를 끼우던 우회가 더 이상 필요 없습니다.
+- **`create_document` · `save_document` 의 경로 무시.** 새 문서가 실제 위치 없이
+  `new-document.hwpx` 라는 상대 파일명을 들고 있어 저장이 서버 프로세스 cwd 로 갔습니다.
+  목적지가 없으면 조용히 cwd 로 가지 않고 명시적으로 실패합니다.
+- **병합으로 덮인 셀에 쓰면 성공이라 답하고 저장 시 사라지던 문제.** HWPX 는 덮인 위치에
+  `<hp:tc>` 를 두지 않아 직렬화 대상이 없습니다. 이제 어느 마스터 셀에 써야 하는지
+  알려주며 거부합니다.
+- **`get_tool_guide` 의 `topic` 이 무시되던 문제.** 모르는 값에 조용히 전체 참조를
+  반환하던 것을 가능한 값 목록을 담은 오류로 바꿨습니다.
+- **복제 문단·행·열의 `linesegarray` 미초기화.** 원본의 고정 줄 배치를 물려받아 긴 글을
+  넣으면 글자가 겹쳤습니다. `get_section_xml` → 문자열 치환 → `set_section_xml` 수작업이
+  필요 없어집니다.
+
+### Changed
+
+- **필수 인자 누락 시 원인을 밝힙니다.** `section_index` 를 빠뜨리면
+  `Failed to insert paragraph` 가 떠 문서 손상처럼 보였습니다. 스키마의 `required` 를
+  디스패처에서 검사해 어떤 인자가 빠졌는지 이름으로 답합니다.
+  예: `Missing required arguments for insert_paragraph: section_index, after_index`
+- **`save_document` 응답에 절대경로를 돌려줍니다.** `path` 와 `backup_path` 가 추가됐고,
+  `output_path` 외에 `file_path` 도 받습니다.
+- **`batch_fill_table` 이 실패한 셀을 보고하고 나머지를 계속 채웁니다.** 반환값에 `failed`
+  목록(좌표·값·이유)이 추가됐습니다. 이전에는 덮인 셀 하나가 배치 전체를 중단시켰습니다.
+
+### Added
+
+- **`create_document({file_path})`** — 목적지를 미리 지정하면 이후 `save_document` 가
+  인자 없이도 그 경로에 씁니다.
+- **`paraPrIDRef` · `charPrIDRef` 노출** — `get_paragraph` · `get_paragraphs` 가 스타일
+  값과 함께 원본 숫자 ID 를 돌려줍니다. XML 을 직접 조립할 때 `section0.xml` 을 정규식으로
+  파지 않아도 됩니다.
+
+### 알려진 제한
+
+- `updateTableCell` 은 셀마다 문서 전체를 직렬화해 undo 스택에 쌓습니다. 실측상 100×30 표
+  전수 쓰기 1,725ms 중 1,501ms(87%)가 여기서 발생합니다. 구조 변경이라 이 릴리스의 수정
+  범위에 포함하지 않았습니다.
+
+## [0.3.1] - 2026-09-08
+
+- 저장 임시 파일·백업 경로의 링크 공격 방어 및 실패 시 원본 보존
+- 여러 `hp:t`에 분리된 텍스트의 저장 누락 수정 및 특수문자 보존
+- 개인 Windows 문서에 의존하던 테스트를 합성 HWPX 회귀 테스트로 교체
+- 의존성 갱신 및 기존 절대·상대경로 사용법의 호환성 검사 추가
+- 작업 폴더 제한은 추가하지 않았으며, 수식 저장 누락은 이 릴리스의 수정 범위에 포함하지 않음
+
+## 0.3.0 - 2026-01-28
+
+- **대규모 XML persistence 수정**: 8개 조작에 대한 save-reload 지원 추가
+  - `insertTableRow` / `deleteTableRow`
+  - `insertTableColumn` / `deleteTableColumn`
+  - `copyParagraph` / `moveParagraph` (+ 같은 섹션 인덱스 버그 수정)
+  - `setHeader` / `setFooter`
+- **depth-aware element indexing**: 중첩 태그 내부 요소를 무시하는 안전한 파싱
+- **undo/redo 안전성**: pending 배열 초기화로 메모리/XML 비동기화 방지
+- **replaceText 수정**: XML entity 불일치 해결
+- **mergeCells 수정**: indexOf 모호성 해결
+- **테스트**: 24개 E2E 테스트 (16 기본 + 8 persistence)
+
+## 0.2.0
+
+- **신규 기능**: 테이블 셀 내 내어쓰기(Hanging Indent) 자동 적용
+  - `update_table_cell` 시 마커(○, 1., 가., (1) 등) 감지하여 자동 내어쓰기
+  - 멀티라인 텍스트의 각 줄에 독립적으로 내어쓰기 적용
+  - `set_table_cell_hanging_indent`, `get_table_cell_hanging_indent` 도구 추가
+- **버그 수정**: 병렬 테이블 업데이트 시 XML 손상 문제 해결
+  - 문서별 Lock 추가로 병렬 요청 직렬화 (race condition 방지)
+  - `findTableCellInXml()` 중첩 테이블 처리 개선 (balanced bracket 매칭)
+  - 여러 테이블 동시 수정 후 저장 시 "Broken tag structure" 오류 수정
+- **버그 수정**: 여러 테이블에 내어쓰기 적용 시 stale position 문제 해결
+  - 테이블 인덱스 내림차순 처리로 위치 변경 영향 방지
+  - 각 테이블 처리 시 위치 정보 재계산
+- **테스트 강화**: Red Team 스트레스 테스트 추가 (238개 테스트)
+  - 50~200개 테이블 대량 수정 테스트
+  - 중첩 테이블 + 내어쓰기 + 이미지 복합 테스트
+  - 병렬 업데이트 시나리오 테스트
+
+## 0.1.1
+
+- **버그 수정**: `update_table_cell` 후 `save_document` 시 빈 셀 변경사항이 저장되지 않던 문제 수정
+  - Self-closing XML run 태그 (`<hp:run ... />`) 처리 지원 추가
+  - ID 기반 테이블 매칭으로 정확한 XML 업데이트 구현
+  - 원본 XML 구조를 최대한 보존하면서 텍스트만 수정
+
+## 0.1.0
+
+- 최초 릴리스
+
+[0.3.3]: https://github.com/Dayoooun/hwpx-mcp/compare/v0.3.2...v0.3.3
+[0.3.2]: https://github.com/Dayoooun/hwpx-mcp/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/Dayoooun/hwpx-mcp/releases/tag/v0.3.1

package/README.md

@@ -1,11 +1,11 @@
-# HWPX MCP Server — `@dayoun/hwpx-mcp`
+# HWPX MCP Server — `@kimdayoun/hwpx-mcp`
 
-[![npm](https://img.shields.io/npm/v/@dayoun/hwpx-mcp)](https://www.npmjs.com/package/@dayoun/hwpx-mcp)
+[![npm](https://img.shields.io/npm/v/@kimdayoun/hwpx-mcp)](https://www.npmjs.com/package/@kimdayoun/hwpx-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io/)
 
 > **이 저장소가 원본입니다.** 정본: https://github.com/Dayoooun/hwpx-mcp
-> npm 배포본은 **`@dayoun/hwpx-mcp`** 하나뿐입니다.
+> npm 배포본은 **`@kimdayoun/hwpx-mcp`** 하나뿐입니다.
 > `hwpx-mcp`, `hwpx-mcp-server` 등 스코프 없는 동명 패키지는 이 프로젝트와 무관한 제3자 배포본입니다.
 
 HWP/HWPX 문서를 AI로 읽고 편집할 수 있는 Model Context Protocol (MCP) 서버입니다.
@@ -21,13 +21,13 @@ HWP/HWPX 문서를 AI로 읽고 편집할 수 있는 Model Context Protocol (MCP
 ## 설치
 
 ```bash
-npm install -g @dayoun/hwpx-mcp
+npm install -g @kimdayoun/hwpx-mcp
 ```
 
 설치 없이 바로 실행하려면:
 
 ```bash
-npx -y @dayoun/hwpx-mcp
+npx -y @kimdayoun/hwpx-mcp
 ```
 
 소스에서 빌드하려면:
@@ -50,7 +50,7 @@ npm run build
   "mcpServers": {
     "hwpx-mcp": {
       "command": "npx",
-      "args": ["-y", "@dayoun/hwpx-mcp"]
+      "args": ["-y", "@kimdayoun/hwpx-mcp"]
     }
   }
 }
@@ -66,7 +66,7 @@ npm run build
   "mcpServers": {
     "hwpx-mcp": {
       "command": "npx",
-      "args": ["-y", "@dayoun/hwpx-mcp"]
+      "args": ["-y", "@kimdayoun/hwpx-mcp"]
     }
   }
 }
@@ -79,8 +79,8 @@ npm run build
 |------|------|
 | `get_tool_guide` | 도구 가이드 조회 |
 | `open_document` | 문서 열기 (HWPX/HWP) |
-| `create_document` | 새 HWPX 문서 생성 |
-| `save_document` | 문서 저장 |
+| `create_document` | 새 HWPX 문서 생성. `file_path`를 주면 이후 `save_document`가 그 경로에 씁니다 |
+| `save_document` | 문서 저장. `output_path`(또는 `file_path`)로 대상 지정, 응답에 절대경로 반환 |
 | `close_document` | 문서 닫기 |
 | `list_open_documents` | 열린 문서 목록 |
 | `get_document_metadata` | 메타데이터 조회 |
@@ -301,55 +301,26 @@ AI 동작:
 ```bash
 cd mcp-server
 npm test                    # vitest 단위 테스트
+npm run test:security       # 빌드 후 실제 MCP 저장 경로 공격·반복 저장·실패 정리 검사
 node test-mcp-e2e.mjs       # 16개 기본 E2E 테스트
 node test-new-persistence-e2e.mjs  # 8개 persistence E2E 테스트
 ```
 
+문단 저장 회귀 테스트는 개인 PC의 문서 경로 대신 합성 HWPX를 사용합니다.
+여러 `hp:t`로 나뉜 텍스트·빈 문자열·XML 특수문자·동일한 문단 ID/본문의 대상 선택을 검사하며,
+중첩 표 삭제는 최상위 표 목록과 셀 내부 중첩 표의 보존을 각각 확인합니다.
+
 ## 알려진 제한사항
 
 - **각주/미주/북마크/하이퍼링크 삽입**: 메모리에서만 동작, save 후 XML 미반영 (읽기는 정상)
 - **HWP 파일**: 읽기 전용 (편집 불가)
 - **secPr 문단 스타일**: 첫 번째 특수 문단에서 스타일 reload 제한
+- **파일 접근 범위**: 현재 서버는 작업 폴더 밖의 절대경로·상위경로·디렉터리 심볼릭 링크를 차단하지 않습니다. 신뢰하는 로컬 MCP 클라이언트에서만 사용하고, OS 권한 또는 컨테이너로 접근 범위를 제한하세요. `stdio` 실행을 네트워크 인증·격리로 간주하면 안 됩니다.
+- **저장 안전성**: `save_document`는 목적지와 같은 디렉터리 안에 비공개 임시 디렉터리를 만들고 검증 후 rename합니다. 기존 `.tmp` 파일은 사용하지 않으며, `.bak`이 심볼릭 링크 등 일반 파일이 아니면 저장을 거부합니다. 이 조치는 작업 폴더 밖 접근 제한을 대신하지 않습니다.
 
 ## 변경 이력
 
-### 0.3.0 (2026-01-28)
-- **대규모 XML persistence 수정**: 8개 조작에 대한 save-reload 지원 추가
-  - `insertTableRow` / `deleteTableRow`
-  - `insertTableColumn` / `deleteTableColumn`
-  - `copyParagraph` / `moveParagraph` (+ 같은 섹션 인덱스 버그 수정)
-  - `setHeader` / `setFooter`
-- **depth-aware element indexing**: 중첩 태그 내부 요소를 무시하는 안전한 파싱
-- **undo/redo 안전성**: pending 배열 초기화로 메모리/XML 비동기화 방지
-- **replaceText 수정**: XML entity 불일치 해결
-- **mergeCells 수정**: indexOf 모호성 해결
-- **테스트**: 24개 E2E 테스트 (16 기본 + 8 persistence)
-
-### 0.2.0
-- **신규 기능**: 테이블 셀 내 내어쓰기(Hanging Indent) 자동 적용
-  - `update_table_cell` 시 마커(○, 1., 가., (1) 등) 감지하여 자동 내어쓰기
-  - 멀티라인 텍스트의 각 줄에 독립적으로 내어쓰기 적용
-  - `set_table_cell_hanging_indent`, `get_table_cell_hanging_indent` 도구 추가
-- **버그 수정**: 병렬 테이블 업데이트 시 XML 손상 문제 해결
-  - 문서별 Lock 추가로 병렬 요청 직렬화 (race condition 방지)
-  - `findTableCellInXml()` 중첩 테이블 처리 개선 (balanced bracket 매칭)
-  - 여러 테이블 동시 수정 후 저장 시 "Broken tag structure" 오류 수정
-- **버그 수정**: 여러 테이블에 내어쓰기 적용 시 stale position 문제 해결
-  - 테이블 인덱스 내림차순 처리로 위치 변경 영향 방지
-  - 각 테이블 처리 시 위치 정보 재계산
-- **테스트 강화**: Red Team 스트레스 테스트 추가 (238개 테스트)
-  - 50~200개 테이블 대량 수정 테스트
-  - 중첩 테이블 + 내어쓰기 + 이미지 복합 테스트
-  - 병렬 업데이트 시나리오 테스트
-
-### 0.1.1
-- **버그 수정**: `update_table_cell` 후 `save_document` 시 빈 셀 변경사항이 저장되지 않던 문제 수정
-  - Self-closing XML run 태그 (`<hp:run ... />`) 처리 지원 추가
-  - ID 기반 테이블 매칭으로 정확한 XML 업데이트 구현
-  - 원본 XML 구조를 최대한 보존하면서 텍스트만 수정
-
-### 0.1.0
-- 최초 릴리스
+버전별 변경 사항은 [CHANGELOG.md](./CHANGELOG.md) 를 참고하세요.
 
 ## 라이선스
 

package/dist/HangingIndentCalculator.js

@@ -13,175 +13,143 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HangingIndentCalculator = void 0;
 /**
- * 문자 너비 테이블 (em 단위, 기준 폰트 기준)
- * 실제 한글 문서에서 자주 사용되는 마커 문자들의 상대적 너비
+ * 문자 너비 테이블 (em 단위).
  *
- * 한글 폰트(함초롬바탕, 맑은 고딕 등)에서 측정된 값 기준
+ * 값은 Windows 한/글이 함초롬바탕 10pt 로 그린 PDF 에서 **글자 전진폭**
+ * (다음 글자 x − 이 글자 x) 을 잰 것이다. 추정치가 아니다.
+ * 측정 원본: src/fixtures/hancom-marker-widths.json
+ *
+ * 이전 표는 전각 1.0em·공백 0.5em 에 폰트 보정 1.25 를 곱해, 한/글보다
+ * 평균 4.14pt(최대 6.30pt) 넓게 계산했다. 한/글은 전각 기호를 0.996em,
+ * 공백을 0.498em 로 그리므로 보정 계수는 1.0 이 맞다.
+ *
+ * 표에 없는 글자는 getCharWidth 의 범주별 기본값을 쓴다.
  */
 const CHAR_WIDTH_TABLE = {
-    // 불릿 문자 (전각 = 1em)
-    '○': 1.0,
-    '●': 1.0,
-    '•': 0.6, // 중간 불릿
-    '▪': 0.6,
-    '◆': 1.0,
-    '◇': 1.0,
-    '■': 1.0,
-    '□': 1.0,
-    '※': 1.0,
-    '★': 1.0,
-    '☆': 1.0,
-    '◎': 1.0, // 이중 원
-    '◉': 1.0,
-    '▶': 1.0, // 화살표
-    '▷': 1.0,
-    '►': 1.0,
-    '▻': 0.6,
-    '▸': 0.6, // 작은 화살표
-    '▹': 0.6,
-    '➢': 1.0,
-    '➣': 1.0,
-    '➤': 1.0,
-    '✓': 0.7, // 체크마크
-    '✔': 0.7,
-    '✗': 0.7,
-    '✘': 0.7,
-    '✦': 0.7, // 별
-    '✧': 0.7,
-    '→': 1.0, // 화살표
-    '⇒': 1.0,
-    '▣': 1.0, // 박스
-    '▤': 1.0,
-    '▥': 1.0,
-    // 대시/하이픈
-    '-': 0.5,
-    '–': 0.7, // en-dash
-    '—': 1.0, // em-dash
-    // 숫자 (반각이지만 한글 폰트에서는 조금 넓음)
-    '0': 0.6,
-    '1': 0.6,
-    '2': 0.6,
-    '3': 0.6,
-    '4': 0.6,
-    '5': 0.6,
-    '6': 0.6,
-    '7': 0.6,
-    '8': 0.6,
-    '9': 0.6,
-    // 구두점 (한글 폰트에서 조금 넓음)
-    '.': 0.35,
-    ')': 0.4,
-    '(': 0.4,
-    // 공백 (한글 폰트에서 더 넓음)
-    ' ': 0.5,
-    // 한글 자모/글자 (전각)
-    '가': 1.0,
-    '나': 1.0,
-    '다': 1.0,
-    '라': 1.0,
-    '마': 1.0,
-    '바': 1.0,
-    '사': 1.0,
-    '아': 1.0,
-    '자': 1.0,
-    '차': 1.0,
-    '카': 1.0,
-    '타': 1.0,
-    '파': 1.0,
-    '하': 1.0,
-    // 원문자 (전각)
-    '①': 1.0,
-    '②': 1.0,
-    '③': 1.0,
-    '④': 1.0,
-    '⑤': 1.0,
-    '⑥': 1.0,
-    '⑦': 1.0,
-    '⑧': 1.0,
-    '⑨': 1.0,
-    '⑩': 1.0,
-    '⑪': 1.0,
-    '⑫': 1.0,
-    '⑬': 1.0,
-    '⑭': 1.0,
-    '⑮': 1.0,
-    '⑯': 1.0,
-    '⑰': 1.0,
-    '⑱': 1.0,
-    '⑲': 1.0,
-    '⑳': 1.0,
-    // 로마 숫자/알파벳 대문자 (반각이지만 한글 폰트에서 조금 넓음)
-    'I': 0.4,
-    'V': 0.7,
-    'X': 0.7,
+    // 전각 기호 (실측 0.996em: ○ ● □ ■ ▶ ①)
+    '○': 0.996,
+    '●': 0.996,
+    '◆': 0.996,
+    '◇': 0.996,
+    '■': 0.996,
+    '□': 0.996,
+    '★': 0.996,
+    '☆': 0.996,
+    '◎': 0.996,
+    '◉': 0.996,
+    '▶': 0.996,
+    '▷': 0.996,
+    '►': 0.996,
+    '➢': 0.996,
+    '➣': 0.996,
+    '➤': 0.996,
+    '→': 0.996,
+    '⇒': 0.996,
+    '▣': 0.996,
+    '▤': 0.996,
+    '▥': 0.996,
+    // 폭이 좁은 기호 (실측: ※ 0.756, • 0.456)
+    '※': 0.756,
+    '•': 0.456,
+    '▪': 0.456,
+    '▻': 0.456,
+    '▸': 0.456,
+    '▹': 0.456,
+    // 체크·별 기호 (실측 ✓ 0.996)
+    '✓': 0.996,
+    '✔': 0.996,
+    '✗': 0.996,
+    '✘': 0.996,
+    '✦': 0.996,
+    '✧': 0.996,
+    // 대시 (실측 - 0.834, — 0.852)
+    '-': 0.834,
+    '–': 0.834,
+    '—': 0.852,
+    // 숫자 (실측 1 0.576, 0 0.588)
+    '0': 0.588,
+    '1': 0.576,
+    '2': 0.588,
+    '3': 0.588,
+    '4': 0.588,
+    '5': 0.588,
+    '6': 0.588,
+    '7': 0.588,
+    '8': 0.588,
+    '9': 0.588,
+    // 구두점·공백 (실측 . 0.294, ( 0.498, ) 0.504, 공백 0.498)
+    '.': 0.294,
+    ')': 0.504,
+    '(': 0.498,
+    ':': 0.294,
+    ' ': 0.498,
+    // 알파벳 (실측 A 0.744, B 0.66, I 0.372, a 0.492)
+    'I': 0.372,
+    'V': 0.744,
+    'X': 0.744,
     'L': 0.6,
-    'C': 0.7,
-    'D': 0.7,
+    'C': 0.744,
+    'D': 0.744,
     'M': 0.9,
-    'A': 0.7,
-    'B': 0.7,
-    'E': 0.6,
+    'A': 0.744,
+    'B': 0.66,
+    'E': 0.66,
     'F': 0.6,
-    'G': 0.7,
-    'H': 0.7,
-    // 알파벳 소문자 (반각)
-    'a': 0.55,
-    'b': 0.55,
-    'c': 0.55,
-    'd': 0.55,
-    'e': 0.55,
+    'G': 0.744,
+    'H': 0.744,
+    'a': 0.492,
+    'b': 0.492,
+    'c': 0.492,
+    'd': 0.492,
+    'e': 0.492,
     'f': 0.35,
-    'g': 0.55,
-    'h': 0.55,
-    // 콜론 (마커 뒤에 올 수 있음)
-    ':': 0.35,
-    // 법률/공문서 한글 문자
-    '제': 1.0,
-    '조': 1.0,
-    '항': 1.0,
-    '호': 1.0,
-    '목': 1.0,
-    '의': 1.0,
+    'g': 0.492,
+    'h': 0.492,
 };
+/** 한글 음절 전진폭 (실측 가·본 0.972em). */
+const HANGUL_SYLLABLE_WIDTH = 0.972;
+/** 원문자·전각 기호 기본 전진폭 (실측 ① 0.996em). */
+const FULL_WIDTH_SYMBOL = 0.996;
 /**
- * @deprecated Use getFontFactor(fontName) instead
- * 기본 한글 폰트 보정 계수 (하위 호환성 유지)
- */
-const HANGUL_FONT_FACTOR = 1.3;
-/**
- * 폰트별 보정 계수 테이블
- * 실측 기반 값 (한글에서 실제 렌더링 너비 / em 값)
+ * 폰트별 보정 계수 — CHAR_WIDTH_TABLE(함초롬바탕 실측) 대비 배율.
+ *
+ * 함초롬 계열만 한/글에서 실측했다(1.0). 나머지는 측정하지 않았으므로
+ * 종전 표가 함초롬(1.25) 대비 두던 **상대 비율**만 옮겼다
+ * (예: 맑은 고딕 1.35/1.25 = 1.08). 새 폰트를 쓰는 양식이 생기면
+ * scripts 쪽 측정 문서로 다시 재서 이 값을 교체한다.
  */
 const FONT_FACTOR_TABLE = {
-    // 기본값
-    'default': 1.3,
-    // 한컴 폰트
-    '함초롬바탕': 1.25,
-    '함초롬돋움': 1.25,
-    '한컴바탕': 1.3,
-    '한컴돋움': 1.3,
-    // 마이크로소프트 폰트
-    '맑은 고딕': 1.35,
-    '맑은고딕': 1.35,
-    'Malgun Gothic': 1.35,
-    '바탕': 1.3,
-    '돋움': 1.3,
-    '굴림': 1.3,
-    '궁서': 1.35,
-    // 나눔 폰트
-    '나눔고딕': 1.3,
-    '나눔명조': 1.3,
-    'NanumGothic': 1.3,
-    'NanumMyeongjo': 1.3,
-    '나눔바른고딕': 1.28,
-    // Adobe 폰트
-    '본고딕': 1.25,
-    '본명조': 1.25,
-    'Noto Sans KR': 1.25,
-    'Noto Serif KR': 1.25,
-    // 영문 폰트 (한글이 없는 경우)
-    'Arial': 1.0,
-    'Times New Roman': 1.0,
+    // 기본값 — 한/글 새 문서 기본 글꼴이 함초롬바탕이다
+    'default': 1.0,
+    // 한컴 폰트 (실측)
+    '함초롬바탕': 1.0,
+    '함초롬돋움': 1.0,
+    'HCR Batang': 1.0,
+    'HCR Dotum': 1.0,
+    '한컴바탕': 1.04,
+    '한컴돋움': 1.04,
+    // 마이크로소프트 폰트 (미측정, 종전 상대비)
+    '맑은 고딕': 1.08,
+    '맑은고딕': 1.08,
+    'Malgun Gothic': 1.08,
+    '바탕': 1.04,
+    '돋움': 1.04,
+    '굴림': 1.04,
+    '궁서': 1.08,
+    // 나눔 폰트 (미측정, 종전 상대비)
+    '나눔고딕': 1.04,
+    '나눔명조': 1.04,
+    'NanumGothic': 1.04,
+    'NanumMyeongjo': 1.04,
+    '나눔바른고딕': 1.024,
+    // Adobe 폰트 (미측정, 종전 상대비)
+    '본고딕': 1.0,
+    '본명조': 1.0,
+    'Noto Sans KR': 1.0,
+    'Noto Serif KR': 1.0,
+    // 영문 폰트 (미측정, 종전 상대비)
+    'Arial': 0.8,
+    'Times New Roman': 0.8,
 };
 /**
  * 폰트 보정 계수 가져오기
@@ -247,17 +215,19 @@ class HangingIndentCalculator {
         if (CHAR_WIDTH_TABLE[char] !== undefined) {
             return CHAR_WIDTH_TABLE[char];
         }
-        // 한글 범위 (가-힣) 체크 - 전각으로 처리
+        // 한글 음절 (가-힣)
         if (/[가-힣]/.test(char)) {
-            return 1.0;
+            return HANGUL_SYLLABLE_WIDTH;
         }
-        // 전각 문자 범위 체크
-        const code = char.charCodeAt(0);
-        if (code >= 0xFF00 && code <= 0xFFEF) {
-            return 1.0; // 전각 문자
+        const code = char.codePointAt(0) ?? 0;
+        // 원문자 ①–⑳ 등 Enclosed Alphanumerics, 도형 기호 블록, 전각 형태
+        if ((code >= 0x2460 && code <= 0x24FF) ||
+            (code >= 0x25A0 && code <= 0x25FF) ||
+            (code >= 0xFF00 && code <= 0xFFEF)) {
+            return FULL_WIDTH_SYMBOL;
         }
-        // 기본값: 반각 문자로 가정
-        return 0.55;
+        // 표에 없는 반각 문자 — 실측한 소문자 폭을 쓴다
+        return 0.492;
     }
     /**
      * 마커 문자열의 너비를 em 단위로 계산