@clazic/kordoc 2.1.1 → 2.1.3

package/README.md

@@ -2,14 +2,11 @@
 
 **모두 파싱해버리겠다.**
 
-[![npm version](https://img.shields.io/npm/v/kordoc.svg)](https://www.npmjs.com/package/kordoc)
-[![license](https://img.shields.io/npm/l/kordoc.svg)](https://github.com/chrisryugj/kordoc/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/@clazic/kordoc.svg)](https://www.npmjs.com/package/@clazic/kordoc)
+[![license](https://img.shields.io/npm/l/@clazic/kordoc.svg)](https://github.com/clazic/kordoc/blob/main/LICENSE)
 
 HWP, HWPX, PDF, XLSX, DOCX — 관공서에서 쏟아지는 모든 문서를 파싱하고, 비교하고, 분석하고, 생성합니다.
 
-[English](./README-EN.md)
-
-![kordoc 데모](./demo.gif)
 
 ---
 
@@ -108,10 +105,7 @@ HWP, HWPX, PDF, XLSX, DOCX — 관공서에서 쏟아지는 모든 문서를 파
 ## 설치
 
 ```bash
-npm install kordoc
-
-# PDF 파싱이 필요하면 (선택)
-npm install pdfjs-dist
+npm install @clazic/kordoc
 ```
 
 ## 빠른 시작
@@ -119,7 +113,7 @@ npm install pdfjs-dist
 ### 문서 파싱
 
 ```typescript
-import { parse } from "kordoc"
+import { parse } from "@clazic/kordoc"
 import { readFileSync } from "fs"
 
 const buffer = readFileSync("사업계획서.hwpx")
@@ -135,7 +129,7 @@ if (result.success) {
 ### 문서 비교 (신구대조표)
 
 ```typescript
-import { compare } from "kordoc"
+import { compare } from "@clazic/kordoc"
 
 const diff = await compare(구버전Buffer, 신버전Buffer)
 // diff.stats → { added: 3, removed: 1, modified: 5, unchanged: 42 }
@@ -147,7 +141,7 @@ HWP vs HWPX 크로스 포맷 비교도 가능합니다.
 ### 양식 필드 추출
 
 ```typescript
-import { parse, extractFormFields } from "kordoc"
+import { parse, extractFormFields } from "@clazic/kordoc"
 
 const result = await parse(buffer)
 if (result.success) {
@@ -160,7 +154,7 @@ if (result.success) {
 ### HWPX 생성 (역변환)
 
 ```typescript
-import { markdownToHwpx } from "kordoc"
+import { markdownToHwpx } from "@clazic/kordoc"
 
 const hwpxBuffer = await markdownToHwpx("# 제목\n\n본문 텍스트\n\n| 이름 | 직급 |\n| --- | --- |\n| 홍길동 | 과장 |")
 writeFileSync("출력.hwpx", Buffer.from(hwpxBuffer))
@@ -186,23 +180,45 @@ const result = await parse(buffer, {
 ## CLI
 
 ```bash
-npx kordoc 사업계획서.hwpx                          # 터미널 출력
-npx kordoc 보고서.hwp -o 보고서.md                  # 파일 저장
-npx kordoc *.pdf -d ./변환결과/                     # 일괄 변환
-npx kordoc 검토서.hwpx --format json               # JSON (blocks + metadata 포함)
-npx kordoc 보고서.hwpx --pages 1-3                  # 페이지 범위
-npx kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
-npx kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
+# 전역 설치 (권장)
+npm install -g @clazic/kordoc
+
+kordoc 사업계획서.hwpx                          # 터미널 출력
+kordoc 보고서.hwp -o 보고서.md                  # 파일 저장
+kordoc *.pdf -d ./변환결과/                     # 일괄 변환
+kordoc 검토서.hwpx --format json               # JSON (blocks + metadata 포함)
+kordoc 보고서.hwpx --pages 1-3                  # 페이지 범위
+kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
+kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
 ```
 
 ## MCP 서버 (Claude / Cursor / Windsurf)
 
+### 원격 MCP (설치 불필요 — 파일을 base64로 전송)
+
+```json
+{
+  "mcpServers": {
+    "kordoc": {
+      "serverUrl": "https://kordoc-mcp.clazic.workers.dev"
+    }
+  }
+}
+```
+
+> HWPX, XLSX, DOCX, PDF 지원. HWP 5.x는 로컬 MCP 사용.
+
+### 로컬 MCP (HWP 5.x 포함 전 포맷, 파일 경로 직접 접근)
+
+```bash
+npm install -g @clazic/kordoc
+```
+
 ```json
 {
   "mcpServers": {
     "kordoc": {
-      "command": "npx",
-      "args": ["-y", "kordoc-mcp"]
+      "command": "kordoc-mcp"
     }
   }
 }
@@ -253,7 +269,7 @@ import type {
   DiffResult, BlockDiff, CellDiff, DiffChangeType,
   FormField, FormResult,
   OcrProvider, WatchOptions,
-} from "kordoc"
+} from "@clazic/kordoc"
 ```
 
 ## 지원 포맷
@@ -272,8 +288,8 @@ import type {
 
 ## 만든 사람
 
-대한민국 지방공무원. 광진구청에서 7년간 HWP 파일과 싸우다가 이걸 만들었습니다.
-5개 공공 프로젝트에서 수천 건의 실제 관공서 문서를 파싱하며 검증했습니다.
+chrisryugj님의 kordoc을 fork해서 수정하고 사용하고 있습니다.
+
 
 ## 라이선스
 

package/dist/{chunk-R6J5ZSDL.js → chunk-P7ZKUWEP.js}

@@ -6,7 +6,7 @@ import {
   precheckZipSize,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-WQNXZXC4.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -5491,4 +5491,4 @@ export {
   extractFormFields,
   parse
 };
-//# sourceMappingURL=chunk-R6J5ZSDL.js.map
+//# sourceMappingURL=chunk-P7ZKUWEP.js.map

package/dist/{chunk-PKIJLEV6.js → chunk-WQNXZXC4.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/utils.ts
-var VERSION = true ? "2.1.0" : "0.0.0-dev";
+var VERSION = true ? "2.1.3" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -90,4 +90,4 @@ export {
   sanitizeHref,
   classifyError
 };
-//# sourceMappingURL=chunk-PKIJLEV6.js.map
+//# sourceMappingURL=chunk-WQNXZXC4.js.map

package/dist/cli.js

@@ -2,11 +2,11 @@
 import {
   detectFormat,
   parse
-} from "./chunk-R6J5ZSDL.js";
+} from "./chunk-P7ZKUWEP.js";
 import {
   VERSION,
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-WQNXZXC4.js";
 import "./chunk-MOL7MDBG.js";
 
 // src/cli.ts
@@ -92,7 +92,7 @@ program.name("kordoc").description("\uBAA8\uB450 \uD30C\uC2F1\uD574\uBC84\uB9AC\
         process.stdout.write(output + "\n");
       }
     } catch (err) {
-      const { sanitizeError } = await import("./utils-BWQ2RGUD.js");
+      const { sanitizeError } = await import("./utils-G5QGECZV.js");
       process.stderr.write(`
 [kordoc] ERROR: ${fileName} \u2014 ${sanitizeError(err)}
 `);
@@ -101,7 +101,7 @@ program.name("kordoc").description("\uBAA8\uB450 \uD30C\uC2F1\uD574\uBC84\uB9AC\
   }
 });
 program.command("watch <dir>").description("\uB514\uB809\uD1A0\uB9AC \uAC10\uC2DC \u2014 \uC0C8 \uBB38\uC11C \uC790\uB3D9 \uBCC0\uD658").option("--webhook <url>", "\uACB0\uACFC \uC804\uC1A1 \uC6F9\uD6C5 URL").option("-d, --out-dir <dir>", "\uBCC0\uD658 \uACB0\uACFC \uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC").option("-p, --pages <range>", "\uD398\uC774\uC9C0/\uC139\uC158 \uBC94\uC704").option("--format <type>", "\uCD9C\uB825 \uD615\uC2DD: markdown \uB610\uB294 json", "markdown").option("--silent", "\uC9C4\uD589 \uBA54\uC2DC\uC9C0 \uC228\uAE30\uAE30").action(async (dir, opts) => {
-  const { watchDirectory } = await import("./watch-U4AVI5RY.js");
+  const { watchDirectory } = await import("./watch-F4ZAMRJ2.js");
   await watchDirectory({
     dir,
     outDir: opts.outDir,

package/dist/index.cjs

@@ -181,7 +181,7 @@ var import_jszip2 = __toESM(require("jszip"), 1);
 var import_xmldom = require("@xmldom/xmldom");
 
 // src/utils.ts
-var VERSION = true ? "2.1.0" : "0.0.0-dev";
+var VERSION = true ? "2.1.3" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;

package/dist/index.js

@@ -137,7 +137,7 @@ import JSZip2 from "jszip";
 import { DOMParser } from "@xmldom/xmldom";
 
 // src/utils.ts
-var VERSION = true ? "2.1.0" : "0.0.0-dev";
+var VERSION = true ? "2.1.3" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;

package/dist/mcp.js

@@ -8,13 +8,13 @@ import {
   extractHwpxMetadataOnly,
   extractPdfMetadataOnly,
   parse
-} from "./chunk-R6J5ZSDL.js";
+} from "./chunk-P7ZKUWEP.js";
 import {
   KordocError,
   VERSION,
   sanitizeError,
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-WQNXZXC4.js";
 import "./chunk-MOL7MDBG.js";
 
 // src/mcp.ts

package/dist/{utils-BWQ2RGUD.js → utils-G5QGECZV.js}

@@ -8,7 +8,7 @@ import {
   sanitizeError,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-WQNXZXC4.js";
 export {
   KordocError,
   VERSION,
@@ -19,4 +19,4 @@ export {
   sanitizeHref,
   toArrayBuffer
 };
-//# sourceMappingURL=utils-BWQ2RGUD.js.map
+//# sourceMappingURL=utils-G5QGECZV.js.map

package/dist/{watch-U4AVI5RY.js → watch-F4ZAMRJ2.js}

@@ -2,10 +2,10 @@
 import {
   detectFormat,
   parse
-} from "./chunk-R6J5ZSDL.js";
+} from "./chunk-P7ZKUWEP.js";
 import {
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-WQNXZXC4.js";
 import "./chunk-MOL7MDBG.js";
 
 // src/watch.ts
@@ -125,4 +125,4 @@ async function sendWebhook(url, payload) {
 export {
   watchDirectory
 };
-//# sourceMappingURL=watch-U4AVI5RY.js.map
+//# sourceMappingURL=watch-F4ZAMRJ2.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clazic/kordoc",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX) to Markdown",
   "type": "module",
   "exports": {
@@ -59,16 +59,9 @@
     "cfb": "1.2.2",
     "commander": "^13.0.0",
     "jszip": "^3.10.1",
+    "pdfjs-dist": "^4.10.38",
     "zod": "^3.23.0"
   },
-  "peerDependencies": {
-    "pdfjs-dist": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "pdfjs-dist": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/node": "^18.19.130",
     "pdfjs-dist": "^4.10.38",