@motionscript/core 0.1.0-alpha.6 → 0.1.0-alpha.8

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 (804) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/NOTICE +15 -14
  3. package/README.md +5 -7
  4. package/dist/assets/errors.js +4 -5
  5. package/dist/assets/errors.js.map +1 -1
  6. package/dist/assets/manager.d.ts.map +1 -1
  7. package/dist/assets/manager.js +7 -5
  8. package/dist/assets/manager.js.map +1 -1
  9. package/dist/assets/scope.d.ts +1 -1
  10. package/dist/assets/scope.d.ts.map +1 -1
  11. package/dist/assets/scope.js +1 -1
  12. package/dist/assets/scope.js.map +1 -1
  13. package/dist/attributes/audio/effects/chain.d.ts +73 -0
  14. package/dist/attributes/audio/effects/chain.d.ts.map +1 -0
  15. package/dist/attributes/audio/effects/chain.js +67 -0
  16. package/dist/attributes/audio/effects/chain.js.map +1 -0
  17. package/dist/attributes/audio/effects/implementations/echo.d.ts +14 -0
  18. package/dist/attributes/audio/effects/implementations/echo.d.ts.map +1 -0
  19. package/dist/attributes/audio/effects/implementations/echo.js +11 -0
  20. package/dist/attributes/audio/effects/implementations/echo.js.map +1 -0
  21. package/dist/attributes/audio/effects/implementations/gain.d.ts +10 -0
  22. package/dist/attributes/audio/effects/implementations/gain.d.ts.map +1 -0
  23. package/dist/attributes/audio/effects/implementations/gain.js +6 -0
  24. package/dist/attributes/audio/effects/implementations/gain.js.map +1 -0
  25. package/dist/attributes/audio/effects/implementations/highpass.d.ts +12 -0
  26. package/dist/attributes/audio/effects/implementations/highpass.d.ts.map +1 -0
  27. package/dist/attributes/audio/effects/implementations/highpass.js +10 -0
  28. package/dist/attributes/audio/effects/implementations/highpass.js.map +1 -0
  29. package/dist/attributes/audio/effects/implementations/lowpass.d.ts +12 -0
  30. package/dist/attributes/audio/effects/implementations/lowpass.d.ts.map +1 -0
  31. package/dist/attributes/audio/effects/implementations/lowpass.js +10 -0
  32. package/dist/attributes/audio/effects/implementations/lowpass.js.map +1 -0
  33. package/dist/attributes/audio/effects/implementations/tremolo.d.ts +12 -0
  34. package/dist/attributes/audio/effects/implementations/tremolo.d.ts.map +1 -0
  35. package/dist/attributes/audio/effects/implementations/tremolo.js +10 -0
  36. package/dist/attributes/audio/effects/implementations/tremolo.js.map +1 -0
  37. package/dist/attributes/audio/effects/index.d.ts +12 -0
  38. package/dist/attributes/audio/effects/index.d.ts.map +1 -0
  39. package/dist/attributes/audio/effects/index.js +4 -0
  40. package/dist/attributes/audio/effects/index.js.map +1 -0
  41. package/dist/attributes/audio/effects/registry.d.ts +36 -0
  42. package/dist/attributes/audio/effects/registry.d.ts.map +1 -0
  43. package/dist/attributes/audio/effects/registry.js +80 -0
  44. package/dist/attributes/audio/effects/registry.js.map +1 -0
  45. package/dist/attributes/audio/effects/union.d.ts +14 -0
  46. package/dist/attributes/audio/effects/union.d.ts.map +1 -0
  47. package/dist/attributes/audio/effects/union.js +24 -0
  48. package/dist/attributes/audio/effects/union.js.map +1 -0
  49. package/dist/attributes/audio/ramp.d.ts +103 -0
  50. package/dist/attributes/audio/ramp.d.ts.map +1 -0
  51. package/dist/attributes/audio/ramp.js +246 -0
  52. package/dist/attributes/audio/ramp.js.map +1 -0
  53. package/dist/attributes/audio/request.d.ts +24 -13
  54. package/dist/attributes/audio/request.d.ts.map +1 -1
  55. package/dist/attributes/audio/request.js +4 -3
  56. package/dist/attributes/audio/request.js.map +1 -1
  57. package/dist/attributes/audio/schedule.d.ts +24 -31
  58. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  59. package/dist/attributes/audio/schedule.js +42 -28
  60. package/dist/attributes/audio/schedule.js.map +1 -1
  61. package/dist/attributes/audio/sound.d.ts +15 -12
  62. package/dist/attributes/audio/sound.d.ts.map +1 -1
  63. package/dist/attributes/audio/sound.js +8 -10
  64. package/dist/attributes/audio/sound.js.map +1 -1
  65. package/dist/attributes/audio/transition.d.ts +33 -0
  66. package/dist/attributes/audio/transition.d.ts.map +1 -0
  67. package/dist/attributes/audio/transition.js +48 -0
  68. package/dist/attributes/audio/transition.js.map +1 -0
  69. package/dist/attributes/index.d.ts +7 -8
  70. package/dist/attributes/index.d.ts.map +1 -1
  71. package/dist/attributes/index.js +6 -9
  72. package/dist/attributes/index.js.map +1 -1
  73. package/dist/attributes/layout/insets.d.ts +1 -1
  74. package/dist/attributes/layout/insets.js.map +1 -1
  75. package/dist/attributes/layout/matrix2d.d.ts +2 -2
  76. package/dist/attributes/layout/matrix2d.js.map +1 -1
  77. package/dist/attributes/layout/size.d.ts +1 -1
  78. package/dist/attributes/layout/size.js +1 -1
  79. package/dist/attributes/layout/size.js.map +1 -1
  80. package/dist/attributes/layout/space3d.js +1 -1
  81. package/dist/attributes/layout/space3d.js.map +1 -1
  82. package/dist/attributes/properties/decorator.d.ts +44 -11
  83. package/dist/attributes/properties/decorator.d.ts.map +1 -1
  84. package/dist/attributes/properties/decorator.js +37 -9
  85. package/dist/attributes/properties/decorator.js.map +1 -1
  86. package/dist/attributes/properties/inputs.d.ts +1 -1
  87. package/dist/attributes/properties/inputs.js +1 -1
  88. package/dist/attributes/properties/inputs.js.map +1 -1
  89. package/dist/attributes/properties/typed.d.ts +24 -145
  90. package/dist/attributes/properties/typed.d.ts.map +1 -1
  91. package/dist/attributes/properties/typed.js +16 -112
  92. package/dist/attributes/properties/typed.js.map +1 -1
  93. package/dist/attributes/shape/corners/corner-radius.d.ts +2 -3
  94. package/dist/attributes/shape/corners/corner-radius.d.ts.map +1 -1
  95. package/dist/attributes/shape/corners/corner-radius.js +2 -3
  96. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  97. package/dist/attributes/shape/effects/chain.d.ts +96 -409
  98. package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
  99. package/dist/attributes/shape/effects/chain.js +93 -283
  100. package/dist/attributes/shape/effects/chain.js.map +1 -1
  101. package/dist/attributes/shape/effects/effect-data.d.ts +1 -1
  102. package/dist/attributes/shape/effects/effect-data.js.map +1 -1
  103. package/dist/attributes/shape/effects/implementations/ascii.d.ts +45 -13
  104. package/dist/attributes/shape/effects/implementations/ascii.d.ts.map +1 -1
  105. package/dist/attributes/shape/effects/implementations/ascii.js +29 -23
  106. package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
  107. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts +32 -7
  108. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts.map +1 -1
  109. package/dist/attributes/shape/effects/implementations/bit-crush.js +17 -15
  110. package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
  111. package/dist/attributes/shape/effects/implementations/block-displace.d.ts +46 -10
  112. package/dist/attributes/shape/effects/implementations/block-displace.d.ts.map +1 -1
  113. package/dist/attributes/shape/effects/implementations/block-displace.js +21 -19
  114. package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
  115. package/dist/attributes/shape/effects/implementations/bloom.d.ts +32 -7
  116. package/dist/attributes/shape/effects/implementations/bloom.d.ts.map +1 -1
  117. package/dist/attributes/shape/effects/implementations/bloom.js +17 -11
  118. package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
  119. package/dist/attributes/shape/effects/implementations/blur.d.ts +16 -3
  120. package/dist/attributes/shape/effects/implementations/blur.d.ts.map +1 -1
  121. package/dist/attributes/shape/effects/implementations/blur.js +13 -5
  122. package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
  123. package/dist/attributes/shape/effects/implementations/bulge.d.ts +28 -9
  124. package/dist/attributes/shape/effects/implementations/bulge.d.ts.map +1 -1
  125. package/dist/attributes/shape/effects/implementations/bulge.js +15 -14
  126. package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
  127. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts +21 -5
  128. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts.map +1 -1
  129. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js +15 -10
  130. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
  131. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +96 -26
  132. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts.map +1 -1
  133. package/dist/attributes/shape/effects/implementations/color-adjustment.js +29 -26
  134. package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
  135. package/dist/attributes/shape/effects/implementations/curves.d.ts +20 -6
  136. package/dist/attributes/shape/effects/implementations/curves.d.ts.map +1 -1
  137. package/dist/attributes/shape/effects/implementations/curves.js +26 -23
  138. package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
  139. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts +26 -5
  140. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts.map +1 -1
  141. package/dist/attributes/shape/effects/implementations/directional-blur.js +15 -10
  142. package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
  143. package/dist/attributes/shape/effects/implementations/dither.d.ts +58 -11
  144. package/dist/attributes/shape/effects/implementations/dither.d.ts.map +1 -1
  145. package/dist/attributes/shape/effects/implementations/dither.js +26 -20
  146. package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
  147. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts +47 -15
  148. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts.map +1 -1
  149. package/dist/attributes/shape/effects/implementations/drop-shadow.js +24 -29
  150. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  151. package/dist/attributes/shape/effects/implementations/duotone.d.ts +26 -7
  152. package/dist/attributes/shape/effects/implementations/duotone.d.ts.map +1 -1
  153. package/dist/attributes/shape/effects/implementations/duotone.js +17 -16
  154. package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
  155. package/dist/attributes/shape/effects/implementations/edges.d.ts +29 -7
  156. package/dist/attributes/shape/effects/implementations/edges.d.ts.map +1 -1
  157. package/dist/attributes/shape/effects/implementations/edges.js +17 -14
  158. package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
  159. package/dist/attributes/shape/effects/implementations/glass.d.ts +76 -19
  160. package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
  161. package/dist/attributes/shape/effects/implementations/glass.js +28 -22
  162. package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
  163. package/dist/attributes/shape/effects/implementations/glow.d.ts +149 -42
  164. package/dist/attributes/shape/effects/implementations/glow.d.ts.map +1 -1
  165. package/dist/attributes/shape/effects/implementations/glow.js +74 -72
  166. package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
  167. package/dist/attributes/shape/effects/implementations/grain.d.ts +43 -11
  168. package/dist/attributes/shape/effects/implementations/grain.d.ts.map +1 -1
  169. package/dist/attributes/shape/effects/implementations/grain.js +21 -18
  170. package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
  171. package/dist/attributes/shape/effects/implementations/grayscale.d.ts +17 -3
  172. package/dist/attributes/shape/effects/implementations/grayscale.d.ts.map +1 -1
  173. package/dist/attributes/shape/effects/implementations/grayscale.js +13 -5
  174. package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
  175. package/dist/attributes/shape/effects/implementations/halftone.d.ts +40 -9
  176. package/dist/attributes/shape/effects/implementations/halftone.d.ts.map +1 -1
  177. package/dist/attributes/shape/effects/implementations/halftone.js +20 -16
  178. package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
  179. package/dist/attributes/shape/effects/implementations/invert.d.ts +23 -5
  180. package/dist/attributes/shape/effects/implementations/invert.d.ts.map +1 -1
  181. package/dist/attributes/shape/effects/implementations/invert.js +15 -10
  182. package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
  183. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts +57 -18
  184. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts.map +1 -1
  185. package/dist/attributes/shape/effects/implementations/kaleidoscope.js +25 -22
  186. package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
  187. package/dist/attributes/shape/effects/implementations/lut.d.ts +34 -7
  188. package/dist/attributes/shape/effects/implementations/lut.d.ts.map +1 -1
  189. package/dist/attributes/shape/effects/implementations/lut.js +20 -16
  190. package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
  191. package/dist/attributes/shape/effects/implementations/magnify.d.ts +27 -9
  192. package/dist/attributes/shape/effects/implementations/magnify.d.ts.map +1 -1
  193. package/dist/attributes/shape/effects/implementations/magnify.js +17 -14
  194. package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
  195. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts +54 -19
  196. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts.map +1 -1
  197. package/dist/attributes/shape/effects/implementations/motion-blur.js +42 -20
  198. package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
  199. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts +17 -3
  200. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts.map +1 -1
  201. package/dist/attributes/shape/effects/implementations/oil-paint.js +13 -9
  202. package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
  203. package/dist/attributes/shape/effects/implementations/outline.d.ts +28 -8
  204. package/dist/attributes/shape/effects/implementations/outline.d.ts.map +1 -1
  205. package/dist/attributes/shape/effects/implementations/outline.js +18 -17
  206. package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
  207. package/dist/attributes/shape/effects/implementations/pixelate.d.ts +25 -6
  208. package/dist/attributes/shape/effects/implementations/pixelate.d.ts.map +1 -1
  209. package/dist/attributes/shape/effects/implementations/pixelate.js +16 -14
  210. package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
  211. package/dist/attributes/shape/effects/implementations/posterize.d.ts +14 -3
  212. package/dist/attributes/shape/effects/implementations/posterize.d.ts.map +1 -1
  213. package/dist/attributes/shape/effects/implementations/posterize.js +13 -9
  214. package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
  215. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts +91 -26
  216. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts.map +1 -1
  217. package/dist/attributes/shape/effects/implementations/progressive-blur.js +27 -28
  218. package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
  219. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts +49 -10
  220. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts.map +1 -1
  221. package/dist/attributes/shape/effects/implementations/radial-blur.js +19 -20
  222. package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
  223. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts +36 -6
  224. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts.map +1 -1
  225. package/dist/attributes/shape/effects/implementations/rgb-shift.js +16 -15
  226. package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
  227. package/dist/attributes/shape/effects/implementations/scanlines.d.ts +52 -11
  228. package/dist/attributes/shape/effects/implementations/scanlines.d.ts.map +1 -1
  229. package/dist/attributes/shape/effects/implementations/scanlines.js +21 -18
  230. package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
  231. package/dist/attributes/shape/effects/implementations/scatter.d.ts +23 -9
  232. package/dist/attributes/shape/effects/implementations/scatter.d.ts.map +1 -1
  233. package/dist/attributes/shape/effects/implementations/scatter.js +15 -12
  234. package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
  235. package/dist/attributes/shape/effects/implementations/shader.d.ts +90 -34
  236. package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
  237. package/dist/attributes/shape/effects/implementations/shader.js +42 -26
  238. package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
  239. package/dist/attributes/shape/effects/implementations/sharpen.d.ts +23 -5
  240. package/dist/attributes/shape/effects/implementations/sharpen.d.ts.map +1 -1
  241. package/dist/attributes/shape/effects/implementations/sharpen.js +16 -11
  242. package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
  243. package/dist/attributes/shape/effects/implementations/streak.d.ts +40 -9
  244. package/dist/attributes/shape/effects/implementations/streak.d.ts.map +1 -1
  245. package/dist/attributes/shape/effects/implementations/streak.js +19 -16
  246. package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
  247. package/dist/attributes/shape/effects/implementations/threshold.d.ts +24 -5
  248. package/dist/attributes/shape/effects/implementations/threshold.d.ts.map +1 -1
  249. package/dist/attributes/shape/effects/implementations/threshold.js +17 -11
  250. package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
  251. package/dist/attributes/shape/effects/implementations/twirl.d.ts +35 -8
  252. package/dist/attributes/shape/effects/implementations/twirl.d.ts.map +1 -1
  253. package/dist/attributes/shape/effects/implementations/twirl.js +17 -16
  254. package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
  255. package/dist/attributes/shape/effects/implementations/vignette.d.ts +37 -7
  256. package/dist/attributes/shape/effects/implementations/vignette.d.ts.map +1 -1
  257. package/dist/attributes/shape/effects/implementations/vignette.js +19 -18
  258. package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
  259. package/dist/attributes/shape/effects/implementations/vintage.d.ts +24 -5
  260. package/dist/attributes/shape/effects/implementations/vintage.d.ts.map +1 -1
  261. package/dist/attributes/shape/effects/implementations/vintage.js +15 -10
  262. package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
  263. package/dist/attributes/shape/effects/implementations/wave.d.ts +61 -14
  264. package/dist/attributes/shape/effects/implementations/wave.d.ts.map +1 -1
  265. package/dist/attributes/shape/effects/implementations/wave.js +26 -23
  266. package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
  267. package/dist/attributes/shape/effects/index.d.ts +4 -2
  268. package/dist/attributes/shape/effects/index.d.ts.map +1 -1
  269. package/dist/attributes/shape/effects/index.js +1 -1
  270. package/dist/attributes/shape/effects/index.js.map +1 -1
  271. package/dist/attributes/shape/effects/registry.d.ts +11 -0
  272. package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
  273. package/dist/attributes/shape/effects/registry.js +113 -102
  274. package/dist/attributes/shape/effects/registry.js.map +1 -1
  275. package/dist/attributes/shape/effects/spec.d.ts +229 -0
  276. package/dist/attributes/shape/effects/spec.d.ts.map +1 -0
  277. package/dist/attributes/shape/effects/spec.js +178 -0
  278. package/dist/attributes/shape/effects/spec.js.map +1 -0
  279. package/dist/attributes/shape/fill/chain.d.ts +7 -9
  280. package/dist/attributes/shape/fill/chain.d.ts.map +1 -1
  281. package/dist/attributes/shape/fill/chain.js +9 -11
  282. package/dist/attributes/shape/fill/chain.js.map +1 -1
  283. package/dist/attributes/shape/fill/color/parser.d.ts +1 -1
  284. package/dist/attributes/shape/fill/color/parser.js +1 -1
  285. package/dist/attributes/shape/fill/color/parser.js.map +1 -1
  286. package/dist/attributes/shape/fill/implementations/canvas3d.d.ts +2 -2
  287. package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
  288. package/dist/attributes/shape/fill/implementations/shader.d.ts +28 -27
  289. package/dist/attributes/shape/fill/implementations/shader.d.ts.map +1 -1
  290. package/dist/attributes/shape/fill/implementations/shader.js +20 -14
  291. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  292. package/dist/attributes/shape/fill/implementations/video.d.ts +1 -1
  293. package/dist/attributes/shape/fill/implementations/video.js +1 -1
  294. package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
  295. package/dist/attributes/shape/fill/index.d.ts +1 -1
  296. package/dist/attributes/shape/fill/index.d.ts.map +1 -1
  297. package/dist/attributes/shape/fill/index.js.map +1 -1
  298. package/dist/attributes/shape/fill/lerp.d.ts +1 -1
  299. package/dist/attributes/shape/fill/lerp.js.map +1 -1
  300. package/dist/attributes/shape/fill/registry.d.ts +1 -2
  301. package/dist/attributes/shape/fill/registry.d.ts.map +1 -1
  302. package/dist/attributes/shape/fill/registry.js +1 -2
  303. package/dist/attributes/shape/fill/registry.js.map +1 -1
  304. package/dist/attributes/shape/filters/chain.d.ts +3 -7
  305. package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
  306. package/dist/attributes/shape/filters/chain.js +2 -6
  307. package/dist/attributes/shape/filters/chain.js.map +1 -1
  308. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts +2 -2
  309. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts.map +1 -1
  310. package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
  311. package/dist/attributes/shape/filters/registry.d.ts +1 -1
  312. package/dist/attributes/shape/filters/registry.d.ts.map +1 -1
  313. package/dist/attributes/shape/filters/registry.js +3 -3
  314. package/dist/attributes/shape/filters/registry.js.map +1 -1
  315. package/dist/attributes/shape/filters/union.d.ts +6 -6
  316. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  317. package/dist/attributes/shape/filters/union.js.map +1 -1
  318. package/dist/attributes/shape/path/ops.d.ts +1 -2
  319. package/dist/attributes/shape/path/ops.d.ts.map +1 -1
  320. package/dist/attributes/shape/path/ops.js.map +1 -1
  321. package/dist/attributes/shape/shaders/index.d.ts +2 -0
  322. package/dist/attributes/shape/shaders/index.d.ts.map +1 -1
  323. package/dist/attributes/shape/shaders/index.js +2 -0
  324. package/dist/attributes/shape/shaders/index.js.map +1 -1
  325. package/dist/attributes/shape/shaders/language.d.ts +26 -0
  326. package/dist/attributes/shape/shaders/language.d.ts.map +1 -0
  327. package/dist/attributes/shape/shaders/language.js +20 -0
  328. package/dist/attributes/shape/shaders/language.js.map +1 -0
  329. package/dist/attributes/shape/shaders/pack.d.ts +25 -11
  330. package/dist/attributes/shape/shaders/pack.d.ts.map +1 -1
  331. package/dist/attributes/shape/shaders/pack.js +9 -4
  332. package/dist/attributes/shape/shaders/pack.js.map +1 -1
  333. package/dist/attributes/shape/shaders/resolve.d.ts +4 -5
  334. package/dist/attributes/shape/shaders/resolve.d.ts.map +1 -1
  335. package/dist/attributes/shape/shaders/resolve.js +3 -6
  336. package/dist/attributes/shape/shaders/resolve.js.map +1 -1
  337. package/dist/attributes/shape/shaders/uniforms.d.ts +41 -0
  338. package/dist/attributes/shape/shaders/uniforms.d.ts.map +1 -0
  339. package/dist/attributes/shape/shaders/uniforms.js +0 -0
  340. package/dist/attributes/shape/shaders/uniforms.js.map +1 -0
  341. package/dist/attributes/shared/operators.d.ts +2 -2
  342. package/dist/attributes/shared/operators.js.map +1 -1
  343. package/dist/attributes/text/types.d.ts +2 -3
  344. package/dist/attributes/text/types.d.ts.map +1 -1
  345. package/dist/attributes/text/types.js.map +1 -1
  346. package/dist/browser/chunks/chunk-AOT33LMS.js +13 -0
  347. package/dist/browser/chunks/chunk-AOT33LMS.js.map +7 -0
  348. package/dist/browser/chunks/chunk-GKM6UZJR.js +6 -0
  349. package/dist/browser/chunks/chunk-GKM6UZJR.js.map +7 -0
  350. package/dist/browser/chunks/chunk-LKUYVFU3.js +2 -0
  351. package/dist/browser/chunks/{chunk-DHB4COFY.js.map → chunk-LKUYVFU3.js.map} +4 -4
  352. package/dist/browser/chunks/chunk-ZRPZPWZU.js +3 -0
  353. package/dist/browser/chunks/chunk-ZRPZPWZU.js.map +7 -0
  354. package/dist/browser/component.js +1 -1
  355. package/dist/browser/component.js.map +4 -4
  356. package/dist/browser/experimental.js +1 -1
  357. package/dist/browser/experimental.js.map +4 -4
  358. package/dist/browser/index.js +1 -1
  359. package/dist/browser/index.js.map +4 -4
  360. package/dist/browser/manifest.json +2 -4
  361. package/dist/browser/sdk.js +1 -1
  362. package/dist/component.d.ts +10 -18
  363. package/dist/component.d.ts.map +1 -1
  364. package/dist/component.js +10 -17
  365. package/dist/component.js.map +1 -1
  366. package/dist/components/builtins/audio/audio.d.ts +62 -0
  367. package/dist/components/builtins/audio/audio.d.ts.map +1 -0
  368. package/dist/components/builtins/audio/audio.js +38 -0
  369. package/dist/components/builtins/audio/audio.js.map +1 -0
  370. package/dist/components/builtins/geometry/composite.d.ts +93 -0
  371. package/dist/components/builtins/geometry/composite.d.ts.map +1 -0
  372. package/dist/components/builtins/geometry/composite.js +25 -0
  373. package/dist/components/builtins/geometry/composite.js.map +1 -0
  374. package/dist/components/builtins/geometry/geometry.d.ts +921 -0
  375. package/dist/components/builtins/geometry/geometry.d.ts.map +1 -0
  376. package/dist/components/builtins/geometry/geometry.js +107 -0
  377. package/dist/components/builtins/geometry/geometry.js.map +1 -0
  378. package/dist/components/builtins/geometry/shape-outline.d.ts +93 -0
  379. package/dist/components/builtins/geometry/shape-outline.d.ts.map +1 -0
  380. package/dist/components/builtins/geometry/shape-outline.js +470 -0
  381. package/dist/components/builtins/geometry/shape-outline.js.map +1 -0
  382. package/dist/components/builtins/layout/layout.d.ts +186 -0
  383. package/dist/components/builtins/layout/layout.d.ts.map +1 -0
  384. package/dist/components/builtins/layout/layout.js +84 -0
  385. package/dist/components/builtins/layout/layout.js.map +1 -0
  386. package/dist/components/builtins/media/media.d.ts +240 -0
  387. package/dist/components/builtins/media/media.d.ts.map +1 -0
  388. package/dist/components/builtins/media/media.js +143 -0
  389. package/dist/components/builtins/media/media.js.map +1 -0
  390. package/dist/components/builtins/providers/providers.d.ts +47 -0
  391. package/dist/components/builtins/providers/providers.d.ts.map +1 -0
  392. package/dist/components/builtins/providers/providers.js +30 -0
  393. package/dist/components/builtins/providers/providers.js.map +1 -0
  394. package/dist/components/builtins/text/number-format.d.ts +66 -0
  395. package/dist/components/builtins/text/number-format.d.ts.map +1 -0
  396. package/dist/components/builtins/text/number-format.js +227 -0
  397. package/dist/components/builtins/text/number-format.js.map +1 -0
  398. package/dist/components/builtins/text/number-pattern.d.ts +51 -0
  399. package/dist/components/builtins/text/number-pattern.d.ts.map +1 -0
  400. package/dist/components/builtins/text/number-pattern.js +77 -0
  401. package/dist/components/builtins/text/number-pattern.js.map +1 -0
  402. package/dist/components/builtins/text/text-defaults.d.ts +32 -0
  403. package/dist/components/builtins/text/text-defaults.d.ts.map +1 -0
  404. package/dist/components/builtins/text/text-defaults.js +37 -0
  405. package/dist/components/builtins/text/text-defaults.js.map +1 -0
  406. package/dist/components/builtins/text/text-layout.d.ts +82 -0
  407. package/dist/components/builtins/text/text-layout.d.ts.map +1 -0
  408. package/dist/components/builtins/text/text-layout.js +331 -0
  409. package/dist/components/builtins/text/text-layout.js.map +1 -0
  410. package/dist/components/builtins/text/text.d.ts +409 -0
  411. package/dist/components/builtins/text/text.d.ts.map +1 -0
  412. package/dist/components/builtins/text/text.js +116 -0
  413. package/dist/components/builtins/text/text.js.map +1 -0
  414. package/dist/components/builtins/three/canvas3d.d.ts +245 -0
  415. package/dist/components/builtins/three/canvas3d.d.ts.map +1 -0
  416. package/dist/components/builtins/three/canvas3d.js +21 -0
  417. package/dist/components/builtins/three/canvas3d.js.map +1 -0
  418. package/dist/components/builtins/three/grid-geometry3d.d.ts +62 -0
  419. package/dist/components/builtins/three/grid-geometry3d.d.ts.map +1 -0
  420. package/dist/components/builtins/three/grid-geometry3d.js +114 -0
  421. package/dist/components/builtins/three/grid-geometry3d.js.map +1 -0
  422. package/dist/components/builtins/three/three.d.ts +1889 -0
  423. package/dist/components/builtins/three/three.d.ts.map +1 -0
  424. package/dist/components/builtins/three/three.js +305 -0
  425. package/dist/components/builtins/three/three.js.map +1 -0
  426. package/dist/components/factory/api.d.ts +543 -0
  427. package/dist/components/factory/api.d.ts.map +1 -0
  428. package/dist/components/factory/api.js +4 -0
  429. package/dist/components/factory/api.js.map +1 -0
  430. package/dist/components/factory/clip-of.d.ts +5 -0
  431. package/dist/components/factory/clip-of.d.ts.map +1 -0
  432. package/dist/components/factory/clip-of.js +33 -0
  433. package/dist/components/factory/clip-of.js.map +1 -0
  434. package/dist/components/factory/commands-for.d.ts +19 -0
  435. package/dist/components/factory/commands-for.d.ts.map +1 -0
  436. package/dist/components/factory/commands-for.js +5 -0
  437. package/dist/components/factory/commands-for.js.map +1 -0
  438. package/dist/components/factory/component-audio.d.ts +9 -0
  439. package/dist/components/factory/component-audio.d.ts.map +1 -0
  440. package/dist/components/factory/component-audio.js +18 -0
  441. package/dist/components/factory/component-audio.js.map +1 -0
  442. package/dist/components/factory/component2d.d.ts +8 -0
  443. package/dist/components/factory/component2d.d.ts.map +1 -0
  444. package/dist/components/factory/component2d.js +240 -0
  445. package/dist/components/factory/component2d.js.map +1 -0
  446. package/dist/components/factory/component3d.d.ts +9 -0
  447. package/dist/components/factory/component3d.d.ts.map +1 -0
  448. package/dist/components/factory/component3d.js +107 -0
  449. package/dist/components/factory/component3d.js.map +1 -0
  450. package/dist/components/factory/factory.d.ts +66 -0
  451. package/dist/components/factory/factory.d.ts.map +1 -0
  452. package/dist/components/factory/factory.js +347 -0
  453. package/dist/components/factory/factory.js.map +1 -0
  454. package/dist/components/factory/timeline.d.ts +22 -0
  455. package/dist/components/factory/timeline.d.ts.map +1 -0
  456. package/dist/components/factory/timeline.js +128 -0
  457. package/dist/components/factory/timeline.js.map +1 -0
  458. package/dist/components/factory/type-def.d.ts +26 -0
  459. package/dist/components/factory/type-def.d.ts.map +1 -0
  460. package/dist/components/factory/type-def.js +16 -0
  461. package/dist/components/factory/type-def.js.map +1 -0
  462. package/dist/components/factory/types.d.ts +91 -0
  463. package/dist/components/factory/types.d.ts.map +1 -0
  464. package/dist/components/factory/types.js +88 -0
  465. package/dist/components/factory/types.js.map +1 -0
  466. package/dist/components/factory/views.d.ts +121 -0
  467. package/dist/components/factory/views.d.ts.map +1 -0
  468. package/dist/components/factory/views.js +413 -0
  469. package/dist/components/factory/views.js.map +1 -0
  470. package/dist/components/modules/aim.d.ts +30 -0
  471. package/dist/components/modules/aim.d.ts.map +1 -0
  472. package/dist/components/modules/aim.js +39 -0
  473. package/dist/components/modules/aim.js.map +1 -0
  474. package/dist/components/modules/corners.d.ts +13 -0
  475. package/dist/components/modules/corners.d.ts.map +1 -0
  476. package/dist/components/modules/corners.js +12 -0
  477. package/dist/components/modules/corners.js.map +1 -0
  478. package/dist/components/modules/flow.d.ts +26 -0
  479. package/dist/components/modules/flow.d.ts.map +1 -0
  480. package/dist/components/modules/flow.js +57 -0
  481. package/dist/components/modules/flow.js.map +1 -0
  482. package/dist/components/modules/material.d.ts +40 -0
  483. package/dist/components/modules/material.d.ts.map +1 -0
  484. package/dist/components/modules/material.js +75 -0
  485. package/dist/components/modules/material.js.map +1 -0
  486. package/dist/components/modules/paint.d.ts +71 -0
  487. package/dist/components/modules/paint.d.ts.map +1 -0
  488. package/dist/components/modules/paint.js +106 -0
  489. package/dist/components/modules/paint.js.map +1 -0
  490. package/dist/components/modules/shapes.d.ts +31 -0
  491. package/dist/components/modules/shapes.d.ts.map +1 -0
  492. package/dist/components/modules/shapes.js +43 -0
  493. package/dist/components/modules/shapes.js.map +1 -0
  494. package/dist/components/modules/text-layout.d.ts +26 -0
  495. package/dist/components/modules/text-layout.d.ts.map +1 -0
  496. package/dist/components/modules/text-layout.js +57 -0
  497. package/dist/components/modules/text-layout.js.map +1 -0
  498. package/dist/components/modules/text-style.d.ts +48 -0
  499. package/dist/components/modules/text-style.d.ts.map +1 -0
  500. package/dist/components/modules/text-style.js +63 -0
  501. package/dist/components/modules/text-style.js.map +1 -0
  502. package/dist/components/modules/three-entries.d.ts +23 -0
  503. package/dist/components/modules/three-entries.d.ts.map +1 -0
  504. package/dist/components/modules/three-entries.js +41 -0
  505. package/dist/components/modules/three-entries.js.map +1 -0
  506. package/dist/components/modules/view3d.d.ts +59 -0
  507. package/dist/components/modules/view3d.d.ts.map +1 -0
  508. package/dist/components/modules/view3d.js +171 -0
  509. package/dist/components/modules/view3d.js.map +1 -0
  510. package/dist/components/trees/2d/group-bounds.d.ts +56 -0
  511. package/dist/components/trees/2d/group-bounds.d.ts.map +1 -0
  512. package/dist/components/trees/2d/group-bounds.js +87 -0
  513. package/dist/components/trees/2d/group-bounds.js.map +1 -0
  514. package/dist/components/trees/2d/node-lifecycle.d.ts +46 -0
  515. package/dist/components/trees/2d/node-lifecycle.d.ts.map +1 -0
  516. package/dist/components/trees/2d/node-lifecycle.js +264 -0
  517. package/dist/components/trees/2d/node-lifecycle.js.map +1 -0
  518. package/dist/components/trees/2d/node-motion.d.ts +56 -0
  519. package/dist/components/trees/2d/node-motion.d.ts.map +1 -0
  520. package/dist/components/trees/2d/node-motion.js +86 -0
  521. package/dist/components/trees/2d/node-motion.js.map +1 -0
  522. package/dist/components/trees/2d/node-render.d.ts +36 -0
  523. package/dist/components/trees/2d/node-render.d.ts.map +1 -0
  524. package/dist/components/trees/2d/node-render.js +67 -0
  525. package/dist/components/trees/2d/node-render.js.map +1 -0
  526. package/dist/components/trees/2d/node-space.d.ts +63 -0
  527. package/dist/components/trees/2d/node-space.d.ts.map +1 -0
  528. package/dist/components/trees/2d/node-space.js +131 -0
  529. package/dist/components/trees/2d/node-space.js.map +1 -0
  530. package/dist/components/trees/2d/node-transform.d.ts +55 -0
  531. package/dist/components/trees/2d/node-transform.d.ts.map +1 -0
  532. package/dist/components/trees/2d/node-transform.js +73 -0
  533. package/dist/components/trees/2d/node-transform.js.map +1 -0
  534. package/dist/components/trees/2d/node2d.d.ts +1020 -0
  535. package/dist/components/trees/2d/node2d.d.ts.map +1 -0
  536. package/dist/components/trees/2d/node2d.js +1481 -0
  537. package/dist/components/trees/2d/node2d.js.map +1 -0
  538. package/dist/components/trees/audio/index.d.ts +2 -0
  539. package/dist/components/trees/audio/index.d.ts.map +1 -0
  540. package/dist/components/trees/audio/index.js +2 -0
  541. package/dist/components/trees/audio/index.js.map +1 -0
  542. package/dist/components/trees/audio/node-audio.d.ts +116 -0
  543. package/dist/components/trees/audio/node-audio.d.ts.map +1 -0
  544. package/dist/components/trees/audio/node-audio.js +171 -0
  545. package/dist/components/trees/audio/node-audio.js.map +1 -0
  546. package/dist/components/trees/index.d.ts +10 -0
  547. package/dist/components/trees/index.d.ts.map +1 -0
  548. package/dist/components/trees/index.js +14 -0
  549. package/dist/components/trees/index.js.map +1 -0
  550. package/dist/components/trees/node/node-editor-state.d.ts +53 -0
  551. package/dist/components/trees/node/node-editor-state.d.ts.map +1 -0
  552. package/dist/components/trees/node/node-editor-state.js +23 -0
  553. package/dist/components/trees/node/node-editor-state.js.map +1 -0
  554. package/dist/components/trees/node/node-reactive.d.ts +89 -0
  555. package/dist/components/trees/node/node-reactive.d.ts.map +1 -0
  556. package/dist/components/trees/node/node-reactive.js +135 -0
  557. package/dist/components/trees/node/node-reactive.js.map +1 -0
  558. package/dist/components/trees/node/node-time.d.ts +39 -0
  559. package/dist/components/trees/node/node-time.d.ts.map +1 -0
  560. package/dist/components/trees/node/node-time.js +14 -0
  561. package/dist/components/trees/node/node-time.js.map +1 -0
  562. package/dist/components/trees/node/node-walk.d.ts +46 -0
  563. package/dist/components/trees/node/node-walk.d.ts.map +1 -0
  564. package/dist/components/trees/node/node-walk.js +74 -0
  565. package/dist/components/trees/node/node-walk.js.map +1 -0
  566. package/dist/components/trees/node/node.d.ts +401 -0
  567. package/dist/components/trees/node/node.d.ts.map +1 -0
  568. package/dist/components/trees/node/node.js +680 -0
  569. package/dist/components/trees/node/node.js.map +1 -0
  570. package/dist/components/trees/root/canvas2d-node.d.ts +163 -0
  571. package/dist/components/trees/root/canvas2d-node.d.ts.map +1 -0
  572. package/dist/components/trees/root/canvas2d-node.js +216 -0
  573. package/dist/components/trees/root/canvas2d-node.js.map +1 -0
  574. package/dist/components/trees/three/node3d.d.ts +222 -0
  575. package/dist/components/trees/three/node3d.d.ts.map +1 -0
  576. package/dist/components/trees/three/node3d.js +289 -0
  577. package/dist/components/trees/three/node3d.js.map +1 -0
  578. package/dist/document/builtins.js +13 -13
  579. package/dist/document/builtins.js.map +1 -1
  580. package/dist/document/command-traits.d.ts +14 -4
  581. package/dist/document/command-traits.d.ts.map +1 -1
  582. package/dist/document/command-traits.js +35 -7
  583. package/dist/document/command-traits.js.map +1 -1
  584. package/dist/document/deny-globals.d.ts +2 -2
  585. package/dist/document/deny-globals.js +2 -2
  586. package/dist/document/deny-globals.js.map +1 -1
  587. package/dist/document/expression/index.d.ts +1 -1
  588. package/dist/document/expression/index.js +1 -1
  589. package/dist/document/expression/index.js.map +1 -1
  590. package/dist/document/expression/ops.js +1 -1
  591. package/dist/document/expression/ops.js.map +1 -1
  592. package/dist/document/index.d.ts +9 -2
  593. package/dist/document/index.d.ts.map +1 -1
  594. package/dist/document/index.js +5 -2
  595. package/dist/document/index.js.map +1 -1
  596. package/dist/document/migrate.d.ts +70 -0
  597. package/dist/document/migrate.d.ts.map +1 -0
  598. package/dist/document/migrate.js +202 -0
  599. package/dist/document/migrate.js.map +1 -0
  600. package/dist/document/missing-node.d.ts +27 -0
  601. package/dist/document/missing-node.d.ts.map +1 -0
  602. package/dist/document/missing-node.js +48 -0
  603. package/dist/document/missing-node.js.map +1 -0
  604. package/dist/document/node-decorator.d.ts +14 -10
  605. package/dist/document/node-decorator.d.ts.map +1 -1
  606. package/dist/document/node-decorator.js +14 -10
  607. package/dist/document/node-decorator.js.map +1 -1
  608. package/dist/document/node-descriptor.d.ts +7 -3
  609. package/dist/document/node-descriptor.d.ts.map +1 -1
  610. package/dist/document/node-descriptor.js.map +1 -1
  611. package/dist/document/placement.d.ts +2 -1
  612. package/dist/document/placement.d.ts.map +1 -1
  613. package/dist/document/placement.js.map +1 -1
  614. package/dist/document/project.d.ts +2 -0
  615. package/dist/document/project.d.ts.map +1 -1
  616. package/dist/document/project.js +1 -0
  617. package/dist/document/project.js.map +1 -1
  618. package/dist/document/prop-evolution.d.ts +51 -0
  619. package/dist/document/prop-evolution.d.ts.map +1 -0
  620. package/dist/document/prop-evolution.js +83 -0
  621. package/dist/document/prop-evolution.js.map +1 -0
  622. package/dist/document/registry.d.ts +39 -25
  623. package/dist/document/registry.d.ts.map +1 -1
  624. package/dist/document/registry.js +41 -21
  625. package/dist/document/registry.js.map +1 -1
  626. package/dist/document/settled-index.d.ts +2 -0
  627. package/dist/document/settled-index.d.ts.map +1 -1
  628. package/dist/document/settled-index.js +5 -5
  629. package/dist/document/settled-index.js.map +1 -1
  630. package/dist/document/timeline-patch.d.ts +4 -0
  631. package/dist/document/timeline-patch.d.ts.map +1 -1
  632. package/dist/document/timeline-patch.js +28 -3
  633. package/dist/document/timeline-patch.js.map +1 -1
  634. package/dist/document/timeline.d.ts +48 -4
  635. package/dist/document/timeline.d.ts.map +1 -1
  636. package/dist/document/timeline.js +174 -44
  637. package/dist/document/timeline.js.map +1 -1
  638. package/dist/document/types.d.ts +18 -32
  639. package/dist/document/types.d.ts.map +1 -1
  640. package/dist/document/types.js.map +1 -1
  641. package/dist/document/validate.d.ts +18 -6
  642. package/dist/document/validate.d.ts.map +1 -1
  643. package/dist/document/validate.js +158 -21
  644. package/dist/document/validate.js.map +1 -1
  645. package/dist/document/vocabulary.d.ts +28 -0
  646. package/dist/document/vocabulary.d.ts.map +1 -0
  647. package/dist/document/vocabulary.js +42 -0
  648. package/dist/document/vocabulary.js.map +1 -0
  649. package/dist/experimental.d.ts +79 -19
  650. package/dist/experimental.d.ts.map +1 -1
  651. package/dist/experimental.js +31 -17
  652. package/dist/experimental.js.map +1 -1
  653. package/dist/index.d.ts +10 -11
  654. package/dist/index.d.ts.map +1 -1
  655. package/dist/index.js +10 -11
  656. package/dist/index.js.map +1 -1
  657. package/dist/layout/types.d.ts +1 -1
  658. package/dist/layout/types.js.map +1 -1
  659. package/dist/platform/exporter.d.ts +13 -0
  660. package/dist/platform/exporter.d.ts.map +1 -1
  661. package/dist/platform/exporter.js.map +1 -1
  662. package/dist/props/host.d.ts +1 -1
  663. package/dist/props/host.js.map +1 -1
  664. package/dist/props/slot.d.ts +1 -1
  665. package/dist/props/slot.js +1 -1
  666. package/dist/props/slot.js.map +1 -1
  667. package/dist/renamed-scene-names.d.ts +1 -1
  668. package/dist/renamed-scene-names.d.ts.map +1 -1
  669. package/dist/renamed-scene-names.js +1 -1
  670. package/dist/renamed-scene-names.js.map +1 -1
  671. package/dist/render/canvas-render-context2d.d.ts +9 -0
  672. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  673. package/dist/render/canvas-render-context2d.js +10 -0
  674. package/dist/render/canvas-render-context2d.js.map +1 -1
  675. package/dist/render/clip-contains.js +1 -1
  676. package/dist/render/clip-contains.js.map +1 -1
  677. package/dist/render/clip.d.ts +1 -1
  678. package/dist/render/clip.js +1 -1
  679. package/dist/render/clip.js.map +1 -1
  680. package/dist/render/descriptors/rect.js.map +1 -1
  681. package/dist/render/descriptors/text.d.ts +13 -7
  682. package/dist/render/descriptors/text.d.ts.map +1 -1
  683. package/dist/render/descriptors/text.js +9 -3
  684. package/dist/render/descriptors/text.js.map +1 -1
  685. package/dist/render/index.d.ts +2 -0
  686. package/dist/render/index.d.ts.map +1 -1
  687. package/dist/render/index.js +1 -0
  688. package/dist/render/index.js.map +1 -1
  689. package/dist/render/render-context2d.d.ts +3 -3
  690. package/dist/render/render-context2d.js.map +1 -1
  691. package/dist/render/render-issue.d.ts +39 -0
  692. package/dist/render/render-issue.d.ts.map +1 -0
  693. package/dist/render/render-issue.js +29 -0
  694. package/dist/render/render-issue.js.map +1 -0
  695. package/dist/render/surface.d.ts +2 -2
  696. package/dist/render/surface.js.map +1 -1
  697. package/dist/render3d/builders.d.ts +1 -1
  698. package/dist/render3d/builders.js +1 -1
  699. package/dist/render3d/builders.js.map +1 -1
  700. package/dist/render3d/graphics3d.d.ts +13 -19
  701. package/dist/render3d/graphics3d.d.ts.map +1 -1
  702. package/dist/render3d/graphics3d.js +67 -24
  703. package/dist/render3d/graphics3d.js.map +1 -1
  704. package/dist/render3d/scene3d.d.ts +1 -1
  705. package/dist/render3d/scene3d.js +1 -1
  706. package/dist/render3d/scene3d.js.map +1 -1
  707. package/dist/render3d/texture.d.ts +2 -2
  708. package/dist/render3d/texture.d.ts.map +1 -1
  709. package/dist/render3d/texture.js.map +1 -1
  710. package/dist/render3d/vector3.d.ts +2 -2
  711. package/dist/render3d/vector3.js +2 -2
  712. package/dist/render3d/vector3.js.map +1 -1
  713. package/dist/runtime/asset-refine.d.ts +1 -1
  714. package/dist/runtime/asset-refine.d.ts.map +1 -1
  715. package/dist/runtime/asset-refine.js +3 -2
  716. package/dist/runtime/asset-refine.js.map +1 -1
  717. package/dist/runtime/asset-timeline.d.ts +10 -0
  718. package/dist/runtime/asset-timeline.d.ts.map +1 -1
  719. package/dist/runtime/asset-timeline.js.map +1 -1
  720. package/dist/runtime/asset-update.d.ts.map +1 -1
  721. package/dist/runtime/asset-update.js +8 -1
  722. package/dist/runtime/asset-update.js.map +1 -1
  723. package/dist/runtime/audio-index.d.ts +0 -11
  724. package/dist/runtime/audio-index.d.ts.map +1 -1
  725. package/dist/runtime/audio-index.js +0 -25
  726. package/dist/runtime/audio-index.js.map +1 -1
  727. package/dist/runtime/clip-instance.d.ts +6 -4
  728. package/dist/runtime/clip-instance.d.ts.map +1 -1
  729. package/dist/runtime/clip-instance.js +8 -4
  730. package/dist/runtime/clip-instance.js.map +1 -1
  731. package/dist/runtime/clip-store.d.ts +2 -3
  732. package/dist/runtime/clip-store.d.ts.map +1 -1
  733. package/dist/runtime/clip-store.js +34 -37
  734. package/dist/runtime/clip-store.js.map +1 -1
  735. package/dist/runtime/engine.d.ts +8 -6
  736. package/dist/runtime/engine.d.ts.map +1 -1
  737. package/dist/runtime/engine.js +4 -3
  738. package/dist/runtime/engine.js.map +1 -1
  739. package/dist/runtime/node-picking.d.ts +2 -2
  740. package/dist/runtime/node-picking.d.ts.map +1 -1
  741. package/dist/runtime/node-picking.js +3 -3
  742. package/dist/runtime/node-picking.js.map +1 -1
  743. package/dist/runtime/node-picking3d.d.ts +2 -2
  744. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  745. package/dist/runtime/node-picking3d.js +1 -1
  746. package/dist/runtime/node-picking3d.js.map +1 -1
  747. package/dist/runtime/playback-controller.d.ts +2 -2
  748. package/dist/runtime/playback-controller.d.ts.map +1 -1
  749. package/dist/runtime/playback-controller.js +15 -5
  750. package/dist/runtime/playback-controller.js.map +1 -1
  751. package/dist/runtime/session.d.ts +7 -3
  752. package/dist/runtime/session.d.ts.map +1 -1
  753. package/dist/runtime/session.js +11 -4
  754. package/dist/runtime/session.js.map +1 -1
  755. package/dist/runtime/state-evaluator.d.ts +2 -2
  756. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  757. package/dist/runtime/state-evaluator.js.map +1 -1
  758. package/dist/runtime/text-geometry.d.ts +2 -2
  759. package/dist/runtime/text-geometry.d.ts.map +1 -1
  760. package/dist/runtime/text-geometry.js +4 -5
  761. package/dist/runtime/text-geometry.js.map +1 -1
  762. package/dist/sdk/index.d.ts +50 -44
  763. package/dist/sdk/index.d.ts.map +1 -1
  764. package/dist/sdk/index.js +35 -29
  765. package/dist/sdk/index.js.map +1 -1
  766. package/dist/tween/command-decorator.d.ts +14 -9
  767. package/dist/tween/command-decorator.d.ts.map +1 -1
  768. package/dist/tween/command-decorator.js +3 -2
  769. package/dist/tween/command-decorator.js.map +1 -1
  770. package/dist/tween/command.d.ts +1 -1
  771. package/dist/tween/command.js.map +1 -1
  772. package/dist/tween/ease/describe.d.ts +2 -0
  773. package/dist/tween/ease/describe.d.ts.map +1 -1
  774. package/dist/tween/ease/describe.js +4 -0
  775. package/dist/tween/ease/describe.js.map +1 -1
  776. package/dist/tween/ease/spec.d.ts +31 -0
  777. package/dist/tween/ease/spec.d.ts.map +1 -0
  778. package/dist/tween/ease/spec.js +51 -0
  779. package/dist/tween/ease/spec.js.map +1 -0
  780. package/dist/tween/index.d.ts +3 -1
  781. package/dist/tween/index.d.ts.map +1 -1
  782. package/dist/tween/index.js +2 -1
  783. package/dist/tween/index.js.map +1 -1
  784. package/dist/tween/loop.d.ts +1 -1
  785. package/dist/tween/loop.js +1 -1
  786. package/dist/tween/loop.js.map +1 -1
  787. package/dist/util/reference.d.ts +6 -6
  788. package/dist/util/reference.js.map +1 -1
  789. package/package.json +3 -11
  790. package/dist/browser/chunks/chunk-2RIYH36X.js +0 -3
  791. package/dist/browser/chunks/chunk-2RIYH36X.js.map +0 -7
  792. package/dist/browser/chunks/chunk-DDJN3QII.js +0 -15
  793. package/dist/browser/chunks/chunk-DDJN3QII.js.map +0 -7
  794. package/dist/browser/chunks/chunk-DHB4COFY.js +0 -2
  795. package/dist/browser/chunks/chunk-EJDPYDQI.js +0 -5
  796. package/dist/browser/chunks/chunk-EJDPYDQI.js.map +0 -7
  797. package/dist/browser/chunks/chunk-SFNJRPBV.js +0 -2
  798. package/dist/browser/chunks/chunk-SFNJRPBV.js.map +0 -7
  799. package/dist/browser/chunks/chunk-XAWE4EAK.js +0 -2
  800. package/dist/browser/chunks/chunk-XAWE4EAK.js.map +0 -7
  801. package/dist/browser/jsx-jsx-dev-runtime.js +0 -2
  802. package/dist/browser/jsx-jsx-dev-runtime.js.map +0 -7
  803. package/dist/browser/jsx-jsx-runtime.js +0 -2
  804. package/dist/browser/jsx-jsx-runtime.js.map +0 -7
