kordoc 2.4.1 → 2.5.1

package/README.md

@@ -31,6 +31,12 @@ Windows 도 자동으로 `cmd /c npx` 래핑. 수동 JSON 편집 불필요. 재
 
 > **CLI 로만 쓸 거면** 설치 없이 `npx kordoc <파일>` 바로 사용. 아래 [CLI](#cli) 섹션 참고.
 
+> **`MODULE_NOT_FOUND` / `Cannot find module ...\dist\cli.js` 가 뜨면**: 과거에 깨진 글로벌 설치가 남아있는 상태입니다. 아래로 해결:
+> ```powershell
+> npm uninstall -g kordoc
+> npx -y kordoc@latest setup
+> ```
+
 ---
 
 ## 💡 kordoc으로 무엇을 할 수 있나요?
@@ -46,10 +52,18 @@ Windows 도 자동으로 `cmd /c npx` 래핑. 수동 JSON 편집 불필요. 재
 
 ---
 
-## v2.4.0 변경사항
+## v2.5.0 변경사항
+
+- **🏛️ macOS 한컴오피스 호환 HWPX 생성** (#4) — `markdownToHwpx()` 가 만든 HWPX 가 macOS 한컴에서 "파일이 깨졌다"며 거부되던 문제 해결. 테이블 XML 을 최소 스켈레톤에서 완전 스펙 형태로 재작성 — `<hp:tbl>` 필수 속성 10종 + `<hp:sz>`/`<hp:pos>`/`<hp:outMargin>`/`<hp:inMargin>`, `<hp:tc>` 안에 `<hp:subList>` 래퍼 + `<hp:cellAddr>`/`<hp:cellSpan>`/`<hp:cellSz>`/`<hp:cellMargin>`, paragraph 래핑. `Preview/PrvText.txt` 추가 + `borderFill` id=1(SOLID 0.12mm) 추가.
+- **🔓 HWP 5.x 배포용 문서 COM fallback** (#25) — `.hwp` 바이너리에서 "이 문서는 상위 버전의 배포용 문서입니다..." 경고 플레이스홀더만 나오는 케이스에서, Windows + 한컴오피스 환경이면 자동으로 `HWPFrame.HwpObject` COM API 로 재시도. v2.4.0 의 HWPX DRM fallback 인프라를 `.hwp` 에도 확장.
+
+<details>
+<summary>v2.4.0 변경사항</summary>
 
 - **🔓 HWPX DRM 배포용 문서 자동 추출** — 공공기관 배포용 DRM이 걸린 HWPX 파일을 한컴 오피스 COM API로 자동 텍스트 추출. `manifest.xml`에서 암호화 감지 → `HWPFrame.HwpObject`의 `GetPageText`로 페이지별 추출 → Markdown 변환. Windows + 한컴 오피스 설치 환경에서 별도 설정 없이 동작.
 
+</details>
+
 <details>
 <summary>v2.3.0 변경사항</summary>
 

package/dist/{chunk-VYFIAYCW.js → chunk-KO7DKAXW.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/utils.ts
-var VERSION = true ? "2.4.1" : "0.0.0-dev";
+var VERSION = true ? "2.5.1" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -454,4 +454,4 @@ export {
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
 };
-//# sourceMappingURL=chunk-VYFIAYCW.js.map
+//# sourceMappingURL=chunk-KO7DKAXW.js.map

package/dist/{chunk-T65PPCNU.js → chunk-OCVWJSG7.js}

@@ -1,5 +1,5 @@
 // src/utils.ts
-var VERSION = true ? "2.4.1" : "0.0.0-dev";
+var VERSION = true ? "2.5.1" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -447,4 +447,4 @@ export {
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
 };
-//# sourceMappingURL=chunk-T65PPCNU.js.map
+//# sourceMappingURL=chunk-OCVWJSG7.js.map

package/dist/{chunk-JFPF7B5L.js → chunk-QEZ4CUF7.js}

@@ -20,7 +20,7 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-VYFIAYCW.js";
+} from "./chunk-KO7DKAXW.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -3342,8 +3342,21 @@ async function markdownToHwpx(markdown) {
   zip.file("Contents/content.hpf", generateManifest());
   zip.file("Contents/header.xml", generateHeaderXml());
   zip.file("Contents/section0.xml", sectionXml);
+  zip.file("Preview/PrvText.txt", buildPrvText(blocks));
   return await zip.generateAsync({ type: "arraybuffer" });
 }
+function buildPrvText(blocks) {
+  const lines = [];
+  let bytes = 0;
+  for (const b of blocks) {
+    const text = b.text || (b.rows ? b.rows.map((r) => r.join(" ")).join("\n") : "");
+    if (!text) continue;
+    lines.push(text);
+    bytes += text.length * 3;
+    if (bytes > 1024) break;
+  }
+  return lines.join("\n").slice(0, 1024);
+}
 function parseMarkdownToBlocks(md) {
   const lines = md.split("\n");
   const blocks = [];
@@ -3578,7 +3591,7 @@ function generateHeaderXml() {
         </hh:font>
       </hh:fontface>
     </hh:fontfaces>
-    <hh:borderFills itemCnt="1">
+    <hh:borderFills itemCnt="2">
       <hh:borderFill id="0" threeD="0" shadow="0" centerLine="0" breakCellSeparateLine="0">
         <hh:slash type="NONE" Crooked="0" isCounter="0"/>
         <hh:backSlash type="NONE" Crooked="0" isCounter="0"/>
@@ -3589,6 +3602,16 @@ function generateHeaderXml() {
         <hh:diagonal type="NONE" width="0.1mm" color="#000000"/>
         <hh:fillInfo/>
       </hh:borderFill>
+      <hh:borderFill id="1" threeD="0" shadow="0" centerLine="0" breakCellSeparateLine="0">
+        <hh:slash type="NONE" Crooked="0" isCounter="0"/>
+        <hh:backSlash type="NONE" Crooked="0" isCounter="0"/>
+        <hh:leftBorder type="SOLID" width="0.12mm" color="#000000"/>
+        <hh:rightBorder type="SOLID" width="0.12mm" color="#000000"/>
+        <hh:topBorder type="SOLID" width="0.12mm" color="#000000"/>
+        <hh:bottomBorder type="SOLID" width="0.12mm" color="#000000"/>
+        <hh:diagonal type="NONE" width="0.1mm" color="#000000"/>
+        <hh:fillInfo/>
+      </hh:borderFill>
     </hh:borderFills>
     <hh:charProperties itemCnt="9">
 ${charPr(0, 1e3, false, false)}
@@ -3624,15 +3647,31 @@ ${paraPr(7, { align: "LEFT", lineSpacing: 160, indent: 600 })}
 function generateSecPr() {
   return `<hp:secPr textDirection="HORIZONTAL" spaceColumns="1134" tabStop="8000" outlineShapeIDRef="0" memoShapeIDRef="0" textVerticalWidthHead="0" masterPageCnt="0"><hp:grid lineGrid="0" charGrid="0" wonggojiFormat="0"/><hp:startNum pageStartsOn="BOTH" page="0" pic="0" tbl="0" equation="0"/><hp:visibility hideFirstHeader="0" hideFirstFooter="0" hideFirstMasterPage="0" border="SHOW_ALL" fill="SHOW_ALL" hideFirstPageNum="0" hideFirstEmptyLine="0" showLineNumber="0"/><hp:pagePr landscape="WIDELY" width="59528" height="84188" gutterType="LEFT_ONLY"><hp:margin header="2835" footer="2835" gutter="0" left="5670" right="4252" top="8504" bottom="4252"/></hp:pagePr><hp:footNotePr><hp:autoNumFormat type="DIGIT" userChar="" prefixChar="" suffixChar=")" supscript="0"/><hp:noteLine length="-1" type="SOLID" width="0.12 mm" color="#000000"/><hp:noteSpacing betweenNotes="283" belowLine="567" aboveLine="850"/><hp:numbering type="CONTINUOUS" newNum="1"/><hp:placement place="EACH_COLUMN" beneathText="0"/></hp:footNotePr><hp:endNotePr><hp:autoNumFormat type="DIGIT" userChar="" prefixChar="" suffixChar=")" supscript="0"/><hp:noteLine length="14692344" type="SOLID" width="0.12 mm" color="#000000"/><hp:noteSpacing betweenNotes="0" belowLine="567" aboveLine="850"/><hp:numbering type="CONTINUOUS" newNum="1"/><hp:placement place="END_OF_DOCUMENT" beneathText="0"/></hp:endNotePr></hp:secPr>`;
 }
+var TABLE_ID_BASE = 1e3;
+var tableIdCounter = TABLE_ID_BASE;
+function nextTableId() {
+  return ++tableIdCounter;
+}
 function generateTable(rows) {
-  const trElements = rows.map((row) => {
-    const tdElements = row.map((cell) => {
+  const rowCnt = rows.length;
+  const colCnt = Math.max(...rows.map((r) => r.length), 1);
+  const cellW = Math.floor(44e3 / colCnt);
+  const cellH = 1500;
+  const tblW = cellW * colCnt;
+  const tblH = cellH * rowCnt;
+  const tblId = nextTableId();
+  const trElements = rows.map((row, rowIdx) => {
+    const cells = row.length < colCnt ? [...row, ...Array(colCnt - row.length).fill("")] : row;
+    const tdElements = cells.map((cell, colIdx) => {
       const runs = generateRuns(cell);
-      return `<hp:tc><hp:cellSpan colSpan="1" rowSpan="1"/><hp:p paraPrIDRef="0" styleIDRef="0">${runs}</hp:p></hp:tc>`;
+      const p = `<hp:p paraPrIDRef="0" styleIDRef="0">${runs}</hp:p>`;
+      return `<hp:tc name="" header="${rowIdx === 0 ? 1 : 0}" hasMargin="0" protect="0" editable="1" dirty="0" borderFillIDRef="1"><hp:subList id="" textDirection="HORIZONTAL" lineWrap="BREAK" vertAlign="TOP" linkListIDRef="0" linkListNextIDRef="0" textWidth="0" textHeight="0" hasTextRef="0" hasNumRef="0">${p}</hp:subList><hp:cellAddr colAddr="${colIdx}" rowAddr="${rowIdx}"/><hp:cellSpan colSpan="1" rowSpan="1"/><hp:cellSz width="${cellW}" height="${cellH}"/><hp:cellMargin left="141" right="141" top="141" bottom="141"/></hp:tc>`;
     }).join("");
     return `<hp:tr>${tdElements}</hp:tr>`;
   }).join("");
-  return `<hp:tbl>${trElements}</hp:tbl>`;
+  const tblInner = `<hp:sz width="${tblW}" widthRelTo="ABSOLUTE" height="${tblH}" heightRelTo="ABSOLUTE" protect="0"/><hp:pos treatAsChar="1" affectLSpacing="0" flowWithText="0" allowOverlap="0" holdAnchorAndSO="0" vertRelTo="PARA" horzRelTo="PARA" vertAlign="TOP" horzAlign="LEFT" vertOffset="0" horzOffset="0"/><hp:outMargin left="0" right="0" top="0" bottom="0"/><hp:inMargin left="510" right="510" top="141" bottom="141"/>` + trElements;
+  const tbl = `<hp:tbl id="${tblId}" zOrder="0" numberingType="TABLE" pageBreak="CELL" repeatHeader="0" rowCnt="${rowCnt}" colCnt="${colCnt}" cellSpacing="0" borderFillIDRef="1" noShading="0">${tblInner}</hp:tbl>`;
+  return `<hp:p paraPrIDRef="0" styleIDRef="0"><hp:run charPrIDRef="0">${tbl}</hp:run></hp:p>`;
 }
 function blocksToSectionXml(blocks) {
   const paraXmls = [];
@@ -3699,6 +3738,20 @@ function blocksToSectionXml(blocks) {
 // src/index.ts
 import { readFile } from "fs/promises";
 
+// src/hwp5/sentinel.ts
+var SENTINEL_PATTERNS = [
+  /상위\s*버전의\s*배포용\s*문서/,
+  /최신\s*버전의\s*한글.*뷰어/,
+  /문서를\s*읽으려면/
+];
+function isDistributionSentinel(markdown) {
+  if (!markdown) return false;
+  const hit = SENTINEL_PATTERNS.some((p) => p.test(markdown));
+  if (!hit) return false;
+  const stripped = markdown.split(/\r?\n/).filter((line) => !SENTINEL_PATTERNS.some((p) => p.test(line))).join("").replace(/\s+/g, "");
+  return stripped.length < 120;
+}
+
 // src/xlsx/parser.ts
 import JSZip4 from "jszip";
 import { DOMParser as DOMParser3 } from "@xmldom/xmldom";
@@ -4711,6 +4764,23 @@ async function parseHwpx(buffer, options) {
 async function parseHwp(buffer, options) {
   try {
     const { markdown, blocks, metadata, outline, warnings, images } = parseHwp5Document(Buffer.from(buffer), options);
+    if (isDistributionSentinel(markdown) && isComFallbackAvailable() && options?.filePath) {
+      try {
+        const { pages, pageCount, warnings: comWarns } = extractTextViaCom(options.filePath);
+        if (pages.some((p) => p && p.trim().length > 0)) {
+          const com = comResultToParseResult(pages, pageCount, comWarns);
+          return {
+            success: true,
+            fileType: "hwp",
+            markdown: com.markdown,
+            blocks: com.blocks,
+            metadata: com.metadata,
+            warnings: com.warnings
+          };
+        }
+      } catch {
+      }
+    }
     return { success: true, fileType: "hwp", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0 };
   } catch (err) {
     return { success: false, fileType: "hwp", error: err instanceof Error ? err.message : "HWP \uD30C\uC2F1 \uC2E4\uD328", code: classifyError(err) };
@@ -4719,7 +4789,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-UHUCMAA7.js");
+    const mod = await import("./parser-DA3CGOZF.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -4949,4 +5019,4 @@ export {
   compare,
   parse
 };
-//# sourceMappingURL=chunk-JFPF7B5L.js.map
+//# sourceMappingURL=chunk-QEZ4CUF7.js.map