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

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 (904) hide show
  1. package/CHANGELOG.md +247 -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-2RIYH36X.js +3 -0
  240. package/dist/browser/chunks/chunk-2RIYH36X.js.map +7 -0
  241. package/dist/browser/chunks/chunk-DDJN3QII.js +15 -0
  242. package/dist/browser/chunks/chunk-DDJN3QII.js.map +7 -0
  243. package/dist/browser/chunks/chunk-DHB4COFY.js +2 -0
  244. package/dist/browser/chunks/chunk-DHB4COFY.js.map +7 -0
  245. package/dist/browser/chunks/chunk-EJDPYDQI.js +5 -0
  246. package/dist/browser/chunks/chunk-EJDPYDQI.js.map +7 -0
  247. package/dist/browser/chunks/chunk-SFNJRPBV.js +2 -0
  248. package/dist/browser/chunks/chunk-SFNJRPBV.js.map +7 -0
  249. package/dist/browser/chunks/chunk-XAWE4EAK.js +2 -0
  250. package/dist/browser/chunks/chunk-XAWE4EAK.js.map +7 -0
  251. package/dist/browser/component.js +1 -1
  252. package/dist/browser/component.js.map +4 -4
  253. package/dist/browser/experimental.js +2 -0
  254. package/dist/browser/experimental.js.map +7 -0
  255. package/dist/browser/index.js +1 -1
  256. package/dist/browser/index.js.map +4 -4
  257. package/dist/browser/jsx-jsx-dev-runtime.js +1 -1
  258. package/dist/browser/jsx-jsx-runtime.js +1 -1
  259. package/dist/browser/manifest.json +4 -2
  260. package/dist/browser/sdk.js +1 -1
  261. package/dist/component/api.d.ts +508 -0
  262. package/dist/component/api.d.ts.map +1 -0
  263. package/dist/component/api.js +4 -0
  264. package/dist/component/api.js.map +1 -0
  265. package/dist/component/builtins/audio.d.ts +26 -0
  266. package/dist/component/builtins/audio.d.ts.map +1 -0
  267. package/dist/component/builtins/audio.js +41 -0
  268. package/dist/component/builtins/audio.js.map +1 -0
  269. package/dist/component/builtins/canvas3d.d.ts +98 -0
  270. package/dist/component/builtins/canvas3d.d.ts.map +1 -0
  271. package/dist/component/builtins/canvas3d.js +21 -0
  272. package/dist/component/builtins/canvas3d.js.map +1 -0
  273. package/dist/component/builtins/composite.d.ts +56 -0
  274. package/dist/component/builtins/composite.d.ts.map +1 -0
  275. package/dist/component/builtins/composite.js +25 -0
  276. package/dist/component/builtins/composite.js.map +1 -0
  277. package/dist/component/builtins/geometry.d.ts +505 -0
  278. package/dist/component/builtins/geometry.d.ts.map +1 -0
  279. package/dist/component/builtins/geometry.js +107 -0
  280. package/dist/component/builtins/geometry.js.map +1 -0
  281. package/dist/component/builtins/layout.d.ts +88 -0
  282. package/dist/component/builtins/layout.d.ts.map +1 -0
  283. package/dist/component/builtins/layout.js +84 -0
  284. package/dist/component/builtins/layout.js.map +1 -0
  285. package/dist/component/builtins/media.d.ts +95 -0
  286. package/dist/component/builtins/media.d.ts.map +1 -0
  287. package/dist/component/builtins/media.js +149 -0
  288. package/dist/component/builtins/media.js.map +1 -0
  289. package/dist/component/builtins/providers.d.ts +23 -0
  290. package/dist/component/builtins/providers.d.ts.map +1 -0
  291. package/dist/component/builtins/providers.js +30 -0
  292. package/dist/component/builtins/providers.js.map +1 -0
  293. package/dist/component/builtins/text.d.ts +193 -0
  294. package/dist/component/builtins/text.d.ts.map +1 -0
  295. package/dist/component/builtins/text.js +113 -0
  296. package/dist/component/builtins/text.js.map +1 -0
  297. package/dist/component/builtins/three.d.ts +1085 -0
  298. package/dist/component/builtins/three.d.ts.map +1 -0
  299. package/dist/component/builtins/three.js +265 -0
  300. package/dist/component/builtins/three.js.map +1 -0
  301. package/dist/component/clip-of.d.ts +5 -0
  302. package/dist/component/clip-of.d.ts.map +1 -0
  303. package/dist/component/clip-of.js +33 -0
  304. package/dist/component/clip-of.js.map +1 -0
  305. package/dist/component/commands-for.d.ts +19 -0
  306. package/dist/component/commands-for.d.ts.map +1 -0
  307. package/dist/component/commands-for.js +5 -0
  308. package/dist/component/commands-for.js.map +1 -0
  309. package/dist/component/component-audio.d.ts +9 -0
  310. package/dist/component/component-audio.d.ts.map +1 -0
  311. package/dist/component/component-audio.js +18 -0
  312. package/dist/component/component-audio.js.map +1 -0
  313. package/dist/component/component2d.d.ts +9 -0
  314. package/dist/component/component2d.d.ts.map +1 -0
  315. package/dist/component/component2d.js +239 -0
  316. package/dist/component/component2d.js.map +1 -0
  317. package/dist/component/component3d.d.ts +9 -0
  318. package/dist/component/component3d.d.ts.map +1 -0
  319. package/dist/component/component3d.js +99 -0
  320. package/dist/component/component3d.js.map +1 -0
  321. package/dist/component/factory.d.ts +63 -0
  322. package/dist/component/factory.d.ts.map +1 -0
  323. package/dist/component/factory.js +313 -0
  324. package/dist/component/factory.js.map +1 -0
  325. package/dist/component/modules/aim.d.ts +30 -0
  326. package/dist/component/modules/aim.d.ts.map +1 -0
  327. package/dist/component/modules/aim.js +39 -0
  328. package/dist/component/modules/aim.js.map +1 -0
  329. package/dist/component/modules/corners.d.ts +13 -0
  330. package/dist/component/modules/corners.d.ts.map +1 -0
  331. package/dist/component/modules/corners.js +12 -0
  332. package/dist/component/modules/corners.js.map +1 -0
  333. package/dist/component/modules/flow.d.ts +26 -0
  334. package/dist/component/modules/flow.d.ts.map +1 -0
  335. package/dist/component/modules/flow.js +55 -0
  336. package/dist/component/modules/flow.js.map +1 -0
  337. package/dist/component/modules/material.d.ts +40 -0
  338. package/dist/component/modules/material.d.ts.map +1 -0
  339. package/dist/component/modules/material.js +75 -0
  340. package/dist/component/modules/material.js.map +1 -0
  341. package/dist/component/modules/paint.d.ts +71 -0
  342. package/dist/component/modules/paint.d.ts.map +1 -0
  343. package/dist/component/modules/paint.js +106 -0
  344. package/dist/component/modules/paint.js.map +1 -0
  345. package/dist/component/modules/shapes.d.ts +31 -0
  346. package/dist/component/modules/shapes.d.ts.map +1 -0
  347. package/dist/component/modules/shapes.js +43 -0
  348. package/dist/component/modules/shapes.js.map +1 -0
  349. package/dist/component/modules/text-layout.d.ts +26 -0
  350. package/dist/component/modules/text-layout.d.ts.map +1 -0
  351. package/dist/component/modules/text-layout.js +57 -0
  352. package/dist/component/modules/text-layout.js.map +1 -0
  353. package/dist/component/modules/text-style.d.ts +48 -0
  354. package/dist/component/modules/text-style.d.ts.map +1 -0
  355. package/dist/component/modules/text-style.js +63 -0
  356. package/dist/component/modules/text-style.js.map +1 -0
  357. package/dist/component/modules/three-entries.d.ts +23 -0
  358. package/dist/component/modules/three-entries.d.ts.map +1 -0
  359. package/dist/component/modules/three-entries.js +41 -0
  360. package/dist/component/modules/three-entries.js.map +1 -0
  361. package/dist/component/modules/view3d.d.ts +55 -0
  362. package/dist/component/modules/view3d.d.ts.map +1 -0
  363. package/dist/component/modules/view3d.js +160 -0
  364. package/dist/component/modules/view3d.js.map +1 -0
  365. package/dist/component/timeline.d.ts +22 -0
  366. package/dist/component/timeline.d.ts.map +1 -0
  367. package/dist/component/timeline.js +128 -0
  368. package/dist/component/timeline.js.map +1 -0
  369. package/dist/component/type-def.d.ts +26 -0
  370. package/dist/component/type-def.d.ts.map +1 -0
  371. package/dist/component/type-def.js +16 -0
  372. package/dist/component/type-def.js.map +1 -0
  373. package/dist/component/types.d.ts +91 -0
  374. package/dist/component/types.d.ts.map +1 -0
  375. package/dist/component/types.js +88 -0
  376. package/dist/component/types.js.map +1 -0
  377. package/dist/component/views.d.ts +121 -0
  378. package/dist/component/views.d.ts.map +1 -0
  379. package/dist/component/views.js +413 -0
  380. package/dist/component/views.js.map +1 -0
  381. package/dist/component.d.ts +4 -5
  382. package/dist/component.d.ts.map +1 -1
  383. package/dist/component.js +3 -5
  384. package/dist/component.js.map +1 -1
  385. package/dist/document/audio.d.ts +10 -2
  386. package/dist/document/audio.d.ts.map +1 -1
  387. package/dist/document/audio.js +45 -4
  388. package/dist/document/audio.js.map +1 -1
  389. package/dist/document/builtins.d.ts.map +1 -1
  390. package/dist/document/builtins.js +15 -39
  391. package/dist/document/builtins.js.map +1 -1
  392. package/dist/document/command-traits.d.ts +1 -1
  393. package/dist/document/command-traits.js +16 -1
  394. package/dist/document/command-traits.js.map +1 -1
  395. package/dist/document/deny-globals.js.map +1 -1
  396. package/dist/document/diff.d.ts.map +1 -1
  397. package/dist/document/diff.js +3 -3
  398. package/dist/document/diff.js.map +1 -1
  399. package/dist/document/doc-index.d.ts +2 -2
  400. package/dist/document/doc-index.d.ts.map +1 -1
  401. package/dist/document/doc-index.js +3 -3
  402. package/dist/document/doc-index.js.map +1 -1
  403. package/dist/document/expression/compile.d.ts.map +1 -1
  404. package/dist/document/expression/compile.js +8 -5
  405. package/dist/document/expression/compile.js.map +1 -1
  406. package/dist/document/expression/index.js.map +1 -1
  407. package/dist/document/expression/ops.js +1 -1
  408. package/dist/document/expression/ops.js.map +1 -1
  409. package/dist/document/expression/parse.d.ts.map +1 -1
  410. package/dist/document/expression/parse.js +15 -6
  411. package/dist/document/expression/parse.js.map +1 -1
  412. package/dist/document/expression/refs.d.ts +1 -1
  413. package/dist/document/expression/refs.js +1 -1
  414. package/dist/document/expression/refs.js.map +1 -1
  415. package/dist/document/expression/types.js.map +1 -1
  416. package/dist/document/expression/walk.d.ts.map +1 -1
  417. package/dist/document/expression/walk.js +2 -1
  418. package/dist/document/expression/walk.js.map +1 -1
  419. package/dist/document/index.d.ts +2 -0
  420. package/dist/document/index.d.ts.map +1 -1
  421. package/dist/document/index.js +2 -0
  422. package/dist/document/index.js.map +1 -1
  423. package/dist/document/node-decorator.js.map +1 -1
  424. package/dist/document/node-descriptor.d.ts +25 -0
  425. package/dist/document/node-descriptor.d.ts.map +1 -1
  426. package/dist/document/node-descriptor.js.map +1 -1
  427. package/dist/document/placement.d.ts +70 -0
  428. package/dist/document/placement.d.ts.map +1 -0
  429. package/dist/document/placement.js +83 -0
  430. package/dist/document/placement.js.map +1 -0
  431. package/dist/document/project.d.ts +2 -2
  432. package/dist/document/project.d.ts.map +1 -1
  433. package/dist/document/project.js.map +1 -1
  434. package/dist/document/registry.d.ts +23 -11
  435. package/dist/document/registry.d.ts.map +1 -1
  436. package/dist/document/registry.js +46 -19
  437. package/dist/document/registry.js.map +1 -1
  438. package/dist/document/settled-index.d.ts +49 -0
  439. package/dist/document/settled-index.d.ts.map +1 -0
  440. package/dist/document/settled-index.js +247 -0
  441. package/dist/document/settled-index.js.map +1 -0
  442. package/dist/document/timeline-patch.js.map +1 -1
  443. package/dist/document/timeline.d.ts +100 -19
  444. package/dist/document/timeline.d.ts.map +1 -1
  445. package/dist/document/timeline.js +290 -42
  446. package/dist/document/timeline.js.map +1 -1
  447. package/dist/document/types.d.ts +12 -12
  448. package/dist/document/types.d.ts.map +1 -1
  449. package/dist/document/types.js +2 -2
  450. package/dist/document/types.js.map +1 -1
  451. package/dist/document/validate.d.ts +2 -2
  452. package/dist/document/validate.d.ts.map +1 -1
  453. package/dist/document/validate.js +37 -31
  454. package/dist/document/validate.js.map +1 -1
  455. package/dist/document/withdraw.d.ts +28 -0
  456. package/dist/document/withdraw.d.ts.map +1 -0
  457. package/dist/document/withdraw.js +61 -0
  458. package/dist/document/withdraw.js.map +1 -0
  459. package/dist/experimental.d.ts +22 -0
  460. package/dist/experimental.d.ts.map +1 -0
  461. package/dist/experimental.js +20 -0
  462. package/dist/experimental.js.map +1 -0
  463. package/dist/index.d.ts +10 -0
  464. package/dist/index.d.ts.map +1 -1
  465. package/dist/index.js +10 -0
  466. package/dist/index.js.map +1 -1
  467. package/dist/jsx/jsx-dev-runtime.js.map +1 -1
  468. package/dist/jsx/jsx-runtime.d.ts +9 -1
  469. package/dist/jsx/jsx-runtime.d.ts.map +1 -1
  470. package/dist/jsx/jsx-runtime.js +13 -3
  471. package/dist/jsx/jsx-runtime.js.map +1 -1
  472. package/dist/layout/bounds.d.ts +0 -1
  473. package/dist/layout/bounds.d.ts.map +1 -1
  474. package/dist/layout/bounds.js.map +1 -1
  475. package/dist/layout/constraints.js.map +1 -1
  476. package/dist/layout/flex.d.ts +4 -2
  477. package/dist/layout/flex.d.ts.map +1 -1
  478. package/dist/layout/flex.js +27 -11
  479. package/dist/layout/flex.js.map +1 -1
  480. package/dist/layout/freeform.js.map +1 -1
  481. package/dist/layout/grid.js.map +1 -1
  482. package/dist/layout/index.js.map +1 -1
  483. package/dist/layout/item.js.map +1 -1
  484. package/dist/layout/ops.d.ts +6 -0
  485. package/dist/layout/ops.d.ts.map +1 -1
  486. package/dist/layout/ops.js +6 -0
  487. package/dist/layout/ops.js.map +1 -1
  488. package/dist/layout/types.js.map +1 -1
  489. package/dist/nodes/2d/node-lifecycle.js.map +1 -1
  490. package/dist/nodes/2d/node-motion.js.map +1 -1
  491. package/dist/nodes/2d/node-render.d.ts +3 -3
  492. package/dist/nodes/2d/node-render.d.ts.map +1 -1
  493. package/dist/nodes/2d/node-render.js.map +1 -1
  494. package/dist/nodes/2d/node-transform.js.map +1 -1
  495. package/dist/nodes/2d/node2d.d.ts +115 -3
  496. package/dist/nodes/2d/node2d.d.ts.map +1 -1
  497. package/dist/nodes/2d/node2d.js +180 -28
  498. package/dist/nodes/2d/node2d.js.map +1 -1
  499. package/dist/nodes/2d/paint-node.d.ts +27 -0
  500. package/dist/nodes/2d/paint-node.d.ts.map +1 -1
  501. package/dist/nodes/2d/paint-node.js +42 -0
  502. package/dist/nodes/2d/paint-node.js.map +1 -1
  503. package/dist/nodes/audio/audio-bus.js.map +1 -1
  504. package/dist/nodes/audio/index.d.ts +2 -2
  505. package/dist/nodes/audio/index.d.ts.map +1 -1
  506. package/dist/nodes/audio/index.js +0 -2
  507. package/dist/nodes/audio/index.js.map +1 -1
  508. package/dist/nodes/audio/node-audio.js.map +1 -1
  509. package/dist/nodes/audio/sound-node.d.ts +4 -3
  510. package/dist/nodes/audio/sound-node.d.ts.map +1 -1
  511. package/dist/nodes/audio/sound-node.js +4 -1
  512. package/dist/nodes/audio/sound-node.js.map +1 -1
  513. package/dist/nodes/geometry/bounds-shape-node.d.ts +4 -4
  514. package/dist/nodes/geometry/bounds-shape-node.js +2 -2
  515. package/dist/nodes/geometry/bounds-shape-node.js.map +1 -1
  516. package/dist/nodes/geometry/box-path-node.d.ts +3 -3
  517. package/dist/nodes/geometry/box-path-node.js +2 -2
  518. package/dist/nodes/geometry/box-path-node.js.map +1 -1
  519. package/dist/nodes/geometry/ellipse-node.js.map +1 -1
  520. package/dist/nodes/geometry/group-bounds.d.ts +2 -2
  521. package/dist/nodes/geometry/group-bounds.d.ts.map +1 -1
  522. package/dist/nodes/geometry/group-bounds.js +1 -2
  523. package/dist/nodes/geometry/group-bounds.js.map +1 -1
  524. package/dist/nodes/geometry/path-node.d.ts.map +1 -1
  525. package/dist/nodes/geometry/path-node.js +6 -0
  526. package/dist/nodes/geometry/path-node.js.map +1 -1
  527. package/dist/nodes/geometry/polygon-node.js.map +1 -1
  528. package/dist/nodes/geometry/polygram-node.js.map +1 -1
  529. package/dist/nodes/geometry/rect-node.js.map +1 -1
  530. package/dist/nodes/geometry/shape-node.js.map +1 -1
  531. package/dist/nodes/geometry/shape-outline.d.ts +2 -2
  532. package/dist/nodes/geometry/shape-outline.d.ts.map +1 -1
  533. package/dist/nodes/geometry/shape-outline.js +2 -13
  534. package/dist/nodes/geometry/shape-outline.js.map +1 -1
  535. package/dist/nodes/index.d.ts +40 -33
  536. package/dist/nodes/index.d.ts.map +1 -1
  537. package/dist/nodes/index.js +17 -36
  538. package/dist/nodes/index.js.map +1 -1
  539. package/dist/nodes/layout/camera-node.d.ts +9 -0
  540. package/dist/nodes/layout/camera-node.d.ts.map +1 -1
  541. package/dist/nodes/layout/camera-node.js +38 -3
  542. package/dist/nodes/layout/camera-node.js.map +1 -1
  543. package/dist/nodes/layout/orbit-camera-node.d.ts +1 -1
  544. package/dist/nodes/layout/orbit-camera-node.js +1 -1
  545. package/dist/nodes/layout/orbit-camera-node.js.map +1 -1
  546. package/dist/nodes/layout/rotated-box.js.map +1 -1
  547. package/dist/nodes/media/video-node.d.ts.map +1 -1
  548. package/dist/nodes/media/video-node.js +2 -0
  549. package/dist/nodes/media/video-node.js.map +1 -1
  550. package/dist/nodes/node/declare-paints.js.map +1 -1
  551. package/dist/nodes/node/node-editor-state.js.map +1 -1
  552. package/dist/nodes/node/node-reactive.js.map +1 -1
  553. package/dist/nodes/node/node-time.d.ts +3 -3
  554. package/dist/nodes/node/node-time.d.ts.map +1 -1
  555. package/dist/nodes/node/node-time.js +1 -1
  556. package/dist/nodes/node/node-time.js.map +1 -1
  557. package/dist/nodes/node/node-walk.js.map +1 -1
  558. package/dist/nodes/node/node.d.ts +12 -4
  559. package/dist/nodes/node/node.d.ts.map +1 -1
  560. package/dist/nodes/node/node.js +67 -27
  561. package/dist/nodes/node/node.js.map +1 -1
  562. package/dist/nodes/node/text-defaults.d.ts +10 -12
  563. package/dist/nodes/node/text-defaults.d.ts.map +1 -1
  564. package/dist/nodes/node/text-defaults.js +10 -12
  565. package/dist/nodes/node/text-defaults.js.map +1 -1
  566. package/dist/nodes/{scene → root}/canvas2d-node.d.ts +4 -3
  567. package/dist/nodes/root/canvas2d-node.d.ts.map +1 -0
  568. package/dist/nodes/{scene → root}/canvas2d-node.js +5 -2
  569. package/dist/nodes/root/canvas2d-node.js.map +1 -0
  570. package/dist/nodes/root/provider-node.d.ts.map +1 -0
  571. package/dist/nodes/root/provider-node.js.map +1 -0
  572. package/dist/nodes/root/theme-provider-node.d.ts.map +1 -0
  573. package/dist/nodes/root/theme-provider-node.js.map +1 -0
  574. package/dist/nodes/text/default-text-style-node.d.ts +5 -2
  575. package/dist/nodes/text/default-text-style-node.d.ts.map +1 -1
  576. package/dist/nodes/text/default-text-style-node.js +10 -4
  577. package/dist/nodes/text/default-text-style-node.js.map +1 -1
  578. package/dist/nodes/text/number-format.d.ts +1 -1
  579. package/dist/nodes/text/number-format.js +1 -1
  580. package/dist/nodes/text/number-format.js.map +1 -1
  581. package/dist/nodes/text/number-node.js.map +1 -1
  582. package/dist/nodes/text/number-pattern.js.map +1 -1
  583. package/dist/nodes/text/richtext-node.d.ts +0 -5
  584. package/dist/nodes/text/richtext-node.d.ts.map +1 -1
  585. package/dist/nodes/text/richtext-node.js +6 -72
  586. package/dist/nodes/text/richtext-node.js.map +1 -1
  587. package/dist/nodes/text/text-base.d.ts +5 -22
  588. package/dist/nodes/text/text-base.d.ts.map +1 -1
  589. package/dist/nodes/text/text-base.js +13 -364
  590. package/dist/nodes/text/text-base.js.map +1 -1
  591. package/dist/nodes/text/text-layout.d.ts +87 -0
  592. package/dist/nodes/text/text-layout.d.ts.map +1 -0
  593. package/dist/nodes/text/text-layout.js +368 -0
  594. package/dist/nodes/text/text-layout.js.map +1 -0
  595. package/dist/nodes/text/text-node.js.map +1 -1
  596. package/dist/nodes/text/text-selection.js.map +1 -1
  597. package/dist/nodes/three/camera-nodes.d.ts +21 -3
  598. package/dist/nodes/three/camera-nodes.d.ts.map +1 -1
  599. package/dist/nodes/three/camera-nodes.js +42 -1
  600. package/dist/nodes/three/camera-nodes.js.map +1 -1
  601. package/dist/nodes/three/canvas3d-node.d.ts +32 -7
  602. package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
  603. package/dist/nodes/three/canvas3d-node.js +50 -2
  604. package/dist/nodes/three/canvas3d-node.js.map +1 -1
  605. package/dist/nodes/three/drawable-nodes.d.ts +25 -11
  606. package/dist/nodes/three/drawable-nodes.d.ts.map +1 -1
  607. package/dist/nodes/three/drawable-nodes.js +43 -13
  608. package/dist/nodes/three/drawable-nodes.js.map +1 -1
  609. package/dist/nodes/three/environment-nodes.d.ts +9 -3
  610. package/dist/nodes/three/environment-nodes.d.ts.map +1 -1
  611. package/dist/nodes/three/environment-nodes.js.map +1 -1
  612. package/dist/nodes/three/geometry-nodes.d.ts +2 -2
  613. package/dist/nodes/three/geometry-nodes.js +2 -2
  614. package/dist/nodes/three/geometry-nodes.js.map +1 -1
  615. package/dist/nodes/three/grid-geometry3d.js.map +1 -1
  616. package/dist/nodes/three/group3d.js.map +1 -1
  617. package/dist/nodes/three/light-nodes.d.ts.map +1 -1
  618. package/dist/nodes/three/light-nodes.js +3 -3
  619. package/dist/nodes/three/light-nodes.js.map +1 -1
  620. package/dist/nodes/three/mesh3d.js.map +1 -1
  621. package/dist/nodes/three/node3d.d.ts +48 -0
  622. package/dist/nodes/three/node3d.d.ts.map +1 -1
  623. package/dist/nodes/three/node3d.js +53 -3
  624. package/dist/nodes/three/node3d.js.map +1 -1
  625. package/dist/platform/audio-sink.d.ts +2 -2
  626. package/dist/platform/audio-sink.d.ts.map +1 -1
  627. package/dist/platform/audio-sink.js.map +1 -1
  628. package/dist/platform/exporter.d.ts +13 -8
  629. package/dist/platform/exporter.d.ts.map +1 -1
  630. package/dist/platform/exporter.js.map +1 -1
  631. package/dist/platform/index.d.ts +1 -1
  632. package/dist/platform/index.d.ts.map +1 -1
  633. package/dist/platform/index.js.map +1 -1
  634. package/dist/platform/stepped-clock.js.map +1 -1
  635. package/dist/platform/storage-adapter.d.ts +12 -6
  636. package/dist/platform/storage-adapter.d.ts.map +1 -1
  637. package/dist/platform/storage-adapter.js +4 -0
  638. package/dist/platform/storage-adapter.js.map +1 -1
  639. package/dist/platform/ticker.d.ts +6 -0
  640. package/dist/platform/ticker.d.ts.map +1 -1
  641. package/dist/platform/ticker.js +6 -0
  642. package/dist/platform/ticker.js.map +1 -1
  643. package/dist/project/config.js.map +1 -1
  644. package/dist/project/index.js.map +1 -1
  645. package/dist/project/tree.d.ts +3 -3
  646. package/dist/project/tree.d.ts.map +1 -1
  647. package/dist/project/tree.js.map +1 -1
  648. package/dist/props/host.js.map +1 -1
  649. package/dist/props/index.js.map +1 -1
  650. package/dist/props/observer.js.map +1 -1
  651. package/dist/props/slot.js.map +1 -1
  652. package/dist/renamed-scene-names.d.ts +17 -0
  653. package/dist/renamed-scene-names.d.ts.map +1 -0
  654. package/dist/renamed-scene-names.js +9 -0
  655. package/dist/renamed-scene-names.js.map +1 -0
  656. package/dist/render/canvas-render-context2d.d.ts +2 -2
  657. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  658. package/dist/render/canvas-render-context2d.js.map +1 -1
  659. package/dist/render/clip-contains.js.map +1 -1
  660. package/dist/render/clip.js.map +1 -1
  661. package/dist/render/descriptors/ellipse.js.map +1 -1
  662. package/dist/render/descriptors/latex.js.map +1 -1
  663. package/dist/render/descriptors/line.js.map +1 -1
  664. package/dist/render/descriptors/path-builder.js.map +1 -1
  665. package/dist/render/descriptors/path.js.map +1 -1
  666. package/dist/render/descriptors/polygon.js.map +1 -1
  667. package/dist/render/descriptors/polygram.js.map +1 -1
  668. package/dist/render/descriptors/rect.js.map +1 -1
  669. package/dist/render/descriptors/richtext.js.map +1 -1
  670. package/dist/render/descriptors/shape.d.ts +12 -0
  671. package/dist/render/descriptors/shape.d.ts.map +1 -1
  672. package/dist/render/descriptors/shape.js.map +1 -1
  673. package/dist/render/descriptors/text.d.ts +2 -2
  674. package/dist/render/descriptors/text.js +2 -2
  675. package/dist/render/descriptors/text.js.map +1 -1
  676. package/dist/render/descriptors/transform.d.ts +2 -2
  677. package/dist/render/descriptors/transform.d.ts.map +1 -1
  678. package/dist/render/descriptors/transform.js.map +1 -1
  679. package/dist/render/graphics2d.d.ts +3 -3
  680. package/dist/render/graphics2d.d.ts.map +1 -1
  681. package/dist/render/graphics2d.js +1 -1
  682. package/dist/render/graphics2d.js.map +1 -1
  683. package/dist/render/index.js.map +1 -1
  684. package/dist/render/measure-context.js.map +1 -1
  685. package/dist/render/null-render-context.js.map +1 -1
  686. package/dist/render/render-context2d.d.ts +2 -2
  687. package/dist/render/render-context2d.d.ts.map +1 -1
  688. package/dist/render/render-context2d.js.map +1 -1
  689. package/dist/render/surface.js.map +1 -1
  690. package/dist/render/text-defaults.js.map +1 -1
  691. package/dist/render/text-layout.js.map +1 -1
  692. package/dist/render3d/bounds3d.d.ts.map +1 -1
  693. package/dist/render3d/bounds3d.js +4 -2
  694. package/dist/render3d/bounds3d.js.map +1 -1
  695. package/dist/render3d/builders.js.map +1 -1
  696. package/dist/render3d/camera.d.ts +6 -0
  697. package/dist/render3d/camera.d.ts.map +1 -1
  698. package/dist/render3d/camera.js +5 -3
  699. package/dist/render3d/camera.js.map +1 -1
  700. package/dist/render3d/fill3d.d.ts +2 -9
  701. package/dist/render3d/fill3d.d.ts.map +1 -1
  702. package/dist/render3d/fill3d.js +2 -13
  703. package/dist/render3d/fill3d.js.map +1 -1
  704. package/dist/render3d/geometry.d.ts +8 -1
  705. package/dist/render3d/geometry.d.ts.map +1 -1
  706. package/dist/render3d/geometry.js.map +1 -1
  707. package/dist/render3d/graphics3d.d.ts +8 -4
  708. package/dist/render3d/graphics3d.d.ts.map +1 -1
  709. package/dist/render3d/graphics3d.js +18 -10
  710. package/dist/render3d/graphics3d.js.map +1 -1
  711. package/dist/render3d/index.d.ts +1 -1
  712. package/dist/render3d/index.js +1 -1
  713. package/dist/render3d/index.js.map +1 -1
  714. package/dist/render3d/inert.d.ts +14 -0
  715. package/dist/render3d/inert.d.ts.map +1 -0
  716. package/dist/render3d/inert.js +62 -0
  717. package/dist/render3d/inert.js.map +1 -0
  718. package/dist/render3d/light.js.map +1 -1
  719. package/dist/render3d/material.d.ts +10 -5
  720. package/dist/render3d/material.d.ts.map +1 -1
  721. package/dist/render3d/material.js.map +1 -1
  722. package/dist/render3d/matrix4.js.map +1 -1
  723. package/dist/render3d/render-context3d.js.map +1 -1
  724. package/dist/render3d/resources.js.map +1 -1
  725. package/dist/render3d/rounded-box.js.map +1 -1
  726. package/dist/render3d/scene-settings.d.ts +23 -4
  727. package/dist/render3d/scene-settings.d.ts.map +1 -1
  728. package/dist/render3d/scene-settings.js.map +1 -1
  729. package/dist/render3d/scene3d.d.ts +11 -0
  730. package/dist/render3d/scene3d.d.ts.map +1 -1
  731. package/dist/render3d/scene3d.js +39 -6
  732. package/dist/render3d/scene3d.js.map +1 -1
  733. package/dist/render3d/segments.js.map +1 -1
  734. package/dist/render3d/texture.d.ts +9 -0
  735. package/dist/render3d/texture.d.ts.map +1 -1
  736. package/dist/render3d/texture.js +13 -0
  737. package/dist/render3d/texture.js.map +1 -1
  738. package/dist/render3d/tracking.js.map +1 -1
  739. package/dist/render3d/transform.d.ts +1 -1
  740. package/dist/render3d/transform.js.map +1 -1
  741. package/dist/render3d/vector3.d.ts +18 -1
  742. package/dist/render3d/vector3.d.ts.map +1 -1
  743. package/dist/render3d/vector3.js +27 -0
  744. package/dist/render3d/vector3.js.map +1 -1
  745. package/dist/render3d/walk.d.ts +1 -1
  746. package/dist/render3d/walk.d.ts.map +1 -1
  747. package/dist/render3d/walk.js +5 -1
  748. package/dist/render3d/walk.js.map +1 -1
  749. package/dist/runtime/asset-refine.js.map +1 -1
  750. package/dist/runtime/asset-timeline.js.map +1 -1
  751. package/dist/runtime/asset-update.js.map +1 -1
  752. package/dist/runtime/audio-index.js.map +1 -1
  753. package/dist/runtime/builtin-context.js.map +1 -1
  754. package/dist/runtime/clip-instance.d.ts +9 -4
  755. package/dist/runtime/clip-instance.d.ts.map +1 -1
  756. package/dist/runtime/clip-instance.js +27 -9
  757. package/dist/runtime/clip-instance.js.map +1 -1
  758. package/dist/runtime/clip-store.d.ts +18 -0
  759. package/dist/runtime/clip-store.d.ts.map +1 -1
  760. package/dist/runtime/clip-store.js +97 -0
  761. package/dist/runtime/clip-store.js.map +1 -1
  762. package/dist/runtime/engine.d.ts +5 -0
  763. package/dist/runtime/engine.d.ts.map +1 -1
  764. package/dist/runtime/engine.js +2 -0
  765. package/dist/runtime/engine.js.map +1 -1
  766. package/dist/runtime/frame-time.d.ts +31 -0
  767. package/dist/runtime/frame-time.d.ts.map +1 -0
  768. package/dist/runtime/frame-time.js +29 -0
  769. package/dist/runtime/frame-time.js.map +1 -0
  770. package/dist/runtime/index.d.ts +1 -0
  771. package/dist/runtime/index.d.ts.map +1 -1
  772. package/dist/runtime/index.js +1 -0
  773. package/dist/runtime/index.js.map +1 -1
  774. package/dist/runtime/node-picking.d.ts +44 -3
  775. package/dist/runtime/node-picking.d.ts.map +1 -1
  776. package/dist/runtime/node-picking.js +124 -10
  777. package/dist/runtime/node-picking.js.map +1 -1
  778. package/dist/runtime/node-picking3d.d.ts +13 -5
  779. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  780. package/dist/runtime/node-picking3d.js +10 -2
  781. package/dist/runtime/node-picking3d.js.map +1 -1
  782. package/dist/runtime/placement.d.ts.map +1 -1
  783. package/dist/runtime/placement.js +4 -5
  784. package/dist/runtime/placement.js.map +1 -1
  785. package/dist/runtime/playback-controller.d.ts +31 -2
  786. package/dist/runtime/playback-controller.d.ts.map +1 -1
  787. package/dist/runtime/playback-controller.js +63 -6
  788. package/dist/runtime/playback-controller.js.map +1 -1
  789. package/dist/runtime/playback.js.map +1 -1
  790. package/dist/runtime/precompisition.js.map +1 -1
  791. package/dist/runtime/project-assets.js.map +1 -1
  792. package/dist/runtime/session.d.ts +9 -7
  793. package/dist/runtime/session.d.ts.map +1 -1
  794. package/dist/runtime/session.js +12 -4
  795. package/dist/runtime/session.js.map +1 -1
  796. package/dist/runtime/settle.js.map +1 -1
  797. package/dist/runtime/state-evaluator.d.ts +1 -1
  798. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  799. package/dist/runtime/state-evaluator.js +4 -3
  800. package/dist/runtime/state-evaluator.js.map +1 -1
  801. package/dist/runtime/text-geometry.d.ts.map +1 -1
  802. package/dist/runtime/text-geometry.js +7 -3
  803. package/dist/runtime/text-geometry.js.map +1 -1
  804. package/dist/sdk/index.d.ts +50 -25
  805. package/dist/sdk/index.d.ts.map +1 -1
  806. package/dist/sdk/index.js +52 -42
  807. package/dist/sdk/index.js.map +1 -1
  808. package/dist/tween/command-decorator.d.ts +2 -0
  809. package/dist/tween/command-decorator.d.ts.map +1 -1
  810. package/dist/tween/command-decorator.js.map +1 -1
  811. package/dist/tween/command.d.ts +12 -0
  812. package/dist/tween/command.d.ts.map +1 -1
  813. package/dist/tween/command.js +14 -0
  814. package/dist/tween/command.js.map +1 -1
  815. package/dist/tween/ease/constants.d.ts.map +1 -1
  816. package/dist/tween/ease/constants.js +8 -5
  817. package/dist/tween/ease/constants.js.map +1 -1
  818. package/dist/tween/ease/curve.d.ts.map +1 -1
  819. package/dist/tween/ease/curve.js +4 -3
  820. package/dist/tween/ease/curve.js.map +1 -1
  821. package/dist/tween/ease/describe.d.ts +15 -0
  822. package/dist/tween/ease/describe.d.ts.map +1 -0
  823. package/dist/tween/ease/describe.js +37 -0
  824. package/dist/tween/ease/describe.js.map +1 -0
  825. package/dist/tween/ease/type.js.map +1 -1
  826. package/dist/tween/index.js.map +1 -1
  827. package/dist/tween/inert.js.map +1 -1
  828. package/dist/tween/lerp.js.map +1 -1
  829. package/dist/tween/loop.js.map +1 -1
  830. package/dist/tween/prepare.d.ts +3 -3
  831. package/dist/tween/prepare.js +3 -3
  832. package/dist/tween/prepare.js.map +1 -1
  833. package/dist/tween/seekable.d.ts +1 -1
  834. package/dist/tween/seekable.js.map +1 -1
  835. package/dist/tween/stepper.js.map +1 -1
  836. package/dist/tween/to-command.js.map +1 -1
  837. package/dist/util/clamp.js.map +1 -1
  838. package/dist/util/context.js.map +1 -1
  839. package/dist/util/csv.js.map +1 -1
  840. package/dist/util/generateList.js.map +1 -1
  841. package/dist/util/index.js.map +1 -1
  842. package/dist/util/metrics.d.ts +1 -1
  843. package/dist/util/metrics.js +1 -1
  844. package/dist/util/metrics.js.map +1 -1
  845. package/dist/util/random.js.map +1 -1
  846. package/dist/util/reference.js.map +1 -1
  847. package/dist/util/scheduler.js.map +1 -1
  848. package/package.json +7 -1
  849. package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
  850. package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
  851. package/dist/attributes/shape/effects/implementations/displace.js +0 -30
  852. package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
  853. package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
  854. package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
  855. package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
  856. package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
  857. package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
  858. package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
  859. package/dist/attributes/shape/effects/implementations/texture.js +0 -25
  860. package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
  861. package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
  862. package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
  863. package/dist/attributes/shape/effects/implementations/trails.js +0 -22
  864. package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
  865. package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
  866. package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
  867. package/dist/browser/chunks/chunk-KJXGRHOL.js +0 -3
  868. package/dist/browser/chunks/chunk-KJXGRHOL.js.map +0 -7
  869. package/dist/browser/chunks/chunk-TGDX2SS2.js +0 -18
  870. package/dist/browser/chunks/chunk-TGDX2SS2.js.map +0 -7
  871. package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
  872. package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
  873. package/dist/nodes/geometry/dot-grid-node.js +0 -142
  874. package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
  875. package/dist/nodes/geometry/grid-lines.d.ts +0 -101
  876. package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
  877. package/dist/nodes/geometry/grid-lines.js +0 -128
  878. package/dist/nodes/geometry/grid-lines.js.map +0 -1
  879. package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
  880. package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
  881. package/dist/nodes/geometry/grid-pattern-node.js +0 -172
  882. package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
  883. package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
  884. package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
  885. package/dist/nodes/geometry/line-grid-node.js +0 -127
  886. package/dist/nodes/geometry/line-grid-node.js.map +0 -1
  887. package/dist/nodes/geometry/line-node.d.ts +0 -58
  888. package/dist/nodes/geometry/line-node.d.ts.map +0 -1
  889. package/dist/nodes/geometry/line-node.js +0 -123
  890. package/dist/nodes/geometry/line-node.js.map +0 -1
  891. package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
  892. package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
  893. package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
  894. package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
  895. package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
  896. package/dist/nodes/scene/canvas2d-node.js.map +0 -1
  897. package/dist/nodes/scene/provider-node.d.ts.map +0 -1
  898. package/dist/nodes/scene/provider-node.js.map +0 -1
  899. package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
  900. package/dist/nodes/scene/theme-provider-node.js.map +0 -1
  901. /package/dist/nodes/{scene → root}/provider-node.d.ts +0 -0
  902. /package/dist/nodes/{scene → root}/provider-node.js +0 -0
  903. /package/dist/nodes/{scene → root}/theme-provider-node.d.ts +0 -0
  904. /package/dist/nodes/{scene → root}/theme-provider-node.js +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"grid-geometry3d.js","sourceRoot":"","sources":["../../../src/nodes/three/grid-geometry3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BufferGeometry3D } from \"@/render3d/geometry\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\n\nimport { resolveColor3D } from \"@/attributes/render3d/orbit\"\n\n/** How the ground plane is drawn — the fields the Canvas 3D's schema states. */\nexport interface Grid3DOptions {\n /** Total extent of the grid, in scene units. It spans `±size / 2` on both axes. */\n size: number\n /** How many cells across. One minor line per cell boundary. */\n divisions: number\n /** Every Nth minor line is drawn in {@link majorColor} instead. */\n majorEvery: number\n minorColor: Color\n majorColor: Color\n /** The line through `z = 0`. Red by convention, in every 3D tool there is. */\n axisXColor: Color\n /** The line through `x = 0`. Blue by the same convention. */\n axisZColor: Color\n /** Whether to draw the two axis lines at all. */\n showAxes: boolean\n /**\n * What the far edge fades into — the colour behind the grid.\n *\n * Fading is done by lerping each vertex's *colour* toward this rather than by\n * dropping its alpha, because a vertex colour is RGB and there is nowhere to\n * put a per-vertex alpha in the descriptor (see {@link BufferGeometry3D}). Over\n * an opaque background the two are indistinguishable, and this one costs no\n * blending and no sort order.\n *\n * A {@link Color} rather than a string, because it is read off the node's fill\n * stack now — see `Canvas3DView.fadeColor` — and a resolved paint holds its\n * colour as a normalized tuple.\n */\n fadeTo: Color\n /**\n * How much of the way to the edge the fade has finished, in `[0, 1]`.\n *\n * `0` disables it. Distance is measured radially from the origin rather than\n * per-axis, so the grid dissolves into a disc — which is what stops the four\n * corners from staying visible long after the edges have gone, and is why the\n * horizon in a viewport reads as a horizon rather than as a square table.\n */\n fade: number\n}\n\n/**\n * The ground plane, as one buffer of line segments.\n *\n * **One geometry, not three.** The minor lines, the major lines and the two axes\n * differ only in colour, and colour is a vertex attribute — so drawing them as\n * three ops with three materials would be three draw calls, three cache entries\n * and three chances for the sort order to put an axis under the grid it is\n * supposed to sit in. Baking the colour per vertex makes it one op with\n * `vertexColors: true` on a single unlit material, which is also the only way to\n * get the distance fade at all: it varies *along* each line, and a material's\n * colour is uniform across the primitive it paints.\n *\n * The returned arrays are freshly allocated, so the caller is expected to cache\n * them — see {@link Canvas3DView}, which does, and marks the result\n * `staticData` on the strength of it. Rebuilding this every frame would be\n * ~10k floats of allocation and a full re-upload for a picture that only changes\n * when somebody edits a field.\n */\nexport function gridGeometry3D(options: Grid3DOptions): BufferGeometry3D {\n const { size, divisions, majorEvery, showAxes, fade } = options\n\n const half = size / 2\n const step = size / divisions\n const minor = rgb(options.minorColor)\n const major = rgb(options.majorColor)\n const axisX = rgb(options.axisXColor)\n const axisZ = rgb(options.axisZColor)\n const fadeTo = rgb(options.fadeTo)\n\n const position: number[] = []\n const color: number[] = []\n\n /** One segment, with each end faded by its own distance from the origin. */\n const segment = (\n ax: number,\n az: number,\n bx: number,\n bz: number,\n tint: readonly [number, number, number]\n ): void => {\n // y is a hair above zero for the axes only — see the call sites. Everything\n // here is the same plane otherwise.\n position.push(ax, 0, az, bx, 0, bz)\n pushFaded(color, tint, fadeTo, fadeAt(ax, az, half, fade))\n pushFaded(color, tint, fadeTo, fadeAt(bx, bz, half, fade))\n }\n\n for (let i = 0; i <= divisions; i++) {\n const offset = -half + i * step\n // The index counted from the centre line, so \"every Nth\" is symmetrical\n // about the origin rather than about the grid's far corner — otherwise the\n // major lines drift off-centre on an odd division count.\n const fromCentre = Math.abs(i - divisions / 2)\n const isCentre = Math.abs(offset) < step / 2\n // The centre lines are the axes' own, so they are skipped here when the axes\n // are being drawn and left as ordinary major lines when they are not.\n if (isCentre && showAxes) continue\n\n const tint =\n Number.isInteger(fromCentre) && fromCentre % majorEvery === 0\n ? major\n : minor\n\n segment(offset, -half, offset, half, tint)\n segment(-half, offset, half, offset, tint)\n }\n\n if (showAxes) {\n // The X axis runs along x with z pinned at 0, and vice versa. Same plane as\n // the grid: they replace the two centre lines rather than sitting over them,\n // so there is nothing to z-fight with.\n segment(-half, 0, half, 0, axisX)\n segment(0, -half, 0, half, axisZ)\n }\n\n return {\n type: \"buffer\",\n position: new Float32Array(position),\n color: new Float32Array(color),\n // Nothing here is lit — a grid is emissive by nature — so there are no\n // normals to derive and asking for them would be a wasted pass.\n computeNormals: false,\n // True only because the caller caches: see this module's note.\n staticData: true,\n }\n}\n\n/**\n * How faded a point is, in `[0, 1]`, where 1 is fully the background.\n *\n * Squared falloff rather than linear, because a linear ramp over a plane seen at\n * a shallow angle reads as a hard edge — most of the ramp is compressed into the\n * last few pixels before the horizon. The square spends more of its range near\n * the camera, where the perspective is stretching it back out.\n */\nfunction fadeAt(\n x: number,\n z: number,\n half: number,\n fade: number\n): number {\n if (fade <= 0) return 0\n const distance = Math.hypot(x, z) / half\n const start = 1 - fade\n if (distance <= start) return 0\n const t = Math.min(1, (distance - start) / Math.max(fade, 1e-6))\n return t * t\n}\n\n/** Push one vertex colour, lerped `t` of the way from `tint` toward `fadeTo`. */\nfunction pushFaded(\n out: number[],\n tint: readonly [number, number, number],\n fadeTo: readonly [number, number, number],\n t: number\n): void {\n out.push(\n tint[0] + (fadeTo[0] - tint[0]) * t,\n tint[1] + (fadeTo[1] - tint[1]) * t,\n tint[2] + (fadeTo[2] - tint[2]) * t\n )\n}\n\n/**\n * A colour as the linear RGB triple a vertex attribute holds.\n *\n * `resolveColor3D` gives normalized sRGB; three reads vertex colours as\n * **linear**, so each channel is converted. Skipping this is the classic\n * washed-out-grid bug: an sRGB 0.16 uploaded as linear paints at about 0.4,\n * which is why a grid that should whisper ends up shouting.\n */\nfunction rgb(value: Color): [number, number, number] {\n const [r, g, b] = resolveColor3D(value)\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)]\n}\n\n/** The sRGB transfer function, inverted. three's own `SRGBToLinear`. */\nfunction srgbToLinear(channel: number): number {\n return channel < 0.04045\n ? channel * 0.0773993808\n : Math.pow(channel * 0.9478672986 + 0.0521327014, 2.4)\n}\n"]}
