weifuwu 0.94.1 → 0.95.0

package/dist/level5/client/components/Notification/Notification.ts

@@ -0,0 +1,252 @@
+/** Notification：队列式通知：notification.success/error/warning 命令式（antd 对齐）（showcase /components/notification） */
+import type { Component, VNode } from '../../../../level6/client/vdom/index.ts'
+import { createClientBrowser } from '../../../../level6/client/vdom/index.ts'
+import type { UIContext, AppMiddleware } from '../../../../level6/client/vdom/index.ts'
+import { h } from '../../../../level6/client/vdom/index.ts'
+import { Icon } from '../Icon/Icon.ts'
+import type { IconName } from '../Icon/Icon.ts'
+
+// 命令式 API：浏览器环境（SSR 不调用）
+const browser = createClientBrowser()
+
+export type NotificationType = 'success' | 'error' | 'info' | 'warning'
+export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'
+
+export interface NotificationItem {
+  id: string
+  type: NotificationType
+  title: string
+  description?: string
+  /** 自动关闭时间（ms），0 = 不自动关闭，默认 4500 */
+  duration?: number
+  action?: { label: string; onClick: ()=> void }
+}
+
+export interface NotificationProps {
+  items?: NotificationItem[]
+  onRemove?: (id: string)=> void
+  position?: NotificationPosition
+  /** 全局默认自动关闭时间（ms），默认 4500 */
+  duration?: number
+  /** 最大显示条数，超出移除最早，默认 0 = 不限制 */
+  max?: number
+}
+
+export interface NotificationOptions {
+  position?: NotificationPosition
+  duration?: number
+  max?: number
+}
+
+function positionClass(pos: NotificationPosition): string {
+  const map: Record<NotificationPosition, string> = {
+    'top-right': 'wf-notification--tr',
+    'top-left': 'wf-notification--tl',
+    'bottom-right': 'wf-notification--br',
+    'bottom-left': 'wf-notification--bl',
+  }
+  return map[pos] ?? 'wf-notification--tr'
+}
+
+function iconFor(type: NotificationType): IconName {
+  switch (type) {
+    case 'success': return 'check'
+    case 'error': return 'close'
+    case 'warning': return 'alert'
+    case 'info': return 'info'
+  }
+}
+
+/** 通知（对应 antd/EP Notification 队列式）：title + description + icon + 操作，聚合角落 */
+/**
+ * 命令式中间件：ctx.notification()（队列式——聚合角落——自动消失）
+ *
+ * 真实 bug（2026-12 showcase QA）：NotificationInjected 契约定义了实现缺失
+ * ——showcase Notification demo 静默失效（ctx.notification undefined）——
+ * 补全：模块级队列 + 常驻容器 + diff 重渲染（Notification 组件真实实例）。
+ */
+import { renderV2 } from '../../../../level3/vdom/v2/render.ts' // v1 退役——v2 引擎
+import { diffV2, disposeSegment as disposeSegmentV2, type SegmentMap } from '../../../../level3/vdom/v2/diff.ts'
+import { collectCommands } from '../../../../level3/vdom/v2/integrate.ts'
+import { CommandApplier } from '../../../../level3/vdom/patch/index.ts'
+import { createComponentRegistry } from '../../../../level3/vdom/node/component.ts'
+import type { ComponentRegistry } from '../../../../level3/vdom/node/component.ts'
+
+type NotifHost = {
+  container: HTMLDivElement
+  applier: CommandApplier
+  registry: ComponentRegistry
+  items: NotificationItem[]
+  seq: number
+  currentTree: VNode | null
+  ctx: UIContext
+  /** v2 段表（弹窗级独立实例——组件工厂不重跑） */
+  segments: SegmentMap
+}
+
+let notifHost: NotifHost | null = null
+
+function ensureHost(): NotifHost {
+  if (notifHost) return notifHost
+  const container = document.createElement('div')
+  container.className = 'wf-notification-host'
+  document.body.appendChild(container)
+  const registry = createComponentRegistry()
+  const applier = new CommandApplier(container, document, registry)
+  const ctx = {
+    render: async ()=> {},
+    onUnmount: ()=> {},
+    data: { get: async ()=> undefined, set: ()=> {}, has: ()=> false },
+    browser,
+  } as unknown as UIContext
+  notifHost = { container, applier, registry, items: [], seq: 0, currentTree: null, ctx, segments: new Map() }
+  return notifHost
+}
+
+async function renderNotifs(host: NotifHost): Promise<void> {
+  const vnode = h(Notification, {
+    items: host.items,
+    onRemove: (id: string)=> { removeNotif(id) },
+  }) as VNode
+  const obs = host.currentTree
+    ? diffV2(host.currentTree as never, vnode as never, host.ctx, host.segments, host.registry, ()=> {})
+    : renderV2(vnode as never, host.ctx, host.registry, host.segments, ()=> {})
+  const cmds = await collectCommands(obs)
+  for (const cmd of cmds) host.applier.apply(cmd)
+  host.currentTree = vnode
+  for (const cmd of cmds) {
+    if (cmd.op === 'unmount') disposeSegmentV2(cmd.compId, host.segments)
+  }
+}
+
+async function removeNotif(id: string): Promise<void> {
+  if (!notifHost) return
+  notifHost.items = notifHost.items.filter((t)=> t.id !== id)
+  if (notifHost.items.length === 0) {
+    // **先渲染空列表（2027-08——v1 退役——portal 清理）**：Notification 内容
+    // 挂全局 portal（openPopup）——handle.close 发生在 renderFn（空列表
+    // 分支）——v1 的 applier.dispose 经 registry onUnmounts 触发；v2 段表
+    // 需显式渲染空态触发段卸载 → handle.close → portal 内容移除——
+    // 再 dispose host（等待渲染完成——序列确定）
+    try { await renderNotifs(notifHost) } catch { /* 空态渲染失败——继续清理 */ }
+    notifHost.applier.dispose()
+    notifHost.container.remove()
+    notifHost = null
+  } else {
+    void renderNotifs(notifHost)
+  }
+}
+
+function openNotif(opts: {
+  type: NotificationType
+  title: string
+  description?: string
+  duration?: number
+  action?: NotificationItem['action']
+}): void {
+  const host = ensureHost()
+  const item: NotificationItem = { id: `n${++host.seq}`, ...opts }
+  host.items = [...host.items, item]
+  renderNotifs(host)
+  const dur = opts.duration ?? 4500
+  if (dur > 0) {
+    setTimeout(()=> removeNotif(item.id), dur)
+  }
+}
+
+/** 命令式入口（对齐 antd notification.open 风格——可调用可链式） */
+export const notification: NotificationInjected['notification'] = Object.assign(
+  (title: string, opts?: { type?: NotificationType; description?: string; duration?: number; action?: NotificationItem['action'] }): void =>
+    openNotif({ type: opts?.type ?? 'info', title, description: opts?.description, duration: opts?.duration, action: opts?.action }),
+  {
+    open: (o: { type?: NotificationType; title: string; description?: string; duration?: number; action?: NotificationItem['action'] })=>
+      openNotif({ type: o.type ?? 'info', title: o.title, description: o.description, duration: o.duration, action: o.action }),
+    success: (o: { title: string; description?: string; duration?: number })=> openNotif({ type: 'success', ...o }),
+    error: (o: { title: string; description?: string; duration?: number })=> openNotif({ type: 'error', ...o }),
+    info: (o: { title: string; description?: string; duration?: number })=> openNotif({ type: 'info', ...o }),
+    warning: (o: { title: string; description?: string; duration?: number })=> openNotif({ type: 'warning', ...o }),
+  },
+)
+
+/**
+ * 命令式中间件：注入 ctx.notification()（AppMiddleware 形态——应用装配）
+ */
+export function notificationMiddleware<C extends Record<string, unknown>>(ctx: C): C & NotificationInjected {
+  return Object.assign(ctx, { notification })
+}
+
+export const Notification: Component<NotificationProps> = (_init, ctx)=> {
+  // 命令式弹窗（唯一形态 openPopup）：常驻容器（positioning 'none'——CSS 角落定位）
+  /** 命令式句柄（唯一形态——openPopup——组件内部同步样板） */
+  let handle: import('../../../../level3/vdom/hooks/popup-manager.ts').PopupHandle | null = null
+
+  return (props)=> {
+    const { items = [], onRemove, position = 'top-right', duration = 4500, max = 0 } = props
+
+    const visible = max > 0 && items.length > max ? items.slice(-max) : items
+    if (visible.length === 0) {
+      if (handle) { handle.close(); handle = null }
+      return null
+    }
+
+    const cards = visible.map(t =>
+      h('div', {
+        class: `wf-notification wf-notification--${t.type}`,
+        key: t.id,
+        role: t.type === 'error' ? 'alert' : 'status',
+        'aria-live': t.type === 'error' ? 'assertive' : 'polite',
+        'data-id': t.id,
+        'data-duration': (t.duration ?? duration) || undefined,
+      }, [
+        h('span', { class: 'wf-notification-icon' }, h(Icon, { name: iconFor(t.type) })),
+        h('div', { class: 'wf-notification-body' }, [
+          h('div', { class: 'wf-notification-title' }, t.title),
+          t.description ? h('div', { class: 'wf-notification-desc' }, t.description) : null,
+          t.action ? h('button', {
+            class: 'wf-notification-action',
+            type: 'button',
+            onClick: (e: Event)=> { e.stopPropagation(); t.action!.onClick() },
+          }, t.action.label) : null,
+        ].filter(Boolean)),
+        h('button', {
+          type: 'button',
+          class: 'wf-notification-close',
+          'aria-label': '关闭通知',
+          onClick: ()=> onRemove?.(t.id),
+        }, h(Icon, { name: 'close', size: 12 })),
+      ].filter(Boolean))
+    )
+
+    const container = h('div', {
+      class: `wf-notification-container ${positionClass(position)}`,
+      'data-max': max || undefined,
+    }, cards)
+
+    // 命令式同步（常驻容器——内容更新）
+    if (!handle)
+      handle = ctx.ui.openPopup({
+        key: 'notification',
+        positioning: 'none',
+        closeOnOutside: false, closeOnEscape: false,
+        content: ()=> container,
+        onClose: ()=> { handle = null },
+      })
+    else handle.update(container)
+    return null
+  }
+}
+
+// ── 命令式中间件：ctx.notification() ──────────────────
+// 对齐 antd notification.open / EP ElNotification 风格
+
+export interface NotificationInjected {
+  notification: {
+    (title: string, opts?: { type?: NotificationType; description?: string; duration?: number; action?: NotificationItem['action'] }): void
+    open: (opts: { type?: NotificationType; title: string; description?: string; duration?: number; action?: NotificationItem['action'] })=> void
+    success: (opts: { title: string; description?: string; duration?: number })=> void
+    error: (opts: { title: string; description?: string; duration?: number })=> void
+    info: (opts: { title: string; description?: string; duration?: number })=> void
+    warning: (opts: { title: string; description?: string; duration?: number })=> void
+  }
+}
+

