更新日志

本项目的所有重大变更将记录在此文件中。

[2026-03-26]

新增

• TOC：新增支持为目录（TOC）节点预览查找最近的可滚动父元素。

变更

• TOC：改进目录（TOC）中的标题组织方式，以提升性能和可读性。

[2026-03-25]

新增

• 缩进支持：向编辑器添加了 indent 和 outdent 命令，允许用户调整块缩进级别。目前此功能仅适用于类 Notion 模板。

[2026-02-19]

变更

• AI 菜单：为 <AiMenu> 添加了 anchorToSelection 属性，用于将菜单锚定到当前文本选区，且菜单宽度与编辑器宽度一致。

[2026-02-10]

修复

• 工具栏按钮：修正按钮显示逻辑，之前未设置 hideWhenUnavailable 时按钮错误隐藏。按钮现在默认始终显示，只有当 hideWhenUnavailable={true} 且所需扩展/模式不可用时才隐藏。
• 链接弹出框：在 setMark("link") 周围添加错误处理，避免在某些编辑器状态下抛出未捕获异常。
• 转换下拉菜单：新增缺失的 !editor.isEditable 条件，避免只读编辑器中显示该菜单。
• 标题节点：修复 margin-top 取消样式，确保正确应用于首个标题及其前方为 ProseMirror 小部件（如装饰、节点视图）的标题。
• 颜色高亮：将 toggleMark("highlight", { color }) 的调用改为正确的 toggleHighlight({ color })，实现正确切换行为。

变更

• CLI -c 参数的认证检查：使用 -c（组件）标志时，CLI 现在验证 .npmrc 身份认证，防止未认证用户发生静默失败。
• 自动生成 scss.d.ts：通过 CLI 安装包含 SCSS 文件的组件时，自动创建 SCSS 类型声明文件。
• 嵌套列表样式：新增最多 8 级嵌套列表样式循环：
  • 有序列表：decimal → lower-alpha → lower-roman → decimal → …
  • 无序列表：disc → circle → square → disc → …
• 颜色高亮的 useColorValue 属性：新增支持直接使用十六进制颜色值代替 CSS 变量，确保在不支持 CSS 自定义属性的环境下也能应用高亮样式。
• 标题下拉菜单：新增支持自定义 children 属性，允许用户覆盖默认的图标和箭头渲染。
• 内联图片：段落内图片现设为 inline-block 显示。

移除

• 评论页面示例：移除 /comments 和 /preview/templates/comments 路由及相关所有组件。

[2026-02-03]

• 更新 CLI 版本至 3.18.0，修复自定义路径下 -p 参数问题。

[2026-01-15]

修复

• 避免多选多个区块时执行“转换为”操作，确保节点切换仅应用于单个被选中的区块。
  请运行 pnpm dlx @tiptap/cli@latest add heading-button blockquote-button list-button text-button code-block-button -o 来更新现有代码。

[2026-01-09]

新增

• 带节点预览的目录（TOC）功能
• 更新 CLI 版本至 3.11.1

[2026-01-05]

新增

• 为 FloatingElement 添加 resetTextSelectionOnClose 属性，增加编辑器失焦时保留当前光标选区的选项

[2025-12-15]

修复

• 移除图片的 stopEvent，修复复制粘贴内联图片时的问题

[2025-12-04]

新增

• 退格键时合并相邻列表，防止垂直间距卡顿

---

说明

• 新增：新功能
• 变更：现有功能的变动
• 弃用：即将移除的功能
• 移除：已移除的功能
• 修复：错误修正
• 安全：安全修复与改进