kordoc 4.10.0 → 4.12.0

package/README.md

@@ -89,6 +89,24 @@ MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
 
 ---
 
+## v4.12.0 변경사항
+
+v4.11.0 이 걷어낸 HWP3 유실의 **잔여 전량**을 처리했습니다. rhwp `samples/` 의 HWP3 원본 9종을 한컴 변환본과 문자 멀티셋으로 대조하면, 이제 변환본에만 있는 문자는 그림 대체텍스트를 빼면 **0** 입니다.
+
+- **🖼️ 그리기 개체 안 글상자 텍스트 회수 (#73)**: HWP3 의 ch=11(그림) 확장 블록은 `pic_type` 이 3 이면 그림이 아니라 **그리기 개체 트리**입니다. 표지 제목·순서도 라벨처럼 눈에 잘 띄는 본문이 그 안 글상자에 들어가는데, 종전에는 블록을 통째로 건너뛰어 사라졌습니다(sample16 618자, sample19 86자). 프레임 헤더 → 도형 트리(형제·자식 비트)를 훑어 글상자 문단 리스트를 본문과 같은 파서로 읽습니다. 비-글상자 도형이 '글상자로 만들기' 로 같은 블록을 실은 경우도, **잉여 길이가 스펙 표 78 과 정확히 맞을 때만** 회수합니다. 트리 해석은 확장 블록 슬라이스 안에서만 하므로 실패해도 본문 스트림 동기가 깨지지 않고 종전 동작으로 되돌아갑니다(재귀 256단계·도형 4,096개 상한).
+- **🔣 비가시 마커가 대체 문자로 새던 것**: 새 번호·쪽 번호 위치·쪽 감추기 제어 문자 자리에 ``(U+FFFC)를 심어 마크다운에 그대로 남았습니다. 한글도 그 자리에 아무 글자를 내지 않습니다 — 차례 표식과 같은 계약으로 맞췄습니다.
+
+## v4.11.0 변경사항
+
+rhwp 최신 devel(v0.8.3~0.8.4)을 훑어 kordoc 의 HWP3 디코더에 반영했습니다. 네 결함 모두 **글자가 경고 없이 사라지는** 형태라, 변환은 성공했는데 본문 일부가 비어 있는 식으로만 드러납니다.
+
+- **🈳 HWP3 기호·한자 유실 (완성형 좌표 규칙 누락)**: HWP3 은 KS X 1001 기호행(0xA1~0xAC)을 행 간격 96, 한자행(0xCA~0xFD)을 행 간격 94 로 편 코드에 문자를 담습니다. rhwp 에서 johab 디코더를 포팅할 때 하드코딩 표만 옮기고 **이 규칙 두 개를 빠뜨려**, 표에 없는 코드는 전부 삭제됐습니다 — `채권(債權)조서` 가 `채권()조서` 가 되고 `※ ○ 【】 ∴ ☞ ￦ ━` 같은 기호가 통째로 사라집니다. 규칙을 이식하고, 표준 매핑과 한컴 표기가 갈리는 두 자리(`∼→～`, `⊙→◉`)를 보정했습니다.
+- **🔤 사적 코드 실측 표 확장**: 라틴 확장(`ü·ö·ä·ß` 가 지워져 "für"→"fr" 이 되던 것)과 rhwp #5860 의 실측 28코드를 이식하고, rhwp 표에도 없던 코드를 직접 실측해 더했습니다 — 괘선 조각 6종, 겹줄, 원문자·괄호문자 계열(`⓪①②`·`ⓐ~ⓕ`·`㉠~㉢`), 글머리표 `•` 등. 근거는 HWP3 원본과 같은 문서의 한컴 변환본을 문맥 정렬한 것으로, **코드 출현 횟수가 변환본의 해당 문자 개수와 정확히 맞는 것만** 실었습니다.
+- **✒️ 초성 없는 아래아 음절 유실**: 초성이 '채움'인 아래아 음절(`ㆍ` 단독)을 무효 초성으로 보고 버렸습니다. 한컴 변환본과 같이 자모 하나로 남깁니다.
+- **🧱 서식 run 이 PUA 정리를 건너뛰던 결함 (전 포맷)**: 굵게·밑줄이 걸린 문단은 span 경로를 타는데 여기서만 PUA 치환·제거를 하지 않아, 한컴 전용 글머리표·괘선 조각이 **원시 PUA(두부 문자) 그대로** 마크다운에 실렸습니다. HWP5·HWPX·HWP3 공통 경로입니다. 함께 rhwp 의 한컴 PUA 검증표(한컴 PDF 대조 확정)에서 빠져 있던 22종(`┌┬┐└┘│`·`┈═━`·`⓪①②④~⑨`·`✺◇▸□`·`⊞⊟`)을 동기화했습니다.
+
+검증은 rhwp `samples/` 의 HWP3 원본 9종을 같은 문서의 한컴 변환본과 문자 멀티셋으로 대조했습니다. 변환본에만 있는 문자(=HWP3 경로에서 잃은 문자)가 `hwp3-sample11` 189→0, `hwp3-sample16` 1,139→618, `hwp3-sample10` 172→11 로 줄었습니다. 남은 618자는 **그리기 개체 안 글상자**(표지 제목·순서도 라벨)로, kordoc 은 아직 그리기 개체를 건너뜁니다.
+
 ## v4.10.0 변경사항
 
 - **📡 실패 계약 전 포맷 확장 (#69)**: 실패 JSON(`success:false` + `code`)이 `--format json` 전용에서 **markdown·chunks 포함 전 포맷**으로 확장됐습니다. 헤드리스 파이프라인이 stderr 한국어 문구 파싱 없이 원인 코드로 분기할 수 있습니다. `code` 값 집합·종료 코드 규칙·안정성 보증을 README [실패 계약](#실패-계약--기계-판독-가능한-실패-json-v4100-69) 표로 문서화했습니다. (@sorbetsharkroundhand 제보)

package/dist/{-AN4MKOOO.js → -B3EUUBPV.js}

@@ -56,7 +56,7 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-4EJLRZ7A.js";
+} from "./chunk-PFUW4I4I.js";
 import "./chunk-7FCNOKOR.js";
 import "./chunk-N3DLQ2YH.js";
 import "./chunk-MOL7MDBG.js";
@@ -66,7 +66,7 @@ import {
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-EWUFLCRP.js";
+} from "./chunk-TF5DS74F.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -74,10 +74,10 @@ import {
 } from "./chunk-DZIXKL7E.js";
 import {
   blocksToChunks
-} from "./chunk-F3OPGGQ2.js";
+} from "./chunk-YASFVKDT.js";
 import {
   blocksToMarkdown
-} from "./chunk-B4MQXOU5.js";
+} from "./chunk-GHVXLV52.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -87,11 +87,11 @@ import {
   renderHwpxToSvg,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-QYXQJPB7.js";
