kordoc 4.14.2 → 4.14.4

package/README.md

@@ -84,18 +84,42 @@ MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
 *   **✏️ 양식 자동 채우기**: 공문서 양식 템플릿(신청서, 보고서)에 값을 넣으면 자동으로 빈칸을 채웁니다. 원본 서식(글꼴, 크기, 정렬)을 100% 보존합니다.
 *   **👓 내장 OCR — API 키 없이 (v4.2)**: 스캔본·이미지 PDF와 PNG/JPG/WebP 이미지를 **로컬 CPU 추론**(PP-OCRv5 korean)으로 읽습니다. 외부 서비스도 API 키도 없이, 텍스트층이 깨진 페이지만 골라 OCR 하고, 래스터 괘선까지 찾아 스캔본에서도 표를 복원합니다.
 *   **📑 RAG·인용 대응 (v4.1~4.8)**: 헤딩·개조식 위계를 breadcrumb으로 보존한 구조 청크(`--format chunks`)와, 조판 캐시로 복원한 **실제 쪽 번호** 기준 페이지별 마크다운(`pages`)을 냅니다 — 답변에 "몇 쪽" 각주를 붙일 수 있습니다.
-*   **🕶️ 개인정보 마스킹 (v4.1)**: 주민번호·전화·이메일·카드·계좌를 탐지해 **원본 서식 그대로** 가린 문서를 냅니다 (`kordoc redact`). 자동 검출 보조 도구이므로 공개 전 사람 확인은 필수입니다.
+*   **🕶️ 개인정보 마스킹 (v4.1)**: 주민·외국인등록번호·전화·이메일·카드·계좌·사업자등록번호·여권·운전면허(v4.14.4 부터 opt-in 으로 이름·주소)를 탐지해 **원본 서식 그대로** 가린 HWPX/HWP를 냅니다 (`kordoc redact`). 본문·표·머리말/꼬리말·각주·글상자·필드·미리보기(텍스트·이미지)·문서 정보(제목·작성자)까지 가리고, 결과 파일을 다시 훑어 남은 개인정보가 있으면 실패(exit 2)로 알립니다. **PDF·DOCX·XLSX 등은 원본 파일을 고치지 않고 마스킹된 마크다운만** 냅니다 — PDF 자체의 가림(redaction)은 지원하지 않습니다. 이미지 속 글자와 문맥 없는 맨이름은 탐지하지 못하는 자동 검출 보조 도구이므로 공개 전 사람 확인은 필수입니다.
 *   **🤖 AI 에이전트 연동 (MCP)**: `Claude Desktop`, `Cursor`, `Codex`와 같은 도구에서 직접 `kordoc`을 호출해 문서를 읽고 코딩할 수 있습니다.
 
 ---
 
