kordoc 4.2.2 → 4.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/README.md +14 -2
  2. package/dist/{-NFHVGTVM.js → -GJYDKVQD.js} +9 -9
  3. package/dist/{chunk-WMU2KJHF.cjs → chunk-5AXGFJQO.cjs} +4 -4
  4. package/dist/{chunk-WMU2KJHF.cjs.map → chunk-5AXGFJQO.cjs.map} +1 -1
  5. package/dist/{chunk-EFF2JPPA.cjs → chunk-AA6UPPZF.cjs} +9 -9
  6. package/dist/{chunk-EFF2JPPA.cjs.map → chunk-AA6UPPZF.cjs.map} +1 -1
  7. package/dist/{chunk-LUJN3VFB.js → chunk-CGFWS3BQ.js} +3 -3
  8. package/dist/{chunk-KKZATKQW.cjs → chunk-CWP56BRC.cjs} +2 -2
  9. package/dist/{chunk-KKZATKQW.cjs.map → chunk-CWP56BRC.cjs.map} +1 -1
  10. package/dist/{chunk-DSL6EVFJ.js → chunk-DE6FORIP.js} +2 -2
  11. package/dist/{chunk-T4AWY45Q.js → chunk-ELRVXOMP.js} +2 -2
  12. package/dist/{chunk-DLFZAU4X.cjs → chunk-FF5QNEKZ.cjs} +3 -3
  13. package/dist/{chunk-DLFZAU4X.cjs.map → chunk-FF5QNEKZ.cjs.map} +1 -1
  14. package/dist/{chunk-ZF7QL4IY.js → chunk-GJO3ORFW.js} +1 -1
  15. package/dist/chunk-GJO3ORFW.js.map +1 -0
  16. package/dist/{chunk-IXHBRMDB.js → chunk-K5LGSH5T.js} +2 -2
  17. package/dist/{chunk-MYD3QLBL.js → chunk-LMNSIPWZ.js} +2 -2
  18. package/dist/{chunk-X77U36TV.js → chunk-LPWP4FWU.js} +2 -2
  19. package/dist/{chunk-L5B7PQOP.js → chunk-NIPPOAT6.js} +2 -2
  20. package/dist/{chunk-MOOVF6CT.js → chunk-NOMNOG74.js} +2 -2
  21. package/dist/{chunk-GUYIXVV7.js → chunk-QNVZAKUQ.js} +2 -2
  22. package/dist/chunk-QNVZAKUQ.js.map +1 -0
  23. package/dist/{chunk-2L7MIKOM.js → chunk-RAS3HM4X.js} +2 -2
  24. package/dist/{chunk-OLDIDBJ2.js → chunk-U6XYOV32.js} +3 -3
  25. package/dist/{chunk-GHMVNMUN.js → chunk-WTJIRGPN.js} +3 -3
  26. package/dist/{chunk-TXYQJXOV.js → chunk-WX75LYAS.js} +89 -30
  27. package/dist/chunk-WX75LYAS.js.map +1 -0
  28. package/dist/{chunk-FHYLLKIP.js → chunk-X634MXVJ.js} +2 -2
  29. package/dist/chunks-JOGD2KUK.js +10 -0
  30. package/dist/cli.js +18 -18
  31. package/dist/{image-ocr-S4REURLR.js → image-ocr-O3YQ3KEN.js} +5 -5
  32. package/dist/{image-ocr-TGHAMIQL.js → image-ocr-PLTV4NOK.js} +4 -4
  33. package/dist/{image-ocr-3AFBDDJI.cjs → image-ocr-TCJLNMTG.cjs} +9 -9
  34. package/dist/{image-ocr-3AFBDDJI.cjs.map → image-ocr-TCJLNMTG.cjs.map} +1 -1
  35. package/dist/index.cjs +506 -447
  36. package/dist/index.cjs.map +1 -1
  37. package/dist/index.d.cts +7 -2
  38. package/dist/index.d.ts +7 -2
  39. package/dist/index.js +84 -25
  40. package/dist/index.js.map +1 -1
  41. package/dist/mcp.js +15 -15
  42. package/dist/{parser-C3APVZGT.js → parser-UX5T6KTZ.js} +6 -6
  43. package/dist/{parser-MRM6WICO.cjs → parser-VQIJPCI5.cjs} +24 -24
  44. package/dist/{parser-MRM6WICO.cjs.map → parser-VQIJPCI5.cjs.map} +1 -1
  45. package/dist/{parser-KMC4YOZH.js → parser-Y2X4JMAK.js} +5 -5
  46. package/dist/{pdf-ocr-UURMV6FD.js → pdf-ocr-DOPZP6QS.js} +5 -5
  47. package/dist/pdf-ocr-I3Y6YF5K.js +12 -0
  48. package/dist/pdf-ocr-XMDJ2IF5.cjs +13 -0
  49. package/dist/{pdf-ocr-5BRMIJAT.cjs.map → pdf-ocr-XMDJ2IF5.cjs.map} +1 -1
  50. package/dist/{profile-io-RLQ62KS5.js → profile-io-EGVJAZDG.js} +3 -3
  51. package/dist/{rasterize-LBABF2WI.js → rasterize-TH26U5E2.js} +2 -2
  52. package/dist/render-C4R3OJ45.js +10 -0
  53. package/dist/seal-JF2J4S52.js +10 -0
  54. package/dist/{setup-Q2PRE7UA.js → setup-GUQT5ELJ.js} +23 -3
  55. package/dist/setup-GUQT5ELJ.js.map +1 -0
  56. package/dist/{watch-XEUEGOXW.js → watch-4SP7V6SV.js} +9 -9
  57. package/package.json +1 -1
  58. package/dist/chunk-GUYIXVV7.js.map +0 -1
  59. package/dist/chunk-TXYQJXOV.js.map +0 -1
  60. package/dist/chunk-ZF7QL4IY.js.map +0 -1
  61. package/dist/chunks-N4CWHTJI.js +0 -10
  62. package/dist/pdf-ocr-5BRMIJAT.cjs +0 -13
  63. package/dist/pdf-ocr-UDTEQEWA.js +0 -12
  64. package/dist/render-CYXQEHS7.js +0 -10
  65. package/dist/seal-SV6PFFYU.js +0 -10
  66. package/dist/setup-Q2PRE7UA.js.map +0 -1
  67. /package/dist/{-NFHVGTVM.js.map → -GJYDKVQD.js.map} +0 -0
  68. /package/dist/{chunk-LUJN3VFB.js.map → chunk-CGFWS3BQ.js.map} +0 -0
  69. /package/dist/{chunk-DSL6EVFJ.js.map → chunk-DE6FORIP.js.map} +0 -0
  70. /package/dist/{chunk-T4AWY45Q.js.map → chunk-ELRVXOMP.js.map} +0 -0
  71. /package/dist/{chunk-IXHBRMDB.js.map → chunk-K5LGSH5T.js.map} +0 -0
  72. /package/dist/{chunk-MYD3QLBL.js.map → chunk-LMNSIPWZ.js.map} +0 -0
  73. /package/dist/{chunk-X77U36TV.js.map → chunk-LPWP4FWU.js.map} +0 -0
  74. /package/dist/{chunk-L5B7PQOP.js.map → chunk-NIPPOAT6.js.map} +0 -0
  75. /package/dist/{chunk-MOOVF6CT.js.map → chunk-NOMNOG74.js.map} +0 -0
  76. /package/dist/{chunk-2L7MIKOM.js.map → chunk-RAS3HM4X.js.map} +0 -0
  77. /package/dist/{chunk-OLDIDBJ2.js.map → chunk-U6XYOV32.js.map} +0 -0
  78. /package/dist/{chunk-GHMVNMUN.js.map → chunk-WTJIRGPN.js.map} +0 -0
  79. /package/dist/{chunk-FHYLLKIP.js.map → chunk-X634MXVJ.js.map} +0 -0
  80. /package/dist/{chunks-N4CWHTJI.js.map → chunks-JOGD2KUK.js.map} +0 -0
  81. /package/dist/{image-ocr-S4REURLR.js.map → image-ocr-O3YQ3KEN.js.map} +0 -0
  82. /package/dist/{image-ocr-TGHAMIQL.js.map → image-ocr-PLTV4NOK.js.map} +0 -0
  83. /package/dist/{parser-C3APVZGT.js.map → parser-UX5T6KTZ.js.map} +0 -0
  84. /package/dist/{parser-KMC4YOZH.js.map → parser-Y2X4JMAK.js.map} +0 -0
  85. /package/dist/{pdf-ocr-UDTEQEWA.js.map → pdf-ocr-DOPZP6QS.js.map} +0 -0
  86. /package/dist/{pdf-ocr-UURMV6FD.js.map → pdf-ocr-I3Y6YF5K.js.map} +0 -0
  87. /package/dist/{profile-io-RLQ62KS5.js.map → profile-io-EGVJAZDG.js.map} +0 -0
  88. /package/dist/{rasterize-LBABF2WI.js.map → rasterize-TH26U5E2.js.map} +0 -0
  89. /package/dist/{render-CYXQEHS7.js.map → render-C4R3OJ45.js.map} +0 -0
  90. /package/dist/{seal-SV6PFFYU.js.map → seal-JF2J4S52.js.map} +0 -0
  91. /package/dist/{watch-XEUEGOXW.js.map → watch-4SP7V6SV.js.map} +0 -0
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  KordocError
4
- } from "./chunk-2L7MIKOM.js";
4
+ } from "./chunk-RAS3HM4X.js";
5
5
 
