@capyclaw/ppt-workbench 0.0.0-stage → 2.4.1

package/core/ops/import.js

@@ -0,0 +1,95 @@
+/**
+ * 浏览器专用 view op：把上传的 PPTX 交给编辑器内置的 PPTist 导入器。
+ *
+ * 为什么不在服务端解析：PPTist 的 importPPTXFile 依赖 DOM / FileReader /
+ * 字体与图片上下文，直接复用才能在“打开已有 pptx”时拿到和 UI 导入一致的
+ * 还原度。服务端只负责把文件传到 relay，由编辑器页面执行本 op。
+ *
+ * 协议：
+ *   { op: 'import-pptx', req, id, url, name, resultUrl? }
+ *   - url：relay 上的待导入文件地址（同源相对路径即可）
+ *   - resultUrl：导入完成后回传结果的地址
+ */
+
+export const importOps = {
+  'import-pptx': {
+    mutates: false,
+    view: true,
+    description: '导入 PPTX（仅编辑器页面执行）',
+    async run(P, c, ctx = {}) {
+      if (!P || typeof P.importFile !== 'function') {
+        throw new Error('当前编辑器不支持 PPTX 导入：PptApp.importFile 不可用')
+      }
+
+      const req = String(c.req || '')
+      const apiBase = String(ctx.apiBase || '').replace(/\/+$/, '')
+      const resultUrl = String(c.resultUrl || (apiBase ? `${apiBase}/import-result` : '/api/desktop/works/ppt-bridge/import-result'))
+      const doFetch = ctx.fetch || (typeof fetch === 'function' ? fetch : null)
+
+      const notify = async (body) => {
+        if (!doFetch) return
+        try {
+          await doFetch(resultUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ req, id: String(c.id || ''), ...body }),
+          })
+        } catch { /* 结果回传失败由 MCP 侧超时兜底 */ }
+      }
+
+      try {
+        if (!doFetch) throw new Error('当前环境不支持 fetch，无法读取待导入文件')
+        const base = ctx.baseUrl || (typeof location !== 'undefined' ? location.href : 'http://127.0.0.1/')
+        const sourceUrl = new URL(String(c.url || ''), base).href
+        const response = await doFetch(sourceUrl)
+        if (!response || !response.ok) {
+          throw new Error(`读取待导入文件失败：HTTP ${response ? response.status : 'no response'}`)
+        }
+
+        const blob = await response.blob()
+        const FileCtor = ctx.File || (typeof File !== 'undefined' ? File : null)
+        if (!FileCtor) throw new Error('当前环境不支持 File 构造器，无法导入 PPTX')
+
+        const name = String(c.name || 'import.pptx')
+        const file = new FileCtor([blob], name, {
+          type: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        })
+
+        /* PPTist 的 importPPTXFile 默认是“追加/空 deck 才替换”。工具语义是
+         * “打开 pptx”，所以 replace 模式先记住旧页，导入后把它们删掉；
+         * append 模式保留旧页（多文件拼接场景）。 */
+        const mode = c.mode === 'append' ? 'append' : 'replace'
+        const beforeSlides = typeof P.getSlides === 'function' ? (P.getSlides() || []) : []
+        const previousIds = mode === 'replace'
+          ? beforeSlides.map((slide) => slide.id).filter(Boolean)
+          : []
+
+        const imported = await P.importFile(file)
+        for (const id of previousIds) {
+          try { P.removeSlide(id) } catch { /* 单页 deck 不允许删空；忽略 */ }
+        }
+
+        const finalCount = typeof P.getSlides === 'function' ? (P.getSlides() || []).length : imported?.slideCount
+        const rawCount = Number(imported?.slideCount || 0)
+        const contributed = mode === 'append'
+          ? Math.max(0, Number(finalCount || 0) - beforeSlides.length)
+          : Number(finalCount || rawCount || 0)
+        const summary = {
+          ...(imported && typeof imported === 'object' ? imported : {}),
+          slideCount: Number(finalCount || rawCount || 0),
+          import: {
+            mode,
+            before: beforeSlides.length,
+            imported: contributed,
+            final: Number(finalCount || 0),
+          },
+        }
+        await notify({ ok: true, summary })
+        return summary
+      } catch (error) {
+        await notify({ ok: false, error: String((error && error.message) || error) })
+        throw error
+      }
+    },
+  },
+}

package/core/ops/index.js

