@qimen-lab/core 0.1.4 → 0.1.5

package/dist/event-dom/adapters/semantic-map/base.esm.js

@@ -0,0 +1,73 @@
+/**
+ * 基础事件映射，包含与输入设备形态无关的事件
+ * 不需要"输入动作"的事件
+ * baseMap 原则：
+ *
+ *     只包含"与输入设备形态无关"的事件
+ *
+ *     需要特定输入设备（鼠标、键盘、触摸屏等）才能产生的事件，都不进入 baseMap
+ *
+ * @description 定义了跨平台输入设备的基础事件映射，将语义化的输入信号（press、release、move、cancel）
+ *              映射到具体的 DOM 事件上，使得上层组件可以不关心具体的输入设备类型
+ */
+export const baseMap = {
+    /**
+     * 按下/激活事件 - 当用户开始与元素交互时触发
+     * 支持多种输入设备，包括指针设备、触摸屏和鼠标
+     */
+    press: {
+        pointer: ['pointerdown'], // 指针按下事件，适用于鼠标、触摸笔、触摸屏等支持 Pointer Events 的设备
+        touch: ['touchstart'], // 触摸开始事件，用于触摸屏设备
+        mouse: ['mousedown'], // 鼠标按下事件，用于传统鼠标设备
+    },
+    /**
+     * 释放/取消激活事件 - 当用户结束与元素的交互时触发
+     * 通常与 press 事件配对使用，表示一次完整的交互周期
+     */
+    release: {
+        pointer: ['pointerup'], // 指针释放事件，当指针设备按钮被释放时触发
+        touch: ['touchend'], // 触摸结束事件，当手指离开触摸屏时触发
+        mouse: ['mouseup'], // 鼠标释放事件，当鼠标按钮被释放时触发
+    },
+    /**
+     * 移动事件 - 当输入设备在元素上移动时持续触发
+     * 用于跟踪用户的移动轨迹或位置变化
+     */
+    move: {
+        pointer: ['pointermove'], // 指针移动事件，提供跨设备的统一移动检测
+        touch: ['touchmove'], // 触摸移动事件，当手指在屏幕上滑动时触发
+        mouse: ['mousemove'], // 鼠标移动事件，当鼠标在元素上移动时触发
+    },
+    /**
+     * 取消事件 - 当正在进行的交互被系统中断时触发
+     * 例如：电话呼入中断触摸操作、浏览器失去焦点等场景
+     */
+    cancel: {
+        pointer: ['pointercancel'], // 指针取消事件，当 Pointer Event 被系统强制终止时触发
+        touch: ['touchcancel'], // 触摸取消事件，当 Touch Event 被系统中断时触发
+        // 注意：mouse 设备没有对应的 cancel 事件，因为鼠标交互通常不会被意外中断
+    },
+    /**
+     * 滚轮事件 - 当用户使用滚轮或类似滚动机制时触发
+     * 目前主要由鼠标设备支持
+     */
+    wheel: {
+        mouse: ['wheel'], // 鼠标滚轮事件，当用户滚动鼠标滚轮时触发
+        // 注意：虽然触摸板也可以产生滚动，但这里暂时只考虑传统的鼠标滚轮
+    },
+    /**
+     * 键盘按键按下事件 - 当用户按下键盘上的键时触发
+     * 提供键盘输入的基本支持
+     */
+    keydown: {
+        keyboard: ['keydown'], // 键盘按键按下事件，当任何键被按下时触发
+    },
+    /**
+     * 键盘按键释放事件 - 当用户释放键盘上的键时触发
+     * 与 keydown 事件配对，完成一次完整的按键周期
+     */
+    keyup: {
+        keyboard: ['keyup'], // 键盘按键释放事件，当被按下的键被释放时触发
+    },
+};
+//# sourceMappingURL=base.js.map

package/dist/event-dom/adapters/semantic-map/base.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/base.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAkB;IAClC;;;OAGG;IACH,KAAK,EAAE;QACH,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,6CAA6C;QACvE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,iBAAiB;QACxC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,kBAAkB;KAC3C;IACD;;;OAGG;IACH,OAAO,EAAE;QACL,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,uBAAuB;QAC/C,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,qBAAqB;QAC1C,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,qBAAqB;KAC5C;IACD;;;OAGG;IACH,IAAI,EAAE;QACF,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,sBAAsB;QAChD,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB;QAC5C,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB;KAC/C;IACD;;;OAGG;IACH,MAAM,EAAE;QACJ,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,oCAAoC;QAChE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,gCAAgC;QACxD,6CAA6C;KAChD;IACD;;;OAGG;IACH,KAAK,EAAE;QACH,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB;QACxC,kCAAkC;KACrC;IACD;;;OAGG;IACH,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,sBAAsB;KAChD;IACD;;;OAGG;IACH,KAAK,EAAE;QACH,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB;KAChD;CACJ,CAAC"}

