kordoc 4.14.0 → 4.14.2

package/README.md

@@ -19,7 +19,7 @@ HWP 3.x/5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, 이미지(PNG/JPG/WebP) — 관
 
 ## ⚡ 30초 설치 (AI 에이전트 연동)
 
-**macOS / Linux / Windows 공용**. Node.js 18+ 만 있으면 됩니다.
+**macOS / Linux / Windows 공용**. Node.js 20+ 만 있으면 됩니다.
 
 ```bash
 npx -y kordoc setup
@@ -89,6 +89,16 @@ MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
 
 ---
 
+## v4.14.2 변경사항
+
+공문서 출력을 한글 2024 실렌더 PDF로 다시 대조해 "진짜 공문처럼" 다듬었습니다.
+
+- **📐 항목 둘째 줄이 첫 줄 내용과 정확히 맞습니다**: 부호(□ ○ - ※ 1. 가.) 뒤를 공백이 아니라 탭으로 두고, 한글의 "내어쓰기용 자동 탭"을 씁니다. 양쪽 정렬이 부호 뒤 공백을 늘려 첫 줄 내용이 밀리던 것, 자간을 줄인 줄에서 내용이 당겨지던 것이 구조적으로 없어졌습니다. 기안문·보고서·계획서·통지·회의록·업무보고·개조식·보도자료 전부.
+- **✂️ 낱말이 줄 끝에서 쪼개지지 않습니다**: 본문을 어절 단위 줄바꿈으로 바꾸고("동대/문" → "동대문") 외톨이줄 보호를 켰습니다. 날짜·금액은 묶음 빈칸으로 묶어 "2026. 1. / 22." 처럼 갈라지지 않습니다. 곧은따옴표는 ‘ ’ “ ”로 바꿉니다.
+- **📏 한글 글꼴 실폭으로 조판을 재현합니다**: 한컴돋움·HY견고딕·휴먼명조 등 8종의 실제 글자 폭으로 줄바꿈을 계산해(한글 2024 PDF 154줄 전부 일치), 짧은 꼬리 줄은 자간으로 올리고 긴 어절이 넘어가 공백이 크게 벌어지는 줄은 자간을 살짝 줄여 메웁니다. 종전처럼 한 줄을 과하게 눌러 옆 줄과 밀도가 달라 보이는 일이 줄었습니다.
+- **🧩 PPTX 감지** (#80, PR #81 @LimePencil): PPTX 를 넣으면 "HWPX 섹션 없음" 대신 지원하지 않는 형식이라고 알려 줍니다.
+- **🧹 기술부채**: 1,200줄 넘던 `mcp.ts`·`cli.ts`·`hwp5/parser.ts`·`svg-render.ts` 를 기능별 모듈로 나눴고, 파서가 묶음 빈칸을 버리던 것과 `kordoc render` 미리보기의 탭 폭·줄 끝 공백 정렬을 고쳤습니다.
+
 ## v4.14.0 변경사항
 
 - **🏛️ 중앙부처 업무보고 프리셋 `업무보고`**: 재정경제부 「2차 업무보고 서면보고자료」(2026. 7. 15., 17쪽)를 글꼴·크기·색·도형 좌표까지 전수 실측해 국회 서면보고형 골격을 그대로 냅니다 — 표지(대외주의 박스 `--cover-label`, 파란 바 두 줄), 목차 박스, `##` Ⅰ. 장 띠(그라데이션+파랑 이중선, 장마다 새 쪽), `###` 파란 숫자칸 절, `####` 남색 소제목 박스, `#####` ① 하늘색 항목 띠, `> ▪ …` 연노랑 성과 요약박스, `## 별첨 …` 별첨 띠. 본문 함초롬바탕 15·각주 맑은 고딕 12·표 맑은 고딕 12, **□ 뒤 `(키워드)`·`[키워드]` 는 파랑 굵게**(ㅇ 뒤는 검정 굵게), ❶⇒↳ 부호 보존. `kordoc generate 보고.md --preset 업무보고 --date "2026. 7. 15." --cover-label 대외주의`. 한글 COM 실렌더로 원본과 대조했습니다.
@@ -1102,7 +1112,13 @@ codex mcp add kordoc -- npx -y kordoc mcp
 | `parseDocx(buffer, options?)` | DOCX 전용 |
 | `parseHwpml(buffer, options?)` | HWPML (XML 기반 HWP) 전용 |
 | `parseImage(buffer, options?)` | 이미지(PNG/JPG/WebP) 전용 — 내장 OCR 상시 적용 (v4.2.1) |