+## v4.14.4 변경사항
+
+읽기 품질을 한 번 더 점검했습니다. 원본 HWPX 를 정답으로 PDF 글을 재는 벤치를 새로 세워 띄어쓰기·읽기 순서까지 보고, PDF 표·OCR·개인정보 마스킹을 고쳤습니다.
+
+- **📊 PDF 표**: 쪽을 넘는 표의 쪼개진 행과 반복 머리 행, 쪽을 넘는 한 칸, 표 위에 걸친 그림·글상자, 셀 간격 표를 바로잡았습니다. hwpx↔pdf 430쌍 1,784표 정확 일치 90.1% → 92.9%, 표 안의 표 63.7% → 72.0%. 텍스트층이 있는 417쌍만 보면 94.5%, 칸 글이 제자리에 있는 비율 0.768 → 0.903.
+- **✍️ PDF 띄어쓰기·줄 이음**: 본문을 시각 줄이 아니라 문단으로 복원합니다. 한글이 글자 단위로 줄바꿈된 문서에서 "재 일학도의용군인"·"또 는" 처럼 낱말 중간에 공백이 들어가던 것을 조사·어미·문서 안 어휘로 판정해 붙입니다. 어절 F1 0.925 → 0.971.
+- **🧮 한컴 밖에서 만든 PDF**: 예산서처럼 글자마다 떨어져 찍힌 숫자("2 0 , 7 7 5" → "20,775"), 행마다 끊어 그은 괘선, 빈칸 위에 따로 얹은 숫자를 바로잡았습니다. PDF 글자 커버리지 0.99569 → 0.99760.
+- **🔎 글자를 곡선으로 그린 PDF**: 한글을 글꼴 대신 곡선으로 그린 쪽은 텍스트층에 한글이 없어 종전엔 경고 없이 한글이 빠졌습니다. 이런 쪽을 찾아(`ocrReason: "vector_text"`) OCR 을 켜면 읽고, 끄면 경고합니다. 표는 그 쪽의 실제 괘선으로 복원합니다.
+- **👓 OCR**: 점선 괘선·색 칸 경계·목차 리더 점·숫자 앞 △ 를 바로잡았습니다. 글자 오류율 0.171 → 0.096(정답지인 텍스트층 수정분 포함), OCR 표 셀 F1 0.440 → 0.618.
+- **🕶️ 개인정보 마스킹 인명·주소** (opt-in, `--rules …,name,address`): 역할어·호칭·라벨·표 머리글 문맥으로 이름을, 도로명·지번 문법으로 주소를 찾아 가립니다(주소는 시·군·구까지 남김). 외부 정답(473문장) 인명 354/411·주소 141/141, 실문서 표본 오탐 0. 공무원 결재란 이름은 정보공개 관행상 공개 대상이라 기본값에는 넣지 않았습니다.
+
+## v4.14.3 변경사항
+
+읽기 품질을 전면 점검했습니다. 코퍼스를 넓히고(rhwp 표본 1,351파일·정책브리핑 hwpx+pdf 짝 200쌍) 포맷마다 정답지 벤치를 다시 세운 뒤 표·PDF·OCR·개인정보 마스킹을 고쳤고, 검색 색인처럼 글자만 필요한 호출자를 위한 두 가지를 더했습니다.
+
+- **📊 PDF 표 복원**: 쪽을 넘는 표를 잇고, 표 안의 표를 틀 칸 안에 넣습니다. hwpx↔pdf 430쌍 1,784표 정확 일치 64.1% → 90.1%, 셀 F1 0.790 → 0.945.
+- **🧾 HWP·HWP3·HWPX 표와 주석**: HWP 표를 HWPX 와 같은 규칙으로 배치해 hwp↔hwpx 쌍 3,593표가 모두 정확히 일치합니다(0.824 → 1). HWP3 표 격자를 복원하고, HWPX 각주·미주 번호와 문서 정보(제목·지은이 등)를 읽습니다.
+- **👓 OCR**: 기울기를 보정하고 세로로 이어진 글 상자를 나눠 읽으며 공문서 기호(○·△·따옴표)를 되살립니다. 글자 오류율 0.201 → 0.171, 3° 기울어진 스캔 57.6% → 22.0%.
+- **🕶️ 개인정보 마스킹**: 파일 안 모든 글자 저장소(머리말·각주·글상자·필드·미리보기·문서 정보 등)를 같은 길이로 가리고 결과를 다시 훑습니다. 5,081문서 오탐 387 → 0.
+- **💲 본문의 `$` 가 수식이 되지 않습니다**: 한글 문서(HWPX·HWP·HWP3)의 리터럴 `$` 는 `\$` 로 내고 `$…$` 는 수식에만 씁니다. "echo $HOME $PATH" 같은 글이 마크다운 렌더러에서 수식으로 바뀌던 것. 역슬래시 뒤 구두점("C:\.Pls")에서 역슬래시가 사라지던 것도 고쳤습니다.
+- **📝 미기입 누름틀 안내문을 빼고 읽습니다**: 한컴이 화면에만 흐리게 보이고 인쇄하지 않는 HWPX 안내문을 마크다운에서 뺍니다(블록 글에는 남김). 누름틀을 채우면 수정 표시를 켭니다.
+- **🖼️ 이미지 끄기** (`images: false` / `--no-images`): 결과에 이미지 바이트를 싣지 않습니다. 그림 자리 표시(`![image](…)`)와 본문 글자는 그대로라 그림 위치는 알 수 있습니다. PDF 는 PNG 인코딩을 건너뜁니다. 그림 많은 PDF 실측: JSON 출력 200MB → 9.5MB, CPU 시간 30% 감소.
+- **🚀 상주 파싱 워커** (`kordoc parse-worker`): 프로세스를 띄워 둔 채 stdin 요청 한 줄마다 한 줄 JSON 을 돌려줍니다. 파일마다 node 를 새로 띄우지 않아 대량 색인에 알맞습니다. 응답에 메모리 사용량(`rss`)을 실어 호스트가 워커 교체 시점을 정할 수 있습니다.
+
 ## v4.14.2 변경사항
 
 공문서 출력을 한글 2024 실렌더 PDF로 다시 대조해 "진짜 공문처럼" 다듬었습니다.
 
 - **📐 항목 둘째 줄이 첫 줄 내용과 정확히 맞습니다**: 부호(□ ○ - ※ 1. 가.) 뒤를 공백이 아니라 탭으로 두고, 한글의 "내어쓰기용 자동 탭"을 씁니다. 양쪽 정렬이 부호 뒤 공백을 늘려 첫 줄 내용이 밀리던 것, 자간을 줄인 줄에서 내용이 당겨지던 것이 구조적으로 없어졌습니다. 기안문·보고서·계획서·통지·회의록·업무보고·개조식·보도자료 전부.
 - **✂️ 낱말이 줄 끝에서 쪼개지지 않습니다**: 본문을 어절 단위 줄바꿈으로 바꾸고("동대/문" → "동대문") 외톨이줄 보호를 켰습니다. 날짜·금액은 묶음 빈칸으로 묶어 "2026. 1. / 22." 처럼 갈라지지 않습니다. 곧은따옴표는 ‘ ’ “ ”로 바꿉니다.