package/dist/event-dom/adapters/semantic-map/gesture.esm.js

@@ -0,0 +1,95 @@
+/**
+ * 手势事件映射配置
+ *
+ * ✔ 不涉及 DOM
+ * ✔ 不涉及 mouse / touch / pointer
+ * ✔ 只声明"我需要什么 + 谁来解释"
+ *
+ * @description 定义了高层语义化手势事件，将基础输入信号组合成有意义的手势行为，
+ *              如点击、拖拽、长按等，并指定相应的处理器和约束条件
+ */
+export const gestureMap = {
+    tap: {
+        requires: ['press', 'release'], // 需要按下和释放两个基础信号
+        processor: 'tapProcessor', // 使用点击处理器
+        constraints: {
+            // 约束条件
+            maxDuration: 250, // 最大持续时间250毫秒
+            maxDistance: 10, // 最大移动距离10像素
+        },
+        semantic: 'tap', // 语义为轻触
+    },
+    click: {
+        requires: ['press', 'release'], // 需要按下和释放两个基础信号
+        processor: 'tapProcessor', // 使用点击处理器
+        semantic: 'click', // 语义为点击
+    },
+    dblclick: {
+        requires: ['press', 'release'], // 需要按下和释放两个基础信号
+        processor: 'doubleTapProcessor', // 使用双击处理器
+        constraints: {
+            maxDuration: 300, // 最大持续时间300毫秒
+        },
+        semantic: 'dblclick', // 语义为双击
+    },
+    longpress: {
+        requires: ['press'], // 只需要按下信号
+        processor: 'longPressProcessor', // 使用长按处理器
+        constraints: {
+            minDuration: 500, // 最小持续时间500毫秒
+        },
+        semantic: 'longpress', // 语义为长按
+    },
+    drag: {
+        requires: ['press', 'move', 'release'], // 需要按下、移动和释放信号
+        processor: 'panProcessor', // 使用拖拽处理器
+        constraints: {
+            minDistance: 5, // 最小移动距离5像素
+        },
+        semantic: 'drag', // 语义为拖拽
+    },
+    swipe: {
+        requires: ['press', 'move', 'release'], // 需要按下、移动和释放信号
+        processor: 'swipeProcessor', // 使用滑动手势处理器
+        constraints: {
+            minDistance: 30, // 最小移动距离30像素
+            maxDuration: 300, // 最大持续时间300毫秒
+        },
+        semantic: 'swipe', // 语义为滑动
+    },
+    hover: {
+        requires: ['enter', 'leave'], // 需要进入和离开信号
+        processor: 'hoverProcessor', // 使用悬停处理器
+        semantic: 'hover', // 语义为悬停
+    },
+    contextmenu: {
+        requires: ['press'], // 需要按下信号
+        processor: 'contextMenuProcessor', // 使用右键菜单处理器
+        constraints: {
+            buttons: [2], // 右键           // 只响应鼠标右键
+        },
+        semantic: 'contextmenu', // 语义为上下文菜单
+    },
+};
+/**
+ * 键盘手势事件映射配置
+ *
+ * @description 定义了键盘相关的高层语义化事件，如回车提交等
+ */
+export const keyboardGestureMap = {
+    submit: {
+        requires: ['keydown'], // 需要按键按下信号
+        processor: 'enterKeyProcessor', // 使用回车键处理器
+        semantic: 'submit', // 语义为提交
+    },
+};
+/**
+ * 合并所有手势事件映射
+ *
+ * @description 将普通手势和键盘手势映射合并成一个完整的手势事件映射
+ */
+export const gestureEventMap = {
+    ...gestureMap,
+    ...keyboardGestureMap,
+};
+//# sourceMappingURL=gesture.js.map

