kordoc 1.6.0 → 1.6.1

package/README.md

@@ -14,13 +14,21 @@
 
 ---
 
-## What's New in v1.6.0
+## What's New in v1.6.1
+
+- **HWP5 Table Cell Offset Fix** — Fixed critical 2-byte offset misalignment in LIST_HEADER parsing. Row address was incorrectly read as colSpan, causing 3-column tables to explode into 6+ columns with misaligned content. Tables now use colAddr/rowAddr-based direct placement for accurate cell positioning.
+- **HWP5 TAB Control Character Fix** — TAB (0x0009) inline control's 14-byte extension data was not skipped, producing garbage characters (`࣐Ā`) after every tab in the output. Fixed by adding the required 14-byte skip.
+
+<details>
+<summary>v1.6.0 features</summary>
 
 - **Cluster-Based Table Detection (PDF)** — Detects borderless tables by analyzing text alignment patterns. Baseline grouping + X-coordinate clustering identifies 2+ column tables that line-based detection misses. Sort-and-split clustering for order-independent results.
 - **Korean Special Table Detection** — Automatically detects `구분/항목/종류`-style key-value patterns common in Korean government documents and converts them to structured 2-column tables.
 - **Korean Word-Break Recovery** — Improved merging of broken Korean words in PDF table cells. Handles character-level PDF rendering (micro-gaps between Hangul characters) and cell line-break artifacts up to 8 characters.
 - **Empty Table Filtering** — Tables with all-empty cells (from line detection of decorative borders) are now automatically removed.
 
+</details>
+
 <details>
 <summary>v1.5.0 features</summary>
 
@@ -215,7 +223,7 @@ import type {
 | Format | Engine | Features |
 |--------|--------|----------|
 | **HWPX** (한컴 2020+) | ZIP + XML DOM | Manifest, nested tables, merged cells, broken ZIP recovery |
-| **HWP 5.x** (한컴 Legacy) | OLE2 + CFB | 21 control chars, zlib decompression, DRM detection |
+| **HWP 5.x** (한컴 Legacy) | OLE2 + CFB | 21 control chars, zlib decompression, DRM detection, colAddr-based table cell placement |
 | **PDF** | pdfjs-dist | Line-based table detection, XY-Cut reading order, heading detection, hidden text filter, OCR |
 
 ## Security

package/dist/{chunk-TFGOV2ML.js → chunk-DYUB34PO.js}

@@ -185,7 +185,7 @@ function tableToMarkdown(table) {
 }
 
 // src/utils.ts
-var VERSION = true ? "1.6.0" : "0.0.0-dev";
+var VERSION = true ? "1.6.1" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -923,6 +923,7 @@ function extractText(data) {
         break;
       case CHAR_TAB:
         result += "	";
+        if (i + 14 <= data.length) i += 14;
         break;
       case CHAR_HYPHEN:
         result += "-";
@@ -1237,9 +1238,13 @@ function parseCellBlock(records, startIdx, tableLevel) {
   const texts = [];
   let colSpan = 1;
   let rowSpan = 1;
-  if (rec.data.length >= 14) {
-    const cs = rec.data.readUInt16LE(10);
-    const rs = rec.data.readUInt16LE(12);
+  let colAddr;
+  let rowAddr;
+  if (rec.data.length >= 16) {
+    colAddr = rec.data.readUInt16LE(8);
+    rowAddr = rec.data.readUInt16LE(10);
+    const cs = rec.data.readUInt16LE(12);
+    const rs = rec.data.readUInt16LE(14);
     if (cs > 0) colSpan = Math.min(cs, MAX_COLS);
     if (rs > 0) rowSpan = Math.min(rs, MAX_ROWS);
   }
@@ -1254,15 +1259,16 @@ function parseCellBlock(records, startIdx, tableLevel) {
     }
     i++;
   }
-  return { cell: { text: texts.join("\n"), colSpan, rowSpan }, nextIdx: i };
+  return { cell: { text: texts.join("\n"), colSpan, rowSpan, colAddr, rowAddr }, nextIdx: i };
 }
 function arrangeCells(rows, cols, cells) {
   const grid = Array.from({ length: rows }, () => Array(cols).fill(null));
-  let cellIdx = 0;
-  for (let r = 0; r < rows && cellIdx < cells.length; r++) {
-    for (let c = 0; c < cols && cellIdx < cells.length; c++) {
-      if (grid[r][c] !== null) continue;
-      const cell = cells[cellIdx++];
+  const hasAddr = cells.some((c) => c.colAddr !== void 0 && c.rowAddr !== void 0);
+  if (hasAddr) {
+    for (const cell of cells) {
+      const r = cell.rowAddr ?? 0;
+      const c = cell.colAddr ?? 0;
+      if (r >= rows || c >= cols) continue;
       grid[r][c] = cell;
       for (let dr = 0; dr < cell.rowSpan; dr++) {
         for (let dc = 0; dc < cell.colSpan; dc++) {
@@ -1272,6 +1278,22 @@ function arrangeCells(rows, cols, cells) {
         }
       }
     }
+  } else {
+    let cellIdx = 0;
+    for (let r = 0; r < rows && cellIdx < cells.length; r++) {
+      for (let c = 0; c < cols && cellIdx < cells.length; c++) {
+        if (grid[r][c] !== null) continue;
+        const cell = cells[cellIdx++];
+        grid[r][c] = cell;
+        for (let dr = 0; dr < cell.rowSpan; dr++) {
+          for (let dc = 0; dc < cell.colSpan; dc++) {
+            if (dr === 0 && dc === 0) continue;
+            if (r + dr < rows && c + dc < cols)
+              grid[r + dr][c + dc] = { text: "", colSpan: 1, rowSpan: 1 };
+          }
+        }
+      }
+    }
   }
   return grid.map((row) => row.map((c) => c || { text: "", colSpan: 1, rowSpan: 1 }));
 }
@@ -2964,4 +2986,4 @@ export {
   extractFormFields,
   parse
 };
-//# sourceMappingURL=chunk-TFGOV2ML.js.map
+//# sourceMappingURL=chunk-DYUB34PO.js.map