hwp-convert 1.0.0

package/dist/lib/hwp/owpml.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OWPML(HWPX) 패키지 생성 공통 헬퍼.
+ *
+ * writer.ts(평문) 와 hwpxBuilder.ts(IR) 가 공유하는 OWPML 컨벤션 상수·유틸.
+ * 기준: 한컴 정상 출력 샘플 etc/hwpxcore_test/ (header.xml / section0.xml).
+ *
+ * OWPML 핵심 규칙:
+ *   - mimetype = "application/hwp+zip" (한글의 HWPX 매직 문자열)
+ *   - 요소만 네임스페이스 prefix(hp:/hh:/hc:), 속성은 prefix 없음
+ *   - head/sec/package 루트에 풀 네임스페이스 선언
+ *   - 첫 문단에 <hp:secPr> (페이지 설정) 필수
+ *
+ * 순수 문자열·로직만 — Node 전용 API(Buffer/fs/path/crypto) 금지 (브라우저 ESM 번들 유지).
+ * [shyang 2026-06-21]
+ */
+/** mimetype 파일 내용 — 한글이 HWPX 를 감지하는 매직 문자열. */
+export declare const MIMETYPE = "application/hwp+zip";
+/** head/sec/package 루트가 공유하는 OWPML 풀 네임스페이스 선언. */
+export declare const OWPML_NS: string;
+/** 한 문단 라인세그 기본값(한컴 호환). 속성 prefix 없음. */
+export declare const DEFAULT_LINESEG: string;
+/**
+ * 섹션 첫 문단에 들어가는 <hp:secPr>(페이지 설정) + <hp:ctrl><hp:colPr> 블록.
+ * 한컴 정상 샘플(etc/hwpxcore_test/Contents/section0.xml) 기준 A4 세로.
+ * 한글이 열 때 실제 레이아웃을 재계산하므로 이 기본값으로 충분.
+ */
+export declare const SEC_PR_XML: string;
+/**
+ * 문단 고유 id 생성. 한컴은 <hp:p> 에 고유 정수 id 를 요구한다.
+ * 결정적(카운터 기반) — 같은 문서/세션 내 고유하면 충분.
+ */
+export declare function makeParaId(): number;
+export declare function escapeXml(s: string): string;

package/dist/lib/hwp/owpml.js

