@motionscript/core 0.1.0-alpha.3 → 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 (746) hide show
  1. package/CHANGELOG.md +220 -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 +79 -4
  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 +17 -2
  43. package/dist/attributes/audio/request.d.ts.map +1 -1
  44. package/dist/attributes/audio/request.js.map +1 -1
  45. package/dist/attributes/audio/schedule.d.ts +4 -2
  46. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  47. package/dist/attributes/audio/schedule.js +15 -8
  48. package/dist/attributes/audio/schedule.js.map +1 -1
  49. package/dist/attributes/audio/sound.d.ts +4 -2
  50. package/dist/attributes/audio/sound.d.ts.map +1 -1
  51. package/dist/attributes/audio/sound.js +8 -4
  52. package/dist/attributes/audio/sound.js.map +1 -1
  53. package/dist/attributes/index.js.map +1 -1
  54. package/dist/attributes/layout/alignment.js +1 -1
  55. package/dist/attributes/layout/alignment.js.map +1 -1
  56. package/dist/attributes/layout/index.js.map +1 -1
  57. package/dist/attributes/layout/insets.js.map +1 -1
  58. package/dist/attributes/layout/matrix2d.js.map +1 -1
  59. package/dist/attributes/layout/size.js.map +1 -1
  60. package/dist/attributes/layout/transform3d.js.map +1 -1
  61. package/dist/attributes/layout/vector2.js.map +1 -1
  62. package/dist/attributes/layout/world-transform.js.map +1 -1
  63. package/dist/attributes/mask/boolean.js.map +1 -1
  64. package/dist/attributes/mask/mask.js.map +1 -1
  65. package/dist/attributes/properties/decorator.d.ts +3 -1
  66. package/dist/attributes/properties/decorator.d.ts.map +1 -1
  67. package/dist/attributes/properties/decorator.js.map +1 -1
  68. package/dist/attributes/properties/inputs.js.map +1 -1
  69. package/dist/attributes/properties/typed.d.ts +9 -2
  70. package/dist/attributes/properties/typed.d.ts.map +1 -1
  71. package/dist/attributes/properties/typed.js +15 -1
  72. package/dist/attributes/properties/typed.js.map +1 -1
  73. package/dist/attributes/render3d/orbit.d.ts +8 -8
  74. package/dist/attributes/render3d/orbit.js +7 -7
  75. package/dist/attributes/render3d/orbit.js.map +1 -1
  76. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  77. package/dist/attributes/shape/corners/corner-style.js.map +1 -1
  78. package/dist/attributes/shape/corners/corners.js.map +1 -1
  79. package/dist/attributes/shape/corners/index.js.map +1 -1
  80. package/dist/attributes/shape/effects/backdrop.d.ts +4 -4
  81. package/dist/attributes/shape/effects/backdrop.d.ts.map +1 -1
  82. package/dist/attributes/shape/effects/backdrop.js.map +1 -1
  83. package/dist/attributes/shape/effects/chain.d.ts +28 -120
  84. package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
  85. package/dist/attributes/shape/effects/chain.js +16 -88
  86. package/dist/attributes/shape/effects/chain.js.map +1 -1
  87. package/dist/attributes/shape/effects/effect-data.js.map +1 -1
  88. package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
  89. package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
  90. package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
  91. package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
  92. package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
  93. package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
  94. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
  95. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +2 -2
  96. package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
  97. package/dist/attributes/shape/effects/implementations/curves.d.ts +1 -1
  98. package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
  99. package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
  100. package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
  101. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  102. package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
  103. package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
  104. package/dist/attributes/shape/effects/implementations/glass.d.ts +15 -24
  105. package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
  106. package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
  107. package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
  108. package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
  109. package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
  110. package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
  111. package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
  112. package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
  113. package/dist/attributes/shape/effects/implementations/lut.d.ts +1 -1
  114. package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
  115. package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
  116. package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
  117. package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
  118. package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
  119. package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
  120. package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
  121. package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
  122. package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
  123. package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
  124. package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
  125. package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
  126. package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
  127. package/dist/attributes/shape/effects/implementations/shader.js +15 -8
  128. package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
  129. package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
  130. package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
  131. package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
  132. package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
  133. package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
  134. package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
  135. package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
  136. package/dist/attributes/shape/effects/index.d.ts +2 -6
  137. package/dist/attributes/shape/effects/index.d.ts.map +1 -1
  138. package/dist/attributes/shape/effects/index.js.map +1 -1
  139. package/dist/attributes/shape/effects/registry.d.ts +23 -6
  140. package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
  141. package/dist/attributes/shape/effects/registry.js +44 -10
  142. package/dist/attributes/shape/effects/registry.js.map +1 -1
  143. package/dist/attributes/shape/effects/union.d.ts +2 -6
  144. package/dist/attributes/shape/effects/union.d.ts.map +1 -1
  145. package/dist/attributes/shape/effects/union.js.map +1 -1
  146. package/dist/attributes/shape/fill/blend.js.map +1 -1
  147. package/dist/attributes/shape/fill/chain.js.map +1 -1
  148. package/dist/attributes/shape/fill/coerce.js.map +1 -1
  149. package/dist/attributes/shape/fill/color/constants.js.map +1 -1
  150. package/dist/attributes/shape/fill/color/parser.d.ts.map +1 -1
  151. package/dist/attributes/shape/fill/color/parser.js +81 -44
  152. package/dist/attributes/shape/fill/color/parser.js.map +1 -1
  153. package/dist/attributes/shape/fill/gradient-stops.d.ts +16 -0
  154. package/dist/attributes/shape/fill/gradient-stops.d.ts.map +1 -0
  155. package/dist/attributes/shape/fill/gradient-stops.js +65 -0
  156. package/dist/attributes/shape/fill/gradient-stops.js.map +1 -0
  157. package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
  158. package/dist/attributes/shape/fill/implementations/color.js.map +1 -1
  159. package/dist/attributes/shape/fill/implementations/conic-gradient.d.ts.map +1 -1
  160. package/dist/attributes/shape/fill/implementations/conic-gradient.js +2 -5
  161. package/dist/attributes/shape/fill/implementations/conic-gradient.js.map +1 -1
  162. package/dist/attributes/shape/fill/implementations/dot-grid.js.map +1 -1
  163. package/dist/attributes/shape/fill/implementations/fractal-noise.d.ts.map +1 -1
  164. package/dist/attributes/shape/fill/implementations/fractal-noise.js +2 -10
  165. package/dist/attributes/shape/fill/implementations/fractal-noise.js.map +1 -1
  166. package/dist/attributes/shape/fill/implementations/grid.js.map +1 -1
  167. package/dist/attributes/shape/fill/implementations/image.d.ts.map +1 -1
  168. package/dist/attributes/shape/fill/implementations/image.js +5 -4
  169. package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
  170. package/dist/attributes/shape/fill/implementations/linear-gradient.d.ts.map +1 -1
  171. package/dist/attributes/shape/fill/implementations/linear-gradient.js +2 -6
  172. package/dist/attributes/shape/fill/implementations/linear-gradient.js.map +1 -1
  173. package/dist/attributes/shape/fill/implementations/noise.js.map +1 -1
  174. package/dist/attributes/shape/fill/implementations/radial-gradient.d.ts.map +1 -1
  175. package/dist/attributes/shape/fill/implementations/radial-gradient.js +2 -5
  176. package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
  177. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  178. package/dist/attributes/shape/fill/implementations/stripe.js.map +1 -1
  179. package/dist/attributes/shape/fill/implementations/video.js +1 -1
  180. package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
  181. package/dist/attributes/shape/fill/index.js.map +1 -1
  182. package/dist/attributes/shape/fill/lerp.js.map +1 -1
  183. package/dist/attributes/shape/fill/media-preset.js.map +1 -1
  184. package/dist/attributes/shape/fill/registry.js.map +1 -1
  185. package/dist/attributes/shape/fill/union.js.map +1 -1
  186. package/dist/attributes/shape/filters/chain.d.ts +4 -10
  187. package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
  188. package/dist/attributes/shape/filters/chain.js +1 -13
  189. package/dist/attributes/shape/filters/chain.js.map +1 -1
  190. package/dist/attributes/shape/filters/implementations/alpha.js.map +1 -1
  191. package/dist/attributes/shape/filters/implementations/blur.js.map +1 -1
  192. package/dist/attributes/shape/filters/implementations/color-adjustment.js.map +1 -1
  193. package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
  194. package/dist/attributes/shape/filters/implementations/curves.js.map +1 -1
  195. package/dist/attributes/shape/filters/implementations/echo.js.map +1 -1
  196. package/dist/attributes/shape/filters/implementations/exposure.js.map +1 -1
  197. package/dist/attributes/shape/filters/implementations/grayscale.js.map +1 -1
  198. package/dist/attributes/shape/filters/implementations/posterize-time.js.map +1 -1
  199. package/dist/attributes/shape/filters/index.d.ts +1 -1
  200. package/dist/attributes/shape/filters/index.js.map +1 -1
  201. package/dist/attributes/shape/filters/registry.d.ts +2 -2
  202. package/dist/attributes/shape/filters/registry.js +3 -3
  203. package/dist/attributes/shape/filters/registry.js.map +1 -1
  204. package/dist/attributes/shape/filters/union.d.ts +6 -7
  205. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  206. package/dist/attributes/shape/filters/union.js.map +1 -1
  207. package/dist/attributes/shape/path/anchors.d.ts.map +1 -1
  208. package/dist/attributes/shape/path/anchors.js +12 -5
  209. package/dist/attributes/shape/path/anchors.js.map +1 -1
  210. package/dist/attributes/shape/path/bezier.js.map +1 -1
  211. package/dist/attributes/shape/path/index.js.map +1 -1
  212. package/dist/attributes/shape/path/measure.js.map +1 -1
  213. package/dist/attributes/shape/path/morph.d.ts.map +1 -1
  214. package/dist/attributes/shape/path/morph.js +16 -4
  215. package/dist/attributes/shape/path/morph.js.map +1 -1
  216. package/dist/attributes/shape/path/ops.js.map +1 -1
  217. package/dist/attributes/shape/path/types.js.map +1 -1
  218. package/dist/attributes/shape/path/walk.js.map +1 -1
  219. package/dist/attributes/shape/shaders/index.js.map +1 -1
  220. package/dist/attributes/shape/shaders/pack.js.map +1 -1
  221. package/dist/attributes/shape/shaders/resolve.js.map +1 -1
  222. package/dist/attributes/shape/shadow/index.js.map +1 -1
  223. package/dist/attributes/shape/shadow/shadow.js.map +1 -1
  224. package/dist/attributes/shape/stroke/index.d.ts +2 -2
  225. package/dist/attributes/shape/stroke/index.d.ts.map +1 -1
  226. package/dist/attributes/shape/stroke/index.js +1 -1
  227. package/dist/attributes/shape/stroke/index.js.map +1 -1
  228. package/dist/attributes/shape/stroke/stroke.d.ts +27 -6
  229. package/dist/attributes/shape/stroke/stroke.d.ts.map +1 -1
  230. package/dist/attributes/shape/stroke/stroke.js +22 -2
  231. package/dist/attributes/shape/stroke/stroke.js.map +1 -1
  232. package/dist/attributes/shared/operators.js.map +1 -1
  233. package/dist/attributes/text/index.js.map +1 -1
  234. package/dist/attributes/text/ops.d.ts +6 -0
  235. package/dist/attributes/text/ops.d.ts.map +1 -1
  236. package/dist/attributes/text/ops.js +1 -0
  237. package/dist/attributes/text/ops.js.map +1 -1
  238. package/dist/attributes/text/types.js.map +1 -1
  239. package/dist/browser/chunks/chunk-FUZVFT3W.js +18 -0
  240. package/dist/browser/chunks/chunk-FUZVFT3W.js.map +7 -0
  241. package/dist/browser/chunks/chunk-QG6C23IJ.js +3 -0
  242. package/dist/browser/chunks/chunk-QG6C23IJ.js.map +7 -0
  243. package/dist/browser/chunks/chunk-SFNJRPBV.js +2 -0
  244. package/dist/browser/chunks/chunk-SFNJRPBV.js.map +7 -0
  245. package/dist/browser/component.js +1 -1
  246. package/dist/browser/component.js.map +1 -1
  247. package/dist/browser/index.js +1 -1
  248. package/dist/browser/index.js.map +4 -4
  249. package/dist/browser/jsx-jsx-dev-runtime.js +1 -1
  250. package/dist/browser/jsx-jsx-runtime.js +1 -1
  251. package/dist/browser/manifest.json +3 -2
  252. package/dist/browser/sdk.js +1 -1
  253. package/dist/component.js.map +1 -1
  254. package/dist/document/audio.d.ts +1 -1
  255. package/dist/document/audio.js +4 -4
  256. package/dist/document/audio.js.map +1 -1
  257. package/dist/document/builtins.d.ts.map +1 -1
  258. package/dist/document/builtins.js +8 -14
  259. package/dist/document/builtins.js.map +1 -1
  260. package/dist/document/command-traits.d.ts +1 -1
  261. package/dist/document/command-traits.js +13 -1
  262. package/dist/document/command-traits.js.map +1 -1
  263. package/dist/document/deny-globals.js.map +1 -1
  264. package/dist/document/diff.js.map +1 -1
  265. package/dist/document/doc-index.d.ts +2 -2
  266. package/dist/document/doc-index.d.ts.map +1 -1
  267. package/dist/document/doc-index.js.map +1 -1
  268. package/dist/document/expression/compile.d.ts.map +1 -1
  269. package/dist/document/expression/compile.js +8 -5
  270. package/dist/document/expression/compile.js.map +1 -1
  271. package/dist/document/expression/index.js.map +1 -1
  272. package/dist/document/expression/ops.js +1 -1
  273. package/dist/document/expression/ops.js.map +1 -1
  274. package/dist/document/expression/parse.d.ts.map +1 -1
  275. package/dist/document/expression/parse.js +15 -6
  276. package/dist/document/expression/parse.js.map +1 -1
  277. package/dist/document/expression/refs.d.ts +1 -1
  278. package/dist/document/expression/refs.js +1 -1
  279. package/dist/document/expression/refs.js.map +1 -1
  280. package/dist/document/expression/types.js.map +1 -1
  281. package/dist/document/expression/walk.d.ts.map +1 -1
  282. package/dist/document/expression/walk.js +2 -1
  283. package/dist/document/expression/walk.js.map +1 -1
  284. package/dist/document/index.d.ts +2 -0
  285. package/dist/document/index.d.ts.map +1 -1
  286. package/dist/document/index.js +2 -0
  287. package/dist/document/index.js.map +1 -1
  288. package/dist/document/node-decorator.js.map +1 -1
  289. package/dist/document/node-descriptor.d.ts +19 -0
  290. package/dist/document/node-descriptor.d.ts.map +1 -1
  291. package/dist/document/node-descriptor.js.map +1 -1
  292. package/dist/document/placement.d.ts +70 -0
  293. package/dist/document/placement.d.ts.map +1 -0
  294. package/dist/document/placement.js +83 -0
  295. package/dist/document/placement.js.map +1 -0
  296. package/dist/document/project.d.ts +2 -2
  297. package/dist/document/project.d.ts.map +1 -1
  298. package/dist/document/project.js.map +1 -1
  299. package/dist/document/registry.d.ts +17 -0
  300. package/dist/document/registry.d.ts.map +1 -1
  301. package/dist/document/registry.js +29 -2
  302. package/dist/document/registry.js.map +1 -1
  303. package/dist/document/timeline-patch.js.map +1 -1
  304. package/dist/document/timeline.d.ts +73 -18
  305. package/dist/document/timeline.d.ts.map +1 -1
  306. package/dist/document/timeline.js +192 -40
  307. package/dist/document/timeline.js.map +1 -1
  308. package/dist/document/types.d.ts +12 -12
  309. package/dist/document/types.d.ts.map +1 -1
  310. package/dist/document/types.js +2 -2
  311. package/dist/document/types.js.map +1 -1
  312. package/dist/document/validate.d.ts +2 -2
  313. package/dist/document/validate.d.ts.map +1 -1
  314. package/dist/document/validate.js +37 -31
  315. package/dist/document/validate.js.map +1 -1
  316. package/dist/document/withdraw.d.ts +28 -0
  317. package/dist/document/withdraw.d.ts.map +1 -0
  318. package/dist/document/withdraw.js +61 -0
  319. package/dist/document/withdraw.js.map +1 -0
  320. package/dist/index.d.ts +1 -0
  321. package/dist/index.d.ts.map +1 -1
  322. package/dist/index.js +1 -0
  323. package/dist/index.js.map +1 -1
  324. package/dist/jsx/jsx-dev-runtime.js.map +1 -1
  325. package/dist/jsx/jsx-runtime.d.ts +9 -1
  326. package/dist/jsx/jsx-runtime.d.ts.map +1 -1
  327. package/dist/jsx/jsx-runtime.js +13 -3
  328. package/dist/jsx/jsx-runtime.js.map +1 -1
  329. package/dist/layout/bounds.d.ts +0 -1
  330. package/dist/layout/bounds.d.ts.map +1 -1
  331. package/dist/layout/bounds.js.map +1 -1
  332. package/dist/layout/constraints.js.map +1 -1
  333. package/dist/layout/flex.d.ts +4 -2
  334. package/dist/layout/flex.d.ts.map +1 -1
  335. package/dist/layout/flex.js +27 -11
  336. package/dist/layout/flex.js.map +1 -1
  337. package/dist/layout/freeform.js.map +1 -1
  338. package/dist/layout/grid.js.map +1 -1
  339. package/dist/layout/index.js.map +1 -1
  340. package/dist/layout/item.js.map +1 -1
  341. package/dist/layout/ops.d.ts +6 -0
  342. package/dist/layout/ops.d.ts.map +1 -1
  343. package/dist/layout/ops.js +6 -0
  344. package/dist/layout/ops.js.map +1 -1
  345. package/dist/layout/types.js.map +1 -1
  346. package/dist/nodes/2d/node-lifecycle.js.map +1 -1
  347. package/dist/nodes/2d/node-motion.js.map +1 -1
  348. package/dist/nodes/2d/node-render.d.ts +3 -3
  349. package/dist/nodes/2d/node-render.d.ts.map +1 -1
  350. package/dist/nodes/2d/node-render.js.map +1 -1
  351. package/dist/nodes/2d/node-transform.js.map +1 -1
  352. package/dist/nodes/2d/node2d.d.ts +115 -3
  353. package/dist/nodes/2d/node2d.d.ts.map +1 -1
  354. package/dist/nodes/2d/node2d.js +180 -28
  355. package/dist/nodes/2d/node2d.js.map +1 -1
  356. package/dist/nodes/2d/paint-node.d.ts +27 -0
  357. package/dist/nodes/2d/paint-node.d.ts.map +1 -1
  358. package/dist/nodes/2d/paint-node.js +42 -0
  359. package/dist/nodes/2d/paint-node.js.map +1 -1
  360. package/dist/nodes/audio/audio-bus.js.map +1 -1
  361. package/dist/nodes/audio/index.js.map +1 -1
  362. package/dist/nodes/audio/node-audio.js.map +1 -1
  363. package/dist/nodes/audio/sound-node.d.ts +2 -2
  364. package/dist/nodes/audio/sound-node.d.ts.map +1 -1
  365. package/dist/nodes/audio/sound-node.js +1 -1
  366. package/dist/nodes/audio/sound-node.js.map +1 -1
  367. package/dist/nodes/geometry/bounds-shape-node.d.ts +4 -4
  368. package/dist/nodes/geometry/bounds-shape-node.js +2 -2
  369. package/dist/nodes/geometry/bounds-shape-node.js.map +1 -1
  370. package/dist/nodes/geometry/box-path-node.d.ts +3 -3
  371. package/dist/nodes/geometry/box-path-node.js +2 -2
  372. package/dist/nodes/geometry/box-path-node.js.map +1 -1
  373. package/dist/nodes/geometry/ellipse-node.js.map +1 -1
  374. package/dist/nodes/geometry/group-bounds.d.ts +2 -2
  375. package/dist/nodes/geometry/group-bounds.d.ts.map +1 -1
  376. package/dist/nodes/geometry/group-bounds.js +1 -2
  377. package/dist/nodes/geometry/group-bounds.js.map +1 -1
  378. package/dist/nodes/geometry/path-node.d.ts.map +1 -1
  379. package/dist/nodes/geometry/path-node.js +6 -0
  380. package/dist/nodes/geometry/path-node.js.map +1 -1
  381. package/dist/nodes/geometry/polygon-node.js.map +1 -1
  382. package/dist/nodes/geometry/polygram-node.js.map +1 -1
  383. package/dist/nodes/geometry/rect-node.js.map +1 -1
  384. package/dist/nodes/geometry/shape-node.js.map +1 -1
  385. package/dist/nodes/geometry/shape-outline.d.ts +2 -2
  386. package/dist/nodes/geometry/shape-outline.d.ts.map +1 -1
  387. package/dist/nodes/geometry/shape-outline.js +2 -13
  388. package/dist/nodes/geometry/shape-outline.js.map +1 -1
  389. package/dist/nodes/index.d.ts +3 -8
  390. package/dist/nodes/index.d.ts.map +1 -1
  391. package/dist/nodes/index.js +3 -8
  392. package/dist/nodes/index.js.map +1 -1
  393. package/dist/nodes/layout/camera-node.d.ts +9 -0
  394. package/dist/nodes/layout/camera-node.d.ts.map +1 -1
  395. package/dist/nodes/layout/camera-node.js +38 -3
  396. package/dist/nodes/layout/camera-node.js.map +1 -1
  397. package/dist/nodes/layout/orbit-camera-node.d.ts +1 -1
  398. package/dist/nodes/layout/orbit-camera-node.js +1 -1
  399. package/dist/nodes/layout/orbit-camera-node.js.map +1 -1
  400. package/dist/nodes/layout/rotated-box.js.map +1 -1
  401. package/dist/nodes/media/video-node.d.ts.map +1 -1
  402. package/dist/nodes/media/video-node.js +2 -0
  403. package/dist/nodes/media/video-node.js.map +1 -1
  404. package/dist/nodes/node/declare-paints.js.map +1 -1
  405. package/dist/nodes/node/node-editor-state.js.map +1 -1
  406. package/dist/nodes/node/node-reactive.js.map +1 -1
  407. package/dist/nodes/node/node-time.d.ts +3 -3
  408. package/dist/nodes/node/node-time.d.ts.map +1 -1
  409. package/dist/nodes/node/node-time.js +1 -1
  410. package/dist/nodes/node/node-time.js.map +1 -1
  411. package/dist/nodes/node/node-walk.js.map +1 -1
  412. package/dist/nodes/node/node.d.ts +5 -3
  413. package/dist/nodes/node/node.d.ts.map +1 -1
  414. package/dist/nodes/node/node.js +44 -19
  415. package/dist/nodes/node/node.js.map +1 -1
  416. package/dist/nodes/node/text-defaults.d.ts +10 -12
  417. package/dist/nodes/node/text-defaults.d.ts.map +1 -1
  418. package/dist/nodes/node/text-defaults.js +10 -12
  419. package/dist/nodes/node/text-defaults.js.map +1 -1
  420. package/dist/nodes/{scene → root}/canvas2d-node.d.ts +2 -2
  421. package/dist/nodes/root/canvas2d-node.d.ts.map +1 -0
  422. package/dist/nodes/{scene → root}/canvas2d-node.js +2 -2
  423. package/dist/nodes/root/canvas2d-node.js.map +1 -0
  424. package/dist/nodes/root/provider-node.d.ts.map +1 -0
  425. package/dist/nodes/root/provider-node.js.map +1 -0
  426. package/dist/nodes/root/theme-provider-node.d.ts.map +1 -0
  427. package/dist/nodes/root/theme-provider-node.js.map +1 -0
  428. package/dist/nodes/text/default-text-style-node.d.ts +5 -2
  429. package/dist/nodes/text/default-text-style-node.d.ts.map +1 -1
  430. package/dist/nodes/text/default-text-style-node.js +10 -4
  431. package/dist/nodes/text/default-text-style-node.js.map +1 -1
  432. package/dist/nodes/text/number-format.d.ts +1 -1
  433. package/dist/nodes/text/number-format.js +1 -1
  434. package/dist/nodes/text/number-format.js.map +1 -1
  435. package/dist/nodes/text/number-node.js.map +1 -1
  436. package/dist/nodes/text/number-pattern.js.map +1 -1
  437. package/dist/nodes/text/richtext-node.js +1 -1
  438. package/dist/nodes/text/richtext-node.js.map +1 -1
  439. package/dist/nodes/text/text-base.d.ts.map +1 -1
  440. package/dist/nodes/text/text-base.js +1 -1
  441. package/dist/nodes/text/text-base.js.map +1 -1
  442. package/dist/nodes/text/text-node.js.map +1 -1
  443. package/dist/nodes/text/text-selection.js.map +1 -1
  444. package/dist/nodes/three/camera-nodes.d.ts +21 -3
  445. package/dist/nodes/three/camera-nodes.d.ts.map +1 -1
  446. package/dist/nodes/three/camera-nodes.js +42 -1
  447. package/dist/nodes/three/camera-nodes.js.map +1 -1
  448. package/dist/nodes/three/canvas3d-node.d.ts +29 -6
  449. package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
  450. package/dist/nodes/three/canvas3d-node.js +44 -2
  451. package/dist/nodes/three/canvas3d-node.js.map +1 -1
  452. package/dist/nodes/three/drawable-nodes.d.ts +25 -11
  453. package/dist/nodes/three/drawable-nodes.d.ts.map +1 -1
  454. package/dist/nodes/three/drawable-nodes.js +43 -13
  455. package/dist/nodes/three/drawable-nodes.js.map +1 -1
  456. package/dist/nodes/three/environment-nodes.d.ts +9 -3
  457. package/dist/nodes/three/environment-nodes.d.ts.map +1 -1
  458. package/dist/nodes/three/environment-nodes.js.map +1 -1
  459. package/dist/nodes/three/geometry-nodes.d.ts +2 -2
  460. package/dist/nodes/three/geometry-nodes.js +2 -2
  461. package/dist/nodes/three/geometry-nodes.js.map +1 -1
  462. package/dist/nodes/three/grid-geometry3d.js.map +1 -1
  463. package/dist/nodes/three/group3d.js.map +1 -1
  464. package/dist/nodes/three/light-nodes.d.ts.map +1 -1
  465. package/dist/nodes/three/light-nodes.js +3 -3
  466. package/dist/nodes/three/light-nodes.js.map +1 -1
  467. package/dist/nodes/three/mesh3d.js.map +1 -1
  468. package/dist/nodes/three/node3d.d.ts +48 -0
  469. package/dist/nodes/three/node3d.d.ts.map +1 -1
  470. package/dist/nodes/three/node3d.js +53 -3
  471. package/dist/nodes/three/node3d.js.map +1 -1
  472. package/dist/platform/audio-sink.d.ts +2 -2
  473. package/dist/platform/audio-sink.d.ts.map +1 -1
  474. package/dist/platform/audio-sink.js.map +1 -1
  475. package/dist/platform/exporter.d.ts +13 -8
  476. package/dist/platform/exporter.d.ts.map +1 -1
  477. package/dist/platform/exporter.js.map +1 -1
  478. package/dist/platform/index.d.ts +1 -1
  479. package/dist/platform/index.d.ts.map +1 -1
  480. package/dist/platform/index.js.map +1 -1
  481. package/dist/platform/stepped-clock.js.map +1 -1
  482. package/dist/platform/storage-adapter.d.ts +12 -6
  483. package/dist/platform/storage-adapter.d.ts.map +1 -1
  484. package/dist/platform/storage-adapter.js +4 -0
  485. package/dist/platform/storage-adapter.js.map +1 -1
  486. package/dist/platform/ticker.d.ts +6 -0
  487. package/dist/platform/ticker.d.ts.map +1 -1
  488. package/dist/platform/ticker.js +6 -0
  489. package/dist/platform/ticker.js.map +1 -1
  490. package/dist/project/config.js.map +1 -1
  491. package/dist/project/index.js.map +1 -1
  492. package/dist/project/tree.d.ts +3 -3
  493. package/dist/project/tree.d.ts.map +1 -1
  494. package/dist/project/tree.js.map +1 -1
  495. package/dist/props/host.js.map +1 -1
  496. package/dist/props/index.js.map +1 -1
  497. package/dist/props/observer.js.map +1 -1
  498. package/dist/props/slot.js.map +1 -1
  499. package/dist/renamed-scene-names.d.ts +17 -0
  500. package/dist/renamed-scene-names.d.ts.map +1 -0
  501. package/dist/renamed-scene-names.js +9 -0
  502. package/dist/renamed-scene-names.js.map +1 -0
  503. package/dist/render/canvas-render-context2d.d.ts +2 -2
  504. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  505. package/dist/render/canvas-render-context2d.js.map +1 -1
  506. package/dist/render/clip-contains.js.map +1 -1
  507. package/dist/render/clip.js.map +1 -1
  508. package/dist/render/descriptors/ellipse.js.map +1 -1
  509. package/dist/render/descriptors/latex.js.map +1 -1
  510. package/dist/render/descriptors/line.js.map +1 -1
  511. package/dist/render/descriptors/path-builder.js.map +1 -1
  512. package/dist/render/descriptors/path.js.map +1 -1
  513. package/dist/render/descriptors/polygon.js.map +1 -1
  514. package/dist/render/descriptors/polygram.js.map +1 -1
  515. package/dist/render/descriptors/rect.js.map +1 -1
  516. package/dist/render/descriptors/richtext.js.map +1 -1
  517. package/dist/render/descriptors/shape.d.ts +12 -0
  518. package/dist/render/descriptors/shape.d.ts.map +1 -1
  519. package/dist/render/descriptors/shape.js.map +1 -1
  520. package/dist/render/descriptors/text.d.ts +2 -2
  521. package/dist/render/descriptors/text.js +2 -2
  522. package/dist/render/descriptors/text.js.map +1 -1
  523. package/dist/render/descriptors/transform.d.ts +2 -2
  524. package/dist/render/descriptors/transform.d.ts.map +1 -1
  525. package/dist/render/descriptors/transform.js.map +1 -1
  526. package/dist/render/graphics2d.d.ts +3 -3
  527. package/dist/render/graphics2d.d.ts.map +1 -1
  528. package/dist/render/graphics2d.js +1 -1
  529. package/dist/render/graphics2d.js.map +1 -1
  530. package/dist/render/index.js.map +1 -1
  531. package/dist/render/measure-context.js.map +1 -1
  532. package/dist/render/null-render-context.js.map +1 -1
  533. package/dist/render/render-context2d.d.ts +2 -2
  534. package/dist/render/render-context2d.d.ts.map +1 -1
  535. package/dist/render/render-context2d.js.map +1 -1
  536. package/dist/render/surface.js.map +1 -1
  537. package/dist/render/text-defaults.js.map +1 -1
  538. package/dist/render/text-layout.js.map +1 -1
  539. package/dist/render3d/bounds3d.d.ts.map +1 -1
  540. package/dist/render3d/bounds3d.js +4 -2
  541. package/dist/render3d/bounds3d.js.map +1 -1
  542. package/dist/render3d/builders.js.map +1 -1
  543. package/dist/render3d/camera.d.ts +6 -0
  544. package/dist/render3d/camera.d.ts.map +1 -1
  545. package/dist/render3d/camera.js +5 -3
  546. package/dist/render3d/camera.js.map +1 -1
  547. package/dist/render3d/fill3d.d.ts +2 -9
  548. package/dist/render3d/fill3d.d.ts.map +1 -1
  549. package/dist/render3d/fill3d.js +2 -13
  550. package/dist/render3d/fill3d.js.map +1 -1
  551. package/dist/render3d/geometry.d.ts +8 -1
  552. package/dist/render3d/geometry.d.ts.map +1 -1
  553. package/dist/render3d/geometry.js.map +1 -1
  554. package/dist/render3d/graphics3d.d.ts +8 -4
  555. package/dist/render3d/graphics3d.d.ts.map +1 -1
  556. package/dist/render3d/graphics3d.js +18 -10
  557. package/dist/render3d/graphics3d.js.map +1 -1
  558. package/dist/render3d/index.d.ts +1 -1
  559. package/dist/render3d/index.js +1 -1
  560. package/dist/render3d/index.js.map +1 -1
  561. package/dist/render3d/inert.d.ts +14 -0
  562. package/dist/render3d/inert.d.ts.map +1 -0
  563. package/dist/render3d/inert.js +62 -0
  564. package/dist/render3d/inert.js.map +1 -0
  565. package/dist/render3d/light.js.map +1 -1
  566. package/dist/render3d/material.d.ts +10 -5
  567. package/dist/render3d/material.d.ts.map +1 -1
  568. package/dist/render3d/material.js.map +1 -1
  569. package/dist/render3d/matrix4.js.map +1 -1
  570. package/dist/render3d/render-context3d.js.map +1 -1
  571. package/dist/render3d/resources.js.map +1 -1
  572. package/dist/render3d/rounded-box.js.map +1 -1
  573. package/dist/render3d/scene-settings.d.ts +23 -4
  574. package/dist/render3d/scene-settings.d.ts.map +1 -1
  575. package/dist/render3d/scene-settings.js.map +1 -1
  576. package/dist/render3d/scene3d.d.ts +11 -0
  577. package/dist/render3d/scene3d.d.ts.map +1 -1
  578. package/dist/render3d/scene3d.js +39 -6
  579. package/dist/render3d/scene3d.js.map +1 -1
  580. package/dist/render3d/segments.js.map +1 -1
  581. package/dist/render3d/texture.d.ts +9 -0
  582. package/dist/render3d/texture.d.ts.map +1 -1
  583. package/dist/render3d/texture.js +13 -0
  584. package/dist/render3d/texture.js.map +1 -1
  585. package/dist/render3d/tracking.js.map +1 -1
  586. package/dist/render3d/transform.d.ts +1 -1
  587. package/dist/render3d/transform.js.map +1 -1
  588. package/dist/render3d/vector3.d.ts +18 -1
  589. package/dist/render3d/vector3.d.ts.map +1 -1
  590. package/dist/render3d/vector3.js +27 -0
  591. package/dist/render3d/vector3.js.map +1 -1
  592. package/dist/render3d/walk.d.ts +1 -1
  593. package/dist/render3d/walk.d.ts.map +1 -1
  594. package/dist/render3d/walk.js +5 -1
  595. package/dist/render3d/walk.js.map +1 -1
  596. package/dist/runtime/asset-refine.js.map +1 -1
  597. package/dist/runtime/asset-timeline.js.map +1 -1
  598. package/dist/runtime/asset-update.js.map +1 -1
  599. package/dist/runtime/audio-index.js.map +1 -1
  600. package/dist/runtime/builtin-context.js.map +1 -1
  601. package/dist/runtime/clip-instance.d.ts +5 -3
  602. package/dist/runtime/clip-instance.d.ts.map +1 -1
  603. package/dist/runtime/clip-instance.js +10 -6
  604. package/dist/runtime/clip-instance.js.map +1 -1
  605. package/dist/runtime/clip-store.d.ts +9 -0
  606. package/dist/runtime/clip-store.d.ts.map +1 -1
  607. package/dist/runtime/clip-store.js +19 -0
  608. package/dist/runtime/clip-store.js.map +1 -1
  609. package/dist/runtime/engine.d.ts +5 -0
  610. package/dist/runtime/engine.d.ts.map +1 -1
  611. package/dist/runtime/engine.js +2 -0
  612. package/dist/runtime/engine.js.map +1 -1
  613. package/dist/runtime/frame-time.d.ts +31 -0
  614. package/dist/runtime/frame-time.d.ts.map +1 -0
  615. package/dist/runtime/frame-time.js +29 -0
  616. package/dist/runtime/frame-time.js.map +1 -0
  617. package/dist/runtime/index.d.ts +1 -0
  618. package/dist/runtime/index.d.ts.map +1 -1
  619. package/dist/runtime/index.js +1 -0
  620. package/dist/runtime/index.js.map +1 -1
  621. package/dist/runtime/node-picking.d.ts +44 -3
  622. package/dist/runtime/node-picking.d.ts.map +1 -1
  623. package/dist/runtime/node-picking.js +118 -3
  624. package/dist/runtime/node-picking.js.map +1 -1
  625. package/dist/runtime/node-picking3d.d.ts +2 -1
  626. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  627. package/dist/runtime/node-picking3d.js +5 -2
  628. package/dist/runtime/node-picking3d.js.map +1 -1
  629. package/dist/runtime/placement.d.ts.map +1 -1
  630. package/dist/runtime/placement.js +4 -5
  631. package/dist/runtime/placement.js.map +1 -1
  632. package/dist/runtime/playback-controller.d.ts +31 -2
  633. package/dist/runtime/playback-controller.d.ts.map +1 -1
  634. package/dist/runtime/playback-controller.js +63 -6
  635. package/dist/runtime/playback-controller.js.map +1 -1
  636. package/dist/runtime/playback.js.map +1 -1
  637. package/dist/runtime/precompisition.js.map +1 -1
  638. package/dist/runtime/project-assets.js.map +1 -1
  639. package/dist/runtime/session.d.ts +9 -7
  640. package/dist/runtime/session.d.ts.map +1 -1
  641. package/dist/runtime/session.js +12 -4
  642. package/dist/runtime/session.js.map +1 -1
  643. package/dist/runtime/settle.js.map +1 -1
  644. package/dist/runtime/state-evaluator.d.ts +1 -1
  645. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  646. package/dist/runtime/state-evaluator.js +4 -3
  647. package/dist/runtime/state-evaluator.js.map +1 -1
  648. package/dist/runtime/text-geometry.js.map +1 -1
  649. package/dist/sdk/index.d.ts +19 -15
  650. package/dist/sdk/index.d.ts.map +1 -1
  651. package/dist/sdk/index.js +11 -6
  652. package/dist/sdk/index.js.map +1 -1
  653. package/dist/tween/command-decorator.d.ts +2 -0
  654. package/dist/tween/command-decorator.d.ts.map +1 -1
  655. package/dist/tween/command-decorator.js.map +1 -1
  656. package/dist/tween/command.js.map +1 -1
  657. package/dist/tween/ease/constants.d.ts.map +1 -1
  658. package/dist/tween/ease/constants.js +8 -5
  659. package/dist/tween/ease/constants.js.map +1 -1
  660. package/dist/tween/ease/curve.d.ts.map +1 -1
  661. package/dist/tween/ease/curve.js +4 -3
  662. package/dist/tween/ease/curve.js.map +1 -1
  663. package/dist/tween/ease/describe.d.ts +15 -0
  664. package/dist/tween/ease/describe.d.ts.map +1 -0
  665. package/dist/tween/ease/describe.js +37 -0
  666. package/dist/tween/ease/describe.js.map +1 -0
  667. package/dist/tween/ease/type.js.map +1 -1
  668. package/dist/tween/index.js.map +1 -1
  669. package/dist/tween/inert.js.map +1 -1
  670. package/dist/tween/lerp.js.map +1 -1
  671. package/dist/tween/loop.js.map +1 -1
  672. package/dist/tween/prepare.d.ts +3 -3
  673. package/dist/tween/prepare.js +3 -3
  674. package/dist/tween/prepare.js.map +1 -1
  675. package/dist/tween/seekable.d.ts +1 -1
  676. package/dist/tween/seekable.js.map +1 -1
  677. package/dist/tween/stepper.js.map +1 -1
  678. package/dist/tween/to-command.js.map +1 -1
  679. package/dist/util/clamp.js.map +1 -1
  680. package/dist/util/context.js.map +1 -1
  681. package/dist/util/csv.js.map +1 -1
  682. package/dist/util/generateList.js.map +1 -1
  683. package/dist/util/index.js.map +1 -1
  684. package/dist/util/metrics.d.ts +1 -1
  685. package/dist/util/metrics.js +1 -1
  686. package/dist/util/metrics.js.map +1 -1
  687. package/dist/util/random.js.map +1 -1
  688. package/dist/util/reference.js.map +1 -1
  689. package/dist/util/scheduler.js.map +1 -1
  690. package/package.json +2 -1
  691. package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
  692. package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
  693. package/dist/attributes/shape/effects/implementations/displace.js +0 -30
  694. package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
  695. package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
  696. package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
  697. package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
  698. package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
  699. package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
  700. package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
  701. package/dist/attributes/shape/effects/implementations/texture.js +0 -25
  702. package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
  703. package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
  704. package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
  705. package/dist/attributes/shape/effects/implementations/trails.js +0 -22
  706. package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
  707. package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
  708. package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
  709. package/dist/browser/chunks/chunk-KJXGRHOL.js +0 -3
  710. package/dist/browser/chunks/chunk-KJXGRHOL.js.map +0 -7
  711. package/dist/browser/chunks/chunk-TGDX2SS2.js +0 -18
  712. package/dist/browser/chunks/chunk-TGDX2SS2.js.map +0 -7
  713. package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
  714. package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
  715. package/dist/nodes/geometry/dot-grid-node.js +0 -142
  716. package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
  717. package/dist/nodes/geometry/grid-lines.d.ts +0 -101
  718. package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
  719. package/dist/nodes/geometry/grid-lines.js +0 -128
  720. package/dist/nodes/geometry/grid-lines.js.map +0 -1
  721. package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
  722. package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
  723. package/dist/nodes/geometry/grid-pattern-node.js +0 -172
  724. package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
  725. package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
  726. package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
  727. package/dist/nodes/geometry/line-grid-node.js +0 -127
  728. package/dist/nodes/geometry/line-grid-node.js.map +0 -1
  729. package/dist/nodes/geometry/line-node.d.ts +0 -58
  730. package/dist/nodes/geometry/line-node.d.ts.map +0 -1
  731. package/dist/nodes/geometry/line-node.js +0 -123
  732. package/dist/nodes/geometry/line-node.js.map +0 -1
  733. package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
  734. package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
  735. package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
  736. package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
  737. package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
  738. package/dist/nodes/scene/canvas2d-node.js.map +0 -1
  739. package/dist/nodes/scene/provider-node.d.ts.map +0 -1
  740. package/dist/nodes/scene/provider-node.js.map +0 -1
  741. package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
  742. package/dist/nodes/scene/theme-provider-node.js.map +0 -1
  743. /package/dist/nodes/{scene → root}/provider-node.d.ts +0 -0
  744. /package/dist/nodes/{scene → root}/provider-node.js +0 -0
  745. /package/dist/nodes/{scene → root}/theme-provider-node.d.ts +0 -0
  746. /package/dist/nodes/{scene → root}/theme-provider-node.js +0 -0
