@combos-fun/plugin-renderer-3d-event 0.0.40

package/README.md

@@ -0,0 +1,27 @@
+# @combos-fun/plugin-renderer-3d-event
+
+@combos-fun/plugin-renderer-3d-event — part of the Combos Fun engine monorepo.
+
+Keywords: `3d`, `pointer`, `touch`, `tap`, `raycast`, `input`, `event`.
+
+## Documentation
+
+- Per-package agent / developer notes: [`agent-skill.md`](./agent-skill.md)
+- Machine-readable manifest: [`combos-plugin.json`](./combos-plugin.json)
+  (validated against `schemas/combos-plugin.schema.json` in the repo
+  root)
+- Entry skill (single source of truth for AI agents working with this
+  monorepo): `skills/combos-engine-development/SKILL.md`
+
+When consumed from npm, the manifest and agent notes are exposed as
+stable subpaths:
+
+```ts
+import manifest from '@combos-fun/plugin-renderer-3d-event/plugin-manifest';
+// or fetch the markdown directly:
+// require.resolve('@combos-fun/plugin-renderer-3d-event/agent-skill')
+```
+
+## License
+
+Internal workspace package, part of the Combos Fun engine monorepo.

package/agent-skill.md

@@ -0,0 +1,79 @@
+# `@combos-fun/plugin-renderer-3d-event` — Agent notes
+
+Pointer / touch input for the 3D pipeline via Three.js `Raycaster`. Pointer events on the WebGL canvas are converted to NDC, raycast against tagged meshes, and forwarded as `tap` / `touchstart` / `touchmove` / `touchend` on the `Event3D` Component.
+
+There is **no keyboard** API here (same as 2D `plugin-renderer-event`). `surface.input` in host templates is a design hint, not a runtime switch.
+
+## When to read
+
+Read for any 3D input task: tap a mesh, drag, pick a model, or wire UI-like 3D objects.
+
+## Public API
+
+```ts
+import {
+  Event3DSystem,
+  Event3D,
+  type Event3DParams,
+  type Event3DSystemParams,
+} from '@combos-fun/plugin-renderer-3d-event';
+```
+
+`componentName = 'Event3D'`, `systemName = 'Event3DSystem'`. Use `game.getSystem(Event3DSystem)`, not a string.
+
+Hit testing uses the GameObject's mesh (every 3D renderer tags `Object3D.userData.combosGameObjectId`). There is no separate `hitArea` shape.
+
+### Events emitted by the `Event3D` component
+
+`touchstart`, `touchmove`, `touchend`, `tap`, `touchendoutside`, `touchcancel`.
+
+Callback payload:
+
+```ts
+(payload) => {
+  payload.stopPropagation();
+  payload.data.pointerId;
+  payload.data.position;        // canvas-pixel space
+  payload.data.localPosition;   // hit point in the mesh's local space (x/y/z)
+  payload.gameObject;
+};
+```
+
+## Required setup
+
+- Add `Renderer3DSystem` before `Event3DSystem`.
+- Put `Event3D` on the same GameObject as the visual (`Model3D`, `Graphics3D`, `Img3D`, …).
+- Meshes must already be in the scene (the matching 3D renderer system must be registered).
+
+## Runtime behaviour
+
+- First raycast hit that belongs to a GameObject with `Event3D` wins.
+- `tap` fires on `pointerup` when the press and release hit the same GameObject.
+- `touchendoutside` fires when the pointer is released on a different object (or none).
+
+## Common pitfalls
+
+| Symptom | Fix |
+|---------|-----|
+| `tap` never fires | Add `Event3DSystem`, attach `Event3D` on the **same** GO as the mesh |
+| Hits the wrong object | First mesh along the ray wins; move the camera or the mesh |
+| Nothing is pickable | Confirm the 3D renderer tagged the mesh (official `plugin-renderer-3d-*` systems do) |
+| Using 2D `Event` / `EventSystem` in a 3D game | Use `Event3D` / `Event3DSystem` — Pixi hit-areas do not apply |
+
+## Minimal example
+
+```ts
+import { Event3D } from '@combos-fun/plugin-renderer-3d-event';
+import { Graphics3D } from '@combos-fun/plugin-renderer-3d-graphics';
+
+const box = new GameObject('box');
+box.addComponent(new Graphics3D({ shape: 'box', width: 1, height: 1, depth: 1, color: 0xffaa00 }));
+box.addComponent(new Event3D());
+box.getComponent(Event3D)!.on('tap', () => {
+  /* handle */
+});
+```
+
+## Verification
+
+`pnpm --filter @combos-fun/plugin-renderer-3d-event run build`.

package/combos-plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "@combos-fun/plugin-renderer-3d-event",
+  "pluginId": "renderer-3d-event",
+  "category": "input",
+  "dimension": "3d",
+  "isCore": false,
+  "keywords": ["3d", "pointer", "touch", "tap", "raycast", "input", "event"],
+  "agentSkill": "./agent-skill.md",
+  "requires": ["@combos-fun/engine", "@combos-fun/plugin-renderer-3d"],
+  "exports": ["Event3DSystem", "Event3D"]
+}

package/dist/plugin-renderer-3d-event.cjs.js