6
6
  // src/hwpx/profile-io.ts
7
7
  import { z } from "zod";
@@ -89,4 +89,4 @@ export {
89
89
  formatProfileSchema,
90
90
  parseFormatProfileJson
91
91
  };
92
- //# sourceMappingURL=chunk-MYD3QLBL.js.map
92
+ //# sourceMappingURL=chunk-LMNSIPWZ.js.map
@@ -4,7 +4,7 @@ import {
4
4
  HEADING_RATIO_H3,
5
5
  safeMax,
6
6
  safeMin
7
- } from "./chunk-GUYIXVV7.js";
7
+ } from "./chunk-QNVZAKUQ.js";
8
8
 
9
9
  // src/pdf/image-regions.ts
10
10
  import { OPS } from "pdfjs-dist/legacy/build/pdf.mjs";
@@ -3340,4 +3340,4 @@ export {
3340
3340
  extractPageBlocksWithLines,
3341
3341
  mergeCrossPageTables
3342
3342
  };
3343
- //# sourceMappingURL=chunk-X77U36TV.js.map
3343
+ //# sourceMappingURL=chunk-LPWP4FWU.js.map
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  blocksToMarkdown
4
- } from "./chunk-DSL6EVFJ.js";
4
+ } from "./chunk-DE6FORIP.js";
5
5
 
6
6
  // src/chunks.ts
7
7
  var LIST_MARKER_RE = /^(?:[□■◇◆○◎●◦ㅇ•▪▸▶※-]|\d{1,3}[.)]|[가나다라마바사아자차카타파하][.)]|\([가나다라마바사아자차카타파하0-9]{1,3}\)|[①-⑳㉮-㉻㈎-㈛])\s/;
@@ -79,4 +79,4 @@ function blocksToChunks(blocks, options) {
79
79
  export {
80
80
  blocksToChunks
81
81
  };
82
- //# sourceMappingURL=chunk-L5B7PQOP.js.map
82
+ //# sourceMappingURL=chunk-NIPPOAT6.js.map
@@ -4,7 +4,7 @@ import {
4
4
  } from "./chunk-J2RZ444H.js";
5
5
  import {
6
6
  extractPageBlocksWithLines
7
- } from "./chunk-X77U36TV.js";
7
+ } from "./chunk-LPWP4FWU.js";
8
8
 
9
9
  // src/ocr/ruling-lines.ts
10
10
  var INK_LUMA_MAX = 190;
@@ -557,4 +557,4 @@ export {
557
557
  runPdfOcr,
558
558
  ocrItemsToBlocks
559
559
  };
560
- //# sourceMappingURL=chunk-MOOVF6CT.js.map
560
+ //# sourceMappingURL=chunk-NOMNOG74.js.map
@@ -1,5 +1,5 @@
1
1
  // src/utils.ts
