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

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 (1278) hide show
  1. package/CHANGELOG.md +356 -0
  2. package/NOTICE +49 -0
  3. package/README.md +29 -10
  4. package/dist/assets/catalog.d.ts +9 -0
  5. package/dist/assets/catalog.d.ts.map +1 -1
  6. package/dist/assets/catalog.js +11 -0
  7. package/dist/assets/catalog.js.map +1 -1
  8. package/dist/assets/errors.d.ts.map +1 -1
  9. package/dist/assets/errors.js +7 -3
  10. package/dist/assets/errors.js.map +1 -1
  11. package/dist/assets/manager.d.ts +26 -1
  12. package/dist/assets/manager.d.ts.map +1 -1
  13. package/dist/assets/manager.js +99 -15
  14. package/dist/assets/manager.js.map +1 -1
  15. package/dist/assets/scope.d.ts +4 -4
  16. package/dist/assets/scope.d.ts.map +1 -1
  17. package/dist/assets/scope.js +1 -1
  18. package/dist/assets/scope.js.map +1 -1
  19. package/dist/attributes/audio/effects/chain.d.ts +73 -0
  20. package/dist/attributes/audio/effects/chain.d.ts.map +1 -0
  21. package/dist/attributes/audio/effects/chain.js +67 -0
  22. package/dist/attributes/audio/effects/chain.js.map +1 -0
  23. package/dist/attributes/audio/effects/implementations/echo.d.ts +14 -0
  24. package/dist/attributes/audio/effects/implementations/echo.d.ts.map +1 -0
  25. package/dist/attributes/audio/{filters → effects}/implementations/echo.js +2 -2
  26. package/dist/attributes/audio/effects/implementations/echo.js.map +1 -0
  27. package/dist/attributes/audio/effects/implementations/gain.d.ts +10 -0
  28. package/dist/attributes/audio/effects/implementations/gain.d.ts.map +1 -0
  29. package/dist/attributes/audio/{filters → effects}/implementations/gain.js +2 -2
  30. package/dist/attributes/audio/effects/implementations/gain.js.map +1 -0
  31. package/dist/attributes/audio/effects/implementations/highpass.d.ts +12 -0
  32. package/dist/attributes/audio/effects/implementations/highpass.d.ts.map +1 -0
  33. package/dist/attributes/audio/{filters → effects}/implementations/highpass.js +2 -2
  34. package/dist/attributes/audio/effects/implementations/highpass.js.map +1 -0
  35. package/dist/attributes/audio/effects/implementations/lowpass.d.ts +12 -0
  36. package/dist/attributes/audio/effects/implementations/lowpass.d.ts.map +1 -0
  37. package/dist/attributes/audio/{filters → effects}/implementations/lowpass.js +2 -2
  38. package/dist/attributes/audio/effects/implementations/lowpass.js.map +1 -0
  39. package/dist/attributes/audio/effects/implementations/tremolo.d.ts +12 -0
  40. package/dist/attributes/audio/effects/implementations/tremolo.d.ts.map +1 -0
  41. package/dist/attributes/audio/{filters → effects}/implementations/tremolo.js +2 -2
  42. package/dist/attributes/audio/effects/implementations/tremolo.js.map +1 -0
  43. package/dist/attributes/audio/effects/index.d.ts +12 -0
  44. package/dist/attributes/audio/effects/index.d.ts.map +1 -0
  45. package/dist/attributes/audio/effects/index.js +4 -0
  46. package/dist/attributes/audio/effects/index.js.map +1 -0
  47. package/dist/attributes/audio/effects/registry.d.ts +36 -0
  48. package/dist/attributes/audio/effects/registry.d.ts.map +1 -0
  49. package/dist/attributes/audio/effects/registry.js +80 -0
  50. package/dist/attributes/audio/effects/registry.js.map +1 -0
  51. package/dist/attributes/audio/effects/union.d.ts +14 -0
  52. package/dist/attributes/audio/effects/union.d.ts.map +1 -0
  53. package/dist/attributes/audio/effects/union.js +24 -0
  54. package/dist/attributes/audio/effects/union.js.map +1 -0
  55. package/dist/attributes/audio/ramp.d.ts +103 -0
  56. package/dist/attributes/audio/ramp.d.ts.map +1 -0
  57. package/dist/attributes/audio/ramp.js +246 -0
  58. package/dist/attributes/audio/ramp.js.map +1 -0
  59. package/dist/attributes/audio/request.d.ts +52 -13
  60. package/dist/attributes/audio/request.d.ts.map +1 -1
  61. package/dist/attributes/audio/request.js +10 -1
  62. package/dist/attributes/audio/request.js.map +1 -1
  63. package/dist/attributes/audio/schedule.d.ts +26 -24
  64. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  65. package/dist/attributes/audio/schedule.js +51 -30
  66. package/dist/attributes/audio/schedule.js.map +1 -1
  67. package/dist/attributes/audio/sound.d.ts +18 -13
  68. package/dist/attributes/audio/sound.d.ts.map +1 -1
  69. package/dist/attributes/audio/sound.js +13 -11
  70. package/dist/attributes/audio/sound.js.map +1 -1
  71. package/dist/attributes/audio/transition.d.ts +33 -0
  72. package/dist/attributes/audio/transition.d.ts.map +1 -0
  73. package/dist/attributes/audio/transition.js +48 -0
  74. package/dist/attributes/audio/transition.js.map +1 -0
  75. package/dist/attributes/index.d.ts +8 -8
  76. package/dist/attributes/index.d.ts.map +1 -1
  77. package/dist/attributes/index.js +7 -9
  78. package/dist/attributes/index.js.map +1 -1
  79. package/dist/attributes/layout/alignment.js +1 -1
  80. package/dist/attributes/layout/alignment.js.map +1 -1
  81. package/dist/attributes/layout/insets.d.ts +1 -1
  82. package/dist/attributes/layout/insets.js.map +1 -1
  83. package/dist/attributes/layout/matrix2d.d.ts +2 -2
  84. package/dist/attributes/layout/matrix2d.js.map +1 -1
  85. package/dist/attributes/layout/size.d.ts +1 -1
  86. package/dist/attributes/layout/size.js +1 -1
  87. package/dist/attributes/layout/size.js.map +1 -1
  88. package/dist/attributes/layout/space3d.js +1 -1
  89. package/dist/attributes/layout/space3d.js.map +1 -1
  90. package/dist/attributes/properties/decorator.d.ts +56 -12
  91. package/dist/attributes/properties/decorator.d.ts.map +1 -1
  92. package/dist/attributes/properties/decorator.js +59 -19
  93. package/dist/attributes/properties/decorator.js.map +1 -1
  94. package/dist/attributes/properties/inputs.d.ts +1 -1
  95. package/dist/attributes/properties/inputs.js +1 -1
  96. package/dist/attributes/properties/inputs.js.map +1 -1
  97. package/dist/attributes/properties/typed.d.ts +27 -141
  98. package/dist/attributes/properties/typed.d.ts.map +1 -1
  99. package/dist/attributes/properties/typed.js +24 -106
  100. package/dist/attributes/properties/typed.js.map +1 -1
  101. package/dist/attributes/render3d/orbit.d.ts +8 -8
  102. package/dist/attributes/render3d/orbit.js +7 -7
  103. package/dist/attributes/render3d/orbit.js.map +1 -1
  104. package/dist/attributes/shape/corners/corner-radius.d.ts +2 -3
  105. package/dist/attributes/shape/corners/corner-radius.d.ts.map +1 -1
  106. package/dist/attributes/shape/corners/corner-radius.js +2 -3
  107. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  108. package/dist/attributes/shape/effects/backdrop.d.ts +4 -4
  109. package/dist/attributes/shape/effects/backdrop.d.ts.map +1 -1
  110. package/dist/attributes/shape/effects/backdrop.js.map +1 -1
  111. package/dist/attributes/shape/effects/chain.d.ts +117 -522
  112. package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
  113. package/dist/attributes/shape/effects/chain.js +102 -364
  114. package/dist/attributes/shape/effects/chain.js.map +1 -1
  115. package/dist/attributes/shape/effects/effect-data.d.ts +1 -1
  116. package/dist/attributes/shape/effects/effect-data.js.map +1 -1
  117. package/dist/attributes/shape/effects/implementations/ascii.d.ts +45 -13
  118. package/dist/attributes/shape/effects/implementations/ascii.d.ts.map +1 -1
  119. package/dist/attributes/shape/effects/implementations/ascii.js +29 -23
  120. package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
  121. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts +32 -7
  122. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts.map +1 -1
  123. package/dist/attributes/shape/effects/implementations/bit-crush.js +17 -15
  124. package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
  125. package/dist/attributes/shape/effects/implementations/block-displace.d.ts +46 -10
  126. package/dist/attributes/shape/effects/implementations/block-displace.d.ts.map +1 -1
  127. package/dist/attributes/shape/effects/implementations/block-displace.js +21 -19
  128. package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
  129. package/dist/attributes/shape/effects/implementations/bloom.d.ts +32 -7
  130. package/dist/attributes/shape/effects/implementations/bloom.d.ts.map +1 -1
  131. package/dist/attributes/shape/effects/implementations/bloom.js +17 -11
  132. package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
  133. package/dist/attributes/shape/effects/implementations/blur.d.ts +16 -3
  134. package/dist/attributes/shape/effects/implementations/blur.d.ts.map +1 -1
  135. package/dist/attributes/shape/effects/implementations/blur.js +13 -5
  136. package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
  137. package/dist/attributes/shape/effects/implementations/bulge.d.ts +28 -9
  138. package/dist/attributes/shape/effects/implementations/bulge.d.ts.map +1 -1
  139. package/dist/attributes/shape/effects/implementations/bulge.js +15 -14
  140. package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
  141. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts +21 -5
  142. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts.map +1 -1
  143. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js +15 -10
  144. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
  145. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +98 -28
  146. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts.map +1 -1
  147. package/dist/attributes/shape/effects/implementations/color-adjustment.js +29 -26
  148. package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
  149. package/dist/attributes/shape/effects/implementations/curves.d.ts +21 -7
  150. package/dist/attributes/shape/effects/implementations/curves.d.ts.map +1 -1
  151. package/dist/attributes/shape/effects/implementations/curves.js +26 -23
  152. package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
  153. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts +26 -5
  154. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts.map +1 -1
  155. package/dist/attributes/shape/effects/implementations/directional-blur.js +15 -10
  156. package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
  157. package/dist/attributes/shape/effects/implementations/dither.d.ts +58 -11
  158. package/dist/attributes/shape/effects/implementations/dither.d.ts.map +1 -1
  159. package/dist/attributes/shape/effects/implementations/dither.js +26 -20
  160. package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
  161. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts +47 -15
  162. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts.map +1 -1
  163. package/dist/attributes/shape/effects/implementations/drop-shadow.js +24 -29
  164. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  165. package/dist/attributes/shape/effects/implementations/duotone.d.ts +26 -7
  166. package/dist/attributes/shape/effects/implementations/duotone.d.ts.map +1 -1
  167. package/dist/attributes/shape/effects/implementations/duotone.js +17 -16
  168. package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
  169. package/dist/attributes/shape/effects/implementations/edges.d.ts +29 -7
  170. package/dist/attributes/shape/effects/implementations/edges.d.ts.map +1 -1
  171. package/dist/attributes/shape/effects/implementations/edges.js +17 -14
  172. package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
  173. package/dist/attributes/shape/effects/implementations/glass.d.ts +82 -34
  174. package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
  175. package/dist/attributes/shape/effects/implementations/glass.js +28 -22
  176. package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
  177. package/dist/attributes/shape/effects/implementations/glow.d.ts +149 -42
  178. package/dist/attributes/shape/effects/implementations/glow.d.ts.map +1 -1
  179. package/dist/attributes/shape/effects/implementations/glow.js +74 -72
  180. package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
  181. package/dist/attributes/shape/effects/implementations/grain.d.ts +43 -11
  182. package/dist/attributes/shape/effects/implementations/grain.d.ts.map +1 -1
  183. package/dist/attributes/shape/effects/implementations/grain.js +21 -18
  184. package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
  185. package/dist/attributes/shape/effects/implementations/grayscale.d.ts +17 -3
  186. package/dist/attributes/shape/effects/implementations/grayscale.d.ts.map +1 -1
  187. package/dist/attributes/shape/effects/implementations/grayscale.js +13 -5
  188. package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
  189. package/dist/attributes/shape/effects/implementations/halftone.d.ts +40 -9
  190. package/dist/attributes/shape/effects/implementations/halftone.d.ts.map +1 -1
  191. package/dist/attributes/shape/effects/implementations/halftone.js +20 -16
  192. package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
  193. package/dist/attributes/shape/effects/implementations/invert.d.ts +23 -5
  194. package/dist/attributes/shape/effects/implementations/invert.d.ts.map +1 -1
  195. package/dist/attributes/shape/effects/implementations/invert.js +15 -10
  196. package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
  197. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts +57 -18
  198. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts.map +1 -1
  199. package/dist/attributes/shape/effects/implementations/kaleidoscope.js +25 -22
  200. package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
  201. package/dist/attributes/shape/effects/implementations/lut.d.ts +35 -8
  202. package/dist/attributes/shape/effects/implementations/lut.d.ts.map +1 -1
  203. package/dist/attributes/shape/effects/implementations/lut.js +20 -16
  204. package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
  205. package/dist/attributes/shape/effects/implementations/magnify.d.ts +27 -9
  206. package/dist/attributes/shape/effects/implementations/magnify.d.ts.map +1 -1
  207. package/dist/attributes/shape/effects/implementations/magnify.js +17 -14
  208. package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
  209. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts +54 -19
  210. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts.map +1 -1
  211. package/dist/attributes/shape/effects/implementations/motion-blur.js +42 -20
  212. package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
  213. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts +17 -3
  214. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts.map +1 -1
  215. package/dist/attributes/shape/effects/implementations/oil-paint.js +13 -9
  216. package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
  217. package/dist/attributes/shape/effects/implementations/outline.d.ts +28 -8
  218. package/dist/attributes/shape/effects/implementations/outline.d.ts.map +1 -1
  219. package/dist/attributes/shape/effects/implementations/outline.js +18 -17
  220. package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
  221. package/dist/attributes/shape/effects/implementations/pixelate.d.ts +25 -6
  222. package/dist/attributes/shape/effects/implementations/pixelate.d.ts.map +1 -1
  223. package/dist/attributes/shape/effects/implementations/pixelate.js +16 -14
  224. package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
  225. package/dist/attributes/shape/effects/implementations/posterize.d.ts +14 -3
  226. package/dist/attributes/shape/effects/implementations/posterize.d.ts.map +1 -1
  227. package/dist/attributes/shape/effects/implementations/posterize.js +13 -9
  228. package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
  229. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts +91 -26
  230. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts.map +1 -1
  231. package/dist/attributes/shape/effects/implementations/progressive-blur.js +27 -28
  232. package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
  233. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts +49 -10
  234. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts.map +1 -1
  235. package/dist/attributes/shape/effects/implementations/radial-blur.js +19 -20
  236. package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
  237. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts +36 -6
  238. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts.map +1 -1
  239. package/dist/attributes/shape/effects/implementations/rgb-shift.js +16 -15
  240. package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
  241. package/dist/attributes/shape/effects/implementations/scanlines.d.ts +52 -11
  242. package/dist/attributes/shape/effects/implementations/scanlines.d.ts.map +1 -1
  243. package/dist/attributes/shape/effects/implementations/scanlines.js +21 -18
  244. package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
  245. package/dist/attributes/shape/effects/implementations/scatter.d.ts +23 -9
  246. package/dist/attributes/shape/effects/implementations/scatter.d.ts.map +1 -1
  247. package/dist/attributes/shape/effects/implementations/scatter.js +15 -12
  248. package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
  249. package/dist/attributes/shape/effects/implementations/shader.d.ts +90 -34
  250. package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
  251. package/dist/attributes/shape/effects/implementations/shader.js +57 -34
  252. package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
  253. package/dist/attributes/shape/effects/implementations/sharpen.d.ts +23 -5
  254. package/dist/attributes/shape/effects/implementations/sharpen.d.ts.map +1 -1
  255. package/dist/attributes/shape/effects/implementations/sharpen.js +16 -11
  256. package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
  257. package/dist/attributes/shape/effects/implementations/streak.d.ts +40 -9
  258. package/dist/attributes/shape/effects/implementations/streak.d.ts.map +1 -1
  259. package/dist/attributes/shape/effects/implementations/streak.js +19 -16
  260. package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
  261. package/dist/attributes/shape/effects/implementations/threshold.d.ts +24 -5
  262. package/dist/attributes/shape/effects/implementations/threshold.d.ts.map +1 -1
  263. package/dist/attributes/shape/effects/implementations/threshold.js +17 -11
  264. package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
  265. package/dist/attributes/shape/effects/implementations/twirl.d.ts +35 -8
  266. package/dist/attributes/shape/effects/implementations/twirl.d.ts.map +1 -1
  267. package/dist/attributes/shape/effects/implementations/twirl.js +17 -16
  268. package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
  269. package/dist/attributes/shape/effects/implementations/vignette.d.ts +37 -7
  270. package/dist/attributes/shape/effects/implementations/vignette.d.ts.map +1 -1
  271. package/dist/attributes/shape/effects/implementations/vignette.js +19 -18
  272. package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
  273. package/dist/attributes/shape/effects/implementations/vintage.d.ts +24 -5
  274. package/dist/attributes/shape/effects/implementations/vintage.d.ts.map +1 -1
  275. package/dist/attributes/shape/effects/implementations/vintage.js +15 -10
  276. package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
  277. package/dist/attributes/shape/effects/implementations/wave.d.ts +61 -14
  278. package/dist/attributes/shape/effects/implementations/wave.d.ts.map +1 -1
  279. package/dist/attributes/shape/effects/implementations/wave.js +26 -23
  280. package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
  281. package/dist/attributes/shape/effects/index.d.ts +6 -8
  282. package/dist/attributes/shape/effects/index.d.ts.map +1 -1
  283. package/dist/attributes/shape/effects/index.js +1 -1
  284. package/dist/attributes/shape/effects/index.js.map +1 -1
  285. package/dist/attributes/shape/effects/registry.d.ts +34 -6
  286. package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
  287. package/dist/attributes/shape/effects/registry.js +157 -112
  288. package/dist/attributes/shape/effects/registry.js.map +1 -1
  289. package/dist/attributes/shape/effects/spec.d.ts +229 -0
  290. package/dist/attributes/shape/effects/spec.d.ts.map +1 -0
  291. package/dist/attributes/shape/effects/spec.js +178 -0
  292. package/dist/attributes/shape/effects/spec.js.map +1 -0
  293. package/dist/attributes/shape/effects/union.d.ts +2 -6
  294. package/dist/attributes/shape/effects/union.d.ts.map +1 -1
  295. package/dist/attributes/shape/effects/union.js.map +1 -1
  296. package/dist/attributes/shape/fill/chain.d.ts +7 -9
  297. package/dist/attributes/shape/fill/chain.d.ts.map +1 -1
  298. package/dist/attributes/shape/fill/chain.js +9 -11
  299. package/dist/attributes/shape/fill/chain.js.map +1 -1
  300. package/dist/attributes/shape/fill/color/parser.d.ts +1 -1
  301. package/dist/attributes/shape/fill/color/parser.d.ts.map +1 -1
  302. package/dist/attributes/shape/fill/color/parser.js +102 -50
  303. package/dist/attributes/shape/fill/color/parser.js.map +1 -1
  304. package/dist/attributes/shape/fill/gradient-stops.d.ts +16 -0
  305. package/dist/attributes/shape/fill/gradient-stops.d.ts.map +1 -0
  306. package/dist/attributes/shape/fill/gradient-stops.js +65 -0
  307. package/dist/attributes/shape/fill/gradient-stops.js.map +1 -0
  308. package/dist/attributes/shape/fill/implementations/canvas3d.d.ts +2 -2
  309. package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
  310. package/dist/attributes/shape/fill/implementations/conic-gradient.d.ts.map +1 -1
  311. package/dist/attributes/shape/fill/implementations/conic-gradient.js +2 -5
  312. package/dist/attributes/shape/fill/implementations/conic-gradient.js.map +1 -1
  313. package/dist/attributes/shape/fill/implementations/fractal-noise.d.ts.map +1 -1
  314. package/dist/attributes/shape/fill/implementations/fractal-noise.js +2 -10
  315. package/dist/attributes/shape/fill/implementations/fractal-noise.js.map +1 -1
  316. package/dist/attributes/shape/fill/implementations/image.d.ts.map +1 -1
  317. package/dist/attributes/shape/fill/implementations/image.js +5 -4
  318. package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
  319. package/dist/attributes/shape/fill/implementations/linear-gradient.d.ts.map +1 -1
  320. package/dist/attributes/shape/fill/implementations/linear-gradient.js +2 -6
  321. package/dist/attributes/shape/fill/implementations/linear-gradient.js.map +1 -1
  322. package/dist/attributes/shape/fill/implementations/radial-gradient.d.ts.map +1 -1
  323. package/dist/attributes/shape/fill/implementations/radial-gradient.js +2 -5
  324. package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
  325. package/dist/attributes/shape/fill/implementations/shader.d.ts +28 -27
  326. package/dist/attributes/shape/fill/implementations/shader.d.ts.map +1 -1
  327. package/dist/attributes/shape/fill/implementations/shader.js +20 -14
  328. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  329. package/dist/attributes/shape/fill/implementations/video.d.ts +1 -1
  330. package/dist/attributes/shape/fill/implementations/video.js +2 -2
  331. package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
  332. package/dist/attributes/shape/fill/index.d.ts +1 -1
  333. package/dist/attributes/shape/fill/index.d.ts.map +1 -1
  334. package/dist/attributes/shape/fill/index.js.map +1 -1
  335. package/dist/attributes/shape/fill/lerp.d.ts +9 -1
  336. package/dist/attributes/shape/fill/lerp.d.ts.map +1 -1
  337. package/dist/attributes/shape/fill/lerp.js +12 -1
  338. package/dist/attributes/shape/fill/lerp.js.map +1 -1
  339. package/dist/attributes/shape/fill/registry.d.ts +1 -2
  340. package/dist/attributes/shape/fill/registry.d.ts.map +1 -1
  341. package/dist/attributes/shape/fill/registry.js +1 -2
  342. package/dist/attributes/shape/fill/registry.js.map +1 -1
  343. package/dist/attributes/shape/filters/chain.d.ts +7 -17
  344. package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
  345. package/dist/attributes/shape/filters/chain.js +3 -19
  346. package/dist/attributes/shape/filters/chain.js.map +1 -1
  347. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts +2 -2
  348. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts.map +1 -1
  349. package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
  350. package/dist/attributes/shape/filters/index.d.ts +1 -1
  351. package/dist/attributes/shape/filters/index.js.map +1 -1
  352. package/dist/attributes/shape/filters/registry.d.ts +3 -3
  353. package/dist/attributes/shape/filters/registry.d.ts.map +1 -1
  354. package/dist/attributes/shape/filters/registry.js +6 -6
  355. package/dist/attributes/shape/filters/registry.js.map +1 -1
  356. package/dist/attributes/shape/filters/union.d.ts +12 -13
  357. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  358. package/dist/attributes/shape/filters/union.js.map +1 -1
  359. package/dist/attributes/shape/path/anchors.d.ts.map +1 -1
  360. package/dist/attributes/shape/path/anchors.js +12 -5
  361. package/dist/attributes/shape/path/anchors.js.map +1 -1
  362. package/dist/attributes/shape/path/morph.d.ts.map +1 -1
  363. package/dist/attributes/shape/path/morph.js +16 -4
  364. package/dist/attributes/shape/path/morph.js.map +1 -1
  365. package/dist/attributes/shape/path/ops.d.ts +1 -2
  366. package/dist/attributes/shape/path/ops.d.ts.map +1 -1
  367. package/dist/attributes/shape/path/ops.js.map +1 -1
  368. package/dist/attributes/shape/shaders/index.d.ts +2 -0
  369. package/dist/attributes/shape/shaders/index.d.ts.map +1 -1
  370. package/dist/attributes/shape/shaders/index.js +2 -0
  371. package/dist/attributes/shape/shaders/index.js.map +1 -1
  372. package/dist/attributes/shape/shaders/language.d.ts +26 -0
  373. package/dist/attributes/shape/shaders/language.d.ts.map +1 -0
  374. package/dist/attributes/shape/shaders/language.js +20 -0
  375. package/dist/attributes/shape/shaders/language.js.map +1 -0
  376. package/dist/attributes/shape/shaders/pack.d.ts +25 -11
  377. package/dist/attributes/shape/shaders/pack.d.ts.map +1 -1
  378. package/dist/attributes/shape/shaders/pack.js +9 -4
  379. package/dist/attributes/shape/shaders/pack.js.map +1 -1
  380. package/dist/attributes/shape/shaders/resolve.d.ts +4 -5
  381. package/dist/attributes/shape/shaders/resolve.d.ts.map +1 -1
  382. package/dist/attributes/shape/shaders/resolve.js +3 -6
  383. package/dist/attributes/shape/shaders/resolve.js.map +1 -1
  384. package/dist/attributes/shape/shaders/uniforms.d.ts +41 -0
  385. package/dist/attributes/shape/shaders/uniforms.d.ts.map +1 -0
  386. package/dist/attributes/shape/shaders/uniforms.js +0 -0
  387. package/dist/attributes/shape/shaders/uniforms.js.map +1 -0
  388. package/dist/attributes/shape/stroke/index.d.ts +2 -2
  389. package/dist/attributes/shape/stroke/index.d.ts.map +1 -1
  390. package/dist/attributes/shape/stroke/index.js +1 -1
  391. package/dist/attributes/shape/stroke/index.js.map +1 -1
  392. package/dist/attributes/shape/stroke/stroke.d.ts +27 -6
  393. package/dist/attributes/shape/stroke/stroke.d.ts.map +1 -1
  394. package/dist/attributes/shape/stroke/stroke.js +22 -2
  395. package/dist/attributes/shape/stroke/stroke.js.map +1 -1
  396. package/dist/attributes/shared/operators.d.ts +2 -2
  397. package/dist/attributes/shared/operators.js.map +1 -1
  398. package/dist/attributes/text/ops.d.ts +6 -0
  399. package/dist/attributes/text/ops.d.ts.map +1 -1
  400. package/dist/attributes/text/ops.js +1 -0
  401. package/dist/attributes/text/ops.js.map +1 -1
  402. package/dist/attributes/text/types.d.ts +2 -3
  403. package/dist/attributes/text/types.d.ts.map +1 -1
  404. package/dist/attributes/text/types.js.map +1 -1
  405. package/dist/browser/chunks/chunk-4BDLFEOC.js +2 -0
  406. package/dist/browser/chunks/chunk-4BDLFEOC.js.map +7 -0
  407. package/dist/browser/chunks/chunk-CCGVIR4F.js +3 -0
  408. package/dist/browser/chunks/chunk-CCGVIR4F.js.map +7 -0
  409. package/dist/browser/chunks/chunk-N4WSN5WY.js +13 -0
  410. package/dist/browser/chunks/chunk-N4WSN5WY.js.map +7 -0
  411. package/dist/browser/chunks/chunk-WZSI3GSK.js +6 -0
  412. package/dist/browser/chunks/chunk-WZSI3GSK.js.map +7 -0
  413. package/dist/browser/component.js +1 -1
  414. package/dist/browser/component.js.map +4 -4
  415. package/dist/browser/experimental.js +2 -0
  416. package/dist/browser/experimental.js.map +7 -0
  417. package/dist/browser/index.js +1 -1
  418. package/dist/browser/index.js.map +4 -4
  419. package/dist/browser/manifest.json +5 -5
  420. package/dist/browser/sdk.js +1 -1
  421. package/dist/component.d.ts +10 -19
  422. package/dist/component.d.ts.map +1 -1
  423. package/dist/component.js +10 -19
  424. package/dist/component.js.map +1 -1
  425. package/dist/components/builtins/audio/audio.d.ts +62 -0
  426. package/dist/components/builtins/audio/audio.d.ts.map +1 -0
  427. package/dist/components/builtins/audio/audio.js +38 -0
  428. package/dist/components/builtins/audio/audio.js.map +1 -0
  429. package/dist/components/builtins/geometry/composite.d.ts +93 -0
  430. package/dist/components/builtins/geometry/composite.d.ts.map +1 -0
  431. package/dist/components/builtins/geometry/composite.js +25 -0
  432. package/dist/components/builtins/geometry/composite.js.map +1 -0
  433. package/dist/components/builtins/geometry/geometry.d.ts +921 -0
  434. package/dist/components/builtins/geometry/geometry.d.ts.map +1 -0
  435. package/dist/components/builtins/geometry/geometry.js +107 -0
  436. package/dist/components/builtins/geometry/geometry.js.map +1 -0
  437. package/dist/{nodes → components/builtins}/geometry/shape-outline.d.ts +5 -5
  438. package/dist/components/builtins/geometry/shape-outline.d.ts.map +1 -0
  439. package/dist/{nodes → components/builtins}/geometry/shape-outline.js +4 -15
  440. package/dist/components/builtins/geometry/shape-outline.js.map +1 -0
  441. package/dist/components/builtins/layout/layout.d.ts +186 -0
  442. package/dist/components/builtins/layout/layout.d.ts.map +1 -0
  443. package/dist/components/builtins/layout/layout.js +84 -0
  444. package/dist/components/builtins/layout/layout.js.map +1 -0
  445. package/dist/components/builtins/media/media.d.ts +240 -0
  446. package/dist/components/builtins/media/media.d.ts.map +1 -0
  447. package/dist/components/builtins/media/media.js +143 -0
  448. package/dist/components/builtins/media/media.js.map +1 -0
  449. package/dist/components/builtins/providers/providers.d.ts +47 -0
  450. package/dist/components/builtins/providers/providers.d.ts.map +1 -0
  451. package/dist/components/builtins/providers/providers.js +30 -0
  452. package/dist/components/builtins/providers/providers.js.map +1 -0
  453. package/dist/{nodes → components/builtins}/text/number-format.d.ts +1 -1
  454. package/dist/components/builtins/text/number-format.d.ts.map +1 -0
  455. package/dist/{nodes → components/builtins}/text/number-format.js +1 -1
  456. package/dist/components/builtins/text/number-format.js.map +1 -0
  457. package/dist/components/builtins/text/number-pattern.d.ts.map +1 -0
  458. package/dist/components/builtins/text/number-pattern.js.map +1 -0
  459. package/dist/{nodes/node → components/builtins/text}/text-defaults.d.ts +10 -12
  460. package/dist/components/builtins/text/text-defaults.d.ts.map +1 -0
  461. package/dist/{nodes/node → components/builtins/text}/text-defaults.js +10 -12
  462. package/dist/components/builtins/text/text-defaults.js.map +1 -0
  463. package/dist/components/builtins/text/text-layout.d.ts +82 -0
  464. package/dist/components/builtins/text/text-layout.d.ts.map +1 -0
  465. package/dist/components/builtins/text/text-layout.js +331 -0
  466. package/dist/components/builtins/text/text-layout.js.map +1 -0
  467. package/dist/components/builtins/text/text.d.ts +409 -0
  468. package/dist/components/builtins/text/text.d.ts.map +1 -0
  469. package/dist/components/builtins/text/text.js +116 -0
  470. package/dist/components/builtins/text/text.js.map +1 -0
  471. package/dist/components/builtins/three/canvas3d.d.ts +245 -0
  472. package/dist/components/builtins/three/canvas3d.d.ts.map +1 -0
  473. package/dist/components/builtins/three/canvas3d.js +21 -0
  474. package/dist/components/builtins/three/canvas3d.js.map +1 -0
  475. package/dist/{nodes → components/builtins}/three/grid-geometry3d.d.ts +2 -2
  476. package/dist/components/builtins/three/grid-geometry3d.d.ts.map +1 -0
  477. package/dist/{nodes → components/builtins}/three/grid-geometry3d.js +1 -1
  478. package/dist/components/builtins/three/grid-geometry3d.js.map +1 -0
  479. package/dist/components/builtins/three/three.d.ts +1889 -0
  480. package/dist/components/builtins/three/three.d.ts.map +1 -0
  481. package/dist/components/builtins/three/three.js +305 -0
  482. package/dist/components/builtins/three/three.js.map +1 -0
  483. package/dist/components/factory/api.d.ts +543 -0
  484. package/dist/components/factory/api.d.ts.map +1 -0
  485. package/dist/components/factory/api.js +4 -0
  486. package/dist/components/factory/api.js.map +1 -0
  487. package/dist/components/factory/clip-of.d.ts +5 -0
  488. package/dist/components/factory/clip-of.d.ts.map +1 -0
  489. package/dist/components/factory/clip-of.js +33 -0
  490. package/dist/components/factory/clip-of.js.map +1 -0
  491. package/dist/components/factory/commands-for.d.ts +19 -0
  492. package/dist/components/factory/commands-for.d.ts.map +1 -0
  493. package/dist/components/factory/commands-for.js +5 -0
  494. package/dist/components/factory/commands-for.js.map +1 -0
  495. package/dist/components/factory/component-audio.d.ts +9 -0
  496. package/dist/components/factory/component-audio.d.ts.map +1 -0
  497. package/dist/components/factory/component-audio.js +18 -0
  498. package/dist/components/factory/component-audio.js.map +1 -0
  499. package/dist/components/factory/component2d.d.ts +8 -0
  500. package/dist/components/factory/component2d.d.ts.map +1 -0
  501. package/dist/components/factory/component2d.js +240 -0
  502. package/dist/components/factory/component2d.js.map +1 -0
  503. package/dist/components/factory/component3d.d.ts +9 -0
  504. package/dist/components/factory/component3d.d.ts.map +1 -0
  505. package/dist/components/factory/component3d.js +107 -0
  506. package/dist/components/factory/component3d.js.map +1 -0
  507. package/dist/components/factory/factory.d.ts +66 -0
  508. package/dist/components/factory/factory.d.ts.map +1 -0
  509. package/dist/components/factory/factory.js +347 -0
  510. package/dist/components/factory/factory.js.map +1 -0
  511. package/dist/components/factory/timeline.d.ts +22 -0
  512. package/dist/components/factory/timeline.d.ts.map +1 -0
  513. package/dist/components/factory/timeline.js +128 -0
  514. package/dist/components/factory/timeline.js.map +1 -0
  515. package/dist/components/factory/type-def.d.ts +26 -0
  516. package/dist/components/factory/type-def.d.ts.map +1 -0
  517. package/dist/components/factory/type-def.js +16 -0
  518. package/dist/components/factory/type-def.js.map +1 -0
  519. package/dist/components/factory/types.d.ts +91 -0
  520. package/dist/components/factory/types.d.ts.map +1 -0
  521. package/dist/components/factory/types.js +88 -0
  522. package/dist/components/factory/types.js.map +1 -0
  523. package/dist/components/factory/views.d.ts +121 -0
  524. package/dist/components/factory/views.d.ts.map +1 -0
  525. package/dist/components/factory/views.js +453 -0
  526. package/dist/components/factory/views.js.map +1 -0
  527. package/dist/components/modules/aim.d.ts +30 -0
  528. package/dist/components/modules/aim.d.ts.map +1 -0
  529. package/dist/components/modules/aim.js +39 -0
  530. package/dist/components/modules/aim.js.map +1 -0
  531. package/dist/components/modules/corners.d.ts +13 -0
  532. package/dist/components/modules/corners.d.ts.map +1 -0
  533. package/dist/components/modules/corners.js +12 -0
  534. package/dist/components/modules/corners.js.map +1 -0
  535. package/dist/components/modules/flow.d.ts +26 -0
  536. package/dist/components/modules/flow.d.ts.map +1 -0
  537. package/dist/components/modules/flow.js +57 -0
  538. package/dist/components/modules/flow.js.map +1 -0
  539. package/dist/components/modules/material.d.ts +40 -0
  540. package/dist/components/modules/material.d.ts.map +1 -0
  541. package/dist/components/modules/material.js +75 -0
  542. package/dist/components/modules/material.js.map +1 -0
  543. package/dist/components/modules/paint.d.ts +71 -0
  544. package/dist/components/modules/paint.d.ts.map +1 -0
  545. package/dist/components/modules/paint.js +106 -0
  546. package/dist/components/modules/paint.js.map +1 -0
  547. package/dist/components/modules/shapes.d.ts +31 -0
  548. package/dist/components/modules/shapes.d.ts.map +1 -0
  549. package/dist/components/modules/shapes.js +43 -0
  550. package/dist/components/modules/shapes.js.map +1 -0
  551. package/dist/components/modules/text-layout.d.ts +26 -0
  552. package/dist/components/modules/text-layout.d.ts.map +1 -0
  553. package/dist/components/modules/text-layout.js +57 -0
  554. package/dist/components/modules/text-layout.js.map +1 -0
  555. package/dist/components/modules/text-style.d.ts +48 -0
  556. package/dist/components/modules/text-style.d.ts.map +1 -0
  557. package/dist/components/modules/text-style.js +63 -0
  558. package/dist/components/modules/text-style.js.map +1 -0
  559. package/dist/components/modules/three-entries.d.ts +23 -0
  560. package/dist/components/modules/three-entries.d.ts.map +1 -0
  561. package/dist/components/modules/three-entries.js +41 -0
  562. package/dist/components/modules/three-entries.js.map +1 -0
  563. package/dist/components/modules/view3d.d.ts +59 -0
  564. package/dist/components/modules/view3d.d.ts.map +1 -0
  565. package/dist/components/modules/view3d.js +171 -0
  566. package/dist/components/modules/view3d.js.map +1 -0
  567. package/dist/{nodes/geometry → components/trees/2d}/group-bounds.d.ts +4 -4
  568. package/dist/components/trees/2d/group-bounds.d.ts.map +1 -0
  569. package/dist/{nodes/geometry → components/trees/2d}/group-bounds.js +3 -4
  570. package/dist/components/trees/2d/group-bounds.js.map +1 -0
  571. package/dist/{nodes → components/trees}/2d/node-lifecycle.d.ts +2 -2
  572. package/dist/components/trees/2d/node-lifecycle.d.ts.map +1 -0
  573. package/dist/{nodes → components/trees}/2d/node-lifecycle.js +1 -1
  574. package/dist/components/trees/2d/node-lifecycle.js.map +1 -0
  575. package/dist/{nodes → components/trees}/2d/node-motion.d.ts +3 -3
  576. package/dist/components/trees/2d/node-motion.d.ts.map +1 -0
  577. package/dist/{nodes → components/trees}/2d/node-motion.js +1 -1
  578. package/dist/components/trees/2d/node-motion.js.map +1 -0
  579. package/dist/components/trees/2d/node-render.d.ts +36 -0
  580. package/dist/components/trees/2d/node-render.d.ts.map +1 -0
  581. package/dist/{nodes → components/trees}/2d/node-render.js +10 -23
  582. package/dist/components/trees/2d/node-render.js.map +1 -0
  583. package/dist/{nodes → components/trees}/2d/node-space.d.ts +3 -3
  584. package/dist/components/trees/2d/node-space.d.ts.map +1 -0
  585. package/dist/{nodes → components/trees}/2d/node-space.js +4 -4
  586. package/dist/components/trees/2d/node-space.js.map +1 -0
  587. package/dist/{nodes → components/trees}/2d/node-transform.d.ts +2 -2
  588. package/dist/components/trees/2d/node-transform.d.ts.map +1 -0
  589. package/dist/{nodes → components/trees}/2d/node-transform.js +1 -1
  590. package/dist/components/trees/2d/node-transform.js.map +1 -0
  591. package/dist/{nodes → components/trees}/2d/node2d.d.ts +206 -185
  592. package/dist/components/trees/2d/node2d.d.ts.map +1 -0
  593. package/dist/{nodes → components/trees}/2d/node2d.js +296 -324
  594. package/dist/components/trees/2d/node2d.js.map +1 -0
  595. package/dist/components/trees/audio/index.d.ts +2 -0
  596. package/dist/components/trees/audio/index.d.ts.map +1 -0
  597. package/dist/components/trees/audio/index.js +2 -0
  598. package/dist/components/trees/audio/index.js.map +1 -0
  599. package/dist/{nodes → components/trees}/audio/node-audio.d.ts +25 -15
  600. package/dist/components/trees/audio/node-audio.d.ts.map +1 -0
  601. package/dist/{nodes → components/trees}/audio/node-audio.js +30 -35
  602. package/dist/components/trees/audio/node-audio.js.map +1 -0
  603. package/dist/components/trees/index.d.ts +10 -0
  604. package/dist/components/trees/index.d.ts.map +1 -0
  605. package/dist/components/trees/index.js +14 -0
  606. package/dist/components/trees/index.js.map +1 -0
  607. package/dist/components/trees/node/node-editor-state.d.ts.map +1 -0
  608. package/dist/components/trees/node/node-editor-state.js.map +1 -0
  609. package/dist/{nodes → components/trees}/node/node-reactive.d.ts +9 -10
  610. package/dist/components/trees/node/node-reactive.d.ts.map +1 -0
  611. package/dist/{nodes → components/trees}/node/node-reactive.js +16 -13
  612. package/dist/components/trees/node/node-reactive.js.map +1 -0
  613. package/dist/{nodes → components/trees}/node/node-time.d.ts +3 -3
  614. package/dist/components/trees/node/node-time.d.ts.map +1 -0
  615. package/dist/{nodes → components/trees}/node/node-time.js +1 -1
  616. package/dist/components/trees/node/node-time.js.map +1 -0
  617. package/dist/{nodes → components/trees}/node/node-walk.d.ts +1 -1
  618. package/dist/components/trees/node/node-walk.d.ts.map +1 -0
  619. package/dist/{nodes → components/trees}/node/node-walk.js +1 -1
  620. package/dist/components/trees/node/node-walk.js.map +1 -0
  621. package/dist/{nodes → components/trees}/node/node.d.ts +46 -82
  622. package/dist/components/trees/node/node.d.ts.map +1 -0
  623. package/dist/{nodes → components/trees}/node/node.js +89 -114
  624. package/dist/components/trees/node/node.js.map +1 -0
  625. package/dist/{nodes/scene → components/trees/root}/canvas2d-node.d.ts +16 -15
  626. package/dist/components/trees/root/canvas2d-node.d.ts.map +1 -0
  627. package/dist/{nodes/scene → components/trees/root}/canvas2d-node.js +40 -85
  628. package/dist/components/trees/root/canvas2d-node.js.map +1 -0
  629. package/dist/{nodes → components/trees}/three/node3d.d.ts +65 -25
  630. package/dist/components/trees/three/node3d.d.ts.map +1 -0
  631. package/dist/{nodes → components/trees}/three/node3d.js +78 -76
  632. package/dist/components/trees/three/node3d.js.map +1 -0
  633. package/dist/document/audio.d.ts +10 -2
  634. package/dist/document/audio.d.ts.map +1 -1
  635. package/dist/document/audio.js +45 -4
  636. package/dist/document/audio.js.map +1 -1
  637. package/dist/document/builtins.d.ts.map +1 -1
  638. package/dist/document/builtins.js +18 -42
  639. package/dist/document/builtins.js.map +1 -1
  640. package/dist/document/command-traits.d.ts +23 -5
  641. package/dist/document/command-traits.d.ts.map +1 -1
  642. package/dist/document/command-traits.js +72 -10
  643. package/dist/document/command-traits.js.map +1 -1
  644. package/dist/document/deny-globals.d.ts +2 -2
  645. package/dist/document/deny-globals.js +2 -2
  646. package/dist/document/deny-globals.js.map +1 -1
  647. package/dist/document/diff.d.ts.map +1 -1
  648. package/dist/document/diff.js +3 -3
  649. package/dist/document/diff.js.map +1 -1
  650. package/dist/document/doc-index.d.ts +2 -2
  651. package/dist/document/doc-index.d.ts.map +1 -1
  652. package/dist/document/doc-index.js +3 -3
  653. package/dist/document/doc-index.js.map +1 -1
  654. package/dist/document/expression/compile.d.ts.map +1 -1
  655. package/dist/document/expression/compile.js +8 -5
  656. package/dist/document/expression/compile.js.map +1 -1
  657. package/dist/document/expression/index.d.ts +1 -1
  658. package/dist/document/expression/index.js +1 -1
  659. package/dist/document/expression/index.js.map +1 -1
  660. package/dist/document/expression/ops.js +2 -2
  661. package/dist/document/expression/ops.js.map +1 -1
  662. package/dist/document/expression/parse.d.ts.map +1 -1
  663. package/dist/document/expression/parse.js +15 -6
  664. package/dist/document/expression/parse.js.map +1 -1
  665. package/dist/document/expression/refs.d.ts +1 -1
  666. package/dist/document/expression/refs.js +1 -1
  667. package/dist/document/expression/refs.js.map +1 -1
  668. package/dist/document/expression/walk.d.ts.map +1 -1
  669. package/dist/document/expression/walk.js +2 -1
  670. package/dist/document/expression/walk.js.map +1 -1
  671. package/dist/document/index.d.ts +10 -1
  672. package/dist/document/index.d.ts.map +1 -1
  673. package/dist/document/index.js +6 -1
  674. package/dist/document/index.js.map +1 -1
  675. package/dist/document/migrate.d.ts +70 -0
  676. package/dist/document/migrate.d.ts.map +1 -0
  677. package/dist/document/migrate.js +202 -0
  678. package/dist/document/migrate.js.map +1 -0
  679. package/dist/document/missing-node.d.ts +27 -0
  680. package/dist/document/missing-node.d.ts.map +1 -0
  681. package/dist/document/missing-node.js +48 -0
  682. package/dist/document/missing-node.js.map +1 -0
  683. package/dist/document/node-decorator.d.ts +14 -10
  684. package/dist/document/node-decorator.d.ts.map +1 -1
  685. package/dist/document/node-decorator.js +14 -10
  686. package/dist/document/node-decorator.js.map +1 -1
  687. package/dist/document/node-descriptor.d.ts +32 -3
  688. package/dist/document/node-descriptor.d.ts.map +1 -1
  689. package/dist/document/node-descriptor.js.map +1 -1
  690. package/dist/document/placement.d.ts +71 -0
  691. package/dist/document/placement.d.ts.map +1 -0
  692. package/dist/document/placement.js +83 -0
  693. package/dist/document/placement.js.map +1 -0
  694. package/dist/document/project.d.ts +4 -2
  695. package/dist/document/project.d.ts.map +1 -1
  696. package/dist/document/project.js +1 -0
  697. package/dist/document/project.js.map +1 -1
  698. package/dist/document/prop-evolution.d.ts +51 -0
  699. package/dist/document/prop-evolution.d.ts.map +1 -0
  700. package/dist/document/prop-evolution.js +83 -0
  701. package/dist/document/prop-evolution.js.map +1 -0
  702. package/dist/document/registry.d.ts +71 -44
  703. package/dist/document/registry.d.ts.map +1 -1
  704. package/dist/document/registry.js +94 -35
  705. package/dist/document/registry.js.map +1 -1
  706. package/dist/document/settled-index.d.ts +57 -0
  707. package/dist/document/settled-index.d.ts.map +1 -0
  708. package/dist/document/settled-index.js +264 -0
  709. package/dist/document/settled-index.js.map +1 -0
  710. package/dist/document/timeline-patch.d.ts +4 -0
  711. package/dist/document/timeline-patch.d.ts.map +1 -1
  712. package/dist/document/timeline-patch.js +28 -3
  713. package/dist/document/timeline-patch.js.map +1 -1
  714. package/dist/document/timeline.d.ts +145 -20
  715. package/dist/document/timeline.d.ts.map +1 -1
  716. package/dist/document/timeline.js +478 -80
  717. package/dist/document/timeline.js.map +1 -1
  718. package/dist/document/types.d.ts +30 -44
  719. package/dist/document/types.d.ts.map +1 -1
  720. package/dist/document/types.js +2 -2
  721. package/dist/document/types.js.map +1 -1
  722. package/dist/document/validate.d.ts +20 -8
  723. package/dist/document/validate.d.ts.map +1 -1
  724. package/dist/document/validate.js +195 -52
  725. package/dist/document/validate.js.map +1 -1
  726. package/dist/document/vocabulary.d.ts +28 -0
  727. package/dist/document/vocabulary.d.ts.map +1 -0
  728. package/dist/document/vocabulary.js +42 -0
  729. package/dist/document/vocabulary.js.map +1 -0
  730. package/dist/experimental.d.ts +82 -0
  731. package/dist/experimental.d.ts.map +1 -0
  732. package/dist/experimental.js +34 -0
  733. package/dist/experimental.js.map +1 -0
  734. package/dist/index.d.ts +11 -2
  735. package/dist/index.d.ts.map +1 -1
  736. package/dist/index.js +11 -2
  737. package/dist/index.js.map +1 -1
  738. package/dist/layout/bounds.d.ts +0 -1
  739. package/dist/layout/bounds.d.ts.map +1 -1
  740. package/dist/layout/bounds.js.map +1 -1
  741. package/dist/layout/flex.d.ts +4 -2
  742. package/dist/layout/flex.d.ts.map +1 -1
  743. package/dist/layout/flex.js +27 -11
  744. package/dist/layout/flex.js.map +1 -1
  745. package/dist/layout/ops.d.ts +6 -0
  746. package/dist/layout/ops.d.ts.map +1 -1
  747. package/dist/layout/ops.js +6 -0
  748. package/dist/layout/ops.js.map +1 -1
  749. package/dist/layout/types.d.ts +1 -1
  750. package/dist/layout/types.js.map +1 -1
  751. package/dist/platform/audio-sink.d.ts +2 -2
  752. package/dist/platform/audio-sink.d.ts.map +1 -1
  753. package/dist/platform/audio-sink.js.map +1 -1
  754. package/dist/platform/exporter.d.ts +26 -8
  755. package/dist/platform/exporter.d.ts.map +1 -1
  756. package/dist/platform/exporter.js.map +1 -1
  757. package/dist/platform/index.d.ts +1 -1
  758. package/dist/platform/index.d.ts.map +1 -1
  759. package/dist/platform/index.js.map +1 -1
  760. package/dist/platform/storage-adapter.d.ts +12 -6
  761. package/dist/platform/storage-adapter.d.ts.map +1 -1
  762. package/dist/platform/storage-adapter.js +4 -0
  763. package/dist/platform/storage-adapter.js.map +1 -1
  764. package/dist/platform/ticker.d.ts +6 -0
  765. package/dist/platform/ticker.d.ts.map +1 -1
  766. package/dist/platform/ticker.js +6 -0
  767. package/dist/platform/ticker.js.map +1 -1
  768. package/dist/project/tree.d.ts +3 -3
  769. package/dist/project/tree.d.ts.map +1 -1
  770. package/dist/project/tree.js.map +1 -1
  771. package/dist/props/host.d.ts +6 -1
  772. package/dist/props/host.d.ts.map +1 -1
  773. package/dist/props/host.js +3 -1
  774. package/dist/props/host.js.map +1 -1
  775. package/dist/props/layout.d.ts +29 -0
  776. package/dist/props/layout.d.ts.map +1 -0
  777. package/dist/props/layout.js +84 -0
  778. package/dist/props/layout.js.map +1 -0
  779. package/dist/props/slot.d.ts +1 -1
  780. package/dist/props/slot.js +1 -1
  781. package/dist/props/slot.js.map +1 -1
  782. package/dist/renamed-scene-names.d.ts +17 -0
  783. package/dist/renamed-scene-names.d.ts.map +1 -0
  784. package/dist/renamed-scene-names.js +9 -0
  785. package/dist/renamed-scene-names.js.map +1 -0
  786. package/dist/render/canvas-render-context2d.d.ts +19 -3
  787. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  788. package/dist/render/canvas-render-context2d.js +20 -0
  789. package/dist/render/canvas-render-context2d.js.map +1 -1
  790. package/dist/render/clip-contains.js +1 -1
  791. package/dist/render/clip-contains.js.map +1 -1
  792. package/dist/render/clip.d.ts +1 -1
  793. package/dist/render/clip.js +1 -1
  794. package/dist/render/clip.js.map +1 -1
  795. package/dist/render/descriptors/rect.js.map +1 -1
  796. package/dist/render/descriptors/shape.d.ts +12 -0
  797. package/dist/render/descriptors/shape.d.ts.map +1 -1
  798. package/dist/render/descriptors/shape.js.map +1 -1
  799. package/dist/render/descriptors/text.d.ts +15 -9
  800. package/dist/render/descriptors/text.d.ts.map +1 -1
  801. package/dist/render/descriptors/text.js +11 -5
  802. package/dist/render/descriptors/text.js.map +1 -1
  803. package/dist/render/descriptors/transform.d.ts +2 -2
  804. package/dist/render/descriptors/transform.d.ts.map +1 -1
  805. package/dist/render/descriptors/transform.js.map +1 -1
  806. package/dist/render/graphics2d.d.ts +3 -3
  807. package/dist/render/graphics2d.d.ts.map +1 -1
  808. package/dist/render/graphics2d.js +1 -1
  809. package/dist/render/graphics2d.js.map +1 -1
  810. package/dist/render/index.d.ts +2 -0
  811. package/dist/render/index.d.ts.map +1 -1
  812. package/dist/render/index.js +1 -0
  813. package/dist/render/index.js.map +1 -1
  814. package/dist/render/render-context2d.d.ts +8 -8
  815. package/dist/render/render-context2d.d.ts.map +1 -1
  816. package/dist/render/render-context2d.js.map +1 -1
  817. package/dist/render/render-issue.d.ts +39 -0
  818. package/dist/render/render-issue.d.ts.map +1 -0
  819. package/dist/render/render-issue.js +29 -0
  820. package/dist/render/render-issue.js.map +1 -0
  821. package/dist/render/surface.d.ts +2 -2
  822. package/dist/render/surface.js.map +1 -1
  823. package/dist/render3d/bounds3d.d.ts.map +1 -1
  824. package/dist/render3d/bounds3d.js +4 -2
  825. package/dist/render3d/bounds3d.js.map +1 -1
  826. package/dist/render3d/builders.d.ts +1 -1
  827. package/dist/render3d/builders.js +1 -1
  828. package/dist/render3d/builders.js.map +1 -1
  829. package/dist/render3d/camera.d.ts +6 -0
  830. package/dist/render3d/camera.d.ts.map +1 -1
  831. package/dist/render3d/camera.js +5 -3
  832. package/dist/render3d/camera.js.map +1 -1
  833. package/dist/render3d/fill3d.d.ts +2 -9
  834. package/dist/render3d/fill3d.d.ts.map +1 -1
  835. package/dist/render3d/fill3d.js +2 -13
  836. package/dist/render3d/fill3d.js.map +1 -1
  837. package/dist/render3d/geometry.d.ts +8 -1
  838. package/dist/render3d/geometry.d.ts.map +1 -1
  839. package/dist/render3d/geometry.js.map +1 -1
  840. package/dist/render3d/graphics3d.d.ts +21 -23
  841. package/dist/render3d/graphics3d.d.ts.map +1 -1
  842. package/dist/render3d/graphics3d.js +85 -34
  843. package/dist/render3d/graphics3d.js.map +1 -1
  844. package/dist/render3d/index.d.ts +1 -1
  845. package/dist/render3d/index.js +1 -1
  846. package/dist/render3d/index.js.map +1 -1
  847. package/dist/render3d/inert.d.ts +14 -0
  848. package/dist/render3d/inert.d.ts.map +1 -0
  849. package/dist/render3d/inert.js +62 -0
  850. package/dist/render3d/inert.js.map +1 -0
  851. package/dist/render3d/material.d.ts +10 -5
  852. package/dist/render3d/material.d.ts.map +1 -1
  853. package/dist/render3d/material.js.map +1 -1
  854. package/dist/render3d/resources.d.ts +2 -2
  855. package/dist/render3d/resources.js +2 -2
  856. package/dist/render3d/resources.js.map +1 -1
  857. package/dist/render3d/scene-settings.d.ts +23 -4
  858. package/dist/render3d/scene-settings.d.ts.map +1 -1
  859. package/dist/render3d/scene-settings.js.map +1 -1
  860. package/dist/render3d/scene3d.d.ts +12 -1
  861. package/dist/render3d/scene3d.d.ts.map +1 -1
  862. package/dist/render3d/scene3d.js +40 -7
  863. package/dist/render3d/scene3d.js.map +1 -1
  864. package/dist/render3d/texture.d.ts +11 -2
  865. package/dist/render3d/texture.d.ts.map +1 -1
  866. package/dist/render3d/texture.js +13 -0
  867. package/dist/render3d/texture.js.map +1 -1
  868. package/dist/render3d/transform.d.ts +1 -1
  869. package/dist/render3d/transform.js.map +1 -1
  870. package/dist/render3d/vector3.d.ts +20 -3
  871. package/dist/render3d/vector3.d.ts.map +1 -1
  872. package/dist/render3d/vector3.js +29 -2
  873. package/dist/render3d/vector3.js.map +1 -1
  874. package/dist/render3d/walk.d.ts +1 -1
  875. package/dist/render3d/walk.d.ts.map +1 -1
  876. package/dist/render3d/walk.js +5 -1
  877. package/dist/render3d/walk.js.map +1 -1
  878. package/dist/runtime/asset-refine.d.ts +1 -1
  879. package/dist/runtime/asset-refine.d.ts.map +1 -1
  880. package/dist/runtime/asset-refine.js +3 -2
  881. package/dist/runtime/asset-refine.js.map +1 -1
  882. package/dist/runtime/asset-timeline.d.ts +10 -0
  883. package/dist/runtime/asset-timeline.d.ts.map +1 -1
  884. package/dist/runtime/asset-timeline.js.map +1 -1
  885. package/dist/runtime/asset-update.d.ts.map +1 -1
  886. package/dist/runtime/asset-update.js +8 -1
  887. package/dist/runtime/asset-update.js.map +1 -1
  888. package/dist/runtime/audio-index.d.ts +0 -11
  889. package/dist/runtime/audio-index.d.ts.map +1 -1
  890. package/dist/runtime/audio-index.js +0 -19
  891. package/dist/runtime/audio-index.js.map +1 -1
  892. package/dist/runtime/clip-instance.d.ts +13 -6
  893. package/dist/runtime/clip-instance.d.ts.map +1 -1
  894. package/dist/runtime/clip-instance.js +34 -12
  895. package/dist/runtime/clip-instance.js.map +1 -1
  896. package/dist/runtime/clip-store.d.ts +20 -3
  897. package/dist/runtime/clip-store.d.ts.map +1 -1
  898. package/dist/runtime/clip-store.js +132 -27
  899. package/dist/runtime/clip-store.js.map +1 -1
  900. package/dist/runtime/engine.d.ts +13 -6
  901. package/dist/runtime/engine.d.ts.map +1 -1
  902. package/dist/runtime/engine.js +6 -3
  903. package/dist/runtime/engine.js.map +1 -1
  904. package/dist/runtime/frame-time.d.ts +31 -0
  905. package/dist/runtime/frame-time.d.ts.map +1 -0
  906. package/dist/runtime/frame-time.js +29 -0
  907. package/dist/runtime/frame-time.js.map +1 -0
  908. package/dist/runtime/index.d.ts +1 -0
  909. package/dist/runtime/index.d.ts.map +1 -1
  910. package/dist/runtime/index.js +1 -0
  911. package/dist/runtime/index.js.map +1 -1
  912. package/dist/runtime/node-picking.d.ts +45 -4
  913. package/dist/runtime/node-picking.d.ts.map +1 -1
  914. package/dist/runtime/node-picking.js +127 -13
  915. package/dist/runtime/node-picking.js.map +1 -1
  916. package/dist/runtime/node-picking3d.d.ts +14 -6
  917. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  918. package/dist/runtime/node-picking3d.js +10 -2
  919. package/dist/runtime/node-picking3d.js.map +1 -1
  920. package/dist/runtime/placement.d.ts.map +1 -1
  921. package/dist/runtime/placement.js +4 -5
  922. package/dist/runtime/placement.js.map +1 -1
  923. package/dist/runtime/playback-controller.d.ts +32 -3
  924. package/dist/runtime/playback-controller.d.ts.map +1 -1
  925. package/dist/runtime/playback-controller.js +78 -11
  926. package/dist/runtime/playback-controller.js.map +1 -1
  927. package/dist/runtime/session.d.ts +16 -10
  928. package/dist/runtime/session.d.ts.map +1 -1
  929. package/dist/runtime/session.js +23 -8
  930. package/dist/runtime/session.js.map +1 -1
  931. package/dist/runtime/state-evaluator.d.ts +2 -2
  932. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  933. package/dist/runtime/state-evaluator.js +4 -3
  934. package/dist/runtime/state-evaluator.js.map +1 -1
  935. package/dist/runtime/text-geometry.d.ts +2 -2
  936. package/dist/runtime/text-geometry.d.ts.map +1 -1
  937. package/dist/runtime/text-geometry.js +6 -3
  938. package/dist/runtime/text-geometry.js.map +1 -1
  939. package/dist/sdk/index.d.ts +70 -38
  940. package/dist/sdk/index.d.ts.map +1 -1
  941. package/dist/sdk/index.js +71 -46
  942. package/dist/sdk/index.js.map +1 -1
  943. package/dist/tween/command-decorator.d.ts +21 -8
  944. package/dist/tween/command-decorator.d.ts.map +1 -1
  945. package/dist/tween/command-decorator.js +12 -23
  946. package/dist/tween/command-decorator.js.map +1 -1
  947. package/dist/tween/command.d.ts +13 -1
  948. package/dist/tween/command.d.ts.map +1 -1
  949. package/dist/tween/command.js +14 -0
  950. package/dist/tween/command.js.map +1 -1
  951. package/dist/tween/ease/constants.d.ts.map +1 -1
  952. package/dist/tween/ease/constants.js +8 -5
  953. package/dist/tween/ease/constants.js.map +1 -1
  954. package/dist/tween/ease/curve.d.ts.map +1 -1
  955. package/dist/tween/ease/curve.js +4 -3
  956. package/dist/tween/ease/curve.js.map +1 -1
  957. package/dist/tween/ease/describe.d.ts +17 -0
  958. package/dist/tween/ease/describe.d.ts.map +1 -0
  959. package/dist/tween/ease/describe.js +41 -0
  960. package/dist/tween/ease/describe.js.map +1 -0
  961. package/dist/tween/ease/spec.d.ts +31 -0
  962. package/dist/tween/ease/spec.d.ts.map +1 -0
  963. package/dist/tween/ease/spec.js +51 -0
  964. package/dist/tween/ease/spec.js.map +1 -0
  965. package/dist/tween/index.d.ts +3 -1
  966. package/dist/tween/index.d.ts.map +1 -1
  967. package/dist/tween/index.js +2 -1
  968. package/dist/tween/index.js.map +1 -1
  969. package/dist/tween/loop.d.ts +1 -1
  970. package/dist/tween/loop.js +1 -1
  971. package/dist/tween/loop.js.map +1 -1
  972. package/dist/tween/prepare.d.ts +3 -3
  973. package/dist/tween/prepare.js +3 -3
  974. package/dist/tween/prepare.js.map +1 -1
  975. package/dist/util/metrics.d.ts +1 -1
  976. package/dist/util/metrics.js +1 -1
  977. package/dist/util/metrics.js.map +1 -1
  978. package/dist/util/reference.d.ts +6 -6
  979. package/dist/util/reference.js.map +1 -1
  980. package/package.json +8 -10
  981. package/dist/attributes/audio/filters/chain.d.ts +0 -113
  982. package/dist/attributes/audio/filters/chain.d.ts.map +0 -1
  983. package/dist/attributes/audio/filters/chain.js +0 -104
  984. package/dist/attributes/audio/filters/chain.js.map +0 -1
  985. package/dist/attributes/audio/filters/curve.d.ts +0 -152
  986. package/dist/attributes/audio/filters/curve.d.ts.map +0 -1
  987. package/dist/attributes/audio/filters/curve.js +0 -249
  988. package/dist/attributes/audio/filters/curve.js.map +0 -1
  989. package/dist/attributes/audio/filters/implementations/echo.d.ts +0 -14
  990. package/dist/attributes/audio/filters/implementations/echo.d.ts.map +0 -1
  991. package/dist/attributes/audio/filters/implementations/echo.js.map +0 -1
  992. package/dist/attributes/audio/filters/implementations/gain.d.ts +0 -10
  993. package/dist/attributes/audio/filters/implementations/gain.d.ts.map +0 -1
  994. package/dist/attributes/audio/filters/implementations/gain.js.map +0 -1
  995. package/dist/attributes/audio/filters/implementations/highpass.d.ts +0 -12
  996. package/dist/attributes/audio/filters/implementations/highpass.d.ts.map +0 -1
  997. package/dist/attributes/audio/filters/implementations/highpass.js.map +0 -1
  998. package/dist/attributes/audio/filters/implementations/lowpass.d.ts +0 -12
  999. package/dist/attributes/audio/filters/implementations/lowpass.d.ts.map +0 -1
  1000. package/dist/attributes/audio/filters/implementations/lowpass.js.map +0 -1
  1001. package/dist/attributes/audio/filters/implementations/speed.d.ts +0 -18
  1002. package/dist/attributes/audio/filters/implementations/speed.d.ts.map +0 -1
  1003. package/dist/attributes/audio/filters/implementations/speed.js +0 -6
  1004. package/dist/attributes/audio/filters/implementations/speed.js.map +0 -1
  1005. package/dist/attributes/audio/filters/implementations/tremolo.d.ts +0 -12
  1006. package/dist/attributes/audio/filters/implementations/tremolo.d.ts.map +0 -1
  1007. package/dist/attributes/audio/filters/implementations/tremolo.js.map +0 -1
  1008. package/dist/attributes/audio/filters/index.d.ts +0 -22
  1009. package/dist/attributes/audio/filters/index.d.ts.map +0 -1
  1010. package/dist/attributes/audio/filters/index.js +0 -8
  1011. package/dist/attributes/audio/filters/index.js.map +0 -1
  1012. package/dist/attributes/audio/filters/registry.d.ts +0 -36
  1013. package/dist/attributes/audio/filters/registry.d.ts.map +0 -1
  1014. package/dist/attributes/audio/filters/registry.js +0 -82
  1015. package/dist/attributes/audio/filters/registry.js.map +0 -1
  1016. package/dist/attributes/audio/filters/union.d.ts +0 -18
  1017. package/dist/attributes/audio/filters/union.d.ts.map +0 -1
  1018. package/dist/attributes/audio/filters/union.js +0 -28
  1019. package/dist/attributes/audio/filters/union.js.map +0 -1
  1020. package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
  1021. package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
  1022. package/dist/attributes/shape/effects/implementations/displace.js +0 -30
  1023. package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
  1024. package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
  1025. package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
  1026. package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
  1027. package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
  1028. package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
  1029. package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
  1030. package/dist/attributes/shape/effects/implementations/texture.js +0 -25
  1031. package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
  1032. package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
  1033. package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
  1034. package/dist/attributes/shape/effects/implementations/trails.js +0 -22
  1035. package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
  1036. package/dist/attributes/shape/sksl-uniforms.d.ts +0 -146
  1037. package/dist/attributes/shape/sksl-uniforms.d.ts.map +0 -1
  1038. package/dist/attributes/shape/sksl-uniforms.js +0 -0
  1039. package/dist/attributes/shape/sksl-uniforms.js.map +0 -1
  1040. package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
  1041. package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
  1042. package/dist/browser/chunks/chunk-P3XQCHDW.js +0 -16
  1043. package/dist/browser/chunks/chunk-P3XQCHDW.js.map +0 -7
  1044. package/dist/browser/chunks/chunk-VJQMKHGQ.js +0 -3
  1045. package/dist/browser/chunks/chunk-VJQMKHGQ.js.map +0 -7
  1046. package/dist/browser/jsx-jsx-dev-runtime.js +0 -2
  1047. package/dist/browser/jsx-jsx-dev-runtime.js.map +0 -7
  1048. package/dist/browser/jsx-jsx-runtime.js +0 -2
  1049. package/dist/browser/jsx-jsx-runtime.js.map +0 -7
  1050. package/dist/jsx/jsx-dev-runtime.d.ts +0 -3
  1051. package/dist/jsx/jsx-dev-runtime.d.ts.map +0 -1
  1052. package/dist/jsx/jsx-dev-runtime.js +0 -3
  1053. package/dist/jsx/jsx-dev-runtime.js.map +0 -1
  1054. package/dist/jsx/jsx-runtime.d.ts +0 -19
  1055. package/dist/jsx/jsx-runtime.d.ts.map +0 -1
  1056. package/dist/jsx/jsx-runtime.js +0 -16
  1057. package/dist/jsx/jsx-runtime.js.map +0 -1
  1058. package/dist/nodes/2d/node-lifecycle.d.ts.map +0 -1
  1059. package/dist/nodes/2d/node-lifecycle.js.map +0 -1
  1060. package/dist/nodes/2d/node-motion.d.ts.map +0 -1
  1061. package/dist/nodes/2d/node-motion.js.map +0 -1
  1062. package/dist/nodes/2d/node-render.d.ts +0 -44
  1063. package/dist/nodes/2d/node-render.d.ts.map +0 -1
  1064. package/dist/nodes/2d/node-render.js.map +0 -1
  1065. package/dist/nodes/2d/node-space.d.ts.map +0 -1
  1066. package/dist/nodes/2d/node-space.js.map +0 -1
  1067. package/dist/nodes/2d/node-transform.d.ts.map +0 -1
  1068. package/dist/nodes/2d/node-transform.js.map +0 -1
  1069. package/dist/nodes/2d/node2d.d.ts.map +0 -1
  1070. package/dist/nodes/2d/node2d.js.map +0 -1
  1071. package/dist/nodes/2d/paint-node.d.ts +0 -115
  1072. package/dist/nodes/2d/paint-node.d.ts.map +0 -1
  1073. package/dist/nodes/2d/paint-node.js +0 -190
  1074. package/dist/nodes/2d/paint-node.js.map +0 -1
  1075. package/dist/nodes/audio/audio-bus.d.ts +0 -28
  1076. package/dist/nodes/audio/audio-bus.d.ts.map +0 -1
  1077. package/dist/nodes/audio/audio-bus.js +0 -33
  1078. package/dist/nodes/audio/audio-bus.js.map +0 -1
  1079. package/dist/nodes/audio/index.d.ts +0 -4
  1080. package/dist/nodes/audio/index.d.ts.map +0 -1
  1081. package/dist/nodes/audio/index.js +0 -4
  1082. package/dist/nodes/audio/index.js.map +0 -1
  1083. package/dist/nodes/audio/node-audio.d.ts.map +0 -1
  1084. package/dist/nodes/audio/node-audio.js.map +0 -1
  1085. package/dist/nodes/audio/sound-node.d.ts +0 -40
  1086. package/dist/nodes/audio/sound-node.d.ts.map +0 -1
  1087. package/dist/nodes/audio/sound-node.js +0 -68
  1088. package/dist/nodes/audio/sound-node.js.map +0 -1
  1089. package/dist/nodes/geometry/boolean-node.d.ts +0 -28
  1090. package/dist/nodes/geometry/boolean-node.d.ts.map +0 -1
  1091. package/dist/nodes/geometry/boolean-node.js +0 -81
  1092. package/dist/nodes/geometry/boolean-node.js.map +0 -1
  1093. package/dist/nodes/geometry/bounds-shape-node.d.ts +0 -149
  1094. package/dist/nodes/geometry/bounds-shape-node.d.ts.map +0 -1
  1095. package/dist/nodes/geometry/bounds-shape-node.js +0 -181
  1096. package/dist/nodes/geometry/bounds-shape-node.js.map +0 -1
  1097. package/dist/nodes/geometry/box-path-node.d.ts +0 -89
  1098. package/dist/nodes/geometry/box-path-node.d.ts.map +0 -1
  1099. package/dist/nodes/geometry/box-path-node.js +0 -116
  1100. package/dist/nodes/geometry/box-path-node.js.map +0 -1
  1101. package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
  1102. package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
  1103. package/dist/nodes/geometry/dot-grid-node.js +0 -142
  1104. package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
  1105. package/dist/nodes/geometry/ellipse-node.d.ts +0 -18
  1106. package/dist/nodes/geometry/ellipse-node.d.ts.map +0 -1
  1107. package/dist/nodes/geometry/ellipse-node.js +0 -45
  1108. package/dist/nodes/geometry/ellipse-node.js.map +0 -1
  1109. package/dist/nodes/geometry/grid-lines.d.ts +0 -101
  1110. package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
  1111. package/dist/nodes/geometry/grid-lines.js +0 -128
  1112. package/dist/nodes/geometry/grid-lines.js.map +0 -1
  1113. package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
  1114. package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
  1115. package/dist/nodes/geometry/grid-pattern-node.js +0 -172
  1116. package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
  1117. package/dist/nodes/geometry/group-bounds.d.ts.map +0 -1
  1118. package/dist/nodes/geometry/group-bounds.js.map +0 -1
  1119. package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
  1120. package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
  1121. package/dist/nodes/geometry/line-grid-node.js +0 -127
  1122. package/dist/nodes/geometry/line-grid-node.js.map +0 -1
  1123. package/dist/nodes/geometry/line-node.d.ts +0 -58
  1124. package/dist/nodes/geometry/line-node.d.ts.map +0 -1
  1125. package/dist/nodes/geometry/line-node.js +0 -123
  1126. package/dist/nodes/geometry/line-node.js.map +0 -1
  1127. package/dist/nodes/geometry/mask-node.d.ts +0 -33
  1128. package/dist/nodes/geometry/mask-node.d.ts.map +0 -1
  1129. package/dist/nodes/geometry/mask-node.js +0 -66
  1130. package/dist/nodes/geometry/mask-node.js.map +0 -1
  1131. package/dist/nodes/geometry/path-node.d.ts +0 -26
  1132. package/dist/nodes/geometry/path-node.d.ts.map +0 -1
  1133. package/dist/nodes/geometry/path-node.js +0 -52
  1134. package/dist/nodes/geometry/path-node.js.map +0 -1
  1135. package/dist/nodes/geometry/polygon-node.d.ts +0 -26
  1136. package/dist/nodes/geometry/polygon-node.d.ts.map +0 -1
  1137. package/dist/nodes/geometry/polygon-node.js +0 -47
  1138. package/dist/nodes/geometry/polygon-node.js.map +0 -1
  1139. package/dist/nodes/geometry/polygram-node.d.ts +0 -33
  1140. package/dist/nodes/geometry/polygram-node.d.ts.map +0 -1
  1141. package/dist/nodes/geometry/polygram-node.js +0 -52
  1142. package/dist/nodes/geometry/polygram-node.js.map +0 -1
  1143. package/dist/nodes/geometry/rect-node.d.ts +0 -38
  1144. package/dist/nodes/geometry/rect-node.d.ts.map +0 -1
  1145. package/dist/nodes/geometry/rect-node.js +0 -56
  1146. package/dist/nodes/geometry/rect-node.js.map +0 -1
  1147. package/dist/nodes/geometry/shape-node.d.ts +0 -71
  1148. package/dist/nodes/geometry/shape-node.d.ts.map +0 -1
  1149. package/dist/nodes/geometry/shape-node.js +0 -140
  1150. package/dist/nodes/geometry/shape-node.js.map +0 -1
  1151. package/dist/nodes/geometry/shape-outline.d.ts.map +0 -1
  1152. package/dist/nodes/geometry/shape-outline.js.map +0 -1
  1153. package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
  1154. package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
  1155. package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
  1156. package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
  1157. package/dist/nodes/index.d.ts +0 -46
  1158. package/dist/nodes/index.d.ts.map +0 -1
  1159. package/dist/nodes/index.js +0 -54
  1160. package/dist/nodes/index.js.map +0 -1
  1161. package/dist/nodes/layout/camera-node.d.ts +0 -71
  1162. package/dist/nodes/layout/camera-node.d.ts.map +0 -1
  1163. package/dist/nodes/layout/camera-node.js +0 -118
  1164. package/dist/nodes/layout/camera-node.js.map +0 -1
  1165. package/dist/nodes/layout/orbit-camera-node.d.ts +0 -80
  1166. package/dist/nodes/layout/orbit-camera-node.d.ts.map +0 -1
  1167. package/dist/nodes/layout/orbit-camera-node.js +0 -118
  1168. package/dist/nodes/layout/orbit-camera-node.js.map +0 -1
  1169. package/dist/nodes/layout/rotated-box.d.ts +0 -20
  1170. package/dist/nodes/layout/rotated-box.d.ts.map +0 -1
  1171. package/dist/nodes/layout/rotated-box.js +0 -76
  1172. package/dist/nodes/layout/rotated-box.js.map +0 -1
  1173. package/dist/nodes/media/video-node.d.ts +0 -229
  1174. package/dist/nodes/media/video-node.d.ts.map +0 -1
  1175. package/dist/nodes/media/video-node.js +0 -348
  1176. package/dist/nodes/media/video-node.js.map +0 -1
  1177. package/dist/nodes/node/declare-paints.d.ts +0 -19
  1178. package/dist/nodes/node/declare-paints.d.ts.map +0 -1
  1179. package/dist/nodes/node/declare-paints.js +0 -27
  1180. package/dist/nodes/node/declare-paints.js.map +0 -1
  1181. package/dist/nodes/node/node-editor-state.d.ts.map +0 -1
  1182. package/dist/nodes/node/node-editor-state.js.map +0 -1
  1183. package/dist/nodes/node/node-reactive.d.ts.map +0 -1
  1184. package/dist/nodes/node/node-reactive.js.map +0 -1
  1185. package/dist/nodes/node/node-time.d.ts.map +0 -1
  1186. package/dist/nodes/node/node-time.js.map +0 -1
  1187. package/dist/nodes/node/node-walk.d.ts.map +0 -1
  1188. package/dist/nodes/node/node-walk.js.map +0 -1
  1189. package/dist/nodes/node/node.d.ts.map +0 -1
  1190. package/dist/nodes/node/node.js.map +0 -1
  1191. package/dist/nodes/node/text-defaults.d.ts.map +0 -1
  1192. package/dist/nodes/node/text-defaults.js.map +0 -1
  1193. package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
  1194. package/dist/nodes/scene/canvas2d-node.js.map +0 -1
  1195. package/dist/nodes/scene/provider-node.d.ts +0 -47
  1196. package/dist/nodes/scene/provider-node.d.ts.map +0 -1
  1197. package/dist/nodes/scene/provider-node.js +0 -63
  1198. package/dist/nodes/scene/provider-node.js.map +0 -1
  1199. package/dist/nodes/scene/theme-provider-node.d.ts +0 -29
  1200. package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
  1201. package/dist/nodes/scene/theme-provider-node.js +0 -43
  1202. package/dist/nodes/scene/theme-provider-node.js.map +0 -1
  1203. package/dist/nodes/text/default-text-style-node.d.ts +0 -100
  1204. package/dist/nodes/text/default-text-style-node.d.ts.map +0 -1
  1205. package/dist/nodes/text/default-text-style-node.js +0 -140
  1206. package/dist/nodes/text/default-text-style-node.js.map +0 -1
  1207. package/dist/nodes/text/number-format.d.ts.map +0 -1
  1208. package/dist/nodes/text/number-format.js.map +0 -1
  1209. package/dist/nodes/text/number-node.d.ts +0 -94
  1210. package/dist/nodes/text/number-node.d.ts.map +0 -1
  1211. package/dist/nodes/text/number-node.js +0 -86
  1212. package/dist/nodes/text/number-node.js.map +0 -1
  1213. package/dist/nodes/text/number-pattern.d.ts.map +0 -1
  1214. package/dist/nodes/text/number-pattern.js.map +0 -1
  1215. package/dist/nodes/text/richtext-node.d.ts +0 -73
  1216. package/dist/nodes/text/richtext-node.d.ts.map +0 -1
  1217. package/dist/nodes/text/richtext-node.js +0 -144
  1218. package/dist/nodes/text/richtext-node.js.map +0 -1
  1219. package/dist/nodes/text/text-base.d.ts +0 -135
  1220. package/dist/nodes/text/text-base.d.ts.map +0 -1
  1221. package/dist/nodes/text/text-base.js +0 -504
  1222. package/dist/nodes/text/text-base.js.map +0 -1
  1223. package/dist/nodes/text/text-node.d.ts +0 -84
  1224. package/dist/nodes/text/text-node.d.ts.map +0 -1
  1225. package/dist/nodes/text/text-node.js +0 -188
  1226. package/dist/nodes/text/text-node.js.map +0 -1
  1227. package/dist/nodes/text/text-selection.d.ts +0 -125
  1228. package/dist/nodes/text/text-selection.d.ts.map +0 -1
  1229. package/dist/nodes/text/text-selection.js +0 -209
  1230. package/dist/nodes/text/text-selection.js.map +0 -1
  1231. package/dist/nodes/three/camera-nodes.d.ts +0 -91
  1232. package/dist/nodes/three/camera-nodes.d.ts.map +0 -1
  1233. package/dist/nodes/three/camera-nodes.js +0 -71
  1234. package/dist/nodes/three/camera-nodes.js.map +0 -1
  1235. package/dist/nodes/three/canvas3d-node.d.ts +0 -270
  1236. package/dist/nodes/three/canvas3d-node.d.ts.map +0 -1
  1237. package/dist/nodes/three/canvas3d-node.js +0 -438
  1238. package/dist/nodes/three/canvas3d-node.js.map +0 -1
  1239. package/dist/nodes/three/drawable-nodes.d.ts +0 -159
  1240. package/dist/nodes/three/drawable-nodes.d.ts.map +0 -1
  1241. package/dist/nodes/three/drawable-nodes.js +0 -254
  1242. package/dist/nodes/three/drawable-nodes.js.map +0 -1
  1243. package/dist/nodes/three/environment-nodes.d.ts +0 -100
  1244. package/dist/nodes/three/environment-nodes.d.ts.map +0 -1
  1245. package/dist/nodes/three/environment-nodes.js +0 -134
  1246. package/dist/nodes/three/environment-nodes.js.map +0 -1
  1247. package/dist/nodes/three/geometry-nodes.d.ts +0 -197
  1248. package/dist/nodes/three/geometry-nodes.d.ts.map +0 -1
  1249. package/dist/nodes/three/geometry-nodes.js +0 -322
  1250. package/dist/nodes/three/geometry-nodes.js.map +0 -1
  1251. package/dist/nodes/three/grid-geometry3d.d.ts.map +0 -1
  1252. package/dist/nodes/three/grid-geometry3d.js.map +0 -1
  1253. package/dist/nodes/three/group3d.d.ts +0 -23
  1254. package/dist/nodes/three/group3d.d.ts.map +0 -1
  1255. package/dist/nodes/three/group3d.js +0 -21
  1256. package/dist/nodes/three/group3d.js.map +0 -1
  1257. package/dist/nodes/three/light-nodes.d.ts +0 -120
  1258. package/dist/nodes/three/light-nodes.d.ts.map +0 -1
  1259. package/dist/nodes/three/light-nodes.js +0 -173
  1260. package/dist/nodes/three/light-nodes.js.map +0 -1
  1261. package/dist/nodes/three/mesh3d.d.ts +0 -117
  1262. package/dist/nodes/three/mesh3d.d.ts.map +0 -1
  1263. package/dist/nodes/three/mesh3d.js +0 -147
  1264. package/dist/nodes/three/mesh3d.js.map +0 -1
  1265. package/dist/nodes/three/node3d.d.ts.map +0 -1
  1266. package/dist/nodes/three/node3d.js.map +0 -1
  1267. package/dist/render/descriptors/latex.d.ts +0 -6
  1268. package/dist/render/descriptors/latex.d.ts.map +0 -1
  1269. package/dist/render/descriptors/latex.js +0 -2
  1270. package/dist/render/descriptors/latex.js.map +0 -1
  1271. package/dist/tween/seekable.d.ts +0 -70
  1272. package/dist/tween/seekable.d.ts.map +0 -1
  1273. package/dist/tween/seekable.js +0 -122
  1274. package/dist/tween/seekable.js.map +0 -1
  1275. /package/dist/{nodes → components/builtins}/text/number-pattern.d.ts +0 -0
  1276. /package/dist/{nodes → components/builtins}/text/number-pattern.js +0 -0
  1277. /package/dist/{nodes → components/trees}/node/node-editor-state.d.ts +0 -0
  1278. /package/dist/{nodes → components/trees}/node/node-editor-state.js +0 -0