@@ -0,0 +1,86 @@
+/**
+ * OWPML(HWPX) 패키지 생성 공통 헬퍼.
+ *
+ * writer.ts(평문) 와 hwpxBuilder.ts(IR) 가 공유하는 OWPML 컨벤션 상수·유틸.
+ * 기준: 한컴 정상 출력 샘플 etc/hwpxcore_test/ (header.xml / section0.xml).
+ *
+ * OWPML 핵심 규칙:
+ *   - mimetype = "application/hwp+zip" (한글의 HWPX 매직 문자열)
+ *   - 요소만 네임스페이스 prefix(hp:/hh:/hc:), 속성은 prefix 없음
+ *   - head/sec/package 루트에 풀 네임스페이스 선언
+ *   - 첫 문단에 <hp:secPr> (페이지 설정) 필수
+ *
+ * 순수 문자열·로직만 — Node 전용 API(Buffer/fs/path/crypto) 금지 (브라우저 ESM 번들 유지).
+ * [shyang 2026-06-21]
+ */
+/** mimetype 파일 내용 — 한글이 HWPX 를 감지하는 매직 문자열. */
+export const MIMETYPE = "application/hwp+zip";
+/** head/sec/package 루트가 공유하는 OWPML 풀 네임스페이스 선언. */
+export const OWPML_NS = `xmlns:ha="http://www.hancom.co.kr/hwpml/2011/app" ` +
+    `xmlns:hp="http://www.hancom.co.kr/hwpml/2011/paragraph" ` +
+    `xmlns:hp10="http://www.hancom.co.kr/hwpml/2016/paragraph" ` +
+    `xmlns:hs="http://www.hancom.co.kr/hwpml/2011/section" ` +
+    `xmlns:hc="http://www.hancom.co.kr/hwpml/2011/core" ` +
+    `xmlns:hh="http://www.hancom.co.kr/hwpml/2011/head" ` +
+    `xmlns:hhs="http://www.hancom.co.kr/hwpml/2011/history" ` +
+    `xmlns:hm="http://www.hancom.co.kr/hwpml/2011/master-page" ` +
+    `xmlns:hpf="http://www.hancom.co.kr/schema/2011/hpf" ` +
+    `xmlns:dc="http://purl.org/dc/elements/1.1/" ` +
+    `xmlns:opf="http://www.idpf.org/2007/opf/" ` +
+    `xmlns:ooxmlchart="http://www.hancom.co.kr/hwpml/2016/ooxmlchart" ` +
+    `xmlns:hwpunitchar="http://www.hancom.co.kr/hwpml/2016/HwpUnitChar" ` +
+    `xmlns:epub="http://www.idpf.org/2007/ops" ` +
+    `xmlns:config="urn:oasis:names:tc:opendocument:xmlns:config:1.0"`;
+/** 한 문단 라인세그 기본값(한컴 호환). 속성 prefix 없음. */
+export const DEFAULT_LINESEG = `<hp:linesegarray>` +
+    `<hp:lineseg textpos="0" vertpos="0" vertsize="1000" textheight="1000" baseline="850" spacing="600" horzpos="0" horzsize="42520" flags="393216"/>` +
+    `</hp:linesegarray>`;
+/**
+ * 섹션 첫 문단에 들어가는 <hp:secPr>(페이지 설정) + <hp:ctrl><hp:colPr> 블록.
+ * 한컴 정상 샘플(etc/hwpxcore_test/Contents/section0.xml) 기준 A4 세로.
+ * 한글이 열 때 실제 레이아웃을 재계산하므로 이 기본값으로 충분.
+ */
+export const SEC_PR_XML = `<hp:secPr id="" textDirection="HORIZONTAL" spaceColumns="1134" tabStop="8000" tabStopVal="4000" tabStopUnit="HWPUNIT" outlineShapeIDRef="1" 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:lineNumberShape restartType="0" countBy="0" distance="0" startNumber="0"/>` +
+    `<hp:pagePr landscape="WIDELY" width="59528" height="84186" gutterType="LEFT_ONLY">` +
+    `<hp:margin header="4252" footer="4252" gutter="0" left="8504" right="8504" top="5668" 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:pageBorderFill type="BOTH" borderFillIDRef="1" textBorder="PAPER" headerInside="0" footerInside="0" fillArea="PAPER"><hp:offset left="1417" right="1417" top="1417" bottom="1417"/></hp:pageBorderFill>` +
+    `<hp:pageBorderFill type="EVEN" borderFillIDRef="1" textBorder="PAPER" headerInside="0" footerInside="0" fillArea="PAPER"><hp:offset left="1417" right="1417" top="1417" bottom="1417"/></hp:pageBorderFill>` +
+    `<hp:pageBorderFill type="ODD" borderFillIDRef="1" textBorder="PAPER" headerInside="0" footerInside="0" fillArea="PAPER"><hp:offset left="1417" right="1417" top="1417" bottom="1417"/></hp:pageBorderFill>` +
+    `</hp:secPr>` +
+    `<hp:ctrl><hp:colPr id="" type="NEWSPAPER" layout="LEFT" colCount="1" sameSz="1" sameGap="0"/></hp:ctrl>`;
+let paraIdCounter = 0;
+/**
+ * 문단 고유 id 생성. 한컴은 <hp:p> 에 고유 정수 id 를 요구한다.
+ * 결정적(카운터 기반) — 같은 문서/세션 내 고유하면 충분.
+ */
+export function makeParaId() {
+    paraIdCounter = (paraIdCounter + 1) >>> 0;
+    return paraIdCounter;
+}
+export function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}

package/dist/lib/hwp/record.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HWP 레코드 헤더 (4바이트):
+ *   - bits 0..9   : tag_id  (0..1023)
+ *   - bits 10..19 : level   (0..1023)
+ *   - bits 20..31 : size    (0..4095)
+ *   - size == 0xFFF 이면 다음 4바이트가 실제 size (확장 크기)
+ *
+ * 원작: rhwp/src/parser/record.rs (MIT, Copyright (c) 2025-2026 Edward Kim)
+ */
+export interface Record {
+    tagId: number;
+    level: number;
+    size: number;
+    data: Uint8Array;
+}
+export declare class RecordError extends Error {
+    constructor(msg: string);
+}
+/**
+ * 바이트 스트림에서 모든 레코드를 평탄하게 파싱.
+ * 트리 재구성은 호출자가 level 필드를 보고 직접 수행.
+ */
+export declare function readAllRecords(data: Uint8Array): Record[];
+export declare function recordTagName(rec: Record): string;

