@rhwp/core 0.7.16 → 0.7.17

package/README.md

@@ -135,6 +135,51 @@ for (let i = 0; i < total; i++) {
 }
 ```
 
+### 편집 API
+
+`HwpDocument` 는 텍스트·표·그림·필드·서식을 편집하는 API 를 제공합니다. 대부분의
+편집 메서드는 결과를 JSON 문자열로 반환합니다.
+
+```javascript
+// 텍스트 삽입 (구역 0, 문단 0, 오프셋 0)
+doc.insertText(0, 0, 0, '안녕하세요');
+
+// 표 생성 (2행 2열)
+doc.createTable(0, 0, 0, 2, 2);
+```
+
+전체 편집 API 목록과 시그니처는 패키지에 포함된 타입 정의 `rhwp.d.ts` 를 참고하세요
+(IDE 자동완성으로 인자·반환 타입을 확인할 수 있습니다).
+
+### options object 변형 (`*Ex`) — 권장
+
+인자가 많은 편집 API 는 **options object 변형 `<이름>Ex(optionsJson)`** 을 함께
+제공합니다. positional 인자 대신 JSON 문자열로 호출하므로, 라이브러리 버전이 올라가며
+인자가 추가·변경돼도 호출부가 덜 깨집니다(0.x 단계 권장).
+
+```javascript
+// positional — 인자 위치가 바뀌면 호출부를 모두 수정해야 함
+doc.insertPicture(0, 0, 0, '', imageBytes, 4000, 3000, 100, 80, 'png', '', null, null);
+
+// options object (권장) — 필드 추가/순서 변경에 안전
+doc.insertPictureEx(
+  JSON.stringify({
+    sectionIdx: 0, paraIdx: 0, charOffset: 0,
+    width: 4000, height: 3000, naturalWidthPx: 100, naturalHeightPx: 80,
+    extension: 'png',
+  }),
+  imageBytes, // 이미지 바이너리는 별도 인자(Uint8Array)
+);
+```
+
+- 키는 camelCase(`section_idx` → `sectionIdx`). 선택 키는 생략 시 기본값으로 처리됩니다.
+- 반환값과 동작은 positional 버전과 동일합니다.
+- 이미지 같은 바이너리 데이터는 JSON 이 아니라 별도 인자로 받습니다.
+- 어떤 메서드에 `*Ex` 가 있는지는 `rhwp.d.ts` 에서 `Ex(options` 로 확인할 수 있습니다.
+
+> 0.x 단계라 편집 API 시그니처가 바뀔 수 있습니다. 인자가 많은 API 는 `*Ex` 사용을
+> 권장하며, 변경 사항은 CHANGELOG 의 `### API` 항목에 기록합니다.
+
 ## 필수 설정: measureTextWidth
 
 WASM 내부에서 텍스트 레이아웃(줄바꿈, 정렬 등)을 계산할 때

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhwp/core",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "description": "HWP/HWPX file parser and renderer — Rust + WebAssembly",
   "type": "module",
   "main": "rhwp.js",

package/rhwp.d.ts

@@ -26,6 +26,14 @@ export class HwpDocument {
      * 글자 서식을 적용한다 (셀 내 문단).
      */
     applyCharFormatInCell(sec_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, start_offset: number, end_offset: number, props_json: string): string;
+    /**
+     * `applyCharFormatInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ secIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * startOffset, endOffset, props: object }`. `props` 는 글자 서식 JSON 객체(positional
+     * 의 props_json 과 동일). positional 과 동일 동작.
+     */
+    applyCharFormatInCellEx(options_json: string): string;
     /**
      * 미주 모양을 적용한다.
      */
@@ -95,6 +103,13 @@ export class HwpDocument {
      * 표 셀 내부 선택 영역을 내부 클립보드에 복사한다.
      */
     copySelectionInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, start_cell_para_idx: number, start_char_offset: number, end_cell_para_idx: number, end_char_offset: number): string;
+    /**
+     * `copySelectionInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, startCellParaIdx,
+     * startCharOffset, endCellParaIdx, endCharOffset }`. positional 과 동일 동작.
+     */
+    copySelectionInCellEx(options_json: string): string;
     /**
      * 내장 템플릿에서 빈 문서를 생성한다.
      *
@@ -192,6 +207,13 @@ export class HwpDocument {
      * 반환: JSON `{"ok":true,"paraIdx":N,"charOffset":N}`
      */
     deleteRangeInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, start_cell_para_idx: number, start_char_offset: number, end_cell_para_idx: number, end_char_offset: number): string;
+    /**
+     * `deleteRangeInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, startCellParaIdx,
+     * startCharOffset, endCellParaIdx, endCharOffset }`. positional 과 동일 동작.
+     */
+    deleteRangeInCellEx(options_json: string): string;
     /**
      * Shape(글상자) 컨트롤을 문단에서 삭제한다.
      *
@@ -237,6 +259,13 @@ export class HwpDocument {
      */
     deleteTextInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, count: number): string;
     deleteTextInCellByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, count: number): string;