@@ -0,0 +1,174 @@
+'use strict';
+
+var tslib = require('tslib');
+var engine = require('@combos-fun/engine');
+var pluginRenderer3d = require('@combos-fun/plugin-renderer-3d');
+var three = require('three');
+
+class Event3D extends engine.Component {
+    static { this.componentName = 'Event3D'; }
+    init(params) {
+        params && Object.assign(this, params);
+    }
+    emit(en, ...args) {
+        return super.emit(en, ...args);
+    }
+    once(en, fn, context) {
+        return super.once(en, fn, context);
+    }
+    on(en, fn, context) {
+        return super.on(en, fn, context);
+    }
+}
+
+let Event3DSystem = class Event3DSystem extends pluginRenderer3d.Renderer3D {
+    constructor() {
+        super(...arguments);
+        this.name = 'Event3DSystem';
+        this.raycaster = new three.Raycaster();
+        this.ndc = new three.Vector2();
+        this.localScratch = new three.Vector3();
+        this.downByPointer = new Map();
+        this.canvas = null;
+        this.onPointerDown = (e) => this.handlePointer(e, 'touchstart');
+        this.onPointerMove = (e) => this.handlePointer(e, 'touchmove');
+        this.onPointerUp = (e) => this.handlePointer(e, 'touchend');
+        this.onPointerCancel = (e) => this.handlePointer(e, 'touchcancel');
+    }
+    static { this.systemName = 'Event3DSystem'; }
+    init(_params) {
+        const renderer3DSystem = this.game.getSystem(pluginRenderer3d.Renderer3DSystem);
+        renderer3DSystem.rendererManager.register(this);
+        this.canvas = this.threeContext.renderer.domElement;
+        this.canvas.style.touchAction = 'none';
+        this.canvas.addEventListener('pointerdown', this.onPointerDown);
+        this.canvas.addEventListener('pointermove', this.onPointerMove);
+        this.canvas.addEventListener('pointerup', this.onPointerUp);
+        this.canvas.addEventListener('pointercancel', this.onPointerCancel);
+        this.canvas.addEventListener('pointerleave', this.onPointerCancel);
+    }
+    componentChanged(changed) {
+        if (changed.componentName !== 'Event3D')
+            return;
+        if (changed.type === engine.OBSERVER_TYPE.REMOVE) {
+            changed.component.removeAllListeners();
+            for (const [pointerId, hit] of this.downByPointer) {
+                if (hit.gameObject.id === changed.gameObject.id) {
+                    this.downByPointer.delete(pointerId);
+                }
+            }
+        }
+    }
+    rendererUpdate(_gameObject) { }
+    onDestroy() {
+        if (!this.canvas)
+            return;
+        this.canvas.removeEventListener('pointerdown', this.onPointerDown);
+        this.canvas.removeEventListener('pointermove', this.onPointerMove);
+        this.canvas.removeEventListener('pointerup', this.onPointerUp);
+        this.canvas.removeEventListener('pointercancel', this.onPointerCancel);
+        this.canvas.removeEventListener('pointerleave', this.onPointerCancel);
+        this.canvas = null;
+        this.downByPointer.clear();
+    }
+    handlePointer(e, kind) {
+        const hit = this.hitFromEvent(e);
+        const canvasPos = this.canvasPosition(e);
+        if (kind === 'touchstart') {
+            if (!hit)
+                return;
+            this.downByPointer.set(e.pointerId, hit);
+            this.emitOn(hit, 'touchstart', e, canvasPos);
+            return;
+        }
+        if (kind === 'touchmove') {
+            if (!hit)
+                return;
+            this.emitOn(hit, 'touchmove', e, canvasPos);
+            return;
+        }
+        const down = this.downByPointer.get(e.pointerId);
+        this.downByPointer.delete(e.pointerId);
+        if (kind === 'touchcancel') {
+            if (down)
+                this.emitOn(down, 'touchcancel', e, canvasPos);
+            return;
+        }
+        if (hit && down && hit.gameObject.id === down.gameObject.id) {
+            this.emitOn(hit, 'touchend', e, canvasPos);
+            this.emitOn(hit, 'tap', e, canvasPos);
+            return;
+        }
+        if (down) {
+            this.emitOn(down, 'touchendoutside', e, canvasPos);
+        }
+        if (hit) {
+            this.emitOn(hit, 'touchend', e, canvasPos);
+        }
+    }
+    emitOn(hit, eventName, e, canvasPos) {
+        let stopped = false;
+        hit.component.emit(eventName, {
+            stopPropagation: () => { stopped = true; },
+            data: {
+                pointerId: e.pointerId,
+                position: canvasPos,
+                localPosition: {
+                    x: hit.local.x,
+                    y: hit.local.y,
+                    z: hit.local.z,
+                },
+            },
+            gameObject: hit.gameObject,
+        });
+        if (stopped) {
+            e.stopPropagation();
+        }
+    }
+    canvasPosition(e) {
+        const rect = this.canvas.getBoundingClientRect();
+        return {
+            x: e.clientX - rect.left,
+            y: e.clientY - rect.top,
+        };
+    }
+    hitFromEvent(e) {
+        if (!this.canvas)
+            return null;
+        const rect = this.canvas.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0)
+            return null;
+        this.ndc.set(((e.clientX - rect.left) / rect.width) * 2 - 1, -((e.clientY - rect.top) / rect.height) * 2 + 1);
+        this.raycaster.setFromCamera(this.ndc, this.threeContext.camera);
+        const intersections = this.raycaster.intersectObjects(this.threeContext.scene.children, true);
+        for (const intersection of intersections) {
+            const id = pluginRenderer3d.gameObjectIdFromObject3D(intersection.object);
+            if (id == null)
+                continue;
+            const gameObject = this.game.gameObjects.find((go) => go.id === id);
+            if (!gameObject)
+                continue;
+            const component = gameObject.getComponent(Event3D);
+            if (!component)
+                continue;
+            this.localScratch.copy(intersection.point);
+            intersection.object.worldToLocal(this.localScratch);
+            return {
+                gameObject,
+                component,
+                local: this.localScratch.clone(),
+            };
+        }
+        return null;
+    }
+};
+Event3DSystem = tslib.__decorate([
+    engine.decorators.componentObserver({
+        Event3D: [],
+    })
+], Event3DSystem);
+var Event3DSystem_default = Event3DSystem;
+
+exports.Event3D = Event3D;
+exports.Event3DSystem = Event3DSystem_default;
+//# sourceMappingURL=plugin-renderer-3d-event.cjs.js.map