package/dist/lib/hwp/record.js

@@ -0,0 +1,59 @@
+/**
+ * HWP 레코드 헤더 (4바이트):
+ *   - bits 0..9   : tag_id  (0..1023)
+ *   - bits 10..19 : level   (0..1023)
+ *   - bits 20..31 : size    (0..4095)
+ *   - size == 0xFFF 이면 다음 4바이트가 실제 size (확장 크기)
+ *
+ * 원작: rhwp/src/parser/record.rs (MIT, Copyright (c) 2025-2026 Edward Kim)
+ */
+import { tagName } from "./tags.js";
+export class RecordError extends Error {
+    constructor(msg) {
+        super(msg);
+        this.name = "RecordError";
+    }
+}
+/**
+ * 바이트 스트림에서 모든 레코드를 평탄하게 파싱.
+ * 트리 재구성은 호출자가 level 필드를 보고 직접 수행.
+ */
+export function readAllRecords(data) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const records = [];
+    let offset = 0;
+    const end = data.byteLength;
+    while (offset < end) {
+        if (end - offset < 4) {
+            // 트레일링 패딩으로 간주하고 정상 종료
+            break;
+        }
+        const header = view.getUint32(offset, true);
+        offset += 4;
+        const tagId = header & 0x3ff;
+        const level = (header >>> 10) & 0x3ff;
+        let size = header >>> 20;
+        if (size === 0xfff) {
+            if (end - offset < 4) {
+                throw new RecordError(`extended size 헤더 중간 EOF (tag=${tagId})`);
+            }
+            size = view.getUint32(offset, true);
+            offset += 4;
+        }
+        if (offset + size > end) {
+            throw new RecordError(`레코드 데이터 부족: tag=${tagId}/${tagName(tagId)}, 필요=${size}, 가용=${end - offset}`);
+        }
+        const recordData = new Uint8Array(data.buffer, data.byteOffset + offset, size);
+        offset += size;
+        records.push({
+            tagId,
+            level,
+            size,
+            data: new Uint8Array(recordData), // 복사
+        });
+    }
+    return records;
+}
+export function recordTagName(rec) {
+    return tagName(rec.tagId);
+}

package/dist/lib/hwp/tags.d.ts

