@kimdayoun/hwpx-mcp 0.3.0 → 0.3.4

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 단위로 계산