@@ -0,0 +1,29 @@
1
+ /** A backend's issue as a typed one; a bare string is the shader message backends reported before issues were typed. */
2
+ export function toRenderIssue(issue) {
3
+ return typeof issue === "string" ? { kind: "shader", message: issue } : issue;
4
+ }
5
+ /** One key per kind, feature and node: what an issue list is deduplicated by. */
6
+ export function renderIssueKey(issue) {
7
+ return `${issue.kind}|${issue.feature ?? ""}|${issue.nodeId ?? ""}|${issue.feature ? "" : issue.message}`;
8
+ }
9
+ /**
10
+ * The backend lost what it draws with while a render was under way, so the
11
+ * frames already drawn cannot be trusted. Thrown by exports and stills on a
12
+ * `device-lost` or `crashed` issue; `retryable` says whether the same render
13
+ * can simply run again (the backend recovered on a new device).
14
+ */
15
+ export class RenderBackendError extends Error {
16
+ issue;
17
+ name = "RenderBackendError";
18
+ retryable;
19
+ constructor(issue) {
20
+ super(issue.message);
21
+ this.issue = issue;
22
+ this.retryable = issue.kind === "device-lost";
23
+ }
24
+ }
25
+ /** Whether an issue means the frames drawn around it are not to be trusted. */
26
+ export function isFatalRenderIssue(issue) {
27
+ return issue.kind === "device-lost" || issue.kind === "crashed";
28
+ }
29
+ //# sourceMappingURL=render-issue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render-issue.js","sourceRoot":"","sources":["../../src/render/render-issue.ts"],"names":[],"mappings":"AAsBA,wHAAwH;AACxH,MAAM,UAAU,aAAa,CAAC,KAA2B;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC7C,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;AAC9G,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAIpB;IAHH,IAAI,GAAG,oBAAoB,CAAC;IACrC,SAAS,CAAU;IAE5B,YAAqB,KAAkB;QACnC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QADJ,UAAK,GAAL,KAAK,CAAa;QAEnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;IAClD,CAAC;CACJ;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AACpE,CAAC","sourcesContent":["/**\r\n * What a render issue is about:\r\n *\r\n * - `missing`: a feature the backend does not draw (`feature` names it).\r\n * - `shader`: a user shader that does not compile, or one that is not WGSL (an SkSL shader from an old document).\r\n * - `params`: a shader's uniforms and its `struct Params` disagree (a value with no member, a member with no value).\r\n * - `gpu`: a WebGPU validation or out-of-memory error.\r\n * - `device-lost`: the GPU device was lost; the backend is drawing on a new one.\r\n * - `crashed`: the backend itself failed and draws nothing more on this page.\r\n */\r\nexport type RenderIssueKind = \"missing\" | \"shader\" | \"params\" | \"gpu\" | \"device-lost\" | \"crashed\";\r\n\r\n/** Something a frame drew without throwing but not as the document says. */\r\nexport interface RenderIssue {\r\n kind: RenderIssueKind;\r\n message: string;\r\n /** What is affected, as the backend names it (`blend:color-dodge`, `text:path`, `fill:shader`). */\r\n feature?: string;\r\n /** The node it was found on, when the backend knows. */\r\n nodeId?: string;\r\n}\r\n\r\n/** A backend's issue as a typed one; a bare string is the shader message backends reported before issues were typed. */\r\nexport function toRenderIssue(issue: RenderIssue | string): RenderIssue {\r\n return typeof issue === \"string\" ? { kind: \"shader\", message: issue } : issue;\r\n}\r\n\r\n/** One key per kind, feature and node: what an issue list is deduplicated by. */\r\nexport function renderIssueKey(issue: RenderIssue): string {\r\n return `${issue.kind}|${issue.feature ?? \"\"}|${issue.nodeId ?? \"\"}|${issue.feature ? \"\" : issue.message}`;\r\n}\r\n\r\n/**\r\n * The backend lost what it draws with while a render was under way, so the\r\n * frames already drawn cannot be trusted. Thrown by exports and stills on a\r\n * `device-lost` or `crashed` issue; `retryable` says whether the same render\r\n * can simply run again (the backend recovered on a new device).\r\n */\r\nexport class RenderBackendError extends Error {\r\n override readonly name = \"RenderBackendError\";\r\n readonly retryable: boolean;\r\n\r\n constructor(readonly issue: RenderIssue) {\r\n super(issue.message);\r\n this.retryable = issue.kind === \"device-lost\";\r\n }\r\n}\r\n\r\n/** Whether an issue means the frames drawn around it are not to be trusted. */\r\nexport function isFatalRenderIssue(issue: RenderIssue): boolean {\r\n return issue.kind === \"device-lost\" || issue.kind === \"crashed\";\r\n}\r\n"]}
@@ -11,8 +11,8 @@ import { Size2D } from "../attributes/layout/size.js";
11
11
  * with `lib: ["ES2022"]` and no DOM, deliberately, so this layer cannot name a
