wendang 0.1.0 → 0.2.0

package/LICENSE

@@ -1,3 +1,44 @@
-UNLICENSED
+Wendang 商业使用许可 1.0
 
-No license to use, copy, modify or distribute the Wendang source is granted by this file. Contact the maintainer for terms. Third-party components retain their own licenses; see NOTICE.md.
+Copyright (c) 2026 ztes. All rights reserved.
+
+本许可适用于 Wendang 项目及 wendang、wendang-vue 包中由 ztes 拥有版权的代码。
+使用、复制或分发本软件即表示接受以下条款。
+
+1. 允许的使用
+   在遵守本许可的前提下，授予您非独占、全球、免许可费的权利：
+   a. 将本软件用于个人、内部或商业用途，包括收费产品、客户项目及 SaaS 服务；
+   b. 为开发、集成、测试、维护和运行您的应用而复制本软件，并修改源码；
+   c. 将原版或修改后的编译代码作为您的应用组成部分交付给客户或最终用户，
+      包括网站、浏览器应用、桌面应用、移动应用及服务端部署；
+   d. 向受保密义务约束的雇员、承包商或客户提供维护上述应用所需的源码，
+      前提是这些接收者只能为该应用使用源码并遵守本许可。
+   您无需公开应用源码，也无需向 ztes 支付商业使用许可费。
+
+2. 限制及保留的权利
+   本许可未授予您将本软件或其修改版作为独立库、SDK、编辑器组件包或源码
+   产品进行公开再发布、再许可、改名发布、出售或出租的权利。
+   上述限制不妨碍您销售或运营包含本软件的应用，也不妨碍按第 1 条交付应用。
+   超出本许可范围的独立分发或源码再许可，须另获 ztes 书面授权。
+   不得移除本软件中的版权、许可及第三方权利声明。本许可不授予商标权；
+   其他未明确授予的权利由各权利人保留。
+
+3. 声明的保留
+   分发包含本软件的应用时，应在随附许可文件、第三方声明或应用关于页面中
+   保留本许可及版权声明。无需在应用主界面展示品牌或链接。
+
+4. 第三方组件
+   第三方组件及其版权声明继续适用各自许可证，见 NOTICE.md 和
+   third-party-notices/。本许可不限制第三方许可证已经授予的权利。
+
+5. 终止
+   如违反本许可且未在收到书面通知后 30 日内纠正，本许可授予的权利终止。
+   终止不影响终止前已产生的义务及权利人的救济权。
+
+6. 免责声明与责任限制
+   在适用法律允许的最大范围内，本软件按“现状”提供，不附带任何明示或
+   默示担保，包括适销性、特定用途适用性及不侵权担保。对于使用或无法使用
+   本软件产生的损害、数据丢失、利润损失或其他责任，作者及权利人不承担责任。
+
+这是保留源码权利的商业使用许可，不是开源许可证。
+授权联系：https://doc.yjmf.com

package/NOTICE.md

@@ -1,7 +1,7 @@
 # Third-party notices
 
 Generated from the installed runtime dependency graph; package licenses remain unchanged.
-Wendang itself remains UNLICENSED. This inventory is not a grant of rights or a statement that optional Pro services are included.
+Wendang is licensed under the Wendang Commercial Use License; see LICENSE. Third-party components retain their own licenses.
 
 | Package | Version | Declared license | Included upstream notice |
 | --- | --- | --- | --- |

package/README.md

@@ -1,104 +1,172 @@
 # wendang
 
-文档、电子表格、思维导图的内容协议与校验核心。适用于前端数据层和 Node 服务端，不包含可视编辑器。当前源码 0.1.0 为开发版，npm 0.0.1 仅为占位。
+文档、电子表格和思维导图的内容协议与校验核心，适用于浏览器数据层和 Node.js 服务端。
 
