@motionscript/core 0.1.0-alpha.0 → 0.1.0-alpha.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (767) hide show
  1. package/CHANGELOG.md +282 -0
  2. package/LICENSE +201 -201
  3. package/NOTICE +48 -0
  4. package/README.md +93 -72
  5. package/dist/assets/asset-index.js.map +1 -1
  6. package/dist/assets/catalog.d.ts +9 -0
  7. package/dist/assets/catalog.d.ts.map +1 -1
  8. package/dist/assets/catalog.js +11 -0
  9. package/dist/assets/catalog.js.map +1 -1
  10. package/dist/assets/errors.d.ts.map +1 -1
  11. package/dist/assets/errors.js +8 -3
  12. package/dist/assets/errors.js.map +1 -1
  13. package/dist/assets/index.js.map +1 -1
  14. package/dist/assets/manager.d.ts +26 -1
  15. package/dist/assets/manager.d.ts.map +1 -1
  16. package/dist/assets/manager.js +93 -11
  17. package/dist/assets/manager.js.map +1 -1
  18. package/dist/assets/manifest.js.map +1 -1
  19. package/dist/assets/record.js.map +1 -1
  20. package/dist/assets/scope.d.ts +3 -3
  21. package/dist/assets/scope.d.ts.map +1 -1
  22. package/dist/assets/scope.js.map +1 -1
  23. package/dist/attributes/audio/filters/chain.d.ts +1 -1
  24. package/dist/attributes/audio/filters/chain.js.map +1 -1
  25. package/dist/attributes/audio/filters/curve.d.ts +8 -8
  26. package/dist/attributes/audio/filters/curve.d.ts.map +1 -1
  27. package/dist/attributes/audio/filters/curve.js +20 -19
  28. package/dist/attributes/audio/filters/curve.js.map +1 -1
  29. package/dist/attributes/audio/filters/implementations/echo.js.map +1 -1
  30. package/dist/attributes/audio/filters/implementations/gain.js.map +1 -1
  31. package/dist/attributes/audio/filters/implementations/highpass.js.map +1 -1
  32. package/dist/attributes/audio/filters/implementations/lowpass.js.map +1 -1
  33. package/dist/attributes/audio/filters/implementations/speed.d.ts +2 -2
  34. package/dist/attributes/audio/filters/implementations/speed.js.map +1 -1
  35. package/dist/attributes/audio/filters/implementations/tremolo.js.map +1 -1
  36. package/dist/attributes/audio/filters/index.d.ts +1 -1
  37. package/dist/attributes/audio/filters/index.d.ts.map +1 -1
  38. package/dist/attributes/audio/filters/index.js +1 -1
  39. package/dist/attributes/audio/filters/index.js.map +1 -1
  40. package/dist/attributes/audio/filters/registry.js.map +1 -1
  41. package/dist/attributes/audio/filters/union.js.map +1 -1
  42. package/dist/attributes/audio/request.d.ts +32 -4
  43. package/dist/attributes/audio/request.d.ts.map +1 -1
  44. package/dist/attributes/audio/request.js +9 -1
  45. package/dist/attributes/audio/request.js.map +1 -1
  46. package/dist/attributes/audio/schedule.d.ts +11 -2
  47. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  48. package/dist/attributes/audio/schedule.js +15 -8
  49. package/dist/attributes/audio/schedule.js.map +1 -1
  50. package/dist/attributes/audio/sound.d.ts +4 -2
  51. package/dist/attributes/audio/sound.d.ts.map +1 -1
  52. package/dist/attributes/audio/sound.js +8 -4
  53. package/dist/attributes/audio/sound.js.map +1 -1
  54. package/dist/attributes/index.d.ts +1 -0
  55. package/dist/attributes/index.d.ts.map +1 -1
  56. package/dist/attributes/index.js +1 -0
  57. package/dist/attributes/index.js.map +1 -1
  58. package/dist/attributes/layout/alignment.js +1 -1
  59. package/dist/attributes/layout/alignment.js.map +1 -1
  60. package/dist/attributes/layout/index.js.map +1 -1
  61. package/dist/attributes/layout/insets.js.map +1 -1
  62. package/dist/attributes/layout/matrix2d.js.map +1 -1
  63. package/dist/attributes/layout/size.js.map +1 -1
  64. package/dist/attributes/layout/transform3d.js.map +1 -1
  65. package/dist/attributes/layout/vector2.js.map +1 -1
  66. package/dist/attributes/layout/world-transform.js.map +1 -1
  67. package/dist/attributes/mask/boolean.js.map +1 -1
  68. package/dist/attributes/mask/mask.js.map +1 -1
  69. package/dist/attributes/properties/decorator.d.ts +17 -6
  70. package/dist/attributes/properties/decorator.d.ts.map +1 -1
  71. package/dist/attributes/properties/decorator.js +26 -14
  72. package/dist/attributes/properties/decorator.js.map +1 -1
  73. package/dist/attributes/properties/inputs.js.map +1 -1
  74. package/dist/attributes/properties/typed.d.ts +9 -2
  75. package/dist/attributes/properties/typed.d.ts.map +1 -1
  76. package/dist/attributes/properties/typed.js +15 -1
  77. package/dist/attributes/properties/typed.js.map +1 -1
  78. package/dist/attributes/render3d/orbit.d.ts +8 -8
  79. package/dist/attributes/render3d/orbit.js +7 -7
  80. package/dist/attributes/render3d/orbit.js.map +1 -1
  81. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  82. package/dist/attributes/shape/corners/corner-style.js.map +1 -1
  83. package/dist/attributes/shape/corners/corners.js.map +1 -1
  84. package/dist/attributes/shape/corners/index.js.map +1 -1
  85. package/dist/attributes/shape/effects/backdrop.d.ts +4 -4
  86. package/dist/attributes/shape/effects/backdrop.d.ts.map +1 -1
  87. package/dist/attributes/shape/effects/backdrop.js.map +1 -1
  88. package/dist/attributes/shape/effects/chain.d.ts +28 -120
  89. package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
  90. package/dist/attributes/shape/effects/chain.js +16 -88
  91. package/dist/attributes/shape/effects/chain.js.map +1 -1
  92. package/dist/attributes/shape/effects/effect-data.js.map +1 -1
  93. package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
  94. package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
  95. package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
  96. package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
  97. package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
  98. package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
  99. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
  100. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +2 -2
  101. package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
  102. package/dist/attributes/shape/effects/implementations/curves.d.ts +1 -1
  103. package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
  104. package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
  105. package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
  106. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  107. package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
  108. package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
  109. package/dist/attributes/shape/effects/implementations/glass.d.ts +15 -24
  110. package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
  111. package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
  112. package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
  113. package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
  114. package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
  115. package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
  116. package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
  117. package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
  118. package/dist/attributes/shape/effects/implementations/lut.d.ts +1 -1
  119. package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
  120. package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
  121. package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
  122. package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
  123. package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
  124. package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
  125. package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
  126. package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
  127. package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
  128. package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
  129. package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
  130. package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
  131. package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
  132. package/dist/attributes/shape/effects/implementations/shader.js +15 -8
  133. package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
  134. package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
  135. package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
  136. package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
  137. package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
  138. package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
  139. package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
  140. package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
  141. package/dist/attributes/shape/effects/index.d.ts +2 -6
  142. package/dist/attributes/shape/effects/index.d.ts.map +1 -1
  143. package/dist/attributes/shape/effects/index.js.map +1 -1
  144. package/dist/attributes/shape/effects/registry.d.ts +23 -6
  145. package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
  146. package/dist/attributes/shape/effects/registry.js +44 -10
  147. package/dist/attributes/shape/effects/registry.js.map +1 -1
  148. package/dist/attributes/shape/effects/union.d.ts +2 -6
  149. package/dist/attributes/shape/effects/union.d.ts.map +1 -1
  150. package/dist/attributes/shape/effects/union.js.map +1 -1
  151. package/dist/attributes/shape/fill/blend.js.map +1 -1
  152. package/dist/attributes/shape/fill/chain.js.map +1 -1
  153. package/dist/attributes/shape/fill/coerce.js.map +1 -1
  154. package/dist/attributes/shape/fill/color/constants.js.map +1 -1
  155. package/dist/attributes/shape/fill/color/parser.d.ts.map +1 -1
  156. package/dist/attributes/shape/fill/color/parser.js +81 -44
  157. package/dist/attributes/shape/fill/color/parser.js.map +1 -1
  158. package/dist/attributes/shape/fill/gradient-stops.d.ts +16 -0
  159. package/dist/attributes/shape/fill/gradient-stops.d.ts.map +1 -0
  160. package/dist/attributes/shape/fill/gradient-stops.js +65 -0
  161. package/dist/attributes/shape/fill/gradient-stops.js.map +1 -0
  162. package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
  163. package/dist/attributes/shape/fill/implementations/color.js.map +1 -1
  164. package/dist/attributes/shape/fill/implementations/conic-gradient.d.ts.map +1 -1
  165. package/dist/attributes/shape/fill/implementations/conic-gradient.js +2 -5
  166. package/dist/attributes/shape/fill/implementations/conic-gradient.js.map +1 -1
  167. package/dist/attributes/shape/fill/implementations/dot-grid.js.map +1 -1
  168. package/dist/attributes/shape/fill/implementations/fractal-noise.d.ts.map +1 -1
  169. package/dist/attributes/shape/fill/implementations/fractal-noise.js +2 -10
  170. package/dist/attributes/shape/fill/implementations/fractal-noise.js.map +1 -1
  171. package/dist/attributes/shape/fill/implementations/grid.js.map +1 -1
  172. package/dist/attributes/shape/fill/implementations/image.d.ts.map +1 -1
  173. package/dist/attributes/shape/fill/implementations/image.js +5 -4
  174. package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
  175. package/dist/attributes/shape/fill/implementations/linear-gradient.d.ts.map +1 -1
  176. package/dist/attributes/shape/fill/implementations/linear-gradient.js +2 -6
  177. package/dist/attributes/shape/fill/implementations/linear-gradient.js.map +1 -1
  178. package/dist/attributes/shape/fill/implementations/noise.js.map +1 -1
  179. package/dist/attributes/shape/fill/implementations/radial-gradient.d.ts.map +1 -1
  180. package/dist/attributes/shape/fill/implementations/radial-gradient.js +2 -5
  181. package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
  182. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  183. package/dist/attributes/shape/fill/implementations/stripe.js.map +1 -1
  184. package/dist/attributes/shape/fill/implementations/video.js +1 -1
  185. package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
  186. package/dist/attributes/shape/fill/index.js.map +1 -1
  187. package/dist/attributes/shape/fill/lerp.d.ts +9 -1
  188. package/dist/attributes/shape/fill/lerp.d.ts.map +1 -1
  189. package/dist/attributes/shape/fill/lerp.js +12 -1
  190. package/dist/attributes/shape/fill/lerp.js.map +1 -1
  191. package/dist/attributes/shape/fill/media-preset.js.map +1 -1
  192. package/dist/attributes/shape/fill/registry.js.map +1 -1
  193. package/dist/attributes/shape/fill/union.js.map +1 -1
  194. package/dist/attributes/shape/filters/chain.d.ts +4 -10
  195. package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
  196. package/dist/attributes/shape/filters/chain.js +1 -13
  197. package/dist/attributes/shape/filters/chain.js.map +1 -1
  198. package/dist/attributes/shape/filters/implementations/alpha.js.map +1 -1
  199. package/dist/attributes/shape/filters/implementations/blur.js.map +1 -1
  200. package/dist/attributes/shape/filters/implementations/color-adjustment.js.map +1 -1
  201. package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
  202. package/dist/attributes/shape/filters/implementations/curves.js.map +1 -1
  203. package/dist/attributes/shape/filters/implementations/echo.js.map +1 -1
  204. package/dist/attributes/shape/filters/implementations/exposure.js.map +1 -1
  205. package/dist/attributes/shape/filters/implementations/grayscale.js.map +1 -1
  206. package/dist/attributes/shape/filters/implementations/posterize-time.js.map +1 -1
  207. package/dist/attributes/shape/filters/index.d.ts +1 -1
  208. package/dist/attributes/shape/filters/index.js.map +1 -1
  209. package/dist/attributes/shape/filters/registry.d.ts +2 -2
  210. package/dist/attributes/shape/filters/registry.js +3 -3
  211. package/dist/attributes/shape/filters/registry.js.map +1 -1
  212. package/dist/attributes/shape/filters/union.d.ts +6 -7
  213. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  214. package/dist/attributes/shape/filters/union.js.map +1 -1
  215. package/dist/attributes/shape/path/anchors.d.ts.map +1 -1
  216. package/dist/attributes/shape/path/anchors.js +12 -5
  217. package/dist/attributes/shape/path/anchors.js.map +1 -1
  218. package/dist/attributes/shape/path/bezier.js.map +1 -1
  219. package/dist/attributes/shape/path/index.js.map +1 -1
  220. package/dist/attributes/shape/path/measure.js.map +1 -1
  221. package/dist/attributes/shape/path/morph.d.ts.map +1 -1
  222. package/dist/attributes/shape/path/morph.js +16 -4
  223. package/dist/attributes/shape/path/morph.js.map +1 -1
  224. package/dist/attributes/shape/path/ops.js.map +1 -1
  225. package/dist/attributes/shape/path/types.js.map +1 -1
  226. package/dist/attributes/shape/path/walk.js.map +1 -1
  227. package/dist/attributes/shape/shaders/index.js.map +1 -1
  228. package/dist/attributes/shape/shaders/pack.js.map +1 -1
  229. package/dist/attributes/shape/shaders/resolve.js.map +1 -1
  230. package/dist/attributes/shape/shadow/index.js.map +1 -1
  231. package/dist/attributes/shape/shadow/shadow.js.map +1 -1
  232. package/dist/attributes/shape/stroke/index.d.ts +2 -2
  233. package/dist/attributes/shape/stroke/index.d.ts.map +1 -1
  234. package/dist/attributes/shape/stroke/index.js +1 -1
  235. package/dist/attributes/shape/stroke/index.js.map +1 -1
  236. package/dist/attributes/shape/stroke/stroke.d.ts +27 -6
  237. package/dist/attributes/shape/stroke/stroke.d.ts.map +1 -1
  238. package/dist/attributes/shape/stroke/stroke.js +22 -2
  239. package/dist/attributes/shape/stroke/stroke.js.map +1 -1
  240. package/dist/attributes/shared/operators.js.map +1 -1
  241. package/dist/attributes/text/index.js.map +1 -1
  242. package/dist/attributes/text/ops.d.ts +6 -0
  243. package/dist/attributes/text/ops.d.ts.map +1 -1
  244. package/dist/attributes/text/ops.js +1 -0
  245. package/dist/attributes/text/ops.js.map +1 -1
  246. package/dist/attributes/text/types.js.map +1 -1
  247. package/dist/browser/chunks/chunk-FUZVFT3W.js +18 -0
  248. package/dist/browser/chunks/chunk-FUZVFT3W.js.map +7 -0
  249. package/dist/browser/chunks/chunk-QG6C23IJ.js +3 -0
  250. package/dist/browser/chunks/chunk-QG6C23IJ.js.map +7 -0
  251. package/dist/browser/chunks/chunk-SFNJRPBV.js +2 -0
  252. package/dist/browser/chunks/chunk-SFNJRPBV.js.map +7 -0
  253. package/dist/browser/component.js +1 -1
  254. package/dist/browser/component.js.map +3 -3
  255. package/dist/browser/index.js +1 -1
  256. package/dist/browser/index.js.map +4 -4
  257. package/dist/browser/jsx-jsx-dev-runtime.js +1 -1
  258. package/dist/browser/jsx-jsx-runtime.js +1 -1
  259. package/dist/browser/manifest.json +3 -2
  260. package/dist/browser/sdk.js +1 -1
  261. package/dist/component.js.map +1 -1
  262. package/dist/document/audio.d.ts +1 -1
  263. package/dist/document/audio.js +4 -4
  264. package/dist/document/audio.js.map +1 -1
  265. package/dist/document/builtins.d.ts.map +1 -1
  266. package/dist/document/builtins.js +8 -14
  267. package/dist/document/builtins.js.map +1 -1
  268. package/dist/document/command-traits.d.ts +1 -1
  269. package/dist/document/command-traits.d.ts.map +1 -1
  270. package/dist/document/command-traits.js +17 -3
  271. package/dist/document/command-traits.js.map +1 -1
  272. package/dist/document/deny-globals.js.map +1 -1
  273. package/dist/document/diff.js.map +1 -1
  274. package/dist/document/doc-index.d.ts +2 -2
  275. package/dist/document/doc-index.d.ts.map +1 -1
  276. package/dist/document/doc-index.js.map +1 -1
  277. package/dist/document/expression/compile.d.ts.map +1 -1
  278. package/dist/document/expression/compile.js +8 -5
  279. package/dist/document/expression/compile.js.map +1 -1
  280. package/dist/document/expression/index.js.map +1 -1
  281. package/dist/document/expression/ops.js +1 -1
  282. package/dist/document/expression/ops.js.map +1 -1
  283. package/dist/document/expression/parse.d.ts.map +1 -1
  284. package/dist/document/expression/parse.js +15 -6
  285. package/dist/document/expression/parse.js.map +1 -1
  286. package/dist/document/expression/refs.d.ts +1 -1
  287. package/dist/document/expression/refs.js +1 -1
  288. package/dist/document/expression/refs.js.map +1 -1
  289. package/dist/document/expression/types.js.map +1 -1
  290. package/dist/document/expression/walk.d.ts.map +1 -1
  291. package/dist/document/expression/walk.js +2 -1
  292. package/dist/document/expression/walk.js.map +1 -1
  293. package/dist/document/index.d.ts +2 -0
  294. package/dist/document/index.d.ts.map +1 -1
  295. package/dist/document/index.js +2 -0
  296. package/dist/document/index.js.map +1 -1
  297. package/dist/document/node-decorator.js.map +1 -1
  298. package/dist/document/node-descriptor.d.ts +19 -0
  299. package/dist/document/node-descriptor.d.ts.map +1 -1
  300. package/dist/document/node-descriptor.js.map +1 -1
  301. package/dist/document/placement.d.ts +70 -0
  302. package/dist/document/placement.d.ts.map +1 -0
  303. package/dist/document/placement.js +83 -0
  304. package/dist/document/placement.js.map +1 -0
  305. package/dist/document/project.d.ts +2 -2
  306. package/dist/document/project.d.ts.map +1 -1
  307. package/dist/document/project.js.map +1 -1
  308. package/dist/document/registry.d.ts +34 -16
  309. package/dist/document/registry.d.ts.map +1 -1
  310. package/dist/document/registry.js +51 -12
  311. package/dist/document/registry.js.map +1 -1
  312. package/dist/document/timeline-patch.js.map +1 -1
  313. package/dist/document/timeline.d.ts +73 -18
  314. package/dist/document/timeline.d.ts.map +1 -1
  315. package/dist/document/timeline.js +192 -40
  316. package/dist/document/timeline.js.map +1 -1
  317. package/dist/document/types.d.ts +12 -12
  318. package/dist/document/types.d.ts.map +1 -1
  319. package/dist/document/types.js +2 -2
  320. package/dist/document/types.js.map +1 -1
  321. package/dist/document/validate.d.ts +2 -2
  322. package/dist/document/validate.d.ts.map +1 -1
  323. package/dist/document/validate.js +37 -31
  324. package/dist/document/validate.js.map +1 -1
  325. package/dist/document/withdraw.d.ts +28 -0
  326. package/dist/document/withdraw.d.ts.map +1 -0
  327. package/dist/document/withdraw.js +61 -0
  328. package/dist/document/withdraw.js.map +1 -0
  329. package/dist/index.d.ts +1 -0
  330. package/dist/index.d.ts.map +1 -1
  331. package/dist/index.js +1 -0
  332. package/dist/index.js.map +1 -1
  333. package/dist/jsx/jsx-dev-runtime.js.map +1 -1
  334. package/dist/jsx/jsx-runtime.d.ts +9 -1
  335. package/dist/jsx/jsx-runtime.d.ts.map +1 -1
  336. package/dist/jsx/jsx-runtime.js +13 -3
  337. package/dist/jsx/jsx-runtime.js.map +1 -1
  338. package/dist/layout/bounds.d.ts +0 -1
  339. package/dist/layout/bounds.d.ts.map +1 -1
  340. package/dist/layout/bounds.js.map +1 -1
  341. package/dist/layout/constraints.js.map +1 -1
  342. package/dist/layout/flex.d.ts +4 -2
  343. package/dist/layout/flex.d.ts.map +1 -1
  344. package/dist/layout/flex.js +27 -11
  345. package/dist/layout/flex.js.map +1 -1
  346. package/dist/layout/freeform.js.map +1 -1
  347. package/dist/layout/grid.js.map +1 -1
  348. package/dist/layout/index.js.map +1 -1
  349. package/dist/layout/item.js.map +1 -1
  350. package/dist/layout/ops.d.ts +6 -0
  351. package/dist/layout/ops.d.ts.map +1 -1
  352. package/dist/layout/ops.js +6 -0
  353. package/dist/layout/ops.js.map +1 -1
  354. package/dist/layout/types.js.map +1 -1
  355. package/dist/nodes/2d/node-lifecycle.js.map +1 -1
  356. package/dist/nodes/2d/node-motion.js.map +1 -1
  357. package/dist/nodes/2d/node-render.d.ts +3 -3
  358. package/dist/nodes/2d/node-render.d.ts.map +1 -1
  359. package/dist/nodes/2d/node-render.js.map +1 -1
  360. package/dist/nodes/2d/node-transform.js.map +1 -1
  361. package/dist/nodes/2d/node2d.d.ts +115 -3
  362. package/dist/nodes/2d/node2d.d.ts.map +1 -1
  363. package/dist/nodes/2d/node2d.js +188 -32
  364. package/dist/nodes/2d/node2d.js.map +1 -1
  365. package/dist/nodes/2d/paint-node.d.ts +27 -0
  366. package/dist/nodes/2d/paint-node.d.ts.map +1 -1
  367. package/dist/nodes/2d/paint-node.js +42 -0
  368. package/dist/nodes/2d/paint-node.js.map +1 -1
  369. package/dist/nodes/audio/audio-bus.js.map +1 -1
  370. package/dist/nodes/audio/index.js.map +1 -1
  371. package/dist/nodes/audio/node-audio.d.ts +3 -2
  372. package/dist/nodes/audio/node-audio.d.ts.map +1 -1
  373. package/dist/nodes/audio/node-audio.js +8 -5
  374. package/dist/nodes/audio/node-audio.js.map +1 -1
  375. package/dist/nodes/audio/sound-node.d.ts +2 -2
  376. package/dist/nodes/audio/sound-node.d.ts.map +1 -1
  377. package/dist/nodes/audio/sound-node.js +2 -2
  378. package/dist/nodes/audio/sound-node.js.map +1 -1
  379. package/dist/nodes/geometry/bounds-shape-node.d.ts +4 -4
  380. package/dist/nodes/geometry/bounds-shape-node.js +2 -2
  381. package/dist/nodes/geometry/bounds-shape-node.js.map +1 -1
  382. package/dist/nodes/geometry/box-path-node.d.ts +3 -3
  383. package/dist/nodes/geometry/box-path-node.js +2 -2
  384. package/dist/nodes/geometry/box-path-node.js.map +1 -1
  385. package/dist/nodes/geometry/ellipse-node.js.map +1 -1
  386. package/dist/nodes/geometry/group-bounds.d.ts +2 -2
  387. package/dist/nodes/geometry/group-bounds.d.ts.map +1 -1
  388. package/dist/nodes/geometry/group-bounds.js +1 -2
  389. package/dist/nodes/geometry/group-bounds.js.map +1 -1
  390. package/dist/nodes/geometry/path-node.d.ts.map +1 -1
  391. package/dist/nodes/geometry/path-node.js +6 -0
  392. package/dist/nodes/geometry/path-node.js.map +1 -1
  393. package/dist/nodes/geometry/polygon-node.js.map +1 -1
  394. package/dist/nodes/geometry/polygram-node.js.map +1 -1
  395. package/dist/nodes/geometry/rect-node.js.map +1 -1
  396. package/dist/nodes/geometry/shape-node.js.map +1 -1
  397. package/dist/nodes/geometry/shape-outline.d.ts +2 -2
  398. package/dist/nodes/geometry/shape-outline.d.ts.map +1 -1
  399. package/dist/nodes/geometry/shape-outline.js +2 -13
  400. package/dist/nodes/geometry/shape-outline.js.map +1 -1
  401. package/dist/nodes/index.d.ts +3 -8
  402. package/dist/nodes/index.d.ts.map +1 -1
  403. package/dist/nodes/index.js +3 -8
  404. package/dist/nodes/index.js.map +1 -1
  405. package/dist/nodes/layout/camera-node.d.ts +9 -0
  406. package/dist/nodes/layout/camera-node.d.ts.map +1 -1
  407. package/dist/nodes/layout/camera-node.js +38 -3
  408. package/dist/nodes/layout/camera-node.js.map +1 -1
  409. package/dist/nodes/layout/orbit-camera-node.d.ts +1 -1
  410. package/dist/nodes/layout/orbit-camera-node.js +1 -1
  411. package/dist/nodes/layout/orbit-camera-node.js.map +1 -1
  412. package/dist/nodes/layout/rotated-box.js.map +1 -1
  413. package/dist/nodes/media/video-node.d.ts.map +1 -1
  414. package/dist/nodes/media/video-node.js +5 -3
  415. package/dist/nodes/media/video-node.js.map +1 -1
  416. package/dist/nodes/node/declare-paints.js.map +1 -1
  417. package/dist/nodes/node/node-editor-state.js.map +1 -1
  418. package/dist/nodes/node/node-reactive.js.map +1 -1
  419. package/dist/nodes/node/node-time.d.ts +3 -3
  420. package/dist/nodes/node/node-time.d.ts.map +1 -1
  421. package/dist/nodes/node/node-time.js +1 -1
  422. package/dist/nodes/node/node-time.js.map +1 -1
  423. package/dist/nodes/node/node-walk.js.map +1 -1
  424. package/dist/nodes/node/node.d.ts +5 -3
  425. package/dist/nodes/node/node.d.ts.map +1 -1
  426. package/dist/nodes/node/node.js +44 -19
  427. package/dist/nodes/node/node.js.map +1 -1
  428. package/dist/nodes/node/text-defaults.d.ts +10 -12
  429. package/dist/nodes/node/text-defaults.d.ts.map +1 -1
  430. package/dist/nodes/node/text-defaults.js +10 -12
  431. package/dist/nodes/node/text-defaults.js.map +1 -1
  432. package/dist/nodes/{scene → root}/canvas2d-node.d.ts +2 -2
  433. package/dist/nodes/root/canvas2d-node.d.ts.map +1 -0
  434. package/dist/nodes/{scene → root}/canvas2d-node.js +2 -2
  435. package/dist/nodes/root/canvas2d-node.js.map +1 -0
  436. package/dist/nodes/root/provider-node.d.ts.map +1 -0
  437. package/dist/nodes/root/provider-node.js.map +1 -0
  438. package/dist/nodes/root/theme-provider-node.d.ts.map +1 -0
  439. package/dist/nodes/root/theme-provider-node.js.map +1 -0
  440. package/dist/nodes/text/default-text-style-node.d.ts +5 -2
  441. package/dist/nodes/text/default-text-style-node.d.ts.map +1 -1
  442. package/dist/nodes/text/default-text-style-node.js +10 -4
  443. package/dist/nodes/text/default-text-style-node.js.map +1 -1
  444. package/dist/nodes/text/number-format.d.ts +1 -1
  445. package/dist/nodes/text/number-format.js +1 -1
  446. package/dist/nodes/text/number-format.js.map +1 -1
  447. package/dist/nodes/text/number-node.js.map +1 -1
  448. package/dist/nodes/text/number-pattern.js.map +1 -1
  449. package/dist/nodes/text/richtext-node.js +1 -1
  450. package/dist/nodes/text/richtext-node.js.map +1 -1
  451. package/dist/nodes/text/text-base.d.ts.map +1 -1
  452. package/dist/nodes/text/text-base.js +1 -1
  453. package/dist/nodes/text/text-base.js.map +1 -1
  454. package/dist/nodes/text/text-node.js.map +1 -1
  455. package/dist/nodes/text/text-selection.js.map +1 -1
  456. package/dist/nodes/three/camera-nodes.d.ts +21 -3
  457. package/dist/nodes/three/camera-nodes.d.ts.map +1 -1
  458. package/dist/nodes/three/camera-nodes.js +42 -1
  459. package/dist/nodes/three/camera-nodes.js.map +1 -1
  460. package/dist/nodes/three/canvas3d-node.d.ts +29 -6
  461. package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
  462. package/dist/nodes/three/canvas3d-node.js +44 -2
  463. package/dist/nodes/three/canvas3d-node.js.map +1 -1
  464. package/dist/nodes/three/drawable-nodes.d.ts +25 -11
  465. package/dist/nodes/three/drawable-nodes.d.ts.map +1 -1
  466. package/dist/nodes/three/drawable-nodes.js +43 -13
  467. package/dist/nodes/three/drawable-nodes.js.map +1 -1
  468. package/dist/nodes/three/environment-nodes.d.ts +9 -3
  469. package/dist/nodes/three/environment-nodes.d.ts.map +1 -1
  470. package/dist/nodes/three/environment-nodes.js.map +1 -1
  471. package/dist/nodes/three/geometry-nodes.d.ts +2 -2
  472. package/dist/nodes/three/geometry-nodes.js +2 -2
  473. package/dist/nodes/three/geometry-nodes.js.map +1 -1
  474. package/dist/nodes/three/grid-geometry3d.js.map +1 -1
  475. package/dist/nodes/three/group3d.js.map +1 -1
  476. package/dist/nodes/three/light-nodes.d.ts.map +1 -1
  477. package/dist/nodes/three/light-nodes.js +3 -3
  478. package/dist/nodes/three/light-nodes.js.map +1 -1
  479. package/dist/nodes/three/mesh3d.js.map +1 -1
  480. package/dist/nodes/three/node3d.d.ts +48 -0
  481. package/dist/nodes/three/node3d.d.ts.map +1 -1
  482. package/dist/nodes/three/node3d.js +53 -3
  483. package/dist/nodes/three/node3d.js.map +1 -1
  484. package/dist/platform/audio-sink.d.ts +2 -2
  485. package/dist/platform/audio-sink.d.ts.map +1 -1
  486. package/dist/platform/audio-sink.js.map +1 -1
  487. package/dist/platform/exporter.d.ts +13 -8
  488. package/dist/platform/exporter.d.ts.map +1 -1
  489. package/dist/platform/exporter.js.map +1 -1
  490. package/dist/platform/index.d.ts +1 -1
  491. package/dist/platform/index.d.ts.map +1 -1
  492. package/dist/platform/index.js.map +1 -1
  493. package/dist/platform/stepped-clock.js.map +1 -1
  494. package/dist/platform/storage-adapter.d.ts +12 -6
  495. package/dist/platform/storage-adapter.d.ts.map +1 -1
  496. package/dist/platform/storage-adapter.js +4 -0
  497. package/dist/platform/storage-adapter.js.map +1 -1
  498. package/dist/platform/ticker.d.ts +6 -0
  499. package/dist/platform/ticker.d.ts.map +1 -1
  500. package/dist/platform/ticker.js +6 -0
  501. package/dist/platform/ticker.js.map +1 -1
  502. package/dist/project/config.js.map +1 -1
  503. package/dist/project/index.js.map +1 -1
  504. package/dist/project/tree.d.ts +3 -3
  505. package/dist/project/tree.d.ts.map +1 -1
  506. package/dist/project/tree.js.map +1 -1
  507. package/dist/props/host.js.map +1 -1
  508. package/dist/props/index.js.map +1 -1
  509. package/dist/props/observer.js.map +1 -1
  510. package/dist/props/slot.js.map +1 -1
  511. package/dist/renamed-scene-names.d.ts +17 -0
  512. package/dist/renamed-scene-names.d.ts.map +1 -0
  513. package/dist/renamed-scene-names.js +9 -0
  514. package/dist/renamed-scene-names.js.map +1 -0
  515. package/dist/render/canvas-render-context2d.d.ts +10 -3
  516. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  517. package/dist/render/canvas-render-context2d.js +10 -0
  518. package/dist/render/canvas-render-context2d.js.map +1 -1
  519. package/dist/render/clip-contains.js.map +1 -1
  520. package/dist/render/clip.js.map +1 -1
  521. package/dist/render/descriptors/ellipse.js.map +1 -1
  522. package/dist/render/descriptors/latex.js.map +1 -1
  523. package/dist/render/descriptors/line.js.map +1 -1
  524. package/dist/render/descriptors/path-builder.js.map +1 -1
  525. package/dist/render/descriptors/path.js.map +1 -1
  526. package/dist/render/descriptors/polygon.js.map +1 -1
  527. package/dist/render/descriptors/polygram.js.map +1 -1
  528. package/dist/render/descriptors/rect.js.map +1 -1
  529. package/dist/render/descriptors/richtext.js.map +1 -1
  530. package/dist/render/descriptors/shape.d.ts +12 -0
  531. package/dist/render/descriptors/shape.d.ts.map +1 -1
  532. package/dist/render/descriptors/shape.js.map +1 -1
  533. package/dist/render/descriptors/text.d.ts +2 -2
  534. package/dist/render/descriptors/text.js +2 -2
  535. package/dist/render/descriptors/text.js.map +1 -1
  536. package/dist/render/descriptors/transform.d.ts +2 -2
  537. package/dist/render/descriptors/transform.d.ts.map +1 -1
  538. package/dist/render/descriptors/transform.js.map +1 -1
  539. package/dist/render/graphics2d.d.ts +3 -3
  540. package/dist/render/graphics2d.d.ts.map +1 -1
  541. package/dist/render/graphics2d.js +1 -1
  542. package/dist/render/graphics2d.js.map +1 -1
  543. package/dist/render/index.js.map +1 -1
  544. package/dist/render/measure-context.js.map +1 -1
  545. package/dist/render/null-render-context.js.map +1 -1
  546. package/dist/render/render-context2d.d.ts +5 -5
  547. package/dist/render/render-context2d.d.ts.map +1 -1
  548. package/dist/render/render-context2d.js.map +1 -1
  549. package/dist/render/surface.js.map +1 -1
  550. package/dist/render/text-defaults.js.map +1 -1
  551. package/dist/render/text-layout.js.map +1 -1
  552. package/dist/render3d/bounds3d.d.ts.map +1 -1
  553. package/dist/render3d/bounds3d.js +4 -2
  554. package/dist/render3d/bounds3d.js.map +1 -1
  555. package/dist/render3d/builders.js.map +1 -1
  556. package/dist/render3d/camera.d.ts +6 -0
  557. package/dist/render3d/camera.d.ts.map +1 -1
  558. package/dist/render3d/camera.js +5 -3
  559. package/dist/render3d/camera.js.map +1 -1
  560. package/dist/render3d/fill3d.d.ts +2 -9
  561. package/dist/render3d/fill3d.d.ts.map +1 -1
  562. package/dist/render3d/fill3d.js +2 -13
  563. package/dist/render3d/fill3d.js.map +1 -1
  564. package/dist/render3d/geometry.d.ts +8 -1
  565. package/dist/render3d/geometry.d.ts.map +1 -1
  566. package/dist/render3d/geometry.js.map +1 -1
  567. package/dist/render3d/graphics3d.d.ts +8 -4
  568. package/dist/render3d/graphics3d.d.ts.map +1 -1
  569. package/dist/render3d/graphics3d.js +18 -10
  570. package/dist/render3d/graphics3d.js.map +1 -1
  571. package/dist/render3d/index.d.ts +1 -1
  572. package/dist/render3d/index.js +1 -1
  573. package/dist/render3d/index.js.map +1 -1
  574. package/dist/render3d/inert.d.ts +14 -0
  575. package/dist/render3d/inert.d.ts.map +1 -0
  576. package/dist/render3d/inert.js +62 -0
  577. package/dist/render3d/inert.js.map +1 -0
  578. package/dist/render3d/light.js.map +1 -1
  579. package/dist/render3d/material.d.ts +10 -5
  580. package/dist/render3d/material.d.ts.map +1 -1
  581. package/dist/render3d/material.js.map +1 -1
  582. package/dist/render3d/matrix4.js.map +1 -1
  583. package/dist/render3d/render-context3d.js.map +1 -1
  584. package/dist/render3d/resources.d.ts +2 -2
  585. package/dist/render3d/resources.js +2 -2
  586. package/dist/render3d/resources.js.map +1 -1
  587. package/dist/render3d/rounded-box.js.map +1 -1
  588. package/dist/render3d/scene-settings.d.ts +23 -4
  589. package/dist/render3d/scene-settings.d.ts.map +1 -1
  590. package/dist/render3d/scene-settings.js.map +1 -1
  591. package/dist/render3d/scene3d.d.ts +11 -0
  592. package/dist/render3d/scene3d.d.ts.map +1 -1
  593. package/dist/render3d/scene3d.js +39 -6
  594. package/dist/render3d/scene3d.js.map +1 -1
  595. package/dist/render3d/segments.js.map +1 -1
  596. package/dist/render3d/texture.d.ts +9 -0
  597. package/dist/render3d/texture.d.ts.map +1 -1
  598. package/dist/render3d/texture.js +13 -0
  599. package/dist/render3d/texture.js.map +1 -1
  600. package/dist/render3d/tracking.js.map +1 -1
  601. package/dist/render3d/transform.d.ts +1 -1
  602. package/dist/render3d/transform.js.map +1 -1
  603. package/dist/render3d/vector3.d.ts +18 -1
  604. package/dist/render3d/vector3.d.ts.map +1 -1
  605. package/dist/render3d/vector3.js +27 -0
  606. package/dist/render3d/vector3.js.map +1 -1
  607. package/dist/render3d/walk.d.ts +1 -1
  608. package/dist/render3d/walk.d.ts.map +1 -1
  609. package/dist/render3d/walk.js +5 -1
  610. package/dist/render3d/walk.js.map +1 -1
  611. package/dist/runtime/asset-refine.js.map +1 -1
  612. package/dist/runtime/asset-timeline.js.map +1 -1
  613. package/dist/runtime/asset-update.js.map +1 -1
  614. package/dist/runtime/audio-index.d.ts +2 -2
  615. package/dist/runtime/audio-index.d.ts.map +1 -1
  616. package/dist/runtime/audio-index.js +8 -2
  617. package/dist/runtime/audio-index.js.map +1 -1
  618. package/dist/runtime/builtin-context.js.map +1 -1
  619. package/dist/runtime/clip-instance.d.ts +5 -3
  620. package/dist/runtime/clip-instance.d.ts.map +1 -1
  621. package/dist/runtime/clip-instance.js +10 -6
  622. package/dist/runtime/clip-instance.js.map +1 -1
  623. package/dist/runtime/clip-store.d.ts +9 -0
  624. package/dist/runtime/clip-store.d.ts.map +1 -1
  625. package/dist/runtime/clip-store.js +33 -3
  626. package/dist/runtime/clip-store.js.map +1 -1
  627. package/dist/runtime/engine.d.ts +5 -0
  628. package/dist/runtime/engine.d.ts.map +1 -1
  629. package/dist/runtime/engine.js +2 -0
  630. package/dist/runtime/engine.js.map +1 -1
  631. package/dist/runtime/frame-time.d.ts +31 -0
  632. package/dist/runtime/frame-time.d.ts.map +1 -0
  633. package/dist/runtime/frame-time.js +29 -0
  634. package/dist/runtime/frame-time.js.map +1 -0
  635. package/dist/runtime/index.d.ts +1 -0
  636. package/dist/runtime/index.d.ts.map +1 -1
  637. package/dist/runtime/index.js +1 -0
  638. package/dist/runtime/index.js.map +1 -1
  639. package/dist/runtime/node-picking.d.ts +44 -3
  640. package/dist/runtime/node-picking.d.ts.map +1 -1
  641. package/dist/runtime/node-picking.js +118 -3
  642. package/dist/runtime/node-picking.js.map +1 -1
  643. package/dist/runtime/node-picking3d.d.ts +2 -1
  644. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  645. package/dist/runtime/node-picking3d.js +5 -2
  646. package/dist/runtime/node-picking3d.js.map +1 -1
  647. package/dist/runtime/placement.d.ts.map +1 -1
  648. package/dist/runtime/placement.js +4 -5
  649. package/dist/runtime/placement.js.map +1 -1
  650. package/dist/runtime/playback-controller.d.ts +31 -2
  651. package/dist/runtime/playback-controller.d.ts.map +1 -1
  652. package/dist/runtime/playback-controller.js +63 -6
  653. package/dist/runtime/playback-controller.js.map +1 -1
  654. package/dist/runtime/playback.js.map +1 -1
  655. package/dist/runtime/precompisition.js.map +1 -1
  656. package/dist/runtime/project-assets.js.map +1 -1
  657. package/dist/runtime/session.d.ts +9 -7
  658. package/dist/runtime/session.d.ts.map +1 -1
  659. package/dist/runtime/session.js +12 -4
  660. package/dist/runtime/session.js.map +1 -1
  661. package/dist/runtime/settle.js.map +1 -1
  662. package/dist/runtime/state-evaluator.d.ts +1 -1
  663. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  664. package/dist/runtime/state-evaluator.js +4 -3
  665. package/dist/runtime/state-evaluator.js.map +1 -1
  666. package/dist/runtime/text-geometry.js.map +1 -1
  667. package/dist/sdk/index.d.ts +27 -22
  668. package/dist/sdk/index.d.ts.map +1 -1
  669. package/dist/sdk/index.js +23 -9
  670. package/dist/sdk/index.js.map +1 -1
  671. package/dist/tween/command-decorator.d.ts +12 -4
  672. package/dist/tween/command-decorator.d.ts.map +1 -1
  673. package/dist/tween/command-decorator.js +10 -22
  674. package/dist/tween/command-decorator.js.map +1 -1
  675. package/dist/tween/command.js.map +1 -1
  676. package/dist/tween/ease/constants.d.ts.map +1 -1
  677. package/dist/tween/ease/constants.js +8 -5
  678. package/dist/tween/ease/constants.js.map +1 -1
  679. package/dist/tween/ease/curve.d.ts.map +1 -1
  680. package/dist/tween/ease/curve.js +4 -3
  681. package/dist/tween/ease/curve.js.map +1 -1
  682. package/dist/tween/ease/describe.d.ts +15 -0
  683. package/dist/tween/ease/describe.d.ts.map +1 -0
  684. package/dist/tween/ease/describe.js +37 -0
  685. package/dist/tween/ease/describe.js.map +1 -0
  686. package/dist/tween/ease/type.js.map +1 -1
  687. package/dist/tween/index.js.map +1 -1
  688. package/dist/tween/inert.js.map +1 -1
  689. package/dist/tween/lerp.js.map +1 -1
  690. package/dist/tween/loop.js.map +1 -1
  691. package/dist/tween/prepare.d.ts +3 -3
  692. package/dist/tween/prepare.js +3 -3
  693. package/dist/tween/prepare.js.map +1 -1
  694. package/dist/tween/seekable.d.ts +12 -1
  695. package/dist/tween/seekable.d.ts.map +1 -1
  696. package/dist/tween/seekable.js +15 -0
  697. package/dist/tween/seekable.js.map +1 -1
  698. package/dist/tween/stepper.js.map +1 -1
  699. package/dist/tween/to-command.js.map +1 -1
  700. package/dist/util/clamp.js.map +1 -1
  701. package/dist/util/context.js.map +1 -1
  702. package/dist/util/csv.js.map +1 -1
  703. package/dist/util/generateList.js.map +1 -1
  704. package/dist/util/index.js.map +1 -1
  705. package/dist/util/metrics.d.ts +1 -1
  706. package/dist/util/metrics.js +1 -1
  707. package/dist/util/metrics.js.map +1 -1
  708. package/dist/util/random.js.map +1 -1
  709. package/dist/util/reference.js.map +1 -1
  710. package/dist/util/scheduler.js.map +1 -1
  711. package/package.json +2 -1
  712. package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
  713. package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
  714. package/dist/attributes/shape/effects/implementations/displace.js +0 -30
  715. package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
  716. package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
  717. package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
  718. package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
  719. package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
  720. package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
  721. package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
  722. package/dist/attributes/shape/effects/implementations/texture.js +0 -25
  723. package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
  724. package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
  725. package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
  726. package/dist/attributes/shape/effects/implementations/trails.js +0 -22
  727. package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
  728. package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
  729. package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
  730. package/dist/browser/chunks/chunk-P3XQCHDW.js +0 -16
  731. package/dist/browser/chunks/chunk-P3XQCHDW.js.map +0 -7
  732. package/dist/browser/chunks/chunk-VJQMKHGQ.js +0 -3
  733. package/dist/browser/chunks/chunk-VJQMKHGQ.js.map +0 -7
  734. package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
  735. package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
  736. package/dist/nodes/geometry/dot-grid-node.js +0 -142
  737. package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
  738. package/dist/nodes/geometry/grid-lines.d.ts +0 -101
  739. package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
  740. package/dist/nodes/geometry/grid-lines.js +0 -128
  741. package/dist/nodes/geometry/grid-lines.js.map +0 -1
  742. package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
  743. package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
  744. package/dist/nodes/geometry/grid-pattern-node.js +0 -172
  745. package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
  746. package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
  747. package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
  748. package/dist/nodes/geometry/line-grid-node.js +0 -127
  749. package/dist/nodes/geometry/line-grid-node.js.map +0 -1
  750. package/dist/nodes/geometry/line-node.d.ts +0 -58
  751. package/dist/nodes/geometry/line-node.d.ts.map +0 -1
  752. package/dist/nodes/geometry/line-node.js +0 -123
  753. package/dist/nodes/geometry/line-node.js.map +0 -1
  754. package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
  755. package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
  756. package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
  757. package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
  758. package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
  759. package/dist/nodes/scene/canvas2d-node.js.map +0 -1
  760. package/dist/nodes/scene/provider-node.d.ts.map +0 -1
  761. package/dist/nodes/scene/provider-node.js.map +0 -1
  762. package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
  763. package/dist/nodes/scene/theme-provider-node.js.map +0 -1
  764. /package/dist/nodes/{scene → root}/provider-node.d.ts +0 -0
  765. /package/dist/nodes/{scene → root}/provider-node.js +0 -0
  766. /package/dist/nodes/{scene → root}/theme-provider-node.d.ts +0 -0
  767. /package/dist/nodes/{scene → root}/theme-provider-node.js +0 -0