+    /**
+     * `deleteTextInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, count }`. positional 과 동일 동작.
+     */
+    deleteTextInCellEx(options_json: string): string;
     /**
      * 각주 내 텍스트를 삭제한다.
      */
@@ -274,6 +303,13 @@ export class HwpDocument {
      * write_result: true이면 결과를 셀에 기록
      */
     evaluateTableFormula(section_idx: number, parent_para_idx: number, control_idx: number, target_row: number, target_col: number, formula: string, write_result: boolean): string;
+    /**
+     * `evaluateTableFormula` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, targetRow, targetCol,
+     * formula: string, writeResult? }`. positional 과 동일 동작.
+     */
+    evaluateTableFormulaEx(options_json: string): string;
     /**
      * 컨트롤 객체를 HTML 문자열로 변환한다.
      */
@@ -316,6 +352,13 @@ export class HwpDocument {
      * 선택 영역을 HTML 문자열로 변환한다 (셀 내부).
      */
     exportSelectionInCellHtml(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, start_cell_para_idx: number, start_char_offset: number, end_cell_para_idx: number, end_char_offset: number): string;
+    /**
+     * `exportSelectionInCellHtml` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, startCellParaIdx,
+     * startCharOffset, endCellParaIdx, endCharOffset }`. positional 과 동일 동작.
+     */
+    exportSelectionInCellHtmlEx(options_json: string): string;
     /**
      * 커서에서 이전 방향으로 가장 가까운 선택 가능 컨트롤을 찾는다 (F11 키).
      */
@@ -408,7 +451,7 @@ export class HwpDocument {
     /**
      * 셀 속성을 조회한다.
      *
-     * 반환: JSON `{width, height, paddingLeft, paddingRight, paddingTop, paddingBottom, verticalAlign, textDirection, isHeader}`
+     * 반환: JSON `{width, height, paddingLeft, paddingRight, paddingTop, paddingBottom, applyInnerMargin, verticalAlign, textDirection, isHeader, cellProtect, fieldName, editableInForm, ...borderFill}`
      */
     getCellProperties(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number): string;
     /**
@@ -489,6 +532,14 @@ export class HwpDocument {
      * 각주/미주 내부 커서 렉트 계산
      */
     getCursorRectInNote(section_idx: number, para_idx: number, control_idx: number, note_para_idx: number, char_offset: number): string;
+    /**
+     * 줄 경계 offset을 특정 시각 줄 기준으로 해석한 커서 좌표를 반환한다.
+     *
+     * `at_end=false`이면 lineIndex 줄의 시작, `at_end=true`이면 lineIndex 줄의 끝을 반환한다.
+     * soft-wrap 경계에서는 같은 charOffset이 이전 줄 끝과 다음 줄 시작을 동시에 뜻할 수 있어
+     * Home/End가 이 API로 시각 줄 affinity를 명시한다.
+     */
+    getCursorRectOnLine(section_idx: number, para_idx: number, line_index: number, at_end: boolean, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number): string;
     /**
      * 문서 정보를 JSON 문자열로 반환한다.
      */
@@ -545,6 +596,13 @@ export class HwpDocument {
      * 커서 위치의 필드 범위 정보를 조회한다 (셀/글상자 내 문단).
      */
     getFieldInfoAtInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, is_textbox: boolean): string;
+    /**
+     * `getFieldInfoAtInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, isTextbox? }`. positional 과 동일 동작(String 반환).
+     */
+    getFieldInfoAtInCellEx(options_json: string): string;
     /**
      * 문서 내 모든 필드 목록을 JSON 배열로 반환한다.
      *
@@ -742,6 +800,13 @@ export class HwpDocument {
      * 반환: JSON 배열 `[{"pageIndex":N,"x":F,"y":F,"width":F,"height":F}, ...]`
      */
     getSelectionRectsInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, start_cell_para_idx: number, start_char_offset: number, end_cell_para_idx: number, end_char_offset: number): string;
+    /**
+     * `getSelectionRectsInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, startCellParaIdx,
+     * startCharOffset, endCellParaIdx, endCharOffset }`. positional 과 동일 동작.
+     */
+    getSelectionRectsInCellEx(options_json: string): string;
     /**
      * 각주/미주 내부 선택 영역의 줄별 사각형을 반환한다.
      */
@@ -763,6 +828,10 @@ export class HwpDocument {
      * 조판부호 표시 여부를 반환한다.
      */
     getShowControlCodes(): boolean;
+    /**
+     * 문단부호(¶) 표시 여부를 반환한다.
+     */
+    getShowParagraphMarks(): boolean;
     /**
      * 투명선 표시 여부를 반환한다.
      */
@@ -835,6 +904,13 @@ export class HwpDocument {
      */
     getTextInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, count: number): string;
     getTextInCellByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, count: number): string;
+    /**
+     * `getTextInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, count }`. positional 과 동일 동작.
+     */
+    getTextInCellEx(options_json: string): string;
     /**
      * 문단에서 텍스트 부분 문자열을 반환한다 (Undo용 텍스트 보존).
      */
@@ -938,10 +1014,31 @@ export class HwpDocument {
      * 현재 중첩 표 cellPath 위치에 ClickHere 누름틀 필드를 삽입한다.
      */
     insertClickHereFieldByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, guide: string, memo: string, name: string, editable: boolean): string;
+    /**
+     * `insertClickHereFieldByPath` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, path: string, charOffset?, guide?,
+     * memo?, name?, editable? }`. `path` 는 cell_path JSON 문자열. positional 과 동일 동작.
+     */
+    insertClickHereFieldByPathEx(options_json: string): string;
+    /**
+     * `insertClickHereField` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, paraIdx, charOffset?, guide?, memo?, name?, editable? }`.
+     * positional 과 동일 동작.
+     */
+    insertClickHereFieldEx(options_json: string): string;
     /**
      * 현재 셀/글상자 위치에 ClickHere 누름틀 필드를 삽입한다.
      */
     insertClickHereFieldInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, is_textbox: boolean, guide: string, memo: string, name: string, editable: boolean): string;
+    /**
+     * `insertClickHereFieldInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, isTextbox?, guide?, memo?, name?, editable? }`. positional 과 동일 동작.
+     */
+    insertClickHereFieldInCellEx(options_json: string): string;
     /**
      * 단 나누기 삽입 (Ctrl+Shift+Enter)
      */
@@ -991,6 +1088,21 @@ export class HwpDocument {
      * — 기존 동작 호환.
      */
     insertPicture(section_idx: number, para_idx: number, char_offset: number, cell_path_json: string, image_data: Uint8Array, width: number, height: number, natural_width_px: number, natural_height_px: number, extension: string, description: string, paper_offset_x_hu?: number | null, paper_offset_y_hu?: number | null): string;
+    /**
+     * 커서 위치에 그림을 삽입한다 (확장, options object — #1413).
+     *
+     * positional `insertPicture` 와 동일 동작의 얇은 어댑터. 이미지 바이너리는 별도
+     * `image_data` 인자(Uint8Array)로 받고, 나머지는 JSON options 로 받는다. 필드 추가/
+     * 순서 변경 시 호출부 영향이 작다.
+     *
+     * options JSON 키 (positional 과 동일 의미, camelCase):
+     * `{ sectionIdx, paraIdx, charOffset?, cellPath?: string, width, height,
+     *    naturalWidthPx, naturalHeightPx, extension?, description?,
+     *    paperOffsetXHu?: number|null, paperOffsetYHu?: number|null }`
+     * - `cellPath` 는 cell_path_json 문자열(빈 문자열/`"[]"` 이면 본문 inline).
+     * - 반환값은 `insertPicture` 와 동일.
+     */
+    insertPictureEx(options_json: string, image_data: Uint8Array): string;
     /**
      * 표에 열을 삽입한다.
      *
@@ -1017,6 +1129,13 @@ export class HwpDocument {
      */
     insertTextInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, text: string): string;
     insertTextInCellByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, text: string): string;