package/dist/event-dom/adapters/semantic-map/gesture.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/gesture.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAA6B;IAChD,GAAG,EAAE;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,gBAAgB;QAChD,SAAS,EAAE,cAAc,EAAE,UAAU;QACrC,WAAW,EAAE;YACT,OAAO;YACP,WAAW,EAAE,GAAG,EAAE,cAAc;YAChC,WAAW,EAAE,EAAE,EAAE,aAAa;SACjC;QACD,QAAQ,EAAE,KAAK,EAAE,QAAQ;KAC5B;IAED,KAAK,EAAE;QACH,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,gBAAgB;QAChD,SAAS,EAAE,cAAc,EAAE,UAAU;QACrC,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC9B;IAED,QAAQ,EAAE;QACN,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,gBAAgB;QAChD,SAAS,EAAE,oBAAoB,EAAE,UAAU;QAC3C,WAAW,EAAE;YACT,WAAW,EAAE,GAAG,EAAE,cAAc;SACnC;QACD,QAAQ,EAAE,UAAU,EAAE,QAAQ;KACjC;IAED,SAAS,EAAE;QACP,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU;QAC/B,SAAS,EAAE,oBAAoB,EAAE,UAAU;QAC3C,WAAW,EAAE;YACT,WAAW,EAAE,GAAG,EAAE,cAAc;SACnC;QACD,QAAQ,EAAE,WAAW,EAAE,QAAQ;KAClC;IAED,IAAI,EAAE;QACF,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe;QACvD,SAAS,EAAE,cAAc,EAAE,UAAU;QACrC,WAAW,EAAE;YACT,WAAW,EAAE,CAAC,EAAE,YAAY;SAC/B;QACD,QAAQ,EAAE,MAAM,EAAE,QAAQ;KAC7B;IAED,KAAK,EAAE;QACH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe;QACvD,SAAS,EAAE,gBAAgB,EAAE,YAAY;QACzC,WAAW,EAAE;YACT,WAAW,EAAE,EAAE,EAAE,aAAa;YAC9B,WAAW,EAAE,GAAG,EAAE,cAAc;SACnC;QACD,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC9B;IAED,KAAK,EAAE;QACH,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY;QAC1C,SAAS,EAAE,gBAAgB,EAAE,UAAU;QACvC,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC9B;IAED,WAAW,EAAE;QACT,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS;QAC9B,SAAS,EAAE,sBAAsB,EAAE,YAAY;QAC/C,WAAW,EAAE;YACT,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,0BAA0B;SAC3C;QACD,QAAQ,EAAE,aAAa,EAAE,WAAW;KACvC;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IACxD,MAAM,EAAE;QACJ,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW;QAClC,SAAS,EAAE,mBAAmB,EAAE,WAAW;QAC3C,QAAQ,EAAE,QAAQ,EAAE,QAAQ;KAC/B;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC5C,GAAG,UAAU;IACb,GAAG,kBAAkB;CACL,CAAC"}

package/dist/event-dom/adapters/semantic-map/index.esm.js

@@ -0,0 +1,8 @@
+export * from './base';
+export * from './keyboard';
+export * from './mouse';
+export * from './pointer';
+export * from './touch';
+export * from './gesture';
+export * from './resolve';
+//# sourceMappingURL=index.js.map

package/dist/event-dom/adapters/semantic-map/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/event-dom/adapters/semantic-map/keyboard.esm.js

@@ -0,0 +1,20 @@
+/**
+ * 键盘事件映射
+ * keyboardMap 原则：
+ *
+ *     只包含键盘设备相关的事件
+ *
+ *     仅映射到 keyboard 类型的 DOM 事件
+ *
+ * @description 定义了键盘设备的输入信号到具体 DOM 事件的映射，
+ *              使得上层可以使用语义化的键盘信号，而不必关心具体的 DOM 事件
+ */
+export const keyboardMap = {
+    keydown: {
+        keyboard: ['keydown'], // 键盘按下事件映射
+    },
+    keyup: {
+        keyboard: ['keyup'], // 键盘释放事件映射
+    },
+};
+//# sourceMappingURL=keyboard.js.map

package/dist/event-dom/adapters/semantic-map/keyboard.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/keyboard.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB;IACtC,OAAO,EAAE;QACL,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW;KACrC;IACD,KAAK,EAAE;QACH,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW;KACnC;CACJ,CAAC"}

package/dist/event-dom/adapters/semantic-map/mouse.esm.js