12
12
  * canvas — and it does not need to: a browser backend takes a canvas, a headless
13
13
  * one takes a size. Each narrows the argument at its own `mount`, where the
14
- * relevant types exist. `SkiaRenderContext` satisfies this structurally, so
15
- * neither `skia-render` nor `web` imports it.
14
+ * relevant types exist. A backend's context satisfies this structurally, so it
15
+ * never imports it.
16
16
  */
17
17
  export interface RenderSurface {
18
18
  mount(target: unknown): void;
@@ -1 +1 @@
1
- {"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/render/surface.ts"],"names":[],"mappings":"","sourcesContent":["import { Size2D } from \"@/attributes/layout/size\";\r\n\r\n/**\r\n * The host-facing half of a render context: where pixels land, and how the\r\n * preview frames them.\r\n *\r\n * Split out from `CanvasRenderContext2D` because a *node* never touches any of\r\n * it — a node draws, and the host decides what it is drawing into. A `Session`\r\n * owns one of these; a node is handed a `RenderContext2D`.\r\n *\r\n * **`mount` takes `unknown`, not `HTMLCanvasElement`.** `packages/core` compiles\r\n * with `lib: [\"ES2022\"]` and no DOM, deliberately, so this layer cannot name a\r\n * canvas — and it does not need to: a browser backend takes a canvas, a headless\r\n * one takes a size. Each narrows the argument at its own `mount`, where the\r\n * relevant types exist. `SkiaRenderContext` satisfies this structurally, so\r\n * neither `skia-render` nor `web` imports it.\r\n */\r\nexport interface RenderSurface {\r\n mount(target: unknown): void;\r\n unmount(): void;\r\n /** Device pixels per viewport unit. Rasterization, not zoom — see {@link view}. */\r\n pixelRatio: number;\r\n /** Preview pan/zoom over the frame. Costs a repaint, never a surface rebuild. */\r\n view: { zoom: number; x: number; y: number };\r\n /** The frame's own size when the surface is a window onto it, else `null`. */\r\n frame: Size2D | null;\r\n clipToFrame: boolean;\r\n /**\r\n * What the frame's backdrop is painted with. `\"transparent\"` lets whatever\r\n * is behind the canvas show through where nothing was drawn.\r\n */\r\n frameBackground: \"black\" | \"transparent\";\r\n}\r\n"]}
1
+ {"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/render/surface.ts"],"names":[],"mappings":"","sourcesContent":["import { Size2D } from \"@/attributes/layout/size\";\r\n\r\n/**\r\n * The host-facing half of a render context: where pixels land, and how the\r\n * preview frames them.\r\n *\r\n * Split out from `CanvasRenderContext2D` because a *node* never touches any of\r\n * it — a node draws, and the host decides what it is drawing into. A `Session`\r\n * owns one of these; a node is handed a `RenderContext2D`.\r\n *\r\n * **`mount` takes `unknown`, not `HTMLCanvasElement`.** `packages/core` compiles\r\n * with `lib: [\"ES2022\"]` and no DOM, deliberately, so this layer cannot name a\r\n * canvas — and it does not need to: a browser backend takes a canvas, a headless\r\n * one takes a size. Each narrows the argument at its own `mount`, where the\r\n * relevant types exist. A backend's context satisfies this structurally, so it\r\n * never imports it.\r\n */\r\nexport interface RenderSurface {\r\n mount(target: unknown): void;\r\n unmount(): void;\r\n /** Device pixels per viewport unit. Rasterization, not zoom — see {@link view}. */\r\n pixelRatio: number;\r\n /** Preview pan/zoom over the frame. Costs a repaint, never a surface rebuild. */\r\n view: { zoom: number; x: number; y: number };\r\n /** The frame's own size when the surface is a window onto it, else `null`. */\r\n frame: Size2D | null;\r\n clipToFrame: boolean;\r\n /**\r\n * What the frame's backdrop is painted with. `\"transparent\"` lets whatever\r\n * is behind the canvas show through where nothing was drawn.\r\n */\r\n frameBackground: \"black\" | \"transparent\";\r\n}\r\n"]}
@@ -96,7 +96,7 @@ export declare const Tex: {
96
96
  * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);
