@mzzsfy/dsh-turn-notify 0.8.0 → 0.8.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-turn-notify",
   "description": "消息通知:六类回合事件送达声音、系统弹窗、页内提示、webhook 与 IM;内置八种合成音色,自定义音效,按事件分类指定;多窗口只响一次",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
   id: '@mzzsfy/dsh-turn-notify',
   factory(require) {
     const React = require('react')
-    const { useState, useEffect } = React
+    const { useState, useEffect, useRef } = React
 
     // 通知出口:公共依赖 @mzzsfy/dsh-toast,可选消费——共享依赖包的模块表注入
     // 全仓收敛到唯一权威消费方(session-manager),本插件不再代挂占位条目;
@@ -827,13 +827,28 @@ window.__ModuleLoader__.load({
 
     // 宿主重渲染会重建行节点抹掉高亮类,观察器在同一帧内补齐;
     // applySessionHighlights 幂等(类齐不写 DOM),观察器链自然收敛;
-    // 令牌承载 observer:HMR 重建闭包后先断开旧代再挂新代,旧闭包不滞留
+    // 令牌承载 observer 与 pending 帧:HMR 重建闭包后先断开旧代 observer、
+    // cancel 旧代 pending 帧(帧回调持有旧代高亮 Map,不取消会写幽灵高亮),
+    // 旧闭包不滞留;rAF 合批:流式期间 DOM 变更批远高于帧率,同帧多批合并
+    // 为一次重应用(同帧补齐语义不变),无高亮条目时不排帧
     const KEY_HL_OBSERVER = 'turn-notify:hl-observer'
+    const KEY_HL_FRAME = 'turn-notify:hl-frame'
     function ensureHighlightObserver() {
       if (typeof document === 'undefined' || typeof document.body === 'undefined' || typeof MutationObserver === 'undefined') return
       if (window[KEY_HL_OBSERVER] !== undefined && typeof window[KEY_HL_OBSERVER].disconnect === 'function') window[KEY_HL_OBSERVER].disconnect()
+      if (typeof window[KEY_HL_FRAME] === 'number') {
+        cancelAnimationFrame(window[KEY_HL_FRAME])
+      }
+      // 哨兵 0 = 无在途帧(规范 rAF 句柄自 1 起,cancel 0 为 no-op);新代显式归零,
+      // 防 undefined 初始态使在途判定恒真、帧永不排程
+      window[KEY_HL_FRAME] = 0
       const observer = new MutationObserver(() => {
-        if (sessionHighlightEnabled && sessionHighlights.size > 0) applySessionHighlights()
+        if (!sessionHighlightEnabled || sessionHighlights.size === 0) return
+        if (window[KEY_HL_FRAME] !== 0) return
+        window[KEY_HL_FRAME] = requestAnimationFrame(() => {
+          window[KEY_HL_FRAME] = 0
+          if (sessionHighlightEnabled && sessionHighlights.size > 0) applySessionHighlights()
+        })
       })
       observer.observe(document.body, { childList: true, subtree: true })
       window[KEY_HL_OBSERVER] = observer
@@ -1484,14 +1499,16 @@ window.__ModuleLoader__.load({
       // 已绑 bot chips 由 imBoundBotIds 去重(见 LOGIC 段同源函数)
       const imBoundBots = imBoundBotIds(config.imTargets)
 
-      // 勾选即存:与分类开关同模式,列表整体替换,连续操作以最新一次请求为准
-      let imPersistSeq = 0
+      // 勾选即存:与分类开关同模式,列表整体替换,连续操作以最新一次请求为准;
+      // seq 守卫须跨渲染存活(useRef),组件体内 let 声明每次渲染重置使守卫失效
+      const imPersistSeqRef = useRef(0)
       async function persistImTargets(next, okMessage) {
-        const seq = ++imPersistSeq
+        imPersistSeqRef.current += 1
+        const seq = imPersistSeqRef.current
         setConfig({ ...config, imTargets: next })
         try {
           const res = await api('/api/turn-notify/config', { method: 'POST', body: JSON.stringify({ imTargets: next }) })
-          if (seq === imPersistSeq) {
+          if (seq === imPersistSeqRef.current) {
             setConfig({ ...DEFAULT_CONFIG, ...res })
             if (res.soundMapping) setMappingState(res.soundMapping)
             if (okMessage !== undefined) patch(okMessage)

package/test/hooks-destructure.test.mjs

@@ -0,0 +1,28 @@
+// client 半区 React hooks 解构静态断言:client.js 为经典 bundle,组件渲染路径
+// 无运行时测试,hooks 未从 React 解构的缺陷(useRef is not a function)只能靠
+// 源码静态比对拦截——组件体内使用的全部 hooks 必须出现在解构清单。
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const source = readFileSync(join(root, 'src', 'client.js'), 'utf8')
+
+test('client.js 组件使用的全部 React hooks 均在解构清单中', () => {
+  // Given 解构行(const { ... } = React)与全源码 hooks 调用
+  const destructure = /const\s*\{([^}]+)\}\s*=\s*React\b/.exec(source)
+  assert.notEqual(destructure, null, 'React 解构行必须存在')
+  const declared = new Set(destructure[1].split(',').map((name) => name.trim()).filter(Boolean))
+  const used = [...source.matchAll(/\b(use[A-Z]\w*)\s*\(/g)].map((match) => match[1])
+  assert.ok(used.length > 0, '至少存在一个 hooks 调用,否则断言失效')
+  // Then 每个使用的 hooks 都已声明
+  const missing = [...new Set(used)].filter((name) => !declared.has(name))
+  assert.deepEqual(missing, [], '未解构的 hooks(渲染即 ReferenceError)')
+})
+
+test('client.js 不存在 React.useXxx 直调形态(绕过解构清单)', () => {
+  const direct = [...source.matchAll(/\bReact\.(use[A-Z]\w*)\s*\(/g)].map((match) => match[1])
+  assert.deepEqual(direct, [], 'hooks 一律经解构清单使用,便于静态断言')
+})