kordoc 4.12.3 → 4.13.0

package/README.md

@@ -89,6 +89,24 @@ MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
 
 ---
 
+## v4.13.0 변경사항
+
+공문서 생성 엔진을 다시 설계했습니다(v5). 서울 정보소통광장 결재문서 **629건을 전수 실측**해 위계·글꼴·들여쓰기·골격을 스킴 하나에 박고, 기안문·보고서·계획서·통지·회의록 생성을 새 엔진으로 갈아탔습니다. 어떤 형태의 마크다운(`#/##/###`, 리스트, □ ㅇ - 1. 가. 명시 부호)을 던져도 같은 위계로 나옵니다.
+
+- **📐 위계 = 실결재 그대로**: 개조식형 □ HY견고딕 17pt 굵게(0타) → ㅇ 한컴돋움 15pt 굵게(1타) → - 휴먼명조 14pt(3타) → ㆍ, ※ 한컴돋움 14. 법정형 굴림체 12pt 160%, `1.` 0타 → `가.` 2타 → `1)` 4타(2타 계단), 내어쓰기는 부호폭+1타. 표는 한컴돋움 12(헤더 굵게·#DFE6F7). 근거는 `docs/gongmunseo-reference.md` 2.8.
+- **📏 □·제목은 절대 두 줄로 안 꺾입니다**: 장평 → 자간 → 글자 크기 순으로 줄여 한 줄에 담고(실측 관행), 그래도 안 되면 경고합니다. 표 셀도 12→11→10pt 자동 축소.
+- **📋 기안문 두문표·결문표**: 실결재 표 그대로 — 슬로건·기관명(굴림 20 굵게 자간띄움)·수신/(경유)/제목, 발신명의·회색 띠·결재선(직위/성명/일자)·협조자·시행/접수·주소·전화/전송/이메일/공개구분. 수신이 '내부결재'면 발신명의 생략. `--doc-head "org=광진구,slogan=…,to=…,title=…"` `--doc-foot "sender=…,drafter=주무관 홍길동,…,zip=…"`.
+- **📑 보고서(서울 실무 보고서형)**: 제목표(HY헤드라인M 25 굵게, 상 0.4mm/하 0.15mm) + 담당자 행(`--report-info`) + 요약박스(`--summary` 또는 제목 직후 `>`) + `Ⅰ. Ⅱ.` 장(h2) + □/ㅇ/- 본문. `--cover --dept 스마트도시과 --doc-info "docNum=…"` 로 표지(문서정보표·결재선·파랑 띠 제목·기관명).
+- **✍️ 실무 디테일**: `출처:`/`자료:`/`근거:` 줄은 자동으로 ※ 참고(13pt 작은 글씨), 둘째 줄이 한 줄의 20% 이내로 삐져나온 항목은 자간을 줄여(Shift+Alt+N 관행) 한 줄에 담고, 줄바꿈은 실결재 76%가 쓰는 글자 단위+양쪽정렬(어절 유지는 긴 어절 앞 줄이 벌어져 기각, 영문·숫자는 단어 유지), 법령 코드 `(282791)`·KOSIS 표 ID `DT_…`·"○○ MCP 조회" 같은 내부 식별자는 자동 제거. 보고서는 제목 직후 인용문(`>`) 한 문장("…하고자 함", 부호 없이 3줄 이내)이 요약박스가 됩니다(없거나 넘치면 경고).
+- **⚙️ 기본값 변경**: 기안문 본문 굴림체 12(함초롬바탕은 `--font myeongjo`), 보고서·계획서 여백 13/13/18/18·줄간격 180%·2단계 부호 ㅇ(중앙부처 개조식만 ○), h2는 장(`--h2-marker roman|number|box|none`). 개조식(`개조식` 프리셋)·보도자료는 종전 그대로.
+- **🏷️ 장 제목 띠 표**: 보고서·계획서의 `## 장 제목`이 로마자 채움 칸 + 제목 칸(밑줄) 표로 나옵니다(계획서 실결재 37~39% 관행). 종전 `Ⅰ. 제목` 텍스트는 `--h2-marker roman`. 맥 한컴에서 글꼴 칸이 비고 스타일이 영문명으로 뜨던 산출물 결함도 수정(7개 언어 글꼴 슬롯 통일·`langID`).
+- **📊 표 열폭은 중요도 순**: `비고`·`근거`·`참고`·`담당`·`연락처` 열과 내용 열이 있는 표의 마지막 열은 25% 이내로 좁게(실결재 462표에서 비고 열 중앙값 21%), `내용`·`사항`·`실적`·`계획`류 열은 넓게(중앙값 51%) 왼쪽 정렬. 긴 근거 텍스트가 최광열을 차지하고 내용이 두 줄로 꺾이던 결함. 요약박스는 문단 좌우 여백 1000(실측 55%)으로 글자가 테두리에 붙지 않습니다.
+- **📊 코퍼스**: `bench/corpus-gen/opengov-2609/` 7종 필터 280건 추가(계획·결과보고·방침·안내·회의·2024·2022).
+- **💰 금액 한글 병기 자동 계산**: `금113,560원` 처럼 한글 병기가 빠진 금액은 경고와 함께 `금113,560원(금일십일만삼천오백육십원)` 실제 값을 제안합니다(규정 시행규칙 제2조). 하이픈 날짜 `2026-07-18` 도 잡아서 `2026. 7. 18.` 로 바꿔 줍니다(URL·파일명·표 셀은 제외).
+- **🔣 항목 부호 확장**: `❑ ❏ ㅁ`(대항목)·`◎`(중항목)·`ㅡ ‣ ▪ ▫`(세부) 도 □/ㅇ/- 와 같은 위계로 읽습니다.
+- **🖼️ 렌더 통합 계층 (#75)**: `renderDocument(파일, { format: "svg"|"html"|"png"|"jpeg"|"pdf", pages: "2-4" })` 하나로 페이지별 SVG·자급자족 레이아웃 HTML·페이지별 PNG/JPEG·PDF(Chromium 필요)를 냅니다. 렌더 결과에는 문단·표·이미지·도형의 **페이지 로컬 pt bbox 와 결정적 id**(`RenderScene.regions`, SVG `data-kordoc-id`)가 붙고, `extractRenderedRegions()` / `kordoc crop 문서.hwpx --target table -d ./regions` 로 그 영역을 실배율로 잘라냅니다. `kordoc render --format png --pages 2-4 -d ./pages`, MCP `render_document` 의 `pages`, `crop_regions`. HWP5 렌더는 후속.
+- **🧭 표 분류·시각 추출 (#76)**: `parse(파일, { classifyTables: true })` 로 표마다 `semantic-table`(데이터표) / `non-tabular-layout`(표를 캔버스로 쓴 조직도·연락망) / `uncertain` 분류가 붙습니다(휴리스틱, 네트워크·LLM 없음, 중첩표 독립 분류). `extractTables(파일)` / `kordoc tables 문서.hwpx --visual non-tabular-and-uncertain -d ./tables` 는 분류 + 렌더 영역 + crop 을 한 번에 — 조직도는 이미지로, 데이터표는 구조로 넘기는 멀티모달 파이프라인용. 병합 없는 단순 표의 셀 이미지가 마크다운에서 사라지던 결함도 함께 수정.
+
 ## v4.12.3 변경사항
 
 공문서 작성 쪽 라운드. 실결재 기안문 206건·보고서 337건의 항목부호 단계별 글꼴을 실측해 **위계 폰트 옵션**을 넣고, 표기법 검수의 쌍점·날짜 룰 오탐을 법정 서식 근거로 좁혔습니다. 별표 코퍼스 3차(183쌍)를 더해 게이트 모수는 hwpx ~1,390·pdf ~950·hwp쌍 ~860 입니다.
@@ -102,6 +120,8 @@ MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
 - **📊 별표 코퍼스 3차**: `licbyl-byl2/` 183쌍(seed 20260907). 하위 30건 분해 — 1×1 틀 PDF 미감지 8 · HWP 레이아웃 해체 vs PDF 1열 유지 15 · 구조 차 7(수식 셀·쪽 경계 셀 분할·줄바꿈, 파서 결함 없음). HWP↔PDF 셀 일치 별표 0.728 → 0.746, 3차 0.772 → 0.787, 서식 0.965 유지.
 
 
+## v4.12.2 변경사항
+
 별지서식 라운드 2. 코퍼스를 서식 279쌍·별표 90쌍 더 모아(총 1,995파일) HWP·HWPX·PDF 세 파서가 **같은 IR 모양**을 내도록 맞췄습니다. HWP↔PDF 셀 텍스트 일치 0.927 → 0.965, PDF 표 GT cellExact 0.945 → 0.980 을 실측했고 게이트 플로어를 그 수치로 올렸습니다.
 
 - **🪆 PDF 틀 안 중첩표**: 지정서·영치증·선서문처럼 1칸 틀 안에 "발신명의 | 직인" 표가 든 서식에서, PDF 가 그 표를 틀 뒤 별도 블록으로 흘리던 것을 틀 셀 안에 문단·표 원문 순서로 넣습니다(HWPX 파서와 같은 모양). 네 변에 테두리가 그려진 1칸 틀은 표로, 그 안에 홀로 든 상자는 중첩표로 살립니다. 테두리 없는 바깥 틀은 한컴 본문 영역 클립과 구분할 수 없어 표로 삼지 않습니다.
@@ -382,7 +402,7 @@ rhwp 최신 devel(v0.8.3~0.8.4)을 훑어 kordoc 의 HWP3 디코더에 반영했
 
 ## v3.10.0 변경사항
 
-- **🖼️ 레이아웃 보존 렌더**: `kordoc render 문서.hwpx -o 문서.svg` / `renderHwpxToSvg(buffer)` — 한컴이 저장한 조판 캐시(줄 좌표·셀 그리드·개체 앵커)를 SVG 절대배치로 그려 원본 레이아웃을 재현합니다. run별 글자 크기/굵기/색/장평/자간, 문단 정렬, 셀 배경·테두리, 병합 셀, 인라인 개체, 이미지 크롭까지. 한컴 저장본 전용(1페이지).
+- **🖼️ 레이아웃 보존 렌더**: `kordoc render 문서.hwpx -o 문서.svg` / `renderHwpxToSvg(buffer)` (v4.13.0: `renderDocument` 로 HTML·PNG·JPEG·PDF·페이지 선택·영역 crop) — 한컴이 저장한 조판 캐시(줄 좌표·셀 그리드·개체 앵커)를 SVG 절대배치로 그려 원본 레이아웃을 재현합니다. run별 글자 크기/굵기/색/장평/자간, 문단 정렬, 셀 배경·테두리, 병합 셀, 인라인 개체, 이미지 크롭까지. 한컴 저장본 전용(1페이지).
 - **🔧 uint32 음수 좌표**: `vertOffset="4294967103"`(= −193) 같은 uint32 저장 음수를 올바르게 해석합니다.
 - **🔧 셀 내부 COLUMN 기준계**: 셀 안 개체의 `horzRelTo="COLUMN"`을 셀 영역 기준으로 해석합니다 (사진이 페이지 왼쪽으로 튀던 문제).
 

package/dist/{-FWGDIOV4.js → -UZDRUWTX.js}

@@ -5,15 +5,16 @@ import {
   PRESET_ALIAS,
   ValueCursor,
   blocksToPages,
-  blocksToPdf,
+  chooseTableRepresentation,
+  classifyTable,
+  classifyTableTree,
+  collectTableBlocks,
   compare,
-  detectFormat,
-  detectOle2Format,
-  detectZipFormat,
   diffBlocks,
   extractClickHereFields,
   extractFormFields,
   extractFormSchema,
+  extractTables,
   fillForm,
   fillFormFields,
   fillHwpx,
@@ -23,16 +24,11 @@ import {
   hwpxToProfile,
   incompatibleGongmunWarnings,
   inferFieldType,
-  isHwpxFile,
   isKnownFont,
   isLabelCell,
-  isOldHwpFile,
-  isPdfFile,
-  isZipFile,
   lintGongmunText,
   lintMuncheText,
   markdownToHwpx,
-  markdownToPdf,
   muncheLintWarnings,
   normalizeGongmunPreset,
   openHwpxDocument,
@@ -51,22 +47,20 @@ import {
   patchHwpxBlocks,
   readBuiltinTemplate,
   readBuiltinTemplateSample,
-  renderHtml,
   resolveBuiltinTemplate,
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-INFYDSZL.js";
+} from "./chunk-2RREQZ44.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-N3DLQ2YH.js";
-import "./chunk-MOL7MDBG.js";
+import "./chunk-HG5LXXCC.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-CKYDP34A.js";
+} from "./chunk-IEJR23OA.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -74,24 +68,41 @@ import {
 } from "./chunk-DZIXKL7E.js";
 import {
   blocksToChunks
-} from "./chunk-6L3B44DH.js";
-import {
-  blocksToMarkdown
-} from "./chunk-ZASGH5EN.js";
+} from "./chunk-OSLJ3A6D.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
+  blocksToPdf,
   charWidthEm1000,
+  detectFormat,
+  detectOle2Format,
+  detectZipFormat,
+  extractRenderedRegions,
   fitRatioForFewerLines,
+  isHwpxFile,
+  isOldHwpFile,
+  isPdfFile,
+  isZipFile,
+  markdownToPdf,
   measureTextWidth,
+  renderDocument,
+  renderDocumentToScene,
+  renderHtml,
   renderHwpxToSvg,
+  renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-B63QEHYL.js";
-import "./chunk-YBZJMAE2.js";
+} from "./chunk-T7AFLXGA.js";
+import "./chunk-MOL7MDBG.js";
+import "./chunk-6JXMIX3G.js";
+import {
+  blocksToMarkdown,
+  hasStructuredCellContent
+} from "./chunk-GWFX5ZD7.js";
+import "./chunk-BQLZOQES.js";
 import {
   VERSION
-} from "./chunk-PUZZFYLV.js";
+} from "./chunk-27QN27I3.js";
 export {
   BUILTIN_TEMPLATES,
   DEFAULT_REDACT_RULES,
@@ -109,6 +120,10 @@ export {
   buildParagraphSplices,
   buildRangeSplices,
   charWidthEm1000,
+  chooseTableRepresentation,
+  classifyTable,
+  classifyTableTree,
+  collectTableBlocks,
   compare,
   detectFormat,
   detectOle2Format,
@@ -117,6 +132,8 @@ export {
   extractClickHereFields,
   extractFormFields,
   extractFormSchema,
+  extractRenderedRegions,
+  extractTables,
   fillForm,
   fillFormFields,
   fillHwpx,
@@ -124,6 +141,7 @@ export {
   fitRatioForFewerLines,
   formatFillValue,
   gongmunLintWarnings,
+  hasStructuredCellContent,
   hwpxToProfile,
   incompatibleGongmunWarnings,
   inferFieldType,
@@ -159,8 +177,11 @@ export {
   readBuiltinTemplateSample,
   redactMarkdown,
   redactText,
+  renderDocument,
+  renderDocumentToScene,
   renderHtml,
   renderHwpxToSvg,
+  renderSceneToHtml,
   resolveBuiltinTemplate,
   scanSectionXml,
   simulateWrap,
@@ -169,4 +190,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-FWGDIOV4.js.map
+//# sourceMappingURL=-UZDRUWTX.js.map

package/dist/{chunk-PUZZFYLV.js → chunk-27QN27I3.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/utils.ts
-var VERSION = true ? "4.12.3" : "0.0.0-dev";
+var VERSION = true ? "4.13.0" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -123,4 +123,4 @@ export {
   safeMax,
   classifyError
 };
-//# sourceMappingURL=chunk-PUZZFYLV.js.map
+//# sourceMappingURL=chunk-27QN27I3.js.map

package/dist/{chunk-KRE2SREV.js → chunk-2B45S7FM.js}

@@ -1,5 +1,5 @@
 // src/utils.ts
-var VERSION = true ? "4.12.3" : "0.0.0-dev";
+var VERSION = true ? "4.13.0" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -121,4 +121,4 @@ export {
   safeMax,
   classifyError
 };
-//# sourceMappingURL=chunk-KRE2SREV.js.map
+//# sourceMappingURL=chunk-2B45S7FM.js.map