@@ -0,0 +1,115 @@
+/**
+ * HWP 5.0 레코드 TagID 및 컨트롤 ID 상수.
+ * HWPTAG_BEGIN(0x010) 기준 오프셋으로 정의.
+ *
+ * 원작: rhwp/src/parser/tags.rs (MIT, Copyright (c) 2025-2026 Edward Kim)
+ */
+export declare const HWPTAG_BEGIN = 16;
+export declare const HWPTAG_DOCUMENT_PROPERTIES: number;
+export declare const HWPTAG_ID_MAPPINGS: number;
+export declare const HWPTAG_BIN_DATA: number;
+export declare const HWPTAG_FACE_NAME: number;
+export declare const HWPTAG_BORDER_FILL: number;
+export declare const HWPTAG_CHAR_SHAPE: number;
+export declare const HWPTAG_TAB_DEF: number;
+export declare const HWPTAG_NUMBERING: number;
+export declare const HWPTAG_BULLET: number;
+export declare const HWPTAG_PARA_SHAPE: number;
+export declare const HWPTAG_STYLE: number;
+export declare const HWPTAG_DOC_DATA: number;
+export declare const HWPTAG_DISTRIBUTE_DOC_DATA: number;
+export declare const HWPTAG_COMPATIBLE_DOCUMENT: number;
+export declare const HWPTAG_LAYOUT_COMPATIBILITY: number;
+export declare const HWPTAG_TRACKCHANGE: number;
+export declare const HWPTAG_PARA_HEADER: number;
+export declare const HWPTAG_PARA_TEXT: number;
+export declare const HWPTAG_PARA_CHAR_SHAPE: number;
+export declare const HWPTAG_PARA_LINE_SEG: number;
+export declare const HWPTAG_PARA_RANGE_TAG: number;
+export declare const HWPTAG_CTRL_HEADER: number;
+export declare const HWPTAG_LIST_HEADER: number;
+export declare const HWPTAG_PAGE_DEF: number;
+export declare const HWPTAG_FOOTNOTE_SHAPE: number;
+export declare const HWPTAG_PAGE_BORDER_FILL: number;
+export declare const HWPTAG_SHAPE_COMPONENT: number;
+export declare const HWPTAG_TABLE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_LINE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_RECTANGLE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_ELLIPSE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_ARC: number;
+export declare const HWPTAG_SHAPE_COMPONENT_POLYGON: number;
+export declare const HWPTAG_SHAPE_COMPONENT_CURVE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_OLE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_PICTURE: number;
+export declare const HWPTAG_SHAPE_COMPONENT_CONTAINER: number;
+export declare const HWPTAG_CTRL_DATA: number;
+export declare const HWPTAG_EQEDIT: number;
+export declare const HWPTAG_SHAPE_COMPONENT_TEXTART: number;
+export declare const HWPTAG_FORM_OBJECT: number;
+export declare const HWPTAG_MEMO_SHAPE: number;
+export declare const HWPTAG_MEMO_LIST: number;
+export declare const HWPTAG_FORBIDDEN_CHAR: number;
+export declare const HWPTAG_CHART_DATA: number;
+export declare const CHAR_SECTION_COLUMN_DEF = 2;
+export declare const CHAR_FIELD_BEGIN = 3;
+export declare const CHAR_FIELD_END = 4;
+export declare const CHAR_INLINE_NON_TEXT = 8;
+export declare const CHAR_TAB = 9;
+export declare const CHAR_LINE_BREAK = 10;
+export declare const CHAR_EXTENDED_CTRL = 11;
+export declare const CHAR_PARA_BREAK = 13;
+export declare const CHAR_NBSPACE = 24;
+export declare const CHAR_FIXED_WIDTH_SPACE = 25;
+export declare const CHAR_HYPHEN = 30;
+export declare const CHAR_FIXED_WIDTH_SPACE_31 = 31;
+/**
+ * 인라인 컨트롤 코드는 16비트 자리에 1~2개 등장한다.
+ * 길이 1: 일반 문자 / Tab / Line break / Para break
+ * 길이 8: ExtendedCtrl 등 (ctrl_id + 4바이트 + 동일 코드 반복)
+ *
+ * rhwp 기준 8자리(=16바이트)를 차지하는 컨트롤 코드 집합.
+ */
+export declare function isExtendedCtrlChar(code: number): boolean;
+export declare const CTRL_SECTION_DEF: number;
+export declare const CTRL_COLUMN_DEF: number;
+export declare const CTRL_TABLE: number;
+export declare const CTRL_EQUATION: number;
+export declare const CTRL_GEN_SHAPE: number;
+export declare const SHAPE_PICTURE_ID: number;
+export declare const SHAPE_RECT_ID: number;
+export declare const SHAPE_LINE_ID: number;
+export declare const SHAPE_ELLIPSE_ID: number;
+export declare const SHAPE_POLYGON_ID: number;
+export declare const SHAPE_ARC_ID: number;
+export declare const SHAPE_CURVE_ID: number;
+export declare const SHAPE_CONNECTOR_ID: number;
+export declare const CTRL_HEADER: number;
+export declare const CTRL_FOOTER: number;
+export declare const CTRL_FOOTNOTE: number;
+export declare const CTRL_ENDNOTE: number;
+export declare const CTRL_AUTO_NUMBER: number;
+export declare const CTRL_NEW_NUMBER: number;
+export declare const CTRL_PAGE_NUM_POS: number;
+export declare const CTRL_PAGE_HIDE: number;
+export declare const CTRL_INDEX_MARK: number;
+export declare const CTRL_BOOKMARK: number;
+export declare const CTRL_TCPS: number;
+export declare const CTRL_FORM: number;
+export declare const CTRL_CHAR_OVERLAP: number;
+export declare const CTRL_HIDDEN_COMMENT: number;
+export declare const FIELD_CLICKHERE: number;
+export declare const FIELD_HYPERLINK: number;
+export declare const FIELD_BOOKMARK: number;
+export declare const FIELD_DATE: number;
+export declare const FIELD_DOCDATE: number;
+export declare const FIELD_PATH: number;
+export declare const FIELD_MAILMERGE: number;
+export declare const FIELD_CROSSREF: number;
+export declare const FIELD_FORMULA: number;
+export declare const FIELD_SUMMARY: number;
+export declare const FIELD_USERINFO: number;
+export declare function isFieldCtrlId(id: number): boolean;
+export declare function tagName(tagId: number): string;
+export declare function ctrlName(id: number): string;
+/** ctrl_id를 4글자 문자열로 (디버그 용) */
+export declare function ctrlIdToString(id: number): string;