@@ -0,0 +1,39 @@
+/** op 组装：按域合并为一张表，交给通用 op registry 分发。 */
+import { createOpDispatcher, createOpRegistry } from '@capyclaw/document-workbench/ops'
+import { deckOps } from './deck.js'
+import { textOps } from './text.js'
+import { elementOps } from './element.js'
+import { slideOps } from './slide.js'
+import { recolorOps } from './recolor.js'
+import { viewOps } from './view.js'
+import { historyOps } from './history.js'
+import { playbackOps } from './playback.js'
+import { chartOps } from './chart.js'
+import { tableOps } from './table.js'
+import { importOps } from './import.js'
+
+export const OP_MODULES = {
+  deck: deckOps,
+  text: textOps,
+  element: elementOps,
+  slide: slideOps,
+  recolor: recolorOps,
+  view: viewOps,
+  history: historyOps,
+  playback: playbackOps,
+  chart: chartOps,
+  table: tableOps,
+  importer: importOps,
+}
+
+export const registry = createOpRegistry({
+  modules: OP_MODULES,
+  snapshot: (P) => P.snapshot?.(),
+})
+
+export const OP_DEFINITIONS = registry.definitions
+export const OP_NAMES = registry.names
+export const VIEW_OP_NAMES = registry.viewNames
+export const applyOp = registry.apply
+
+export { createOpDispatcher }

package/core/ops/playback.js

@@ -0,0 +1,9 @@
+/** 节奏 op：sleep（不改 deck）。 */
+export const playbackOps = {
+  sleep: {
+    mutates: false,
+    run(P, c) {
+      return new Promise(r => setTimeout(r, Math.min(3000, Math.max(0, Number(c.ms) || 600))))
+    },
+  },
+}

package/core/ops/recolor.js

