kindy-editor 3.2.5 → 3.2.6

package/dist-lib/{kindy-editor-CT14IO-Y.js → kindy-editor-CToKn_gP.js}

@@ -2,7 +2,7 @@ import "./qrcode-efBlPzzh.js";
 import { m as x } from "./stylesheet-BT1DGhnx.js";
 import { H as m, A as f, C as v, b as y, I as w, T as C, F as T, d as S, e as L, E as D, D as P } from "./paintStyle-Cb7IGKPW.js";
 import { E as A } from "./changeAggregator-ZI959nPP.js";
-const z = 1.1, B = 0.25, R = 5, M = 36, p = {
+const z = 1.1, B = 0.25, R = 5, M = 36, c = {
   canvasBackground: "#e8eaed",
   grid: P,
   gridMesh: "rgba(0,0,0,0.08)",
@@ -37,10 +37,10 @@ const z = 1.1, B = 0.25, R = 5, M = 36, p = {
 };
 function E(r) {
   return r ? {
-    ...p,
+    ...c,
     ...l(r),
-    ruler: { ...p.ruler, ...r.ruler ? l(r.ruler) : {} }
-  } : p;
+    ruler: { ...c.ruler, ...r.ruler ? l(r.ruler) : {} }
+  } : c;
 }
 function F(r) {
   return r ? { ...g, ...l(r) } : g;
@@ -77,10 +77,10 @@ function O(r) {
 }
 function l(r) {
   const e = {};
-  for (const [t, n] of Object.entries(r)) n !== void 0 && (e[t] = n);
+  for (const [t, o] of Object.entries(r)) o !== void 0 && (e[t] = o);
   return e;
 }
-const N = "kindy-editor-styles", H = `
+const H = "kindy-editor-styles", N = `
 /* ===== Design tokens (Office 365 / Fluent-inspired palette) ========= */
 .kindy-editor-root {
   /* Brand blues */
@@ -783,39 +783,39 @@ function h(r, e) {
   t.id = r, t.textContent = e, document.head.appendChild(t);
 }
 function J() {
-  h(N, H);
+  h(H, N);
 }
 const U = `
 .ked-drag-handle{cursor:move;user-select:none;}
 .ked-drag-handle::before{content:"⠿";color:#b0b4ba;font-size:14px;line-height:1;margin-right:4px;flex:0 0 auto;}`;
 function Z(r) {
   h("ked-drag-handle-styles", U);
-  const { backdrop: e, modal: t, handle: n, signal: o } = r;
-  e.style.pointerEvents = "none", e.style.background = "transparent", e.style.display = "block", t.style.position = "fixed", t.style.margin = "0", t.style.pointerEvents = "auto", n.classList.add("ked-drag-handle");
+  const { backdrop: e, modal: t, handle: o, signal: n } = r;
+  e.style.pointerEvents = "none", e.style.background = "transparent", e.style.display = "block", t.style.position = "fixed", t.style.margin = "0", t.style.pointerEvents = "auto", o.classList.add("ked-drag-handle");
   const d = (a, s) => {
     const b = Math.max(4, window.innerWidth - t.offsetWidth - 6), k = Math.max(4, window.innerHeight - 44);
     t.style.left = `${Math.min(Math.max(4, a), b)}px`, t.style.top = `${Math.min(Math.max(4, s), k)}px`;
   };
   d(window.innerWidth - t.offsetWidth - 24, 72);
   let i = null;
-  n.addEventListener(
+  o.addEventListener(
     "mousedown",
     (a) => {
       if (r.noDrag && a.target.closest(r.noDrag)) return;
       const s = t.getBoundingClientRect();
       i = { dx: a.clientX - s.left, dy: a.clientY - s.top }, a.preventDefault();
     },
-    { signal: o }
+    { signal: n }
   ), window.addEventListener("mousemove", (a) => {
     i && d(a.clientX - i.dx, a.clientY - i.dy);
-  }, { signal: o }), window.addEventListener("mouseup", () => {
+  }, { signal: n }), window.addEventListener("mouseup", () => {
     i = null;
-  }, { signal: o });
+  }, { signal: n });
 }
-const c = 0.15;
+const p = 0.15;
 function Y(r, e) {
   const t = e > 0 ? r / e : 1;
-  return { phase: "fonts", loaded: r, total: e, percent: c + (1 - c) * t };
+  return { phase: "fonts", loaded: r, total: e, percent: p + (1 - p) * t };
 }
 const u = {
   common: {
@@ -1298,7 +1298,7 @@ const u = {
     submit: "Comment",
     replyPlaceholder: "Reply…"
   }
-}, K = {
+}, V = {
   common: {
     ok: "Đồng ý",
     cancel: "Hủy",
@@ -1779,13 +1779,13 @@ const u = {
     submit: "Nhận xét",
     replyPlaceholder: "Trả lời…"
   }
-}, V = {
+}, K = {
   en: u,
-  vi: K
+  vi: V
 };
 function j(r) {
   const t = (r ?? (typeof navigator < "u" ? navigator.language : "en") ?? "en").split(/[-_]/)[0].toLowerCase();
-  return V[t] ?? u;
+  return K[t] ?? u;
 }
 class $ {
   /** Namespaced, typed public integration events. Legacy on()/off() remains. */
@@ -1796,7 +1796,7 @@ class $ {
   handlers = /* @__PURE__ */ new Map();
   constructor(e) {
     this.pendingQRCode = e.qrCode, this.events = new A(e.events), this.ready = new Promise((t) => {
-      const n = {
+      const o = {
         container: e.container,
         backendUrl: e.backendUrl,
         // `docId` is the canonical name; fall back to the deprecated `collabId`.
@@ -1828,27 +1828,27 @@ class $ {
         onVariableClick: e.onVariableClick,
         showVariablePopover: e.showVariablePopover,
         qrCode: e.qrCode,
-        onReady: (o) => {
-          this.handle = o, this.pendingQRCode !== void 0 && o.setQRCode(this.pendingQRCode), t(o);
+        onReady: (n) => {
+          this.handle = n, this.pendingQRCode !== void 0 && n.setQRCode(this.pendingQRCode), t(n);
         },
-        onEvent: (o) => this.emit(o),
-        onPublicEvent: (o) => this.events.dispatch(o)
+        onEvent: (n) => this.emit(n),
+        onPublicEvent: (n) => this.events.dispatch(n)
       };
-      e.onLoadProgress?.({ phase: "bundle", percent: 0, loaded: 0, total: 0 }), import("./editorApp-B6qDC4lD.js").then((o) => o.e).then((o) => (e.onLoadProgress?.({ phase: "bundle", percent: c, loaded: 0, total: 0 }), o.mountEditorApp(n)));
+      e.onLoadProgress?.({ phase: "bundle", percent: 0, loaded: 0, total: 0 }), import("./editorApp-Bu3dbUIU.js").then((n) => n.e).then((n) => (e.onLoadProgress?.({ phase: "bundle", percent: p, loaded: 0, total: 0 }), n.mountEditorApp(o)));
     });
   }
   /** Subscribe to a collaboration event. Returns an unsubscribe function. */
   on(e, t) {
-    let n = this.handlers.get(e);
-    return n || this.handlers.set(e, n = /* @__PURE__ */ new Set()), n.add(t), () => this.off(e, t);
+    let o = this.handlers.get(e);
+    return o || this.handlers.set(e, o = /* @__PURE__ */ new Set()), o.add(t), () => this.off(e, t);
   }
   /** Unsubscribe a handler previously passed to on(). */
   off(e, t) {
     this.handlers.get(e)?.delete(t);
   }
   emit(e) {
-    const { type: t, ...n } = e;
-    for (const o of this.handlers.get(t) ?? []) o(n);
+    const { type: t, ...o } = e;
+    for (const n of this.handlers.get(t) ?? []) n(o);
   }
   /** Resolves once the editor is mounted and ready. */
   whenReady() {
@@ -1882,20 +1882,20 @@ class $ {
    *  is ready are buffered and flush on ready. (mountEditor() requires the editor
    *  to be ready — await whenReady() first.) */
   createChild() {
-    let e = null, t = null, n = !1;
-    return this.ready.then((o) => {
-      n || (e = o.createChild(), t?.(), t = null);
+    let e = null, t = null, o = !1;
+    return this.ready.then((n) => {
+      o || (e = n.createChild(), t?.(), t = null);
     }), {
-      render: (o, d, i) => {
-        const a = () => e?.render(o, d, i);
+      render: (n, d, i) => {
+        const a = () => e?.render(n, d, i);
         e ? a() : t = a;
       },
-      mountEditor: (o, d, i) => {
+      mountEditor: (n, d, i) => {
         if (!e) throw new Error("KindyEditor.createChild(): await whenReady() before mountEditor()");
-        return e.mountEditor(o, d, i);
+        return e.mountEditor(n, d, i);
       },
       destroy: () => {
-        n = !0, e?.destroy(), e = null;
+        o = !0, e?.destroy(), e = null;
       }
     };
   }
@@ -1981,8 +1981,8 @@ class $ {
   async addComment(e, t) {
     return (await this.ready).addComment(e, t);
   }
-  async replyToComment(e, t, n) {
-    (await this.ready).replyToComment(e, t, n);
+  async replyToComment(e, t, o) {
+    (await this.ready).replyToComment(e, t, o);
   }
   async startComment() {
     (await this.ready).startComment();
@@ -1990,8 +1990,8 @@ class $ {
   async openCommentThread(e) {
     (await this.ready).openCommentThread(e);
   }
-  async editComment(e, t, n, o) {
-    (await this.ready).editComment(e, t, n, o);
+  async editComment(e, t, o, n) {
+    (await this.ready).editComment(e, t, o, n);
   }
   async deleteComment(e, t) {
     (await this.ready).deleteComment(e, t);
@@ -2023,6 +2023,26 @@ class $ {
   async executeTableAction(e) {
     return (await this.ready).executeTableAction(e);
   }
+  /** Check if a table action can be executed by host with optional selection. */
+  canExecuteHostTableAction(e, t) {
+    return this.handle?.canExecuteHostTableAction(e, t) ?? !1;
+  }
+  /** Execute a table action from host/code, optionally targeting a specific selection or table path/ID. */
+  async executeHostTableAction(e, t) {
+    return (await this.ready).executeHostTableAction(e, t);
+  }
+  /** Update the text value of a single cell in a table. */
+  async setTableCellValue(e, t, o, n) {
+    return (await this.ready).setTableCellValue(e, t, o, n);
+  }
+  /** Replace data rows in a table in a single atomic batch update. */
+  async replaceTableRows(e, t, o) {
+    return (await this.ready).replaceTableRows(e, t, o);
+  }
+  /** Get summaries of all tables in the document. */
+  getTables() {
+    return this.handle?.getTables() ?? [];
+  }
   getDocId() {
     return this.handle?.getDocId() ?? null;
   }
@@ -2042,14 +2062,18 @@ class $ {
   async revealRange(e, t) {
     (await this.ready).revealRange(e, t);
   }
+  /** Scroll the viewport directly to the specified 1-based page number. */
+  async goToPage(e, t) {
+    return (await this.ready).goToPage(e, t);
+  }
   /** Live-update {{KEY}} template placeholders in the document without full reload,
    *  preserving zoom, scroll position, and selection. */
   async setTemplateVariables(e, t) {
     (await this.ready).setTemplateVariables(e, t);
   }
   /** Revert a template variable to an earlier value recorded in its audit history. */
-  async revertTemplateVariable(e, t, n) {
-    return (await this.ready).revertTemplateVariable(e, t, n);
+  async revertTemplateVariable(e, t, o) {
+    return (await this.ready).revertTemplateVariable(e, t, o);
   }
   /** Insert an atomic template variable token at current caret/selection. */
   async insertTemplateVariable(e, t) {
@@ -2108,8 +2132,8 @@ class $ {
     (await this.ready).markSigningArea(e);
   }
   /** Thay đổi kích thước (Width x Height) của một ô ký */
-  async resizeSignatureBox(e, t, n) {
-    (await this.ready).resizeSignatureBox(e, t, n);
+  async resizeSignatureBox(e, t, o) {
+    (await this.ready).resizeSignatureBox(e, t, o);
   }
   /** Cập nhật thông tin và kích thước của một ô ký */
   async updateSignatureBox(e, t) {
@@ -2132,7 +2156,7 @@ class $ {
   }
 }
 export {
-  p as D,
+  c as D,
   $ as K,
   B as Z,
   R as a,

package/dist-lib/kindy-editor.js

@@ -1,4 +1,4 @@
-import { K as e, d as o, m as r } from "./kindy-editor-CT14IO-Y.js";
+import { K as e, d as o, m as r } from "./kindy-editor-CToKn_gP.js";
 import { C as i, a as m, E as n, c as g } from "./changeAggregator-ZI959nPP.js";
 export {
   i as ChangeAggregator,

package/dist-lib/{webmcp-BcWSo1v9.js → webmcp-ClHEa6Gq.js}

@@ -332,7 +332,7 @@ function H(e, o = {}, r = {}) {
       if (i && e.search(i).total === 0)
         return e.searchClear(), f(`text not found: ${i}`);
       if (!e.getSelection()) return f("no selection (pass 'find' or select_range first)");
-      const { insertText: d } = await import("./editorApp-B6qDC4lD.js").then((m) => m.c);
+      const { insertText: d } = await import("./editorApp-Bu3dbUIU.js").then((m) => m.c);
       return e.dispatch(d(t)), i && e.searchClear(), g("inserted");
     }
   }), a({

package/docs/qrcode-integration-guide.md

@@ -514,8 +514,43 @@ Mỗi khi cấu hình mã QR được cập nhật (`editor.setQRCode(...)`), h
 
 ---
 
-## 11. Lịch sử Cập nhật (Update Log)
+## 11. Xử lý Điều Hướng Trang Khi Quét QR (`goToPage`)
 
+Khi người dùng quét mã QR trên bản in hoặc văn bản điện tử, đường dẫn mở ra sẽ chứa tham số trang:
+```text
+https://my-hospital.vn/verify/BA-2026-0012?page=3
+```
+
+Ứng dụng Host FE chỉ cần đọc tham số `?page=N` từ URL và gọi `goToPage` trên `KindyEditor` hoặc `EditorHandle`:
+
+```ts
+const urlParams = new URLSearchParams(window.location.search);
+const pageParam = urlParams.get("page");
+
+if (pageParam) {
+  const page = parseInt(pageParam, 10);
+  // Tự động chờ layout render xong, tự scroll chuẩn xác container Kindy
+  const success = await editor.goToPage(page, { behavior: "smooth" });
+  if (!success) {
+    console.warn("Không thể chuyển tới trang:", page);
+  }
+}
+```
+
+### Các ưu điểm nổi bật của `goToPage`:
+- **`pageNumber` bắt đầu từ 1** (1-based).
+- **Tự động chờ layout hoàn tất**: Tự đợi layout engine tính toán và DOM mount xong trước khi scroll, giải quyết triệt để lỗi scroll hụt khi vừa mở tài liệu.
+- **Tự scroll đúng container Kindy**: Cuộn chính xác thanh cuộn `.ked-app` của editor, không làm lệch hay cuộn trang web bên ngoài của host.
+- **Tự clamp trang**: Nếu số trang truyền vào vượt quá tổng số trang tài liệu (ví dụ trang 10 nhưng tài liệu chỉ có 4 trang), editor tự động cuộn đến trang cuối cùng.
+- **Kiểm tra hợp lệ an toàn**: Trả về `false` nếu `pageNumber` không hợp lệ (`<= 0`, `NaN`, chuỗi không phải số).
+- **Hoạt động đa nền tảng & đa chế độ**: Hoạt động hoàn hảo trong mọi chế độ (`view`, `comment`, `edit`), chế độ toàn màn hình (fullscreen) cũng như giao diện thu gọn trên điện thoại di động (mobile).
+
+---
+
+## 12. Lịch sử Cập nhật (Update Log)
+
+* **v3.2.5**:
+  - ✅ **Bổ sung `goToPage(pageNumber, options)`**: Hỗ trợ cuộn mượt hoặc tức thì tới trang chỉ định theo tham số `?page=N` từ URL khi quét mã QR, tự động chờ layout render và tự clamp trang.
 * **v3.2.4**:
   - ✅ **Tự động sinh `?page=N` (`autoPageParam`)**: Chỉ cần truyền URL gốc (ví dụ: `https://my-hospital.vn/verify/{docId}`), thư viện sẽ tự động phân tích và sinh thêm `?page=1`, `?page=2`... cho từng trang. Tự động dùng `&page=N` nếu URL đã có sẵn tham số.
   - ✅ **Chuẩn hóa URL Parameter**: Đổi từ `?page={page}/{totalPages}` sang chuẩn web `?page={page}` (ví dụ: `?page=1`, `?page=2`).

package/docs/table-editing.md

@@ -26,7 +26,103 @@ Vì vậy thao tác chèn/xóa hàng hoặc cột, merge/unmerge và undo đều
 
 Mọi structural command là một transaction duy nhất, nên Undo/Redo không để lại bảng ở trạng thái trung gian.
 
-## API tích hợp
+## Thao tác bảng từ Host Application trong View Mode (`mode: "view"`)
+
+Khi ứng dụng chạy ở chế độ xem (`mode: "view"`), người dùng **không thể click hoặc chỉnh sửa canvas trực tiếp**. Toolbar, thanh hover rail và context menu chỉnh sửa hoàn toàn bị khóa.
+
+Để cho phép ứng dụng FE (form ngoài, modal, wizard) thao tác và cập nhật bảng bằng code mà người dùng vẫn ở View Mode, cấp quyền `hostTableMutation: true`:
+
+```ts
+const editor = new KindyEditor({
+  container: document.getElementById("editor"),
+  mode: "view",
+  permissions: {
+    hostTableMutation: true,
+  },
+});
+```
+
+### Các API thao tác bảng từ Host
+
+#### 1. Lấy danh sách bảng (`getTables`)
+```ts
+const tables = editor.getTables();
+// [
+//   {
+//     tableId: "table_1",
+//     tablePath: { story: { kind: "body" }, ancestors: [], tableId: "table_1" },
+//     rows: 5,
+//     cols: 3,
+//     header: ["STT", "Tên hàng", "Thành tiền"],
+//     hasMergedCells: false
+//   }
+// ]
+```
+
+#### 2. Thực thi Table Action với selection trực tiếp (`executeHostTableAction`)
+Không cần người dùng click canvas. Host truyền trực tiếp `TableAction` cùng selection:
+
+```ts
+// Thêm 1 dòng dưới dòng index 1
+await editor.executeHostTableAction("insertRowBelow", { tableId: "table_1", row: 1 });
+
+// Thêm 1 cột bên phải cột index 0
+await editor.executeHostTableAction("insertColumnRight", { tableId: "table_1", col: 0 });
+
+// Xóa dòng index 2
+await editor.executeHostTableAction("deleteRow", { tableId: "table_1", row: 2 });
+
+// Merge các ô từ (1, 0) đến (1, 2)
+await editor.executeHostTableAction("mergeCells", {
+  tableId: "table_1",
+  fromRow: 1,
+  toRow: 1,
+  fromCol: 0,
+  toCol: 2
+});
+
+// Xóa bảng
+await editor.executeHostTableAction("deleteTable", "table_1");
+```
+
+Kiểm tra action có khả thi trước khi thực thi:
+```ts
+if (editor.canExecuteHostTableAction("deleteRow", { tableId: "table_1", row: 1 })) {
+  await editor.executeHostTableAction("deleteRow", { tableId: "table_1", row: 1 });
+}
+```
+
+#### 3. Nhập giá trị vào 1 ô (`setTableCellValue`)
+Cập nhật nội dung một ô theo tọa độ `(row, column)`. Tự động giữ nguyên định dạng cell/paragraph (font, kích thước, căn lề, màu sắc) và hỗ trợ xuống dòng:
+
+```ts
+await editor.setTableCellValue("table_1", 1, 2, "250.000 đ");
+```
+
+#### 4. Thay thế nhiều dòng dữ liệu cùng lúc (`replaceTableRows`)
+Cập nhật hàng loạt dòng dữ liệu trong một transaction nguyên tử (atomic update).
+- Tự động giữ format từ dòng mẫu (`sampleRowIndex`).
+- Giữ nguyên header (`headerRows`) và footer (`footerRows`).
+- Tự động sinh ID duy nhất cho cell/paragraph mới.
+- Validate cấu trúc bảng và render canvas đúng một lần.
+
+```ts
+await editor.replaceTableRows(
+  "table_1",
+  [
+    ["1", "Sản phẩm A", "100.000"],
+    ["2", "Sản phẩm B", "200.000"],
+    ["3", "Sản phẩm C", "300.000"],
+  ],
+  {
+    headerRows: 1,      // Giữ nguyên dòng tiêu đề
+    footerRows: 1,      // Giữ nguyên dòng tổng cộng
+    sampleRowIndex: 1,  // Lấy định dạng font/style từ dòng mẫu 1
+  }
+);
+```
+
+## API tương tác canvas thông thường
 
 ```ts
 import type { TablePath, TableSelection } from "kindy-editor";

package/docs/table-form-integration.md

@@ -533,7 +533,94 @@ Thanh công cụ Ribbon của Editor có độ rộng mặc định tương đ
 
 ---
 
-## 10. Trải Nghiệm Trang Demo Trực Quan
+## 10. Thao Tác Table Native Trong View Mode (`mode: "view"`)
+
+Nếu sản phẩm yêu cầu Kindy chạy ở chế độ **View Mode** (người dùng không thể gõ hoặc sửa trực tiếp trên canvas, toolbar/context menu/hover rail bị khóa), FE có thể dùng các API table native tích hợp sẵn:
+
+### 10.1 Cấp quyền `hostTableMutation`
+
+```ts
+const editor = new KindyEditor({
+  container: document.getElementById("editor-container"),
+  mode: "view",
+  permissions: {
+    hostTableMutation: true, // Cho phép host thao tác bảng trong View Mode
+  },
+});
+```
+
+### 10.2 Lấy danh sách bảng (`editor.getTables()`)
+
+```ts
+const tables = editor.getTables();
+// tables[0] -> {
+//   tableId: "tbl_invoice",
+//   rows: 4,
+//   cols: 5,
+//   header: ["STT", "Mã", "Tên dịch vụ", "Số lượng", "Đơn giá"],
+//   hasMergedCells: false
+// }
+```
+
+### 10.3 Cập nhật giá trị ô (`editor.setTableCellValue()`)
+
+```ts
+// Cập nhật ô dòng 1, cột 2 (0-indexed)
+await editor.setTableCellValue("tbl_invoice", 1, 2, "Khám tổng quát");
+```
+
+### 10.4 Thay thế nhiều dòng dữ liệu một lần (`editor.replaceTableRows()`)
+
+Cập nhật hàng loạt dòng dữ liệu trong một transaction nguyên tử:
+- Giữ nguyên số dòng header (`headerRows`) và footer (`footerRows`).
+- Giữ format font, shading, border từ dòng mẫu (`sampleRowIndex`).
+- Tự động sinh ID hợp lệ duy nhất cho từng cell và paragraph.
+- Validate bảng và render canvas đúng một lần.
+
+```ts
+const rowsFromForm = [
+  ["1", "DV01", "Siêu âm màu", "1", "150.000"],
+  ["2", "DV02", "Xét nghiệm máu", "1", "200.000"],
+  ["3", "DV03", "Chụp X-quang", "2", "300.000"],
+];
+
+await editor.replaceTableRows("tbl_invoice", rowsFromForm, {
+  headerRows: 1,
+  footerRows: 1,
+  sampleRowIndex: 1,
+});
+```
+
+### 10.5 Chạy Table Action từ FE (`editor.executeHostTableAction()`)
+
+Tái sử dụng toàn bộ 9 Table Action mà không phụ thuộc con trỏ chuột:
+
+```ts
+// Thêm 1 dòng dưới dòng 1
+await editor.executeHostTableAction("insertRowBelow", { tableId: "tbl_invoice", row: 1 });
+
+// Thêm cột bên phải cột 2
+await editor.executeHostTableAction("insertColumnRight", { tableId: "tbl_invoice", col: 2 });
+
+// Xóa dòng 3
+await editor.executeHostTableAction("deleteRow", { tableId: "tbl_invoice", row: 3 });
+
+// Merge ô từ dòng 1 cột 0 đến dòng 1 cột 2
+await editor.executeHostTableAction("mergeCells", {
+  tableId: "tbl_invoice",
+  fromRow: 1,
+  toRow: 1,
+  fromCol: 0,
+  toCol: 2,
+});
+
+// Xóa bảng
+await editor.executeHostTableAction("deleteTable", "tbl_invoice");
+```
+
+---
+
+## 11. Trải Nghiệm Trang Demo Trực Quan
 
 Kindy Editor cung cấp sẵn trang demo tương tác đầy đủ các tính năng trên:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kindy-editor",
-  "version": "3.2.5",
+  "version": "3.2.6",
   "type": "module",
   "description": "Trình soạn thảo tài liệu Word chính xác, vẽ bằng canvas",
   "license": "MIT",

package/types/kindy-editor.d.ts

@@ -196,6 +196,7 @@ export interface EditorPermissions {
   copy: boolean;
   createComment: boolean;
   viewComment: boolean;
+  hostTableMutation?: boolean;
 }
 
 /** A selection/caret in the document (offsets are UTF-16 code units into a
@@ -227,6 +228,73 @@ export type TableAction =
   | "deleteRow" | "deleteColumn" | "deleteTable"
   | "mergeCells" | "unmergeCell";
 
+export type TableCellValue =
+  | string
+  | number
+  | boolean
+  | null
+  | undefined
+  | { text?: string; value?: unknown };
+
+export type HostTableSelection =
+  | TableSelection
+  | {
+      kind?: "cell";
+      table?: string | TablePath;
+      tableId?: string;
+      anchor: TableGridPoint;
+      focus?: TableGridPoint;
+    }
+  | {
+      kind: "row";
+      table?: string | TablePath;
+      tableId?: string;
+      from: number;
+      to?: number;
+    }
+  | {
+      kind: "column";
+      table?: string | TablePath;
+      tableId?: string;
+      from: number;
+      to?: number;
+    }
+  | {
+      kind: "table";
+      table?: string | TablePath;
+      tableId?: string;
+    }
+  | {
+      tableId: string;
+      row?: number;
+      col?: number;
+      fromRow?: number;
+      toRow?: number;
+      fromCol?: number;
+      toCol?: number;
+    }
+  | string;
+
+export interface TableSummary {
+  tableId: string;
+  tablePath: TablePath;
+  path: TablePath;
+  rows: number;
+  cols: number;
+  header: string[];
+  headers?: string[][];
+  hasMergedCells: boolean;
+}
+
+export interface ReplaceTableRowsOptions {
+  /** Number of leading rows to preserve as header (defaults to leading repeatHeader rows, or 1 if table has >= 2 rows). */
+  headerRows?: number;
+  /** Number of trailing rows to preserve as footer (defaults to 0). */
+  footerRows?: number;
+  /** Index of the row to use as formatting template (defaults to first data row after header, or row 0). */
+  sampleRowIndex?: number;
+}
+
 // ===== Review layer (track changes + comments) =============================
 // An attributed, anchored overlay on top of the core document. `getReview()`
 // returns a snapshot; the `reviewChanged` event carries the full layer.
@@ -908,6 +976,15 @@ export interface EditorHandle {
   setTableSelection(selection: TableSelection | null): void;
   canExecuteTableAction(action: TableAction): boolean;
   executeTableAction(action: TableAction): boolean;
+  canExecuteHostTableAction(action: TableAction, selection?: HostTableSelection | TableSelection): boolean;
+  executeHostTableAction(action: TableAction, selection?: HostTableSelection | TableSelection): boolean;
+  setTableCellValue(table: string | TablePath, row: number, column: number, value: TableCellValue): boolean;
+  replaceTableRows(
+    table: string | TablePath,
+    rows: Array<Array<TableCellValue> | Record<string, unknown>>,
+    options?: ReplaceTableRowsOptions,
+  ): boolean;
+  getTables(): TableSummary[];
   // ---- review layer (track changes + comments) ----------------------------
   /** The current editor mode. */
   getMode(): EditMode;
@@ -944,6 +1021,11 @@ export interface EditorHandle {
   clearExternalAnnotations(): void;
   /** Scroll the viewport to reveal a document range with smooth animation. */
   revealRange(range: ExternalRange, options?: RevealRangeOptions): void;
+  /** Scroll the viewport directly to the specified 1-based page number. */
+  goToPage(
+    pageNumber: number,
+    options?: { behavior?: "auto" | "smooth" },
+  ): Promise<boolean>;
   /** Live-update {{KEY}} template placeholders in the document without full reload,
    *  preserving zoom, scroll position, and selection. */
   setTemplateVariables(values: TemplateVariableValues, options?: SetTemplateVariablesOptions): void;
@@ -1066,6 +1148,15 @@ export declare class KindyEditor {
   setTableSelection(selection: TableSelection | null): Promise<void>;
   canExecuteTableAction(action: TableAction): boolean;
   executeTableAction(action: TableAction): Promise<boolean>;
+  canExecuteHostTableAction(action: TableAction, selection?: HostTableSelection | TableSelection): boolean;
+  executeHostTableAction(action: TableAction, selection?: HostTableSelection | TableSelection): Promise<boolean>;
+  setTableCellValue(table: string | TablePath, row: number, column: number, value: TableCellValue): Promise<boolean>;
+  replaceTableRows(
+    table: string | TablePath,
+    rows: Array<Array<TableCellValue> | Record<string, unknown>>,
+    options?: ReplaceTableRowsOptions,
+  ): Promise<boolean>;
+  getTables(): TableSummary[];
   getDocId(): string | null;
   getShareLink(): string | null;
   /** Render ephemeral highlight decorations for external comments/annotations.
@@ -1075,6 +1166,11 @@ export declare class KindyEditor {
   clearExternalAnnotations(): Promise<void>;
   /** Scroll the viewport to reveal a document range with smooth animation. */
   revealRange(range: ExternalRange, options?: RevealRangeOptions): Promise<void>;
+  /** Scroll the viewport directly to the specified 1-based page number. */
+  goToPage(
+    pageNumber: number,
+    options?: { behavior?: "auto" | "smooth" },
+  ): Promise<boolean>;
   /** Live-update {{KEY}} template placeholders in the document without full reload,
    *  preserving zoom, scroll position, and selection. */
   setTemplateVariables(values: TemplateVariableValues, options?: SetTemplateVariablesOptions): Promise<void>;