@splicetree/plugin-pointer 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @splicetree/plugin-pointer
+
+## 0.1.0
+
+### Minor Changes
+
+- ### @splicetree/plugin-pointer
+  - 新增输入插件，采集节点点击事件并派发 `input:node-click`
+  - 事件负载包含修饰键：`shift/ctrl/meta/alt`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Michael Cocova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @splicetree/plugin-pointer
+
+采集节点点击事件，统一派发 `input:node-click` 语义事件，供行为插件消费（如 `@splicetree/plugin-selectable`、`@splicetree/plugin-checkable`）。
+
+[![version](https://img.shields.io/npm/v/@splicetree/plugin-pointer.svg?label=version)](https://www.npmjs.com/package/@splicetree/plugin-pointer)
+[![downloads](https://img.shields.io/npm/dm/@splicetree/plugin-pointer.svg)](https://npmcharts.com/compare/%40splicetree%2Fplugin-pointer?minimal=true)
+[![license](https://img.shields.io/npm/l/@splicetree/plugin-pointer.svg)](https://www.npmjs.com/package/@splicetree/plugin-pointer)
+[![Website](https://img.shields.io/static/v1?label=Website&message=splicetree.dev&color=blue)](https://www.splicetree.dev)
+[![GitHub](https://img.shields.io/static/v1?label=GitHub&message=splicetree%2Fsplicetree&logo=github)](https://github.com/michaelcocova/splicetree)
+
+## 安装
+
+`pnpm add @splicetree/plugin-pointer`
+
+## 使用
+
+```ts
+import { createSpliceTree } from '@splicetree/core'
+import pointer from '@splicetree/plugin-pointer'
+
+const tree = createSpliceTree(data, {
+  plugins: [pointer],
+})
+
+// 在视图中调用
+// onClick(nodeId, e) 会派发 input:node-click 事件（包含修饰键）
+tree.onClick('a', mouseEvent)
+```
+
+## Api
+
+- 事件派发
+  - `onClick(nodeId, e: MouseEvent)` 派发 `input:node-click`
+- 事件负载
+  - `nodeId: string`
+  - `modifiers: { shift: boolean; ctrl: boolean; meta: boolean; alt: boolean }`

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { SpliceTreePlugin } from "@splicetree/core";
+
+//#region src/index.d.ts
+interface Modifiers {
+  shift: boolean;
+  ctrl: boolean;
+  meta: boolean;
+  alt: boolean;
+}
+declare module '@splicetree/core' {
+  interface SpliceTreeEventPayloadMap {
+    'input:node-click': {
+      nodeId: string;
+      modifiers: Modifiers;
+    };
+  }
+  interface SpliceTreeInstance {
+    onClick: (nodeId: string, e: MouseEvent) => void;
+  }
+}
+declare const pointerPlugin: SpliceTreePlugin;
+//#endregion
+export { pointerPlugin as default, pointerPlugin };

package/dist/index.js

@@ -0,0 +1,26 @@
+//#region src/index.ts
+function getModifiers(e) {
+	return {
+		shift: e.shiftKey,
+		ctrl: e.ctrlKey,
+		meta: e.metaKey,
+		alt: e.altKey
+	};
+}
+const pointerPlugin = {
+	name: "pointer",
+	setup(ctx) {
+		const onClick = (nodeId, e) => {
+			ctx.events.emit({
+				name: "input:node-click",
+				nodeId,
+				modifiers: getModifiers(e)
+			});
+		};
+		return { onClick };
+	}
+};
+var src_default = pointerPlugin;
+
+//#endregion
+export { src_default as default, pointerPlugin };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@splicetree/plugin-pointer",
+  "type": "module",
+  "version": "0.1.1",
+  "author": {
+    "email": "michael.cocova@gmail.com",
+    "name": "Michael Cocova"
+  },
+  "license": "MIT",
+  "homepage": "https://www.splicetree.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/michaelcocova/splicetree"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@splicetree/core": "0.1.1"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown"
+  }
+}

package/src/index.ts

@@ -0,0 +1,46 @@
+import type { SpliceTreePlugin, SpliceTreePluginContext } from '@splicetree/core'
+import '@splicetree/core'
+
+interface Modifiers {
+  shift: boolean
+  ctrl: boolean
+  meta: boolean
+  alt: boolean
+}
+
+declare module '@splicetree/core' {
+  export interface SpliceTreeEventPayloadMap {
+    'input:node-click': {
+      nodeId: string
+      modifiers: Modifiers
+    }
+  }
+  export interface SpliceTreeInstance {
+    onClick: (nodeId: string, e: MouseEvent) => void
+  }
+}
+
+function getModifiers(e: MouseEvent) {
+  return {
+    shift: e.shiftKey,
+    ctrl: e.ctrlKey,
+    meta: e.metaKey,
+    alt: e.altKey,
+  }
+}
+
+export const pointerPlugin: SpliceTreePlugin = {
+  name: 'pointer',
+  setup(ctx: SpliceTreePluginContext) {
+    const onClick = (nodeId: string, e: MouseEvent) => {
+      ctx.events.emit({
+        name: 'input:node-click',
+        nodeId,
+        modifiers: getModifiers(e),
+      })
+    }
+    return { onClick }
+  },
+}
+
+export default pointerPlugin

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "declaration": true,
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["dist", "node_modules"]
+}

package/tsdown.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  clean: true,
+  sourcemap: false,
+  treeshake: true,
+  unused: true,
+  unbundle: false,
+  platform: 'neutral',
+  entry: ['./src/index.ts'],
+})