+    /**
+     * `insertTextInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, text: string }`. positional 과 동일 동작.
+     */
+    insertTextInCellEx(options_json: string): string;
     /**
      * 각주 내 텍스트를 삽입한다.
      */
@@ -1074,10 +1193,23 @@ export class HwpDocument {
      * 반환값: JSON `{"ok":true,"cellCount":<N>}`
      */
     mergeTableCells(section_idx: number, parent_para_idx: number, control_idx: number, start_row: number, start_col: number, end_row: number, end_col: number): string;
+    /**
+     * `mergeTableCells` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, startRow, startCol,
+     * endRow, endCol }`. positional 과 동일 동작.
+     */
+    mergeTableCellsEx(options_json: string): string;
     /**
      * 직선 끝점 이동 (글로벌 HWPUNIT 좌표)
      */
     moveLineEndpoint(sec: number, para: number, ci: number, sx: number, sy: number, ex: number, ey: number): string;
+    /**
+     * `moveLineEndpoint` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sec, para, ci, sx, sy, ex, ey }` (좌표는 i32). positional 과 동일 동작.
+     */
+    moveLineEndpointEx(options_json: string): string;
     /**
      * 표의 위치 오프셋(vertical_offset, horizontal_offset)을 이동한다.
      *
@@ -1101,6 +1233,14 @@ export class HwpDocument {
      * 반환: JSON `{DocumentPosition + CursorRect + preferredX}`
      */
     moveVerticalByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, delta: number, preferred_x: number): string;
