wendang 0.1.0 → 0.2.0

package/dist/cjs/validation/schema.js

@@ -1,376 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentSchemaService = exports.SCHEMA_VERSION = exports.ALLOWED_NODES = void 0;
-const error_js_1 = require("./error.js");
-const ErrorCode = { VALIDATION_FAILED: 'validation.failed' };
-const doc_node_whitelist_js_1 = require("./doc-node-whitelist.js");
-Object.defineProperty(exports, "ALLOWED_NODES", { enumerable: true, get: function () { return doc_node_whitelist_js_1.ALLOWED_NODES; } });
-const video_embed_js_1 = require("./video-embed.js");
-const schema_version_js_1 = require("./schema-version.js");
-const mind_map_js_1 = require("./mind-map.js");
-const callout_js_1 = require("./callout.js");
-const workbook_js_1 = require("./workbook.js");
-/**
- * 文档 schema 校验与派生提取（M0 定稿，见实施计划 4.1）。
- *
- * 职责：
- * 1) 校验客户端提交的 ProseMirror JSON 是否只含白名单节点/标记 → 否则**拒绝写入**，
- *    避免旧客户端遇到未知节点的文档时覆盖成空（对齐主方案第 3 节）。
- * 2) 提取派生数据：正文引用的页面 ID（用于反向链接）、附件 ID。
- *
- * schemaVersion 升级策略：新增节点或旧客户端无法保留的持久属性时提升 SCHEMA_VERSION，并在此登记。
- * 旧版本客户端读到更高版本文档时由前端拒编辑（本服务不影响读取）。
- */
-/**
- * 正文格式版本。
- *
- * 变更记录：
- *  - 1：M0 初始版本（段落/标题/列表/引用/代码/表格/图片/页面引用/提及/公式）
- *  - 2：新增 `fileAttachment`（视频或文件卡片）与 `callout`（高亮块）
- *  - 3：新增块级格式属性 `textAlign`/`indent`（段落与标题）与行内样式标记
- *       `textStyle`（文字颜色）/`highlight`（背景高亮）；同时补上此前遗漏的
- *       `paragraph` 属性条目与表格 `colwidth`（列宽）
- *  - 4：新增分栏节点 `columns`/`column`（等宽，无属性）
- *  - 5：新增平台视频节点 `videoEmbed`
- *  - 6：新增结构化思维导图 `mindMap` / `mindMapTopic`
- *  - 7：导图描述、备注、关系节点、受限主题样式与图片引用；标题支持行内标记
- *  - 8：思维导图分支方向 side，防止旧编辑器重写时丢失左右布局
- *  - 9：高亮块图标与独立文字、边框、填充颜色
- *  - 10：独立工作簿根格式 workbook（不进入 ProseMirror）
- *
- * 提升它的意义：客户端读到**更高版本**的文档时可以选择拒编辑（而非静默丢内容），
- * 因此只要引入了新的节点类型就必须登记在此，不能只改白名单。
- */
-exports.SCHEMA_VERSION = schema_version_js_1.CONTENT_SCHEMA_VERSION;
-/** 属性白名单：只保留我们认识且安全的属性，其余剥离（防 XSS 与样式污染）。 */
-const ALLOWED_ATTRS = {
-    // 标题：级别 + 块级格式（对齐/缩进）
-    heading: new Set(['level', 'textAlign', 'indent']),
-    // 段落此前**没有条目** → 任何段落属性都会被丢弃（对齐/缩进加上来时必须补）
-    paragraph: new Set(['textAlign', 'indent']),
-    // Tiptap / Markdown 已有的标准属性；遗漏会让从 3 开始的列表保存后变回 1。
-    orderedList: new Set(['start']),
-    // 行内样式标记的颜色值（漏登记 = 颜色丢失，只剩空标记）
-    textStyle: new Set(['color']),
-    highlight: new Set(['color']),
-    // width：等比缩放的显式宽度（四角手柄）；align：图片工具条的左/中/右对齐。
-    // 两者都必须登记，否则作者调整尺寸/对齐后一经保存就被静默剥离。
-    image: new Set(['attachmentId', 'alt', 'width', 'align']),
-    fileAttachment: new Set(['attachmentId', 'filename', 'mimeType', 'size']),
-    videoEmbed: new Set(['provider', 'videoId', 'page', 'startSeconds']),
-    mindMap: new Set(['id', 'rootId', 'formatVersion', 'layout', 'theme', 'height', 'branchStyle']),
-    mindMapTopic: new Set(['id', 'parentId', 'order', 'shape', 'color', 'background', 'fontSize', 'align', 'icon', 'done', 'attachmentId', 'side']),
-    mindMapRelation: new Set(['id', 'source', 'target', 'kind', 'label']),
-    callout: new Set(['tone', 'icon', 'textColor', 'borderColor', 'backgroundColor']),
-    codeBlock: new Set(['language']),
-    link: new Set(['href', 'target', 'rel']),
-    pageLink: new Set(['pageId', 'label']),
-    mention: new Set(['userId', 'label']),
-    // colwidth：Tiptap 的列宽就是这个属性。此前未登记 → 拖动列宽保存后被
-    // 静默剥离（且当时没有任何测试覆盖属性白名单，所以长期未被发现）。
-    tableCell: new Set(['colspan', 'rowspan', 'align', 'colwidth', 'backgroundColor']),
-    tableHeader: new Set(['colspan', 'rowspan', 'align', 'colwidth', 'backgroundColor']),
-    taskItem: new Set(['checked']),
-    mathInline: new Set(['latex']),
-    mathBlock: new Set(['latex']),
-};
-/**
- * 需要强制为**正整数**的表格属性。
- *
- * ## 为什么只登记名字不够（实测的正文整篇消失）
- *
- * 白名单只保证"属性名合法"，不保证**类型**合法。历史数据里出现过
- * `colspan: "2"` / `colspan: 0` / `colwidth: "[180,0]"`：
- *
- * - 字符串 colspan 会让 `prosemirror-tables` 的 `findWidth()` 执行
- *   `rowWidth += colspan` 时发生**字符串拼接**（`0 + "1"` → `"01"`），
- *   `width` 膨胀到 1e39，`computeMap()` 的 `map[i] = 0` 抛
- *   `RangeError: Invalid array length`；
- * - `colspan: 0` 会让列宽数组长度与 colspan 不匹配；
- * - 字符串 colwidth 会在 `removeColSpan` 的 `slice().splice()` 处抛错。
- *
- * 三者都挂在 Tiptap 挂载期，表现为**正文区整体渲染失败**（用户看到"标题与目录
- * 还在、正文空白"）。因此这里在入库边界上做强类型归一：把能安全转换的转成正确
- * 类型，转换不了的**丢弃该属性**（回退 schema 默认值），而不是原样存进去。
- *
- * 前端另有读取侧兜底（`web/src/shared/table-attrs.ts`），因为历史数据已经存在，
- * 且协同路径不经过本服务的校验。
- */
-const POSITIVE_INT_ATTRS = new Set(['colspan', 'rowspan']);
-const CELL_BACKGROUND_COLORS = new Set([
-    '#f1f3f5', '#fff3bf', '#d3f9d8', '#d0ebff', '#e5dbff', '#ffe3e3',
-]);
-/** 该节点是否是表格单元格（需要强类型化数值属性）。 */
-function isTableCellType(type) {
-    return type === 'tableCell' || type === 'tableHeader';
-}
-/**
- * 把值归一为 `[1, +∞)` 的整数；不合法返回 undefined（表示丢弃该属性）。
- *
- * 不抛错而丢弃的理由：这是**净化**而非校验——粘贴来的内容常带脏属性，
- * 为此拒绝整个保存会让用户无法保存正文，代价远大于丢掉一个单元格属性。
- */
-function coercePositiveInt(raw) {
-    const n = typeof raw === 'number' ? raw : Number.parseInt(String(raw ?? ''), 10);
-    if (!Number.isFinite(n))
-        return undefined;
-    const i = Math.floor(n);
-    return i >= 1 ? i : undefined;
-}
-/**
- * 把 colwidth 归一为「正整数数组」或 null；不合法返回 undefined（丢弃）。
- *
- * 注意 0 是**合法分量**（表示"该列自适应"），长度必须与 colspan 对齐，
- * 因此这里保留 0、只把非数字分量归 0。
- */
-function coerceColwidth(raw) {
-    if (raw === null)
-        return null;
-    let list;
-    if (Array.isArray(raw)) {
-        list = raw;
-    }
-    else if (typeof raw === 'string') {
-        const text = raw.trim();
-        if (!text)
-            return null;
-        if (text.startsWith('[')) {
-            try {
-                const parsed = JSON.parse(text);
-                list = Array.isArray(parsed) ? parsed : [];
-            }
-            catch {
-                return undefined;
-            }
-        }
-        else {
-            list = text.split(',');
-        }
-    }
-    else {
-        return undefined;
-    }
-    if (list.length === 0)
-        return null;
-    const nums = list.map((v) => {
-        const n = typeof v === 'number' ? v : Number.parseInt(String(v ?? ''), 10);
-        return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
-    });
-    return nums.some((n) => n > 0) ? nums : null;
-}
-const MAX_NODES = 20000; // 防御性上限，避免超大文档拖垮服务
-const MAX_DEPTH = 100;
-class ContentSchemaService {
-    validate(raw, schemaVersion) {
-        if (!Number.isSafeInteger(schemaVersion) || schemaVersion < 1)
-            throw error_js_1.ContentValidationError.validation('内容版本必须是正整数');
-        if ((0, workbook_js_1.isWorkbookDocument)(raw)) {
-            if (schemaVersion !== 10)
-                throw error_js_1.ContentValidationError.validation('工作表需要当前编辑器版本');
-            try {
-                return { doc: (0, workbook_js_1.validateWorkbook)(raw), schemaVersion,
-                    linkTargetIds: [], attachmentIds: [], mentionUserIds: [] };
-            }
-            catch (error) {
-                throw error_js_1.ContentValidationError.validation(error instanceof Error ? error.message : '工作表格式无效');
-            }
-        }
-        if (typeof raw !== 'object' ||
-            raw === null ||
-            raw.type !== 'doc') {
-            throw error_js_1.ContentValidationError.validation('正文格式非法：根节点必须是 doc');
-        }
-        if (schemaVersion > exports.SCHEMA_VERSION) {
-            throw new error_js_1.ContentValidationError(ErrorCode.VALIDATION_FAILED, `正文版本 ${schemaVersion} 高于服务端支持的 ${exports.SCHEMA_VERSION}，请升级后再编辑`, 422);
-        }
-        const linkTargetIds = new Set();
-        const attachmentIds = new Set();
-        const mentionUserIds = new Set();
-        let nodeCount = 0;
-        const walk = (node, depth, parentType = '') => {
-            if (typeof node !== 'object' || node === null) {
-                throw error_js_1.ContentValidationError.validation('正文包含非法节点');
-            }
-            if (depth > MAX_DEPTH) {
-                throw error_js_1.ContentValidationError.validation('正文嵌套层级过深');
-            }
-            const n = node;
-            const type = n.type;
-            if ((type === 'mindMapTopic' || type === 'mindMapRelation') && parentType !== 'mindMap') {
-                throw error_js_1.ContentValidationError.validation('导图主题只能放在思维导图内');
-            }
-            if (['mindMapDescription', 'mindMapNote'].includes(String(type)) && parentType !== 'mindMapTopic')
-                throw error_js_1.ContentValidationError.validation('导图描述只能放在主题内');
-            if (type === 'mindMap') {
-                try {
-                    (0, mind_map_js_1.validateMindMap)(n);
-                }
-                catch (err) {
-                    throw error_js_1.ContentValidationError.validation(err instanceof Error ? err.message : '思维导图结构无效');
-                }
-            }
-            if (type === 'callout' && !(0, callout_js_1.validCalloutAttrs)(n.attrs ?? {}))
-                throw error_js_1.ContentValidationError.validation('高亮块属性无效');
-            if (typeof type === 'string') {
-                if (!doc_node_whitelist_js_1.ALLOWED_NODES.has(type)) {
-                    throw new error_js_1.ContentValidationError(ErrorCode.VALIDATION_FAILED, `正文包含服务端不支持的节点「${type}」，已拒绝保存以避免内容丢失`, 422, { nodeType: type, schemaVersion: exports.SCHEMA_VERSION });
-                }
-                nodeCount += 1;
-                if (nodeCount > MAX_NODES) {
-                    throw error_js_1.ContentValidationError.validation('正文节点数超出上限');
-                }
-            }
-            const out = {};
-            if (typeof type === 'string')
-                out.type = type;
-            // 属性净化：非白名单属性直接丢弃，而非报错（粘贴内容常携带脏属性）
-            if (n.attrs && typeof n.attrs === 'object') {
-                const allowed = typeof type === 'string' ? ALLOWED_ATTRS[type] : undefined;
-                const cleaned = {};
-                for (const [k, v] of Object.entries(n.attrs)) {
-                    if (!allowed || !allowed.has(k))
-                        continue;
-                    if (isTableCellType(type) && k === 'backgroundColor') {
-                        if (typeof v === 'string' && CELL_BACKGROUND_COLORS.has(v))
-                            cleaned[k] = v;
-                        continue;
-                    }
-                    if (k === 'href' && typeof v === 'string') {
-                        if (!this.isSafeHref(v))
-                            continue;
-                    }
-                    // 表格单元格的数值属性必须强类型化：字符串形态会让
-                    // prosemirror-tables 崩溃、整篇正文渲染失败（见 POSITIVE_INT_ATTRS 注释）
-                    if (isTableCellType(type) && POSITIVE_INT_ATTRS.has(k)) {
-                        const coerced = coercePositiveInt(v);
-                        if (coerced === undefined)
-                            continue;
-                        cleaned[k] = coerced;
-                        continue;
-                    }
-                    if (isTableCellType(type) && k === 'colwidth') {
-                        const coerced = coerceColwidth(v);
-                        if (coerced === undefined)
-                            continue;
-                        cleaned[k] = coerced;
-                        continue;
-                    }
-                    cleaned[k] = v;
-                }
-                if (Object.keys(cleaned).length > 0)
-                    out.attrs = cleaned;
-            }
-            if (type === 'videoEmbed') {
-                const video = (0, video_embed_js_1.normalizeVideoEmbed)(n.attrs);
-                if (!video)
-                    throw error_js_1.ContentValidationError.validation('视频属性无效，请重新插入视频');
-                out.attrs = { ...video };
-            }
-            if (typeof n.text === 'string')
-                out.text = n.text;
-            // 标记净化
-            if (Array.isArray(n.marks)) {
-                const marks = n.marks
-                    .filter((m) => typeof m.type === 'string' && doc_node_whitelist_js_1.ALLOWED_MARKS.has(m.type))
-                    .map((m) => {
-                    const mm = { type: m.type };
-                    if (m.attrs && typeof m.attrs === 'object') {
-                        const allowed = ALLOWED_ATTRS[m.type];
-                        const cleaned = {};
-                        for (const [k, v] of Object.entries(m.attrs)) {
-                            if (!allowed?.has(k))
-                                continue;
-                            // 链接标记的 href 同样必须过协议白名单。
-                            // 注意：这里曾漏检，导致正文内超链接可携带 javascript: 协议
-                            // 绕过服务端校验（由 doc-schema 单测发现）。
-                            if (k === 'href') {
-                                if (typeof v !== 'string' || !this.isSafeHref(v))
-                                    continue;
-                            }
-                            cleaned[k] = v;
-                        }
-                        if (Object.keys(cleaned).length > 0)
-                            mm.attrs = cleaned;
-                    }
-                    return mm;
-                });
-                if (marks.length > 0)
-                    out.marks = marks;
-            }
-            // 派生提取
-            if (type === 'pageLink' && n.attrs) {
-                const pid = n.attrs.pageId;
-                if (typeof pid === 'string' && pid.length > 0)
-                    linkTargetIds.add(pid);
-            }
-            if ((type === 'image' || type === 'mindMapTopic') && n.attrs) {
-                const aid = n.attrs.attachmentId;
-                if (typeof aid === 'string' && aid.length > 0) {
-                    attachmentIds.add(aid);
-                }
-            }
-            // 视频/文件卡片同样引用附件：必须一并收集，否则这些附件会被
-            // 附件引用计数与孤儿清理误判为「无人引用」而删掉。
-            if (type === 'fileAttachment' && n.attrs) {
-                const aid = n.attrs.attachmentId;
-                if (typeof aid === 'string' && aid.length > 0) {
-                    attachmentIds.add(aid);
-                }
-            }
-            // 公式源码长度上限：LaTeX 渲染复杂度可被超长输入放大
-            if ((type === 'mathInline' || type === 'mathBlock') && n.attrs) {
-                const latex = n.attrs.latex;
-                if (typeof latex === 'string' && latex.length > 5000) {
-                    throw error_js_1.ContentValidationError.validation('公式内容过长（上限 5000 字符）');
-                }
-            }
-            if (type === 'mention' && n.attrs) {
-                const uid = n.attrs.userId;
-                if (typeof uid === 'string' && uid.length > 0) {
-                    mentionUserIds.add(uid);
-                }
-            }
-            if (Array.isArray(n.content)) {
-                out.content = n.content
-                    .filter((c) => c !== null && c !== undefined)
-                    .map((c) => walk(c, depth + 1, typeof type === 'string' ? type : ''));
-            }
-            return out;
-        };
-        const doc = walk(raw, 0);
-        return {
-            doc,
-            schemaVersion: exports.SCHEMA_VERSION,
-            linkTargetIds: [...linkTargetIds],
-            attachmentIds: [...attachmentIds],
-            mentionUserIds: [...mentionUserIds],
-        };
-    }
-    /** 仅允许 http/https/mailto 与站内相对链接，阻断 javascript: 等危险协议。 */
-    isSafeHref(href) {
-        const trimmed = href.trim().toLowerCase();
-        if (trimmed.startsWith('/') || trimmed.startsWith('#'))
-            return true;
-        return (trimmed.startsWith('http://') ||
-            trimmed.startsWith('https://') ||
-            trimmed.startsWith('mailto:'));
-    }
-    /** 纯文本投影：供 M0 搜索与摘要使用（不含 HTML，避免 XSS 面）。 */
-    extractPlainText(doc) {
-        if ((0, workbook_js_1.isWorkbookDocument)(doc))
-            return (0, workbook_js_1.workbookText)(doc);
-        const buf = [];
-        const walk = (node) => {
-            if (typeof node !== 'object' || node === null)
-                return;
-            const n = node;
-            if (typeof n.text === 'string')
-                buf.push(n.text);
-            if (Array.isArray(n.content))
-                n.content.forEach(walk);
-        };
-        walk(doc);
-        return buf.join(' ').replace(/\s+/g, ' ').trim();
-    }
-}
-exports.ContentSchemaService = ContentSchemaService;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ContentSchemaService=exports.SCHEMA_VERSION=exports.ALLOWED_NODES=void 0;const t=require("./error.js"),e="validation.failed",n=require("./doc-node-whitelist.js");Object.defineProperty(exports,"ALLOWED_NODES",{enumerable:!0,get:function(){return n.ALLOWED_NODES}});const r=require("./video-embed.js"),o=require("./schema-version.js"),i=require("./mind-map.js"),a=require("./callout.js"),s=require("./workbook.js");exports.SCHEMA_VERSION=o.CONTENT_SCHEMA_VERSION;const l={heading:new Set(["level","textAlign","indent"]),paragraph:new Set(["textAlign","indent"]),orderedList:new Set(["start"]),textStyle:new Set(["color"]),highlight:new Set(["color"]),image:new Set(["attachmentId","alt","width","align"]),fileAttachment:new Set(["attachmentId","filename","mimeType","size"]),videoEmbed:new Set(["provider","videoId","page","startSeconds"]),mindMap:new Set(["id","rootId","formatVersion","layout","theme","height","branchStyle"]),mindMapTopic:new Set(["id","parentId","order","shape","color","background","fontSize","align","icon","done","attachmentId","side"]),mindMapRelation:new Set(["id","source","target","kind","label"]),callout:new Set(["tone","icon","textColor","borderColor","backgroundColor"]),codeBlock:new Set(["language"]),link:new Set(["href","target","rel"]),pageLink:new Set(["pageId","label"]),mention:new Set(["userId","label"]),tableCell:new Set(["colspan","rowspan","align","colwidth","backgroundColor"]),tableHeader:new Set(["colspan","rowspan","align","colwidth","backgroundColor"]),taskItem:new Set(["checked"]),mathInline:new Set(["latex"]),mathBlock:new Set(["latex"])},c=new Set(["colspan","rowspan"]),d=new Set(["#f1f3f5","#fff3bf","#d3f9d8","#d0ebff","#e5dbff","#ffe3e3"]);function isTableCellType(t){return"tableCell"===t||"tableHeader"===t}function coercePositiveInt(t){const e="number"==typeof t?t:Number.parseInt(String(t??""),10);if(!Number.isFinite(e))return;const n=Math.floor(e);return n>=1?n:void 0}function coerceColwidth(t){if(null===t)return null;let e;if(Array.isArray(t))e=t;else{if("string"!=typeof t)return;{const n=t.trim();if(!n)return null;if(n.startsWith("["))try{const t=JSON.parse(n);e=Array.isArray(t)?t:[]}catch{return}else e=n.split(",")}}if(0===e.length)return null;const n=e.map(t=>{const e="number"==typeof t?t:Number.parseInt(String(t??""),10);return Number.isFinite(e)&&e>0?Math.floor(e):0});return n.some(t=>t>0)?n:null}exports.ContentSchemaService=class ContentSchemaService{validate(o,f){if(!Number.isSafeInteger(f)||f<1)throw t.ContentValidationError.validation("内容版本必须是正整数");if((0,s.isWorkbookDocument)(o)){if(10!==f)throw t.ContentValidationError.validation("工作表需要当前编辑器版本");try{return{doc:(0,s.validateWorkbook)(o),schemaVersion:f,linkTargetIds:[],attachmentIds:[],mentionUserIds:[]}}catch(e){throw t.ContentValidationError.validation(e instanceof Error?e.message:"工作表格式无效")}}if("object"!=typeof o||null===o||"doc"!==o.type)throw t.ContentValidationError.validation("正文格式非法：根节点必须是 doc");if(f>exports.SCHEMA_VERSION)throw new t.ContentValidationError(e,`正文版本 ${f} 高于服务端支持的 ${exports.SCHEMA_VERSION}，请升级后再编辑`,422);const p=new Set,h=new Set,m=new Set;let u=0;const walk=(o,s,f="")=>{if("object"!=typeof o||null===o)throw t.ContentValidationError.validation("正文包含非法节点");if(s>100)throw t.ContentValidationError.validation("正文嵌套层级过深");const S=o,g=S.type;if(("mindMapTopic"===g||"mindMapRelation"===g)&&"mindMap"!==f)throw t.ContentValidationError.validation("导图主题只能放在思维导图内");if(["mindMapDescription","mindMapNote"].includes(String(g))&&"mindMapTopic"!==f)throw t.ContentValidationError.validation("导图描述只能放在主题内");if("mindMap"===g)try{(0,i.validateMindMap)(S)}catch(e){throw t.ContentValidationError.validation(e instanceof Error?e.message:"思维导图结构无效")}if("callout"===g&&!(0,a.validCalloutAttrs)(S.attrs??{}))throw t.ContentValidationError.validation("高亮块属性无效");if("string"==typeof g){if(!n.ALLOWED_NODES.has(g))throw new t.ContentValidationError(e,`正文包含服务端不支持的节点「${g}」，已拒绝保存以避免内容丢失`,422,{nodeType:g,schemaVersion:exports.SCHEMA_VERSION});if(u+=1,u>2e4)throw t.ContentValidationError.validation("正文节点数超出上限")}const y={};if("string"==typeof g&&(y.type=g),S.attrs&&"object"==typeof S.attrs){const t="string"==typeof g?l[g]:void 0,e={};for(const[n,r]of Object.entries(S.attrs))if(t&&t.has(n))if(isTableCellType(g)&&"backgroundColor"===n)"string"==typeof r&&d.has(r)&&(e[n]=r);else if("href"!==n||"string"!=typeof r||this.isSafeHref(r)){if(isTableCellType(g)&&c.has(n)){const t=coercePositiveInt(r);if(void 0===t)continue;e[n]=t;continue}if(isTableCellType(g)&&"colwidth"===n){const t=coerceColwidth(r);if(void 0===t)continue;e[n]=t;continue}e[n]=r}Object.keys(e).length>0&&(y.attrs=e)}if("videoEmbed"===g){const e=(0,r.normalizeVideoEmbed)(S.attrs);if(!e)throw t.ContentValidationError.validation("视频属性无效，请重新插入视频");y.attrs={...e}}if("string"==typeof S.text&&(y.text=S.text),Array.isArray(S.marks)){const t=S.marks.filter(t=>"string"==typeof t.type&&n.ALLOWED_MARKS.has(t.type)).map(t=>{const e={type:t.type};if(t.attrs&&"object"==typeof t.attrs){const n=l[t.type],r={};for(const[e,o]of Object.entries(t.attrs))n?.has(e)&&("href"!==e||"string"==typeof o&&this.isSafeHref(o))&&(r[e]=o);Object.keys(r).length>0&&(e.attrs=r)}return e});t.length>0&&(y.marks=t)}if("pageLink"===g&&S.attrs){const t=S.attrs.pageId;"string"==typeof t&&t.length>0&&p.add(t)}if(("image"===g||"mindMapTopic"===g)&&S.attrs){const t=S.attrs.attachmentId;"string"==typeof t&&t.length>0&&h.add(t)}if("fileAttachment"===g&&S.attrs){const t=S.attrs.attachmentId;"string"==typeof t&&t.length>0&&h.add(t)}if(("mathInline"===g||"mathBlock"===g)&&S.attrs){const e=S.attrs.latex;if("string"==typeof e&&e.length>5e3)throw t.ContentValidationError.validation("公式内容过长（上限 5000 字符）")}if("mention"===g&&S.attrs){const t=S.attrs.userId;"string"==typeof t&&t.length>0&&m.add(t)}return Array.isArray(S.content)&&(y.content=S.content.filter(t=>null!=t).map(t=>walk(t,s+1,"string"==typeof g?g:""))),y};return{doc:walk(o,0),schemaVersion:exports.SCHEMA_VERSION,linkTargetIds:[...p],attachmentIds:[...h],mentionUserIds:[...m]}}isSafeHref(t){const e=t.trim().toLowerCase();return!(!e.startsWith("/")&&!e.startsWith("#"))||e.startsWith("http://")||e.startsWith("https://")||e.startsWith("mailto:")}extractPlainText(t){if((0,s.isWorkbookDocument)(t))return(0,s.workbookText)(t);const e=[],walk=t=>{if("object"!=typeof t||null===t)return;const n=t;"string"==typeof n.text&&e.push(n.text),Array.isArray(n.content)&&n.content.forEach(walk)};return walk(t),e.join(" ").replace(/\s+/g," ").trim()}};

