@threenative/core 0.3.3 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. package/capabilities.json +2019 -59
  2. package/dist/{assets-CYKk2WTu.d.ts → assets-CqvE429w.d.ts} +45 -3
  3. package/dist/{audio-7i3Xl0l3.d.ts → audio-DIJE5HTr.d.ts} +43 -3
  4. package/dist/{canvas-layer-C1SnMoJ-.d.ts → canvas-layer-C1-5CviZ.d.ts} +5 -1
  5. package/dist/{game-D_6r-k4Y.d.ts → game-Bj8G1wmD.d.ts} +242 -17
  6. package/dist/hot.d.ts +5 -5
  7. package/dist/index.d.ts +1131 -105
  8. package/dist/index.js +15201 -4782
  9. package/dist/model-lod-BDAUYgsS.d.ts +197 -0
  10. package/dist/playtest.d.ts +6 -4
  11. package/dist/playtest.js +84 -11
  12. package/dist/react-css.d.ts +62 -0
  13. package/dist/react-css.js +591 -0
  14. package/dist/react.d.ts +2 -2
  15. package/dist/{renderer-Cy4qeBOA.d.ts → renderer-9yEo9hPa.d.ts} +676 -21
  16. package/dist/terrain-jobs-worker.d.ts +2 -0
  17. package/dist/terrain-jobs-worker.js +130 -0
  18. package/dist/ui-layer.d.ts +5 -3
  19. package/dist/ui-layer.js +59 -8
  20. package/dist/world.d.ts +1596 -17
  21. package/dist/world.js +17035 -521
  22. package/gpl/fixtures/make_world_fixture.py +184 -0
  23. package/gpl/recipes/_common.py +11 -0
  24. package/gpl/recipes/decimate.py +11 -5
  25. package/gpl/recipes/export_world.py +699 -0
  26. package/mcp/blender-server.mjs +61 -4
  27. package/mcp/blender.mjs +3 -4
  28. package/mcp/engine-server.mjs +55 -21
  29. package/mcp/servers.mjs +4 -4
  30. package/package.json +15 -9
  31. package/patches/three@0.185.1-prd269-upgrade.patch +22418 -0
  32. package/patches/three@0.185.1.patch +8246 -389
  33. package/scripts/apply-three-patch.mjs +123 -41
  34. package/src/animation-blend.ts +264 -0
  35. package/src/animation-composition.ts +362 -0
  36. package/src/animation-layers.ts +260 -0
  37. package/src/animation-root-motion.ts +283 -0
  38. package/src/animation.ts +896 -0
  39. package/src/assets.ts +1303 -0
  40. package/src/atmosphere/index.ts +335 -0
  41. package/src/atmosphere/luts.ts +298 -0
  42. package/src/atmosphere/params.ts +323 -0
  43. package/src/audio.ts +912 -0
  44. package/src/billboard.ts +124 -0
  45. package/src/bone-lengths.ts +157 -0
  46. package/src/camera-shake.ts +116 -0
  47. package/src/canvas-layer.ts +47 -0
  48. package/src/clip-audit.ts +401 -0
  49. package/src/clustered-batch.ts +492 -0
  50. package/src/clustered-mesh.ts +638 -0
  51. package/src/compute-driven.ts +176 -0
  52. package/src/compute-timing.ts +318 -0
  53. package/src/config.ts +593 -0
  54. package/src/debug.ts +82 -0
  55. package/src/engine-render-hook.ts +25 -0
  56. package/src/entities.ts +79 -0
  57. package/src/entity-snapshot.ts +53 -0
  58. package/src/flight.ts +683 -0
  59. package/src/fluid-field.ts +748 -0
  60. package/src/fluid-particles.ts +1253 -0
  61. package/src/frame-budget.ts +1368 -0
  62. package/src/game.ts +2390 -0
  63. package/src/geometry-capture.ts +1098 -0
  64. package/src/gpu-class.ts +160 -0
  65. package/src/gpu-frame-observation.ts +424 -0
  66. package/src/gpu-readback.ts +143 -0
  67. package/src/gpu-scene-bvh.ts +464 -0
  68. package/src/grounding.ts +100 -0
  69. package/src/hot.ts +161 -0
  70. package/src/import-meta.d.ts +13 -0
  71. package/src/index.ts +1536 -0
  72. package/src/input.ts +690 -0
  73. package/src/instanced-batch-lod.ts +283 -0
  74. package/src/instanced-batch.ts +274 -0
  75. package/src/interpolation.ts +129 -0
  76. package/src/launch-diagnostics.ts +161 -0
  77. package/src/loop.ts +564 -0
  78. package/src/matrix-world.ts +245 -0
  79. package/src/merge-parts.ts +812 -0
  80. package/src/model-lod.ts +1315 -0
  81. package/src/net-protocol.ts +333 -0
  82. package/src/net-session.ts +477 -0
  83. package/src/net.ts +80 -0
  84. package/src/ocean/fft.ts +72 -0
  85. package/src/ocean/spectral.ts +728 -0
  86. package/src/particle-significance.ts +102 -0
  87. package/src/particles.ts +648 -0
  88. package/src/path-follow.ts +175 -0
  89. package/src/picking.ts +250 -0
  90. package/src/pipeline-census.ts +1566 -0
  91. package/src/platform.ts +210 -0
  92. package/src/playtest.ts +839 -0
  93. package/src/pointer-events.ts +411 -0
  94. package/src/pose-measure.ts +435 -0
  95. package/src/profiling/FrameCounters.ts +231 -0
  96. package/src/profiling/Spans.ts +548 -0
  97. package/src/profiling/opacity-convention.ts +21 -0
  98. package/src/profiling/render-list-validate.ts +175 -0
  99. package/src/profiling/render-trap-audit.ts +84 -0
  100. package/src/profiling/scene-warning.ts +190 -0
  101. package/src/profiling/span-probes.ts +191 -0
  102. package/src/profiling/unlit-foliage-warning.ts +149 -0
  103. package/src/projection-apply.ts +1529 -0
  104. package/src/projection-marker.ts +142 -0
  105. package/src/projection-plan.ts +1258 -0
  106. package/src/projection-skinned.ts +419 -0
  107. package/src/projection-stability.ts +409 -0
  108. package/src/projection-uniform.ts +328 -0
  109. package/src/random.ts +41 -0
  110. package/src/react-css.ts +604 -0
  111. package/src/react-glyphs.ts +114 -0
  112. package/src/react-host.ts +576 -0
  113. package/src/react-layout.ts +265 -0
  114. package/src/react.ts +60 -0
  115. package/src/render/alpha-antialiasing.ts +159 -0
  116. package/src/render/batched-velocity.ts +126 -0
  117. package/src/render/chain.ts +1021 -0
  118. package/src/render/daylight.ts +189 -0
  119. package/src/render/depth-pyramid.ts +596 -0
  120. package/src/render/foliage-alpha.ts +166 -0
  121. package/src/render/material-key.ts +60 -0
  122. package/src/render/mesh-pool.ts +144 -0
  123. package/src/render/probe-volume.ts +1668 -0
  124. package/src/render/resolution-subrect.ts +253 -0
  125. package/src/render/velocity.ts +442 -0
  126. package/src/render/virtual-shadow-pages.ts +827 -0
  127. package/src/render/virtual-shadow-partial.ts +174 -0
  128. package/src/render/virtual-shadow.ts +3330 -0
  129. package/src/render/world-impostor-surface.ts +722 -0
  130. package/src/render/world-impostor.ts +558 -0
  131. package/src/render-camera-cull.ts +441 -0
  132. package/src/render-pass-budget.ts +501 -0
  133. package/src/renderProjection.ts +758 -0
  134. package/src/renderer-config.ts +127 -0
  135. package/src/renderer.ts +1847 -0
  136. package/src/replay-protocol.ts +85 -0
  137. package/src/replay.ts +205 -0
  138. package/src/resolution-scaler.ts +819 -0
  139. package/src/rig-preparation.ts +271 -0
  140. package/src/ripple-field.ts +432 -0
  141. package/src/scale.ts +109 -0
  142. package/src/scene.ts +239 -0
  143. package/src/schedule.ts +155 -0
  144. package/src/skeletal-mesh.ts +61 -0
  145. package/src/skeleton.ts +100 -0
  146. package/src/snow-field.ts +744 -0
  147. package/src/softbody-topology.ts +269 -0
  148. package/src/softbody.ts +516 -0
  149. package/src/sprite-animator.ts +222 -0
  150. package/src/startup-readiness.ts +386 -0
  151. package/src/state.ts +66 -0
  152. package/src/static-transform.ts +274 -0
  153. package/src/storage-buffer.ts +253 -0
  154. package/src/streaming.ts +308 -0
  155. package/src/target-fps.ts +92 -0
  156. package/src/terrain-jobs-worker.ts +17 -0
  157. package/src/terrain-jobs.ts +353 -0
  158. package/src/textures.ts +39 -0
  159. package/src/tracers.ts +237 -0
  160. package/src/ui-bridge.ts +368 -0
  161. package/src/ui-hit-regions.ts +380 -0
  162. package/src/ui-layer.ts +83 -0
  163. package/src/ui-state.ts +220 -0
  164. package/src/version.ts +2 -0
  165. package/src/viewport.ts +253 -0
  166. package/src/warmup.ts +1357 -0
  167. package/src/water-surface.ts +384 -0
  168. package/src/wave-field.ts +524 -0
  169. package/src/world-capabilities.ts +131 -0
  170. package/src/world-cell-proxy.ts +392 -0
  171. package/src/world-cells.ts +10564 -0
  172. package/src/world-gpu-scene.ts +3354 -0
  173. package/src/world-heightmap.ts +82 -0
  174. package/src/world-package.ts +469 -0
  175. package/src/world-passes.ts +582 -0
  176. package/src/world-region.ts +17 -0
  177. package/src/world-terrain-splat.ts +564 -0
  178. package/src/world-tiles.ts +3826 -0
  179. package/src/world-topology.ts +370 -0
  180. package/src/world-validate.ts +48 -0
  181. package/src/world.ts +805 -0
  182. package/dist/gpu-readback-CMklJs6r.d.ts +0 -112
