refactor: 重构链接属性配置类型和工具栏选项

[RSS1102]

Cherry Markdown 类型定义修复日志

本次修改总结

1. 类型定义修复 (cherry.d.ts)

修改项	说明	风险
enableShortLink 注释	默认:true → 默认:false（与实际默认值一致）	⚪ 无风险
loaing 拼写错误	→ loading	⚪ 无风险
CherryFileUploadMultiHandler	callback 参数从 (url, params) 改为 (results: Array<{url, params}>)	🔴 破坏性
FormulaMenu 导入	移除无效的 @/ 别名导入，改为本地定义接口	⚪ 无风险
toolbarRight/hiddenToolbar/sidebar/bubble/float	any[] → 精确类型定义	🟡 可能影响现有 TS 项目
showToolbar 注释	补充说明会同时隐藏侧边栏	⚪ 无风险

2. 新增 API (registerHeadlessToolbars)

修改项	说明	风险
hiddenToolbar	标记为 @deprecated	🟡 需通知用户迁移
registerHeadlessToolbars	新增替代 API	⚪ 无风险
实现逻辑	registerHeadlessToolbars 优先于 hiddenToolbar	⚪ 向后兼容

3. 注释修复 (Cherry.config.js)

修改项	说明	风险
showToolbar 注释	补充"和侧边栏"	⚪ 无风险

---

🔴 高风险改动

CherryFileUploadMultiHandler 类型变更

之前（错误的类型）：

callback: (url: string, params?: {...}) => void

现在（正确的类型）：

callback: (results: Array<{ url: string; params?: {...} }>) => void

影响：如果用户的 TypeScript 项目使用了 fileUploadMulti 回调，类型检查可能会报错。但这是修复，之前的类型定义本身就是错误的，与实际运行时行为不符。

---

🟡 中等风险改动

1. any[] → 精确类型

如果用户之前传入了不在 CherryDefaultToolbar 联合类型中的自定义字符串，现在会报类型错误。需要使用 customMenu 配合泛型参数来声明自定义菜单。

2. hiddenToolbar 废弃

现有使用 hiddenToolbar 的代码仍然可以正常工作（向后兼容），但 IDE 会显示废弃警告，建议迁移到 registerHeadlessToolbars。

---

修改的文件列表

• packages/cherry-markdown/types/cherry.d.ts
• packages/cherry-markdown/types/previewer.d.ts
• packages/cherry-markdown/src/Cherry.js
• packages/cherry-markdown/src/Cherry.config.js

[changeset-bot]

🦋 Changeset detected

Latest commit: a7ebf72

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
cherry-markdown	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

pnpm add https://pkg.pr.new/cherry-markdown@1592

npm i https://pkg.pr.new/cherry-markdown@1592

yarn add https://pkg.pr.new/cherry-markdown@1592.tgz

commit: a7ebf72

[cherry-markdown-bot]

【预览链接】

• 完整版
• 基础
• 移动端
• 多实例
• 无工具栏
• 纯预览模式
• XSS 测试（默认禁用，需配置后允许）
• 图片编辑
• 表格编辑
• 自动编号标题
• 流式输入模式（AI chat 场景）
• VIM 编辑模式
• 使用自带或自定义的 Mermaid.js
• 自定义代码块外层容器

[github-actions]

Size Change: +3.4 kB (+0.05%)

Total Size: 6.59 MB

Filename	Size	Change
./packages/cherry-markdown/dist/cherry-markdown.core.common.js	479 kB	+355 B (+0.07%)
./packages/cherry-markdown/dist/cherry-markdown.core.js	480 kB	+349 B (+0.07%)
./packages/cherry-markdown/dist/cherry-markdown.engine.core.common.js	180 kB	+480 B (+0.27%)
./packages/cherry-markdown/dist/cherry-markdown.engine.core.esm.js	180 kB	+471 B (+0.26%)
./packages/cherry-markdown/dist/cherry-markdown.engine.core.js	181 kB	+469 B (+0.26%)
./packages/cherry-markdown/dist/cherry-markdown.esm.js	1.32 MB	+339 B (+0.03%)
./packages/cherry-markdown/dist/cherry-markdown.js	2.07 MB	+523 B (+0.03%)
./packages/cherry-markdown/dist/cherry-markdown.min.js	1.32 MB	+360 B (+0.03%)
./packages/cherry-markdown/dist/types/Event.d.ts	588 B	+57 B (+10.73%)	⚠️