-- **📏 한글 글꼴 실폭으로 조판을 재현합니다**: 한컴돋움·HY견고딕·휴먼명조 등 8종의 실제 글자 폭으로 줄바꿈을 계산해(한글 2024 PDF 154줄 전부 일치), 짧은 꼬리 줄은 자간으로 올리고 긴 어절이 넘어가 공백이 크게 벌어지는 줄은 자간을 살짝 줄여 메웁니다. 종전처럼 한 줄을 과하게 눌러 옆 줄과 밀도가 달라 보이는 일이 줄었습니다.
+- **📏 한글 글꼴 실폭으로 조판을 재현합니다**: 한컴돋움·HY견고딕·휴먼명조 등 8종의 실제 글자 폭으로 줄바꿈을 계산합니다(한글 2024 PDF 154줄 전부 일치). 마지막 줄이 짧으면(줄 폭 절반 이하) 자간·장평을 최대 15%까지 줄여 한 줄 올리고, 한 줄에 맞춘다는 판단엔 2% 여유를 둬 한글에서 넘치지 않게 했습니다. 공백 없는 긴 목록("구(강남·강서·…·종로)가")처럼 한 줄보다 긴 어절이 있는 문단은 그 문단만 글자 단위로 조판하되 가운뎃점·쉼표 뒤에서만 끊어, 앞 줄이 크게 벌어지지 않습니다.
 - **🧩 PPTX 감지** (#80, PR #81 @LimePencil): PPTX 를 넣으면 "HWPX 섹션 없음" 대신 지원하지 않는 형식이라고 알려 줍니다.
 - **🧹 기술부채**: 1,200줄 넘던 `mcp.ts`·`cli.ts`·`hwp5/parser.ts`·`svg-render.ts` 를 기능별 모듈로 나눴고, 파서가 묶음 빈칸을 버리던 것과 `kordoc render` 미리보기의 탭 폭·줄 끝 공백 정렬을 고쳤습니다.
 
@@ -898,6 +922,24 @@ CLI로도: `kordoc render 결재문서.hwpx -o 결재문서.svg` — 조판 캐
 reflow 조판되며 `--no-reflow`로 끌 수 있습니다 (`--highlight 예산,집행` 지원),
 연속 렌더는 `kordoc render-worker`(stdin NDJSON, 미리보기 앱 연동용)
 
+### 글자만 필요할 때 (이미지 끄기·상주 파싱 워커)
+
+```typescript
+const result = await parse(buffer, { images: false }) // 이미지 바이트 없이 (그림 자리 표시는 남김)
+```
+
+CLI 는 `kordoc 문서.pdf --format json --no-images`. 대량 변환은 `kordoc parse-worker` 를 띄워 두고
+stdin 으로 한 줄씩 요청합니다 (한 줄 = 한 JSON).
+
+```text
+시작  {"ready":true,"version":"4.14.4","protocol":1}
+요청  {"id":1,"file":"문서.hwpx","images":false,"ocr":"off"}
+응답  {"id":1,"rss":183500800,"result":{ …--format json 과 같은 결과, 실패도 success:false 로… }}
+종료  {"cmd":"quit"}  (또는 stdin 닫기)
+```
+
+`ocr` 은 `"off"`·`"auto"`(OCR 필요 페이지만)·`"force"`, 그 밖에 `formulaOcr`·`password` 를 받습니다.
+
 ### 페이지 범위 지정
 
 ```typescript
@@ -946,7 +988,7 @@ for (const p of r.pageQuality ?? []) {
 }
 ```
 
-신호 키: `textChars`, `hangulRatio`, `controlCharRatio`, `replacementCharRatio`, `puaRatio` / `needsOcr` (페이지·문서 단위) / `ocrReason` (`low_text` | `high_pua` | `high_control` | `high_replacement`).
+신호 키: `textChars`, `hangulRatio`, `controlCharRatio`, `replacementCharRatio`, `puaRatio` / `needsOcr` (페이지·문서 단위) / `ocrReason` (`low_text` | `high_pua` | `high_control` | `high_replacement` | `garbled_hangul` | `vector_text`). `vector_text` 는 글자를 곡선으로 그려 텍스트층에 글이 없는 쪽입니다(v4.14.4).
 
 ## CLI
 
@@ -973,8 +1015,11 @@ npx kordoc patch 원본.hwpx 편집.md -o 반영.hwpx      # 서식 보존 라
 npx kordoc seal 신청서.hwpx --image 도장.png --anchor "(인)" -o 날인.hwpx  # 도장/서명 날인
 npx kordoc validate 산출물.hwpx                      # HWPX 구조 검증 (ZIP·필수 파트·XML)
 npx kordoc lint 보고서.md                            # 공문서 표기법 검수 19룰 — 입력은 md/txt('-'=stdin), error 있으면 exit 1
-npx kordoc redact 민원서류.hwpx -o 마스킹.hwpx       # 개인정보 탐지 + 서식 보존 마스킹 (v4.1)
+npx kordoc redact 민원서류.hwpx -o 마스킹.hwpx       # 개인정보 탐지 + 서식 보존 마스킹 (머리말·각주·미리보기·문서 정보 포함, 잔존 재검사 — 남으면 exit 2)
 npx kordoc redact 민원서류.hwpx --mask-char '*' -o 마스킹.hwpx   # 마스크 문자 지정 (기본 ●)
+npx kordoc redact 계약서.hwp --rules rrn,phone,crn --json --dry-run  # 룰 선택(법인등록번호 crn·IP 는 opt-in) + 위치별 리포트만
+npx kordoc redact 민원서류.hwpx --rules rrn,phone,email,name,address -o 마스킹.hwpx  # 이름·주소까지 (opt-in)
+npx kordoc redact 공문.pdf                            # PDF·DOCX 등은 원본을 고치지 않고 마스킹된 마크다운(.redacted.md)만 — PDF 가림 미지원
 npx kordoc profile 기관서식.hwpx                     # 표 서식 프로필(JSON) 추출 → generate --profile 로 재현
 npx kordoc render 결재문서.hwpx -o 미리보기.svg      # 레이아웃 보존 SVG 렌더 (캐시 없는 문서는 자동 reflow 조판, --no-reflow로 끔)
 npx kordoc render 결재문서.hwpx --reflow-mode charAll -o 미리보기.svg  # reflow 줄바꿈: keep(어절, 기본) | charAll(글자)
@@ -1091,7 +1136,7 @@ codex mcp add kordoc -- npx -y kordoc mcp
 | `generate_document` | 마크다운(표·수식·차트 포함) → HWPX 생성, 공문서 프리셋 (v3.5) |
 | `place_seal` | 도장/서명 이미지를 앵커 문구 위에 부유 배치 (v3.16) |
 | `render_document` | HWPX·HWP를 조판 그대로 PNG/JPEG 이미지(응답)·SVG/HTML/PDF 파일로 렌더 — 생성·수정 결과를 AI가 눈으로 검증 (v4.1, HWP·포맷 확장 v4.13.1) |
-| `redact_document` | 개인정보(주민번호·전화·이메일·카드·계좌) 탐지 + 서식 보존 마스킹, 리포트 반환 (v4.1) |
+| `redact_document` | 개인정보(주민·외국인등록번호·전화·이메일·카드·계좌·사업자등록번호·여권·운전면허, opt-in 법인등록번호·IP·이름·주소) 탐지 + 서식 보존 마스킹 — HWPX/HWP는 머리말·각주·미리보기·문서 정보까지 가리고 잔존 재검사, 그 외 포맷은 마스킹된 마크다운만 (v4.1) |
 | `parse_chunks` | RAG용 구조 청크 JSON — 헤딩·개조식 위계 breadcrumb + 표 독립 청크 (v4.1) |
 | `crop_regions` | 렌더 영역(표·이미지·문단·도형)을 페이지 이미지에서 실배율로 잘라 저장 + regions.json (v4.13) |
 | `extract_tables` | 표 분류(데이터표/조직도류/불확실) + 페이지·bbox + 정책별 crop — 조직도는 이미지로, 데이터표는 구조로 (v4.13.1) |
@@ -1148,7 +1193,7 @@ PPTX는 감지만 지원합니다. `parse()`는 PPTX 입력에 `success: false`,
 | `placeSealHwpx(buffer, seals)` | 도장/서명 이미지를 앵커 문구 위에 부유 배치 (v3.16) |
 | `validateHwpx(buffer)` | HWPX 구조 검증 — ZIP·mimetype·필수 파트·XML 웰폼드 (v3.16) |
 | `lintGongmunText(text, { document? })` | 공문서 표기법 검수 19룰 + AI 슬롭 2룰 — 텍스트/마크다운 입력 (v4.0.1, v4.12.1 보강). `document: true` 면 붙임/"끝." 문서 단위 검사 포함 |
-| `redactMarkdown(text, options?)` / `redactText(...)` | 개인정보 탐지 + 마스킹 (기본 룰: 주민번호·전화·이메일·카드·계좌, v4.1) |
+| `redactMarkdown(text, options?)` / `redactText(...)` | 개인정보 탐지 + 마스킹 (기본 룰: 주민·외국인등록번호·전화·이메일·카드·계좌·사업자등록번호·여권·운전면허, opt-in: 법인등록번호·IP — 텍스트 단위, 파일 단위 마스킹은 CLI `redact`/MCP `redact_document`, v4.1) |
 | `blocksToChunks(blocks, options?)` | RAG용 구조 청크 — 헤딩·개조식 위계 breadcrumb + 표 독립 청크 (v4.1) |
 | `blocksToMarkdown(blocks)` | IRBlock[] → Markdown 문자열 |
 | `blocksToPages(blocks)` | IRBlock[] → `[{ pageNumber, markdown }]` 페이지별 마크다운 (v4.8) |

package/dist/{-AQKXLFIM.js → -Z4TJ3QGK.js}

@@ -51,22 +51,22 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-EISO3POT.js";
+} from "./chunk-XVXHXQIO.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-ZWOFQRIB.js";
+} from "./chunk-HIJUKZHM.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
   redactText
