wendang 0.0.1 → 0.1.0

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

@@ -0,0 +1,26 @@
+/** Presentation metadata only; code, whitespace and the document schema remain unchanged. */
+export declare const CODE_THEMES: readonly [{
+    readonly value: "auto";
+    readonly label: "跟随页面";
+}, {
+    readonly value: "paper";
+    readonly label: "纸白";
+}, {
+    readonly value: "soft";
+    readonly label: "柔和";
+}, {
+    readonly value: "night";
+    readonly label: "深色";
+}];
+export type CodeTheme = typeof CODE_THEMES[number]['value'];
+export interface CodeBlockDisplay {
+    collapsed: boolean;
+    lineNumbers: boolean;
+    limited: boolean;
+    theme: CodeTheme;
+}
+export declare function codeBlockDisplay(): CodeBlockDisplay;
+export declare function rememberCodeTheme(_theme: CodeTheme): void;
+export declare function codeLineCount(text: string): number;
+export declare function codeLineNumbers(text: string): string;
+export declare function codeBlockClass(display: CodeBlockDisplay): string[];

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

@@ -0,0 +1,26 @@
+/**
+ * 代码块语言目录（**纯数据，无编辑器依赖**）。
+ *
+ * 为什么放 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-compatibility.d.ts

@@ -0,0 +1 @@
+export declare function supportsDocument(raw: unknown, version?: number): boolean;

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

@@ -0,0 +1,21 @@
+/**
+ * 从 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

@@ -0,0 +1,106 @@
+/**
+ * 文档文字与高亮的受限调色板。存储值保持原始 hex，显示色通过主题变量切换；
+ * 阅读路径复用此模块，不引入 Tiptap。历史色值均保留，复制时 data-color 可往返。
+ */
+export declare const TEXT_COLORS: readonly [{
+    readonly name: "默认";
+    readonly value: null;
+    readonly token: null;
+}, {
+    readonly name: "灰";
+    readonly value: "#868e96";
+    readonly token: "gray";
+}, {
+    readonly name: "红";
+    readonly value: "#d92c2c";
+    readonly token: "red";
+}, {
+    readonly name: "橙";
+    readonly value: "#e07b1a";
+    readonly token: "orange";
+}, {
+    readonly name: "黄褐";
+    readonly value: "#9a7b12";
+    readonly token: "yellow";
+}, {
+    readonly name: "绿";
+    readonly value: "#2f9e44";
+    readonly token: "green";
+}, {
+    readonly name: "蓝";
+    readonly value: "#1971c2";
+    readonly token: "blue";
+}, {
+    readonly name: "紫";
+    readonly value: "#7048e8";
+    readonly token: "purple";
+}];
+export declare const HIGHLIGHT_COLORS: readonly [{
+    readonly name: "无";
+    readonly value: null;
+    readonly token: null;
+}, {
+    readonly name: "浅灰";
+    readonly value: "#f1f3f5";
+    readonly token: "gray-soft";
+}, {
+    readonly name: "浅红";
+    readonly value: "#ffe3e3";
+    readonly token: "red";
+}, {
+    readonly name: "浅橙";
+    readonly value: "#fff0db";
+    readonly token: "orange";
+}, {
+    readonly name: "浅黄";
+    readonly value: "#fff3bf";
+    readonly token: "yellow";
+}, {
+    readonly name: "浅绿";
+    readonly value: "#d3f9d8";
+    readonly token: "green";
+}, {
+    readonly name: "浅蓝";
+    readonly value: "#d0ebff";
+    readonly token: "blue";
+}, {
+    readonly name: "浅紫";
+    readonly value: "#e5dbff";
+    readonly token: "purple";
+}, {
+    readonly name: "灰";
+    readonly value: "#dee2e6";
+    readonly token: "gray";
+}, {
+    readonly name: "深灰";
+    readonly value: "#ced4da";
+    readonly token: "gray-strong";
+}, {
+    readonly name: "红";
+    readonly value: "#ffc9c9";
+    readonly token: "red-strong";
+}, {
+    readonly name: "橙";
+    readonly value: "#ffd8a8";
+    readonly token: "orange-strong";
+}, {
+    readonly name: "黄";
+    readonly value: "#ffec99";
+    readonly token: "yellow-strong";
+}, {
+    readonly name: "绿";
+    readonly value: "#b2f2bb";
+    readonly token: "green-strong";
+}, {
+    readonly name: "蓝";
+    readonly value: "#a5d8ff";
+    readonly token: "blue-strong";
+}, {
+    readonly name: "紫";
+    readonly value: "#d0bfff";
+    readonly token: "purple-strong";
+}];
+export declare function paletteColor(value: string, palette: readonly {
+    value: string | null;
+}[]): string | null;
+export declare function documentColorAttributes(kind: 'text' | 'highlight', value: unknown): Record<string, string>;

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