1
+ {"version":3,"file":"grid-geometry3d.js","sourceRoot":"","sources":["../../../src/nodes/three/grid-geometry3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BufferGeometry3D } from \"@/render3d/geometry\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\n\r\nimport { resolveColor3D } from \"@/attributes/render3d/orbit\"\r\n\r\n/** How the ground plane is drawn — the fields the Canvas 3D's schema states. */\r\nexport interface Grid3DOptions {\r\n /** Total extent of the grid, in scene units. It spans `±size / 2` on both axes. */\r\n size: number\r\n /** How many cells across. One minor line per cell boundary. */\r\n divisions: number\r\n /** Every Nth minor line is drawn in {@link majorColor} instead. */\r\n majorEvery: number\r\n minorColor: Color\r\n majorColor: Color\r\n /** The line through `z = 0`. Red by convention, in every 3D tool there is. */\r\n axisXColor: Color\r\n /** The line through `x = 0`. Blue by the same convention. */\r\n axisZColor: Color\r\n /** Whether to draw the two axis lines at all. */\r\n showAxes: boolean\r\n /**\r\n * What the far edge fades into — the colour behind the grid.\r\n *\r\n * Fading is done by lerping each vertex's *colour* toward this rather than by\r\n * dropping its alpha, because a vertex colour is RGB and there is nowhere to\r\n * put a per-vertex alpha in the descriptor (see {@link BufferGeometry3D}). Over\r\n * an opaque background the two are indistinguishable, and this one costs no\r\n * blending and no sort order.\r\n *\r\n * A {@link Color} rather than a string, because it is read off the node's fill\r\n * stack now — see `Canvas3DView.fadeColor` — and a resolved paint holds its\r\n * colour as a normalized tuple.\r\n */\r\n fadeTo: Color\r\n /**\r\n * How much of the way to the edge the fade has finished, in `[0, 1]`.\r\n *\r\n * `0` disables it. Distance is measured radially from the origin rather than\r\n * per-axis, so the grid dissolves into a disc — which is what stops the four\r\n * corners from staying visible long after the edges have gone, and is why the\r\n * horizon in a viewport reads as a horizon rather than as a square table.\r\n */\r\n fade: number\r\n}\r\n\r\n/**\r\n * The ground plane, as one buffer of line segments.\r\n *\r\n * **One geometry, not three.** The minor lines, the major lines and the two axes\r\n * differ only in colour, and colour is a vertex attribute — so drawing them as\r\n * three ops with three materials would be three draw calls, three cache entries\r\n * and three chances for the sort order to put an axis under the grid it is\r\n * supposed to sit in. Baking the colour per vertex makes it one op with\r\n * `vertexColors: true` on a single unlit material, which is also the only way to\r\n * get the distance fade at all: it varies *along* each line, and a material's\r\n * colour is uniform across the primitive it paints.\r\n *\r\n * The returned arrays are freshly allocated, so the caller is expected to cache\r\n * them — see {@link Canvas3DView}, which does, and marks the result\r\n * `staticData` on the strength of it. Rebuilding this every frame would be\r\n * ~10k floats of allocation and a full re-upload for a picture that only changes\r\n * when somebody edits a field.\r\n */\r\nexport function gridGeometry3D(options: Grid3DOptions): BufferGeometry3D {\r\n const { size, divisions, majorEvery, showAxes, fade } = options\r\n\r\n const half = size / 2\r\n const step = size / divisions\r\n const minor = rgb(options.minorColor)\r\n const major = rgb(options.majorColor)\r\n const axisX = rgb(options.axisXColor)\r\n const axisZ = rgb(options.axisZColor)\r\n const fadeTo = rgb(options.fadeTo)\r\n\r\n const position: number[] = []\r\n const color: number[] = []\r\n\r\n /** One segment, with each end faded by its own distance from the origin. */\r\n const segment = (\r\n ax: number,\r\n az: number,\r\n bx: number,\r\n bz: number,\r\n tint: readonly [number, number, number]\r\n ): void => {\r\n // y is a hair above zero for the axes only — see the call sites. Everything\r\n // here is the same plane otherwise.\r\n position.push(ax, 0, az, bx, 0, bz)\r\n pushFaded(color, tint, fadeTo, fadeAt(ax, az, half, fade))\r\n pushFaded(color, tint, fadeTo, fadeAt(bx, bz, half, fade))\r\n }\r\n\r\n for (let i = 0; i <= divisions; i++) {\r\n const offset = -half + i * step\r\n // The index counted from the centre line, so \"every Nth\" is symmetrical\r\n // about the origin rather than about the grid's far corner — otherwise the\r\n // major lines drift off-centre on an odd division count.\r\n const fromCentre = Math.abs(i - divisions / 2)\r\n const isCentre = Math.abs(offset) < step / 2\r\n // The centre lines are the axes' own, so they are skipped here when the axes\r\n // are being drawn and left as ordinary major lines when they are not.\r\n if (isCentre && showAxes) continue\r\n\r\n const tint =\r\n Number.isInteger(fromCentre) && fromCentre % majorEvery === 0\r\n ? major\r\n : minor\r\n\r\n segment(offset, -half, offset, half, tint)\r\n segment(-half, offset, half, offset, tint)\r\n }\r\n\r\n if (showAxes) {\r\n // The X axis runs along x with z pinned at 0, and vice versa. Same plane as\r\n // the grid: they replace the two centre lines rather than sitting over them,\r\n // so there is nothing to z-fight with.\r\n segment(-half, 0, half, 0, axisX)\r\n segment(0, -half, 0, half, axisZ)\r\n }\r\n\r\n return {\r\n type: \"buffer\",\r\n position: new Float32Array(position),\r\n color: new Float32Array(color),\r\n // Nothing here is lit — a grid is emissive by nature — so there are no\r\n // normals to derive and asking for them would be a wasted pass.\r\n computeNormals: false,\r\n // True only because the caller caches: see this module's note.\r\n staticData: true,\r\n }\r\n}\r\n\r\n/**\r\n * How faded a point is, in `[0, 1]`, where 1 is fully the background.\r\n *\r\n * Squared falloff rather than linear, because a linear ramp over a plane seen at\r\n * a shallow angle reads as a hard edge — most of the ramp is compressed into the\r\n * last few pixels before the horizon. The square spends more of its range near\r\n * the camera, where the perspective is stretching it back out.\r\n */\r\nfunction fadeAt(\r\n x: number,\r\n z: number,\r\n half: number,\r\n fade: number\r\n): number {\r\n if (fade <= 0) return 0\r\n const distance = Math.hypot(x, z) / half\r\n const start = 1 - fade\r\n if (distance <= start) return 0\r\n const t = Math.min(1, (distance - start) / Math.max(fade, 1e-6))\r\n return t * t\r\n}\r\n\r\n/** Push one vertex colour, lerped `t` of the way from `tint` toward `fadeTo`. */\r\nfunction pushFaded(\r\n out: number[],\r\n tint: readonly [number, number, number],\r\n fadeTo: readonly [number, number, number],\r\n t: number\r\n): void {\r\n out.push(\r\n tint[0] + (fadeTo[0] - tint[0]) * t,\r\n tint[1] + (fadeTo[1] - tint[1]) * t,\r\n tint[2] + (fadeTo[2] - tint[2]) * t\r\n )\r\n}\r\n\r\n/**\r\n * A colour as the linear RGB triple a vertex attribute holds.\r\n *\r\n * `resolveColor3D` gives normalized sRGB; three reads vertex colours as\r\n * **linear**, so each channel is converted. Skipping this is the classic\r\n * washed-out-grid bug: an sRGB 0.16 uploaded as linear paints at about 0.4,\r\n * which is why a grid that should whisper ends up shouting.\r\n */\r\nfunction rgb(value: Color): [number, number, number] {\r\n const [r, g, b] = resolveColor3D(value)\r\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)]\r\n}\r\n\r\n/** The sRGB transfer function, inverted. three's own `SRGBToLinear`. */\r\nfunction srgbToLinear(channel: number): number {\r\n return channel < 0.04045\r\n ? channel * 0.0773993808\r\n : Math.pow(channel * 0.9478672986 + 0.0521327014, 2.4)\r\n}\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"group3d.js","sourceRoot":"","sources":["../../../src/nodes/three/group3d.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,OAA+C,SAAQ,MAAS;CAAI","sourcesContent":["import type { Node3DProps } from \"./node3d\";\nimport { Node3D } from \"./node3d\";\n\nexport type Group3DProps = Node3DProps;\n\n/**\n * A transform with children and nothing of its own to draw — the 3D `<Rect>` that\n * only groups.\n *\n * Move, rotate or scale it and everything under it follows, which is what makes a\n * rig animatable as one thing:\n *\n * <Group3D ref={rig} position={[0, 1, 0]}>\n * <Box3D width={2} />\n * <Sphere3D radius={0.8} position={[3, 0, 0]} />\n * </Group3D>\n *\n * rig().to({ data: { rotation: [0, 360, 0] }, duration: 2 });\n *\n * `Node3D` already draws nothing by default, so this adds no behaviour — it\n * exists to be named for what it is at the call site.\n */\nexport class Group3D<P extends Group3DProps = Group3DProps> extends Node3D<P> { }\n"]}
1
+ {"version":3,"file":"group3d.js","sourceRoot":"","sources":["../../../src/nodes/three/group3d.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,OAA+C,SAAQ,MAAS;CAAI","sourcesContent":["import type { Node3DProps } from \"./node3d\";\r\nimport { Node3D } from \"./node3d\";\r\n\r\nexport type Group3DProps = Node3DProps;\r\n\r\n/**\r\n * A transform with children and nothing of its own to draw — the 3D `<Rect>` that\r\n * only groups.\r\n *\r\n * Move, rotate or scale it and everything under it follows, which is what makes a\r\n * rig animatable as one thing:\r\n *\r\n * <Group3D ref={rig} position={[0, 1, 0]}>\r\n * <Box3D width={2} />\r\n * <Sphere3D radius={0.8} position={[3, 0, 0]} />\r\n * </Group3D>\r\n *\r\n * rig().to({ data: { rotation: [0, 360, 0] }, duration: 2 });\r\n *\r\n * `Node3D` already draws nothing by default, so this adds no behaviour — it\r\n * exists to be named for what it is at the call site.\r\n */\r\nexport class Group3D<P extends Group3DProps = Group3DProps> extends Node3D<P> { }\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"light-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"light-nodes.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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"}
@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
5
5
  return c > 3 && r && Object.defineProperty(target, key, r), r;
6
6
  };
7
7
  import { property } from "../../attributes/properties/decorator.js";
8
- import { colorProperty } from "../../attributes/properties/typed.js";
8
+ import { colorProperty, optionalVector3Property } from "../../attributes/properties/typed.js";
9
9
  import { Node3D } from "./node3d.js";
10
10
  /**
11
11
  * A light's own parameters, gathered off the props that were actually set.
@@ -102,7 +102,7 @@ __decorate([
102
102
  property({ default: undefined })
103
103
  ], DirectionalLight3D.prototype, "intensity", void 0);
104
104
  __decorate([
105
- property({ default: undefined })
105
+ optionalVector3Property("origin")
106
106
  ], DirectionalLight3D.prototype, "target", void 0);
107
107
  const POINT_KEYS = ["color", "intensity", "distance", "decay", "shadow"];
108
108
  /** A bulb: light radiating from a point, falling off with distance. */
@@ -149,7 +149,7 @@ __decorate([
149
149
  property({ default: undefined })
150
150
  ], SpotLight3D.prototype, "decay", void 0);
151
151
  __decorate([
152
- property({ default: undefined })
152
+ optionalVector3Property("origin")
153
153
  ], SpotLight3D.prototype, "target", void 0);
154
154
  const AREA_KEYS = ["color", "intensity", "width", "height"];
155
155
  /** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */
@@ -1 +1 @@
1
- {"version":3,"file":"light-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport { colorProperty } from \"@/attributes/properties/typed\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type {\n AmbientLightData3D, AreaLightData3D, DirectionalLightData3D,\n HemisphereLightData3D, LightData3D, PointLightData3D, SpotLightData3D,\n} from \"@/render3d/light\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\n\nimport { Node3D, type Node3DProps } from \"./node3d\";\nimport type { NodeConfig } from \"@/nodes/node/node\";\n\n/**\n * The light nodes.\n *\n * A light is a thing in the scene with a position, so it is a `Node3D` like any\n * other — it can sit inside a `Group3D` and be carried by it, be held by a ref,\n * and have its `intensity` or `color` tweened:\n *\n * <DirectionalLight3D ref={key} intensity={2.4} position={[4, 6, 3]} shadow />\n * key().to({ data: { intensity: 0.2 }, duration: 1 });\n *\n * `AmbientLight3D` and `HemisphereLight3D` have no position — they light the\n * whole scene evenly — but are still nodes, so they read the same way in a tree.\n *\n * ── Intensity is one scale ────────────────────────────────────────────────────\n * A point or spot light's `intensity` means the same thing a directional light's\n * does: 1 is a normal light. three measures the first two in candela and the\n * third in lux, which is physically correct and is why scenes ended up written\n * with `intensity={2.4}` beside `intensity={40}`. The renderer converts.\n */\n\n/** Params of a light descriptor, minus its discriminant. */\n// `shadow` is dropped because `Node3DProps` already declares it, as the broader\n// `Shadow3D` a mesh also takes — one prop, one type, asked of both kinds of node.\ntype ParamsOf<L extends { type: string }> = Omit<L, \"type\" | \"shadow\">;\n\n/**\n * A light's own parameters, gathered off the props that were actually set.\n *\n * Omitted keys stay absent so the renderer's default applies, exactly as the\n * `Graphics3D` light sugar does.\n */\nfunction lightFrom(type: LightData3D[\"type\"], node: object, keys: readonly string[]): LightData3D {\n const out: Record<string, unknown> = { type };\n for (const key of keys) {\n const value = (node as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n return out as unknown as LightData3D;\n}\n\n/** Shared base: every light draws itself by declaring itself to the context. */\nabstract class Light3DNode<P extends Node3DProps> extends Node3D<P> {\n /** The descriptor this node contributes. */\n protected abstract buildLight(): LightData3D;\n\n /** Loads nothing — and recording `renderSelf` would make every light prop a dependency. */\n override declareAssets(): void { }\n\n protected override renderSelf(ctx: RenderContext3D): void {\n ctx.light(this.buildLight());\n }\n}\n\n/**\n * A light that can cast a shadow map.\n *\n * `shadow` is the {@link Shadow3D} every node carries, and it defaults to `true`\n * there because that is right for a *mesh* — turning shadows on should make\n * meshes cast and receive without tagging each one. A light is the other half of\n * that trade: every light casting is N shadow maps, and a point light's is six\n * faces. So the default is flipped here, in the constructor rather than by\n * redeclaring the prop, because the property registry keeps the base class's\n * metadata for a key and a subclass decorator would be silently ignored.\n */\nabstract class ShadowCastingLight3D<P extends Node3DProps> extends Light3DNode<P> {\n constructor(props?: NodeConfig<any, P>) {\n super(props);\n // Only when the author said nothing: an explicit `shadow` — including\n // `shadow={false}` — has already been written by `initProps`.\n if (props?.shadow === undefined) this.applyProp(\"shadow\", false);\n }\n}\n\n// ─── ambient ─────────────────────────────────────────────────────────────────\n\nexport interface AmbientLight3DProps extends Node3DProps, Partial<ParamsOf<AmbientLightData3D>> { }\n\nconst AMBIENT_KEYS = [\"color\", \"intensity\"] as const;\n\n/** Flat, directionless fill light. The cheapest way to stop shadows being black. */\nexport class AmbientLight3D<P extends AmbientLight3DProps = AmbientLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"ambient\", this, AMBIENT_KEYS);\n }\n}\n\n// ─── hemisphere ──────────────────────────────────────────────────────────────\n\nexport interface HemisphereLight3DProps extends Node3DProps, Partial<ParamsOf<HemisphereLightData3D>> { }\n\nconst HEMISPHERE_KEYS = [\"sky\", \"ground\", \"intensity\"] as const;\n\n/**\n * Sky-to-ground gradient fill — ambient light with a sense of up.\n *\n * The two colours are `sky` and `ground`. They were `color` and `groundColor`,\n * and the node's `color` was silently dropped: the descriptor and the renderer\n * both read `skyColor`, which nothing ever wrote.\n */\nexport class HemisphereLight3D<P extends HemisphereLight3DProps = HemisphereLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare sky: Color | undefined;\n @colorProperty({ default: undefined }) declare ground: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"hemisphere\", this, HEMISPHERE_KEYS);\n }\n}\n\n// ─── directional ─────────────────────────────────────────────────────────────\n\nexport interface DirectionalLight3DProps extends Node3DProps, Partial<ParamsOf<DirectionalLightData3D>> { }\n\nconst DIRECTIONAL_KEYS = [\"color\", \"intensity\", \"target\", \"shadow\"] as const;\n\n/**\n * Parallel rays from a direction — the sun. Its `position` sets the direction it\n * shines *from*, toward `target` (the origin by default).\n */\nexport class DirectionalLight3D<P extends DirectionalLight3DProps = DirectionalLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare target: DirectionalLightData3D[\"target\"];\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"directional\", this, DIRECTIONAL_KEYS);\n }\n}\n\n// ─── point ───────────────────────────────────────────────────────────────────\n\nexport interface PointLight3DProps extends Node3DProps, Partial<ParamsOf<PointLightData3D>> { }\n\nconst POINT_KEYS = [\"color\", \"intensity\", \"distance\", \"decay\", \"shadow\"] as const;\n\n/** A bulb: light radiating from a point, falling off with distance. */\nexport class PointLight3D<P extends PointLight3DProps = PointLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare distance: number | undefined;\n @property({ default: undefined }) declare decay: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"point\", this, POINT_KEYS);\n }\n}\n\n// ─── spot ────────────────────────────────────────────────────────────────────\n\nexport interface SpotLight3DProps extends Node3DProps, Partial<ParamsOf<SpotLightData3D>> { }\n\nconst SPOT_KEYS = [\"color\", \"intensity\", \"distance\", \"angle\", \"penumbra\", \"decay\", \"target\", \"shadow\"] as const;\n\n/** A cone of light. `angle` is the cone half-angle, in **degrees**. */\nexport class SpotLight3D<P extends SpotLight3DProps = SpotLight3DProps> extends ShadowCastingLight3D<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare distance: number | undefined;\n @property({ default: undefined }) declare angle: number | undefined;\n @property({ default: undefined }) declare penumbra: number | undefined;\n @property({ default: undefined }) declare decay: number | undefined;\n @property({ default: undefined }) declare target: SpotLightData3D[\"target\"];\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"spot\", this, SPOT_KEYS);\n }\n}\n\n// ─── area ────────────────────────────────────────────────────────────────────\n\nexport interface AreaLight3DProps extends Node3DProps, Partial<ParamsOf<AreaLightData3D>> { }\n\nconst AREA_KEYS = [\"color\", \"intensity\", \"width\", \"height\"] as const;\n\n/** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */\nexport class AreaLight3D<P extends AreaLight3DProps = AreaLight3DProps> extends Light3DNode<P> {\n @colorProperty({ default: undefined }) declare color: Color | undefined;\n @property({ default: undefined }) declare intensity: number | undefined;\n @property({ default: undefined }) declare width: number | undefined;\n @property({ default: undefined }) declare height: number | undefined;\n\n protected override buildLight(): LightData3D {\n return lightFrom(\"area\", this, AREA_KEYS);\n }\n}\n\n"]}
1
+ {"version":3,"file":"light-nodes.js","sourceRoot":"","sources":["../../../src/nodes/three/light-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { colorProperty, optionalVector3Property } from \"@/attributes/properties/typed\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n AmbientLightData3D, AreaLightData3D, DirectionalLightData3D,\r\n HemisphereLightData3D, LightData3D, PointLightData3D, SpotLightData3D,\r\n} from \"@/render3d/light\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\n\r\nimport { Node3D, type Node3DProps } from \"./node3d\";\r\nimport type { NodeConfig } from \"@/nodes/node/node\";\r\n\r\n/**\r\n * The light nodes.\r\n *\r\n * A light is a thing in the scene with a position, so it is a `Node3D` like any\r\n * other — it can sit inside a `Group3D` and be carried by it, be held by a ref,\r\n * and have its `intensity` or `color` tweened:\r\n *\r\n * <DirectionalLight3D ref={key} intensity={2.4} position={[4, 6, 3]} shadow />\r\n * key().to({ data: { intensity: 0.2 }, duration: 1 });\r\n *\r\n * `AmbientLight3D` and `HemisphereLight3D` have no position — they light the\r\n * whole scene evenly — but are still nodes, so they read the same way in a tree.\r\n *\r\n * ── Intensity is one scale ────────────────────────────────────────────────────\r\n * A point or spot light's `intensity` means the same thing a directional light's\r\n * does: 1 is a normal light. three measures the first two in candela and the\r\n * third in lux, which is physically correct and is why scenes ended up written\r\n * with `intensity={2.4}` beside `intensity={40}`. The renderer converts.\r\n */\r\n\r\n/** Params of a light descriptor, minus its discriminant. */\r\n// `shadow` is dropped because `Node3DProps` already declares it, as the broader\r\n// `Shadow3D` a mesh also takes — one prop, one type, asked of both kinds of node.\r\ntype ParamsOf<L extends { type: string }> = Omit<L, \"type\" | \"shadow\">;\r\n\r\n/**\r\n * A light's own parameters, gathered off the props that were actually set.\r\n *\r\n * Omitted keys stay absent so the renderer's default applies, exactly as the\r\n * `Graphics3D` light sugar does.\r\n */\r\nfunction lightFrom(type: LightData3D[\"type\"], node: object, keys: readonly string[]): LightData3D {\r\n const out: Record<string, unknown> = { type };\r\n for (const key of keys) {\r\n const value = (node as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n return out as unknown as LightData3D;\r\n}\r\n\r\n/** Shared base: every light draws itself by declaring itself to the context. */\r\nabstract class Light3DNode<P extends Node3DProps> extends Node3D<P> {\r\n /** The descriptor this node contributes. */\r\n protected abstract buildLight(): LightData3D;\r\n\r\n /** Loads nothing — and recording `renderSelf` would make every light prop a dependency. */\r\n override declareAssets(): void { }\r\n\r\n protected override renderSelf(ctx: RenderContext3D): void {\r\n ctx.light(this.buildLight());\r\n }\r\n}\r\n\r\n/**\r\n * A light that can cast a shadow map.\r\n *\r\n * `shadow` is the {@link Shadow3D} every node carries, and it defaults to `true`\r\n * there because that is right for a *mesh* — turning shadows on should make\r\n * meshes cast and receive without tagging each one. A light is the other half of\r\n * that trade: every light casting is N shadow maps, and a point light's is six\r\n * faces. So the default is flipped here, in the constructor rather than by\r\n * redeclaring the prop, because the property registry keeps the base class's\r\n * metadata for a key and a subclass decorator would be silently ignored.\r\n */\r\nabstract class ShadowCastingLight3D<P extends Node3DProps> extends Light3DNode<P> {\r\n constructor(props?: NodeConfig<any, P>) {\r\n super(props);\r\n // Only when the author said nothing: an explicit `shadow` — including\r\n // `shadow={false}` — has already been written by `initProps`.\r\n if (props?.shadow === undefined) this.applyProp(\"shadow\", false);\r\n }\r\n}\r\n\r\n// ─── ambient ─────────────────────────────────────────────────────────────────\r\n\r\nexport interface AmbientLight3DProps extends Node3DProps, Partial<ParamsOf<AmbientLightData3D>> { }\r\n\r\nconst AMBIENT_KEYS = [\"color\", \"intensity\"] as const;\r\n\r\n/** Flat, directionless fill light. The cheapest way to stop shadows being black. */\r\nexport class AmbientLight3D<P extends AmbientLight3DProps = AmbientLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"ambient\", this, AMBIENT_KEYS);\r\n }\r\n}\r\n\r\n// ─── hemisphere ──────────────────────────────────────────────────────────────\r\n\r\nexport interface HemisphereLight3DProps extends Node3DProps, Partial<ParamsOf<HemisphereLightData3D>> { }\r\n\r\nconst HEMISPHERE_KEYS = [\"sky\", \"ground\", \"intensity\"] as const;\r\n\r\n/**\r\n * Sky-to-ground gradient fill — ambient light with a sense of up.\r\n *\r\n * The two colours are `sky` and `ground`. They were `color` and `groundColor`,\r\n * and the node's `color` was silently dropped: the descriptor and the renderer\r\n * both read `skyColor`, which nothing ever wrote.\r\n */\r\nexport class HemisphereLight3D<P extends HemisphereLight3DProps = HemisphereLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare sky: Color | undefined;\r\n @colorProperty({ default: undefined }) declare ground: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"hemisphere\", this, HEMISPHERE_KEYS);\r\n }\r\n}\r\n\r\n// ─── directional ─────────────────────────────────────────────────────────────\r\n\r\nexport interface DirectionalLight3DProps extends Node3DProps, Partial<ParamsOf<DirectionalLightData3D>> { }\r\n\r\nconst DIRECTIONAL_KEYS = [\"color\", \"intensity\", \"target\", \"shadow\"] as const;\r\n\r\n/**\r\n * Parallel rays from a direction — the sun. Its `position` sets the direction it\r\n * shines *from*, toward `target` (the origin by default).\r\n */\r\nexport class DirectionalLight3D<P extends DirectionalLight3DProps = DirectionalLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @optionalVector3Property(\"origin\") declare target: DirectionalLightData3D[\"target\"];\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"directional\", this, DIRECTIONAL_KEYS);\r\n }\r\n}\r\n\r\n// ─── point ───────────────────────────────────────────────────────────────────\r\n\r\nexport interface PointLight3DProps extends Node3DProps, Partial<ParamsOf<PointLightData3D>> { }\r\n\r\nconst POINT_KEYS = [\"color\", \"intensity\", \"distance\", \"decay\", \"shadow\"] as const;\r\n\r\n/** A bulb: light radiating from a point, falling off with distance. */\r\nexport class PointLight3D<P extends PointLight3DProps = PointLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare distance: number | undefined;\r\n @property({ default: undefined }) declare decay: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"point\", this, POINT_KEYS);\r\n }\r\n}\r\n\r\n// ─── spot ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface SpotLight3DProps extends Node3DProps, Partial<ParamsOf<SpotLightData3D>> { }\r\n\r\nconst SPOT_KEYS = [\"color\", \"intensity\", \"distance\", \"angle\", \"penumbra\", \"decay\", \"target\", \"shadow\"] as const;\r\n\r\n/** A cone of light. `angle` is the cone half-angle, in **degrees**. */\r\nexport class SpotLight3D<P extends SpotLight3DProps = SpotLight3DProps> extends ShadowCastingLight3D<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare distance: number | undefined;\r\n @property({ default: undefined }) declare angle: number | undefined;\r\n @property({ default: undefined }) declare penumbra: number | undefined;\r\n @property({ default: undefined }) declare decay: number | undefined;\r\n @optionalVector3Property(\"origin\") declare target: SpotLightData3D[\"target\"];\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"spot\", this, SPOT_KEYS);\r\n }\r\n}\r\n\r\n// ─── area ────────────────────────────────────────────────────────────────────\r\n\r\nexport interface AreaLight3DProps extends Node3DProps, Partial<ParamsOf<AreaLightData3D>> { }\r\n\r\nconst AREA_KEYS = [\"color\", \"intensity\", \"width\", \"height\"] as const;\r\n\r\n/** A glowing rectangle — a softbox. Lights `standard`/`physical` materials only. */\r\nexport class AreaLight3D<P extends AreaLight3DProps = AreaLight3DProps> extends Light3DNode<P> {\r\n @colorProperty({ default: undefined }) declare color: Color | undefined;\r\n @property({ default: undefined }) declare intensity: number | undefined;\r\n @property({ default: undefined }) declare width: number | undefined;\r\n @property({ default: undefined }) declare height: number | undefined;\r\n\r\n protected override buildLight(): LightData3D {\r\n return lightFrom(\"area\", this, AREA_KEYS);\r\n }\r\n}\r\n\r\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"mesh3d.js","sourceRoot":"","sources":["../../../src/nodes/three/mesh3d.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAA4B,MAAM,uBAAuB,CAAC;AACzG,OAAO,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAM5D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AAgDpD,gFAAgF;AAChF,MAAM,kBAAkB,GAAG;IACvB,SAAS,EAAE,WAAW,EAAE,WAAW;IACnC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc;IAC3D,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW;IACnE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO;CACrC,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,MAA4C,SAAQ,MAAS;IAuBtE;;;;;;OAMG;IACO,aAAa;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACO,iBAAiB;QACvB,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,KAAK,GAAI,IAA2C,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;QACjC,OAAO,GAA0B,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACO,eAAe;QACrB,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,QAAQ;YAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACtF,OAAO,EAAE,CAAC;IACd,CAAC;IAEkB,UAAU,CAAC,GAAoB;QAC9C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACrC,CAAC;CACJ;AAtE6C;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;wCAA8B;AACrB;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;wCAAkE;AAExC;IAA1D,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;oCAAsB;AAC9B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;uCAAqC;AAC5B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;yCAAuC;AAC9B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;yCAAuC;AACzB;IAA9C,aAAa,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;wCAAqC;AACjC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;gDAA8C;AACrC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;yCAA0C;AACjC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;4CAA6C;AACpC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;4CAA6C;AACpC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAsC;AAC7B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;wCAAyC;AAChC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;+CAA6C;AACpC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;yCAAwC;AAC/B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;uCAAwC;AAC/B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAoC;AAC3B;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;4CAA2C;AAClC;IAAzC,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;qCAAoC;AAC/B;IAArC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;qCAAwB","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport { colorProperty } from \"@/attributes/properties/typed\";\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport { Graphics3D, resolveMaterialShorthand3D, type MaterialShorthand3D } from \"@/render3d/graphics3d\";\nimport { lerpFill3D, type Fill3D } from \"@/render3d/fill3d\";\nimport type { Geometry3D } from \"@/render3d/geometry\";\nimport type { Material3D, Shading3D } from \"@/render3d/material\";\nimport type { Texture3D } from \"@/render3d/texture\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\nimport type { Blend3D, Faces3D } from \"@/render3d/transform\";\nimport { Node3D, type Node3DProps } from \"./node3d\";\n\n/**\n * The material shorthand, as node props.\n *\n * Exactly the keys {@link MaterialShorthand3D} promotes onto the `Graphics3D`\n * sugar methods, so `<Box3D fill=\"red\" roughness={0.3} />` and\n * `g3.box({ fill: \"red\", roughness: 0.3 })` describe the same mesh — and each is\n * a real prop here, so any of them can be tweened.\n *\n * Ten props, where there were twenty-four. What went is everything that was a\n * renderer knob rather than a design decision — `depthWrite`, `depthTest`,\n * `alphaTest`, `toneMapped`, `polygonOffset`, `dithering` — which now live only\n * on a `Mat.*` descriptor passed through {@link material}; plus `transparent`,\n * which is derived; plus five texture slots, which are fills.\n */\nexport interface Material3DProps {\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\n material: Material3D | readonly Material3D[] | undefined;\n /** What the surface is made of — the same value a 2D `fill` takes. */\n fill: Fill3D;\n opacity: number;\n roughness: number;\n metalness: number;\n emission: Color | undefined;\n emissionStrength: number;\n normalMap: Texture3D | undefined;\n roughnessMap: Texture3D | undefined;\n metalnessMap: Texture3D | undefined;\n aoMap: Texture3D | undefined;\n alphaMap: Texture3D | undefined;\n envMapIntensity: number;\n wireframe: boolean;\n /** Facet or smooth shading. Default `\"smooth\"`. */\n shading: Shading3D;\n /** Which faces to rasterize. Default `\"front\"`. */\n faces: Faces3D;\n vertexColors: boolean;\n blend: Blend3D;\n /** Shade with an unlit `basic` material instead of `standard`. */\n unlit: boolean;\n}\n\nexport interface Mesh3DProps extends Node3DProps, Partial<Material3DProps> {\n /** The geometry to draw. Set directly, or by a geometry subclass's props. */\n geometry: Geometry3D;\n}\n\n/** The shorthand keys, in the order they are copied onto a built descriptor. */\nconst MATERIAL_PROP_KEYS = [\n \"opacity\", \"roughness\", \"metalness\",\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\n] as const;\n\n/**\n * A drawable 3D object — geometry plus a material.\n *\n * The 3D counterpart of {@link ShapeNode}: it owns the material vocabulary, and\n * the geometry sugar nodes ({@link Box3D}, {@link Sphere3D}, …) subclass it to\n * supply a geometry from their own props.\n *\n * <Mesh3D geometry={Geo.torusKnot({ radius: 1.2 })} fill=\"tomato\" roughness={0.2} />\n * <Box3D fill={[\"#1a1a2e\", Fills.linearGradient([\"#e0533d\", \"#8b5cf6\"])]} />\n *\n * Every material key is a prop, so `mesh().to({ data: { roughness: 1, fill: \"cyan\" }, duration: 1 })`\n * animates in place — three writes the values onto the live material rather than\n * recompiling. Geometry *parameters* are the exception: three geometries are\n * immutable, so tweening a `radius` reallocates the mesh every frame. Tween\n * `scale` (or `scaleX`/`scaleY`/`scaleZ`) instead.\n */\nexport class Mesh3D<P extends Mesh3DProps = Mesh3DProps> extends Node3D<P> {\n @property({ default: undefined }) declare geometry: Geometry3D;\n @property({ default: undefined }) declare material: Material3D | readonly Material3D[] | undefined;\n\n @property({ default: \"white\", tween: lerpFill3D }) declare fill: Fill3D;\n @property({ default: undefined }) declare opacity: number | undefined;\n @property({ default: undefined }) declare roughness: number | undefined;\n @property({ default: undefined }) declare metalness: number | undefined;\n @colorProperty({ default: undefined }) declare emission: Color | undefined;\n @property({ default: undefined }) declare emissionStrength: number | undefined;\n @property({ default: undefined }) declare normalMap: Texture3D | undefined;\n @property({ default: undefined }) declare roughnessMap: Texture3D | undefined;\n @property({ default: undefined }) declare metalnessMap: Texture3D | undefined;\n @property({ default: undefined }) declare aoMap: Texture3D | undefined;\n @property({ default: undefined }) declare alphaMap: Texture3D | undefined;\n @property({ default: undefined }) declare envMapIntensity: number | undefined;\n @property({ default: undefined }) declare wireframe: boolean | undefined;\n @property({ default: undefined }) declare shading: Shading3D | undefined;\n @property({ default: undefined }) declare faces: Faces3D | undefined;\n @property({ default: undefined }) declare vertexColors: boolean | undefined;\n @property({ default: undefined }) declare blend: Blend3D | undefined;\n @property({ default: false }) declare unlit: boolean;\n\n /**\n * The geometry this node draws.\n *\n * Overridden by each sugar subclass to build one from its own props; the base\n * returns the `geometry` prop, so `<Mesh3D geometry={Geo.lathe(...)} />` works\n * for anything the sugar doesn't cover.\n */\n protected buildGeometry(): Geometry3D | undefined {\n return this.geometry;\n }\n\n /**\n * The material shorthand, gathered off the props that were actually set.\n *\n * `undefined` defaults are deliberate: an omitted key must stay absent from\n * the descriptor so `Graphics3D` picks the renderer's own default, rather than\n * being pinned to a value this node invented.\n */\n protected materialShorthand(): MaterialShorthand3D {\n const out: Record<string, unknown> = {};\n const material = this.material;\n if (material !== undefined) out.material = material;\n if (this.fill !== undefined) out.fill = this.fill;\n for (const key of MATERIAL_PROP_KEYS) {\n const value = (this as unknown as Record<string, unknown>)[key];\n if (value !== undefined) out[key] = value;\n }\n if (this.unlit) out.unlit = true;\n return out as MaterialShorthand3D;\n }\n\n /**\n * What this node draws this frame.\n *\n * The single seam both the real render and the asset-declaration pass go\n * through — the same discipline as `Rect.shapeGraphics()` — so the textures\n * that get loaded can never drift from the ones that get drawn.\n */\n protected buildGraphics3D(): Graphics3D {\n const g3 = new Graphics3D();\n const geometry = this.buildGeometry();\n if (geometry) g3.mesh(geometry, resolveMaterialShorthand3D(this.materialShorthand()));\n return g3;\n }\n\n protected override renderSelf(ctx: RenderContext3D): void {\n ctx.draw(this.buildGraphics3D());\n }\n}\n\n"]}
1
+ {"version":3,"file":"mesh3d.js","sourceRoot":"","sources":["../../../src/nodes/three/mesh3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { colorProperty } from \"@/attributes/properties/typed\";\r\nimport type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport { Graphics3D, resolveMaterialShorthand3D, type MaterialShorthand3D } from \"@/render3d/graphics3d\";\r\nimport { lerpFill3D, type Fill3D } from \"@/render3d/fill3d\";\r\nimport type { Geometry3D } from \"@/render3d/geometry\";\r\nimport type { Material3D, Shading3D } from \"@/render3d/material\";\r\nimport type { Texture3D } from \"@/render3d/texture\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\nimport type { Blend3D, Faces3D } from \"@/render3d/transform\";\r\nimport { Node3D, type Node3DProps } from \"./node3d\";\r\n\r\n/**\r\n * The material shorthand, as node props.\r\n *\r\n * Exactly the keys {@link MaterialShorthand3D} promotes onto the `Graphics3D`\r\n * sugar methods, so `<Box3D fill=\"red\" roughness={0.3} />` and\r\n * `g3.box({ fill: \"red\", roughness: 0.3 })` describe the same mesh — and each is\r\n * a real prop here, so any of them can be tweened.\r\n *\r\n * Ten props, where there were twenty-four. What went is everything that was a\r\n * renderer knob rather than a design decision — `depthWrite`, `depthTest`,\r\n * `alphaTest`, `toneMapped`, `polygonOffset`, `dithering` — which now live only\r\n * on a `Mat.*` descriptor passed through {@link material}; plus `transparent`,\r\n * which is derived; plus five texture slots, which are fills.\r\n */\r\nexport interface Material3DProps {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material: Material3D | readonly Material3D[] | undefined;\r\n /** What the surface is made of — the same value a 2D `fill` takes. */\r\n fill: Fill3D;\r\n opacity: number;\r\n roughness: number;\r\n metalness: number;\r\n emission: Color | undefined;\r\n emissionStrength: number;\r\n normalMap: Texture3D | undefined;\r\n roughnessMap: Texture3D | undefined;\r\n metalnessMap: Texture3D | undefined;\r\n aoMap: Texture3D | undefined;\r\n alphaMap: Texture3D | undefined;\r\n envMapIntensity: number;\r\n wireframe: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces: Faces3D;\r\n vertexColors: boolean;\r\n blend: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit: boolean;\r\n}\r\n\r\nexport interface Mesh3DProps extends Node3DProps, Partial<Material3DProps> {\r\n /** The geometry to draw. Set directly, or by a geometry subclass's props. */\r\n geometry: Geometry3D;\r\n}\r\n\r\n/** The shorthand keys, in the order they are copied onto a built descriptor. */\r\nconst MATERIAL_PROP_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/**\r\n * A drawable 3D object — geometry plus a material.\r\n *\r\n * The 3D counterpart of {@link ShapeNode}: it owns the material vocabulary, and\r\n * the geometry sugar nodes ({@link Box3D}, {@link Sphere3D}, …) subclass it to\r\n * supply a geometry from their own props.\r\n *\r\n * <Mesh3D geometry={Geo.torusKnot({ radius: 1.2 })} fill=\"tomato\" roughness={0.2} />\r\n * <Box3D fill={[\"#1a1a2e\", Fills.linearGradient([\"#e0533d\", \"#8b5cf6\"])]} />\r\n *\r\n * Every material key is a prop, so `mesh().to({ data: { roughness: 1, fill: \"cyan\" }, duration: 1 })`\r\n * animates in place — three writes the values onto the live material rather than\r\n * recompiling. Geometry *parameters* are the exception: three geometries are\r\n * immutable, so tweening a `radius` reallocates the mesh every frame. Tween\r\n * `scale` (or `scaleX`/`scaleY`/`scaleZ`) instead.\r\n */\r\nexport class Mesh3D<P extends Mesh3DProps = Mesh3DProps> extends Node3D<P> {\r\n @property({ default: undefined }) declare geometry: Geometry3D;\r\n @property({ default: undefined }) declare material: Material3D | readonly Material3D[] | undefined;\r\n\r\n @property({ default: \"white\", tween: lerpFill3D }) declare fill: Fill3D;\r\n @property({ default: undefined }) declare opacity: number | undefined;\r\n @property({ default: undefined }) declare roughness: number | undefined;\r\n @property({ default: undefined }) declare metalness: number | undefined;\r\n @colorProperty({ default: undefined }) declare emission: Color | undefined;\r\n @property({ default: undefined }) declare emissionStrength: number | undefined;\r\n @property({ default: undefined }) declare normalMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare roughnessMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare metalnessMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare aoMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare alphaMap: Texture3D | undefined;\r\n @property({ default: undefined }) declare envMapIntensity: number | undefined;\r\n @property({ default: undefined }) declare wireframe: boolean | undefined;\r\n @property({ default: undefined }) declare shading: Shading3D | undefined;\r\n @property({ default: undefined }) declare faces: Faces3D | undefined;\r\n @property({ default: undefined }) declare vertexColors: boolean | undefined;\r\n @property({ default: undefined }) declare blend: Blend3D | undefined;\r\n @property({ default: false }) declare unlit: boolean;\r\n\r\n /**\r\n * The geometry this node draws.\r\n *\r\n * Overridden by each sugar subclass to build one from its own props; the base\r\n * returns the `geometry` prop, so `<Mesh3D geometry={Geo.lathe(...)} />` works\r\n * for anything the sugar doesn't cover.\r\n */\r\n protected buildGeometry(): Geometry3D | undefined {\r\n return this.geometry;\r\n }\r\n\r\n /**\r\n * The material shorthand, gathered off the props that were actually set.\r\n *\r\n * `undefined` defaults are deliberate: an omitted key must stay absent from\r\n * the descriptor so `Graphics3D` picks the renderer's own default, rather than\r\n * being pinned to a value this node invented.\r\n */\r\n protected materialShorthand(): MaterialShorthand3D {\r\n const out: Record<string, unknown> = {};\r\n const material = this.material;\r\n if (material !== undefined) out.material = material;\r\n if (this.fill !== undefined) out.fill = this.fill;\r\n for (const key of MATERIAL_PROP_KEYS) {\r\n const value = (this as unknown as Record<string, unknown>)[key];\r\n if (value !== undefined) out[key] = value;\r\n }\r\n if (this.unlit) out.unlit = true;\r\n return out as MaterialShorthand3D;\r\n }\r\n\r\n /**\r\n * What this node draws this frame.\r\n *\r\n * The single seam both the real render and the asset-declaration pass go\r\n * through — the same discipline as `Rect.shapeGraphics()` — so the textures\r\n * that get loaded can never drift from the ones that get drawn.\r\n */\r\n protected buildGraphics3D(): Graphics3D {\r\n const g3 = new Graphics3D();\r\n const geometry = this.buildGeometry();\r\n if (geometry) g3.mesh(geometry, resolveMaterialShorthand3D(this.materialShorthand()));\r\n return g3;\r\n }\r\n\r\n protected override renderSelf(ctx: RenderContext3D): void {\r\n ctx.draw(this.buildGraphics3D());\r\n }\r\n}\r\n\r\n"]}
@@ -3,6 +3,7 @@ import type { RenderContext3D } from "../../render3d/render-context3d.js";
3
3
  import type { AssetScope } from "../../assets/scope.js";