97
97
  * g3.plane({ fill: scope }); // sized for you
98
98
  *
99
- * const stats = <Rect flow="vertical" padding={48}><Text text="CPU" /></Rect>;
99
+ * const stats = new Rect({ flow: "vertical", padding: 48, children: [Text({ text: "CPU" })] });
100
100
  * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });
101
101
  *
102
102
  * `width`/`height` are the buffer's resolution and default to 512. A source
@@ -89,7 +89,7 @@ export const Tex = {
89
89
  * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);
90
90
  * g3.plane({ fill: scope }); // sized for you
91
91
  *
92
- * const stats = <Rect flow="vertical" padding={48}><Text text="CPU" /></Rect>;
92
+ * const stats = new Rect({ flow: "vertical", padding: 48, children: [Text({ text: "CPU" })] });
93
93
  * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });
94
94
  *
95
95
  * `width`/`height` are the buffer's resolution and default to 512. A source
@@ -1 +1 @@
1
- {"version":3,"file":"builders.js","sourceRoot":"","sources":["../../src/render3d/builders.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D,\r\n ConeGeometry3D, CylinderGeometry3D, EdgesGeometry3D, ExtrudeGeometry3D,\r\n Geometry3D, LatheGeometry3D, ModelGeometry3D, ParametricGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D, WireframeGeometry3D,\r\n} from \"./geometry\";\r\nimport type {\r\n BasicMaterial3D, DepthMaterial3D, LambertMaterial3D, LineBasicMaterial3D,\r\n LineDashedMaterial3D, MatcapMaterial3D, NormalMaterial3D, PhongMaterial3D,\r\n PhysicalMaterial3D, PointsMaterial3D, ShaderMaterial3D, ShadowMaterial3D,\r\n SpriteMaterial3D, StandardMaterial3D, ToonMaterial3D,\r\n} from \"./material\";\r\nimport type { DataTexture3D, ImageTexture3D, SurfaceSource3D, SurfaceTexture3D, TextureOptions3D } from \"./texture\";\r\n\r\n/** A descriptor's own params, with the `type` discriminant removed. */\r\ntype ParamsOf<T> = Omit<T, \"type\">;\r\n\r\n/**\r\n * Geometry descriptors.\r\n *\r\n * These are plain values, so hoist one out of the builder and share it across\r\n * meshes — the renderer dedupes by identity, so a shared geometry is uploaded to\r\n * the GPU once no matter how many meshes reference it.\r\n *\r\n * const brick = Geo.box({ width: 1, height: 0.5, depth: 0.5 });\r\n * g.mesh(brick, red, { position: [0, 0, 0] })\r\n * .mesh(brick, red, { position: [1, 0, 0] }); // same GPU buffer\r\n */\r\nexport const Geo = {\r\n box: (o?: ParamsOf<BoxGeometry3D>): BoxGeometry3D => ({ type: \"box\", ...o }),\r\n sphere: (o?: ParamsOf<SphereGeometry3D>): SphereGeometry3D => ({ type: \"sphere\", ...o }),\r\n plane: (o?: ParamsOf<PlaneGeometry3D>): PlaneGeometry3D => ({ type: \"plane\", ...o }),\r\n cylinder: (o?: ParamsOf<CylinderGeometry3D>): CylinderGeometry3D => ({ type: \"cylinder\", ...o }),\r\n cone: (o?: ParamsOf<ConeGeometry3D>): ConeGeometry3D => ({ type: \"cone\", ...o }),\r\n torus: (o?: ParamsOf<TorusGeometry3D>): TorusGeometry3D => ({ type: \"torus\", ...o }),\r\n torusKnot: (o?: ParamsOf<TorusKnotGeometry3D>): TorusKnotGeometry3D => ({ type: \"torusKnot\", ...o }),\r\n circle: (o?: ParamsOf<CircleGeometry3D>): CircleGeometry3D => ({ type: \"circle\", ...o }),\r\n ring: (o?: ParamsOf<RingGeometry3D>): RingGeometry3D => ({ type: \"ring\", ...o }),\r\n capsule: (o?: ParamsOf<CapsuleGeometry3D>): CapsuleGeometry3D => ({ type: \"capsule\", ...o }),\r\n\r\n tetrahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"tetrahedron\", ...o }),\r\n octahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"octahedron\", ...o }),\r\n icosahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"icosahedron\", ...o }),\r\n dodecahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"dodecahedron\", ...o }),\r\n\r\n extrude: (o: ParamsOf<ExtrudeGeometry3D>): ExtrudeGeometry3D => ({ type: \"extrude\", ...o }),\r\n lathe: (o: ParamsOf<LatheGeometry3D>): LatheGeometry3D => ({ type: \"lathe\", ...o }),\r\n tube: (o: ParamsOf<TubeGeometry3D>): TubeGeometry3D => ({ type: \"tube\", ...o }),\r\n\r\n /** Raw vertex buffers — any mesh you can compute. */\r\n buffer: (o: ParamsOf<BufferGeometry3D>): BufferGeometry3D => ({ type: \"buffer\", ...o }),\r\n /** A surface sampled over a `[0,1]²` grid. Sugar over {@link Geo.buffer}. */\r\n parametric: (o: ParamsOf<ParametricGeometry3D>): ParametricGeometry3D => ({ type: \"parametric\", ...o }),\r\n\r\n /** The hard edges of another geometry — a clean outline, no triangulation diagonals. */\r\n edges: (source: Geometry3D, o?: Omit<ParamsOf<EdgesGeometry3D>, \"source\">): EdgesGeometry3D =>\r\n ({ type: \"edges\", source, ...o }),\r\n /** Every triangle edge of another geometry. */\r\n wireframe: (source: Geometry3D): WireframeGeometry3D => ({ type: \"wireframe\", source }),\r\n\r\n model: (src: string, o?: Omit<ParamsOf<ModelGeometry3D>, \"src\">): ModelGeometry3D =>\r\n ({ type: \"modelGeometry\", src, ...o }),\r\n} as const;\r\n\r\n/**\r\n * Material descriptors.\r\n *\r\n * Like geometries these are shareable values — one hoisted material across many\r\n * meshes compiles one shader program instead of N.\r\n *\r\n * Reach for {@link Mat.standard} by default; {@link Mat.physical} only when a\r\n * surface actually needs clearcoat, transmission, sheen or iridescence, since\r\n * those cost more per pixel. {@link Mat.shader} is the full-control escape hatch.\r\n */\r\nexport const Mat = {\r\n basic: (o?: ParamsOf<BasicMaterial3D>): BasicMaterial3D => ({ type: \"basic\", ...o }),\r\n standard: (o?: ParamsOf<StandardMaterial3D>): StandardMaterial3D => ({ type: \"standard\", ...o }),\r\n physical: (o?: ParamsOf<PhysicalMaterial3D>): PhysicalMaterial3D => ({ type: \"physical\", ...o }),\r\n phong: (o?: ParamsOf<PhongMaterial3D>): PhongMaterial3D => ({ type: \"phong\", ...o }),\r\n lambert: (o?: ParamsOf<LambertMaterial3D>): LambertMaterial3D => ({ type: \"lambert\", ...o }),\r\n toon: (o?: ParamsOf<ToonMaterial3D>): ToonMaterial3D => ({ type: \"toon\", ...o }),\r\n normal: (o?: ParamsOf<NormalMaterial3D>): NormalMaterial3D => ({ type: \"normal\", ...o }),\r\n depth: (o?: ParamsOf<DepthMaterial3D>): DepthMaterial3D => ({ type: \"depth\", ...o }),\r\n matcap: (o?: ParamsOf<MatcapMaterial3D>): MatcapMaterial3D => ({ type: \"matcap\", ...o }),\r\n points: (o?: ParamsOf<PointsMaterial3D>): PointsMaterial3D => ({ type: \"points\", ...o }),\r\n lineBasic: (o?: ParamsOf<LineBasicMaterial3D>): LineBasicMaterial3D => ({ type: \"lineBasic\", ...o }),\r\n lineDashed: (o?: ParamsOf<LineDashedMaterial3D>): LineDashedMaterial3D => ({ type: \"lineDashed\", ...o }),\r\n sprite: (o?: ParamsOf<SpriteMaterial3D>): SpriteMaterial3D => ({ type: \"sprite\", ...o }),\r\n shadow: (o?: ParamsOf<ShadowMaterial3D>): ShadowMaterial3D => ({ type: \"shadow\", ...o }),\r\n /** Raw GLSL. Uniform *values* are free to animate; source changes recompile. */\r\n shader: (o: ParamsOf<ShaderMaterial3D>): ShaderMaterial3D => ({ type: \"shader\", ...o }),\r\n} as const;\r\n\r\n/**\r\n * Texture descriptors.\r\n *\r\n * {@link Tex.image} takes a manifest path and is loaded through core's ordinary\r\n * image pipeline, so the pixels are resident before the frame that needs them\r\n * draws. A bare string works anywhere a texture is expected, so `Tex.image` is\r\n * only needed when passing sampler options.\r\n */\r\nexport const Tex = {\r\n image: (src: string, o?: TextureOptions3D): ImageTexture3D => ({ src, ...o }),\r\n /** A texture from raw RGBA8888 bytes — gradient ramps, noise, LUTs. */\r\n data: (\r\n data: ArrayLike<number>,\r\n width: number,\r\n height: number,\r\n o?: TextureOptions3D & { revision?: number },\r\n ): DataTexture3D => ({ data, width, height, ...o }),\r\n /**\r\n * A texture painted from Motion Script's own 2D output — the bridge from 2D\r\n * onto 3D geometry.\r\n *\r\n * `source` is a **value**: a built `Graphics2D` command list, or a `Node2D`\r\n * subtree for anything needing real layout, shaped `Text` or a loaded\r\n * `Image`. Both are passed directly; there is no name to match and nothing\r\n * has to be mounted anywhere in particular.\r\n *\r\n * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);\r\n * g3.plane({ fill: scope }); // sized for you\r\n *\r\n * const stats = <Rect flow=\"vertical\" padding={48}><Text text=\"CPU\" /></Rect>;\r\n * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });\r\n *\r\n * `width`/`height` are the buffer's resolution and default to 512. A source\r\n * handed straight to `fill` gets exactly this treatment with those defaults,\r\n * so the builder is only needed to pin a resolution or a sampler option.\r\n * **Hoist the source** rather than rebuilding it each frame — see\r\n * {@link SurfaceTexture3D}.\r\n */\r\n surface: (\r\n source: SurfaceSource3D,\r\n o?: TextureOptions3D & { width?: number; height?: number; maxPixelRatio?: number },\r\n ): SurfaceTexture3D => ({\r\n width: 512,\r\n height: 512,\r\n ...o,\r\n source,\r\n }),\r\n} as const;\r\n"]}
1
+ {"version":3,"file":"builders.js","sourceRoot":"","sources":["../../src/render3d/builders.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D,\r\n ConeGeometry3D, CylinderGeometry3D, EdgesGeometry3D, ExtrudeGeometry3D,\r\n Geometry3D, LatheGeometry3D, ModelGeometry3D, ParametricGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D, WireframeGeometry3D,\r\n} from \"./geometry\";\r\nimport type {\r\n BasicMaterial3D, DepthMaterial3D, LambertMaterial3D, LineBasicMaterial3D,\r\n LineDashedMaterial3D, MatcapMaterial3D, NormalMaterial3D, PhongMaterial3D,\r\n PhysicalMaterial3D, PointsMaterial3D, ShaderMaterial3D, ShadowMaterial3D,\r\n SpriteMaterial3D, StandardMaterial3D, ToonMaterial3D,\r\n} from \"./material\";\r\nimport type { DataTexture3D, ImageTexture3D, SurfaceSource3D, SurfaceTexture3D, TextureOptions3D } from \"./texture\";\r\n\r\n/** A descriptor's own params, with the `type` discriminant removed. */\r\ntype ParamsOf<T> = Omit<T, \"type\">;\r\n\r\n/**\r\n * Geometry descriptors.\r\n *\r\n * These are plain values, so hoist one out of the builder and share it across\r\n * meshes — the renderer dedupes by identity, so a shared geometry is uploaded to\r\n * the GPU once no matter how many meshes reference it.\r\n *\r\n * const brick = Geo.box({ width: 1, height: 0.5, depth: 0.5 });\r\n * g.mesh(brick, red, { position: [0, 0, 0] })\r\n * .mesh(brick, red, { position: [1, 0, 0] }); // same GPU buffer\r\n */\r\nexport const Geo = {\r\n box: (o?: ParamsOf<BoxGeometry3D>): BoxGeometry3D => ({ type: \"box\", ...o }),\r\n sphere: (o?: ParamsOf<SphereGeometry3D>): SphereGeometry3D => ({ type: \"sphere\", ...o }),\r\n plane: (o?: ParamsOf<PlaneGeometry3D>): PlaneGeometry3D => ({ type: \"plane\", ...o }),\r\n cylinder: (o?: ParamsOf<CylinderGeometry3D>): CylinderGeometry3D => ({ type: \"cylinder\", ...o }),\r\n cone: (o?: ParamsOf<ConeGeometry3D>): ConeGeometry3D => ({ type: \"cone\", ...o }),\r\n torus: (o?: ParamsOf<TorusGeometry3D>): TorusGeometry3D => ({ type: \"torus\", ...o }),\r\n torusKnot: (o?: ParamsOf<TorusKnotGeometry3D>): TorusKnotGeometry3D => ({ type: \"torusKnot\", ...o }),\r\n circle: (o?: ParamsOf<CircleGeometry3D>): CircleGeometry3D => ({ type: \"circle\", ...o }),\r\n ring: (o?: ParamsOf<RingGeometry3D>): RingGeometry3D => ({ type: \"ring\", ...o }),\r\n capsule: (o?: ParamsOf<CapsuleGeometry3D>): CapsuleGeometry3D => ({ type: \"capsule\", ...o }),\r\n\r\n tetrahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"tetrahedron\", ...o }),\r\n octahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"octahedron\", ...o }),\r\n icosahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"icosahedron\", ...o }),\r\n dodecahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"dodecahedron\", ...o }),\r\n\r\n extrude: (o: ParamsOf<ExtrudeGeometry3D>): ExtrudeGeometry3D => ({ type: \"extrude\", ...o }),\r\n lathe: (o: ParamsOf<LatheGeometry3D>): LatheGeometry3D => ({ type: \"lathe\", ...o }),\r\n tube: (o: ParamsOf<TubeGeometry3D>): TubeGeometry3D => ({ type: \"tube\", ...o }),\r\n\r\n /** Raw vertex buffers — any mesh you can compute. */\r\n buffer: (o: ParamsOf<BufferGeometry3D>): BufferGeometry3D => ({ type: \"buffer\", ...o }),\r\n /** A surface sampled over a `[0,1]²` grid. Sugar over {@link Geo.buffer}. */\r\n parametric: (o: ParamsOf<ParametricGeometry3D>): ParametricGeometry3D => ({ type: \"parametric\", ...o }),\r\n\r\n /** The hard edges of another geometry — a clean outline, no triangulation diagonals. */\r\n edges: (source: Geometry3D, o?: Omit<ParamsOf<EdgesGeometry3D>, \"source\">): EdgesGeometry3D =>\r\n ({ type: \"edges\", source, ...o }),\r\n /** Every triangle edge of another geometry. */\r\n wireframe: (source: Geometry3D): WireframeGeometry3D => ({ type: \"wireframe\", source }),\r\n\r\n model: (src: string, o?: Omit<ParamsOf<ModelGeometry3D>, \"src\">): ModelGeometry3D =>\r\n ({ type: \"modelGeometry\", src, ...o }),\r\n} as const;\r\n\r\n/**\r\n * Material descriptors.\r\n *\r\n * Like geometries these are shareable values — one hoisted material across many\r\n * meshes compiles one shader program instead of N.\r\n *\r\n * Reach for {@link Mat.standard} by default; {@link Mat.physical} only when a\r\n * surface actually needs clearcoat, transmission, sheen or iridescence, since\r\n * those cost more per pixel. {@link Mat.shader} is the full-control escape hatch.\r\n */\r\nexport const Mat = {\r\n basic: (o?: ParamsOf<BasicMaterial3D>): BasicMaterial3D => ({ type: \"basic\", ...o }),\r\n standard: (o?: ParamsOf<StandardMaterial3D>): StandardMaterial3D => ({ type: \"standard\", ...o }),\r\n physical: (o?: ParamsOf<PhysicalMaterial3D>): PhysicalMaterial3D => ({ type: \"physical\", ...o }),\r\n phong: (o?: ParamsOf<PhongMaterial3D>): PhongMaterial3D => ({ type: \"phong\", ...o }),\r\n lambert: (o?: ParamsOf<LambertMaterial3D>): LambertMaterial3D => ({ type: \"lambert\", ...o }),\r\n toon: (o?: ParamsOf<ToonMaterial3D>): ToonMaterial3D => ({ type: \"toon\", ...o }),\r\n normal: (o?: ParamsOf<NormalMaterial3D>): NormalMaterial3D => ({ type: \"normal\", ...o }),\r\n depth: (o?: ParamsOf<DepthMaterial3D>): DepthMaterial3D => ({ type: \"depth\", ...o }),\r\n matcap: (o?: ParamsOf<MatcapMaterial3D>): MatcapMaterial3D => ({ type: \"matcap\", ...o }),\r\n points: (o?: ParamsOf<PointsMaterial3D>): PointsMaterial3D => ({ type: \"points\", ...o }),\r\n lineBasic: (o?: ParamsOf<LineBasicMaterial3D>): LineBasicMaterial3D => ({ type: \"lineBasic\", ...o }),\r\n lineDashed: (o?: ParamsOf<LineDashedMaterial3D>): LineDashedMaterial3D => ({ type: \"lineDashed\", ...o }),\r\n sprite: (o?: ParamsOf<SpriteMaterial3D>): SpriteMaterial3D => ({ type: \"sprite\", ...o }),\r\n shadow: (o?: ParamsOf<ShadowMaterial3D>): ShadowMaterial3D => ({ type: \"shadow\", ...o }),\r\n /** Raw GLSL. Uniform *values* are free to animate; source changes recompile. */\r\n shader: (o: ParamsOf<ShaderMaterial3D>): ShaderMaterial3D => ({ type: \"shader\", ...o }),\r\n} as const;\r\n\r\n/**\r\n * Texture descriptors.\r\n *\r\n * {@link Tex.image} takes a manifest path and is loaded through core's ordinary\r\n * image pipeline, so the pixels are resident before the frame that needs them\r\n * draws. A bare string works anywhere a texture is expected, so `Tex.image` is\r\n * only needed when passing sampler options.\r\n */\r\nexport const Tex = {\r\n image: (src: string, o?: TextureOptions3D): ImageTexture3D => ({ src, ...o }),\r\n /** A texture from raw RGBA8888 bytes — gradient ramps, noise, LUTs. */\r\n data: (\r\n data: ArrayLike<number>,\r\n width: number,\r\n height: number,\r\n o?: TextureOptions3D & { revision?: number },\r\n ): DataTexture3D => ({ data, width, height, ...o }),\r\n /**\r\n * A texture painted from Motion Script's own 2D output — the bridge from 2D\r\n * onto 3D geometry.\r\n *\r\n * `source` is a **value**: a built `Graphics2D` command list, or a `Node2D`\r\n * subtree for anything needing real layout, shaped `Text` or a loaded\r\n * `Image`. Both are passed directly; there is no name to match and nothing\r\n * has to be mounted anywhere in particular.\r\n *\r\n * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);\r\n * g3.plane({ fill: scope }); // sized for you\r\n *\r\n * const stats = new Rect({ flow: \"vertical\", padding: 48, children: [Text({ text: \"CPU\" })] });\r\n * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });\r\n *\r\n * `width`/`height` are the buffer's resolution and default to 512. A source\r\n * handed straight to `fill` gets exactly this treatment with those defaults,\r\n * so the builder is only needed to pin a resolution or a sampler option.\r\n * **Hoist the source** rather than rebuilding it each frame — see\r\n * {@link SurfaceTexture3D}.\r\n */\r\n surface: (\r\n source: SurfaceSource3D,\r\n o?: TextureOptions3D & { width?: number; height?: number; maxPixelRatio?: number },\r\n ): SurfaceTexture3D => ({\r\n width: 512,\r\n height: 512,\r\n ...o,\r\n source,\r\n }),\r\n} as const;\r\n"]}
@@ -147,10 +147,8 @@ type ParamsOf<G> = Omit<G, "type">;
147
147
  * the `Node3D` tree owns them. The exact division `Graphics2D` and
