@lytjs/common-event-normalizer 6.5.0 → 6.6.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["EVENT_MODIFIER_RE"],"mappings":"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","file":"index.cjs","sourcesContent":["// @lytjs/common-event-normalizer\r\n// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件\r\n\r\nimport type { RendererHost, HostEvent, HostEventHandler, HostEventOptions } from '@lytjs/host-contract';\r\nimport { EVENT_MODIFIER_RE } from '@lytjs/common-events';\r\n\r\n// ============================================================\r\n// 类型定义\r\n// ============================================================\r\n\r\n/**\r\n * 事件修饰符解析结果。\r\n */\r\nexport interface ParsedModifiers {\r\n  /** 是否调用 stopPropagation */\r\n  stop: boolean;\r\n  /** 是否调用 preventDefault */\r\n  prevent: boolean;\r\n  /** 是否使用 capture 模式 */\r\n  capture: boolean;\r\n  /** 是否使用 once 模式 */\r\n  once: boolean;\r\n  /** 是否仅在 target === currentTarget 时触发 */\r\n  self: boolean;\r\n  /** 是否使用 passive 模式 */\r\n  passive: boolean;\r\n}\r\n\r\n/**\r\n * 解析后的事件信息。\r\n */\r\nexport interface ParsedEventInfo {\r\n  /** 规范化后的事件名（如 'click'） */\r\n  name: string;\r\n  /** 事件修饰符 */\r\n  modifiers: ParsedModifiers;\r\n}\r\n\r\n/**\r\n * 事件 invoker 接口。\r\n *\r\n * 持有 value 属性用于更新，避免重复 addEventListener。\r\n */\r\nexport interface EventInvoker<HE> {\r\n  /** 当前绑定的事件处理函数 */\r\n  value: ((event: HostEvent) => void) | null;\r\n  /** 解析后的事件信息 */\r\n  parsed: ParsedEventInfo;\r\n  /** 宿主元素引用 */\r\n  el: HE;\r\n  /** 实际的事件处理函数（传给 addEventListener 的函数） */\r\n  handler: (event: HostEvent) => void;\r\n  /** 取消监听函数 */\r\n  dispose: () => void;\r\n}\r\n\r\n/**\r\n * 事件监听器注册条目。\r\n */\r\nexport interface EventListenerEntry<HE> {\r\n  /** 宿主元素 */\r\n  el: HE;\r\n  /** 事件名 */\r\n  event: string;\r\n  /** 处理函数 */\r\n  handler: (event: HostEvent) => void;\r\n  /** 事件选项 */\r\n  options?: { capture?: boolean; once?: boolean; passive?: boolean };\r\n}\r\n\r\n// ============================================================\r\n// 常量\r\n// ============================================================\r\n\r\n/** invoker 缓存类型 */\r\ntype InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;\r\n\r\n// ============================================================\r\n// EventNormalizer\r\n// ============================================================\r\n\r\n/**\r\n * 事件归一化器。\r\n *\r\n * 负责解析事件名中的修饰符、管理事件 invoker 缓存，\r\n * 通过 RendererHost 接口执行平台无关的事件操作。\r\n *\r\n * @template HN - 宿主节点类型\r\n * @template HE - 宿主元素类型\r\n */\r\n// FIX: DTS build error - HN 必须约束为 object\r\nexport class EventNormalizer<HN extends object = object, HE extends HN = HN> {\r\n  /** RendererHost 实例 */\r\n  private host: RendererHost<HN, HE>;\r\n\r\n  /**\r\n   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染\r\n   * 键：宿主元素，值：该元素的事件 invoker 缓存\r\n   */\r\n  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();\r\n\r\n  /**\r\n   * 创建事件归一化器实例。\r\n   * @param host - RendererHost 实例\r\n   */\r\n  constructor(host: RendererHost<HN, HE>) {\r\n    this.host = host;\r\n  }\r\n\r\n  // ==========================================================\r\n  // 事件名解析\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 解析事件名。\r\n   *\r\n   * 将各种格式的事件名规范化并提取修饰符：\r\n   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }\r\n   * - @click.capture → { name: 'click', modifiers: { capture: true } }\r\n   * - click → { name: 'click', modifiers: { stop: false, ... } }\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 解析后的事件信息\r\n   */\r\n  parseEventName(rawName: string): ParsedEventInfo {\r\n    const name = this.normalizeEventName(rawName);\r\n    const modifiers = this.parseModifiers(rawName);\r\n\r\n    return { name, modifiers };\r\n  }\r\n\r\n  /**\r\n   * 将原始事件名规范化为标准事件名。\r\n   *\r\n   * 支持格式：@click / onClick / click → click\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 规范化后的事件名\r\n   */\r\n  normalizeEventName(rawName: string): string {\r\n    // 移除 @ 前缀\r\n    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;\r\n\r\n    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）\r\n    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符\r\n    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {\r\n      name = name.slice(2);\r\n    }\r\n\r\n    // 移除修饰符后缀（如 .stop.prevent）\r\n    name = name.replace(EVENT_MODIFIER_RE, '');\r\n\r\n    // 转为小写\r\n    return name.toLowerCase();\r\n  }\r\n\r\n  /**\r\n   * 解析事件名中的修饰符。\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 修饰符集合\r\n   */\r\n  parseModifiers(rawName: string): ParsedModifiers {\r\n    const modifiers: ParsedModifiers = {\r\n      stop: false,\r\n      prevent: false,\r\n      capture: false,\r\n      once: false,\r\n      self: false,\r\n      passive: false,\r\n    };\r\n\r\n    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则\r\n    const RE_EVENT_MODIFIERS = /\\.(stop|prevent|capture|once|self|passive)/g;\r\n    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符\r\n    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);\r\n    if (modifierMatch) {\r\n      for (const mod of modifierMatch) {\r\n        switch (mod) {\r\n          case '.stop':\r\n            modifiers.stop = true;\r\n            break;\r\n          case '.prevent':\r\n            modifiers.prevent = true;\r\n            break;\r\n          case '.capture':\r\n            modifiers.capture = true;\r\n            break;\r\n          case '.once':\r\n            modifiers.once = true;\r\n            break;\r\n          case '.self':\r\n            modifiers.self = true;\r\n            break;\r\n          case '.passive':\r\n            modifiers.passive = true;\r\n            break;\r\n        }\r\n      }\r\n    }\r\n\r\n    return modifiers;\r\n  }\r\n\r\n  // ==========================================================\r\n  // 事件名 → 缓存 key 转换\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 将事件名转换为 invoker 缓存的 key。\r\n   *\r\n   * click → onClick，mouseenter → onMouseenter\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 缓存 key\r\n   */\r\n  getEventKey(rawName: string): string {\r\n    const name = this.normalizeEventName(rawName);\r\n    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined\r\n    if (!name) return 'on';\r\n    return 'on' + name[0]!.toUpperCase() + name.slice(1);\r\n  }\r\n\r\n  // ==========================================================\r\n  // Invoker 缓存模式\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 更新元素上的事件监听（invoker 缓存模式）。\r\n   *\r\n   * 四种情况：\r\n   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）\r\n   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener\r\n   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存\r\n   * 4. !nextValue && !existingInvoker → 无操作\r\n   *\r\n   * @param el - 宿主元素\r\n   * @param rawName - 原始事件名\r\n   * @param nextValue - 新的事件处理函数\r\n   */\r\n  patchEvent(\r\n    el: HE,\r\n    rawName: string,\r\n    nextValue: HostEventHandler | null,\r\n  ): void {\r\n    const eventKey = this.getEventKey(rawName);\r\n    const parsed = this.parseEventName(rawName);\r\n\r\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\r\n    let invokers = this.invokerCache.get(el);\r\n    if (!invokers) {\r\n      invokers = {};\r\n      this.invokerCache.set(el, invokers);\r\n    }\r\n\r\n    const existingInvoker = invokers[eventKey];\r\n\r\n    if (nextValue && existingInvoker) {\r\n      // 情况 1：有新值 + 有旧 invoker → 直接替换 value\r\n      existingInvoker.value = nextValue;\r\n    } else if (nextValue && !existingInvoker) {\r\n      // 情况 2：有新值 + 无旧 invoker → 创建并绑定\r\n      const invoker = this.createInvoker(el, parsed, nextValue);\r\n      invokers[eventKey] = invoker;\r\n\r\n      const options = this.buildHostEventOptions(parsed.modifiers);\r\n      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，\r\n      // 确保后续可以通过 invoker.dispose() 正确移除事件监听\r\n      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);\r\n      invoker.dispose = () => {\r\n        hostDispose();\r\n        // 同时清理内部状态\r\n        (invoker as { value?: HostEventHandler | null }).value = null;\r\n      };\r\n    } else if (!nextValue && existingInvoker) {\r\n      // 情况 3：无新值 + 有旧 invoker → 移除\r\n      const options = this.buildHostEventOptions(parsed.modifiers);\r\n      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);\r\n      invokers[eventKey] = undefined;\r\n    }\r\n    // 情况 4：无新值 + 无旧 invoker → 无操作\r\n  }\r\n\r\n  /**\r\n   * 移除元素上所有通过 invoker 缓存的事件监听。\r\n   *\r\n   * @param el - 宿主元素\r\n   */\r\n  removeAllEventListeners(el: HE): void {\r\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\r\n    const invokers = this.invokerCache.get(el);\r\n    if (!invokers) return;\r\n\r\n    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性\r\n    for (const eventKey of Object.keys(invokers)) {\r\n      const invoker = invokers[eventKey];\r\n      if (invoker) {\r\n        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，\r\n        // 确保能正确匹配 addEventListener 时注册的包装 handler\r\n        const options = this.buildHostEventOptions(invoker.parsed.modifiers);\r\n        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);\r\n      }\r\n    }\r\n\r\n    // 从 WeakMap 中删除该元素的缓存\r\n    this.invokerCache.delete(el);\r\n  }\r\n\r\n  // ==========================================================\r\n  // 内部方法\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 创建事件 invoker。\r\n   *\r\n   * invoker 持有 value 属性，调用时执行 invoker.value(event)。\r\n   * 修饰符在 invoker 内部处理，更新时仅需替换 value。\r\n   */\r\n  private createInvoker(\r\n    el: HE,\r\n    parsed: ParsedEventInfo,\r\n    initialValue: HostEventHandler,\r\n  ): EventInvoker<HE> {\r\n    let currentValue: HostEventHandler | null = initialValue;\r\n    let disposed = false;\r\n\r\n    const handler: HostEventHandler = (event: HostEvent) => {\r\n      if (disposed) return;\r\n\r\n      // 处理修饰符\r\n      if (parsed.modifiers.stop) {\r\n        event.stopPropagation();\r\n      }\r\n      if (parsed.modifiers.prevent) {\r\n        event.preventDefault();\r\n      }\r\n      if (parsed.modifiers.self && event.target !== event.currentTarget) {\r\n        return;\r\n      }\r\n\r\n      if (currentValue) {\r\n        currentValue(event);\r\n      }\r\n    };\r\n\r\n    const invoker: EventInvoker<HE> = {\r\n      get value() {\r\n        return currentValue;\r\n      },\r\n      set value(fn: HostEventHandler | null) {\r\n        currentValue = fn;\r\n      },\r\n      parsed,\r\n      el,\r\n      handler,\r\n      dispose: () => {\r\n        disposed = true;\r\n        currentValue = null;\r\n      },\r\n    };\r\n\r\n    return invoker;\r\n  }\r\n\r\n  /**\r\n   * 根据 ParsedModifiers 构建 HostEventOptions。\r\n   */\r\n  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {\r\n    if (modifiers.capture || modifiers.once || modifiers.passive) {\r\n      const options: HostEventOptions = {};\r\n      if (modifiers.capture) options.capture = true;\r\n      if (modifiers.once) options.once = true;\r\n      if (modifiers.passive) options.passive = true;\r\n      return options;\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["EVENT_MODIFIER_RE"],"mappings":"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","file":"index.cjs","sourcesContent":["// @lytjs/common-event-normalizer\n// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件\n\nimport type {\n  RendererHost,\n  HostEvent,\n  HostEventHandler,\n  HostEventOptions,\n} from '@lytjs/host-contract';\nimport { EVENT_MODIFIER_RE } from '@lytjs/common-events';\n\n// ============================================================\n// 类型定义\n// ============================================================\n\n/**\n * 事件修饰符解析结果。\n */\nexport interface ParsedModifiers {\n  /** 是否调用 stopPropagation */\n  stop: boolean;\n  /** 是否调用 preventDefault */\n  prevent: boolean;\n  /** 是否使用 capture 模式 */\n  capture: boolean;\n  /** 是否使用 once 模式 */\n  once: boolean;\n  /** 是否仅在 target === currentTarget 时触发 */\n  self: boolean;\n  /** 是否使用 passive 模式 */\n  passive: boolean;\n}\n\n/**\n * 解析后的事件信息。\n */\nexport interface ParsedEventInfo {\n  /** 规范化后的事件名（如 'click'） */\n  name: string;\n  /** 事件修饰符 */\n  modifiers: ParsedModifiers;\n}\n\n/**\n * 事件 invoker 接口。\n *\n * 持有 value 属性用于更新，避免重复 addEventListener。\n */\nexport interface EventInvoker<HE> {\n  /** 当前绑定的事件处理函数 */\n  value: ((event: HostEvent) => void) | null;\n  /** 解析后的事件信息 */\n  parsed: ParsedEventInfo;\n  /** 宿主元素引用 */\n  el: HE;\n  /** 实际的事件处理函数（传给 addEventListener 的函数） */\n  handler: (event: HostEvent) => void;\n  /** 取消监听函数 */\n  dispose: () => void;\n}\n\n/**\n * 事件监听器注册条目。\n */\nexport interface EventListenerEntry<HE> {\n  /** 宿主元素 */\n  el: HE;\n  /** 事件名 */\n  event: string;\n  /** 处理函数 */\n  handler: (event: HostEvent) => void;\n  /** 事件选项 */\n  options?: { capture?: boolean; once?: boolean; passive?: boolean };\n}\n\n// ============================================================\n// 常量\n// ============================================================\n\n/** invoker 缓存类型 */\ntype InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;\n\n// ============================================================\n// EventNormalizer\n// ============================================================\n\n/**\n * 事件归一化器。\n *\n * 负责解析事件名中的修饰符、管理事件 invoker 缓存，\n * 通过 RendererHost 接口执行平台无关的事件操作。\n *\n * @template HN - 宿主节点类型\n * @template HE - 宿主元素类型\n */\n// FIX: DTS build error - HN 必须约束为 object\nexport class EventNormalizer<HN extends object = object, HE extends HN = HN> {\n  /** RendererHost 实例 */\n  private host: RendererHost<HN, HE>;\n\n  /**\n   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染\n   * 键：宿主元素，值：该元素的事件 invoker 缓存\n   */\n  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();\n\n  /**\n   * 创建事件归一化器实例。\n   * @param host - RendererHost 实例\n   */\n  constructor(host: RendererHost<HN, HE>) {\n    this.host = host;\n  }\n\n  // ==========================================================\n  // 事件名解析\n  // ==========================================================\n\n  /**\n   * 解析事件名。\n   *\n   * 将各种格式的事件名规范化并提取修饰符：\n   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }\n   * - @click.capture → { name: 'click', modifiers: { capture: true } }\n   * - click → { name: 'click', modifiers: { stop: false, ... } }\n   *\n   * @param rawName - 原始事件名\n   * @returns 解析后的事件信息\n   */\n  parseEventName(rawName: string): ParsedEventInfo {\n    const name = this.normalizeEventName(rawName);\n    const modifiers = this.parseModifiers(rawName);\n\n    return { name, modifiers };\n  }\n\n  /**\n   * 将原始事件名规范化为标准事件名。\n   *\n   * 支持格式：@click / onClick / click → click\n   *\n   * @param rawName - 原始事件名\n   * @returns 规范化后的事件名\n   */\n  normalizeEventName(rawName: string): string {\n    // 移除 @ 前缀\n    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;\n\n    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）\n    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符\n    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {\n      name = name.slice(2);\n    }\n\n    // 移除修饰符后缀（如 .stop.prevent）\n    name = name.replace(EVENT_MODIFIER_RE, '');\n\n    // 转为小写\n    return name.toLowerCase();\n  }\n\n  /**\n   * 解析事件名中的修饰符。\n   *\n   * @param rawName - 原始事件名\n   * @returns 修饰符集合\n   */\n  parseModifiers(rawName: string): ParsedModifiers {\n    const modifiers: ParsedModifiers = {\n      stop: false,\n      prevent: false,\n      capture: false,\n      once: false,\n      self: false,\n      passive: false,\n    };\n\n    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则\n    const RE_EVENT_MODIFIERS = /\\.(stop|prevent|capture|once|self|passive)/g;\n    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符\n    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);\n    if (modifierMatch) {\n      for (const mod of modifierMatch) {\n        switch (mod) {\n          case '.stop':\n            modifiers.stop = true;\n            break;\n          case '.prevent':\n            modifiers.prevent = true;\n            break;\n          case '.capture':\n            modifiers.capture = true;\n            break;\n          case '.once':\n            modifiers.once = true;\n            break;\n          case '.self':\n            modifiers.self = true;\n            break;\n          case '.passive':\n            modifiers.passive = true;\n            break;\n        }\n      }\n    }\n\n    return modifiers;\n  }\n\n  // ==========================================================\n  // 事件名 → 缓存 key 转换\n  // ==========================================================\n\n  /**\n   * 将事件名转换为 invoker 缓存的 key。\n   *\n   * click → onClick，mouseenter → onMouseenter\n   *\n   * @param rawName - 原始事件名\n   * @returns 缓存 key\n   */\n  getEventKey(rawName: string): string {\n    const name = this.normalizeEventName(rawName);\n    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined\n    if (!name) return 'on';\n    return 'on' + name[0]!.toUpperCase() + name.slice(1);\n  }\n\n  // ==========================================================\n  // Invoker 缓存模式\n  // ==========================================================\n\n  /**\n   * 更新元素上的事件监听（invoker 缓存模式）。\n   *\n   * 四种情况：\n   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）\n   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener\n   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存\n   * 4. !nextValue && !existingInvoker → 无操作\n   *\n   * @param el - 宿主元素\n   * @param rawName - 原始事件名\n   * @param nextValue - 新的事件处理函数\n   */\n  patchEvent(el: HE, rawName: string, nextValue: HostEventHandler | null): void {\n    const eventKey = this.getEventKey(rawName);\n    const parsed = this.parseEventName(rawName);\n\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\n    let invokers = this.invokerCache.get(el);\n    if (!invokers) {\n      invokers = {};\n      this.invokerCache.set(el, invokers);\n    }\n\n    const existingInvoker = invokers[eventKey];\n\n    if (nextValue && existingInvoker) {\n      // 情况 1：有新值 + 有旧 invoker → 直接替换 value\n      existingInvoker.value = nextValue;\n    } else if (nextValue && !existingInvoker) {\n      // 情况 2：有新值 + 无旧 invoker → 创建并绑定\n      const invoker = this.createInvoker(el, parsed, nextValue);\n      invokers[eventKey] = invoker;\n\n      const options = this.buildHostEventOptions(parsed.modifiers);\n      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，\n      // 确保后续可以通过 invoker.dispose() 正确移除事件监听\n      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);\n      invoker.dispose = () => {\n        hostDispose();\n        // 同时清理内部状态\n        (invoker as { value?: HostEventHandler | null }).value = null;\n      };\n    } else if (!nextValue && existingInvoker) {\n      // 情况 3：无新值 + 有旧 invoker → 移除\n      const options = this.buildHostEventOptions(parsed.modifiers);\n      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);\n      invokers[eventKey] = undefined;\n    }\n    // 情况 4：无新值 + 无旧 invoker → 无操作\n  }\n\n  /**\n   * 移除元素上所有通过 invoker 缓存的事件监听。\n   *\n   * @param el - 宿主元素\n   */\n  removeAllEventListeners(el: HE): void {\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\n    const invokers = this.invokerCache.get(el);\n    if (!invokers) return;\n\n    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性\n    for (const eventKey of Object.keys(invokers)) {\n      const invoker = invokers[eventKey];\n      if (invoker) {\n        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，\n        // 确保能正确匹配 addEventListener 时注册的包装 handler\n        const options = this.buildHostEventOptions(invoker.parsed.modifiers);\n        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);\n      }\n    }\n\n    // 从 WeakMap 中删除该元素的缓存\n    this.invokerCache.delete(el);\n  }\n\n  // ==========================================================\n  // 内部方法\n  // ==========================================================\n\n  /**\n   * 创建事件 invoker。\n   *\n   * invoker 持有 value 属性，调用时执行 invoker.value(event)。\n   * 修饰符在 invoker 内部处理，更新时仅需替换 value。\n   */\n  private createInvoker(\n    el: HE,\n    parsed: ParsedEventInfo,\n    initialValue: HostEventHandler,\n  ): EventInvoker<HE> {\n    let currentValue: HostEventHandler | null = initialValue;\n    let disposed = false;\n\n    const handler: HostEventHandler = (event: HostEvent) => {\n      if (disposed) return;\n\n      // 处理修饰符\n      if (parsed.modifiers.stop) {\n        event.stopPropagation();\n      }\n      if (parsed.modifiers.prevent) {\n        event.preventDefault();\n      }\n      if (parsed.modifiers.self && event.target !== event.currentTarget) {\n        return;\n      }\n\n      if (currentValue) {\n        currentValue(event);\n      }\n    };\n\n    const invoker: EventInvoker<HE> = {\n      get value() {\n        return currentValue;\n      },\n      set value(fn: HostEventHandler | null) {\n        currentValue = fn;\n      },\n      parsed,\n      el,\n      handler,\n      dispose: () => {\n        disposed = true;\n        currentValue = null;\n      },\n    };\n\n    return invoker;\n  }\n\n  /**\n   * 根据 ParsedModifiers 构建 HostEventOptions。\n   */\n  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {\n    if (modifiers.capture || modifiers.once || modifiers.passive) {\n      const options: HostEventOptions = {};\n      if (modifiers.capture) options.capture = true;\n      if (modifiers.once) options.once = true;\n      if (modifiers.passive) options.passive = true;\n      return options;\n    }\n    return undefined;\n  }\n}\n"]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA2FO,IAAM,kBAAN,MAAsE;AAAA;AAAA;AAAA;AAAA;AAAA,EAc3E,YAAY,IAAA,EAA4B;AANxC;AAAA;AAAA;AAAA;AAAA,IAAA,IAAA,CAAQ,YAAA,uBAAmB,OAAA,EAA8B;AAOvD,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,eAAe,OAAA,EAAkC;AAC/C,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,kBAAA,CAAmB,OAAO,CAAA;AAC5C,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,cAAA,CAAe,OAAO,CAAA;AAE7C,IAAA,OAAO,EAAE,MAAM,SAAA,EAAU;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,mBAAmB,OAAA,EAAyB;AAE1C,IAAA,IAAI,IAAA,GAAO,QAAQ,UAAA,CAAW,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAC,CAAA,GAAI,OAAA;AAIxD,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAI,CAAA,IAAK,IAAA,CAAK,MAAA,GAAS,CAAA,IAAK,YAAA,CAAa,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,CAAC,CAAC,CAAA,EAAG;AACjF,MAAA,IAAA,GAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,IACrB;AAGA,IAAA,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,iBAAA,EAAmB,EAAE,CAAA;AAGzC,IAAA,OAAO,KAAK,WAAA,EAAY;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAe,OAAA,EAAkC;AAC/C,IAAA,MAAM,SAAA,GAA6B;AAAA,MACjC,IAAA,EAAM,KAAA;AAAA,MACN,OAAA,EAAS,KAAA;AAAA,MACT,OAAA,EAAS,KAAA;AAAA,MACT,IAAA,EAAM,KAAA;AAAA,MACN,IAAA,EAAM,KAAA;AAAA,MACN,OAAA,EAAS;AAAA,KACX;AAGA,IAAA,MAAM,kBAAA,GAAqB,6CAAA;AAE3B,IAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,KAAA,CAAM,kBAAkB,CAAA;AACtD,IAAA,IAAI,aAAA,EAAe;AACjB,MAAA,KAAA,MAAW,OAAO,aAAA,EAAe;AAC/B,QAAA,QAAQ,GAAA;AAAK,UACX,KAAK,OAAA;AACH,YAAA,SAAA,CAAU,IAAA,GAAO,IAAA;AACjB,YAAA;AAAA,UACF,KAAK,UAAA;AACH,YAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AACpB,YAAA;AAAA,UACF,KAAK,UAAA;AACH,YAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AACpB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,SAAA,CAAU,IAAA,GAAO,IAAA;AACjB,YAAA;AAAA,UACF,KAAK,OAAA;AACH,YAAA,SAAA,CAAU,IAAA,GAAO,IAAA;AACjB,YAAA;AAAA,UACF,KAAK,UAAA;AACH,YAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AACpB,YAAA;AAAA;AACJ,MACF;AAAA,IACF;AAEA,IAAA,OAAO,SAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,YAAY,OAAA,EAAyB;AACnC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,kBAAA,CAAmB,OAAO,CAAA;AAE5C,IAAA,IAAI,CAAC,MAAM,OAAO,IAAA;AAClB,IAAA,OAAO,IAAA,GAAO,KAAK,CAAC,CAAA,CAAG,aAAY,GAAI,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,UAAA,CACE,EAAA,EACA,OAAA,EACA,SAAA,EACM;AACN,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,WAAA,CAAY,OAAO,CAAA;AACzC,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,cAAA,CAAe,OAAO,CAAA;AAG1C,IAAA,IAAI,QAAA,GAAW,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,EAAE,CAAA;AACvC,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,QAAA,GAAW,EAAC;AACZ,MAAA,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,EAAA,EAAI,QAAQ,CAAA;AAAA,IACpC;AAEA,IAAA,MAAM,eAAA,GAAkB,SAAS,QAAQ,CAAA;AAEzC,IAAA,IAAI,aAAa,eAAA,EAAiB;AAEhC,MAAA,eAAA,CAAgB,KAAA,GAAQ,SAAA;AAAA,IAC1B,CAAA,MAAA,IAAW,SAAA,IAAa,CAAC,eAAA,EAAiB;AAExC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,aAAA,CAAc,EAAA,EAAI,QAAQ,SAAS,CAAA;AACxD,MAAA,QAAA,CAAS,QAAQ,CAAA,GAAI,OAAA;AAErB,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,qBAAA,CAAsB,MAAA,CAAO,SAAS,CAAA;AAG3D,MAAA,MAAM,WAAA,GAAc,KAAK,IAAA,CAAK,gBAAA,CAAiB,IAAI,MAAA,CAAO,IAAA,EAAM,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAA;AACxF,MAAA,OAAA,CAAQ,UAAU,MAAM;AACtB,QAAA,WAAA,EAAY;AAEZ,QAAC,QAAgD,KAAA,GAAQ,IAAA;AAAA,MAC3D,CAAA;AAAA,IACF,CAAA,MAAA,IAAW,CAAC,SAAA,IAAa,eAAA,EAAiB;AAExC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,qBAAA,CAAsB,MAAA,CAAO,SAAS,CAAA;AAC3D,MAAA,IAAA,CAAK,KAAK,mBAAA,CAAoB,EAAA,EAAI,OAAO,IAAA,EAAM,eAAA,CAAgB,SAAS,OAAO,CAAA;AAC/E,MAAA,QAAA,CAAS,QAAQ,CAAA,GAAI,MAAA;AAAA,IACvB;AAAA,EAEF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAwB,EAAA,EAAc;AAEpC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,EAAE,CAAA;AACzC,IAAA,IAAI,CAAC,QAAA,EAAU;AAGf,IAAA,KAAA,MAAW,QAAA,IAAY,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,EAAG;AAC5C,MAAA,MAAM,OAAA,GAAU,SAAS,QAAQ,CAAA;AACjC,MAAA,IAAI,OAAA,EAAS;AAGX,QAAA,MAAM,OAAA,GAAU,IAAA,CAAK,qBAAA,CAAsB,OAAA,CAAQ,OAAO,SAAS,CAAA;AACnE,QAAA,IAAA,CAAK,IAAA,CAAK,oBAAoB,EAAA,EAAI,OAAA,CAAQ,OAAO,IAAA,EAAM,OAAA,CAAQ,SAAS,OAAO,CAAA;AAAA,MACjF;AAAA,IACF;AAGA,IAAA,IAAA,CAAK,YAAA,CAAa,OAAO,EAAE,CAAA;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYQ,aAAA,CACN,EAAA,EACA,MAAA,EACA,YAAA,EACkB;AAClB,IAAA,IAAI,YAAA,GAAwC,YAAA;AAC5C,IAAA,IAAI,QAAA,GAAW,KAAA;AAEf,IAAA,MAAM,OAAA,GAA4B,CAAC,KAAA,KAAqB;AACtD,MAAA,IAAI,QAAA,EAAU;AAGd,MAAA,IAAI,MAAA,CAAO,UAAU,IAAA,EAAM;AACzB,QAAA,KAAA,CAAM,eAAA,EAAgB;AAAA,MACxB;AACA,MAAA,IAAI,MAAA,CAAO,UAAU,OAAA,EAAS;AAC5B,QAAA,KAAA,CAAM,cAAA,EAAe;AAAA,MACvB;AACA,MAAA,IAAI,OAAO,SAAA,CAAU,IAAA,IAAQ,KAAA,CAAM,MAAA,KAAW,MAAM,aAAA,EAAe;AACjE,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,YAAA,EAAc;AAChB,QAAA,YAAA,CAAa,KAAK,CAAA;AAAA,MACpB;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,OAAA,GAA4B;AAAA,MAChC,IAAI,KAAA,GAAQ;AACV,QAAA,OAAO,YAAA;AAAA,MACT,CAAA;AAAA,MACA,IAAI,MAAM,EAAA,EAA6B;AACrC,QAAA,YAAA,GAAe,EAAA;AAAA,MACjB,CAAA;AAAA,MACA,MAAA;AAAA,MACA,EAAA;AAAA,MACA,OAAA;AAAA,MACA,SAAS,MAAM;AACb,QAAA,QAAA,GAAW,IAAA;AACX,QAAA,YAAA,GAAe,IAAA;AAAA,MACjB;AAAA,KACF;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,sBAAsB,SAAA,EAA0D;AACtF,IAAA,IAAI,SAAA,CAAU,OAAA,IAAW,SAAA,CAAU,IAAA,IAAQ,UAAU,OAAA,EAAS;AAC5D,MAAA,MAAM,UAA4B,EAAC;AACnC,MAAA,IAAI,SAAA,CAAU,OAAA,EAAS,OAAA,CAAQ,OAAA,GAAU,IAAA;AACzC,MAAA,IAAI,SAAA,CAAU,IAAA,EAAM,OAAA,CAAQ,IAAA,GAAO,IAAA;AACnC,MAAA,IAAI,SAAA,CAAU,OAAA,EAAS,OAAA,CAAQ,OAAA,GAAU,IAAA;AACzC,MAAA,OAAO,OAAA;AAAA,IACT;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACF","file":"index.mjs","sourcesContent":["// @lytjs/common-event-normalizer\r\n// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件\r\n\r\nimport type { RendererHost, HostEvent, HostEventHandler, HostEventOptions } from '@lytjs/host-contract';\r\nimport { EVENT_MODIFIER_RE } from '@lytjs/common-events';\r\n\r\n// ============================================================\r\n// 类型定义\r\n// ============================================================\r\n\r\n/**\r\n * 事件修饰符解析结果。\r\n */\r\nexport interface ParsedModifiers {\r\n  /** 是否调用 stopPropagation */\r\n  stop: boolean;\r\n  /** 是否调用 preventDefault */\r\n  prevent: boolean;\r\n  /** 是否使用 capture 模式 */\r\n  capture: boolean;\r\n  /** 是否使用 once 模式 */\r\n  once: boolean;\r\n  /** 是否仅在 target === currentTarget 时触发 */\r\n  self: boolean;\r\n  /** 是否使用 passive 模式 */\r\n  passive: boolean;\r\n}\r\n\r\n/**\r\n * 解析后的事件信息。\r\n */\r\nexport interface ParsedEventInfo {\r\n  /** 规范化后的事件名（如 'click'） */\r\n  name: string;\r\n  /** 事件修饰符 */\r\n  modifiers: ParsedModifiers;\r\n}\r\n\r\n/**\r\n * 事件 invoker 接口。\r\n *\r\n * 持有 value 属性用于更新，避免重复 addEventListener。\r\n */\r\nexport interface EventInvoker<HE> {\r\n  /** 当前绑定的事件处理函数 */\r\n  value: ((event: HostEvent) => void) | null;\r\n  /** 解析后的事件信息 */\r\n  parsed: ParsedEventInfo;\r\n  /** 宿主元素引用 */\r\n  el: HE;\r\n  /** 实际的事件处理函数（传给 addEventListener 的函数） */\r\n  handler: (event: HostEvent) => void;\r\n  /** 取消监听函数 */\r\n  dispose: () => void;\r\n}\r\n\r\n/**\r\n * 事件监听器注册条目。\r\n */\r\nexport interface EventListenerEntry<HE> {\r\n  /** 宿主元素 */\r\n  el: HE;\r\n  /** 事件名 */\r\n  event: string;\r\n  /** 处理函数 */\r\n  handler: (event: HostEvent) => void;\r\n  /** 事件选项 */\r\n  options?: { capture?: boolean; once?: boolean; passive?: boolean };\r\n}\r\n\r\n// ============================================================\r\n// 常量\r\n// ============================================================\r\n\r\n/** invoker 缓存类型 */\r\ntype InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;\r\n\r\n// ============================================================\r\n// EventNormalizer\r\n// ============================================================\r\n\r\n/**\r\n * 事件归一化器。\r\n *\r\n * 负责解析事件名中的修饰符、管理事件 invoker 缓存，\r\n * 通过 RendererHost 接口执行平台无关的事件操作。\r\n *\r\n * @template HN - 宿主节点类型\r\n * @template HE - 宿主元素类型\r\n */\r\n// FIX: DTS build error - HN 必须约束为 object\r\nexport class EventNormalizer<HN extends object = object, HE extends HN = HN> {\r\n  /** RendererHost 实例 */\r\n  private host: RendererHost<HN, HE>;\r\n\r\n  /**\r\n   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染\r\n   * 键：宿主元素，值：该元素的事件 invoker 缓存\r\n   */\r\n  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();\r\n\r\n  /**\r\n   * 创建事件归一化器实例。\r\n   * @param host - RendererHost 实例\r\n   */\r\n  constructor(host: RendererHost<HN, HE>) {\r\n    this.host = host;\r\n  }\r\n\r\n  // ==========================================================\r\n  // 事件名解析\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 解析事件名。\r\n   *\r\n   * 将各种格式的事件名规范化并提取修饰符：\r\n   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }\r\n   * - @click.capture → { name: 'click', modifiers: { capture: true } }\r\n   * - click → { name: 'click', modifiers: { stop: false, ... } }\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 解析后的事件信息\r\n   */\r\n  parseEventName(rawName: string): ParsedEventInfo {\r\n    const name = this.normalizeEventName(rawName);\r\n    const modifiers = this.parseModifiers(rawName);\r\n\r\n    return { name, modifiers };\r\n  }\r\n\r\n  /**\r\n   * 将原始事件名规范化为标准事件名。\r\n   *\r\n   * 支持格式：@click / onClick / click → click\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 规范化后的事件名\r\n   */\r\n  normalizeEventName(rawName: string): string {\r\n    // 移除 @ 前缀\r\n    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;\r\n\r\n    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）\r\n    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符\r\n    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {\r\n      name = name.slice(2);\r\n    }\r\n\r\n    // 移除修饰符后缀（如 .stop.prevent）\r\n    name = name.replace(EVENT_MODIFIER_RE, '');\r\n\r\n    // 转为小写\r\n    return name.toLowerCase();\r\n  }\r\n\r\n  /**\r\n   * 解析事件名中的修饰符。\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 修饰符集合\r\n   */\r\n  parseModifiers(rawName: string): ParsedModifiers {\r\n    const modifiers: ParsedModifiers = {\r\n      stop: false,\r\n      prevent: false,\r\n      capture: false,\r\n      once: false,\r\n      self: false,\r\n      passive: false,\r\n    };\r\n\r\n    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则\r\n    const RE_EVENT_MODIFIERS = /\\.(stop|prevent|capture|once|self|passive)/g;\r\n    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符\r\n    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);\r\n    if (modifierMatch) {\r\n      for (const mod of modifierMatch) {\r\n        switch (mod) {\r\n          case '.stop':\r\n            modifiers.stop = true;\r\n            break;\r\n          case '.prevent':\r\n            modifiers.prevent = true;\r\n            break;\r\n          case '.capture':\r\n            modifiers.capture = true;\r\n            break;\r\n          case '.once':\r\n            modifiers.once = true;\r\n            break;\r\n          case '.self':\r\n            modifiers.self = true;\r\n            break;\r\n          case '.passive':\r\n            modifiers.passive = true;\r\n            break;\r\n        }\r\n      }\r\n    }\r\n\r\n    return modifiers;\r\n  }\r\n\r\n  // ==========================================================\r\n  // 事件名 → 缓存 key 转换\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 将事件名转换为 invoker 缓存的 key。\r\n   *\r\n   * click → onClick，mouseenter → onMouseenter\r\n   *\r\n   * @param rawName - 原始事件名\r\n   * @returns 缓存 key\r\n   */\r\n  getEventKey(rawName: string): string {\r\n    const name = this.normalizeEventName(rawName);\r\n    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined\r\n    if (!name) return 'on';\r\n    return 'on' + name[0]!.toUpperCase() + name.slice(1);\r\n  }\r\n\r\n  // ==========================================================\r\n  // Invoker 缓存模式\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 更新元素上的事件监听（invoker 缓存模式）。\r\n   *\r\n   * 四种情况：\r\n   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）\r\n   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener\r\n   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存\r\n   * 4. !nextValue && !existingInvoker → 无操作\r\n   *\r\n   * @param el - 宿主元素\r\n   * @param rawName - 原始事件名\r\n   * @param nextValue - 新的事件处理函数\r\n   */\r\n  patchEvent(\r\n    el: HE,\r\n    rawName: string,\r\n    nextValue: HostEventHandler | null,\r\n  ): void {\r\n    const eventKey = this.getEventKey(rawName);\r\n    const parsed = this.parseEventName(rawName);\r\n\r\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\r\n    let invokers = this.invokerCache.get(el);\r\n    if (!invokers) {\r\n      invokers = {};\r\n      this.invokerCache.set(el, invokers);\r\n    }\r\n\r\n    const existingInvoker = invokers[eventKey];\r\n\r\n    if (nextValue && existingInvoker) {\r\n      // 情况 1：有新值 + 有旧 invoker → 直接替换 value\r\n      existingInvoker.value = nextValue;\r\n    } else if (nextValue && !existingInvoker) {\r\n      // 情况 2：有新值 + 无旧 invoker → 创建并绑定\r\n      const invoker = this.createInvoker(el, parsed, nextValue);\r\n      invokers[eventKey] = invoker;\r\n\r\n      const options = this.buildHostEventOptions(parsed.modifiers);\r\n      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，\r\n      // 确保后续可以通过 invoker.dispose() 正确移除事件监听\r\n      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);\r\n      invoker.dispose = () => {\r\n        hostDispose();\r\n        // 同时清理内部状态\r\n        (invoker as { value?: HostEventHandler | null }).value = null;\r\n      };\r\n    } else if (!nextValue && existingInvoker) {\r\n      // 情况 3：无新值 + 有旧 invoker → 移除\r\n      const options = this.buildHostEventOptions(parsed.modifiers);\r\n      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);\r\n      invokers[eventKey] = undefined;\r\n    }\r\n    // 情况 4：无新值 + 无旧 invoker → 无操作\r\n  }\r\n\r\n  /**\r\n   * 移除元素上所有通过 invoker 缓存的事件监听。\r\n   *\r\n   * @param el - 宿主元素\r\n   */\r\n  removeAllEventListeners(el: HE): void {\r\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\r\n    const invokers = this.invokerCache.get(el);\r\n    if (!invokers) return;\r\n\r\n    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性\r\n    for (const eventKey of Object.keys(invokers)) {\r\n      const invoker = invokers[eventKey];\r\n      if (invoker) {\r\n        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，\r\n        // 确保能正确匹配 addEventListener 时注册的包装 handler\r\n        const options = this.buildHostEventOptions(invoker.parsed.modifiers);\r\n        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);\r\n      }\r\n    }\r\n\r\n    // 从 WeakMap 中删除该元素的缓存\r\n    this.invokerCache.delete(el);\r\n  }\r\n\r\n  // ==========================================================\r\n  // 内部方法\r\n  // ==========================================================\r\n\r\n  /**\r\n   * 创建事件 invoker。\r\n   *\r\n   * invoker 持有 value 属性，调用时执行 invoker.value(event)。\r\n   * 修饰符在 invoker 内部处理，更新时仅需替换 value。\r\n   */\r\n  private createInvoker(\r\n    el: HE,\r\n    parsed: ParsedEventInfo,\r\n    initialValue: HostEventHandler,\r\n  ): EventInvoker<HE> {\r\n    let currentValue: HostEventHandler | null = initialValue;\r\n    let disposed = false;\r\n\r\n    const handler: HostEventHandler = (event: HostEvent) => {\r\n      if (disposed) return;\r\n\r\n      // 处理修饰符\r\n      if (parsed.modifiers.stop) {\r\n        event.stopPropagation();\r\n      }\r\n      if (parsed.modifiers.prevent) {\r\n        event.preventDefault();\r\n      }\r\n      if (parsed.modifiers.self && event.target !== event.currentTarget) {\r\n        return;\r\n      }\r\n\r\n      if (currentValue) {\r\n        currentValue(event);\r\n      }\r\n    };\r\n\r\n    const invoker: EventInvoker<HE> = {\r\n      get value() {\r\n        return currentValue;\r\n      },\r\n      set value(fn: HostEventHandler | null) {\r\n        currentValue = fn;\r\n      },\r\n      parsed,\r\n      el,\r\n      handler,\r\n      dispose: () => {\r\n        disposed = true;\r\n        currentValue = null;\r\n      },\r\n    };\r\n\r\n    return invoker;\r\n  }\r\n\r\n  /**\r\n   * 根据 ParsedModifiers 构建 HostEventOptions。\r\n   */\r\n  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {\r\n    if (modifiers.capture || modifiers.once || modifiers.passive) {\r\n      const options: HostEventOptions = {};\r\n      if (modifiers.capture) options.capture = true;\r\n      if (modifiers.once) options.once = true;\r\n      if (modifiers.passive) options.passive = true;\r\n      return options;\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["// @lytjs/common-event-normalizer\n// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件\n\nimport type {\n  RendererHost,\n  HostEvent,\n  HostEventHandler,\n  HostEventOptions,\n} from '@lytjs/host-contract';\nimport { EVENT_MODIFIER_RE } from '@lytjs/common-events';\n\n// ============================================================\n// 类型定义\n// ============================================================\n\n/**\n * 事件修饰符解析结果。\n */\nexport interface ParsedModifiers {\n  /** 是否调用 stopPropagation */\n  stop: boolean;\n  /** 是否调用 preventDefault */\n  prevent: boolean;\n  /** 是否使用 capture 模式 */\n  capture: boolean;\n  /** 是否使用 once 模式 */\n  once: boolean;\n  /** 是否仅在 target === currentTarget 时触发 */\n  self: boolean;\n  /** 是否使用 passive 模式 */\n  passive: boolean;\n}\n\n/**\n * 解析后的事件信息。\n */\nexport interface ParsedEventInfo {\n  /** 规范化后的事件名（如 'click'） */\n  name: string;\n  /** 事件修饰符 */\n  modifiers: ParsedModifiers;\n}\n\n/**\n * 事件 invoker 接口。\n *\n * 持有 value 属性用于更新，避免重复 addEventListener。\n */\nexport interface EventInvoker<HE> {\n  /** 当前绑定的事件处理函数 */\n  value: ((event: HostEvent) => void) | null;\n  /** 解析后的事件信息 */\n  parsed: ParsedEventInfo;\n  /** 宿主元素引用 */\n  el: HE;\n  /** 实际的事件处理函数（传给 addEventListener 的函数） */\n  handler: (event: HostEvent) => void;\n  /** 取消监听函数 */\n  dispose: () => void;\n}\n\n/**\n * 事件监听器注册条目。\n */\nexport interface EventListenerEntry<HE> {\n  /** 宿主元素 */\n  el: HE;\n  /** 事件名 */\n  event: string;\n  /** 处理函数 */\n  handler: (event: HostEvent) => void;\n  /** 事件选项 */\n  options?: { capture?: boolean; once?: boolean; passive?: boolean };\n}\n\n// ============================================================\n// 常量\n// ============================================================\n\n/** invoker 缓存类型 */\ntype InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;\n\n// ============================================================\n// EventNormalizer\n// ============================================================\n\n/**\n * 事件归一化器。\n *\n * 负责解析事件名中的修饰符、管理事件 invoker 缓存，\n * 通过 RendererHost 接口执行平台无关的事件操作。\n *\n * @template HN - 宿主节点类型\n * @template HE - 宿主元素类型\n */\n// FIX: DTS build error - HN 必须约束为 object\nexport class EventNormalizer<HN extends object = object, HE extends HN = HN> {\n  /** RendererHost 实例 */\n  private host: RendererHost<HN, HE>;\n\n  /**\n   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染\n   * 键：宿主元素，值：该元素的事件 invoker 缓存\n   */\n  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();\n\n  /**\n   * 创建事件归一化器实例。\n   * @param host - RendererHost 实例\n   */\n  constructor(host: RendererHost<HN, HE>) {\n    this.host = host;\n  }\n\n  // ==========================================================\n  // 事件名解析\n  // ==========================================================\n\n  /**\n   * 解析事件名。\n   *\n   * 将各种格式的事件名规范化并提取修饰符：\n   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }\n   * - @click.capture → { name: 'click', modifiers: { capture: true } }\n   * - click → { name: 'click', modifiers: { stop: false, ... } }\n   *\n   * @param rawName - 原始事件名\n   * @returns 解析后的事件信息\n   */\n  parseEventName(rawName: string): ParsedEventInfo {\n    const name = this.normalizeEventName(rawName);\n    const modifiers = this.parseModifiers(rawName);\n\n    return { name, modifiers };\n  }\n\n  /**\n   * 将原始事件名规范化为标准事件名。\n   *\n   * 支持格式：@click / onClick / click → click\n   *\n   * @param rawName - 原始事件名\n   * @returns 规范化后的事件名\n   */\n  normalizeEventName(rawName: string): string {\n    // 移除 @ 前缀\n    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;\n\n    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）\n    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符\n    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {\n      name = name.slice(2);\n    }\n\n    // 移除修饰符后缀（如 .stop.prevent）\n    name = name.replace(EVENT_MODIFIER_RE, '');\n\n    // 转为小写\n    return name.toLowerCase();\n  }\n\n  /**\n   * 解析事件名中的修饰符。\n   *\n   * @param rawName - 原始事件名\n   * @returns 修饰符集合\n   */\n  parseModifiers(rawName: string): ParsedModifiers {\n    const modifiers: ParsedModifiers = {\n      stop: false,\n      prevent: false,\n      capture: false,\n      once: false,\n      self: false,\n      passive: false,\n    };\n\n    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则\n    const RE_EVENT_MODIFIERS = /\\.(stop|prevent|capture|once|self|passive)/g;\n    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符\n    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);\n    if (modifierMatch) {\n      for (const mod of modifierMatch) {\n        switch (mod) {\n          case '.stop':\n            modifiers.stop = true;\n            break;\n          case '.prevent':\n            modifiers.prevent = true;\n            break;\n          case '.capture':\n            modifiers.capture = true;\n            break;\n          case '.once':\n            modifiers.once = true;\n            break;\n          case '.self':\n            modifiers.self = true;\n            break;\n          case '.passive':\n            modifiers.passive = true;\n            break;\n        }\n      }\n    }\n\n    return modifiers;\n  }\n\n  // ==========================================================\n  // 事件名 → 缓存 key 转换\n  // ==========================================================\n\n  /**\n   * 将事件名转换为 invoker 缓存的 key。\n   *\n   * click → onClick，mouseenter → onMouseenter\n   *\n   * @param rawName - 原始事件名\n   * @returns 缓存 key\n   */\n  getEventKey(rawName: string): string {\n    const name = this.normalizeEventName(rawName);\n    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined\n    if (!name) return 'on';\n    return 'on' + name[0]!.toUpperCase() + name.slice(1);\n  }\n\n  // ==========================================================\n  // Invoker 缓存模式\n  // ==========================================================\n\n  /**\n   * 更新元素上的事件监听（invoker 缓存模式）。\n   *\n   * 四种情况：\n   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）\n   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener\n   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存\n   * 4. !nextValue && !existingInvoker → 无操作\n   *\n   * @param el - 宿主元素\n   * @param rawName - 原始事件名\n   * @param nextValue - 新的事件处理函数\n   */\n  patchEvent(el: HE, rawName: string, nextValue: HostEventHandler | null): void {\n    const eventKey = this.getEventKey(rawName);\n    const parsed = this.parseEventName(rawName);\n\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\n    let invokers = this.invokerCache.get(el);\n    if (!invokers) {\n      invokers = {};\n      this.invokerCache.set(el, invokers);\n    }\n\n    const existingInvoker = invokers[eventKey];\n\n    if (nextValue && existingInvoker) {\n      // 情况 1：有新值 + 有旧 invoker → 直接替换 value\n      existingInvoker.value = nextValue;\n    } else if (nextValue && !existingInvoker) {\n      // 情况 2：有新值 + 无旧 invoker → 创建并绑定\n      const invoker = this.createInvoker(el, parsed, nextValue);\n      invokers[eventKey] = invoker;\n\n      const options = this.buildHostEventOptions(parsed.modifiers);\n      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，\n      // 确保后续可以通过 invoker.dispose() 正确移除事件监听\n      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);\n      invoker.dispose = () => {\n        hostDispose();\n        // 同时清理内部状态\n        (invoker as { value?: HostEventHandler | null }).value = null;\n      };\n    } else if (!nextValue && existingInvoker) {\n      // 情况 3：无新值 + 有旧 invoker → 移除\n      const options = this.buildHostEventOptions(parsed.modifiers);\n      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);\n      invokers[eventKey] = undefined;\n    }\n    // 情况 4：无新值 + 无旧 invoker → 无操作\n  }\n\n  /**\n   * 移除元素上所有通过 invoker 缓存的事件监听。\n   *\n   * @param el - 宿主元素\n   */\n  removeAllEventListeners(el: HE): void {\n    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储\n    const invokers = this.invokerCache.get(el);\n    if (!invokers) return;\n\n    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性\n    for (const eventKey of Object.keys(invokers)) {\n      const invoker = invokers[eventKey];\n      if (invoker) {\n        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，\n        // 确保能正确匹配 addEventListener 时注册的包装 handler\n        const options = this.buildHostEventOptions(invoker.parsed.modifiers);\n        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);\n      }\n    }\n\n    // 从 WeakMap 中删除该元素的缓存\n    this.invokerCache.delete(el);\n  }\n\n  // ==========================================================\n  // 内部方法\n  // ==========================================================\n\n  /**\n   * 创建事件 invoker。\n   *\n   * invoker 持有 value 属性，调用时执行 invoker.value(event)。\n   * 修饰符在 invoker 内部处理，更新时仅需替换 value。\n   */\n  private createInvoker(\n    el: HE,\n    parsed: ParsedEventInfo,\n    initialValue: HostEventHandler,\n  ): EventInvoker<HE> {\n    let currentValue: HostEventHandler | null = initialValue;\n    let disposed = false;\n\n    const handler: HostEventHandler = (event: HostEvent) => {\n      if (disposed) return;\n\n      // 处理修饰符\n      if (parsed.modifiers.stop) {\n        event.stopPropagation();\n      }\n      if (parsed.modifiers.prevent) {\n        event.preventDefault();\n      }\n      if (parsed.modifiers.self && event.target !== event.currentTarget) {\n        return;\n      }\n\n      if (currentValue) {\n        currentValue(event);\n      }\n    };\n\n    const invoker: EventInvoker<HE> = {\n      get value() {\n        return currentValue;\n      },\n      set value(fn: HostEventHandler | null) {\n        currentValue = fn;\n      },\n      parsed,\n      el,\n      handler,\n      dispose: () => {\n        disposed = true;\n        currentValue = null;\n      },\n    };\n\n    return invoker;\n  }\n\n  /**\n   * 根据 ParsedModifiers 构建 HostEventOptions。\n   */\n  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {\n    if (modifiers.capture || modifiers.once || modifiers.passive) {\n      const options: HostEventOptions = {};\n      if (modifiers.capture) options.capture = true;\n      if (modifiers.once) options.once = true;\n      if (modifiers.passive) options.passive = true;\n      return options;\n    }\n    return undefined;\n  }\n}\n"]}

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "@lytjs/common-event-normalizer",
-  "version": "6.5.0",
-  "description": "Event normalization utilities for parsing event names and managing invoker cache in LytJS",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "build": "tsup",
-    "type-check": "tsc --noEmit",
-    "clean": "rm -rf dist"
-  },
-  "sideEffects": false,
-  "license": "MIT",
-  "dependencies": {
-    "@lytjs/host-contract": "^6.0.0",
-    "@lytjs/common-events": "^6.0.0"
-  },
-  "devDependencies": {
-    "tsup": "^8.4.0",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.7"
-  }
-}
+{
+  "name": "@lytjs/common-event-normalizer",
+  "version": "6.6.0",
+  "description": "Event normalization utilities for parsing event names and managing invoker cache in LytJS",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "dependencies": {
+    "@lytjs/host-contract": "workspace:*",
+    "@lytjs/common-events": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.7"
+  }
+}