ℹ️ View Unchanged

Filename	Size
./packages/cherry-markdown/dist/addons/advance/cherry-table-echarts-plugin.js	49.6 kB
./packages/cherry-markdown/dist/addons/advance/cherry-tapd-checklist-plugin.js	21.8 kB
./packages/cherry-markdown/dist/addons/advance/cherry-tapd-html-tag-plugin.js	21.8 kB
./packages/cherry-markdown/dist/addons/advance/cherry-tapd-table-plugin.js	24.8 kB
./packages/cherry-markdown/dist/addons/cherry-code-block-mermaid-plugin.js	23.2 kB
./packages/cherry-markdown/dist/addons/cherry-code-block-plantuml-plugin.js	24.8 kB
./packages/cherry-markdown/dist/cherry-markdown.core.common.d.ts	106 B
./packages/cherry-markdown/dist/cherry-markdown.core.d.ts	106 B
./packages/cherry-markdown/dist/cherry-markdown.css	36.7 kB
./packages/cherry-markdown/dist/cherry-markdown.d.ts	101 B
./packages/cherry-markdown/dist/cherry-markdown.engine.core.common.d.ts	116 B
./packages/cherry-markdown/dist/cherry-markdown.engine.core.d.ts	116 B
./packages/cherry-markdown/dist/cherry-markdown.engine.core.esm.d.ts	116 B
./packages/cherry-markdown/dist/cherry-markdown.esm.d.ts	101 B
./packages/cherry-markdown/dist/cherry-markdown.markdown.css	20.3 kB
./packages/cherry-markdown/dist/cherry-markdown.markdown.min.css	13.9 kB
./packages/cherry-markdown/dist/cherry-markdown.min.css	28.4 kB
./packages/cherry-markdown/dist/cherry-markdown.min.d.ts	101 B
./packages/cherry-markdown/dist/types/addons/advance/cherry-table-echarts-plugin.d.ts	1.73 kB
./packages/cherry-markdown/dist/types/addons/advance/cherry-tapd-checklist-plugin.d.ts	323 B
./packages/cherry-markdown/dist/types/addons/advance/cherry-tapd-html-tag-plugin.d.ts	494 B
./packages/cherry-markdown/dist/types/addons/advance/cherry-tapd-table-plugin.d.ts	1.15 kB
./packages/cherry-markdown/dist/types/addons/cherry-code-block-mermaid-plugin.d.ts	1.37 kB
./packages/cherry-markdown/dist/types/addons/cherry-code-block-plantuml-plugin.d.ts	160 B
./packages/cherry-markdown/dist/types/Cherry.config.d.ts	117 B
./packages/cherry-markdown/dist/types/Cherry.d.ts	4.42 kB
./packages/cherry-markdown/dist/types/CherryStatic.d.ts	509 B
./packages/cherry-markdown/dist/types/core/HookCenter.d.ts	818 B
./packages/cherry-markdown/dist/types/core/hooks/AiFlowAutoClose.d.ts	370 B
./packages/cherry-markdown/dist/types/core/hooks/AutoLink.d.ts	948 B
./packages/cherry-markdown/dist/types/core/hooks/BackgroundColor.d.ts	189 B
./packages/cherry-markdown/dist/types/core/hooks/Blockquote.d.ts	195 B
./packages/cherry-markdown/dist/types/core/hooks/Br.d.ts	193 B
./packages/cherry-markdown/dist/types/core/hooks/CodeBlock.d.ts	1.31 kB
./packages/cherry-markdown/dist/types/core/hooks/Color.d.ts	183 B
./packages/cherry-markdown/dist/types/core/hooks/CommentReference.d.ts	665 B
./packages/cherry-markdown/dist/types/core/hooks/Detail.d.ts	328 B
./packages/cherry-markdown/dist/types/core/hooks/Emoji.config.d.ts	9.31 kB
./packages/cherry-markdown/dist/types/core/hooks/Emoji.d.ts	9.36 kB
./packages/cherry-markdown/dist/types/core/hooks/Emphasis.d.ts	263 B
./packages/cherry-markdown/dist/types/core/hooks/Footnote.d.ts	307 B
./packages/cherry-markdown/dist/types/core/hooks/FrontMatter.d.ts	192 B
./packages/cherry-markdown/dist/types/core/hooks/Header.d.ts	605 B
./packages/cherry-markdown/dist/types/core/hooks/HighLight.d.ts	158 B
./packages/cherry-markdown/dist/types/core/hooks/Hr.d.ts	223 B
./packages/cherry-markdown/dist/types/core/hooks/HtmlBlock.d.ts	313 B
./packages/cherry-markdown/dist/types/core/hooks/Image.d.ts	325 B
./packages/cherry-markdown/dist/types/core/hooks/InlineCode.d.ts	181 B
./packages/cherry-markdown/dist/types/core/hooks/InlineMath.d.ts	487 B
./packages/cherry-markdown/dist/types/core/hooks/Link.d.ts	583 B
./packages/cherry-markdown/dist/types/core/hooks/List.d.ts	347 B
./packages/cherry-markdown/dist/types/core/hooks/MathBlock.d.ts	451 B
./packages/cherry-markdown/dist/types/core/hooks/Panel.d.ts	435 B
./packages/cherry-markdown/dist/types/core/hooks/Paragraph.d.ts	664 B
./packages/cherry-markdown/dist/types/core/hooks/Ruby.d.ts	154 B
./packages/cherry-markdown/dist/types/core/hooks/Size.d.ts	177 B
./packages/cherry-markdown/dist/types/core/hooks/Space.d.ts	199 B
./packages/cherry-markdown/dist/types/core/hooks/Strikethrough.d.ts	235 B
./packages/cherry-markdown/dist/types/core/hooks/Sub.d.ts	180 B
./packages/cherry-markdown/dist/types/core/hooks/Suggester.d.ts	1.72 kB
./packages/cherry-markdown/dist/types/core/hooks/SuggestList.d.ts	158 B
./packages/cherry-markdown/dist/types/core/hooks/Sup.d.ts	180 B
./packages/cherry-markdown/dist/types/core/hooks/Table.d.ts	554 B
./packages/cherry-markdown/dist/types/core/hooks/Toc.d.ts	974 B
./packages/cherry-markdown/dist/types/core/hooks/Transfer.d.ts	176 B
./packages/cherry-markdown/dist/types/core/hooks/Underline.d.ts	157 B
./packages/cherry-markdown/dist/types/core/HooksConfig.d.ts	524 B
./packages/cherry-markdown/dist/types/core/ParagraphBase.d.ts	1.18 kB
./packages/cherry-markdown/dist/types/core/SyntaxBase.d.ts	951 B
./packages/cherry-markdown/dist/types/Editor.d.ts	1.49 kB
./packages/cherry-markdown/dist/types/Engine.d.ts	1.45 kB
./packages/cherry-markdown/dist/types/Factory.d.ts	972 B
./packages/cherry-markdown/dist/types/index.core.d.ts	122 B
./packages/cherry-markdown/dist/types/index.d.ts	76 B
./packages/cherry-markdown/dist/types/index.engine.core.d.ts	373 B
./packages/cherry-markdown/dist/types/index.engine.d.ts	87 B
./packages/cherry-markdown/dist/types/libs/rawdeflate.d.ts	87 B
./packages/cherry-markdown/dist/types/locales/en_US.d.ts	1.05 kB
./packages/cherry-markdown/dist/types/locales/index.d.ts	141 B
./packages/cherry-markdown/dist/types/locales/ru_RU.d.ts	1.05 kB
./packages/cherry-markdown/dist/types/locales/zh_CN.d.ts	1.06 kB
./packages/cherry-markdown/dist/types/Logger.d.ts	441 B
./packages/cherry-markdown/dist/types/Previewer.d.ts	2.15 kB
./packages/cherry-markdown/dist/types/Sanitizer.d.ts	85 B
./packages/cherry-markdown/dist/types/toolbars/Bubble.d.ts	657 B
./packages/cherry-markdown/dist/types/toolbars/BubbleFormula.d.ts	1.38 kB
./packages/cherry-markdown/dist/types/toolbars/BubbleTable.d.ts	329 B
./packages/cherry-markdown/dist/types/toolbars/FloatMenu.d.ts	577 B
./packages/cherry-markdown/dist/types/toolbars/HiddenToolbar.d.ts	226 B
./packages/cherry-markdown/dist/types/toolbars/HookCenter.d.ts	505 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Align.d.ts	191 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Audio.d.ts	322 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Bold.d.ts	455 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Br.d.ts	318 B
./packages/cherry-markdown/dist/types/toolbars/hooks/ChangeLocale.d.ts	252 B
./packages/cherry-markdown/dist/types/toolbars/hooks/CheckList.d.ts	353 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Code.d.ts	398 B
./packages/cherry-markdown/dist/types/toolbars/hooks/CodeTheme.d.ts	451 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Color.d.ts	2.11 kB
./packages/cherry-markdown/dist/types/toolbars/hooks/Copy.d.ts	697 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Detail.d.ts	324 B
./packages/cherry-markdown/dist/types/toolbars/hooks/DrawIo.d.ts	421 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Export.d.ts	195 B
./packages/cherry-markdown/dist/types/toolbars/hooks/File.d.ts	319 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Formula.d.ts	459 B
./packages/cherry-markdown/dist/types/toolbars/hooks/FullScreen.d.ts	206 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Graph.d.ts	736 B
./packages/cherry-markdown/dist/types/toolbars/hooks/H1.d.ts	390 B
./packages/cherry-markdown/dist/types/toolbars/hooks/H2.d.ts	391 B
./packages/cherry-markdown/dist/types/toolbars/hooks/H3.d.ts	391 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Header.d.ts	505 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Hr.d.ts	322 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Image.d.ts	345 B
./packages/cherry-markdown/dist/types/toolbars/hooks/InlineCode.d.ts	429 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Insert.d.ts	473 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Italic.d.ts	464 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Justify.d.ts	163 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Link.d.ts	347 B
./packages/cherry-markdown/dist/types/toolbars/hooks/List.d.ts	486 B
./packages/cherry-markdown/dist/types/toolbars/hooks/MobilePreview.d.ts	316 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Ol.d.ts	349 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Panel.d.ts	475 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Pdf.d.ts	318 B
./packages/cherry-markdown/dist/types/toolbars/hooks/ProTable.d.ts	561 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Publish.d.ts	388 B
./packages/cherry-markdown/dist/types/toolbars/hooks/QuickTable.d.ts	441 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Quote.d.ts	245 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Redo.d.ts	268 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Ruby.d.ts	447 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Search.d.ts	369 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Settings.d.ts	752 B
./packages/cherry-markdown/dist/types/toolbars/hooks/ShortcutKey.d.ts	442 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Size.d.ts	301 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Split.d.ts	319 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Strikethrough.d.ts	404 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Sub.d.ts	372 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Sup.d.ts	372 B
./packages/cherry-markdown/dist/types/toolbars/hooks/SwitchModel.d.ts	285 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Table.d.ts	364 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Theme.d.ts	465 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Toc.d.ts	320 B
./packages/cherry-markdown/dist/types/toolbars/hooks/TogglePreview.d.ts	340 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Ul.d.ts	350 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Underline.d.ts	404 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Undo.d.ts	245 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Video.d.ts	322 B
./packages/cherry-markdown/dist/types/toolbars/hooks/Word.d.ts	318 B
./packages/cherry-markdown/dist/types/toolbars/hooks/WordCount.d.ts	463 B
./packages/cherry-markdown/dist/types/toolbars/MenuBase.d.ts	2.57 kB
./packages/cherry-markdown/dist/types/toolbars/PreviewerBubble.d.ts	2.03 kB
./packages/cherry-markdown/dist/types/toolbars/ShortcutKeyConfigPanel.d.ts	1.35 kB
./packages/cherry-markdown/dist/types/toolbars/Sidebar.d.ts	224 B
./packages/cherry-markdown/dist/types/toolbars/Toc.d.ts	369 B
./packages/cherry-markdown/dist/types/toolbars/Toolbar.d.ts	2.28 kB
./packages/cherry-markdown/dist/types/toolbars/ToolbarRight.d.ts	156 B
./packages/cherry-markdown/dist/types/UrlCache.d.ts	529 B
./packages/cherry-markdown/dist/types/utils/async-render-handler.d.ts	344 B
./packages/cherry-markdown/dist/types/utils/autoindent.d.ts	450 B
./packages/cherry-markdown/dist/types/utils/cm-search-replace.d.ts	1.52 kB
./packages/cherry-markdown/dist/types/utils/code-preview-language-setting.d.ts	169 B
./packages/cherry-markdown/dist/types/utils/codeBlockContentHandler.d.ts	951 B
./packages/cherry-markdown/dist/types/utils/color.d.ts	205 B
./packages/cherry-markdown/dist/types/utils/config.d.ts	984 B
./packages/cherry-markdown/dist/types/utils/copy.d.ts	577 B
./packages/cherry-markdown/dist/types/utils/dialog.d.ts	195 B
./packages/cherry-markdown/dist/types/utils/dom.d.ts	650 B
./packages/cherry-markdown/dist/types/utils/downloadUtil.d.ts	426 B
./packages/cherry-markdown/dist/types/utils/env.d.ts	482 B
./packages/cherry-markdown/dist/types/utils/error.d.ts	185 B
./packages/cherry-markdown/dist/types/utils/event.d.ts	440 B
./packages/cherry-markdown/dist/types/utils/export.d.ts	351 B
./packages/cherry-markdown/dist/types/utils/exportWord.d.ts	424 B
./packages/cherry-markdown/dist/types/utils/file.d.ts	848 B
./packages/cherry-markdown/dist/types/utils/footnoteHoverHandler.d.ts	889 B
./packages/cherry-markdown/dist/types/utils/formulaUtilsHandler.d.ts	531 B
./packages/cherry-markdown/dist/types/utils/htmlparser.d.ts	1.67 kB
./packages/cherry-markdown/dist/types/utils/image.d.ts	454 B
./packages/cherry-markdown/dist/types/utils/imgSizeHandler.d.ts	969 B
./packages/cherry-markdown/dist/types/utils/imgToolHandler.d.ts	332 B
./packages/cherry-markdown/dist/types/utils/lazyLoadImg.d.ts	2.57 kB
./packages/cherry-markdown/dist/types/utils/lineFeed.d.ts	720 B
./packages/cherry-markdown/dist/types/utils/listContentHandler.d.ts	645 B
./packages/cherry-markdown/dist/types/utils/lookbehind-replace.d.ts	381 B
./packages/cherry-markdown/dist/types/utils/LRUCache.d.ts	554 B
./packages/cherry-markdown/dist/types/utils/mathjax.d.ts	218 B
./packages/cherry-markdown/dist/types/utils/myersDiff.d.ts	431 B
./packages/cherry-markdown/dist/types/utils/pasteHelper.d.ts	825 B
./packages/cherry-markdown/dist/types/utils/platformTransform.d.ts	151 B
./packages/cherry-markdown/dist/types/utils/recount-pos.d.ts	259 B
./packages/cherry-markdown/dist/types/utils/regexp.d.ts	1.56 kB
./packages/cherry-markdown/dist/types/utils/sanitize.d.ts	423 B
./packages/cherry-markdown/dist/types/utils/selection.d.ts	723 B
./packages/cherry-markdown/dist/types/utils/shortcutKey.d.ts	539 B
./packages/cherry-markdown/dist/types/utils/svgUtils.d.ts	650 B
./packages/cherry-markdown/dist/types/utils/tableContentHandler.d.ts	3.24 kB

_{compressed-size-action}

[sunsonliu]

针对 【2. 新增 API (registerHeadlessToolbars) 】，不建议改名，先通过注释来说明