148
148
  * `RenderContext2D` already make in 2D.
149
149
  *
150
- * protected renderSelf(ctx: RenderContext3D): void {
151
- * ctx.draw(new Graphics3D()
152
- * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 }));
153
- * }
150
+ * render: (ctx) => ctx.draw(new Graphics3D()
151
+ * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 })),
154
152
  *
155
153
  * Nothing here touches a renderer: a built `Graphics3D` is handed to a
156
154
  * {@link RenderContext3D}, which splices its ops into the scene being recorded.
@@ -169,23 +167,19 @@ type ParamsOf<G> = Omit<G, "type">;
169
167
  *
170
168
  * ── Animation ─────────────────────────────────────────────────────────────────
171
169
  * A `Graphics3D` is rebuilt from scratch every frame, so animation is just
172
- * reading the node's own props while building:
170
+ * reading the node's own state while building:
173
171
  *
174
- * class Rig extends Canvas3D {
175
- * @property({ default: 0 }) declare spin: number;
176
- * @vector3Property() declare lift: Vector3;
172
+ * const Rig = component3d({
173
+ * key: "rig",
174
+ * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },
175
+ * render: (ctx, s) => ctx.draw(new Graphics3D()
176
+ * .box({ rotation: [0, s.spin, 0], position: s.lift })),
177
+ * });
178
+ * // a `to` of { spin: 360 } over two seconds turns it
177
179
  *