package/dist/cjs/validation/video-embed.js

@@ -1,17 +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("../shared/video-embed.js"), exports);
+"use strict";var e=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var o=Object.getOwnPropertyDescriptor(t,r);o&&!("get"in o?!t.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,o)}:function(e,t,r,i){void 0===i&&(i=r),e[i]=t[r]}),t=this&&this.__exportStar||function(t,r){for(var i in t)"default"===i||Object.prototype.hasOwnProperty.call(r,i)||e(r,t,i)};Object.defineProperty(exports,"__esModule",{value:!0}),t(require("../shared/video-embed.js"),exports);

package/dist/cjs/validation/workbook.js

@@ -1,17 +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("../shared/workbook.js"), exports);
+"use strict";var e=this&&this.__createBinding||(Object.create?function(e,t,r,o){void 0===o&&(o=r);var i=Object.getOwnPropertyDescriptor(t,r);i&&!("get"in i?!t.__esModule:i.writable||i.configurable)||(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,o,i)}:function(e,t,r,o){void 0===o&&(o=r),e[o]=t[r]}),t=this&&this.__exportStar||function(t,r){for(var o in t)"default"===o||Object.prototype.hasOwnProperty.call(r,o)||e(r,t,o)};Object.defineProperty(exports,"__esModule",{value:!0}),t(require("../shared/workbook.js"),exports);

