kindy-editor 3.2.6 → 3.2.8

package/dist-lib/{stylesheet-BT1DGhnx.js → stylesheet-BfxJTGA5.js}

@@ -1,4 +1,4 @@
-import { p as u } from "./qrcode-efBlPzzh.js";
+import { p as u } from "./qrcode-CR8i1-w0.js";
 function p(e) {
   return e.type ?? "paragraph";
 }

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

@@ -1,4 +1,4 @@
-import { p as j, c as _, e as F, t as k, D as L } from "./qrcode-efBlPzzh.js";
+import { p as j, c as _, e as F, t as k, D as L } from "./qrcode-CR8i1-w0.js";
 const s = (e) => Math.round(e * 100) / 100;
 function A(e) {
   const o = { font: e.fontFamily, sizePx: e.fontSizePx };
@@ -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-Bu3dbUIU.js").then((m) => m.c);
+      const { insertText: d } = await import("./kindy-editor-T1YCQdwF.js").then((m) => m.c);
       return e.dispatch(d(t)), i && e.searchClear(), g("inserted");
     }
   }), a({

package/docs/find-and-replace.md

@@ -0,0 +1,224 @@
+# Tìm kiếm, Thay thế & Cuộn Focus (Find & Replace API)
+
+Kindy Editor cung cấp hệ thống Tìm kiếm & Thay thế (Find & Replace) mạnh mẽ trên nền Canvas, hỗ trợ tính toán tọa độ ký tự chính xác, tự động bôi đen (selection) và **tự động cuộn màn hình (scroll focus)** đến vị trí văn bản cần thay thế.
+
+---
+
+## 1. Cơ chế hoạt động (How it works)
+
+Khi tìm kiếm hoặc thay thế, editor thực hiện các bước sau:
+
+```text
+[search(query)] 
+   │
+   ├── 1. Quét AST text của các block trong Document
+   ├── 2. Highlight tất cả các matches trên Canvas overlay
+   └── 3. gotoMatch(0):
+            ├── setSelection({ anchor, focus })  --> Bôi đen match
+            ├── caretRect(tree, position)        --> Tính tọa độ pixel trên trang
+            └── paint.ensureVisible(rect)        --> TỰ ĐỘNG CUỘN VIEWPORT ĐẾN MATCH
+```
+
+Khi thực hiện thay thế (`searchReplaceCurrent`):
+1. Match đang chọn được thay thế bằng chuỗi mới thông qua một **Transaction nguyên tử** (Atomic Op Group: `deleteRange` + `insertText`).
+2. Editor tự động quét lại các match còn lại.
+3. Tự động chuyển con trỏ và **cuộn màn hình đến match kế tiếp** ngay lập tức.
+4. Toàn bộ thao tác có thể **Undo (`Ctrl+Z`)** hoàn hảo.
+
+---
+
+## 2. Danh sách API (API Reference)
+
+Các API này có thể được gọi trực tiếp từ đối tượng editor (`KindyEditorElement` hoặc `EditorHandle`):
+
+### `search(query, opts?): Promise<SearchState>`
+Tìm kiếm văn bản trong tài liệu, đánh dấu tất cả các vị trí trùng khớp và tự động cuộn focus đến match đầu tiên.
+- **Tham số**:
+  - `query: string`: Từ khóa cần tìm.
+  - `opts?: { matchCase?: boolean; wholeWord?: boolean }`:
+    - `matchCase`: Khớp chính xác chữ hoa/chữ thường (mặc định: `false`).
+    - `wholeWord`: Chỉ khớp từ nguyên vẹn (mặc định: `false`).
+- **Trả về**: `Promise<SearchState>` gồm `{ index: number, total: number }` (1-based, ví dụ `1/12`).
+
+### `searchNav(dir): Promise<SearchState>`
+Điều hướng giữa các kết quả tìm kiếm và tự động cuộn màn hình đến kết quả đó.
+- **Tham số**:
+  - `dir: 1 | -1`: `1` để chuyển đến match kế tiếp, `-1` để quay lại match trước.
+- **Trả về**: `Promise<SearchState>`.
+
+### `searchReplaceCurrent(replacement): Promise<SearchState>`
+Thay thế kết quả đang được chọn bằng nội dung mới, sau đó **tự động nhảy và cuộn focus đến match kế tiếp**.
+- **Tham số**:
+  - `replacement: string`: Chuỗi văn bản thay thế.
+- **Trả về**: `Promise<SearchState>` biểu thị vị trí match tiếp theo.
+
+### `searchReplaceAll(replacement): Promise<number>`
+Thay thế toàn bộ tất cả các kết quả tìm kiếm trong tài liệu trong một transaction duy nhất (1 lần Undo).
+- **Tham số**:
+  - `replacement: string`: Chuỗi văn bản thay thế.
+- **Trả về**: `Promise<number>`: Số lượng đoạn văn bản đã được thay thế.
+
+### `searchClear(): Promise<void>`
+Xóa tất cả highlight tìm kiếm và đóng trạng thái tìm kiếm hiện tại.
+
+### `revealRange(range, options?): Promise<void>`
+Cuộn viewport đến bất kỳ vị trí text range nào trong văn bản (hữu ích cho AI suggestion hoặc spellcheck).
+- **Tham số**:
+  - `range: ExternalRange`: Gồm `{ start: { blockId, offset }, end: { blockId, offset } }`.
+  - `options?: RevealRangeOptions`:
+    - `behavior?: "auto" | "smooth"`: Hiệu ứng cuộn mượt (mặc định `"smooth"`).
+    - `align?: "nearest" | "center"`: Vị trí canh lề (mặc định `"center"`).
+    - `durationMs?: number`: Thời gian animation cuộn (mặc định `280ms`).
+
+---
+
+## 3. Hướng dẫn tích hợp hệ thống (System Integration Guide)
+
+### Cách 1: Sử dụng UI Tìm kiếm & Thay thế có sẵn (Built-in UI)
+
+Kindy Editor đã tích hợp sẵn thanh công cụ Find & Replace:
+- **Phím tắt**: Nhấn `Ctrl + F` (hoặc `Cmd + F` trên macOS).
+- **Ribbon**: Chọn tab **Trang chủ** / **Home** -> nút **Tìm kiếm / Thay thế**.
+- Giao diện có sẵn:
+  - Ô nhập từ khóa tìm kiếm và ô nhập nội dung thay thế.
+  - Tùy chọn khớp hoa/thường (`Aa`) và khớp nguyên từ (`[W]`).
+  - Nút điều hướng trước/sau (`‹`, `›`) với phím tắt `Enter` / `Shift+Enter`.
+  - Nút `Replace` và `Replace All`.
+  - Bộ đếm `1/5` hiển thị số lượng match trực quan.
+
+---
+
+### Cách 2: Tích hợp Custom Search & Replace Toolbar từ Host Application
+
+Nếu hệ thống của bạn muốn xây dựng thanh tìm kiếm riêng bên ngoài khung editor (ví dụ: thanh công cụ header của ứng dụng web React / Vue / Angular):
+
+#### Mã nguồn tích hợp JavaScript / TypeScript:
+
+```ts
+import type { KindyEditorElement, SearchState } from "kindy-editor";
+
+// 1. Lấy tham chiếu đến web component kindy-editor
+const editor = document.querySelector("kindy-editor") as KindyEditorElement;
+
+// 2. Thực hiện tìm kiếm
+async function handleSearch(keyword: string) {
+  if (!keyword.trim()) {
+    await editor.searchClear();
+    return;
+  }
+
+  // search() tự động highlight VÀ cuộn focus đến kết quả đầu tiên
+  const state: SearchState = await editor.search(keyword, {
+    matchCase: false, // Không phân biệt hoa/thường
+    wholeWord: false, // Không bắt buộc nguyên từ
+  });
+
+  console.log(`Tìm thấy ${state.total} kết quả. Đang ở vị trí ${state.index}`);
+  updateMatchUI(state);
+}
+
+// 3. Chuyển sang kết quả tiếp theo (Next match)
+async function handleNext() {
+  const state = await editor.searchNav(1);
+  updateMatchUI(state);
+}
+
+// 4. Quay lại kết quả trước (Previous match)
+async function handlePrev() {
+  const state = await editor.searchNav(-1);
+  updateMatchUI(state);
+}
+
+// 5. Thay thế kết quả hiện tại và tự động cuộn đến kết quả tiếp theo
+async function handleReplace(newText: string) {
+  const state = await editor.searchReplaceCurrent(newText);
+  console.log(`Đã thay thế. Chuyển đến kết quả tiếp theo: ${state.index}/${state.total}`);
+  updateMatchUI(state);
+}
+
+// 6. Thay thế tất cả (Replace All)
+async function handleReplaceAll(newText: string) {
+  const count = await editor.searchReplaceAll(newText);
+  alert(`Đã thay thế thành công ${count} vị trí.`);
+  await editor.searchClear();
+}
+
+// 7. Đóng tìm kiếm
+async function handleCloseSearch() {
+  await editor.searchClear();
+}
+
+function updateMatchUI(state: SearchState) {
+  const badge = document.getElementById("search-counter");
+  if (badge) {
+    badge.innerText = state.total > 0 ? `${state.index}/${state.total}` : "0/0";
+  }
+}
+```
+
+---
+
+### Cách 3: Thay thế tại vị trí cụ thể và Scroll Focus (AI Suggestion / Linter)
+
+Khi hệ thống backend (AI rà soát hợp đồng, kiểm tra chính tả) trả về một vị trí lỗi cụ thể và bạn muốn người dùng duyệt qua từng lỗi, cuộn màn hình đến đoạn đó và thay thế:
+
+```ts
+interface ReplacementSuggestion {
+  range: {
+    start: { blockId: string; offset: number };
+    end: { blockId: string; offset: number };
+  };
+  originalText: string;
+  suggestedText: string;
+}
+
+async function reviewAndApplySuggestion(suggestion: ReplacementSuggestion) {
+  // 1. Cuộn màn hình canvas đến vị trí cần sửa với animation mượt
+  await editor.revealRange(suggestion.range, {
+    behavior: "smooth",
+    align: "center",
+  });
+
+  // 2. Tùy chọn: Chọn đoạn văn bản đó để người dùng thấy rõ
+  // (Nếu host có hỗ trợ setSelection)
+
+  // 3. Khi người dùng bấm "Chấp nhận thay thế":
+  // Nếu dùng search theo cụm từ:
+  const state = await editor.search(suggestion.originalText);
+  if (state.total > 0) {
+    await editor.searchReplaceCurrent(suggestion.suggestedText);
+  }
+}
+```
+
+---
+
+### Cách 4: Phân biệt với Thay thế Biến mẫu hợp đồng (`setTemplateVariables`)
+
+Nếu mục đích của bạn là **điền dữ liệu hợp đồng tự động** (ví dụ thay thế `{{HO_TEN}}`, `{{SO_CCCD}}`, `{{NGAY_KY}}`):
+
+👉 **Nên dùng `setTemplateVariables`** thay vì `searchReplaceCurrent`:
+- `setTemplateVariables` cập nhật nguyên tử, bảo toàn format chữ, không phá vỡ cấu trúc và có lịch sử Audit Trail.
+- `searchReplaceCurrent` phù hợp cho tìm kiếm / thay thế văn bản thông thường của người dùng.
+
+```ts
+// Điền tự động các trường dữ liệu hợp đồng
+await editor.setTemplateVariables({
+  HO_TEN: "Nguyễn Văn A",
+  SO_CCCD: "0123456789",
+  NGAY_KY: "10/10/2026"
+});
+```
+
+---
+
+## 4. Bảng tóm tắt các tính năng
+
+| Nhu cầu | Hàm đề xuất | Tự động Scroll & Focus? |
+| :--- | :--- | :---: |
+| Tìm từ khóa và nhảy đến vị trí đó | `editor.search(query, opts)` |  Có (`gotoMatch` -> `paint.ensureVisible`) |
+| Xem kết quả kế tiếp / trước đó | `editor.searchNav(1)` / `(-1)` |  Có |
+| Thay thế từ đang chọn và nhảy đến từ kế tiếp | `editor.searchReplaceCurrent(newText)` |  Có |
+| Thay thế toàn bộ tài liệu | `editor.searchReplaceAll(newText)` | Giữ nguyên selection |
+| Cuộn đến một đoạn bất kỳ theo Range | `editor.revealRange(range, options)` |  Có (Smooth animation) |
+| Xóa highlight tìm kiếm | `editor.searchClear()` | - |

package/docs/security-review.md

@@ -0,0 +1,26 @@
+# Security review — editor hardening
+
+**Reviewed:** 2026-10-09  
+**Scope:** editor repository changes based on `c1aef59f`, covering signature demo DOM rendering, host table mutation permissions and input limits, DOCX archive import, QR configuration logging, and JavaScript development/build dependencies. This is a scoped code review, not a penetration test or product-wide compliance assessment.
+
+## Changes made
+
+- Signature metadata from imported documents is written with DOM `textContent`; the demo's dynamic log messages are text nodes. Fixed placeholder HTML was replaced with DOM construction as well.
+- Host table mutation remains available in normal edit mode. It is off in view/comment modes and turns off when `editContent: false` unless the host explicitly enables `hostTableMutation`. Hosts still need to authorize users and documents at their own trusted boundary.
+- Host table APIs reject over-budget tables and replacements before allocating new cells: 10,000 rows, 256 columns, 50,000 cells, 1,000,000 text characters, 100,000 characters or 1,024 paragraphs per cell, 20,000 paragraphs, and 8 nested table levels.
+- DOCX import rejects archives over 64 MiB compressed, more than 4,096 entries, an entry over 32 MiB expanded, or more than 128 MiB expanded in total. The file/Blob size is checked before reading it into memory.
+- QR configuration values are no longer printed to the developer console. `.env*` files are ignored, with `.env.example` permitted.
+- Updated Vite to 6.4.4, Vitest to 4.1.11, and Vue to 3.5.43. A workspace override keeps VitePress and its Vite plugins on Vite 6.4.4, which meets their published peer ranges.
+
+## Verification
+
+- Focused regression/security tests: **PASS**, 36 tests across table mutation, permissions, DOCX archive limits, and signature rendering, using Vitest 4.1.11.
+- Production library build: **PASS**, Vite 6.4.4.
+- Production dependency audit (`npm audit --omit=dev`): **PASS**, 0 reported findings.
+- Typecheck: **FAIL**. The repository has existing errors in demo/test fixtures, including model shape mismatches and stale editor APIs. This scoped change also revealed no retained `defaultReviewAccessCan` missing-import error; full typecheck remains blocked by the listed broader issues.
+- `npm audit`: **12 findings remain**: 4 high, 2 moderate, and 6 low. High findings are in the `patch-package` → `find-yarn-workspace-root` → `micromatch`/`braces` install tooling chain; npm offers only a major downgrade to patch-package 6.0.7. Remaining moderate findings are `pbkdf2` and `qs`; remaining low findings are in the `vite-plugin-node-polyfills`/`node-stdlib-browser` compatibility chain, whose npm fix also requires a major downgrade. These were not changed automatically because doing so would alter the patch workflow or browser polyfill support. Review and replace these toolchain components before production release if their install/build risk is unacceptable.
+- Secret-pattern scan: **PASS for the checked patterns only** across tracked files and this reviewed change (0 matches); it does not prove the entire Git history is free of secrets.
+
+## Remaining limits and risk
+
+This review does not verify server authentication/authorization, hosting headers/CSP, CORS, CSRF, production secrets, external API rate limits, or runtime behavior in every host integration. The DOCX byte budgets bound archive expansion; malformed files and parser complexity still need normal failure handling. No browser exploit exercise or complete Git-history secrets scan was run.

package/docs/table-editing.md

@@ -30,7 +30,7 @@ Mọi structural command là một transaction duy nhất, nên Undo/Redo không
 
 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`:
+Trong `edit` mode, các thao tác bảng sẵn có được bật như trước. Nếu đặt `editContent: false`, thao tác bảng từ host sẽ tự tắt trừ khi ứng dụng cấp rõ ràng `hostTableMutation: true` sau khi xác thực actor và tài liệu tại lớp host/backend. Trong `view`/`comment` mode, quyền này mặc định tắt:
 
 ```ts
 const editor = new KindyEditor({
@@ -42,6 +42,8 @@ const editor = new KindyEditor({
 });
 ```
 
+Các giới hạn để tránh payload làm nghẽn giao diện: tối đa 10.000 hàng đầu vào, 256 cột mỗi hàng, 50.000 ô trong bảng sau khi thay thế, 1.000.000 ký tự tổng, 100.000 ký tự và 1.024 đoạn trong một ô, 20.000 paragraph và 8 tầng bảng lồng. API trả `false` khi vượt giới hạn; bảng giữ nguyên.
+
 ### Các API thao tác bảng từ Host
 
 #### 1. Lấy danh sách bảng (`getTables`)
@@ -93,11 +95,13 @@ if (editor.canExecuteHostTableAction("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:
+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), tăng `revision`, giải phóng layout cache của bảng, tự động phân trang lại khi kích thước hàng thay đổi và lên lịch repaint mượt mà qua `requestAnimationFrame`:
 
 ```ts
 await editor.setTableCellValue("table_1", 1, 2, "250.000 đ");
 ```
+- **Không cần gọi `setDocument()`**: Thay đổi được áp dụng ngay lập tức mà không phải rebuild lại DOM editor.
+- **Giữ nguyên trạng thái**: Bảo toàn `mode="view"`, vị trí scroll, zoom và vùng chọn ô (`cellSelection`).
 
 #### 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).
@@ -122,6 +126,17 @@ await editor.replaceTableRows(
 );
 ```
 
+#### 5. Giải phóng Cache Layout thủ công (`invalidateLayout`)
+Ép buộc giải phóng cache đo đạc layout của bảng hoặc toàn bộ tài liệu:
+
+```ts
+// Giải phóng cache bảng và repaint
+await editor.invalidateLayout("table_1");
+
+// Hoặc giải phóng toàn bộ cache
+await editor.invalidateLayout();
+```
+
 ## API tương tác canvas thông thường
 
 ```ts

package/docs/table-form-integration.md

@@ -539,6 +539,8 @@ Nếu sản phẩm yêu cầu Kindy chạy ở chế độ **View Mode** (ngư
 
 ### 10.1 Cấp quyền `hostTableMutation`
 
+Quyền này mặc định tắt trong `view`/`comment` mode. Ở `edit` mode, thao tác bảng tích hợp vẫn được bật. Nếu đặt `editContent: false`, thao tác bảng từ host tự tắt trừ khi ứng dụng cấp rõ ràng `hostTableMutation: true` sau khi xác thực quyền người dùng và tài liệu. Đây là quyền ngoại lệ ở API client, không thay thế kiểm tra quyền backend.
+
 ```ts
 const editor = new KindyEditor({
   container: document.getElementById("editor-container"),
@@ -549,6 +551,8 @@ const editor = new KindyEditor({
 });
 ```
 
+Giới hạn đầu vào `replaceTableRows`: 10.000 hàng, 256 cột mỗi hàng, tối đa 50.000 ô sau khi thay thế, 1.000.000 ký tự tổng, 100.000 ký tự/1.024 paragraph mỗi ô, tối đa 20.000 paragraph và 8 tầng bảng lồng. API trả `false` nếu vượt ngưỡng và không ghi thay đổi.
+
 ### 10.2 Lấy danh sách bảng (`editor.getTables()`)
 
 ```ts
@@ -564,11 +568,19 @@ const tables = editor.getTables();
 
 ### 10.3 Cập nhật giá trị ô (`editor.setTableCellValue()`)
 
+Cập nhật nội dung một ô theo tọa độ `(row, column)`. Tự động tăng `revision`, giải phóng layout cache (`linesCache`, `tableCache`), tự động phân trang lại nếu chiều cao hàng thay đổi, và lên lịch repaint mượt mà qua `requestAnimationFrame`:
+
 ```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");
 ```
 
+::: tip Tự động Repaint & Giữ Nguyên Viewport
+- **Không cần gọi `setDocument()`**: Canvas sẽ tự động tính lại layout và repaint ngay sau khi gọi `setTableCellValue()`.
+- **Bảo toàn trạng thái**: Giữ nguyên `mode="view"`, vị trí scroll, tỷ lệ zoom và vùng chọn ô (`cellSelection`).
+- **Bảng tách nhiều trang (Multi-page Fragments)**: Nếu nội dung dài làm tăng chiều cao hàng và đẩy các hàng sang trang sau, hệ thống tự động phân trang lại và repaint tất cả các trang/fragment bị ảnh hưởng.
+:::
+
 ### 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ử:
@@ -618,9 +630,49 @@ await editor.executeHostTableAction("mergeCells", {
 await editor.executeHostTableAction("deleteTable", "tbl_invoice");
 ```
 
+### 10.6 Giải phóng Cache Layout thủ công (`editor.invalidateLayout()`)
+
+Nếu cần ép buộc làm mới cache đo đạc và vẽ lại một bảng hoặc toàn bộ tài liệu:
+
+```ts
+// Xóa cache đo đạc của bảng cụ thể và repaint
+await editor.invalidateLayout("tbl_invoice");
+
+// Hoặc làm mới toàn bộ layout cache
+await editor.invalidateLayout();
+```
+
+---
+
+## 11. Tối Ưu Hiệu Năng: Nhập Liệu Liên Tục Không Gây Giật
+
+::: warning Tuyệt đối không gọi `setDocument()` khi người dùng đang nhập Form
+Phương thức `setDocument()` thực hiện hủy và tái tạo toàn bộ DOM của Editor (`editor.destroy()` + mount lại). Nếu gọi `setDocument()` trên mỗi sự kiện `input` / `change` của form, canvas sẽ bị nhấp nháy trắng, tụt FPS và nhảy vị trí cuộn.
+
+**Hãy dùng `setTableCellValue()` kết hợp gom frame bằng `requestAnimationFrame`:**
+:::
+
+```ts
+let pendingRaf: number | null = null;
+let pendingValue = "";
+
+function onFormCellInput(newValue: string) {
+  pendingValue = newValue;
+  if (pendingRaf !== null) return;
+
+  pendingRaf = requestAnimationFrame(async () => {
+    pendingRaf = null;
+    await editor.setTableCellValue("tbl_invoice", 1, 2, pendingValue);
+  });
+}
+```
+Nhờ cơ chế này:
+- Trình duyệt chỉ cập nhật cell và repaint 1 lần mỗi khung hình (60/120 FPS).
+- Trải nghiệm nhập liệu ở Form ngoài sang Canvas đạt độ mượt mà tối đa.
+
 ---
 
-## 11. Trải Nghiệm Trang Demo Trực Quan
+## 12. 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.6",
+  "version": "3.2.8",
   "type": "module",
   "description": "Trình soạn thảo tài liệu Word chính xác, vẽ bằng canvas",
   "license": "MIT",
@@ -59,10 +59,10 @@
     "fontkit": "^2.0.4",
     "pdfkit": "^0.19.0",
     "txml": "^6.0.0",
-    "vite": "^6.0.0",
-    "vite-plugin-node-polyfills": "^0.28.0",
-    "vitest": "^3.0.0",
     "typescript": "^5.9.2",
-    "vue": "^3.5.29"
+    "vite": "^6.4.4",
+    "vite-plugin-node-polyfills": "^0.28.0",
+    "vitest": "^4.1.11",
+    "vue": "^3.5.43"
   }
-}
+}

package/types/import.d.ts

@@ -10,6 +10,13 @@ export type { Document } from "./model";
 
 export type ImportPhase = "unzip" | "styles" | "parse" | "map";
 
+export type ImportErrorCode = "NOT_ZIP" | "ENCRYPTED" | "NO_DOCUMENT_PART" | "MALFORMED_XML" | "ARCHIVE_LIMIT";
+
+/** Error raised when a DOCX is malformed, encrypted, missing its main part, or exceeds safe import limits. */
+export declare class ImportError extends Error {
+  readonly code: ImportErrorCode;
+}
+
 /** A lossy-mapping decision — surfaced, not swallowed (deduplicated by code). */
 export interface ImportWarning {
   code: string;

package/types/kindy-editor.d.ts

@@ -26,6 +26,12 @@ export interface Participant {
   user?: UserInfo;
 }
 
+/** Search and replace state. */
+export interface SearchState {
+  index: number;
+  total: number;
+}
+
 /** A WeSign signing box with laid-out geometry. `page` is 1-based for WeSign
  *  `PositionInfoRequest.page`; `pageIndex` is the 0-based layout index. */
 export interface SignatureBox {
@@ -985,6 +991,8 @@ export interface EditorHandle {
     options?: ReplaceTableRowsOptions,
   ): boolean;
   getTables(): TableSummary[];
+  /** Invalidate layout cache (for a specific table or full relayout) and repaint. */
+  invalidateLayout(blockId?: string): void;
   // ---- review layer (track changes + comments) ----------------------------
   /** The current editor mode. */
   getMode(): EditMode;
@@ -1026,6 +1034,16 @@ export interface EditorHandle {
     pageNumber: number,
     options?: { behavior?: "auto" | "smooth" },
   ): Promise<boolean>;
+  /** Find & replace. search() highlights all matches, focuses first match, and returns state. */
+  search(query: string, opts?: { matchCase?: boolean; wholeWord?: boolean }): SearchState;
+  /** Navigate between search matches (-1 for previous, 1 for next) and scroll focus to it. */
+  searchNav(dir: 1 | -1): SearchState;
+  /** Replace the currently focused match with text and scroll focus to the next match. */
+  searchReplaceCurrent(replacement: string): SearchState;
+  /** Replace all matches in one atomic transaction. */
+  searchReplaceAll(replacement: string): number;
+  /** Clear search highlights and reset search state. */
+  searchClear(): void;
   /** Live-update {{KEY}} template placeholders in the document without full reload,
    *  preserving zoom, scroll position, and selection. */
   setTemplateVariables(values: TemplateVariableValues, options?: SetTemplateVariablesOptions): void;
@@ -1157,6 +1175,8 @@ export declare class KindyEditor {
     options?: ReplaceTableRowsOptions,
   ): Promise<boolean>;
   getTables(): TableSummary[];
+  /** Invalidate layout cache (for a specific table or full relayout) and repaint. */
+  invalidateLayout(blockId?: string): Promise<void>;
   getDocId(): string | null;
   getShareLink(): string | null;
   /** Render ephemeral highlight decorations for external comments/annotations.
@@ -1218,5 +1238,15 @@ export declare class KindyEditor {
   setQRCode(config: QRCodeConfig | null): void;
   /** Get current header/footer QR code configuration. */
   getQRCode(): QRCodeConfig | undefined;
+  /** Find & replace. search() highlights all matches, focuses first match, and returns state. */
+  search(query: string, opts?: { matchCase?: boolean; wholeWord?: boolean }): Promise<SearchState>;
+  /** Navigate between search matches (-1 for previous, 1 for next) and scroll focus to it. */
+  searchNav(dir: 1 | -1): Promise<SearchState>;
+  /** Replace the currently focused match with text and scroll focus to the next match. */
+  searchReplaceCurrent(replacement: string): Promise<SearchState>;
+  /** Replace all search matches in document in a single atomic undoable transaction. */
+  searchReplaceAll(replacement: string): Promise<number>;
+  /** Clear search highlights and reset search state. */
+  searchClear(): Promise<void>;
   destroy(): void;
 }