package/dist/plugin-renderer-3d-event.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-renderer-3d-event.cjs.js","sources":["../lib/component.ts","../lib/system.ts"],"sourcesContent":["import { Component } from '@combos-fun/engine';\nimport type { GameObject } from '@combos-fun/engine';\n\ntype TouchEventName = 'touchstart' | 'touchmove' | 'touchend' | 'tap' | 'touchendoutside' | 'touchcancel';\n\nexport type Event3DParam = {\n  stopPropagation: () => void,\n  data: {\n    pointerId: number,\n    position: {\n      x: number,\n      y: number,\n    },\n    localPosition: {\n      x: number,\n      y: number,\n      z: number,\n    },\n  },\n  gameObject: GameObject,\n};\n\nexport interface Event3DParams {}\n\nexport default class Event3D extends Component<Event3DParams> {\n  static componentName = 'Event3D';\n\n  init(params?: Event3DParams) {\n    params && Object.assign(this, params);\n  }\n\n  emit(eventName: TouchEventName, ...args: [Event3DParam]): boolean\n  emit<T extends string>(eventName: Exclude<T, TouchEventName>, ...args: any[]): boolean\n  emit(en: string, ...args: any[]) {\n    return super.emit(en, ...args);\n  }\n\n  once(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this\n  once<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this\n  once(en: string, fn: (...args: any[]) => void, context?: any) {\n    return super.once(en, fn, context);\n  }\n\n  on(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this\n  on<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this\n  on(en: string, fn: (...args: any[]) => void, context?: any) {\n    return super.on(en, fn, context);\n  }\n}\n","import { decorators, ComponentChanged, OBSERVER_TYPE, GameObject } from '@combos-fun/engine';\nimport {\n  Renderer3D,\n  Renderer3DSystem,\n  gameObjectIdFromObject3D,\n} from '@combos-fun/plugin-renderer-3d';\nimport { Raycaster, Vector2, Vector3 } from 'three';\nimport Event3D from './component';\n\nexport interface Event3DSystemParams {}\n\ninterface PointerHit {\n  gameObject: GameObject;\n  component: Event3D;\n  local: Vector3;\n}\n\n@decorators.componentObserver({\n  Event3D: [],\n})\nexport default class Event3DSystem extends Renderer3D {\n  static systemName = 'Event3DSystem';\n  name: string = 'Event3DSystem';\n\n  private raycaster = new Raycaster();\n  private ndc = new Vector2();\n  private localScratch = new Vector3();\n  private downByPointer = new Map<number, PointerHit>();\n  private canvas: HTMLCanvasElement | null = null;\n\n  private onPointerDown = (e: PointerEvent) => this.handlePointer(e, 'touchstart');\n  private onPointerMove = (e: PointerEvent) => this.handlePointer(e, 'touchmove');\n  private onPointerUp = (e: PointerEvent) => this.handlePointer(e, 'touchend');\n  private onPointerCancel = (e: PointerEvent) => this.handlePointer(e, 'touchcancel');\n\n  init(_params?: Event3DSystemParams) {\n    const renderer3DSystem = this.game.getSystem(Renderer3DSystem) as Renderer3DSystem;\n    renderer3DSystem.rendererManager.register(this);\n\n    this.canvas = this.threeContext.renderer.domElement;\n    this.canvas.style.touchAction = 'none';\n    this.canvas.addEventListener('pointerdown', this.onPointerDown);\n    this.canvas.addEventListener('pointermove', this.onPointerMove);\n    this.canvas.addEventListener('pointerup', this.onPointerUp);\n    this.canvas.addEventListener('pointercancel', this.onPointerCancel);\n    this.canvas.addEventListener('pointerleave', this.onPointerCancel);\n  }\n\n  componentChanged(changed: ComponentChanged) {\n    if (changed.componentName !== 'Event3D') return;\n    if (changed.type === OBSERVER_TYPE.REMOVE) {\n      changed.component.removeAllListeners();\n      for (const [pointerId, hit] of this.downByPointer) {\n        if (hit.gameObject.id === changed.gameObject.id) {\n          this.downByPointer.delete(pointerId);\n        }\n      }\n    }\n  }\n\n  rendererUpdate(_gameObject: GameObject) {}\n\n  onDestroy() {\n    if (!this.canvas) return;\n    this.canvas.removeEventListener('pointerdown', this.onPointerDown);\n    this.canvas.removeEventListener('pointermove', this.onPointerMove);\n    this.canvas.removeEventListener('pointerup', this.onPointerUp);\n    this.canvas.removeEventListener('pointercancel', this.onPointerCancel);\n    this.canvas.removeEventListener('pointerleave', this.onPointerCancel);\n    this.canvas = null;\n    this.downByPointer.clear();\n  }\n\n  private handlePointer(e: PointerEvent, kind: 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel') {\n    const hit = this.hitFromEvent(e);\n    const canvasPos = this.canvasPosition(e);\n\n    if (kind === 'touchstart') {\n      if (!hit) return;\n      this.downByPointer.set(e.pointerId, hit);\n      this.emitOn(hit, 'touchstart', e, canvasPos);\n      return;\n    }\n\n    if (kind === 'touchmove') {\n      if (!hit) return;\n      this.emitOn(hit, 'touchmove', e, canvasPos);\n      return;\n    }\n\n    const down = this.downByPointer.get(e.pointerId);\n    this.downByPointer.delete(e.pointerId);\n\n    if (kind === 'touchcancel') {\n      if (down) this.emitOn(down, 'touchcancel', e, canvasPos);\n      return;\n    }\n\n    if (hit && down && hit.gameObject.id === down.gameObject.id) {\n      this.emitOn(hit, 'touchend', e, canvasPos);\n      this.emitOn(hit, 'tap', e, canvasPos);\n      return;\n    }\n\n    if (down) {\n      this.emitOn(down, 'touchendoutside', e, canvasPos);\n    }\n    if (hit) {\n      this.emitOn(hit, 'touchend', e, canvasPos);\n    }\n  }\n\n  private emitOn(\n    hit: PointerHit,\n    eventName: 'touchstart' | 'touchmove' | 'touchend' | 'tap' | 'touchendoutside' | 'touchcancel',\n    e: PointerEvent,\n    canvasPos: { x: number; y: number },\n  ) {\n    let stopped = false;\n    hit.component.emit(eventName, {\n      stopPropagation: () => { stopped = true; },\n      data: {\n        pointerId: e.pointerId,\n        position: canvasPos,\n        localPosition: {\n          x: hit.local.x,\n          y: hit.local.y,\n          z: hit.local.z,\n        },\n      },\n      gameObject: hit.gameObject,\n    });\n    if (stopped) {\n      e.stopPropagation();\n    }\n  }\n\n  private canvasPosition(e: PointerEvent) {\n    const rect = this.canvas.getBoundingClientRect();\n    return {\n      x: e.clientX - rect.left,\n      y: e.clientY - rect.top,\n    };\n  }\n\n  private hitFromEvent(e: PointerEvent): PointerHit | null {\n    if (!this.canvas) return null;\n    const rect = this.canvas.getBoundingClientRect();\n    if (rect.width === 0 || rect.height === 0) return null;\n\n    this.ndc.set(\n      ((e.clientX - rect.left) / rect.width) * 2 - 1,\n      -((e.clientY - rect.top) / rect.height) * 2 + 1,\n    );\n    this.raycaster.setFromCamera(this.ndc, this.threeContext.camera);\n    const intersections = this.raycaster.intersectObjects(this.threeContext.scene.children, true);\n\n    for (const intersection of intersections) {\n      const id = gameObjectIdFromObject3D(intersection.object);\n      if (id == null) continue;\n      const gameObject = this.game.gameObjects.find((go) => go.id === id);\n      if (!gameObject) continue;\n      const component = gameObject.getComponent(Event3D) as Event3D | undefined;\n      if (!component) continue;\n\n      this.localScratch.copy(intersection.point);\n      intersection.object.worldToLocal(this.localScratch);\n      return {\n        gameObject,\n        component,\n        local: this.localScratch.clone(),\n      };\n    }\n    return null;\n  }\n}\n"],"names":["Component","Renderer3D","Raycaster","Vector2","Vector3","Renderer3DSystem","OBSERVER_TYPE","gameObjectIdFromObject3D","__decorate","decorators"],"mappings":"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"}

package/dist/plugin-renderer-3d-event.cjs.prod.js

@@ -0,0 +1 @@
+"use strict";var t=require("tslib"),e=require("@combos-fun/engine"),n=require("@combos-fun/plugin-renderer-3d"),i=require("three");class o extends e.Component{static{this.componentName="Event3D"}init(t){t&&Object.assign(this,t)}emit(t,...e){return super.emit(t,...e)}once(t,e,n){return super.once(t,e,n)}on(t,e,n){return super.on(t,e,n)}}let s=class extends n.Renderer3D{constructor(){super(...arguments),this.name="Event3DSystem",this.raycaster=new i.Raycaster,this.ndc=new i.Vector2,this.localScratch=new i.Vector3,this.downByPointer=new Map,this.canvas=null,this.onPointerDown=t=>this.handlePointer(t,"touchstart"),this.onPointerMove=t=>this.handlePointer(t,"touchmove"),this.onPointerUp=t=>this.handlePointer(t,"touchend"),this.onPointerCancel=t=>this.handlePointer(t,"touchcancel")}static{this.systemName="Event3DSystem"}init(t){this.game.getSystem(n.Renderer3DSystem).rendererManager.register(this),this.canvas=this.threeContext.renderer.domElement,this.canvas.style.touchAction="none",this.canvas.addEventListener("pointerdown",this.onPointerDown),this.canvas.addEventListener("pointermove",this.onPointerMove),this.canvas.addEventListener("pointerup",this.onPointerUp),this.canvas.addEventListener("pointercancel",this.onPointerCancel),this.canvas.addEventListener("pointerleave",this.onPointerCancel)}componentChanged(t){if("Event3D"===t.componentName&&t.type===e.OBSERVER_TYPE.REMOVE){t.component.removeAllListeners();for(const[e,n]of this.downByPointer)n.gameObject.id===t.gameObject.id&&this.downByPointer.delete(e)}}rendererUpdate(t){}onDestroy(){this.canvas&&(this.canvas.removeEventListener("pointerdown",this.onPointerDown),this.canvas.removeEventListener("pointermove",this.onPointerMove),this.canvas.removeEventListener("pointerup",this.onPointerUp),this.canvas.removeEventListener("pointercancel",this.onPointerCancel),this.canvas.removeEventListener("pointerleave",this.onPointerCancel),this.canvas=null,this.downByPointer.clear())}handlePointer(t,e){const n=this.hitFromEvent(t),i=this.canvasPosition(t);if("touchstart"===e){if(!n)return;return this.downByPointer.set(t.pointerId,n),void this.emitOn(n,"touchstart",t,i)}if("touchmove"===e){if(!n)return;return void this.emitOn(n,"touchmove",t,i)}const o=this.downByPointer.get(t.pointerId);if(this.downByPointer.delete(t.pointerId),"touchcancel"!==e){if(n&&o&&n.gameObject.id===o.gameObject.id)return this.emitOn(n,"touchend",t,i),void this.emitOn(n,"tap",t,i);o&&this.emitOn(o,"touchendoutside",t,i),n&&this.emitOn(n,"touchend",t,i)}else o&&this.emitOn(o,"touchcancel",t,i)}emitOn(t,e,n,i){let o=!1;t.component.emit(e,{stopPropagation:()=>{o=!0},data:{pointerId:n.pointerId,position:i,localPosition:{x:t.local.x,y:t.local.y,z:t.local.z}},gameObject:t.gameObject}),o&&n.stopPropagation()}canvasPosition(t){const e=this.canvas.getBoundingClientRect();return{x:t.clientX-e.left,y:t.clientY-e.top}}hitFromEvent(t){if(!this.canvas)return null;const e=this.canvas.getBoundingClientRect();if(0===e.width||0===e.height)return null;this.ndc.set((t.clientX-e.left)/e.width*2-1,-(t.clientY-e.top)/e.height*2+1),this.raycaster.setFromCamera(this.ndc,this.threeContext.camera);const i=this.raycaster.intersectObjects(this.threeContext.scene.children,!0);for(const t of i){const e=n.gameObjectIdFromObject3D(t.object);if(null==e)continue;const i=this.game.gameObjects.find(t=>t.id===e);if(!i)continue;const s=i.getComponent(o);if(s)return this.localScratch.copy(t.point),t.object.worldToLocal(this.localScratch),{gameObject:i,component:s,local:this.localScratch.clone()}}return null}};s=t.__decorate([e.decorators.componentObserver({Event3D:[]})],s);var r=s;exports.Event3D=o,exports.Event3DSystem=r;

package/dist/plugin-renderer-3d-event.d.ts

@@ -0,0 +1,59 @@
+import { ComponentChanged, GameObject, Component } from '@combos-fun/engine';
+import { Renderer3D } from '@combos-fun/plugin-renderer-3d';
+
+interface Event3DSystemParams {
+}
+declare class Event3DSystem extends Renderer3D {
+    static systemName: string;
+    name: string;
+    private raycaster;
+    private ndc;
+    private localScratch;
+    private downByPointer;
+    private canvas;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
+    private onPointerCancel;
+    init(_params?: Event3DSystemParams): void;
+    componentChanged(changed: ComponentChanged): void;
+    rendererUpdate(_gameObject: GameObject): void;
+    onDestroy(): void;
+    private handlePointer;
+    private emitOn;
+    private canvasPosition;
+    private hitFromEvent;
+}
+
+type TouchEventName = 'touchstart' | 'touchmove' | 'touchend' | 'tap' | 'touchendoutside' | 'touchcancel';
+type Event3DParam = {
+    stopPropagation: () => void;
+    data: {
+        pointerId: number;
+        position: {
+            x: number;
+            y: number;
+        };
+        localPosition: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    gameObject: GameObject;
+};
+interface Event3DParams {
+}
+declare class Event3D extends Component<Event3DParams> {
+    static componentName: string;
+    init(params?: Event3DParams): void;
+    emit(eventName: TouchEventName, ...args: [Event3DParam]): boolean;
+    emit<T extends string>(eventName: Exclude<T, TouchEventName>, ...args: any[]): boolean;
+    once(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this;
+    once<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this;
+    on(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this;
+    on<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this;
+}
+
+export { Event3D, Event3DSystem };
+export type { Event3DParam, Event3DParams, Event3DSystemParams };

package/dist/plugin-renderer-3d-event.esm.js

@@ -0,0 +1,171 @@
+import { __decorate } from 'tslib';
+import { Component, OBSERVER_TYPE, decorators } from '@combos-fun/engine';
+import { Renderer3D, Renderer3DSystem, gameObjectIdFromObject3D } from '@combos-fun/plugin-renderer-3d';
+import { Raycaster, Vector2, Vector3 } from 'three';
+
+class Event3D extends Component {
+    static { this.componentName = 'Event3D'; }
+    init(params) {
+        params && Object.assign(this, params);
+    }
+    emit(en, ...args) {
+        return super.emit(en, ...args);
+    }
+    once(en, fn, context) {
+        return super.once(en, fn, context);
+    }
+    on(en, fn, context) {
+        return super.on(en, fn, context);
+    }
+}
+
+let Event3DSystem = class Event3DSystem extends Renderer3D {
+    constructor() {
+        super(...arguments);
+        this.name = 'Event3DSystem';
+        this.raycaster = new Raycaster();
+        this.ndc = new Vector2();
+        this.localScratch = new Vector3();
+        this.downByPointer = new Map();
+        this.canvas = null;
+        this.onPointerDown = (e) => this.handlePointer(e, 'touchstart');
+        this.onPointerMove = (e) => this.handlePointer(e, 'touchmove');
+        this.onPointerUp = (e) => this.handlePointer(e, 'touchend');
+        this.onPointerCancel = (e) => this.handlePointer(e, 'touchcancel');
+    }
+    static { this.systemName = 'Event3DSystem'; }
+    init(_params) {
+        const renderer3DSystem = this.game.getSystem(Renderer3DSystem);
+        renderer3DSystem.rendererManager.register(this);
+        this.canvas = this.threeContext.renderer.domElement;
+        this.canvas.style.touchAction = 'none';
+        this.canvas.addEventListener('pointerdown', this.onPointerDown);
+        this.canvas.addEventListener('pointermove', this.onPointerMove);
+        this.canvas.addEventListener('pointerup', this.onPointerUp);
+        this.canvas.addEventListener('pointercancel', this.onPointerCancel);
+        this.canvas.addEventListener('pointerleave', this.onPointerCancel);
+    }
+    componentChanged(changed) {
+        if (changed.componentName !== 'Event3D')
+            return;
+        if (changed.type === OBSERVER_TYPE.REMOVE) {
+            changed.component.removeAllListeners();
+            for (const [pointerId, hit] of this.downByPointer) {
+                if (hit.gameObject.id === changed.gameObject.id) {
+                    this.downByPointer.delete(pointerId);
+                }
+            }
+        }
+    }
+    rendererUpdate(_gameObject) { }
+    onDestroy() {
+        if (!this.canvas)
+            return;
+        this.canvas.removeEventListener('pointerdown', this.onPointerDown);
+        this.canvas.removeEventListener('pointermove', this.onPointerMove);
+        this.canvas.removeEventListener('pointerup', this.onPointerUp);
+        this.canvas.removeEventListener('pointercancel', this.onPointerCancel);
+        this.canvas.removeEventListener('pointerleave', this.onPointerCancel);
+        this.canvas = null;
+        this.downByPointer.clear();
+    }
+    handlePointer(e, kind) {
+        const hit = this.hitFromEvent(e);
+        const canvasPos = this.canvasPosition(e);
+        if (kind === 'touchstart') {
+            if (!hit)
+                return;
+            this.downByPointer.set(e.pointerId, hit);
+            this.emitOn(hit, 'touchstart', e, canvasPos);
+            return;
+        }
+        if (kind === 'touchmove') {
+            if (!hit)
+                return;
+            this.emitOn(hit, 'touchmove', e, canvasPos);
+            return;
+        }
+        const down = this.downByPointer.get(e.pointerId);
+        this.downByPointer.delete(e.pointerId);
+        if (kind === 'touchcancel') {
+            if (down)
+                this.emitOn(down, 'touchcancel', e, canvasPos);
+            return;
+        }
+        if (hit && down && hit.gameObject.id === down.gameObject.id) {
+            this.emitOn(hit, 'touchend', e, canvasPos);
+            this.emitOn(hit, 'tap', e, canvasPos);
+            return;
+        }
+        if (down) {
+            this.emitOn(down, 'touchendoutside', e, canvasPos);
+        }
+        if (hit) {
+            this.emitOn(hit, 'touchend', e, canvasPos);
+        }
+    }
+    emitOn(hit, eventName, e, canvasPos) {
+        let stopped = false;
+        hit.component.emit(eventName, {
+            stopPropagation: () => { stopped = true; },
+            data: {
+                pointerId: e.pointerId,
+                position: canvasPos,
+                localPosition: {
+                    x: hit.local.x,
+                    y: hit.local.y,
+                    z: hit.local.z,
+                },
+            },
+            gameObject: hit.gameObject,
+        });
+        if (stopped) {
+            e.stopPropagation();
+        }
+    }
+    canvasPosition(e) {
+        const rect = this.canvas.getBoundingClientRect();
+        return {
+            x: e.clientX - rect.left,
+            y: e.clientY - rect.top,
+        };
+    }
+    hitFromEvent(e) {
+        if (!this.canvas)
+            return null;
+        const rect = this.canvas.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0)
+            return null;
+        this.ndc.set(((e.clientX - rect.left) / rect.width) * 2 - 1, -((e.clientY - rect.top) / rect.height) * 2 + 1);
+        this.raycaster.setFromCamera(this.ndc, this.threeContext.camera);
+        const intersections = this.raycaster.intersectObjects(this.threeContext.scene.children, true);
+        for (const intersection of intersections) {
+            const id = gameObjectIdFromObject3D(intersection.object);
+            if (id == null)
+                continue;
+            const gameObject = this.game.gameObjects.find((go) => go.id === id);
+            if (!gameObject)
+                continue;
+            const component = gameObject.getComponent(Event3D);
+            if (!component)
+                continue;
+            this.localScratch.copy(intersection.point);
+            intersection.object.worldToLocal(this.localScratch);
+            return {
+                gameObject,
+                component,
+                local: this.localScratch.clone(),
+            };
+        }
+        return null;
+    }
+};
+Event3DSystem = __decorate([
+    decorators.componentObserver({
+        Event3D: [],
+    })
+], Event3DSystem);
+var Event3DSystem_default = Event3DSystem;
+
+export { Event3D, Event3DSystem_default as Event3DSystem };
+//# sourceMappingURL=plugin-renderer-3d-event.esm.js.map

package/dist/plugin-renderer-3d-event.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-renderer-3d-event.esm.js","sources":["../lib/component.ts","../lib/system.ts"],"sourcesContent":["import { Component } from '@combos-fun/engine';\nimport type { GameObject } from '@combos-fun/engine';\n\ntype TouchEventName = 'touchstart' | 'touchmove' | 'touchend' | 'tap' | 'touchendoutside' | 'touchcancel';\n\nexport type Event3DParam = {\n  stopPropagation: () => void,\n  data: {\n    pointerId: number,\n    position: {\n      x: number,\n      y: number,\n    },\n    localPosition: {\n      x: number,\n      y: number,\n      z: number,\n    },\n  },\n  gameObject: GameObject,\n};\n\nexport interface Event3DParams {}\n\nexport default class Event3D extends Component<Event3DParams> {\n  static componentName = 'Event3D';\n\n  init(params?: Event3DParams) {\n    params && Object.assign(this, params);\n  }\n\n  emit(eventName: TouchEventName, ...args: [Event3DParam]): boolean\n  emit<T extends string>(eventName: Exclude<T, TouchEventName>, ...args: any[]): boolean\n  emit(en: string, ...args: any[]) {\n    return super.emit(en, ...args);\n  }\n\n  once(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this\n  once<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this\n  once(en: string, fn: (...args: any[]) => void, context?: any) {\n    return super.once(en, fn, context);\n  }\n\n  on(eventName: TouchEventName, fn: (arg: Event3DParam) => void, context?: any): this\n  on<T extends string>(eventName: Exclude<T, TouchEventName>, fn: (...args: any[]) => void, context?: any): this\n  on(en: string, fn: (...args: any[]) => void, context?: any) {\n    return super.on(en, fn, context);\n  }\n}\n","import { decorators, ComponentChanged, OBSERVER_TYPE, GameObject } from '@combos-fun/engine';\nimport {\n  Renderer3D,\n  Renderer3DSystem,\n  gameObjectIdFromObject3D,\n} from '@combos-fun/plugin-renderer-3d';\nimport { Raycaster, Vector2, Vector3 } from 'three';\nimport Event3D from './component';\n\nexport interface Event3DSystemParams {}\n\ninterface PointerHit {\n  gameObject: GameObject;\n  component: Event3D;\n  local: Vector3;\n}\n\n@decorators.componentObserver({\n  Event3D: [],\n})\nexport default class Event3DSystem extends Renderer3D {\n  static systemName = 'Event3DSystem';\n  name: string = 'Event3DSystem';\n\n  private raycaster = new Raycaster();\n  private ndc = new Vector2();\n  private localScratch = new Vector3();\n  private downByPointer = new Map<number, PointerHit>();\n  private canvas: HTMLCanvasElement | null = null;\n\n  private onPointerDown = (e: PointerEvent) => this.handlePointer(e, 'touchstart');\n  private onPointerMove = (e: PointerEvent) => this.handlePointer(e, 'touchmove');\n  private onPointerUp = (e: PointerEvent) => this.handlePointer(e, 'touchend');\n  private onPointerCancel = (e: PointerEvent) => this.handlePointer(e, 'touchcancel');\n\n  init(_params?: Event3DSystemParams) {\n    const renderer3DSystem = this.game.getSystem(Renderer3DSystem) as Renderer3DSystem;\n    renderer3DSystem.rendererManager.register(this);\n\n    this.canvas = this.threeContext.renderer.domElement;\n    this.canvas.style.touchAction = 'none';\n    this.canvas.addEventListener('pointerdown', this.onPointerDown);\n    this.canvas.addEventListener('pointermove', this.onPointerMove);\n    this.canvas.addEventListener('pointerup', this.onPointerUp);\n    this.canvas.addEventListener('pointercancel', this.onPointerCancel);\n    this.canvas.addEventListener('pointerleave', this.onPointerCancel);\n  }\n\n  componentChanged(changed: ComponentChanged) {\n    if (changed.componentName !== 'Event3D') return;\n    if (changed.type === OBSERVER_TYPE.REMOVE) {\n      changed.component.removeAllListeners();\n      for (const [pointerId, hit] of this.downByPointer) {\n        if (hit.gameObject.id === changed.gameObject.id) {\n          this.downByPointer.delete(pointerId);\n        }\n      }\n    }\n  }\n\n  rendererUpdate(_gameObject: GameObject) {}\n\n  onDestroy() {\n    if (!this.canvas) return;\n    this.canvas.removeEventListener('pointerdown', this.onPointerDown);\n    this.canvas.removeEventListener('pointermove', this.onPointerMove);\n    this.canvas.removeEventListener('pointerup', this.onPointerUp);\n    this.canvas.removeEventListener('pointercancel', this.onPointerCancel);\n    this.canvas.removeEventListener('pointerleave', this.onPointerCancel);\n    this.canvas = null;\n    this.downByPointer.clear();\n  }\n\n  private handlePointer(e: PointerEvent, kind: 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel') {\n    const hit = this.hitFromEvent(e);\n    const canvasPos = this.canvasPosition(e);\n\n    if (kind === 'touchstart') {\n      if (!hit) return;\n      this.downByPointer.set(e.pointerId, hit);\n      this.emitOn(hit, 'touchstart', e, canvasPos);\n      return;\n    }\n\n    if (kind === 'touchmove') {\n      if (!hit) return;\n      this.emitOn(hit, 'touchmove', e, canvasPos);\n      return;\n    }\n\n    const down = this.downByPointer.get(e.pointerId);\n    this.downByPointer.delete(e.pointerId);\n\n    if (kind === 'touchcancel') {\n      if (down) this.emitOn(down, 'touchcancel', e, canvasPos);\n      return;\n    }\n\n    if (hit && down && hit.gameObject.id === down.gameObject.id) {\n      this.emitOn(hit, 'touchend', e, canvasPos);\n      this.emitOn(hit, 'tap', e, canvasPos);\n      return;\n    }\n\n    if (down) {\n      this.emitOn(down, 'touchendoutside', e, canvasPos);\n    }\n    if (hit) {\n      this.emitOn(hit, 'touchend', e, canvasPos);\n    }\n  }\n\n  private emitOn(\n    hit: PointerHit,\n    eventName: 'touchstart' | 'touchmove' | 'touchend' | 'tap' | 'touchendoutside' | 'touchcancel',\n    e: PointerEvent,\n    canvasPos: { x: number; y: number },\n  ) {\n    let stopped = false;\n    hit.component.emit(eventName, {\n      stopPropagation: () => { stopped = true; },\n      data: {\n        pointerId: e.pointerId,\n        position: canvasPos,\n        localPosition: {\n          x: hit.local.x,\n          y: hit.local.y,\n          z: hit.local.z,\n        },\n      },\n      gameObject: hit.gameObject,\n    });\n    if (stopped) {\n      e.stopPropagation();\n    }\n  }\n\n  private canvasPosition(e: PointerEvent) {\n    const rect = this.canvas.getBoundingClientRect();\n    return {\n      x: e.clientX - rect.left,\n      y: e.clientY - rect.top,\n    };\n  }\n\n  private hitFromEvent(e: PointerEvent): PointerHit | null {\n    if (!this.canvas) return null;\n    const rect = this.canvas.getBoundingClientRect();\n    if (rect.width === 0 || rect.height === 0) return null;\n\n    this.ndc.set(\n      ((e.clientX - rect.left) / rect.width) * 2 - 1,\n      -((e.clientY - rect.top) / rect.height) * 2 + 1,\n    );\n    this.raycaster.setFromCamera(this.ndc, this.threeContext.camera);\n    const intersections = this.raycaster.intersectObjects(this.threeContext.scene.children, true);\n\n    for (const intersection of intersections) {\n      const id = gameObjectIdFromObject3D(intersection.object);\n      if (id == null) continue;\n      const gameObject = this.game.gameObjects.find((go) => go.id === id);\n      if (!gameObject) continue;\n      const component = gameObject.getComponent(Event3D) as Event3D | undefined;\n      if (!component) continue;\n\n      this.localScratch.copy(intersection.point);\n      intersection.object.worldToLocal(this.localScratch);\n      return {\n        gameObject,\n        component,\n        local: this.localScratch.clone(),\n      };\n    }\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}

package/index.js

@@ -0,0 +1,7 @@
+'use strict';
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./dist/plugin-renderer-3d-event.cjs.prod.js');
+} else {
+  module.exports = require('./dist/plugin-renderer-3d-event.cjs.js');
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@combos-fun/plugin-renderer-3d-event",
+  "version": "0.0.40",
+  "description": "Pointer / touch event input via Three.js raycasting",
+  "main": "index.js",
+  "module": "dist/plugin-renderer-3d-event.esm.js",
+  "bundle": "CombosFun.plugin.renderer.3d.event",
+  "unpkg": "dist/CombosFun.plugin.renderer.3d.event.min.js",
+  "types": "dist/plugin-renderer-3d-event.d.ts",
+  "files": [
+    "index.js",
+    "dist",
+    "agent-skill.md",
+    "combos-plugin.json"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/plugin-renderer-3d-event.esm.js",
+      "require": "./index.js",
+      "types": "./dist/plugin-renderer-3d-event.d.ts"
+    },
+    "./plugin-manifest": "./combos-plugin.json",
+    "./agent-skill": "./agent-skill.md"
+  },
+  "combos": {
+    "pluginManifest": "./combos-plugin.json"
+  },
+  "dependencies": {
+    "@combos-fun/engine": "0.0.39",
+    "@combos-fun/plugin-renderer-3d": "0.0.39",
+    "three": "^0.172.0"
+  },
+  "keywords": [
+    "combos-fun",
+    "3d",
+    "pointer",
+    "touch",
+    "tap",
+    "raycast",
+    "input",
+    "event"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs"
+  }
+}