@@ -299,8 +299,8 @@ __decorate([
299
299
  ], Lathe3D.prototype, "sweep", void 0);
300
300
  const TUBE_KEYS = ["points", "radius", "segments", "closed"];
301
301
  /**
302
- * A circular cross-section swept along a curve. `closed` joins the ends, the
303
- * same prop the 2D `Line` node carries; `segments` is `[along, around]`.
302
+ * A circular cross-section swept along a curve. `closed` joins the ends;
303
+ * `segments` is `[along, around]`.
304
304
  */
305
305
  export class Tube3D extends Mesh3D {
306
306
  buildGeometry() {
@@ -1 +1 @@
1
- {"version":3,"file":"geometry-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/geometry-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport type { PathBuilder } from \"@/render/descriptors/path-builder\";\nimport type { PathData } from \"@/render/descriptors/path\";\nimport type {\n Bevel3D, BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\n} from \"@/render3d/geometry\";\nimport type { Segments3D } from \"@/render3d/segments\";\nimport type { Vector3Input } from \"@/render3d/vector3\";\nimport { Mesh3D, type Mesh3DProps } from \"./mesh3d\";\n\n/**\n * The geometry nodes: one per shape `Graphics3D` has sugar for, so a scene reads\n * as a tree of things rather than as a builder chain.\n *\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\n * <Torus3D radius={1.4} thickness={0.08} position={[3, 0, 0]} />\n *\n * Each is a {@link Mesh3D}, so it carries the whole material vocabulary and the\n * whole `Node3D` transform. The only thing a subclass adds is its geometry's own\n * parameters — every one optional, so an unset parameter stays *absent* from the\n * descriptor and the renderer's own default applies rather than one invented here.\n *\n * ── Two names, everywhere ─────────────────────────────────────────────────────\n * Subdivision is always `segments` (a number, or a per-axis tuple whose order\n * each shape documents), replacing the ten spellings three has for it. A partial\n * revolution is always `startAngle` + `sweep` in degrees — the pair `Ellipse` has\n * used since the beginning — replacing `thetaStart`, `thetaLength`, `phiStart`,\n * `phiLength` and `arc`.\n *\n * A shape without sugar (a buffer, a parametric surface, a loaded model's mesh)\n * goes through the base directly: `<Mesh3D geometry={Geo.parametric({ … })} />`.\n *\n * **Geometry parameters are expensive to animate.** Three's geometries are\n * immutable, so tweening `radius` reallocates the mesh every frame. Tween\n * `scale` (or one of `scaleX`/`scaleY`/`scaleZ`) instead — those are in-place\n * writes on the object's matrix.\n */\n\n/** Params of a geometry descriptor, minus its discriminant. */\ntype ParamsOf<G extends { type: string }> = Omit<G, \"type\">;\n\n/**\n * Gather the set parameters off a node into a geometry descriptor.\n *\n * Reads through the prop accessors, so every parameter is live and a `to()` on\n * one rebuilds the geometry on the next frame.\n */\nfunction geometryFrom(type: Geometry3D[\"type\"], node: object, keys: readonly string[]): Geometry3D {\n const out: Record<string, unknown> = { type };\n for (const key of keys) {\n const value = (node as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n return out as unknown as Geometry3D;\n}\n\n/** The two sweep props every partially-revolvable shape carries. */\nconst SWEEP_KEYS = [\"startAngle\", \"sweep\"] as const;\n\n// ─── box ─────────────────────────────────────────────────────────────────────\n\nexport interface Box3DProps extends Mesh3DProps, Partial<ParamsOf<BoxGeometry3D>> { }\n\nconst BOX_KEYS = [\"width\", \"height\", \"depth\", \"cornerRadius\", \"segments\"] as const;\n\n/**\n * A box — and, with `cornerRadius`, the rounded box that most of a designed 3D\n * scene is made of. Same prop name and same meaning as `Rect`'s.\n */\nexport class Box3D<P extends Box3DProps = Box3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare width: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n @property({ default: undefined }) declare depth: number | undefined;\n @property({ default: undefined }) declare cornerRadius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"box\", this, BOX_KEYS);\n }\n}\n\n// ─── sphere ──────────────────────────────────────────────────────────────────\n\nexport interface Sphere3DProps extends Mesh3DProps, Partial<ParamsOf<SphereGeometry3D>> { }\n\nconst SPHERE_KEYS = [\"radius\", \"segments\", \"startLatitude\", \"latitudeSweep\", ...SWEEP_KEYS] as const;\n\n/** A sphere. `segments` is `[longitude, latitude]`. */\nexport class Sphere3D<P extends Sphere3DProps = Sphere3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n @property({ default: undefined }) declare startLatitude: number | undefined;\n @property({ default: undefined }) declare latitudeSweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"sphere\", this, SPHERE_KEYS);\n }\n}\n\n// ─── plane ───────────────────────────────────────────────────────────────────\n\nexport interface Plane3DProps extends Mesh3DProps, Partial<ParamsOf<PlaneGeometry3D>> { }\n\nconst PLANE_KEYS = [\"width\", \"height\", \"segments\"] as const;\n\n/** A flat quad. `segments` is `[width, height]`. */\nexport class Plane3D<P extends Plane3DProps = Plane3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare width: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"plane\", this, PLANE_KEYS);\n }\n}\n\n// ─── cylinder ────────────────────────────────────────────────────────────────\n\nexport interface Cylinder3DProps extends Mesh3DProps, Partial<ParamsOf<CylinderGeometry3D>> { }\n\nconst CYLINDER_KEYS = [\"radius\", \"height\", \"segments\", \"capped\", ...SWEEP_KEYS] as const;\n\n/**\n * A cylinder, or any tapered tube: `radius={[top, bottom]}`. `segments` is\n * `[radial, height]`.\n */\nexport class Cylinder3D<P extends Cylinder3DProps = Cylinder3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | readonly [number, number] | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare capped: boolean | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"cylinder\", this, CYLINDER_KEYS);\n }\n}\n\n// ─── cone ────────────────────────────────────────────────────────────────────\n\nexport interface Cone3DProps extends Mesh3DProps, Partial<ParamsOf<ConeGeometry3D>> { }\n\nconst CONE_KEYS = [\"radius\", \"height\", \"segments\", \"capped\", ...SWEEP_KEYS] as const;\n\n/** A cone. `segments` is `[radial, height]`. */\nexport class Cone3D<P extends Cone3DProps = Cone3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare capped: boolean | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"cone\", this, CONE_KEYS);\n }\n}\n\n// ─── torus ───────────────────────────────────────────────────────────────────\n\nexport interface Torus3DProps extends Mesh3DProps, Partial<ParamsOf<TorusGeometry3D>> { }\n\nconst TORUS_KEYS = [\"radius\", \"thickness\", \"segments\", ...SWEEP_KEYS] as const;\n\n/** A ring. `thickness` is the strand; `segments` is `[radial, tubular]`. */\nexport class Torus3D<P extends Torus3DProps = Torus3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare thickness: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"torus\", this, TORUS_KEYS);\n }\n}\n\n// ─── torus knot ──────────────────────────────────────────────────────────────\n\nexport interface TorusKnot3DProps extends Mesh3DProps, Partial<ParamsOf<TorusKnotGeometry3D>> { }\n\nconst TORUS_KNOT_KEYS = [\"radius\", \"thickness\", \"segments\", \"windings\"] as const;\n\n/** A knotted ring. `windings` is `[p, q]`; `segments` is `[tubular, radial]`. */\nexport class TorusKnot3D<P extends TorusKnot3DProps = TorusKnot3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare thickness: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare windings: readonly [number, number] | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"torusKnot\", this, TORUS_KNOT_KEYS);\n }\n}\n\n// ─── circle ──────────────────────────────────────────────────────────────────\n\nexport interface Circle3DProps extends Mesh3DProps, Partial<ParamsOf<CircleGeometry3D>> { }\n\nconst CIRCLE_KEYS = [\"radius\", \"segments\", ...SWEEP_KEYS] as const;\n\n/** A flat disc, or a pie slice via `startAngle`/`sweep` — exactly as `Ellipse`. */\nexport class Circle3D<P extends Circle3DProps = Circle3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"circle\", this, CIRCLE_KEYS);\n }\n}\n\n// ─── ring ────────────────────────────────────────────────────────────────────\n\nexport interface Ring3DProps extends Mesh3DProps, Partial<ParamsOf<RingGeometry3D>> { }\n\nconst RING_KEYS = [\"radius\", \"innerRadius\", \"segments\", ...SWEEP_KEYS] as const;\n\n/** A flat annulus. `radius` is the outer edge; `segments` is `[around, radial]`. */\nexport class Ring3D<P extends Ring3DProps = Ring3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare innerRadius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"ring\", this, RING_KEYS);\n }\n}\n\n// ─── capsule ─────────────────────────────────────────────────────────────────\n\nexport interface Capsule3DProps extends Mesh3DProps, Partial<ParamsOf<CapsuleGeometry3D>> { }\n\nconst CAPSULE_KEYS = [\"radius\", \"height\", \"segments\"] as const;\n\n/** A pill. `height` is the straight mid-section; `segments` is `[radial, cap]`. */\nexport class Capsule3D<P extends Capsule3DProps = Capsule3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"capsule\", this, CAPSULE_KEYS);\n }\n}\n\n// ─── polyhedron ──────────────────────────────────────────────────────────────\n\nexport interface Polyhedron3DProps extends Mesh3DProps, Partial<ParamsOf<PolyhedronGeometry3D>> { }\n\nconst POLYHEDRON_KEYS = [\"shape\", \"radius\", \"segments\"] as const;\n\n/** A platonic solid. `segments` subdivides it toward a sphere. */\nexport class Polyhedron3D<P extends Polyhedron3DProps = Polyhedron3DProps> extends Mesh3D<P> {\n @property({ default: \"icosahedron\" }) declare shape: PolyhedronGeometry3D[\"shape\"];\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"polyhedron\", this, POLYHEDRON_KEYS);\n }\n}\n\n// ─── extrude ─────────────────────────────────────────────────────────────────\n\nexport interface Extrude3DProps extends Mesh3DProps, Partial<ParamsOf<ExtrudeGeometry3D>> { }\n\nconst EXTRUDE_KEYS = [\"path\", \"depth\", \"segments\", \"bevel\"] as const;\n\n/**\n * A 2D outline swept into a solid. `path` takes the same value the 2D `Path`\n * node's own `path` prop does — same name, same vocabulary.\n */\nexport class Extrude3D<P extends Extrude3DProps = Extrude3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare path: PathData | PathBuilder | undefined;\n @property({ default: undefined }) declare depth: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare bevel: number | Bevel3D | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"extrude\", this, EXTRUDE_KEYS);\n }\n}\n\n// ─── lathe ───────────────────────────────────────────────────────────────────\n\nexport interface Lathe3DProps extends Mesh3DProps, Partial<ParamsOf<LatheGeometry3D>> { }\n\nconst LATHE_KEYS = [\"points\", \"segments\", ...SWEEP_KEYS] as const;\n\n/** A profile revolved about Y — vases, bowls, turned shapes. */\nexport class Lathe3D<P extends Lathe3DProps = Lathe3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare points: readonly Vector3Input[] | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare startAngle: number | undefined;\n @property({ default: undefined }) declare sweep: number | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"lathe\", this, LATHE_KEYS);\n }\n}\n\n// ─── tube ────────────────────────────────────────────────────────────────────\n\nexport interface Tube3DProps extends Mesh3DProps, Partial<ParamsOf<TubeGeometry3D>> { }\n\nconst TUBE_KEYS = [\"points\", \"radius\", \"segments\", \"closed\"] as const;\n\n/**\n * A circular cross-section swept along a curve. `closed` joins the ends, the\n * same prop the 2D `Line` node carries; `segments` is `[along, around]`.\n */\nexport class Tube3D<P extends Tube3DProps = Tube3DProps> extends Mesh3D<P> {\n @property({ default: undefined }) declare points: readonly Vector3Input[] | undefined;\n @property({ default: undefined }) declare radius: number | undefined;\n @property({ default: undefined }) declare segments: Segments3D | undefined;\n @property({ default: undefined }) declare closed: boolean | undefined;\n\n protected override buildGeometry(): Geometry3D {\n return geometryFrom(\"tube\", this, TUBE_KEYS);\n }\n}\n"]}
1
+ {"version":3,"file":"geometry-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/geometry-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport type { PathBuilder } from \"@/render/descriptors/path-builder\";\r\nimport type { PathData } from \"@/render/descriptors/path\";\r\nimport type {\r\n Bevel3D, BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"@/render3d/geometry\";\r\nimport type { Segments3D } from \"@/render3d/segments\";\r\nimport type { Vector3Input } from \"@/render3d/vector3\";\r\nimport { Mesh3D, type Mesh3DProps } from \"./mesh3d\";\r\n\r\n/**\r\n * The geometry nodes: one per shape `Graphics3D` has sugar for, so a scene reads\r\n * as a tree of things rather than as a builder chain.\r\n *\r\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\r\n * <Torus3D radius={1.4} thickness={0.08} position={[3, 0, 0]} />\r\n *\r\n * Each is a {@link Mesh3D}, so it carries the whole material vocabulary and the\r\n * whole `Node3D` transform. The only thing a subclass adds is its geometry's own\r\n * parameters — every one optional, so an unset parameter stays *absent* from the\r\n * descriptor and the renderer's own default applies rather than one invented here.\r\n *\r\n * ── Two names, everywhere ─────────────────────────────────────────────────────\r\n * Subdivision is always `segments` (a number, or a per-axis tuple whose order\r\n * each shape documents), replacing the ten spellings three has for it. A partial\r\n * revolution is always `startAngle` + `sweep` in degrees — the pair `Ellipse` has\r\n * used since the beginning — replacing `thetaStart`, `thetaLength`, `phiStart`,\r\n * `phiLength` and `arc`.\r\n *\r\n * A shape without sugar (a buffer, a parametric surface, a loaded model's mesh)\r\n * goes through the base directly: `<Mesh3D geometry={Geo.parametric({ … })} />`.\r\n *\r\n * **Geometry parameters are expensive to animate.** Three's geometries are\r\n * immutable, so tweening `radius` reallocates the mesh every frame. Tween\r\n * `scale` (or one of `scaleX`/`scaleY`/`scaleZ`) instead — those are in-place\r\n * writes on the object's matrix.\r\n */\r\n\r\n/** Params of a geometry descriptor, minus its discriminant. */\r\ntype ParamsOf<G extends { type: string }> = Omit<G, \"type\">;\r\n\r\n/**\r\n * Gather the set parameters off a node into a geometry descriptor.\r\n *\r\n * Reads through the prop accessors, so every parameter is live and a `to()` on\r\n * one rebuilds the geometry on the next frame.\r\n */\r\nfunction geometryFrom(type: Geometry3D[\"type\"], node: object, keys: readonly string[]): Geometry3D {\r\n const out: Record<string, unknown> = { type };\r\n for (const key of keys) {\r\n const value = (node as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n return out as unknown as Geometry3D;\r\n}\r\n\r\n/** The two sweep props every partially-revolvable shape carries. */\r\nconst SWEEP_KEYS = [\"startAngle\", \"sweep\"] as const;\r\n\r\n// ─── box ─────────────────────────────────────────────────────────────────────\r\n\r\nexport interface Box3DProps extends Mesh3DProps, Partial<ParamsOf<BoxGeometry3D>> { }\r\n\r\nconst BOX_KEYS = [\"width\", \"height\", \"depth\", \"cornerRadius\", \"segments\"] as const;\r\n\r\n/**\r\n * A box — and, with `cornerRadius`, the rounded box that most of a designed 3D\r\n * scene is made of. Same prop name and same meaning as `Rect`'s.\r\n */\r\nexport class Box3D<P extends Box3DProps = Box3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare width: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n @property({ default: undefined }) declare depth: number | undefined;\r\n @property({ default: undefined }) declare cornerRadius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"box\", this, BOX_KEYS);\r\n }\r\n}\r\n\r\n// ─── sphere ──────────────────────────────────────────────────────────────────\r\n\r\nexport interface Sphere3DProps extends Mesh3DProps, Partial<ParamsOf<SphereGeometry3D>> { }\r\n\r\nconst SPHERE_KEYS = [\"radius\", \"segments\", \"startLatitude\", \"latitudeSweep\", ...SWEEP_KEYS] as const;\r\n\r\n/** A sphere. `segments` is `[longitude, latitude]`. */\r\nexport class Sphere3D<P extends Sphere3DProps = Sphere3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n @property({ default: undefined }) declare startLatitude: number | undefined;\r\n @property({ default: undefined }) declare latitudeSweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"sphere\", this, SPHERE_KEYS);\r\n }\r\n}\r\n\r\n// ─── plane ───────────────────────────────────────────────────────────────────\r\n\r\nexport interface Plane3DProps extends Mesh3DProps, Partial<ParamsOf<PlaneGeometry3D>> { }\r\n\r\nconst PLANE_KEYS = [\"width\", \"height\", \"segments\"] as const;\r\n\r\n/** A flat quad. `segments` is `[width, height]`. */\r\nexport class Plane3D<P extends Plane3DProps = Plane3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare width: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"plane\", this, PLANE_KEYS);\r\n }\r\n}\r\n\r\n// ─── cylinder ────────────────────────────────────────────────────────────────\r\n\r\nexport interface Cylinder3DProps extends Mesh3DProps, Partial<ParamsOf<CylinderGeometry3D>> { }\r\n\r\nconst CYLINDER_KEYS = [\"radius\", \"height\", \"segments\", \"capped\", ...SWEEP_KEYS] as const;\r\n\r\n/**\r\n * A cylinder, or any tapered tube: `radius={[top, bottom]}`. `segments` is\r\n * `[radial, height]`.\r\n */\r\nexport class Cylinder3D<P extends Cylinder3DProps = Cylinder3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | readonly [number, number] | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare capped: boolean | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"cylinder\", this, CYLINDER_KEYS);\r\n }\r\n}\r\n\r\n// ─── cone ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface Cone3DProps extends Mesh3DProps, Partial<ParamsOf<ConeGeometry3D>> { }\r\n\r\nconst CONE_KEYS = [\"radius\", \"height\", \"segments\", \"capped\", ...SWEEP_KEYS] as const;\r\n\r\n/** A cone. `segments` is `[radial, height]`. */\r\nexport class Cone3D<P extends Cone3DProps = Cone3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare capped: boolean | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"cone\", this, CONE_KEYS);\r\n }\r\n}\r\n\r\n// ─── torus ───────────────────────────────────────────────────────────────────\r\n\r\nexport interface Torus3DProps extends Mesh3DProps, Partial<ParamsOf<TorusGeometry3D>> { }\r\n\r\nconst TORUS_KEYS = [\"radius\", \"thickness\", \"segments\", ...SWEEP_KEYS] as const;\r\n\r\n/** A ring. `thickness` is the strand; `segments` is `[radial, tubular]`. */\r\nexport class Torus3D<P extends Torus3DProps = Torus3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare thickness: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"torus\", this, TORUS_KEYS);\r\n }\r\n}\r\n\r\n// ─── torus knot ──────────────────────────────────────────────────────────────\r\n\r\nexport interface TorusKnot3DProps extends Mesh3DProps, Partial<ParamsOf<TorusKnotGeometry3D>> { }\r\n\r\nconst TORUS_KNOT_KEYS = [\"radius\", \"thickness\", \"segments\", \"windings\"] as const;\r\n\r\n/** A knotted ring. `windings` is `[p, q]`; `segments` is `[tubular, radial]`. */\r\nexport class TorusKnot3D<P extends TorusKnot3DProps = TorusKnot3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare thickness: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare windings: readonly [number, number] | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"torusKnot\", this, TORUS_KNOT_KEYS);\r\n }\r\n}\r\n\r\n// ─── circle ──────────────────────────────────────────────────────────────────\r\n\r\nexport interface Circle3DProps extends Mesh3DProps, Partial<ParamsOf<CircleGeometry3D>> { }\r\n\r\nconst CIRCLE_KEYS = [\"radius\", \"segments\", ...SWEEP_KEYS] as const;\r\n\r\n/** A flat disc, or a pie slice via `startAngle`/`sweep` — exactly as `Ellipse`. */\r\nexport class Circle3D<P extends Circle3DProps = Circle3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"circle\", this, CIRCLE_KEYS);\r\n }\r\n}\r\n\r\n// ─── ring ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface Ring3DProps extends Mesh3DProps, Partial<ParamsOf<RingGeometry3D>> { }\r\n\r\nconst RING_KEYS = [\"radius\", \"innerRadius\", \"segments\", ...SWEEP_KEYS] as const;\r\n\r\n/** A flat annulus. `radius` is the outer edge; `segments` is `[around, radial]`. */\r\nexport class Ring3D<P extends Ring3DProps = Ring3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare innerRadius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"ring\", this, RING_KEYS);\r\n }\r\n}\r\n\r\n// ─── capsule ─────────────────────────────────────────────────────────────────\r\n\r\nexport interface Capsule3DProps extends Mesh3DProps, Partial<ParamsOf<CapsuleGeometry3D>> { }\r\n\r\nconst CAPSULE_KEYS = [\"radius\", \"height\", \"segments\"] as const;\r\n\r\n/** A pill. `height` is the straight mid-section; `segments` is `[radial, cap]`. */\r\nexport class Capsule3D<P extends Capsule3DProps = Capsule3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"capsule\", this, CAPSULE_KEYS);\r\n }\r\n}\r\n\r\n// ─── polyhedron ──────────────────────────────────────────────────────────────\r\n\r\nexport interface Polyhedron3DProps extends Mesh3DProps, Partial<ParamsOf<PolyhedronGeometry3D>> { }\r\n\r\nconst POLYHEDRON_KEYS = [\"shape\", \"radius\", \"segments\"] as const;\r\n\r\n/** A platonic solid. `segments` subdivides it toward a sphere. */\r\nexport class Polyhedron3D<P extends Polyhedron3DProps = Polyhedron3DProps> extends Mesh3D<P> {\r\n @property({ default: \"icosahedron\" }) declare shape: PolyhedronGeometry3D[\"shape\"];\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"polyhedron\", this, POLYHEDRON_KEYS);\r\n }\r\n}\r\n\r\n// ─── extrude ─────────────────────────────────────────────────────────────────\r\n\r\nexport interface Extrude3DProps extends Mesh3DProps, Partial<ParamsOf<ExtrudeGeometry3D>> { }\r\n\r\nconst EXTRUDE_KEYS = [\"path\", \"depth\", \"segments\", \"bevel\"] as const;\r\n\r\n/**\r\n * A 2D outline swept into a solid. `path` takes the same value the 2D `Path`\r\n * node's own `path` prop does — same name, same vocabulary.\r\n */\r\nexport class Extrude3D<P extends Extrude3DProps = Extrude3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare path: PathData | PathBuilder | undefined;\r\n @property({ default: undefined }) declare depth: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare bevel: number | Bevel3D | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"extrude\", this, EXTRUDE_KEYS);\r\n }\r\n}\r\n\r\n// ─── lathe ───────────────────────────────────────────────────────────────────\r\n\r\nexport interface Lathe3DProps extends Mesh3DProps, Partial<ParamsOf<LatheGeometry3D>> { }\r\n\r\nconst LATHE_KEYS = [\"points\", \"segments\", ...SWEEP_KEYS] as const;\r\n\r\n/** A profile revolved about Y — vases, bowls, turned shapes. */\r\nexport class Lathe3D<P extends Lathe3DProps = Lathe3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare points: readonly Vector3Input[] | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare startAngle: number | undefined;\r\n @property({ default: undefined }) declare sweep: number | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"lathe\", this, LATHE_KEYS);\r\n }\r\n}\r\n\r\n// ─── tube ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface Tube3DProps extends Mesh3DProps, Partial<ParamsOf<TubeGeometry3D>> { }\r\n\r\nconst TUBE_KEYS = [\"points\", \"radius\", \"segments\", \"closed\"] as const;\r\n\r\n/**\r\n * A circular cross-section swept along a curve. `closed` joins the ends;\r\n * `segments` is `[along, around]`.\r\n */\r\nexport class Tube3D<P extends Tube3DProps = Tube3DProps> extends Mesh3D<P> {\r\n @property({ default: undefined }) declare points: readonly Vector3Input[] | undefined;\r\n @property({ default: undefined }) declare radius: number | undefined;\r\n @property({ default: undefined }) declare segments: Segments3D | undefined;\r\n @property({ default: undefined }) declare closed: boolean | undefined;\r\n\r\n protected override buildGeometry(): Geometry3D {\r\n return geometryFrom(\"tube\", this, TUBE_KEYS);\r\n }\r\n}\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"grid-geometry3d.js","sourceRoot":"","sources":["../../../src/nodes/three/grid-geometry3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BufferGeometry3D } from \"@/render3d/geometry\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\n\nimport { resolveColor3D } from \"@/attributes/render3d/orbit\"\n\n/** How the ground plane is drawn — the fields the Canvas 3D's schema states. */\nexport interface Grid3DOptions {\n /** Total extent of the grid, in scene units. It spans `±size / 2` on both axes. */\n size: number\n /** How many cells across. One minor line per cell boundary. */\n divisions: number\n /** Every Nth minor line is drawn in {@link majorColor} instead. */\n majorEvery: number\n minorColor: Color\n majorColor: Color\n /** The line through `z = 0`. Red by convention, in every 3D tool there is. */\n axisXColor: Color\n /** The line through `x = 0`. Blue by the same convention. */\n axisZColor: Color\n /** Whether to draw the two axis lines at all. */\n showAxes: boolean\n /**\n * What the far edge fades into — the colour behind the grid.\n *\n * Fading is done by lerping each vertex's *colour* toward this rather than by\n * dropping its alpha, because a vertex colour is RGB and there is nowhere to\n * put a per-vertex alpha in the descriptor (see {@link BufferGeometry3D}). Over\n * an opaque background the two are indistinguishable, and this one costs no\n * blending and no sort order.\n *\n * A {@link Color} rather than a string, because it is read off the node's fill\n * stack now — see `Canvas3DView.fadeColor` — and a resolved paint holds its\n * colour as a normalized tuple.\n */\n fadeTo: Color\n /**\n * How much of the way to the edge the fade has finished, in `[0, 1]`.\n *\n * `0` disables it. Distance is measured radially from the origin rather than\n * per-axis, so the grid dissolves into a disc — which is what stops the four\n * corners from staying visible long after the edges have gone, and is why the\n * horizon in a viewport reads as a horizon rather than as a square table.\n */\n fade: number\n}\n\n/**\n * The ground plane, as one buffer of line segments.\n *\n * **One geometry, not three.** The minor lines, the major lines and the two axes\n * differ only in colour, and colour is a vertex attribute — so drawing them as\n * three ops with three materials would be three draw calls, three cache entries\n * and three chances for the sort order to put an axis under the grid it is\n * supposed to sit in. Baking the colour per vertex makes it one op with\n * `vertexColors: true` on a single unlit material, which is also the only way to\n * get the distance fade at all: it varies *along* each line, and a material's\n * colour is uniform across the primitive it paints.\n *\n * The returned arrays are freshly allocated, so the caller is expected to cache\n * them — see {@link Canvas3DView}, which does, and marks the result\n * `staticData` on the strength of it. Rebuilding this every frame would be\n * ~10k floats of allocation and a full re-upload for a picture that only changes\n * when somebody edits a field.\n */\nexport function gridGeometry3D(options: Grid3DOptions): BufferGeometry3D {\n const { size, divisions, majorEvery, showAxes, fade } = options\n\n const half = size / 2\n const step = size / divisions\n const minor = rgb(options.minorColor)\n const major = rgb(options.majorColor)\n const axisX = rgb(options.axisXColor)\n const axisZ = rgb(options.axisZColor)\n const fadeTo = rgb(options.fadeTo)\n\n const position: number[] = []\n const color: number[] = []\n\n /** One segment, with each end faded by its own distance from the origin. */\n const segment = (\n ax: number,\n az: number,\n bx: number,\n bz: number,\n tint: readonly [number, number, number]\n ): void => {\n // y is a hair above zero for the axes only — see the call sites. Everything\n // here is the same plane otherwise.\n position.push(ax, 0, az, bx, 0, bz)\n pushFaded(color, tint, fadeTo, fadeAt(ax, az, half, fade))\n pushFaded(color, tint, fadeTo, fadeAt(bx, bz, half, fade))\n }\n\n for (let i = 0; i <= divisions; i++) {\n const offset = -half + i * step\n // The index counted from the centre line, so \"every Nth\" is symmetrical\n // about the origin rather than about the grid's far corner — otherwise the\n // major lines drift off-centre on an odd division count.\n const fromCentre = Math.abs(i - divisions / 2)\n const isCentre = Math.abs(offset) < step / 2\n // The centre lines are the axes' own, so they are skipped here when the axes\n // are being drawn and left as ordinary major lines when they are not.\n if (isCentre && showAxes) continue\n\n const tint =\n Number.isInteger(fromCentre) && fromCentre % majorEvery === 0\n ? major\n : minor\n\n segment(offset, -half, offset, half, tint)\n segment(-half, offset, half, offset, tint)\n }\n\n if (showAxes) {\n // The X axis runs along x with z pinned at 0, and vice versa. Same plane as\n // the grid: they replace the two centre lines rather than sitting over them,\n // so there is nothing to z-fight with.\n segment(-half, 0, half, 0, axisX)\n segment(0, -half, 0, half, axisZ)\n }\n\n return {\n type: \"buffer\",\n position: new Float32Array(position),\n color: new Float32Array(color),\n // Nothing here is lit — a grid is emissive by nature — so there are no\n // normals to derive and asking for them would be a wasted pass.\n computeNormals: false,\n // True only because the caller caches: see this module's note.\n staticData: true,\n }\n}\n\n/**\n * How faded a point is, in `[0, 1]`, where 1 is fully the background.\n *\n * Squared falloff rather than linear, because a linear ramp over a plane seen at\n * a shallow angle reads as a hard edge — most of the ramp is compressed into the\n * last few pixels before the horizon. The square spends more of its range near\n * the camera, where the perspective is stretching it back out.\n */\nfunction fadeAt(\n x: number,\n z: number,\n half: number,\n fade: number\n): number {\n if (fade <= 0) return 0\n const distance = Math.hypot(x, z) / half\n const start = 1 - fade\n if (distance <= start) return 0\n const t = Math.min(1, (distance - start) / Math.max(fade, 1e-6))\n return t * t\n}\n\n/** Push one vertex colour, lerped `t` of the way from `tint` toward `fadeTo`. */\nfunction pushFaded(\n out: number[],\n tint: readonly [number, number, number],\n fadeTo: readonly [number, number, number],\n t: number\n): void {\n out.push(\n tint[0] + (fadeTo[0] - tint[0]) * t,\n tint[1] + (fadeTo[1] - tint[1]) * t,\n tint[2] + (fadeTo[2] - tint[2]) * t\n )\n}\n\n/**\n * A colour as the linear RGB triple a vertex attribute holds.\n *\n * `resolveColor3D` gives normalized sRGB; three reads vertex colours as\n * **linear**, so each channel is converted. Skipping this is the classic\n * washed-out-grid bug: an sRGB 0.16 uploaded as linear paints at about 0.4,\n * which is why a grid that should whisper ends up shouting.\n */\nfunction rgb(value: Color): [number, number, number] {\n const [r, g, b] = resolveColor3D(value)\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)]\n}\n\n/** The sRGB transfer function, inverted. three's own `SRGBToLinear`. */\nfunction srgbToLinear(channel: number): number {\n return channel < 0.04045\n ? channel * 0.0773993808\n : Math.pow(channel * 0.9478672986 + 0.0521327014, 2.4)\n}\n"]}
1
+ {"version":3,"file":"grid-geometry3d.js","sourceRoot":"","sources":["../../../src/nodes/three/grid-geometry3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BufferGeometry3D } from \"@/render3d/geometry\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\n\r\nimport { resolveColor3D } from \"@/attributes/render3d/orbit\"\r\n\r\n/** How the ground plane is drawn — the fields the Canvas 3D's schema states. */\r\nexport interface Grid3DOptions {\r\n /** Total extent of the grid, in scene units. It spans `±size / 2` on both axes. */\r\n size: number\r\n /** How many cells across. One minor line per cell boundary. */\r\n divisions: number\r\n /** Every Nth minor line is drawn in {@link majorColor} instead. */\r\n majorEvery: number\r\n minorColor: Color\r\n majorColor: Color\r\n /** The line through `z = 0`. Red by convention, in every 3D tool there is. */\r\n axisXColor: Color\r\n /** The line through `x = 0`. Blue by the same convention. */\r\n axisZColor: Color\r\n /** Whether to draw the two axis lines at all. */\r\n showAxes: boolean\r\n /**\r\n * What the far edge fades into — the colour behind the grid.\r\n *\r\n * Fading is done by lerping each vertex's *colour* toward this rather than by\r\n * dropping its alpha, because a vertex colour is RGB and there is nowhere to\r\n * put a per-vertex alpha in the descriptor (see {@link BufferGeometry3D}). Over\r\n * an opaque background the two are indistinguishable, and this one costs no\r\n * blending and no sort order.\r\n *\r\n * A {@link Color} rather than a string, because it is read off the node's fill\r\n * stack now — see `Canvas3DView.fadeColor` — and a resolved paint holds its\r\n * colour as a normalized tuple.\r\n */\r\n fadeTo: Color\r\n /**\r\n * How much of the way to the edge the fade has finished, in `[0, 1]`.\r\n *\r\n * `0` disables it. Distance is measured radially from the origin rather than\r\n * per-axis, so the grid dissolves into a disc — which is what stops the four\r\n * corners from staying visible long after the edges have gone, and is why the\r\n * horizon in a viewport reads as a horizon rather than as a square table.\r\n */\r\n fade: number\r\n}\r\n\r\n/**\r\n * The ground plane, as one buffer of line segments.\r\n *\r\n * **One geometry, not three.** The minor lines, the major lines and the two axes\r\n * differ only in colour, and colour is a vertex attribute — so drawing them as\r\n * three ops with three materials would be three draw calls, three cache entries\r\n * and three chances for the sort order to put an axis under the grid it is\r\n * supposed to sit in. Baking the colour per vertex makes it one op with\r\n * `vertexColors: true` on a single unlit material, which is also the only way to\r\n * get the distance fade at all: it varies *along* each line, and a material's\r\n * colour is uniform across the primitive it paints.\r\n *\r\n * The returned arrays are freshly allocated, so the caller is expected to cache\r\n * them — see {@link Canvas3DView}, which does, and marks the result\r\n * `staticData` on the strength of it. Rebuilding this every frame would be\r\n * ~10k floats of allocation and a full re-upload for a picture that only changes\r\n * when somebody edits a field.\r\n */\r\nexport function gridGeometry3D(options: Grid3DOptions): BufferGeometry3D {\r\n const { size, divisions, majorEvery, showAxes, fade } = options\r\n\r\n const half = size / 2\r\n const step = size / divisions\r\n const minor = rgb(options.minorColor)\r\n const major = rgb(options.majorColor)\r\n const axisX = rgb(options.axisXColor)\r\n const axisZ = rgb(options.axisZColor)\r\n const fadeTo = rgb(options.fadeTo)\r\n\r\n const position: number[] = []\r\n const color: number[] = []\r\n\r\n /** One segment, with each end faded by its own distance from the origin. */\r\n const segment = (\r\n ax: number,\r\n az: number,\r\n bx: number,\r\n bz: number,\r\n tint: readonly [number, number, number]\r\n ): void => {\r\n // y is a hair above zero for the axes only — see the call sites. Everything\r\n // here is the same plane otherwise.\r\n position.push(ax, 0, az, bx, 0, bz)\r\n pushFaded(color, tint, fadeTo, fadeAt(ax, az, half, fade))\r\n pushFaded(color, tint, fadeTo, fadeAt(bx, bz, half, fade))\r\n }\r\n\r\n for (let i = 0; i <= divisions; i++) {\r\n const offset = -half + i * step\r\n // The index counted from the centre line, so \"every Nth\" is symmetrical\r\n // about the origin rather than about the grid's far corner — otherwise the\r\n // major lines drift off-centre on an odd division count.\r\n const fromCentre = Math.abs(i - divisions / 2)\r\n const isCentre = Math.abs(offset) < step / 2\r\n // The centre lines are the axes' own, so they are skipped here when the axes\r\n // are being drawn and left as ordinary major lines when they are not.\r\n if (isCentre && showAxes) continue\r\n\r\n const tint =\r\n Number.isInteger(fromCentre) && fromCentre % majorEvery === 0\r\n ? major\r\n : minor\r\n\r\n segment(offset, -half, offset, half, tint)\r\n segment(-half, offset, half, offset, tint)\r\n }\r\n\r\n if (showAxes) {\r\n // The X axis runs along x with z pinned at 0, and vice versa. Same plane as\r\n // the grid: they replace the two centre lines rather than sitting over them,\r\n // so there is nothing to z-fight with.\r\n segment(-half, 0, half, 0, axisX)\r\n segment(0, -half, 0, half, axisZ)\r\n }\r\n\r\n return {\r\n type: \"buffer\",\r\n position: new Float32Array(position),\r\n color: new Float32Array(color),\r\n // Nothing here is lit — a grid is emissive by nature — so there are no\r\n // normals to derive and asking for them would be a wasted pass.\r\n computeNormals: false,\r\n // True only because the caller caches: see this module's note.\r\n staticData: true,\r\n }\r\n}\r\n\r\n/**\r\n * How faded a point is, in `[0, 1]`, where 1 is fully the background.\r\n *\r\n * Squared falloff rather than linear, because a linear ramp over a plane seen at\r\n * a shallow angle reads as a hard edge — most of the ramp is compressed into the\r\n * last few pixels before the horizon. The square spends more of its range near\r\n * the camera, where the perspective is stretching it back out.\r\n */\r\nfunction fadeAt(\r\n x: number,\r\n z: number,\r\n half: number,\r\n fade: number\r\n): number {\r\n if (fade <= 0) return 0\r\n const distance = Math.hypot(x, z) / half\r\n const start = 1 - fade\r\n if (distance <= start) return 0\r\n const t = Math.min(1, (distance - start) / Math.max(fade, 1e-6))\r\n return t * t\r\n}\r\n\r\n/** Push one vertex colour, lerped `t` of the way from `tint` toward `fadeTo`. */\r\nfunction pushFaded(\r\n out: number[],\r\n tint: readonly [number, number, number],\r\n fadeTo: readonly [number, number, number],\r\n t: number\r\n): void {\r\n out.push(\r\n tint[0] + (fadeTo[0] - tint[0]) * t,\r\n tint[1] + (fadeTo[1] - tint[1]) * t,\r\n tint[2] + (fadeTo[2] - tint[2]) * t\r\n )\r\n}\r\n\r\n/**\r\n * A colour as the linear RGB triple a vertex attribute holds.\r\n *\r\n * `resolveColor3D` gives normalized sRGB; three reads vertex colours as\r\n * **linear**, so each channel is converted. Skipping this is the classic\r\n * washed-out-grid bug: an sRGB 0.16 uploaded as linear paints at about 0.4,\r\n * which is why a grid that should whisper ends up shouting.\r\n */\r\nfunction rgb(value: Color): [number, number, number] {\r\n const [r, g, b] = resolveColor3D(value)\r\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)]\r\n}\r\n\r\n/** The sRGB transfer function, inverted. three's own `SRGBToLinear`. */\r\nfunction srgbToLinear(channel: number): number {\r\n return channel < 0.04045\r\n ? channel * 0.0773993808\r\n : Math.pow(channel * 0.9478672986 + 0.0521327014, 2.4)\r\n}\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"group3d.js","sourceRoot":"","sources":["../../../src/nodes/three/group3d.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,OAA+C,SAAQ,MAAS;CAAI","sourcesContent":["import type { Node3DProps } from \"./node3d\";\nimport { Node3D } from \"./node3d\";\n\nexport type Group3DProps = Node3DProps;\n\n/**\n * A transform with children and nothing of its own to draw — the 3D `<Rect>` that\n * only groups.\n *\n * Move, rotate or scale it and everything under it follows, which is what makes a\n * rig animatable as one thing:\n *\n * <Group3D ref={rig} position={[0, 1, 0]}>\n * <Box3D width={2} />\n * <Sphere3D radius={0.8} position={[3, 0, 0]} />\n * </Group3D>\n *\n * rig().to({ data: { rotation: [0, 360, 0] }, duration: 2 });\n *\n * `Node3D` already draws nothing by default, so this adds no behaviour — it\n * exists to be named for what it is at the call site.\n */\nexport class Group3D<P extends Group3DProps = Group3DProps> extends Node3D<P> { }\n"]}
1
+ {"version":3,"file":"group3d.js","sourceRoot":"","sources":["../../../src/nodes/three/group3d.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,OAA+C,SAAQ,MAAS;CAAI","sourcesContent":["import type { Node3DProps } from \"./node3d\";\r\nimport { Node3D } from \"./node3d\";\r\n\r\nexport type Group3DProps = Node3DProps;\r\n\r\n/**\r\n * A transform with children and nothing of its own to draw — the 3D `<Rect>` that\r\n * only groups.\r\n *\r\n * Move, rotate or scale it and everything under it follows, which is what makes a\r\n * rig animatable as one thing:\r\n *\r\n * <Group3D ref={rig} position={[0, 1, 0]}>\r\n * <Box3D width={2} />\r\n * <Sphere3D radius={0.8} position={[3, 0, 0]} />\r\n * </Group3D>\r\n *\r\n * rig().to({ data: { rotation: [0, 360, 0] }, duration: 2 });\r\n *\r\n * `Node3D` already draws nothing by default, so this adds no behaviour — it\r\n * exists to be named for what it is at the call site.\r\n */\r\nexport class Group3D<P extends Group3DProps = Group3DProps> extends Node3D<P> { }\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"light-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"light-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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"}
@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
5
5
  return c > 3 && r && Object.defineProperty(target, key, r), r;
6
6
  };
7
7
  import { property } from "../../attributes/properties/decorator.js";
8
- import { colorProperty } from "../../attributes/properties/typed.js";
8
+ import { colorProperty, optionalVector3Property } from "../../attributes/properties/typed.js";
9
9
  import { Node3D } from "./node3d.js";
10
10
  /**
11
11
  * A light's own parameters, gathered off the props that were actually set.
@@ -102,7 +102,7 @@ __decorate([
102
102
  property({ default: undefined })
103
103
  ], DirectionalLight3D.prototype, "intensity", void 0);
104
104
  __decorate([
105
- property({ default: undefined })
105
+ optionalVector3Property("origin")
106
106
  ], DirectionalLight3D.prototype, "target", void 0);
107
107
  const POINT_KEYS = ["color", "intensity", "distance", "decay", "shadow"];
108
108
  /** A bulb: light radiating from a point, falling off with distance. */
@@ -149,7 +149,7 @@ __decorate([
149
149
  property({ default: undefined })
150
150
  ], SpotLight3D.prototype, "decay", void 0);
151
151
  __decorate([
152
- property({ default: undefined })
152
+ optionalVector3Property("origin")
153
153
  ], SpotLight3D.prototype, "target", void 0);
154
154
  const AREA_KEYS = ["color", "intensity", "width", "height"];
155
155
  /** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */
@@ -1 +1 @@
1
- {"version":3,"file":"light-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport { colorProperty } from \"@/attributes/properties/typed\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type {\n AmbientLightData3D, AreaLightData3D, DirectionalLightData3D,\n HemisphereLightData3D, LightData3D, PointLightData3D, SpotLightData3D,\n} from \"@/render3d/light\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\n\nimport { Node3D, type Node3DProps } from \"./node3d\";\nimport type { NodeConfig } from \"@/nodes/node/node\";\n\n/**\n * The light nodes.\n *\n * A light is a thing in the scene with a position, so it is a `Node3D` like any\n * other — it can sit inside a `Group3D` and be carried by it, be held by a ref,\n * and have its `intensity` or `color` tweened:\n *\n * <DirectionalLight3D ref={key} intensity={2.4} position={[4, 6, 3]} shadow />\n * key().to({ data: { intensity: 0.2 }, duration: 1 });\n *\n * `AmbientLight3D` and `HemisphereLight3D` have no position — they light the\n * whole scene evenly — but are still nodes, so they read the same way in a tree.\n *\n * ── Intensity is one scale ────────────────────────────────────────────────────\n * A point or spot light's `intensity` means the same thing a directional light's\n * does: 1 is a normal light. three measures the first two in candela and the\n * third in lux, which is physically correct and is why scenes ended up written\n * with `intensity={2.4}` beside `intensity={40}`. The renderer converts.\n */\n\n/** Params of a light descriptor, minus its discriminant. */\n// `shadow` is dropped because `Node3DProps` already declares it, as the broader\n// `Shadow3D` a mesh also takes — one prop, one type, asked of both kinds of node.\ntype ParamsOf<L extends { type: string }> = Omit<L, \"type\" | \"shadow\">;\n\n/**\n * A light's own parameters, gathered off the props that were actually set.\n *\n * Omitted keys stay absent so the renderer's default applies, exactly as the\n * `Graphics3D` light sugar does.\n */\nfunction lightFrom(type: LightData3D[\"type\"], node: object, keys: readonly string[]): LightData3D {\n const out: Record<string, unknown> = { type };\n for (const key of keys) {\n const value = (node as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n return out as unknown as LightData3D;\n}\n\n/** Shared base: every light draws itself by declaring itself to the context. */\nabstract class Light3DNode<P extends Node3DProps> extends Node3D<P> {\n /** The descriptor this node contributes. */\n protected abstract buildLight(): LightData3D;\n\n /** Loads nothing — and recording `renderSelf` would make every light prop a dependency. */\n override declareAssets(): void { }\n\n protected override renderSelf(ctx: RenderContext3D): void {\n ctx.light(this.buildLight());\n }\n}\n\n/**\n * A light that can cast a shadow map.\n *\n * `shadow` is the {@link Shadow3D} every node carries, and it defaults to `true`\n * there because that is right for a *mesh* — turning shadows on should make\n * meshes cast and receive without tagging each one. A light is the other half of\n * that trade: every light casting is N shadow maps, and a point light's is six\n * faces. So the default is flipped here, in the constructor rather than by\n * redeclaring the prop, because the property registry keeps the base class's\n * metadata for a key and a subclass decorator would be silently ignored.\n */\nabstract class ShadowCastingLight3D<P extends Node3DProps> extends Light3DNode<P> {\n constructor(props?: NodeConfig<any, P>) {\n super(props);\n // Only when the author said nothing: an explicit `shadow` — including\n // `shadow={false}` — has already been written by `initProps`.\n if (props?.shadow === undefined) this.applyProp(\"shadow\", false);\n }\n}\n\n// ─── ambient ─────────────────────────────────────────────────────────────────\n\nexport interface AmbientLight3DProps extends Node3DProps, Partial<ParamsOf<AmbientLightData3D>> { }\n\nconst AMBIENT_KEYS = [\"color\", \"intensity\"] as const;\n\n/** Flat, directionless fill light. The cheapest way to stop shadows being black. */\nexport class AmbientLight3D<P extends AmbientLight3DProps = AmbientLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"ambient\", this, AMBIENT_KEYS);\n }\n}\n\n// ─── hemisphere ──────────────────────────────────────────────────────────────\n\nexport interface HemisphereLight3DProps extends Node3DProps, Partial<ParamsOf<HemisphereLightData3D>> { }\n\nconst HEMISPHERE_KEYS = [\"sky\", \"ground\", \"intensity\"] as const;\n\n/**\n * Sky-to-ground gradient fill — ambient light with a sense of up.\n *\n * The two colours are `sky` and `ground`. They were `color` and `groundColor`,\n * and the node's `color` was silently dropped: the descriptor and the renderer\n * both read `skyColor`, which nothing ever wrote.\n */\nexport class HemisphereLight3D<P extends HemisphereLight3DProps = HemisphereLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare sky: Color | undefined;\n @colorProperty({ default: undefined }) declare ground: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"hemisphere\", this, HEMISPHERE_KEYS);\n }\n}\n\n// ─── directional ─────────────────────────────────────────────────────────────\n\nexport interface DirectionalLight3DProps extends Node3DProps, Partial<ParamsOf<DirectionalLightData3D>> { }\n\nconst DIRECTIONAL_KEYS = [\"color\", \"intensity\", \"target\", \"shadow\"] as const;\n\n/**\n * Parallel rays from a direction — the sun. Its `position` sets the direction it\n * shines *from*, toward `target` (the origin by default).\n */\nexport class DirectionalLight3D<P extends DirectionalLight3DProps = DirectionalLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare target: DirectionalLightData3D[\"target\"];\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"directional\", this, DIRECTIONAL_KEYS);\n }\n}\n\n// ─── point ───────────────────────────────────────────────────────────────────\n\nexport interface PointLight3DProps extends Node3DProps, Partial<ParamsOf<PointLightData3D>> { }\n\nconst POINT_KEYS = [\"color\", \"intensity\", \"distance\", \"decay\", \"shadow\"] as const;\n\n/** A bulb: light radiating from a point, falling off with distance. */\nexport class PointLight3D<P extends PointLight3DProps = PointLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare distance: number | undefined;\n @property({ default: undefined }) declare decay: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"point\", this, POINT_KEYS);\n }\n}\n\n// ─── spot ────────────────────────────────────────────────────────────────────\n\nexport interface SpotLight3DProps extends Node3DProps, Partial<ParamsOf<SpotLightData3D>> { }\n\nconst SPOT_KEYS = [\"color\", \"intensity\", \"distance\", \"angle\", \"penumbra\", \"decay\", \"target\", \"shadow\"] as const;\n\n/** A cone of light. `angle` is the cone half-angle, in **degrees**. */\nexport class SpotLight3D<P extends SpotLight3DProps = SpotLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare distance: number | undefined;\n @property({ default: undefined }) declare angle: number | undefined;\n @property({ default: undefined }) declare penumbra: number | undefined;\n @property({ default: undefined }) declare decay: number | undefined;\n @property({ default: undefined }) declare target: SpotLightData3D[\"target\"];\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"spot\", this, SPOT_KEYS);\n }\n}\n\n// ─── area ────────────────────────────────────────────────────────────────────\n\nexport interface AreaLight3DProps extends Node3DProps, Partial<ParamsOf<AreaLightData3D>> { }\n\nconst AREA_KEYS = [\"color\", \"intensity\", \"width\", \"height\"] as const;\n\n/** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */\nexport class AreaLight3D<P extends AreaLight3DProps = AreaLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare width: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"area\", this, AREA_KEYS);\n }\n}\n\n"]}
1
+ {"version":3,"file":"light-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { colorProperty, optionalVector3Property } from \"@/attributes/properties/typed\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n AmbientLightData3D, AreaLightData3D, DirectionalLightData3D,\r\n HemisphereLightData3D, LightData3D, PointLightData3D, SpotLightData3D,\r\n} from \"@/render3d/light\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\n\r\nimport { Node3D, type Node3DProps } from \"./node3d\";\r\nimport type { NodeConfig } from \"@/nodes/node/node\";\r\n\r\n/**\r\n * The light nodes.\r\n *\r\n * A light is a thing in the scene with a position, so it is a `Node3D` like any\r\n * other — it can sit inside a `Group3D` and be carried by it, be held by a ref,\r\n * and have its `intensity` or `color` tweened:\r\n *\r\n * <DirectionalLight3D ref={key} intensity={2.4} position={[4, 6, 3]} shadow />\r\n * key().to({ data: { intensity: 0.2 }, duration: 1 });\r\n *\r\n * `AmbientLight3D` and `HemisphereLight3D` have no position — they light the\r\n * whole scene evenly — but are still nodes, so they read the same way in a tree.\r\n *\r\n * ── Intensity is one scale ────────────────────────────────────────────────────\r\n * A point or spot light's `intensity` means the same thing a directional light's\r\n * does: 1 is a normal light. three measures the first two in candela and the\r\n * third in lux, which is physically correct and is why scenes ended up written\r\n * with `intensity={2.4}` beside `intensity={40}`. The renderer converts.\r\n */\r\n\r\n/** Params of a light descriptor, minus its discriminant. */\r\n// `shadow` is dropped because `Node3DProps` already declares it, as the broader\r\n// `Shadow3D` a mesh also takes — one prop, one type, asked of both kinds of node.\r\ntype ParamsOf<L extends { type: string }> = Omit<L, \"type\" | \"shadow\">;\r\n\r\n/**\r\n * A light's own parameters, gathered off the props that were actually set.\r\n *\r\n * Omitted keys stay absent so the renderer's default applies, exactly as the\r\n * `Graphics3D` light sugar does.\r\n */\r\nfunction lightFrom(type: LightData3D[\"type\"], node: object, keys: readonly string[]): LightData3D {\r\n const out: Record<string, unknown> = { type };\r\n for (const key of keys) {\r\n const value = (node as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n return out as unknown as LightData3D;\r\n}\r\n\r\n/** Shared base: every light draws itself by declaring itself to the context. */\r\nabstract class Light3DNode<P extends Node3DProps> extends Node3D<P> {\r\n /** The descriptor this node contributes. */\r\n protected abstract buildLight(): LightData3D;\r\n\r\n /** Loads nothing — and recording `renderSelf` would make every light prop a dependency. */\r\n override declareAssets(): void { }\r\n\r\n protected override renderSelf(ctx: RenderContext3D): void {\r\n ctx.light(this.buildLight());\r\n }\r\n}\r\n\r\n/**\r\n * A light that can cast a shadow map.\r\n *\r\n * `shadow` is the {@link Shadow3D} every node carries, and it defaults to `true`\r\n * there because that is right for a *mesh* — turning shadows on should make\r\n * meshes cast and receive without tagging each one. A light is the other half of\r\n * that trade: every light casting is N shadow maps, and a point light's is six\r\n * faces. So the default is flipped here, in the constructor rather than by\r\n * redeclaring the prop, because the property registry keeps the base class's\r\n * metadata for a key and a subclass decorator would be silently ignored.\r\n */\r\nabstract class ShadowCastingLight3D<P extends Node3DProps> extends Light3DNode<P> {\r\n constructor(props?: NodeConfig<any, P>) {\r\n super(props);\r\n // Only when the author said nothing: an explicit `shadow` — including\r\n // `shadow={false}` — has already been written by `initProps`.\r\n if (props?.shadow === undefined) this.applyProp(\"shadow\", false);\r\n }\r\n}\r\n\r\n// ─── ambient ─────────────────────────────────────────────────────────────────\r\n\r\nexport interface AmbientLight3DProps extends Node3DProps, Partial<ParamsOf<AmbientLightData3D>> { }\r\n\r\nconst AMBIENT_KEYS = [\"color\", \"intensity\"] as const;\r\n\r\n/** Flat, directionless fill light. The cheapest way to stop shadows being black. */\r\nexport class AmbientLight3D<P extends AmbientLight3DProps = AmbientLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"ambient\", this, AMBIENT_KEYS);\r\n }\r\n}\r\n\r\n// ─── hemisphere ──────────────────────────────────────────────────────────────\r\n\r\nexport interface HemisphereLight3DProps extends Node3DProps, Partial<ParamsOf<HemisphereLightData3D>> { }\r\n\r\nconst HEMISPHERE_KEYS = [\"sky\", \"ground\", \"intensity\"] as const;\r\n\r\n/**\r\n * Sky-to-ground gradient fill — ambient light with a sense of up.\r\n *\r\n * The two colours are `sky` and `ground`. They were `color` and `groundColor`,\r\n * and the node's `color` was silently dropped: the descriptor and the renderer\r\n * both read `skyColor`, which nothing ever wrote.\r\n */\r\nexport class HemisphereLight3D<P extends HemisphereLight3DProps = HemisphereLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare sky: Color | undefined;\r\n @colorProperty({ default: undefined }) declare ground: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"hemisphere\", this, HEMISPHERE_KEYS);\r\n }\r\n}\r\n\r\n// ─── directional ─────────────────────────────────────────────────────────────\r\n\r\nexport interface DirectionalLight3DProps extends Node3DProps, Partial<ParamsOf<DirectionalLightData3D>> { }\r\n\r\nconst DIRECTIONAL_KEYS = [\"color\", \"intensity\", \"target\", \"shadow\"] as const;\r\n\r\n/**\r\n * Parallel rays from a direction — the sun. Its `position` sets the direction it\r\n * shines *from*, toward `target` (the origin by default).\r\n */\r\nexport class DirectionalLight3D<P extends DirectionalLight3DProps = DirectionalLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @optionalVector3Property(\"origin\") declare target: DirectionalLightData3D[\"target\"];\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"directional\", this, DIRECTIONAL_KEYS);\r\n }\r\n}\r\n\r\n// ─── point ───────────────────────────────────────────────────────────────────\r\n\r\nexport interface PointLight3DProps extends Node3DProps, Partial<ParamsOf<PointLightData3D>> { }\r\n\r\nconst POINT_KEYS = [\"color\", \"intensity\", \"distance\", \"decay\", \"shadow\"] as const;\r\n\r\n/** A bulb: light radiating from a point, falling off with distance. */\r\nexport class PointLight3D<P extends PointLight3DProps = PointLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare distance: number | undefined;\r\n @property({ default: undefined }) declare decay: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"point\", this, POINT_KEYS);\r\n }\r\n}\r\n\r\n// ─── spot ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface SpotLight3DProps extends Node3DProps, Partial<ParamsOf<SpotLightData3D>> { }\r\n\r\nconst SPOT_KEYS = [\"color\", \"intensity\", \"distance\", \"angle\", \"penumbra\", \"decay\", \"target\", \"shadow\"] as const;\r\n\r\n/** A cone of light. `angle` is the cone half-angle, in **degrees**. */\r\nexport class SpotLight3D<P extends SpotLight3DProps = SpotLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare distance: number | undefined;\r\n @property({ default: undefined }) declare angle: number | undefined;\r\n @property({ default: undefined }) declare penumbra: number | undefined;\r\n @property({ default: undefined }) declare decay: number | undefined;\r\n @optionalVector3Property(\"origin\") declare target: SpotLightData3D[\"target\"];\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"spot\", this, SPOT_KEYS);\r\n }\r\n}\r\n\r\n// ─── area ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface AreaLight3DProps extends Node3DProps, Partial<ParamsOf<AreaLightData3D>> { }\r\n\r\nconst AREA_KEYS = [\"color\", \"intensity\", \"width\", \"height\"] as const;\r\n\r\n/** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */\r\nexport class AreaLight3D<P extends AreaLight3DProps = AreaLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare width: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"area\", this, AREA_KEYS);\r\n }\r\n}\r\n\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"mesh3d.js","sourceRoot":"","sources":["../../../src/nodes/three/mesh3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport { colorProperty } from \"@/attributes/properties/typed\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport { Graphics3D, resolveMaterialShorthand3D, type MaterialShorthand3D } from \"@/render3d/graphics3d\";\nimport { lerpFill3D, type Fill3D } from \"@/render3d/fill3d\";\nimport type { Geometry3D } from \"@/render3d/geometry\";\nimport type { Material3D, Shading3D } from \"@/render3d/material\";\nimport type { Texture3D } from \"@/render3d/texture\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\nimport type { Blend3D, Faces3D } from \"@/render3d/transform\";\nimport { Node3D, type Node3DProps } from \"./node3d\";\n\n/**\n * The material shorthand, as node props.\n *\n * Exactly the keys {@link MaterialShorthand3D} promotes onto the `Graphics3D`\n * sugar methods, so `<Box3D fill=\"red\" roughness={0.3} />` and\n * `g3.box({ fill: \"red\", roughness: 0.3 })` describe the same mesh — and each is\n * a real prop here, so any of them can be tweened.\n *\n * Ten props, where there were twenty-four. What went is everything that was a\n * renderer knob rather than a design decision — `depthWrite`, `depthTest`,\n * `alphaTest`, `toneMapped`, `polygonOffset`, `dithering` — which now live only\n * on a `Mat.*` descriptor passed through {@link material}; plus `transparent`,\n * which is derived; plus five texture slots, which are fills.\n */\nexport interface Material3DProps {\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\n material: Material3D | readonly Material3D[] | undefined;\n /** What the surface is made of — the same value a 2D `fill` takes. */\n fill: Fill3D;\n opacity: number;\n roughness: number;\n metalness: number;\n emission: Color | undefined;\n emissionStrength: number;\n normalMap: Texture3D | undefined;\n roughnessMap: Texture3D | undefined;\n metalnessMap: Texture3D | undefined;\n aoMap: Texture3D | undefined;\n alphaMap: Texture3D | undefined;\n envMapIntensity: number;\n wireframe: boolean;\n /** Facet or smooth shading. Default `\"smooth\"`. */\n shading: Shading3D;\n /** Which faces to rasterize. Default `\"front\"`. */\n faces: Faces3D;\n vertexColors: boolean;\n blend: Blend3D;\n /** Shade with an unlit `basic` material instead of `standard`. */\n unlit: boolean;\n}\n\nexport interface Mesh3DProps extends Node3DProps, Partial<Material3DProps> {\n /** The geometry to draw. Set directly, or by a geometry subclass's props. */\n geometry: Geometry3D;\n}\n\n/** The shorthand keys, in the order they are copied onto a built descriptor. */\nconst MATERIAL_PROP_KEYS = [\n \"opacity\", \"roughness\", \"metalness\",\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\n] as const;\n\n/**\n * A drawable 3D object — geometry plus a material.\n *\n * The 3D counterpart of {@link ShapeNode}: it owns the material vocabulary, and\n * the geometry sugar nodes ({@link Box3D}, {@link Sphere3D}, …) subclass it to\n * supply a geometry from their own props.\n *\n * <Mesh3D geometry={Geo.torusKnot({ radius: 1.2 })} fill=\"tomato\" roughness={0.2} />\n * <Box3D fill={[\"#1a1a2e\", Fills.linearGradient([\"#e0533d\", \"#8b5cf6\"])]} />\n *\n * Every material key is a prop, so `mesh().to({ data: { roughness: 1, fill: \"cyan\" }, duration: 1 })`\n * animates in place — three writes the values onto the live material rather than\n * recompiling. Geometry *parameters* are the exception: three geometries are\n * immutable, so tweening a `radius` reallocates the mesh every frame. Tween\n * `scale` (or `scaleX`/`scaleY`/`scaleZ`) instead.\n */\nexport class Mesh3D<P extends Mesh3DProps = Mesh3DProps> extends Node3D<P> {\n @property({ default: undefined }) declare geometry: Geometry3D;\n @property({ default: undefined }) declare material: Material3D | readonly Material3D[] | undefined;\n\n @property({ default: \"white\", tween: lerpFill3D }) declare fill: Fill3D;\n @property({ default: undefined }) declare opacity: number | undefined;\n @property({ default: undefined }) declare roughness: number | undefined;\n @property({ default: undefined }) declare metalness: number | undefined;\n @colorProperty({ default: undefined }) declare emission: Color | undefined;\n @property({ default: undefined }) declare emissionStrength: number | undefined;\n @property({ default: undefined }) declare normalMap: Texture3D | undefined;\n @property({ default: undefined }) declare roughnessMap: Texture3D | undefined;\n @property({ default: undefined }) declare metalnessMap: Texture3D | undefined;\n @property({ default: undefined }) declare aoMap: Texture3D | undefined;\n @property({ default: undefined }) declare alphaMap: Texture3D | undefined;\n @property({ default: undefined }) declare envMapIntensity: number | undefined;\n @property({ default: undefined }) declare wireframe: boolean | undefined;\n @property({ default: undefined }) declare shading: Shading3D | undefined;\n @property({ default: undefined }) declare faces: Faces3D | undefined;\n @property({ default: undefined }) declare vertexColors: boolean | undefined;\n @property({ default: undefined }) declare blend: Blend3D | undefined;\n @property({ default: false }) declare unlit: boolean;\n\n /**\n * The geometry this node draws.\n *\n * Overridden by each sugar subclass to build one from its own props; the base\n * returns the `geometry` prop, so `<Mesh3D geometry={Geo.lathe(...)} />` works\n * for anything the sugar doesn't cover.\n */\n protected buildGeometry(): Geometry3D | undefined {\n return this.geometry;\n }\n\n /**\n * The material shorthand, gathered off the props that were actually set.\n *\n * `undefined` defaults are deliberate: an omitted key must stay absent from\n * the descriptor so `Graphics3D` picks the renderer's own default, rather than\n * being pinned to a value this node invented.\n */\n protected materialShorthand(): MaterialShorthand3D {\n const out: Record<string, unknown> = {};\n const material = this.material;\n if (material !== undefined) out.material = material;\n if (this.fill !== undefined) out.fill = this.fill;\n for (const key of MATERIAL_PROP_KEYS) {\n const value = (this as unknown as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n if (this.unlit) out.unlit = true;\n return out as MaterialShorthand3D;\n }\n\n /**\n * What this node draws this frame.\n *\n * The single seam both the real render and the asset-declaration pass go\n * through — the same discipline as `Rect.shapeGraphics()` — so the textures\n * that get loaded can never drift from the ones that get drawn.\n */\n protected buildGraphics3D(): Graphics3D {\n const g3 = new Graphics3D();\n const geometry = this.buildGeometry();\n if (geometry) g3.mesh(geometry, resolveMaterialShorthand3D(this.materialShorthand()));\n return g3;\n }\n\n protected override renderSelf(ctx: RenderContext3D): void {\n ctx.draw(this.buildGraphics3D());\n }\n}\n\n"]}
1
+ {"version":3,"file":"mesh3d.js","sourceRoot":"","sources":["../../../src/nodes/three/mesh3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { colorProperty } from \"@/attributes/properties/typed\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport { Graphics3D, resolveMaterialShorthand3D, type MaterialShorthand3D } from \"@/render3d/graphics3d\";\r\nimport { lerpFill3D, type Fill3D } from \"@/render3d/fill3d\";\r\nimport type { Geometry3D } from \"@/render3d/geometry\";\r\nimport type { Material3D, Shading3D } from \"@/render3d/material\";\r\nimport type { Texture3D } from \"@/render3d/texture\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\nimport type { Blend3D, Faces3D } from \"@/render3d/transform\";\r\nimport { Node3D, type Node3DProps } from \"./node3d\";\r\n\r\n/**\r\n * The material shorthand, as node props.\r\n *\r\n * Exactly the keys {@link MaterialShorthand3D} promotes onto the `Graphics3D`\r\n * sugar methods, so `<Box3D fill=\"red\" roughness={0.3} />` and\r\n * `g3.box({ fill: \"red\", roughness: 0.3 })` describe the same mesh — and each is\r\n * a real prop here, so any of them can be tweened.\r\n *\r\n * Ten props, where there were twenty-four. What went is everything that was a\r\n * renderer knob rather than a design decision — `depthWrite`, `depthTest`,\r\n * `alphaTest`, `toneMapped`, `polygonOffset`, `dithering` — which now live only\r\n * on a `Mat.*` descriptor passed through {@link material}; plus `transparent`,\r\n * which is derived; plus five texture slots, which are fills.\r\n */\r\nexport interface Material3DProps {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material: Material3D | readonly Material3D[] | undefined;\r\n /** What the surface is made of — the same value a 2D `fill` takes. */\r\n fill: Fill3D;\r\n opacity: number;\r\n roughness: number;\r\n metalness: number;\r\n emission: Color | undefined;\r\n emissionStrength: number;\r\n normalMap: Texture3D | undefined;\r\n roughnessMap: Texture3D | undefined;\r\n metalnessMap: Texture3D | undefined;\r\n aoMap: Texture3D | undefined;\r\n alphaMap: Texture3D | undefined;\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\nexport interface Mesh3DProps extends Node3DProps, Partial<Material3DProps> {\r\n /** The geometry to draw. Set directly, or by a geometry subclass's props. */\r\n geometry: Geometry3D;\r\n}\r\n\r\n/** The shorthand keys, in the order they are copied onto a built descriptor. */\r\nconst MATERIAL_PROP_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/**\r\n * A drawable 3D object — geometry plus a material.\r\n *\r\n * The 3D counterpart of {@link ShapeNode}: it owns the material vocabulary, and\r\n * the geometry sugar nodes ({@link Box3D}, {@link Sphere3D}, …) subclass it to\r\n * supply a geometry from their own props.\r\n *\r\n * <Mesh3D geometry={Geo.torusKnot({ radius: 1.2 })} fill=\"tomato\" roughness={0.2} />\r\n * <Box3D fill={[\"#1a1a2e\", Fills.linearGradient([\"#e0533d\", \"#8b5cf6\"])]} />\r\n *\r\n * Every material key is a prop, so `mesh().to({ data: { roughness: 1, fill: \"cyan\" }, duration: 1 })`\r\n * animates in place — three writes the values onto the live material rather than\r\n * recompiling. Geometry *parameters* are the exception: three geometries are\r\n * immutable, so tweening a `radius` reallocates the mesh every frame. Tween\r\n * `scale` (or `scaleX`/`scaleY`/`scaleZ`) instead.\r\n */\r\nexport class Mesh3D<P extends Mesh3DProps = Mesh3DProps> extends Node3D<P> {\r\n @property({ default: undefined }) declare geometry: Geometry3D;\r\n @property({ default: undefined }) declare material: Material3D | readonly Material3D[] | undefined;\r\n\r\n @property({ default: \"white\", tween: lerpFill3D }) declare fill: Fill3D;\r\n @property({ default: undefined }) declare opacity: number | undefined;\r\n @property({ default: undefined }) declare roughness: number | undefined;\r\n @property({ default: undefined }) declare metalness: number | undefined;\r\n @colorProperty({ default: undefined }) declare emission: Color | undefined;\r\n @property({ default: undefined }) declare emissionStrength: number | undefined;\r\n @property({ default: undefined }) declare normalMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare roughnessMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare metalnessMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare aoMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare alphaMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare envMapIntensity: number | undefined;\r\n @property({ default: undefined }) declare wireframe: boolean | undefined;\r\n @property({ default: undefined }) declare shading: Shading3D | undefined;\r\n @property({ default: undefined }) declare faces: Faces3D | undefined;\r\n @property({ default: undefined }) declare vertexColors: boolean | undefined;\r\n @property({ default: undefined }) declare blend: Blend3D | undefined;\r\n @property({ default: false }) declare unlit: boolean;\r\n\r\n /**\r\n * The geometry this node draws.\r\n *\r\n * Overridden by each sugar subclass to build one from its own props; the base\r\n * returns the `geometry` prop, so `<Mesh3D geometry={Geo.lathe(...)} />` works\r\n * for anything the sugar doesn't cover.\r\n */\r\n protected buildGeometry(): Geometry3D | undefined {\r\n return this.geometry;\r\n }\r\n\r\n /**\r\n * The material shorthand, gathered off the props that were actually set.\r\n *\r\n * `undefined` defaults are deliberate: an omitted key must stay absent from\r\n * the descriptor so `Graphics3D` picks the renderer's own default, rather than\r\n * being pinned to a value this node invented.\r\n */\r\n protected materialShorthand(): MaterialShorthand3D {\r\n const out: Record<string, unknown> = {};\r\n const material = this.material;\r\n if (material !== undefined) out.material = material;\r\n if (this.fill !== undefined) out.fill = this.fill;\r\n for (const key of MATERIAL_PROP_KEYS) {\r\n const value = (this as unknown as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n if (this.unlit) out.unlit = true;\r\n return out as MaterialShorthand3D;\r\n }\r\n\r\n /**\r\n * What this node draws this frame.\r\n *\r\n * The single seam both the real render and the asset-declaration pass go\r\n * through — the same discipline as `Rect.shapeGraphics()` — so the textures\r\n * that get loaded can never drift from the ones that get drawn.\r\n */\r\n protected buildGraphics3D(): Graphics3D {\r\n const g3 = new Graphics3D();\r\n const geometry = this.buildGeometry();\r\n if (geometry) g3.mesh(geometry, resolveMaterialShorthand3D(this.materialShorthand()));\r\n return g3;\r\n }\r\n\r\n protected override renderSelf(ctx: RenderContext3D): void {\r\n ctx.draw(this.buildGraphics3D());\r\n }\r\n}\r\n\r\n"]}
@@ -3,6 +3,7 @@ import type { RenderContext3D } from "../../render3d/render-context3d.js";
3
3
  import type { AssetScope } from "../../assets/scope.js";