2
- var VERSION = true ? "4.2.2" : "0.0.0-dev";
2
+ var VERSION = true ? "4.2.3" : "0.0.0-dev";
3
3
  function toArrayBuffer(buf) {
4
4
  if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
5
5
  return buf.buffer;
@@ -127,4 +127,4 @@ export {
127
127
  HEADING_RATIO_H2,
128
128
  HEADING_RATIO_H3
129
129
  };
130
- //# sourceMappingURL=chunk-GUYIXVV7.js.map
130
+ //# sourceMappingURL=chunk-QNVZAKUQ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils.ts","../src/types.ts"],"sourcesContent":["/** kordoc 공용 유틸리티 */\n\n/** 빌드 타임에 tsup define으로 주입되는 버전 */\ndeclare const __KORDOC_VERSION__: string\nexport const VERSION: string = typeof __KORDOC_VERSION__ !== \"undefined\" ? __KORDOC_VERSION__ : \"0.0.0-dev\"\n\n/**\n * Node.js Buffer → ArrayBuffer 변환\n * pool Buffer의 공유 ArrayBuffer 문제를 안전하게 처리.\n * offset=0이고 전체 ArrayBuffer를 차지하면 복사 없이 직접 반환.\n */\nexport function toArrayBuffer(buf: Buffer): ArrayBuffer {\n if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {\n return buf.buffer as ArrayBuffer\n }\n return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n}\n\n/**\n * kordoc 내부 에러 클래스 — 사용자에게 노출해도 안전한 메시지만 포함.\n * MCP 에러 정제에서 instanceof로 판별하여 allowlist 패턴 매칭 없이 안전하게 통과.\n */\nexport class KordocError extends Error {\n constructor(message: string) {\n super(message)\n this.name = \"KordocError\"\n }\n}\n\n/**\n * 에러 메시지 정제 — KordocError는 그대로, 나머지는 일반 메시지로 대체.\n * 파일시스템 경로, 스택 트레이스 등 내부 정보 노출 방지.\n */\nexport function sanitizeError(err: unknown): string {\n if (err instanceof KordocError) return err.message\n return \"문서 처리 중 오류가 발생했습니다\"\n}\n\n/**\n * ZIP 엔트리 경로의 경로 순회 여부 판별.\n * 백슬래시 정규화, .., 절대경로, Windows 드라이브 문자 모두 차단.\n */\nexport function isPathTraversal(name: string): boolean {\n if (name.includes(\"\\x00\")) return true\n const normalized = name.replace(/\\\\/g, \"/\")\n const segments = normalized.split(\"/\")\n return segments.some(s => s === \"..\") || normalized.startsWith(\"/\") || /^[A-Za-z]:/.test(normalized)\n}\n\n// ─── HWPX 섹션 href 해석 (parser/roundtrip 공용) ────────────────────\n\n/**\n * manifest href를 본문 섹션 경로(`Contents/sectionN.xml`)로 정규화.\n * 비본문 XML(header/script/settings)·path traversal·드라이브 경로는 null로 거른다.\n * 백슬래시 구분자를 슬래시로 통일해 parser와 roundtrip이 동일한 목록을 만든다.\n */\nexport function normalizeSectionHref(href: string): string | null {\n if (!href) return null\n let normalized = href.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\")\n if (isPathTraversal(normalized)) return null\n if (/^[Ss]ection\\d+\\.xml$/.test(normalized)) normalized = \"Contents/\" + normalized\n return /(?:^|\\/)[Ss]ection\\d+\\.xml$/.test(normalized) ? normalized : null\n}\n\n/** sectionN.xml을 N 숫자 순서로 정렬 (section10 > section2). */\nexport function compareSectionPaths(a: string, b: string): number {\n const ai = Number(a.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n const bi = Number(b.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n return ai === bi ? a.localeCompare(b) : ai - bi\n}\n\n// ─── ZIP 안전 로딩 (ZIP bomb 방지) ────────────────────\n\n/**\n * ZIP bomb 사전 검사 — Central Directory에서 비압축 합계와 엔트리 수 확인.\n * HWPX/XLSX/DOCX 등 모든 ZIP 기반 포맷에서 공통 사용.\n */\nexport function precheckZipSize(\n buffer: ArrayBuffer,\n maxUncompressedSize = 256 * 1024 * 1024, // parser-shared MAX_DECOMPRESS_SIZE 와 동기\n maxEntries = 500,\n): { totalUncompressed: number; entryCount: number } {\n try {\n const data = new DataView(buffer)\n const len = buffer.byteLength\n // EOCD 시그니처 역방향 스캔\n let eocdOffset = -1\n for (let i = len - 22; i >= Math.max(0, len - 65557); i--) {\n if (data.getUint32(i, true) === 0x06054b50) { eocdOffset = i; break }\n }\n if (eocdOffset < 0) return { totalUncompressed: 0, entryCount: 0 }\n\n const entryCount = data.getUint16(eocdOffset + 10, true)\n if (entryCount > maxEntries) {\n throw new KordocError(`ZIP 엔트리 수 초과: ${entryCount} (최대 ${maxEntries})`)\n }\n\n const cdSize = data.getUint32(eocdOffset + 12, true)\n const cdOffset = data.getUint32(eocdOffset + 16, true)\n if (cdOffset + cdSize > len) return { totalUncompressed: 0, entryCount }\n\n let totalUncompressed = 0\n let pos = cdOffset\n for (let i = 0; i < entryCount && pos + 46 <= cdOffset + cdSize; i++) {\n if (data.getUint32(pos, true) !== 0x02014b50) break\n totalUncompressed += data.getUint32(pos + 24, true)\n const nameLen = data.getUint16(pos + 28, true)\n const extraLen = data.getUint16(pos + 30, true)\n const commentLen = data.getUint16(pos + 32, true)\n pos += 46 + nameLen + extraLen + commentLen\n }\n\n if (totalUncompressed > maxUncompressedSize) {\n throw new KordocError(`ZIP 비압축 크기 초과: ${(totalUncompressed / 1024 / 1024).toFixed(1)}MB (최대 ${maxUncompressedSize / 1024 / 1024}MB)`)\n }\n\n return { totalUncompressed, entryCount }\n } catch (err) {\n if (err instanceof KordocError) throw err\n return { totalUncompressed: 0, entryCount: 0 }\n }\n}\n\n/** XXE/Billion Laughs 방지 — DOCTYPE 제거 (내부 DTD 서브셋 포함) */\nexport function stripDtd(xml: string): string {\n return xml.replace(/<!DOCTYPE\\s[^[>]*(\\[[\\s\\S]*?\\])?\\s*>/gi, \"\")\n}\n\n/** 하이퍼링크 URL 살균 — javascript: 등 XSS 위험 스킴 차단 */\nconst SAFE_HREF_RE = /^(?:https?:|mailto:|tel:|#)/i\nexport function sanitizeHref(href: string): string | null {\n const trimmed = href.trim()\n if (!trimmed || !SAFE_HREF_RE.test(trimmed)) return null\n // 괄호 percent-encoding — 마크다운 링크 목적지에서 불균형 ')'는 링크를 조기 종료시켜\n // 문법이 깨진다 (원문 하이퍼링크에 ')'가 박힌 실문서 존재). %28/%29는 의미 동일.\n return trimmed.replace(/\\(/g, \"%28\").replace(/\\)/g, \"%29\")\n}\n\n// ─── 안전한 min/max (스택 오버플로 방지) ─────────────\n\n/** Math.min(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMin(arr: number[]): number {\n let min = Infinity\n for (let i = 0; i < arr.length; i++) if (arr[i] < min) min = arr[i]\n return min\n}\n\n/** Math.max(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMax(arr: number[]): number {\n let max = -Infinity\n for (let i = 0; i < arr.length; i++) if (arr[i] > max) max = arr[i]\n return max\n}\n\n// ─── 에러 분류 ──────────────────────────────────────\n\nimport type { ErrorCode } from \"./types.js\"\n\n/** 에러를 구조화된 ErrorCode로 분류 — KordocError 메시지 패턴 매칭 */\nexport function classifyError(err: unknown): ErrorCode {\n if (!(err instanceof Error)) return \"PARSE_ERROR\"\n const msg = err.message\n if (msg.includes(\"암호화\")) return \"ENCRYPTED\"\n if (msg.includes(\"DRM\")) return \"DRM_PROTECTED\"\n if (msg.includes(\"ZIP bomb\") || msg.includes(\"ZIP 비압축 크기 초과\") || msg.includes(\"ZIP 엔트리 수 초과\")) return \"ZIP_BOMB\"\n if (msg.includes(\"bomb\") || msg.includes(\"크기 초과\") || msg.includes(\"압축 해제\")) return \"DECOMPRESSION_BOMB\"\n if (msg.includes(\"이미지 기반\")) return \"IMAGE_BASED_PDF\"\n if (msg.includes(\"섹션\") && (msg.includes(\"찾을 수 없\") || msg.includes(\"없음\"))) return \"NO_SECTIONS\"\n if (msg.includes(\"시그니처\") || msg.includes(\"복구할 수 없\")) return \"CORRUPTED\"\n return \"PARSE_ERROR\"\n}\n","/** kordoc 공통 타입 정의 */\n\n// ─── 중간 표현 (Intermediate Representation) ─────────\n\nexport interface CellContext {\n text: string\n colSpan: number\n rowSpan: number\n /** HWP5 셀 열 주소 (0-based) — 병합 테이블 배치용 */\n colAddr?: number\n /** HWP5 셀 행 주소 (0-based) — 병합 테이블 배치용 */\n rowAddr?: number\n}\n\n/** 블록 타입 — v2.0에서 heading, list, image, separator 추가 */\nexport type IRBlockType = \"paragraph\" | \"table\" | \"heading\" | \"list\" | \"image\" | \"separator\"\n\n/** 인라인 강조 run-span — 문단 텍스트를 서식 단위로 쪼갠 조각 (텍스트 연결 = block.text) */\nexport interface IRSpan {\n text: string\n bold?: boolean\n italic?: boolean\n strike?: boolean\n code?: boolean\n}\n\nexport interface IRBlock {\n type: IRBlockType\n text?: string\n table?: IRTable\n /** 헤딩 레벨 (1-6), type=\"heading\"일 때 사용 */\n level?: number\n /** 원본 페이지 번호 (1-based) */\n pageNumber?: number\n /** 바운딩 박스 — PDF에서만 제공 */\n bbox?: BoundingBox\n /** 텍스트 스타일 정보 (선택) */\n style?: InlineStyle\n /** 리스트 타입, type=\"list\"일 때 사용 */\n listType?: \"ordered\" | \"unordered\"\n /** 중첩 리스트 아이템 */\n children?: IRBlock[]\n /** 하이퍼링크 URL */\n href?: string\n /** 각주/미주 텍스트 (인라인 삽입용) */\n footnoteText?: string\n /** 이미지 데이터 (type=\"image\"일 때) */\n imageData?: ImageData\n /** 인라인 강조 run-span (선택 — kordoc 생성 hwpx 왕복 채널 + 외래 실속성 볼드/이탤릭).\n * 존재하면 마크다운 변환이 **·*·` 마커를 재방출한다 */\n spans?: IRSpan[]\n /** 인용문 문단 (선택 — kordoc 생성 hwpx 왕복 채널) — 마크다운 변환이 \"> \" 접두 재방출 */\n quote?: boolean\n /**\n * 문단 들여쓰기(HWPUNIT, 선택) — HWPX paraPr `<hh:margin>` 자식요소형 hc:left\n * (+양수 hc:intent 첫줄분). 마크다운 방출엔 쓰지 않는 관찰 슬롯 — gongmun 리스트\n * depth 재유도·양식 분석 등 소비자 몫 (v4.0.4)\n */\n indent?: number\n /**\n * gongmun 리스트 단계(1~7, 선택) — indent를 levelIndent 단위로 역산한 소비 결과\n * (v4.0.5). md 리스트 문법과 충돌하는 부호('- '·'1) ') 문단에만 채워지며,\n * 마크다운 변환이 2칸/단계 선행 공백을 방출해 재생성 시 depth가 복원된다\n */\n listDepth?: number\n}\n\n/** 추출된 이미지 바이너리 데이터 */\nexport interface ImageData {\n /** 이미지 바이너리 */\n data: Uint8Array\n /** MIME 타입 (image/png, image/jpeg, image/gif, image/bmp, image/wmf, image/emf) */\n mimeType: string\n /** 원본 파일명 (있는 경우) */\n filename?: string\n}\n\n/** 바운딩 박스 — PDF 포인트 단위 (72pt = 1인치) */\nexport interface BoundingBox {\n page: number\n x: number\n y: number\n width: number\n height: number\n}\n\n/** 인라인 텍스트 스타일 */\nexport interface InlineStyle {\n bold?: boolean\n italic?: boolean\n /** 취소선 — 법령 개정문 등의 삭제 표시. 판정은 취소선 모양 whitelist (비트만 믿으면 오탐) */\n strike?: boolean\n fontSize?: number\n fontName?: string\n}\n\nexport interface IRTable {\n rows: number\n cols: number\n cells: IRCell[][]\n /** 첫 행을 헤더로 렌더링할지 여부 (현재: rows > 1이면 true — 의미적 감지가 아닌 레이아웃 힌트) */\n hasHeader: boolean\n /** 표 캡션 (예: \"표 1. 부서별 예산\") — v3.0 */\n caption?: string\n}\n\nexport interface IRCell {\n text: string\n colSpan: number\n rowSpan: number\n /**\n * 셀 내부 블록 콘텐츠 — v3.0.\n * 중첩 표·이미지·다중 문단을 구조 그대로, 문서(원문) 순서대로 보존한다.\n * 표와 텍스트가 한 줄에 번갈아 놓인 셀도 배치 순서를 따른다 (v4.2.3, #49).\n * blocks가 있으면 text는 blocks의 평탄화 텍스트(하위 호환용)다.\n */\n blocks?: IRBlock[]\n /** 제목 셀 여부 (HWP5 width_ref bit2 / HWPX header 속성) — v3.0 */\n isHeader?: boolean\n}\n\n// ─── 메타데이터 ─────────────────────────────────────\n\n/** 문서 메타데이터 — 각 포맷에서 추출 가능한 필드만 채워짐 */\nexport interface DocumentMetadata {\n /** 문서 제목 */\n title?: string\n /** 작성자 */\n author?: string\n /** 작성 프로그램 (예: \"한글 2020\", \"Adobe Acrobat\") */\n creator?: string\n /** 생성일시 (ISO 8601) */\n createdAt?: string\n /** 수정일시 (ISO 8601) */\n modifiedAt?: string\n /** 페이지/섹션 수 */\n pageCount?: number\n /** 문서 포맷 버전 (예: HWP \"5.1.0.1\") */\n version?: string\n /** 설명 */\n description?: string\n /** 키워드 */\n keywords?: string[]\n}\n\n// ─── 파싱 옵션 ──────────────────────────────────────\n\n/** 파싱 옵션 — parse() 함수에 전달 */\nexport interface ParseOptions {\n /**\n * 파싱할 페이지/섹션 범위 (1-based).\n * - 배열: [1, 2, 3]\n * - 문자열: \"1-3\", \"1,3,5-7\"\n *\n * PDF: 정확한 페이지 단위. HWP/HWPX: 섹션 단위 근사치.\n */\n pages?: number[] | string\n /** 이미지 기반 PDF OCR (선택).\n * - `true`: 내장 엔진(PP-OCRv5 korean, ~18MB 자동 다운로드)으로 OCR 필요 판정\n * 페이지만 인식 (스캔 페이지·글꼴 매핑 깨진 페이지). 정상 페이지는 파싱 결과 유지.\n * - `\"force\"`: 전 페이지를 내장 엔진으로 강제 OCR.\n * - 함수: 사용자 제공 OcrProvider (Claude Vision·Tesseract 등) — 판정은 `true`와 동일. */\n ocr?: boolean | \"force\" | OcrProvider\n /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */\n onProgress?: (current: number, total: number) => void\n /** PDF 머리글/바닥글 자동 제거 */\n removeHeaderFooter?: boolean\n /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n * 기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n * 양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n keepTrailingEmptyCols?: boolean\n /** 원본 파일 경로 (DRM COM fallback에 필요, 내부 전용) */\n filePath?: string\n /**\n * PDF 수식 OCR 활성화 (기본 false).\n *\n * 활성화 시 각 PDF 페이지를 이미지로 렌더링 → YOLOv8 기반 수식 영역 검출 →\n * TrOCR 기반 LaTeX 인식. 감지된 수식은 `$...$` (inline) / `$$...$$` (display) 로\n * 블록 텍스트에 삽입된다.\n *\n * 필수 optional 의존성: `onnxruntime-node`, `@huggingface/transformers`,\n * `@hyzyla/pdfium`, `sharp`. 미설치 시 parse 에 실패하지 않고 **경고만** 남기고\n * 수식 인식은 skip 한다 (일반 텍스트 추출은 정상 동작).\n *\n * 모델(~155MB) 은 첫 사용 시 HuggingFace 에서 자동 다운로드 되어\n * `~/.cache/kordoc/models/pix2text/` 에 SHA-256 검증과 함께 저장된다.\n */\n formulaOcr?: boolean\n /**\n * 레이아웃 표 페이지 반복 헤더(러닝 헤더) 정리 휴리스틱 활성화 (기본 false).\n *\n * 구형 HWP5 문서가 페이지마다 재삽입한 짧은 번호매김 러닝 헤더\n * (\"2. 과제 구축 내용\")를 최초 1회만 남기고 이후 중복을 제거한다.\n * 다만 페이지 위치 정보가 없는 HWP5 특성상 이 휴리스틱은 정당하게 반복되는\n * 번호매김 문단(예: 붙임/별지별 재번호 \"1. 목적\")도 삭제할 수 있어 opt-in 으로\n * 둔다. 활성 시 제거가 발생하면 HIDDEN_TEXT_FILTERED 경고를 남긴다.\n */\n dedupeRunningHeaders?: boolean\n /**\n * 추출된 이미지를 마크다운에 base64 data URI 로 인라인 (기본 false).\n *\n * 활성화 시 `![image](image_001.bmp)` 참조를 `![image](data:image/png;base64,...)` 로\n * 치환한다. 임베드된 BMP 는 PNG 로 무손실 압축 후 인라인하여 용량을 크게 줄인다.\n * 별도 이미지 파일 없이 자체 완결형 마크다운이 되어 MCP/AI 에이전트 소비에 적합하다.\n * (현재 HWP5 경로 지원)\n */\n inlineImages?: boolean\n}\n\n// ─── 파싱 경고 ──────────────────────────────────────\n\n/** 파싱 중 스킵/실패한 요소 보고 */\nexport interface ParseWarning {\n /** 관련 페이지 번호 (알 수 있는 경우) */\n page?: number\n /** 경고 메시지 */\n message: string\n /** 구조화된 경고 코드 */\n code: WarningCode\n}\n\nexport type WarningCode =\n | \"SKIPPED_IMAGE\"\n | \"SKIPPED_OLE\"\n | \"TRUNCATED_TABLE\"\n | \"OCR_FALLBACK\"\n | \"UNSUPPORTED_ELEMENT\"\n | \"BROKEN_ZIP_RECOVERY\"\n | \"HIDDEN_TEXT_FILTERED\"\n | \"MALFORMED_XML\"\n | \"PARTIAL_PARSE\"\n | \"LENIENT_CFB_RECOVERY\"\n | \"NEEDS_OCR\"\n | \"OCR_FAILED\"\n | \"OCR_APPLIED\"\n | \"COM_EMPTY\"\n | \"DRM_COM_FALLBACK\"\n\n/** 문서 구조 (헤딩 트리) */\nexport interface OutlineItem {\n level: number\n text: string\n pageNumber?: number\n}\n\n// ─── 에러 코드 ──────────────────────────────────────\n\n/** 구조화된 에러 코드 — 프로그래밍적 에러 핸들링용 */\nexport type ErrorCode =\n | \"EMPTY_INPUT\"\n | \"UNSUPPORTED_FORMAT\"\n | \"ENCRYPTED\"\n | \"DRM_PROTECTED\"\n | \"CORRUPTED\"\n | \"DECOMPRESSION_BOMB\"\n | \"ZIP_BOMB\"\n | \"IMAGE_BASED_PDF\"\n | \"NO_SECTIONS\"\n | \"PARSE_ERROR\"\n | \"MISSING_DEPENDENCY\"\n\n// ─── 파싱 결과 (discriminated union) ────────────────\n\nexport type FileType = \"hwpx\" | \"hwp\" | \"hwp3\" | \"hwpml\" | \"pdf\" | \"xlsx\" | \"xls\" | \"docx\" | \"image\" | \"unknown\"\n\ninterface ParseResultBase {\n fileType: FileType\n /** 페이지/섹션 수 — PDF: 실제 페이지 수, HWP/HWPX: 섹션 수, XLSX: 시트 수 */\n pageCount?: number\n /** 이미지 기반 PDF 여부 (텍스트 추출 불가) */\n isImageBased?: boolean\n}\n\nexport interface ParseSuccess extends ParseResultBase {\n success: true\n /** 추출된 마크다운 텍스트 */\n markdown: string\n /**\n * 중간 표현 블록 (구조화된 데이터 접근용).\n * 블록은 문서(원문) 읽기 순서를 따른다 — 한 문단 안에 글자취급(treatAsChar)\n * 표와 텍스트가 섞여 있어도 배치 순서대로 방출된다 (v4.2.3, #50).\n */\n blocks: IRBlock[]\n /** 문서 메타데이터 */\n metadata?: DocumentMetadata\n /** 문서 구조 (헤딩 트리) — v2.0 */\n outline?: OutlineItem[]\n /** 파싱 중 발생한 경고 — v2.0 */\n warnings?: ParseWarning[]\n /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */\n images?: ExtractedImage[]\n /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */\n pageQuality?: PageQuality[]\n /** 문서 단위 품질 요약 — PDF에서만 제공 */\n qualitySummary?: DocumentQualitySummary\n}\n\n/** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */\nexport interface PageQuality {\n page: number\n textChars: number\n hangulRatio: number\n controlCharRatio: number\n replacementCharRatio: number\n puaRatio: number\n needsOcr: boolean\n ocrReason?: \"low_text\" | \"high_pua\" | \"high_control\" | \"high_replacement\" | \"garbled_hangul\"\n}\n\n/** 문서 단위 품질 요약 (PDF 전용). */\nexport interface DocumentQualitySummary {\n totalPages: number\n totalTextChars: number\n avgHangulRatio: number\n avgControlCharRatio: number\n avgReplacementCharRatio: number\n avgPuaRatio: number\n lowTextPageCount: number\n highPuaPageCount: number\n needsOcr: boolean\n ocrCandidatePages: number[]\n}\n\n/** 추출된 이미지 — ParseSuccess.images에 포함 */\nexport interface ExtractedImage {\n /** 마크다운에서 참조되는 파일명 (예: image_001.png) */\n filename: string\n /** 이미지 바이너리 */\n data: Uint8Array\n /** MIME 타입 */\n mimeType: string\n}\n\nexport interface ParseFailure extends ParseResultBase {\n success: false\n /** 오류 메시지 */\n error: string\n /** 구조화된 에러 코드 */\n code?: ErrorCode\n}\n\nexport type ParseResult = ParseSuccess | ParseFailure\n\n// ─── 문서 비교 (Diff) ───────────────────────────────\n\nexport type DiffChangeType = \"added\" | \"removed\" | \"modified\" | \"unchanged\"\n\nexport interface BlockDiff {\n type: DiffChangeType\n /** 원본 블록 (added이면 undefined) */\n before?: IRBlock\n /** 변경 후 블록 (removed이면 undefined) */\n after?: IRBlock\n /** modified 테이블의 셀 단위 diff */\n cellDiffs?: CellDiff[][]\n /** 유사도 (0-1) */\n similarity?: number\n}\n\nexport interface CellDiff {\n type: DiffChangeType\n before?: string\n after?: string\n}\n\nexport interface DiffResult {\n stats: { added: number; removed: number; modified: number; unchanged: number }\n diffs: BlockDiff[]\n}\n\n// ─── 라운드트립 패치 (v3.0) ─────────────────────────\n\n/** 패치 중 매핑 실패/미지원으로 건너뛴 항목 — silent 실패 금지 */\nexport interface PatchSkip {\n /** 건너뛴 사유 */\n reason: string\n /** 원본 쪽 내용 요약 (최대 80자) */\n before?: string\n /** 편집 쪽 내용 요약 (최대 80자) */\n after?: string\n /**\n * 부분 적용 표시 — 변경이 적용은 됐지만(applied 계상) 편집 원형 그대로는\n * 아님 (예: 셀 내 줄 추가를 마지막 문단에 병합). 완전 미적용 skip과 구분.\n */\n partial?: boolean\n}\n\n/** patchHwpx 옵션 */\nexport interface PatchOptions {\n /** 패치 후 재파싱 자동 검증 (기본 true) */\n verify?: boolean\n}\n\n/** patchHwpx / patchBlocks 결과 */\nexport interface PatchResult {\n success: boolean\n /** 패치된 HWPX (success=true) */\n data?: Uint8Array\n /** 적용된 변경 수 */\n applied: number\n /** 매핑 실패 항목 (이유 포함) */\n skipped: PatchSkip[]\n /**\n * 무손실 검증 (patchHwpx/patchHwp 전용): 패치본 재파싱 vs 편집 마크다운의\n * 잔차 diff — modified/added/removed가 0이어야 의도가 전부 반영된 것.\n * session.patchBlocks는 이 필드를 채우지 않는다 (changes 참조).\n */\n verification?: DiffResult\n /**\n * 변경 가시화 (session.patchBlocks 전용): 패치 전 → 후 문서 diff —\n * 적용된 편집 수만큼 modified가 나오는 것이 정상. verification과 의미가\n * 정반대이므로 혼용 금지.\n */\n changes?: DiffResult\n /** 실패 사유 (success=false) */\n error?: string\n}\n\n// ─── 양식 인식 ──────────────────────────────────────\n\nexport interface FormField {\n label: string\n value: string\n /** 0-based 소스 행 */\n row: number\n /** 0-based 소스 열 */\n col: number\n /** 매칭된 입력 키(정규화) — 모호 라벨 거부 가드(fillWithUniqueGuard)의 집계 기준 */\n key?: string\n}\n\nexport interface FormResult {\n fields: FormField[]\n /** 양식 확신도 (0-1) */\n confidence: number\n}\n\n// ─── OCR 프로바이더 ─────────────────────────────────\n\n/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 반환 */\nexport type OcrProvider = (\n pageImage: Uint8Array,\n pageNumber: number,\n mimeType: \"image/png\"\n) => Promise<string>\n\n// ─── Watch 모드 ─────────────────────────────────────\n\nexport interface WatchOptions {\n dir: string\n outDir?: string\n webhook?: string\n format?: \"markdown\" | \"json\"\n pages?: string\n silent?: boolean\n}\n\n// ─── 헤딩 감지 공통 임계값 ──────────────────────────\n\n/** 폰트 크기 비율 → heading level (전 파서 공통) */\nexport const HEADING_RATIO_H1 = 1.5\nexport const HEADING_RATIO_H2 = 1.3\nexport const HEADING_RATIO_H3 = 1.15\n\n// ─── 내부 파서 반환 타입 ─────────────────────────────\n\n/** 내부 파서가 index.ts에 반환하는 공통 타입 (HWP5/HWPX/PDF/XLSX/DOCX) */\nexport interface InternalParseResult {\n markdown: string\n blocks: IRBlock[]\n metadata?: DocumentMetadata\n outline?: OutlineItem[]\n warnings?: ParseWarning[]\n images?: ExtractedImage[]\n /** PDF 전용: 이미지 기반 PDF 여부 */\n isImageBased?: boolean\n /** PDF 전용: 페이지별 품질 신호 */\n pageQuality?: PageQuality[]\n /** PDF 전용: 문서 단위 품질 요약 */\n qualitySummary?: DocumentQualitySummary\n}\n"],"mappings":"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","names":[]}
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  // src/utils.ts
4
- var VERSION = true ? "4.2.2" : "0.0.0-dev";
4
+ var VERSION = true ? "4.2.3" : "0.0.0-dev";
5
5
  function toArrayBuffer(buf) {
6
6
  if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
7
7
  return buf.buffer;
@@ -121,4 +121,4 @@ export {
121
121
  safeMax,
122
122
  classifyError
123
123
  };
124
- //# sourceMappingURL=chunk-2L7MIKOM.js.map
124
+ //# sourceMappingURL=chunk-RAS3HM4X.js.map
@@ -3,11 +3,11 @@ import {
3
3
  HEADING_RATIO_H1,
4
4
  HEADING_RATIO_H2,
5
5
  HEADING_RATIO_H3
6
- } from "./chunk-ZF7QL4IY.js";
6
+ } from "./chunk-GJO3ORFW.js";
7
7
  import {
8
8
  safeMax,
9
9
  safeMin
10
- } from "./chunk-2L7MIKOM.js";
10
+ } from "./chunk-RAS3HM4X.js";
11
11
 