+    /**
+     * `moveVertical` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, paraIdx, charOffset?, delta, preferredX,
+     * parentParaIdx?, controlIdx?, cellIdx?, cellParaIdx? }`. cell 컨텍스트 키가 모두
+     * 생략되면 본문 이동(parentParaIdx=MAX 동작과 동일). positional 과 동일 동작.
+     */
+    moveVerticalEx(options_json: string): string;
     /**
      * 페이지 단위로 이전/다음 머리말·꼬리말로 이동한다.
      *
@@ -1139,6 +1279,13 @@ export class HwpDocument {
      * HTML 문자열을 파싱하여 cellPath가 가리키는 중첩 표 셀에 삽입한다.
      */
     pasteHtmlInCellByPath(section_idx: number, parent_para_idx: number, path_json: string, char_offset: number, html: string): string;
+    /**
+     * `pasteHtmlInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, html: string }`. positional 과 동일 동작.
+     */
+    pasteHtmlInCellEx(options_json: string): string;
     /**
      * 내부 클립보드의 내용을 캐럿 위치에 붙여넣는다 (본문 문단).
      *
@@ -1174,6 +1321,13 @@ export class HwpDocument {
      * 커서 위치의 누름틀 필드를 제거한다 (셀/글상자 내 문단).
      */
     removeFieldAtInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, is_textbox: boolean): string;
+    /**
+     * `removeFieldAtInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, isTextbox? }`. positional 과 동일 동작(String 반환).
+     */
+    removeFieldAtInCellEx(options_json: string): string;
     /**
      * 책갈피 이름 변경
      */
@@ -1269,6 +1423,13 @@ export class HwpDocument {
      * 변경이 발생하면 true를 반환한다.
      */
     setActiveFieldInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number, is_textbox: boolean): boolean;
+    /**
+     * `setActiveFieldInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * charOffset?, isTextbox? }`. positional 과 동일 동작(bool 반환).
+     */
+    setActiveFieldInCellEx(options_json: string): boolean;
     /**
      * 셀 내 문단의 paraShapeId를 직접 설정한다.
      */