package/dist/esm/document.js

@@ -1,3 +1 @@
-export * from './schema.js';
-export * from './shared/node-catalog.js';
-export * from './shared/doc-text.js';
+export*from"./schema.js";export*from"./shared/node-catalog.js";export*from"./shared/doc-text.js";export*from"./shared/headings.js";

package/dist/esm/index.js

@@ -1,3 +1 @@
-export * from './schema.js';
-export { emptyWorkbook, validateWorkbook } from './spreadsheet.js';
-export { createMindMap, readMindMap, mindMapToJson } from './mindmap.js';
+export*from"./schema.js";export{emptyWorkbook,validateWorkbook}from"./spreadsheet.js";export{createMindMap,readMindMap,mindMapToJson}from"./mindmap.js";

package/dist/esm/mindmap.js

@@ -1,4 +1 @@
-export * from './shared/mind-map.js';
-export * from './shared/mind-map-phase2.js';
-export * from './shared/mind-map-folding.js';
-export { validateMindMap } from './validation/mind-map.js';
+export*from"./shared/mind-map.js";export*from"./shared/mind-map-phase2.js";export*from"./shared/mind-map-folding.js";export{validateMindMap}from"./validation/mind-map.js";

package/dist/esm/schema.js

@@ -1,3 +1 @@
-export { ContentSchemaService, SCHEMA_VERSION } from './validation/schema.js';
-export { ContentValidationError } from './validation/error.js';
-export { ALLOWED_NODES, ALLOWED_MARKS } from './validation/doc-node-whitelist.js';
+export{ContentSchemaService,SCHEMA_VERSION}from"./validation/schema.js";export{ContentValidationError}from"./validation/error.js";export{ALLOWED_NODES,ALLOWED_MARKS}from"./validation/doc-node-whitelist.js";

