dsh-mobile-use 1.0.1 → 1.0.4

package/test/coords.test.mjs

@@ -0,0 +1,129 @@
+/**
+ * 坐标换算回归：从 client.js 里切出真实的 pictureRect / turned / devicePoint 源码，
+ * 在 node 里用假 DOM 矩形跑。侧栏在右边时坐标曾经被减两次（视觉中心点成 0,600），
+ * 这条测试就是那份审阅复现的固化版：改坏就红。
+ *
+ *   node test/coords.test.mjs
+ */
+
+import fs from 'node:fs'
+import assert from 'node:assert/strict'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const source = fs.readFileSync(path.join(here, '..', 'client.js'), 'utf8')
+
+const start = source.indexOf('/* 画面元素：MSE 用 video')
+const end = source.indexOf('/* 平移边界')
+assert.ok(start > 0 && end > start, '没找到几何换算那一段源码')
+
+const geometry = source.slice(start, end)
+const factory = new Function(
+  'engine', 'videoRef', 'imgRef', 'canvasRef', 'screen', 'frameSize', 'Math',
+  `${geometry}\n return { devicePoint, pictureRect, turned }`,
+)
+
+/**
+ * 造一个用给定矩形假装的 DOM 元素。
+ * @param {number} left - 视口左边缘。
+ * @param {number} top - 视口上边缘。
+ * @param {number} width - 宽。
+ * @param {number} height - 高。
+ * @returns {{ getBoundingClientRect: () => any }} 元素桩。
+ */
+const box = (left, top, width, height) => ({ getBoundingClientRect: () => ({ left, top, width, height, right: left + width, bottom: top + height }) })
+
+/**
+ * 造一台设备状态下的换算器。
+ * @param {{ device: {w: number, h: number}, frame: {w: number, h: number}, canvas: any, media: any, engine?: string }} config - 现场。
+ * @returns {(point: {x: number, y: number}) => {x: number, y: number}} 换算函数。
+ */
+const make = ({ device, frame, canvas, media, engine = 'jpeg' }) => {
+  const { devicePoint } = factory(engine, { current: null }, { current: media }, { current: canvas }, device, frame, Math)
+  return devicePoint
+}
+
+let pass = 0
+/**
+ * 断言一点。
+ * @param {string} label - 检查项。
+ * @param {() => void} run - 断言体。
+ * @returns {void}
+ */
+const it = (label, run) => {
+  try {
+    run()
+    pass += 1
+    console.log(`  ✅ ${label}`)
+  } catch (error) {
+    console.log(`  ❌ ${label}`)
+    throw error
+  }
+}
+
+console.log('\n坐标换算（源码级）\n')
+
+/* 审阅给的复现：右栏里画面框 left=1000/top=100，显示 300x533.33，设备 1080x1920。
+   取画面正中心，正确结果是 (540,960)；旧代码会算成 (0,600)。 */
+it('右栏里点画面正中心 = 设备正中心', () => {
+  const toDevice = make({
+    device: { w: 1080, h: 1920 },
+    frame: { w: 300, h: 533.333 },
+    canvas: box(1000, 100, 300, 533.333),
+    media: box(1000, 100, 300, 533.333),
+  })
+  assert.deepEqual(toDevice({ x: 150, y: 266.666 }), { x: 540, y: 960 })
+})
+
+it('画面有上下留边时按画面矩形换算（不是画布）', () => {
+  const toDevice = make({
+    device: { w: 1080, h: 1350 },
+    frame: { w: 400, h: 500 },
+    canvas: box(20, 40, 400, 600),
+    media: box(20, 90, 400, 500),
+  })
+  assert.deepEqual(toDevice({ x: 200, y: 250 }), { x: 540, y: 540 })
+})
+
+it('画面有左右留边时按画面矩形换算', () => {
+  const toDevice = make({
+    device: { w: 1080, h: 1080 },
+    frame: { w: 400, h: 400 },
+    canvas: box(0, 0, 500, 400),
+    media: box(50, 0, 400, 400),
+  })
+  assert.deepEqual(toDevice({ x: 250, y: 200 }), { x: 540, y: 540 })
+})
+
+it('画面外沿夹到边界，不会溢成负数', () => {
+  const toDevice = make({
+    device: { w: 1080, h: 1920 },
+    frame: { w: 300, h: 533 },
+    canvas: box(1000, 100, 300, 533),
+    media: box(1000, 100, 300, 533),
+  })
+  assert.deepEqual(toDevice({ x: -50, y: 900 }), { x: 0, y: 1920 })
+})
+
+it('横屏画面 + 竖屏设备（转过 90°）映射到长边', () => {
+  const toDevice = make({
+    device: { w: 2136, h: 3200 },
+    frame: { w: 2400, h: 1080 },
+    canvas: box(0, 0, 2400, 1080),
+    media: box(0, 0, 2400, 1080),
+  })
+  assert.deepEqual(toDevice({ x: 1200, y: 540 }), { x: 1068, y: 1600 })
+})
+
+it('MSE 走 video 元素，抓帧走 img，两条路都拿画面矩形', () => {
+  const canvas = box(0, 0, 300, 500)
+  const video = box(0, 0, 300, 500)
+  const img = box(10, 20, 280, 460)
+  const mse = factory('mse', { current: video }, { current: img }, { current: canvas }, { w: 1080, h: 1800 }, { w: 300, h: 500 }, Math)
+  assert.deepEqual(mse.devicePoint({ x: 150, y: 250 }), { x: 540, y: 900 })
+  const jpeg = factory('jpeg', { current: video }, { current: img }, { current: canvas }, { w: 1080, h: 1800 }, { w: 300, h: 500 }, Math)
+  assert.deepEqual(jpeg.devicePoint({ x: 150, y: 250 }), { x: 540, y: 900 })
+})
+
+console.log(`\n${pass} 项通过\n`)