@@ -0,0 +1,35 @@
+/**
+ * 鼠标事件映射
+ * mouseMap 原则：
+ *
+ *     只包含鼠标设备相关的事件
+ *
+ *     仅映射到 mouse 类型的 DOM 事件
+ *
+ * @description 定义了鼠标设备的输入信号到具体 DOM 事件的映射，
+ *              使得上层可以使用语义化的鼠标信号，而不必关心具体的 DOM 事件
+ */
+export const mouseMap = {
+    press: {
+        mouse: ['mousedown'], // 鼠标按下事件映射
+    },
+    release: {
+        mouse: ['mouseup'], // 鼠标释放事件映射
+    },
+    move: {
+        mouse: ['mousemove'], // 鼠标移动事件映射
+    },
+    enter: {
+        mouse: ['mouseenter'], // 鼠标进入元素事件映射
+    },
+    leave: {
+        mouse: ['mouseleave'], // 鼠标离开元素事件映射
+    },
+    over: {
+        mouse: ['mouseover'], // 鼠标悬停事件映射（会冒泡）
+    },
+    out: {
+        mouse: ['mouseout'], // 鼠标移出事件映射（会冒泡）
+    },
+};
+//# sourceMappingURL=mouse.js.map

package/dist/event-dom/adapters/semantic-map/mouse.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/mouse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACnC,KAAK,EAAE;QACH,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW;KACpC;IACD,OAAO,EAAE;QACL,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW;KAClC;IACD,IAAI,EAAE;QACF,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW;KACpC;IACD,KAAK,EAAE;QACH,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa;KACvC;IACD,KAAK,EAAE;QACH,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa;KACvC;IACD,IAAI,EAAE;QACF,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,gBAAgB;KACzC;IACD,GAAG,EAAE;QACD,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,gBAAgB;KACxC;CACJ,CAAC"}

package/dist/event-dom/adapters/semantic-map/pointer.esm.js

@@ -0,0 +1,38 @@
+/**
+ * 指针事件映射
+ * pointerMap 原则：
+ *
+ *     只包含指针设备相关的事件
+ *
+ *     仅映射到 pointer 类型的 DOM 事件
+ *
+ * @description 定义了指针设备（鼠标、触摸笔、触摸屏）的输入信号到具体 DOM 事件的映射，
+ *              使得上层可以使用统一的语义化指针信号，而不必关心具体的输入设备类型
+ */
+export const pointerMap = {
+    press: {
+        pointer: ['pointerdown'], // 指针按下事件映射
+    },
+    move: {
+        pointer: ['pointermove'], // 指针移动事件映射
+    },
+    release: {
+        pointer: ['pointerup'], // 指针释放事件映射
+    },
+    cancel: {
+        pointer: ['pointercancel'], // 指针取消事件映射
+    },
+    enter: {
+        pointer: ['pointerenter'], // 指针进入元素事件映射
+    },
+    leave: {
+        pointer: ['pointerleave'], // 指针离开元素事件映射
+    },
+    over: {
+        pointer: ['pointerover'], // 指针悬停事件映射（会冒泡）
+    },
+    out: {
+        pointer: ['pointerout'], // 指针移出事件映射（会冒泡）
+    },
+};
+//# sourceMappingURL=pointer.js.map

package/dist/event-dom/adapters/semantic-map/pointer.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/pointer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB;IACrC,KAAK,EAAE;QACH,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,WAAW;KACxC;IACD,IAAI,EAAE;QACF,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,WAAW;KACxC;IACD,OAAO,EAAE;QACL,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW;KACtC;IACD,MAAM,EAAE;QACJ,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,WAAW;KAC1C;IACD,KAAK,EAAE;QACH,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,aAAa;KAC3C;IACD,KAAK,EAAE;QACH,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,aAAa;KAC3C;IACD,IAAI,EAAE;QACF,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,gBAAgB;KAC7C;IACD,GAAG,EAAE;QACD,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,gBAAgB;KAC5C;CACJ,CAAC"}

package/dist/event-dom/adapters/semantic-map/resolve.esm.js

