wendang 0.1.0 → 0.2.0

package/dist/types/shared/callout.d.ts

@@ -1,8 +1,46 @@
-/** Document attributes only; shared with server validation by a source parity test. */
 export declare const CALLOUT_TONES: readonly ["info", "success", "warning", "danger"];
 export declare const CALLOUT_ICONS: readonly ["💡", "ℹ️", "✅", "⚠️", "❗", "📌", "🎯", "💬", "📖", "📝", "🚀", "🔔", "🔎", "⭐", "🌅", "🛠️", "📅", "🔒", "❤️", "🎉", "❓", "📎", "🏁", "🔥"];
 export declare const CALLOUT_COLORS: readonly ["gray", "red", "orange", "yellow", "green", "blue", "purple"];
 export declare const CALLOUT_FILLS: readonly ["gray", "red", "orange", "yellow", "green", "blue", "purple", ...string[]];
+export declare const CALLOUT_SWATCH_FALLBACKS: {
+    readonly textColor: {
+        readonly gray: "#646a73";
+        readonly red: "#d92c2c";
+        readonly orange: "#b95d0b";
+        readonly yellow: "#8a6c0a";
+        readonly green: "#237b35";
+        readonly blue: "#1971c2";
+        readonly purple: "#7048e8";
+    };
+    readonly borderColor: {
+        readonly gray: "#c7cbd1";
+        readonly red: "#f0a2a2";
+        readonly orange: "#ffc078";
+        readonly yellow: "#e3ca71";
+        readonly green: "#91d4a0";
+        readonly blue: "#9ac5ef";
+        readonly purple: "#c0a4ed";
+    };
+    readonly backgroundColor: {
+        readonly gray: "#f1f3f5";
+        readonly red: "#ffe3e3";
+        readonly orange: "#fff0db";
+        readonly yellow: "#fff3bf";
+        readonly green: "#d3f9d8";
+        readonly blue: "#d0ebff";
+        readonly purple: "#e5dbff";
+        readonly 'gray-strong': "#ced4da";
+        readonly 'red-strong': "#ffc9c9";
+        readonly 'orange-strong': "#ffd8a8";
+        readonly 'yellow-strong': "#ffec99";
+        readonly 'green-strong': "#b2f2bb";
+        readonly 'blue-strong': "#a5d8ff";
+        readonly 'purple-strong': "#d0bfff";
+    };
+};
+export type CalloutSwatchKey = keyof typeof CALLOUT_SWATCH_FALLBACKS;
+export declare function calloutColorToken(key: CalloutSwatchKey, value: string): string;
+export declare function calloutSwatchStyle(key: CalloutSwatchKey, value: string | null): Record<string, string>;
 export interface CalloutAttrs {
     tone?: string | null;
     icon?: string | null;
@@ -19,7 +57,6 @@ export declare function effectiveCallout(attrs?: CalloutAttrs): {
     backgroundColor: string;
 };
 export declare function calloutDOMAttributes(attrs?: CalloutAttrs): Record<string, string>;
-/** Optional Markdown metadata never contains free CSS or HTML. */
 export declare function calloutMetadata(attrs: CalloutAttrs): string;
 export declare function readCalloutMetadata(text: string): {
     attrs: CalloutAttrs;

package/dist/types/shared/code-block.d.ts

@@ -1,4 +1,3 @@
-/** Presentation metadata only; code, whitespace and the document schema remain unchanged. */
 export declare const CODE_THEMES: readonly [{
     readonly value: "auto";
     readonly label: "跟随页面";

package/dist/types/shared/code-languages.d.ts

@@ -1,26 +1,7 @@
-/**
- * 代码块语言目录（**纯数据，无编辑器依赖**）。
- *
- * 为什么放 shared：编辑端（语言选择器）与只读端（语言标签）都要用；
- * 若放在 editor/ 下，只读端 import 它就会把编辑器模块拉进阅读路径，
- * 违反读写分离（与 doc-schema-version.ts 的取舍同理）。
- *
- * `value` 即写入正文 `codeBlock.language` 的值，也是 Markdown 围栏的语言标记
- * （```` ```js ````），因此导出/导入可无损往返（服务端序列化器与解析器均已支持）。
- * `label` 仅供界面展示。
- */
 export interface CodeLanguage {
     value: string;
     label: string;
 }
-/** 空字符串表示「纯文本 / 不指定」。 */
 export declare const CODE_LANGUAGES: CodeLanguage[];
-/**
- * 取语言的展示标签。
- *
- * 未知语言（如用户从 Markdown 导入的少见围栏标记）直接显示原值——
- * 不隐藏、不改写，避免"我明明标了语言却看不到"。
- */
 export declare function codeLanguageLabel(value: string | null | undefined): string;
-/** 是否为目录内已知语言（用于选择器回显：未知值时追加一个临时选项）。 */
 export declare function isKnownCodeLanguage(value: string): boolean;

package/dist/types/shared/doc-text.d.ts

@@ -1,21 +1,7 @@
-/**
- * 从 ProseMirror 文档提取用于锚点定位的块级纯文本。
- *
- * 与 anchor.ts 配合：锚点用「在扁平文本中的字符偏移」表达，
- * 这里负责把文档结构摊平，并保留「块 → 字符区间」的映射，
- * 以便把定位结果映射回具体的块（前端据此在对应块上加高亮）。
- *
- * 与后端 DocSchemaService.extractPlainText 保持一致的遍历顺序（先文本、后子节点），
- * 否则同一段内容在提交锚点与解析锚点时会得到不同的字符偏移。
- */
 import type { ProseMirrorNode } from './types.js';
 export interface BlockText {
-    /** 块在文档顶层 content 中的索引 */
     index: number;
-    /** 该块的纯文本 */
     text: string;
 }
-/** 提取顶层块（含嵌套块）的纯文本。列表会递归取出每一项。 */
 export declare function extractBlockTexts(doc: ProseMirrorNode | null | undefined): BlockText[];
-/** 取节点的全部文本（含后代）。 */
 export declare function plainTextOf(node: ProseMirrorNode): string;

package/dist/types/shared/document-colors.d.ts

@@ -1,7 +1,3 @@
-/**
- * 文档文字与高亮的受限调色板。存储值保持原始 hex，显示色通过主题变量切换；
- * 阅读路径复用此模块，不引入 Tiptap。历史色值均保留，复制时 data-color 可往返。
- */
 export declare const TEXT_COLORS: readonly [{
     readonly name: "默认";
     readonly value: null;

package/dist/types/shared/headings.d.ts

@@ -0,0 +1,7 @@
+import type { ProseMirrorNode } from './types.js';
+export interface DocumentHeading {
+    level: number;
+    text: string;
+    order: number;
+}
+export declare function extractHeadings(doc: ProseMirrorNode | null | undefined): DocumentHeading[];

package/dist/types/shared/inline-comments.d.ts

@@ -1,71 +1,29 @@
 import type { CommentItem, ProseMirrorNode } from './types.js';
-/**
- * 把行内评论锚点解析为**文本节点内的字符区间**，供渲染器加高亮。
- *
- * ## 为什么不用「块索引」
- *
- * 直觉做法是记录「第几个段落 + 段内偏移」。但文档结构是嵌套的
- * （列表套列表、引用里含段落、表格单元格…），"第几块"这种扁平索引
- * 很难与渲染器的实际遍历对应，映射错一位高亮就会错位。
- *
- * ## 采用方案：文本节点序号 + 节点内偏移
- *
- * 把文档里所有**文本节点**按深度优先顺序编号（第 0 个、第 1 个…），
- * 锚点记录「第几个文本节点 + 节点内起止」。
- *
- * 关键在于：锚点解析与渲染器**使用完全相同的遍历顺序**
- * （都是深度优先、先文本后子节点），因此序号天然一致，不需要维护额外映射。
- * 这个顺序与后端 `DocSchemaService.extractPlainText` 也保持一致。
- *
- * ## 三种状态必须区分显示
- *  - `exact`：原文仍在，正常高亮；
- *  - `shifted`：原文被改动，仅靠上下文降级定位，零宽落点并提示；
- *  - 失联：无法定位，**不给正文加高亮**，只在评论区列出。
- *    宁可显示「有评论已失联」，也不要把评论挂到无关文字上。
- */
 export type InlineMarkState = 'exact' | 'shifted';
 export interface InlineMark {
     commentId: string;
-    /** 文本节点序号（深度优先顺序，从 0 开始） */
     textIndex: number;
-    /** 该文本节点内的字符区间（含头不含尾）；shifted 时 from === to */
     from: number;
     to: number;
     state: InlineMarkState;
-    /** 该评论是否有回复（供高亮配色区分） */
     hasReplies: boolean;
 }
 export interface ResolvedInlineComments {
     marks: InlineMark[];
-    /** 无法定位的评论（内容已被删除或改动过大） */
     orphanCommentIds: string[];
-    /** 按文本节点序号分组，渲染时 O(1) 查询 */
     byTextIndex: Map<number, InlineMark[]>;
 }
-/**
- * 把文档摊平为「每个文本节点一段」，并给出每段在扁平文本中的偏移。
- *
- * **遍历顺序必须与 DocRenderer 一致**（深度优先、先 text 后 content），
- * 否则文本节点序号会错位。二者的一致性由测试覆盖。
- */
 export interface TextRun {
-    /** 文本节点序号 */
     index: number;
     text: string;
-    /** 在扁平文本中的起始偏移 */
     flatStart: number;
-    /** 在扁平文本中的结束偏移（不含） */
     flatEnd: number;
 }
 export declare function buildTextRuns(doc: ProseMirrorNode | null | undefined): TextRun[];
-/** 文档的扁平文本（与 buildTextRuns 的偏移体系一致）。 */
 export declare function buildFlatText(doc: ProseMirrorNode | null | undefined): string;
-/** 仅有锚点的评论才参与定位（页级评论不属于行内）。 */
 export declare function resolveInlineComments(doc: ProseMirrorNode | null | undefined, comments: CommentItem[]): ResolvedInlineComments;
-/** 响应式封装。 */
 export interface TextPiece {
     text: string;
-    /** 覆盖该片段的标记（可能多个：不同评论指向重叠文字） */
     marks: InlineMark[];
 }
 export declare function splitTextByMarks(text: string, marks: InlineMark[]): TextPiece[];

package/dist/types/shared/mind-map-folding.d.ts

@@ -1,5 +1,3 @@
 import { type MindMapModel } from './mind-map.js';
-/** Root/leaf/stale entries have no local fold affordance and must not hide a whole map. */
 export declare function normalizeMindFolds(model: MindMapModel, ids: Iterable<string>): Set<string>;
-/** Keep every first-level branch visible, collapsing only those with descendants. */
 export declare function firstLevelMindFolds(model: MindMapModel): Set<string>;

package/dist/types/shared/mind-map.d.ts

@@ -1,4 +1,3 @@
-/** Engine-independent document format. Topic text remains ordinary ProseMirror text. */
 export declare const MIND_MAP_VERSION = 3;
 export declare const MIND_MAP_MAX_TOPICS = 500;
 export declare const MIND_MAP_MAX_TEXT = 2000;
@@ -98,13 +97,10 @@ export interface MindMapDrawing {
 export declare const mindMapId: () => `${string}-${string}-${string}-${string}-${string}`;
 export declare function createMindMap(layout?: MindMapLayout): MindMapJson;
 export declare function readMindMap(node: MindMapJson | null | undefined): MindMapModel | null;
-/** Missing parents and concurrent cycles keep every surviving topic, deterministically. */
 export declare function mindMapTree(model: MindMapModel): MindTopic[];
 export declare function mindMapDescendants(model: MindMapModel, id: string): Set<string>;
 export declare function canMoveMindTopic(model: MindMapModel, id: string, parentId: string): boolean;
-/** Only first-level topics own a side; all descendants inherit their branch direction. */
 export declare function mindMapBranchSides(model: MindMapModel): Map<string, -1 | 1>;
-/** Shared by the live drop preview and the single document transaction on release. */
 export declare function projectMindSideMove(model: MindMapModel, id: string, side: -1 | 1, beforeId?: string): MindMapModel | null;
 export declare function textDifference(before: string, after: string): {
     from: number;

package/dist/types/shared/mind-topic-text.d.ts

@@ -5,9 +5,7 @@ export declare const MIND_TOPIC_FONT = "-apple-system, BlinkMacSystemFont, \"Seg
 export type MindTextMeasure = (text: string) => number;
 declare let factory: ((fontSize: number, weight: number) => MindTextMeasure | null) | undefined;
 export declare function setMindTextMeasureFactory(value: typeof factory): void;
-/** Real browser font metrics; non-DOM exports/tests keep a conservative text-only fallback. */
 export declare function mindTextMeasure(fontSize?: number, weight?: number): MindTextMeasure;
-/** Keep explicit empty lines and emoji clusters; presentation wrapping never edits the source. */
 export declare function wrapMindText(text: string, width: number, measure: MindTextMeasure): string[];
 export declare function mindTopicTextSize(text: string, fontSize?: number, root?: boolean, description?: string, bold?: boolean, minimumWidth?: number): {
     width: number;

package/dist/types/shared/node-catalog.d.ts

@@ -1,30 +1,13 @@
-/**
- * 节点目录：编辑器的 nodeView 与只读渲染规则**共用的单一真源**
- * （对齐《Wiki好用技术方案》1.1）。
- *
- * 这里只放纯数据（无 Vue、无 Tiptap 依赖），因此阅读端可以只引它 + Renderer，
- * 而完全不加载编辑器代码；编辑器端再基于同一份目录生成扩展。
- *
- * 新增节点时必须同时更新：
- *  1) 本目录  2) 服务端 doc-schema.service.ts 白名单  3) 提升 schema 版本
- * 否则旧客户端会因「遇到不支持节点」而被服务端拒写（这是预期行为，避免静默丢内容）。
- */
 export type NodeKind = 'block' | 'inline' | 'text' | 'atom';
 export interface NodeSpecMeta {
     type: string;
     kind: NodeKind;
-    /** 能否出现在只读正文的顶层容器 */
     topLevel?: boolean;
-    /** 是否为原子节点（无 content，如分隔线、图片） */
     atom?: boolean;
-    /** 供 UI 展示与 slash 菜单使用 */
     label: string;
-    /** 是否仅编辑态可用（如占位） */
     editorOnly?: boolean;
 }
 export declare const NODE_CATALOG: NodeSpecMeta[];
 export declare function nodeMeta(type: string | undefined): NodeSpecMeta | undefined;
-/** 只读渲染遇到未知节点时使用的降级提示（不静默丢弃，向用户明示）。 */
 export declare const UNKNOWN_NODE_LABEL = "\u6B64\u5185\u5BB9\u7531\u66F4\u9AD8\u7248\u672C\u7684\u7F16\u8F91\u5668\u521B\u5EFA\uFF0C\u5F53\u524D\u7248\u672C\u65E0\u6CD5\u663E\u793A";
-/** 标题级别 → HTML 标签 */
 export declare function headingTag(level: unknown): string;

package/dist/types/shared/presence.d.ts

@@ -1,69 +1,18 @@
-/**
- * 协同在线状态（presence）的纯逻辑（可单测，不依赖 DOM / Yjs / 网络）。
- *
- * ## 为什么单独抽出来
- *
- * 在线状态有两个容易做错、且出错后**不报错、只是显示不对**的地方：
- *  1) 颜色分配：同一用户在不同客户端必须得到**相同颜色**（否则"那个蓝色光标是谁"
- *     无法对应），而颜色若只按"连接顺序"分，B 客户端上同一个人的颜色就会变。
- *     因此颜色必须由**用户身份**稳定推导，不能依赖顺序或随机。
- *  2) 对比度：名字气泡上的文字要与背景色对比可读；简单地对 6 个色相取固定亮度，
- *     在浅色模式下会有几个色相偏亮、白字看不清。
- * 这些都能用纯函数锁定，因此放在这里。
- */
-/** 在线用户条目（用于头像/名字展示）。 */
 export interface PresenceUser {
     userId: string;
     displayName: string;
-    /** 稳定的身份色（hex） */
     color: string;
 }
-/**
- * 稳定的用户色板。
- *
- * 选取标准不是"好看"，而是**所有颜色配白字都达到 WCAG AA（≥4.5:1）**——
- * 这样光标/名字气泡永远是"彩色底 + 白字"，视觉一致，也不会出现浅底白字看不清。
- * （初版用了偏亮的绿 `#1a9d5a`（3.49:1）与橙 `#d97706`（3.19:1），配白字或深字
- * 都不到 AA；这里换成更深的一档，由单测锁定对比度。）
- */
 export declare const PRESENCE_PALETTE: readonly ["#2f6feb", "#127a45", "#b45309", "#c026d3", "#dc2626", "#0e7490", "#7c3aed", "#9a4a08"];
-/**
- * 由用户 id 稳定映射到调色板颜色。
- *
- * 用 FNV-1a 哈希而非 simple sum：简单的字符求和会让 `user1`/`user2`
- * 这类相邻 id 落到同一颜色，而实际用户 id 常是顺序生成的。
- */
 export declare function colorForUser(userId: string): string;
-/** FNV-1a 32 位哈希 → 取模。 */
 export declare function hashIndex(input: string, buckets: number): number;
-/** 名字首字（用于头像占位）。中文取首字，英文取首字母大写。 */
 export declare function initialOf(displayName: string): string;
-/**
- * 汇总在线用户：去重（同一用户多标签页只显示一次）、排除自己、稳定排序。
- *
- * 稳定性很重要：若按 Map 遍历顺序输出，光标/头像列表会随消息到达顺序抖动。
- * 这里按 displayName 排序，保证界面上顺序稳定。
- */
 export declare function collectPresence(states: Array<{
     userId: string;
     displayName: string;
 }>, selfUserId: string | null): PresenceUser[];
-/**
- * 相对亮度（WCAG），用于决定光标/气泡上该用白字还是深字。
- * 返回 0（黑）~1（白）。
- */
 export declare function relativeLuminance(hex: string): number;
-/** 前景深色的基准（与 :root 的 --color-text 接近）。 */
 export declare const DARK_TEXT = "#1f2937";
-/** WCAG 对比度。 */
 export declare function contrastRatio(a: string, b: string): number;
-/**
- * 该背景色上应使用的前景色。
- *
- * 实现为「比较白字与深字各自的对比度，取更高的那个」，而不是用一个亮度阈值判断——
- * 阈值是脆弱的：初版用 0.179 作分界，`#2f6feb`（亮度 0.180）被判为用深字，
- * 但实际白字对比度 4.57 优于深字 3.21，选错了。（由单测发现。）
- */
 export declare function readableTextColor(hex: string): '#ffffff' | typeof DARK_TEXT;
-/** 解析 #rgb / #rrggbb；非法返回 null。 */
 export declare function parseHex(hex: string): [number, number, number] | null;

package/dist/types/shared/safe-href.d.ts

@@ -1,3 +1,2 @@
 export declare function isSafeHref(raw: unknown): boolean;
-/** 渲染用：安全则原样返回，否则返回 '#'。 */
 export declare function safeHref(raw: unknown): string;

package/dist/types/shared/table-cell-format.d.ts

@@ -1,4 +1,3 @@
-/** 固定单元格底色，不接受任意 CSS；读写端共用，服务端同步白名单。 */
 export declare const CELL_BACKGROUNDS: readonly [{
     readonly name: "默认";
     readonly value: null;

package/dist/types/shared/table-layout.d.ts

@@ -1,7 +1,4 @@
 import type { ProseMirrorNode } from './types.js';
-/** 自动列宽保留可读空间；窄屏在表格内部滚动，不把长文本压成单字列。 */
 export declare const TABLE_CELL_MIN_WIDTH = 120;
-/** 首行合并单元格的 colwidth 数组包含多个视觉列，必须逐列展开。 */
 export declare function tableColumnWidths(table: ProseMirrorNode): number[];
-/** 未设置宽度的列与编辑器 cellMinWidth 共用同一默认值；保留历史显式列宽。 */
 export declare function tableMinWidth(widths: number[]): number | undefined;

package/dist/types/shared/types.d.ts

@@ -17,7 +17,6 @@ export interface CommentAnchor {
     prefix: string | null;
     suffix: string | null;
     start: number | null;
-    /** 锚点创建时的已发布版本号 */
     seq: number | null;
 }
 export interface CommentItem {
@@ -25,18 +24,15 @@ export interface CommentItem {
     pageId: string;
     parentId: string | null;
     body: string;
-    /** 行内评论的锚点；页级评论为 null */
     anchor?: CommentAnchor | null;
     authorId: string | null;
     authorName: string;
     deleted: boolean;
     canDelete: boolean;
     canEdit?: boolean;
-    /** 讨论是否已解决（仅顶层评论有意义） */
     resolved: boolean;
     resolvedByName: string | null;
     resolvedAt: string | null;
-    /** 当前用户是否可标记/取消解决 */
     canResolve: boolean;
     createdAt: string;
     updatedAt: string;

package/dist/types/shared/video-embed.d.ts

@@ -1,11 +1,18 @@
-/** 纯数据协议；服务端同名文件必须保持一致，由契约测试检查。 */
+export type VideoProvider = 'youtube' | 'bilibili' | 'vimeo' | 'youku' | 'tencent' | 'acfun';
 export interface VideoEmbedData {
-    provider: 'youtube' | 'bilibili';
+    provider: VideoProvider;
     videoId: string;
     page: number;
     startSeconds: number;
 }
+export declare const VIDEO_PROVIDER_LABELS: Record<VideoProvider, string>;
 export declare function normalizeVideoEmbed(raw: unknown): VideoEmbedData | null;
+export type VideoUrlIssue = 'empty' | 'invalid' | 'unsupported' | 'short-link' | 'missing-id';
+export interface VideoUrlInspection {
+    data: VideoEmbedData | null;
+    issue: VideoUrlIssue | null;
+}
+export declare function inspectVideoUrl(value: string): VideoUrlInspection;
 export declare function parseVideoUrl(value: string): VideoEmbedData | null;
 export declare function videoSourceUrl(data: VideoEmbedData): string;
 export declare function videoPlayerUrl(data: VideoEmbedData): string;

package/dist/types/shared/workbook.d.ts

@@ -1,4 +1,3 @@
-/** Neutral workbook wire format. Keep in sync with web/src/shared/workbook.ts. */
 export interface WorkbookCell {
     v?: string | number | boolean | null;
     f?: string;
@@ -50,7 +49,6 @@ export declare const WORKBOOK_LIMITS: {
 };
 export declare function isWorkbookDocument(value: unknown): value is WorkbookDocument;
 export declare function emptyWorkbook(id: string): WorkbookDocument;
-/** Validate the complete snapshot without silently dropping supported engine attributes. */
 export declare function validateWorkbook(raw: unknown): WorkbookDocument;
 export declare function workbookCellText(cell: WorkbookCell | null | undefined): string;
 export declare function workbookText(doc: WorkbookDocument): string;

package/dist/types/validation/doc-node-whitelist.d.ts

@@ -1,21 +1,2 @@
-/**
- * 文档节点白名单（**纯数据，无依赖**）。
- *
- * 为什么单独成文件：白名单需要被三处引用——
- *  1) 服务端校验（doc-schema.service.ts）
- *  2) 一致性测试（与前端 node-catalog 交叉核对）
- *  3) 导出序列化器的防漂移测试
- * 若把它放在 doc-schema.service.ts 里，测试导入会连带加载 Nest 依赖，
- * 导致 spec 在测试环境下加载失败（实测：整个测试文件被静默跳过）。
- *
- * 因此这里只放数据，不放逻辑，任何一方都能安全引用。
- *
- * 新增节点时必须同时更新：
- *  1) 本文件
- *  2) 前端 web/src/shared/node-catalog.ts
- *  3) 导出序列化器 markdown-serializer.ts 的处理分支
- * 三处一致性由测试自动核对（读取真实文件，而非维护测试内副本）。
- */
 export declare const ALLOWED_NODES: Set<string>;
-/** 允许的标记类型。 */
 export declare const ALLOWED_MARKS: Set<string>;

package/dist/types/validation/mind-map.d.ts

@@ -1,4 +1,3 @@
-/** Kept independent of Nest and of the editing engine: usable by validation and export. */
 interface JsonNode {
     type?: string;
     attrs?: Record<string, unknown>;
@@ -15,7 +14,6 @@ interface Topic {
     attachmentId?: string;
 }
 export declare function validateMindMap(node: JsonNode): void;
-/** Same deterministic tree projection as the reader; orphan/cycle conflicts never discard text. */
 export declare function mindMapOutline(node: JsonNode): Array<Topic & {
     depth: number;
 }>;

package/dist/types/validation/schema-version.d.ts

@@ -1,2 +1 @@
-/** 协同握手与正文写入共用，不依赖 Nest 服务。 */
 export declare const CONTENT_SCHEMA_VERSION = 10;

package/dist/types/validation/schema.d.ts

@@ -1,49 +1,15 @@
 import { ALLOWED_NODES } from './doc-node-whitelist.js';
 export { ALLOWED_NODES };
-/**
- * 文档 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）
- *
- * 提升它的意义：客户端读到**更高版本**的文档时可以选择拒编辑（而非静默丢内容），
- * 因此只要引入了新的节点类型就必须登记在此，不能只改白名单。
- */
 export declare const SCHEMA_VERSION = 10;
 export interface ValidatedDoc {
     doc: Record<string, unknown>;
     schemaVersion: number;
     linkTargetIds: string[];
     attachmentIds: string[];
-    /** 正文中 @ 提及的用户 ID（去重），用于通知扇出 */
     mentionUserIds: string[];
 }
 export declare class ContentSchemaService {
     validate(raw: unknown, schemaVersion: number): ValidatedDoc;
-    /** 仅允许 http/https/mailto 与站内相对链接，阻断 javascript: 等危险协议。 */
     private isSafeHref;
-    /** 纯文本投影：供 M0 搜索与摘要使用（不含 HTML，避免 XSS 面）。 */
     extractPlainText(doc: unknown): string;
 }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "wendang",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "文档、工作表和思维导图的内容协议与校验核心。",
   "type": "module",
-  "license": "UNLICENSED",
+  "license": "SEE LICENSE IN LICENSE",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
@@ -74,6 +74,11 @@
   "engines": {
     "node": ">=20.19"
   },
+  "scripts": {
+    "build": "node ../../scripts/build-core.mjs",
+    "dev": "node ../../scripts/build-core.mjs --watch",
+    "typecheck": "tsc --noEmit"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -84,13 +89,8 @@
     "url": "git+https://gitee.com/ztes/wendang.git",
     "directory": "packages/core"
   },
-  "homepage": "https://gitee.com/ztes/wendang",
+  "homepage": "https://doc.yjmf.com",
   "bugs": {
     "url": "https://gitee.com/ztes/wendang/issues"
-  },
-  "scripts": {
-    "build": "node ../../scripts/build-core.mjs",
-    "dev": "node ../../scripts/build-core.mjs --watch",
-    "typecheck": "tsc --noEmit"
   }
-}
+}