@@ -27,12 +27,16 @@ export class AssetNotLoadedError extends Error {
27
27
  /** The innermost drawing node, stamped by `Node2D.render` on the way out. */
28
28
  nodeId;
29
29
  constructor(assetType, src, hint) {
30
- super(`${assetType} asset "${src}" is not loaded. ` +
31
- (hint ?? `Declare it from the node's declareAssets() ` +
32
- `(e.g. assets.${assetType === "font" ? "font" : "image"}(...)), so the asset timeline loads it before this frame draws.`));
30
+ super(`${assetType} asset "${src}" is not loaded. ` + (hint ?? declareHint(assetType)));
33
31
  this.name = "AssetNotLoadedError";
34
32
  this.assetType = assetType;
35
33
  this.src = src;
36
34
  }
37
35
  }
36
+ /** How to declare an asset of `assetType`: the scope method, or a command's sound. */
37
+ function declareHint(assetType) {
38
+ if (assetType === "audio")
39
+ return "Play it from a command (`timeline.sound(...)`), so the asset timeline loads it before this frame draws.";
40
+ return `Declare it from the node's declareAssets() (e.g. assets.${assetType}(...)), so the asset timeline loads it before this frame draws.`;
41
+ }
38
42
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/assets/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACjC,SAAS,CAAY;IACrB,GAAG,CAAS;IACrB,6EAA6E;IAC7E,MAAM,CAAU;IAEhB,YAAY,SAAoB,EAAE,GAAW,EAAE,IAAa;QACxD,KAAK,CACD,GAAG,SAAS,WAAW,GAAG,mBAAmB;YAC7C,CAAC,IAAI,IAAI,6CAA6C;gBAClD,gBAAgB,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,iEAAiE,CAAC,CAChI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;CACJ","sourcesContent":["import type { AssetType } from \"./record\";\n\n/**\n * A frame reached for an asset that was never loaded.\n *\n * This is the counterweight to declared asset tracking. A node states what it\n * needs from `Node.declareAssets`; if it\n * misses something, the renderer finds nothing when it goes to paint. The old\n * inference pass could not really get this wrong — it discovered assets *from*\n * the draw calls, so anything drawn was by construction requested — and the\n * fills were written to match: a missing decode returned `false` and the layer\n * was quietly skipped.\n *\n * Under declarations that leniency is the wrong default. A skipped layer is a\n * frame that renders *almost* right, with a photo missing or a heading in the\n * fallback face, on a node that may only appear seconds in and only on a cold\n * load. Throwing turns a silent visual gap into a located failure: during precomp\n * it is caught per scene and surfaces as a `BuildError` in the errors panel, and\n * at playback it stops the frame rather than shipping a wrong one.\n *\n * It means \"declared but not loaded, or never declared\". It deliberately does\n * **not** cover a *time-varying* miss — a video frame the decode window has not\n * reached yet is an asset that loaded fine, and `warmPendingVideo` already exists\n * to settle those; those paths still paint the nearest decoded frame.\n */\nexport class AssetNotLoadedError extends Error {\n readonly assetType: AssetType;\n readonly src: string;\n /** The innermost drawing node, stamped by `Node2D.render` on the way out. */\n nodeId?: string;\n\n constructor(assetType: AssetType, src: string, hint?: string) {\n super(\n `${assetType} asset \"${src}\" is not loaded. ` +\n (hint ?? `Declare it from the node's declareAssets() ` +\n `(e.g. assets.${assetType === \"font\" ? \"font\" : \"image\"}(...)), so the asset timeline loads it before this frame draws.`)\n );\n this.name = \"AssetNotLoadedError\";\n this.assetType = assetType;\n this.src = src;\n }\n}\n"]}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/assets/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACjC,SAAS,CAAY;IACrB,GAAG,CAAS;IACrB,6EAA6E;IAC7E,MAAM,CAAU;IAEhB,YAAY,SAAoB,EAAE,GAAW,EAAE,IAAa;QACxD,KAAK,CAAC,GAAG,SAAS,WAAW,GAAG,mBAAmB,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;CACJ;AAED,sFAAsF;AACtF,SAAS,WAAW,CAAC,SAAoB;IACrC,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,yGAAyG,CAAC;IAC5I,OAAO,2DAA2D,SAAS,iEAAiE,CAAC;AACjJ,CAAC","sourcesContent":["import type { AssetType } from \"./record\";\n\n/**\n * A frame reached for an asset that was never loaded.\n *\n * This is the counterweight to declared asset tracking. A node states what it\n * needs from `Node.declareAssets`; if it\n * misses something, the renderer finds nothing when it goes to paint. The old\n * inference pass could not really get this wrong — it discovered assets *from*\n * the draw calls, so anything drawn was by construction requested — and the\n * fills were written to match: a missing decode returned `false` and the layer\n * was quietly skipped.\n *\n * Under declarations that leniency is the wrong default. A skipped layer is a\n * frame that renders *almost* right, with a photo missing or a heading in the\n * fallback face, on a node that may only appear seconds in and only on a cold\n * load. Throwing turns a silent visual gap into a located failure: during precomp\n * it is caught per scene and surfaces as a `BuildError` in the errors panel, and\n * at playback it stops the frame rather than shipping a wrong one.\n *\n * It means \"declared but not loaded, or never declared\". It deliberately does\n * **not** cover a *time-varying* miss — a video frame the decode window has not\n * reached yet is an asset that loaded fine, and `warmPendingVideo` already exists\n * to settle those; those paths still paint the nearest decoded frame.\n */\nexport class AssetNotLoadedError extends Error {\n readonly assetType: AssetType;\n readonly src: string;\n /** The innermost drawing node, stamped by `Node2D.render` on the way out. */\n nodeId?: string;\n\n constructor(assetType: AssetType, src: string, hint?: string) {\n super(`${assetType} asset \"${src}\" is not loaded. ` + (hint ?? declareHint(assetType)));\n this.name = \"AssetNotLoadedError\";\n this.assetType = assetType;\n this.src = src;\n }\n}\n\n/** How to declare an asset of `assetType`: the scope method, or a command's sound. */\nfunction declareHint(assetType: AssetType): string {\n if (assetType === \"audio\") return \"Play it from a command (`timeline.sound(...)`), so the asset timeline loads it before this frame draws.\";\n return `Declare it from the node's declareAssets() (e.g. assets.${assetType}(...)), so the asset timeline loads it before this frame draws.`;\n}\n"]}
@@ -7,6 +7,7 @@ import { AssetTimelineResult } from "../runtime/asset-timeline.js";
7
7
  * Wraps a {@link AssetTimelineResult} and delegates storage/audio work to platform adapters.