@@ -0,0 +1,49 @@
+// input/maps/resolve.ts
+import { detectInputCapabilities } from '../../../runtime/index.esm.js';
+/**
+ * 根据设备能力解析输入事件映射
+ *
+ * @description 根据当前设备的输入能力，动态选择合适的事件映射配置。
+ *              优先级顺序：Pointer -> Touch -> Mouse -> Keyboard
+ *
+ * @param maps - 包含各种输入设备映射的对象
+ * @returns 合并后的输入事件映射，只包含当前设备支持的事件类型
+ *
+ * @example
+ * ```ts
+ * const resolvedMap = resolveInputEventMap({
+ *   base: baseMap,
+ *   pointer: pointerMap,
+ *   touch: touchMap,
+ *   mouse: mouseMap,
+ *   keyboard: keyboardMap
+ * });
+ * ```
+ */
+export function resolveInputEventMap(maps) {
+    // 检测当前设备的输入能力
+    const cap = detectInputCapabilities();
+    // 初始化结果，始终包含基础事件映射
+    const result = {
+        ...maps.base,
+    };
+    // 根据设备能力优先级，添加相应的事件映射
+    if (cap.pointer && maps.pointer) {
+        // 如果支持指针事件且提供了指针映射，则添加指针映射
+        Object.assign(result, maps.pointer);
+    }
+    else if (cap.touch && maps.touch) {
+        // 否则如果支持触摸事件且提供了触摸映射，则添加触摸映射
+        Object.assign(result, maps.touch);
+    }
+    else if (maps.mouse) {
+        // 否则如果提供了鼠标映射，则添加鼠标映射（作为降级方案）
+        Object.assign(result, maps.mouse);
+    }
+    // 键盘映射始终添加（如果提供），因为键盘输入通常独立于其他输入设备
+    if (maps.keyboard) {
+        Object.assign(result, maps.keyboard);
+    }
+    return result;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/event-dom/adapters/semantic-map/resolve.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/resolve.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAMpC;IACG,cAAc;IACd,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IAEtC,mBAAmB;IACnB,MAAM,MAAM,GAAkB;QAC1B,GAAG,IAAI,CAAC,IAAI;KACf,CAAC;IAEF,sBAAsB;IACtB,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,2BAA2B;QAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,6BAA6B;QAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,8BAA8B;QAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,mCAAmC;IACnC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/event-dom/adapters/semantic-map/touch.esm.js

@@ -0,0 +1,26 @@
+/**
+ * 触摸事件映射
+ * touchMap 原则：
+ *
+ *     只包含触摸设备相关的事件
+ *
+ *     仅映射到 touch 类型的 DOM 事件
+ *
+ * @description 定义了触摸设备的输入信号到具体 DOM 事件的映射，
+ *              使得上层可以使用语义化的触摸信号，而不必关心具体的 DOM 事件
+ */
+export const touchMap = {
+    press: {
+        touch: ['touchstart'], // 触摸开始事件映射
+    },
+    move: {
+        touch: ['touchmove'], // 触摸移动事件映射
+    },
+    release: {
+        touch: ['touchend'], // 触摸结束事件映射
+    },
+    cancel: {
+        touch: ['touchcancel'], // 触摸取消事件映射
+    },
+};
+//# sourceMappingURL=touch.js.map

package/dist/event-dom/adapters/semantic-map/touch.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/semantic-map/touch.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACnC,KAAK,EAAE;QACH,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,WAAW;KACrC;IACD,IAAI,EAAE;QACF,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW;KACpC;IACD,OAAO,EAAE;QACL,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,WAAW;KACnC;IACD,MAAM,EAAE;QACJ,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,WAAW;KACtC;CACJ,CAAC"}

package/dist/event-dom/adapters/utils/index.esm.js

@@ -0,0 +1,2 @@
+export * from './validation';
+//# sourceMappingURL=index.js.map

package/dist/event-dom/adapters/utils/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/event-dom/adapters/utils/validation.esm.js

@@ -0,0 +1,67 @@
+import { geometry } from '../../../utils/index.esm.js';
+/**
+ * 验证双击（double tap）手势
+ * 检查两次点击的时间间隔是否在允许范围内，且两次点击的位置是否接近
+ *
+ * @param now 当前时间戳
+ * @param lastTapTime 上一次点击的时间戳
+ * @param currentX 当前点击位置的X坐标
+ * @param currentY 当前点击位置的Y坐标
+ * @param lastTapX 上一次点击位置的X坐标
+ * @param lastTapY 上一次点击位置的Y坐标
+ * @param maxInterval 最大时间间隔（毫秒），超过此时间则不是双击
+ * @param maxDistance 最大距离（像素），两次点击位置的距离不能超过此值
+ * @returns 如果满足双击条件返回true，否则返回false
+ */
+export function validateDoubleTap(now, lastTapTime, currentX, currentY, lastTapX, lastTapY, maxInterval, maxDistance) {
+    if (now - lastTapTime >= maxInterval) {
+        return false;
+    }
+    return geometry.isWithinRadius({ x: currentX, y: currentY }, { x: lastTapX, y: lastTapY }, maxDistance);
+}
+/**
+ * 验证长按（long press）手势
+ * 检查手指当前位置与起始位置的距离是否在允许范围内
+ *
+ * @param startX 按下开始时的X坐标
+ * @param startY 按下开始时的Y坐标
+ * @param currentX 当前位置的X坐标
+ * @param currentY 当前位置的Y坐标
+ * @param maxDistance 最大移动距离（像素），超过此距离则不是长按
+ * @returns 如果满足长按条件返回true，否则返回false
+ */
+export function validateLongPress(startX, startY, currentX, currentY, maxDistance) {
+    return geometry.isWithinRadius({ x: currentX, y: currentY }, { x: startX, y: startY }, maxDistance);
+}
+/**
+ * 验证滑动（swipe）手势
+ * 检查滑动的距离、持续时间和速度是否满足滑动条件
+ *
+ * @param distance 滑动距离（像素）
+ * @param duration 滑动持续时间（毫秒）
+ * @param minDistance 最小滑动距离（像素），低于此距离则不是滑动
+ * @param maxDuration 最大持续时间（毫秒），超过此时间则不是滑动
+ * @param minVelocity 最小速度（像素/毫秒），低于此速度则不是滑动
+ * @returns 如果满足滑动条件返回true，否则返回false
+ */
+export function validateSwipe(distance, duration, minDistance, maxDuration, minVelocity) {
+    if (duration >= maxDuration || distance < minDistance) {
+        return false;
+    }
+    const velocity = geometry.calculateVelocity(distance, duration);
+    return velocity >= minVelocity;
+}
+/**
+ * 验证轻敲（tap）手势
+ * 检查触摸持续时间和移动距离是否满足轻敲条件
+ *
+ * @param duration 触摸持续时间（毫秒）
+ * @param distance 手指移动距离（像素）
+ * @param maxDuration 最大持续时间（毫秒），超过此时间则不是轻敲
+ * @param maxDistance 最大移动距离（像素），超过此距离则不是轻敲
+ * @returns 如果满足轻敲条件返回true，否则返回false
+ */
+export function validateTap(duration, distance, maxDuration, maxDistance) {
+    return duration <= maxDuration && distance <= maxDistance;
+}
+//# sourceMappingURL=validation.js.map

package/dist/event-dom/adapters/utils/validation.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../../src/event-dom/adapters/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC7B,GAAW,EACX,WAAmB,EACnB,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,WAAmB,EACnB,WAAmB;IAEnB,IAAI,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,QAAQ,CAAC,cAAc,CAC1B,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAC5B,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAC5B,WAAW,CACd,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC7B,MAAc,EACd,MAAc,EACd,QAAgB,EAChB,QAAgB,EAChB,WAAmB;IAEnB,OAAO,QAAQ,CAAC,cAAc,CAC1B,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAC5B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EACxB,WAAW,CACd,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CACzB,QAAgB,EAChB,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,WAAmB;IAEnB,IAAI,QAAQ,IAAI,WAAW,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChE,OAAO,QAAQ,IAAI,WAAW,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACvB,QAAgB,EAChB,QAAgB,EAChB,WAAmB,EACnB,WAAmB;IAEnB,OAAO,QAAQ,IAAI,WAAW,IAAI,QAAQ,IAAI,WAAW,CAAC;AAC9D,CAAC"}

package/dist/event-dom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/event-dom",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,11 +13,11 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/events": "0.1.3",
-    "@qimen-lab/utils": "0.1.3",
-    "@qimen-lab/runtime": "0.1.3",
-    "@qimen-lab/logger": "0.1.3",
-    "@qimen-lab/error": "0.1.3",
-    "@qimen-lab/async": "0.1.3"
+    "@qimen-lab/events": "0.1.4",
+    "@qimen-lab/utils": "0.1.4",
+    "@qimen-lab/runtime": "0.1.4",
+    "@qimen-lab/logger": "0.1.4",
+    "@qimen-lab/error": "0.1.4",
+    "@qimen-lab/async": "0.1.4"
   }
 }