178
- * protected buildScene3D(scene: Scene3D): void {
179
- * scene.draw(new Graphics3D()
180
- * .box({ rotation: [0, this.spin, 0], position: this.lift }));
181
- * }
182
- * }
183
- * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })
184
- *
185
- * Note `@vector3Property` rather than a bare `@property`. A prop holding a
186
- * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,
187
- * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it
188
- * alone; the attribute-typed decorators carry the right one already.
180
+ * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit
181
+ * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing
182
+ * to interpolate it with and leaves it alone.
189
183
  *
190
184
  * ── Reconciliation identity ───────────────────────────────────────────────────
191
185
  * The renderer caches one live 3D object per op and mutates it between frames
@@ -1 +1 @@
1
- {"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,KAAK,EACR,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAClE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAClE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EACvE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EACvD,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,WAAW,CAAA;CAAE,GAC7G;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC,sEAAsE;IACtE,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,WAAW,CAAC;CAC3B,GACC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,WAAW,CAAA;CAAE,GACvF;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,CAAC;CAC3B,GACC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,WAAW,CAAA;CAAE,GACjE;IACE,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEN;;;;;GAKG;AACH,gBAAgB;AAChB,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAE7C,CAAC;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IAC9C,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAsChE;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,UAAU,GAAG,SAAS,UAAU,EAAE,CAc1G;AAcD,+EAA+E;AAC/E,KAAK,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAInC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,IAAI,CAAsB;IAElC,2EAA2E;IAC3E,OAAO,CAAC,MAAM;IAOd;;;OAGG;IACH,IAAI,CACA,QAAQ,EAAE,UAAU,EACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,EAC7C,SAAS,CAAC,EAAE,WAAW,GACxB,IAAI;IAUP,sEAAsE;IACtE,OAAO,CAAC,KAAK;IASb,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,eAAe,GAAG,IAAI;IAG9D,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,eAAe,GAAG,IAAI;IAGpE,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,eAAe,GAAG,IAAI;IAGlE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,eAAe,GAAG,IAAI;IAGxE,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,eAAe,GAAG,IAAI;IAGhE,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,eAAe,GAAG,IAAI;IAGlE,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,eAAe,GAAG,IAAI;IAG1E,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,eAAe,GAAG,IAAI;IAGpE,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,eAAe,GAAG,IAAI;IAGhE,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,eAAe,GAAG,IAAI;IAGtE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,eAAe,GAAG,IAAI;IAG3E,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,eAAe,GAAG,IAAI;IAGrE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,eAAe,GAAG,IAAI;IAGjE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,eAAe,GAAG,IAAI;IAM/D;;;;;;OAMG;IACH,SAAS,CACL,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,SAAS,WAAW,EAAE,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,WAAW,CAAA;KAAE,GACjE,IAAI;IAYP,2EAA2E;IAC3E,MAAM,CACF,QAAQ,EAAE,UAAU,EACpB,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,WAAW,GACxB,IAAI;IAUP;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAO,EAAE;QACV,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;QACjC,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,6CAA6C;QAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,oDAAoD;QACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,mEAAmE;QACnE,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,WAAW,CAAC;KAC3B,GAAG,WAAW,GAAG,IAAI;IA2BtB,4CAA4C;IAC5C,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,GAAG,IAAI;IAiB/F;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAAC;QAC3D,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;KACnD,GAAG,WAAW,GAAG,IAAI;IAgBtB,4DAA4D;IAC5D,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,yCAAyC;IACzC,OAAO,IAAI,OAAO;CAGrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IACzB,gEAAgE;IAChE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrC"}
1
+ {"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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"}
@@ -94,10 +94,8 @@ function pickGeometry(source, type) {
94
94
  * the `Node3D` tree owns them. The exact division `Graphics2D` and
95
95
  * `RenderContext2D` already make in 2D.
96
96
  *
97
- * protected renderSelf(ctx: RenderContext3D): void {
98
- * ctx.draw(new Graphics3D()
99
- * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 }));
100
- * }
97
+ * render: (ctx) => ctx.draw(new Graphics3D()
98
+ * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 })),
101
99
  *
102
100
  * Nothing here touches a renderer: a built `Graphics3D` is handed to a
103
101
  * {@link RenderContext3D}, which splices its ops into the scene being recorded.
@@ -116,23 +114,19 @@ function pickGeometry(source, type) {
116
114
  *
117
115
  * ── Animation ─────────────────────────────────────────────────────────────────
118
116
  * A `Graphics3D` is rebuilt from scratch every frame, so animation is just
119
- * reading the node's own props while building:
117
+ * reading the node's own state while building:
120
118
  *
121
- * class Rig extends Canvas3D {
122
- * @property({ default: 0 }) declare spin: number;
123
- * @vector3Property() declare lift: Vector3;
119
+ * const Rig = component3d({
120
+ * key: "rig",
121
+ * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },
122
+ * render: (ctx, s) => ctx.draw(new Graphics3D()
123
+ * .box({ rotation: [0, s.spin, 0], position: s.lift })),
124
+ * });
125
+ * // a `to` of { spin: 360 } over two seconds turns it
124
126
  *
125
- * protected buildScene3D(scene: Scene3D): void {
126
- * scene.draw(new Graphics3D()
127
- * .box({ rotation: [0, this.spin, 0], position: this.lift }));
128
- * }
129
- * }
130
- * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })
131
- *
132
- * Note `@vector3Property` rather than a bare `@property`. A prop holding a
133
- * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,
134
- * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it
135
- * alone; the attribute-typed decorators carry the right one already.
127
+ * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit
128
+ * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing
129
+ * to interpolate it with and leaves it alone.
136
130
  *
137
131
  * ── Reconciliation identity ───────────────────────────────────────────────────
138
132
  * The renderer caches one live 3D object per op and mutates it between frames
@@ -271,7 +265,7 @@ export class Graphics3D {
271
265
  };
272
266
  this.record({
273
267
  kind: "line",
274
- geometry: geometry ?? { type: "buffer", position: flattenPoints(points) },
268
+ geometry: geometry ?? lineBuffer(points),
275
269
  material: resolved,
276
270
  mode: segments ? "segments" : closed ? "loop" : "strip",
277
271
  transform: pickTransform(options),
@@ -326,21 +320,70 @@ export class Graphics3D {
326
320
  return this._ops.length === 0;
327
321
  }
328
322
  }
323
+ /** The buffer each points array was last flattened into, and the revision it was uploaded under. */
324
+ const lineBuffers = new WeakMap();
325
+ let lineRevision = 0;
326
+ /**
327
+ * `points` as a line's buffer. The same array holding the same values gets the
328
+ * same buffer and revision back, so a renderer uploads an unchanged line once,
329
+ * not every frame; the values are checked, so one changed in place still lands.
330
+ */
331
+ function lineBuffer(points) {
332
+ let kept = lineBuffers.get(points);
333
+ if (!kept || !holds(kept.position, points)) {
334
+ kept = { position: flattenPoints(points), revision: ++lineRevision };
335
+ lineBuffers.set(points, kept);
336
+ }
337
+ return { type: "buffer", position: kept.position, revision: kept.revision };
338
+ }
329
339
  /** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */
330
340
  function flattenPoints(points) {
331
- const out = [];
341
+ const out = new Float32Array(points.length * 3);
342
+ let i = 0;
332
343
  for (const point of points) {
333
344
  if (typeof point === "number") {
334
- out.push(point, point, point);
345
+ out[i] = out[i + 1] = out[i + 2] = point;
335
346
  }
336
347
  else if (Array.isArray(point)) {
337
- out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);
348
+ out[i] = point[0] ?? 0;
349
+ out[i + 1] = point[1] ?? 0;
350
+ out[i + 2] = point[2] ?? 0;
338
351
  }
339
352
  else {
340
353
  const v = point;
341
- out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);
354
+ out[i] = v.x ?? 0;
355
+ out[i + 1] = v.y ?? 0;
356
+ out[i + 2] = v.z ?? 0;
342
357
  }
358
+ i += 3;
343
359
  }
344
360
  return out;
345
361
  }