8
8
  */
9
9
  export declare class AssetManager {
10
+ private readonly onError;
10
11
  private precomp;
11
12
  private readonly storageAdapter;
12
13
  private readonly audioDevice;
@@ -14,11 +15,31 @@ export declare class AssetManager {
14
15
  private lastAudioRequestKey;
15
16
  private lastAudioSrcs;
16
17
  private audioFetching;
18
+ /**
19
+ * Sources whose fetch or decode failed, with why, so they are not fetched
20
+ * again every sync. A source leaves when no request in the window names it
21
+ * any more — and, once it has been reported, when a new precomp arrives —
22
+ * so the next time it is wanted it is tried afresh. One that failed quietly
23
+ * (see {@link AudioRequest.optional}) is kept across a precomp: a video with
24
+ * no audio track would otherwise be fetched whole on every edit.
25
+ */
26
+ private audioFailed;
27
+ /** The failed sources already reported to {@link onError}. */
28
+ private audioReported;
29
+ /** Sources a request in the last window asked for by name, not as a picture's own sound. */
30
+ private audioRequired;
31
+ /** Keys of the loaders a track measures against, which no window may evict. */
32
+ private layoutGateKeys;
33
+ private disposed;
17
34
  /** Disposers for loaders whose load has resolved, keyed by loader key. */
18
35
  private loaderDisposers;
19
36
  /** In-flight loader runs, keyed by loader key, to dedupe concurrent calls. */
20
37
  private loaderInFlight;
21
- constructor(precomp: AssetTimelineResult, storageAdapter: StorageAdapter, audioDevice: AudioSink);
38
+ /**
39
+ * @param onError Told once per source when audio a request asked for cannot
40
+ * be fetched or decoded. Defaults to `console.error`.
41
+ */
42
+ constructor(precomp: AssetTimelineResult, storageAdapter: StorageAdapter, audioDevice: AudioSink, onError?: (error: Error) => void);
22
43
  /**
23
44
  * Swap in a new precomp result (a document swap). The manager keeps its
24
45
  * warm loader disposers and in-flight audio fetches so a single-track edit
@@ -63,5 +84,9 @@ export declare class AssetManager {
63
84
  * render tick so the device stays in sync with the tracks' audio requests.
64
85
  */
65
86
  syncAudio(frame: number): void;
87
+ /** Record that `src` could not be loaded, and say so if a request asked for its sound. */
88
+ private failAudio;
89
+ /** Say that `src` could not be loaded, once, until it is wanted afresh. */
90
+ private reportAudio;
66
91
  }
67
92
  //# sourceMappingURL=manager.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/assets/manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAsB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAc,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IAExC,sFAAsF;IACtF,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,aAAa,CAAoC;IAEzD,0EAA0E;IAC1E,OAAO,CAAC,eAAe,CAA+B;IACtD,8EAA8E;IAC9E,OAAO,CAAC,cAAc,CAAoC;gBAGtD,OAAO,EAAE,mBAAmB,EAC5B,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,SAAS;IAS1B;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAM9C;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1C,0EAA0E;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB7B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAiBlB,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAqBjB,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAMf;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CA8CjC"}
1
+ {"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/assets/manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAsB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAc,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,YAAY;IAuCjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAtC5B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IAExC,sFAAsF;IACtF,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,aAAa,CAAoC;IACzD;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,CAA8B;IACjD,8DAA8D;IAC9D,OAAO,CAAC,aAAa,CAAqB;IAC1C,4FAA4F;IAC5F,OAAO,CAAC,aAAa,CAAkC;IACvD,+EAA+E;IAC/E,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAS;IAEzB,0EAA0E;IAC1E,OAAO,CAAC,eAAe,CAA+B;IACtD,8EAA8E;IAC9E,OAAO,CAAC,cAAc,CAAoC;IAE1D;;;OAGG;gBAEC,OAAO,EAAE,mBAAmB,EAC5B,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,SAAS,EACL,OAAO,GAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAkE;IAUlH;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAS9C;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1C,0EAA0E;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB7B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAqBlB,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAqBjB,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAOf;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwE9B,0FAA0F;IAC1F,OAAO,CAAC,SAAS;IAMjB,2EAA2E;IAC3E,OAAO,CAAC,WAAW;CAMtB"}
@@ -1,10 +1,13 @@
1
- import { filtersKey } from "../attributes/audio/filters/union.js";
2
- import { paramKey } from "../attributes/audio/filters/curve.js";
1
+ import { busStopKey } from "../attributes/audio/request.js";
2
+ import { effectsKey } from "../attributes/audio/effects/union.js";
3
+ import { paramKey } from "../attributes/audio/ramp.js";
4
+ import { transitionKey } from "../attributes/audio/transition.js";
3
5
  /**
4
6
  * Coordinates asset loading and audio synchronization during playback.
5
7
  * Wraps a {@link AssetTimelineResult} and delegates storage/audio work to platform adapters.
6
8
  */
7
9
  export class AssetManager {
10
+ onError;
8
11
  precomp;
9
12
  storageAdapter;
10
13
  audioDevice;
@@ -12,12 +15,34 @@ export class AssetManager {
12
15
  lastAudioRequestKey = "";
13
16
  lastAudioSrcs = new Set();
14
17
  audioFetching = new Map();
18
+ /**
19
+ * Sources whose fetch or decode failed, with why, so they are not fetched
20
+ * again every sync. A source leaves when no request in the window names it
21
+ * any more — and, once it has been reported, when a new precomp arrives —
22
+ * so the next time it is wanted it is tried afresh. One that failed quietly
23
+ * (see {@link AudioRequest.optional}) is kept across a precomp: a video with
24
+ * no audio track would otherwise be fetched whole on every edit.
25
+ */
26
+ audioFailed = new Map();
27
+ /** The failed sources already reported to {@link onError}. */
28
+ audioReported = new Set();
29
+ /** Sources a request in the last window asked for by name, not as a picture's own sound. */
30
+ audioRequired = new Set();
31
+ /** Keys of the loaders a track measures against, which no window may evict. */
32
+ layoutGateKeys;
33
+ disposed = false;
15
34
  /** Disposers for loaders whose load has resolved, keyed by loader key. */
16
35
  loaderDisposers = new Map();
17
36
  /** In-flight loader runs, keyed by loader key, to dedupe concurrent calls. */
18
37
  loaderInFlight = new Map();
19
- constructor(precomp, storageAdapter, audioDevice) {
38
+ /**
39
+ * @param onError Told once per source when audio a request asked for cannot
40
+ * be fetched or decoded. Defaults to `console.error`.
41
+ */
42
+ constructor(precomp, storageAdapter, audioDevice, onError = (error) => console.error(`[AssetManager] ${error.message}`)) {
43
+ this.onError = onError;
20
44
  this.precomp = precomp;
45
+ this.layoutGateKeys = layoutGatesOf(precomp);
21
46
  this.storageAdapter = storageAdapter;
22
47
  this.audioDevice = audioDevice;
23
48
  }
@@ -32,6 +57,10 @@ export class AssetManager {
32
57
  */
33
58
  setPrecomp(precomp) {
34
59
  this.precomp = precomp;
60
+ this.layoutGateKeys = layoutGatesOf(precomp);
61
+ for (const src of this.audioReported)
62
+ this.audioFailed.delete(src);
63
+ this.audioReported.clear();
35
64
  this.lastAudioRequestKey = null;
36
65
  this.lastAudioSrcs = null;
37
66
  }
@@ -102,6 +131,11 @@ export class AssetManager {
102
131
  const discardAt = track.discardAt ?? Infinity;
103
132
  const inWindow = track.cacheAt <= frame && frame <= discardAt;
104
133
  if (!inWindow) {
134
+ // A layout gate is loaded by `loadRecords` whatever frame is drawn, so
135
+ // its window says nothing about when it may go: disposing it here made
136
+ // `isReady` false and the next frame load it again.
137
+ if (this.layoutGateKeys.has(key))
138
+ return undefined;
105
139
  const dispose = this.loaderDisposers.get(key);
106
140
  if (dispose) {
107
141
  this.loaderDisposers.delete(key);
@@ -139,6 +173,7 @@ export class AssetManager {
139
173
  dispose();
140
174
  this.loaderDisposers.clear();
141
175
  this.loaderInFlight.clear();
176
+ this.disposed = true;
142
177
  }
143
178
  /**
144
179
  * Push the current audio working set to the AudioSink. Called after each
@@ -148,6 +183,7 @@ export class AssetManager {
148
183
  const currentTime = frame / this.precomp.fps;
149
184
  const inWindow = [];
150
185
  const srcs = new Set();
186
+ const required = new Set();
151
187
  const seen = new Set();
152
188
  /** Admit `req` if it overlaps the scheduling window, shifted by its owner's offset. */
153
189
  const consider = (req, offsetSecs) => {
@@ -155,11 +191,23 @@ export class AssetManager {
155
191
  const globalEnd = offsetSecs + req.endAt;
156
192
  if (globalEnd < currentTime || globalStart > currentTime + 10)
157
193
  return;
194
+ // Ahead of the dedupe: the flag is not part of a request's identity.
195
+ if (!req.optional)
196
+ required.add(req.src);
158
197
  const stableId = stableKey(req, offsetSecs);
159
198
  if (seen.has(stableId))
160
199
  return;
161
200
  seen.add(stableId);
162
- inWindow.push({ ...req, id: stableId, startAt: globalStart, endAt: globalEnd });
201
+ inWindow.push({
202
+ ...req,
203
+ id: stableId,
204
+ startAt: globalStart,
205
+ endAt: globalEnd,
206
+ // A bus's span is in its request's seconds, so it moves with it.
207
+ ...(req.bus && {
208
+ bus: req.bus.map((s) => ({ ...s, startAt: offsetSecs + s.startAt, endAt: offsetSecs + s.endAt })),
209
+ }),
210
+ });
163
211
  srcs.add(req.src);
164
212
  };
165
213
  for (const track of this.precomp.tracks) {
@@ -167,14 +215,28 @@ export class AssetManager {
167
215
  for (const req of track.audioRequests)
168
216
  consider(req, offsetSecs);
169
217
  }
218
+ this.audioRequired = required;
170
219
  for (const src of srcs) {
171
- if (!this.audioDevice.has(src) && !this.audioFetching.has(src)) {
220
+ if (!this.audioDevice.has(src) && !this.audioFetching.has(src) && !this.audioFailed.has(src)) {
172
221
  const job = this.storageAdapter.fetchAudioData(src)
173
222
  .then(data => this.audioDevice.append(src, data))
223
+ .catch(cause => this.failAudio(src, cause))
174
224
  .finally(() => this.audioFetching.delete(src));
175
225
  this.audioFetching.set(src, job);
176
226
  }
177
227
  }
228
+ // A failed source nothing asks for any more is forgotten, so wanting it
229
+ // again later tries it afresh; one that failed quietly is reported when
230
+ // a request that asks for its sound arrives.
231
+ for (const [src, cause] of this.audioFailed) {
232
+ if (!srcs.has(src)) {
233
+ this.audioFailed.delete(src);
234
+ this.audioReported.delete(src);
235
+ }
236
+ else if (required.has(src)) {
237
+ this.reportAudio(src, cause);
238
+ }
239
+ }
178
240
  const requestKey = audioSignature(inWindow);
179
241
  if (requestKey !== this.lastAudioRequestKey) {
180
242
  this.audioDevice.schedule(inWindow);
@@ -185,30 +247,52 @@ export class AssetManager {
185
247
  this.lastAudioSrcs = srcs;
186
248
  }
187
249
  }
250
+ /** Record that `src` could not be loaded, and say so if a request asked for its sound. */
251
+ failAudio(src, cause) {
252
+ if (this.disposed)
253
+ return;
254
+ this.audioFailed.set(src, cause);
255
+ if (this.audioRequired.has(src))
256
+ this.reportAudio(src, cause);
257
+ }
258
+ /** Say that `src` could not be loaded, once, until it is wanted afresh. */
259
+ reportAudio(src, cause) {
260
+ if (this.audioReported.has(src))
261
+ return;
262
+ this.audioReported.add(src);
263
+ const message = cause instanceof Error ? cause.message : String(cause);
264
+ this.onError(new Error(`audio "${src}" could not be loaded: ${message}`, { cause }));
265
+ }
188
266
  }
189
267
  // ─── Helpers ──────────────────────────────────────────────────────────────────
268
+ /** Every layout-gate key any track of `precomp` declares. */
269
+ function layoutGatesOf(precomp) {
270
+ const keys = new Set();
271
+ for (const track of precomp.tracks)
272
+ for (const key of track.layoutGates ?? [])
273
+ keys.add(key);
274
+ return keys;
275
+ }
190
276
  /** Stand-in for a loader that resolved nothing — see the note in {@link AssetManager.syncLoader}. */
191
277
  const NO_DISPOSE = () => { };
192
278
  /**
193
279
  * Produce a deterministic string key that uniquely identifies an audio request's
194
- * playback identity. Includes the filter chain (via {@link filtersKey}) so editing a
195
- * filter/volume curve changes the id — the device then stops the stale source and
196
- * rebuilds the graph with the new filters instead of reusing the old one.
280
+ * playback identity. Includes the effect chain, the ramps and the transitions so
281
+ * editing any of them changes the id — the device then stops the stale source and
282
+ * rebuilds the graph instead of reusing the old one.
197
283
  *
198
284
  * The bus chain is in for the same reason: re-routing a clip to a different bus,
199
- * or changing a bus's level, changes what it sounds like without changing
200
- * anything else here — so leaving it out would keep the stale graph.
285
+ * or changing a bus's level or its span, changes what it sounds like without
286
+ * changing anything else here — so leaving it out would keep the stale graph.
201
287
  */
202
- function stableKey(req, sceneOffsetSecs) {
203
- return `${req.src}|${sceneOffsetSecs + req.startAt}|${sceneOffsetSecs + req.endAt}|${req.trimStart}|${req.loop ? 1 : 0}|${req.volume}|${filtersKey(req.filters)}|${busKey(req.bus)}`;
288
+ function stableKey(req, clipOffsetSecs) {
289
+ return `${req.src}|${clipOffsetSecs + req.startAt}|${clipOffsetSecs + req.endAt}|${req.trimStart}|${req.trimEnd ?? "_"}|${req.loop ? 1 : 0}|${paramKey(req.volume)}|${paramKey(req.speed)}|${req.sourceLength ?? "_"}|${effectsKey(req.effects)}|${transitionKey(req.transitionIn)}|${transitionKey(req.transitionOut)}|${busKey(req.bus)}`;
204
290
  }
205
291
  /** The bus chain's contribution to {@link stableKey}. */
206
292
  function busKey(bus) {
207
293
  if (!bus || bus.length === 0)
208
294
  return "";
209
- return bus
210
- .map((s) => `${s.id}:${paramKey(s.volume)}:${paramKey(s.pan)}:${s.mute ? 1 : 0}:${filtersKey(s.filters)}`)
211
- .join(">");
295
+ return bus.map(busStopKey).join(">");
212
296
  }
213
297
  /** Produce a stable hash of the active audio request set to detect scheduling changes. */
214
298
  function audioSignature(reqs) {
@@ -1 +1 @@
1
- {"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/assets/manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioRequest } from \"@/attributes/audio/request\";\nimport { filtersKey } from \"@/attributes/audio/filters/union\";\nimport { paramKey } from \"@/attributes/audio/filters/curve\";\nimport { AssetRecord, Disposer, LoaderFn } from \"@/assets/record\";\nimport { AudioSink } from \"@/platform/audio-sink\";\nimport { StorageAdapter } from \"@/platform/storage-adapter\";\nimport { AssetTrack, AssetTimelineResult } from \"@/runtime/asset-timeline\";\n\n/**\n * Coordinates asset loading and audio synchronization during playback.\n * Wraps a {@link AssetTimelineResult} and delegates storage/audio work to platform adapters.\n */\nexport class AssetManager {\n private precomp: AssetTimelineResult;\n private readonly storageAdapter: StorageAdapter;\n private readonly audioDevice: AudioSink;\n\n /** `null` after a swap: whatever the device holds belongs to the previous precomp. */\n private lastAudioRequestKey: string | null = \"\";\n private lastAudioSrcs: ReadonlySet<string> | null = new Set();\n private audioFetching = new Map<string, Promise<void>>();\n\n /** Disposers for loaders whose load has resolved, keyed by loader key. */\n private loaderDisposers = new Map<string, Disposer>();\n /** In-flight loader runs, keyed by loader key, to dedupe concurrent calls. */\n private loaderInFlight = new Map<string, Promise<void>>();\n\n constructor(\n precomp: AssetTimelineResult,\n storageAdapter: StorageAdapter,\n audioDevice: AudioSink,\n ) {\n this.precomp = precomp;\n this.storageAdapter = storageAdapter;\n this.audioDevice = audioDevice;\n }\n\n // ─── Public surface ───────────────────────────────────────────────────────\n\n /**\n * Swap in a new precomp result (a document swap). The manager keeps its\n * warm loader disposers and in-flight audio fetches so a single-track edit\n * doesn't re-fetch unchanged assets; the next loadAt/syncAudio picks up the\n * new asset windows. Resetting the audio signature forces a reschedule so a\n * changed track's audio is re-evaluated against the new timeline — including\n * into an empty window, which is how removed audio stops.\n */\n setPrecomp(precomp: AssetTimelineResult): void {\n this.precomp = precomp;\n this.lastAudioRequestKey = null;\n this.lastAudioSrcs = null;\n }\n\n /**\n * Blocking load for seek and initial render. Waits for every asset whose\n * cacheAt <= frame and endFrame >= frame to be ready, then schedules audio.\n */\n async loadAt(frame: number): Promise<void> {\n const jobs: Promise<void>[] = [];\n\n for (const [key, track] of this.precomp.assets) {\n if (track.record.type === 'loader') {\n const job = this.syncLoader(key, track, frame);\n if (job) jobs.push(job);\n continue;\n }\n if (track.cacheAt <= frame && track.record.endFrame >= frame) {\n jobs.push(this.storageAdapter.loadAsset(key, track.record));\n }\n }\n\n await Promise.all(jobs);\n if (this.audioDevice.schedulesAudio) this.syncAudio(frame);\n }\n\n /** Whether `key` — a loader key or a stored asset's — is resident now. */\n isReady(key: string): boolean {\n return this.loaderDisposers.has(key) || this.storageAdapter.isLoaded(key);\n }\n\n /**\n * Load `records` whatever their windows say — for layout gates, which must be\n * resident before a track measures regardless of the frame being drawn.\n */\n async loadRecords(records: readonly AssetRecord[]): Promise<void> {\n await Promise.all(records.map((record) => record.type === 'loader'\n ? this.runLoader(record.src, record.load)\n : this.storageAdapter.loadAsset(record.src, record)));\n }\n\n /**\n * Non-blocking incremental prefetch called after each render tick. Fires\n * loads for assets whose cacheAt window has been reached without blocking.\n */\n prefetch(frame: number): void {\n for (const [key, track] of this.precomp.assets) {\n if (track.record.type === 'loader') {\n this.syncLoader(key, track, frame)?.catch(err => {\n console.error(`[AssetManager] loader failed for ${key}:`, err);\n });\n continue;\n }\n if (track.cacheAt <= frame && track.record.endFrame >= frame) {\n this.storageAdapter.loadAsset(key, track.record).catch(err => {\n console.error(`[AssetManager] prefetch failed for ${key}:`, err);\n });\n }\n }\n }\n\n /**\n * Drive a single loader track toward the state `frame` requires. If `frame`\n * is inside the loader's `[cacheAt, discardAt]` window, run its callback\n * (deduped — at most one in-flight run, skipped once loaded) and return the\n * pending job, if any. If `frame` is outside the window and the loader was\n * loaded, dispose it. Returns the in-flight load promise so a blocking\n * caller can await it; `undefined` when there's nothing to wait for.\n */\n private syncLoader(key: string, track: AssetTrack, frame: number): Promise<void> | undefined {\n if (track.record.type !== 'loader') return undefined;\n const discardAt = track.discardAt ?? Infinity;\n const inWindow = track.cacheAt <= frame && frame <= discardAt;\n\n if (!inWindow) {\n const dispose = this.loaderDisposers.get(key);\n if (dispose) {\n this.loaderDisposers.delete(key);\n dispose();\n }\n return undefined;\n }\n\n return this.runLoader(key, track.record.load);\n }\n\n /** Run a loader unless it is resident or already running. */\n private runLoader(key: string, load: LoaderFn): Promise<void> | undefined {\n // Already loaded for this window, or a run is already in flight.\n if (this.loaderDisposers.has(key)) return undefined;\n const existing = this.loaderInFlight.get(key);\n if (existing) return existing;\n\n const job = load()\n .then(disposer => {\n // A loader that resolves nothing is keeping its result resident on\n // purpose (see `LoaderFn`). Recording a no-op disposer rather than\n // skipping the entry is what keeps `loaderDisposers.has(key)` the\n // single \"already loaded\" test for both kinds.\n this.loaderDisposers.set(key, disposer ?? NO_DISPOSE);\n })\n .finally(() => {\n this.loaderInFlight.delete(key);\n });\n this.loaderInFlight.set(key, job);\n return job;\n }\n\n /** Run every outstanding loader disposer and clear loader state. */\n dispose(): void {\n for (const dispose of this.loaderDisposers.values()) dispose();\n this.loaderDisposers.clear();\n this.loaderInFlight.clear();\n }\n\n /**\n * Push the current audio working set to the AudioSink. Called after each\n * render tick so the device stays in sync with the tracks' audio requests.\n */\n syncAudio(frame: number): void {\n const currentTime = frame / this.precomp.fps;\n\n const inWindow: AudioRequest[] = [];\n const srcs = new Set<string>();\n const seen = new Set<string>();\n\n /** Admit `req` if it overlaps the scheduling window, shifted by its owner's offset. */\n const consider = (req: AudioRequest, offsetSecs: number): void => {\n const globalStart = offsetSecs + req.startAt;\n const globalEnd = offsetSecs + req.endAt;\n\n if (globalEnd < currentTime || globalStart > currentTime + 10) return;\n\n const stableId = stableKey(req, offsetSecs);\n if (seen.has(stableId)) return;\n seen.add(stableId);\n\n inWindow.push({ ...req, id: stableId, startAt: globalStart, endAt: globalEnd });\n srcs.add(req.src);\n };\n\n for (const track of this.precomp.tracks) {\n const offsetSecs = track.startFrame / this.precomp.fps;\n for (const req of track.audioRequests) consider(req, offsetSecs);\n }\n\n for (const src of srcs) {\n if (!this.audioDevice.has(src) && !this.audioFetching.has(src)) {\n const job = this.storageAdapter.fetchAudioData(src)\n .then(data => this.audioDevice.append(src, data))\n .finally(() => this.audioFetching.delete(src));\n this.audioFetching.set(src, job);\n }\n }\n\n const requestKey = audioSignature(inWindow);\n if (requestKey !== this.lastAudioRequestKey) {\n this.audioDevice.schedule(inWindow);\n this.lastAudioRequestKey = requestKey;\n }\n if (this.lastAudioSrcs === null || !setsEqual(this.lastAudioSrcs, srcs)) {\n this.audioDevice.retain(srcs);\n this.lastAudioSrcs = srcs;\n }\n }\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\n/** Stand-in for a loader that resolved nothing — see the note in {@link AssetManager.syncLoader}. */\nconst NO_DISPOSE: Disposer = () => { };\n\n/**\n * Produce a deterministic string key that uniquely identifies an audio request's\n * playback identity. Includes the filter chain (via {@link filtersKey}) so editing a\n * filter/volume curve changes the id — the device then stops the stale source and\n * rebuilds the graph with the new filters instead of reusing the old one.\n *\n * The bus chain is in for the same reason: re-routing a clip to a different bus,\n * or changing a bus's level, changes what it sounds like without changing\n * anything else here — so leaving it out would keep the stale graph.\n */\nfunction stableKey(req: AudioRequest, sceneOffsetSecs: number): string {\n return `${req.src}|${sceneOffsetSecs + req.startAt}|${sceneOffsetSecs + req.endAt}|${req.trimStart}|${req.loop ? 1 : 0}|${req.volume}|${filtersKey(req.filters)}|${busKey(req.bus)}`;\n}\n\n/** The bus chain's contribution to {@link stableKey}. */\nfunction busKey(bus: AudioRequest[\"bus\"]): string {\n if (!bus || bus.length === 0) return \"\";\n return bus\n .map((s) => `${s.id}:${paramKey(s.volume)}:${paramKey(s.pan)}:${s.mute ? 1 : 0}:${filtersKey(s.filters)}`)\n .join(\">\");\n}\n\n/** Produce a stable hash of the active audio request set to detect scheduling changes. */\nfunction audioSignature(reqs: readonly AudioRequest[]): string {\n if (reqs.length === 0) return \"\";\n return reqs.map(r => r.id).sort().join(\"\\n\");\n}\n\n/** Shallow equality check for two string sets (order-independent). */\nfunction setsEqual(a: ReadonlySet<string>, b: ReadonlySet<string>): boolean {\n if (a.size !== b.size) return false;\n for (const v of a) if (!b.has(v)) return false;\n return true;\n}\n"]}
1
+ {"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/assets/manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioRequest, busStopKey } from \"@/attributes/audio/request\";\nimport { effectsKey } from \"@/attributes/audio/effects/union\";\nimport { paramKey } from \"@/attributes/audio/ramp\";\nimport { transitionKey } from \"@/attributes/audio/transition\";\nimport { AssetRecord, Disposer, LoaderFn } from \"@/assets/record\";\nimport { AudioSink } from \"@/platform/audio-sink\";\nimport { StorageAdapter } from \"@/platform/storage-adapter\";\nimport { AssetTrack, AssetTimelineResult } from \"@/runtime/asset-timeline\";\n\n/**\n * Coordinates asset loading and audio synchronization during playback.\n * Wraps a {@link AssetTimelineResult} and delegates storage/audio work to platform adapters.\n */\nexport class AssetManager {\n private precomp: AssetTimelineResult;\n private readonly storageAdapter: StorageAdapter;\n private readonly audioDevice: AudioSink;\n\n /** `null` after a swap: whatever the device holds belongs to the previous precomp. */\n private lastAudioRequestKey: string | null = \"\";\n private lastAudioSrcs: ReadonlySet<string> | null = new Set();\n private audioFetching = new Map<string, Promise<void>>();\n /**\n * Sources whose fetch or decode failed, with why, so they are not fetched\n * again every sync. A source leaves when no request in the window names it\n * any more — and, once it has been reported, when a new precomp arrives —\n * so the next time it is wanted it is tried afresh. One that failed quietly\n * (see {@link AudioRequest.optional}) is kept across a precomp: a video with\n * no audio track would otherwise be fetched whole on every edit.\n */\n private audioFailed = new Map<string, unknown>();\n /** The failed sources already reported to {@link onError}. */\n private audioReported = new Set<string>();\n /** Sources a request in the last window asked for by name, not as a picture's own sound. */\n private audioRequired: ReadonlySet<string> = new Set();\n /** Keys of the loaders a track measures against, which no window may evict. */\n private layoutGateKeys: ReadonlySet<string>;\n private disposed = false;\n\n /** Disposers for loaders whose load has resolved, keyed by loader key. */\n private loaderDisposers = new Map<string, Disposer>();\n /** In-flight loader runs, keyed by loader key, to dedupe concurrent calls. */\n private loaderInFlight = new Map<string, Promise<void>>();\n\n /**\n * @param onError Told once per source when audio a request asked for cannot\n * be fetched or decoded. Defaults to `console.error`.\n */\n constructor(\n precomp: AssetTimelineResult,\n storageAdapter: StorageAdapter,\n audioDevice: AudioSink,\n private readonly onError: (error: Error) => void = (error) => console.error(`[AssetManager] ${error.message}`),\n ) {\n this.precomp = precomp;\n this.layoutGateKeys = layoutGatesOf(precomp);\n this.storageAdapter = storageAdapter;\n this.audioDevice = audioDevice;\n }\n\n // ─── Public surface ───────────────────────────────────────────────────────\n\n /**\n * Swap in a new precomp result (a document swap). The manager keeps its\n * warm loader disposers and in-flight audio fetches so a single-track edit\n * doesn't re-fetch unchanged assets; the next loadAt/syncAudio picks up the\n * new asset windows. Resetting the audio signature forces a reschedule so a\n * changed track's audio is re-evaluated against the new timeline — including\n * into an empty window, which is how removed audio stops.\n */\n setPrecomp(precomp: AssetTimelineResult): void {\n this.precomp = precomp;\n this.layoutGateKeys = layoutGatesOf(precomp);\n for (const src of this.audioReported) this.audioFailed.delete(src);\n this.audioReported.clear();\n this.lastAudioRequestKey = null;\n this.lastAudioSrcs = null;\n }\n\n /**\n * Blocking load for seek and initial render. Waits for every asset whose\n * cacheAt <= frame and endFrame >= frame to be ready, then schedules audio.\n */\n async loadAt(frame: number): Promise<void> {\n const jobs: Promise<void>[] = [];\n\n for (const [key, track] of this.precomp.assets) {\n if (track.record.type === 'loader') {\n const job = this.syncLoader(key, track, frame);\n if (job) jobs.push(job);\n continue;\n }\n if (track.cacheAt <= frame && track.record.endFrame >= frame) {\n jobs.push(this.storageAdapter.loadAsset(key, track.record));\n }\n }\n\n await Promise.all(jobs);\n if (this.audioDevice.schedulesAudio) this.syncAudio(frame);\n }\n\n /** Whether `key` — a loader key or a stored asset's — is resident now. */\n isReady(key: string): boolean {\n return this.loaderDisposers.has(key) || this.storageAdapter.isLoaded(key);\n }\n\n /**\n * Load `records` whatever their windows say — for layout gates, which must be\n * resident before a track measures regardless of the frame being drawn.\n */\n async loadRecords(records: readonly AssetRecord[]): Promise<void> {\n await Promise.all(records.map((record) => record.type === 'loader'\n ? this.runLoader(record.src, record.load)\n : this.storageAdapter.loadAsset(record.src, record)));\n }\n\n /**\n * Non-blocking incremental prefetch called after each render tick. Fires\n * loads for assets whose cacheAt window has been reached without blocking.\n */\n prefetch(frame: number): void {\n for (const [key, track] of this.precomp.assets) {\n if (track.record.type === 'loader') {\n this.syncLoader(key, track, frame)?.catch(err => {\n console.error(`[AssetManager] loader failed for ${key}:`, err);\n });\n continue;\n }\n if (track.cacheAt <= frame && track.record.endFrame >= frame) {\n this.storageAdapter.loadAsset(key, track.record).catch(err => {\n console.error(`[AssetManager] prefetch failed for ${key}:`, err);\n });\n }\n }\n }\n\n /**\n * Drive a single loader track toward the state `frame` requires. If `frame`\n * is inside the loader's `[cacheAt, discardAt]` window, run its callback\n * (deduped — at most one in-flight run, skipped once loaded) and return the\n * pending job, if any. If `frame` is outside the window and the loader was\n * loaded, dispose it. Returns the in-flight load promise so a blocking\n * caller can await it; `undefined` when there's nothing to wait for.\n */\n private syncLoader(key: string, track: AssetTrack, frame: number): Promise<void> | undefined {\n if (track.record.type !== 'loader') return undefined;\n const discardAt = track.discardAt ?? Infinity;\n const inWindow = track.cacheAt <= frame && frame <= discardAt;\n\n if (!inWindow) {\n // A layout gate is loaded by `loadRecords` whatever frame is drawn, so\n // its window says nothing about when it may go: disposing it here made\n // `isReady` false and the next frame load it again.\n if (this.layoutGateKeys.has(key)) return undefined;\n const dispose = this.loaderDisposers.get(key);\n if (dispose) {\n this.loaderDisposers.delete(key);\n dispose();\n }\n return undefined;\n }\n\n return this.runLoader(key, track.record.load);\n }\n\n /** Run a loader unless it is resident or already running. */\n private runLoader(key: string, load: LoaderFn): Promise<void> | undefined {\n // Already loaded for this window, or a run is already in flight.\n if (this.loaderDisposers.has(key)) return undefined;\n const existing = this.loaderInFlight.get(key);\n if (existing) return existing;\n\n const job = load()\n .then(disposer => {\n // A loader that resolves nothing is keeping its result resident on\n // purpose (see `LoaderFn`). Recording a no-op disposer rather than\n // skipping the entry is what keeps `loaderDisposers.has(key)` the\n // single \"already loaded\" test for both kinds.\n this.loaderDisposers.set(key, disposer ?? NO_DISPOSE);\n })\n .finally(() => {\n this.loaderInFlight.delete(key);\n });\n this.loaderInFlight.set(key, job);\n return job;\n }\n\n /** Run every outstanding loader disposer and clear loader state. */\n dispose(): void {\n for (const dispose of this.loaderDisposers.values()) dispose();\n this.loaderDisposers.clear();\n this.loaderInFlight.clear();\n this.disposed = true;\n }\n\n /**\n * Push the current audio working set to the AudioSink. Called after each\n * render tick so the device stays in sync with the tracks' audio requests.\n */\n syncAudio(frame: number): void {\n const currentTime = frame / this.precomp.fps;\n\n const inWindow: AudioRequest[] = [];\n const srcs = new Set<string>();\n const required = new Set<string>();\n const seen = new Set<string>();\n\n /** Admit `req` if it overlaps the scheduling window, shifted by its owner's offset. */\n const consider = (req: AudioRequest, offsetSecs: number): void => {\n const globalStart = offsetSecs + req.startAt;\n const globalEnd = offsetSecs + req.endAt;\n\n if (globalEnd < currentTime || globalStart > currentTime + 10) return;\n // Ahead of the dedupe: the flag is not part of a request's identity.\n if (!req.optional) required.add(req.src);\n\n const stableId = stableKey(req, offsetSecs);\n if (seen.has(stableId)) return;\n seen.add(stableId);\n\n inWindow.push({\n ...req,\n id: stableId,\n startAt: globalStart,\n endAt: globalEnd,\n // A bus's span is in its request's seconds, so it moves with it.\n ...(req.bus && {\n bus: req.bus.map((s) => ({ ...s, startAt: offsetSecs + s.startAt, endAt: offsetSecs + s.endAt })),\n }),\n });\n srcs.add(req.src);\n };\n\n for (const track of this.precomp.tracks) {\n const offsetSecs = track.startFrame / this.precomp.fps;\n for (const req of track.audioRequests) consider(req, offsetSecs);\n }\n\n this.audioRequired = required;\n for (const src of srcs) {\n if (!this.audioDevice.has(src) && !this.audioFetching.has(src) && !this.audioFailed.has(src)) {\n const job = this.storageAdapter.fetchAudioData(src)\n .then(data => this.audioDevice.append(src, data))\n .catch(cause => this.failAudio(src, cause))\n .finally(() => this.audioFetching.delete(src));\n this.audioFetching.set(src, job);\n }\n }\n // A failed source nothing asks for any more is forgotten, so wanting it\n // again later tries it afresh; one that failed quietly is reported when\n // a request that asks for its sound arrives.\n for (const [src, cause] of this.audioFailed) {\n if (!srcs.has(src)) {\n this.audioFailed.delete(src);\n this.audioReported.delete(src);\n } else if (required.has(src)) {\n this.reportAudio(src, cause);\n }\n }\n\n const requestKey = audioSignature(inWindow);\n if (requestKey !== this.lastAudioRequestKey) {\n this.audioDevice.schedule(inWindow);\n this.lastAudioRequestKey = requestKey;\n }\n if (this.lastAudioSrcs === null || !setsEqual(this.lastAudioSrcs, srcs)) {\n this.audioDevice.retain(srcs);\n this.lastAudioSrcs = srcs;\n }\n }\n\n /** Record that `src` could not be loaded, and say so if a request asked for its sound. */\n private failAudio(src: string, cause: unknown): void {\n if (this.disposed) return;\n this.audioFailed.set(src, cause);\n if (this.audioRequired.has(src)) this.reportAudio(src, cause);\n }\n\n /** Say that `src` could not be loaded, once, until it is wanted afresh. */\n private reportAudio(src: string, cause: unknown): void {\n if (this.audioReported.has(src)) return;\n this.audioReported.add(src);\n const message = cause instanceof Error ? cause.message : String(cause);\n this.onError(new Error(`audio \"${src}\" could not be loaded: ${message}`, { cause }));\n }\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\n/** Every layout-gate key any track of `precomp` declares. */\nfunction layoutGatesOf(precomp: AssetTimelineResult): ReadonlySet<string> {\n const keys = new Set<string>();\n for (const track of precomp.tracks) for (const key of track.layoutGates ?? []) keys.add(key);\n return keys;\n}\n\n/** Stand-in for a loader that resolved nothing — see the note in {@link AssetManager.syncLoader}. */\nconst NO_DISPOSE: Disposer = () => { };\n\n/**\n * Produce a deterministic string key that uniquely identifies an audio request's\n * playback identity. Includes the effect chain, the ramps and the transitions so\n * editing any of them changes the id — the device then stops the stale source and\n * rebuilds the graph instead of reusing the old one.\n *\n * The bus chain is in for the same reason: re-routing a clip to a different bus,\n * or changing a bus's level or its span, changes what it sounds like without\n * changing anything else here — so leaving it out would keep the stale graph.\n */\nfunction stableKey(req: AudioRequest, clipOffsetSecs: number): string {\n return `${req.src}|${clipOffsetSecs + req.startAt}|${clipOffsetSecs + req.endAt}|${req.trimStart}|${req.trimEnd ?? \"_\"}|${req.loop ? 1 : 0}|${paramKey(req.volume)}|${paramKey(req.speed)}|${req.sourceLength ?? \"_\"}|${effectsKey(req.effects)}|${transitionKey(req.transitionIn)}|${transitionKey(req.transitionOut)}|${busKey(req.bus)}`;\n}\n\n/** The bus chain's contribution to {@link stableKey}. */\nfunction busKey(bus: AudioRequest[\"bus\"]): string {\n if (!bus || bus.length === 0) return \"\";\n return bus.map(busStopKey).join(\">\");\n}\n\n/** Produce a stable hash of the active audio request set to detect scheduling changes. */\nfunction audioSignature(reqs: readonly AudioRequest[]): string {\n if (reqs.length === 0) return \"\";\n return reqs.map(r => r.id).sort().join(\"\\n\");\n}\n\n/** Shallow equality check for two string sets (order-independent). */\nfunction setsEqual(a: ReadonlySet<string>, b: ReadonlySet<string>): boolean {\n if (a.size !== b.size) return false;\n for (const v of a) if (!b.has(v)) return false;\n return true;\n}\n"]}
@@ -1,8 +1,8 @@
1
1
  import type { AssetCatalog } from "./catalog.js";
2
2
  import type { LoaderFn } from "./record.js";
3
3
  import type { FillResolved } from "../attributes/shape/fill/union.js";
4
- import type { SceneEffect } from "../attributes/shape/effects/union.js";
5
- import type { Node } from "../nodes/node/node.js";
4
+ import type { NodeEffect } from "../attributes/shape/effects/union.js";
5
+ import type { Node } from "../components/trees/node/node.js";
6
6
  /** Whether an asset has to be resident before layout measures, or only before a frame draws. */
7
7
  export type AssetGate = "layout" | "render";
8
8
  export type AssetDecl = {
@@ -44,7 +44,7 @@ export interface AssetScope {
44
44
  gate?: AssetGate;
45
45
  }): void;
46
46
  fill(fills: FillResolved | readonly FillResolved[]): void;
47
- effects(effects: readonly SceneEffect[]): void;
47
+ effects(effects: readonly NodeEffect[]): void;
48
48
  /** A detached subtree this node draws (a `Tex.surface` node source), declared as part of this node. */
49
49
  subtree(node: Node): void;
50
50
  }
@@ -82,7 +82,7 @@ export declare class AssetDeclaration implements AssetScope {
82
82
  gate?: AssetGate;
83
83
  }): void;
84
84
  fill(fills: FillResolved | readonly FillResolved[]): void;
85
- effects(effects: readonly SceneEffect[]): void;
85
+ effects(effects: readonly NodeEffect[]): void;
86
86
  subtree(node: Node): void;
87
87
  private readonly _options;
88
88
  private readonly _decls;
@@ -1 +1 @@
1
- {"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/assets/scope.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/assets/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAKzD,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,uDAAuD;IACvD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrD,wFAAwF;IACxF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;IAC1D,OAAO,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC;IAC9C,uGAAuG;IACvG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAUhD;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED,MAAM,WAAW,uBAAuB;IACpC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvD;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IAC/C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;gBAEnB,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,uBAA4B;IAKxE,IAAI,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAEjD;IAID,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMxB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWjE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAoBzE,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,IAAI;IASzD,OAAO,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAK7C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IASzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAwB;CAC5C"}
@@ -1,6 +1,6 @@
1
1
  import { declareFill } from "../attributes/shape/fill/registry.js";
2
2
  import { declareEffect } from "../attributes/shape/effects/registry.js";
3
- import { declareTree } from "../nodes/node/node-walk.js";
3
+ import { declareTree } from "../components/trees/node/node-walk.js";
4
4
  /**
5
5
  * Fonts key by family alone: `loadFont` registers every weight of a family at once
6
6
  * and a variable weight renders through `fontVariations`, so a weight in the key
@@ -1 +1 @@
1
- {"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/assets/scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssetCatalog } from \"./catalog\";\nimport type { LoaderFn } from \"./record\";\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\nimport type { SceneEffect } from \"@/attributes/shape/effects/union\";\nimport type { Node } from \"@/nodes/node/node\";\nimport { declareFill } from \"@/attributes/shape/fill/registry\";\nimport { declareEffect } from \"@/attributes/shape/effects/registry\";\nimport { declareTree } from \"@/nodes/node/node-walk\";\n\n/** Whether an asset has to be resident before layout measures, or only before a frame draws. */\nexport type AssetGate = \"layout\" | \"render\";\n\nexport type AssetDecl =\n | { type: \"image\"; src: string }\n | { type: \"video\"; src: string; trimStart: number; trimEnd: number }\n | { type: \"font\"; family: string; weight: number }\n | { type: \"loader\"; key: string; load: LoaderFn; gate: AssetGate };\n\n/**\n * What a node's `declareAssets` states its needs into.\n *\n * A declaration must be a pure function of the props and context it reads — never\n * `layoutBounds`, never `time`, no writes — because the runtime re-runs it only\n * when something it read changes. Declarations dedupe by {@link assetKey}.\n */\nexport interface AssetScope {\n readonly catalog: AssetCatalog;\n image(src: string): void;\n video(src: string, trim?: { start?: number; end?: number }): void;\n /** Gates layout: text is measured against the face. */\n font(family: string, weight?: number | string): void;\n /** `gate` defaults to `\"render\"`; pass `\"layout\"` for a load measurement depends on. */\n loader(key: string, load: LoaderFn, options?: { gate?: AssetGate }): void;\n fill(fills: FillResolved | readonly FillResolved[]): void;\n effects(effects: readonly SceneEffect[]): void;\n /** A detached subtree this node draws (a `Tex.surface` node source), declared as part of this node. */\n subtree(node: Node): void;\n}\n\n/**\n * Fonts key by family alone: `loadFont` registers every weight of a family at once\n * and a variable weight renders through `fontVariations`, so a weight in the key\n * would mint an entry per frame of a weight tween.\n */\nexport function assetKey(decl: AssetDecl): string {\n switch (decl.type) {\n case \"image\":\n case \"video\":\n return decl.src;\n case \"font\":\n return decl.family;\n case \"loader\":\n return decl.key;\n }\n}\n\n/** Anything unparseable lands on 400, which is what an unspecified weight means anyway. */\nexport function normalizeWeight(weight: number | string | undefined): number {\n if (typeof weight === \"number\") return Number.isFinite(weight) ? weight : 400;\n if (typeof weight === \"string\") return parseInt(weight, 10) || 400;\n return 400;\n}\n\nexport interface AssetDeclarationOptions {\n /** Binds a detached subtree (catalog, context, clock) before it declares. */\n bindSubtree?: (node: Node) => void;\n /** Replaces the default {@link declareTree} walk over a subtree. */\n onSubtree?: (node: Node, scope: AssetScope) => void;\n}\n\n/**\n * The {@link AssetScope} that collects: one declaration pass, keyed and validated.\n *\n * Unknown images and videos throw here, so a typo surfaces against the node that\n * declared it rather than as a picture that never paints.\n */\nexport class AssetDeclaration implements AssetScope {\n readonly catalog: AssetCatalog;\n\n constructor(catalog: AssetCatalog, options: AssetDeclarationOptions = {}) {\n this.catalog = catalog;\n this._options = options;\n }\n\n get declarations(): ReadonlyMap<string, AssetDecl> {\n return this._decls;\n }\n\n // An empty `src` is an unset media slot — it paints the checkerboard, not a\n // missing asset — so it declares nothing.\n image(src: string): void {\n if (!src || this._decls.has(src)) return;\n this.catalog.getImageMeta(src);\n this._decls.set(src, { type: \"image\", src });\n }\n\n video(src: string, trim?: { start?: number; end?: number }): void {\n if (!src || this._decls.has(src)) return;\n this.catalog.getVideoMeta(src);\n this._decls.set(src, {\n type: \"video\",\n src,\n trimStart: trim?.start ?? 0,\n trimEnd: trim?.end ?? this.catalog.getVideoDuration(src),\n });\n }\n\n font(family: string, weight?: number | string): void {\n if (!family || this._decls.has(family)) return;\n this._decls.set(family, { type: \"font\", family, weight: normalizeWeight(weight) });\n }\n\n loader(key: string, load: LoaderFn, options?: { gate?: AssetGate }): void {\n const gate = options?.gate ?? \"render\";\n const existing = this._decls.get(key);\n if (existing === undefined) {\n this._decls.set(key, { type: \"loader\", key, load, gate });\n return;\n }\n if (existing.type !== \"loader\") return;\n if (existing.load !== load && process.env.NODE_ENV !== \"production\") {\n console.warn(\n `[assets] Loader \"${key}\" was declared with a different load function; the first is kept. ` +\n `Hoist the function so every declaration of the key hands over the same one.`,\n );\n }\n // Layout is the stricter gate, so it wins whichever declaration asked first.\n if (gate === \"layout\" && existing.gate !== \"layout\") {\n this._decls.set(key, { ...existing, gate });\n }\n }\n\n fill(fills: FillResolved | readonly FillResolved[]): void {\n if (!fills) return;\n if (!Array.isArray(fills)) {\n declareFill(fills as FillResolved, this);\n return;\n }\n for (const fill of fills as readonly FillResolved[]) declareFill(fill, this);\n }\n\n effects(effects: readonly SceneEffect[]): void {\n if (!effects) return;\n for (const effect of effects) declareEffect(effect, this);\n }\n\n subtree(node: Node): void {\n this._subtrees ??= new Set();\n if (this._subtrees.has(node)) return;\n this._subtrees.add(node);\n this._options.bindSubtree?.(node);\n if (this._options.onSubtree) this._options.onSubtree(node, this);\n else declareTree(node, this);\n }\n\n private readonly _options: AssetDeclarationOptions;\n private readonly _decls = new Map<string, AssetDecl>();\n private _subtrees: Set<Node> | undefined;\n}\n"]}
1
+ {"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/assets/scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssetCatalog } from \"./catalog\";\nimport type { LoaderFn } from \"./record\";\nimport type { FillResolved } from \"@/attributes/shape/fill/union\";\nimport type { NodeEffect } from \"@/attributes/shape/effects/union\";\nimport type { Node } from \"@/components/trees/node/node\";\nimport { declareFill } from \"@/attributes/shape/fill/registry\";\nimport { declareEffect } from \"@/attributes/shape/effects/registry\";\nimport { declareTree } from \"@/components/trees/node/node-walk\";\n\n/** Whether an asset has to be resident before layout measures, or only before a frame draws. */\nexport type AssetGate = \"layout\" | \"render\";\n\nexport type AssetDecl =\n | { type: \"image\"; src: string }\n | { type: \"video\"; src: string; trimStart: number; trimEnd: number }\n | { type: \"font\"; family: string; weight: number }\n | { type: \"loader\"; key: string; load: LoaderFn; gate: AssetGate };\n\n/**\n * What a node's `declareAssets` states its needs into.\n *\n * A declaration must be a pure function of the props and context it reads — never\n * `layoutBounds`, never `time`, no writes — because the runtime re-runs it only\n * when something it read changes. Declarations dedupe by {@link assetKey}.\n */\nexport interface AssetScope {\n readonly catalog: AssetCatalog;\n image(src: string): void;\n video(src: string, trim?: { start?: number; end?: number }): void;\n /** Gates layout: text is measured against the face. */\n font(family: string, weight?: number | string): void;\n /** `gate` defaults to `\"render\"`; pass `\"layout\"` for a load measurement depends on. */\n loader(key: string, load: LoaderFn, options?: { gate?: AssetGate }): void;\n fill(fills: FillResolved | readonly FillResolved[]): void;\n effects(effects: readonly NodeEffect[]): void;\n /** A detached subtree this node draws (a `Tex.surface` node source), declared as part of this node. */\n subtree(node: Node): void;\n}\n\n/**\n * Fonts key by family alone: `loadFont` registers every weight of a family at once\n * and a variable weight renders through `fontVariations`, so a weight in the key\n * would mint an entry per frame of a weight tween.\n */\nexport function assetKey(decl: AssetDecl): string {\n switch (decl.type) {\n case \"image\":\n case \"video\":\n return decl.src;\n case \"font\":\n return decl.family;\n case \"loader\":\n return decl.key;\n }\n}\n\n/** Anything unparseable lands on 400, which is what an unspecified weight means anyway. */\nexport function normalizeWeight(weight: number | string | undefined): number {\n if (typeof weight === \"number\") return Number.isFinite(weight) ? weight : 400;\n if (typeof weight === \"string\") return parseInt(weight, 10) || 400;\n return 400;\n}\n\nexport interface AssetDeclarationOptions {\n /** Binds a detached subtree (catalog, context, clock) before it declares. */\n bindSubtree?: (node: Node) => void;\n /** Replaces the default {@link declareTree} walk over a subtree. */\n onSubtree?: (node: Node, scope: AssetScope) => void;\n}\n\n/**\n * The {@link AssetScope} that collects: one declaration pass, keyed and validated.\n *\n * Unknown images and videos throw here, so a typo surfaces against the node that\n * declared it rather than as a picture that never paints.\n */\nexport class AssetDeclaration implements AssetScope {\n readonly catalog: AssetCatalog;\n\n constructor(catalog: AssetCatalog, options: AssetDeclarationOptions = {}) {\n this.catalog = catalog;\n this._options = options;\n }\n\n get declarations(): ReadonlyMap<string, AssetDecl> {\n return this._decls;\n }\n\n // An empty `src` is an unset media slot — it paints the checkerboard, not a\n // missing asset — so it declares nothing.\n image(src: string): void {\n if (!src || this._decls.has(src)) return;\n this.catalog.getImageMeta(src);\n this._decls.set(src, { type: \"image\", src });\n }\n\n video(src: string, trim?: { start?: number; end?: number }): void {\n if (!src || this._decls.has(src)) return;\n this.catalog.getVideoMeta(src);\n this._decls.set(src, {\n type: \"video\",\n src,\n trimStart: trim?.start ?? 0,\n trimEnd: trim?.end ?? this.catalog.getVideoDuration(src),\n });\n }\n\n font(family: string, weight?: number | string): void {\n if (!family || this._decls.has(family)) return;\n this._decls.set(family, { type: \"font\", family, weight: normalizeWeight(weight) });\n }\n\n loader(key: string, load: LoaderFn, options?: { gate?: AssetGate }): void {\n const gate = options?.gate ?? \"render\";\n const existing = this._decls.get(key);\n if (existing === undefined) {\n this._decls.set(key, { type: \"loader\", key, load, gate });\n return;\n }\n if (existing.type !== \"loader\") return;\n if (existing.load !== load && process.env.NODE_ENV !== \"production\") {\n console.warn(\n `[assets] Loader \"${key}\" was declared with a different load function; the first is kept. ` +\n `Hoist the function so every declaration of the key hands over the same one.`,\n );\n }\n // Layout is the stricter gate, so it wins whichever declaration asked first.\n if (gate === \"layout\" && existing.gate !== \"layout\") {\n this._decls.set(key, { ...existing, gate });\n }\n }\n\n fill(fills: FillResolved | readonly FillResolved[]): void {\n if (!fills) return;\n if (!Array.isArray(fills)) {\n declareFill(fills as FillResolved, this);\n return;\n }\n for (const fill of fills as readonly FillResolved[]) declareFill(fill, this);\n }\n\n effects(effects: readonly NodeEffect[]): void {\n if (!effects) return;\n for (const effect of effects) declareEffect(effect, this);\n }\n\n subtree(node: Node): void {\n this._subtrees ??= new Set();\n if (this._subtrees.has(node)) return;\n this._subtrees.add(node);\n this._options.bindSubtree?.(node);\n if (this._options.onSubtree) this._options.onSubtree(node, this);\n else declareTree(node, this);\n }\n\n private readonly _options: AssetDeclarationOptions;\n private readonly _decls = new Map<string, AssetDecl>();\n private _subtrees: Set<Node> | undefined;\n}\n"]}
@@ -0,0 +1,73 @@
1
+ import { AudioEffect } from "./union.js";
2
+ import { Param } from "../ramp.js";
3
+ /**
4
+ * Every builder takes one options object, and those with one dominant param
5
+ * also take that param directly — a number or a {@link Ramp}, so
6
+ * `AudioEffects.lowpass(ramp(8000, 400, 2))` works.
7
+ */
8
+ /** Gain. Param shorthand sets `value`. */
9
+ export interface GainEffectOptions {
10
+ /** 1 = unchanged, 0 = silent, >1 = louder. */
11
+ value: Param;
12
+ }
13
+ /** High-pass filter. Param shorthand sets `frequency`. */
14
+ export interface HighPassEffectOptions {
15
+ /** Rolls off content below this frequency, in Hz. */
16
+ frequency: Param;
17
+ /** Resonance at the cutoff (default 1). */
18
+ q?: Param;
19
+ }
20
+ /** Low-pass filter. Param shorthand sets `frequency`. */
21
+ export interface LowPassEffectOptions {
22
+ /** Rolls off content above this frequency, in Hz. */
23
+ frequency: Param;
24
+ /** Resonance at the cutoff (default 1). */
25
+ q?: Param;
26
+ }
27
+ /** Amplitude wobble. Param shorthand sets `rate`. */
28
+ export interface TremoloEffectOptions {
29
+ /** Wobble rate in Hz. */
30
+ rate: Param;
31
+ /** Modulation depth, 0–1 (default 0.5). */
32
+ depth?: Param;
33
+ }
34
+ /** Delay line with feedback. Param shorthand sets `delay`. */
35
+ export interface EchoEffectOptions {
36
+ /** Delay time in seconds. */
37
+ delay: Param;
38
+ /** Feedback amount, 0–<1 (default 0.4). */
39
+ feedback?: Param;
40
+ /** Wet mix, 0–1 (default 0.5). */
41
+ mix?: Param;
42
+ }
43
+ /**
44
+ * Immutable, chainable list of audio effects, applied in order (index 0
45
+ * closest to the source).
46
+ *
47
+ * @example
48
+ * const chain = AudioEffects.gain(1.5).lowpass(800).echo(0.3);
49
+ */
50
+ export declare class AudioEffectChain {
51
+ list: AudioEffect[];
52
+ constructor(list?: AudioEffect[]);
53
+ private append;
54
+ gain(options: Param | GainEffectOptions): AudioEffectChain;
55
+ /** Alias for {@link gain}. */
56
+ volume(options: Param | GainEffectOptions): AudioEffectChain;
57
+ /** Rolls off content below `frequency` Hz. */
58
+ highpass(options: Param | HighPassEffectOptions): AudioEffectChain;
59
+ /** Rolls off content above `frequency` Hz. */
60
+ lowpass(options: Param | LowPassEffectOptions): AudioEffectChain;
61
+ /** A `rate` Hz wobble at `depth` (0–1). */
62
+ tremolo(options: Param | TremoloEffectOptions): AudioEffectChain;
63
+ /** `delay` seconds, `feedback` 0–<1, optional wet `mix` 0–1. */
64
+ echo(options: Param | EchoEffectOptions): AudioEffectChain;
65
+ [Symbol.iterator](): Generator<AudioEffect, void, unknown>;
66
+ toJSON(): AudioEffect[];
67
+ }
68
+ /** What an `effects` prop accepts: one effect, a plain array, or a chain. */
69
+ export type AudioEffectsInput = AudioEffect[] | AudioEffectChain | AudioEffect;
70
+ /** An empty {@link AudioEffectChain}: `AudioEffects.gain(1.5)` is `new AudioEffectChain().gain(1.5)`. */
71
+ export declare const AudioEffects: AudioEffectChain;
72
+ export declare function resolveAudioEffects(effects: AudioEffectsInput | undefined): AudioEffect[];
73
+ //# sourceMappingURL=chain.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../../src/attributes/audio/effects/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,KAAK,EAAU,MAAM,SAAS,CAAC;AAExC;;;;GAIG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IAClC,qDAAqD;IACrD,SAAS,EAAE,KAAK,CAAC;IACjB,2CAA2C;IAC3C,CAAC,CAAC,EAAE,KAAK,CAAC;CACb;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,SAAS,EAAE,KAAK,CAAC;IACjB,2CAA2C;IAC3C,CAAC,CAAC,EAAE,KAAK,CAAC;CACb;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACjC,yBAAyB;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,2CAA2C;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,kCAAkC;IAClC,GAAG,CAAC,EAAE,KAAK,CAAC;CACf;AAOD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACN,IAAI,EAAE,WAAW,EAAE;gBAAnB,IAAI,GAAE,WAAW,EAAO;IAE3C,OAAO,CAAC,MAAM;IAId,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,iBAAiB;IAKvC,8BAA8B;IAC9B,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,iBAAiB;IAIzC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,qBAAqB;IAK/C,8CAA8C;IAC9C,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,oBAAoB;IAK7C,2CAA2C;IAC3C,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,oBAAoB;IAK7C,gEAAgE;IAChE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,iBAAiB;IAKtC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIlB,MAAM;CAGT;AAED,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,WAAW,EAAE,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE/E,yGAAyG;AACzG,eAAO,MAAM,YAAY,kBAAyB,CAAC;AAEnD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,WAAW,EAAE,CAKzF"}