package/dist/esm/shared/anchor.js

@@ -1,192 +1 @@
-/**
- * 行内评论的锚点定位（纯函数，可单测）。
- *
- * ## 为什么不能存位置
- *
- * 直觉做法是「记录选中文字的 start/end 偏移」。但文档会被编辑：
- * 在选区前面插入一个字，所有后续位置全部偏移——锚点立刻指向错误文字，
- * 而且**错得很安静**（评论跑到别的地方，没人会立刻发现）。
- *
- * ## 采用方案：文本引用（TextQuoteSelector 思路，W3C Web Annotation）
- *
- * 存三样东西：
- *  - `quote`：选中的原文
- *  - `prefix` / `suffix`：前后各一小段上下文（用于区分重复文本）
- *
- * 定位时在文档纯文本里搜索 quote；有多处命中时，用 prefix/suffix 的匹配长度打分，
- * 取最匹配的一处。这样：
- *  - 在文档**别处**编辑（不碰该段文字）→ 锚点依然准确定位；
- *  - 该段文字本身被改动 → 匹配不到，此时用 prefix+suffix 的接缝尽力定位，
- *    返回一个「降级」结果（exact=false），前端据此提示「原文已改动」；
- *  - 完全找不到（整段被删）→ 返回 null，前端把评论归入「已失联」，
- *    **而不是指向一处无关文字**。
- *
- * 宁可显示「已失联」，也不要指向错误位置——后者会让用户读到与上下文无关的评论，
- * 比看得见的缺失更有害。
- */
-/** 上下文最大长度（与提交时截断长度一致）。 */
-export const ANCHOR_CONTEXT_LENGTH = 64;
-export const ANCHOR_QUOTE_MAX = 500;
-/**
- * 把若干块文本拼成扁平文本，记录片段边界。
- * 块之间插入换行（可用块间匹配不应跨越块边界，换行同时避免把块首块尾误连成词）。
- */
-export 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 };
-}
-/** 由扁平字符偏移定位到 (块索引, 块内偏移)。 */
-export 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 表示无法可信定位（整段被删），调用方应标记为「已失联」。
- */
-export 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;
-}
-/** 两个字符串从末尾开始相同的字符数。 */
-export 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;
-}
-/** 两个字符串从头开始相同的字符数。 */
-export function commonPrefixLength(a, b) {
-    let n = 0;
-    while (n < a.length && n < b.length && a[n] === b[n]) {
-        n += 1;
-    }
-    return n;
-}
-/** 截断上下文到限定长度（提交时使用）。 */
-export function clipContext(text) {
-    return text.slice(0, ANCHOR_CONTEXT_LENGTH);
-}
+export const ANCHOR_CONTEXT_LENGTH=64;export const ANCHOR_QUOTE_MAX=500;export 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}}export 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}export 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,c=[];let s=t.indexOf(n);for(;-1!==s;)c.push(s),s=t.indexOf(n,s+1);if(c.length>0){let e=null;for(const s of c){const c=scoreCandidate(t,s,n.length,o,r,l);(!e||c>e.score)&&(e={start:s,score:c})}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}function scoreCandidate(t,e,n,o,r,l){let c=1e3;return o.length>0&&(c+=4*commonSuffixLength(t.slice(Math.max(0,e-o.length),e),o)),r.length>0&&(c+=4*commonPrefixLength(t.slice(e+n,e+n+r.length),r)),l>=0&&(c-=Math.min(Math.abs(e-l),200)),c}export 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}export function commonPrefixLength(t,e){let n=0;for(;n<t.length&&n<e.length&&t[n]===e[n];)n+=1;return n}export function clipContext(t){return t.slice(0,64)}