@@ -2,10 +2,11 @@ import { RenderContext2D } from "../../render/render-context2d.js";
2
2
  import { Scene3D } from "../../render3d/scene3d.js";
3
3
  import { type PostEffect3D, type Shadows3D, type ToneMapping3D } from "../../render3d/scene-settings.js";
4
4
  import type { Color } from "../../attributes/shape/fill/color/parser.js";
5
+ import type { Command, CommandArgs } from "../../tween/command.js";
5
6
  import type { AssetScope } from "../../assets/scope.js";
6
7
  import { Rect, RectProps } from "../geometry/rect-node.js";
7
8
  import { Node, NodeConfig } from "../../nodes/node/node.js";
8
- import { Node3D } from "./node3d.js";
9
+ import { Node3D, type ChildSpace3D } from "./node3d.js";
9
10
  export interface Canvas3DProps extends RectProps {
10
11
  /**
11
12
  * Ceiling on the 3D buffer's device-pixel ratio. Default 2.
@@ -35,6 +36,10 @@ export interface Canvas3DProps extends RectProps {
35
36
  * blur and the rest of the 2D `effects` chain already run over the composited
36
37
  * result. What is here is what genuinely needs the depth buffer, object ids,
37
38
  * or HDR radiance before tone mapping.
39
+ *
40
+ * **Inert today**: the chain is recorded on the scene and no pass is applied,
41
+ * so a viewport with `post` renders exactly like one without (the first one
42
+ * set warns in development). Use the viewport's 2D `effects` instead.
38
43
  */
39
44
  post: PostEffect3D | readonly PostEffect3D[];
40
45
  /**
@@ -42,8 +47,7 @@ export interface Canvas3DProps extends RectProps {
42
47
  *
43
48
  * A host that renders a **timeline** needs a camera a `to` command can tween
44
49
  * and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes
45
- * the same values the timeline reads. `Graph3D` and `Protein` already carry
46
- * this vocabulary for the same reason. Only read when the scene contains no
50
+ * the same values the timeline reads. Only read when the scene contains no
47
51
  * camera of its own, so a `<Camera3D>` child still wins.
48
52
  */
49
53
  /** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */
@@ -92,7 +96,7 @@ export interface Canvas3DProps extends RectProps {
92
96
  * make that impossible is for there to be nothing to keep in step: see
93
97
  * {@link Canvas3DView.fadeColor}.
94
98
  *
95
- * The same rule motion-script applies to fog with no colour of its own, one
99
+ * The same rule the engine applies to fog with no colour of its own, one
96
100
  * layer down (`Canvas3D.buildScene3D`), and for the same reason.
97
101
  */
98
102
  gridFadeColor: Color;
@@ -162,7 +166,7 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
162
166
  * Each default is applied only when the walk left that slot empty, so a
163
167
  * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the
164
168
  * node's own props rather than being silently overwritten by them — which is
165
- * the behaviour that lets this class stop being special the day the studio
169
+ * the behaviour that lets this class stop being special the day an editor
166
170
  * offers those as node types.
167
171
  */
168
172
  /**
@@ -189,7 +193,7 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
189
193
  * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than
190
194
  * inventing black.
191
195
  *
192
- * Restated here rather than imported because motion-script's own copy (used
196
+ * Restated here rather than imported because the engine's own copy (used
193
197
  * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The
194
198
  * duplication is small and deliberate — the alternative was a second control
195
199
  * the author had to keep in step with the fill, which is exactly what this
@@ -204,6 +208,18 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
204
208
  exposure: number | undefined;
205
209
  post: PostEffect3D | readonly PostEffect3D[] | undefined;
206
210
  constructor(props?: NodeConfig<Canvas3D<P>, P>);
211
+ /**
212
+ * Swing the default camera round the scene and pull it back or in,
213
+ * whichever are given. `zoom` is its distance, as the prop is. A scene with
214
+ * a `Camera3D` of its own is framed by that camera's `orbitTo` instead.
215
+ */
216
+ orbitTo(args: CommandArgs<{
217
+ orbit?: number;
218
+ elevation?: number;
219
+ zoom?: number;
220
+ }> & {
221
+ duration: number;
222
+ }): Command<P>;
207
223
  /**
208
224
  * Accept both dimensions — the only node that does.
209
225
  *
@@ -211,6 +227,13 @@ export declare class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends R
211
227
  * (see {@link Node.acceptsChild}); here it is the entire point.
212
228
  */
213
229
  protected acceptsChild(child: Node): boolean;
230
+ /**
231
+ * The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the
232
+ * default) when they are the scene's own. A viewport that is a graph answers
233
+ * with the graph's units. See {@link ChildSpace3D}.
234
+ */
235
+ /** @internal */
236
+ _spaceOf(_child: Node3D | null): ChildSpace3D | null;
214
237
  /** This node's children that describe the 3D scene. */
215
238
  get children3D(): Node3D[];
216
239
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"canvas3d-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"canvas3d-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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"}
@@ -14,6 +14,7 @@ import { cameraOrbit, lerpColor3D, resolveColor3D } from "../../attributes/rende
14
14
  import { gridGeometry3D } from "./grid-geometry3d.js";
15
15
  import { Fills, resolveChainFill } from "../../attributes/shape/fill/chain.js";
16
16
  import { property } from "../../attributes/properties/decorator.js";
17
+ import { command } from "../../tween/command-decorator.js";
17
18
  import { declare3DResources } from "../../render3d/tracking.js";
18
19
  import { Rect } from "../geometry/rect-node.js";
19
20
  import { Node3D } from "./node3d.js";
@@ -66,7 +67,7 @@ export class Canvas3D extends Rect {
66
67
  * Each default is applied only when the walk left that slot empty, so a
67
68
  * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the
68
69
  * node's own props rather than being silently overwritten by them — which is
69
- * the behaviour that lets this class stop being special the day the studio
70
+ * the behaviour that lets this class stop being special the day an editor
70
71
  * offers those as node types.
71
72
  */
72
73
  /**
@@ -93,7 +94,7 @@ export class Canvas3D extends Rect {
93
94
  * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than
94
95
  * inventing black.
95
96
  *
96
- * Restated here rather than imported because motion-script's own copy (used
97
+ * Restated here rather than imported because the engine's own copy (used
97
98
  * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The
98
99
  * duplication is small and deliberate — the alternative was a second control
99
100
  * the author had to keep in step with the fill, which is exactly what this
@@ -141,6 +142,18 @@ export class Canvas3D extends Rect {
141
142
  constructor(props) {
142
143
  super((props ?? {}));
143
144
  }
145
+ /**
146
+ * Swing the default camera round the scene and pull it back or in,
147
+ * whichever are given. `zoom` is its distance, as the prop is. A scene with
148
+ * a `Camera3D` of its own is framed by that camera's `orbitTo` instead.
149
+ */
150
+ orbitTo(args) {
151
+ const data = {};
152
+ for (const [key, value] of Object.entries(args.data ?? {}))
153
+ if (value !== undefined)
154
+ data[key] = value;
155
+ return this.to({ data: data, duration: args.duration, easing: args.easing });
156
+ }
144
157
  /**
145
158
  * Accept both dimensions — the only node that does.
146
159
  *
@@ -150,6 +163,15 @@ export class Canvas3D extends Rect {
150
163
  acceptsChild(child) {
151
164
  return true;
152
165
  }
166
+ /**
167
+ * The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the
168
+ * default) when they are the scene's own. A viewport that is a graph answers
169
+ * with the graph's units. See {@link ChildSpace3D}.
170
+ */
171
+ /** @internal */
172
+ _spaceOf(_child) {
173
+ return null;
174
+ }
153
175
  /** This node's children that describe the 3D scene. */
154
176
  get children3D() {
155
177
  return this._allChildren.filter((c) => c instanceof Node3D);
@@ -227,6 +249,17 @@ export class Canvas3D extends Rect {
227
249
  },
228
250
  }));
229
251
  }
