Merge branch 'dev' into rss1102/chore/build/simplify-rollup-config

Author: RSS1102

.changeset/violet-tires-stick.md

@@ -0,0 +1,5 @@
+---
+'cherry-markdown': patch
+---
+
+feat: 支持 `onClickPreview` 返回 `false` 阻止后续处理

packages/cherry-markdown/src/toolbars/PreviewerBubble.js

@@ -289,14 +289,11 @@ export default class PreviewerBubble {
    * @returns
    */
   $onClick(e) {
-    if (this.previewer.$cherry.options.callback.onClickPreview) {
-      // 如果有自定义的onClickPreview回调函数，则先执行
-      const ret = this.previewer.$cherry.options.callback.onClickPreview(e);
-      // @ts-ignore
-      if (ret === false) {
-        return ret;
-      }
+    // 如果有自定义的onClickPreview回调函数，则先执行；返回false时中断后续处理
+    if (this.previewer.$cherry.options.callback?.onClickPreview?.(e) === false) {
+      return false;
     }
+
     const { target } = e;
     if (!(target instanceof Element)) {
       return;

packages/cherry-markdown/types/cherry.d.ts

@@ -143,7 +143,8 @@ export interface _CherryOptions<T extends CherryCustomOptions = CherryCustomOpti
     afterAsyncRender?: CherryLifecycle;
     /** img 标签挂载前触发，可用于懒加载等场景 */
     beforeImageMounted?: (srcProp: string, src: string) => { srcProp: string; src: string };
-    onClickPreview?: (e: MouseEvent) => void;
+    /** 点击预览区域时触发，返回 false 可阻止后续处理 */
+    onClickPreview?: (e: MouseEvent) => void | false;
     onCopyCode?: (e: ClipboardEvent, code: string) => string | false;
     changeString2Pinyin?: (str: string) => string;
     onPaste?: (
@@ -620,7 +621,7 @@ export interface CherryPreviewerOptions {
   /** 预览区域的DOM className */
   className?: string;
   /** 是否是移动端预览 */
-  isMobilePreview?: boolean,
+  isMobilePreview?: boolean;
   enablePreviewerBubble?: boolean;
   floatWhenClosePreviewer?: boolean;
   // 配置图片懒加载的逻辑