-} from "./chunk-DZIXKL7E.js";
+} from "./chunk-DPWWXUOG.js";
 import {
   blocksToChunks
-} from "./chunk-EDNJLUSE.js";
+} from "./chunk-VJIL6PIL.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -91,19 +91,20 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-TSFS5VKD.js";
+} from "./chunk-D4U2TXDC.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-7IAQ4HOK.js";
+import "./chunk-6BWU6SQX.js";
 import "./chunk-MOL7MDBG.js";
-import "./chunk-ILU76UF3.js";
+import "./chunk-YAKC46HZ.js";
 import {
   blocksToMarkdown,
+  flattenLayoutTables,
   hasStructuredCellContent
-} from "./chunk-QC5T6D4J.js";
-import "./chunk-C7FQBSON.js";
+} from "./chunk-NLU6LBLY.js";
+import "./chunk-V3DX4DUF.js";
 import {
   VERSION
-} from "./chunk-UET462HB.js";
+} from "./chunk-TITDJWVZ.js";
 export {
   BUILTIN_TEMPLATES,
   DEFAULT_REDACT_RULES,
@@ -140,6 +141,7 @@ export {
   fillHwpx,
   fillWithUniqueGuard,
   fitRatioForFewerLines,
+  flattenLayoutTables,
   formatFillValue,
   gongmunLintWarnings,
   hasStructuredCellContent,
@@ -192,4 +194,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-AQKXLFIM.js.map
+//# sourceMappingURL=-Z4TJ3QGK.js.map

package/dist/{chunk-QOMNEWCQ.cjs → chunk-5LAZQCUJ.cjs}

@@ -1,6 +1,237 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkHR2XNERBcjs = require('./chunk-HR2XNERB.cjs');
+var _chunkWJHAU73Bcjs = require('./chunk-WJHAU73B.cjs');
+
+// src/shared/symbol-fonts.ts
+var WINGDINGS = [
+  "\u{1F589}",
+  "\u2702",
+  "\u2701",
+  "\u{1F453}",
+  "\u{1F56D}",
+  "\u{1F56E}",
+  "\u{1F56F}",
+  "\u{1F57F}",
+  "\u2706",
+  "\u{1F582}",
+  "\u{1F583}",
+  "\u{1F4EA}",
+  "\u{1F4EB}",
+  "\u{1F4EC}",
+  "\u{1F4ED}",
+  "\u{1F4C1}",
+  "\u{1F4C2}",
+  "\u{1F4C4}",
+  "\u{1F5CF}",
+  "\u{1F5D0}",
+  "\u{1F5C4}",
+  "\u231B",
+  "\u{1F5AE}",
+  "\u{1F5B0}",
+  "\u{1F5B2}",
+  "\u{1F5B3}",
+  "\u{1F5B4}",
+  "\u{1F5AB}",
+  "\u{1F5AC}",
+  "\u2707",
+  "\u270D",
+  "\u{1F58E}",
+  "\u270C",
+  "\u{1F44C}",
+  "\u{1F44D}",
+  "\u{1F44E}",
+  "\u261C",
+  "\u261E",
+  "\u261D",
+  "\u261F",
+  "\u{1F590}",
+  "\u263A",
+  "\u{1F610}",
+  "\u2639",
+  "\u{1F4A3}",
+  "\u2620",
+  "\u{1F3F3}",
+  "\u{1F3F1}",
+  "\u2708",
+  "\u263C",
+  "\u{1F4A7}",
+  "\u2744",
+  "\u{1F546}",
+  "\u271E",
+  "\u{1F548}",
+  "\u2720",
+  "\u2721",
+  "\u262A",
+  "\u262F",
+  "\u0950",
+  "\u2638",
+  "\u2648",
+  "\u2649",
+  "\u264A",
+  "\u264B",
+  "\u264C",
+  "\u264D",
+  "\u264E",
+  "\u264F",
+  "\u2650",
+  "\u2651",
+  "\u2652",
+  "\u2653",
+  "\u{1F670}",
+  "\u{1F675}",
+  "\u25CF",
+  "\u25CB",
+  "\u25A0",
+  "\u25A1",
+  "\u25A1",
+  "\u2751",
+  "\u2752",
+  "\u2B27",
+  "\u29EB",
+  "\u25C6",
+  "\u2756",
+  "\u2B25",
+  "\u2327",
+  "\u2BB9",
+  "\u2318",
+  "\u{1F3F5}",
+  "\u{1F3F6}",
+  "\u{1F676}",
+  "\u{1F677}",
+  "",
+  "\u24EA",
+  "\u2460",
+  "\u2461",
+  "\u2462",
+  "\u2463",
+  "\u2464",
+  "\u2465",
+  "\u2466",
+  "\u2467",
+  "\u2468",
+  "\u2469",
+  "\u24FF",
+  "\u2776",
+  "\u2777",
+  "\u2778",
+  "\u2779",
+  "\u277A",
+  "\u277B",
+  "\u277C",
+  "\u277D",
+  "\u277E",
+  "\u277F",
+  "\u{1F662}",
+  "\u{1F660}",
+  "\u{1F661}",
+  "\u{1F663}",
+  "\u{1F65E}",
+  "\u{1F65C}",
+  "\u{1F65D}",
+  "\u{1F65F}",
+  "\xB7",
+  "\u2022",
+  "\u25AA",
+  "\u26AA",
+  "\u25CB",
+  "\u25EF",
+  "\u25C9",
+  "\u25CE",
+  "\u{1F53F}",
+  "\u25AA",
+  "\u25FB",
+  "\u{1F7C2}",
+  "\u2726",
+  "\u2605",
+  "\u2736",
+  "\u2734",
+  "\u2739",
+  "\u2735",
+  "\u2BD0",
+  "\u2316",
+  "\u27E1",
+  "\u2311",
+  "\u2BD1",
+  "\u272A",
+  "\u2730",
+  "\u{1F550}",
+  "\u{1F551}",
+  "\u{1F552}",
+  "\u{1F553}",
+  "\u{1F554}",
+  "\u{1F555}",
+  "\u{1F556}",
+  "\u{1F557}",
+  "\u{1F558}",
+  "\u{1F559}",
+  "\u{1F55A}",
+  "\u{1F55B}",
+  "\u2BB0",
+  "\u2BB1",
+  "\u2BB2",
+  "\u2BB3",
+  "\u2BB4",
+  "\u2BB5",
+  "\u2BB6",
+  "\u2BB7",
+  "\u{1F66A}",
+  "\u{1F66B}",
+  "\u{1F655}",
+  "\u{1F654}",
+  "\u{1F657}",
+  "\u{1F656}",
+  "\u{1F650}",
+  "\u{1F651}",
+  "\u{1F652}",
+  "\u{1F653}",
+  "\u232B",
+  "\u2326",
+  "\u2B98",
+  "\u2B9A",
+  "\u2B99",
+  "\u2B9B",
+  "\u2B88",
+  "\u2B8A",
+  "\u2B89",
+  "\u2B8B",
+  "\u2190",
+  "\u2192",
+  "\u2191",
+  "\u2193",
+  "\u2196",
+  "\u2197",
+  "\u2199",
+  "\u2198",
+  "\u2B05",
+  "\u2794",
+  "\u2B06",
+  "\u2B07",
+  "\u2B09",
+  "\u2B08",
+  "\u2B0B",
+  "\u2B0A",
+  "\u21E6",
+  "\u21E8",
+  "\u21E7",
+  "\u21E9",
+  "\u2B04",
+  "\u21F3",
+  "\u2B00",
+  "\u2B01",
+  "\u2B03",
+  "\u2B02",
+  "\u{1F8AC}",
+  "\u{1F8AD}",
+  "\u2717",
+  "\u2714",
+  "\u2612",
+  "\u2611",
+  ""
+];
+function wingdingsChar(code) {
+  if (code < 33 || code > 255) return void 0;
+  return WINGDINGS[code - 33] || void 0;
+}
 
 // src/shared/pua.ts
 var BMP_SYMBOL_MAP = {
@@ -188,7 +419,7 @@ var BOXED_NUMBER_START = 983729;
 var BOXED_NUMBER_END = 983748;
 function mapPuaChar(code) {
   if (code >= 61472 && code <= 61695) {
-    return BMP_SYMBOL_MAP[code - 61440];
+    return _nullishCoalesce(BMP_SYMBOL_MAP[code - 61440], () => ( wingdingsChar(code - 61440)));
   }
   if (code >= BOXED_NUMBER_START && code <= BOXED_NUMBER_END) {
     return String.fromCodePoint(9312 + (code - BOXED_NUMBER_START));
@@ -264,32 +495,54 @@ function buildTable(rows, options) {
 }
 function buildTableDirect(rows, numRows, options) {
   let maxCols = 0;
+  const rowCap = Math.min(MAX_ROWS, numRows + rows.reduce((n, r) => n + r.length, 0) + 1);
   for (const row of rows) {
     for (const cell of row) {
       const end = (_nullishCoalesce(cell.colAddr, () => ( 0))) + cell.colSpan;
       if (end > maxCols) maxCols = end;
+      if (cell.rowAddr !== void 0 && cell.rowAddr >= numRows) numRows = Math.min(cell.rowAddr + 1, rowCap);
     }
   }
   if (maxCols > MAX_COLS) maxCols = MAX_COLS;
-  if (maxCols === 0) return { rows: 0, cols: 0, cells: [], hasHeader: false };
+  if (maxCols === 0 || numRows === 0) return { rows: 0, cols: 0, cells: [], hasHeader: false };
   const grid = Array.from(
     { length: numRows },
     () => Array.from({ length: maxCols }, () => ({ text: "", colSpan: 1, rowSpan: 1 }))
   );
+  const owner = Array.from({ length: numRows }, () => new Array(maxCols));
   const anchorCols = /* @__PURE__ */ new Set();
-  for (const row of rows) {
-    for (const cell of row) {
-      const r = _nullishCoalesce(cell.rowAddr, () => ( 0));
-      const c = _nullishCoalesce(cell.colAddr, () => ( 0));
-      if (r >= numRows || c >= maxCols || r < 0 || c < 0) continue;
+  for (let ri = 0; ri < rows.length; ri++) {
+    for (const cell of rows[ri]) {
+      const text = _optionalChain([options, 'optionalAccess', _3 => _3.keepEmptyParagraphs]) ? cell.text : cell.text.trim();
+      const r = Math.min(_nullishCoalesce(cell.rowAddr, () => ( ri)), numRows - 1);
+      let c = _nullishCoalesce(cell.colAddr, () => ( 0));
+      if (r < 0 || c < 0) continue;
+      if (cell.colAddr === void 0) while (c < maxCols - 1 && owner[r][c]) c++;
+      if (c >= maxCols) c = maxCols - 1;
+      const own = owner[r][c];
+      if (own) {
+        if (text.trim()) own.text = own.text ? `${own.text}
+${text}` : text;
+        continue;
+      }
+      let colSpan = Math.max(1, Math.min(cell.colSpan, maxCols - c));
+      for (let dc = 1; dc < colSpan; dc++) if (owner[r][c + dc]) {
+        colSpan = dc;
+        break;
+      }
+      let rowSpan = Math.max(1, Math.min(cell.rowSpan, numRows - r));
+      for (let dr = 1; dr < rowSpan; dr++) {
+        if (owner[r + dr].slice(c, c + colSpan).some(Boolean)) {
+          rowSpan = dr;
+          break;
+        }
+      }
+      const ir = { text, colSpan, rowSpan };
       anchorCols.add(c);
-      grid[r][c] = { text: _optionalChain([options, 'optionalAccess', _3 => _3.keepEmptyParagraphs]) ? cell.text : cell.text.trim(), colSpan: cell.colSpan, rowSpan: cell.rowSpan };
-      for (let dr = 0; dr < cell.rowSpan; dr++) {
-        for (let dc = 0; dc < cell.colSpan; dc++) {
-          if (dr === 0 && dc === 0) continue;
-          if (r + dr < numRows && c + dc < maxCols) {
-            grid[r + dr][c + dc] = { text: "", colSpan: 1, rowSpan: 1 };
-          }
+      for (let dr = 0; dr < rowSpan; dr++) {
+        for (let dc = 0; dc < colSpan; dc++) {
+          owner[r + dr][c + dc] = ir;
+          grid[r + dr][c + dc] = dr === 0 && dc === 0 ? ir : { text: "", colSpan: 1, rowSpan: 1 };
         }
       }
     }
@@ -306,6 +559,11 @@ function trimAndReturn(grid, numRows, maxCols, anchorCols, options) {
   }
   if (effectiveCols < maxCols && effectiveCols > 0) {
     const trimmed = grid.map((row) => row.slice(0, effectiveCols));
+    for (const row of trimmed) {
+      for (let c = 0; c < row.length; c++) {
+        if (c + row[c].colSpan > effectiveCols) row[c].colSpan = effectiveCols - c;
+      }
+    }
     return { rows: numRows, cols: effectiveCols, cells: trimmed, hasHeader: numRows > 1 };
   }
   return { rows: numRows, cols: maxCols, cells: grid, hasHeader: numRows > 1 };
@@ -318,13 +576,16 @@ function convertTableToText(rows) {
 function escapeGfm(text) {
   const NUL = String.fromCharCode(0);
   const spans = [];
-  const masked = text.replace(/!\[[^\]]*\]\([^)\n]*\)|\]\((?:https?:|mailto:|tel:|#)[^)\n]*\)|\$\$[^$]*\$\$|\$[^$\n]*\$/gi, (m) => {
+  const masked = text.replace(/!\[[^\]]*\]\([^)\n]*\)|\]\((?:https?:|mailto:|tel:|#)[^)\n]*\)|(?<!\\)\$\$(?:\\[\s\S]|[^\\$])*\$\$|(?<!\\)\$(?:\\[^\n]|[^\\$\n])*\$/gi, (m) => {
     spans.push(m);
     return NUL + (spans.length - 1) + NUL;
   });
-  const escaped = masked.replace(/([~*_`])/g, "\\$1");
+  const escaped = masked.replace(/\\(?=[!-#%-\/:-@\[-\x60{}~])/g, "\\\\").replace(/([~*_`])/g, "\\$1").replace(/(?<!\\)\|/g, "\\|").replace(/^([ \t]*)(?=#{1,6}(?:[ \t]|$))/gm, "$1\\").replace(/<(?!\/?u>)(?=[A-Za-z/!?])/g, "\\<");
   return escaped.replace(new RegExp(NUL + "(\\d+)" + NUL, "g"), (_, n) => spans[Number(n)]);
 }
+function escapeLiteralDollar(text) {
+  return text.includes("$") ? text.replace(/\$/g, "\\$") : text;
+}
 var HWP_SHAPE_ALT_TEXT_RE = /^(?:모서리가 둥근 |둥근 )?(?:사각형|직사각형|정사각형|원|타원|삼각형|이등변 삼각형|직각 삼각형|선|직선|곡선|화살표|굵은 화살표|이중 화살표|오각형|육각형|팔각형|별|[4-8]점별|십자|십자형|구름|구름형|마름모|도넛|평행사변형|사다리꼴|부채꼴|호|반원|물결|번개|하트|빗금|블록 화살표|수식|표|그림|개체|그리기\s?개체|묶음\s?개체|글상자|수식\s?개체|OLE\s?개체)\s?입니다\.?$/gm;
 function sanitizePua(text) {
   return mapPuaText(text).replace(/[\u{F0000}-\u{FFFFD}]/gu, "");
@@ -423,6 +684,7 @@ function dedupeRunningHeaders(blocks) {
 function spansToMarkdown(spans) {
   let out = "";
   for (const s of spans) {
+    if (s.placeholder) continue;
     const text = sanitizePua(_nullishCoalesce(s.text, () => ( "")));
     if (!text) continue;
     let marker = s.code ? "`" : s.bold && s.italic ? "***" : s.bold ? "**" : s.italic ? "*" : "";
@@ -455,7 +717,8 @@ function blocksToMarkdown(blocks) {
     if (block.type === "heading" && block.text) {
       const prefix = "#".repeat(Math.min(block.level || 2, 6));
       const headingText = sanitizeText(block.text);
-      if (headingText) lines.push("", `${prefix} ${escapeGfm(headingText)}`, "");
+      const note = block.footnoteText ? ` (\uC8FC: ${block.footnoteText})` : "";
+      if (headingText) lines.push("", `${prefix} ${escapeGfm(headingText + note)}`, "");
       continue;
     }
     if (block.type === "image" && block.text) {
@@ -501,7 +764,7 @@ function blocksToMarkdown(blocks) {
       if (_optionalChain([block, 'access', _26 => _26.spans, 'optionalAccess', _27 => _27.length])) {
         let rendered = spansToMarkdown(block.spans);
         if (block.href) {
-          const href = _chunkHR2XNERBcjs.sanitizeHref.call(void 0, block.href);
+          const href = _chunkWJHAU73Bcjs.sanitizeHref.call(void 0, block.href);
           if (href) rendered = `[${rendered}](${href})`;
         }
         if (block.footnoteText) rendered += ` (\uC8FC: ${block.footnoteText})`;
@@ -509,7 +772,7 @@ function blocksToMarkdown(blocks) {
         continue;
       }
       if (block.href) {
-        const href = _chunkHR2XNERBcjs.sanitizeHref.call(void 0, block.href);
+        const href = _chunkWJHAU73Bcjs.sanitizeHref.call(void 0, block.href);
         if (href) text = `[${text}](${href})`;
       }
       if (block.footnoteText) {
@@ -549,16 +812,22 @@ function hasStructuredCellContent(table) {
   }
   return false;
 }
+function noteSuffix(b) {
+  return b.footnoteText && b.text ? ` (\uC8FC: ${b.footnoteText})` : "";
+}
+function visibleText(b) {
+  return _optionalChain([b, 'access', _31 => _31.spans, 'optionalAccess', _32 => _32.some, 'call', _33 => _33((s) => s.placeholder)]) ? b.spans.filter((s) => !s.placeholder).map((s) => s.text).join("") : _nullishCoalesce(b.text, () => ( ""));
+}
 function cellInnerHtml(cell) {
-  if (_optionalChain([cell, 'access', _31 => _31.blocks, 'optionalAccess', _32 => _32.length])) {
+  if (_optionalChain([cell, 'access', _34 => _34.blocks, 'optionalAccess', _35 => _35.length])) {
     return cell.blocks.map((b) => {
       if (b.type === "table" && b.table) {
         const cap = b.table.caption ? sanitizeText(b.table.caption) : "";
         return (cap ? cap + "<br>" : "") + tableToHtml(b.table);
       }
       if (b.type === "image" && b.text) return `<img src="${b.text}" alt="image">`;
-      const t = sanitizeText(_nullishCoalesce(b.text, () => ( "")));
-      return t ? t.replace(/\n/g, "<br>") : "";
+      const t = sanitizeText(visibleText(b));
+      return t ? (t + noteSuffix(b)).replace(/\n/g, "<br>") : "";
     }).filter(Boolean).join("<br>");
   }
   return sanitizeText(cell.text).replace(/\n/g, "<br>");
@@ -583,7 +852,7 @@ function tableToHtml(table) {
     const rowHtml = [];
     for (let c = 0; c < numCols; c++) {
       if (skip.has(`${r},${c}`)) continue;
-      const cell = _optionalChain([cells, 'access', _33 => _33[r], 'optionalAccess', _34 => _34[c]]);
+      const cell = _optionalChain([cells, 'access', _36 => _36[r], 'optionalAccess', _37 => _37[c]]);
       if (!cell) continue;
       for (let dr = 0; dr < cell.rowSpan; dr++) {
         for (let dc = 0; dc < cell.colSpan; dc++) {
@@ -598,7 +867,7 @@ function tableToHtml(table) {
       const attrStr = attrs.length ? " " + attrs.join(" ") : "";
       rowHtml.push(`<${tag}${attrStr}>${text}</${tag}>`);
     }
-    if (rowHtml.length) lines.push(`<tr>${rowHtml.join("")}</tr>`);
+    lines.push(`<tr>${rowHtml.join("")}</tr>`);
   }
   lines.push("</table>");
   return lines.join("\n");
@@ -606,7 +875,8 @@ function tableToHtml(table) {
 function tableToMarkdown(table) {
   if (table.rows === 0 || table.cols === 0) return "";
   const { cells, rows: numRows, cols: numCols } = table;
-  if ((hasMergedCells(table) || hasStructuredCellContent(table)) && !tableContainsInlineMath(table)) {
+  if (hasStructuredCellContent(table)) return tableToHtml(table);
+  if (hasMergedCells(table) && !tableContainsInlineMath(table)) {
     return tableToHtml(table);
   }
   if (numRows === 1 && numCols === 1) {
@@ -628,9 +898,9 @@ function tableToMarkdown(table) {
   for (let r = 0; r < numRows; r++) {
     for (let c = 0; c < numCols; c++) {
       if (skip.has(`${r},${c}`)) continue;
-      const cell = _optionalChain([cells, 'access', _35 => _35[r], 'optionalAccess', _36 => _36[c]]);
+      const cell = _optionalChain([cells, 'access', _38 => _38[r], 'optionalAccess', _39 => _39[c]]);
       if (!cell) continue;
-      display[r][c] = (_optionalChain([cell, 'access', _37 => _37.blocks, 'optionalAccess', _38 => _38.some, 'call', _39 => _39((b) => b.spans || b.type === "image" && b.text)]) ? cell.blocks.map((b) => b.type === "image" && b.text ? `![image](${b.text})` : b.spans ? spansToMarkdown(b.spans) : escapeGfm(sanitizeText(_nullishCoalesce(b.text, () => ( ""))))).filter(Boolean).join("<br>") : escapeGfm(sanitizeText(cell.text)).replace(/\n/g, "<br>")).replace(/\|/g, "\\|");
+      display[r][c] = (_optionalChain([cell, 'access', _40 => _40.blocks, 'optionalAccess', _41 => _41.some, 'call', _42 => _42((b) => b.spans || b.type === "image" && b.text)]) ? cell.blocks.map((b) => b.type === "image" && b.text ? `![image](${b.text})` : b.spans ? spansToMarkdown(b.spans) + escapeGfm(noteSuffix(b)) : escapeGfm(sanitizeText(_nullishCoalesce(b.text, () => ( ""))) + noteSuffix(b))).filter(Boolean).join("<br>") : escapeGfm(sanitizeText(cell.text)).replace(/\n/g, "<br>")).replace(/(?<!\\)\|/g, "\\|");
       for (let dr = 0; dr < cell.rowSpan; dr++) {
         for (let dc = 0; dc < cell.colSpan; dc++) {
           if (dr === 0 && dc === 0) continue;
@@ -791,7 +1061,7 @@ function encodePng(width, height, rgba) {
   return out;
 }
 function inlineImagesIntoMarkdown(markdown, images, opts) {
-  const compress = _optionalChain([opts, 'optionalAccess', _40 => _40.compress]) !== false;
+  const compress = _optionalChain([opts, 'optionalAccess', _43 => _43.compress]) !== false;
   const uris = /* @__PURE__ */ new Map();
   for (const img of images) {
     let bytes = img.data;
@@ -829,5 +1099,9 @@ function inlineImagesIntoMarkdown(markdown, images, opts) {
 
 
 
-exports.mapPuaText = mapPuaText; exports.MAX_COLS = MAX_COLS; exports.MAX_ROWS = MAX_ROWS; exports.buildTable = buildTable; exports.convertTableToText = convertTableToText; exports.flattenLayoutTables = flattenLayoutTables; exports.dedupeRunningHeaders = dedupeRunningHeaders; exports.blocksToMarkdown = blocksToMarkdown; exports.hasStructuredCellContent = hasStructuredCellContent; exports.encodePng = encodePng; exports.inlineImagesIntoMarkdown = inlineImagesIntoMarkdown;
-//# sourceMappingURL=chunk-QOMNEWCQ.cjs.map
+
+
+
+
+exports.WINGDINGS = WINGDINGS; exports.mapPuaText = mapPuaText; exports.MAX_COLS = MAX_COLS; exports.MAX_ROWS = MAX_ROWS; exports.buildTable = buildTable; exports.convertTableToText = convertTableToText; exports.escapeGfm = escapeGfm; exports.escapeLiteralDollar = escapeLiteralDollar; exports.flattenLayoutTables = flattenLayoutTables; exports.dedupeRunningHeaders = dedupeRunningHeaders; exports.blocksToMarkdown = blocksToMarkdown; exports.hasStructuredCellContent = hasStructuredCellContent; exports.noteSuffix = noteSuffix; exports.encodePng = encodePng; exports.inlineImagesIntoMarkdown = inlineImagesIntoMarkdown;
+//# sourceMappingURL=chunk-5LAZQCUJ.cjs.map