feat(editorStore): 重构编辑器状态管理，优化块操作和历史记录处理；删除冗余类型定义

src/services/webMcpAgentService.ts

@@ -307,14 +307,24 @@ const parseLocalDocumentCommand = async (
   if (isBlockAction) {
     const blockMatch = remainder.match(/\b(block-[\w-]+)\b/i);
     blockId = blockMatch?.[1];
-    blockContent = remainder.match(/(?:为|改为|内容为|插入)[:：]?\s*(.+)$/)?.[1];
-    remainder = remainder
-      .replace(blockId || '', '')
-      .replace(/(?:为|改为|内容为|插入)[:：]?\s*.+$/, '')
-      .trim();
-    const parsedReference = parseBlockReference(remainder);
-    blockReference = parsedReference.reference;
-    remainder = parsedReference.remainder;
+    remainder = remainder.replace(blockId || '', '').trim();
+
+    // 支持“第二行：内容”以及“第二行改为：内容”两种自然表达。
+    const positionedContent = remainder.match(
+      /^(.*?)(第\s*(?:\d+|[零〇一二两三四五六七八九十百]+)\s*(?:个)?\s*(?:行|段|块|标题|段落|条)|(?:最后|末尾|末)\s*(?:一行|一段|一个块|一块|一条|行|段|块|条)|首行|第一行)\s*(?::|：|为|改为|内容为)\s*(.+)$/i
+    );
+    if (positionedContent) {
+      const parsedReference = parseBlockReference(positionedContent[2].trim());
+      blockReference = parsedReference.reference;
+      blockContent = positionedContent[3].trim();
+      remainder = positionedContent[1].trim();
+    } else {
+      blockContent = remainder.match(/(?:为|改为|内容为|插入)[:：]?\s*(.+)$/)?.[1];
+      remainder = remainder.replace(/(?:为|改为|内容为|插入)[:：]?\s*.+$/, '').trim();
+      const parsedReference = parseBlockReference(remainder);
+      blockReference = parsedReference.reference;
+      remainder = parsedReference.remainder;
+    }
     remainder = remainder.replace(/(?:这个|该)?(?:文档|文件)\s*$/i, '').trim();
   }
 
@@ -363,7 +373,13 @@ const parseLocalDocumentCommand = async (
     toolName === 'download_export_record'
       ? { recordId: candidate.recordId || candidate.documentId }
       : { documentId: candidate.documentId };
-  if (blockId) input.blockId = blockId;
+  if (blockId) {
+    if (toolName === 'insert_block') {
+      input.afterBlockId = blockId;
+    } else {
+      input.blockId = blockId;
+    }
+  }
   if (toolName === 'update_block' && blockContent) input.content = blockContent;
   if (toolName === 'insert_block' && blockContent) {
     input.type = 'paragraph';

src/services/webMcpService.ts

@@ -110,6 +110,12 @@ const numberOr = (input: Record<string, unknown>, key: string, fallback: number)
 	return value;
 };
 
+const contentProperty = {
+	type: ['string', 'object', 'array'],
+	description: '块内容：字符串、结构化对象或数组',
+	maxLength: 200000,
+};
+
 const run = async (operation: () => Promise<unknown>): Promise<WebMcpToolResult> => {
 	try {
 		return text(await operation());
@@ -140,13 +146,23 @@ const validateToolInput = (tool: WebMcpTool, input: Record<string, unknown>): st
 	for (const [key, definition] of Object.entries(schema.properties)) {
 		const value = input[key];
 		if (value === undefined || value === null) continue;
-		if (definition.type === 'string' && typeof value !== 'string') return `${key} 必须是字符串`;
-		if (definition.type === 'string' && typeof value === 'string') {
+		const expectedTypes = Array.isArray(definition.type) ? definition.type : [definition.type];
+		const actualType = Array.isArray(value) ? 'array' : value === null ? 'null' : typeof value;
+		if (!expectedTypes.includes(actualType)) {
+			return `${key} 必须是${expectedTypes.join('、')}`;
+		}
+		if (expectedTypes.includes('string') && typeof value === 'string') {
 			if (definition.minLength !== undefined && value.length < Number(definition.minLength)) return `${key} 长度过短`;
 			if (definition.maxLength !== undefined && value.length > Number(definition.maxLength)) return `${key} 长度过长`;
+		} else if (definition.maxLength !== undefined && (Array.isArray(value) || isRecord(value))) {
+			try {
+				if (JSON.stringify(value).length > Number(definition.maxLength)) return `${key} 内容过大`;
+			} catch {
+				return `${key} 内容无法序列化`;
+			}
 		}
-		if (definition.type === 'number' && (typeof value !== 'number' || !Number.isFinite(value))) return `${key} 必须是数字`;
-		if (definition.type === 'number' && typeof value === 'number') {
+		if (expectedTypes.includes('number') && typeof value === 'number' && !Number.isFinite(value)) return `${key} 必须是数字`;
+		if (expectedTypes.includes('number') && typeof value === 'number') {
 			if (definition.minimum !== undefined && value < Number(definition.minimum)) return `${key} 不能小于 ${definition.minimum}`;
 			if (definition.maximum !== undefined && value > Number(definition.maximum)) return `${key} 不能大于 ${definition.maximum}`;
 		}
@@ -265,7 +281,7 @@ const tools: WebMcpTool[] = [
 			{
 				documentId: documentIdProperty,
 				type: { type: 'string', enum: ['heading', 'paragraph', 'table', 'image', 'toc'] },
-				content: { type: 'string', description: '块内容', maxLength: 200000 },
+				content: contentProperty,
 				level: { type: 'number', minimum: 0, maximum: 6 },
 				afterBlockId: { type: 'string', description: '插入到此块之后，可选' },
 				clientBlockId: { type: 'string', description: '可选，客户端幂等块 ID' },
@@ -301,11 +317,13 @@ const tools: WebMcpTool[] = [
 		title: '修改内容块',
 		description: '更新文档块内容。需要用户确认。',
 		requiresConfirmation: true,
-		inputSchema: objectSchema({ documentId: documentIdProperty, blockId: blockIdProperty, content: { type: 'string', description: '新的块内容' } }, ['documentId', 'blockId', 'content']),
+		inputSchema: objectSchema({ documentId: documentIdProperty, blockId: blockIdProperty, content: contentProperty }, ['documentId', 'blockId', 'content']),
 		execute: (input) => run(() => {
 			const documentId = requiredString(input, 'documentId');
 			const blockId = requiredString(input, 'blockId');
-			const updates: UpdateBlockRequest = { content: requiredString(input, 'content') };
+			const updates: UpdateBlockRequest = {
+				content: requiredContent(input, 'content') as UpdateBlockRequest['content'],
+			};
 			return blockService.updateBlock(documentId, blockId, updates).then((result) => {
 				window.dispatchEvent(new CustomEvent(BLOCK_UPDATED_EVENT, {
 					detail: { documentId, blockId, updates },

src/share/webmcp/translator.ts

@@ -11,6 +11,17 @@ export const translateWebMcpInput = async (
   input: string,
   context: WebMcpTranslationContext = {}
 ): Promise<WebMcpTranslationResponse> => {
+  const normalizedContext = {
+    ...context,
+    documentCandidates: context.documentCandidates?.map((candidate) => ({
+      documentId: candidate.documentId,
+      title: candidate.title,
+      ...(candidate.recordId ? { recordId: candidate.recordId } : {}),
+      ...('aliases' in candidate && Array.isArray(candidate.aliases) && candidate.aliases.length > 0
+        ? { aliases: candidate.aliases.join(' | ') }
+        : {}),
+    })),
+  };
   const controller = new AbortController();
   const timeoutId = window.setTimeout(() => controller.abort(), TRANSLATION_TIMEOUT_MS);
   let response: Response;
@@ -19,7 +30,7 @@ export const translateWebMcpInput = async (
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       credentials: 'include',
-      body: JSON.stringify({ input, context }),
+      body: JSON.stringify({ input, context: normalizedContext }),
       signal: controller.signal,
     });
   } catch (error) {

src/stores/editorStore.ts

@@ -12,6 +12,7 @@
 
 import { create } from 'zustand';
 import pLimit from 'p-limit';
+import hashSum from 'hash-sum';
 import { v4 as uuidv4 } from 'uuid';
 import { message } from 'antd';
 import type {
@@ -23,20 +24,11 @@ import type {
 } from '../types/editor';
 import { blockService } from '../services/blockService';
 import { getErrorMessage, isApiError } from '../services/api';
-import { normalizeTableBlock, validateTableStructure } from '../utils/blockOperations';
 import {
-  computeBlockHash,
-  computeInsertOrder,
-  isCanceledRequest,
-  isReadonlyBlock,
-  mergeBlockUpdates,
-  rebalanceOrders,
-  serializeBlockForSave,
-  serializePendingBlockUpdate,
-  snapshotBlocks,
-  waitForStructuralOperations,
-} from '../utils/editorStoreHelpers';
-import type { EditorHistoryEntry, EditorStore } from './editorStoreTypes';
+  normalizeTableBlock,
+  serializeTableBlock,
+  validateTableStructure,
+} from '../utils/blockOperations';
 
 // 并发保存限制器（最多同时进行 3 个请求，降低服务器压力）
 const saveConcurrencyLimit = pLimit(3);
@@ -50,6 +42,350 @@ const MAX_RETRY_ATTEMPTS = 3;
 const MAX_HISTORY_ENTRIES = 100;
 const HISTORY_COALESCE_WINDOW = 500;
 
+function waitForStructuralOperations(isReady: () => boolean): Promise<void> {
+  return new Promise((resolve) => {
+    const check = () => {
+      if (isReady()) {
+        resolve();
+        return;
+      }
+      setTimeout(check, 16);
+    };
+    check();
+  });
+}
+
+interface EditorHistoryEntry {
+  blocks: DocumentBlock[];
+  selectedBlockId: string | null;
+}
+
+function snapshotBlocks(blocks: DocumentBlock[]): DocumentBlock[] {
+  // 块更新采用不可变替换，历史快照只需复制数组即可复用块对象。
+  return blocks.slice();
+}
+
+/**
+ * 计算块内容的哈希值
+ * 用于检测内容是否真的发生了变化
+ */
+function computeBlockHash(block: DocumentBlock): string {
+  // 只计算可编辑字段的哈希，忽略 id 等不可变元数据
+  const contentForHash = {
+    type: block.type,
+    content: block.content,
+    style: block.style,
+    word_style: block.word_style,
+    level: block.level,
+    block_order: block.block_order,
+  };
+  return hashSum(contentForHash);
+}
+
+function isReadonlyBlock(block: DocumentBlock): boolean {
+  const metadata: object = block.metadata;
+  return (
+    ('readonly' in metadata && metadata.readonly === true) ||
+    ('is_auto_generated' in metadata && metadata.is_auto_generated === true)
+  );
+}
+
+function isCanceledRequest(error: unknown): boolean {
+  return (
+    error instanceof Error &&
+    (error.name === 'AbortError' ||
+      error.name === 'CanceledError' ||
+      error.message.toLowerCase().includes('cancel'))
+  );
+}
+
+function serializeBlockForSave(block: DocumentBlock): Pick<BlockUpdate, 'content' | 'style'> {
+  if (block.type === 'table') {
+    const serializedTable = serializeTableBlock(block as TableBlock);
+    return {
+      content: serializedTable.content,
+      style: block.style,
+    };
+  }
+
+  if ((block.type === 'heading' || block.type === 'paragraph') && Array.isArray(block.content)) {
+    const firstStyle = block.content[0]?.style;
+    const allSameStyle =
+      !!firstStyle &&
+      block.content.every(
+        (segment) => JSON.stringify(segment.style) === JSON.stringify(firstStyle)
+      );
+
+    return {
+      content: block.content.map((segment) => segment.text).join(''),
+      style:
+        allSameStyle && Object.keys(firstStyle).length > 0
+          ? { ...block.style, ...firstStyle }
+          : block.style,
+    };
+  }
+
+  return {
+    content: block.content,
+    style: block.style,
+  };
+}
+
+function mergeBlockUpdates(previous: BlockUpdate | undefined, next: BlockUpdate): BlockUpdate {
+  return { ...(previous || {}), ...next };
+}
+
+function serializePendingBlockUpdate(
+  block: DocumentBlock,
+  pending: BlockUpdate | undefined
+): BlockUpdate {
+  if (!pending) {
+    const serialized = serializeBlockForSave(block);
+    return {
+      type: block.type,
+      level: block.level,
+      content: serialized.content,
+      style: serialized.style,
+      word_style: block.word_style,
+      metadata: block.metadata,
+      block_order: block.block_order,
+    };
+  }
+  const updates = pending || {};
+  const serialized = serializeBlockForSave(block);
+  const payload: BlockUpdate = {};
+
+  if ('type' in updates) payload.type = block.type;
+  if ('level' in updates) payload.level = block.level;
+  if ('content' in updates) payload.content = serialized.content;
+  if ('style' in updates) payload.style = serialized.style;
+  if ('word_style' in updates) payload.word_style = block.word_style;
+  if ('metadata' in updates) payload.metadata = block.metadata;
+  if ('block_order' in updates) payload.block_order = block.block_order;
+
+  return payload;
+}
+
+// ══════════════════════════════════════════════════════════════════════════════
+// Store State Interface
+// ══════════════════════════════════════════════════════════════════════════════
+
+interface EditorStore {
+  // ── 文档状态 ────────────────────────────────────────────────────────────
+  documentId: string | null;
+  documentTitle: string;
+  blocks: DocumentBlock[];
+  selectedBlockId: string | null;
+  focusRequestId: number;
+  past: EditorHistoryEntry[];
+  future: EditorHistoryEntry[];
+  lastHistoryEditBlockId: string | null;
+  lastHistoryEditAt: number | null;
+  isHistoryApplying: boolean;
+  pendingStructuralOperations: number;
+
+  // ── 加载/保存状态 ──────────────────────────────────────────────────────
+  isLoading: boolean;
+  isSaving: boolean;
+  error: string | null;
+
+  // ── 保存进度 ────────────────────────────────────────────────────────────
+  /** 正在保存的块数量 */
+  savingProgress: { current: number; total: number } | null;
+
+  // ── 修改状态追踪 ────────────────────────────────────────────────────────
+  /** 文档是否已被修改(用于控制保存按钮状态) */
+  hasModified: boolean;
+  /** 原始blocks快照(用于检测变化) */
+  originalBlocksSnapshot: string | null;
+  /** 保存失败的块ID列表 */
+  failedBlocks: string[];
+  /** 被修改但未保存的块ID集合 */
+  dirtyBlocks: Set<string>;
+  /** 上次成功保存的快照 */
+  lastSavedSnapshot: string | null;
+  /** 块内容哈希映射表（用于精确检测内容变化）*/
+  blockHashes: Map<string, string>;
+  /** 每个块尚未提交的字段变更，只在保存时转换为 API patch */
+  pendingBlockUpdates: Map<string, BlockUpdate>;
+
+  // ── 保存控制 ────────────────────────────────────────────────────────────
+  /** 当前正在进行的保存 Promise */
+  currentSavePromise: Promise<void> | null;
+  /** 用于取消请求的 AbortController */
+  saveAbortController: AbortController | null;
+  /** 用于取消文档加载请求的 AbortController */
+  loadAbortController: AbortController | null;
+
+  // ── 自动保存 ────────────────────────────────────────────────────────────
+  /** 自动保存定时器 */
+  autoSaveTimer: ReturnType<typeof setTimeout> | null;
+  /** 是否启用自动保存 */
+  autoSaveEnabled: boolean;
+  /** 上次保存时间戳 */
+  lastSaveTime: number | null;
+
+  // ── 重试机制 ────────────────────────────────────────────────────────────
+  /** 块重试次数记录 */
+  retryAttempts: Map<string, number>;
+  /** 延迟重试定时器 */
+  retryTimer: ReturnType<typeof setTimeout> | null;
+
+  // ── 操作方法 ────────────────────────────────────────────────────────────
+
+  /**
+   * 加载文档
+   */
+  loadDocument: (documentId: string) => Promise<void>;
+
+  /**
+   * 保存文档
+   */
+  saveDocument: () => Promise<void>;
+
+  /**
+   * 重试保存失败的块
+   */
+  retryFailedBlocks: () => Promise<void>;
+
+  /**
+   * 添加块
+   * @param block 块数据(部分字段)
+   * @param afterBlockId 插入位置(在此块之后),不传则追加到末尾
+   */
+  addBlock: (block: PartialBlock, afterBlockId?: string) => void;
+
+  /**
+   * 更新块
+   * @param id 块ID
+   * @param updates 更新数据
+   */
+  updateBlock: (id: string, updates: BlockUpdate) => void;
+
+  /** 应用来自聊天/WebMCP 的已保存块更新 */
+  applyRemoteBlockUpdate: (id: string, updates: BlockUpdate) => void;
+
+  /** 应用来自 WebMCP 的已保存块插入 */
+  applyRemoteBlockInsert: (block: DocumentBlock) => void;
+
+  /** 应用来自聊天/WebMCP 的已保存块删除 */
+  applyRemoteBlockDelete: (id: string) => void;
+
+  /**
+   * 标记文档已修改
+   */
+  markAsModified: () => void;
+
+  /**
+   * 标记文档已保存
+   */
+  markAsSaved: () => void;
+
+  /**
+   * 删除块
+   * @param id 块ID
+   */
+  deleteBlock: (id: string) => Promise<void>;
+
+  /**
+   * 移动块
+   * @param id 块ID
+   * @param targetOrder 目标位置
+   */
+  moveBlock: (id: string, targetOrder: number) => void;
+
+  /**
+   * 选中块
+   * @param id 块ID
+   */
+  selectBlock: (id: string | null) => void;
+
+  /**
+   * 根据ID获取块
+   */
+  getBlockById: (id: string) => DocumentBlock | undefined;
+
+  /**
+   * 根据类型获取块
+   */
+  getBlocksByType: (type: BlockType) => DocumentBlock[];
+
+  /**
+   * 检查块是否为脏块（已修改未保存）
+   */
+  isBlockDirty: (id: string) => boolean;
+
+  /**
+   * 获取所有脏块
+   */
+  getDirtyBlocks: () => DocumentBlock[];
+
+  /**
+   * 保存单个block的更改
+   */
+  saveBlock: (id: string) => Promise<void>;
+
+  /**
+   * 重新计算所有块的block_order(稀疏排序)
+   */
+  recomputeBlockOrders: () => void;
+
+  /**
+   * 启用/禁用自动保存
+   */
+  setAutoSaveEnabled: (enabled: boolean) => void;
+
+  /**
+   * 触发自动保存（带防抖）
+   */
+  triggerAutoSave: () => void;
+
+  /**
+   * 取消自动保存定时器
+   */
+  cancelAutoSave: () => void;
+
+  /**
+   * 重置状态
+   */
+  reset: () => void;
+  /** 撤销最近一次编辑 */
+  undo: () => Promise<void>;
+  /** 重做最近一次撤销 */
+  redo: () => Promise<void>;
+}
+
+// ══════════════════════════════════════════════════════════════════════════════
+// Utility Functions
+// ══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * 计算插入位置的block_order
+ * 稀疏排序策略:在两个块之间找到中间值
+ */
+function computeInsertOrder(prevOrder: number, nextOrder: number): number {
+  const gap = nextOrder - prevOrder;
+
+  if (gap > 1) {
+    // 有间隙,直接取中间值
+    return Math.floor((prevOrder + nextOrder) / 2);
+  }
+
+  // 间隙不足,需要重排
+  return -1;
+}
+
+/**
+ * 重新平衡block_order(稀疏排序,间隔100)
+ */
+function rebalanceOrders(blocks: DocumentBlock[]): DocumentBlock[] {
+  const sorted = [...blocks].sort((a, b) => a.block_order - b.block_order);
+  return sorted.map((block, index) => ({
+    ...block,
+    block_order: index * 100,
+  }));
+}
+
 // ══════════════════════════════════════════════════════════════════════════════
 // Store Implementation
 // ══════════════════════════════════════════════════════════════════════════════
@@ -319,14 +655,14 @@ export const useEditorStore = create<EditorStore>((set, get) => {
         return;
       }
 
-      const dirtyBlocks = new Set<string>();
-      const blocksToSave: DocumentBlock[] = [];
-      for (const block of blocks) {
-        if (currentDirtyBlocks.has(block.id) && block.type !== 'toc' && !isReadonlyBlock(block)) {
-          dirtyBlocks.add(block.id);
-          blocksToSave.push(block);
-        }
-      }
+      const dirtyBlocks = new Set(
+        blocks
+          .filter(
+            (block) =>
+              currentDirtyBlocks.has(block.id) && block.type !== 'toc' && !isReadonlyBlock(block)
+          )
+          .map((block) => block.id)
+      );
 
       if (dirtyBlocks.size === 0) {
         set({
@@ -367,6 +703,15 @@ export const useEditorStore = create<EditorStore>((set, get) => {
       // 创建保存 Promise
       const savePromise = (async () => {
         try {
+          // 获取需要保存的块（只保存脏块）
+          const blocksToSave = blocks.filter((block) => {
+            // 必须在脏块列表中
+            if (!dirtyBlocks.has(block.id)) {
+              return false;
+            }
+
+            return true;
+          });
           const pendingUpdatesAtSave = new Map(currentPendingBlockUpdates);
 
           const totalBlocks = blocksToSave.length;
@@ -389,9 +734,12 @@ export const useEditorStore = create<EditorStore>((set, get) => {
               );
 
               try {
-                const result = await blockService.updateBlock(documentId, block.id, payload, {
-                  signal: newAbortController.signal,
-                });
+                const result = await blockService.updateBlock(
+                  documentId,
+                  block.id,
+                  payload,
+                  { signal: newAbortController.signal }
+                );
                 if (newAbortController.signal.aborted || get().documentId !== documentId) {
                   return result;
                 }
@@ -925,7 +1273,10 @@ export const useEditorStore = create<EditorStore>((set, get) => {
       if (originalHash && newHash === originalHash) {
         newPendingBlockUpdates.delete(id);
       } else {
-        newPendingBlockUpdates.set(id, mergeBlockUpdates(pendingBlockUpdates.get(id), updates));
+        newPendingBlockUpdates.set(
+          id,
+          mergeBlockUpdates(pendingBlockUpdates.get(id), updates)
+        );
       }
 
       set({
@@ -977,9 +1328,7 @@ export const useEditorStore = create<EditorStore>((set, get) => {
       const { documentId, blocks, blockHashes, dirtyBlocks, pendingBlockUpdates } = get();
       if (!documentId || blocks.some((currentBlock) => currentBlock.id === block.id)) return;
 
-      const updatedBlocks = [...blocks, block].sort(
-        (left, right) => left.block_order - right.block_order
-      );
+      const updatedBlocks = [...blocks, block].sort((left, right) => left.block_order - right.block_order);
       const updatedHashes = new Map(blockHashes);
       updatedHashes.set(block.id, computeBlockHash(block));
       const snapshot = JSON.stringify(updatedBlocks);

src/stores/editorStoreTypes.ts

@@ -1,70 +0,0 @@
-import type { BlockType, BlockUpdate, DocumentBlock, PartialBlock } from '../types/editor';
-
-export interface EditorHistoryEntry {
-  blocks: DocumentBlock[];
-  selectedBlockId: string | null;
-}
-
-export interface EditorStore {
-  documentId: string | null;
-  documentTitle: string;
-  blocks: DocumentBlock[];
-  selectedBlockId: string | null;
-  focusRequestId: number;
-  past: EditorHistoryEntry[];
-  future: EditorHistoryEntry[];
-  lastHistoryEditBlockId: string | null;
-  lastHistoryEditAt: number | null;
-  isHistoryApplying: boolean;
-  pendingStructuralOperations: number;
-
-  isLoading: boolean;
-  isSaving: boolean;
-  error: string | null;
-  savingProgress: { current: number; total: number } | null;
-
-  hasModified: boolean;
-  originalBlocksSnapshot: string | null;
-  failedBlocks: string[];
-  dirtyBlocks: Set<string>;
-  lastSavedSnapshot: string | null;
-  blockHashes: Map<string, string>;
-  pendingBlockUpdates: Map<string, BlockUpdate>;
-
-  currentSavePromise: Promise<void> | null;
-  saveAbortController: AbortController | null;
-  loadAbortController: AbortController | null;
-
-  autoSaveTimer: ReturnType<typeof setTimeout> | null;
-  autoSaveEnabled: boolean;
-  lastSaveTime: number | null;
-
-  retryAttempts: Map<string, number>;
-  retryTimer: ReturnType<typeof setTimeout> | null;
-
-  loadDocument: (documentId: string) => Promise<void>;
-  saveDocument: () => Promise<void>;
-  retryFailedBlocks: () => Promise<void>;
-  addBlock: (block: PartialBlock, afterBlockId?: string) => void;
-  updateBlock: (id: string, updates: BlockUpdate) => void;
-  applyRemoteBlockUpdate: (id: string, updates: BlockUpdate) => void;
-  applyRemoteBlockInsert: (block: DocumentBlock) => void;
-  applyRemoteBlockDelete: (id: string) => void;
-  markAsModified: () => void;
-  markAsSaved: () => void;
-  deleteBlock: (id: string) => Promise<void>;
-  moveBlock: (id: string, targetOrder: number) => void;
-  selectBlock: (id: string | null) => void;
-  getBlockById: (id: string) => DocumentBlock | undefined;
-  getBlocksByType: (type: BlockType) => DocumentBlock[];
-  isBlockDirty: (id: string) => boolean;
-  getDirtyBlocks: () => DocumentBlock[];
-  saveBlock: (id: string) => Promise<void>;
-  recomputeBlockOrders: () => void;
-  setAutoSaveEnabled: (enabled: boolean) => void;
-  triggerAutoSave: () => void;
-  cancelAutoSave: () => void;
-  reset: () => void;
-  undo: () => Promise<void>;
-  redo: () => Promise<void>;
-}

src/utils/editorStoreHelpers.ts

@@ -1,121 +0,0 @@
-import hashSum from 'hash-sum';
-import type { BlockUpdate, DocumentBlock, TableBlock } from '../types/editor';
-import { serializeTableBlock } from './blockOperations';
-
-export function waitForStructuralOperations(isReady: () => boolean): Promise<void> {
-  return new Promise((resolve) => {
-    const check = () => {
-      if (isReady()) {
-        resolve();
-        return;
-      }
-      setTimeout(check, 16);
-    };
-    check();
-  });
-}
-
-export function computeInsertOrder(prevOrder: number, nextOrder: number): number {
-  const gap = nextOrder - prevOrder;
-  return gap > 1 ? Math.floor((prevOrder + nextOrder) / 2) : -1;
-}
-
-export function rebalanceOrders(blocks: DocumentBlock[]): DocumentBlock[] {
-  return [...blocks]
-    .sort((left, right) => left.block_order - right.block_order)
-    .map((block, index) => ({ ...block, block_order: index * 100 }));
-}
-
-export function snapshotBlocks(blocks: DocumentBlock[]): DocumentBlock[] {
-  return blocks.slice();
-}
-
-export function computeBlockHash(block: DocumentBlock): string {
-  return hashSum({
-    type: block.type,
-    content: block.content,
-    style: block.style,
-    word_style: block.word_style,
-    level: block.level,
-    block_order: block.block_order,
-  });
-}
-
-export function isReadonlyBlock(block: DocumentBlock): boolean {
-  const metadata = block.metadata as { readonly?: unknown; is_auto_generated?: unknown };
-  return metadata.readonly === true || metadata.is_auto_generated === true;
-}
-
-export function isCanceledRequest(error: unknown): boolean {
-  return (
-    error instanceof Error &&
-    (error.name === 'AbortError' ||
-      error.name === 'CanceledError' ||
-      error.message.toLowerCase().includes('cancel'))
-  );
-}
-
-export function serializeBlockForSave(
-  block: DocumentBlock
-): Pick<BlockUpdate, 'content' | 'style'> {
-  if (block.type === 'table') {
-    const serializedTable = serializeTableBlock(block as TableBlock);
-    return { content: serializedTable.content, style: block.style };
-  }
-
-  if ((block.type === 'heading' || block.type === 'paragraph') && Array.isArray(block.content)) {
-    const firstStyle = block.content[0]?.style;
-    const firstStyleSerialized = firstStyle ? JSON.stringify(firstStyle) : undefined;
-    const allSameStyle =
-      !!firstStyle &&
-      block.content.every((segment) => JSON.stringify(segment.style) === firstStyleSerialized);
-
-    return {
-      content: block.content.map((segment) => segment.text).join(''),
-      style:
-        allSameStyle && Object.keys(firstStyle).length > 0
-          ? { ...block.style, ...firstStyle }
-          : block.style,
-    };
-  }
-
-  return { content: block.content, style: block.style };
-}
-
-export function mergeBlockUpdates(
-  previous: BlockUpdate | undefined,
-  next: BlockUpdate
-): BlockUpdate {
-  return { ...(previous || {}), ...next };
-}
-
-export function serializePendingBlockUpdate(
-  block: DocumentBlock,
-  pending: BlockUpdate | undefined
-): BlockUpdate {
-  if (!pending) {
-    const serialized = serializeBlockForSave(block);
-    return {
-      type: block.type,
-      level: block.level,
-      content: serialized.content,
-      style: serialized.style,
-      word_style: block.word_style,
-      metadata: block.metadata,
-      block_order: block.block_order,
-    };
-  }
-
-  const payload: BlockUpdate = {};
-  if ('type' in pending) payload.type = block.type;
-  if ('level' in pending) payload.level = block.level;
-  if ('content' in pending || 'style' in pending) {
-    const serialized = serializeBlockForSave(block);
-    if ('content' in pending) payload.content = serialized.content;
-    if ('style' in pending) payload.style = serialized.style;
-  }
-  if ('word_style' in pending) payload.word_style = block.word_style;
-  if ('metadata' in pending) payload.metadata = block.metadata;
-  if ('block_order' in pending) payload.block_order = block.block_order;
-  return payload;
-}