package/dist/level5/client/components/OfficeEditor/ai/ai-bridge.ts

@@ -0,0 +1,104 @@
+/**
+ * weifuwu/client/components/OfficeEditor/ai — ODES × AI 事件流对接
+ *
+ * 设计（ §9）：AI 落地 = 普通 op + ai 元数据。
+ * 本模块：AI 回复 → OfficeOp[] 默认解析（按 mode）+ 事件流桥接发射。
+ *
+ * xlsx formula 模式解析：
+ * - 回复含 `=...` → 公式单元格（kind:'f'——值 + formula 字符串保留——不计算）
+ * - 纯数字 → kind:'n'；true/false → kind:'b'；其余 → kind:'s'
+ * - 位置：回复内嵌 ref（`A1:` 前缀 / `B2=...`）优先，否则 ctx.ref（活动单元格）
+ */
+
+import type { AiContext, OfficeOp, OfficeStreamPayload } from '../model/types.ts'
+import type { SheetCell } from '../model/types.ts'
+import { editEmit } from '../../Editor/edit-events.ts'
+import type { DocType } from '../model/types.ts'
+
+// ── 回复解析（默认——按 mode） ─────────────────────────────────────────────
+
+export interface ParseResult {
+  ops: OfficeOp[]
+  /** 解析说明（UI 展示；不可解析时建议） */
+  note?: string
+}
+
+/** AI 回复 → cell-set ops（formula 模式） */
+export function parseFormulaReply(text: string, ctx: AiContext): ParseResult {
+  const clean = text.trim()
+  // 单行或多行——每行一个单元格写入；行内 `ref=value` 或 `ref: value`
+  const lines = clean.split('\n').map((l)=> l.trim()).filter(Boolean)
+  const ops: OfficeOp[] = []
+  const sheet = 0
+  let used = false
+  for (const line of lines) {
+    const m = /^([A-Z]+\d+)\s*[:=]\s*(.*)$/.exec(line)
+    if (m) {
+      const cell = parseCellValue(m[2].trim())
+      ops.push({ type: 'cell-set', sheet, ref: m[1], cell })
+      used = true
+      continue
+    }
+    // 无 ref——整行作为活动单元格内容（文本限短值——长文本是自然语言回复）
+    if (!used && lines.length === 1) {
+      const cell = parseCellValue(line)
+      if (cell.kind === 's' && line.length > 16) continue
+      ops.push({ type: 'cell-set', sheet, ref: ctx.ref ?? 'A1', cell })
+      used = true
+    }
+  }
+  if (!used) {
+    return { ops: [], note: '回复无法解析为单元格内容（期望公式/值或 `A1: 值` 格式）' }
+  }
+  return { ops }
+}
+
+function parseCellValue(v: string): SheetCell {
+  if (v.startsWith('=')) return { kind: 'f', value: '', formula: v }
+  if (/^-?\d+(\.\d+)?$/.test(v)) return { kind: 'n', value: Number(v) }
+  if (v === 'true' || v === 'false') return { kind: 'b', value: v === 'true' }
+  return { kind: 's', value: v }
+}
+
+/** AI 回复 → shape-set op（pptx text 模式——选中 shape 文本替换） */
+export function parseShapeTextReply(text: string, ctx: AiContext): ParseResult {
+  if (!ctx.shapeId) return { ops: [], note: '未选中形状（先点选文本框再触发 AI）' }
+  const clean = text.trim()
+  if (!clean) return { ops: [], note: 'AI 回复为空' }
+  return {
+    ops: [{ type: 'shape-set', slide: 0, shapeId: ctx.shapeId, props: { text: clean } }],
+  }
+}
+
+/** docx/text 模式：回复即正文——Editor ai-apply 语义由 Editor 层处理（本模块不产生 op） */
+export function parseTextReply(_text: string, _ctx: AiContext): ParseResult {
+  return { ops: [], note: 'docx 文本 AI 走 Editor ai-apply（选区替换——Editor 层处理）' }
+}
+
+export function parseReplyByMode(text: string, ctx: AiContext): ParseResult {
+  if (ctx.docType === 'xlsx') return parseFormulaReply(text, ctx)
+  if (ctx.docType === 'pptx') return parseShapeTextReply(text, ctx)
+  return parseTextReply(text, ctx)
+}
+
+// ── 事件流桥接（edit ↔ ai 关联审计） ───────────────────────────────────────
+
+/**
+ * 发射 office 事件（AI 关联——payload.ai.messageId + target = messageId——
+ * editEvents ↔ aiEvents 一条链：`__edit_tail(50,'office')` ↔ `__ai_events(n,{messageId})`）
+ */
+export function officeAiEmit(
+  payload: Omit<OfficeStreamPayload, 'ai'> & { ai: { messageId: string; status: 'suggested' | 'accepted' | 'rejected' } },
+): void {
+  editEmit('office', payload as unknown as Record<string, unknown>, payload.ai.messageId)
+}
+
+/** 便捷：AI 建议接受 = 普通 op 落地（ai 元数据——接受状态） */
+export function emitAiApply(docType: DocType, op: OfficeOp, messageId: string): void {
+  officeAiEmit({ docType, op, ai: { messageId, status: 'accepted' } })
+}
+
+/** 便捷：AI 建议拒绝（不产生 op——状态记录审计） */
+export function emitAiReject(docType: DocType, messageId: string, reason?: string): void {
+  editEmit('office', { docType, ai: { messageId, status: 'rejected' }, reason } as unknown as Record<string, unknown>, messageId)
+}