package/src/index.ts

@@ -1,378 +1,379 @@
-// @lytjs/common-event-normalizer
-// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件
-
-import type { RendererHost, HostEvent, HostEventHandler, HostEventOptions } from '@lytjs/host-contract';
-import { EVENT_MODIFIER_RE } from '@lytjs/common-events';
-
-// ============================================================
-// 类型定义
-// ============================================================
-
-/**
- * 事件修饰符解析结果。
- */
-export interface ParsedModifiers {
-  /** 是否调用 stopPropagation */
-  stop: boolean;
-  /** 是否调用 preventDefault */
-  prevent: boolean;
-  /** 是否使用 capture 模式 */
-  capture: boolean;
-  /** 是否使用 once 模式 */
-  once: boolean;
-  /** 是否仅在 target === currentTarget 时触发 */
-  self: boolean;
-  /** 是否使用 passive 模式 */
-  passive: boolean;
-}
-
-/**
- * 解析后的事件信息。
- */
-export interface ParsedEventInfo {
-  /** 规范化后的事件名（如 'click'） */
-  name: string;
-  /** 事件修饰符 */
-  modifiers: ParsedModifiers;
-}
-
-/**
- * 事件 invoker 接口。
- *
- * 持有 value 属性用于更新，避免重复 addEventListener。
- */
-export interface EventInvoker<HE> {
-  /** 当前绑定的事件处理函数 */
-  value: ((event: HostEvent) => void) | null;
-  /** 解析后的事件信息 */
-  parsed: ParsedEventInfo;
-  /** 宿主元素引用 */
-  el: HE;
-  /** 实际的事件处理函数（传给 addEventListener 的函数） */
-  handler: (event: HostEvent) => void;
-  /** 取消监听函数 */
-  dispose: () => void;
-}
-
-/**
- * 事件监听器注册条目。
- */
-export interface EventListenerEntry<HE> {
-  /** 宿主元素 */
-  el: HE;
-  /** 事件名 */
-  event: string;
-  /** 处理函数 */
-  handler: (event: HostEvent) => void;
-  /** 事件选项 */
-  options?: { capture?: boolean; once?: boolean; passive?: boolean };
-}
-
-// ============================================================
-// 常量
-// ============================================================
-
-/** invoker 缓存类型 */
-type InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;
-
-// ============================================================
-// EventNormalizer
-// ============================================================
-
-/**
- * 事件归一化器。
- *
- * 负责解析事件名中的修饰符、管理事件 invoker 缓存，
- * 通过 RendererHost 接口执行平台无关的事件操作。
- *
- * @template HN - 宿主节点类型
- * @template HE - 宿主元素类型
- */
-// FIX: DTS build error - HN 必须约束为 object
-export class EventNormalizer<HN extends object = object, HE extends HN = HN> {
-  /** RendererHost 实例 */
-  private host: RendererHost<HN, HE>;
-
-  /**
-   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染
-   * 键：宿主元素，值：该元素的事件 invoker 缓存
-   */
-  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();
-
-  /**
-   * 创建事件归一化器实例。
-   * @param host - RendererHost 实例
-   */
-  constructor(host: RendererHost<HN, HE>) {
-    this.host = host;
-  }
-
-  // ==========================================================
-  // 事件名解析
-  // ==========================================================
-
-  /**
-   * 解析事件名。
-   *
-   * 将各种格式的事件名规范化并提取修饰符：
-   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }
-   * - @click.capture → { name: 'click', modifiers: { capture: true } }
-   * - click → { name: 'click', modifiers: { stop: false, ... } }
-   *
-   * @param rawName - 原始事件名
-   * @returns 解析后的事件信息
-   */
-  parseEventName(rawName: string): ParsedEventInfo {
-    const name = this.normalizeEventName(rawName);
-    const modifiers = this.parseModifiers(rawName);
-
-    return { name, modifiers };
-  }
-
-  /**
-   * 将原始事件名规范化为标准事件名。
-   *
-   * 支持格式：@click / onClick / click → click
-   *
-   * @param rawName - 原始事件名
-   * @returns 规范化后的事件名
-   */
-  normalizeEventName(rawName: string): string {
-    // 移除 @ 前缀
-    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;
-
-    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）
-    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符
-    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {
-      name = name.slice(2);
-    }
-
-    // 移除修饰符后缀（如 .stop.prevent）
-    name = name.replace(EVENT_MODIFIER_RE, '');
-
-    // 转为小写
-    return name.toLowerCase();
-  }
-
-  /**
-   * 解析事件名中的修饰符。
-   *
-   * @param rawName - 原始事件名
-   * @returns 修饰符集合
-   */
-  parseModifiers(rawName: string): ParsedModifiers {
-    const modifiers: ParsedModifiers = {
-      stop: false,
-      prevent: false,
-      capture: false,
-      once: false,
-      self: false,
-      passive: false,
-    };
-
-    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则
-    const RE_EVENT_MODIFIERS = /\.(stop|prevent|capture|once|self|passive)/g;
-    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符
-    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);
-    if (modifierMatch) {
-      for (const mod of modifierMatch) {
-        switch (mod) {
-          case '.stop':
-            modifiers.stop = true;
-            break;
-          case '.prevent':
-            modifiers.prevent = true;
-            break;
-          case '.capture':
-            modifiers.capture = true;
-            break;
-          case '.once':
-            modifiers.once = true;
-            break;
-          case '.self':
-            modifiers.self = true;
-            break;
-          case '.passive':
-            modifiers.passive = true;
-            break;
-        }
-      }
-    }
-
-    return modifiers;
-  }
-
-  // ==========================================================
-  // 事件名 → 缓存 key 转换
-  // ==========================================================
-
-  /**
-   * 将事件名转换为 invoker 缓存的 key。
-   *
-   * click → onClick，mouseenter → onMouseenter
-   *
-   * @param rawName - 原始事件名
-   * @returns 缓存 key
-   */
-  getEventKey(rawName: string): string {
-    const name = this.normalizeEventName(rawName);
-    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined
-    if (!name) return 'on';
-    return 'on' + name[0]!.toUpperCase() + name.slice(1);
-  }
-
-  // ==========================================================
-  // Invoker 缓存模式
-  // ==========================================================
-
-  /**
-   * 更新元素上的事件监听（invoker 缓存模式）。
-   *
-   * 四种情况：
-   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）
-   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener
-   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存
-   * 4. !nextValue && !existingInvoker → 无操作
-   *
-   * @param el - 宿主元素
-   * @param rawName - 原始事件名
-   * @param nextValue - 新的事件处理函数
-   */
-  patchEvent(
-    el: HE,
-    rawName: string,
-    nextValue: HostEventHandler | null,
-  ): void {
-    const eventKey = this.getEventKey(rawName);
-    const parsed = this.parseEventName(rawName);
-
-    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储
-    let invokers = this.invokerCache.get(el);
-    if (!invokers) {
-      invokers = {};
-      this.invokerCache.set(el, invokers);
-    }
-
-    const existingInvoker = invokers[eventKey];
-
-    if (nextValue && existingInvoker) {
-      // 情况 1：有新值 + 有旧 invoker → 直接替换 value
-      existingInvoker.value = nextValue;
-    } else if (nextValue && !existingInvoker) {
-      // 情况 2：有新值 + 无旧 invoker → 创建并绑定
-      const invoker = this.createInvoker(el, parsed, nextValue);
-      invokers[eventKey] = invoker;
-
-      const options = this.buildHostEventOptions(parsed.modifiers);
-      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，
-      // 确保后续可以通过 invoker.dispose() 正确移除事件监听
-      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);
-      invoker.dispose = () => {
-        hostDispose();
-        // 同时清理内部状态
-        (invoker as { value?: HostEventHandler | null }).value = null;
-      };
-    } else if (!nextValue && existingInvoker) {
-      // 情况 3：无新值 + 有旧 invoker → 移除
-      const options = this.buildHostEventOptions(parsed.modifiers);
-      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);
-      invokers[eventKey] = undefined;
-    }
-    // 情况 4：无新值 + 无旧 invoker → 无操作
-  }
-
-  /**
-   * 移除元素上所有通过 invoker 缓存的事件监听。
-   *
-   * @param el - 宿主元素
-   */
-  removeAllEventListeners(el: HE): void {
-    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储
-    const invokers = this.invokerCache.get(el);
-    if (!invokers) return;
-
-    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性
-    for (const eventKey of Object.keys(invokers)) {
-      const invoker = invokers[eventKey];
-      if (invoker) {
-        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，
-        // 确保能正确匹配 addEventListener 时注册的包装 handler
-        const options = this.buildHostEventOptions(invoker.parsed.modifiers);
-        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);
-      }
-    }
-
-    // 从 WeakMap 中删除该元素的缓存
-    this.invokerCache.delete(el);
-  }
-
-  // ==========================================================
-  // 内部方法
-  // ==========================================================
-
-  /**
-   * 创建事件 invoker。
-   *
-   * invoker 持有 value 属性，调用时执行 invoker.value(event)。
-   * 修饰符在 invoker 内部处理，更新时仅需替换 value。
-   */
-  private createInvoker(
-    el: HE,
-    parsed: ParsedEventInfo,
-    initialValue: HostEventHandler,
-  ): EventInvoker<HE> {
-    let currentValue: HostEventHandler | null = initialValue;
-    let disposed = false;
-
-    const handler: HostEventHandler = (event: HostEvent) => {
-      if (disposed) return;
-
-      // 处理修饰符
-      if (parsed.modifiers.stop) {
-        event.stopPropagation();
-      }
-      if (parsed.modifiers.prevent) {
-        event.preventDefault();
-      }
-      if (parsed.modifiers.self && event.target !== event.currentTarget) {
-        return;
-      }
-
-      if (currentValue) {
-        currentValue(event);
-      }
-    };
-
-    const invoker: EventInvoker<HE> = {
-      get value() {
-        return currentValue;
-      },
-      set value(fn: HostEventHandler | null) {
-        currentValue = fn;
-      },
-      parsed,
-      el,
-      handler,
-      dispose: () => {
-        disposed = true;
-        currentValue = null;
-      },
-    };
-
-    return invoker;
-  }
-
-  /**
-   * 根据 ParsedModifiers 构建 HostEventOptions。
-   */
-  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {
-    if (modifiers.capture || modifiers.once || modifiers.passive) {
-      const options: HostEventOptions = {};
-      if (modifiers.capture) options.capture = true;
-      if (modifiers.once) options.once = true;
-      if (modifiers.passive) options.passive = true;
-      return options;
-    }
-    return undefined;
-  }
-}
+// @lytjs/common-event-normalizer
+// 事件归一化：解析事件名、提供 invoker 缓存模式、通过 RendererHost 操作事件
+
+import type {
+  RendererHost,
+  HostEvent,
+  HostEventHandler,
+  HostEventOptions,
+} from '@lytjs/host-contract';
+import { EVENT_MODIFIER_RE } from '@lytjs/common-events';
+
+// ============================================================
+// 类型定义
+// ============================================================
+
+/**
+ * 事件修饰符解析结果。
+ */
+export interface ParsedModifiers {
+  /** 是否调用 stopPropagation */
+  stop: boolean;
+  /** 是否调用 preventDefault */
+  prevent: boolean;
+  /** 是否使用 capture 模式 */
+  capture: boolean;
+  /** 是否使用 once 模式 */
+  once: boolean;
+  /** 是否仅在 target === currentTarget 时触发 */
+  self: boolean;
+  /** 是否使用 passive 模式 */
+  passive: boolean;
+}
+
+/**
+ * 解析后的事件信息。
+ */
+export interface ParsedEventInfo {
+  /** 规范化后的事件名（如 'click'） */
+  name: string;
+  /** 事件修饰符 */
+  modifiers: ParsedModifiers;
+}
+
+/**
+ * 事件 invoker 接口。
+ *
+ * 持有 value 属性用于更新，避免重复 addEventListener。
+ */
+export interface EventInvoker<HE> {
+  /** 当前绑定的事件处理函数 */
+  value: ((event: HostEvent) => void) | null;
+  /** 解析后的事件信息 */
+  parsed: ParsedEventInfo;
+  /** 宿主元素引用 */
+  el: HE;
+  /** 实际的事件处理函数（传给 addEventListener 的函数） */
+  handler: (event: HostEvent) => void;
+  /** 取消监听函数 */
+  dispose: () => void;
+}
+
+/**
+ * 事件监听器注册条目。
+ */
+export interface EventListenerEntry<HE> {
+  /** 宿主元素 */
+  el: HE;
+  /** 事件名 */
+  event: string;
+  /** 处理函数 */
+  handler: (event: HostEvent) => void;
+  /** 事件选项 */
+  options?: { capture?: boolean; once?: boolean; passive?: boolean };
+}
+
+// ============================================================
+// 常量
+// ============================================================
+
+/** invoker 缓存类型 */
+type InvokerCache<HE> = Record<string, EventInvoker<HE> | undefined>;
+
+// ============================================================
+// EventNormalizer
+// ============================================================
+
+/**
+ * 事件归一化器。
+ *
+ * 负责解析事件名中的修饰符、管理事件 invoker 缓存，
+ * 通过 RendererHost 接口执行平台无关的事件操作。
+ *
+ * @template HN - 宿主节点类型
+ * @template HE - 宿主元素类型
+ */
+// FIX: DTS build error - HN 必须约束为 object
+export class EventNormalizer<HN extends object = object, HE extends HN = HN> {
+  /** RendererHost 实例 */
+  private host: RendererHost<HN, HE>;
+
+  /**
+   * FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储，避免类型断言和属性污染
+   * 键：宿主元素，值：该元素的事件 invoker 缓存
+   */
+  private invokerCache = new WeakMap<HE, InvokerCache<HE>>();
+
+  /**
+   * 创建事件归一化器实例。
+   * @param host - RendererHost 实例
+   */
+  constructor(host: RendererHost<HN, HE>) {
+    this.host = host;
+  }
+
+  // ==========================================================
+  // 事件名解析
+  // ==========================================================
+
+  /**
+   * 解析事件名。
+   *
+   * 将各种格式的事件名规范化并提取修饰符：
+   * - onClick.stop.prevent → { name: 'click', modifiers: { stop: true, prevent: true } }
+   * - @click.capture → { name: 'click', modifiers: { capture: true } }
+   * - click → { name: 'click', modifiers: { stop: false, ... } }
+   *
+   * @param rawName - 原始事件名
+   * @returns 解析后的事件信息
+   */
+  parseEventName(rawName: string): ParsedEventInfo {
+    const name = this.normalizeEventName(rawName);
+    const modifiers = this.parseModifiers(rawName);
+
+    return { name, modifiers };
+  }
+
+  /**
+   * 将原始事件名规范化为标准事件名。
+   *
+   * 支持格式：@click / onClick / click → click
+   *
+   * @param rawName - 原始事件名
+   * @returns 规范化后的事件名
+   */
+  normalizeEventName(rawName: string): string {
+    // 移除 @ 前缀
+    let name = rawName.startsWith('@') ? rawName.slice(1) : rawName;
+
+    // 移除 on 前缀（仅当以大写字母开头的 on 前缀时）
+    // FIX: P2-45 使用 charAt 替代非空断言，更安全地访问字符串字符
+    if (name.startsWith('on') && name.length > 2 && /^[A-Za-z]$/.test(name.charAt(2))) {
+      name = name.slice(2);
+    }
+
+    // 移除修饰符后缀（如 .stop.prevent）
+    name = name.replace(EVENT_MODIFIER_RE, '');
+
+    // 转为小写
+    return name.toLowerCase();
+  }
+
+  /**
+   * 解析事件名中的修饰符。
+   *
+   * @param rawName - 原始事件名
+   * @returns 修饰符集合
+   */
+  parseModifiers(rawName: string): ParsedModifiers {
+    const modifiers: ParsedModifiers = {
+      stop: false,
+      prevent: false,
+      capture: false,
+      once: false,
+      self: false,
+      passive: false,
+    };
+
+    // FIX: P2-23 正则表达式缓存 - 模块级预编译正则
+    const RE_EVENT_MODIFIERS = /\.(stop|prevent|capture|once|self|passive)/g;
+    // FIX: P2-41 事件捕获选项支持：支持 .capture 修饰符
+    const modifierMatch = rawName.match(RE_EVENT_MODIFIERS);
+    if (modifierMatch) {
+      for (const mod of modifierMatch) {
+        switch (mod) {
+          case '.stop':
+            modifiers.stop = true;
+            break;
+          case '.prevent':
+            modifiers.prevent = true;
+            break;
+          case '.capture':
+            modifiers.capture = true;
+            break;
+          case '.once':
+            modifiers.once = true;
+            break;
+          case '.self':
+            modifiers.self = true;
+            break;
+          case '.passive':
+            modifiers.passive = true;
+            break;
+        }
+      }
+    }
+
+    return modifiers;
+  }
+
+  // ==========================================================
+  // 事件名 → 缓存 key 转换
+  // ==========================================================
+
+  /**
+   * 将事件名转换为 invoker 缓存的 key。
+   *
+   * click → onClick，mouseenter → onMouseenter
+   *
+   * @param rawName - 原始事件名
+   * @returns 缓存 key
+   */
+  getEventKey(rawName: string): string {
+    const name = this.normalizeEventName(rawName);
+    // FIX: P2-v11-20 添加空字符串检查，避免 name 为空时 name[0] 返回 undefined
+    if (!name) return 'on';
+    return 'on' + name[0]!.toUpperCase() + name.slice(1);
+  }
+
+  // ==========================================================
+  // Invoker 缓存模式
+  // ==========================================================
+
+  /**
+   * 更新元素上的事件监听（invoker 缓存模式）。
+   *
+   * 四种情况：
+   * 1. nextValue && existingInvoker → 直接替换 invoker.value（O(1) 赋值）
+   * 2. nextValue && !existingInvoker → 创建 invoker，addEventListener
+   * 3. !nextValue && existingInvoker → removeEventListener，清除缓存
+   * 4. !nextValue && !existingInvoker → 无操作
+   *
+   * @param el - 宿主元素
+   * @param rawName - 原始事件名
+   * @param nextValue - 新的事件处理函数
+   */
+  patchEvent(el: HE, rawName: string, nextValue: HostEventHandler | null): void {
+    const eventKey = this.getEventKey(rawName);
+    const parsed = this.parseEventName(rawName);
+
+    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储
+    let invokers = this.invokerCache.get(el);
+    if (!invokers) {
+      invokers = {};
+      this.invokerCache.set(el, invokers);
+    }
+
+    const existingInvoker = invokers[eventKey];
+
+    if (nextValue && existingInvoker) {
+      // 情况 1：有新值 + 有旧 invoker → 直接替换 value
+      existingInvoker.value = nextValue;
+    } else if (nextValue && !existingInvoker) {
+      // 情况 2：有新值 + 无旧 invoker → 创建并绑定
+      const invoker = this.createInvoker(el, parsed, nextValue);
+      invokers[eventKey] = invoker;
+
+      const options = this.buildHostEventOptions(parsed.modifiers);
+      // FIX: P2 保存 addEventListener 返回的 dispose 函数到 invoker，
+      // 确保后续可以通过 invoker.dispose() 正确移除事件监听
+      const hostDispose = this.host.addEventListener(el, parsed.name, invoker.handler, options);
+      invoker.dispose = () => {
+        hostDispose();
+        // 同时清理内部状态
+        (invoker as { value?: HostEventHandler | null }).value = null;
+      };
+    } else if (!nextValue && existingInvoker) {
+      // 情况 3：无新值 + 有旧 invoker → 移除
+      const options = this.buildHostEventOptions(parsed.modifiers);
+      this.host.removeEventListener(el, parsed.name, existingInvoker.handler, options);
+      invokers[eventKey] = undefined;
+    }
+    // 情况 4：无新值 + 无旧 invoker → 无操作
+  }
+
+  /**
+   * 移除元素上所有通过 invoker 缓存的事件监听。
+   *
+   * @param el - 宿主元素
+   */
+  removeAllEventListeners(el: HE): void {
+    // FIX: P2-46 使用 WeakMap 替代 el._vei 属性存储
+    const invokers = this.invokerCache.get(el);
+    if (!invokers) return;
+
+    // FIX: P2-47 使用 Object.keys 替代 for...in，避免遍历原型链上的属性
+    for (const eventKey of Object.keys(invokers)) {
+      const invoker = invokers[eventKey];
+      if (invoker) {
+        // FIX: P1-48 使用 invoker.handler 而非原始 handler 引用移除事件监听器，
+        // 确保能正确匹配 addEventListener 时注册的包装 handler
+        const options = this.buildHostEventOptions(invoker.parsed.modifiers);
+        this.host.removeEventListener(el, invoker.parsed.name, invoker.handler, options);
+      }
+    }
+
+    // 从 WeakMap 中删除该元素的缓存
+    this.invokerCache.delete(el);
+  }
+
+  // ==========================================================
+  // 内部方法
+  // ==========================================================
+
+  /**
+   * 创建事件 invoker。
+   *
+   * invoker 持有 value 属性，调用时执行 invoker.value(event)。
+   * 修饰符在 invoker 内部处理，更新时仅需替换 value。
+   */
+  private createInvoker(
+    el: HE,
+    parsed: ParsedEventInfo,
+    initialValue: HostEventHandler,
+  ): EventInvoker<HE> {
+    let currentValue: HostEventHandler | null = initialValue;
+    let disposed = false;
+
+    const handler: HostEventHandler = (event: HostEvent) => {
+      if (disposed) return;
+
+      // 处理修饰符
+      if (parsed.modifiers.stop) {
+        event.stopPropagation();
+      }
+      if (parsed.modifiers.prevent) {
+        event.preventDefault();
+      }
+      if (parsed.modifiers.self && event.target !== event.currentTarget) {
+        return;
+      }
+
+      if (currentValue) {
+        currentValue(event);
+      }
+    };
+
+    const invoker: EventInvoker<HE> = {
+      get value() {
+        return currentValue;
+      },
+      set value(fn: HostEventHandler | null) {
+        currentValue = fn;
+      },
+      parsed,
+      el,
+      handler,
+      dispose: () => {
+        disposed = true;
+        currentValue = null;
+      },
+    };
+
+    return invoker;
+  }
+
+  /**
+   * 根据 ParsedModifiers 构建 HostEventOptions。
+   */
+  private buildHostEventOptions(modifiers: ParsedModifiers): HostEventOptions | undefined {
+    if (modifiers.capture || modifiers.once || modifiers.passive) {
+      const options: HostEventOptions = {};
+      if (modifiers.capture) options.capture = true;
+      if (modifiers.once) options.once = true;
+      if (modifiers.passive) options.passive = true;
+      return options;
+    }
+    return undefined;
+  }
+}