@atom.io/spa 0.0.1 → 0.0.2

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 (112) hide show
  1. package/README.md +201 -6
  2. package/README.mdx +62 -1
  3. package/dist/astro-application.d.ts +1 -1
  4. package/dist/astro-client.d.ts +1 -1
  5. package/dist/astro-client.js +6 -3
  6. package/dist/astro-client.js.map +1 -1
  7. package/dist/astro-server.js +2 -1
  8. package/dist/astro-server.js.map +1 -1
  9. package/dist/astro-shared-BT45auwR.js.map +1 -1
  10. package/dist/{astro-shared-DkZaqX7L.d.ts → astro-shared-DyzbUi6c.d.ts} +4 -2
  11. package/dist/astro-shared-DyzbUi6c.d.ts.map +1 -0
  12. package/dist/astro.d.ts +1 -1
  13. package/dist/astro.js +1 -1
  14. package/dist/{core-Dvqm7w2y.js → capabilities-BuZUQpiD.js} +64 -2
  15. package/dist/capabilities-BuZUQpiD.js.map +1 -0
  16. package/dist/{core-BhiA9fFi.d.ts → capabilities-yC9TsHDI.d.ts} +20 -2
  17. package/dist/capabilities-yC9TsHDI.d.ts.map +1 -0
  18. package/dist/client.min.js +1 -1
  19. package/dist/development/astro-client.js +6 -3
  20. package/dist/development/astro-client.js.map +1 -1
  21. package/dist/development/astro-server.js +2 -1
  22. package/dist/development/astro-server.js.map +1 -1
  23. package/dist/development/astro-shared-BT45auwR.js.map +1 -1
  24. package/dist/development/astro.js +1 -1
  25. package/dist/development/{core-DB3sQz4h.js → capabilities-DhOJmeoJ.js} +64 -2
  26. package/dist/development/capabilities-DhOJmeoJ.js.map +1 -0
  27. package/dist/development/{dom-D9cY6l1R.js → dom-BKc6V_Kz.js} +8 -3
  28. package/dist/development/dom-BKc6V_Kz.js.map +1 -0
  29. package/dist/development/index.js +3 -38
  30. package/dist/development/jsx-runtime.js.map +1 -1
  31. package/dist/development/konva.js +121 -0
  32. package/dist/development/konva.js.map +1 -0
  33. package/dist/development/motion.js +217 -0
  34. package/dist/development/motion.js.map +1 -0
  35. package/dist/development/renderer.js +177 -0
  36. package/dist/development/renderer.js.map +1 -0
  37. package/dist/development/server.js +3 -2
  38. package/dist/development/server.js.map +1 -1
  39. package/dist/development/src-Dh-d6w4y.js +38 -0
  40. package/dist/development/src-Dh-d6w4y.js.map +1 -0
  41. package/dist/development/three.js +438 -0
  42. package/dist/development/three.js.map +1 -0
  43. package/dist/development/vite-CSHoxzXU.js +240 -0
  44. package/dist/development/vite-CSHoxzXU.js.map +1 -0
  45. package/dist/development/vite.js +1 -1
  46. package/dist/{dom-BR9o9wZW.js → dom-B2rm8o2L.js} +8 -3
  47. package/dist/dom-B2rm8o2L.js.map +1 -0
  48. package/dist/index-BdwxmSKg.d.ts +24 -0
  49. package/dist/index-BdwxmSKg.d.ts.map +1 -0
  50. package/dist/index.d.ts +4 -24
  51. package/dist/index.js +3 -38
  52. package/dist/{jsx-runtime-BzGV18VO.d.ts → jsx-runtime-CZU7F8Qz.d.ts} +6 -4
  53. package/dist/jsx-runtime-CZU7F8Qz.d.ts.map +1 -0
  54. package/dist/jsx-runtime.d.ts +2 -2
  55. package/dist/jsx-runtime.js.map +1 -1
  56. package/dist/konva.d.ts +32 -0
  57. package/dist/konva.d.ts.map +1 -0
  58. package/dist/konva.js +121 -0
  59. package/dist/konva.js.map +1 -0
  60. package/dist/motion.d.ts +44 -0
  61. package/dist/motion.d.ts.map +1 -0
  62. package/dist/motion.js +217 -0
  63. package/dist/motion.js.map +1 -0
  64. package/dist/renderer.d.ts +24 -0
  65. package/dist/renderer.d.ts.map +1 -0
  66. package/dist/renderer.js +177 -0
  67. package/dist/renderer.js.map +1 -0
  68. package/dist/server.d.ts +1 -1
  69. package/dist/server.d.ts.map +1 -1
  70. package/dist/server.js +3 -2
  71. package/dist/server.js.map +1 -1
  72. package/dist/size.json +16 -16
  73. package/dist/src-BZxX4xbU.js +38 -0
  74. package/dist/src-BZxX4xbU.js.map +1 -0
  75. package/dist/three.d.ts +110 -0
  76. package/dist/three.d.ts.map +1 -0
  77. package/dist/three.js +438 -0
  78. package/dist/three.js.map +1 -0
  79. package/dist/vite-CSHoxzXU.js +240 -0
  80. package/dist/vite-CSHoxzXU.js.map +1 -0
  81. package/dist/vite.js +1 -1
  82. package/package.json +56 -11
  83. package/src/astro-client.ts +1 -0
  84. package/src/astro-server.ts +1 -0
  85. package/src/astro-shared.ts +3 -0
  86. package/src/capabilities.ts +88 -0
  87. package/src/compiler.ts +251 -178
  88. package/src/core.ts +11 -0
  89. package/src/dom.ts +4 -1
  90. package/src/index.ts +5 -0
  91. package/src/jsx-runtime.ts +4 -0
  92. package/src/jsx-types.d.ts +3 -1
  93. package/src/konva.ts +159 -0
  94. package/src/motion.ts +406 -0
  95. package/src/renderer.ts +241 -0
  96. package/src/server.ts +3 -0
  97. package/src/three-events.ts +330 -0
  98. package/src/three.ts +350 -0
  99. package/dist/astro-shared-DkZaqX7L.d.ts.map +0 -1
  100. package/dist/core-BhiA9fFi.d.ts.map +0 -1
  101. package/dist/core-Dvqm7w2y.js.map +0 -1
  102. package/dist/development/core-DB3sQz4h.js.map +0 -1
  103. package/dist/development/dom-D9cY6l1R.js.map +0 -1
  104. package/dist/development/index.js.map +0 -1
  105. package/dist/development/vite-CQchIQ_-.js +0 -126
  106. package/dist/development/vite-CQchIQ_-.js.map +0 -1
  107. package/dist/dom-BR9o9wZW.js.map +0 -1
  108. package/dist/index.d.ts.map +0 -1
  109. package/dist/index.js.map +0 -1
  110. package/dist/jsx-runtime-BzGV18VO.d.ts.map +0 -1
  111. package/dist/vite-CQchIQ_-.js +0 -126
  112. package/dist/vite-CQchIQ_-.js.map +0 -1