-| `detectFormat(buffer)` | `"hwpx" \| "hwp" \| "hwp3" \| "hwpml" \| "pdf" \| "xlsx" \| "xls" \| "docx" \| "image" \| "unknown"` |
+| `detectFormat(buffer)` | 동기 매직 바이트 감지 — 하위 호환을 위해 ZIP은 `hwpx`, OLE2는 `hwp` 반환 |
+| `await detectZipFormat(buffer)` | ZIP 내부 구조로 `hwpx`, `xlsx`, `docx`, `pptx`, `unknown` 구분 |
+| `detectOle2Format(buffer)` | OLE2 내부 스트림으로 `hwp`, `xls`, `unknown` 구분 |
+
+PPTX는 감지만 지원합니다. `parse()`는 PPTX 입력에 `success: false`, `fileType: "pptx"`,
+`code: "UNSUPPORTED_FORMAT"`을 반환합니다. ZIP을 구분해 라우팅하는 래퍼/API는
+`detectFormat()` 결과가 `hwpx`일 때 `await detectZipFormat(buffer)`로 세분화하세요.
 
 ### 고급 함수
 

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

@@ -51,14 +51,14 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-EMQZX5QQ.js";
+} from "./chunk-EISO3POT.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-UBNJXMYX.js";
+} from "./chunk-ZWOFQRIB.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -66,7 +66,7 @@ import {
 } from "./chunk-DZIXKL7E.js";
 import {
   blocksToChunks
-} from "./chunk-6T6MB5ON.js";
+} from "./chunk-EDNJLUSE.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -91,19 +91,19 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-HH7T6SMB.js";
+} from "./chunk-TSFS5VKD.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-HG5LXXCC.js";
+import "./chunk-7IAQ4HOK.js";
 import "./chunk-MOL7MDBG.js";