@@ -0,0 +1,411 @@
1
+ import { type Intersection, type Object3D, Vector2, Vector3 } from "three";
2
+ import type { IRawInputPointerEdge } from "./input.js";
3
+ import type { IRaycastOptions, ScenePicker } from "./picking.js";
4
+
5
+ export const POINTER_EVENT_TYPES = [
6
+ "pointerEntered",
7
+ "pointerExited",
8
+ "pointerPressed",
9
+ "pointerReleased",
10
+ "tapped",
11
+ "dragStarted",
12
+ "dragged",
13
+ "dragEnded",
14
+ ] as const;
15
+
16
+ export type PointerEvent3DType = (typeof POINTER_EVENT_TYPES)[number];
17
+
18
+ export interface IPointerState {
19
+ readonly id: number;
20
+ readonly buttons: number;
21
+ readonly position: Vector2;
22
+ }
23
+
24
+ export interface IPointerEvent3D {
25
+ readonly buttons: number;
26
+ readonly intersection: Intersection | undefined;
27
+ readonly object: Object3D;
28
+ readonly point: Vector3;
29
+ readonly pointerId: number;
30
+ readonly target: Object3D;
31
+ readonly type: PointerEvent3DType;
32
+ stopPropagation(): void;
33
+ }
34
+
35
+ export type PointerEvent3DListener = (event: IPointerEvent3D) => void;
36
+
37
+ export interface IPointerDragHandle {
38
+ cancel(): void;
39
+ }
40
+
41
+ export interface IPointerEvents3DPicker {
42
+ raycastAll(options?: IRaycastOptions): readonly Intersection[];
43
+ }
44
+
45
+ export interface IPointerEvents3D {
46
+ on(object: Object3D, type: PointerEvent3DType, listener: PointerEvent3DListener): () => void;
47
+ off(object: Object3D, type: PointerEvent3DType, listener: PointerEvent3DListener): void;
48
+ drag(object: Object3D): IPointerDragHandle;
49
+ }
50
+
51
+ export interface IPointerEvents3DOptions {
52
+ /** Convert an input position into the canvas-relative pixels expected by ScenePicker. */
53
+ readonly screen?: (position: Vector2, target: Vector2) => Vector2;
54
+ }
55
+
56
+ interface IPointerRecord {
57
+ readonly id: number;
58
+ buttons: number;
59
+ dragTarget: Object3D | undefined;
60
+ hovered: Object3D | undefined;
61
+ lastPoint: Vector3;
62
+ pressed: Object3D | undefined;
63
+ }
64
+
65
+ type PrimaryPointer = Pick<IPointerState, "buttons" | "position">;
66
+ type PointerEdge = IRawInputPointerEdge;
67
+ type PointerEdges = ReadonlyMap<number, readonly PointerEdge[]>;
68
+ type PointerPicker = Pick<ScenePicker, "raycastAll"> | IPointerEvents3DPicker;
69
+
70
+ const NO_POINT = new Vector3();
71
+
72
+ function isPointerEventType(value: string): value is PointerEvent3DType {
73
+ return (POINTER_EVENT_TYPES as readonly string[]).includes(value);
74
+ }
75
+
76
+ /**
77
+ * Dispatch portable pointer events from the input stream to registered Three.js objects.
78
+ *
79
+ * Listeners live in a side table, so this never patches Three.js prototypes. The picker receives
80
+ * one target list and one query per active pointer, while the empty registration path does no
81
+ * queries at all.
82
+ */
83
+ export class PointerEvents3D implements IPointerEvents3D {
84
+ #listeners = new Map<Object3D, Map<PointerEvent3DType, Set<PointerEvent3DListener>>>();
85
+ #draggable = new Set<Object3D>();
86
+ #edgeHits = new Map<number, Intersection | undefined>();
87
+ #pointers = new Map<number, IPointerRecord>();
88
+ // The active-pointer set is rebuilt every tick; one reused map keeps a busy frame from
89
+ // allocating a fresh map and its entries each time.
90
+ // ponytail: one shared scratch map, matching the shared #edgeIds/#edgeHits below. Depth-pool it
91
+ // if a listener ever drives a nested tick.
92
+ #active = new Map<number, IPointerState>();
93
+ #edgeIds = new Set<number>();
94
+ #targets: Object3D[] = [];
95
+ #screen = new Vector2();
96
+ #screenTransform: (position: Vector2, target: Vector2) => Vector2;
97
+
98
+ constructor(options: IPointerEvents3DOptions = {}) {
99
+ this.#screenTransform = options.screen ?? ((position, target) => target.copy(position));
100
+ }
101
+
102
+ /** Listen for one event on an object. The returned function removes exactly this listener. */
103
+ on(object: Object3D, type: PointerEvent3DType, listener: PointerEvent3DListener): () => void {
104
+ if (!isPointerEventType(type)) throw new Error(`Unknown 3D pointer event '${type}'.`);
105
+ let byType = this.#listeners.get(object);
106
+ if (byType === undefined) {
107
+ byType = new Map();
108
+ this.#listeners.set(object, byType);
109
+ this.#addTarget(object);
110
+ }
111
+ let listeners = byType.get(type);
112
+ if (listeners === undefined) {
113
+ listeners = new Set();
114
+ byType.set(type, listeners);
115
+ }
116
+ listeners.add(listener);
117
+ let active = true;
118
+ return () => {
119
+ if (!active) return;
120
+ active = false;
121
+ this.off(object, type, listener);
122
+ };
123
+ }
124
+
125
+ /** Remove a listener previously passed to `on`. */
126
+ off(object: Object3D, type: PointerEvent3DType, listener: PointerEvent3DListener): void {
127
+ const byType = this.#listeners.get(object);
128
+ const listeners = byType?.get(type);
129
+ if (byType === undefined || listeners === undefined) return;
130
+ listeners.delete(listener);
131
+ if (listeners.size !== 0) return;
132
+ byType.delete(type);
133
+ this.#unregisterIfUnused(object);
134
+ }
135
+
136
+ /** Make an object capture a pointer for drag events until its handle is cancelled. */
137
+ drag(object: Object3D): IPointerDragHandle {
138
+ this.#draggable.add(object);
139
+ this.#addTarget(object);
140
+ let active = true;
141
+ return {
142
+ cancel: () => {
143
+ if (!active) return;
144
+ active = false;
145
+ this.#draggable.delete(object);
146
+ for (const record of this.#pointers.values()) {
147
+ if (record.dragTarget !== object) continue;
148
+ this.#dispatch("dragEnded", object, record, record.buttons, undefined);
149
+ record.dragTarget = undefined;
150
+ record.pressed = undefined;
151
+ }
152
+ this.#unregisterIfUnused(object);
153
+ },
154
+ };
155
+ }
156
+
157
+ /**
158
+ * Advance every pointer by one simulation tick.
159
+ *
160
+ * `primary` is the legacy mouse position: InputMap keeps it even when no button is down, which
161
+ * lets hover work on web without changing the existing held-touch map. It is ignored whenever
162
+ * the per-id map has a live pointer.
163
+ */
164
+ tick(
165
+ pointers: ReadonlyMap<number, IPointerState>,
166
+ picker: PointerPicker,
167
+ primary?: PrimaryPointer,
168
+ edges?: PointerEdges,
169
+ ): void {
170
+ this.#edgeIds.clear();
171
+ this.#edgeHits.clear();
172
+ if (this.#targets.length === 0) return;
173
+ const active = this.#active;
174
+ active.clear();
175
+ for (const [id, pointer] of pointers) active.set(id, pointer);
176
+ const hasEdges = edges !== undefined && edges.size !== 0;
177
+ if (!hasEdges && active.size === 0 && primary !== undefined) {
178
+ const onlyPointer =
179
+ this.#pointers.size === 1 ? this.#pointers.keys().next().value : undefined;
180
+ const id = onlyPointer ?? 0;
181
+ active.set(id, { id, buttons: primary.buttons, position: primary.position });
182
+ }
183
+
184
+ if (edges !== undefined) {
185
+ for (const id of edges.keys()) this.#edgeIds.add(id);
186
+ }
187
+ for (const [id, record] of this.#pointers) {
188
+ if (active.has(id) || this.#edgeIds.has(id)) continue;
189
+ this.#finishPointer(id, record);
190
+ }
191
+
192
+ this.#processEdges(picker, edges);
193
+ if (active.size === 0 && primary !== undefined) {
194
+ const onlyPointer =
195
+ this.#pointers.size === 1 ? this.#pointers.keys().next().value : undefined;
196
+ const id = onlyPointer ?? 0;
197
+ active.set(id, { id, buttons: primary.buttons, position: primary.position });
198
+ }
199
+ for (const [id, record] of this.#pointers) {
200
+ if (active.has(id) || this.#edgeIds.has(id)) continue;
201
+ this.#finishPointer(id, record);
202
+ }
203
+
204
+ for (const [id, pointer] of active) {
205
+ this.#processActive(pointer, picker, this.#edgeIds.has(id));
206
+ }
207
+ }
208
+
209
+ /** Remove all registrations and release all per-pointer state, usually on scene change. */
210
+ clear(): void {
211
+ this.#listeners.clear();
212
+ this.#draggable.clear();
213
+ this.#edgeHits.clear();
214
+ this.#edgeIds.clear();
215
+ this.#pointers.clear();
216
+ this.#targets.length = 0;
217
+ }
218
+
219
+ dispose(): void {
220
+ this.clear();
221
+ }
222
+
223
+ #newRecord(id: number): IPointerRecord {
224
+ return {
225
+ buttons: 0,
226
+ dragTarget: undefined,
227
+ hovered: undefined,
228
+ id,
229
+ lastPoint: NO_POINT.clone(),
230
+ pressed: undefined,
231
+ };
232
+ }
233
+
234
+ #hit(pointer: IPointerState, picker: PointerPicker): Intersection | undefined {
235
+ this.#screenTransform(pointer.position, this.#screen);
236
+ const hits = picker.raycastAll({ screen: this.#screen, targets: this.#targets });
237
+ return hits[0];
238
+ }
239
+
240
+ #processEdges(picker: PointerPicker, edges: PointerEdges | undefined): void {
241
+ if (edges === undefined) return;
242
+ for (const [id, pointerEdges] of edges) {
243
+ this.#edgeIds.add(id);
244
+ for (const edge of pointerEdges) {
245
+ const hit = this.#hit(edge, picker);
246
+ this.#edgeHits.set(id, hit);
247
+ this.#processEdge(edge, hit);
248
+ }
249
+ }
250
+ }
251
+
252
+ #processEdge(edge: PointerEdge, hit: Intersection | undefined): void {
253
+ const record = this.#pointers.get(edge.id) ?? this.#newRecord(edge.id);
254
+ this.#pointers.set(edge.id, record);
255
+ this.#edgeHits.set(edge.id, hit);
256
+ this.#updateHover(record, hit, edge.buttons);
257
+ if (edge.type === "down") {
258
+ if (record.buttons === 0 && edge.buttons !== 0) this.#press(record, hit, edge.buttons);
259
+ } else if (edge.type === "up" && record.buttons !== 0 && edge.buttons === 0) {
260
+ this.#release(record, hit, edge.buttons);
261
+ } else if (edge.type === "cancel") {
262
+ this.#cancel(record);
263
+ }
264
+ record.buttons = edge.type === "cancel" ? 0 : edge.buttons;
265
+ }
266
+
267
+ #processActive(pointer: IPointerState, picker: PointerPicker, hasEdge: boolean): void {
268
+ const record = this.#pointers.get(pointer.id) ?? this.#newRecord(pointer.id);
269
+ this.#pointers.set(pointer.id, record);
270
+ const previousButtons = record.buttons;
271
+ const hit = hasEdge ? this.#edgeHits.get(pointer.id) : this.#hit(pointer, picker);
272
+ this.#updateHover(record, hit, pointer.buttons);
273
+ if (!hasEdge) {
274
+ if (previousButtons === 0 && pointer.buttons !== 0) {
275
+ this.#press(record, hit, pointer.buttons);
276
+ } else if (pointer.buttons !== 0 && record.dragTarget !== undefined) {
277
+ this.#dispatch("dragged", record.dragTarget, record, pointer.buttons, hit);
278
+ }
279
+ if (previousButtons !== 0 && pointer.buttons === 0)
280
+ this.#release(record, hit, pointer.buttons);
281
+ }
282
+ record.buttons = pointer.buttons;
283
+ }
284
+
285
+ #press(record: IPointerRecord, hit: Intersection | undefined, buttons: number): void {
286
+ record.pressed = hit?.object;
287
+ if (record.pressed === undefined) return;
288
+ this.#dispatch("pointerPressed", record.pressed, record, buttons, hit);
289
+ record.dragTarget = this.#draggableAncestor(record.pressed);
290
+ if (record.dragTarget !== undefined)
291
+ this.#dispatch("dragStarted", record.dragTarget, record, buttons, hit);
292
+ }
293
+
294
+ #cancel(record: IPointerRecord): void {
295
+ record.pressed = undefined;
296
+ record.dragTarget = undefined;
297
+ if (record.hovered === undefined) return;
298
+ this.#dispatch("pointerExited", record.hovered, record, 0, undefined);
299
+ record.hovered = undefined;
300
+ }
301
+
302
+ #updateHover(record: IPointerRecord, hit: Intersection | undefined, buttons: number): void {
303
+ const next = hit?.object;
304
+ if (record.hovered === next) {
305
+ if (hit !== undefined) record.lastPoint.copy(hit.point);
306
+ return;
307
+ }
308
+ if (record.hovered !== undefined)
309
+ this.#dispatch("pointerExited", record.hovered, record, buttons, undefined);
310
+ record.hovered = next;
311
+ if (hit !== undefined) {
312
+ record.lastPoint.copy(hit.point);
313
+ this.#dispatch("pointerEntered", hit.object, record, buttons, hit);
314
+ }
315
+ }
316
+
317
+ #release(
318
+ record: IPointerRecord,
319
+ hit: Intersection | undefined,
320
+ buttons: number,
321
+ allowTap = true,
322
+ ): void {
323
+ const pressed = record.pressed;
324
+ if (pressed === undefined) return;
325
+ this.#dispatch("pointerReleased", pressed, record, buttons, hit);
326
+ const dragTarget = record.dragTarget;
327
+ if (dragTarget !== undefined) {
328
+ this.#dispatch("dragEnded", dragTarget, record, buttons, hit);
329
+ } else if (allowTap && this.#sameInteractiveTarget(pressed, hit?.object ?? record.hovered)) {
330
+ this.#dispatch("tapped", pressed, record, buttons, hit);
331
+ }
332
+ record.pressed = undefined;
333
+ record.dragTarget = undefined;
334
+ }
335
+
336
+ #finishPointer(id: number, record: IPointerRecord): void {
337
+ if (record.buttons !== 0) this.#release(record, undefined, 0, false);
338
+ if (record.hovered !== undefined) {
339
+ this.#dispatch("pointerExited", record.hovered, record, 0, undefined);
340
+ record.hovered = undefined;
341
+ }
342
+ this.#pointers.delete(id);
343
+ }
344
+
345
+ #dispatch(
346
+ type: PointerEvent3DType,
347
+ target: Object3D,
348
+ record: IPointerRecord,
349
+ buttons: number,
350
+ hit: Intersection | undefined,
351
+ ): void {
352
+ let stopped = false;
353
+ const event: IPointerEvent3D = {
354
+ buttons,
355
+ intersection: hit,
356
+ object: target,
357
+ point: (hit?.point ?? record.lastPoint).clone(),
358
+ pointerId: record.id,
359
+ target,
360
+ type,
361
+ stopPropagation: () => {
362
+ stopped = true;
363
+ },
364
+ };
365
+ let current: Object3D | null = target;
366
+ while (current !== null) {
367
+ const listeners = this.#listeners.get(current)?.get(type);
368
+ if (listeners !== undefined) {
369
+ for (const listener of [...listeners]) listener(event);
370
+ }
371
+ if (stopped) return;
372
+ current = current.parent;
373
+ }
374
+ }
375
+
376
+ #draggableAncestor(object: Object3D): Object3D | undefined {
377
+ let current: Object3D | null = object;
378
+ while (current !== null) {
379
+ if (this.#draggable.has(current)) return current;
380
+ current = current.parent;
381
+ }
382
+ return undefined;
383
+ }
384
+
385
+ #sameInteractiveTarget(first: Object3D, second: Object3D | undefined): boolean {
386
+ if (second === undefined) return false;
387
+ return this.#interactiveTarget(first) === this.#interactiveTarget(second);
388
+ }
389
+
390
+ #interactiveTarget(object: Object3D): Object3D | undefined {
391
+ let current: Object3D | null = object;
392
+ while (current !== null) {
393
+ if (this.#listeners.has(current) || this.#draggable.has(current)) return current;
394
+ current = current.parent;
395
+ }
396
+ return undefined;
397
+ }
398
+
399
+ #addTarget(object: Object3D): void {
400
+ if (!this.#targets.includes(object)) this.#targets.push(object);
401
+ }
402
+
403
+ #unregisterIfUnused(object: Object3D): void {
404
+ const byType = this.#listeners.get(object);
405
+ if (byType !== undefined && byType.size !== 0) return;
406
+ if (this.#draggable.has(object)) return;
407
+ this.#listeners.delete(object);
408
+ const index = this.#targets.indexOf(object);
409
+ if (index >= 0) this.#targets.splice(index, 1);
410
+ }
411
+ }