@@ -0,0 +1,330 @@
1
+ import * as THREE from "three"
2
+
3
+ export interface ThreePointerEvent<N extends THREE.Object3D = THREE.Object3D> {
4
+ type: string
5
+ nativeEvent: PointerEvent
6
+ target: THREE.Object3D
7
+ currentTarget: N
8
+ intersection: THREE.Intersection
9
+ ray: THREE.Ray
10
+ pointerId: number
11
+ button: number
12
+ buttons: number
13
+ clientX: number
14
+ clientY: number
15
+ stopPropagation(): void
16
+ preventDefault(): void
17
+ setPointerCapture(): void
18
+ releasePointerCapture(): void
19
+ hasPointerCapture(): boolean
20
+ }
21
+ export type ThreeEventHandler<N extends THREE.Object3D = THREE.Object3D> = (
22
+ event: ThreePointerEvent<N>,
23
+ ) => void
24
+ export interface ThreeEventAttributes<
25
+ N extends THREE.Object3D = THREE.Object3D,
26
+ > {
27
+ onPointerDown?: ThreeEventHandler<N>
28
+ onPointerUp?: ThreeEventHandler<N>
29
+ onPointerMove?: ThreeEventHandler<N>
30
+ onPointerEnter?: ThreeEventHandler<N>
31
+ onPointerLeave?: ThreeEventHandler<N>
32
+ onPointerOver?: ThreeEventHandler<N>
33
+ onPointerOut?: ThreeEventHandler<N>
34
+ onPointerCancel?: ThreeEventHandler<N>
35
+ onClick?: ThreeEventHandler<N>
36
+ }
37
+ type Hit = { node: THREE.Object3D; intersection: THREE.Intersection }
38
+ type Handler = ThreeEventHandler
39
+ const listeners = new WeakMap<THREE.Object3D, Map<string, Set<Handler>>>()
40
+ const managers = new Set<{ remove(node: THREE.Object3D): void }>()
41
+
42
+ export function listenThree(
43
+ node: THREE.Object3D,
44
+ type: string,
45
+ handler: Handler,
46
+ ): () => void {
47
+ const events = listeners.get(node) ?? new Map<string, Set<Handler>>()
48
+ listeners.set(node, events)
49
+ const handlers = events.get(type) ?? new Set<Handler>()
50
+ events.set(type, handlers)
51
+ handlers.add(handler)
52
+ return () => {
53
+ handlers.delete(handler)
54
+ if (!handlers.size) events.delete(type)
55
+ }
56
+ }
57
+ export function forgetThree(node: THREE.Object3D): void {
58
+ const errors: unknown[] = []
59
+ for (const manager of managers) {
60
+ try {
61
+ manager.remove(node)
62
+ } catch (error) {
63
+ errors.push(error)
64
+ }
65
+ }
66
+ listeners.delete(node)
67
+ if (errors.length) throw new AggregateError(errors)
68
+ }
69
+
70
+ export interface ThreeEventManager {
71
+ update(): void
72
+ /** Release hover, press, and capture state for a removed subtree. */
73
+ remove(node: THREE.Object3D): void
74
+ dispose(): void
75
+ }
76
+
77
+ /** Attach raycast pointer routing to a canvas; usable with borrowed scene roots. */
78
+ export function createThreeEvents(
79
+ canvas: HTMLCanvasElement,
80
+ scene: THREE.Object3D,
81
+ camera: () => THREE.Camera,
82
+ onError: (error: unknown) => void = (error) => {
83
+ throw error
84
+ },
85
+ ): ThreeEventManager {
86
+ const raycaster = new THREE.Raycaster()
87
+ const pointer = new THREE.Vector2()
88
+ const hovering = new Map<number, Hit>()
89
+ const pressed = new Map<number, Hit>()
90
+ const captures = new Map<number, Hit>()
91
+ const last = new Map<number, PointerEvent>()
92
+ let dead = false
93
+ const path = (node: THREE.Object3D) => {
94
+ const nodes: THREE.Object3D[] = []
95
+ for (let at: THREE.Object3D | null = node; at; at = at.parent) {
96
+ nodes.push(at)
97
+ if (at === scene) return nodes
98
+ }
99
+ return []
100
+ }
101
+ const contains = (node: THREE.Object3D, child: THREE.Object3D) => {
102
+ for (let at: THREE.Object3D | null = child; at; at = at.parent)
103
+ if (at === node) return true
104
+ return false
105
+ }
106
+ const eligible = (intersection: THREE.Intersection) => {
107
+ const nodes = path(intersection.object)
108
+ if (!nodes.length || nodes.some((node) => !node.visible)) return false
109
+ const material = (intersection.object as THREE.Mesh).material
110
+ return (
111
+ !material ||
112
+ (Array.isArray(material)
113
+ ? material[intersection.face?.materialIndex ?? 0]?.visible !== false
114
+ : material.visible)
115
+ )
116
+ }
117
+ const pick = (event: PointerEvent): Hit | undefined => {
118
+ const bounds = canvas.getBoundingClientRect()
119
+ if (!bounds.width || !bounds.height) return undefined
120
+ const active = camera()
121
+ scene.updateWorldMatrix(true, true)
122
+ active.updateWorldMatrix(true, false)
123
+ pointer.set(
124
+ ((event.clientX - bounds.left) / bounds.width) * 2 - 1,
125
+ 1 - ((event.clientY - bounds.top) / bounds.height) * 2,
126
+ )
127
+ raycaster.layers.mask = active.layers.mask
128
+ raycaster.setFromCamera(pointer, active)
129
+ if (
130
+ event.clientX < bounds.left ||
131
+ event.clientX > bounds.right ||
132
+ event.clientY < bounds.top ||
133
+ event.clientY > bounds.bottom
134
+ )
135
+ return undefined
136
+ const intersection = raycaster.intersectObject(scene, true).find(eligible)
137
+ return intersection ? { node: intersection.object, intersection } : undefined
138
+ }
139
+ const nativeCapture = (id: number) => {
140
+ if (canvas.hasPointerCapture?.(id)) canvas.releasePointerCapture(id)
141
+ }
142
+ const dispatch = (
143
+ type: string,
144
+ hit: Hit,
145
+ nativeEvent: PointerEvent,
146
+ nodes = path(hit.node),
147
+ ) => {
148
+ let stopped = false
149
+ for (const node of nodes) {
150
+ if (dead) break
151
+ const event: ThreePointerEvent = {
152
+ type,
153
+ nativeEvent,
154
+ target: hit.node,
155
+ currentTarget: node,
156
+ intersection: hit.intersection,
157
+ ray: raycaster.ray.clone(),
158
+ pointerId: nativeEvent.pointerId,
159
+ button: nativeEvent.button,
160
+ buttons: nativeEvent.buttons,
161
+ clientX: nativeEvent.clientX,
162
+ clientY: nativeEvent.clientY,
163
+ stopPropagation() {
164
+ stopped = true
165
+ },
166
+ preventDefault() {
167
+ nativeEvent.preventDefault()
168
+ },
169
+ setPointerCapture() {
170
+ canvas.setPointerCapture(nativeEvent.pointerId)
171
+ captures.set(nativeEvent.pointerId, {
172
+ node,
173
+ intersection: hit.intersection,
174
+ })
175
+ },
176
+ releasePointerCapture() {
177
+ if (captures.get(nativeEvent.pointerId)?.node === node) {
178
+ captures.delete(nativeEvent.pointerId)
179
+ nativeCapture(nativeEvent.pointerId)
180
+ }
181
+ },
182
+ hasPointerCapture() {
183
+ return captures.get(nativeEvent.pointerId)?.node === node
184
+ },
185
+ }
186
+ for (const handler of [...(listeners.get(node)?.get(type) ?? [])])
187
+ if (!dead && listeners.get(node)?.get(type)?.has(handler)) handler(event)
188
+ if (stopped) break
189
+ }
190
+ }
191
+ const hover = (event: PointerEvent, next?: Hit) => {
192
+ const previous = hovering.get(event.pointerId)
193
+ if (previous?.node === next?.node) {
194
+ if (next) hovering.set(event.pointerId, next)
195
+ return
196
+ }
197
+ const oldPath = previous ? path(previous.node) : []
198
+ const newPath = next ? path(next.node) : []
199
+ // Publish state first so handlers may remove nodes or dispose this manager safely.
200
+ if (next) hovering.set(event.pointerId, next)
201
+ else hovering.delete(event.pointerId)
202
+ if (previous) {
203
+ dispatch(`pointerout`, previous, event)
204
+ for (const node of oldPath)
205
+ if (!newPath.includes(node))
206
+ dispatch(`pointerleave`, previous, event, [node])
207
+ }
208
+ if (next && path(next.node).length) {
209
+ dispatch(`pointerover`, next, event)
210
+ for (const node of newPath.reverse())
211
+ if (!oldPath.includes(node))
212
+ dispatch(`pointerenter`, next, event, [node])
213
+ }
214
+ }
215
+ const cancel = (event: PointerEvent) => {
216
+ const hit = captures.get(event.pointerId) ?? pressed.get(event.pointerId)
217
+ captures.delete(event.pointerId)
218
+ pressed.delete(event.pointerId)
219
+ try {
220
+ if (hit) dispatch(`pointercancel`, hit, event)
221
+ } finally {
222
+ nativeCapture(event.pointerId)
223
+ }
224
+ }
225
+ const handle = (event: PointerEvent) => {
226
+ try {
227
+ if (event.type === `lostpointercapture`) {
228
+ cancel(event)
229
+ return
230
+ }
231
+ if (event.type === `pointercancel`) {
232
+ cancel(event)
233
+ hover(event)
234
+ last.delete(event.pointerId)
235
+ return
236
+ }
237
+ if (event.type === `pointerleave`) {
238
+ last.set(event.pointerId, event)
239
+ hover(event)
240
+ return
241
+ }
242
+ last.set(event.pointerId, event)
243
+ const hit = pick(event)
244
+ hover(event, hit)
245
+ if (dead) return
246
+ const capture = captures.get(event.pointerId)
247
+ if (capture && hit && contains(capture.node, hit.node))
248
+ capture.intersection = hit.intersection
249
+ const delivery = capture ?? hit
250
+ if (event.type === `pointerdown`) {
251
+ if (hit) {
252
+ pressed.set(event.pointerId, hit)
253
+ canvas.setPointerCapture?.(event.pointerId)
254
+ }
255
+ }
256
+ if (event.type === `pointerup`) {
257
+ const down = pressed.get(event.pointerId)
258
+ pressed.delete(event.pointerId)
259
+ if (down && down.node !== delivery?.node)
260
+ dispatch(`pointercancel`, down, event)
261
+ if (delivery) dispatch(`pointerup`, delivery, event)
262
+ if (down && down.node === hit?.node && event.button === 0)
263
+ dispatch(`click`, hit, event)
264
+ captures.delete(event.pointerId)
265
+ nativeCapture(event.pointerId)
266
+ if (event.pointerType === `touch`) {
267
+ hover(event)
268
+ last.delete(event.pointerId)
269
+ }
270
+ } else if (delivery) dispatch(event.type, delivery, event)
271
+ } catch (error) {
272
+ onError(error)
273
+ }
274
+ }
275
+ const events = [
276
+ `pointerdown`,
277
+ `pointerup`,
278
+ `pointermove`,
279
+ `pointerleave`,
280
+ `pointercancel`,
281
+ `lostpointercapture`,
282
+ ] as const
283
+ for (const type of events) canvas.addEventListener(type, handle)
284
+ const manager = {
285
+ /** Re-pick stationary pointers after camera, geometry, or transforms change. */
286
+ update() {
287
+ if (dead) return
288
+ try {
289
+ for (const event of last.values())
290
+ if (event.type !== `pointerleave`) hover(event, pick(event))
291
+ } catch (error) {
292
+ onError(error)
293
+ }
294
+ },
295
+ remove(node: THREE.Object3D) {
296
+ const errors: unknown[] = []
297
+ for (const [id, hit] of hovering)
298
+ if (contains(node, hit.node)) {
299
+ try {
300
+ hover(last.get(id)!)
301
+ } catch (error) {
302
+ errors.push(error)
303
+ }
304
+ }
305
+ for (const [id, hit] of [...pressed, ...captures])
306
+ if (contains(node, hit.node)) {
307
+ try {
308
+ cancel(last.get(id)!)
309
+ } catch (error) {
310
+ errors.push(error)
311
+ }
312
+ }
313
+ if (errors.length) throw new AggregateError(errors)
314
+ },
315
+ dispose() {
316
+ if (dead) return
317
+ dead = true
318
+ for (const type of events) canvas.removeEventListener(type, handle)
319
+ for (const id of new Set([...pressed.keys(), ...captures.keys()]))
320
+ nativeCapture(id)
321
+ hovering.clear()
322
+ pressed.clear()
323
+ captures.clear()
324
+ last.clear()
325
+ managers.delete(manager)
326
+ },
327
+ }
328
+ managers.add(manager)
329
+ return manager
330
+ }
package/src/three.ts ADDED
@@ -0,0 +1,350 @@
1
+ import { fail, owner } from "./core.ts"
2
+ import type { ThreeEventAttributes, ThreeEventHandler } from "./three-events.ts"
3
+ import { createThreeEvents, forgetThree, listenThree } from "./three-events.ts"
4
+
5
+ export type {
6
+ ThreeEventAttributes,
7
+ ThreeEventHandler,
8
+ ThreeEventManager,
9
+ ThreePointerEvent,
10
+ } from "./three-events.ts"
11
+ export { createThreeEvents } from "./three-events.ts"
12
+ import * as THREE from "three"
13
+
14
+ import type { Child, VNode } from "./index.ts"
15
+ import { onCleanup, onMount } from "./index.ts"
16
+ import type { CapabilityAttributes } from "./jsx-runtime.ts"
17
+ import { jsx } from "./jsx-runtime.ts"
18
+ import {
19
+ bindScene,
20
+ createSceneRenderer,
21
+ onSceneFrame,
22
+ sceneComponent,
23
+ } from "./renderer.ts"
24
+
25
+ type Resource = THREE.Object3D | THREE.BufferGeometry | THREE.Material
26
+ type Vector3 = readonly [number, number, number]
27
+ export interface ObjectProps<N extends THREE.Object3D = THREE.Object3D>
28
+ extends CapabilityAttributes<`three`>, ThreeEventAttributes<N> {
29
+ children?: Child
30
+ position?: Vector3
31
+ rotation?: Vector3
32
+ scale?: Vector3 | number
33
+ visible?: boolean
34
+ name?: string
35
+ ref?: (object: N | null) => void
36
+ }
37
+ const constructors = {
38
+ Group: THREE.Group,
39
+ Mesh: THREE.Mesh,
40
+ PerspectiveCamera: THREE.PerspectiveCamera,
41
+ AmbientLight: THREE.AmbientLight,
42
+ DirectionalLight: THREE.DirectionalLight,
43
+ BoxGeometry: THREE.BoxGeometry,
44
+ SphereGeometry: THREE.SphereGeometry,
45
+ PlaneGeometry: THREE.PlaneGeometry,
46
+ MeshStandardMaterial: THREE.MeshStandardMaterial,
47
+ MeshBasicMaterial: THREE.MeshBasicMaterial,
48
+ MeshNormalMaterial: THREE.MeshNormalMaterial,
49
+ }
50
+ const meshDefaults = new WeakMap<
51
+ THREE.Mesh,
52
+ { geometry: THREE.BufferGeometry; material: THREE.Material }
53
+ >()
54
+ const borrowedMeshDefaults = new WeakMap<
55
+ THREE.Mesh,
56
+ {
57
+ geometry: THREE.BufferGeometry
58
+ material: THREE.Material | THREE.Material[]
59
+ }
60
+ >()
61
+ const constructorArgs = new WeakMap<Resource, unknown[]>()
62
+ const eventHandlers = new WeakMap<Resource, Map<string, () => void>>()
63
+ const defaults = new WeakMap<Resource, Map<string, any>>()
64
+ function writeProperty(node: Resource, key: string, value: any): void {
65
+ const target = node as any
66
+ if (!(key in target)) throw new Error(`spa/three: unknown property ${key}`)
67
+ const current = target[key]
68
+ if (current?.isColor) current.set(value)
69
+ else if (Array.isArray(value) && typeof current?.set === `function`)
70
+ current.set(...value)
71
+ else if (key === `scale` && typeof value === `number`) current.setScalar(value)
72
+ else if (current?.copy && value?.constructor === current.constructor)
73
+ current.copy(value)
74
+ else target[key] = value
75
+ if (node instanceof THREE.PerspectiveCamera) node.updateProjectionMatrix()
76
+ }
77
+ const renderer = createSceneRenderer<Resource>({
78
+ target(node) {
79
+ return {
80
+ kind: `three`,
81
+ node,
82
+ ...(node instanceof THREE.Object3D
83
+ ? {
84
+ listen: (type: string, listener: () => void) =>
85
+ listenThree(node, type, listener),
86
+ }
87
+ : {}),
88
+ read(key) {
89
+ const value = (node as any)[key]
90
+ return value?.isColor
91
+ ? value.getStyle()
92
+ : value?.isVector3 || value?.isEuler
93
+ ? [value.x, value.y, value.z]
94
+ : value
95
+ },
96
+ write(key, value) {
97
+ writeProperty(node, key, value)
98
+ },
99
+ }
100
+ },
101
+ create(type, props) {
102
+ const Constructor = constructors[type as keyof typeof constructors]
103
+ if (!Constructor) throw new Error(`spa/three: unknown node ${type}`)
104
+ const node = new (Constructor as any)(...(props[`args`] ?? [])) as Resource
105
+ // Mesh's implicit resources are replaced by owned JSX resources below.
106
+ if (node instanceof THREE.Mesh)
107
+ meshDefaults.set(node, {
108
+ geometry: node.geometry,
109
+ material: node.material as THREE.Material,
110
+ })
111
+ constructorArgs.set(node, [...(props[`args`] ?? [])])
112
+ defaults.set(node, new Map())
113
+ eventHandlers.set(node, new Map())
114
+ return node
115
+ },
116
+ update(node, props, previous) {
117
+ if (!equalArgs(constructorArgs.get(node)!, props[`args`]))
118
+ throw new Error(
119
+ `spa/three: change the component key to replace constructor args`,
120
+ )
121
+ const target = node as any
122
+ const saved = defaults.get(node)!
123
+ for (const key of new Set([
124
+ ...Object.keys(previous),
125
+ ...Object.keys(props),
126
+ ])) {
127
+ if (
128
+ /^(key|children|ref|args)$/.test(key) ||
129
+ Object.is(props[key], previous[key])
130
+ )
131
+ continue
132
+ if (key.startsWith(`on`)) {
133
+ if (
134
+ !(node instanceof THREE.Object3D) ||
135
+ !/^on(Pointer(Down|Up|Move|Enter|Leave|Over|Out|Cancel)|Click)$/.test(
136
+ key,
137
+ )
138
+ )
139
+ throw new Error(`spa/three: unknown event ${key}`)
140
+ const handlers = eventHandlers.get(node)!
141
+ handlers.get(key)?.()
142
+ handlers.delete(key)
143
+ if (props[key])
144
+ handlers.set(
145
+ key,
146
+ listenThree(
147
+ node,
148
+ key.slice(2).toLowerCase(),
149
+ props[key] as ThreeEventHandler,
150
+ ),
151
+ )
152
+ continue
153
+ }
154
+ if (!(key in target)) throw new Error(`spa/three: unknown property ${key}`)
155
+ const current = target[key]
156
+ if (!saved.has(key))
157
+ saved.set(key, current?.clone ? current.clone() : current)
158
+ const value = props[key] === undefined ? saved.get(key) : props[key]
159
+ writeProperty(node, key, value)
160
+ }
161
+ if (node instanceof THREE.PerspectiveCamera) node.updateProjectionMatrix()
162
+ },
163
+ children(parent, children) {
164
+ if (!(parent instanceof THREE.Object3D)) {
165
+ if (children.length)
166
+ throw new Error(`spa/three: resources cannot contain children`)
167
+ return
168
+ }
169
+ const objects = children.filter(
170
+ (child): child is THREE.Object3D => child instanceof THREE.Object3D,
171
+ )
172
+ for (const child of [...parent.children])
173
+ if (!objects.includes(child)) parent.remove(child)
174
+ for (const child of objects) if (child.parent !== parent) parent.add(child)
175
+ parent.children.splice(0, parent.children.length, ...objects)
176
+ const resources = children.filter(
177
+ (child) => !(child instanceof THREE.Object3D),
178
+ )
179
+ if (resources.length && !(parent instanceof THREE.Mesh))
180
+ throw new Error(`spa/three: geometry and material require a Mesh parent`)
181
+ if (parent instanceof THREE.Mesh) {
182
+ const geometries = resources.filter(
183
+ (child) => child instanceof THREE.BufferGeometry,
184
+ )
185
+ const materials = resources.filter(
186
+ (child) => child instanceof THREE.Material,
187
+ )
188
+ if (geometries.length > 1 || materials.length > 1)
189
+ throw new Error(
190
+ `spa/three: each Mesh accepts one geometry and one material`,
191
+ )
192
+ const owned = meshDefaults.get(parent)
193
+ let baseline = owned ?? borrowedMeshDefaults.get(parent)
194
+ if (!baseline) {
195
+ baseline = { geometry: parent.geometry, material: parent.material }
196
+ borrowedMeshDefaults.set(parent, baseline)
197
+ }
198
+ parent.geometry = geometries[0] ?? baseline.geometry
199
+ parent.material = materials[0] ?? baseline.material
200
+ if (!owned && children.length === 0) borrowedMeshDefaults.delete(parent)
201
+ }
202
+ },
203
+ destroy(node) {
204
+ eventHandlers.get(node)!.clear()
205
+ if (node instanceof THREE.Object3D) {
206
+ try {
207
+ forgetThree(node)
208
+ } finally {
209
+ node.removeFromParent()
210
+ if (node instanceof THREE.Mesh) {
211
+ const owned = meshDefaults.get(node)!
212
+ owned.geometry.dispose()
213
+ owned.material.dispose()
214
+ }
215
+ }
216
+ } else node.dispose()
217
+ },
218
+ })
219
+ function equalArgs(a: unknown[], b: unknown[] = []): boolean {
220
+ return (
221
+ a.length === b.length &&
222
+ a.every((value, index) => Object.is(value, b[index]))
223
+ )
224
+ }
225
+
226
+ export interface CanvasProps {
227
+ children?: Child
228
+ width?: number
229
+ height?: number
230
+ camera?: THREE.Camera
231
+ onFrame?: (state: {
232
+ scene: THREE.Scene
233
+ camera: THREE.Camera
234
+ renderer: THREE.WebGLRenderer
235
+ delta: number
236
+ time: number
237
+ }) => void
238
+ }
239
+ /** Browser-only scene boundary. The camera prop is borrowed and never disposed. */
240
+ export function Canvas(props: CanvasProps): VNode {
241
+ let canvas: HTMLCanvasElement | null = null
242
+ onMount(() => {
243
+ const webgl = new THREE.WebGLRenderer({ canvas: canvas!, antialias: true })
244
+ onCleanup(() => {
245
+ webgl.dispose()
246
+ })
247
+ const scene = new THREE.Scene()
248
+ const camera = new THREE.PerspectiveCamera(50, 1, 0.1, 1000)
249
+ camera.position.z = 5
250
+ bindScene(
251
+ () => [props.width ?? 800, props.height ?? 600] as const,
252
+ ([width, height]) => {
253
+ webgl.setSize(width, height)
254
+ camera.aspect = width / height
255
+ camera.updateProjectionMatrix()
256
+ },
257
+ )
258
+ renderer.mount(() => props.children, scene)
259
+ const root = owner!._root
260
+ const events = createThreeEvents(
261
+ canvas!,
262
+ scene,
263
+ () => props.camera ?? camera,
264
+ (error) => {
265
+ try {
266
+ fail(root, error)
267
+ } catch (failure) {
268
+ root.error(failure)
269
+ }
270
+ },
271
+ )
272
+ onCleanup(() => {
273
+ events.dispose()
274
+ })
275
+ let last: number | undefined
276
+ onSceneFrame((time) => {
277
+ const active = props.camera ?? camera
278
+ const delta = last === undefined ? 0 : (time - last) / 1000
279
+ last = time
280
+ props.onFrame?.({
281
+ scene,
282
+ camera: active,
283
+ renderer: webgl,
284
+ delta,
285
+ time: time / 1000,
286
+ })
287
+ events.update()
288
+ webgl.render(scene, active)
289
+ })
290
+ })
291
+ return jsx(`canvas`, {
292
+ ref: (element: HTMLCanvasElement | null) => {
293
+ canvas = element
294
+ },
295
+ })
296
+ }
297
+ export const Group = sceneComponent<ObjectProps>(`Group`)
298
+ export const Mesh = sceneComponent<ObjectProps<THREE.Mesh>>(`Mesh`)
299
+ export const PerspectiveCamera = sceneComponent<
300
+ ObjectProps<THREE.PerspectiveCamera> & {
301
+ args?: ConstructorParameters<typeof THREE.PerspectiveCamera>
302
+ fov?: number
303
+ aspect?: number
304
+ near?: number
305
+ far?: number
306
+ }
307
+ >(`PerspectiveCamera`)
308
+ export const AmbientLight = sceneComponent<
309
+ ObjectProps<THREE.Light> & {
310
+ color?: THREE.ColorRepresentation
311
+ intensity?: number
312
+ }
313
+ >(`AmbientLight`)
314
+ export const DirectionalLight = sceneComponent<
315
+ ObjectProps<THREE.Light> & {
316
+ color?: THREE.ColorRepresentation
317
+ intensity?: number
318
+ }
319
+ >(`DirectionalLight`)
320
+ export const BoxGeometry = sceneComponent<{
321
+ args?: ConstructorParameters<typeof THREE.BoxGeometry>
322
+ ref?: (node: THREE.BoxGeometry | null) => void
323
+ }>(`BoxGeometry`)
324
+ export const SphereGeometry = sceneComponent<{
325
+ args?: ConstructorParameters<typeof THREE.SphereGeometry>
326
+ ref?: (node: THREE.SphereGeometry | null) => void
327
+ }>(`SphereGeometry`)
328
+ export const PlaneGeometry = sceneComponent<{
329
+ args?: ConstructorParameters<typeof THREE.PlaneGeometry>
330
+ ref?: (node: THREE.PlaneGeometry | null) => void
331
+ }>(`PlaneGeometry`)
332
+ export const MeshStandardMaterial = sceneComponent<
333
+ THREE.MeshStandardMaterialParameters &
334
+ CapabilityAttributes<`three`> & {
335
+ ref?: (node: THREE.MeshStandardMaterial | null) => void
336
+ }
337
+ >(`MeshStandardMaterial`)
338
+ export const MeshBasicMaterial = sceneComponent<
339
+ THREE.MeshBasicMaterialParameters &
340
+ CapabilityAttributes<`three`> & {
341
+ ref?: (node: THREE.MeshBasicMaterial | null) => void
342
+ }
343
+ >(`MeshBasicMaterial`)
344
+ export const MeshNormalMaterial = sceneComponent<
345
+ THREE.MeshNormalMaterialParameters &
346
+ CapabilityAttributes<`three`> & {
347
+ ref?: (node: THREE.MeshNormalMaterial | null) => void
348
+ }
349
+ >(`MeshNormalMaterial`)
350
+ export { renderer as threeRenderer }
@@ -1 +0,0 @@
1
- {"version":3,"file":"astro-shared-DkZaqX7L.d.ts","names":[],"sources":["../src/astro-shared.ts"],"mappings":";;UAMiB;;WAEP;WACA,QAAQ;EACjB,UAAU;;EAEV,IAAI,GAAG,cAAc,kBAAkB,IAAI;;UAE3B;;EAEhB,aAAa;;EAEb,SAAS;;EAET,QAAQ;;EAER,UAAU;;KAEC,kBAAkB,IAAI,wBACjC,OAAO,GACP,SAAS,sBACL,YAAY,QAAQ;KACb,sBAAsB,IAAI,wBACrC,OAAO,WACP,OAAO,GACP,SAAS,6BACE;KACA,OAAO,WAAW,UAAU;EACvC;;EAEA;EACA,cAAc,kBAAkB;EAChC,eAAe,sBAAsB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"core-BhiA9fFi.d.ts","names":[],"sources":["../src/core.ts"],"mappings":";;;KAgCY;UAGK,SAAS;MACrB;;KAGO,UAAU,YAAY,OAAO,MAAM;UAC9B;EAChB,eAAe;EACf,OAAO;;KAEI,QACT,yEAOS,UACT,SAAS;UACK;EAChB,QAAQ;EACR;EACA,WAAW;;;iBA8HI,YAAY;iBAGZ,UAAU,SAAS;iBAGnB,QAAQ,KAAK;iBASb;;iBAuDA,SAAS,GAAG,WAC3B,OAAO,cAAc,QAAQ,KAC3B,SAAS,OAAO,IAAI;iBACP,SAAS,GAAG,UAAU,WAAW,WAChD,QAAQ,oBAAoB,GAAG,GAAG,IAClC,KAAK,QAAQ,KACX,SAAS,OAAO,IAAI;iBAYP,UAAU,GACzB,OAAO,cAAc,gBAClB,OAAO,IAAI,OAAO;iBACN,UAAU,GAAG,UAAU,WACtC,QAAQ,oBAAoB,GAAG,SAC/B,KAAK,QAAQ,MACV,OAAO,IAAI,OAAO;iBAQN,eAAe,cAAc,qBAC5C,OAAO,iBAAiB,SAClB,MAAM,WAAW,OAAO,WAAW;iBAK1B,OAAO,UAAU,SAChC,OAAO,iBAAiB,aACrB,SAAS;iBACG,OAAO,UAAU,SAAS,UAAU,WACnD,QAAQ,uBAAuB,UAAU,IACzC,KAAK,QAAQ,MACV,SAAS;UAuBI;EAChB;EACA;EACA;EACA;EACA;EACA,kBAAkB;EAClB,kBAAkB;;iBAEH,YAAY,UAAU,oBACrC,OAAO,cAAc,KACnB,SAAS;iBACI,YAAY,UAAU,WAAW,UAAU,oBAC1D,QAAQ,oBAAoB,GAAG,IAC/B,KAAK,QAAQ,KACX,SAAS"}