package/test/symbols.test.mjs

@@ -0,0 +1,73 @@
+/**
+ * 悬空 this 调用扫描：rename 后残留 `this.oldName()` 会让插件在回调里抛 TypeError，
+ * 而宿主不隔离插件异常 —— 一次空转定时器就能打死整个 DSH（2026-10-27 的 killStale 事故）。
+ * 只做一件事：文件里每个 `this.foo(` 都要能找到定义（方法简写或 this.foo = 赋值）。
+ */
+import { readFileSync } from 'node:fs'
+
+const FILES = ['stream.js', 'mirror.js', 'index.js', 'client.js']
+
+/** 从源码里收集「哪些名字在这份文件里是可调用的 this 成员」。 */
+function knownMembers(source) {
+  const names = new Set()
+  /* this.foo = ... 的赋值（含 this.foo = function / 箭头函数）。 */
+  for (const m of source.matchAll(/this\.([A-Za-z_$][\w$]*)\s*=(?!=)/g)) names.add(m[1])
+  /* 方法简写 / 类字段箭头函数：行首缩进后的 `foo(...) {` 或 `foo = (...) =>`。 */
+  for (const m of source.matchAll(/^\s{2,}(?:async\s+)?(?:get\s+|set\s+)?([A-Za-z_$][\w$]*)\s*\([^)]*\)\s*\{/gm)) names.add(m[1])
+  for (const m of source.matchAll(/^\s{2,}([A-Za-z_$][\w$]*)\s*=\s*(?:async\s*)?\(/gm)) names.add(m[1])
+  /* 对象字面量里的方法（route 表这类）也给过。 */
+  for (const m of source.matchAll(/([A-Za-z_$][\w$]*)\s*:\s*(?:async\s*)?(?:function|\()/g)) names.add(m[1])
+  return names
+}
+
+/** 常见内置/外部注入成员，不要求在文件内定义。 */
+const BUILTIN = new Set([
+  'constructor', 'then', 'catch', 'finally', 'apply', 'call', 'bind', 'toString', 'valueOf',
+  'hasOwnProperty', 'push', 'pop', 'shift', 'unshift', 'slice', 'splice', 'map', 'filter',
+  'forEach', 'find', 'findIndex', 'some', 'every', 'reduce', 'join', 'split', 'trim',
+  'replace', 'includes', 'startsWith', 'endsWith', 'padStart', 'padEnd', 'toFixed',
+  'getTime', 'toISOString', 'keys', 'values', 'entries', 'set', 'get', 'delete', 'has',
+  'clear', 'add', 'size', 'length', 'emit', 'on', 'once', 'off', 'removeListener', 'end',
+  'write', 'pipe', 'read', 'kill', 'ref', 'unref', 'stdin', 'stdout', 'stderr',
+])
+
+let failures = 0
+const it = (label, run) => {
+  try {
+    run()
+    console.log(`  ✅ ${label}`)
+  } catch (error) {
+    failures += 1
+    console.log(`  ❌ ${label}\n     ${String(error?.message ?? error)}`)
+  }
+}
+const assert = (cond, msg) => {
+  if (!cond) throw new Error(msg)
+}
+
+for (const file of FILES) {
+  it(`${file}：this.* 调用都有定义`, () => {
+    const source = readFileSync(new URL(`../${file}`, import.meta.url), 'utf8')
+    const known = knownMembers(source)
+    const dangling = new Set()
+    for (const m of source.matchAll(/this\.([A-Za-z_$][\w$]*)\s*\(/g)) {
+      const name = m[1]
+      if (known.has(name) || BUILTIN.has(name)) continue
+      dangling.add(name)
+    }
+    assert(dangling.size === 0, `悬空调用：${[...dangling].join(', ')}（改名后残留会让插件回调抛 TypeError，host 直接退出）`)
+  })
+}
+
+/* 自检：故意造一份带残留调用的源码，确认扫描器抓得到，别写成永远绿的摆设。 */
+it('扫描器能抓到悬空调用（自检）', () => {
+  const broken = 'class A {\n  killOwn() {}\n  stop() {\n    if (this.n > 0) this.killStale()\n  }\n}\n'
+  const known = knownMembers(broken)
+  const dangling = [...broken.matchAll(/this\.([A-Za-z_$][\w$]*)\s*\(/g)]
+    .map((m) => m[1])
+    .filter((name) => !known.has(name) && !BUILTIN.has(name))
+  assert(dangling.includes('killStale'), '扫描器没抓到 killStale，说明这个测试本身失效了')
+})
+
+console.log(failures === 0 ? `\n=== 全部通过 ===` : `\n=== ${failures} 项失败 ===`)
+process.exitCode = failures === 0 ? 0 : 1

package/test/timers.test.mjs

@@ -0,0 +1,60 @@
+/**
+ * 定时器兜底扫描：宿主不隔离插件异常，定时器回调里任何一个 TypeError 都会冒到顶层，
+ * 整个 DSH 以 1 退出（2026-10-27 `this.killStale` 两次事故就是空闲回收定时器 → stop()）。
+ * 规则：host 侧所有节拍器/回收定时器的回调都要经过 guard()，单拍出错只记日志。
+ */
+import { readFileSync } from 'node:fs'
+
+/** 以 this 成员形式挂出去的定时器（节拍器与空闲/续录回收）。 */
+const PATTERN = /this\.(timer|pushTimer|idleTimer|restartTimer)\s*=\s*(?:setInterval|setTimeout)\(/g
+
+/** 从注册点往后看多远算「同一个回调」。 */
+const WINDOW = 160
+
+/** 找出没走 guard 的定时器注册。 @param {string} source - 文件源码。 @returns {string[]} 违规点。 */
+function unguarded(source) {
+  const bad = []
+  for (const m of source.matchAll(PATTERN)) {
+    const tail = source.slice(m.index, m.index + WINDOW)
+    if (!tail.includes('guard(')) bad.push(source.slice(m.index, m.index + 60).split('\n')[0])
+  }
+  return bad
+}
+
+let failures = 0
+const it = (label, run) => {
+  try {
+    run()
+    console.log(`  ✅ ${label}`)
+  } catch (error) {
+    failures += 1
+    console.log(`  ❌ ${label}\n     ${String(error?.message ?? error)}`)
+  }
+}
+const assert = (cond, msg) => {
+  if (!cond) throw new Error(msg)
+}
+
+for (const file of ['stream.js', 'mirror.js']) {
+  it(`${file}：定时器回调都经过 guard`, () => {
+    const bad = unguarded(readFileSync(new URL(`../${file}`, import.meta.url), 'utf8'))
+    assert(bad.length === 0, `未兜底的定时器：${bad.join(' | ')}`)
+  })
+}
+
+it('自检：没兜底的定时器会被抓出来', () => {
+  const fake = 'this.idleTimer = setTimeout(() => { this.stop() }, 20000)'
+  assert(unguarded(fake).length === 1, '扫描放过了一个裸定时器')
+})
+
+it('自检：兜底后的定时器不误报', () => {
+  const fake = "this.idleTimer = setTimeout(() => guard('idle-stop', () => { this.stop() }), 20000)"
+  assert(unguarded(fake).length === 0, '兜底写法被误判')
+})
+
+if (failures > 0) {
+  console.log(`=== ${failures} 项失败 ===`)
+  process.exitCode = 1
+} else {
+  console.log('=== 全部通过 ===')
+}