feat: add pointerEvent

DOC.md

@@ -11065,6 +11065,28 @@ const stooges = [
 pluck(stooges, 'name'); // -> ['moe', 'larry', 'curly']
 ```
 
+## pointerEvent 
+
+Get the pointer event name, use touch and mouse events as a fallback if not supported.
+
+<details>
+<summary>Type Definition</summary>
+
+```typescript
+function pointerEvent(type: 'down' | 'move' | 'up'): string;
+```
+
+</details>
+
+|Name  |Desc                        |
+|------|----------------------------|
+|type  |Event type, down, move or up|
+|return|Pointer event name          |
+
+```javascript
+pointerEvent('down'); // -> 'pointerdown' if supported
+```
+
 ## precision 
 
 Find decimal precision of a given number.

DOC_CN.md

@@ -11056,6 +11056,28 @@ const stooges = [
 pluck(stooges, 'name'); // -> ['moe', 'larry', 'curly']
 ```
 
+## pointerEvent
+
+获取 pointer 事件名，如果不支持使用 touch 或 mouse 事件替代。
+
+<details>
+<summary>类型定义</summary>
+
+```typescript
+function pointerEvent(type: 'down' | 'move' | 'up'): string;
+```
+
+</details>
+
+|参数名|说明|
+|-----|---|
+|type|事件类型，down，move 或 up|
+|返回值|pointer 事件名|
+
+```javascript
+pointerEvent('down'); // -> 'pointerdown' if supported
+```
+
 ## precision
 
 获取数字的精度。

cspell.json

@@ -321,6 +321,7 @@
     "pick",
     "pipe",
     "pluck",
+    "pointerEvent",
     "precision",
     "prefetch",
     "prefix",

i18n/pointerEvent.md

@@ -0,0 +1,8 @@
+## CN
+
+获取 pointer 事件名，如果不支持使用 touch 或 mouse 事件替代。
+
+|参数名|说明|
+|-----|---|
+|type|事件类型，down，move 或 up|
+|返回值|pointer 事件名|

index.json

@@ -5196,6 +5196,18 @@
             "browser"
         ]
     },
+    "pointerEvent": {
+        "dependencies": [
+            "root"
+        ],
+        "description": "Get the pointer event name, use touch and mouse events as a fallback if not supported.",
+        "env": [
+            "browser"
+        ],
+        "test": [
+            "browser"
+        ]
+    },
     "precision": {
         "dependencies": [],
         "description": "Find decimal precision of a given number.",

src/Channel.js

@@ -101,7 +101,7 @@ exports = Emitter.extend({
     },
     isConnected(connection) {
         if (connection === this) {
-            throw new Error('Connection cannot be connected to itself.');
+            throw new Error('Channel cannot be connected to itself.');
         }
 
         return some(this._connections, item => item === connection);

src/pointerEvent.js

@@ -0,0 +1,50 @@
+/* Get the pointer event name, use touch and mouse events as a fallback if not supported.
+ *
+ * |Name  |Desc                        |
+ * |------|----------------------------|
+ * |type  |Event type, down, move or up|
+ * |return|Pointer event name          |
+ */
+
+/* example
+ * pointerEvent('down'); // -> 'pointerdown' if supported
+ */
+
+/* module
+ * env: browser
+ */
+
+/* typescript
+ * export declare function pointerEvent(type: 'down' | 'move' | 'up'): string;
+ */
+
+_('root');
+
+const touchEvents = {
+    down: 'touchstart',
+    move: 'touchmove',
+    up: 'touchend'
+};
+
+const mouseEvents = {
+    down: 'mousedown',
+    move: 'mousemove',
+    up: 'mouseup'
+};
+
+const pointerEvents = {
+    down: 'pointerdown',
+    move: 'pointermove',
+    up: 'pointerup'
+};
+
+const hasPointerSupport = 'PointerEvent' in root;
+const hasTouchSupport = 'ontouchstart' in root;
+
+exports = function(type) {
+    if (hasPointerSupport) {
+        return pointerEvents[type];
+    }
+
+    return hasTouchSupport ? touchEvents[type] : mouseEvents[type];
+};

test/pointerEvent.js

@@ -0,0 +1,5 @@
+tests([
+    ['up', 'pointerup'],
+    ['down', 'pointerdown'],
+    ['move', 'pointermove']
+]);