package/dist/lib/hwp/tags.js

@@ -0,0 +1,217 @@
+/**
+ * HWP 5.0 레코드 TagID 및 컨트롤 ID 상수.
+ * HWPTAG_BEGIN(0x010) 기준 오프셋으로 정의.
+ *
+ * 원작: rhwp/src/parser/tags.rs (MIT, Copyright (c) 2025-2026 Edward Kim)
+ */
+export const HWPTAG_BEGIN = 0x010;
+// ============================================================
+// DocInfo 태그 (HWPTAG_BEGIN + 0 ~ 49)
+// ============================================================
+export const HWPTAG_DOCUMENT_PROPERTIES = HWPTAG_BEGIN + 0;
+export const HWPTAG_ID_MAPPINGS = HWPTAG_BEGIN + 1;
+export const HWPTAG_BIN_DATA = HWPTAG_BEGIN + 2;
+export const HWPTAG_FACE_NAME = HWPTAG_BEGIN + 3;
+export const HWPTAG_BORDER_FILL = HWPTAG_BEGIN + 4;
+export const HWPTAG_CHAR_SHAPE = HWPTAG_BEGIN + 5;
+export const HWPTAG_TAB_DEF = HWPTAG_BEGIN + 6;
+export const HWPTAG_NUMBERING = HWPTAG_BEGIN + 7;
+export const HWPTAG_BULLET = HWPTAG_BEGIN + 8;
+export const HWPTAG_PARA_SHAPE = HWPTAG_BEGIN + 9;
+export const HWPTAG_STYLE = HWPTAG_BEGIN + 10;
+export const HWPTAG_DOC_DATA = HWPTAG_BEGIN + 11;
+export const HWPTAG_DISTRIBUTE_DOC_DATA = HWPTAG_BEGIN + 12;
+// (HWPTAG_BEGIN + 13 예약)
+export const HWPTAG_COMPATIBLE_DOCUMENT = HWPTAG_BEGIN + 14;
+export const HWPTAG_LAYOUT_COMPATIBILITY = HWPTAG_BEGIN + 15;
+export const HWPTAG_TRACKCHANGE = HWPTAG_BEGIN + 16;
+// ============================================================
+// BodyText 태그 (HWPTAG_BEGIN + 50 ~)
+// ============================================================
+export const HWPTAG_PARA_HEADER = HWPTAG_BEGIN + 50;
+export const HWPTAG_PARA_TEXT = HWPTAG_BEGIN + 51;
+export const HWPTAG_PARA_CHAR_SHAPE = HWPTAG_BEGIN + 52;
+export const HWPTAG_PARA_LINE_SEG = HWPTAG_BEGIN + 53;
+export const HWPTAG_PARA_RANGE_TAG = HWPTAG_BEGIN + 54;
+export const HWPTAG_CTRL_HEADER = HWPTAG_BEGIN + 55;
+export const HWPTAG_LIST_HEADER = HWPTAG_BEGIN + 56;
+export const HWPTAG_PAGE_DEF = HWPTAG_BEGIN + 57;
+export const HWPTAG_FOOTNOTE_SHAPE = HWPTAG_BEGIN + 58;
+export const HWPTAG_PAGE_BORDER_FILL = HWPTAG_BEGIN + 59;
+export const HWPTAG_SHAPE_COMPONENT = HWPTAG_BEGIN + 60;
+export const HWPTAG_TABLE = HWPTAG_BEGIN + 61;
+export const HWPTAG_SHAPE_COMPONENT_LINE = HWPTAG_BEGIN + 62;
+export const HWPTAG_SHAPE_COMPONENT_RECTANGLE = HWPTAG_BEGIN + 63;
+export const HWPTAG_SHAPE_COMPONENT_ELLIPSE = HWPTAG_BEGIN + 64;
+export const HWPTAG_SHAPE_COMPONENT_ARC = HWPTAG_BEGIN + 65;
+export const HWPTAG_SHAPE_COMPONENT_POLYGON = HWPTAG_BEGIN + 66;
+export const HWPTAG_SHAPE_COMPONENT_CURVE = HWPTAG_BEGIN + 67;
+export const HWPTAG_SHAPE_COMPONENT_OLE = HWPTAG_BEGIN + 68;
+export const HWPTAG_SHAPE_COMPONENT_PICTURE = HWPTAG_BEGIN + 69;
+export const HWPTAG_SHAPE_COMPONENT_CONTAINER = HWPTAG_BEGIN + 70;
+export const HWPTAG_CTRL_DATA = HWPTAG_BEGIN + 71;
+export const HWPTAG_EQEDIT = HWPTAG_BEGIN + 72;
+// (HWPTAG_BEGIN + 73 예약)
+export const HWPTAG_SHAPE_COMPONENT_TEXTART = HWPTAG_BEGIN + 74;
+export const HWPTAG_FORM_OBJECT = HWPTAG_BEGIN + 75;
+export const HWPTAG_MEMO_SHAPE = HWPTAG_BEGIN + 76;
+export const HWPTAG_MEMO_LIST = HWPTAG_BEGIN + 77;
+export const HWPTAG_FORBIDDEN_CHAR = HWPTAG_BEGIN + 78;
+export const HWPTAG_CHART_DATA = HWPTAG_BEGIN + 79;
+// ============================================================
+// 인라인 컨트롤 코드 (텍스트 내 특수 문자 — UTF-16 코드 포인트)
+// ============================================================
+export const CHAR_SECTION_COLUMN_DEF = 0x0002;
+export const CHAR_FIELD_BEGIN = 0x0003;
+export const CHAR_FIELD_END = 0x0004;
+export const CHAR_INLINE_NON_TEXT = 0x0008;
+export const CHAR_TAB = 0x0009;
+export const CHAR_LINE_BREAK = 0x000a;
+export const CHAR_EXTENDED_CTRL = 0x000b;
+export const CHAR_PARA_BREAK = 0x000d;
+export const CHAR_NBSPACE = 0x0018;
+export const CHAR_FIXED_WIDTH_SPACE = 0x0019;
+export const CHAR_HYPHEN = 0x001e;
+export const CHAR_FIXED_WIDTH_SPACE_31 = 0x001f;
+/**
+ * 인라인 컨트롤 코드는 16비트 자리에 1~2개 등장한다.
+ * 길이 1: 일반 문자 / Tab / Line break / Para break
+ * 길이 8: ExtendedCtrl 등 (ctrl_id + 4바이트 + 동일 코드 반복)
+ *
+ * rhwp 기준 8자리(=16바이트)를 차지하는 컨트롤 코드 집합.
+ */
+export function isExtendedCtrlChar(code) {
+    return (code === CHAR_SECTION_COLUMN_DEF ||
+        code === CHAR_FIELD_BEGIN ||
+        code === CHAR_FIELD_END ||
+        code === CHAR_INLINE_NON_TEXT ||
+        code === CHAR_EXTENDED_CTRL);
+}
+// ============================================================
+// 컨트롤 ID (4바이트 ASCII → u32, big-endian 인코딩)
+// ============================================================
+function ctrlId(s) {
+    if (s.length !== 4)
+        throw new Error(`ctrlId requires 4 chars, got "${s}"`);
+    return ((s.charCodeAt(0) << 24) | (s.charCodeAt(1) << 16) | (s.charCodeAt(2) << 8) | s.charCodeAt(3)) >>> 0;
+}
+export const CTRL_SECTION_DEF = ctrlId("secd");
+export const CTRL_COLUMN_DEF = ctrlId("cold");
+export const CTRL_TABLE = ctrlId("tbl ");
+export const CTRL_EQUATION = ctrlId("eqed");
+export const CTRL_GEN_SHAPE = ctrlId("gso ");
+export const SHAPE_PICTURE_ID = ctrlId("$pic");
+export const SHAPE_RECT_ID = ctrlId("$rec");
+export const SHAPE_LINE_ID = ctrlId("$lin");
+export const SHAPE_ELLIPSE_ID = ctrlId("$ell");
+export const SHAPE_POLYGON_ID = ctrlId("$pol");
+export const SHAPE_ARC_ID = ctrlId("$arc");
+export const SHAPE_CURVE_ID = ctrlId("$cur");
+export const SHAPE_CONNECTOR_ID = ctrlId("$col");
+export const CTRL_HEADER = ctrlId("head");
+export const CTRL_FOOTER = ctrlId("foot");
+export const CTRL_FOOTNOTE = ctrlId("fn  ");
+export const CTRL_ENDNOTE = ctrlId("en  ");
+export const CTRL_AUTO_NUMBER = ctrlId("atno");
+export const CTRL_NEW_NUMBER = ctrlId("nwno");
+export const CTRL_PAGE_NUM_POS = ctrlId("pgnp");
+export const CTRL_PAGE_HIDE = ctrlId("pghd");
+export const CTRL_INDEX_MARK = ctrlId("idxm");
+export const CTRL_BOOKMARK = ctrlId("bokm");
+export const CTRL_TCPS = ctrlId("tcps");
+export const CTRL_FORM = ctrlId("form");
+export const CTRL_CHAR_OVERLAP = ctrlId("tdut");
+export const CTRL_HIDDEN_COMMENT = ctrlId("tcmt");
+// 필드 컨트롤 (% 접두어)
+export const FIELD_CLICKHERE = ctrlId("%clk");
+export const FIELD_HYPERLINK = ctrlId("%hlk");
+export const FIELD_BOOKMARK = ctrlId("%bmk");
+export const FIELD_DATE = ctrlId("%dte");
+export const FIELD_DOCDATE = ctrlId("%ddt");
+export const FIELD_PATH = ctrlId("%pat");
+export const FIELD_MAILMERGE = ctrlId("%mmg");
+export const FIELD_CROSSREF = ctrlId("%xrf");
+export const FIELD_FORMULA = ctrlId("%fmu");
+export const FIELD_SUMMARY = ctrlId("%smr");
+export const FIELD_USERINFO = ctrlId("%usr");
+export function isFieldCtrlId(id) {
+    return ((id >>> 24) & 0xff) === 0x25; // '%'
+}
+const TAG_NAMES = {
+    [HWPTAG_DOCUMENT_PROPERTIES]: "DOCUMENT_PROPERTIES",
+    [HWPTAG_ID_MAPPINGS]: "ID_MAPPINGS",
+    [HWPTAG_BIN_DATA]: "BIN_DATA",
+    [HWPTAG_FACE_NAME]: "FACE_NAME",
+    [HWPTAG_BORDER_FILL]: "BORDER_FILL",
+    [HWPTAG_CHAR_SHAPE]: "CHAR_SHAPE",
+    [HWPTAG_TAB_DEF]: "TAB_DEF",
+    [HWPTAG_NUMBERING]: "NUMBERING",
+    [HWPTAG_BULLET]: "BULLET",
+    [HWPTAG_PARA_SHAPE]: "PARA_SHAPE",
+    [HWPTAG_STYLE]: "STYLE",
+    [HWPTAG_DOC_DATA]: "DOC_DATA",
+    [HWPTAG_DISTRIBUTE_DOC_DATA]: "DISTRIBUTE_DOC_DATA",
+    [HWPTAG_COMPATIBLE_DOCUMENT]: "COMPATIBLE_DOCUMENT",
+    [HWPTAG_LAYOUT_COMPATIBILITY]: "LAYOUT_COMPATIBILITY",
+    [HWPTAG_TRACKCHANGE]: "TRACKCHANGE",
+    [HWPTAG_PARA_HEADER]: "PARA_HEADER",
+    [HWPTAG_PARA_TEXT]: "PARA_TEXT",
+    [HWPTAG_PARA_CHAR_SHAPE]: "PARA_CHAR_SHAPE",
+    [HWPTAG_PARA_LINE_SEG]: "PARA_LINE_SEG",
+    [HWPTAG_PARA_RANGE_TAG]: "PARA_RANGE_TAG",
+    [HWPTAG_CTRL_HEADER]: "CTRL_HEADER",
+    [HWPTAG_LIST_HEADER]: "LIST_HEADER",
+    [HWPTAG_PAGE_DEF]: "PAGE_DEF",
+    [HWPTAG_FOOTNOTE_SHAPE]: "FOOTNOTE_SHAPE",
+    [HWPTAG_PAGE_BORDER_FILL]: "PAGE_BORDER_FILL",
+    [HWPTAG_SHAPE_COMPONENT]: "SHAPE_COMPONENT",
+    [HWPTAG_TABLE]: "TABLE",
+    [HWPTAG_SHAPE_COMPONENT_LINE]: "SHAPE_LINE",
+    [HWPTAG_SHAPE_COMPONENT_RECTANGLE]: "SHAPE_RECTANGLE",
+    [HWPTAG_SHAPE_COMPONENT_ELLIPSE]: "SHAPE_ELLIPSE",
+    [HWPTAG_SHAPE_COMPONENT_ARC]: "SHAPE_ARC",
+    [HWPTAG_SHAPE_COMPONENT_POLYGON]: "SHAPE_POLYGON",
+    [HWPTAG_SHAPE_COMPONENT_CURVE]: "SHAPE_CURVE",
+    [HWPTAG_SHAPE_COMPONENT_OLE]: "SHAPE_OLE",
+    [HWPTAG_SHAPE_COMPONENT_PICTURE]: "SHAPE_PICTURE",
+    [HWPTAG_SHAPE_COMPONENT_CONTAINER]: "SHAPE_CONTAINER",
+    [HWPTAG_CTRL_DATA]: "CTRL_DATA",
+    [HWPTAG_EQEDIT]: "EQEDIT",
+    [HWPTAG_SHAPE_COMPONENT_TEXTART]: "SHAPE_TEXTART",
+    [HWPTAG_FORM_OBJECT]: "FORM_OBJECT",
+    [HWPTAG_MEMO_SHAPE]: "MEMO_SHAPE",
+    [HWPTAG_MEMO_LIST]: "MEMO_LIST",
+    [HWPTAG_FORBIDDEN_CHAR]: "FORBIDDEN_CHAR",
+    [HWPTAG_CHART_DATA]: "CHART_DATA",
+};
+export function tagName(tagId) {
+    return TAG_NAMES[tagId] ?? "UNKNOWN";
+}
+const CTRL_NAMES = {
+    [CTRL_SECTION_DEF]: "SectionDef",
+    [CTRL_COLUMN_DEF]: "ColumnDef",
+    [CTRL_TABLE]: "Table",
+    [CTRL_EQUATION]: "Equation",
+    [CTRL_GEN_SHAPE]: "GenShape",
+    [CTRL_HEADER]: "Header",
+    [CTRL_FOOTER]: "Footer",
+    [CTRL_FOOTNOTE]: "Footnote",
+    [CTRL_ENDNOTE]: "Endnote",
+    [CTRL_AUTO_NUMBER]: "AutoNumber",
+    [CTRL_NEW_NUMBER]: "NewNumber",
+    [CTRL_PAGE_NUM_POS]: "PageNumPos",
+    [CTRL_PAGE_HIDE]: "PageHide",
+    [CTRL_INDEX_MARK]: "IndexMark",
+    [CTRL_BOOKMARK]: "Bookmark",
+    [CTRL_TCPS]: "Tcps",
+    [CTRL_FORM]: "Form",
+    [CTRL_CHAR_OVERLAP]: "CharOverlap",
+    [CTRL_HIDDEN_COMMENT]: "HiddenComment",
+};
+export function ctrlName(id) {
+    return CTRL_NAMES[id] ?? "Unknown";
+}
+/** ctrl_id를 4글자 문자열로 (디버그 용) */
+export function ctrlIdToString(id) {
+    return String.fromCharCode((id >>> 24) & 0xff, (id >>> 16) & 0xff, (id >>> 8) & 0xff, id & 0xff);
+}