362
+ /** Whether `buffer` is what flattening `points` would give. */
363
+ function holds(buffer, points) {
364
+ if (buffer.length !== points.length * 3)
365
+ return false;
366
+ let i = 0;
367
+ for (const point of points) {
368
+ let x, y, z;
369
+ if (typeof point === "number") {
370
+ x = y = z = point;
371
+ }
372
+ else if (Array.isArray(point)) {
373
+ x = point[0] ?? 0;
374
+ y = point[1] ?? 0;
375
+ z = point[2] ?? 0;
376
+ }
377
+ else {
378
+ const v = point;
379
+ x = v.x ?? 0;
380
+ y = v.y ?? 0;
381
+ z = v.z ?? 0;
382
+ }
383
+ if (buffer[i] !== Math.fround(x) || buffer[i + 1] !== Math.fround(y) || buffer[i + 2] !== Math.fround(z))
384
+ return false;
385
+ i += 3;
386
+ }
387
+ return true;
388
+ }
346
389
  //# sourceMappingURL=graphics3d.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"./geometry\";\r\nimport type { Material3D, Shading3D } from \"./material\";\r\nimport type { Texture3D } from \"./texture\";\r\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\r\nimport { inspectDrawable3D } from \"./inert\";\r\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\r\nimport type { Vector3Input } from \"./vector3\";\r\n\r\n// ─── Ops ─────────────────────────────────────────────────────────────────────\r\n\r\n/** One clip of a model's baked animation, sampled at an explicit time. */\r\nexport interface ModelAnimation3D {\r\n /** Clip name, or its index in the file. Defaults to the first clip. */\r\n clip?: string | number;\r\n /**\r\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\r\n * time rather than advancing by a delta, which is what keeps a model's\r\n * animation identical whether the frame was reached by playing forward or by\r\n * scrubbing backwards.\r\n */\r\n time: number;\r\n /** Blend weight, for cross-fading clips. Default 1. */\r\n weight?: number;\r\n}\r\n\r\n/**\r\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\r\n * or in order and closed back to the start.\r\n */\r\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\r\n\r\n/**\r\n * One recorded operation in a {@link Graphics3D} command list.\r\n *\r\n * Every op draws something. Hierarchy, lights and the camera are *scene*\r\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\r\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\r\n *\r\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\r\n * because in a 3D scene graph they are properties of an object rather than\r\n * children of it.\r\n */\r\nexport type Graphics3DOp =\r\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\r\n | {\r\n kind: \"instances\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n /** Per-instance placement. Length drives the instance count. */\r\n instances: readonly Transform3D[];\r\n /** Per-instance tint. Needs a material that reads instance colour. */\r\n colors?: readonly Color[];\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"line\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n mode: LineMode3D;\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"model\";\r\n src: string;\r\n animation?: readonly ModelAnimation3D[];\r\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\r\n override?: Readonly<Record<string, Material3D>>;\r\n transform?: Transform3D;\r\n };\r\n\r\n/**\r\n * Op kinds that put something in the scene (as opposed to shaping the tree).\r\n *\r\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\r\n * `camera` — so \"is anything actually drawn here\" has a single definition.\r\n */\r\n/** @internal */\r\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\r\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\r\n]);\r\n\r\n// ─── Shorthand ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Material fields promoted onto the geometry sugar methods, so the common case is\r\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\r\n *\r\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\r\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\r\n * (how light behaves on it) rather than colour, which is the line Spline's\r\n * material panel draws too and the reason those stay separate fields.\r\n *\r\n * These desugar at record time into a full {@link Material3D} — `standard` by\r\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\r\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\r\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\r\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\r\n */\r\nexport interface MaterialShorthand3D {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material?: Material3D | readonly Material3D[];\r\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\r\n fill?: Fill3D;\r\n opacity?: number;\r\n roughness?: number;\r\n metalness?: number;\r\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n normalMap?: Texture3D;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n aoMap?: Texture3D;\r\n alphaMap?: Texture3D;\r\n envMapIntensity?: number;\r\n wireframe?: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n vertexColors?: boolean;\r\n blend?: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit?: boolean;\r\n}\r\n\r\n/** Transform + material shorthand, accepted by every geometry sugar method. */\r\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\r\n\r\nconst TRANSFORM_KEYS = [\r\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\r\n \"visible\", \"shadow\", \"renderOrder\",\r\n] as const;\r\n\r\n/**\r\n * Shorthand keys copied straight onto the built descriptor.\r\n *\r\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\r\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\r\n */\r\nconst MATERIAL_SHORTHAND_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/** Every key the shorthand owns, for stripping a geometry bag. */\r\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\r\n\r\n/**\r\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\r\n * the concrete option types at each call site pass without a cast, and returns\r\n * `undefined` rather than `{}` when there is nothing to apply — an absent\r\n * transform lets the renderer skip the matrix write entirely.\r\n */\r\nfunction pickTransform(source: object): Transform3D | undefined {\r\n const bag = source as Record<string, unknown>;\r\n let out: Record<string, unknown> | undefined;\r\n for (const key of TRANSFORM_KEYS) {\r\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\r\n }\r\n return out as Transform3D | undefined;\r\n}\r\n\r\n/**\r\n * Build the material a shorthand bag describes. Always returns one, so a recorded\r\n * drawable op never has to be interpreted with \"…or the default\" in mind.\r\n *\r\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\r\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\r\n * two chances for a node and a builder call to paint differently.\r\n *\r\n * @internal\r\n */\r\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\r\n if (source.material !== undefined) return source.material;\r\n\r\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\r\n\r\n const fill = resolveFill3D(source.fill);\r\n if (fill.color !== undefined) material.color = fill.color;\r\n if (fill.map !== undefined) material.map = fill.map;\r\n\r\n for (const key of MATERIAL_SHORTHAND_KEYS) {\r\n const value = (source as Record<string, unknown>)[key];\r\n if (value !== undefined) material[key] = value;\r\n }\r\n return material as unknown as Material3D;\r\n}\r\n\r\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\r\nfunction pickGeometry<T>(source: object, type: string): T {\r\n const bag = source as Record<string, unknown>;\r\n const out: Record<string, unknown> = { type };\r\n for (const key in bag) {\r\n if (SHORTHAND_KEYS.includes(key)) continue;\r\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\r\n if (bag[key] !== undefined) out[key] = bag[key];\r\n }\r\n return out as T;\r\n}\r\n\r\n/** Geometry params only, with `type` and the inherited passthrough removed. */\r\ntype ParamsOf<G> = Omit<G, \"type\">;\r\n\r\n// ─── Recorder ────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * What one 3D node draws — the `Graphics2D` of 3D.\r\n *\r\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\r\n * sprites, models), each with its own geometry, material and local transform.\r\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\r\n * because those are properties of a *scene* rather than of a thing in one, and\r\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\r\n * `RenderContext2D` already make in 2D.\r\n *\r\n * protected renderSelf(ctx: RenderContext3D): void {\r\n * ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 }));\r\n * }\r\n *\r\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\r\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\r\n *\r\n * ── One flat bag, deliberately ────────────────────────────────────────────────\r\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\r\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\r\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\r\n * belongs to exactly one object, because a mesh *is* geometry plus material.\r\n * A chained `.box().fill()` would imply a group material that has nothing to\r\n * scope over, so the shape and what it is made of are stated together instead.\r\n *\r\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\r\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\r\n * matching the engine's 2D `rotation`. The renderer converts.\r\n *\r\n * ── Animation ─────────────────────────────────────────────────────────────────\r\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\r\n * reading the node's own props while building:\r\n *\r\n * class Rig extends Canvas3D {\r\n * @property({ default: 0 }) declare spin: number;\r\n * @vector3Property() declare lift: Vector3;\r\n *\r\n * protected buildScene3D(scene: Scene3D): void {\r\n * scene.draw(new Graphics3D()\r\n * .box({ rotation: [0, this.spin, 0], position: this.lift }));\r\n * }\r\n * }\r\n * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })\r\n *\r\n * Note `@vector3Property` rather than a bare `@property`. A prop holding a\r\n * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,\r\n * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it\r\n * alone; the attribute-typed decorators carry the right one already.\r\n *\r\n * ── Reconciliation identity ───────────────────────────────────────────────────\r\n * The renderer caches one live 3D object per op and mutates it between frames\r\n * rather than rebuilding. Identity is **derived**: it comes from the owning\r\n * `Node3D` plus a signature of what the op actually draws, so a builder that\r\n * emits ops conditionally reuses the right cache entry with nothing written by\r\n * hand. There is no `key` to set.\r\n *\r\n * ── What is cheap to animate ──────────────────────────────────────────────────\r\n * Transforms and most material values are in-place writes, so they cost nothing\r\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\r\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\r\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\r\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\r\n * set once, not tweened.\r\n */\r\nexport class Graphics3D {\r\n private _ops: Graphics3DOp[] = [];\r\n\r\n /** Append one op, flagging (in development) inputs no renderer acts on. */\r\n private record(op: Graphics3DOp): void {\r\n inspectDrawable3D(op);\r\n this._ops.push(op);\r\n }\r\n\r\n // ─── Meshes ──────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record a mesh from an explicit geometry and material. The geometry sugar\r\n * methods below all funnel here.\r\n */\r\n mesh(\r\n geometry: Geometry3D,\r\n material?: Material3D | readonly Material3D[],\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"mesh\",\r\n geometry,\r\n material: material ?? { type: \"standard\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\r\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\r\n const source: MeshShorthand3D = options ?? {};\r\n return this.mesh(\r\n pickGeometry<Geometry3D>(source, type),\r\n resolveMaterialShorthand3D(source),\r\n pickTransform(source),\r\n );\r\n }\r\n\r\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"box\", options);\r\n }\r\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"sphere\", options);\r\n }\r\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"plane\", options);\r\n }\r\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cylinder\", options);\r\n }\r\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cone\", options);\r\n }\r\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torus\", options);\r\n }\r\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torusKnot\", options);\r\n }\r\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"circle\", options);\r\n }\r\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"ring\", options);\r\n }\r\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"capsule\", options);\r\n }\r\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"polyhedron\", options);\r\n }\r\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"extrude\", options);\r\n }\r\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"lathe\", options);\r\n }\r\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"tube\", options);\r\n }\r\n\r\n // ─── Other drawables ─────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record many copies of one geometry in a single draw call. The way to put\r\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\r\n *\r\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\r\n * positions.map(p => ({ position: p })))\r\n */\r\n instances(\r\n geometry: Geometry3D,\r\n material: Material3D,\r\n instances: readonly Transform3D[],\r\n options?: { colors?: readonly Color[]; transform?: Transform3D },\r\n ): this {\r\n this.record({\r\n kind: \"instances\",\r\n geometry,\r\n material,\r\n instances,\r\n colors: options?.colors,\r\n transform: options?.transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\r\n points(\r\n geometry: Geometry3D,\r\n material?: Material3D,\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"points\",\r\n geometry,\r\n material: material ?? { type: \"points\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a line. Give it either explicit `points` or a `geometry` (typically\r\n * `Geo.edges(...)` for a wireframe outline).\r\n *\r\n * `closed` joins the last point back to the first, as the 2D `line` op's\r\n * own field does. `segments` treats the points as disjoint start/end pairs\r\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\r\n * confuse it with: a line is drawn from the points it is given.)\r\n */\r\n line(options: {\r\n points?: readonly Vector3Input[];\r\n geometry?: Geometry3D;\r\n material?: Material3D;\r\n /** Join the last point back to the first. */\r\n closed?: boolean;\r\n /** Treat the points as disjoint start/end pairs. */\r\n segments?: boolean;\r\n /** The line's paint. Cap and join have no meaning on a GL line. */\r\n stroke?: LineStroke3D;\r\n opacity?: number;\r\n transform?: Transform3D;\r\n } & Transform3D): this {\r\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\r\n\r\n if (!points && !geometry) {\r\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\r\n }\r\n\r\n const resolved: Material3D = material ?? {\r\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\r\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\r\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\r\n ...(stroke?.dash !== undefined\r\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\r\n : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n\r\n this.record({\r\n kind: \"line\",\r\n geometry: geometry ?? { type: \"buffer\", position: flattenPoints(points!) },\r\n material: resolved,\r\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a camera-facing textured quad. */\r\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\r\n const { fill, material, opacity } = options;\r\n const paint = resolveFill3D(fill);\r\n const resolved: Material3D = material ?? {\r\n type: \"sprite\",\r\n ...(paint.map !== undefined ? { map: paint.map } : {}),\r\n ...(paint.color !== undefined ? { color: paint.color } : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n this.record({\r\n kind: \"sprite\",\r\n material: resolved,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\r\n * resolves to an empty slot and draws nothing, and in development the first\r\n * one recorded warns.\r\n *\r\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\r\n * a model stays frame-identical under scrubbing.\r\n */\r\n model(options: {\r\n src: string;\r\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\r\n override?: Readonly<Record<string, Material3D>>;\r\n } & Transform3D): this {\r\n const { src, animation, override } = options;\r\n this.record({\r\n kind: \"model\",\r\n src,\r\n animation: animation === undefined\r\n ? undefined\r\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\r\n override,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n // ─── Consumption ─────────────────────────────────────────────────────────\r\n\r\n /** The recorded ops, in order. Replayed by the renderer. */\r\n ops(): readonly Graphics3DOp[] {\r\n return this._ops;\r\n }\r\n\r\n /** True when this node draws nothing. */\r\n isEmpty(): boolean {\r\n return this._ops.length === 0;\r\n }\r\n}\r\n\r\n/**\r\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\r\n *\r\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\r\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\r\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\r\n * thick line, draw a `tube`.\r\n */\r\nexport interface LineStroke3D {\r\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\r\n fill?: Color;\r\n weight?: number;\r\n /** Dash and gap lengths, in world units. */\r\n dash?: readonly [number, number?];\r\n}\r\n\r\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\r\nfunction flattenPoints(points: readonly Vector3Input[]): number[] {\r\n const out: number[] = [];\r\n for (const point of points) {\r\n if (typeof point === \"number\") {\r\n out.push(point, point, point);\r\n } else if (Array.isArray(point)) {\r\n out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);\r\n }\r\n }\r\n return out;\r\n}\r\n"]}
