@edv4h/usketch-plugin-presence-cursor 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdV4H
+
+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/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createPresenceCursorPlugin, type PresenceCursorOptions } from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createPresenceCursorPlugin } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAA8B,MAAM,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { UsketchPlugin } from "@edv4h/usketch-shared";
+import type { WsProviderHandle } from "@edv4h/usketch-sync";
+export interface PresenceCursorOptions {
+    wsProvider: WsProviderHandle;
+    userId: string;
+    userName: string;
+}
+export declare function createPresenceCursorPlugin(options: PresenceCursorOptions): UsketchPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAwE5D,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAwFxF"}

package/dist/plugin.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+const CURSOR_COLORS = [
+    "#e74c3c",
+    "#3498db",
+    "#2ecc71",
+    "#f39c12",
+    "#9b59b6",
+    "#1abc9c",
+    "#e67e22",
+    "#e84393",
+];
+function getUserColor(userId) {
+    let hash = 0;
+    for (let i = 0; i < userId.length; i++) {
+        hash = (hash * 31 + userId.charCodeAt(i)) | 0;
+    }
+    return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];
+}
+const STATUS_EMOJI = {
+    active: "",
+    away: "💤",
+    busy: "🔴",
+    presenting: "📺",
+};
+function RemoteCursor({ obj }) {
+    const color = obj.data.color || "#999";
+    const name = obj.data.name || "";
+    const status = obj.data.status || "active";
+    const statusEmoji = STATUS_EMOJI[status] ?? "";
+    return (_jsxs(_Fragment, { children: [_jsx("svg", { width: "16", height: "22", viewBox: "0 0 16 22", style: { position: "absolute", left: -2, top: -2 }, children: _jsx("path", { d: "M0 0L14 10.5L7.5 11.5L11 21L7 19L4 11L0 14Z", fill: color, stroke: "#fff", strokeWidth: "1" }) }), (name || statusEmoji) && (_jsxs("div", { style: {
+                    position: "absolute",
+                    left: 16,
+                    top: 16,
+                    background: color,
+                    color: "#fff",
+                    fontSize: "11px",
+                    padding: "1px 5px",
+                    borderRadius: "3px",
+                    whiteSpace: "nowrap",
+                    pointerEvents: "none",
+                }, children: [statusEmoji && _jsx("span", { style: { marginRight: 2 }, children: statusEmoji }), name] }))] }));
+}
+export function createPresenceCursorPlugin(options) {
+    const { wsProvider, userId, userName } = options;
+    const color = getUserColor(userId);
+    const { awareness } = wsProvider;
+    let cleanup;
+    return {
+        id: "usketch-plugin-presence-cursor",
+        name: "プレゼンスカーソル",
+        setup(ctx) {
+            ctx.transient.registerType("remote-cursor", {
+                render: (obj) => _jsx(RemoteCursor, { obj: obj }),
+            });
+            awareness.setLocalStateField("user", { name: userName, color });
+            const activeCursors = new Set();
+            function onAwarenessChange() {
+                const states = awareness.getStates();
+                const currentClients = new Set();
+                for (const [clientId, state] of states) {
+                    if (clientId === awareness.doc.clientID)
+                        continue;
+                    const user = state.user;
+                    const cursor = state.cursor;
+                    // バリデーション
+                    if (!user || !cursor || typeof cursor.x !== "number" || typeof cursor.y !== "number") {
+                        continue;
+                    }
+                    currentClients.add(clientId);
+                    ctx.transient.emit({
+                        id: `cursor-${clientId}`,
+                        type: "remote-cursor",
+                        sourceUserId: String(clientId),
+                        position: { x: cursor.x, y: cursor.y },
+                        data: {
+                            name: user.name || "",
+                            color: user.color || getUserColor(String(clientId)),
+                            status: user.status ?? (state.presenting === true ? "presenting" : "active"),
+                        },
+                        ttl: 5000,
+                        createdAt: Date.now(),
+                    });
+                }
+                for (const clientId of activeCursors) {
+                    if (!currentClients.has(clientId)) {
+                        ctx.transient.dismiss(`cursor-${clientId}`);
+                    }
+                }
+                activeCursors.clear();
+                for (const id of currentClients) {
+                    activeCursors.add(id);
+                }
+            }
+            awareness.on("change", onAwarenessChange);
+            // canvas:pointermoveイベントからworldPoint座標を取得
+            const unsubPointerMove = ctx.events.on("canvas:pointermove", (event) => {
+                awareness.setLocalStateField("cursor", event.worldPoint);
+            });
+            const handleMouseLeave = () => {
+                awareness.setLocalStateField("cursor", null);
+            };
+            window.addEventListener("mouseleave", handleMouseLeave);
+            cleanup = () => {
+                awareness.off("change", onAwarenessChange);
+                unsubPointerMove();
+                window.removeEventListener("mouseleave", handleMouseLeave);
+            };
+        },
+        teardown() {
+            cleanup?.();
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@edv4h/usketch-plugin-presence-cursor",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@edv4h/usketch-sync": "1.0.0",
+    "@edv4h/usketch-shared": "1.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.14",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EdV4H/usketch.git",
+    "directory": "plugins/usketch-plugin-presence-cursor"
+  },
+  "homepage": "https://github.com/EdV4H/usketch#readme",
+  "bugs": {
+    "url": "https://github.com/EdV4H/usketch/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}