package/dist/event-dom/types/adapters/base.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/event-dom/types/adapters/base.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/event-dom/types/adapters/base.ts"],"names":[],"mappings":""}

package/dist/event-dom/types/adapters/index.esm.js

@@ -0,0 +1,4 @@
+export * from './base';
+export * from './map';
+export * from './processors';
+//# sourceMappingURL=index.js.map

package/dist/event-dom/types/adapters/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/event-dom/types/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}

package/dist/event-dom/types/adapters/map.esm.js

@@ -0,0 +1,5 @@
+/* ============================================
+ * 1️⃣ AtomicSignal：真实 DOM 能发出的事件
+ * ============================================ */
+export {};
+//# sourceMappingURL=map.js.map

package/dist/event-dom/types/adapters/map.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../src/event-dom/types/adapters/map.ts"],"names":[],"mappings":"AAAA;;kDAEkD"}

package/dist/event-dom/types/adapters/processors.esm.js

@@ -0,0 +1,10 @@
+/**
+ * @file types.ts
+ * @description
+ * 定义手势处理器模块中使用的类型定义。
+ *
+ * 该文件包含手势输入、手势事件、约束条件等相关类型定义，
+ * 为手势处理器提供统一的类型接口。
+ */
+export {};
+//# sourceMappingURL=processors.js.map