4
4
  import type { Shadow3D, Transform3D } from "../../render3d/transform.js";
5
5
  import { Node, type NodeConfig, type NodeDimension, type NodeProps } from "../../nodes/node/node.js";
6
+ import type { Command, CommandArgs } from "../../tween/command.js";
6
7
  import type { EasingFunction } from "../../tween/ease/type.js";
7
8
  import type { TweenStepper } from "../../tween/stepper.js";
8
9
  export interface Node3DProps extends NodeProps {
@@ -48,6 +49,22 @@ export interface Node3DProps extends NodeProps {
48
49
  /** Draw-order override, for tuning transparent sorting. */
49
50
  renderOrder: number;
50
51
  }
52
+ /**
53
+ * A 3D parent's own coordinates for where its children sit: the units of a
54
+ * graph, say. Position only, as a `ChildPlane` is in 2D: a child keeps its
55
+ * size, turn and scale. Answered by the parent ({@link Node3D._spaceOf}, or
56
+ * `Canvas3D._spaceOf` for a child of the viewport itself).
57
+ */
58
+ export interface ChildSpace3D {
59
+ /** A child's `x`/`y`/`z` as a point in the parent's local space. */
60
+ toLocal(x: number, y: number, z: number): Vector3;
61
+ }
62
+ /**
63
+ * The coordinates `node`'s parent places it by, or `null` when they are the
64
+ * parent's local space. The parent may be a 3D node or the viewport holding it.
65
+ */
66
+ /** @internal */
67
+ export declare function parentSpaceOf(node: Node3D): ChildSpace3D | null;
51
68
  /**
52
69
  * A thing in 3D space — the root of the 3D scene graph.
53
70
  *
@@ -109,6 +126,31 @@ export declare class Node3D<P extends Node3DProps = Node3DProps> extends Node<P>
109
126
  shadow: Shadow3D;
110
127
  renderOrder: number;
111
128
  constructor(props?: NodeConfig<any, P>);
129
+ /** Animate the position, whichever axes are given; the rest stay where they are. */
130
+ moveTo(args: CommandArgs<{
131
+ x?: number;
132
+ y?: number;
133
+ z?: number;
134
+ }> & {
135
+ duration: number;
136
+ }): Command<P>;
137
+ /** Animate the Euler rotation, in degrees, whichever axes are given. */
138
+ rotateTo(args: CommandArgs<{
139
+ rotationX?: number;
140
+ rotationY?: number;
141
+ rotationZ?: number;
142
+ }> & {
143
+ duration: number;
144
+ }): Command<P>;
145
+ /** Animate the scale: `scale` on every axis, and any axis given beside it on that one. */
146
+ scaleTo(args: CommandArgs<{
147
+ scale?: number;
148
+ scaleX?: number;
149
+ scaleY?: number;
150
+ scaleZ?: number;
151
+ }> & {
152
+ duration: number;
153
+ }): Command<P>;
112
154
  /** This node's position, composed from the axis props. */
113
155
  get position(): Vector3;
114
156
  set position(value: Vector3Input);
@@ -147,6 +189,12 @@ export declare class Node3D<P extends Node3DProps = Node3DProps> extends Node<P>
147
189
  * make `rotation` silently do nothing.
148
190
  */
149
191
  protected transform3D(): Transform3D;
192
+ /**
193
+ * The coordinates `child`'s `x`/`y`/`z` are in, or `null` (the default) when
194
+ * they are this node's local space. A `null` child is one not here yet.
195
+ */
196
+ /** @internal */
197
+ _spaceOf(_child: Node3D | null): ChildSpace3D | null;
150
198
  /**
151
199
  * The transform that goes on this node's *group* — the scope its children
152
200
  * nest inside. Defaults to this node's own placement, which is right for
@@ -1 +1 @@
1
- {"version":3,"file":"node3d.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"node3d.d.ts","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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"}
@@ -5,11 +5,21 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
5
5
  return c > 3 && r && Object.defineProperty(target, key, r), r;
6
6
  };
7
7
  import { property } from "../../attributes/properties/decorator.js";
8
- import { quaternionProperty } from "../../attributes/properties/typed.js";
8
+ import { optionalVector3Property, quaternionProperty } from "../../attributes/properties/typed.js";
9
9
  import { resolveVector3, } from "../../render3d/vector3.js";
10
10
  import { Scene3D } from "../../render3d/scene3d.js";
11
11
  import { declare3DResources } from "../../render3d/tracking.js";
12
12
  import { Node } from "../../nodes/node/node.js";
13
+ import { command } from "../../tween/command-decorator.js";
14
+ /**
15
+ * The coordinates `node`'s parent places it by, or `null` when they are the
16
+ * parent's local space. The parent may be a 3D node or the viewport holding it.
17
+ */
18
+ /** @internal */
19
+ export function parentSpaceOf(node) {
20
+ const parent = node.parent;
21
+ return typeof parent?._spaceOf === "function" ? parent._spaceOf(node) : null;
22
+ }
13
23
  /** The three axis props each vector prop distributes into, in order. */
14
24
  const VECTOR_SUGAR = {
15
25
  position: ["x", "y", "z"],
@@ -68,6 +78,18 @@ export class Node3D extends Node {
68
78
  this.initProps(distributeVectors(props));
69
79
  this.adoptChildrenProp(props);
70
80
  }
81
+ /** Animate the position, whichever axes are given; the rest stay where they are. */
82
+ moveTo(args) {
83
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
84
+ }
85
+ /** Animate the Euler rotation, in degrees, whichever axes are given. */
86
+ rotateTo(args) {
87
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
88
+ }
89
+ /** Animate the scale: `scale` on every axis, and any axis given beside it on that one. */
90
+ scaleTo(args) {
91
+ return this.to({ data: stated(args.data), duration: args.duration, easing: args.easing });
92
+ }
71
93
  /** This node's position, composed from the axis props. */
72
94
  get position() {
73
95
  return { x: this.x, y: this.y, z: this.z };
@@ -122,8 +144,9 @@ export class Node3D extends Node {
122
144
  transform3D() {
123
145
  const quaternion = this.quaternion;
124
146
  const identityQuaternion = quaternion.x === 0 && quaternion.y === 0 && quaternion.z === 0 && quaternion.w === 1;
147
+ const space = parentSpaceOf(this);
125
148
  return {
126
- position: this.position,
149
+ position: space ? space.toLocal(this.x, this.y, this.z) : this.position,
127
150
  rotation: this.rotation,
128
151
  quaternion: identityQuaternion ? undefined : quaternion,
129
152
  scale: this.scale,
@@ -133,6 +156,14 @@ export class Node3D extends Node {
133
156
  renderOrder: this.renderOrder,
134
157
  };
135
158
  }
159
+ /**
160
+ * The coordinates `child`'s `x`/`y`/`z` are in, or `null` (the default) when
161
+ * they are this node's local space. A `null` child is one not here yet.
162
+ */
163
+ /** @internal */
164
+ _spaceOf(_child) {
165
+ return null;
166
+ }
136
167
  /**
137
168
  * The transform that goes on this node's *group* — the scope its children
138
169
  * nest inside. Defaults to this node's own placement, which is right for
@@ -225,7 +256,7 @@ __decorate([
225
256
  property({ default: 1 })
226
257
  ], Node3D.prototype, "scaleZ", void 0);
227
258
  __decorate([
228
- property({ default: undefined })
259
+ optionalVector3Property("snap")
229
260
  ], Node3D.prototype, "lookAt", void 0);
230
261
  __decorate([
231
262
  property({ default: true })
@@ -236,6 +267,17 @@ __decorate([
236
267
  __decorate([
237
268
  property({ default: 0 })
238
269
  ], Node3D.prototype, "renderOrder", void 0);
270
+ __decorate([
271
+ command({ args: ["x", "y", "z"] })
272
+ ], Node3D.prototype, "moveTo", null);
273
+ __decorate([
274
+ command({ args: ["rotationX", "rotationY", "rotationZ"] })
275
+ ], Node3D.prototype, "rotateTo", null);
276
+ __decorate([
277
+ command({
278
+ args: [{ key: "scale", kind: "number", min: 0, step: 0.05, unit: "×" }, "scaleX", "scaleY", "scaleZ"],
279
+ })
280
+ ], Node3D.prototype, "scaleTo", null);
239
281
  /**
240
282
  * Expand `position`/`rotation`/`scale` in a prop bag into their axis props.
241
283
  *
@@ -281,6 +323,14 @@ function distributeVectors(props) {
281
323
  }
282
324
  return out ?? props;
283
325
  }
326
+ /** `data` without the keys left unstated, so a tween never aims an axis at `undefined`. */
327
+ function stated(data) {
328
+ const out = {};
329
+ for (const key in data)
330
+ if (data[key] !== undefined)
331
+ out[key] = data[key];
332
+ return out;
333
+ }
284
334
  function componentOf(vector, index) {
285
335
  return index === 0 ? vector.x : index === 1 ? vector.y : vector.z;
286
336
  }
@@ -1 +1 @@
1
- {"version":3,"file":"node3d.js","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\nimport { quaternionProperty } from \"@/attributes/properties/typed\";\nimport {\n resolveVector3,\n type Euler3, type EulerOrder, type Quaternion, type Vector3, type Vector3Input,\n} from \"@/render3d/vector3\";\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\nimport { Scene3D } from \"@/render3d/scene3d\";\nimport { declare3DResources } from \"@/render3d/tracking\";\nimport type { AssetScope } from \"@/assets/scope\";\nimport type { Shadow3D, Transform3D } from \"@/render3d/transform\";\nimport { Node, type NodeConfig, type NodeDimension, type NodeProps } from \"@/nodes/node/node\";\nimport type { EasingFunction } from \"@/tween/ease/type\";\nimport type { TweenStepper } from \"@/tween/stepper\";\n\nexport interface Node3DProps extends NodeProps {\n /** Position in the parent's local space. A scalar sets all three axes. */\n position: Vector3Input;\n /** Position on one axis. The same names 2D uses, one dimension over. */\n x: number;\n y: number;\n z: number;\n /**\n * Euler rotation in **degrees**, matching 2D `rotation`. Ignored when\n * {@link quaternion} is set.\n */\n rotation: Vector3Input | Euler3;\n /** Rotation about one axis, in **degrees**. Same names as 2D's. */\n rotationX: number;\n rotationY: number;\n rotationZ: number;\n /** The order the Euler axes are applied in. Default `\"XYZ\"`. */\n rotationOrder: EulerOrder;\n /**\n * Rotation as a unit quaternion. Wins over {@link rotation} — use it for\n * tumbles where Euler interpolation would gimbal.\n */\n quaternion: Quaternion;\n /** Per-axis scale; a scalar scales uniformly. Default 1. */\n scale: Vector3Input;\n scaleX: number;\n scaleY: number;\n scaleZ: number;\n /**\n * World-space point to orient toward, applied after {@link position}. Wins\n * over both {@link rotation} and {@link quaternion}.\n */\n lookAt: Vector3Input | undefined;\n /** Hide without removing — the cached renderer object stays alive. */\n visible: boolean;\n /**\n * Shadow participation. Default `true`, so turning shadows on for the scene\n * turns them on. Pass `false` to opt out, or `\"cast\"`/`\"receive\"` for one half.\n */\n shadow: Shadow3D;\n /** Draw-order override, for tuning transparent sorting. */\n renderOrder: number;\n}\n\n/** The three axis props each vector prop distributes into, in order. */\nconst VECTOR_SUGAR: Readonly<Record<string, readonly [string, string, string]>> = {\n position: [\"x\", \"y\", \"z\"],\n rotation: [\"rotationX\", \"rotationY\", \"rotationZ\"],\n scale: [\"scaleX\", \"scaleY\", \"scaleZ\"],\n};\n\n/**\n * A thing in 3D space — the root of the 3D scene graph.\n *\n * The sibling of {@link Node2D}: same tree, same props, same `to()`/`set()`/\n * `save()`/`restore()`, same refs, context and per-node clock, all inherited from\n * {@link Node}. What differs is the only thing that genuinely differs between the\n * two — how a node is placed and how it draws. There is no `width`, no `padding`,\n * no anchor and no flex here, because none of them mean anything for a mesh; a 3D\n * node's whole placement is its transform.\n *\n * <Canvas3D>\n * <Camera3D orbit={30} elevation={18} distance={6} />\n * <AmbientLight3D intensity={0.4} />\n * <Group3D ref={rig}>\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" />\n * </Group3D>\n * </Canvas3D>\n *\n * rig().to({ data: { rotationY: 360, y: 1 }, duration: 2 });\n *\n * ── Axes are scalars, and vectors are sugar over them ─────────────────────────\n * `x`, `y`, `z`, `rotationX/Y/Z` and `scaleX/Y/Z` are the real props, and they\n * are named exactly what 2D names them. `position`, `rotation` and `scale` are\n * distributed into those three, the way `Node2D` already distributes `size` into\n * `width`/`height` — so both spellings tween identically and there is one source\n * of truth for where a node is. That is what makes `to({ y: 3 })` work: with a\n * single vector prop it would have had nothing to interpolate on the other two\n * axes, which is exactly the trap that made every 3D scene restate coordinates it\n * did not mean to change.\n *\n * A `Node3D` only ever lives under a `Canvas3D` — the one node that holds both\n * dimensions. Parenting one to a `Rect` throws rather than silently drawing\n * nothing (see {@link Node.acceptsChild}).\n *\n * To write your own, override {@link renderSelf} and hand a `Graphics3D` to the\n * context — the exact shape of a custom 2D node's `renderSelf`:\n *\n * class Blob3D extends Node3D {\n * protected override renderSelf(ctx: RenderContext3D): void {\n * ctx.draw(new Graphics3D().sphere({ radius: 1, fill: \"red\" }));\n * }\n * }\n */\nexport class Node3D<P extends Node3DProps = Node3DProps> extends Node<P> {\n get dimension(): NodeDimension { return \"3d\"; }\n\n @property({ default: 0 }) declare x: number;\n @property({ default: 0 }) declare y: number;\n @property({ default: 0 }) declare z: number;\n\n @property({ default: 0 }) declare rotationX: number;\n @property({ default: 0 }) declare rotationY: number;\n @property({ default: 0 }) declare rotationZ: number;\n @property({ default: \"XYZ\" }) declare rotationOrder: EulerOrder;\n\n @quaternionProperty() declare quaternion: Quaternion;\n\n @property({ default: 1 }) declare scaleX: number;\n @property({ default: 1 }) declare scaleY: number;\n @property({ default: 1 }) declare scaleZ: number;\n\n @property({ default: undefined }) declare lookAt: Vector3Input | undefined;\n @property({ default: true }) declare visible: boolean;\n @property({ default: true }) declare shadow: Shadow3D;\n @property({ default: 0 }) declare renderOrder: number;\n\n constructor(props?: NodeConfig<any, P>) {\n super(props);\n // Distributed before `initProps`, which only ever applies keys that are\n // registered props — a `position` left in the bag would be dropped.\n this.initProps(distributeVectors(props) as NodeConfig<any, P>);\n this.adoptChildrenProp(props);\n }\n\n /** This node's position, composed from the axis props. */\n get position(): Vector3 {\n return { x: this.x, y: this.y, z: this.z };\n }\n set position(value: Vector3Input) {\n this.set({ position: value } as never);\n }\n\n /** This node's Euler rotation in degrees, composed from the axis props. */\n get rotation(): Euler3 {\n return { x: this.rotationX, y: this.rotationY, z: this.rotationZ, order: this.rotationOrder };\n }\n set rotation(value: Vector3Input | Euler3) {\n this.set({ rotation: value } as never);\n }\n\n /** This node's scale, composed from the axis props. */\n get scale(): Vector3 {\n return { x: this.scaleX, y: this.scaleY, z: this.scaleZ };\n }\n set scale(value: Vector3Input) {\n this.set({ scale: value } as never);\n }\n\n /**\n * Distribute the vector sugar into axis props, then write as usual.\n *\n * Same shape as `Node2D.set`'s handling of `size`, and for the same reason:\n * `position` has no slot of its own, so it has to become three writes\n * before the generic loop runs. An explicitly stated axis in the same call\n * wins over the vector, which is what lets `{ position: p, y: 0 }` mean what\n * it reads like.\n */\n override set(props: { [K in keyof P]?: P[K] | (() => P[K]) }): void {\n super.set(distributeVectors(props) as typeof props);\n }\n\n /**\n * The tween half of the same rule. Expanded here rather than in the command\n * so `to({ position: [...] })` and `to({ x, y, z })` produce identical\n * steppers — one interpolating path, whichever way it was written.\n */\n override _prepareStep(to: Partial<P>, duration: number, easing?: EasingFunction): TweenStepper {\n return super._prepareStep(distributeVectors(to) as Partial<P>, duration, easing);\n }\n\n /**\n * This node's placement, as the renderer's own vocabulary.\n *\n * Sampled fresh every frame from the prop slots, so a tween moves the object\n * without anything here caching state between frames.\n *\n * `quaternion` is only emitted when it has been set away from identity: it\n * wins over `rotation` in a {@link Transform3D}, so always sending it would\n * make `rotation` silently do nothing.\n */\n protected transform3D(): Transform3D {\n const quaternion = this.quaternion as unknown as Quaternion;\n const identityQuaternion =\n quaternion.x === 0 && quaternion.y === 0 && quaternion.z === 0 && quaternion.w === 1;\n return {\n position: this.position,\n rotation: this.rotation,\n quaternion: identityQuaternion ? undefined : quaternion,\n scale: this.scale,\n lookAt: this.lookAt,\n visible: this.visible,\n shadow: this.shadow,\n renderOrder: this.renderOrder,\n };\n }\n\n /**\n * The transform that goes on this node's *group* — the scope its children\n * nest inside. Defaults to this node's own placement, which is right for\n * everything that lives at its own origin.\n *\n * A camera overrides it to identity and places itself instead: three aims a\n * camera's -Z at `lookAt` but a plain group's +Z, so hanging a camera's\n * placement on its group would point the shot backwards.\n */\n protected groupTransform(): Transform3D {\n return this.transform3D();\n }\n\n /**\n * Draw this node's own contribution to the scene — a `ctx.draw(graphics3D)`\n * for something with geometry, a `ctx.light(...)` for a light, nothing at all\n * for a plain {@link Group3D}. Children are recorded after it, nested inside\n * this node's transform.\n */\n protected renderSelf(ctx: RenderContext3D): void { }\n\n /**\n * Record this node and its subtree into `ctx`.\n *\n * An invisible node still opens its scope: `visible: false` is a renderer-side\n * flag on a live object rather than a removal, which is what lets a node be\n * hidden and shown again without its GPU resources being rebuilt. Skipping the\n * walk here would instead sweep the whole subtree out of the cache.\n */\n render(ctx: RenderContext3D): void {\n // The editor's flag folds into `visible` rather than adding a second one:\n // the 3D side already has exactly this concept, honoured by the picking\n // walk, and two flags meaning \"do not show this\" would be two places to\n // ask. Still opens its scope — see the note above on why an invisible\n // node keeps its cached renderer object.\n if (this.hidden) {\n ctx.begin({ id: this.id, transform: { ...this.groupTransform(), visible: false } });\n ctx.end();\n return;\n }\n ctx.begin({ id: this.id, transform: this.groupTransform() });\n this.renderSelf(ctx);\n for (const child of this._children) {\n if (child instanceof Node3D) child.render(ctx);\n }\n ctx.end();\n }\n\n /**\n * What {@link renderSelf} records, never {@link render}: the placement lives on\n * the group scope, so moving a node does not change what it declares.\n */\n declareAssets(assets: AssetScope): void {\n if (this.renderSelf === Node3D.prototype.renderSelf) return;\n const scene = new Scene3D();\n this.renderSelf(scene);\n declare3DResources(scene, assets);\n }\n}\n\n/**\n * Expand `position`/`rotation`/`scale` in a prop bag into their axis props.\n *\n * Returns the bag untouched when it names none of them, so the common write path\n * allocates nothing. A **binding** expands into three bindings that each resolve\n * the vector and take one component — so `position={() => lift()}` stays a\n * binding, and one thunk driving all three axes is still read once per axis per\n * frame rather than being frozen at bind time.\n */\nfunction distributeVectors<T extends object>(props: T | undefined): T | undefined {\n if (!props) return props;\n\n let out: Record<string, unknown> | undefined;\n\n for (const key in VECTOR_SUGAR) {\n const value = (props as Record<string, unknown>)[key];\n if (value === undefined) continue;\n\n out ??= { ...(props as Record<string, unknown>) };\n delete out[key];\n\n const axes = VECTOR_SUGAR[key];\n\n if (typeof value === \"function\") {\n const read = value as () => Vector3Input;\n for (let i = 0; i < 3; i++) {\n const axis = axes[i];\n if (out[axis] !== undefined) continue;\n out[axis] = () => componentOf(resolveVector3(read()), i);\n }\n continue;\n }\n\n const vector = resolveVector3(value as Vector3Input);\n for (let i = 0; i < 3; i++) {\n const axis = axes[i];\n if (out[axis] === undefined) out[axis] = componentOf(vector, i);\n }\n\n // `order` rides on an Euler and has nowhere else to go.\n if (key === \"rotation\") {\n const order = (value as Euler3).order;\n if (order !== undefined && out.rotationOrder === undefined) out.rotationOrder = order;\n }\n }\n\n return (out as T) ?? props;\n}\n\nfunction componentOf(vector: Vector3, index: number): number {\n return index === 0 ? vector.x : index === 1 ? vector.y : vector.z;\n}\n"]}
1
+ {"version":3,"file":"node3d.js","sourceRoot":"","sources":["../../../src/nodes/three/node3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { property } from \"@/attributes/properties/decorator\";\r\nimport { optionalVector3Property, quaternionProperty } from \"@/attributes/properties/typed\";\r\nimport {\r\n resolveVector3,\r\n type Euler3, type EulerOrder, type Quaternion, type Vector3, type Vector3Input,\r\n} from \"@/render3d/vector3\";\r\nimport type { RenderContext3D } from \"@/render3d/render-context3d\";\r\nimport { Scene3D } from \"@/render3d/scene3d\";\r\nimport { declare3DResources } from \"@/render3d/tracking\";\r\nimport type { AssetScope } from \"@/assets/scope\";\r\nimport type { Shadow3D, Transform3D } from \"@/render3d/transform\";\r\nimport { Node, type NodeConfig, type NodeDimension, type NodeProps } from \"@/nodes/node/node\";\r\nimport type { Command, CommandArgs } from \"@/tween/command\";\r\nimport { command } from \"@/tween/command-decorator\";\r\nimport type { EasingFunction } from \"@/tween/ease/type\";\r\nimport type { TweenStepper } from \"@/tween/stepper\";\r\n\r\nexport interface Node3DProps extends NodeProps {\r\n /** Position in the parent's local space. A scalar sets all three axes. */\r\n position: Vector3Input;\r\n /** Position on one axis. The same names 2D uses, one dimension over. */\r\n x: number;\r\n y: number;\r\n z: number;\r\n /**\r\n * Euler rotation in **degrees**, matching 2D `rotation`. Ignored when\r\n * {@link quaternion} is set.\r\n */\r\n rotation: Vector3Input | Euler3;\r\n /** Rotation about one axis, in **degrees**. Same names as 2D's. */\r\n rotationX: number;\r\n rotationY: number;\r\n rotationZ: number;\r\n /** The order the Euler axes are applied in. Default `\"XYZ\"`. */\r\n rotationOrder: EulerOrder;\r\n /**\r\n * Rotation as a unit quaternion. Wins over {@link rotation} — use it for\r\n * tumbles where Euler interpolation would gimbal.\r\n */\r\n quaternion: Quaternion;\r\n /** Per-axis scale; a scalar scales uniformly. Default 1. */\r\n scale: Vector3Input;\r\n scaleX: number;\r\n scaleY: number;\r\n scaleZ: number;\r\n /**\r\n * World-space point to orient toward, applied after {@link position}. Wins\r\n * over both {@link rotation} and {@link quaternion}.\r\n */\r\n lookAt: Vector3Input | undefined;\r\n /** Hide without removing — the cached renderer object stays alive. */\r\n visible: boolean;\r\n /**\r\n * Shadow participation. Default `true`, so turning shadows on for the scene\r\n * turns them on. Pass `false` to opt out, or `\"cast\"`/`\"receive\"` for one half.\r\n */\r\n shadow: Shadow3D;\r\n /** Draw-order override, for tuning transparent sorting. */\r\n renderOrder: number;\r\n}\r\n\r\n/**\r\n * A 3D parent's own coordinates for where its children sit: the units of a\r\n * graph, say. Position only, as a `ChildPlane` is in 2D: a child keeps its\r\n * size, turn and scale. Answered by the parent ({@link Node3D._spaceOf}, or\r\n * `Canvas3D._spaceOf` for a child of the viewport itself).\r\n */\r\nexport interface ChildSpace3D {\r\n /** A child's `x`/`y`/`z` as a point in the parent's local space. */\r\n toLocal(x: number, y: number, z: number): Vector3;\r\n}\r\n\r\n/** A parent that may place its 3D children in coordinates of its own: a `Node3D`, or a 3D viewport. */\r\ninterface SpaceHolder3D {\r\n _spaceOf(child: Node3D | null): ChildSpace3D | null;\r\n}\r\n\r\n/**\r\n * The coordinates `node`'s parent places it by, or `null` when they are the\r\n * parent's local space. The parent may be a 3D node or the viewport holding it.\r\n */\r\n/** @internal */\r\nexport function parentSpaceOf(node: Node3D): ChildSpace3D | null {\r\n const parent = node.parent as Partial<SpaceHolder3D> | null;\r\n return typeof parent?._spaceOf === \"function\" ? parent._spaceOf(node) : null;\r\n}\r\n\r\n/** The three axis props each vector prop distributes into, in order. */\r\nconst VECTOR_SUGAR: Readonly<Record<string, readonly [string, string, string]>> = {\r\n position: [\"x\", \"y\", \"z\"],\r\n rotation: [\"rotationX\", \"rotationY\", \"rotationZ\"],\r\n scale: [\"scaleX\", \"scaleY\", \"scaleZ\"],\r\n};\r\n\r\n/**\r\n * A thing in 3D space — the root of the 3D scene graph.\r\n *\r\n * The sibling of {@link Node2D}: same tree, same props, same `to()`/`set()`/\r\n * `save()`/`restore()`, same refs, context and per-node clock, all inherited from\r\n * {@link Node}. What differs is the only thing that genuinely differs between the\r\n * two — how a node is placed and how it draws. There is no `width`, no `padding`,\r\n * no anchor and no flex here, because none of them mean anything for a mesh; a 3D\r\n * node's whole placement is its transform.\r\n *\r\n * <Canvas3D>\r\n * <Camera3D orbit={30} elevation={18} distance={6} />\r\n * <AmbientLight3D intensity={0.4} />\r\n * <Group3D ref={rig}>\r\n * <Box3D width={2} cornerRadius={0.15} fill=\"tomato\" />\r\n * </Group3D>\r\n * </Canvas3D>\r\n *\r\n * rig().to({ data: { rotationY: 360, y: 1 }, duration: 2 });\r\n *\r\n * ── Axes are scalars, and vectors are sugar over them ─────────────────────────\r\n * `x`, `y`, `z`, `rotationX/Y/Z` and `scaleX/Y/Z` are the real props, and they\r\n * are named exactly what 2D names them. `position`, `rotation` and `scale` are\r\n * distributed into those three, the way `Node2D` already distributes `size` into\r\n * `width`/`height` — so both spellings tween identically and there is one source\r\n * of truth for where a node is. That is what makes `to({ y: 3 })` work: with a\r\n * single vector prop it would have had nothing to interpolate on the other two\r\n * axes, which is exactly the trap that made every 3D scene restate coordinates it\r\n * did not mean to change.\r\n *\r\n * A `Node3D` only ever lives under a `Canvas3D` — the one node that holds both\r\n * dimensions. Parenting one to a `Rect` throws rather than silently drawing\r\n * nothing (see {@link Node.acceptsChild}).\r\n *\r\n * To write your own, override {@link renderSelf} and hand a `Graphics3D` to the\r\n * context — the exact shape of a custom 2D node's `renderSelf`:\r\n *\r\n * class Blob3D extends Node3D {\r\n * protected override renderSelf(ctx: RenderContext3D): void {\r\n * ctx.draw(new Graphics3D().sphere({ radius: 1, fill: \"red\" }));\r\n * }\r\n * }\r\n */\r\nexport class Node3D<P extends Node3DProps = Node3DProps> extends Node<P> {\r\n get dimension(): NodeDimension { return \"3d\"; }\r\n\r\n @property({ default: 0 }) declare x: number;\r\n @property({ default: 0 }) declare y: number;\r\n @property({ default: 0 }) declare z: number;\r\n\r\n @property({ default: 0 }) declare rotationX: number;\r\n @property({ default: 0 }) declare rotationY: number;\r\n @property({ default: 0 }) declare rotationZ: number;\r\n @property({ default: \"XYZ\" }) declare rotationOrder: EulerOrder;\r\n\r\n @quaternionProperty() declare quaternion: Quaternion;\r\n\r\n @property({ default: 1 }) declare scaleX: number;\r\n @property({ default: 1 }) declare scaleY: number;\r\n @property({ default: 1 }) declare scaleZ: number;\r\n\r\n @optionalVector3Property(\"snap\") declare lookAt: Vector3Input | undefined;\r\n @property({ default: true }) declare visible: boolean;\r\n @property({ default: true }) declare shadow: Shadow3D;\r\n @property({ default: 0 }) declare renderOrder: number;\r\n\r\n constructor(props?: NodeConfig<any, P>) {\r\n super(props);\r\n // Distributed before `initProps`, which only ever applies keys that are\r\n // registered props — a `position` left in the bag would be dropped.\r\n this.initProps(distributeVectors(props) as NodeConfig<any, P>);\r\n this.adoptChildrenProp(props);\r\n }\r\n\r\n /** Animate the position, whichever axes are given; the rest stay where they are. */\r\n @command({ args: [\"x\", \"y\", \"z\"] })\r\n moveTo(args: CommandArgs<{ x?: number; y?: number; z?: number }> & { duration: number }): Command<P> {\r\n return this.to({ data: stated(args.data) as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /** Animate the Euler rotation, in degrees, whichever axes are given. */\r\n @command({ args: [\"rotationX\", \"rotationY\", \"rotationZ\"] })\r\n rotateTo(\r\n args: CommandArgs<{ rotationX?: number; rotationY?: number; rotationZ?: number }> & { duration: number },\r\n ): Command<P> {\r\n return this.to({ data: stated(args.data) as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /** Animate the scale: `scale` on every axis, and any axis given beside it on that one. */\r\n @command({\r\n args: [{ key: \"scale\", kind: \"number\", min: 0, step: 0.05, unit: \"×\" }, \"scaleX\", \"scaleY\", \"scaleZ\"],\r\n })\r\n scaleTo(\r\n args: CommandArgs<{ scale?: number; scaleX?: number; scaleY?: number; scaleZ?: number }> & { duration: number },\r\n ): Command<P> {\r\n return this.to({ data: stated(args.data) as Partial<P>, duration: args.duration, easing: args.easing });\r\n }\r\n\r\n /** This node's position, composed from the axis props. */\r\n get position(): Vector3 {\r\n return { x: this.x, y: this.y, z: this.z };\r\n }\r\n set position(value: Vector3Input) {\r\n this.set({ position: value } as never);\r\n }\r\n\r\n /** This node's Euler rotation in degrees, composed from the axis props. */\r\n get rotation(): Euler3 {\r\n return { x: this.rotationX, y: this.rotationY, z: this.rotationZ, order: this.rotationOrder };\r\n }\r\n set rotation(value: Vector3Input | Euler3) {\r\n this.set({ rotation: value } as never);\r\n }\r\n\r\n /** This node's scale, composed from the axis props. */\r\n get scale(): Vector3 {\r\n return { x: this.scaleX, y: this.scaleY, z: this.scaleZ };\r\n }\r\n set scale(value: Vector3Input) {\r\n this.set({ scale: value } as never);\r\n }\r\n\r\n /**\r\n * Distribute the vector sugar into axis props, then write as usual.\r\n *\r\n * Same shape as `Node2D.set`'s handling of `size`, and for the same reason:\r\n * `position` has no slot of its own, so it has to become three writes\r\n * before the generic loop runs. An explicitly stated axis in the same call\r\n * wins over the vector, which is what lets `{ position: p, y: 0 }` mean what\r\n * it reads like.\r\n */\r\n override set(props: { [K in keyof P]?: P[K] | (() => P[K]) }): void {\r\n super.set(distributeVectors(props) as typeof props);\r\n }\r\n\r\n /**\r\n * The tween half of the same rule. Expanded here rather than in the command\r\n * so `to({ position: [...] })` and `to({ x, y, z })` produce identical\r\n * steppers — one interpolating path, whichever way it was written.\r\n */\r\n override _prepareStep(to: Partial<P>, duration: number, easing?: EasingFunction): TweenStepper {\r\n return super._prepareStep(distributeVectors(to) as Partial<P>, duration, easing);\r\n }\r\n\r\n /**\r\n * This node's placement, as the renderer's own vocabulary.\r\n *\r\n * Sampled fresh every frame from the prop slots, so a tween moves the object\r\n * without anything here caching state between frames.\r\n *\r\n * `quaternion` is only emitted when it has been set away from identity: it\r\n * wins over `rotation` in a {@link Transform3D}, so always sending it would\r\n * make `rotation` silently do nothing.\r\n */\r\n protected transform3D(): Transform3D {\r\n const quaternion = this.quaternion as unknown as Quaternion;\r\n const identityQuaternion =\r\n quaternion.x === 0 && quaternion.y === 0 && quaternion.z === 0 && quaternion.w === 1;\r\n const space = parentSpaceOf(this);\r\n return {\r\n position: space ? space.toLocal(this.x, this.y, this.z) : this.position,\r\n rotation: this.rotation,\r\n quaternion: identityQuaternion ? undefined : quaternion,\r\n scale: this.scale,\r\n lookAt: this.lookAt,\r\n visible: this.visible,\r\n shadow: this.shadow,\r\n renderOrder: this.renderOrder,\r\n };\r\n }\r\n\r\n /**\r\n * The coordinates `child`'s `x`/`y`/`z` are in, or `null` (the default) when\r\n * they are this node's local space. A `null` child is one not here yet.\r\n */\r\n /** @internal */\r\n _spaceOf(_child: Node3D | null): ChildSpace3D | null {\r\n return null;\r\n }\r\n\r\n /**\r\n * The transform that goes on this node's *group* — the scope its children\r\n * nest inside. Defaults to this node's own placement, which is right for\r\n * everything that lives at its own origin.\r\n *\r\n * A camera overrides it to identity and places itself instead: three aims a\r\n * camera's -Z at `lookAt` but a plain group's +Z, so hanging a camera's\r\n * placement on its group would point the shot backwards.\r\n */\r\n protected groupTransform(): Transform3D {\r\n return this.transform3D();\r\n }\r\n\r\n /**\r\n * Draw this node's own contribution to the scene — a `ctx.draw(graphics3D)`\r\n * for something with geometry, a `ctx.light(...)` for a light, nothing at all\r\n * for a plain {@link Group3D}. Children are recorded after it, nested inside\r\n * this node's transform.\r\n */\r\n protected renderSelf(ctx: RenderContext3D): void { }\r\n\r\n /**\r\n * Record this node and its subtree into `ctx`.\r\n *\r\n * An invisible node still opens its scope: `visible: false` is a renderer-side\r\n * flag on a live object rather than a removal, which is what lets a node be\r\n * hidden and shown again without its GPU resources being rebuilt. Skipping the\r\n * walk here would instead sweep the whole subtree out of the cache.\r\n */\r\n render(ctx: RenderContext3D): void {\r\n // The editor's flag folds into `visible` rather than adding a second one:\r\n // the 3D side already has exactly this concept, honoured by the picking\r\n // walk, and two flags meaning \"do not show this\" would be two places to\r\n // ask. Still opens its scope — see the note above on why an invisible\r\n // node keeps its cached renderer object.\r\n if (this.hidden) {\r\n ctx.begin({ id: this.id, transform: { ...this.groupTransform(), visible: false } });\r\n ctx.end();\r\n return;\r\n }\r\n ctx.begin({ id: this.id, transform: this.groupTransform() });\r\n this.renderSelf(ctx);\r\n for (const child of this._children) {\r\n if (child instanceof Node3D) child.render(ctx);\r\n }\r\n ctx.end();\r\n }\r\n\r\n /**\r\n * What {@link renderSelf} records, never {@link render}: the placement lives on\r\n * the group scope, so moving a node does not change what it declares.\r\n */\r\n declareAssets(assets: AssetScope): void {\r\n if (this.renderSelf === Node3D.prototype.renderSelf) return;\r\n const scene = new Scene3D();\r\n this.renderSelf(scene);\r\n declare3DResources(scene, assets);\r\n }\r\n}\r\n\r\n/**\r\n * Expand `position`/`rotation`/`scale` in a prop bag into their axis props.\r\n *\r\n * Returns the bag untouched when it names none of them, so the common write path\r\n * allocates nothing. A **binding** expands into three bindings that each resolve\r\n * the vector and take one component — so `position={() => lift()}` stays a\r\n * binding, and one thunk driving all three axes is still read once per axis per\r\n * frame rather than being frozen at bind time.\r\n */\r\nfunction distributeVectors<T extends object>(props: T | undefined): T | undefined {\r\n if (!props) return props;\r\n\r\n let out: Record<string, unknown> | undefined;\r\n\r\n for (const key in VECTOR_SUGAR) {\r\n const value = (props as Record<string, unknown>)[key];\r\n if (value === undefined) continue;\r\n\r\n out ??= { ...(props as Record<string, unknown>) };\r\n delete out[key];\r\n\r\n const axes = VECTOR_SUGAR[key];\r\n\r\n if (typeof value === \"function\") {\r\n const read = value as () => Vector3Input;\r\n for (let i = 0; i < 3; i++) {\r\n const axis = axes[i];\r\n if (out[axis] !== undefined) continue;\r\n out[axis] = () => componentOf(resolveVector3(read()), i);\r\n }\r\n continue;\r\n }\r\n\r\n const vector = resolveVector3(value as Vector3Input);\r\n for (let i = 0; i < 3; i++) {\r\n const axis = axes[i];\r\n if (out[axis] === undefined) out[axis] = componentOf(vector, i);\r\n }\r\n\r\n // `order` rides on an Euler and has nowhere else to go.\r\n if (key === \"rotation\") {\r\n const order = (value as Euler3).order;\r\n if (order !== undefined && out.rotationOrder === undefined) out.rotationOrder = order;\r\n }\r\n }\r\n\r\n return (out as T) ?? props;\r\n}\r\n\r\n/** `data` without the keys left unstated, so a tween never aims an axis at `undefined`. */\r\nfunction stated<T extends object>(data: T | undefined): Partial<T> {\r\n const out: Partial<T> = {};\r\n for (const key in data) if (data[key] !== undefined) out[key] = data[key];\r\n return out;\r\n}\r\n\r\nfunction componentOf(vector: Vector3, index: number): number {\r\n return index === 0 ? vector.x : index === 1 ? vector.y : vector.z;\r\n}\r\n"]}
@@ -34,10 +34,10 @@ export declare abstract class AudioSink {
34
34
  */
35
35
  abstract schedule(requests: readonly AudioRequest[]): void;
36
36
  /**
37
- * Start/stop scheduled sources to match `sceneTime`. Called every tick.
37
+ * Start/stop scheduled sources to match `clipTime`. Called every tick.
38
38
  * Sources whose data has not yet been appended are skipped until it is.
39
39
  */
40
- abstract syncTo(sceneTime: number): void;
40
+ abstract syncTo(clipTime: number): void;
41
41
  abstract play(time: number, speed: number, reverse: boolean): void | Promise<void>;
42
42
  abstract stop(): void;
43
43
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"audio-sink.d.ts","sourceRoot":"","sources":["../../src/platform/audio-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D;;;;;;;GAOG;AACH,8BAAsB,SAAS;IAC3B;;;;;;;;OAQG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAElC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAE1D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAExC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAE9B;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE/B,OAAO,IAAI,IAAI;CAGlB"}
1
+ {"version":3,"file":"audio-sink.d.ts","sourceRoot":"","sources":["../../src/platform/audio-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D;;;;;;;GAOG;AACH,8BAAsB,SAAS;IAC3B;;;;;;;;OAQG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAElC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAE1D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAEvC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAE9B;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAE/B,OAAO,IAAI,IAAI;CAGlB"}
@@ -1 +1 @@
1
- {"version":3,"file":"audio-sink.js","sourceRoot":"","sources":["../../src/platform/audio-sink.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAgB,SAAS;IAC3B;;;;;;;;OAQG;IACH,IAAI,cAAc;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IA8BD;;;OAGG;IACH,QAAQ,CAAC,KAAc,IAAS,CAAC;IAEjC;;;;;;;OAOG;IACH,SAAS,CAAC,MAAc,IAAS,CAAC;IAElC,OAAO;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;CACJ","sourcesContent":["import type { AudioRequest } from \"@/attributes/audio/request\";\n\n\n/**\n * Stackable audio player driven by the AssetManager.\n *\n * The AssetManager decides which audio data is needed within the current\n * look-ahead window and pushes it in via {@link append}; the device caches the\n * decoded form, schedules the matching {@link AudioRequest}s via\n * {@link schedule}, and drives playback through {@link syncTo} on each tick.\n */\nexport abstract class AudioSink {\n /**\n * Whether pushing the audio working set to this device does anything at all.\n *\n * False for a sink that discards everything — an export, whose audio is mixed\n * offline in a single pass at the end. `AssetManager.syncAudio` runs on every\n * frame and rebuilds a `Set`, a per-request id string and a sorted signature\n * each time; against such a device every one of those calls lands on a no-op,\n * so the work is skipped rather than done and thrown away.\n */\n get schedulesAudio(): boolean {\n return true;\n }\n\n /** True if decoded data for `src` is already cached on the device. */\n abstract has(src: string): boolean;\n\n /**\n * Decode and stack `data` under `src`. Idempotent — repeat calls for an\n * already-cached `src` are no-ops.\n */\n abstract append(src: string, data: ArrayBuffer): Promise<void>;\n\n /** Drop cached audio data (and any active sources) for srcs not in `keep`. */\n abstract retain(keep: ReadonlySet<string>): void;\n\n /**\n * Set the working set of audio requests for the current look-ahead window.\n * Requests no longer present are stopped; new ones become eligible for\n * playback via {@link syncTo} as soon as their data is appended.\n */\n abstract schedule(requests: readonly AudioRequest[]): void;\n\n /**\n * Start/stop scheduled sources to match `sceneTime`. Called every tick.\n * Sources whose data has not yet been appended are skipped until it is.\n */\n abstract syncTo(sceneTime: number): void;\n\n abstract play(time: number, speed: number, reverse: boolean): void | Promise<void>;\n abstract stop(): void;\n\n /**\n * Mute or unmute all output. Default is a no-op for devices that produce no\n * sound (e.g. export/noop sinks).\n */\n setMuted(muted: boolean): void {}\n\n /**\n * Set the linear gain applied to all output, on top of each request's own\n * `volume`. Independent of {@link setMuted} — unmuting restores this level\n * rather than resetting to 1, so a host can hold a volume slider and a mute\n * button without the two clobbering each other.\n *\n * Default is a no-op, as for {@link setMuted}.\n */\n setVolume(volume: number): void {}\n\n dispose(): void {\n this.stop();\n }\n}\n"]}
1
+ {"version":3,"file":"audio-sink.js","sourceRoot":"","sources":["../../src/platform/audio-sink.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAgB,SAAS;IAC3B;;;;;;;;OAQG;IACH,IAAI,cAAc;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IA8BD;;;OAGG;IACH,QAAQ,CAAC,KAAc,IAAS,CAAC;IAEjC;;;;;;;OAOG;IACH,SAAS,CAAC,MAAc,IAAS,CAAC;IAElC,OAAO;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;CACJ","sourcesContent":["import type { AudioRequest } from \"@/attributes/audio/request\";\r\n\r\n\r\n/**\r\n * Stackable audio player driven by the AssetManager.\r\n *\r\n * The AssetManager decides which audio data is needed within the current\r\n * look-ahead window and pushes it in via {@link append}; the device caches the\r\n * decoded form, schedules the matching {@link AudioRequest}s via\r\n * {@link schedule}, and drives playback through {@link syncTo} on each tick.\r\n */\r\nexport abstract class AudioSink {\r\n /**\r\n * Whether pushing the audio working set to this device does anything at all.\r\n *\r\n * False for a sink that discards everything — an export, whose audio is mixed\r\n * offline in a single pass at the end. `AssetManager.syncAudio` runs on every\r\n * frame and rebuilds a `Set`, a per-request id string and a sorted signature\r\n * each time; against such a device every one of those calls lands on a no-op,\r\n * so the work is skipped rather than done and thrown away.\r\n */\r\n get schedulesAudio(): boolean {\r\n return true;\r\n }\r\n\r\n /** True if decoded data for `src` is already cached on the device. */\r\n abstract has(src: string): boolean;\r\n\r\n /**\r\n * Decode and stack `data` under `src`. Idempotent — repeat calls for an\r\n * already-cached `src` are no-ops.\r\n */\r\n abstract append(src: string, data: ArrayBuffer): Promise<void>;\r\n\r\n /** Drop cached audio data (and any active sources) for srcs not in `keep`. */\r\n abstract retain(keep: ReadonlySet<string>): void;\r\n\r\n /**\r\n * Set the working set of audio requests for the current look-ahead window.\r\n * Requests no longer present are stopped; new ones become eligible for\r\n * playback via {@link syncTo} as soon as their data is appended.\r\n */\r\n abstract schedule(requests: readonly AudioRequest[]): void;\r\n\r\n /**\r\n * Start/stop scheduled sources to match `clipTime`. Called every tick.\r\n * Sources whose data has not yet been appended are skipped until it is.\r\n */\r\n abstract syncTo(clipTime: number): void;\r\n\r\n abstract play(time: number, speed: number, reverse: boolean): void | Promise<void>;\r\n abstract stop(): void;\r\n\r\n /**\r\n * Mute or unmute all output. Default is a no-op for devices that produce no\r\n * sound (e.g. export/noop sinks).\r\n */\r\n setMuted(muted: boolean): void {}\r\n\r\n /**\r\n * Set the linear gain applied to all output, on top of each request's own\r\n * `volume`. Independent of {@link setMuted} — unmuting restores this level\r\n * rather than resetting to 1, so a host can hold a volume slider and a mute\r\n * button without the two clobbering each other.\r\n *\r\n * Default is a no-op, as for {@link setMuted}.\r\n */\r\n setVolume(volume: number): void {}\r\n\r\n dispose(): void {\r\n this.stop();\r\n }\r\n}\r\n"]}