-import "./chunk-3U3PJGVO.js";
+import "./chunk-ILU76UF3.js";
 import {
   blocksToMarkdown,
   hasStructuredCellContent
-} from "./chunk-XH34WJKB.js";
-import "./chunk-HCHA3Y2T.js";
+} from "./chunk-QC5T6D4J.js";
+import "./chunk-C7FQBSON.js";
 import {
   VERSION
-} from "./chunk-RCTWZYAM.js";
+} from "./chunk-UET462HB.js";
 export {
   BUILTIN_TEMPLATES,
   DEFAULT_REDACT_RULES,
@@ -192,4 +192,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-SLX6IB6Y.js.map
+//# sourceMappingURL=-AQKXLFIM.js.map

package/dist/{chunk-WAPKUYGP.cjs → chunk-247ANM72.cjs}

@@ -2,11 +2,11 @@
 
 
 
-var _chunkCOUGOFT3cjs = require('./chunk-COUGOFT3.cjs');
+var _chunkL7DMSMAGcjs = require('./chunk-L7DMSMAG.cjs');
 
 
 
-var _chunkANKDK5DFcjs = require('./chunk-ANKDK5DF.cjs');
+var _chunkHR2XNERBcjs = require('./chunk-HR2XNERB.cjs');
 
 // src/pdf/image-regions.ts
 var _pdfmjs = require('pdfjs-dist/legacy/build/pdf.mjs');
@@ -1781,9 +1781,9 @@ function detectHeadings(blocks, medianFontSize) {
     if (/^\d+$/.test(text)) continue;
     const ratio = block.style.fontSize / medianFontSize;
     let level = 0;
-    if (ratio >= _chunkCOUGOFT3cjs.HEADING_RATIO_H1) level = 1;
-    else if (ratio >= _chunkCOUGOFT3cjs.HEADING_RATIO_H2) level = 2;
-    else if (ratio >= _chunkCOUGOFT3cjs.HEADING_RATIO_H3) level = 3;
+    if (ratio >= _chunkL7DMSMAGcjs.HEADING_RATIO_H1) level = 1;
+    else if (ratio >= _chunkL7DMSMAGcjs.HEADING_RATIO_H2) level = 2;
+    else if (ratio >= _chunkL7DMSMAGcjs.HEADING_RATIO_H3) level = 3;
     if (level > 0) {
       block.type = "heading";
       block.level = level;
@@ -3046,14 +3046,14 @@ function isProseSpread(items) {
   for (let i = 1; i < sorted.length; i++) {
     gaps.push(sorted[i].x - (sorted[i - 1].x + sorted[i - 1].w));
   }
-  const maxGap = _chunkANKDK5DFcjs.safeMax.call(void 0, gaps);
+  const maxGap = _chunkHR2XNERBcjs.safeMax.call(void 0, gaps);
   const avgLen = items.reduce((s, i) => s + i.text.length, 0) / items.length;
   return maxGap < 40 && avgLen < 5;
 }
 function detectColumns(yLines) {
   const allItems = yLines.flat();
   if (allItems.length === 0) return null;
-  const pageWidth = _chunkANKDK5DFcjs.safeMax.call(void 0, allItems.map((i) => i.x + i.w)) - _chunkANKDK5DFcjs.safeMin.call(void 0, allItems.map((i) => i.x));
+  const pageWidth = _chunkHR2XNERBcjs.safeMax.call(void 0, allItems.map((i) => i.x + i.w)) - _chunkHR2XNERBcjs.safeMin.call(void 0, allItems.map((i) => i.x));
   if (pageWidth < 100) return null;
   let bigoLineIdx = -1;
   for (let i = 0; i < yLines.length; i++) {
@@ -3678,7 +3678,7 @@ function extractBlocksWithGrids(items, pageNum, grids, horizontals, verticals) {
     if (gutterX !== null) {
       const gx = gutterX;
       const allY = remaining.map((i) => i.y);
-      const pageH = _chunkANKDK5DFcjs.safeMax.call(void 0, allY) - _chunkANKDK5DFcjs.safeMin.call(void 0, allY);
+      const pageH = _chunkHR2XNERBcjs.safeMax.call(void 0, allY) - _chunkHR2XNERBcjs.safeMin.call(void 0, allY);
       const gapThreshold = Math.max(15, pageH * 0.03);
       const sides = [
         remaining.filter((i) => i.x + i.w <= gx),
@@ -3698,7 +3698,7 @@ function extractBlocksWithGrids(items, pageNum, grids, horizontals, verticals) {
       finalTextBlocks = detectListBlocks(textBlocks);
     } else {
       const allY = remaining.map((i) => i.y);
-      const pageH = _chunkANKDK5DFcjs.safeMax.call(void 0, allY) - _chunkANKDK5DFcjs.safeMin.call(void 0, allY);
+      const pageH = _chunkHR2XNERBcjs.safeMax.call(void 0, allY) - _chunkHR2XNERBcjs.safeMin.call(void 0, allY);
       const groups = xyCutOrder(remaining, Math.max(15, pageH * 0.03));
       const textBlocks = [];
       for (const group of groups) {
@@ -3906,7 +3906,7 @@ function extractPageBlocksFallback(items, pageNum, fullPage = false, detectTable
       blocks.push({ type: "paragraph", text: tableText, pageNumber: pageNum, bbox, style: dominantStyle(items) });
     } else {
       const allY = items.map((i) => i.y);
-      const pageHeight = _chunkANKDK5DFcjs.safeMax.call(void 0, allY) - _chunkANKDK5DFcjs.safeMin.call(void 0, allY);
+      const pageHeight = _chunkHR2XNERBcjs.safeMax.call(void 0, allY) - _chunkHR2XNERBcjs.safeMin.call(void 0, allY);
       const gapThreshold = Math.max(15, pageHeight * 0.03);
       const orderedGroups = proseCutX !== null ? splitTwoColumnProse(items, proseCutX) : xyCutOrder(items, gapThreshold);
       for (const group of orderedGroups) {
@@ -3945,4 +3945,4 @@ function extractPageBlocksFallback(items, pageNum, fullPage = false, detectTable
 
 
 exports.extractImageRegions = extractImageRegions; exports.filterHiddenText = filterHiddenText; exports.collapseEvenSpacing = collapseEvenSpacing; exports.normalizeItems = normalizeItems; exports.computeMedianFontSizeFromFreq = computeMedianFontSizeFromFreq; exports.detectHeadings = detectHeadings; exports.detectMarkerHeadings = detectMarkerHeadings; exports.detectTableCaptions = detectTableCaptions; exports.detectKoreanListBlocks = detectKoreanListBlocks; exports.removeHeaderFooterBlocks = removeHeaderFooterBlocks; exports.extractPageBlocksWithLines = extractPageBlocksWithLines; exports.mergeCrossPageTables = mergeCrossPageTables;
-//# sourceMappingURL=chunk-WAPKUYGP.cjs.map
+//# sourceMappingURL=chunk-247ANM72.cjs.map