leafer-x-tooltip-canvas 1.0.2 → 1.0.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "leafer-x-tooltip-canvas",
   "description": "A tooltip plugin for Leafer-ui.",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "author": "214L",
   "license": "MIT",
   "type": "module",

package/src/Tooltip.ts

@@ -70,6 +70,16 @@ export class Tooltip extends Pen implements ITooltip {
     this.show()
   }
 
+  /**
+   * @description Debug 日志输出
+   * @private
+   */
+  private log(...args: unknown[]) {
+    if (this.config?.debug) {
+      console.log('[Tooltip]', ...args)
+    }
+  }
+
   /**
    * @description tooltip
    * @param pos 位置信息
@@ -88,6 +98,25 @@ export class Tooltip extends Pen implements ITooltip {
       fontFamily,
     } = this.config.style
     let offset = this.config.offset
+
+    this.log('createShapes', {
+      target: {
+        tag: this.target?.tag,
+        id: this.target?.id,
+        className: this.target?.className,
+        parent: {
+          tag: this.target?.parent?.tag,
+          id: this.target?.parent?.id,
+        },
+      },
+      pointer: pos,
+      offset,
+      renderPos: { x: pos.x + offset[0], y: pos.y + offset[1] },
+      size: { width, height },
+      style: { backgroundColor, stroke, color, padding, borderRadius, fontSize },
+      text,
+    })
+
     this.setStyle({
       fill: backgroundColor,
       stroke,
@@ -129,6 +158,7 @@ export class Tooltip extends Pen implements ITooltip {
 
   public show(pos = this.__.pointerPos) {
     this.clearShowHideTimers()
+    this.log('show', { pos, delay: this.config.showDelay, isShow: this.isShow })
     this.showTimerId = setTimeout(() => {
       this.createShapes(pos)
       this.showTimerId = null  // 定时器执行完毕,清空引用
@@ -137,6 +167,7 @@ export class Tooltip extends Pen implements ITooltip {
 
   public hide(immediate = false) {
     this.clearShowHideTimers()
+    this.log('hide', { immediate, delay: this.config.hideDelay, isShow: this.isShow })
     if (immediate) {
       this.destroy()
     } else {
@@ -150,6 +181,7 @@ export class Tooltip extends Pen implements ITooltip {
 
   public update(pos: IPos) {
     this.clearShowHideTimers()
+    this.log('update', { pos, isShow: this.isShow })
     if (this.isShow) {
       // 已显示,立即更新位置
       this.createShapes(pos)

package/src/TooltipPlugin.ts

@@ -39,6 +39,16 @@ export class TooltipPlugin {
   private excludesTypeSet: Set<string> = new Set()
   private ignoreTypeSet: Set<string> = new Set()
 
+  /**
+   * @description Debug 日志输出
+   * @private
+   */
+  private log(...args: unknown[]) {
+    if (this.config.debug) {
+      console.log('[TooltipPlugin]', ...args)
+    }
+  }
+
   constructor(instance: ILeafer | App, config?: IUserConfig) {
     this.instance = instance
     this.config = this.mergeConfig(defaultConfig, config)
@@ -142,12 +152,14 @@ export class TooltipPlugin {
     )
 
     const target = this.filterTarget(result.throughPath.list)
+
     if (!target) {
       this.hideTooltip()
       return
     }
 
-    if (!this.handleAllowed(target)) {
+    const allowed = this.handleAllowed(target)
+    if (!allowed) {
       this.hideTooltip()
       return
     }
@@ -188,6 +200,7 @@ export class TooltipPlugin {
 
     // 如果没有配置任何过滤规则,默认允许
     if (!hasIncludesRule && !hasExcludesRule) {
+      this.log('allowed', { target: target.tag, result: true, reason: 'no rules' })
       return true
     }
 
@@ -195,11 +208,21 @@ export class TooltipPlugin {
     const matchesExclude = targetIdentifiers.some((id) => this.excludesTypeSet.has(id))
 
     // includes 优先级高于 excludes
-    if (matchesInclude) return true  // 匹配白名单,直接允许(即使也在黑名单中)
-    if (matchesExclude) return false  // 不在白名单但在黑名单,拒绝
+    if (matchesInclude) {
+      this.log('allowed', { target: target.tag, result: true, reason: 'matches include' })
+      return true  // 匹配白名单,直接允许(即使也在黑名单中)
+    }
+    if (matchesExclude) {
+      this.log('allowed', { target: target.tag, result: false, reason: 'matches exclude' })
+      return false  // 不在白名单但在黑名单,拒绝
+    }
 
     // 两者都不匹配的情况
-    if (hasIncludesRule) return false  // 有白名单规则但不匹配 → 拒绝
+    if (hasIncludesRule) {
+      this.log('allowed', { target: target.tag, result: false, reason: 'has include rule but not matched' })
+      return false  // 有白名单规则但不匹配 → 拒绝
+    }
+    this.log('allowed', { target: target.tag, result: true, reason: 'only exclude rule, not matched' })
     return true  // 只有黑名单规则且不匹配 → 允许
   }
 
@@ -241,6 +264,7 @@ export class TooltipPlugin {
     const cachedTooltip = this.tooltipCache.get(id)
     if (cachedTooltip && cachedTooltip.parent) {
       // 实例有效,直接更新
+      this.log('tooltip update', { id, x: event.x, y: event.y })
       cachedTooltip.update({ x: event.x, y: event.y })
     } else {
       // 实例已被销毁或不存在,移除无效缓存并创建新实例
@@ -248,6 +272,7 @@ export class TooltipPlugin {
         this.tooltipCache.delete(id)
       }
 
+      this.log('tooltip create', { id, x: event.x, y: event.y, target: target.tag })
       const tooltip = new Tooltip({
         id,
         pointerPos: { x: event.x, y: event.y },

package/src/defaultConfig.ts

@@ -1,5 +1,6 @@
 import { IUserConfig } from './interface'
 export const defaultConfig: IUserConfig = {
+  debug: false,
   reference: 'pointer',
   info: ['tag'],
   showType: 'value',

package/src/interface/config.ts

@@ -1,5 +1,6 @@
 import { IFontWeight } from '@leafer-ui/interface'
 interface IUserConfig {
+  debug?: boolean
   reference?: 'pointer' | 'element'
   showDelay?: number
   arrow?: boolean

package/types/index.d.ts

@@ -2,6 +2,7 @@ import { App } from '@leafer-ui/core';
 import { IFontWeight, ILeafer } from '@leafer-ui/interface';
 
 interface IUserConfig {
+    debug?: boolean;
     reference?: 'pointer' | 'element';
     showDelay?: number;
     arrow?: boolean;
@@ -39,6 +40,7 @@ declare class TooltipPlugin {
     private includesTypeSet;
     private excludesTypeSet;
     private ignoreTypeSet;
+    private log;
     constructor(instance: ILeafer | App, config?: IUserConfig);
     private mergeConfig;
     private isAppInstance;