12
12
  // src/pdf/image-regions.ts
13
13
  import { OPS } from "pdfjs-dist/legacy/build/pdf.mjs";
@@ -3343,4 +3343,4 @@ export {
3343
3343
  extractPageBlocksWithLines,
3344
3344
  mergeCrossPageTables
3345
3345
  };
3346
- //# sourceMappingURL=chunk-OLDIDBJ2.js.map
3346
+ //# sourceMappingURL=chunk-U6XYOV32.js.map
@@ -7,11 +7,11 @@ import {
7
7
  createXmlParser,
8
8
  findChildByLocalName,
9
9
  parseRenderStyles
10
- } from "./chunk-FHYLLKIP.js";
10
+ } from "./chunk-X634MXVJ.js";
11
11
  import {
12
12
  KordocError,
13
13
  precheckZipSize
14
- } from "./chunk-2L7MIKOM.js";
14
+ } from "./chunk-RAS3HM4X.js";
15
15
 
16
16
  // src/render/svg-render.ts
17
17
  import JSZip from "jszip";
@@ -1281,4 +1281,4 @@ export {
1281
1281
  fitRatioForFewerLines,
1282
1282
  renderHwpxToSvg
1283
1283
  };
1284
- //# sourceMappingURL=chunk-GHMVNMUN.js.map
1284
+ //# sourceMappingURL=chunk-WTJIRGPN.js.map
@@ -6,7 +6,7 @@ import {
6
6
  HEADING_RATIO_H1,
7
7
  HEADING_RATIO_H2,
8
8
  HEADING_RATIO_H3
9
- } from "./chunk-ZF7QL4IY.js";
9
+ } from "./chunk-GJO3ORFW.js";
10
10
  import {
11
11
  detectFormat,
12
12
  detectOle2Format,
@@ -27,7 +27,7 @@ import {
27
27
  paraTextPureT,
28
28
  patchZipEntries,
29
29
  scanSectionXml
30
- } from "./chunk-LUJN3VFB.js";
30
+ } from "./chunk-CGFWS3BQ.js";
31
31
  import {
32
32
  MAX_COLS,
33
33
  MAX_ROWS,
@@ -37,14 +37,14 @@ import {
37
37
  dedupeRunningHeaders,
38
38
  flattenLayoutTables,
39
39
  mapPuaText
40
- } from "./chunk-DSL6EVFJ.js";
40
+ } from "./chunk-DE6FORIP.js";
41
41
  import {
42
42
  SPACE_EM_FIXED,
43
43
  charWidthEm1000,
44
44
  fitRatioForFewerLines,
45
45
  measureTextWidth,
46
46
  simulateWrap
47
- } from "./chunk-GHMVNMUN.js";
47
+ } from "./chunk-WTJIRGPN.js";
48
48
  import {
49
49
  MAX_DECOMPRESS_SIZE,
50
50
  MAX_XML_DEPTH,
@@ -56,7 +56,7 @@ import {
56
56
  createXmlParser,
57
57
  extractTextFromNode,
58
58
  findChildByLocalName
59
- } from "./chunk-FHYLLKIP.js";
59
+ } from "./chunk-X634MXVJ.js";
60
60
  import {
61
61
  KordocError,
62
62
  classifyError,
@@ -68,7 +68,7 @@ import {
68
68
  sanitizeHref,
69
69
  stripDtd,
70
70
  toArrayBuffer
71
- } from "./chunk-2L7MIKOM.js";
71
+ } from "./chunk-RAS3HM4X.js";
72
72
 