@@ -1295,6 +1456,13 @@ export class HwpDocument {
      * 글자 서식 ID를 직접 복원한다 (셀 내 문단).
      */
     setCharShapeIdInCell(sec_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, start_offset: number, end_offset: number, char_shape_id: number): string;
+    /**
+     * `setCharShapeIdInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ secIdx, parentParaIdx, controlIdx, cellIdx, cellParaIdx,
+     * startOffset, endOffset, charShapeId }`. positional 과 동일 동작.
+     */
+    setCharShapeIdInCellEx(options_json: string): string;
     setClipEnabled(enabled: boolean): void;
     /**
      * 다단 설정 변경
@@ -1351,6 +1519,13 @@ export class HwpDocument {
      * 반환: `{ok}`
      */
     setFormValueInCell(sec: number, table_para: number, table_ci: number, cell_idx: number, cell_para: number, form_ci: number, value_json: string): string;
+    /**
+     * `setFormValueInCell` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sec, tablePara, tableCi, cellIdx, cellPara, formCi, value: object }`.
+     * positional 과 동일 동작.
+     */
+    setFormValueInCellEx(options_json: string): string;
     /**
      * [Task #825] 머리말/꼬리말 안 그림 속성 변경.
      */
@@ -1359,6 +1534,13 @@ export class HwpDocument {
      * 각주/미주 내부 수식 컨트롤의 속성을 변경한다.
      */
     setNoteEquationProperties(kind: string, section_idx: number, parent_para_idx: number, note_control_idx: number, note_para_idx: number, inner_control_idx: number, props_json: string): string;
+    /**
+     * `setNoteEquationProperties` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ kind, sectionIdx, parentParaIdx, noteControlIdx, noteParaIdx,
+     * innerControlIdx, props: object }`. positional 과 동일 동작.
+     */
+    setNoteEquationPropertiesEx(options_json: string): string;
     /**
      * 문단 서식을 적용한다 (본문 문단).
      * 문단 번호 시작 방식 설정
@@ -1376,6 +1558,13 @@ export class HwpDocument {
      * 감추기 설정
      */
     setPageHide(sec: number, para: number, hide_header: boolean, hide_footer: boolean, hide_master: boolean, hide_border: boolean, hide_fill: boolean, hide_page_num: boolean): string;
+    /**
+     * `setPageHide` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sec, para, hideHeader?, hideFooter?, hideMaster?, hideBorder?,
+     * hideFill?, hidePageNum? }`. positional 과 동일 동작.
+     */
+    setPageHideEx(options_json: string): string;
     /**
      * 문단의 paraShapeId를 직접 설정한다.
      */
@@ -1463,12 +1652,26 @@ export class HwpDocument {
      * 반환값: JSON `{"ok":true,"cellCount":<N>}`
      */
     splitTableCellInto(section_idx: number, parent_para_idx: number, control_idx: number, row: number, col: number, n_rows: number, m_cols: number, equal_row_height: boolean, merge_first: boolean): string;
+    /**
+     * `splitTableCellInto` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, row, col, nRows, mCols,
+     * equalRowHeight?, mergeFirst? }`. positional 과 동일 동작.
+     */
+    splitTableCellIntoEx(options_json: string): string;
     /**
      * 범위 내 셀들을 각각 N줄 × M칸으로 분할한다.
      *
      * 반환값: JSON `{"ok":true,"cellCount":<N>}`
      */
     splitTableCellsInRange(section_idx: number, parent_para_idx: number, control_idx: number, start_row: number, start_col: number, end_row: number, end_col: number, n_rows: number, m_cols: number, equal_row_height: boolean): string;
+    /**
+     * `splitTableCellsInRange` 의 options object 변형 (#1413).
+     *
+     * options JSON 키: `{ sectionIdx, parentParaIdx, controlIdx, startRow, startCol,
+     * endRow, endCol, nRows, mCols, equalRowHeight? }`. positional 과 동일 동작.
+     */
+    splitTableCellsInRangeEx(options_json: string): string;
     /**
      * 텍스트 오프셋 → 논리적 오프셋 변환.
      */
@@ -1573,6 +1776,7 @@ export interface InitOutput {
     readonly hwpdocument_applyCellStyle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_applyCharFormat: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_applyCharFormatInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
+    readonly hwpdocument_applyCharFormatInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_applyEndnoteShape: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_applyHfTemplate: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_applyParaFormat: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
@@ -1589,6 +1793,7 @@ export interface InitOutput {
     readonly hwpdocument_copyControl: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_copySelection: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_copySelectionInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_copySelectionInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_createBlankDocument: (a: number) => [number, number, number, number];
     readonly hwpdocument_createEmpty: () => number;
     readonly hwpdocument_createHeaderFooter: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -1606,6 +1811,7 @@ export interface InitOutput {
     readonly hwpdocument_deletePictureControl: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_deleteRange: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_deleteRangeInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_deleteRangeInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_deleteShapeControl: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_deleteStyle: (a: number, b: number) => number;
     readonly hwpdocument_deleteTableColumn: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
@@ -1614,6 +1820,7 @@ export interface InitOutput {
     readonly hwpdocument_deleteText: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_deleteTextInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_deleteTextInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly hwpdocument_deleteTextInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_deleteTextInFootnote: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_deleteTextInHeaderFooter: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_discardSnapshot: (a: number, b: number) => void;
@@ -1621,12 +1828,14 @@ export interface InitOutput {
     readonly hwpdocument_ensureDefaultBullet: (a: number, b: number, c: number) => number;
     readonly hwpdocument_ensureDefaultNumbering: (a: number) => number;
     readonly hwpdocument_evaluateTableFormula: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_evaluateTableFormulaEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_exportControlHtml: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_exportHwp: (a: number) => [number, number, number, number];
     readonly hwpdocument_exportHwpVerify: (a: number) => [number, number, number, number];
     readonly hwpdocument_exportHwpx: (a: number) => [number, number, number, number];
     readonly hwpdocument_exportSelectionHtml: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_exportSelectionInCellHtml: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_exportSelectionInCellHtmlEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_findNearestControlBackward: (a: number, b: number, c: number, d: number) => [number, number];
     readonly hwpdocument_findNearestControlForward: (a: number, b: number, c: number, d: number) => [number, number];
     readonly hwpdocument_findNextEditableControl: (a: number, b: number, c: number, d: number, e: number) => [number, number];
@@ -1662,6 +1871,7 @@ export interface InitOutput {
     readonly hwpdocument_getCursorRectInFootnote: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_getCursorRectInHeaderFooter: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_getCursorRectInNote: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly hwpdocument_getCursorRectOnLine: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_getDocumentInfo: (a: number) => [number, number];
     readonly hwpdocument_getDpi: (a: number) => number;
     readonly hwpdocument_getEndnoteShape: (a: number, b: number) => [number, number, number, number];
@@ -1673,6 +1883,7 @@ export interface InitOutput {
     readonly hwpdocument_getFieldInfoAt: (a: number, b: number, c: number, d: number) => [number, number];
     readonly hwpdocument_getFieldInfoAtByPath: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
     readonly hwpdocument_getFieldInfoAtInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
+    readonly hwpdocument_getFieldInfoAtInCellEx: (a: number, b: number, c: number) => [number, number];
     readonly hwpdocument_getFieldList: (a: number) => [number, number];
     readonly hwpdocument_getFieldValue: (a: number, b: number) => [number, number, number, number];
     readonly hwpdocument_getFieldValueByName: (a: number, b: number, c: number) => [number, number, number, number];
@@ -1713,10 +1924,12 @@ export interface InitOutput {
     readonly hwpdocument_getSectionDef: (a: number, b: number) => [number, number, number, number];
     readonly hwpdocument_getSelectionRects: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_getSelectionRectsInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_getSelectionRectsInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_getSelectionRectsInFootnote: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_getShapeBBox: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_getShapeProperties: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_getShowControlCodes: (a: number) => number;
+    readonly hwpdocument_getShowParagraphMarks: (a: number) => number;
     readonly hwpdocument_getShowTransparentBorders: (a: number) => number;
     readonly hwpdocument_getSourceFormat: (a: number) => [number, number];
     readonly hwpdocument_getStyleAt: (a: number, b: number, c: number) => [number, number];
@@ -1731,6 +1944,7 @@ export interface InitOutput {
     readonly hwpdocument_getTextBoxControlIndex: (a: number, b: number, c: number) => number;
     readonly hwpdocument_getTextInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_getTextInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly hwpdocument_getTextInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_getTextRange: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_getValidationWarnings: (a: number) => [number, number];
     readonly hwpdocument_groupShapes: (a: number, b: number, c: number) => [number, number, number, number];
@@ -1745,7 +1959,10 @@ export interface InitOutput {
     readonly hwpdocument_injectExternalImageByKey: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly hwpdocument_insertClickHereField: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number, number, number];
     readonly hwpdocument_insertClickHereFieldByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => [number, number, number, number];
+    readonly hwpdocument_insertClickHereFieldByPathEx: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly hwpdocument_insertClickHereFieldEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_insertClickHereFieldInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number) => [number, number, number, number];
+    readonly hwpdocument_insertClickHereFieldInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_insertColumnBreak: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_insertEndnote: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_insertEquation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
@@ -1755,11 +1972,13 @@ export interface InitOutput {
     readonly hwpdocument_insertPageBreak: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_insertParagraph: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_insertPicture: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number) => [number, number, number, number];
+    readonly hwpdocument_insertPictureEx: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_insertTableColumn: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_insertTableRow: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_insertText: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_insertTextInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_insertTextInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly hwpdocument_insertTextInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_insertTextInFootnote: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_insertTextInHeaderFooter: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_insertTextLogical: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
@@ -1771,10 +1990,13 @@ export interface InitOutput {
     readonly hwpdocument_mergeParagraphInFootnote: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_mergeParagraphInHeaderFooter: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_mergeTableCells: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly hwpdocument_mergeTableCellsEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_moveLineEndpoint: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly hwpdocument_moveLineEndpointEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_moveTableOffset: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_moveVertical: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
     readonly hwpdocument_moveVerticalByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly hwpdocument_moveVerticalEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_navigateHeaderFooterByPage: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_navigateNextEditable: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly hwpdocument_new: (a: number, b: number) => [number, number, number];
@@ -1783,12 +2005,14 @@ export interface InitOutput {
     readonly hwpdocument_pasteHtml: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_pasteHtmlInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_pasteHtmlInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly hwpdocument_pasteHtmlInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_pasteInternal: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_pasteInternalInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_pasteInternalInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_reflowLinesegs: (a: number) => number;
     readonly hwpdocument_removeFieldAt: (a: number, b: number, c: number, d: number) => [number, number];
     readonly hwpdocument_removeFieldAtInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
+    readonly hwpdocument_removeFieldAtInCellEx: (a: number, b: number, c: number) => [number, number];
     readonly hwpdocument_renameBookmark: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_renderEquationPreview: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_renderPageCanvas: (a: number, b: number) => [number, number, number];
@@ -1809,12 +2033,14 @@ export interface InitOutput {
     readonly hwpdocument_setActiveField: (a: number, b: number, c: number, d: number) => number;
     readonly hwpdocument_setActiveFieldByPath: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
     readonly hwpdocument_setActiveFieldInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+    readonly hwpdocument_setActiveFieldInCellEx: (a: number, b: number, c: number) => number;
     readonly hwpdocument_setCellParaShapeId: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_setCellPicturePropertiesByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_setCellProperties: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_setCellShapePropertiesByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_setCharShapeId: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_setCharShapeIdInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_setCharShapeIdInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_setClipEnabled: (a: number, b: number) => void;
     readonly hwpdocument_setColumnDef: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_setDpi: (a: number, b: number) => void;
@@ -1825,12 +2051,15 @@ export interface InitOutput {
     readonly hwpdocument_setFileName: (a: number, b: number, c: number) => void;
     readonly hwpdocument_setFormValue: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_setFormValueInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_setFormValueInCellEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_setHeaderFooterPictureProperties: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_setNoteEquationProperties: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
+    readonly hwpdocument_setNoteEquationPropertiesEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_setNumberingRestart: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
     readonly hwpdocument_setPageBorderFill: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_setPageDef: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_setPageHide: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
+    readonly hwpdocument_setPageHideEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_setParaShapeId: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_setPictureProperties: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_setSectionDef: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -1849,7 +2078,9 @@ export interface InitOutput {
     readonly hwpdocument_splitParagraphInHeaderFooter: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_splitTableCell: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_splitTableCellInto: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
+    readonly hwpdocument_splitTableCellIntoEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_splitTableCellsInRange: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => [number, number, number, number];
+    readonly hwpdocument_splitTableCellsInRangeEx: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_textToLogicalOffset: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly hwpdocument_toggleHideHeaderFooter: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_ungroupShape: (a: number, b: number, c: number, d: number) => [number, number, number, number];