br-dionysus 1.19.5 → 1.19.7

package/README.md

@@ -2847,7 +2847,7 @@ const list = ref<{ name: string, className: string }[]>([
 
 + createHash([](#))
 
-+ globalEvents([|-register---|-注册行为-----------------------|-(options:-EventRegistration)](#|-register---|-注册行为-----------------------|-(options:-EventRegistration)))
++ getDomEventHub([|-on-------|-注册行为------------------------|-(options:-EventRegistration)](#|-on-------|-注册行为------------------------|-(options:-EventRegistration)))
 
 + moneyFormat([](#))
 
@@ -5457,29 +5457,35 @@ const list = ref<{ name: string, className: string }[]>([
 
 
 
-## 全局事件代理 globalEvents
+## 全局单例 DOM 事件任务中心 getDomEventHub
+
+用于在同一 DOM 节点上集中监听事件，并允许多个组件向同一事件注册独立回调任务，避免重复绑定与相互覆盖。
 
 ### 1) 参数
 
-| 参数    | 描述                       | 类型     | 默认值    |
-|-------|--------------------------|--------|--------|
-| point | 锚点（绑定事件的dom节点的class,id等） | string | 'body' |
+| 参数    | 描述                  | 类型     | 默认值    |
+|-------|---------------------|--------|--------|
+| point | 锚点（绑定事件的 dom 节点选择器） | string | 'body' |
 
-### 2) 返参
+### 2) 返参（GlobalEventManager）
+
+| 参数       | 描述                          | 类型                                   | 默认值 |
+|----------|-----------------------------|--------------------------------------|-----|
+| on       | 注册行为                        | (options: EventRegistration) => void | -   |
+| off      | 注销行为（id 存在即注销对应行为，不存在即注销所有） | (id?: string \| number) => void      | -   |
+| clear    | 清空任务池                       | () => void                           | -   |
+| destroy  | 销毁 Hub，解绑事件并清空任务池           | () => void                           | -   |
+| setPoint | 设置监听锚点（重新绑定，保留任务池）          | (point: string) => void              | -   |
 
-| 参数         | 描述                         | 类型                                   | 默认值 |
-|------------|----------------------------|--------------------------------------|-----|
-| register   | 注册行为                       | (options: EventRegistration) => void | -   |
-| unregister | 注销行为（id存在即注销对应行为，不存在即注销所有） | (id?: string \| number) => void      | -   |
+### 3) EventRegistration
 
-#### 2.1) EventRegistration
+| 参数        | 描述               | 类型                                                                                                              | 默认值 |
+|-----------|------------------|-----------------------------------------------------------------------------------------------------------------|-----|
+| eventName | 事件类型             | 'click' \| 'mousemove' \| 'mousedown' \| 'mouseenter' \| 'mouseleave' \| 'mouseout' \| 'mouseover' \| 'mouseup' | -   |
+| id        | 唯一标识符            | string \| number                                                                                                | -   |
+| callback  | 事件回调             | (event: T) => void                                                                                              | -   |
+| priority  | 事件优先级（数字越小优先级越高） | number                                                                                                          | -   |
 
-| 参数        | 描述               | 类型                 | 默认值 |
-|-----------|------------------|--------------------|-----|
-| eventName | 事件类型             | GlobalEventName    | -   |
-| id        | 唯一标识符            | string \| number   | -   |
-| callback  | 事件回调             | (event: T) => void | -   |
-| priority  | 事件优先级（数字越小优先级越高） | number             | -   |
 
 
 

package/build/lib.config.ts

@@ -1,38 +1,43 @@
-import baseConfig from '../vite.config.js'
 import { defineConfig } from 'vite'
 import { resolve } from 'path'
 import dts from 'vite-plugin-dts'
 import createWebTypes from './../createWebTypes.mjs'
 
-export default defineConfig({
-  ...baseConfig,
-  build: {
-    outDir: 'dist',
-    cssCodeSplit: true,
-    lib: {
-      entry: resolve(__dirname, '../packages/index.ts'),
-      name: 'BrPlugin',
-      fileName: (format) => `br-dionysus.${format}.js`
-    },
-    rollupOptions: {
-      // 确保外部化处理那些你不想打包进库的依赖
-      external: ['vue'],
-      output: {
-        // 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
-        globals: {
-          vue: 'Vue'
+export default defineConfig(async ({ mode }) => {
+  const { default: baseConfigFn } = await import('../vite.config.ts')
+  const baseConfig = await baseConfigFn({ command: 'build', mode, isSsrBuild: false, isPreview: false } as any)
+  const basePlugins = (baseConfig?.plugins ?? []) as any[]
+
+  return {
+    ...baseConfig,
+    build: {
+      outDir: 'dist',
+      cssCodeSplit: true,
+      lib: {
+        entry: resolve(__dirname, '../packages/index.ts'),
+        name: 'BrPlugin',
+        fileName: (format: string) => `br-dionysus.${format}.js`
+      },
+      rollupOptions: {
+        // 确保外部化处理那些你不想打包进库的依赖
+        external: ['vue'],
+        output: {
+          // 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
+          globals: {
+            vue: 'Vue'
+          }
         }
       }
-    }
-  },
-  plugins: [
-    ...(baseConfig as any).plugins,
-    dts({ rollupTypes: true }),
-    {
-      name: 'build-complete',
-      writeBundle () {
-        createWebTypes()
+    },
+    plugins: [
+      ...basePlugins,
+      dts({ rollupTypes: true }),
+      {
+        name: 'build-complete',
+        writeBundle () {
+          createWebTypes()
+        }
       }
-    }
-  ]
+    ]
+  }
 })

package/cypress/e2e/toolGetDomEventHub.cy.ts

@@ -0,0 +1,272 @@
+import getDomEventHub from '../../packages/Tool/getDomEventHub/getDomEventHub'
+
+describe('工具函数 getDomEventHub', () => {
+  const waitForBind = () => {
+    cy.then(() => {
+      return new Cypress.Promise<void>(resolve => {
+        window.setTimeout(resolve, 0)
+      })
+    })
+  }
+
+  const triggerMouseEvent = (
+    eventName: 'mouseup' | 'mousedown' | 'mousemove',
+    targetSelector: string = 'body',
+    bubbles: boolean = true
+  ) => {
+    cy.then(() => {
+      const target = document.querySelector(targetSelector)
+      if (!target) throw new Error(`未找到事件触发目标: ${targetSelector}`)
+      target.dispatchEvent(new MouseEvent(eventName, { bubbles }))
+    })
+  }
+
+  beforeEach(() => {
+    getDomEventHub('body').off()
+    getDomEventHub('body')
+    waitForBind()
+  })
+
+  afterEach(() => {
+    getDomEventHub('body').off()
+  })
+
+  it('注册 onmouseup 后能够触发回调', () => {
+    const callback = cy.spy().as('mouseupCallback')
+
+    getDomEventHub('body').on({
+      id: 'global-events-mouseup',
+      eventName: 'mouseup',
+      callback
+    })
+
+    triggerMouseEvent('mouseup')
+    cy.get('@mouseupCallback').should('have.been.calledOnce')
+  })
+
+  it('不传 point 时默认绑定到 body', () => {
+    const callback = cy.spy().as('defaultBodyCallback')
+
+    getDomEventHub().on({
+      id: 'global-events-default-body',
+      eventName: 'mouseup',
+      callback
+    })
+
+    triggerMouseEvent('mouseup')
+    cy.get('@defaultBodyCallback').should('have.been.calledOnce')
+  })
+
+  it('同 id 重复注册会被忽略', () => {
+    const firstCallback = cy.spy().as('firstCallback')
+    const secondCallback = cy.spy().as('secondCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-dup-id',
+      eventName: 'mousedown',
+      callback: firstCallback
+    })
+    manager.on({
+      id: 'global-events-dup-id',
+      eventName: 'mousedown',
+      callback: secondCallback
+    })
+
+    triggerMouseEvent('mousedown')
+    cy.get('@firstCallback').should('have.been.calledOnce')
+    cy.get('@secondCallback').should('not.have.been.called')
+  })
+
+  it('同一事件可注册多个回调，并按注册顺序触发', () => {
+    const callOrder: string[] = []
+    const firstCallback = cy.spy(() => {
+      callOrder.push('first')
+    }).as('orderedFirstCallback')
+    const secondCallback = cy.spy(() => {
+      callOrder.push('second')
+    }).as('orderedSecondCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-order-first',
+      eventName: 'mouseup',
+      callback: firstCallback
+    })
+    manager.on({
+      id: 'global-events-order-second',
+      eventName: 'mouseup',
+      callback: secondCallback
+    })
+
+    triggerMouseEvent('mouseup')
+
+    cy.get('@orderedFirstCallback').should('have.been.calledOnce')
+    cy.get('@orderedSecondCallback').should('have.been.calledOnce')
+    cy.then(() => {
+      expect(callOrder).to.deep.equal(['first', 'second'])
+    })
+  })
+
+  it('不同 eventName 互不干扰，只触发对应回调', () => {
+    const mouseupCallback = cy.spy().as('isolatedMouseupCallback')
+    const mousedownCallback = cy.spy().as('isolatedMousedownCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-isolate-up',
+      eventName: 'mouseup',
+      callback: mouseupCallback
+    })
+    manager.on({
+      id: 'global-events-isolate-down',
+      eventName: 'mousedown',
+      callback: mousedownCallback
+    })
+
+    triggerMouseEvent('mouseup')
+
+    cy.get('@isolatedMouseupCallback').should('have.been.calledOnce')
+    cy.get('@isolatedMousedownCallback').should('not.have.been.called')
+  })
+
+  it('不同事件使用相同 id 时，后注册的监听会被忽略', () => {
+    const mouseupCallback = cy.spy().as('sameIdMouseupCallback')
+    const mousedownCallback = cy.spy().as('sameIdMousedownCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-same-id-cross-event',
+      eventName: 'mouseup',
+      callback: mouseupCallback
+    })
+    manager.on({
+      id: 'global-events-same-id-cross-event',
+      eventName: 'mousedown',
+      callback: mousedownCallback
+    })
+
+    triggerMouseEvent('mouseup')
+    triggerMouseEvent('mousedown')
+
+    cy.get('@sameIdMouseupCallback').should('have.been.calledOnce')
+    cy.get('@sameIdMousedownCallback').should('not.have.been.called')
+  })
+
+  it('off(id) 仅移除指定事件', () => {
+    const keepCallback = cy.spy().as('keepCallback')
+    const removeCallback = cy.spy().as('removeCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-keep',
+      eventName: 'mousemove',
+      callback: keepCallback
+    })
+    manager.on({
+      id: 'global-events-remove',
+      eventName: 'mousemove',
+      callback: removeCallback
+    })
+
+    manager.off('global-events-remove')
+    triggerMouseEvent('mousemove')
+
+    cy.get('@keepCallback').should('have.been.calledOnce')
+    cy.get('@removeCallback').should('not.have.been.called')
+  })
+
+  it('off(不存在的 id) 不影响已有监听', () => {
+    const callback = cy.spy().as('keepAfterInvalidOff')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-invalid-off',
+      eventName: 'mousemove',
+      callback
+    })
+
+    manager.off('global-events-not-exists')
+    triggerMouseEvent('mousemove')
+
+    cy.get('@keepAfterInvalidOff').should('have.been.calledOnce')
+  })
+
+  it('off() 会移除所有事件', () => {
+    const callback = cy.spy().as('allRemovedCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-clear-all',
+      eventName: 'mouseup',
+      callback
+    })
+    manager.off()
+
+    triggerMouseEvent('mouseup')
+    cy.get('@allRemovedCallback').should('not.have.been.called')
+  })
+
+  it('clear() 会清空任务池', () => {
+    const callback = cy.spy().as('clearCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-clear',
+      eventName: 'mouseup',
+      callback
+    })
+
+    manager.clear()
+    triggerMouseEvent('mouseup')
+
+    cy.get('@clearCallback').should('not.have.been.called')
+  })
+
+  it('destroy() 会解绑事件并清空任务池', () => {
+    const callback = cy.spy().as('destroyCallback')
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-destroy',
+      eventName: 'mouseup',
+      callback
+    })
+
+    manager.destroy()
+    triggerMouseEvent('mouseup')
+
+    cy.get('@destroyCallback').should('not.have.been.called')
+  })
+
+  it('setPoint() 切换锚点后保留任务池，仅新锚点触发回调', () => {
+    const callback = cy.spy().as('setPointCallback')
+
+    cy.then(() => {
+      const pointEl = document.createElement('div')
+      pointEl.id = 'global-events-point'
+      document.body.appendChild(pointEl)
+    })
+
+    const manager = getDomEventHub('body')
+    manager.on({
+      id: 'global-events-set-point',
+      eventName: 'mouseup',
+      callback
+    })
+
+    manager.setPoint('#global-events-point')
+    waitForBind()
+
+    triggerMouseEvent('mouseup', 'body', false)
+    triggerMouseEvent('mouseup', '#global-events-point', false)
+
+    cy.get('@setPointCallback').should('have.been.calledOnce')
+
+    manager.setPoint('body')
+    waitForBind()
+    cy.then(() => {
+      document.querySelector('#global-events-point')?.remove()
+    })
+  })
+})

package/cypress/fixtures/profile.json

@@ -0,0 +1,5 @@
+{
+  "id": 8739,
+  "name": "Jane",
+  "email": "jane@example.com"
+}

package/cypress/fixtures/users.json

@@ -0,0 +1,232 @@
+[
+  {
+    "id": 1,
+    "name": "Leanne Graham",
+    "username": "Bret",
+    "email": "Sincere@april.biz",
+    "address": {
+      "street": "Kulas Light",
+      "suite": "Apt. 556",
+      "city": "Gwenborough",
+      "zipcode": "92998-3874",
+      "geo": {
+        "lat": "-37.3159",
+        "lng": "81.1496"
+      }
+    },
+    "phone": "1-770-736-8031 x56442",
+    "website": "hildegard.org",
+    "company": {
+      "name": "Romaguera-Crona",
+      "catchPhrase": "Multi-layered client-server neural-net",
+      "bs": "harness real-time e-markets"
+    }
+  },
+  {
+    "id": 2,
+    "name": "Ervin Howell",
+    "username": "Antonette",
+    "email": "Shanna@melissa.tv",
+    "address": {
+      "street": "Victor Plains",
+      "suite": "Suite 879",
+      "city": "Wisokyburgh",
+      "zipcode": "90566-7771",
+      "geo": {
+        "lat": "-43.9509",
+        "lng": "-34.4618"
+      }
+    },
+    "phone": "010-692-6593 x09125",
+    "website": "anastasia.net",
+    "company": {
+      "name": "Deckow-Crist",
+      "catchPhrase": "Proactive didactic contingency",
+      "bs": "synergize scalable supply-chains"
+    }
+  },
+  {
+    "id": 3,
+    "name": "Clementine Bauch",
+    "username": "Samantha",
+    "email": "Nathan@yesenia.net",
+    "address": {
+      "street": "Douglas Extension",
+      "suite": "Suite 847",
+      "city": "McKenziehaven",
+      "zipcode": "59590-4157",
+      "geo": {
+        "lat": "-68.6102",
+        "lng": "-47.0653"
+      }
+    },
+    "phone": "1-463-123-4447",
+    "website": "ramiro.info",
+    "company": {
+      "name": "Romaguera-Jacobson",
+      "catchPhrase": "Face to face bifurcated interface",
+      "bs": "e-enable strategic applications"
+    }
+  },
+  {
+    "id": 4,
+    "name": "Patricia Lebsack",
+    "username": "Karianne",
+    "email": "Julianne.OConner@kory.org",
+    "address": {
+      "street": "Hoeger Mall",
+      "suite": "Apt. 692",
+      "city": "South Elvis",
+      "zipcode": "53919-4257",
+      "geo": {
+        "lat": "29.4572",
+        "lng": "-164.2990"
+      }
+    },
+    "phone": "493-170-9623 x156",
+    "website": "kale.biz",
+    "company": {
+      "name": "Robel-Corkery",
+      "catchPhrase": "Multi-tiered zero tolerance productivity",
+      "bs": "transition cutting-edge web services"
+    }
+  },
+  {
+    "id": 5,
+    "name": "Chelsey Dietrich",
+    "username": "Kamren",
+    "email": "Lucio_Hettinger@annie.ca",
+    "address": {
+      "street": "Skiles Walks",
+      "suite": "Suite 351",
+      "city": "Roscoeview",
+      "zipcode": "33263",
+      "geo": {
+        "lat": "-31.8129",
+        "lng": "62.5342"
+      }
+    },
+    "phone": "(254)954-1289",
+    "website": "demarco.info",
+    "company": {
+      "name": "Keebler LLC",
+      "catchPhrase": "User-centric fault-tolerant solution",
+      "bs": "revolutionize end-to-end systems"
+    }
+  },
+  {
+    "id": 6,
+    "name": "Mrs. Dennis Schulist",
+    "username": "Leopoldo_Corkery",
+    "email": "Karley_Dach@jasper.info",
+    "address": {
+      "street": "Norberto Crossing",
+      "suite": "Apt. 950",
+      "city": "South Christy",
+      "zipcode": "23505-1337",
+      "geo": {
+        "lat": "-71.4197",
+        "lng": "71.7478"
+      }
+    },
+    "phone": "1-477-935-8478 x6430",
+    "website": "ola.org",
+    "company": {
+      "name": "Considine-Lockman",
+      "catchPhrase": "Synchronised bottom-line interface",
+      "bs": "e-enable innovative applications"
+    }
+  },
+  {
+    "id": 7,
+    "name": "Kurtis Weissnat",
+    "username": "Elwyn.Skiles",
+    "email": "Telly.Hoeger@billy.biz",
+    "address": {
+      "street": "Rex Trail",
+      "suite": "Suite 280",
+      "city": "Howemouth",
+      "zipcode": "58804-1099",
+      "geo": {
+        "lat": "24.8918",
+        "lng": "21.8984"
+      }
+    },
+    "phone": "210.067.6132",
+    "website": "elvis.io",
+    "company": {
+      "name": "Johns Group",
+      "catchPhrase": "Configurable multimedia task-force",
+      "bs": "generate enterprise e-tailers"
+    }
+  },
+  {
+    "id": 8,
+    "name": "Nicholas Runolfsdottir V",
+    "username": "Maxime_Nienow",
+    "email": "Sherwood@rosamond.me",
+    "address": {
+      "street": "Ellsworth Summit",
+      "suite": "Suite 729",
+      "city": "Aliyaview",
+      "zipcode": "45169",
+      "geo": {
+        "lat": "-14.3990",
+        "lng": "-120.7677"
+      }
+    },
+    "phone": "586.493.6943 x140",
+    "website": "jacynthe.com",
+    "company": {
+      "name": "Abernathy Group",
+      "catchPhrase": "Implemented secondary concept",
+      "bs": "e-enable extensible e-tailers"
+    }
+  },
+  {
+    "id": 9,
+    "name": "Glenna Reichert",
+    "username": "Delphine",
+    "email": "Chaim_McDermott@dana.io",
+    "address": {
+      "street": "Dayna Park",
+      "suite": "Suite 449",
+      "city": "Bartholomebury",
+      "zipcode": "76495-3109",
+      "geo": {
+        "lat": "24.6463",
+        "lng": "-168.8889"
+      }
+    },
+    "phone": "(775)976-6794 x41206",
+    "website": "conrad.com",
+    "company": {
+      "name": "Yost and Sons",
+      "catchPhrase": "Switchable contextually-based project",
+      "bs": "aggregate real-time technologies"
+    }
+  },
+  {
+    "id": 10,
+    "name": "Clementina DuBuque",
+    "username": "Moriah.Stanton",
+    "email": "Rey.Padberg@karina.biz",
+    "address": {
+      "street": "Kattie Turnpike",
+      "suite": "Suite 198",
+      "city": "Lebsackbury",
+      "zipcode": "31428-2261",
+      "geo": {
+        "lat": "-38.2386",
+        "lng": "57.2232"
+      }
+    },
+    "phone": "024-648-3804",
+    "website": "ambrose.net",
+    "company": {
+      "name": "Hoeger LLC",
+      "catchPhrase": "Centralized empowering task-force",
+      "bs": "target end-to-end models"
+    }
+  }
+]