@atom.io/spa 0.0.1 → 0.0.3

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 (124) hide show
  1. package/README.md +254 -6
  2. package/README.mdx +83 -1
  3. package/dist/astro-application.d.ts +1 -1
  4. package/dist/astro-application.js +2 -2
  5. package/dist/astro-application.js.map +1 -1
  6. package/dist/astro-client.d.ts +1 -1
  7. package/dist/astro-client.js +6 -3
  8. package/dist/astro-client.js.map +1 -1
  9. package/dist/astro-server.js +2 -1
  10. package/dist/astro-server.js.map +1 -1
  11. package/dist/astro-shared-BT45auwR.js.map +1 -1
  12. package/dist/{astro-shared-DkZaqX7L.d.ts → astro-shared-BkWvVZWZ.d.ts} +4 -2
  13. package/dist/astro-shared-BkWvVZWZ.d.ts.map +1 -0
  14. package/dist/astro.d.ts +1 -1
  15. package/dist/astro.js +1 -1
  16. package/dist/capabilities-BkQ2i0vV.js +63 -0
  17. package/dist/capabilities-BkQ2i0vV.js.map +1 -0
  18. package/dist/capabilities-CFP-HIuY.d.ts +115 -0
  19. package/dist/capabilities-CFP-HIuY.d.ts.map +1 -0
  20. package/dist/client.min.js +1 -1
  21. package/dist/{core-Dvqm7w2y.js → core-DCmqLZQP.js} +23 -4
  22. package/dist/core-DCmqLZQP.js.map +1 -0
  23. package/dist/development/astro-application.js +2 -2
  24. package/dist/development/astro-application.js.map +1 -1
  25. package/dist/development/astro-client.js +6 -3
  26. package/dist/development/astro-client.js.map +1 -1
  27. package/dist/development/astro-server.js +2 -1
  28. package/dist/development/astro-server.js.map +1 -1
  29. package/dist/development/astro-shared-BT45auwR.js.map +1 -1
  30. package/dist/development/astro.js +1 -1
  31. package/dist/development/capabilities-BkQ2i0vV.js +63 -0
  32. package/dist/development/capabilities-BkQ2i0vV.js.map +1 -0
  33. package/dist/development/{core-DB3sQz4h.js → core-p9vciX9C.js} +23 -4
  34. package/dist/development/core-p9vciX9C.js.map +1 -0
  35. package/dist/development/{dom-D9cY6l1R.js → dom-Ci1XvbVJ.js} +21 -7
  36. package/dist/development/dom-Ci1XvbVJ.js.map +1 -0
  37. package/dist/development/index.js +3 -38
  38. package/dist/development/jsx-runtime.js.map +1 -1
  39. package/dist/development/konva.js +143 -0
  40. package/dist/development/konva.js.map +1 -0
  41. package/dist/development/motion.js +601 -0
  42. package/dist/development/motion.js.map +1 -0
  43. package/dist/development/renderer.js +190 -0
  44. package/dist/development/renderer.js.map +1 -0
  45. package/dist/development/server.js +4 -2
  46. package/dist/development/server.js.map +1 -1
  47. package/dist/development/src-DG0xjuS5.js +38 -0
  48. package/dist/development/src-DG0xjuS5.js.map +1 -0
  49. package/dist/development/three.js +452 -0
  50. package/dist/development/three.js.map +1 -0
  51. package/dist/development/vite-CSHoxzXU.js +240 -0
  52. package/dist/development/vite-CSHoxzXU.js.map +1 -0
  53. package/dist/development/vite.js +1 -1
  54. package/dist/{dom-BR9o9wZW.js → dom-dHQM0O7Q.js} +21 -7
  55. package/dist/dom-dHQM0O7Q.js.map +1 -0
  56. package/dist/index-CJJXcKaw.d.ts +24 -0
  57. package/dist/index-CJJXcKaw.d.ts.map +1 -0
  58. package/dist/index.d.ts +4 -24
  59. package/dist/index.js +3 -38
  60. package/dist/{jsx-runtime-BzGV18VO.d.ts → jsx-runtime-CREZYKDC.d.ts} +6 -4
  61. package/dist/jsx-runtime-CREZYKDC.d.ts.map +1 -0
  62. package/dist/jsx-runtime.d.ts +2 -2
  63. package/dist/jsx-runtime.js.map +1 -1
  64. package/dist/konva.d.ts +32 -0
  65. package/dist/konva.d.ts.map +1 -0
  66. package/dist/konva.js +143 -0
  67. package/dist/konva.js.map +1 -0
  68. package/dist/motion.d.ts +45 -0
  69. package/dist/motion.d.ts.map +1 -0
  70. package/dist/motion.js +601 -0
  71. package/dist/motion.js.map +1 -0
  72. package/dist/renderer.d.ts +24 -0
  73. package/dist/renderer.d.ts.map +1 -0
  74. package/dist/renderer.js +190 -0
  75. package/dist/renderer.js.map +1 -0
  76. package/dist/server.d.ts +1 -1
  77. package/dist/server.d.ts.map +1 -1
  78. package/dist/server.js +4 -2
  79. package/dist/server.js.map +1 -1
  80. package/dist/size.json +16 -16
  81. package/dist/src-DCQa6qxs.js +38 -0
  82. package/dist/src-DCQa6qxs.js.map +1 -0
  83. package/dist/three.d.ts +110 -0
  84. package/dist/three.d.ts.map +1 -0
  85. package/dist/three.js +452 -0
  86. package/dist/three.js.map +1 -0
  87. package/dist/vite-CSHoxzXU.js +240 -0
  88. package/dist/vite-CSHoxzXU.js.map +1 -0
  89. package/dist/vite.js +1 -1
  90. package/package.json +62 -15
  91. package/src/astro-application.ts +2 -2
  92. package/src/astro-client.ts +1 -0
  93. package/src/astro-server.ts +1 -0
  94. package/src/astro-shared.ts +3 -0
  95. package/src/capabilities.ts +107 -0
  96. package/src/compiler.ts +251 -178
  97. package/src/core.ts +38 -2
  98. package/src/dom.ts +38 -4
  99. package/src/index.ts +5 -0
  100. package/src/jsx-runtime.ts +4 -0
  101. package/src/jsx-types.d.ts +3 -1
  102. package/src/konva.ts +186 -0
  103. package/src/motion-tween.ts +106 -0
  104. package/src/motion.ts +519 -0
  105. package/src/presence.ts +324 -0
  106. package/src/renderer.ts +278 -0
  107. package/src/server.ts +3 -0
  108. package/src/three-events.ts +342 -0
  109. package/src/three.ts +373 -0
  110. package/dist/astro-shared-DkZaqX7L.d.ts.map +0 -1
  111. package/dist/core-BhiA9fFi.d.ts +0 -44
  112. package/dist/core-BhiA9fFi.d.ts.map +0 -1
  113. package/dist/core-Dvqm7w2y.js.map +0 -1
  114. package/dist/development/core-DB3sQz4h.js.map +0 -1
  115. package/dist/development/dom-D9cY6l1R.js.map +0 -1
  116. package/dist/development/index.js.map +0 -1
  117. package/dist/development/vite-CQchIQ_-.js +0 -126
  118. package/dist/development/vite-CQchIQ_-.js.map +0 -1
  119. package/dist/dom-BR9o9wZW.js.map +0 -1
  120. package/dist/index.d.ts.map +0 -1
  121. package/dist/index.js.map +0 -1
  122. package/dist/jsx-runtime-BzGV18VO.d.ts.map +0 -1
  123. package/dist/vite-CQchIQ_-.js +0 -126
  124. package/dist/vite-CQchIQ_-.js.map +0 -1