package/dist/event-dom/types/adapters/processors.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processors.js","sourceRoot":"","sources":["../../../../../src/event-dom/types/adapters/processors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/event-dom/types/index.esm.js

@@ -0,0 +1,10 @@
+/**
+ * @qimenjs/event-dom 类型定义
+ *
+ * 导出DOM事件处理的所有类型
+ */
+// 导出核心事件类型（从@qimenjs/event重新导出）
+export * from '../../events/types';
+// 导出DOM事件特有类型
+export * from './adapters';
+//# sourceMappingURL=index.js.map

package/dist/event-dom/types/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/event-dom/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gCAAgC;AAChC,cAAc,oBAAoB,CAAC;AAEnC,cAAc;AACd,cAAc,YAAY,CAAC"}

package/dist/events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qimen-lab/events",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "index.js",
   "module": "index.esm.js",
   "types": "index.d.ts",
@@ -13,7 +13,7 @@
     }
   },
   "dependencies": {
-    "@qimen-lab/logger": "0.1.3",
-    "@qimen-lab/utils": "0.1.3"
+    "@qimen-lab/logger": "0.1.4",
+    "@qimen-lab/utils": "0.1.4"
   }
 }

package/dist/events/types/bus.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bus.js.map

package/dist/events/types/bus.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../../../src/events/types/bus.ts"],"names":[],"mappings":""}

package/dist/events/types/core.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core.js.map

package/dist/events/types/core.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../src/events/types/core.ts"],"names":[],"mappings":""}

package/dist/events/types/index.esm.js

@@ -0,0 +1,9 @@
+/**
+ * @qimenjs/event 类型定义
+ *
+ * 导出核心事件系统的所有类型
+ */
+export * from './core';
+export * from './bus';
+export * from './scope';
+//# sourceMappingURL=index.js.map

package/dist/events/types/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/events/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}

package/dist/events/types/scope.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.js.map

package/dist/events/types/scope.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../../src/events/types/scope.ts"],"names":[],"mappings":""}

package/dist/http/actions/align/DownloadInterceptor.esm.js

@@ -0,0 +1,27 @@
+/**
+ * @file DownloadInterceptor.ts
+ * @description
+ * 该文件实现了下载拦截器，用于处理被识别为下载类型的响应。
+ * 当响应被标记为下载且包含有效的Blob数据时，它会触发浏览器的文件下载功能。
+ */
+export const DownloadInterceptorHandler = async (context) => {
+    if (!context.metadata.isDownload)
+        return;
+    // 只有在成功解析出 Blob 且被判定为下载时执行
+    const canDownload = context.metadata.isDownload && !context.error && context.data.raw instanceof Blob;
+    if (!canDownload)
+        return;
+    // 执行下载（创建下载链接）
+    const blob = context.data.raw;
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = context.metadata.fileName || 'download';
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+    // 记录审计日志或标记
+    context.metadata.isDownloadHandled = true;
+};
+//# sourceMappingURL=DownloadInterceptor.js.map