@@ -0,0 +1,71 @@
+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

@@ -0,0 +1,5 @@
+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-phase2.d.ts

@@ -0,0 +1,19 @@
+import { type MindMapJson, type MindMapModel } from './mind-map.js';
+export declare const MIND_ICONS: string[];
+export declare const MIND_COLORS: string[];
+export declare const MIND_BACKGROUNDS: string[];
+export declare function topicTitle(node: MindMapJson): string;
+export declare function topicField(node: MindMapJson, field: 'description' | 'note'): string;
+export declare function branchModel(model: MindMapModel, id: string): MindMapModel;
+export declare function ancestorIds(model: MindMapModel, id: string): string[];
+export interface MindSearchHit {
+    id: string;
+    field: 'title' | 'description' | 'note';
+    from: number;
+    to: number;
+}
+export declare function searchMindMap(model: MindMapModel, query: string, details?: boolean): MindSearchHit[];
+export declare function parseMindMapImport(raw: string): MindMapModel;
+export declare function mindMapTemplate(kind: 'project' | 'meeting' | 'knowledge'): MindMapModel;
+export declare function importBranch(model: MindMapModel): MindMapJson[];
+export declare function parseMindBranch(raw: string): MindMapJson[];

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

@@ -0,0 +1,134 @@
+/** 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;
+export declare const MIND_MAP_LAYOUTS: readonly ["right", "left", "both", "down"];
+export declare const MIND_MAP_THEMES: readonly ["blue", "teal", "violet", "amber"];
+export type MindMapLayout = typeof MIND_MAP_LAYOUTS[number];
+export type MindMapTheme = typeof MIND_MAP_THEMES[number];
+export interface MindMark {
+    type: string;
+    attrs?: Record<string, unknown>;
+}
+export interface MindRun {
+    text: string;
+    marks?: MindMark[];
+}
+export interface MindRelation {
+    id: string;
+    source: string;
+    target: string;
+    kind: 'related' | 'depends' | 'reference';
+    label: string;
+}
+export interface MindTopic {
+    id: string;
+    parentId: string;
+    order: number;
+    text: string;
+    runs?: MindRun[];
+    description?: string;
+    note?: string;
+    shape?: 'round' | 'pill' | 'text';
+    color?: string;
+    background?: string;
+    fontSize?: number;
+    align?: 'left' | 'center' | 'right';
+    icon?: string;
+    done?: boolean;
+    attachmentId?: string;
+    side?: -1 | 1;
+}
+export interface MindMapModel {
+    id: string;
+    rootId: string;
+    layout: MindMapLayout;
+    theme: MindMapTheme;
+    height: number;
+    topics: MindTopic[];
+    relations?: MindRelation[];
+    branchStyle?: 'curve' | 'straight' | 'step';
+}
+export interface MindMapViewState {
+    openId: string | null;
+    maps: Record<string, {
+        selectedId: string;
+        selectedIds?: string[];
+        showGrid?: boolean;
+        showQuickControls?: boolean;
+        panMode?: boolean;
+        collapsed: string[];
+        viewport: {
+            x: number;
+            y: number;
+            zoom: number;
+        };
+    }>;
+}
+export interface MindMapJson {
+    type?: string;
+    attrs?: Record<string, unknown>;
+    text?: string;
+    marks?: MindMark[];
+    content?: MindMapJson[];
+}
+export interface PlacedTopic extends MindTopic {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    lines: string[];
+    side: -1 | 1;
+}
+export interface MindMapDrawing {
+    nodes: PlacedTopic[];
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+        path: string;
+    }>;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+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;
+    to: number;
+    text: string;
+};
+export declare function layoutMindMap(model: MindMapModel, collapsed?: ReadonlySet<string>): MindMapDrawing;
+export declare const MIND_MAP_PALETTE: Record<MindMapTheme, string>;
+export declare function mindMapSvg(model: MindMapModel, options?: {
+    transparent?: boolean;
+    images?: Record<string, string>;
+}): string;
+export declare function mindMapOutline(model: MindMapModel): Array<MindTopic & {
+    depth: number;
+}>;
+export declare function mindMapMarkdown(model: MindMapModel): string;
+export declare function mindRelationPaths(model: MindMapModel, drawing: MindMapDrawing): {
+    path: string;
+    x: number;
+    y: number;
+    id: string;
+    source: string;
+    target: string;
+    kind: "related" | "depends" | "reference";
+    label: string;
+}[];
+export declare function mindMapToJson(model: MindMapModel, fresh?: boolean): MindMapJson;

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

@@ -0,0 +1,18 @@
+export declare const MIND_TOPIC_LINE_HEIGHT = 22;
+export declare const mindTopicLineHeight: (fontSize?: number) => number;
+export declare const MIND_TOPIC_PADDING = 34;
+export declare const MIND_TOPIC_FONT = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", sans-serif";
+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;
+    lines: string[];
+    descriptionLines: string[];
+    titleHeight: number;
+};
+export {};

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

@@ -0,0 +1,30 @@
+/**
+ * 节点目录：编辑器的 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

@@ -0,0 +1,69 @@
+/**
+ * 协同在线状态（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

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

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

@@ -0,0 +1,24 @@
+/** 固定单元格底色，不接受任意 CSS；读写端共用，服务端同步白名单。 */
+export declare const CELL_BACKGROUNDS: readonly [{
+    readonly name: "默认";
+    readonly value: null;
+}, {
+    readonly name: "灰";
+    readonly value: "#f1f3f5";
+}, {
+    readonly name: "黄";
+    readonly value: "#fff3bf";
+}, {
+    readonly name: "绿";
+    readonly value: "#d3f9d8";
+}, {
+    readonly name: "蓝";
+    readonly value: "#d0ebff";
+}, {
+    readonly name: "紫";
+    readonly value: "#e5dbff";
+}, {
+    readonly name: "红";
+    readonly value: "#ffe3e3";
+}];
+export declare function cellBackground(value: unknown): string | null;

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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1,44 @@
+export interface ProseMirrorNode {
+    type?: string;
+    attrs?: Record<string, unknown>;
+    content?: ProseMirrorNode[];
+    marks?: Array<{
+        type: string;
+        attrs?: Record<string, unknown>;
+    }>;
+    text?: string;
+}
+export interface ProseMirrorDoc {
+    type: 'doc';
+    content?: ProseMirrorNode[];
+}
+export interface CommentAnchor {
+    quote: string;
+    prefix: string | null;
+    suffix: string | null;
+    start: number | null;
+    /** 锚点创建时的已发布版本号 */
+    seq: number | null;
+}
+export interface CommentItem {
+    id: string;
+    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;
+    replies: CommentItem[];
+}

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

@@ -0,0 +1,11 @@
+/** 纯数据协议；服务端同名文件必须保持一致，由契约测试检查。 */
+export interface VideoEmbedData {
+    provider: 'youtube' | 'bilibili';
+    videoId: string;
+    page: number;
+    startSeconds: number;
+}
+export declare function normalizeVideoEmbed(raw: unknown): VideoEmbedData | null;
+export declare function parseVideoUrl(value: string): VideoEmbedData | null;
+export declare function videoSourceUrl(data: VideoEmbedData): string;
+export declare function videoPlayerUrl(data: VideoEmbedData): string;