73
73
  // src/index.ts
74
74
  import { readFile } from "fs/promises";
@@ -1576,7 +1576,7 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
1576
1576
  }
1577
1577
  break;
1578
1578
  case "p": {
1579
- const { text: rawText, href, footnote, style } = extractParagraphInfo(el, ctx.styleMap, ctx);
1579
+ const { text: rawText, href, footnote, style, segments } = extractParagraphInfo(el, ctx.styleMap, ctx);
1580
1580
  let text = rawText;
1581
1581
  let headingLevel;
1582
1582
  const ph = resolveParaHeading(el, ctx);
@@ -1584,6 +1584,33 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
1584
1584
  if (ph?.prefix) text = ph.prefix + " " + text;
1585
1585
  headingLevel = ph?.headingLevel;
1586
1586
  }
1587
+ if (segments) {
1588
+ const cell2 = tableCtx?.cell ?? null;
1589
+ if (text && cell2) cell2.text += (cell2.text ? "\n" : "") + (footnote ? `${text} (\uC8FC: ${footnote})` : text);
1590
+ const segs = [...segments];
1591
+ if (ph?.prefix) {
1592
+ const fi = segs.findIndex((s) => s);
1593
+ if (fi >= 0) segs[fi] = ph.prefix + " " + segs[fi];
1594
+ }
1595
+ let segIdx = 0;
1596
+ let first = true;
1597
+ const flush = () => {
1598
+ const s = segs[segIdx++];
1599
+ if (!s) return;
1600
+ const block = { type: "paragraph", text: s, pageNumber: ctx.sectionNum };
1601
+ if (first && !cell2) {
1602
+ first = false;
1603
+ if (style) block.style = style;
1604
+ if (href) block.href = href;
1605
+ if (footnote) block.footnoteText = footnote;
1606
+ }
1607
+ if (cell2) (cell2.blocks ??= []).push(block);
1608
+ else blocks.push(block);
1609
+ };
1610
+ tableCtx = walkParagraphChildren(el, blocks, tableCtx, tableStack, ctx, depth + 1, flush);
1611
+ while (segIdx < segs.length) flush();
1612
+ break;
1613
+ }
1587
1614
  if (text) {
1588
1615
  if (tableCtx?.cell) {
1589
1616
  const cell2 = tableCtx.cell;
@@ -1802,7 +1829,7 @@ function findTopLevelTbls(el, out, depth = 0) {
1802
1829
  findTopLevelTbls(ch, out, depth + 1);
1803
1830
  }
1804
1831
  }
1805
- function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
1832
+ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth = 0, onTbl) {
1806
1833
  if (depth > MAX_XML_DEPTH) return tableCtx;
1807
1834
  const children = node.childNodes;
1808
1835
  if (!children) return tableCtx;
@@ -1816,6 +1843,7 @@ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth =
1816
1843
  const tag = el.tagName || el.localName || "";
1817
1844
  const localTag = tag.replace(/^[^:]+:/, "");
1818
1845
  if (localTag === "tbl") {
1846
+ if (onTbl && isInlineTbl(el)) onTbl();
1819
1847
  if (!tableCtx) {
1820
1848
  const chan = kordocTableChannel(el, ctx);
1821
1849
  if (chan) {
@@ -1862,6 +1890,9 @@ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth =
1862
1890
  walkChildren(node, depth);
1863
1891
  return tableCtx;
1864
1892
  }
1893
+ function isInlineTbl(tbl2) {
1894
+ return findChildByLocalName(tbl2, "pos")?.getAttribute("treatAsChar") === "1";
1895
+ }
1865
1896
  function findDescendant(node, targetTag, depth = 0) {
1866
1897
  if (depth > 5) return null;
1867
1898
  const children = node.childNodes;
@@ -2035,7 +2066,7 @@ function extractParagraphInfo(para2, styleMap, ctx) {
2035
2066
  ctx.warnings?.push({ page: ctx.sectionNum, message: "\uBCC0\uACBD\uCD94\uC801 \uC0AD\uC81C \uD14D\uC2A4\uD2B8 \uCD9C\uB825 \uC81C\uC678", code: "HIDDEN_TEXT_FILTERED" });
2036
2067
  }
2037
2068
  } else {
2038
- text += t;
2069
+ text += t.replace(/\x1E/g, "");
2039
2070
  }
2040
2071
  continue;
2041
2072
  }
@@ -2066,9 +2097,12 @@ function extractParagraphInfo(para2, styleMap, ctx) {
2066
2097
  case "hwSpace":
2067
2098
  text += " ";
2068
2099
  break;
2100
+ // 테이블 자체는 walkSection에서 처리 — 글자취급(inline) 표만 경계 마커를 남겨
2101
+ // 표 앞뒤 텍스트를 문서 순서대로 분할 방출할 수 있게 한다 (#49/#50).
2102
+ // float·페이지 앵커 표는 텍스트 흐름 불참(reflow 모델 정합) — 종전대로 텍스트 뒤 방출
2069
2103
  case "tbl":
2104
+ if (isInlineTbl(child)) text += "";
2070
2105
  break;
2071
- // 테이블은 walkSection에서 처리
2072
2106
  // 하이퍼링크
2073
2107
  case "hyperlink": {
2074
2108
  const url = child.getAttribute("url") || child.getAttribute("href") || "";
@@ -2163,7 +2197,7 @@ function extractParagraphInfo(para2, styleMap, ctx) {
2163
2197
  for (const r of closed) {
2164
2198
  if (applied.some(([s, e]) => r.start < e && r.end > s)) continue;
2165
2199
  const anchor = text.slice(r.start, r.end);
2166
- if (!anchor.trim() || /[\n\x1F\[\]]/.test(anchor)) continue;
2200
+ if (!anchor.trim() || /[\n\x1F\x1E\[\]]/.test(anchor)) continue;
2167
2201
  text = text.slice(0, r.start) + `[${anchor}](${r.url})` + text.slice(r.end);
2168
2202
  applied.push([r.start, r.end]);
2169
2203
  }
@@ -2171,10 +2205,18 @@ function extractParagraphInfo(para2, styleMap, ctx) {
2171
2205
  }
2172
2206
  const leaderIdx = text.indexOf("");
2173
2207
  if (leaderIdx >= 0) text = text.substring(0, leaderIdx);
2174
- let cleanText = text.replace(/[ \t]+/g, " ").trim();
2175
- if (/^그림입니다\.?\s*원본\s*그림의\s*(이름|크기)/.test(cleanText)) cleanText = "";
2176
- cleanText = cleanText.replace(/그림입니다\.?\s*원본\s*그림의\s*(이름|크기)[^\n]*(\n[^\n]*원본\s*그림의\s*(이름|크기)[^\n]*)*/g, "").trim();
2177
- cleanText = cleanText.replace(/^(?:모서리가 둥근 |둥근 )?(?:사각형|직사각형|정사각형|원|타원|삼각형|선|직선|곡선|화살표|오각형|육각형|팔각형|별|십자|구름|마름모|도넛|평행사변형|사다리꼴|개체|그리기\s?개체|묶음\s?개체|글상자|표|그림|OLE\s?개체)\s?입니다\.?$/gm, "").trim();
2208
+ const cleanParaText = (raw) => {
2209
+ let t = raw.replace(/[ \t]+/g, " ").trim();
2210
+ if (/^그림입니다\.?\s*원본\s*그림의\s*(이름|크기)/.test(t)) t = "";
2211
+ t = t.replace(/그림입니다\.?\s*원본\s*그림의\s*(이름|크기)[^\n]*(\n[^\n]*원본\s*그림의\s*(이름|크기)[^\n]*)*/g, "").trim();
2212
+ return t.replace(/^(?:모서리가 둥근 |둥근 )?(?:사각형|직사각형|정사각형|원|타원|삼각형|선|직선|곡선|화살표|오각형|육각형|팔각형|별|십자|구름|마름모|도넛|평행사변형|사다리꼴|개체|그리기\s?개체|묶음\s?개체|글상자|표|그림|OLE\s?개체)\s?입니다\.?$/gm, "").trim();
2213
+ };
2214
+ let segments;
2215
+ if (text.includes("")) {
2216
+ segments = text.split("").map(cleanParaText);
2217
+ text = text.replace(/\x1E/g, "");
2218
+ }
2219
+ const cleanText = cleanParaText(text);
2178
2220
  let style;
2179
2221
  if (styleMap && charPrId) {
2180
2222
  const charProp = styleMap.charProperties.get(charPrId);
@@ -2187,7 +2229,7 @@ function extractParagraphInfo(para2, styleMap, ctx) {
2187
2229
  if (!style.fontSize && !style.bold && !style.italic) style = void 0;
2188
2230
  }
2189
2231
  }
2190
- return { text: cleanText, href, footnote, style };
2232
+ return { text: cleanText, href, footnote, style, segments };
2191
2233
  }
2192
2234
  var KORDOC_CHAR_CODE = "4";
2193
2235
  var KORDOC_PARA_QUOTE = "6";
@@ -22437,6 +22479,18 @@ function htmlCellInnerToLines(inner) {
22437
22479
  const lines = work.split(/<br\s*\/?>/gi).map((s) => s.trim()).filter((s) => s.length > 0);
22438
22480
  return { lines, hadNonText, imgSrcs };
22439
22481
  }
22482
+ function splitCellByTopLevelTables(html) {
22483
+ const tables = extractTopLevelTables(html);
22484
+ const texts = [];
22485
+ let rest = html;
22486
+ for (const t of tables) {
22487
+ const i = rest.indexOf(t);
22488
+ texts.push(rest.slice(0, i));
22489
+ rest = rest.slice(i + t.length);
22490
+ }
22491
+ texts.push(rest);
22492
+ return { texts, tables };
22493
+ }
22440
22494
  function extractTopLevelTables(html) {
22441
22495
  const result = [];
22442
22496
  let depth = 0;
@@ -23115,17 +23169,18 @@ function generateHtmlTableXml(rawHtml, theme, totalWidth = 44e3, style = null, r
23115
23169
  const rowSpan = Math.min(cell2.rowSpan, rowCnt - cell2.r);
23116
23170
  const lines = cellLines[i];
23117
23171
  let nestedH = 0;
23118
- const nestedXmls = [];
23119
- for (const nested of extractTopLevelTables(cell2.inner)) {
23172
+ const { texts: segTexts, tables: nestedTables } = splitCellByTopLevelTables(cell2.inner);
23173
+ const nestedXmls = nestedTables.map((nested) => {
23120
23174
  const sw = spanW(cell2);
23121
23175
  const nestedW = Math.max(Math.min(Math.max(sw - 1020, 4e3), sw - 282), 500);
23122
23176
  const nestedXml = generateHtmlTableXml(nested, theme, nestedW, style ? { ...style, totalWidth: nestedW } : null);
23123
23177
  if (nestedXml) {
23124
- nestedXmls.push(nestedXml);
23125
23178
  const szH = nestedXml.match(/<hp:sz [^>]*height="(\d+)"/)?.[1];
23126
23179
  nestedH += (szH ? Number(szH) : (nested.match(/<tr[\s>]/gi) ?? []).length * cellH) + 300;
23127
23180
  }
23128
- }
23181
+ return nestedXml;
23182
+ });
23183
+ const segLines = segTexts.map((t) => htmlCellInnerToLines(t).lines);
23129
23184
  const usable = Math.max(spanW(cell2) - CELL_PAD, 1e3);
23130
23185
  let wrapLines = 0;
23131
23186
  for (const line of lines) wrapLines += Math.max(1, Math.ceil(measureTextWidth(unescapeHtml(line).trim(), measureH, 100) / usable));
@@ -23134,9 +23189,9 @@ function generateHtmlTableXml(rawHtml, theme, totalWidth = 44e3, style = null, r
23134
23189
  const cellHeight = Math.max(prof?.cellH.get(`${cell2.r},${cell2.c}`) ?? 0, contentH);
23135
23190
  const perRow = Math.ceil(cellHeight / rowSpan);
23136
23191
  for (let r = cell2.r; r < cell2.r + rowSpan; r++) tableRowHeights[r] = Math.max(tableRowHeights[r], perRow);
23137
- return { cell: cell2, rowSpan, lines, nestedXmls, imgSrcs: cellParsed[i].imgSrcs };
23192
+ return { cell: cell2, rowSpan, lines, nestedXmls, segLines, imgSrcs: cellParsed[i].imgSrcs };
23138
23193
  });
23139
- const tcXmls = meta.map(({ cell: cell2, rowSpan, lines, nestedXmls, imgSrcs }) => {
23194
+ const tcXmls = meta.map(({ cell: cell2, rowSpan, nestedXmls, segLines, imgSrcs }) => {
23140
23195
  const k = `${cell2.r},${cell2.c}`;
23141
23196
  const isHeader = cell2.isHeader;
23142
23197
  const baseCharPr = style ? style.charPr : CHAR_NORMAL;
@@ -23147,7 +23202,7 @@ function generateHtmlTableXml(rawHtml, theme, totalWidth = 44e3, style = null, r
23147
23202
  const paraPrId = style ? centered ? reg ? style.tblCenterParaPr ?? style.centerParaPr : style.centerParaPr : reg ? style.tblLeftParaPr ?? PARA_NORMAL : PARA_NORMAL : PARA_NORMAL;
23148
23203
  const picUrls = images ? [...imgSrcs] : [];
23149
23204
  const paras = [];
23150
- for (const line of lines) {
23205
+ const pushTextLine = (line) => {
23151
23206
  let text = unescapeHtml(line);
23152
23207
  if (images) {
23153
23208
  const { text: rest, urls } = splitImageRefs(text);
@@ -23159,7 +23214,14 @@ function generateHtmlTableXml(rawHtml, theme, totalWidth = 44e3, style = null, r
23159
23214
  if (!images || text.trim() || picUrls.length === 0) {
23160
23215
  paras.push(`<hp:p paraPrIDRef="${paraPrId}" styleIDRef="0"><hp:run charPrIDRef="${charPrId}"><hp:t>${escapeXml(text)}</hp:t></hp:run></hp:p>`);
23161
23216
  }
23162
- }
23217
+ };
23218
+ segLines.forEach((seg, si) => {
23219
+ for (const line of seg) pushTextLine(line);
23220
+ const nestedXml = nestedXmls[si];
23221
+ if (nestedXml) {
23222
+ paras.push(`<hp:p paraPrIDRef="0" styleIDRef="0"><hp:run charPrIDRef="0">${nestedXml}</hp:run></hp:p>`);
23223
+ }
23224
+ });
23163
23225
  if (images && picUrls.length > 0) {
23164
23226
  const pics = picUrls.map((u) => {
23165
23227
  const part = images.take(u);
@@ -23169,9 +23231,6 @@ function generateHtmlTableXml(rawHtml, theme, totalWidth = 44e3, style = null, r
23169
23231
  paras.push(`<hp:p paraPrIDRef="${paraPrId}" styleIDRef="0"><hp:run charPrIDRef="${charPrId}">${pics.join("")}</hp:run></hp:p>`);
23170
23232
  }
23171
23233
  }
23172
- for (const nestedXml of nestedXmls) {
23173
- paras.push(`<hp:p paraPrIDRef="0" styleIDRef="0"><hp:run charPrIDRef="0">${nestedXml}</hp:run></hp:p>`);
23174
- }
23175
23234
  if (paras.length === 0) {
23176
23235
  paras.push(`<hp:p paraPrIDRef="${paraPrId}" styleIDRef="0"><hp:run charPrIDRef="${charPrId}"><hp:t></hp:t></hp:run></hp:p>`);
23177
23236
  }
@@ -27547,7 +27606,7 @@ async function parse(input, options) {
27547
27606
  }
27548
27607
  async function parseImage(buffer, options) {
27549
27608
  try {
27550
- const { parseImageDocument } = await import("./image-ocr-S4REURLR.js");
27609
+ const { parseImageDocument } = await import("./image-ocr-O3YQ3KEN.js");
27551
27610
  const { blocks, warnings } = await parseImageDocument(buffer, options);
27552
27611
  return {
27553
27612
  success: true,
@@ -27605,7 +27664,7 @@ async function parseHwp(buffer, options) {
27605
27664
  async function parsePdf(buffer, options) {
27606
27665
  let parsePdfDocument;
27607
27666
  try {
27608
- const mod = await import("./parser-C3APVZGT.js");
27667
+ const mod = await import("./parser-UX5T6KTZ.js");
27609
27668
  parsePdfDocument = mod.parsePdfDocument;
27610
27669
  } catch {
27611
27670
  return {
@@ -27739,4 +27798,4 @@ export {
27739
27798
  parseHwpml,
27740
27799
  fillForm
27741
27800
  };
27742
- //# sourceMappingURL=chunk-TXYQJXOV.js.map
27801
+ //# sourceMappingURL=chunk-WX75LYAS.js.map