1
+ {"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"./geometry\";\r\nimport type { Material3D, Shading3D } from \"./material\";\r\nimport type { Texture3D } from \"./texture\";\r\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\r\nimport { inspectDrawable3D } from \"./inert\";\r\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\r\nimport type { Vector3Input } from \"./vector3\";\r\n\r\n// ─── Ops ─────────────────────────────────────────────────────────────────────\r\n\r\n/** One clip of a model's baked animation, sampled at an explicit time. */\r\nexport interface ModelAnimation3D {\r\n /** Clip name, or its index in the file. Defaults to the first clip. */\r\n clip?: string | number;\r\n /**\r\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\r\n * time rather than advancing by a delta, which is what keeps a model's\r\n * animation identical whether the frame was reached by playing forward or by\r\n * scrubbing backwards.\r\n */\r\n time: number;\r\n /** Blend weight, for cross-fading clips. Default 1. */\r\n weight?: number;\r\n}\r\n\r\n/**\r\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\r\n * or in order and closed back to the start.\r\n */\r\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\r\n\r\n/**\r\n * One recorded operation in a {@link Graphics3D} command list.\r\n *\r\n * Every op draws something. Hierarchy, lights and the camera are *scene*\r\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\r\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\r\n *\r\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\r\n * because in a 3D scene graph they are properties of an object rather than\r\n * children of it.\r\n */\r\nexport type Graphics3DOp =\r\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\r\n | {\r\n kind: \"instances\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n /** Per-instance placement. Length drives the instance count. */\r\n instances: readonly Transform3D[];\r\n /** Per-instance tint. Needs a material that reads instance colour. */\r\n colors?: readonly Color[];\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"line\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n mode: LineMode3D;\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"model\";\r\n src: string;\r\n animation?: readonly ModelAnimation3D[];\r\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\r\n override?: Readonly<Record<string, Material3D>>;\r\n transform?: Transform3D;\r\n };\r\n\r\n/**\r\n * Op kinds that put something in the scene (as opposed to shaping the tree).\r\n *\r\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\r\n * `camera` — so \"is anything actually drawn here\" has a single definition.\r\n */\r\n/** @internal */\r\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\r\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\r\n]);\r\n\r\n// ─── Shorthand ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Material fields promoted onto the geometry sugar methods, so the common case is\r\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\r\n *\r\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\r\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\r\n * (how light behaves on it) rather than colour, which is the line Spline's\r\n * material panel draws too and the reason those stay separate fields.\r\n *\r\n * These desugar at record time into a full {@link Material3D} — `standard` by\r\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\r\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\r\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\r\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\r\n */\r\nexport interface MaterialShorthand3D {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material?: Material3D | readonly Material3D[];\r\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\r\n fill?: Fill3D;\r\n opacity?: number;\r\n roughness?: number;\r\n metalness?: number;\r\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n normalMap?: Texture3D;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n aoMap?: Texture3D;\r\n alphaMap?: Texture3D;\r\n envMapIntensity?: number;\r\n wireframe?: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n vertexColors?: boolean;\r\n blend?: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit?: boolean;\r\n}\r\n\r\n/** Transform + material shorthand, accepted by every geometry sugar method. */\r\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\r\n\r\nconst TRANSFORM_KEYS = [\r\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\r\n \"visible\", \"shadow\", \"renderOrder\",\r\n] as const;\r\n\r\n/**\r\n * Shorthand keys copied straight onto the built descriptor.\r\n *\r\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\r\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\r\n */\r\nconst MATERIAL_SHORTHAND_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/** Every key the shorthand owns, for stripping a geometry bag. */\r\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\r\n\r\n/**\r\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\r\n * the concrete option types at each call site pass without a cast, and returns\r\n * `undefined` rather than `{}` when there is nothing to apply — an absent\r\n * transform lets the renderer skip the matrix write entirely.\r\n */\r\nfunction pickTransform(source: object): Transform3D | undefined {\r\n const bag = source as Record<string, unknown>;\r\n let out: Record<string, unknown> | undefined;\r\n for (const key of TRANSFORM_KEYS) {\r\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\r\n }\r\n return out as Transform3D | undefined;\r\n}\r\n\r\n/**\r\n * Build the material a shorthand bag describes. Always returns one, so a recorded\r\n * drawable op never has to be interpreted with \"…or the default\" in mind.\r\n *\r\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\r\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\r\n * two chances for a node and a builder call to paint differently.\r\n *\r\n * @internal\r\n */\r\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\r\n if (source.material !== undefined) return source.material;\r\n\r\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\r\n\r\n const fill = resolveFill3D(source.fill);\r\n if (fill.color !== undefined) material.color = fill.color;\r\n if (fill.map !== undefined) material.map = fill.map;\r\n\r\n for (const key of MATERIAL_SHORTHAND_KEYS) {\r\n const value = (source as Record<string, unknown>)[key];\r\n if (value !== undefined) material[key] = value;\r\n }\r\n return material as unknown as Material3D;\r\n}\r\n\r\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\r\nfunction pickGeometry<T>(source: object, type: string): T {\r\n const bag = source as Record<string, unknown>;\r\n const out: Record<string, unknown> = { type };\r\n for (const key in bag) {\r\n if (SHORTHAND_KEYS.includes(key)) continue;\r\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\r\n if (bag[key] !== undefined) out[key] = bag[key];\r\n }\r\n return out as T;\r\n}\r\n\r\n/** Geometry params only, with `type` and the inherited passthrough removed. */\r\ntype ParamsOf<G> = Omit<G, \"type\">;\r\n\r\n// ─── Recorder ────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * What one 3D node draws — the `Graphics2D` of 3D.\r\n *\r\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\r\n * sprites, models), each with its own geometry, material and local transform.\r\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\r\n * because those are properties of a *scene* rather than of a thing in one, and\r\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\r\n * `RenderContext2D` already make in 2D.\r\n *\r\n * render: (ctx) => ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 })),\r\n *\r\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\r\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\r\n *\r\n * ── One flat bag, deliberately ────────────────────────────────────────────────\r\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\r\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\r\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\r\n * belongs to exactly one object, because a mesh *is* geometry plus material.\r\n * A chained `.box().fill()` would imply a group material that has nothing to\r\n * scope over, so the shape and what it is made of are stated together instead.\r\n *\r\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\r\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\r\n * matching the engine's 2D `rotation`. The renderer converts.\r\n *\r\n * ── Animation ─────────────────────────────────────────────────────────────────\r\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\r\n * reading the node's own state while building:\r\n *\r\n * const Rig = component3d({\r\n * key: \"rig\",\r\n * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },\r\n * render: (ctx, s) => ctx.draw(new Graphics3D()\r\n * .box({ rotation: [0, s.spin, 0], position: s.lift })),\r\n * });\r\n * // a `to` of { spin: 360 } over two seconds turns it\r\n *\r\n * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit\r\n * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing\r\n * to interpolate it with and leaves it alone.\r\n *\r\n * ── Reconciliation identity ───────────────────────────────────────────────────\r\n * The renderer caches one live 3D object per op and mutates it between frames\r\n * rather than rebuilding. Identity is **derived**: it comes from the owning\r\n * `Node3D` plus a signature of what the op actually draws, so a builder that\r\n * emits ops conditionally reuses the right cache entry with nothing written by\r\n * hand. There is no `key` to set.\r\n *\r\n * ── What is cheap to animate ──────────────────────────────────────────────────\r\n * Transforms and most material values are in-place writes, so they cost nothing\r\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\r\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\r\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\r\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\r\n * set once, not tweened.\r\n */\r\nexport class Graphics3D {\r\n private _ops: Graphics3DOp[] = [];\r\n\r\n /** Append one op, flagging (in development) inputs no renderer acts on. */\r\n private record(op: Graphics3DOp): void {\r\n inspectDrawable3D(op);\r\n this._ops.push(op);\r\n }\r\n\r\n // ─── Meshes ──────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record a mesh from an explicit geometry and material. The geometry sugar\r\n * methods below all funnel here.\r\n */\r\n mesh(\r\n geometry: Geometry3D,\r\n material?: Material3D | readonly Material3D[],\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"mesh\",\r\n geometry,\r\n material: material ?? { type: \"standard\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\r\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\r\n const source: MeshShorthand3D = options ?? {};\r\n return this.mesh(\r\n pickGeometry<Geometry3D>(source, type),\r\n resolveMaterialShorthand3D(source),\r\n pickTransform(source),\r\n );\r\n }\r\n\r\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"box\", options);\r\n }\r\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"sphere\", options);\r\n }\r\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"plane\", options);\r\n }\r\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cylinder\", options);\r\n }\r\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cone\", options);\r\n }\r\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torus\", options);\r\n }\r\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torusKnot\", options);\r\n }\r\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"circle\", options);\r\n }\r\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"ring\", options);\r\n }\r\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"capsule\", options);\r\n }\r\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"polyhedron\", options);\r\n }\r\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"extrude\", options);\r\n }\r\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"lathe\", options);\r\n }\r\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"tube\", options);\r\n }\r\n\r\n // ─── Other drawables ─────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record many copies of one geometry in a single draw call. The way to put\r\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\r\n *\r\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\r\n * positions.map(p => ({ position: p })))\r\n */\r\n instances(\r\n geometry: Geometry3D,\r\n material: Material3D,\r\n instances: readonly Transform3D[],\r\n options?: { colors?: readonly Color[]; transform?: Transform3D },\r\n ): this {\r\n this.record({\r\n kind: \"instances\",\r\n geometry,\r\n material,\r\n instances,\r\n colors: options?.colors,\r\n transform: options?.transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\r\n points(\r\n geometry: Geometry3D,\r\n material?: Material3D,\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"points\",\r\n geometry,\r\n material: material ?? { type: \"points\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a line. Give it either explicit `points` or a `geometry` (typically\r\n * `Geo.edges(...)` for a wireframe outline).\r\n *\r\n * `closed` joins the last point back to the first, as the 2D `line` op's\r\n * own field does. `segments` treats the points as disjoint start/end pairs\r\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\r\n * confuse it with: a line is drawn from the points it is given.)\r\n */\r\n line(options: {\r\n points?: readonly Vector3Input[];\r\n geometry?: Geometry3D;\r\n material?: Material3D;\r\n /** Join the last point back to the first. */\r\n closed?: boolean;\r\n /** Treat the points as disjoint start/end pairs. */\r\n segments?: boolean;\r\n /** The line's paint. Cap and join have no meaning on a GL line. */\r\n stroke?: LineStroke3D;\r\n opacity?: number;\r\n transform?: Transform3D;\r\n } & Transform3D): this {\r\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\r\n\r\n if (!points && !geometry) {\r\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\r\n }\r\n\r\n const resolved: Material3D = material ?? {\r\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\r\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\r\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\r\n ...(stroke?.dash !== undefined\r\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\r\n : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n\r\n this.record({\r\n kind: \"line\",\r\n geometry: geometry ?? lineBuffer(points!),\r\n material: resolved,\r\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a camera-facing textured quad. */\r\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\r\n const { fill, material, opacity } = options;\r\n const paint = resolveFill3D(fill);\r\n const resolved: Material3D = material ?? {\r\n type: \"sprite\",\r\n ...(paint.map !== undefined ? { map: paint.map } : {}),\r\n ...(paint.color !== undefined ? { color: paint.color } : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n this.record({\r\n kind: \"sprite\",\r\n material: resolved,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\r\n * resolves to an empty slot and draws nothing, and in development the first\r\n * one recorded warns.\r\n *\r\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\r\n * a model stays frame-identical under scrubbing.\r\n */\r\n model(options: {\r\n src: string;\r\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\r\n override?: Readonly<Record<string, Material3D>>;\r\n } & Transform3D): this {\r\n const { src, animation, override } = options;\r\n this.record({\r\n kind: \"model\",\r\n src,\r\n animation: animation === undefined\r\n ? undefined\r\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\r\n override,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n // ─── Consumption ─────────────────────────────────────────────────────────\r\n\r\n /** The recorded ops, in order. Replayed by the renderer. */\r\n ops(): readonly Graphics3DOp[] {\r\n return this._ops;\r\n }\r\n\r\n /** True when this node draws nothing. */\r\n isEmpty(): boolean {\r\n return this._ops.length === 0;\r\n }\r\n}\r\n\r\n/**\r\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\r\n *\r\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\r\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\r\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\r\n * thick line, draw a `tube`.\r\n */\r\nexport interface LineStroke3D {\r\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\r\n fill?: Color;\r\n weight?: number;\r\n /** Dash and gap lengths, in world units. */\r\n dash?: readonly [number, number?];\r\n}\r\n\r\n/** The buffer each points array was last flattened into, and the revision it was uploaded under. */\r\nconst lineBuffers = new WeakMap<readonly Vector3Input[], { readonly position: Float32Array; readonly revision: number }>();\r\nlet lineRevision = 0;\r\n\r\n/**\r\n * `points` as a line's buffer. The same array holding the same values gets the\r\n * same buffer and revision back, so a renderer uploads an unchanged line once,\r\n * not every frame; the values are checked, so one changed in place still lands.\r\n */\r\nfunction lineBuffer(points: readonly Vector3Input[]): BufferGeometry3D {\r\n let kept = lineBuffers.get(points);\r\n if (!kept || !holds(kept.position, points)) {\r\n kept = { position: flattenPoints(points), revision: ++lineRevision };\r\n lineBuffers.set(points, kept);\r\n }\r\n return { type: \"buffer\", position: kept.position, revision: kept.revision };\r\n}\r\n\r\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\r\nfunction flattenPoints(points: readonly Vector3Input[]): Float32Array {\r\n const out = new Float32Array(points.length * 3);\r\n let i = 0;\r\n for (const point of points) {\r\n if (typeof point === \"number\") {\r\n out[i] = out[i + 1] = out[i + 2] = point;\r\n } else if (Array.isArray(point)) {\r\n out[i] = point[0] ?? 0;\r\n out[i + 1] = point[1] ?? 0;\r\n out[i + 2] = point[2] ?? 0;\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n out[i] = v.x ?? 0;\r\n out[i + 1] = v.y ?? 0;\r\n out[i + 2] = v.z ?? 0;\r\n }\r\n i += 3;\r\n }\r\n return out;\r\n}\r\n\r\n/** Whether `buffer` is what flattening `points` would give. */\r\nfunction holds(buffer: Float32Array, points: readonly Vector3Input[]): boolean {\r\n if (buffer.length !== points.length * 3) return false;\r\n let i = 0;\r\n for (const point of points) {\r\n let x: number, y: number, z: number;\r\n if (typeof point === \"number\") {\r\n x = y = z = point;\r\n } else if (Array.isArray(point)) {\r\n x = point[0] ?? 0;\r\n y = point[1] ?? 0;\r\n z = point[2] ?? 0;\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n x = v.x ?? 0;\r\n y = v.y ?? 0;\r\n z = v.z ?? 0;\r\n }\r\n if (buffer[i] !== Math.fround(x) || buffer[i + 1] !== Math.fround(y) || buffer[i + 2] !== Math.fround(z)) return false;\r\n i += 3;\r\n }\r\n return true;\r\n}\r\n"]}
@@ -46,7 +46,7 @@ export type Scene3DOp = {
46
46
  * .light({ type: "ambient", intensity: 0.4 })
47
47
  * .draw(new Graphics3D().box({ width: 2, fill: "tomato" }));
48
48
  *
49
- * <Text text="DEPTH" fontSize={320} fill={scene} />
49
+ * Text({ text: "DEPTH", fontSize: 320, fill: scene })
50
50
  *
51
51
  * A bare `Scene3D` coerces to a `canvas3D` fill the way a bare CSS string coerces
52
52
  * to a solid one, so `fill={scene}` and `fill={["#0b0d12", scene]}` both work.
@@ -19,7 +19,7 @@ import { warnInert3D } from "./inert.js";
19
19
  * .light({ type: "ambient", intensity: 0.4 })
20
20
  * .draw(new Graphics3D().box({ width: 2, fill: "tomato" }));
21
21
  *
22
- * <Text text="DEPTH" fontSize={320} fill={scene} />
22
+ * Text({ text: "DEPTH", fontSize: 320, fill: scene })
23
23
  *
24
24
  * A bare `Scene3D` coerces to a `canvas3D` fill the way a bare CSS string coerces
25
25
  * to a solid one, so `fill={scene}` and `fill={["#0b0d12", scene]}` both work.