4
4
  import type { Shadow3D, Transform3D } from "../../render3d/transform.js";
5
5
  import { Node, type NodeConfig, type NodeDimension, type NodeProps } from "../../nodes/node/node.js";
6
+ import type { Command, CommandArgs } from "../../tween/command.js";
6
7
  import type { EasingFunction } from "../../tween/ease/type.js";
7
8
  import type { TweenStepper } from "../../tween/stepper.js";
8
9
  export interface Node3DProps extends NodeProps {
@@ -48,6 +49,22 @@ export interface Node3DProps extends NodeProps {
48
49
  /** Draw-order override, for tuning transparent sorting. */
49
50
  renderOrder: number;
50
51
  }
52
+ /**
53
+ * A 3D parent's own coordinates for where its children sit: the units of a
54
+ * graph, say. Position only, as a `ChildPlane` is in 2D: a child keeps its
55
+ * size, turn and scale. Answered by the parent ({@link Node3D._spaceOf}, or
56
+ * `Canvas3D._spaceOf` for a child of the viewport itself).
57
+ */
58
+ export interface ChildSpace3D {
59
+ /** A child's `x`/`y`/`z` as a point in the parent's local space. */
60
+ toLocal(x: number, y: number, z: number): Vector3;
61
+ }
62
+ /**
63
+ * The coordinates `node`'s parent places it by, or `null` when they are the
64
+ * parent's local space. The parent may be a 3D node or the viewport holding it.
65
+ */
66
+ /** @internal */
67
+ export declare function parentSpaceOf(node: Node3D): ChildSpace3D | null;
51
68
  /**
52
69
  * A thing in 3D space — the root of the 3D scene graph.
53
70
  *
@@ -109,6 +126,31 @@ export declare class Node3D<P extends Node3DProps = Node3DProps> extends Node<P>
109
126
  shadow: Shadow3D;
110
127
  renderOrder: number;
111
128
  constructor(props?: NodeConfig<any, P>);
129
+ /** Animate the position, whichever axes are given; the rest stay where they are. */
130
+ moveTo(args: CommandArgs<{
131
+ x?: number;
132
+ y?: number;
133
+ z?: number;
134
+ }> & {
135
+ duration: number;
136
+ }): Command<P>;
137
+ /** Animate the Euler rotation, in degrees, whichever axes are given. */
138
+ rotateTo(args: CommandArgs<{
139
+ rotationX?: number;
140
+ rotationY?: number;
141
+ rotationZ?: number;
142
+ }> & {
143
+ duration: number;
144
+ }): Command<P>;
145
+ /** Animate the scale: `scale` on every axis, and any axis given beside it on that one. */
146
+ scaleTo(args: CommandArgs<{
147
+ scale?: number;
148
+ scaleX?: number;
149
+ scaleY?: number;
150
+ scaleZ?: number;
151
+ }> & {
152
+ duration: number;
153
+ }): Command<P>;
112
154
  /** This node's position, composed from the axis props. */
113
155
  get position(): Vector3;
114
156
  set position(value: Vector3Input);
@@ -147,6 +189,12 @@ export declare class Node3D<P extends Node3DProps = Node3DProps> extends Node<P>
147
189
  * make `rotation` silently do nothing.
148
190
  */
149
191
  protected transform3D(): Transform3D;
192
+ /**
193
+ * The coordinates `child`'s `x`/`y`/`z` are in, or `null` (the default) when
194
+ * they are this node's local space. A `null` child is one not here yet.
195
+ */
196
+ /** @internal */
197
+ _spaceOf(_child: Node3D | null): ChildSpace3D | null;
150
198
  /**
151
199
  * The transform that goes on this node's *group* — the scope its children
152
200
  * nest inside. Defaults to this node's own placement, which is right for
@@ -1 +1 @@
1
- {"version":3,"file":"node3d.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"node3d.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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"}
@@ -5,11 +5,21 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
5
5
  return c > 3 && r && Object.defineProperty(target, key, r), r;
6
6
  };
7
7
  import { property } from "../../attributes/properties/decorator.js";
8
- import { quaternionProperty } from "../../attributes/properties/typed.js";
8
+ import { optionalVector3Property, quaternionProperty } from "../../attributes/properties/typed.js";
9
9
  import { resolveVector3, } from "../../render3d/vector3.js";
10
10
  import { Scene3D } from "../../render3d/scene3d.js";
11
11
  import { declare3DResources } from "../../render3d/tracking.js";
12
12
  import { Node } from "../../nodes/node/node.js";
13
+ import { command } from "../../tween/command-decorator.js";
14
+ /**
15
+ * The coordinates `node`'s parent places it by, or `null` when they are the
16
+ * parent's local space. The parent may be a 3D node or the viewport holding it.
17
+ */
18
+ /** @internal */
19
+ export function parentSpaceOf(node) {
20
+ const parent = node.parent;
21
+ return typeof parent?._spaceOf === "function" ? parent._spaceOf(node) : null;
22
+ }
13
23
  /** The three axis props each vector prop distributes into, in order. */
14
24
  const VECTOR_SUGAR = {
15
25
  position: ["x", "y", "z"],
@@ -68,6 +78,18 @@ export class Node3D extends Node {
68
78
  this.initProps(distributeVectors(props));
69
79
  this.adoptChildrenProp(props);
70
80
  }
81
+ /** Animate the position, whichever axes are given; the rest stay where they are. */
82
+ moveTo(args) {
83
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
84
+ }
85
+ /** Animate the Euler rotation, in degrees, whichever axes are given. */
86
+ rotateTo(args) {
87
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
88
+ }
89
+ /** Animate the scale: `scale` on every axis, and any axis given beside it on that one. */
90
+ scaleTo(args) {
91
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
92
+ }
71
93
  /** This node's position, composed from the axis props. */
72
94
  get position() {
73
95
  return { x: this.x, y: this.y, z: this.z };
@@ -122,8 +144,9 @@ export class Node3D extends Node {
122
144
  transform3D() {
123
145
  const quaternion = this.quaternion;
124
146
  const identityQuaternion = quaternion.x === 0 && quaternion.y === 0 && quaternion.z === 0 && quaternion.w === 1;
147
+ const space = parentSpaceOf(this);
125
148
  return {
126
- position: this.position,
149
+ position: space ? space.toLocal(this.x, this.y, this.z) : this.position,
127
150
  rotation: this.rotation,
128
151
  quaternion: identityQuaternion ? undefined : quaternion,
129
152
  scale: this.scale,
@@ -133,6 +156,14 @@ export class Node3D extends Node {
133
156
  renderOrder: this.renderOrder,
134
157
  };
135
158
  }
159
+ /**
160
+ * The coordinates `child`'s `x`/`y`/`z` are in, or `null` (the default) when
161
+ * they are this node's local space. A `null` child is one not here yet.
162
+ */
163
+ /** @internal */
164
+ _spaceOf(_child) {
165
+ return null;
166
+ }
136
167
  /**
137
168
  * The transform that goes on this node's *group* — the scope its children
138
169
  * nest inside. Defaults to this node's own placement, which is right for
@@ -225,7 +256,7 @@ __decorate([
225
256
  property({ default: 1 })
226
257
  ], Node3D.prototype, "scaleZ", void 0);
227
258
  __decorate([
228
- property({ default: undefined })
259
+ optionalVector3Property("snap")
229
260
  ], Node3D.prototype, "lookAt", void 0);
230
261
  __decorate([
231
262
  property({ default: true })
@@ -236,6 +267,17 @@ __decorate([
236
267
  __decorate([
237
268
  property({ default: 0 })
238
269
  ], Node3D.prototype, "renderOrder", void 0);
270
+ __decorate([
271
+ command({ args: ["x", "y", "z"] })
272
+ ], Node3D.prototype, "moveTo", null);
273
+ __decorate([
274
+ command({ args: ["rotationX", "rotationY", "rotationZ"] })
275
+ ], Node3D.prototype, "rotateTo", null);
276
+ __decorate([
277
+ command({
278
+ args: [{ key: "scale", kind: "number", min: 0, step: 0.05, unit: "×" }, "scaleX", "scaleY", "scaleZ"],
279
+ })
280
+ ], Node3D.prototype, "scaleTo", null);
239
281
  /**
240
282
  * Expand `position`/`rotation`/`scale` in a prop bag into their axis props.
241
283
  *
@@ -281,6 +323,14 @@ function distributeVectors(props) {
281
323
  }
282
324
  return out ?? props;
283
325
  }
326
+ /** `data` without the keys left unstated, so a tween never aims an axis at `undefined`. */
327
+ function stated(data) {
328
+ const out = {};
329
+ for (const key in data)
330
+ if (data[key] !== undefined)
331
+ out[key] = data[key];
332
+ return out;
333
+ }
284
334
  function componentOf(vector, index) {
285
335
  return index === 0 ? vector.x : index === 1 ? vector.y : vector.z;
286
336
  }