-import "./chunk-JAY6BXZ6.js";
+} from "./chunk-46UDI56N.js";
+import "./chunk-I2OETEEL.js";
 import {
   VERSION
-} from "./chunk-NMXDXHHW.js";
+} from "./chunk-4PKNWBXJ.js";
 export {
   BUILTIN_TEMPLATES,
   DEFAULT_REDACT_RULES,
@@ -169,4 +169,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-AN4MKOOO.js.map
+//# sourceMappingURL=-B3EUUBPV.js.map

package/dist/{chunk-KEF4UQYI.js → chunk-2IR3PEZU.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   KordocError
-} from "./chunk-NMXDXHHW.js";
+} from "./chunk-4PKNWBXJ.js";
 
 // src/shared/offline.ts
 import { realpathSync } from "fs";
@@ -49,4 +49,4 @@ export {
   getAccessRoot,
   assertWithinRoot
 };
-//# sourceMappingURL=chunk-KEF4UQYI.js.map
+//# sourceMappingURL=chunk-2IR3PEZU.js.map

package/dist/{chunk-QYXQJPB7.js → chunk-46UDI56N.js}

@@ -7,11 +7,11 @@ import {
   createXmlParser,
   findChildByLocalName,
   parseRenderStyles
-} from "./chunk-JAY6BXZ6.js";
+} from "./chunk-I2OETEEL.js";
 import {
   KordocError,
   precheckZipSize
-} from "./chunk-NMXDXHHW.js";
+} from "./chunk-4PKNWBXJ.js";
 
 // src/render/svg-render.ts
 import JSZip from "jszip";
@@ -1286,4 +1286,4 @@ export {
   fitRatioForFewerLines,
   renderHwpxToSvg
 };
