[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E65PRSTK0NPCMG58V1FD9T":3,"skill-same:01M7E65PRSTK0NPCMG58V1FD9T":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7E65PRSTK0NPCMG58V1FD9T","pixijs-events",null,"Use this skill when handling pointer, mouse, touch, or wheel input in PixiJS v8. Covers eventMode (none, passive, auto, static, dynamic), FederatedEvent types, propagation and capture phase, hitArea, interactiveChildren, cursor and cursorStyles, global move events for drag, eventFeatures config. Triggers on (in PixiJS code): eventMode, FederatedPointerEvent, pointerdown, click or tap on display objects, globalpointermove, dragging display objects, hitArea, cursorStyles, stopPropagation, persistentDeviceId, contextmenu, rightclick.","w0rxbend\u002Fdot-agents","w0rxbend","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8176996?v=4","01M7E4XY3Y871Z2NFBXF3H3T8F","Oleksandr B.","01M7E4XY51E6NSG05FXR36H9RV",0,"MIT","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fpixi\u002Fpixijs-events\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fpixi\u002Fpixijs-events\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pixijs-events\ndescription: \"Use this skill when handling pointer, mouse, touch, or wheel input in PixiJS v8. Covers eventMode (none, passive, auto, static, dynamic), FederatedEvent types, propagation and capture phase, hitArea, interactiveChildren, cursor and cursorStyles, global move events for drag, eventFeatures config. Triggers on (in PixiJS code): eventMode, FederatedPointerEvent, pointerdown, click or tap on display objects, globalpointermove, dragging display objects, hitArea, cursorStyles, stopPropagation, persistentDeviceId, contextmenu, rightclick.\"\nlicense: MIT\n---\n\nFederated event system mirrors DOM events on scene graph. Opt object in with `container.eventMode = 'static'`, then listen with `.on()`, `addEventListener()` or `onEventName` property handlers. Move events fire only over listening object; use `globalpointermove` for drag.\n\n## Quick Start\n\n```ts\nconst button = new Sprite(await Assets.load(\"button.png\"));\nbutton.eventMode = \"static\";\nbutton.cursor = \"pointer\";\napp.stage.addChild(button);\n\nbutton.on(\"pointertap\", (event) => {\n  console.log(\"clicked at\", event.global.x, event.global.y);\n});\n\nlet dragging = false;\nbutton.on(\"pointerdown\", () => {\n  dragging = true;\n});\nbutton.on(\"pointerup\", () => {\n  dragging = false;\n});\nbutton.on(\"pointerupoutside\", () => {\n  dragging = false;\n});\nbutton.on(\"globalpointermove\", (event) => {\n  if (dragging) button.parent.toLocal(event.global, undefined, button.position);\n});\n```\n\n**Related skills:** `pixijs-performance` (event-heavy scenes). These skills do not cover screen reader and keyboard support (`import 'pixi.js\u002Faccessibility'`) or HTML overlays (`DOMContainer`). See [accessibility guide](https:\u002F\u002Fpixijs.com\u002F8.x\u002Fguides\u002Fcomponents\u002Faccessibility) and [DOMContainer API](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fscene.DOMContainer.html.md).\n\n## Core Patterns\n\n### eventMode values\n\n```ts\nimport { Sprite } from \"pixi.js\";\n\nconst sprite = new Sprite();\n\n\u002F\u002F No interaction at all; children also ignored\nsprite.eventMode = \"none\";\n\n\u002F\u002F Default. Self not interactive; interactive children still work\nsprite.eventMode = \"passive\";\n\n\u002F\u002F Hit tested only when a parent is interactive\nsprite.eventMode = \"auto\";\n\n\u002F\u002F Standard interaction: receives pointer\u002Fmouse\u002Ftouch events\nsprite.eventMode = \"static\";\n\n\u002F\u002F Like static, but also fires synthetic events from the ticker\n\u002F\u002F when the pointer is stationary (for animated objects under cursor)\nsprite.eventMode = \"dynamic\";\n```\n\nUse `'static'` for buttons, UI elements, drag targets. Use `'dynamic'` only for objects that move under stationary cursor and need continuous hover updates.\n\nCheck whether object can receive events with `isInteractive()`:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.isInteractive(); \u002F\u002F true\n\nsprite.eventMode = \"passive\";\nsprite.isInteractive(); \u002F\u002F false\n```\n\n### Event types\n\nPointer events (recommended for cross-device compatibility): `pointerdown`, `pointerup`, `pointerupoutside`, `pointermove`, `pointerover`, `pointerout`, `pointerenter`, `pointerleave`, `pointertap`, `pointercancel`.\n\nMouse events: `mousedown`, `mouseup`, `mouseupoutside`, `mousemove`, `mouseover`, `mouseout`, `mouseenter`, `mouseleave`, `click`, `rightdown`, `rightup`, `rightupoutside`, `rightclick`, `contextmenu`, `wheel`. PixiJS doesn't block browser context menu. Call `event.preventDefault()` in `contextmenu` listener to keep it closed. Canceling `rightdown`, `rightup` or `rightclick` doesn't keep it closed. On macOS, ctrl + click also fires `contextmenu`; browser can report it as left click.\n\nTouch events: `touchstart`, `touchend`, `touchendoutside`, `touchmove`, `touchcancel`, `tap`. Each touch carries `altKey`, `ctrlKey`, `metaKey`, `shiftKey` copied from native `TouchEvent`, so modifier keys work as with mouse or pointer events.\n\nGlobal move events: `globalpointermove`, `globalmousemove`, `globaltouchmove`. Fire on every pointer move, even when pointer is not over listening object.\n\nContainer lifecycle events (no `eventMode` required): `added`, `removed`, `destroyed`, `childAdded`, `childRemoved`, `visibleChanged`.\n\n### Listening styles\n\n```ts\nimport { Sprite } from \"pixi.js\";\n\nconst sprite = new Sprite();\nsprite.eventMode = \"static\";\n\n\u002F\u002F EventEmitter style (recommended)\nconst handler = (e) => console.log(\"clicked\");\nsprite.on(\"pointerdown\", handler);\nsprite.once(\"pointerdown\", handler); \u002F\u002F one-time\nsprite.off(\"pointerdown\", handler);\n\n\u002F\u002F DOM style\nsprite.addEventListener(\n  \"click\",\n  (event) => {\n    console.log(\"Clicked!\", event.detail);\n  },\n  { once: true },\n);\n\n\u002F\u002F Property-based handlers\nsprite.onclick = (event) => {\n  console.log(\"Clicked!\", event.detail);\n};\n```\n\n### Pointer events and propagation\n\n```ts\nimport { Sprite, Container } from \"pixi.js\";\n\nconst parent = new Container();\nparent.eventMode = \"static\";\n\nconst child = new Sprite();\nchild.eventMode = \"static\";\nparent.addChild(child);\n\nchild.on(\"pointerdown\", (event) => {\n  console.log(\"child pressed\");\n  event.stopPropagation(); \u002F\u002F prevent parent from receiving this event\n});\n\nparent.on(\"pointerdown\", () => {\n  console.log(\"parent pressed (only if child did not stop propagation)\");\n});\n```\n\n### Capture phase events\n\nAll events support capture phase: append `capture` to event name (e.g., `pointerdowncapture`, `clickcapture`). Capture listeners fire before event reaches its target.\n\n```ts\ncontainer.addEventListener(\n  \"pointerdown\",\n  (event) => {\n    event.stopImmediatePropagation(); \u002F\u002F blocks event from reaching children\n  },\n  { capture: true },\n);\n```\n\n### Hit testing\n\nOn pointer event, PixiJS walks display tree to find top-most interactive element under pointer. Traversal rules:\n\n- `eventMode = 'none'` on container skips that element and its entire subtree.\n- `interactiveChildren = false` on container skips its children (container itself can still be tested).\n- `hitArea` overrides bounds-based testing; only the shape is checked.\n- Objects not visible, not renderable or not measurable are skipped.\n\nCustom `hitArea` also speeds hit tests on large or complex objects (less geometry to check):\n\n```ts\nimport { Sprite, Rectangle, Circle, Polygon } from \"pixi.js\";\n\nconst sprite = new Sprite();\nsprite.eventMode = \"static\";\n\n\u002F\u002F Rectangular hit area\nsprite.hitArea = new Rectangle(0, 0, 100, 50);\n\n\u002F\u002F Circular hit area\nsprite.hitArea = new Circle(50, 50, 40);\n\n\u002F\u002F Polygon hit area\nsprite.hitArea = new Polygon([0, 0, 100, 0, 50, 100]);\n\n\u002F\u002F Custom hit test via contains()\nsprite.hitArea = {\n  contains(x: number, y: number): boolean {\n    return x >= 0 && x \u003C= 100 && y >= 0 && y \u003C= 100;\n  },\n};\n```\n\n### Cursor styles\n\nSet `cursor` per object. For reusable cursors, register named styles on event system:\n\n```ts\napp.renderer.events.cursorStyles.default = \"url('bunny.png'), auto\";\napp.renderer.events.cursorStyles.hover = \"url('bunny_saturated.png'), auto\";\n\nsprite.eventMode = \"static\";\nsprite.cursor = \"hover\"; \u002F\u002F uses the registered 'hover' style\n```\n\nCursor styles can be strings (CSS cursor values), objects (applied as CSS styles) or functions (called with mode string).\n\n### Event properties\n\nUseful `FederatedPointerEvent` fields:\n\n```ts\nsprite.on(\"pointerdown\", (event: FederatedPointerEvent) => {\n  event.global; \u002F\u002F scene-space Point where the event happened\n  event.client; \u002F\u002F CSS-pixel Point relative to the viewport\n  event.offset; \u002F\u002F Point w.r.t. target Container in world space (not supported at the moment)\n  event.target; \u002F\u002F the Container that received the event\n  event.currentTarget; \u002F\u002F the Container whose listener is running\n\n  event.pointerType; \u002F\u002F 'mouse' | 'pen' | 'touch'\n  event.pointerId; \u002F\u002F unique id for multi-touch tracking\n  event.isPrimary; \u002F\u002F first pointer in a multi-pointer gesture\n  event.persistentDeviceId; \u002F\u002F always 0; present for DOM PointerEvent type compatibility\n  event.pressure; \u002F\u002F 0-1 pen\u002Ftouch pressure\n  event.button; \u002F\u002F 0 left, 1 middle, 2 right\n  event.buttons; \u002F\u002F bitmask of held buttons\n  event.altKey; \u002F\u002F modifier key state\n  event.ctrlKey;\n  event.shiftKey;\n  event.metaKey;\n\n  event.nativeEvent; \u002F\u002F the underlying DOM PointerEvent \u002F MouseEvent \u002F Touch\n  event.preventDefault();\n  event.stopPropagation();\n  event.stopImmediatePropagation();\n});\n```\n\n`FederatedWheelEvent` adds `deltaX`, `deltaY`, `deltaZ`, `deltaMode`. Wheel events fire on same hit-tested object as pointer events.\n\n### Event features\n\nToggle event categories globally for performance:\n\n```ts\nawait app.init({\n  eventFeatures: {\n    move: true, \u002F\u002F pointer\u002Fmouse\u002Ftouch move events\n    globalMove: true, \u002F\u002F global move events (globalpointermove, etc.)\n    click: true, \u002F\u002F click\u002Ftap\u002Fpress and contextmenu events\n    wheel: true, \u002F\u002F mouse wheel events\n  },\n});\n\n\u002F\u002F or configure after init\napp.renderer.events.features.globalMove = false;\n```\n\n### Performance tips\n\n- `eventMode = 'none'` on non-interactive subtrees to skip hit testing entirely.\n- `interactiveChildren = false` on containers where only container itself needs interaction.\n- Disable unused event features via `eventFeatures` (e.g., `globalMove: false`) to cut per-frame work.\n\n## Common Mistakes\n\n### [HIGH] Default eventMode is passive\n\nWrong:\n\n```ts\nconst sprite = new Sprite(texture);\nsprite.on(\"pointerdown\", () => {\n  console.log(\"clicked\");\n});\n```\n\nCorrect:\n\n```ts\nconst sprite = new Sprite(texture);\nsprite.eventMode = \"static\";\nsprite.on(\"pointerdown\", () => {\n  console.log(\"clicked\");\n});\n```\n\nDefault `eventMode` is `'passive'`: object itself receives no events. Must explicitly set `eventMode` to `'static'` or `'dynamic'` before any listener fires.\n\n\n### [HIGH] buttonMode removed; use cursor\n\nWrong:\n\n```ts\nsprite.interactive = true;\nsprite.buttonMode = true;\n```\n\nCorrect:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.cursor = \"pointer\";\n```\n\n`buttonMode` removed in v8. Use `cursor = 'pointer'` for hand cursor on hover. `interactive = true` still works as alias for `eventMode = 'static'`, but prefer `eventMode`.\n\n\n### [HIGH] Move events only fire over the object in v8\n\nWrong:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.on(\"pointermove\", (event) => {\n  \u002F\u002F expects to fire everywhere; only fires inside sprite bounds\n  updateDrag(event.global.x, event.global.y);\n});\n```\n\nCorrect:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.on(\"globalpointermove\", (event) => {\n  \u002F\u002F fires everywhere, even outside sprite bounds\n  updateDrag(event.global.x, event.global.y);\n});\n```\n\nIn v8, `pointermove`, `mousemove`, `touchmove` only fire when pointer is over display object. In v7 they fired on any canvas move. For drag or global tracking, use `globalpointermove`, `globalmousemove` or `globaltouchmove`.\n\n\n### [MEDIUM] Cursor does not inherit from parent\n\n`cursor` on parent container has no effect on its children. Only direct hit target's `cursor` value applies.\n\n```ts\n\u002F\u002F This does NOT make children show a pointer cursor\nparent.cursor = \"pointer\";\n\n\u002F\u002F Each interactive child needs its own cursor\nchild.eventMode = \"static\";\nchild.cursor = \"pointer\";\n```\n\nFor uniform cursor on all children, set `cursor` on each interactive child individually, or set `hitArea` on parent and make children non-interactive.\n\n\n## API Reference\n\n- [EventSystem](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.EventSystem.html.md)\n- [FederatedEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedEvent.html.md)\n- [FederatedPointerEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedPointerEvent.html.md)\n- [FederatedMouseEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedMouseEvent.html.md)\n- [FederatedWheelEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedWheelEvent.html.md)\n- [EventBoundary](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.EventBoundary.html.md)\n","Federated event system mirrors DOM events on scene graph. Opt object in with `container.eventMode = 'static'`, then listen with `.on()`, `addEventListener()` or `onEventName` property handlers. Move events fire only over listening object; use `globalpointermove` for drag.\n\n## Quick Start\n\n```ts\nconst button = new Sprite(await Assets.load(\"button.png\"));\nbutton.eventMode = \"static\";\nbutton.cursor = \"pointer\";\napp.stage.addChild(button);\n\nbutton.on(\"pointertap\", (event) => {\n  console.log(\"clicked at\", event.global.x, event.global.y);\n});\n\nlet dragging = false;\nbutton.on(\"pointerdown\", () => {\n  dragging = true;\n});\nbutton.on(\"pointerup\", () => {\n  dragging = false;\n});\nbutton.on(\"pointerupoutside\", () => {\n  dragging = false;\n});\nbutton.on(\"globalpointermove\", (event) => {\n  if (dragging) button.parent.toLocal(event.global, undefined, button.position);\n});\n```\n\n**Related skills:** `pixijs-performance` (event-heavy scenes). These skills do not cover screen reader and keyboard support (`import 'pixi.js\u002Faccessibility'`) or HTML overlays (`DOMContainer`). See [accessibility guide](https:\u002F\u002Fpixijs.com\u002F8.x\u002Fguides\u002Fcomponents\u002Faccessibility) and [DOMContainer API](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fscene.DOMContainer.html.md).\n\n## Core Patterns\n\n### eventMode values\n\n```ts\nimport { Sprite } from \"pixi.js\";\n\nconst sprite = new Sprite();\n\n\u002F\u002F No interaction at all; children also ignored\nsprite.eventMode = \"none\";\n\n\u002F\u002F Default. Self not interactive; interactive children still work\nsprite.eventMode = \"passive\";\n\n\u002F\u002F Hit tested only when a parent is interactive\nsprite.eventMode = \"auto\";\n\n\u002F\u002F Standard interaction: receives pointer\u002Fmouse\u002Ftouch events\nsprite.eventMode = \"static\";\n\n\u002F\u002F Like static, but also fires synthetic events from the ticker\n\u002F\u002F when the pointer is stationary (for animated objects under cursor)\nsprite.eventMode = \"dynamic\";\n```\n\nUse `'static'` for buttons, UI elements, drag targets. Use `'dynamic'` only for objects that move under stationary cursor and need continuous hover updates.\n\nCheck whether object can receive events with `isInteractive()`:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.isInteractive(); \u002F\u002F true\n\nsprite.eventMode = \"passive\";\nsprite.isInteractive(); \u002F\u002F false\n```\n\n### Event types\n\nPointer events (recommended for cross-device compatibility): `pointerdown`, `pointerup`, `pointerupoutside`, `pointermove`, `pointerover`, `pointerout`, `pointerenter`, `pointerleave`, `pointertap`, `pointercancel`.\n\nMouse events: `mousedown`, `mouseup`, `mouseupoutside`, `mousemove`, `mouseover`, `mouseout`, `mouseenter`, `mouseleave`, `click`, `rightdown`, `rightup`, `rightupoutside`, `rightclick`, `contextmenu`, `wheel`. PixiJS doesn't block browser context menu. Call `event.preventDefault()` in `contextmenu` listener to keep it closed. Canceling `rightdown`, `rightup` or `rightclick` doesn't keep it closed. On macOS, ctrl + click also fires `contextmenu`; browser can report it as left click.\n\nTouch events: `touchstart`, `touchend`, `touchendoutside`, `touchmove`, `touchcancel`, `tap`. Each touch carries `altKey`, `ctrlKey`, `metaKey`, `shiftKey` copied from native `TouchEvent`, so modifier keys work as with mouse or pointer events.\n\nGlobal move events: `globalpointermove`, `globalmousemove`, `globaltouchmove`. Fire on every pointer move, even when pointer is not over listening object.\n\nContainer lifecycle events (no `eventMode` required): `added`, `removed`, `destroyed`, `childAdded`, `childRemoved`, `visibleChanged`.\n\n### Listening styles\n\n```ts\nimport { Sprite } from \"pixi.js\";\n\nconst sprite = new Sprite();\nsprite.eventMode = \"static\";\n\n\u002F\u002F EventEmitter style (recommended)\nconst handler = (e) => console.log(\"clicked\");\nsprite.on(\"pointerdown\", handler);\nsprite.once(\"pointerdown\", handler); \u002F\u002F one-time\nsprite.off(\"pointerdown\", handler);\n\n\u002F\u002F DOM style\nsprite.addEventListener(\n  \"click\",\n  (event) => {\n    console.log(\"Clicked!\", event.detail);\n  },\n  { once: true },\n);\n\n\u002F\u002F Property-based handlers\nsprite.onclick = (event) => {\n  console.log(\"Clicked!\", event.detail);\n};\n```\n\n### Pointer events and propagation\n\n```ts\nimport { Sprite, Container } from \"pixi.js\";\n\nconst parent = new Container();\nparent.eventMode = \"static\";\n\nconst child = new Sprite();\nchild.eventMode = \"static\";\nparent.addChild(child);\n\nchild.on(\"pointerdown\", (event) => {\n  console.log(\"child pressed\");\n  event.stopPropagation(); \u002F\u002F prevent parent from receiving this event\n});\n\nparent.on(\"pointerdown\", () => {\n  console.log(\"parent pressed (only if child did not stop propagation)\");\n});\n```\n\n### Capture phase events\n\nAll events support capture phase: append `capture` to event name (e.g., `pointerdowncapture`, `clickcapture`). Capture listeners fire before event reaches its target.\n\n```ts\ncontainer.addEventListener(\n  \"pointerdown\",\n  (event) => {\n    event.stopImmediatePropagation(); \u002F\u002F blocks event from reaching children\n  },\n  { capture: true },\n);\n```\n\n### Hit testing\n\nOn pointer event, PixiJS walks display tree to find top-most interactive element under pointer. Traversal rules:\n\n- `eventMode = 'none'` on container skips that element and its entire subtree.\n- `interactiveChildren = false` on container skips its children (container itself can still be tested).\n- `hitArea` overrides bounds-based testing; only the shape is checked.\n- Objects not visible, not renderable or not measurable are skipped.\n\nCustom `hitArea` also speeds hit tests on large or complex objects (less geometry to check):\n\n```ts\nimport { Sprite, Rectangle, Circle, Polygon } from \"pixi.js\";\n\nconst sprite = new Sprite();\nsprite.eventMode = \"static\";\n\n\u002F\u002F Rectangular hit area\nsprite.hitArea = new Rectangle(0, 0, 100, 50);\n\n\u002F\u002F Circular hit area\nsprite.hitArea = new Circle(50, 50, 40);\n\n\u002F\u002F Polygon hit area\nsprite.hitArea = new Polygon([0, 0, 100, 0, 50, 100]);\n\n\u002F\u002F Custom hit test via contains()\nsprite.hitArea = {\n  contains(x: number, y: number): boolean {\n    return x >= 0 && x \u003C= 100 && y >= 0 && y \u003C= 100;\n  },\n};\n```\n\n### Cursor styles\n\nSet `cursor` per object. For reusable cursors, register named styles on event system:\n\n```ts\napp.renderer.events.cursorStyles.default = \"url('bunny.png'), auto\";\napp.renderer.events.cursorStyles.hover = \"url('bunny_saturated.png'), auto\";\n\nsprite.eventMode = \"static\";\nsprite.cursor = \"hover\"; \u002F\u002F uses the registered 'hover' style\n```\n\nCursor styles can be strings (CSS cursor values), objects (applied as CSS styles) or functions (called with mode string).\n\n### Event properties\n\nUseful `FederatedPointerEvent` fields:\n\n```ts\nsprite.on(\"pointerdown\", (event: FederatedPointerEvent) => {\n  event.global; \u002F\u002F scene-space Point where the event happened\n  event.client; \u002F\u002F CSS-pixel Point relative to the viewport\n  event.offset; \u002F\u002F Point w.r.t. target Container in world space (not supported at the moment)\n  event.target; \u002F\u002F the Container that received the event\n  event.currentTarget; \u002F\u002F the Container whose listener is running\n\n  event.pointerType; \u002F\u002F 'mouse' | 'pen' | 'touch'\n  event.pointerId; \u002F\u002F unique id for multi-touch tracking\n  event.isPrimary; \u002F\u002F first pointer in a multi-pointer gesture\n  event.persistentDeviceId; \u002F\u002F always 0; present for DOM PointerEvent type compatibility\n  event.pressure; \u002F\u002F 0-1 pen\u002Ftouch pressure\n  event.button; \u002F\u002F 0 left, 1 middle, 2 right\n  event.buttons; \u002F\u002F bitmask of held buttons\n  event.altKey; \u002F\u002F modifier key state\n  event.ctrlKey;\n  event.shiftKey;\n  event.metaKey;\n\n  event.nativeEvent; \u002F\u002F the underlying DOM PointerEvent \u002F MouseEvent \u002F Touch\n  event.preventDefault();\n  event.stopPropagation();\n  event.stopImmediatePropagation();\n});\n```\n\n`FederatedWheelEvent` adds `deltaX`, `deltaY`, `deltaZ`, `deltaMode`. Wheel events fire on same hit-tested object as pointer events.\n\n### Event features\n\nToggle event categories globally for performance:\n\n```ts\nawait app.init({\n  eventFeatures: {\n    move: true, \u002F\u002F pointer\u002Fmouse\u002Ftouch move events\n    globalMove: true, \u002F\u002F global move events (globalpointermove, etc.)\n    click: true, \u002F\u002F click\u002Ftap\u002Fpress and contextmenu events\n    wheel: true, \u002F\u002F mouse wheel events\n  },\n});\n\n\u002F\u002F or configure after init\napp.renderer.events.features.globalMove = false;\n```\n\n### Performance tips\n\n- `eventMode = 'none'` on non-interactive subtrees to skip hit testing entirely.\n- `interactiveChildren = false` on containers where only container itself needs interaction.\n- Disable unused event features via `eventFeatures` (e.g., `globalMove: false`) to cut per-frame work.\n\n## Common Mistakes\n\n### [HIGH] Default eventMode is passive\n\nWrong:\n\n```ts\nconst sprite = new Sprite(texture);\nsprite.on(\"pointerdown\", () => {\n  console.log(\"clicked\");\n});\n```\n\nCorrect:\n\n```ts\nconst sprite = new Sprite(texture);\nsprite.eventMode = \"static\";\nsprite.on(\"pointerdown\", () => {\n  console.log(\"clicked\");\n});\n```\n\nDefault `eventMode` is `'passive'`: object itself receives no events. Must explicitly set `eventMode` to `'static'` or `'dynamic'` before any listener fires.\n\n\n### [HIGH] buttonMode removed; use cursor\n\nWrong:\n\n```ts\nsprite.interactive = true;\nsprite.buttonMode = true;\n```\n\nCorrect:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.cursor = \"pointer\";\n```\n\n`buttonMode` removed in v8. Use `cursor = 'pointer'` for hand cursor on hover. `interactive = true` still works as alias for `eventMode = 'static'`, but prefer `eventMode`.\n\n\n### [HIGH] Move events only fire over the object in v8\n\nWrong:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.on(\"pointermove\", (event) => {\n  \u002F\u002F expects to fire everywhere; only fires inside sprite bounds\n  updateDrag(event.global.x, event.global.y);\n});\n```\n\nCorrect:\n\n```ts\nsprite.eventMode = \"static\";\nsprite.on(\"globalpointermove\", (event) => {\n  \u002F\u002F fires everywhere, even outside sprite bounds\n  updateDrag(event.global.x, event.global.y);\n});\n```\n\nIn v8, `pointermove`, `mousemove`, `touchmove` only fire when pointer is over display object. In v7 they fired on any canvas move. For drag or global tracking, use `globalpointermove`, `globalmousemove` or `globaltouchmove`.\n\n\n### [MEDIUM] Cursor does not inherit from parent\n\n`cursor` on parent container has no effect on its children. Only direct hit target's `cursor` value applies.\n\n```ts\n\u002F\u002F This does NOT make children show a pointer cursor\nparent.cursor = \"pointer\";\n\n\u002F\u002F Each interactive child needs its own cursor\nchild.eventMode = \"static\";\nchild.cursor = \"pointer\";\n```\n\nFor uniform cursor on all children, set `cursor` on each interactive child individually, or set `hitArea` on parent and make children non-interactive.\n\n\n## API Reference\n\n- [EventSystem](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.EventSystem.html.md)\n- [FederatedEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedEvent.html.md)\n- [FederatedPointerEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedPointerEvent.html.md)\n- [FederatedMouseEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedMouseEvent.html.md)\n- [FederatedWheelEvent](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.FederatedWheelEvent.html.md)\n- [EventBoundary](https:\u002F\u002Fpixijs.download\u002Frelease\u002Fdocs\u002Fevents.EventBoundary.html.md)\n",{"name":5,"license":15,"description":7},"main","101d0f67250256ca5d80dc3f95767cad7b541457","skills\u002Fpixi\u002Fpixijs-events","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents","https:\u002F\u002Fgithub.com\u002Fw0rxbend","https:\u002F\u002Freadme.worxbend.com\u002F","Fluent in Backend-ese (microservices, distributed systems, you know the drill)\r\nFunctional Programming Fanatic...","2026-11-14 14:44:12",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add w0rxbend\u002Fdot-agents --skill pixijs-events",{"tool":39,"command":40},"bunx","bunx skills add w0rxbend\u002Fdot-agents --skill pixijs-events",{"tool":42,"command":43},"pnpm","pnpm dlx skills add w0rxbend\u002Fdot-agents --skill pixijs-events","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fpixi\u002Fpixijs-events\u002FSKILL.md",true,[47],{"path":48,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":16},"LICENSE","许可证",1063,[52,59,66,74,81,88],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":20},"01M7E6TS1SW1ZSXN748N0RBGHT","wiki-builder","Create and maintain a local Markdown research wiki (sources with provenance, compiled concept\u002Fsource pages, index, maintenance log) driven by a per-wiki config. Use when the user wants to start a wiki or knowledge base, ingest sources into one, or query and update it; use wiki-page-writer for a single code deep-dive page.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fwiki-builder\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":20},"01M7E6S8ARS0VQR85H4FEC390B","refactoring-guru","Diagnose a named code smell and apply the smallest behavior-preserving refactoring, with verification before and after and an explicit stop condition. Use for structural refactors (extract, move, consolidate, change ownership), not for feature or bug work; for readability cleanup of recent changes use code-simplification.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Frefactoring-guru\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M7E6RRXCYGSHA0ZBFX3YZP7Y","legacy-seams","When changing untested legacy code, pin the observed results with characterization tests and open the smallest seam that substitutes only the blocking dependency, separate from any later logic change. Use when a clock, random source, I\u002FO, global, or hidden constructor blocks a test or a safe edit. Use test-driven-development for a new behavior or a bug, refactoring-guru for one named structural refactor after the seam exists, and code-refactoring-tech-debt to choose which legacy to replace.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Flegacy-seams\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Flegacy-seams\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":20},"01M7E6QZ11XWSNHCBGYK8HH97C","idea-refine","Refine a raw idea into a one-page brief (problem statement, recommended direction, assumptions to validate, MVP scope, not-doing list) through divergent then convergent thinking. Use when an idea is still vague or you want options and a stress test before committing; use interview-me when the goal itself is unclear and spec-driven-development once the direction is chosen.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fidea-refine\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":20},"01M7E6N2N7BYW7BA5XGM0QD3B4","code-review-and-quality","Review rubric and approval standard for any change before merge, including code written by you, another agent, or a human: five axes (correctness, readability, architecture, security, performance), change sizing, structural remedies, severity labels, and feedback technique. Use to judge whether a change is fit to merge; use code-review to run a PR or diff review end to end.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fcode-review-and-quality\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":20},"01M7E6MNCZPTRD77Z419X755HQ","code-perfection","Smell and style gate for code you write or change. Bans known code smells (long method, large class, primitive obsession, long parameter list, data clumps, duplicate code, dead code, feature envy, shotgun surgery, flag arguments, message chains) and enforces behavior-preserving structure. On Scala files, enforces worxbend style. Use while implementing, reviewing a diff for smells, or when a smell or style violation is suspected. Routine construction stays with code-complete. SOLID and DRY stay with clean-code-guard. One named structural refactor stays with refactoring-guru.","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fcode-perfection\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fw0rxbend\u002Fdot-agents\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fcode-perfection\u002FSKILL.md",[],[]]