-源码位于 [ztes/wendang 的 packages/core](https://gitee.com/ztes/wendang/tree/main/packages/core)。本项目单仓双包维护，开发、问题和版本规范见 [仓库 README](https://gitee.com/ztes/wendang/blob/main/README.md)。
+[主页](https://doc.yjmf.com) · [Vue 编辑组件](https://www.npmjs.com/package/wendang-vue)
 
-## 安装与使用
-
-对应版本正式发布后：
+## 安装
 
 ```sh
 npm install wendang
 ```
 
+支持 Node.js >=20.19、ESM、CommonJS 和 TypeScript。无运行时依赖，不初始化 DOM，也不发起网络请求。
+
+## 文档校验
+
 ```ts
 import { ContentSchemaService, SCHEMA_VERSION } from 'wendang/schema'
-import { emptyWorkbook, validateWorkbook } from 'wendang/spreadsheet'
-import { createMindMap, readMindMap, mindMapToJson } from 'wendang/mindmap'
-import type { ProseMirrorDoc, WorkbookDocument } from 'wendang/types'
+import type { ProseMirrorDoc } from 'wendang/types'
 
-const result = new ContentSchemaService().validate({
+const doc: ProseMirrorDoc = {
   type: 'doc',
-  content: [{ type: 'paragraph', content: [{ type: 'text', text: '你好' }] }],
-}, SCHEMA_VERSION)
+  content: [{
+    type: 'paragraph',
+    content: [{ type: 'text', text: '你好，Wendang' }],
+  }],
+}
 
-const book = validateWorkbook(emptyWorkbook(crypto.randomUUID()))
-const map = readMindMap(createMindMap('both'))
+const result = new ContentSchemaService().validate(doc, SCHEMA_VERSION)
+console.log(result.doc)
+console.log(result.attachmentIds)
+console.log(result.linkTargetIds)
+console.log(result.mentionUserIds)
 ```
 
-支持 Node >=20.19、ESM 和 CommonJS：
+CommonJS：
 
 ```js
 const { ContentSchemaService, SCHEMA_VERSION } = require('wendang/schema')
+
 const result = new ContentSchemaService().validate(
   { type: 'doc', content: [{ type: 'paragraph' }] },
   SCHEMA_VERSION,
 )
 ```
 
-同步校验不发网络请求，不初始化框架、登录、数据库或 DOM。布局默认使用确定的保守度量，Vue 层按需注入浏览器字体度量；核心不执行 Excel 公式。
-
-## API 入口
+`validate(raw, schemaVersion)` 返回以下字段：
 
-| 入口 | 内容 |
+| 字段 | 含义 |
 | --- | --- |
-| `wendang` | schema、版本、主要类型、创建工作簿 / 导图 |
-| `wendang/schema` | `ContentSchemaService`、`ContentValidationError`、`SCHEMA_VERSION`、节点 / mark 白名单 |
-| `wendang/document` | 文档类型、节点目录、文本工具和 schema |
-| `wendang/spreadsheet` | 工作簿类型、`emptyWorkbook`、`validateWorkbook`、`workbookText` |
-| `wendang/mindmap` | 创建 / 解析 / 序列化、布局、分支、搜索及校验 |
-| `wendang/types` | 内容、工作簿、导图和讨论类型 |
+| `doc` | 校验并按白名单处理后的内容 |
+| `schemaVersion` | 内容 schema 版本 |
+| `attachmentIds` | 附件 ID 列表 |
+| `linkTargetIds` | 被引用页面的 ID 列表 |
+| `mentionUserIds` | 被提及用户的 ID 列表 |
 
-`internal/*` / `validation/*` 仅为现有应用迁移兼容入口，三方新增代码优先使用上表入口，不依赖 dist 深层文件。
+未知节点、非法值和不支持的更高版本会被拒绝。`schemaVersion` 必须为正整数；普通文档当前版本为 `10`。
 
-## 文档校验与服务端规范
+### 处理校验错误
 
-`new ContentSchemaService().validate(raw, schemaVersion)` 返回：
-
-- `doc`、`schemaVersion`：按支持规则校验 / 处理后的内容；
-- `attachmentIds`、`linkTargetIds`、`mentionUserIds`：供业务授权、引用、通知使用。
-
-失败抛 `ContentValidationError`，包含 `message`、`code`（`validation.failed`）、`status`（422）、可选 `details`；宿主自行转为框架异常。schemaVersion 必须为正整数。未知节点拒绝，普通脏属性按白名单处理，未知更高版本拒绝写入。
+```ts
+import {
+  ContentSchemaService,
+  ContentValidationError,
+  SCHEMA_VERSION,
+} from 'wendang/schema'
+
+try {
+  new ContentSchemaService().validate({ type: 'unknown' }, SCHEMA_VERSION)
+} catch (error) {
+  if (error instanceof ContentValidationError) {
+    console.error(error.code, error.message, error.details)
+  } else {
+    throw error
+  }
+}
+```
 
-**校验不等于授权。** 后端仍需检查写入权限、附件归属、引用可见性和审批发布；前端检查不替代后端。当前普通文档 schemaVersion 为 **10**，不是 npm 包版本。
+`ContentValidationError` 包含 `code`、`message`、`status` 和可选 `details`。普通校验错误的 `code` 为 `validation.failed`，`status` 为 `422`；可由应用映射成 HTTP 响应。
 
-当前协议的页面、用户、附件引用使用 UUID。宿主若使用数字或其他业务主键，应建立稳定映射；不要把存储 URL 或临时 token 当作 ID。
+内容校验不执行授权。服务端仍需检查写入权限、附件归属和引用资源可见性。页面、用户、附件引用使用 UUID；其他业务主键需建立稳定映射。
 
-## 工作簿规范
+## 电子表格
 
 ```ts
+import {
+  emptyWorkbook,
+  validateWorkbook,
+  workbookText,
+} from 'wendang/spreadsheet'
+
 const doc = emptyWorkbook(crypto.randomUUID())
+doc.workbook.name = '销售统计'
 doc.workbook.sheets.sheet1.cellData = {
   0: {
-    0: { v: 12, t: 2 },
-    1: { f: '=A1*2', v: 24, t: 2 },
+    0: { v: '金额', t: 1 },
+    1: { v: 12, t: 2 },
+    2: { f: '=B1*2', v: 24, t: 2 },
   },
 }
+
 const snapshot = validateWorkbook(doc)
+const searchableText = workbookText(snapshot)
 ```
 
-根为 `{ type: 'workbook', formatVersion: 1, workbook: ... }`。`f` 为表达式，`v` 为数值或保存的公式缓存。最多 20 Sheet、每表 10000 行 / 200 列、实际单元格总数 50000、JSON 4MiB。验证拒绝危险属性、非法值、越界、重叠合并，并返回独立快照。
+工作簿结构为 `{ type: 'workbook', formatVersion: 1, workbook: ... }`：
 
-workbook 含 Univer 1.1.0 兼容数据与资源，是已版本化的引擎适配格式；不承诺任意引擎大版本无损兼容。XLSX 转换在 `wendang-vue/spreadsheet/xlsx`，本包不引入 ExcelJS。
+- `f` 保存公式表达式，`v` 保存值或公式计算缓存。
+- `validateWorkbook` 返回独立快照，检查越界、危险属性、非法值和重叠合并。
+- 核心包保存和校验公式，不执行公式计算。可视编辑和 XLSX 转换使用 `wendang-vue`。
+- 工作簿采用与 Univer 1.1.0 兼容的数据结构；升级引擎大版本时需检查格式兼容。
 
-## 思维导图规范
+| 限制 | 上限 |
+| --- | --- |
+| Sheet 数 | 20 |
+| 每表行数 / 列数 | 10000 / 200 |
+| 实际单元格总数 | 50000 |
+| JSON 大小 | 4 MiB |
 
-`createMindMap(layout)` 创建持久化 `MindMapJson`，`readMindMap(json)` 返回 `MindMapModel | null`，`mindMapToJson(model)` 序列化。当前 formatVersion 为 **3**，支持读取已有受支持旧版。
+## 思维导图
 
-主题和关系线使用稳定 ID；主题包含 parentId、order、文字及可选富文本、描述、备注、附件与样式。单图最多 500 主题，标题 2000 字符。视口、选区、折叠属于视图状态。复制分支重建身份，不能直接沿用旧讨论锚点。
+```ts
+import {
+  createMindMap,
+  readMindMap,
+  mindMapToJson,
+} from 'wendang/mindmap'
+
+const json = createMindMap('both')
+const model = readMindMap(json)
+
+if (model) {
+  model.topics[0].text = '项目计划'
+  const snapshot = mindMapToJson(model)
+  console.log(snapshot)
+}
+```
+
+| API | 用途 |
+| --- | --- |
+| `createMindMap(layout?)` | 创建可持久化的 `MindMapJson` |
+| `readMindMap(json)` | 解析为 `MindMapModel`，无效内容返回 `null` |
+| `mindMapToJson(model)` | 将模型序列化为 JSON |
+
+导图当前 `formatVersion` 为 `3`，支持受支持旧版的读取。主题和关系线拥有稳定 ID，支持主题文字、富文本、描述、备注、附件及样式；单图最多 500 个主题，单主题标题最多 2000 字符。
+
+持久化 JSON 数据；视口和选区属于展示状态。复制分支应重新生成身份，避免讨论锚点指向旧主题。
+
+## 导入入口
+
+| 入口 | 内容 |
+| --- | --- |
+| `wendang` | 校验、版本、主要类型、工作簿和导图创建函数 |
+| `wendang/schema` | 校验服务、异常类型、内容版本和节点白名单 |
+| `wendang/document` | 文档类型、节点目录、文本工具和校验 |
+| `wendang/spreadsheet` | 工作簿类型、创建、校验和文本提取 |
+| `wendang/mindmap` | 导图模型、解析、序列化、布局、分支和搜索 |
+| `wendang/types` | 文档、工作簿、导图及讨论类型 |
 
-## 升级与扩展
+应用应通过以上入口导入，不引用 `dist` 内部文件。
 
-1. SDK semver、文档 schemaVersion、工作簿 / 导图 formatVersion 分开管理。
-2. 关闭新增按钮不能剥离已有内容；不支持的更高版本提示升级或只读保留。
-3. 不把 HTML、截图或绘图坐标当作唯一源数据。
-4. 核心不自动迁移宿主数据库；迁移必须有明确操作、样本和回退，失败保留原文。
-5. 自定义节点必须同步编辑、阅读、校验和导出，不仅放宽前端 JSON。
-6. ESM / CommonJS 通过实际 tarball 消费验证，禁止靠源码路径掩盖缺失导出。
+## 数据与升级规范
 
-## 开发与发布
+- npm 包版本、文档 `schemaVersion` 与工作簿 / 导图 `formatVersion` 分别管理。
+- 保存时同时保存内容和对应格式版本；加载更高版本失败时保留原始数据。
+- HTML、截图及渲染坐标不能替代 JSON 源数据。
+- 自定义节点需同时支持编辑、阅读、校验和导出；只增加前端节点不会自动放宽后端校验。
+- 数据库升级和历史数据迁移由应用控制。
 
-在仓库根运行 `pnpm build`、`pnpm test`、`pnpm typecheck`、`pnpm pack:all`、`pnpm check:package`。只发布 dist、文档及许可文件。完整本地 link 和发布流程见仓库 README。
+## License
 
-当前许可 `UNLICENSED`；维护者另行决定自身授权，不改变第三方依赖授权边界。
+采用随包附带的 [Wendang 商业使用许可](LICENSE)：允许免费商业使用、应用集成修改和随应用分发运行代码，无需公开应用源码。独立 SDK 或源码产品的再发布、再许可及出售需书面授权。

package/dist/cjs/document.js

@@ -1,19 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./schema.js"), exports);
-__exportStar(require("./shared/node-catalog.js"), exports);
-__exportStar(require("./shared/doc-text.js"), exports);
+"use strict";var e=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&!("get"in i?!r.__esModule:i.writable||i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){void 0===o&&(o=t),e[o]=r[t]}),r=this&&this.__exportStar||function(r,t){for(var o in r)"default"===o||Object.prototype.hasOwnProperty.call(t,o)||e(t,r,o)};Object.defineProperty(exports,"__esModule",{value:!0}),r(require("./schema.js"),exports),r(require("./shared/node-catalog.js"),exports),r(require("./shared/doc-text.js"),exports),r(require("./shared/headings.js"),exports);

package/dist/cjs/index.js

@@ -1,25 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mindMapToJson = exports.readMindMap = exports.createMindMap = exports.validateWorkbook = exports.emptyWorkbook = void 0;
-__exportStar(require("./schema.js"), exports);
-var spreadsheet_js_1 = require("./spreadsheet.js");
-Object.defineProperty(exports, "emptyWorkbook", { enumerable: true, get: function () { return spreadsheet_js_1.emptyWorkbook; } });
-Object.defineProperty(exports, "validateWorkbook", { enumerable: true, get: function () { return spreadsheet_js_1.validateWorkbook; } });
-var mindmap_js_1 = require("./mindmap.js");
-Object.defineProperty(exports, "createMindMap", { enumerable: true, get: function () { return mindmap_js_1.createMindMap; } });
-Object.defineProperty(exports, "readMindMap", { enumerable: true, get: function () { return mindmap_js_1.readMindMap; } });
-Object.defineProperty(exports, "mindMapToJson", { enumerable: true, get: function () { return mindmap_js_1.mindMapToJson; } });
+"use strict";var e=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var n=Object.getOwnPropertyDescriptor(r,t);n&&!("get"in n?!r.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,n)}:function(e,r,t,o){void 0===o&&(o=t),e[o]=r[t]}),r=this&&this.__exportStar||function(r,t){for(var o in r)"default"===o||Object.prototype.hasOwnProperty.call(t,o)||e(t,r,o)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.mindMapToJson=exports.readMindMap=exports.createMindMap=exports.validateWorkbook=exports.emptyWorkbook=void 0,r(require("./schema.js"),exports);var t=require("./spreadsheet.js");Object.defineProperty(exports,"emptyWorkbook",{enumerable:!0,get:function(){return t.emptyWorkbook}}),Object.defineProperty(exports,"validateWorkbook",{enumerable:!0,get:function(){return t.validateWorkbook}});var o=require("./mindmap.js");Object.defineProperty(exports,"createMindMap",{enumerable:!0,get:function(){return o.createMindMap}}),Object.defineProperty(exports,"readMindMap",{enumerable:!0,get:function(){return o.readMindMap}}),Object.defineProperty(exports,"mindMapToJson",{enumerable:!0,get:function(){return o.mindMapToJson}});

package/dist/cjs/mindmap.js

@@ -1,22 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateMindMap = void 0;
-__exportStar(require("./shared/mind-map.js"), exports);
-__exportStar(require("./shared/mind-map-phase2.js"), exports);
-__exportStar(require("./shared/mind-map-folding.js"), exports);
-var mind_map_js_1 = require("./validation/mind-map.js");
-Object.defineProperty(exports, "validateMindMap", { enumerable: true, get: function () { return mind_map_js_1.validateMindMap; } });
+"use strict";var e=this&&this.__createBinding||(Object.create?function(e,r,t,i){void 0===i&&(i=t);var a=Object.getOwnPropertyDescriptor(r,t);a&&!("get"in a?!r.__esModule:a.writable||a.configurable)||(a={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,i,a)}:function(e,r,t,i){void 0===i&&(i=t),e[i]=r[t]}),r=this&&this.__exportStar||function(r,t){for(var i in r)"default"===i||Object.prototype.hasOwnProperty.call(t,i)||e(t,r,i)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.validateMindMap=void 0,r(require("./shared/mind-map.js"),exports),r(require("./shared/mind-map-phase2.js"),exports),r(require("./shared/mind-map-folding.js"),exports);var t=require("./validation/mind-map.js");Object.defineProperty(exports,"validateMindMap",{enumerable:!0,get:function(){return t.validateMindMap}});

package/dist/cjs/schema.js

@@ -1,11 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALLOWED_MARKS = exports.ALLOWED_NODES = exports.ContentValidationError = exports.SCHEMA_VERSION = exports.ContentSchemaService = void 0;
-var schema_js_1 = require("./validation/schema.js");
-Object.defineProperty(exports, "ContentSchemaService", { enumerable: true, get: function () { return schema_js_1.ContentSchemaService; } });
-Object.defineProperty(exports, "SCHEMA_VERSION", { enumerable: true, get: function () { return schema_js_1.SCHEMA_VERSION; } });
-var error_js_1 = require("./validation/error.js");
-Object.defineProperty(exports, "ContentValidationError", { enumerable: true, get: function () { return error_js_1.ContentValidationError; } });
-var doc_node_whitelist_js_1 = require("./validation/doc-node-whitelist.js");
-Object.defineProperty(exports, "ALLOWED_NODES", { enumerable: true, get: function () { return doc_node_whitelist_js_1.ALLOWED_NODES; } });
-Object.defineProperty(exports, "ALLOWED_MARKS", { enumerable: true, get: function () { return doc_node_whitelist_js_1.ALLOWED_MARKS; } });
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ALLOWED_MARKS=exports.ALLOWED_NODES=exports.ContentValidationError=exports.SCHEMA_VERSION=exports.ContentSchemaService=void 0;var e=require("./validation/schema.js");Object.defineProperty(exports,"ContentSchemaService",{enumerable:!0,get:function(){return e.ContentSchemaService}}),Object.defineProperty(exports,"SCHEMA_VERSION",{enumerable:!0,get:function(){return e.SCHEMA_VERSION}});var r=require("./validation/error.js");Object.defineProperty(exports,"ContentValidationError",{enumerable:!0,get:function(){return r.ContentValidationError}});var t=require("./validation/doc-node-whitelist.js");Object.defineProperty(exports,"ALLOWED_NODES",{enumerable:!0,get:function(){return t.ALLOWED_NODES}}),Object.defineProperty(exports,"ALLOWED_MARKS",{enumerable:!0,get:function(){return t.ALLOWED_MARKS}});

package/dist/cjs/shared/anchor.js

@@ -1,201 +1 @@
-"use strict";
-/**
- * 行内评论的锚点定位（纯函数，可单测）。
- *
- * ## 为什么不能存位置
- *
- * 直觉做法是「记录选中文字的 start/end 偏移」。但文档会被编辑：
- * 在选区前面插入一个字，所有后续位置全部偏移——锚点立刻指向错误文字，
- * 而且**错得很安静**（评论跑到别的地方，没人会立刻发现）。
- *
- * ## 采用方案：文本引用（TextQuoteSelector 思路，W3C Web Annotation）
- *
- * 存三样东西：
- *  - `quote`：选中的原文
- *  - `prefix` / `suffix`：前后各一小段上下文（用于区分重复文本）
- *
- * 定位时在文档纯文本里搜索 quote；有多处命中时，用 prefix/suffix 的匹配长度打分，
- * 取最匹配的一处。这样：
- *  - 在文档**别处**编辑（不碰该段文字）→ 锚点依然准确定位；
- *  - 该段文字本身被改动 → 匹配不到，此时用 prefix+suffix 的接缝尽力定位，
- *    返回一个「降级」结果（exact=false），前端据此提示「原文已改动」；
- *  - 完全找不到（整段被删）→ 返回 null，前端把评论归入「已失联」，
- *    **而不是指向一处无关文字**。
- *
- * 宁可显示「已失联」，也不要指向错误位置——后者会让用户读到与上下文无关的评论，
- * 比看得见的缺失更有害。
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ANCHOR_QUOTE_MAX = exports.ANCHOR_CONTEXT_LENGTH = void 0;
-exports.flattenDocText = flattenDocText;
-exports.locateBlock = locateBlock;
-exports.resolveAnchor = resolveAnchor;
-exports.commonSuffixLength = commonSuffixLength;
-exports.commonPrefixLength = commonPrefixLength;
-exports.clipContext = clipContext;
-/** 上下文最大长度（与提交时截断长度一致）。 */
-exports.ANCHOR_CONTEXT_LENGTH = 64;
-exports.ANCHOR_QUOTE_MAX = 500;
-/**
- * 把若干块文本拼成扁平文本，记录片段边界。
- * 块之间插入换行（可用块间匹配不应跨越块边界，换行同时避免把块首块尾误连成词）。
- */
-function flattenDocText(blocks) {
-    const segments = [];
-    let text = '';
-    blocks.forEach((blockText, blockIndex) => {
-        if (blockIndex > 0)
-            text += '\n';
-        segments.push({ start: text.length, blockIndex, length: blockText.length });
-        text += blockText;
-    });
-    return { text, segments };
-}
-/** 由扁平字符偏移定位到 (块索引, 块内偏移)。 */
-function locateBlock(flat, charOffset) {
-    for (const seg of flat.segments) {
-        if (charOffset >= seg.start && charOffset <= seg.start + seg.length) {
-            return { blockIndex: seg.blockIndex, offsetInBlock: charOffset - seg.start };
-        }
-    }
-    // 落在块间换行或末尾时，归到最后一个片段
-    const last = flat.segments[flat.segments.length - 1];
-    if (!last)
-        return null;
-    if (charOffset > last.start + last.length) {
-        return { blockIndex: last.blockIndex, offsetInBlock: last.length };
-    }
-    return null;
-}
-/**
- * 定位锚点。返回 null 表示无法可信定位（整段被删），调用方应标记为「已失联」。
- */
-function resolveAnchor(text, anchor) {
-    const quote = (anchor.quote ?? '').trim();
-    if (quote.length === 0)
-        return null;
-    const prefix = anchor.prefix ?? '';
-    const suffix = anchor.suffix ?? '';
-    const expectedStart = anchor.start ?? -1;
-    // 1) 收集 quote 的全部出现位置
-    const candidates = [];
-    let idx = text.indexOf(quote);
-    while (idx !== -1) {
-        candidates.push(idx);
-        // 从下一个字符继续，避免重叠匹配导致死循环
-        idx = text.indexOf(quote, idx + 1);
-    }
-    if (candidates.length > 0) {
-        let best = null;
-        for (const start of candidates) {
-            const score = scoreCandidate(text, start, quote.length, prefix, suffix, expectedStart);
-            if (!best || score > best.score)
-                best = { start, score };
-        }
-        if (best) {
-            return {
-                from: best.start,
-                to: best.start + quote.length,
-                score: best.score,
-                exact: true,
-            };
-        }
-    }
-    // 2) quote 已不在文档中：用上下文降级定位，返回零长度锚点。
-    //    两种情况：
-    //    a) quote 整段被删除 → prefix 与 suffix 在文档中相邻，用接缝精确落点；
-    //    b) quote 被改写但上下文还在 → 用较长的一侧贴住，落在其边缘。
-    //    两者都标记 exact=false，前端据此提示「原文已改动」。
-    // 2a) prefix 与 suffix 相邻（说明中间的原引用被删掉了）
-    if (prefix.length > 0 && suffix.length > 0) {
-        const needle = prefix + suffix;
-        const at = text.indexOf(needle);
-        if (at !== -1) {
-            const pos = at + prefix.length;
-            return { from: pos, to: pos, score: 50, exact: false };
-        }
-    }
-    // 2b) 用较长的一侧贴住边缘。
-    //     注意两点（都是实测教训）：
-    //     - 阈值取 4 而非 8：中文一个词常只有 2–4 字，阈值过高会让中文文档
-    //       几乎无法降级定位；
-    //     - 必须遍历**全部**出现位置并取最接近原偏移的那个：
-    //       短上下文在文档中可能重复，取首个出现会落到错误位置。
-    const side = prefix.length >= suffix.length ? prefix : suffix;
-    if (side.length >= 4) {
-        const at = nearestOccurrence(text, side, expectedStart);
-        if (at !== -1) {
-            const pos = prefix.length >= suffix.length ? at + side.length : at;
-            return { from: pos, to: pos, score: 10, exact: false };
-        }
-    }
-    return null;
-}
-/**
- * 在文本中找出 needle 的全部出现位置，返回最接近 expected 的那个。
- * expected < 0（无提示）时退化为返回第一个出现位置。
- * 这样短上下文重复时不会盲目落到首次出现处。
- */
-function nearestOccurrence(text, needle, expected) {
-    if (needle.length === 0)
-        return -1;
-    const positions = [];
-    let idx = text.indexOf(needle);
-    while (idx !== -1) {
-        positions.push(idx);
-        if (positions.length > 500)
-            break; // 防御：极端重复文本
-        idx = text.indexOf(needle, idx + 1);
-    }
-    if (positions.length === 0)
-        return -1;
-    if (expected < 0)
-        return positions[0];
-    let best = positions[0];
-    for (const p of positions) {
-        if (Math.abs(p - expected) < Math.abs(best - expected))
-            best = p;
-    }
-    return best;
-}
-/**
- * 给候选位置打分：
- *  - 引用本身匹配是基础分；
- *  - 前后文匹配越长越可信（能区分「同一句话在文档里出现多次」）；
- *  - 与提交时偏移越近，略微加分（仅在文本重复且上下文缺失时起作用）。
- */
-function scoreCandidate(text, start, quoteLength, prefix, suffix, expectedStart) {
-    let score = 1000;
-    if (prefix.length > 0) {
-        const actualPrefix = text.slice(Math.max(0, start - prefix.length), start);
-        score += commonSuffixLength(actualPrefix, prefix) * 4;
-    }
-    if (suffix.length > 0) {
-        const actualSuffix = text.slice(start + quoteLength, start + quoteLength + suffix.length);
-        score += commonPrefixLength(actualSuffix, suffix) * 4;
-    }
-    if (expectedStart >= 0) {
-        score -= Math.min(Math.abs(start - expectedStart), 200);
-    }
-    return score;
-}
-/** 两个字符串从末尾开始相同的字符数。 */
-function commonSuffixLength(a, b) {
-    let n = 0;
-    while (n < a.length && n < b.length && a[a.length - 1 - n] === b[b.length - 1 - n]) {
-        n += 1;
-    }
-    return n;
-}
-/** 两个字符串从头开始相同的字符数。 */
-function commonPrefixLength(a, b) {
-    let n = 0;
-    while (n < a.length && n < b.length && a[n] === b[n]) {
-        n += 1;
-    }
-    return n;
-}
-/** 截断上下文到限定长度（提交时使用）。 */
-function clipContext(text) {
-    return text.slice(0, exports.ANCHOR_CONTEXT_LENGTH);
-}
+"use strict";function scoreCandidate(t,e,n,o,r,l){let s=1e3;return o.length>0&&(s+=4*commonSuffixLength(t.slice(Math.max(0,e-o.length),e),o)),r.length>0&&(s+=4*commonPrefixLength(t.slice(e+n,e+n+r.length),r)),l>=0&&(s-=Math.min(Math.abs(e-l),200)),s}function commonSuffixLength(t,e){let n=0;for(;n<t.length&&n<e.length&&t[t.length-1-n]===e[e.length-1-n];)n+=1;return n}function commonPrefixLength(t,e){let n=0;for(;n<t.length&&n<e.length&&t[n]===e[n];)n+=1;return n}Object.defineProperty(exports,"__esModule",{value:!0}),exports.ANCHOR_QUOTE_MAX=exports.ANCHOR_CONTEXT_LENGTH=void 0,exports.flattenDocText=function flattenDocText(t){const e=[];let n="";return t.forEach((t,o)=>{o>0&&(n+="\n"),e.push({start:n.length,blockIndex:o,length:t.length}),n+=t}),{text:n,segments:e}},exports.locateBlock=function locateBlock(t,e){for(const n of t.segments)if(e>=n.start&&e<=n.start+n.length)return{blockIndex:n.blockIndex,offsetInBlock:e-n.start};const n=t.segments[t.segments.length-1];return n&&e>n.start+n.length?{blockIndex:n.blockIndex,offsetInBlock:n.length}:null},exports.resolveAnchor=function resolveAnchor(t,e){const n=(e.quote??"").trim();if(0===n.length)return null;const o=e.prefix??"",r=e.suffix??"",l=e.start??-1,s=[];let c=t.indexOf(n);for(;-1!==c;)s.push(c),c=t.indexOf(n,c+1);if(s.length>0){let e=null;for(const c of s){const s=scoreCandidate(t,c,n.length,o,r,l);(!e||s>e.score)&&(e={start:c,score:s})}if(e)return{from:e.start,to:e.start+n.length,score:e.score,exact:!0}}if(o.length>0&&r.length>0){const e=o+r,n=t.indexOf(e);if(-1!==n){const t=n+o.length;return{from:t,to:t,score:50,exact:!1}}}const f=o.length>=r.length?o:r;if(f.length>=4){const e=function nearestOccurrence(t,e,n){if(0===e.length)return-1;const o=[];let r=t.indexOf(e);for(;-1!==r&&(o.push(r),!(o.length>500));)r=t.indexOf(e,r+1);if(0===o.length)return-1;if(n<0)return o[0];let l=o[0];for(const t of o)Math.abs(t-n)<Math.abs(l-n)&&(l=t);return l}(t,f,l);if(-1!==e){const t=o.length>=r.length?e+f.length:e;return{from:t,to:t,score:10,exact:!1}}}return null},exports.commonSuffixLength=commonSuffixLength,exports.commonPrefixLength=commonPrefixLength,exports.clipContext=function clipContext(t){return t.slice(0,exports.ANCHOR_CONTEXT_LENGTH)},exports.ANCHOR_CONTEXT_LENGTH=64,exports.ANCHOR_QUOTE_MAX=500;