package/src/konva.ts ADDED
@@ -0,0 +1,186 @@
1
+ import Konva from "konva"
2
+
3
+ import { capabilityProps } from "./capabilities.ts"
4
+ import { owner } from "./core.ts"
5
+ import type { Child, VNode } from "./index.ts"
6
+ import { onCleanup, onMount } from "./index.ts"
7
+ import type { CapabilityAttributes } from "./jsx-runtime.ts"
8
+ import { jsx } from "./jsx-runtime.ts"
9
+ import { bindScene, createSceneRenderer, sceneComponent } from "./renderer.ts"
10
+
11
+ type Props<C, N> = C &
12
+ CapabilityAttributes<`konva`> & {
13
+ children?: Child
14
+ ref?: (node: N | null) => void
15
+ onClick?: (event: Konva.KonvaEventObject<MouseEvent>) => void
16
+ onPointerDown?: (event: Konva.KonvaEventObject<PointerEvent>) => void
17
+ onDragMove?: (event: Konva.KonvaEventObject<DragEvent>) => void
18
+ onDragEnd?: (event: Konva.KonvaEventObject<DragEvent>) => void
19
+ }
20
+ const constructors = {
21
+ Layer: Konva.Layer,
22
+ Group: Konva.Group,
23
+ Rect: Konva.Rect,
24
+ Circle: Konva.Circle,
25
+ Ellipse: Konva.Ellipse,
26
+ Line: Konva.Line,
27
+ Text: Konva.Text,
28
+ Image: Konva.Image,
29
+ Path: Konva.Path,
30
+ Star: Konva.Star,
31
+ Transformer: Konva.Transformer,
32
+ }
33
+ function suspendNode(node: Konva.Node): () => void {
34
+ const listening = node.listening()
35
+ const draggable = node.draggable()
36
+ node.listening(false)
37
+ // The public setter clears both pending and active native drag records.
38
+ node.draggable(false)
39
+ return () => {
40
+ node.listening(listening)
41
+ node.draggable(draggable)
42
+ }
43
+ }
44
+ function updateNode(
45
+ node: Konva.Node,
46
+ props: Record<string, any>,
47
+ previous: Record<string, any>,
48
+ ): void {
49
+ for (const key of new Set([...Object.keys(previous), ...Object.keys(props)])) {
50
+ if (/^(key|children|ref)$/.test(key) || Object.is(props[key], previous[key]))
51
+ continue
52
+ if (key.startsWith(`on`)) {
53
+ const event = key.slice(2).toLowerCase()
54
+ if (previous[key]) node.off(event, previous[key])
55
+ if (props[key]) node.on(event, props[key])
56
+ } else node.setAttr(key, props[key])
57
+ }
58
+ }
59
+ const renderer = createSceneRenderer<Konva.Node>({
60
+ target(node) {
61
+ return {
62
+ kind: `konva`,
63
+ node,
64
+ suspend() {
65
+ return suspendNode(node)
66
+ },
67
+ read: (key) => node.getAttr(key),
68
+ write: (key, value) => {
69
+ node.setAttr(key, value)
70
+ },
71
+ listen(event, listener) {
72
+ node.on(event, listener)
73
+ return () => {
74
+ node.off(event, listener)
75
+ }
76
+ },
77
+ }
78
+ },
79
+ create(type) {
80
+ const Constructor = constructors[type as keyof typeof constructors]
81
+ if (!Constructor) throw new Error(`spa/konva: unknown node ${type}`)
82
+ return new Constructor({} as any)
83
+ },
84
+ update: updateNode,
85
+ children(parent, children) {
86
+ if (children.length && !(parent instanceof Konva.Container))
87
+ throw new Error(`spa/konva: shapes cannot contain children`)
88
+ if (parent instanceof Konva.Container) {
89
+ for (const child of [...parent.getChildren()])
90
+ if (!children.includes(child)) child.remove()
91
+ children.forEach((child, index) => {
92
+ if (child.getParent() !== parent) parent.add(child as any)
93
+ child.zIndex(index)
94
+ })
95
+ }
96
+ },
97
+ destroy(node) {
98
+ node.off()
99
+ node.destroy()
100
+ },
101
+ })
102
+
103
+ /** A DOM boundary owning a Konva stage and its scene subtree. */
104
+ export function Stage(
105
+ props: Props<Omit<Konva.StageConfig, `container`>, Konva.Stage> & {
106
+ width?: number
107
+ height?: number
108
+ },
109
+ ): VNode {
110
+ let container: HTMLDivElement | null = null
111
+ onMount(() => {
112
+ // Konva clears its container; preserve SPA's markers in the outer element.
113
+ const surface = container!.ownerDocument.createElement(`div`)
114
+ container!.append(surface)
115
+ onCleanup(() => {
116
+ surface.remove()
117
+ })
118
+ const stage = new Konva.Stage({
119
+ container: surface,
120
+ width: props.width ?? 300,
121
+ height: props.height ?? 150,
122
+ })
123
+ onCleanup(() => {
124
+ stage.off()
125
+ stage.destroy()
126
+ })
127
+ const nativeProps = capabilityProps(
128
+ owner!,
129
+ {
130
+ kind: `konva`,
131
+ node: stage,
132
+ suspend() {
133
+ return suspendNode(stage)
134
+ },
135
+ listen(event, listener) {
136
+ stage.on(event, listener)
137
+ return () => {
138
+ stage.off(event, listener)
139
+ }
140
+ },
141
+ read: (key) => stage.getAttr(key),
142
+ write: (key, value) => {
143
+ stage.setAttr(key, value)
144
+ },
145
+ },
146
+ () => ({ ...props }),
147
+ )
148
+ let previous: Record<string, any> = {}
149
+ bindScene(
150
+ () => ({ ...props }),
151
+ (all) => {
152
+ const next = nativeProps(all)
153
+ updateNode(stage, next, previous)
154
+ previous = next
155
+ },
156
+ )
157
+ props.ref?.(stage)
158
+ onCleanup(() => props.ref?.(null))
159
+ renderer.mount(() => props.children, stage)
160
+ })
161
+ return jsx(`div`, {
162
+ ref: (element: HTMLDivElement | null) => {
163
+ container = element
164
+ },
165
+ })
166
+ }
167
+ export const Layer =
168
+ sceneComponent<Props<Konva.LayerConfig, Konva.Layer>>(`Layer`)
169
+ export const Group =
170
+ sceneComponent<Props<Konva.ContainerConfig, Konva.Group>>(`Group`)
171
+ export const Rect = sceneComponent<Props<Konva.RectConfig, Konva.Rect>>(`Rect`)
172
+ export const Circle =
173
+ sceneComponent<Props<Konva.CircleConfig, Konva.Circle>>(`Circle`)
174
+ export const Ellipse =
175
+ sceneComponent<Props<Konva.EllipseConfig, Konva.Ellipse>>(`Ellipse`)
176
+ export const Line = sceneComponent<Props<Konva.LineConfig, Konva.Line>>(`Line`)
177
+ export const Text = sceneComponent<Props<Konva.TextConfig, Konva.Text>>(`Text`)
178
+ export const Image =
179
+ sceneComponent<Props<Konva.ImageConfig, Konva.Image>>(`Image`)
180
+ export const Path = sceneComponent<Props<Konva.PathConfig, Konva.Path>>(`Path`)
181
+ export const Star = sceneComponent<Props<Konva.StarConfig, Konva.Star>>(`Star`)
182
+ export const Transformer =
183
+ sceneComponent<Props<Konva.TransformerConfig, Konva.Transformer>>(
184
+ `Transformer`,
185
+ )
186
+ export { renderer as konvaRenderer }
@@ -0,0 +1,106 @@
1
+ import type { MotionValue, ValueAnimationTransition } from "motion"
2
+ import { animate, keyframes } from "motion"
3
+
4
+ import type { MotionScalar } from "./motion.ts"
5
+
6
+ const trajectories = new WeakMap<
7
+ MotionValue<MotionScalar>,
8
+ () => { position: number; velocity: number }
9
+ >()
10
+ const scalar = /^(-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)([a-z%]*)$/i
11
+ const brake = (progress: number) => progress * (2 - progress)
12
+ const returnToTarget = (progress: number) =>
13
+ progress * progress * (3 - 2 * progress)
14
+
15
+ /** Retarget a moving tween without changing its position or velocity at the join. */
16
+ export function animateTween(
17
+ value: MotionValue<MotionScalar>,
18
+ goal: MotionScalar,
19
+ transition: ValueAnimationTransition,
20
+ interrupted: boolean,
21
+ ): ReturnType<typeof animate> {
22
+ if (interrupted) value.stop()
23
+ const current = value.get()
24
+ const from =
25
+ typeof current === `number` ? [``, current, ``] : scalar.exec(current)
26
+ const to = typeof goal === `number` ? [``, goal, ``] : scalar.exec(goal)
27
+ const previous = trajectories.get(value)?.()
28
+ const velocity =
29
+ previous && from && Math.abs(previous.position - Number(from[1])) < 0.001
30
+ ? previous.velocity
31
+ : value.getVelocity()
32
+ trajectories.delete(value)
33
+ const duration = transition.duration ?? 0.3
34
+ // A duration/ease without an explicit type is also a Motion tween. Springs keep
35
+ // Motion's own velocity-aware integration; discrete values keep native mixing.
36
+ const tween =
37
+ transition.type === `tween` ||
38
+ (transition.type === undefined &&
39
+ (transition.duration !== undefined || transition.ease !== undefined))
40
+ const moving =
41
+ interrupted &&
42
+ tween &&
43
+ from &&
44
+ to &&
45
+ from[2] === to[2] &&
46
+ Number.isFinite(velocity) &&
47
+ velocity !== 0 &&
48
+ duration > 0
49
+ const braking = 0.2
50
+ const turn = from ? Number(from[1]) + (velocity * duration * braking) / 2 : 0
51
+ const waypoint = typeof current === `number` ? turn : `${turn}${from?.[2]}`
52
+ const frames = moving ? [current, waypoint, goal] : [current, goal]
53
+ // Constant deceleration: dx/dt at t=0 is v, and at the waypoint is zero.
54
+ // The return starts and ends at rest. Keyframes also handle goal === current.
55
+ const next = moving
56
+ ? {
57
+ ...transition,
58
+ type: `tween` as const,
59
+ duration,
60
+ delay: 0,
61
+ times: [0, braking, 1],
62
+ ease: [brake, returnToTarget],
63
+ }
64
+ : transition
65
+ // Values are already resolved. Synchronous numeric tweens also keep cancelled,
66
+ // not-yet-started resolver work from being revived by a timeline read.
67
+ const controls = animate(
68
+ value,
69
+ frames,
70
+ tween && (moving || current !== goal) ? { ...next, isSync: true } : next,
71
+ )
72
+ if (
73
+ tween &&
74
+ (moving || current !== goal) &&
75
+ from &&
76
+ to &&
77
+ from[2] === to[2] &&
78
+ duration > 0
79
+ ) {
80
+ const curve = keyframes({
81
+ keyframes: moving
82
+ ? [Number(from[1]), turn, Number(to[1])]
83
+ : [Number(from[1]), Number(to[1])],
84
+ duration: duration * 1000,
85
+ times: moving ? [0, braking, 1] : [0, 1],
86
+ ease: next.ease ?? `easeOut`,
87
+ })
88
+ const sample = (at: number) => curve.next(at * 1000).value
89
+
90
+ // Use the tween's own timeline. Frame-estimated MotionValue velocity becomes
91
+ // noisy when stop/resume happen several times within the same render frame.
92
+ trajectories.set(value, () => {
93
+ const at = Math.max(0, Math.min(duration, controls.time))
94
+ const before = Math.max(0, at - 0.0001),
95
+ after = Math.min(duration, at + 0.0001)
96
+ return {
97
+ position: sample(at),
98
+ velocity:
99
+ at <= 0 || at >= duration
100
+ ? 0
101
+ : (sample(after) - sample(before)) / (after - before),
102
+ }
103
+ })
104
+ }
105
+ return controls
106
+ }