@@ -0,0 +1,33 @@
+/** 整体换色 op：背景 + 全部文字对比色 + 装饰形状，一次完成。 */
+import { textHolder } from '../text.js'
+import { contrastColor } from '../color.js'
+
+const clone = (P, i) => JSON.parse(JSON.stringify(P.getSlides()[i]))
+
+export const recolorOps = {
+  recolor: {
+    run(P, c) {
+      const bg = String(c.background || '#ffffff')
+      const fg = c.text ? String(c.text) : contrastColor(bg)
+      const shapeFill = c.shapes === null ? null
+        : String(c.shapes != null && c.shapes !== true ? c.shapes : fg)
+      const n = P.getSlides().length
+      for (let i = 0; i < n; i++) {
+        if (Array.isArray(c.indices) && c.indices.indexOf(i) < 0) continue
+        const s = clone(P, i)
+        s.background = { type: 'solid', color: bg }
+        ;(s.elements || []).forEach(el => {
+          const holder = textHolder(el)
+          if (holder) {
+            el.defaultColor = fg
+            if (typeof holder.content === 'string') {
+              holder.content = holder.content.replace(/color:\s*[^;"']+/g, 'color: ' + fg)
+            }
+          }
+          if (el.type !== 'text' && shapeFill && el.fill != null) el.fill = shapeFill
+        })
+        P.updateSlide(i, s)
+      }
+    },
+  },
+}

package/core/ops/slide.js

@@ -0,0 +1,66 @@
+/** 页面 op：背景、增删改移复制、选中。 */
+import { contrast } from '../text.js'
+
+const idx = (c) => (c.id != null ? c.id : c.index)
+const clone = (P, i) => JSON.parse(JSON.stringify(P.getSlides()[i]))
+
+export const slideOps = {
+  'set-background': {
+    run(P, c) {
+      const idxs = Array.isArray(c.indices) ? c.indices : null
+      const n = P.getSlides().length
+      for (let i = 0; i < n; i++) {
+        if (idxs && idxs.indexOf(i) < 0) continue
+        const s = clone(P, i)
+        s.background = { type: 'solid', color: String(c.color || '#ffffff') }
+        if (c.contrast) contrast(s, String(c.color || '#ffffff'))
+        P.updateSlide(i, s)
+      }
+    },
+  },
+
+  'add-slide': {
+    run(P, c) { P.addSlide(c.slide || {}, c.index) },
+  },
+
+  'update-slide': {
+    run(P, c) {
+      if (!P.updateSlide(idx(c), c.slide)) throw new Error('update-slide 未命中')
+    },
+  },
+
+  'remove-slide': {
+    run(P, c) {
+      if (!P.removeSlide(idx(c))) throw new Error('remove-slide 未命中')
+    },
+  },
+
+  'move-slide': {
+    run(P, c) {
+      if (!P.moveSlide(c.from, c.to)) throw new Error('move-slide 越界')
+    },
+  },
+
+  'duplicate-slide': {
+    run(P, c) {
+      if (!P.duplicateSlide(idx(c))) throw new Error('duplicate-slide 未命中')
+    },
+  },
+
+  select: {
+    mutates: false,
+    view: true,
+    run(P, c) {
+      if (!P.selectSlide(idx(c))) throw new Error('select 未命中')
+    },
+  },
+
+  'set-notes': {
+    run(P, c) {
+      const i = Number(c.slide != null ? c.slide : idx(c))
+      const s = clone(P, i)
+      s.notes = String(c.notes == null ? '' : c.notes)
+      P.updateSlide(i, s)
+    },
+  },
+}

package/core/ops/table.js

@@ -0,0 +1,85 @@
+/** 表格 op：加表格 / 更新表格样式 / 精修单元格。数据归一化在 core/table.js。 */
+import { makeTableElement, normalizeCellPatches, DEFAULT_TABLE_COLOR } from '../table.js'
+
+function clone(P, i) {
+  const slide = P.getSlides()[i]
+  if (!slide) {
+    const total = P.getSlides().length
+    throw new Error(`页号越界：第 ${i} 页不存在（共 ${total} 页）`)
+  }
+  return JSON.parse(JSON.stringify(slide))
+}
+
+export const tableOps = {
+  'add-table': {
+    run(P, c) {
+      const i = Number(c.slide != null ? c.slide : 0)
+      const s = clone(P, i)
+      const el = makeTableElement(c.element || {})
+      s.elements.push(el)
+      P.updateSlide(i, s)
+      return el.id
+    },
+  },
+
+  'update-table': {
+    run(P, c) {
+      const i = Number(c.slide != null ? c.slide : 0)
+      const s = clone(P, i)
+      const el = s.elements.find(e => e.id === c.elementId)
+      if (!el) throw new Error('update-table 未命中: ' + c.elementId)
+      if (el.type !== 'table') throw new Error(`元素 ${c.elementId} 不是表格（type=${el.type}）`)
+      const p = c.props || {}
+      if (p.themeColor != null) el.theme = { ...el.theme, color: String(p.themeColor) }
+      if (p.rowHeader != null) el.theme.rowHeader = Boolean(p.rowHeader)
+      if (p.colHeader != null) el.theme.colHeader = Boolean(p.colHeader)
+      if (p.outline && typeof p.outline === 'object') {
+        el.outline = {
+          style: String(p.outline.style || el.outline.style || 'solid'),
+          width: Number(p.outline.width != null ? p.outline.width : el.outline.width),
+          color: String(p.outline.color || el.outline.color || '#d9d9d9'),
+        }
+      }
+      if (Array.isArray(p.colWidths)) {
+        const sum = p.colWidths.reduce((a, b) => a + Number(b || 0), 0)
+        if (!isFinite(sum) || sum <= 0) throw new Error('colWidths 无效')
+        el.colWidths = p.colWidths.map((n) => Number(n) / sum)
+      }
+      if (Array.isArray(p.rowHeights)) {
+        if (p.rowHeights.length !== el.data.length) throw new Error('rowHeights 长度与行数不一致')
+        el.rowHeights = p.rowHeights.map(Number)
+      }
+      if (p.cellMinHeight != null) el.cellMinHeight = Number(p.cellMinHeight)
+      for (const k of ['left', 'top', 'width', 'height', 'rotate']) {
+        if (p[k] != null && isFinite(Number(p[k]))) el[k] = Number(p[k])
+      }
+      P.updateSlide(i, s)
+    },
+  },
+
+  'set-table-cells': {
+    run(P, c) {
+      const i = Number(c.slide != null ? c.slide : 0)
+      const s = clone(P, i)
+      const el = s.elements.find(e => e.id === c.elementId)
+      if (!el) throw new Error('set-table-cells 未命中: ' + c.elementId)
+      if (el.type !== 'table') throw new Error(`元素 ${c.elementId} 不是表格（type=${el.type}）`)
+      const patches = normalizeCellPatches(c.cells || [])
+      for (const p of patches) {
+        const row = el.data[p.row]
+        if (!row) throw new Error(`行越界：第 ${p.row} 行不存在（共 ${el.data.length} 行）`)
+        const cell = row[p.col]
+        if (!cell) throw new Error(`列越界：第 ${p.col} 列不存在（共 ${row.length} 列）`)
+        if (p.text != null) cell.text = p.text
+        if (p.style) {
+          cell.style = { ...(cell.style || {}), ...p.style }
+          if (Object.keys(cell.style).length === 0) delete cell.style
+        }
+      }
+      if (c.themeColor != null && c.themeColor !== '') {
+        el.theme = { ...el.theme, color: String(c.themeColor || DEFAULT_TABLE_COLOR) }
+      }
+      P.updateSlide(i, s)
+    },
+  },
+}

package/core/ops/text.js

@@ -0,0 +1,35 @@
+/** 文本 op：按页/元素改文本，文字槽位填充。 */
+import { patchElement, textHolder } from '../text.js'
+
+const idx = (c) => (c.id != null ? c.id : c.index)
+const clone = (P, i) => JSON.parse(JSON.stringify(P.getSlides()[i]))
+
+export const textOps = {
+  'set-text': {
+    run(P, c) {
+      const i = idx(c)
+      const s = clone(P, i)
+      const el = s.elements.find(e => (c.elementId && e.id === c.elementId) ||
+        (!c.elementId && e.type === 'text'))
+        || (!c.elementId && s.elements.find(e => textHolder(e)))
+      if (!el) throw new Error('set-text 未命中: ' + (c.elementId || '首个文本'))
+      patchElement(el, c)
+      P.updateSlide(i, s)
+    },
+  },
+
+  'fill-slot': {
+    run(P, c) {
+      const i = Number(c.slide) | 0
+      const s = clone(P, i)
+      const texts = (s.elements || []).filter(e => textHolder(e))
+      const el = texts[Number(c.slot) | 0]
+      if (!el) throw new Error('文本槽位不存在: ' + c.slot)
+      patchElement(el, {
+        text: c.text, html: c.html,
+        fontSize: c.fontSize, color: c.color, bold: c.bold, align: c.align,
+      })
+      P.updateSlide(i, s)
+    },
+  },
+}

package/core/ops/view.js

@@ -0,0 +1,13 @@
+/** 视图 op：放映控制（不改 deck，不产生 undo 快照）。 */
+export const viewOps = {
+  present: {
+    mutates: false,
+    view: true,
+    run(P, c) { return P.present(c.index != null ? c.index : undefined) },
+  },
+  'exit-present': {
+    mutates: false,
+    view: true,
+    run(P) { return P.exitPresent() },
+  },
+}

package/core/ops.js

@@ -0,0 +1,12 @@
+/**
+ * 兼容 facade：op 分发已按域拆到 core/ops/*。
+ * 外部（editor / keystudio / relay / tests）继续 import { applyOp }。
+ */
+export {
+  applyOp,
+  createOpDispatcher,
+  OP_DEFINITIONS,
+  OP_MODULES,
+  OP_NAMES,
+  VIEW_OP_NAMES,
+} from './ops/index.js'

package/core/quick.js

@@ -0,0 +1,52 @@
+/**
+ * 本地快捷指令（不经模型，<100ms）：中文颜色名 / 第N页改字 / 加一页。
+ * 纯函数，返回底层 op 数组；解析失败返回 null。
+ */
+import { escapeHtml } from './text.js'
+import { COLORS } from './color.js'
+
+export { COLORS, resolveColor } from './color.js'
+
+export function simpleSlide(title) {
+  const ts = Date.now()
+  return {
+    id: 'quick_' + ts,
+    background: { type: 'solid', color: '#ffffff' },
+    elements: [{
+      type: 'text', id: 'quick_t_' + ts,
+      left: 60, top: 50, width: 880, height: 76,
+      content: '<p style="font-size: 34px;"><strong>' + escapeHtml(title) + '</strong></p>',
+      defaultColor: '#333333', defaultFontName: '', fixedRatio: false, rotate: 0,
+    }],
+  }
+}
+
+export function parseQuick(text) {
+  const t = String(text || '').trim()
+  if (!t) return null
+  const cn = { 一: 1, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7, 八: 8, 九: 9, 十: 10 }
+  const pageMatch = /第\s*([0-9]+|[一二三四五六七八九十])\s*页/.exec(t)
+  const page = pageMatch ? (cn[pageMatch[1]] || parseInt(pageMatch[1], 10)) - 1 : null
+  const setText = /第\s*(?:[0-9]+|[一二三四五六七八九十])\s*页.*?(?:标题|文字|文本|内容).*?(?:改成|换成|改为|设为)\s*(.+)$/.exec(t)
+  if (setText) return [{ op: 'set-text', id: page, text: setText[1].trim() }]
+  const add = /(?:加|新增|添加)一页\s*(.*)$/.exec(t)
+  if (add) return [{ op: 'add-slide', slide: simpleSlide(add[1].trim() || '新一页') }]
+  if (/背景/.test(t)) {
+    let hex = null
+    let best = null
+    for (const k of Object.keys(COLORS)) {
+      const idx = t.indexOf(k)
+      if (idx < 0) continue
+      if (!best || k.length > best.k.length || (k.length === best.k.length && idx < best.idx)) best = { k, idx }
+    }
+    if (best) hex = COLORS[best.k]
+    const hexMatch = /#([0-9a-f]{3}|[0-9a-f]{6})/i.exec(t)
+    if (hexMatch) hex = hexMatch[0]
+    if (hex) {
+      const cmd = { op: 'set-background', color: hex, contrast: true }
+      if (page != null) cmd.indices = [page]
+      return [cmd]
+    }
+  }
+  return null
+}

package/core/shape-library.js

@@ -0,0 +1,122 @@
+/**
+ * 形状库：常用 SVG 形状的 path 生成（viewBox 200×200 空间，编辑器按元素宽高缩放）。
+ * 零 DOM，node:test 直测；ppt_shape 工具的数据源。
+ */
+
+/** 正 n 边形顶点（外接圆半径 R，中心 100,100，顶点朝上）。 */
+function polygon(n, rot = -90) {
+  const pts = []
+  for (let i = 0; i < n; i++) {
+    const a = ((rot + (360 / n) * i) * Math.PI) / 180
+    pts.push([100 + 100 * Math.cos(a), 100 + 100 * Math.sin(a)])
+  }
+  return pts
+}
+
+/** 顶点数组 → path（闭合）。 */
+const toPath = (pts) => 'M ' + pts.map(([x, y]) => `${x.toFixed(1)} ${y.toFixed(1)}`).join(' L ') + ' Z'
+
+/** 五角星（外径 100，内径 40）。 */
+function star5() {
+  const pts = []
+  for (let i = 0; i < 10; i++) {
+    const r = i % 2 === 0 ? 100 : 42
+    const a = ((-90 + 36 * i) * Math.PI) / 180
+    pts.push([100 + r * Math.cos(a), 100 + r * Math.sin(a)])
+  }
+  return toPath(pts)
+}
+
+/** 圆角矩形 path（顺时针，四角四段圆弧）。 */
+function roundRect(radius = 32) {
+  const r = Math.min(radius, 100)
+  return `M 0 ${r} ` +
+    `A ${r} ${r} 0 0 1 ${r} 0 L ${200 - r} 0 A ${r} ${r} 0 0 1 200 ${r} ` +
+    `L 200 ${200 - r} A ${r} ${r} 0 0 1 ${200 - r} 200 L ${r} 200 ` +
+    `A ${r} ${r} 0 0 1 0 ${200 - r} Z`
+}
+
+/** 水平箭头 path（指向 dx 方向：1 右 / -1 左）。 */
+function arrowH(dx) {
+  const pts = dx > 0
+    ? [[0, 75], [125, 75], [125, 40], [200, 100], [125, 160], [125, 125], [0, 125]]
+    : [[200, 75], [75, 75], [75, 40], [0, 100], [75, 160], [75, 125], [200, 125]]
+  return toPath(pts)
+}
+
+/** 垂直箭头 path（指向 dy 方向：1 下 / -1 上）。 */
+function arrowV(dy) {
+  const pts = dy > 0
+    ? [[75, 0], [75, 125], [40, 125], [100, 200], [160, 125], [125, 125], [125, 0]]
+    : [[75, 200], [75, 75], [40, 75], [100, 0], [160, 75], [125, 75], [125, 200]]
+  return toPath(pts)
+}
+
+/** 双向水平箭头。 */
+const doubleArrow = toPath([[0, 100], [50, 55], [50, 80], [150, 80], [150, 55], [200, 100], [150, 145], [150, 120], [50, 120], [50, 145]])
+
+/** 对话气泡（圆角矩形 + 左下尾巴）。 */
+const bubble = 'M 24 12 L 176 12 A 20 20 0 0 1 196 32 L 196 120 A 20 20 0 0 1 176 140 L 88 140 L 44 184 L 52 140 L 24 140 A 20 20 0 0 1 4 120 L 4 32 A 20 20 0 0 1 24 12 Z'
+
+/** 爱心。 */
+const heart = 'M 100 178 C 32 128 8 92 8 60 C 8 30 32 12 56 12 C 76 12 92 24 100 40 C 108 24 124 12 144 12 C 168 12 192 30 192 60 C 192 92 168 128 100 178 Z'
+
+/** 云朵。 */
+const cloud = 'M 56 160 A 44 44 0 0 1 56 72 A 52 52 0 0 1 152 60 A 46 46 0 0 1 152 160 Z'
+
+/** 闪电。 */
+const bolt = 'M 112 4 L 40 112 L 92 112 L 76 196 L 160 80 L 104 80 Z'
+
+/** 十字。 */
+const cross = 'M 70 8 L 130 8 L 130 70 L 192 70 L 192 130 L 130 130 L 130 192 L 70 192 L 70 130 L 8 130 L 8 70 L 70 70 Z'
+
+/** 三角函数圆弧（四分之一圆 path）。 */
+const quarter = (cx, cy, sx, sy, ex, ey) => `M ${sx} ${sy} A 100 100 0 0 1 ${ex} ${ey} L ${cx} ${cy} Z`
+
+/** 圆柱（数据库/桶形）。 */
+const cylinder = 'M 20 40 A 80 26 0 0 1 180 40 L 180 160 A 80 26 0 0 1 20 160 Z'
+
+/**
+ * 形状库：key → { name, path }（viewBox 统一 0 0 200 200）。
+ */
+export const SHAPE_LIBRARY = {
+  rect: { name: '矩形', path: 'M 0 0 L 200 0 L 200 200 L 0 200 Z' },
+  'round-rect': { name: '圆角矩形', path: roundRect(32) },
+  circle: { name: '圆形', path: 'M 0 100 A 100 100 0 1 1 200 100 A 100 100 0 1 1 0 100 Z' },
+  triangle: { name: '三角形', path: toPath(polygon(3)) },
+  'triangle-down': { name: '倒三角', path: toPath(polygon(3, 90)) },
+  diamond: { name: '菱形', path: toPath([[100, 0], [200, 100], [100, 200], [0, 100]]) },
+  pentagon: { name: '五边形', path: toPath(polygon(5)) },
+  hexagon: { name: '六边形', path: toPath(polygon(6, 0)) },
+  'star-5': { name: '五角星', path: star5() },
+  'arrow-right': { name: '右箭头', path: arrowH(1) },
+  'arrow-left': { name: '左箭头', path: arrowH(-1) },
+  'arrow-up': { name: '上箭头', path: arrowV(-1) },
+  'arrow-down': { name: '下箭头', path: arrowV(1) },
+  'double-arrow': { name: '双向箭头', path: doubleArrow },
+  bubble: { name: '气泡', path: bubble },
+  heart: { name: '爱心', path: heart },
+  cloud: { name: '云朵', path: cloud },
+  bolt: { name: '闪电', path: bolt },
+  cross: { name: '十字', path: cross },
+  'pie-quarter': { name: '扇形', path: quarter(100, 100, 100, 0, 200, 100) },
+  cylinder: { name: '圆柱', path: cylinder },
+  'round-frame': {
+    name: '圆角边框',
+    path: 'M 24 4 L 176 4 A 20 20 0 0 1 196 24 L 196 176 A 20 20 0 0 1 176 196 L 24 196 A 20 20 0 0 1 4 176 L 4 24 A 20 20 0 0 1 24 4 Z M 24 20 A 4 4 0 0 0 20 24 L 20 176 A 4 4 0 0 0 24 180 L 176 180 A 4 4 0 0 0 180 176 L 180 24 A 4 4 0 0 0 176 20 Z',
+  },
+}
+
+export const SHAPE_KEYS = Object.keys(SHAPE_LIBRARY)
+
+/**
+ * 取形状定义。
+ * @param {string} key SHAPE_KEYS 之一
+ */
+export function getShape(key) {
+  const s = SHAPE_LIBRARY[String(key || '')]
+  if (!s) {
+    throw new Error(`未知形状: ${key}（可用: ${SHAPE_KEYS.join(', ')}）`)
+  }
+  return { viewBox: [200, 200], ...s }
+}