252
+ // A viewport holding only 2D children (a HUD) has nothing to frame or to
253
+ // light. Without this the default camera and rig made every scene
254
+ // non-empty, so `renderSelf` ran a full 3D pass and created the WebGL
255
+ // context to paint nothing. A subclass overriding `buildScene3D` is
256
+ // exempt: it adds its own content after `super` returns and relies on the
257
+ // rig being there.
258
+ if (this.buildScene3D === Canvas3D.prototype.buildScene3D &&
259
+ scene.isEmpty() &&
260
+ !this._children.some((child) => child instanceof Node3D)) {
261
+ return scene;
262
+ }
230
263
  if (scene.cameraDescriptor() === null) {
231
264
  // Polar placement is the camera's own vocabulary now, so the viewport's
232
265
  // orbit/elevation/zoom pass straight through instead of being converted to
@@ -416,6 +449,15 @@ __decorate([
416
449
  __decorate([
417
450
  property({ default: undefined })
418
451
  ], Canvas3D.prototype, "post", void 0);
452
+ __decorate([
453
+ command({
454
+ args: [
455
+ { key: "orbit", kind: "number", step: 1, unit: "°" },
456
+ { key: "elevation", kind: "number", min: -89, max: 89, step: 1, unit: "°" },
457
+ { key: "zoom", kind: "number", min: 0.01, step: 0.1 },
458
+ ],
459
+ })
460
+ ], Canvas3D.prototype, "orbitTo", null);
419
461
  /**
420
462
  * The colour a fill chain reads as, for anything that has to match it.
421
463
  *
@@ -1 +1 @@
1
- {"version":3,"file":"canvas3d-node.js","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":"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","sourcesContent":["import { RenderContext2D } from \"@/render/render-context2d\";\nimport { Scene3D } from \"@/render3d/scene3d\";\nimport {\n resolveShadows3D,\n type PostEffect3D, type Shadows3D, type ToneMapping3D,\n} from \"@/render3d/scene-settings\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\nimport { warmCanvas3D } from \"@/render3d/resources\";\nimport { forEachTexture3D } from \"@/render3d/walk\";\nimport { isSurfaceTexture3D, resolveSurfaceSource } from \"@/render3d/texture\";\nimport { Graphics3D } from \"@/render3d/graphics3d\";\nimport type { BufferGeometry3D } from \"@/render3d/geometry\";\nimport { cameraOrbit, lerpColor3D, resolveColor3D } from \"@/attributes/render3d/orbit\";\nimport { gridGeometry3D, type Grid3DOptions } from \"./grid-geometry3d\";\nimport { Fills, resolveChainFill } from \"@/attributes/shape/fill/chain\";\nimport { property } from \"@/attributes/properties/decorator\";\nimport { declare3DResources } from \"@/render3d/tracking\";\nimport type { AssetScope } from \"@/assets/scope\";\nimport type { LoaderFn } from \"@/assets/record\";\nimport { Rect, RectProps } from \"../geometry/rect-node\";\nimport { Node, NodeConfig } from \"@/nodes/node/node\";\nimport { Node3D } from \"./node3d\";\n\n// `warmCanvas3D` returns `void` when no backend registered a runtime, so it can't\n// be a loader bare. One function for every declaration keeps the key's loader stable.\nconst loadThreeRuntime: LoaderFn = async () => { await warmCanvas3D(); };\n\nexport interface Canvas3DProps extends RectProps {\n /**\n * Ceiling on the 3D buffer's device-pixel ratio. Default 2.\n *\n * Lower it for an expensive scene: the 3D renders at a smaller buffer and is\n * scaled up on composite, which trades sharpness for fill rate.\n */\n maxPixelRatio: number;\n /** Multisample the 3D pass. Default true. */\n antialias: boolean;\n /**\n * Turn shadow casting on for the scene. A switch, or `{ quality }`.\n *\n * A render setting rather than a scene object, which is why it is a prop here\n * and not a `<Shadows3D>` node: it has no position, and two of them in a tree\n * meant one silently doing nothing.\n */\n shadows: Shadows3D;\n /** How HDR colour is compressed to what the screen can show. Default `\"aces\"`. */\n tone: ToneMapping3D;\n /** Stops of exposure applied before tone mapping. Default 1. */\n exposure: number;\n /**\n * Post-processing inside the 3D composite: `bloom`, `ssao`, `dof`, `outline`.\n *\n * Short by design — a `Canvas3D` is a `Node2D`, so vignette, grain, grading,\n * blur and the rest of the 2D `effects` chain already run over the composited\n * result. What is here is what genuinely needs the depth buffer, object ids,\n * or HDR radiance before tone mapping.\n */\n post: PostEffect3D | readonly PostEffect3D[];\n /**\n * The camera, as three numbers rather than a `<Camera3D>` child.\n *\n * A host that renders a **timeline** needs a camera a `to` command can tween\n * and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes\n * the same values the timeline reads. `Graph3D` and `Protein` already carry\n * this vocabulary for the same reason. Only read when the scene contains no\n * camera of its own, so a `<Camera3D>` child still wins.\n */\n\n /** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */\n orbit: number;\n /** Camera elevation above the ground plane, in **degrees**. */\n elevation: number;\n /** Camera distance from the origin, in scene units. */\n zoom: number;\n /** Vertical field of view, in **degrees**. */\n fov: number;\n /** Strength of the ambient fill. */\n ambientIntensity: number;\n /** Colour of the ambient fill. White leaves the meshes' own colours alone. */\n ambientColor: Color;\n /** Strength of the key light; the rim light is derived from it. */\n keyIntensity: number;\n /** Colour of the key light, and of the rim derived from it. */\n keyColor: Color;\n\n /**\n * Whether the ground plane is drawn. **Off by default** — it is an authoring\n * reference rather than part of the picture; see the property below.\n */\n showGrid: boolean;\n /** Total extent of the grid, in scene units. */\n gridSize: number;\n /** How many cells across it. */\n gridDivisions: number;\n /** Every Nth line is drawn heavier. */\n gridMajorEvery: number;\n gridColor: Color;\n gridMajorColor: Color;\n /** Whether the two coloured axis lines are drawn. Off by default, as above. */\n showAxes: boolean;\n axisXColor: Color;\n axisZColor: Color;\n /** How much of the way to the edge the grid has faded out, in `[0, 1]`. */\n gridFade: number;\n /**\n * What the grid fades into, when the node's own fills do not answer.\n *\n * **Derived, not authored.** The horizon dissolves into the first solid layer\n * of this node's `fill` — the viewport's background — and falls back to this\n * only when the stack has no solid in it to read (an empty stack, or a\n * gradient or image on its own). A grid that faded into a *different* colour\n * than the one behind it would ring the horizon with a halo, and the way to\n * make that impossible is for there to be nothing to keep in step: see\n * {@link Canvas3DView.fadeColor}.\n *\n * The same rule motion-script applies to fog with no colour of its own, one\n * layer down (`Canvas3D.buildScene3D`), and for the same reason.\n */\n gridFadeColor: Color;\n}\n\n/**\n * A 3D viewport in the 2D document — the one node that holds both dimensions.\n *\n * `Canvas3D` is a {@link Rect} that partitions its children by which tree they\n * belong to. `Node3D` children describe a scene: they are walked through a\n * {@link Scene3D} every frame and the result is painted through this rect's own\n * path. `Node2D` children are ordinary children and draw *over* the 3D, which is\n * how a HUD is written.\n *\n * <Canvas3D width=\"fill\" height=\"fill\" cornerRadius={24} fill=\"#0b0d12\" shadows>\n * <Camera3D orbit={-18} elevation={12} distance={13} fov={45} />\n * <AmbientLight3D intensity={0.4} />\n * <DirectionalLight3D intensity={2.4} position={[4, 6, 3]} shadow />\n * <Fog3D near={5} far={30} />\n *\n * <Group3D ref={rig}>\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\n * </Group3D>\n *\n * <Text text=\"FPS 60\" fontSize={32} /> // a 2D HUD, over the 3D\n * </Canvas3D>\n *\n * Being a `Rect` is what makes it lay out in flex/stack groups, take\n * `cornerRadius`/`clip`, be masked, blended and filtered. The 3D is one more\n * fill layer, so the author's own `fill` paints *beneath* it and `stroke` and\n * `overlay` still paint over everything.\n *\n * **That fill is also the background.** There is no `<Background3D>`: three's\n * background pass is unaffected by every light and by fog, the renderer clears\n * transparent, and this node already composites the 3D over its own fill layers —\n * so a solid colour, a gradient, an image or a video behind a 3D scene is the\n * ordinary 2D fill chain, which does strictly more. What genuinely needs the 3D\n * pass is a sky that reprojects as the camera turns, and that is\n * `<Environment3D background>`.\n *\n * The scene is a value, not machinery: the same recorded {@link Scene3D} can be\n * built by hand and used as a fill on any shape, which is how 3D is painted\n * through glyphs or an arbitrary path (`<Text fill={scene} />`).\n */\nexport class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends Rect<P> {\n\n @property({ default: 35 }) declare orbit: number;\n @property({ default: 20 }) declare elevation: number;\n @property({ default: 12 }) declare zoom: number;\n @property({ default: 45 }) declare fov: number;\n\n @property({ default: 0.45 }) declare ambientIntensity: number;\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\n declare ambientColor: Color;\n @property({ default: 2.4 }) declare keyIntensity: number;\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\n declare keyColor: Color;\n\n // Off by default, both of them: the grid and the axes are **reference**, and\n // reference belongs to whoever is authoring rather than to whoever is\n // watching. The studio's 3D view turns them on for the viewport it is a room\n // for and nothing else does — see `BuildSceneOptions.focusCanvas3dId`, and\n // note that the export goes through the same builder with that option unset.\n @property({ default: false }) declare showGrid: boolean;\n @property({ default: 40 }) declare gridSize: number;\n @property({ default: 40 }) declare gridDivisions: number;\n @property({ default: 5 }) declare gridMajorEvery: number;\n @property({ default: \"#26292f\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridColor: Color;\n @property({ default: \"#363a42\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridMajorColor: Color;\n @property({ default: false }) declare showAxes: boolean;\n @property({ default: \"#c8404f\", mapper: resolveColor3D, tween: lerpColor3D })\n declare axisXColor: Color;\n @property({ default: \"#2f6fd0\", mapper: resolveColor3D, tween: lerpColor3D })\n declare axisZColor: Color;\n @property({ default: 0.55 }) declare gridFade: number;\n @property({ default: \"#0b0d12\", mapper: resolveColor3D, tween: lerpColor3D })\n declare gridFadeColor: Color;\n\n\n /**\n * The children's scene, plus whatever it did not already state.\n *\n * Each default is applied only when the walk left that slot empty, so a\n * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the\n * node's own props rather than being silently overwritten by them — which is\n * the behaviour that lets this class stop being special the day the studio\n * offers those as node types.\n */\n /**\n * The grid geometry, rebuilt only when one of its fields moves.\n *\n * A `Scene3D` is recorded from scratch every frame, which is what makes the\n * whole design seekable — but the grid is thousands of floats and depends on\n * nothing that changes between frames. Caching it here is what lets the\n * descriptor claim `staticData`: the renderer compares buffers by identity, so\n * handing it the *same* arrays is the difference between one upload and sixty\n * a second.\n *\n * Keyed by the fields themselves rather than by a dirty flag, so a tween\n * through `gridFade` still rebuilds and nothing has to remember to invalidate.\n */\n private gridCache: { key: string; geometry: BufferGeometry3D } | null = null;\n\n /**\n * The colour a receding grid line ends up at: the background it is drawn on.\n *\n * The first **opaque solid** layer of the fill stack, which is what a\n * background stack is built on — everything above it is a gradient, an image\n * or a video painted over a base colour, and it is that base a surface\n * disappearing into the distance has to match. A stack with no solid in it\n * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than\n * inventing black.\n *\n * Restated here rather than imported because motion-script's own copy (used\n * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The\n * duplication is small and deliberate — the alternative was a second control\n * the author had to keep in step with the fill, which is exactly what this\n * node used to have.\n */\n private fadeColor(): Color {\n const layers = this.fill as unknown;\n if (Array.isArray(layers)) {\n for (const layer of layers) {\n const paint = layer as { type?: string; color?: unknown } | null;\n if (paint?.type !== \"solid\") continue;\n const color = paint.color;\n // A `Color` is a string or a normalized tuple, and the grid takes\n // either — but the tuple's fourth channel is what says whether this\n // layer covers anything, so a transparent \"solid\" is passed over rather\n // than faded into.\n if (typeof color === \"string\") return color;\n if (Array.isArray(color) && (color[3] ?? 1) > 0) return color as Color;\n }\n }\n return this.gridFadeColor;\n }\n\n private gridDescriptor(): BufferGeometry3D {\n const options: Grid3DOptions = {\n size: this.gridSize,\n divisions: Math.max(1, Math.round(this.gridDivisions)),\n majorEvery: Math.max(1, Math.round(this.gridMajorEvery)),\n minorColor: this.gridColor,\n majorColor: this.gridMajorColor,\n axisXColor: this.axisXColor,\n axisZColor: this.axisZColor,\n showAxes: this.showAxes,\n fadeTo: this.fadeColor(),\n fade: this.gridFade,\n };\n\n const key = JSON.stringify(options);\n if (this.gridCache?.key !== key) {\n this.gridCache = { key, geometry: gridGeometry3D(options) };\n }\n return this.gridCache.geometry;\n }\n\n\n\n\n @property({ default: 2 }) declare maxPixelRatio: number;\n @property({ default: true }) declare antialias: boolean;\n @property({ default: false }) declare shadows: Shadows3D;\n @property({ default: undefined }) declare tone: ToneMapping3D | undefined;\n @property({ default: undefined }) declare exposure: number | undefined;\n @property({ default: undefined }) declare post: PostEffect3D | readonly PostEffect3D[] | undefined;\n\n constructor(props?: NodeConfig<Canvas3D<P>, P>) {\n super((props ?? {}) as NodeConfig<any, P>);\n }\n\n /**\n * Accept both dimensions — the only node that does.\n *\n * Everywhere else a mixed tree is a mistake that would silently draw nothing\n * (see {@link Node.acceptsChild}); here it is the entire point.\n */\n protected override acceptsChild(child: Node): boolean {\n return true;\n }\n\n /** This node's children that describe the 3D scene. */\n get children3D(): Node3D[] {\n return this._allChildren.filter((c): c is Node3D => c instanceof Node3D);\n }\n\n /**\n * A 3D viewport has no intrinsic size and shouldn't be sized by its overlay\n * children — hugging a HUD label would collapse the viewport to the size of\n * the text. So it fills unless given an explicit size, whether or not it has\n * children (which is where this diverges from {@link Rect}).\n */\n protected override applyDefaultSize(props?: NodeConfig<any, P>): void {\n if (!props || props.width === undefined) this.applyProp(\"width\", \"fill\");\n if (!props || props.height === undefined) this.applyProp(\"height\", \"fill\");\n }\n\n /**\n * Record this frame's scene by walking the 3D children.\n *\n * The single seam both the real render and the asset-declaration pass go\n * through, so what gets loaded can never drift from what gets drawn. Override\n * it in a subclass for a reusable 3D component that builds its scene some\n * other way.\n *\n * Called inside the synchronous render pass, after the frame's state has been\n * evaluated and layout resolved, so every prop read here samples the\n * *current* frame. That is what makes a 3D scene seekable: frame N is\n * identical whether it was reached by playing forward or by scrubbing\n * backwards, because nothing accumulates.\n */\n protected buildScene3D(): Scene3D {\n const scene = new Scene3D();\n\n // The viewport's own render settings go on first, so a node in the tree\n // can still override one — the same last-writer-wins rule the scene\n // settings have always had, with the viewport as the first writer.\n const shadows = resolveShadows3D(this.shadows);\n if (shadows) scene.shadows(shadows);\n if (this.tone !== undefined || this.exposure !== undefined) {\n scene.tone({ mapping: this.tone, exposure: this.exposure });\n }\n if (this.post !== undefined) scene.post(this.post);\n\n for (const child of this._children) {\n if (child instanceof Node3D) child.render(scene);\n }\n\n // Fog with no colour of its own takes the viewport's. Fog that does not\n // match what is behind it reads as a grey wall rather than as distance,\n // and the two being typed separately is exactly how they drift — which\n // is what the old `<Background3D>` + `<Fog3D>` pair made you do.\n const fog = scene.fogDescriptor();\n if (fog && fog.color === undefined) {\n const base = baseFillColor(this.fill as FillResolved[]);\n if (base !== undefined) scene.fog({ ...fog, color: base });\n }\n\n\n\n // Drawn first, so it sits at the back of the op list — a mesh standing on\n // the ground plane should read as standing *on* it.\n if (this.showGrid) {\n scene.draw(\n new Graphics3D().line({\n geometry: this.gridDescriptor(),\n segments: true,\n material: {\n type: \"lineBasic\",\n // The whole picture is in the vertex colours — the minor lines, the\n // major ones, the two axes and the distance fade at once. See\n // {@link gridGeometry3D} for why that is one op rather than four.\n vertexColors: true,\n // The colours are already exactly what should appear: they were\n // chosen against this background and faded toward it by hand. Tone\n // mapping would re-grade them and pull the fade apart from the fill\n // it is supposed to disappear into.\n toneMapped: false,\n },\n }),\n );\n }\n\n if (scene.cameraDescriptor() === null) {\n // Polar placement is the camera's own vocabulary now, so the viewport's\n // orbit/elevation/zoom pass straight through instead of being converted to\n // a position here; `near`/`far` come from the scene's own bounds.\n // `cameraOrbit` is the quarter turn between the stored zero and the\n // camera's — see it for why that is converted rather than redefined.\n scene.perspective({\n fov: this.fov,\n orbit: cameraOrbit(this.orbit),\n elevation: this.elevation,\n distance: this.zoom,\n });\n }\n\n // A soft ambient fill, a key from the front-right and a weaker rim from\n // behind — enough that a plain untextured box reads as three distinct faces,\n // which is the whole job of a default rig.\n //\n // The rim takes the key's colour as well as a fraction of its strength: it\n // is the key seen from the other side rather than a light of its own, and a\n // rig whose two halves could be tinted apart is two controls rather than\n // one. See the schema's `keyColor`, which says the same from the panel's\n // side.\n if (!scene.ops().some((op) => op.kind === \"light\")) {\n scene\n .light({\n type: \"ambient\",\n intensity: this.ambientIntensity,\n color: this.ambientColor,\n })\n .light(\n {\n type: \"directional\",\n intensity: this.keyIntensity,\n color: this.keyColor,\n },\n { position: [4, 6, 3] },\n )\n .light(\n {\n type: \"directional\",\n intensity: this.keyIntensity * 0.35,\n color: this.keyColor,\n },\n { position: [-5, -2, -4] },\n );\n }\n\n return scene;\n }\n\n /**\n * This frame's scene, for a reader outside the render pass.\n *\n * {@link buildScene3D} is protected because a subclass overrides it, not\n * because the result is private — the asset pass and the render already call\n * it twice a frame. The editor geometry in `runtime/node-picking3d.ts` is the\n * third caller, and it has to go through the *same* seam rather than walking\n * the `Node3D` children itself: a subclass that builds its scene some other\n * way (supplying a default camera and lighting rig, say) would otherwise be\n * picked against a scene nobody renders.\n *\n * Recorded fresh, like the other two, so what it reports is this frame's\n * state rather than a cache a scrub could leave behind.\n */\n /** @internal */\n _scene3D(): Scene3D {\n return this.buildScene3D();\n }\n\n /**\n * The 3D runtime. The scene's resources are its `Node3D` children's to declare;\n * only a subclass building its scene some other way has resources no child states.\n */\n override declareAssets(assets: AssetScope): void {\n super.declareAssets(assets);\n assets.loader(\"three:runtime\", loadThreeRuntime);\n if (this.buildScene3D === Canvas3D.prototype.buildScene3D) return;\n const scene = this.buildScene3D();\n if (!scene.isEmpty()) declare3DResources(scene, assets);\n }\n\n /**\n * Bind every `Node2D` used as a `Tex.surface` source in this scene.\n *\n * A source node is detached — it is a value in a descriptor, not a child — so\n * nothing else would ever hand it an asset catalog, a context map or a clock.\n * This node has all three, and is the only thing that knows the scene, so it\n * adopts them. See {@link Node.attachDetached}.\n */\n private bindSurfaceSources(scene: Scene3D): void {\n forEachTexture3D(scene, (texture) => {\n if (!isSurfaceTexture3D(texture)) return;\n const source = resolveSurfaceSource(texture.source);\n if (source.kind === \"node\") this.attachDetached(source.node);\n });\n }\n\n protected override renderSelf(ctx: RenderContext2D): void {\n const built = this.buildScene3D();\n const scene = built.isEmpty() ? null : built;\n\n if (scene) {\n // Fail loudly at the author's source rather than silently reparenting\n // everything after an unclosed scope.\n scene.assertBalanced();\n this.bindSurfaceSources(scene);\n }\n\n // The author's own fill layers stay first, so a `fill` still paints\n // *beneath* the 3D; the scene goes on top as one more layer.\n const fill = scene\n ? [\n ...resolveChainFill(this.fill),\n ...Fills.canvas3D(scene, {\n maxPixelRatio: this.maxPixelRatio,\n antialias: this.antialias,\n }),\n ]\n : this.fill;\n\n // Stroke is deferred to renderStroke (drawn after children + overlay).\n ctx.draw(this.shapeGraphics().shadow(this.shadow).fill(fill));\n }\n}\n\n/**\n * The colour a fill chain reads as, for anything that has to match it.\n *\n * The first opaque solid layer, which is what a background stack is built on:\n * everything above it is a gradient, an image or a texture painted *over* a base\n * colour, and it is that base a receding surface fades into. Returns `undefined`\n * for a chain with no solid layer at all, which leaves the renderer's own\n * default in place rather than inventing black.\n */\nfunction baseFillColor(fill: FillResolved[] | undefined): Color | undefined {\n if (!fill) return undefined;\n for (const layer of fill) {\n if (layer && (layer as { type?: string }).type === \"solid\") {\n return (layer as unknown as { color: Color }).color;\n }\n }\n return undefined;\n}\n"]}
1
+ {"version":3,"file":"canvas3d-node.js","sourceRoot":"","sources":["../../../src/nodes/three/canvas3d-node.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACH,gBAAgB,GAEnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAAa,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,MAAM,EAAqB,MAAM,UAAU,CAAC;AAErD,kFAAkF;AAClF,sFAAsF;AACtF,MAAM,gBAAgB,GAAa,KAAK,IAAI,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;AAmGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,QAAkD,SAAQ,IAAO;IAoC5E;;;;;;;;OAQG;IACH;;;;;;;;;;;;OAYG;IACK,SAAS,GAAuD,IAAI,CAAC;IAE7E;;;;;;;;;;;;;;;OAeG;IACK,SAAS;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,IAAe,CAAC;QACpC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,KAAkD,CAAC;gBACjE,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO;oBAAE,SAAS;gBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC1B,kEAAkE;gBAClE,oEAAoE;gBACpE,wEAAwE;gBACxE,mBAAmB;gBACnB,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAc,CAAC;YACzE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAEO,cAAc;QACpB,MAAM,OAAO,GAAkB;YAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtD,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxD,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,cAAc;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,QAAQ;SACpB,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;IACjC,CAAC;IAYC,YAAY,KAAkC;QAC1C,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAuB,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IAQH,OAAO,CAAC,IAA+F;QACnG,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAAE,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvG,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAkB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;OAKG;IACgB,YAAY,CAAC,KAAW;QACvC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,gBAAgB;IAChB,QAAQ,CAAC,MAAqB;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,uDAAuD;IACvD,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACgB,gBAAgB,CAAC,KAA0B;QAC1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,YAAY;QAClB,MAAM,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC;QAE5B,wEAAwE;QACxE,oEAAoE;QACpE,mEAAmE;QACnE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,OAAO;YAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,KAAK,YAAY,MAAM;gBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QAED,wEAAwE;QACxE,wEAAwE;QACxE,uEAAuE;QACvE,iEAAiE;QACjE,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAClC,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAsB,CAAC,CAAC;YACxD,IAAI,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAID,0EAA0E;QAC1E,oDAAoD;QACpD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CACR,IAAI,UAAU,EAAE,CAAC,IAAI,CAAC;gBACpB,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE;gBAC/B,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE;oBACR,IAAI,EAAE,WAAW;oBACjB,oEAAoE;oBACpE,8DAA8D;oBAC9D,kEAAkE;oBAClE,YAAY,EAAE,IAAI;oBAClB,gEAAgE;oBAChE,mEAAmE;oBACnE,oEAAoE;oBACpE,oCAAoC;oBACpC,UAAU,EAAE,KAAK;iBAClB;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,kEAAkE;QAClE,sEAAsE;QACtE,oEAAoE;QACpE,0EAA0E;QAC1E,mBAAmB;QACnB,IACE,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,SAAS,CAAC,YAAY;YACrD,KAAK,CAAC,OAAO,EAAE;YACf,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,MAAM,CAAC,EACxD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC;YACtC,wEAAwE;YACxE,2EAA2E;YAC3E,kEAAkE;YAClE,oEAAoE;YACpE,qEAAqE;YACrE,KAAK,CAAC,WAAW,CAAC;gBAChB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAED,wEAAwE;QACxE,6EAA6E;QAC7E,2CAA2C;QAC3C,EAAE;QACF,2EAA2E;QAC3E,4EAA4E;QAC5E,yEAAyE;QACzE,yEAAyE;QACzE,QAAQ;QACR,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;YACnD,KAAK;iBACF,KAAK,CAAC;gBACL,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAI,CAAC,gBAAgB;gBAChC,KAAK,EAAE,IAAI,CAAC,YAAY;aACzB,CAAC;iBACD,KAAK,CACJ;gBACE,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,IAAI,CAAC,YAAY;gBAC5B,KAAK,EAAE,IAAI,CAAC,QAAQ;aACrB,EACD,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CACxB;iBACA,KAAK,CACJ;gBACE,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI;gBACnC,KAAK,EAAE,IAAI,CAAC,QAAQ;aACrB,EACD,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3B,CAAC;QACN,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB;IAChB,QAAQ;QACJ,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACM,aAAa,CAAC,MAAkB;QACrC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,SAAS,CAAC,YAAY;YAAE,OAAO;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;YAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;OAOG;IACK,kBAAkB,CAAC,KAAc;QACrC,gBAAgB,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YAChC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;gBAAE,OAAO;YACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACP,CAAC;IAEkB,UAAU,CAAC,GAAoB;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAE7C,IAAI,KAAK,EAAE,CAAC;YACR,sEAAsE;YACtE,sCAAsC;YACtC,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,IAAI,GAAG,KAAK;YACd,CAAC,CAAC;gBACE,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9B,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;oBACrB,aAAa,EAAE,IAAI,CAAC,aAAa;oBACjC,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC5B,CAAC;aACL;YACD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEhB,uEAAuE;QACvE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;CACJ;AAjYoC;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;uCAAuB;AACd;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;2CAA2B;AAClB;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;sCAAsB;AACb;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;qCAAqB;AAEV;IAApC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;kDAAkC;AAEtD;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;8CACjD;AACQ;IAAnC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;8CAA8B;AAEjD;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;0CACrD;AAMc;IAArC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;0CAA2B;AACrB;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;0CAA0B;AACjB;IAAlC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;+CAA+B;AACvB;IAAjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gDAAgC;AAEjD;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;2CACpD;AAEjB;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;gDAC/C;AACQ;IAArC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;0CAA2B;AAEhD;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;4CACnD;AAElB;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;4CACnD;AACW;IAApC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;0CAA0B;AAE9C;IADP,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;+CAChD;AAqFO;IAAjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;+CAA+B;AACnB;IAApC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;2CAA4B;AAClB;IAArC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;yCAA4B;AACf;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAyC;AAChC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;0CAAsC;AAC7B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;sCAAkE;AAkBnG;IAPC,OAAO,CAAC;QACL,IAAI,EAAE;YACF,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YACpD,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YAC3E,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;SACxD;KACJ,CAAC;uCAKD;AAoPL;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,IAAgC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,KAAK,IAAK,KAA2B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzD,OAAQ,KAAqC,CAAC,KAAK,CAAC;QACxD,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC","sourcesContent":["import { RenderContext2D } from \"@/render/render-context2d\";\r\nimport { Scene3D } from \"@/render3d/scene3d\";\r\nimport {\r\n resolveShadows3D,\r\n type PostEffect3D, type Shadows3D, type ToneMapping3D,\r\n} from \"@/render3d/scene-settings\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\r\nimport { warmCanvas3D } from \"@/render3d/resources\";\r\nimport { forEachTexture3D } from \"@/render3d/walk\";\r\nimport { isSurfaceTexture3D, resolveSurfaceSource } from \"@/render3d/texture\";\r\nimport { Graphics3D } from \"@/render3d/graphics3d\";\r\nimport type { BufferGeometry3D } from \"@/render3d/geometry\";\r\nimport { cameraOrbit, lerpColor3D, resolveColor3D } from \"@/attributes/render3d/orbit\";\r\nimport { gridGeometry3D, type Grid3DOptions } from \"./grid-geometry3d\";\r\nimport { Fills, resolveChainFill } from \"@/attributes/shape/fill/chain\";\r\nimport { property } from \"@/attributes/properties/decorator\";\r\nimport type { Command, CommandArgs } from \"@/tween/command\";\r\nimport { command } from \"@/tween/command-decorator\";\r\nimport { declare3DResources } from \"@/render3d/tracking\";\r\nimport type { AssetScope } from \"@/assets/scope\";\r\nimport type { LoaderFn } from \"@/assets/record\";\r\nimport { Rect, RectProps } from \"../geometry/rect-node\";\r\nimport { Node, NodeConfig } from \"@/nodes/node/node\";\r\nimport { Node3D, type ChildSpace3D } from \"./node3d\";\r\n\r\n// `warmCanvas3D` returns `void` when no backend registered a runtime, so it can't\r\n// be a loader bare. One function for every declaration keeps the key's loader stable.\r\nconst loadThreeRuntime: LoaderFn = async () => { await warmCanvas3D(); };\r\n\r\nexport interface Canvas3DProps extends RectProps {\r\n /**\r\n * Ceiling on the 3D buffer's device-pixel ratio. Default 2.\r\n *\r\n * Lower it for an expensive scene: the 3D renders at a smaller buffer and is\r\n * scaled up on composite, which trades sharpness for fill rate.\r\n */\r\n maxPixelRatio: number;\r\n /** Multisample the 3D pass. Default true. */\r\n antialias: boolean;\r\n /**\r\n * Turn shadow casting on for the scene. A switch, or `{ quality }`.\r\n *\r\n * A render setting rather than a scene object, which is why it is a prop here\r\n * and not a `<Shadows3D>` node: it has no position, and two of them in a tree\r\n * meant one silently doing nothing.\r\n */\r\n shadows: Shadows3D;\r\n /** How HDR colour is compressed to what the screen can show. Default `\"aces\"`. */\r\n tone: ToneMapping3D;\r\n /** Stops of exposure applied before tone mapping. Default 1. */\r\n exposure: number;\r\n /**\r\n * Post-processing inside the 3D composite: `bloom`, `ssao`, `dof`, `outline`.\r\n *\r\n * Short by design — a `Canvas3D` is a `Node2D`, so vignette, grain, grading,\r\n * blur and the rest of the 2D `effects` chain already run over the composited\r\n * result. What is here is what genuinely needs the depth buffer, object ids,\r\n * or HDR radiance before tone mapping.\r\n *\r\n * **Inert today**: the chain is recorded on the scene and no pass is applied,\r\n * so a viewport with `post` renders exactly like one without (the first one\r\n * set warns in development). Use the viewport's 2D `effects` instead.\r\n */\r\n post: PostEffect3D | readonly PostEffect3D[];\r\n /**\r\n * The camera, as three numbers rather than a `<Camera3D>` child.\r\n *\r\n * A host that renders a **timeline** needs a camera a `to` command can tween\r\n * and a scrub can reproduce exactly, and a drag-to-orbit gesture that writes\r\n * the same values the timeline reads. Only read when the scene contains no\r\n * camera of its own, so a `<Camera3D>` child still wins.\r\n */\r\n\r\n /** Camera orbit about the vertical axis, in **degrees**. Animate this to spin. */\r\n orbit: number;\r\n /** Camera elevation above the ground plane, in **degrees**. */\r\n elevation: number;\r\n /** Camera distance from the origin, in scene units. */\r\n zoom: number;\r\n /** Vertical field of view, in **degrees**. */\r\n fov: number;\r\n /** Strength of the ambient fill. */\r\n ambientIntensity: number;\r\n /** Colour of the ambient fill. White leaves the meshes' own colours alone. */\r\n ambientColor: Color;\r\n /** Strength of the key light; the rim light is derived from it. */\r\n keyIntensity: number;\r\n /** Colour of the key light, and of the rim derived from it. */\r\n keyColor: Color;\r\n\r\n /**\r\n * Whether the ground plane is drawn. **Off by default** — it is an authoring\r\n * reference rather than part of the picture; see the property below.\r\n */\r\n showGrid: boolean;\r\n /** Total extent of the grid, in scene units. */\r\n gridSize: number;\r\n /** How many cells across it. */\r\n gridDivisions: number;\r\n /** Every Nth line is drawn heavier. */\r\n gridMajorEvery: number;\r\n gridColor: Color;\r\n gridMajorColor: Color;\r\n /** Whether the two coloured axis lines are drawn. Off by default, as above. */\r\n showAxes: boolean;\r\n axisXColor: Color;\r\n axisZColor: Color;\r\n /** How much of the way to the edge the grid has faded out, in `[0, 1]`. */\r\n gridFade: number;\r\n /**\r\n * What the grid fades into, when the node's own fills do not answer.\r\n *\r\n * **Derived, not authored.** The horizon dissolves into the first solid layer\r\n * of this node's `fill` — the viewport's background — and falls back to this\r\n * only when the stack has no solid in it to read (an empty stack, or a\r\n * gradient or image on its own). A grid that faded into a *different* colour\r\n * than the one behind it would ring the horizon with a halo, and the way to\r\n * make that impossible is for there to be nothing to keep in step: see\r\n * {@link Canvas3DView.fadeColor}.\r\n *\r\n * The same rule the engine applies to fog with no colour of its own, one\r\n * layer down (`Canvas3D.buildScene3D`), and for the same reason.\r\n */\r\n gridFadeColor: Color;\r\n}\r\n\r\n/**\r\n * A 3D viewport in the 2D document — the one node that holds both dimensions.\r\n *\r\n * `Canvas3D` is a {@link Rect} that partitions its children by which tree they\r\n * belong to. `Node3D` children describe a scene: they are walked through a\r\n * {@link Scene3D} every frame and the result is painted through this rect's own\r\n * path. `Node2D` children are ordinary children and draw *over* the 3D, which is\r\n * how a HUD is written.\r\n *\r\n * <Canvas3D width=\"fill\" height=\"fill\" cornerRadius={24} fill=\"#0b0d12\" shadows>\r\n * <Camera3D orbit={-18} elevation={12} distance={13} fov={45} />\r\n * <AmbientLight3D intensity={0.4} />\r\n * <DirectionalLight3D intensity={2.4} position={[4, 6, 3]} shadow />\r\n * <Fog3D near={5} far={30} />\r\n *\r\n * <Group3D ref={rig}>\r\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" roughness={0.3} />\r\n * </Group3D>\r\n *\r\n * <Text text=\"FPS 60\" fontSize={32} /> // a 2D HUD, over the 3D\r\n * </Canvas3D>\r\n *\r\n * Being a `Rect` is what makes it lay out in flex/stack groups, take\r\n * `cornerRadius`/`clip`, be masked, blended and filtered. The 3D is one more\r\n * fill layer, so the author's own `fill` paints *beneath* it and `stroke` and\r\n * `overlay` still paint over everything.\r\n *\r\n * **That fill is also the background.** There is no `<Background3D>`: three's\r\n * background pass is unaffected by every light and by fog, the renderer clears\r\n * transparent, and this node already composites the 3D over its own fill layers —\r\n * so a solid colour, a gradient, an image or a video behind a 3D scene is the\r\n * ordinary 2D fill chain, which does strictly more. What genuinely needs the 3D\r\n * pass is a sky that reprojects as the camera turns, and that is\r\n * `<Environment3D background>`.\r\n *\r\n * The scene is a value, not machinery: the same recorded {@link Scene3D} can be\r\n * built by hand and used as a fill on any shape, which is how 3D is painted\r\n * through glyphs or an arbitrary path (`<Text fill={scene} />`).\r\n */\r\nexport class Canvas3D<P extends Canvas3DProps = Canvas3DProps> extends Rect<P> {\r\n\r\n @property({ default: 35 }) declare orbit: number;\r\n @property({ default: 20 }) declare elevation: number;\r\n @property({ default: 12 }) declare zoom: number;\r\n @property({ default: 45 }) declare fov: number;\r\n\r\n @property({ default: 0.45 }) declare ambientIntensity: number;\r\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare ambientColor: Color;\r\n @property({ default: 2.4 }) declare keyIntensity: number;\r\n @property({ default: \"#ffffff\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare keyColor: Color;\r\n\r\n // Off by default, both of them: the grid and the axes are **reference**, and\r\n // reference belongs to whoever is authoring rather than to whoever is\r\n // watching. A host with an authoring view turns them on there, and nothing\r\n // else does — an export goes through the same builder with them left off.\r\n @property({ default: false }) declare showGrid: boolean;\r\n @property({ default: 40 }) declare gridSize: number;\r\n @property({ default: 40 }) declare gridDivisions: number;\r\n @property({ default: 5 }) declare gridMajorEvery: number;\r\n @property({ default: \"#26292f\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridColor: Color;\r\n @property({ default: \"#363a42\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridMajorColor: Color;\r\n @property({ default: false }) declare showAxes: boolean;\r\n @property({ default: \"#c8404f\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare axisXColor: Color;\r\n @property({ default: \"#2f6fd0\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare axisZColor: Color;\r\n @property({ default: 0.55 }) declare gridFade: number;\r\n @property({ default: \"#0b0d12\", mapper: resolveColor3D, tween: lerpColor3D })\r\n declare gridFadeColor: Color;\r\n\r\n\r\n /**\r\n * The children's scene, plus whatever it did not already state.\r\n *\r\n * Each default is applied only when the walk left that slot empty, so a\r\n * `PerspectiveCamera3D` or an `AmbientLight3D` placed as a child wins over the\r\n * node's own props rather than being silently overwritten by them — which is\r\n * the behaviour that lets this class stop being special the day an editor\r\n * offers those as node types.\r\n */\r\n /**\r\n * The grid geometry, rebuilt only when one of its fields moves.\r\n *\r\n * A `Scene3D` is recorded from scratch every frame, which is what makes the\r\n * whole design seekable — but the grid is thousands of floats and depends on\r\n * nothing that changes between frames. Caching it here is what lets the\r\n * descriptor claim `staticData`: the renderer compares buffers by identity, so\r\n * handing it the *same* arrays is the difference between one upload and sixty\r\n * a second.\r\n *\r\n * Keyed by the fields themselves rather than by a dirty flag, so a tween\r\n * through `gridFade` still rebuilds and nothing has to remember to invalidate.\r\n */\r\n private gridCache: { key: string; geometry: BufferGeometry3D } | null = null;\r\n\r\n /**\r\n * The colour a receding grid line ends up at: the background it is drawn on.\r\n *\r\n * The first **opaque solid** layer of the fill stack, which is what a\r\n * background stack is built on — everything above it is a gradient, an image\r\n * or a video painted over a base colour, and it is that base a surface\r\n * disappearing into the distance has to match. A stack with no solid in it\r\n * leaves {@link Canvas3DProps.gridFadeColor} standing, rather than\r\n * inventing black.\r\n *\r\n * Restated here rather than imported because the engine's own copy (used\r\n * for fog, in `Canvas3D.buildScene3D`) is a module-private function. The\r\n * duplication is small and deliberate — the alternative was a second control\r\n * the author had to keep in step with the fill, which is exactly what this\r\n * node used to have.\r\n */\r\n private fadeColor(): Color {\r\n const layers = this.fill as unknown;\r\n if (Array.isArray(layers)) {\r\n for (const layer of layers) {\r\n const paint = layer as { type?: string; color?: unknown } | null;\r\n if (paint?.type !== \"solid\") continue;\r\n const color = paint.color;\r\n // A `Color` is a string or a normalized tuple, and the grid takes\r\n // either — but the tuple's fourth channel is what says whether this\r\n // layer covers anything, so a transparent \"solid\" is passed over rather\r\n // than faded into.\r\n if (typeof color === \"string\") return color;\r\n if (Array.isArray(color) && (color[3] ?? 1) > 0) return color as Color;\r\n }\r\n }\r\n return this.gridFadeColor;\r\n }\r\n\r\n private gridDescriptor(): BufferGeometry3D {\r\n const options: Grid3DOptions = {\r\n size: this.gridSize,\r\n divisions: Math.max(1, Math.round(this.gridDivisions)),\r\n majorEvery: Math.max(1, Math.round(this.gridMajorEvery)),\r\n minorColor: this.gridColor,\r\n majorColor: this.gridMajorColor,\r\n axisXColor: this.axisXColor,\r\n axisZColor: this.axisZColor,\r\n showAxes: this.showAxes,\r\n fadeTo: this.fadeColor(),\r\n fade: this.gridFade,\r\n };\r\n\r\n const key = JSON.stringify(options);\r\n if (this.gridCache?.key !== key) {\r\n this.gridCache = { key, geometry: gridGeometry3D(options) };\r\n }\r\n return this.gridCache.geometry;\r\n }\r\n\r\n\r\n\r\n\r\n @property({ default: 2 }) declare maxPixelRatio: number;\r\n @property({ default: true }) declare antialias: boolean;\r\n @property({ default: false }) declare shadows: Shadows3D;\r\n @property({ default: undefined }) declare tone: ToneMapping3D | undefined;\r\n @property({ default: undefined }) declare exposure: number | undefined;\r\n @property({ default: undefined }) declare post: PostEffect3D | readonly PostEffect3D[] | undefined;\r\n\r\n constructor(props?: NodeConfig<Canvas3D<P>, P>) {\r\n super((props ?? {}) as NodeConfig<any, P>);\r\n }\r\n\r\n /**\r\n * Swing the default camera round the scene and pull it back or in,\r\n * whichever are given. `zoom` is its distance, as the prop is. A scene with\r\n * a `Camera3D` of its own is framed by that camera's `orbitTo` instead.\r\n */\r\n @command({\r\n args: [\r\n { key: \"orbit\", kind: \"number\", step: 1, unit: \"°\" },\r\n { key: \"elevation\", kind: \"number\", min: -89, max: 89, step: 1, unit: \"°\" },\r\n { key: \"zoom\", kind: \"number\", min: 0.01, step: 0.1 },\r\n ],\r\n })\r\n orbitTo(args: CommandArgs<{ orbit?: number; elevation?: number; zoom?: number }> & { duration: number }): Command<P> {\r\n const data: Record<string, number> = {};\r\n for (const [key, value] of Object.entries(args.data ?? {})) if (value !== undefined) data[key] = value;\r\n return this.to({ data: data as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /**\r\n * Accept both dimensions — the only node that does.\r\n *\r\n * Everywhere else a mixed tree is a mistake that would silently draw nothing\r\n * (see {@link Node.acceptsChild}); here it is the entire point.\r\n */\r\n protected override acceptsChild(child: Node): boolean {\r\n return true;\r\n }\r\n\r\n /**\r\n * The coordinates its 3D children's `x`/`y`/`z` are in, or `null` (the\r\n * default) when they are the scene's own. A viewport that is a graph answers\r\n * with the graph's units. See {@link ChildSpace3D}.\r\n */\r\n /** @internal */\r\n _spaceOf(_child: Node3D | null): ChildSpace3D | null {\r\n return null;\r\n }\r\n\r\n /** This node's children that describe the 3D scene. */\r\n get children3D(): Node3D[] {\r\n return this._allChildren.filter((c): c is Node3D => c instanceof Node3D);\r\n }\r\n\r\n /**\r\n * A 3D viewport has no intrinsic size and shouldn't be sized by its overlay\r\n * children — hugging a HUD label would collapse the viewport to the size of\r\n * the text. So it fills unless given an explicit size, whether or not it has\r\n * children (which is where this diverges from {@link Rect}).\r\n */\r\n protected override applyDefaultSize(props?: NodeConfig<any, P>): void {\r\n if (!props || props.width === undefined) this.applyProp(\"width\", \"fill\");\r\n if (!props || props.height === undefined) this.applyProp(\"height\", \"fill\");\r\n }\r\n\r\n /**\r\n * Record this frame's scene by walking the 3D children.\r\n *\r\n * The single seam both the real render and the asset-declaration pass go\r\n * through, so what gets loaded can never drift from what gets drawn. Override\r\n * it in a subclass for a reusable 3D component that builds its scene some\r\n * other way.\r\n *\r\n * Called inside the synchronous render pass, after the frame's state has been\r\n * evaluated and layout resolved, so every prop read here samples the\r\n * *current* frame. That is what makes a 3D scene seekable: frame N is\r\n * identical whether it was reached by playing forward or by scrubbing\r\n * backwards, because nothing accumulates.\r\n */\r\n protected buildScene3D(): Scene3D {\r\n const scene = new Scene3D();\r\n\r\n // The viewport's own render settings go on first, so a node in the tree\r\n // can still override one — the same last-writer-wins rule the scene\r\n // settings have always had, with the viewport as the first writer.\r\n const shadows = resolveShadows3D(this.shadows);\r\n if (shadows) scene.shadows(shadows);\r\n if (this.tone !== undefined || this.exposure !== undefined) {\r\n scene.tone({ mapping: this.tone, exposure: this.exposure });\r\n }\r\n if (this.post !== undefined) scene.post(this.post);\r\n\r\n for (const child of this._children) {\r\n if (child instanceof Node3D) child.render(scene);\r\n }\r\n\r\n // Fog with no colour of its own takes the viewport's. Fog that does not\r\n // match what is behind it reads as a grey wall rather than as distance,\r\n // and the two being typed separately is exactly how they drift — which\r\n // is what the old `<Background3D>` + `<Fog3D>` pair made you do.\r\n const fog = scene.fogDescriptor();\r\n if (fog && fog.color === undefined) {\r\n const base = baseFillColor(this.fill as FillResolved[]);\r\n if (base !== undefined) scene.fog({ ...fog, color: base });\r\n }\r\n\r\n\r\n\r\n // Drawn first, so it sits at the back of the op list — a mesh standing on\r\n // the ground plane should read as standing *on* it.\r\n if (this.showGrid) {\r\n scene.draw(\r\n new Graphics3D().line({\r\n geometry: this.gridDescriptor(),\r\n segments: true,\r\n material: {\r\n type: \"lineBasic\",\r\n // The whole picture is in the vertex colours — the minor lines, the\r\n // major ones, the two axes and the distance fade at once. See\r\n // {@link gridGeometry3D} for why that is one op rather than four.\r\n vertexColors: true,\r\n // The colours are already exactly what should appear: they were\r\n // chosen against this background and faded toward it by hand. Tone\r\n // mapping would re-grade them and pull the fade apart from the fill\r\n // it is supposed to disappear into.\r\n toneMapped: false,\r\n },\r\n }),\r\n );\r\n }\r\n\r\n // A viewport holding only 2D children (a HUD) has nothing to frame or to\r\n // light. Without this the default camera and rig made every scene\r\n // non-empty, so `renderSelf` ran a full 3D pass and created the WebGL\r\n // context to paint nothing. A subclass overriding `buildScene3D` is\r\n // exempt: it adds its own content after `super` returns and relies on the\r\n // rig being there.\r\n if (\r\n this.buildScene3D === Canvas3D.prototype.buildScene3D &&\r\n scene.isEmpty() &&\r\n !this._children.some((child) => child instanceof Node3D)\r\n ) {\r\n return scene;\r\n }\r\n\r\n if (scene.cameraDescriptor() === null) {\r\n // Polar placement is the camera's own vocabulary now, so the viewport's\r\n // orbit/elevation/zoom pass straight through instead of being converted to\r\n // a position here; `near`/`far` come from the scene's own bounds.\r\n // `cameraOrbit` is the quarter turn between the stored zero and the\r\n // camera's — see it for why that is converted rather than redefined.\r\n scene.perspective({\r\n fov: this.fov,\r\n orbit: cameraOrbit(this.orbit),\r\n elevation: this.elevation,\r\n distance: this.zoom,\r\n });\r\n }\r\n\r\n // A soft ambient fill, a key from the front-right and a weaker rim from\r\n // behind — enough that a plain untextured box reads as three distinct faces,\r\n // which is the whole job of a default rig.\r\n //\r\n // The rim takes the key's colour as well as a fraction of its strength: it\r\n // is the key seen from the other side rather than a light of its own, and a\r\n // rig whose two halves could be tinted apart is two controls rather than\r\n // one. See the schema's `keyColor`, which says the same from the panel's\r\n // side.\r\n if (!scene.ops().some((op) => op.kind === \"light\")) {\r\n scene\r\n .light({\r\n type: \"ambient\",\r\n intensity: this.ambientIntensity,\r\n color: this.ambientColor,\r\n })\r\n .light(\r\n {\r\n type: \"directional\",\r\n intensity: this.keyIntensity,\r\n color: this.keyColor,\r\n },\r\n { position: [4, 6, 3] },\r\n )\r\n .light(\r\n {\r\n type: \"directional\",\r\n intensity: this.keyIntensity * 0.35,\r\n color: this.keyColor,\r\n },\r\n { position: [-5, -2, -4] },\r\n );\r\n }\r\n\r\n return scene;\r\n }\r\n\r\n /**\r\n * This frame's scene, for a reader outside the render pass.\r\n *\r\n * {@link buildScene3D} is protected because a subclass overrides it, not\r\n * because the result is private — the asset pass and the render already call\r\n * it twice a frame. The editor geometry in `runtime/node-picking3d.ts` is the\r\n * third caller, and it has to go through the *same* seam rather than walking\r\n * the `Node3D` children itself: a subclass that builds its scene some other\r\n * way (supplying a default camera and lighting rig, say) would otherwise be\r\n * picked against a scene nobody renders.\r\n *\r\n * Recorded fresh, like the other two, so what it reports is this frame's\r\n * state rather than a cache a scrub could leave behind.\r\n */\r\n /** @internal */\r\n _scene3D(): Scene3D {\r\n return this.buildScene3D();\r\n }\r\n\r\n /**\r\n * The 3D runtime. The scene's resources are its `Node3D` children's to declare;\r\n * only a subclass building its scene some other way has resources no child states.\r\n */\r\n override declareAssets(assets: AssetScope): void {\r\n super.declareAssets(assets);\r\n assets.loader(\"three:runtime\", loadThreeRuntime);\r\n if (this.buildScene3D === Canvas3D.prototype.buildScene3D) return;\r\n const scene = this.buildScene3D();\r\n if (!scene.isEmpty()) declare3DResources(scene, assets);\r\n }\r\n\r\n /**\r\n * Bind every `Node2D` used as a `Tex.surface` source in this scene.\r\n *\r\n * A source node is detached — it is a value in a descriptor, not a child — so\r\n * nothing else would ever hand it an asset catalog, a context map or a clock.\r\n * This node has all three, and is the only thing that knows the scene, so it\r\n * adopts them. See {@link Node.attachDetached}.\r\n */\r\n private bindSurfaceSources(scene: Scene3D): void {\r\n forEachTexture3D(scene, (texture) => {\r\n if (!isSurfaceTexture3D(texture)) return;\r\n const source = resolveSurfaceSource(texture.source);\r\n if (source.kind === \"node\") this.attachDetached(source.node);\r\n });\r\n }\r\n\r\n protected override renderSelf(ctx: RenderContext2D): void {\r\n const built = this.buildScene3D();\r\n const scene = built.isEmpty() ? null : built;\r\n\r\n if (scene) {\r\n // Fail loudly at the author's source rather than silently reparenting\r\n // everything after an unclosed scope.\r\n scene.assertBalanced();\r\n this.bindSurfaceSources(scene);\r\n }\r\n\r\n // The author's own fill layers stay first, so a `fill` still paints\r\n // *beneath* the 3D; the scene goes on top as one more layer.\r\n const fill = scene\r\n ? [\r\n ...resolveChainFill(this.fill),\r\n ...Fills.canvas3D(scene, {\r\n maxPixelRatio: this.maxPixelRatio,\r\n antialias: this.antialias,\r\n }),\r\n ]\r\n : this.fill;\r\n\r\n // Stroke is deferred to renderStroke (drawn after children + overlay).\r\n ctx.draw(this.shapeGraphics().shadow(this.shadow).fill(fill));\r\n }\r\n}\r\n\r\n/**\r\n * The colour a fill chain reads as, for anything that has to match it.\r\n *\r\n * The first opaque solid layer, which is what a background stack is built on:\r\n * everything above it is a gradient, an image or a texture painted *over* a base\r\n * colour, and it is that base a receding surface fades into. Returns `undefined`\r\n * for a chain with no solid layer at all, which leaves the renderer's own\r\n * default in place rather than inventing black.\r\n */\r\nfunction baseFillColor(fill: FillResolved[] | undefined): Color | undefined {\r\n if (!fill) return undefined;\r\n for (const layer of fill) {\r\n if (layer && (layer as { type?: string }).type === \"solid\") {\r\n return (layer as unknown as { color: Color }).color;\r\n }\r\n }\r\n return undefined;\r\n}\r\n"]}
@@ -37,9 +37,21 @@ export declare class Instances3D<P extends Instances3DProps = Instances3DProps>
37
37
  protected resolvedMaterial(): Material3D;
38
38
  }
39
39
  export type Points3DProps = Mesh3DProps;
40
- /** A point cloud — one dot per vertex of the geometry. */
40
+ /**
41
+ * A point cloud — one dot per vertex of the geometry.
42
+ *
43
+ * The material is a `points` material built from the shorthand, so
44
+ * `<Points3D fill="red" opacity={0.5} />` paints red, half-transparent dots. The
45
+ * keys a point can use are `fill` (a colour, or a texture that becomes the dot's
46
+ * `map`), `opacity`, `alphaMap`, `blend` and `vertexColors`; the surface keys
47
+ * (`roughness`, `metalness`, `emission`, `shading`, `unlit` and the rest) have
48
+ * nothing to act on and are ignored. A `material` descriptor wins over all of them
49
+ * and sets the `size` and `sizeAttenuation` only it can.
50
+ */
41
51
  export declare class Points3D<P extends Points3DProps = Points3DProps> extends Mesh3D<P> {
42
52
  protected buildGraphics3D(): Graphics3D;
53
+ /** The `points` material the shorthand describes, or the node's own `material`. */
54
+ protected pointsMaterial(): Material3D;
43
55
  }
44
56
  export interface Line3DProps extends Node3DProps {
45
57
  /** The polyline's vertices. Give this or {@link geometry}, not both. */
@@ -49,7 +61,7 @@ export interface Line3DProps extends Node3DProps {
49
61
  * outline, say. Wins over {@link points}.
50
62
  */
51
63
  geometry: Geometry3D;
52
- /** Join the last point back to the first — the same prop the 2D `Line` has. */
64
+ /** Join the last point back to the first. */
53
65
  closed: boolean;
54
66
  /** Treat the points as disjoint start/end pairs rather than one path. */
55
67
  segments: boolean;
@@ -61,8 +73,8 @@ export interface Line3DProps extends Node3DProps {
61
73
  /**
62
74
  * A polyline in space.
63
75
  *
64
- * `closed` and `stroke` are the 2D `Line` node's own props, one dimension over,
65
- * in place of a `mode` enum and a flat `color`/`width`/`dashed` trio.
76
+ * `closed` and `stroke` stand in place of a `mode` enum and a flat
77
+ * `color`/`width`/`dashed` trio.
66
78
  *
67
79
  * Line width above 1 is not portable — most WebGL implementations ignore it — so
68
80
  * a thick line is better drawn as a {@link Tube3D}.
@@ -93,7 +105,10 @@ export declare class Sprite3D<P extends Sprite3DProps = Sprite3DProps> extends N
93
105
  protected renderSelf(ctx: RenderContext3D): void;
94
106
  }
95
107
  export interface Model3DProps extends Node3DProps {
96
- /** Path to a glTF/GLB file. */
108
+ /**
109
+ * Path to a glTF/GLB file. **Only glTF/GLB loads**: any other format, an OBJ
110
+ * included, resolves to an empty slot and draws nothing.
111
+ */
97
112
  src: string;
98
113
  /**
99
114
  * Baked animation clips, each sampled at an **explicit** time — which is what
@@ -103,7 +118,7 @@ export interface Model3DProps extends Node3DProps {
103
118
  /** Replace materials on the loaded graph, keyed by mesh or material name. */
104
119
  override: Readonly<Record<string, Material3D>> | undefined;
105
120
  }
106
- /** A loaded glTF/GLB model. */
121
+ /** A loaded glTF/GLB model. (OBJ and other formats are not loaded.) */
107
122
  export declare class Model3D<P extends Model3DProps = Model3DProps> extends Node3D<P> {
108
123
  src: string;
109
124
  animation: readonly ModelAnimation3D[] | ModelAnimation3D | undefined;
@@ -121,11 +136,10 @@ export interface ModelView3DProps extends Model3DProps {
121
136
  clipTime: number;
122
137
  }
123
138
  /**
124
- * The studio's **loaded model**: motion-script's `Model3D` with its animation
125
- * restated as two flat props.
139
+ * A **loaded model**: `Model3D` with its animation restated as two flat props.
126
140
  *
127
141
  * The class exists for one reason, and it is the same reason {@link Canvas3DView}
128
- * exists rather than the studio using a bare `Canvas3D`: **the timeline can only
142
+ * exists rather than an editor using a bare `Canvas3D`: **the timeline can only
129
143
  * tween a number**. `Model3D.animation` is an array of `{clip, time, weight}`
130
144
  * records, and a `to` command pointed at it would be asked to interpolate
131
145
  * between two arrays of objects — which the numeric tween path cannot do, and
@@ -135,7 +149,7 @@ export interface ModelView3DProps extends Model3DProps {
135
149
  * That makes "play the walk cycle" an ordinary `to` on {@link clipTime}, ramping
136
150
  * it from 0 to the clip's length — the same shape as every other animation in
137
151
  * the document, undoable and scrubbable and visible as a bar on the timeline.
138
- * And it inherits the property motion-script went out of its way to give the
152
+ * And it inherits the property the engine goes out of its way to give the
139
153
  * underlying op: the clip is sampled at an **explicit** time rather than
140
154
  * advanced by a frame delta, so seeking to a frame and playing to it produce the
141
155
  * same pose. A play/pause switch would have thrown that away.
@@ -150,7 +164,7 @@ export declare class ModelView3D extends Model3D<ModelView3DProps> {
150
164
  * The model op, with the animation folded in from the two props above.
151
165
  *
152
166
  * Deliberately does **not** call `super.buildGraphics3D()`: the base class
153
- * would read its own `animation` prop, which nothing in the studio ever
167
+ * would read its own `animation` prop, which nothing in an editor ever
154
168
  * writes. Rebuilding the op here is three lines and keeps the one place that
155
169
  * decides what a document row draws in one place.
156
170
  */
@@ -1 +1 @@
1
- {"version":3,"file":"drawable-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/drawable-nodes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"drawable-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/drawable-nodes.ts"],"names":[],"mappings":"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"}
@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
6
6
  };
7
7
  import { property } from "../../attributes/properties/decorator.js";
8
8
  import { Graphics3D, resolveMaterialShorthand3D, } from "../../render3d/graphics3d.js";
9
- import { lerpFill3D } from "../../render3d/fill3d.js";
9
+ import { lerpFill3D, resolveFill3D } from "../../render3d/fill3d.js";
10
10
  import { Mesh3D } from "./mesh3d.js";
11
11
  import { Node3D } from "./node3d.js";
12
12
  /**
@@ -38,21 +38,52 @@ __decorate([
38
38
  __decorate([
39
39
  property({ default: undefined })
40
40
  ], Instances3D.prototype, "colors", void 0);
41
- /** A point cloud — one dot per vertex of the geometry. */
41
+ /** The shorthand keys a `points` material can use, beside `fill`. */
42
+ const POINTS_MATERIAL_KEYS = ["opacity", "alphaMap", "blend", "vertexColors"];
43
+ /**
44
+ * A point cloud — one dot per vertex of the geometry.
45
+ *
46
+ * The material is a `points` material built from the shorthand, so
47
+ * `<Points3D fill="red" opacity={0.5} />` paints red, half-transparent dots. The
48
+ * keys a point can use are `fill` (a colour, or a texture that becomes the dot's
49
+ * `map`), `opacity`, `alphaMap`, `blend` and `vertexColors`; the surface keys
50
+ * (`roughness`, `metalness`, `emission`, `shading`, `unlit` and the rest) have
51
+ * nothing to act on and are ignored. A `material` descriptor wins over all of them
52
+ * and sets the `size` and `sizeAttenuation` only it can.
53
+ */
42
54
  export class Points3D extends Mesh3D {
43
55
  buildGraphics3D() {
44
56
  const g3 = new Graphics3D();
45
57
  const geometry = this.buildGeometry();
46
58
  if (geometry)
47
- g3.points(geometry, this.material);
59
+ g3.points(geometry, this.pointsMaterial());
48
60
  return g3;
49
61
  }
62
+ /** The `points` material the shorthand describes, or the node's own `material`. */
63
+ pointsMaterial() {
64
+ const explicit = this.material;
65
+ if (explicit !== undefined) {
66
+ return (Array.isArray(explicit) ? explicit[0] : explicit);
67
+ }
68
+ const material = { type: "points" };
69
+ const fill = resolveFill3D(this.fill);
70
+ if (fill.color !== undefined)
71
+ material.color = fill.color;
72
+ if (fill.map !== undefined)
73
+ material.map = fill.map;
74
+ for (const key of POINTS_MATERIAL_KEYS) {
75
+ const value = this[key];
76
+ if (value !== undefined)
77
+ material[key] = value;
78
+ }
79
+ return material;
80
+ }
50
81
  }
51
82
  /**
52
83
  * A polyline in space.
53
84
  *
54
- * `closed` and `stroke` are the 2D `Line` node's own props, one dimension over,
55
- * in place of a `mode` enum and a flat `color`/`width`/`dashed` trio.
85
+ * `closed` and `stroke` stand in place of a `mode` enum and a flat
86
+ * `color`/`width`/`dashed` trio.
56
87
  *
57
88
  * Line width above 1 is not portable — most WebGL implementations ignore it — so
58
89
  * a thick line is better drawn as a {@link Tube3D}.
@@ -122,7 +153,7 @@ __decorate([
122
153
  __decorate([
123
154
  property({ default: undefined })
124
155
  ], Sprite3D.prototype, "material", void 0);
125
- /** A loaded glTF/GLB model. */
156
+ /** A loaded glTF/GLB model. (OBJ and other formats are not loaded.) */
126
157
  export class Model3D extends Node3D {
127
158
  buildGraphics3D() {
128
159
  const g3 = new Graphics3D();
@@ -145,11 +176,10 @@ __decorate([
145
176
  property({ default: undefined })
146
177
  ], Model3D.prototype, "override", void 0);
147
178
  /**
148
- * The studio's **loaded model**: motion-script's `Model3D` with its animation
149
- * restated as two flat props.
179
+ * A **loaded model**: `Model3D` with its animation restated as two flat props.
150
180
  *
151
181
  * The class exists for one reason, and it is the same reason {@link Canvas3DView}
152
- * exists rather than the studio using a bare `Canvas3D`: **the timeline can only
182
+ * exists rather than an editor using a bare `Canvas3D`: **the timeline can only
153
183
  * tween a number**. `Model3D.animation` is an array of `{clip, time, weight}`
154
184
  * records, and a `to` command pointed at it would be asked to interpolate
155
185
  * between two arrays of objects — which the numeric tween path cannot do, and
@@ -159,7 +189,7 @@ __decorate([
159
189
  * That makes "play the walk cycle" an ordinary `to` on {@link clipTime}, ramping
160
190
  * it from 0 to the clip's length — the same shape as every other animation in
161
191
  * the document, undoable and scrubbable and visible as a bar on the timeline.
162
- * And it inherits the property motion-script went out of its way to give the
192
+ * And it inherits the property the engine goes out of its way to give the
163
193
  * underlying op: the clip is sampled at an **explicit** time rather than
164
194
  * advanced by a frame delta, so seeking to a frame and playing to it produce the
165
195
  * same pose. A play/pause switch would have thrown that away.
@@ -174,7 +204,7 @@ export class ModelView3D extends Model3D {
174
204
  * The model op, with the animation folded in from the two props above.
175
205
  *
176
206
  * Deliberately does **not** call `super.buildGraphics3D()`: the base class
177
- * would read its own `animation` prop, which nothing in the studio ever
207
+ * would read its own `animation` prop, which nothing in an editor ever
178
208
  * writes. Rebuilding the op here is three lines and keeps the one place that
179
209
  * decides what a document row draws in one place.
180
210
  */
@@ -200,7 +230,7 @@ __decorate([
200
230
  * What a Model 3D draws before a file has been picked: a wireframe box.
201
231
  *
202
232
  * **Not nothing**, and the reason is selection. A 3D node's canvas gizmo comes
203
- * from measuring its world-space AABB and projecting it (motion-script's
233
+ * from measuring its world-space AABB and projecting it (see
204
234
  * `node-picking3d.ts`), so a node that records no geometry has no box — which
205
235
  * means it cannot be clicked, cannot be dragged, and shows no outline when it
206
236
  * *is* selected from the Layers tree. A model with no file would therefore be
@@ -233,7 +263,7 @@ function placeholderGraphics(g3) {
233
263
  });
234
264
  }
235
265
  /**
236
- * The `clip` field as motion-script wants it: a name, an index, or nothing.
266
+ * The `clip` field as the renderer wants it: a name, an index, or nothing.
237
267
  *
238
268
  * A numeric string becomes a number because `ModelAnimation3D.clip` reads the
239
269
  * two differently — `"0"` as a name matches a clip literally called `0`, which