-//# sourceMappingURL=chunk-QYXQJPB7.js.map
+//# sourceMappingURL=chunk-46UDI56N.js.map

package/dist/{chunk-NMXDXHHW.js → chunk-4PKNWBXJ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/utils.ts
-var VERSION = true ? "4.10.0" : "0.0.0-dev";
+var VERSION = true ? "4.12.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-NMXDXHHW.js.map
+//# sourceMappingURL=chunk-4PKNWBXJ.js.map

package/dist/{chunk-WLUDCIOK.js → chunk-7JQ2ITT2.js}

@@ -1,6 +1,6 @@
 import {
   KordocError
-} from "./chunk-7UUQXASL.js";
+} from "./chunk-MJPRWCI5.js";
 
 // src/pdf/formula/models.ts
 import { createHash } from "crypto";
@@ -266,4 +266,4 @@ export {
   ensureFormulaModels,
   ensureSingleModel
 };
-//# sourceMappingURL=chunk-WLUDCIOK.js.map
+//# sourceMappingURL=chunk-7JQ2ITT2.js.map

package/dist/{chunk-ZOLKTMBS.cjs → chunk-AT23GFSK.cjs}

@@ -6,7 +6,7 @@ var _chunkT7GRHAIWcjs = require('./chunk-T7GRHAIW.cjs');
 
 
 
-var _chunk4SIKWOLQcjs = require('./chunk-4SIKWOLQ.cjs');
+var _chunkBQSWSMRGcjs = require('./chunk-BQSWSMRG.cjs');
 
 // src/pdf/image-regions.ts
 var _pdfmjs = require('pdfjs-dist/legacy/build/pdf.mjs');
@@ -2834,14 +2834,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 = _chunk4SIKWOLQcjs.safeMax.call(void 0, gaps);
+  const maxGap = _chunkBQSWSMRGcjs.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 = _chunk4SIKWOLQcjs.safeMax.call(void 0, allItems.map((i) => i.x + i.w)) - _chunk4SIKWOLQcjs.safeMin.call(void 0, allItems.map((i) => i.x));
+  const pageWidth = _chunkBQSWSMRGcjs.safeMax.call(void 0, allItems.map((i) => i.x + i.w)) - _chunkBQSWSMRGcjs.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++) {
@@ -3419,7 +3419,7 @@ function extractBlocksWithGrids(items, pageNum, grids, horizontals, verticals) {
     if (gutterX !== null) {
       const gx = gutterX;
       const allY = remaining.map((i) => i.y);
-      const pageH = _chunk4SIKWOLQcjs.safeMax.call(void 0, allY) - _chunk4SIKWOLQcjs.safeMin.call(void 0, allY);
+      const pageH = _chunkBQSWSMRGcjs.safeMax.call(void 0, allY) - _chunkBQSWSMRGcjs.safeMin.call(void 0, allY);
       const gapThreshold = Math.max(15, pageH * 0.03);
       const sides = [
         remaining.filter((i) => i.x + i.w <= gx),
@@ -3439,7 +3439,7 @@ function extractBlocksWithGrids(items, pageNum, grids, horizontals, verticals) {
       finalTextBlocks = detectListBlocks(textBlocks);
     } else {
       const allY = remaining.map((i) => i.y);
-      const pageH = _chunk4SIKWOLQcjs.safeMax.call(void 0, allY) - _chunk4SIKWOLQcjs.safeMin.call(void 0, allY);
+      const pageH = _chunkBQSWSMRGcjs.safeMax.call(void 0, allY) - _chunkBQSWSMRGcjs.safeMin.call(void 0, allY);
       const groups = xyCutOrder(remaining, Math.max(15, pageH * 0.03));
       const textBlocks = [];
       for (const group of groups) {
@@ -3647,7 +3647,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 = _chunk4SIKWOLQcjs.safeMax.call(void 0, allY) - _chunk4SIKWOLQcjs.safeMin.call(void 0, allY);
+      const pageHeight = _chunkBQSWSMRGcjs.safeMax.call(void 0, allY) - _chunkBQSWSMRGcjs.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) {
@@ -3686,4 +3686,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-ZOLKTMBS.cjs.map
+//# sourceMappingURL=chunk-AT23GFSK.cjs.map