package/dist/level5/client/components/OfficeEditor/model/apply.ts

@@ -0,0 +1,274 @@
+/**
+ * weifuwu/client/components/OfficeEditor/model/apply — ODES 折叠（fold）纯函数
+ *
+ * 核心不变量：snapshot = fold(全部事件)——apply 每个 op 得到新状态（不可变）。
+ * - docx：委托 Editor applyEdit（EditEvent 全量复用——零新逻辑）
+ * - xlsx/pptx：各自 apply（纯函数——Map 复制、数组复制）
+ */
+
+import { applyEdit } from '../../Editor/model/apply.ts'
+import { EMPTY_DOC } from '../../Editor/model/types.ts'
+import type { DocState, EditEvent } from '../../Editor/model/types.ts'
+import type {
+  DeckState, DocType, OfficeCheckpoint, OfficeOp, OfficeSnapshot,
+  SheetCell, SheetOp, SheetState, SlideOp, SlideShape, SlideState, WorkbookState,
+} from './types.ts'
+
+// ── 空状态 ──────────────────────────────────────────────────────────────────
+
+export function emptySnapshot(docType: DocType): OfficeSnapshot {
+  if (docType === 'docx') return { docType, doc: EMPTY_DOC }
+  if (docType === 'xlsx') {
+    return {
+      docType,
+      workbook: { sheets: [{ name: 'Sheet1', cols: 1, cells: new Map() }], activeSheet: 0 },
+    }
+  }
+  return {
+    docType,
+    deck: { slides: [{ shapes: [] }], activeSlide: 0, size: { w: 960, h: 540 } },
+  }
+}
+
+// ── 引用工具（网格） ────────────────────────────────────────────────────────
+
+/** 'A1' → { row: 0, col: 0 }（col 字母段、row 数字段） */
+export function parseRef(ref: string): { row: number; col: number } {
+  const m = /^([A-Z]+)(\d+)$/.exec(ref.toUpperCase())
+  if (!m) return { row: 0, col: 0 }
+  let col = 0
+  for (const ch of m[1]) col = col * 26 + (ch.charCodeAt(0) - 64)
+  return { row: Number(m[2]) - 1, col: col - 1 }
+}
+
+export function toRef(row: number, col: number): string {
+  let c = ''
+  let n = col + 1
+  while (n > 0) { c = String.fromCharCode(65 + ((n - 1) % 26)) + c; n = Math.floor((n - 1) / 26) }
+  return `${c}${row + 1}`
+}
+
+/** 行列插入后引用平移（单元格重定位；公式字符串不重算——裁剪登记） */
+export function shiftCellRef(ref: string, atRow: number, atCol: number, dRow: number, dCol: number): string | null {
+  const { row, col } = parseRef(ref)
+  const r = row >= atRow ? row + dRow : row
+  const c = col >= atCol ? col + dCol : col
+  if (r < 0 || c < 0) return null
+  return toRef(r, c)
+}
+
+// ── xlsx apply ──────────────────────────────────────────────────────────────
+
+function cloneSheet(s: SheetState): SheetState {
+  return { name: s.name, cols: s.cols, cells: new Map(s.cells) }
+}
+
+function applyCellOp(sheet: SheetState, op: Extract<SheetOp, { type: 'cell-set' | 'range-style' }>): SheetState {
+  if (op.type === 'cell-set') {
+    const next = cloneSheet(sheet)
+    if (op.cell === null) next.cells.delete(op.ref.toUpperCase())
+    else next.cells.set(op.ref.toUpperCase(), { ...op.cell, style: op.cell.style ? { ...op.cell.style } : undefined })
+    const { col } = parseRef(op.ref)
+    if (col + 1 > next.cols) next.cols = col + 1
+    return next
+  }
+  const next = cloneSheet(sheet)
+  const key = op.ref.toUpperCase()
+  const cell = next.cells.get(key)
+  if (cell) next.cells.set(key, { ...cell, style: op.style ? { ...op.style } : undefined })
+  else next.cells.set(key, { kind: 's', value: '', style: op.style ? { ...op.style } : undefined })
+  return next
+}
+
+function applyRows(sheet: SheetState, at: number, count: number, dir: 1 | -1): SheetState {
+  const next = cloneSheet(sheet)
+  const nextMap = new Map<string, SheetCell>()
+  for (const [ref, cell] of next.cells) {
+    const r = shiftCellRef(ref, at, 0, dir * count, 0)
+    if (r) nextMap.set(r, cell)
+  }
+  next.cells = nextMap
+  return next
+}
+
+function applyCols(sheet: SheetState, at: number, count: number, dir: 1 | -1): SheetState {
+  const next = cloneSheet(sheet)
+  const nextMap = new Map<string, SheetCell>()
+  for (const [ref, cell] of next.cells) {
+    const c = shiftCellRef(ref, 0, at, 0, dir * count)
+    if (c) nextMap.set(c, cell)
+  }
+  next.cells = nextMap
+  next.cols = Math.max(next.cols + dir * count, 1)
+  return next
+}
+
+export function applySheetOp(wb: WorkbookState, op: SheetOp): WorkbookState {
+  const sheets = wb.sheets.map(cloneSheet)
+  switch (op.type) {
+    case 'cell-set':
+    case 'range-style': {
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = applyCellOp(sheets[op.sheet], op as Extract<SheetOp, { type: 'cell-set' | 'range-style' }>)
+      return { ...wb, sheets }
+    }
+    case 'insert-rows':
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = applyRows(sheets[op.sheet], op.at, op.count, 1)
+      return { ...wb, sheets }
+    case 'delete-rows':
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = applyRows(sheets[op.sheet], op.at, op.count, -1)
+      return { ...wb, sheets }
+    case 'insert-cols':
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = applyCols(sheets[op.sheet], op.at, op.count, 1)
+      return { ...wb, sheets }
+    case 'delete-cols':
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = applyCols(sheets[op.sheet], op.at, op.count, -1)
+      return { ...wb, sheets }
+    case 'sheet-add': {
+      const s: SheetState = { name: op.name, cols: 1, cells: new Map() }
+      return { ...wb, sheets: [...sheets, s], activeSheet: sheets.length }
+    }
+    case 'sheet-rename':
+      if (op.sheet >= sheets.length) return wb
+      sheets[op.sheet] = { ...sheets[op.sheet], name: op.name }
+      return { ...wb, sheets }
+    case 'sheet-delete': {
+      if (op.sheet >= sheets.length) return wb
+      const next = sheets.filter((_, i)=> i !== op.sheet)
+      if (next.length === 0) next.push({ name: 'Sheet1', cols: 1, cells: new Map() })
+      return { ...wb, sheets: next, activeSheet: Math.min(wb.activeSheet, next.length - 1) }
+    }
+    case 'sheet-move': {
+      if (op.sheet >= sheets.length || op.to >= sheets.length) return wb
+      const next = [...sheets]
+      const [s] = next.splice(op.sheet, 1)
+      next.splice(op.to, 0, s)
+      return { ...wb, sheets: next }
+    }
+    case 'sheet-active':
+      return op.sheet < sheets.length ? { ...wb, activeSheet: op.sheet } : wb
+  }
+}
+
+// ── pptx apply ──────────────────────────────────────────────────────────────
+
+function cloneShape(s: SlideShape): SlideShape {
+  return { ...s, props: s.props ? { ...s.props } : undefined }
+}
+
+export function applySlideOp(deck: DeckState, op: SlideOp): DeckState {
+  const slides = deck.slides.map((sl)=> ({ ...sl, shapes: sl.shapes.map(cloneShape) }))
+  switch (op.type) {
+    case 'slide-add': {
+      const s: SlideState = { shapes: [], layout: op.layout }
+      const at = op.at ?? slides.length
+      slides.splice(Math.min(at, slides.length), 0, s)
+      return { ...deck, slides, activeSlide: Math.min(at, slides.length - 1) }
+    }
+    case 'slide-delete': {
+      if (op.slide >= slides.length) return deck
+      slides.splice(op.slide, 1)
+      if (slides.length === 0) slides.push({ shapes: [] })
+      return { ...deck, slides, activeSlide: Math.min(deck.activeSlide, slides.length - 1) }
+    }
+    case 'slide-move': {
+      if (op.slide >= slides.length || op.to >= slides.length) return deck
+      const [s] = slides.splice(op.slide, 1)
+      slides.splice(op.to, 0, s)
+      return { ...deck, slides }
+    }
+    case 'slide-active':
+      return op.slide < slides.length ? { ...deck, activeSlide: op.slide } : deck
+    case 'shape-add': {
+      if (op.slide >= slides.length) return deck
+      const shapes = [...slides[op.slide].shapes, cloneShape(op.shape)]
+      slides[op.slide] = { ...slides[op.slide], shapes }
+      return { ...deck, slides }
+    }
+    case 'shape-remove': {
+      if (op.slide >= slides.length) return deck
+      const shapes = slides[op.slide].shapes.filter((s)=> s.id !== op.shapeId)
+      slides[op.slide] = { ...slides[op.slide], shapes }
+      return { ...deck, slides }
+    }
+    case 'shape-move': {
+      if (op.slide >= slides.length) return deck
+      const shapes = slides[op.slide].shapes.map((s)=>
+        s.id === op.shapeId ? { ...s, x: op.x, y: op.y } : s,
+      )
+      slides[op.slide] = { ...slides[op.slide], shapes }
+      return { ...deck, slides }
+    }
+    case 'shape-resize': {
+      if (op.slide >= slides.length) return deck
+      const shapes = slides[op.slide].shapes.map((s)=>
+        s.id === op.shapeId ? { ...s, w: op.w, h: op.h } : s,
+      )
+      slides[op.slide] = { ...slides[op.slide], shapes }
+      return { ...deck, slides }
+    }
+    case 'shape-set': {
+      if (op.slide >= slides.length) return deck
+      const shapes = slides[op.slide].shapes.map((s)=>
+        s.id === op.shapeId ? { ...s, props: { ...(s.props ?? {}), ...op.props } } : s,
+      )
+      slides[op.slide] = { ...slides[op.slide], shapes }
+      return { ...deck, slides }
+    }
+  }
+}
+
+// ── 统一折叠 ────────────────────────────────────────────────────────────────
+
+/** 单 op 应用（docx 委托 applyEdit——EditEvent 全量复用） */
+export function applyOfficeOp(snapshot: OfficeSnapshot, op: OfficeOp): OfficeSnapshot {
+  if (snapshot.docType === 'docx' && isEditEvent(op)) {
+    return { docType: 'docx', doc: applyEdit(snapshot.doc, op) }
+  }
+  if (snapshot.docType === 'xlsx' && isSheetOp(op)) {
+    return { docType: 'xlsx', workbook: applySheetOp(snapshot.workbook, op) }
+  }
+  if (snapshot.docType === 'pptx' && isSlideOp(op)) {
+    return { docType: 'pptx', deck: applySlideOp(snapshot.deck, op as SlideOp) }
+  }
+  // 类型不匹配（docx 收到 sheet op 等）——不可静默（CS-05）：原样返回 + 上层拒绝
+  return snapshot
+}
+
+function isEditEvent(op: OfficeOp): op is EditEvent {
+  const t = (op as { type: string }).type
+  return t === 'text-insert' || t === 'text-delete' || t === 'mark-apply' || t === 'mark-restore'
+    || t === 'block-set' || t === 'embed-insert' || t === 'embed-delete' || t === 'ai-apply'
+}
+
+function isSheetOp(op: OfficeOp): op is SheetOp {
+  const t = (op as { type: string }).type
+  return t === 'cell-set' || t === 'range-style' || t === 'insert-rows' || t === 'delete-rows'
+    || t === 'insert-cols' || t === 'delete-cols' || t === 'sheet-add' || t === 'sheet-rename'
+    || t === 'sheet-delete' || t === 'sheet-move' || t === 'sheet-active'
+}
+
+function isSlideOp(op: OfficeOp): op is SlideOp {
+  const t = (op as { type: string }).type
+  return t === 'slide-add' || t === 'slide-delete' || t === 'slide-move' || t === 'slide-active'
+    || t === 'shape-add' || t === 'shape-remove' || t === 'shape-move' || t === 'shape-resize'
+    || t === 'shape-set'
+}
+
+/** checkpoint 折叠：snapshot + apply tail 全部 op（不变量：结果 = 全部事件 fold） */
+export function foldOffice(cp: OfficeCheckpoint): OfficeSnapshot {
+  let s = cp.snapshot
+  for (const op of cp.tail) s = applyOfficeOp(s, op)
+  return s
+}
+
+/** 校验 op 是否属于 docType 命名空间（跨类型 op 拒绝——诚实裁剪） */
+export function opBelongsTo(op: OfficeOp, docType: DocType): boolean {
+  if (docType === 'docx') return isEditEvent(op)
+  if (docType === 'xlsx') return isSheetOp(op)
+  return isSlideOp(op)
+}