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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (498) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/NOTICE +15 -14
  3. package/README.md +4 -4
  4. package/dist/assets/manager.d.ts.map +1 -1
  5. package/dist/assets/manager.js +7 -5
  6. package/dist/assets/manager.js.map +1 -1
  7. package/dist/attributes/audio/effects/chain.d.ts +73 -0
  8. package/dist/attributes/audio/effects/chain.d.ts.map +1 -0
  9. package/dist/attributes/audio/effects/chain.js +67 -0
  10. package/dist/attributes/audio/effects/chain.js.map +1 -0
  11. package/dist/attributes/audio/effects/implementations/echo.d.ts +14 -0
  12. package/dist/attributes/audio/effects/implementations/echo.d.ts.map +1 -0
  13. package/dist/attributes/audio/effects/implementations/echo.js +11 -0
  14. package/dist/attributes/audio/effects/implementations/echo.js.map +1 -0
  15. package/dist/attributes/audio/effects/implementations/gain.d.ts +10 -0
  16. package/dist/attributes/audio/effects/implementations/gain.d.ts.map +1 -0
  17. package/dist/attributes/audio/effects/implementations/gain.js +6 -0
  18. package/dist/attributes/audio/effects/implementations/gain.js.map +1 -0
  19. package/dist/attributes/audio/effects/implementations/highpass.d.ts +12 -0
  20. package/dist/attributes/audio/effects/implementations/highpass.d.ts.map +1 -0
  21. package/dist/attributes/audio/effects/implementations/highpass.js +10 -0
  22. package/dist/attributes/audio/effects/implementations/highpass.js.map +1 -0
  23. package/dist/attributes/audio/effects/implementations/lowpass.d.ts +12 -0
  24. package/dist/attributes/audio/effects/implementations/lowpass.d.ts.map +1 -0
  25. package/dist/attributes/audio/effects/implementations/lowpass.js +10 -0
  26. package/dist/attributes/audio/effects/implementations/lowpass.js.map +1 -0
  27. package/dist/attributes/audio/effects/implementations/tremolo.d.ts +12 -0
  28. package/dist/attributes/audio/effects/implementations/tremolo.d.ts.map +1 -0
  29. package/dist/attributes/audio/effects/implementations/tremolo.js +10 -0
  30. package/dist/attributes/audio/effects/implementations/tremolo.js.map +1 -0
  31. package/dist/attributes/audio/effects/index.d.ts +12 -0
  32. package/dist/attributes/audio/effects/index.d.ts.map +1 -0
  33. package/dist/attributes/audio/effects/index.js +4 -0
  34. package/dist/attributes/audio/effects/index.js.map +1 -0
  35. package/dist/attributes/audio/effects/registry.d.ts +36 -0
  36. package/dist/attributes/audio/effects/registry.d.ts.map +1 -0
  37. package/dist/attributes/audio/effects/registry.js +80 -0
  38. package/dist/attributes/audio/effects/registry.js.map +1 -0
  39. package/dist/attributes/audio/effects/union.d.ts +14 -0
  40. package/dist/attributes/audio/effects/union.d.ts.map +1 -0
  41. package/dist/attributes/audio/effects/union.js +24 -0
  42. package/dist/attributes/audio/effects/union.js.map +1 -0
  43. package/dist/attributes/audio/ramp.d.ts +103 -0
  44. package/dist/attributes/audio/ramp.d.ts.map +1 -0
  45. package/dist/attributes/audio/ramp.js +246 -0
  46. package/dist/attributes/audio/ramp.js.map +1 -0
  47. package/dist/attributes/audio/request.d.ts +24 -13
  48. package/dist/attributes/audio/request.d.ts.map +1 -1
  49. package/dist/attributes/audio/request.js +4 -3
  50. package/dist/attributes/audio/request.js.map +1 -1
  51. package/dist/attributes/audio/schedule.d.ts +21 -13
  52. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  53. package/dist/attributes/audio/schedule.js +42 -28
  54. package/dist/attributes/audio/schedule.js.map +1 -1
  55. package/dist/attributes/audio/sound.d.ts +15 -12
  56. package/dist/attributes/audio/sound.d.ts.map +1 -1
  57. package/dist/attributes/audio/sound.js +8 -10
  58. package/dist/attributes/audio/sound.js.map +1 -1
  59. package/dist/attributes/audio/transition.d.ts +33 -0
  60. package/dist/attributes/audio/transition.d.ts.map +1 -0
  61. package/dist/attributes/audio/transition.js +48 -0
  62. package/dist/attributes/audio/transition.js.map +1 -0
  63. package/dist/attributes/index.d.ts +4 -3
  64. package/dist/attributes/index.d.ts.map +1 -1
  65. package/dist/attributes/index.js +4 -7
  66. package/dist/attributes/index.js.map +1 -1
  67. package/dist/attributes/layout/matrix2d.d.ts +2 -2
  68. package/dist/attributes/layout/matrix2d.js.map +1 -1
  69. package/dist/attributes/layout/space3d.js +1 -1
  70. package/dist/attributes/layout/space3d.js.map +1 -1
  71. package/dist/attributes/properties/typed.d.ts +7 -7
  72. package/dist/attributes/properties/typed.d.ts.map +1 -1
  73. package/dist/attributes/properties/typed.js +6 -6
  74. package/dist/attributes/properties/typed.js.map +1 -1
  75. package/dist/attributes/shape/corners/corner-radius.d.ts +1 -2
  76. package/dist/attributes/shape/corners/corner-radius.d.ts.map +1 -1
  77. package/dist/attributes/shape/corners/corner-radius.js +1 -2
  78. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  79. package/dist/attributes/shape/effects/chain.d.ts +96 -409
  80. package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
  81. package/dist/attributes/shape/effects/chain.js +93 -283
  82. package/dist/attributes/shape/effects/chain.js.map +1 -1
  83. package/dist/attributes/shape/effects/effect-data.d.ts +1 -1
  84. package/dist/attributes/shape/effects/effect-data.js.map +1 -1
  85. package/dist/attributes/shape/effects/implementations/ascii.d.ts +45 -13
  86. package/dist/attributes/shape/effects/implementations/ascii.d.ts.map +1 -1
  87. package/dist/attributes/shape/effects/implementations/ascii.js +29 -23
  88. package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
  89. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts +32 -7
  90. package/dist/attributes/shape/effects/implementations/bit-crush.d.ts.map +1 -1
  91. package/dist/attributes/shape/effects/implementations/bit-crush.js +17 -15
  92. package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
  93. package/dist/attributes/shape/effects/implementations/block-displace.d.ts +46 -10
  94. package/dist/attributes/shape/effects/implementations/block-displace.d.ts.map +1 -1
  95. package/dist/attributes/shape/effects/implementations/block-displace.js +21 -19
  96. package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
  97. package/dist/attributes/shape/effects/implementations/bloom.d.ts +32 -7
  98. package/dist/attributes/shape/effects/implementations/bloom.d.ts.map +1 -1
  99. package/dist/attributes/shape/effects/implementations/bloom.js +17 -11
  100. package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
  101. package/dist/attributes/shape/effects/implementations/blur.d.ts +16 -3
  102. package/dist/attributes/shape/effects/implementations/blur.d.ts.map +1 -1
  103. package/dist/attributes/shape/effects/implementations/blur.js +13 -5
  104. package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
  105. package/dist/attributes/shape/effects/implementations/bulge.d.ts +28 -9
  106. package/dist/attributes/shape/effects/implementations/bulge.d.ts.map +1 -1
  107. package/dist/attributes/shape/effects/implementations/bulge.js +15 -14
  108. package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
  109. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts +21 -5
  110. package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts.map +1 -1
  111. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js +15 -10
  112. package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
  113. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +96 -26
  114. package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts.map +1 -1
  115. package/dist/attributes/shape/effects/implementations/color-adjustment.js +29 -26
  116. package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
  117. package/dist/attributes/shape/effects/implementations/curves.d.ts +20 -6
  118. package/dist/attributes/shape/effects/implementations/curves.d.ts.map +1 -1
  119. package/dist/attributes/shape/effects/implementations/curves.js +26 -23
  120. package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
  121. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts +26 -5
  122. package/dist/attributes/shape/effects/implementations/directional-blur.d.ts.map +1 -1
  123. package/dist/attributes/shape/effects/implementations/directional-blur.js +15 -10
  124. package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
  125. package/dist/attributes/shape/effects/implementations/dither.d.ts +58 -11
  126. package/dist/attributes/shape/effects/implementations/dither.d.ts.map +1 -1
  127. package/dist/attributes/shape/effects/implementations/dither.js +26 -20
  128. package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
  129. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts +46 -14
  130. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts.map +1 -1
  131. package/dist/attributes/shape/effects/implementations/drop-shadow.js +24 -29
  132. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  133. package/dist/attributes/shape/effects/implementations/duotone.d.ts +26 -7
  134. package/dist/attributes/shape/effects/implementations/duotone.d.ts.map +1 -1
  135. package/dist/attributes/shape/effects/implementations/duotone.js +17 -16
  136. package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
  137. package/dist/attributes/shape/effects/implementations/edges.d.ts +29 -7
  138. package/dist/attributes/shape/effects/implementations/edges.d.ts.map +1 -1
  139. package/dist/attributes/shape/effects/implementations/edges.js +17 -14
  140. package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
  141. package/dist/attributes/shape/effects/implementations/glass.d.ts +76 -19
  142. package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
  143. package/dist/attributes/shape/effects/implementations/glass.js +28 -22
  144. package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
  145. package/dist/attributes/shape/effects/implementations/glow.d.ts +149 -42
  146. package/dist/attributes/shape/effects/implementations/glow.d.ts.map +1 -1
  147. package/dist/attributes/shape/effects/implementations/glow.js +74 -72
  148. package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
  149. package/dist/attributes/shape/effects/implementations/grain.d.ts +43 -11
  150. package/dist/attributes/shape/effects/implementations/grain.d.ts.map +1 -1
  151. package/dist/attributes/shape/effects/implementations/grain.js +21 -18
  152. package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
  153. package/dist/attributes/shape/effects/implementations/grayscale.d.ts +17 -3
  154. package/dist/attributes/shape/effects/implementations/grayscale.d.ts.map +1 -1
  155. package/dist/attributes/shape/effects/implementations/grayscale.js +13 -5
  156. package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
  157. package/dist/attributes/shape/effects/implementations/halftone.d.ts +40 -9
  158. package/dist/attributes/shape/effects/implementations/halftone.d.ts.map +1 -1
  159. package/dist/attributes/shape/effects/implementations/halftone.js +20 -16
  160. package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
  161. package/dist/attributes/shape/effects/implementations/invert.d.ts +23 -5
  162. package/dist/attributes/shape/effects/implementations/invert.d.ts.map +1 -1
  163. package/dist/attributes/shape/effects/implementations/invert.js +15 -10
  164. package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
  165. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts +57 -18
  166. package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts.map +1 -1
  167. package/dist/attributes/shape/effects/implementations/kaleidoscope.js +25 -22
  168. package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
  169. package/dist/attributes/shape/effects/implementations/lut.d.ts +34 -7
  170. package/dist/attributes/shape/effects/implementations/lut.d.ts.map +1 -1
  171. package/dist/attributes/shape/effects/implementations/lut.js +20 -16
  172. package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
  173. package/dist/attributes/shape/effects/implementations/magnify.d.ts +27 -9
  174. package/dist/attributes/shape/effects/implementations/magnify.d.ts.map +1 -1
  175. package/dist/attributes/shape/effects/implementations/magnify.js +17 -14
  176. package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
  177. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts +54 -19
  178. package/dist/attributes/shape/effects/implementations/motion-blur.d.ts.map +1 -1
  179. package/dist/attributes/shape/effects/implementations/motion-blur.js +42 -20
  180. package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
  181. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts +17 -3
  182. package/dist/attributes/shape/effects/implementations/oil-paint.d.ts.map +1 -1
  183. package/dist/attributes/shape/effects/implementations/oil-paint.js +13 -9
  184. package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
  185. package/dist/attributes/shape/effects/implementations/outline.d.ts +28 -8
  186. package/dist/attributes/shape/effects/implementations/outline.d.ts.map +1 -1
  187. package/dist/attributes/shape/effects/implementations/outline.js +18 -17
  188. package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
  189. package/dist/attributes/shape/effects/implementations/pixelate.d.ts +25 -6
  190. package/dist/attributes/shape/effects/implementations/pixelate.d.ts.map +1 -1
  191. package/dist/attributes/shape/effects/implementations/pixelate.js +16 -14
  192. package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
  193. package/dist/attributes/shape/effects/implementations/posterize.d.ts +14 -3
  194. package/dist/attributes/shape/effects/implementations/posterize.d.ts.map +1 -1
  195. package/dist/attributes/shape/effects/implementations/posterize.js +13 -9
  196. package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
  197. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts +91 -26
  198. package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts.map +1 -1
  199. package/dist/attributes/shape/effects/implementations/progressive-blur.js +27 -28
  200. package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
  201. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts +49 -10
  202. package/dist/attributes/shape/effects/implementations/radial-blur.d.ts.map +1 -1
  203. package/dist/attributes/shape/effects/implementations/radial-blur.js +19 -20
  204. package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
  205. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts +36 -6
  206. package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts.map +1 -1
  207. package/dist/attributes/shape/effects/implementations/rgb-shift.js +16 -15
  208. package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
  209. package/dist/attributes/shape/effects/implementations/scanlines.d.ts +52 -11
  210. package/dist/attributes/shape/effects/implementations/scanlines.d.ts.map +1 -1
  211. package/dist/attributes/shape/effects/implementations/scanlines.js +21 -18
  212. package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
  213. package/dist/attributes/shape/effects/implementations/scatter.d.ts +23 -9
  214. package/dist/attributes/shape/effects/implementations/scatter.d.ts.map +1 -1
  215. package/dist/attributes/shape/effects/implementations/scatter.js +15 -12
  216. package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
  217. package/dist/attributes/shape/effects/implementations/shader.d.ts +90 -34
  218. package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
  219. package/dist/attributes/shape/effects/implementations/shader.js +42 -26
  220. package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
  221. package/dist/attributes/shape/effects/implementations/sharpen.d.ts +23 -5
  222. package/dist/attributes/shape/effects/implementations/sharpen.d.ts.map +1 -1
  223. package/dist/attributes/shape/effects/implementations/sharpen.js +16 -11
  224. package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
  225. package/dist/attributes/shape/effects/implementations/streak.d.ts +40 -9
  226. package/dist/attributes/shape/effects/implementations/streak.d.ts.map +1 -1
  227. package/dist/attributes/shape/effects/implementations/streak.js +19 -16
  228. package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
  229. package/dist/attributes/shape/effects/implementations/threshold.d.ts +24 -5
  230. package/dist/attributes/shape/effects/implementations/threshold.d.ts.map +1 -1
  231. package/dist/attributes/shape/effects/implementations/threshold.js +17 -11
  232. package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
  233. package/dist/attributes/shape/effects/implementations/twirl.d.ts +35 -8
  234. package/dist/attributes/shape/effects/implementations/twirl.d.ts.map +1 -1
  235. package/dist/attributes/shape/effects/implementations/twirl.js +17 -16
  236. package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
  237. package/dist/attributes/shape/effects/implementations/vignette.d.ts +37 -7
  238. package/dist/attributes/shape/effects/implementations/vignette.d.ts.map +1 -1
  239. package/dist/attributes/shape/effects/implementations/vignette.js +19 -18
  240. package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
  241. package/dist/attributes/shape/effects/implementations/vintage.d.ts +24 -5
  242. package/dist/attributes/shape/effects/implementations/vintage.d.ts.map +1 -1
  243. package/dist/attributes/shape/effects/implementations/vintage.js +15 -10
  244. package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
  245. package/dist/attributes/shape/effects/implementations/wave.d.ts +61 -14
  246. package/dist/attributes/shape/effects/implementations/wave.d.ts.map +1 -1
  247. package/dist/attributes/shape/effects/implementations/wave.js +26 -23
  248. package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
  249. package/dist/attributes/shape/effects/index.d.ts +4 -2
  250. package/dist/attributes/shape/effects/index.d.ts.map +1 -1
  251. package/dist/attributes/shape/effects/index.js +1 -1
  252. package/dist/attributes/shape/effects/index.js.map +1 -1
  253. package/dist/attributes/shape/effects/registry.d.ts +11 -0
  254. package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
  255. package/dist/attributes/shape/effects/registry.js +113 -102
  256. package/dist/attributes/shape/effects/registry.js.map +1 -1
  257. package/dist/attributes/shape/effects/spec.d.ts +229 -0
  258. package/dist/attributes/shape/effects/spec.d.ts.map +1 -0
  259. package/dist/attributes/shape/effects/spec.js +178 -0
  260. package/dist/attributes/shape/effects/spec.js.map +1 -0
  261. package/dist/attributes/shape/fill/chain.d.ts +7 -9
  262. package/dist/attributes/shape/fill/chain.d.ts.map +1 -1
  263. package/dist/attributes/shape/fill/chain.js +9 -11
  264. package/dist/attributes/shape/fill/chain.js.map +1 -1
  265. package/dist/attributes/shape/fill/implementations/shader.d.ts +27 -26
  266. package/dist/attributes/shape/fill/implementations/shader.d.ts.map +1 -1
  267. package/dist/attributes/shape/fill/implementations/shader.js +20 -14
  268. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  269. package/dist/attributes/shape/fill/index.d.ts +1 -1
  270. package/dist/attributes/shape/fill/index.d.ts.map +1 -1
  271. package/dist/attributes/shape/fill/index.js.map +1 -1
  272. package/dist/attributes/shape/fill/registry.d.ts +1 -2
  273. package/dist/attributes/shape/fill/registry.d.ts.map +1 -1
  274. package/dist/attributes/shape/fill/registry.js +1 -2
  275. package/dist/attributes/shape/fill/registry.js.map +1 -1
  276. package/dist/attributes/shape/filters/chain.d.ts +2 -6
  277. package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
  278. package/dist/attributes/shape/filters/chain.js +1 -5
  279. package/dist/attributes/shape/filters/chain.js.map +1 -1
  280. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts +2 -2
  281. package/dist/attributes/shape/filters/implementations/color-matrix.d.ts.map +1 -1
  282. package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
  283. package/dist/attributes/shape/filters/registry.d.ts +1 -1
  284. package/dist/attributes/shape/filters/registry.d.ts.map +1 -1
  285. package/dist/attributes/shape/filters/registry.js +3 -3
  286. package/dist/attributes/shape/filters/registry.js.map +1 -1
  287. package/dist/attributes/shape/filters/union.d.ts +2 -3
  288. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  289. package/dist/attributes/shape/filters/union.js.map +1 -1
  290. package/dist/attributes/shape/shaders/index.d.ts +2 -0
  291. package/dist/attributes/shape/shaders/index.d.ts.map +1 -1
  292. package/dist/attributes/shape/shaders/index.js +2 -0
  293. package/dist/attributes/shape/shaders/index.js.map +1 -1
  294. package/dist/attributes/shape/shaders/language.d.ts +26 -0
  295. package/dist/attributes/shape/shaders/language.d.ts.map +1 -0
  296. package/dist/attributes/shape/shaders/language.js +20 -0
  297. package/dist/attributes/shape/shaders/language.js.map +1 -0
  298. package/dist/attributes/shape/shaders/pack.d.ts +25 -11
  299. package/dist/attributes/shape/shaders/pack.d.ts.map +1 -1
  300. package/dist/attributes/shape/shaders/pack.js +9 -4
  301. package/dist/attributes/shape/shaders/pack.js.map +1 -1
  302. package/dist/attributes/shape/shaders/resolve.d.ts +4 -5
  303. package/dist/attributes/shape/shaders/resolve.d.ts.map +1 -1
  304. package/dist/attributes/shape/shaders/resolve.js +3 -6
  305. package/dist/attributes/shape/shaders/resolve.js.map +1 -1
  306. package/dist/attributes/shape/shaders/uniforms.d.ts +41 -0
  307. package/dist/attributes/shape/shaders/uniforms.d.ts.map +1 -0
  308. package/dist/attributes/shape/shaders/uniforms.js +0 -0
  309. package/dist/attributes/shape/shaders/uniforms.js.map +1 -0
  310. package/dist/browser/chunks/chunk-AOT33LMS.js +13 -0
  311. package/dist/browser/chunks/chunk-AOT33LMS.js.map +7 -0
  312. package/dist/browser/chunks/chunk-GKM6UZJR.js +6 -0
  313. package/dist/browser/chunks/chunk-GKM6UZJR.js.map +7 -0
  314. package/dist/browser/experimental.js +1 -1
  315. package/dist/browser/experimental.js.map +4 -4
  316. package/dist/browser/index.js +1 -1
  317. package/dist/browser/index.js.map +2 -2
  318. package/dist/browser/manifest.json +1 -1
  319. package/dist/browser/sdk.js +1 -1
  320. package/dist/components/builtins/audio/audio.d.ts +14 -5
  321. package/dist/components/builtins/audio/audio.d.ts.map +1 -1
  322. package/dist/components/builtins/audio/audio.js +10 -13
  323. package/dist/components/builtins/audio/audio.js.map +1 -1
  324. package/dist/components/builtins/geometry/composite.d.ts +3 -3
  325. package/dist/components/builtins/media/media.d.ts +7 -7
  326. package/dist/components/builtins/media/media.d.ts.map +1 -1
  327. package/dist/components/builtins/media/media.js +4 -10
  328. package/dist/components/builtins/media/media.js.map +1 -1
  329. package/dist/components/builtins/text/text.d.ts +12 -12
  330. package/dist/components/builtins/text/text.d.ts.map +1 -1
  331. package/dist/components/builtins/text/text.js +3 -0
  332. package/dist/components/builtins/text/text.js.map +1 -1
  333. package/dist/components/factory/api.d.ts +38 -11
  334. package/dist/components/factory/api.d.ts.map +1 -1
  335. package/dist/components/factory/api.js.map +1 -1
  336. package/dist/components/factory/component3d.d.ts.map +1 -1
  337. package/dist/components/factory/component3d.js +11 -3
  338. package/dist/components/factory/component3d.js.map +1 -1
  339. package/dist/components/factory/factory.d.ts +3 -0
  340. package/dist/components/factory/factory.d.ts.map +1 -1
  341. package/dist/components/factory/factory.js +39 -5
  342. package/dist/components/factory/factory.js.map +1 -1
  343. package/dist/components/modules/text-style.d.ts +1 -1
  344. package/dist/components/trees/2d/node-render.d.ts +1 -1
  345. package/dist/components/trees/2d/node-render.js +1 -1
  346. package/dist/components/trees/2d/node-render.js.map +1 -1
  347. package/dist/components/trees/2d/node2d.d.ts +1 -1
  348. package/dist/components/trees/2d/node2d.js +1 -1
  349. package/dist/components/trees/2d/node2d.js.map +1 -1
  350. package/dist/components/trees/audio/node-audio.d.ts +16 -9
  351. package/dist/components/trees/audio/node-audio.d.ts.map +1 -1
  352. package/dist/components/trees/audio/node-audio.js +15 -11
  353. package/dist/components/trees/audio/node-audio.js.map +1 -1
  354. package/dist/document/command-traits.d.ts +12 -2
  355. package/dist/document/command-traits.d.ts.map +1 -1
  356. package/dist/document/command-traits.js +34 -6
  357. package/dist/document/command-traits.js.map +1 -1
  358. package/dist/document/index.d.ts +8 -0
  359. package/dist/document/index.d.ts.map +1 -1
  360. package/dist/document/index.js +4 -0
  361. package/dist/document/index.js.map +1 -1
  362. package/dist/document/migrate.d.ts +70 -0
  363. package/dist/document/migrate.d.ts.map +1 -0
  364. package/dist/document/migrate.js +202 -0
  365. package/dist/document/migrate.js.map +1 -0
  366. package/dist/document/missing-node.d.ts +27 -0
  367. package/dist/document/missing-node.d.ts.map +1 -0
  368. package/dist/document/missing-node.js +48 -0
  369. package/dist/document/missing-node.js.map +1 -0
  370. package/dist/document/node-descriptor.d.ts +4 -0
  371. package/dist/document/node-descriptor.d.ts.map +1 -1
  372. package/dist/document/node-descriptor.js.map +1 -1
  373. package/dist/document/placement.d.ts +2 -1
  374. package/dist/document/placement.d.ts.map +1 -1
  375. package/dist/document/placement.js.map +1 -1
  376. package/dist/document/project.d.ts +2 -0
  377. package/dist/document/project.d.ts.map +1 -1
  378. package/dist/document/project.js +1 -0
  379. package/dist/document/project.js.map +1 -1
  380. package/dist/document/prop-evolution.d.ts +51 -0
  381. package/dist/document/prop-evolution.d.ts.map +1 -0
  382. package/dist/document/prop-evolution.js +83 -0
  383. package/dist/document/prop-evolution.js.map +1 -0
  384. package/dist/document/registry.d.ts +16 -0
  385. package/dist/document/registry.d.ts.map +1 -1
  386. package/dist/document/registry.js +30 -4
  387. package/dist/document/registry.js.map +1 -1
  388. package/dist/document/settled-index.d.ts +2 -0
  389. package/dist/document/settled-index.d.ts.map +1 -1
  390. package/dist/document/settled-index.js +5 -5
  391. package/dist/document/settled-index.js.map +1 -1
  392. package/dist/document/timeline-patch.d.ts +4 -0
  393. package/dist/document/timeline-patch.d.ts.map +1 -1
  394. package/dist/document/timeline-patch.js +28 -3
  395. package/dist/document/timeline-patch.js.map +1 -1
  396. package/dist/document/timeline.d.ts +45 -1
  397. package/dist/document/timeline.d.ts.map +1 -1
  398. package/dist/document/timeline.js +172 -42
  399. package/dist/document/timeline.js.map +1 -1
  400. package/dist/document/types.d.ts +14 -28
  401. package/dist/document/types.d.ts.map +1 -1
  402. package/dist/document/types.js.map +1 -1
  403. package/dist/document/validate.d.ts +17 -5
  404. package/dist/document/validate.d.ts.map +1 -1
  405. package/dist/document/validate.js +158 -21
  406. package/dist/document/validate.js.map +1 -1
  407. package/dist/document/vocabulary.d.ts +28 -0
  408. package/dist/document/vocabulary.d.ts.map +1 -0
  409. package/dist/document/vocabulary.js +42 -0
  410. package/dist/document/vocabulary.js.map +1 -0
  411. package/dist/experimental.d.ts +68 -8
  412. package/dist/experimental.d.ts.map +1 -1
  413. package/dist/experimental.js +22 -8
  414. package/dist/experimental.js.map +1 -1
  415. package/dist/platform/exporter.d.ts +13 -0
  416. package/dist/platform/exporter.d.ts.map +1 -1
  417. package/dist/platform/exporter.js.map +1 -1
  418. package/dist/renamed-scene-names.d.ts +1 -1
  419. package/dist/renamed-scene-names.d.ts.map +1 -1
  420. package/dist/renamed-scene-names.js +1 -1
  421. package/dist/renamed-scene-names.js.map +1 -1
  422. package/dist/render/canvas-render-context2d.d.ts +9 -0
  423. package/dist/render/canvas-render-context2d.d.ts.map +1 -1
  424. package/dist/render/canvas-render-context2d.js +10 -0
  425. package/dist/render/canvas-render-context2d.js.map +1 -1
  426. package/dist/render/clip-contains.js +1 -1
  427. package/dist/render/clip-contains.js.map +1 -1
  428. package/dist/render/descriptors/text.d.ts +2 -2
  429. package/dist/render/descriptors/text.js +2 -2
  430. package/dist/render/descriptors/text.js.map +1 -1
  431. package/dist/render/index.d.ts +2 -0
  432. package/dist/render/index.d.ts.map +1 -1
  433. package/dist/render/index.js +1 -0
  434. package/dist/render/index.js.map +1 -1
  435. package/dist/render/render-context2d.d.ts +1 -1
  436. package/dist/render/render-context2d.js.map +1 -1
  437. package/dist/render/render-issue.d.ts +39 -0
  438. package/dist/render/render-issue.d.ts.map +1 -0
  439. package/dist/render/render-issue.js +29 -0
  440. package/dist/render/render-issue.js.map +1 -0
  441. package/dist/render/surface.d.ts +2 -2
  442. package/dist/render/surface.js.map +1 -1
  443. package/dist/render3d/graphics3d.d.ts.map +1 -1
  444. package/dist/render3d/graphics3d.js +54 -5
  445. package/dist/render3d/graphics3d.js.map +1 -1
  446. package/dist/runtime/asset-refine.js +2 -1
  447. package/dist/runtime/asset-refine.js.map +1 -1
  448. package/dist/runtime/asset-timeline.d.ts +10 -0
  449. package/dist/runtime/asset-timeline.d.ts.map +1 -1
  450. package/dist/runtime/asset-timeline.js.map +1 -1
  451. package/dist/runtime/asset-update.d.ts.map +1 -1
  452. package/dist/runtime/asset-update.js +7 -0
  453. package/dist/runtime/asset-update.js.map +1 -1
  454. package/dist/runtime/clip-instance.d.ts +3 -1
  455. package/dist/runtime/clip-instance.d.ts.map +1 -1
  456. package/dist/runtime/clip-instance.js +4 -0
  457. package/dist/runtime/clip-instance.js.map +1 -1
  458. package/dist/runtime/clip-store.d.ts.map +1 -1
  459. package/dist/runtime/clip-store.js +17 -2
  460. package/dist/runtime/clip-store.js.map +1 -1
  461. package/dist/runtime/engine.d.ts +5 -3
  462. package/dist/runtime/engine.d.ts.map +1 -1
  463. package/dist/runtime/engine.js +2 -1
  464. package/dist/runtime/engine.js.map +1 -1
  465. package/dist/runtime/playback-controller.d.ts.map +1 -1
  466. package/dist/runtime/playback-controller.js +14 -4
  467. package/dist/runtime/playback-controller.js.map +1 -1
  468. package/dist/runtime/session.d.ts +7 -3
  469. package/dist/runtime/session.d.ts.map +1 -1
  470. package/dist/runtime/session.js +11 -4
  471. package/dist/runtime/session.js.map +1 -1
  472. package/dist/runtime/text-geometry.d.ts +1 -1
  473. package/dist/runtime/text-geometry.js.map +1 -1
  474. package/dist/sdk/index.d.ts +8 -6
  475. package/dist/sdk/index.d.ts.map +1 -1
  476. package/dist/sdk/index.js +10 -3
  477. package/dist/sdk/index.js.map +1 -1
  478. package/dist/tween/command-decorator.d.ts +7 -0
  479. package/dist/tween/command-decorator.d.ts.map +1 -1
  480. package/dist/tween/command-decorator.js +1 -0
  481. package/dist/tween/command-decorator.js.map +1 -1
  482. package/dist/tween/ease/describe.d.ts +2 -0
  483. package/dist/tween/ease/describe.d.ts.map +1 -1
  484. package/dist/tween/ease/describe.js +4 -0
  485. package/dist/tween/ease/describe.js.map +1 -1
  486. package/dist/tween/ease/spec.d.ts +31 -0
  487. package/dist/tween/ease/spec.d.ts.map +1 -0
  488. package/dist/tween/ease/spec.js +51 -0
  489. package/dist/tween/ease/spec.js.map +1 -0
  490. package/dist/tween/index.d.ts +1 -0
  491. package/dist/tween/index.d.ts.map +1 -1
  492. package/dist/tween/index.js +1 -0
  493. package/dist/tween/index.js.map +1 -1
  494. package/package.json +2 -2
  495. package/dist/browser/chunks/chunk-D4FSTPML.js +0 -14
  496. package/dist/browser/chunks/chunk-D4FSTPML.js.map +0 -7
  497. package/dist/browser/chunks/chunk-RTNATFWX.js +0 -5
  498. package/dist/browser/chunks/chunk-RTNATFWX.js.map +0 -7
@@ -1,5 +1,6 @@
1
- import { type AudioFilter } from "../../../attributes/audio/filters/chain.js";
2
- import type { Param } from "../../../attributes/audio/filters/curve.js";
1
+ import { type AudioEffectsInput } from "../../../attributes/audio/effects/chain.js";
2
+ import type { Param } from "../../../attributes/audio/ramp.js";
3
+ import type { AudioTransition } from "../../../attributes/audio/transition.js";
3
4
  import type { AudioBusStop } from "../../../attributes/audio/request.js";
4
5
  import type { NodeSpan } from "../../../document/types.js";
5
6
  import { Node, type NodeConfig, type NodeDimension, type NodeProps } from "../../../components/trees/node/node.js";
@@ -12,8 +13,12 @@ export interface NodeAudioProps extends NodeProps {
12
13
  pan: Param;
13
14
  /** Silence this node and, on a bus, everything under it. */
14
15
  mute: boolean;
15
- /** Filters applied in array order, index 0 closest to the source. */
16
- filters: AudioFilter;
16
+ /** Effects applied in array order, index 0 closest to the source. */
17
+ effects: AudioEffectsInput;
18
+ /** A fade over its first `duration` seconds, on top of `volume`. */
19
+ transitionIn: AudioTransition | undefined;
20
+ /** A fade over its last `duration` seconds, on top of `volume`. */
21
+ transitionOut: AudioTransition | undefined;
17
22
  }
18
23
  /**
19
24
  * The third scene graph: things that make sound.
@@ -22,7 +27,7 @@ export interface NodeAudioProps extends NodeProps {
22
27
  * — a node that makes sound has no box and no place in space, so it inherits the
23
28
  * tree, identity, props, commands, context and clock from {@link Node} and adds
24
29
  * only what every audible thing has: a level, a position in the stereo field, a
25
- * mute, and a filter chain.
30
+ * mute, an effect chain, and how it enters and leaves.
26
31
  *
27
32
  * Two concrete kinds, and no more: `SoundNode` is a leaf that plays a file, and
28
33
  * `AudioBus` is a group that everything beneath it feeds. That is the whole
@@ -30,10 +35,10 @@ export interface NodeAudioProps extends NodeProps {
30
35
  * trees — a group node and a drawing node — because the thing being described is
31
36
  * the same: what exists, and what is under what.
32
37
  *
33
- * ### Levels are curves, not tweens
38
+ * ### Levels are ramps, not tweens
34
39
  *
35
- * `volume` and `pan` are {@link Param}, so a fade is `AudioFilters`-style
36
- * automation (`fadeOut(1)`, `ramp(...)`) rather than a `to()`. That is not a
40
+ * `volume` and `pan` are {@link Param}, so a fade is a ramp (`ramp(1, 0, 1)`)
41
+ * or a `transitionOut` rather than a `to()`. That is not a
37
42
  * limitation being worked around, it is what the two mechanisms mean: a tween
38
43
  * writes a prop once per *frame*, while sound is scheduled once, ahead of
39
44
  * time, and then runs at 48 kHz. A per-frame write reaches the graph on the one
@@ -46,7 +51,9 @@ export declare class NodeAudio<P extends NodeAudioProps = NodeAudioProps> extend
46
51
  volume: Param;
47
52
  pan: Param;
48
53
  mute: boolean;
49
- filters: AudioFilter;
54
+ effects: AudioEffectsInput;
55
+ transitionIn: AudioTransition | undefined;
56
+ transitionOut: AudioTransition | undefined;
50
57
  constructor(props?: NodeConfig<any, P>);
51
58
  /** This node's children in the audio tree. */
52
59
  get childrenAudio(): NodeAudio[];
@@ -1 +1 @@
1
- {"version":3,"file":"node-audio.d.ts","sourceRoot":"","sources":["../../../../src/components/trees/audio/node-audio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC7C,6DAA6D;IAC7D,MAAM,EAAE,KAAK,CAAC;IACd,8DAA8D;IAC9D,GAAG,EAAE,KAAK,CAAC;IACX,4DAA4D;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,SAAS,IAAI,aAAa,CAAoB;IAE1C,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;gBAEjB,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAStC,8CAA8C;IAC9C,IAAI,aAAa,IAAI,SAAS,EAAE,CAE/B;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;;;;;;OAOG;IACM,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,YAAY;CAWjG;AAWD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,SAAS,CAQrF;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAExE;AAED,gFAAgF;AAChF,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIpE;AA0BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAUnD"}
1
+ {"version":3,"file":"node-audio.d.ts","sourceRoot":"","sources":["../../../../src/components/trees/audio/node-audio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC7C,6DAA6D;IAC7D,MAAM,EAAE,KAAK,CAAC;IACd,8DAA8D;IAC9D,GAAG,EAAE,KAAK,CAAC;IACX,4DAA4D;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,qEAAqE;IACrE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IAC1C,mEAAmE;IACnE,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,SAAS,IAAI,aAAa,CAAoB;IAE1C,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IAC1C,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;gBAEvC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAStC,8CAA8C;IAC9C,IAAI,aAAa,IAAI,SAAS,EAAE,CAE/B;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;;;;;;OAOG;IACM,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,YAAY;CAWjG;AAaD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,SAAS,CAQrF;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAExE;AAED,gFAAgF;AAChF,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIpE;AA4BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAUnD"}
@@ -1,5 +1,5 @@
1
1
  import { declareMembers, property } from "../../../attributes/properties/decorator.js";
2
- import { audioFiltersProperty, audioParamProperty } from "../../../attributes/properties/typed.js";
2
+ import { audioEffectsProperty, audioParamProperty } from "../../../attributes/properties/typed.js";
3
3
  import { Node } from "../../../components/trees/node/node.js";
4
4
  /**
5
5
  * The third scene graph: things that make sound.
@@ -8,7 +8,7 @@ import { Node } from "../../../components/trees/node/node.js";
8
8
  * — a node that makes sound has no box and no place in space, so it inherits the
9
9
  * tree, identity, props, commands, context and clock from {@link Node} and adds
10
10
  * only what every audible thing has: a level, a position in the stereo field, a
11
- * mute, and a filter chain.
11
+ * mute, an effect chain, and how it enters and leaves.
12
12
  *
13
13
  * Two concrete kinds, and no more: `SoundNode` is a leaf that plays a file, and
14
14
  * `AudioBus` is a group that everything beneath it feeds. That is the whole
@@ -16,10 +16,10 @@ import { Node } from "../../../components/trees/node/node.js";
16
16
  * trees — a group node and a drawing node — because the thing being described is
17
17
  * the same: what exists, and what is under what.
18
18
  *
19
- * ### Levels are curves, not tweens
19
+ * ### Levels are ramps, not tweens
20
20
  *
21
- * `volume` and `pan` are {@link Param}, so a fade is `AudioFilters`-style
22
- * automation (`fadeOut(1)`, `ramp(...)`) rather than a `to()`. That is not a
21
+ * `volume` and `pan` are {@link Param}, so a fade is a ramp (`ramp(1, 0, 1)`)
22
+ * or a `transitionOut` rather than a `to()`. That is not a
23
23
  * limitation being worked around, it is what the two mechanisms mean: a tween
24
24
  * writes a prop once per *frame*, while sound is scheduled once, ahead of
25
25
  * time, and then runs at 48 kHz. A per-frame write reaches the graph on the one
@@ -71,9 +71,9 @@ export class NodeAudio extends Node {
71
71
  for (const key of TWEEN_REFUSED) {
72
72
  if (!(key in to))
73
73
  continue;
74
- throw new TypeError(`${this.className}: "${key}" cannot be tweened — an audio level is scheduled once, ` +
74
+ throw new TypeError(`${this.className}: "${key}" cannot be tweened — an audio param is scheduled once, ` +
75
75
  `not written per frame, so a tween on it would render flat. Automate it with a ` +
76
- `curve instead: ${key}: fadeOut(1), or filters: AudioFilters.gain(ramp(1, 0, 1)).`);
76
+ `ramp instead: ${key}: ramp(1, 0, 1), or transitionOut: { duration: 1 }.`);
77
77
  }
78
78
  return super._prepareStep(to, duration, easing);
79
79
  }
@@ -82,9 +82,11 @@ declareMembers(NodeAudio, {
82
82
  volume: audioParamProperty({ default: 1 }),
83
83
  pan: audioParamProperty({ default: 0 }),
84
84
  mute: property({ default: false }),
85
- filters: audioFiltersProperty(),
85
+ effects: audioEffectsProperty(),
86
+ transitionIn: property({ default: undefined }),
87
+ transitionOut: property({ default: undefined }),
86
88
  });
87
- const TWEEN_REFUSED = ["volume", "pan"];
89
+ const TWEEN_REFUSED = ["volume", "pan", "speed"];
88
90
  /**
89
91
  * The buses a node feeds, **source-adjacent first**.
90
92
  *
@@ -132,14 +134,16 @@ function searchBus(node, id) {
132
134
  }
133
135
  /** One bus, flattened to the plain data a platform builds its chain from. */
134
136
  function stopOf(bus, spanOf) {
135
- const filters = bus.filters;
137
+ const effects = bus.effects;
136
138
  const span = spanOf(bus);
137
139
  return {
138
140
  id: bus._busId,
139
141
  volume: bus.volume,
140
142
  pan: bus.pan,
141
143
  mute: bus.mute,
142
- ...(filters.length > 0 ? { filters } : {}),
144
+ ...(effects.length > 0 ? { effects } : {}),
145
+ ...(bus.transitionIn ? { transitionIn: bus.transitionIn } : {}),
146
+ ...(bus.transitionOut ? { transitionOut: bus.transitionOut } : {}),
143
147
  startAt: span.start,
144
148
  endAt: span.end,
145
149
  };
@@ -1 +1 @@
1
- {"version":3,"file":"node-audio.js","sourceRoot":"","sources":["../../../../src/components/trees/audio/node-audio.ts"],"names":[],"mappings":"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","sourcesContent":["import { declareMembers, property } from \"@/attributes/properties/decorator\";\r\nimport { audioFiltersProperty, audioParamProperty } from \"@/attributes/properties/typed\";\r\nimport { type AudioFilter } from \"@/attributes/audio/filters/chain\";\r\nimport type { AudioFilterItem } from \"@/attributes/audio/filters/union\";\r\nimport type { Param } from \"@/attributes/audio/filters/curve\";\r\nimport type { AudioBusStop } from \"@/attributes/audio/request\";\r\nimport type { NodeSpan } from \"@/document/types\";\r\nimport { Node, type NodeConfig, type NodeDimension, type NodeProps } from \"@/components/trees/node/node\";\r\nimport type { EasingFunction } from \"@/tween/ease/type\";\r\nimport type { TweenStepper } from \"@/tween/stepper\";\r\n\r\nexport interface NodeAudioProps extends NodeProps {\r\n /** Linear gain. 1 leaves the signal alone, 0 silences it. */\r\n volume: Param;\r\n /** Stereo position: -1 hard left, 0 centre, +1 hard right. */\r\n pan: Param;\r\n /** Silence this node and, on a bus, everything under it. */\r\n mute: boolean;\r\n /** Filters applied in array order, index 0 closest to the source. */\r\n filters: AudioFilter;\r\n}\r\n\r\n/**\r\n * The third scene graph: things that make sound.\r\n *\r\n * Sibling to `Node2D` and `Node3D`, and thin for the same reason they are thick\r\n * — a node that makes sound has no box and no place in space, so it inherits the\r\n * tree, identity, props, commands, context and clock from {@link Node} and adds\r\n * only what every audible thing has: a level, a position in the stereo field, a\r\n * mute, and a filter chain.\r\n *\r\n * Two concrete kinds, and no more: `SoundNode` is a leaf that plays a file, and\r\n * `AudioBus` is a group that everything beneath it feeds. That is the whole\r\n * vocabulary of a mixer, and it is deliberately the same shape as the visual\r\n * trees — a group node and a drawing node — because the thing being described is\r\n * the same: what exists, and what is under what.\r\n *\r\n * ### Levels are curves, not tweens\r\n *\r\n * `volume` and `pan` are {@link Param}, so a fade is `AudioFilters`-style\r\n * automation (`fadeOut(1)`, `ramp(...)`) rather than a `to()`. That is not a\r\n * limitation being worked around, it is what the two mechanisms mean: a tween\r\n * writes a prop once per *frame*, while sound is scheduled once, ahead of\r\n * time, and then runs at 48 kHz. A per-frame write reaches the graph on the one\r\n * frame that built the request and never again — so a `to({ volume })` would\r\n * read as animated on the timeline and render flat. `_prepareStep` refuses it\r\n * instead.\r\n */\r\nexport class NodeAudio<P extends NodeAudioProps = NodeAudioProps> extends Node<P> {\r\n get dimension(): NodeDimension { return \"audio\"; }\r\n\r\n declare volume: Param;\r\n declare pan: Param;\r\n declare mute: boolean;\r\n declare filters: AudioFilter;\r\n\r\n constructor(props?: NodeConfig<any, P>) {\r\n super(props);\r\n // Deferred to here rather than run by `super()`: a subclass's field\r\n // initializers only run once `super()` has returned, so applying props\r\n // any earlier would write into cells that do not exist yet.\r\n this.initProps(props);\r\n this.adoptChildrenProp(props);\r\n }\r\n\r\n /** This node's children in the audio tree. */\r\n get childrenAudio(): NodeAudio[] {\r\n return this._allChildren.filter((c): c is NodeAudio => c instanceof NodeAudio);\r\n }\r\n\r\n /**\r\n * This bus's identity in the platform's graph: one chain, which everything\r\n * under it feeds.\r\n *\r\n * The authored id, and the structural path for a bus built in code rather\r\n * than from a document row. Neither answer alone works, and being wrong is\r\n * silent either way — the string reaches `AssetManager.stableKey`, so one\r\n * that changes re-fetches and re-schedules every clip on the bus. A document\r\n * row's id is fixed for the document's life, while its child index moves as\r\n * `syncPresence` adds and removes siblings; a code-built bus has no authored\r\n * id, but its parent builds it in the same slot every time.\r\n *\r\n * @internal\r\n */\r\n get _busId(): string {\r\n const authored = this._props?.id;\r\n return `bus:${typeof authored === \"string\" ? authored : structuralPathOf(this)}`;\r\n }\r\n\r\n /**\r\n * Refuse a tween on a level, naming the curve that does work.\r\n *\r\n * Loud rather than silent because the failure is otherwise invisible: the\r\n * command runs its full duration, the timeline draws a bar, and the render\r\n * is at one flat level. See the class docblock for why the two mechanisms\r\n * cannot agree.\r\n */\r\n override _prepareStep(to: Partial<P>, duration: number, easing?: EasingFunction): TweenStepper {\r\n for (const key of TWEEN_REFUSED) {\r\n if (!(key in to)) continue;\r\n throw new TypeError(\r\n `${this.className}: \"${key}\" cannot be tweened — an audio level is scheduled once, ` +\r\n `not written per frame, so a tween on it would render flat. Automate it with a ` +\r\n `curve instead: ${key}: fadeOut(1), or filters: AudioFilters.gain(ramp(1, 0, 1)).`,\r\n );\r\n }\r\n return super._prepareStep(to, duration, easing);\r\n }\r\n}\r\n\r\ndeclareMembers(NodeAudio, {\r\n volume: audioParamProperty({ default: 1 }),\r\n pan: audioParamProperty({ default: 0 }),\r\n mute: property({ default: false }),\r\n filters: audioFiltersProperty(),\r\n});\r\n\r\nconst TWEEN_REFUSED = [\"volume\", \"pan\"] as const;\r\n\r\n/**\r\n * The buses a node feeds, **source-adjacent first**.\r\n *\r\n * Walks up the audio ancestors only: the walk stops at the first non-audio\r\n * parent, which is the `Canvas2D` scene root, because a scene root is not a bus\r\n * — it has no level of its own and nothing to mix.\r\n */\r\nexport function busPathOf(node: NodeAudio, spanOf: SpanOf): AudioBusStop[] | undefined {\r\n const stops: AudioBusStop[] = [];\r\n let parent = node.parent;\r\n while (parent instanceof NodeAudio) {\r\n stops.push(stopOf(parent, spanOf));\r\n parent = parent.parent;\r\n }\r\n return stops.length > 0 ? stops : undefined;\r\n}\r\n\r\n/** {@link busPathOf}, with `bus` itself as the first stop. */\r\nexport function busPathTo(bus: NodeAudio, spanOf: SpanOf): AudioBusStop[] {\r\n return [stopOf(bus, spanOf), ...(busPathOf(bus, spanOf) ?? [])];\r\n}\r\n\r\n/** When a node is in the tree, in clip seconds: the span a bus stop carries. */\r\nexport type SpanOf = (node: Node) => Readonly<NodeSpan>;\r\n\r\n/**\r\n * The bus in `from`'s scene with node id `id`, or `null`.\r\n *\r\n * What lets something outside the audio tree feed a bus — a `Video`, whose audio\r\n * is welded to its picture and so cannot be parented under one. It names the bus\r\n * by the same id a `SoundNode` under that bus writes in its `parentId`, because\r\n * it is asking the same question: which bus. A `key` would be a second\r\n * vocabulary for it, and an optional one.\r\n */\r\nexport function findBusById(from: Node, id: string): NodeAudio | null {\r\n let root: Node = from;\r\n while (root.parent) root = root.parent;\r\n return searchBus(root, id);\r\n}\r\n\r\nfunction searchBus(node: Node, id: string): NodeAudio | null {\r\n if (node instanceof NodeAudio && node.id === id) return node;\r\n for (const child of node._allChildren) {\r\n const found = searchBus(child, id);\r\n if (found) return found;\r\n }\r\n return null;\r\n}\r\n\r\n/** One bus, flattened to the plain data a platform builds its chain from. */\r\nfunction stopOf(bus: NodeAudio, spanOf: SpanOf): AudioBusStop {\r\n const filters = bus.filters as unknown as AudioFilterItem[];\r\n const span = spanOf(bus);\r\n return {\r\n id: bus._busId,\r\n volume: bus.volume,\r\n pan: bus.pan,\r\n mute: bus.mute,\r\n ...(filters.length > 0 ? { filters } : {}),\r\n startAt: span.start,\r\n endAt: span.end,\r\n };\r\n}\r\n\r\n/**\r\n * A node's child-index path from the root of its tree, joined with \".\".\r\n *\r\n * The same identity `nodePath` gives the runtime, computed bottom-up because a\r\n * node declaring its audio knows its parents and not its index in a\r\n * walk. Stable across a rebuild for an unchanged tree, which is the property\r\n * both a bus id and a clip's request id need.\r\n */\r\nexport function structuralPathOf(node: Node): string {\r\n const parts: string[] = [];\r\n let current: Node | null = node;\r\n while (current) {\r\n const parent: Node | null = current.parent;\r\n if (!parent) break;\r\n parts.push(String(parent._allChildren.indexOf(current)));\r\n current = parent;\r\n }\r\n return parts.reverse().join(\".\");\r\n}\r\n"]}
1
+ {"version":3,"file":"node-audio.js","sourceRoot":"","sources":["../../../../src/components/trees/audio/node-audio.ts"],"names":[],"mappings":"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","sourcesContent":["import { declareMembers, property } from \"@/attributes/properties/decorator\";\r\nimport { audioEffectsProperty, audioParamProperty } from \"@/attributes/properties/typed\";\r\nimport { type AudioEffectsInput } from \"@/attributes/audio/effects/chain\";\r\nimport type { AudioEffect } from \"@/attributes/audio/effects/union\";\r\nimport type { Param } from \"@/attributes/audio/ramp\";\r\nimport type { AudioTransition } from \"@/attributes/audio/transition\";\r\nimport type { AudioBusStop } from \"@/attributes/audio/request\";\r\nimport type { NodeSpan } from \"@/document/types\";\r\nimport { Node, type NodeConfig, type NodeDimension, type NodeProps } from \"@/components/trees/node/node\";\r\nimport type { EasingFunction } from \"@/tween/ease/type\";\r\nimport type { TweenStepper } from \"@/tween/stepper\";\r\n\r\nexport interface NodeAudioProps extends NodeProps {\r\n /** Linear gain. 1 leaves the signal alone, 0 silences it. */\r\n volume: Param;\r\n /** Stereo position: -1 hard left, 0 centre, +1 hard right. */\r\n pan: Param;\r\n /** Silence this node and, on a bus, everything under it. */\r\n mute: boolean;\r\n /** Effects applied in array order, index 0 closest to the source. */\r\n effects: AudioEffectsInput;\r\n /** A fade over its first `duration` seconds, on top of `volume`. */\r\n transitionIn: AudioTransition | undefined;\r\n /** A fade over its last `duration` seconds, on top of `volume`. */\r\n transitionOut: AudioTransition | undefined;\r\n}\r\n\r\n/**\r\n * The third scene graph: things that make sound.\r\n *\r\n * Sibling to `Node2D` and `Node3D`, and thin for the same reason they are thick\r\n * — a node that makes sound has no box and no place in space, so it inherits the\r\n * tree, identity, props, commands, context and clock from {@link Node} and adds\r\n * only what every audible thing has: a level, a position in the stereo field, a\r\n * mute, an effect chain, and how it enters and leaves.\r\n *\r\n * Two concrete kinds, and no more: `SoundNode` is a leaf that plays a file, and\r\n * `AudioBus` is a group that everything beneath it feeds. That is the whole\r\n * vocabulary of a mixer, and it is deliberately the same shape as the visual\r\n * trees — a group node and a drawing node — because the thing being described is\r\n * the same: what exists, and what is under what.\r\n *\r\n * ### Levels are ramps, not tweens\r\n *\r\n * `volume` and `pan` are {@link Param}, so a fade is a ramp (`ramp(1, 0, 1)`)\r\n * or a `transitionOut` rather than a `to()`. That is not a\r\n * limitation being worked around, it is what the two mechanisms mean: a tween\r\n * writes a prop once per *frame*, while sound is scheduled once, ahead of\r\n * time, and then runs at 48 kHz. A per-frame write reaches the graph on the one\r\n * frame that built the request and never again — so a `to({ volume })` would\r\n * read as animated on the timeline and render flat. `_prepareStep` refuses it\r\n * instead.\r\n */\r\nexport class NodeAudio<P extends NodeAudioProps = NodeAudioProps> extends Node<P> {\r\n get dimension(): NodeDimension { return \"audio\"; }\r\n\r\n declare volume: Param;\r\n declare pan: Param;\r\n declare mute: boolean;\r\n declare effects: AudioEffectsInput;\r\n declare transitionIn: AudioTransition | undefined;\r\n declare transitionOut: AudioTransition | undefined;\r\n\r\n constructor(props?: NodeConfig<any, P>) {\r\n super(props);\r\n // Deferred to here rather than run by `super()`: a subclass's field\r\n // initializers only run once `super()` has returned, so applying props\r\n // any earlier would write into cells that do not exist yet.\r\n this.initProps(props);\r\n this.adoptChildrenProp(props);\r\n }\r\n\r\n /** This node's children in the audio tree. */\r\n get childrenAudio(): NodeAudio[] {\r\n return this._allChildren.filter((c): c is NodeAudio => c instanceof NodeAudio);\r\n }\r\n\r\n /**\r\n * This bus's identity in the platform's graph: one chain, which everything\r\n * under it feeds.\r\n *\r\n * The authored id, and the structural path for a bus built in code rather\r\n * than from a document row. Neither answer alone works, and being wrong is\r\n * silent either way — the string reaches `AssetManager.stableKey`, so one\r\n * that changes re-fetches and re-schedules every clip on the bus. A document\r\n * row's id is fixed for the document's life, while its child index moves as\r\n * `syncPresence` adds and removes siblings; a code-built bus has no authored\r\n * id, but its parent builds it in the same slot every time.\r\n *\r\n * @internal\r\n */\r\n get _busId(): string {\r\n const authored = this._props?.id;\r\n return `bus:${typeof authored === \"string\" ? authored : structuralPathOf(this)}`;\r\n }\r\n\r\n /**\r\n * Refuse a tween on a level, naming the curve that does work.\r\n *\r\n * Loud rather than silent because the failure is otherwise invisible: the\r\n * command runs its full duration, the timeline draws a bar, and the render\r\n * is at one flat level. See the class docblock for why the two mechanisms\r\n * cannot agree.\r\n */\r\n override _prepareStep(to: Partial<P>, duration: number, easing?: EasingFunction): TweenStepper {\r\n for (const key of TWEEN_REFUSED) {\r\n if (!(key in to)) continue;\r\n throw new TypeError(\r\n `${this.className}: \"${key}\" cannot be tweened — an audio param is scheduled once, ` +\r\n `not written per frame, so a tween on it would render flat. Automate it with a ` +\r\n `ramp instead: ${key}: ramp(1, 0, 1), or transitionOut: { duration: 1 }.`,\r\n );\r\n }\r\n return super._prepareStep(to, duration, easing);\r\n }\r\n}\r\n\r\ndeclareMembers(NodeAudio, {\r\n volume: audioParamProperty({ default: 1 }),\r\n pan: audioParamProperty({ default: 0 }),\r\n mute: property({ default: false }),\r\n effects: audioEffectsProperty(),\r\n transitionIn: property({ default: undefined }),\r\n transitionOut: property({ default: undefined }),\r\n});\r\n\r\nconst TWEEN_REFUSED = [\"volume\", \"pan\", \"speed\"] as const;\r\n\r\n/**\r\n * The buses a node feeds, **source-adjacent first**.\r\n *\r\n * Walks up the audio ancestors only: the walk stops at the first non-audio\r\n * parent, which is the `Canvas2D` scene root, because a scene root is not a bus\r\n * — it has no level of its own and nothing to mix.\r\n */\r\nexport function busPathOf(node: NodeAudio, spanOf: SpanOf): AudioBusStop[] | undefined {\r\n const stops: AudioBusStop[] = [];\r\n let parent = node.parent;\r\n while (parent instanceof NodeAudio) {\r\n stops.push(stopOf(parent, spanOf));\r\n parent = parent.parent;\r\n }\r\n return stops.length > 0 ? stops : undefined;\r\n}\r\n\r\n/** {@link busPathOf}, with `bus` itself as the first stop. */\r\nexport function busPathTo(bus: NodeAudio, spanOf: SpanOf): AudioBusStop[] {\r\n return [stopOf(bus, spanOf), ...(busPathOf(bus, spanOf) ?? [])];\r\n}\r\n\r\n/** When a node is in the tree, in clip seconds: the span a bus stop carries. */\r\nexport type SpanOf = (node: Node) => Readonly<NodeSpan>;\r\n\r\n/**\r\n * The bus in `from`'s scene with node id `id`, or `null`.\r\n *\r\n * What lets something outside the audio tree feed a bus — a `Video`, whose audio\r\n * is welded to its picture and so cannot be parented under one. It names the bus\r\n * by the same id a `SoundNode` under that bus writes in its `parentId`, because\r\n * it is asking the same question: which bus. A `key` would be a second\r\n * vocabulary for it, and an optional one.\r\n */\r\nexport function findBusById(from: Node, id: string): NodeAudio | null {\r\n let root: Node = from;\r\n while (root.parent) root = root.parent;\r\n return searchBus(root, id);\r\n}\r\n\r\nfunction searchBus(node: Node, id: string): NodeAudio | null {\r\n if (node instanceof NodeAudio && node.id === id) return node;\r\n for (const child of node._allChildren) {\r\n const found = searchBus(child, id);\r\n if (found) return found;\r\n }\r\n return null;\r\n}\r\n\r\n/** One bus, flattened to the plain data a platform builds its chain from. */\r\nfunction stopOf(bus: NodeAudio, spanOf: SpanOf): AudioBusStop {\r\n const effects = bus.effects as unknown as AudioEffect[];\r\n const span = spanOf(bus);\r\n return {\r\n id: bus._busId,\r\n volume: bus.volume,\r\n pan: bus.pan,\r\n mute: bus.mute,\r\n ...(effects.length > 0 ? { effects } : {}),\r\n ...(bus.transitionIn ? { transitionIn: bus.transitionIn } : {}),\r\n ...(bus.transitionOut ? { transitionOut: bus.transitionOut } : {}),\r\n startAt: span.start,\r\n endAt: span.end,\r\n };\r\n}\r\n\r\n/**\r\n * A node's child-index path from the root of its tree, joined with \".\".\r\n *\r\n * The same identity `nodePath` gives the runtime, computed bottom-up because a\r\n * node declaring its audio knows its parents and not its index in a\r\n * walk. Stable across a rebuild for an unchanged tree, which is the property\r\n * both a bus id and a clip's request id need.\r\n */\r\nexport function structuralPathOf(node: Node): string {\r\n const parts: string[] = [];\r\n let current: Node | null = node;\r\n while (current) {\r\n const parent: Node | null = current.parent;\r\n if (!parent) break;\r\n parts.push(String(parent._allChildren.indexOf(current)));\r\n current = parent;\r\n }\r\n return parts.reverse().join(\".\");\r\n}\r\n"]}
@@ -23,6 +23,8 @@ export declare const ALIGNMENT_KEYS: readonly string[];
23
23
  /**
24
24
  * How a document command resolves, as `ClipTimeline._buildPlaced` resolves it,
25
25
  * and what it does — or `null` when it resolves to nothing (compiling it throws).
26
+ * One the build skips — aimed at a placeholder, or unpublished by its target's
27
+ * type — writes nothing, which is known.
26
28
  * `target` is the command's target row; for `targetId: null` a document with no
27
29
  * explicit root row may pass `undefined`.
28
30
  */
@@ -42,8 +44,16 @@ export declare function hasNodeRef(value: unknown): boolean;
42
44
  /**
43
45
  * Whether writing `key` on a node of `type` leaves every laid-out box unchanged.
44
46
  *
45
- * Answered only for the library's own classes — a custom node may lay itself out
46
- * from anything — and there only for the props layout never reads.
47
+ * Every node's placement is applied after layout; past that, answered only for
48
+ * the library's own classes, since a custom node may lay itself out from anything.
47
49
  */
48
50
  export declare function isLayoutNeutralProp(registry: Registry, type: string, key: string): boolean;
51
+ /** Whether `key` is placement every node of `type` holds as a plain slot, read only once a frame is drawn. */
52
+ export declare function isPlacementProp(registry: Registry, type: string, key: string): boolean;
53
+ /**
54
+ * Whether a new `key` on `row` can be written onto its live node as a fresh
55
+ * build would set it: placement, on a row with no prop its node turns into
56
+ * placement when built (`topLeft` binds `x` and `y`).
57
+ */
58
+ export declare function writesPlacementInPlace(registry: Registry, row: NodeSpec, key: string): boolean;
49
59
  //# sourceMappingURL=command-traits.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"command-traits.d.ts","sourceRoot":"","sources":["../../src/document/command-traits.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAwB,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGrD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,oFAAoF;IACpF,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,0FAA0F;AAC1F,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAG3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAoCvH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,CAY7G;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAM1F"}
1
+ {"version":3,"file":"command-traits.d.ts","sourceRoot":"","sources":["../../src/document/command-traits.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAwB,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGrD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,oFAAoF;IACpF,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,0FAA0F;AAC1F,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAG3C,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAqCvH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,CAY7G;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1F;AAED,8GAA8G;AAC9G,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGtF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAI9F"}
@@ -7,9 +7,12 @@ export const ALIGNMENT_KEYS = [
7
7
  "center", "topLeft", "topRight", "bottomLeft", "bottomRight",
8
8
  "topCenter", "bottomCenter", "centerLeft", "centerRight",
9
9
  ];
10
+ const SKIPPED = { scope: "node", known: true, lifecycle: false, readsLayout: false, writesLayout: false };
10
11
  /**
11
12
  * How a document command resolves, as `ClipTimeline._buildPlaced` resolves it,
12
13
  * and what it does — or `null` when it resolves to nothing (compiling it throws).
14
+ * One the build skips — aimed at a placeholder, or unpublished by its target's
15
+ * type — writes nothing, which is known.
13
16
  * `target` is the command's target row; for `targetId: null` a document with no
14
17
  * explicit root row may pass `undefined`.
15
18
  */
@@ -22,8 +25,10 @@ export function commandTraits(registry, spec, target) {
22
25
  }
23
26
  const row = target ?? (spec.targetId === null ? DEFAULT_ROOT : undefined);
24
27
  const record = row ? registry.node(row.type) : undefined;
25
- if (!row || !record)
28
+ if (!row)
26
29
  return null;
30
+ if (!record)
31
+ return registry.strict ? null : SKIPPED;
27
32
  let chain;
28
33
  if (global) {
29
34
  chain = GLOBAL_NODE_COMMANDS[spec.type];
@@ -33,7 +38,7 @@ export function commandTraits(registry, spec, target) {
33
38
  else {
34
39
  const entry = record.commands.get(spec.type);
35
40
  if (!entry)
36
- return null;
41
+ return registry.strict ? null : SKIPPED;
37
42
  // A method published under a core command's key is not the core command.
38
43
  chain = entry.method === spec.type ? NODE_COMMANDS[spec.type] : undefined;
39
44
  }
@@ -89,17 +94,34 @@ export function hasNodeRef(value) {
89
94
  /**
90
95
  * Whether writing `key` on a node of `type` leaves every laid-out box unchanged.
91
96
  *
92
- * Answered only for the library's own classes — a custom node may lay itself out
93
- * from anything — and there only for the props layout never reads.
97
+ * Every node's placement is applied after layout; past that, answered only for
98
+ * the library's own classes, since a custom node may lay itself out from anything.
94
99
  */
95
100
  export function isLayoutNeutralProp(registry, type, key) {
96
101
  const record = registry.node(type);
97
- if (!record || !coreLibrary().ctors.has(record.ctor))
102
+ if (!record)
98
103
  return false;
99
104
  // Sound has no box, and the 2D walk skips an audio child.
100
105
  if (record.descriptor.dimension === "audio")
101
106
  return true;
102
- return NEUTRAL_KEYS.has(key);
107
+ if (isPlacementProp(registry, type, key))
108
+ return true;
109
+ return coreLibrary().ctors.has(record.ctor) && NEUTRAL_KEYS.has(key);
110
+ }
111
+ /** Whether `key` is placement every node of `type` holds as a plain slot, read only once a frame is drawn. */
112
+ export function isPlacementProp(registry, type, key) {
113
+ const dimension = registry.node(type)?.descriptor.dimension;
114
+ return dimension === "3d" ? PLACEMENT_3D.has(key) : dimension === "2d" && PLACEMENT_2D.has(key);
115
+ }
116
+ /**
117
+ * Whether a new `key` on `row` can be written onto its live node as a fresh
118
+ * build would set it: placement, on a row with no prop its node turns into
119
+ * placement when built (`topLeft` binds `x` and `y`).
120
+ */
121
+ export function writesPlacementInPlace(registry, row, key) {
122
+ const dimension = registry.node(row.type)?.descriptor.dimension;
123
+ const sugar = dimension === "3d" ? PLACEMENT_SUGAR_3D : PLACEMENT_SUGAR_2D;
124
+ return isPlacementProp(registry, row.type, key) && !Object.keys(row.props).some((prop) => sugar.has(prop));
103
125
  }
104
126
  const LIFECYCLE = new Set(["removeChildAt", "addChildAt", "reparent"]);
105
127
  const VARIABLE_COMMANDS = new Set(["variableTo", "variableSet"]);
@@ -107,6 +129,12 @@ const NEUTRAL_KEYS = new Set([
107
129
  "x", "y", "rotation", "scale", "opacity", "fill", "stroke", "shadow", "overlay",
108
130
  "effects", "blend", "transformOrigin", "zoom", "lookAt", "heading",
109
131
  ]);
132
+ const PLACEMENT_2D = new Set(["x", "y", "rotation", "scale", "opacity"]);
133
+ const PLACEMENT_3D = new Set(["x", "y", "z", "rotationX", "rotationY", "rotationZ", "scaleX", "scaleY", "scaleZ"]);
134
+ const PLACEMENT_SUGAR_2D = new Set([
135
+ "center", "topLeft", "topRight", "bottomLeft", "bottomRight", "topCenter", "bottomCenter", "centerLeft", "centerRight",
136
+ ]);
137
+ const PLACEMENT_SUGAR_3D = new Set(["position", "rotation", "scale"]);
110
138
  const DEFAULT_ROOT = { id: ROOT_NODE_ID, type: "canvas2d", parentId: null, layerOrder: 0, props: {} };
111
139
  // Each command's behaviour, as the methods on its target it runs through. A class
112
140
  // overriding any of them is running something else under the command's name.
@@ -1 +1 @@
1
- {"version":3,"file":"command-traits.js","sourceRoot":"","sources":["../../src/document/command-traits.ts"],"names":[],"mappings":"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","sourcesContent":["import { Node } from \"@/components/trees/node/node\";\r\nimport { expressionOps } from \"./expression/ops\";\r\nimport { Registry, type NodeConstructor } from \"./registry\";\r\nimport type { CommandSpec, NodeSpec } from \"./types\";\r\nimport { ROOT_NODE_ID } from \"./types\";\r\n\r\n/**\r\n * What a command can do to the tree around it, read off the document and the\r\n * registry without building anything.\r\n *\r\n * Only the library's own implementations are described: a command resolving to a\r\n * component's method could do anything, so it is `known: false` and assumed to\r\n * read and write layout.\r\n */\r\nexport interface CommandTraits {\r\n scope: \"node\" | \"variable\";\r\n /** Resolves to the library's own implementation, so the rules below hold for it. */\r\n known: boolean;\r\n lifecycle: boolean;\r\n /** Building it can read a laid-out box, so it must be built against a settled tree. */\r\n readsLayout: boolean;\r\n /** Running it can change what layout computes. */\r\n writesLayout: boolean;\r\n}\r\n\r\n/** The nine named alignment props, which position a node against its own laid-out box. */\r\nexport const ALIGNMENT_KEYS: readonly string[] = [\r\n \"center\", \"topLeft\", \"topRight\", \"bottomLeft\", \"bottomRight\",\r\n \"topCenter\", \"bottomCenter\", \"centerLeft\", \"centerRight\",\r\n];\r\n\r\n/**\r\n * How a document command resolves, as `ClipTimeline._buildPlaced` resolves it,\r\n * and what it does — or `null` when it resolves to nothing (compiling it throws).\r\n * `target` is the command's target row; for `targetId: null` a document with no\r\n * explicit root row may pass `undefined`.\r\n */\r\nexport function commandTraits(registry: Registry, spec: CommandSpec, target: NodeSpec | undefined): CommandTraits | null {\r\n const lifecycle = LIFECYCLE.has(spec.type);\r\n const global = registry.command(spec.type);\r\n if (global?.scope === \"variable\") {\r\n const known = VARIABLE_COMMANDS.has(spec.type);\r\n return { scope: \"variable\", known, lifecycle, readsLayout: !known, writesLayout: false };\r\n }\r\n\r\n const row = target ?? (spec.targetId === null ? DEFAULT_ROOT : undefined);\r\n const record = row ? registry.node(row.type) : undefined;\r\n if (!row || !record) return null;\r\n\r\n let chain: readonly string[] | undefined;\r\n if (global) {\r\n chain = GLOBAL_NODE_COMMANDS[spec.type];\r\n if (chain && typeof methodOf(record.ctor, chain[0]) !== \"function\") return null;\r\n } else {\r\n const entry = record.commands.get(spec.type);\r\n if (!entry) return null;\r\n // A method published under a core command's key is not the core command.\r\n chain = entry.method === spec.type ? NODE_COMMANDS[spec.type] : undefined;\r\n }\r\n\r\n const known = !lifecycle && chain !== undefined && implementsCore(record.ctor, chain);\r\n if (!known) return { scope: \"node\", known, lifecycle, readsLayout: true, writesLayout: true };\r\n\r\n const args = spec.args ?? {};\r\n const props = row.props ?? {};\r\n const written = writtenKeys(spec.type, args);\r\n return {\r\n scope: \"node\",\r\n known,\r\n lifecycle,\r\n readsLayout: readsLayout(spec.type, args, props, written),\r\n writesLayout: written === undefined || written.some((key) => !isLayoutNeutralProp(registry, row.type, key)),\r\n };\r\n}\r\n\r\n/**\r\n * The node ids a command's args name through a `nodeRef` argument — the nodes\r\n * whose boxes it may read when it is built, beside its own target.\r\n */\r\nexport function commandNodeRefs(registry: Registry, spec: CommandSpec, target: NodeSpec | undefined): string[] {\r\n const global = registry.command(spec.type);\r\n const row = target ?? (spec.targetId === null ? DEFAULT_ROOT : undefined);\r\n const descriptors = global\r\n ? (global.scope === \"node\" ? global.args : undefined)\r\n : row ? registry.node(row.type)?.commands.get(spec.type)?.args : undefined;\r\n const refs: string[] = [];\r\n for (const descriptor of descriptors ?? []) {\r\n const value = spec.args?.[descriptor.key];\r\n if (descriptor.kind === \"nodeRef\" && typeof value === \"string\" && value !== \"\") refs.push(value);\r\n }\r\n return refs;\r\n}\r\n\r\n/** Whether `type` hands its descendants a context of its own. */\r\nexport function isContextProvider(registry: Registry, type: string): boolean {\r\n const ctor = registry.node(type)?.ctor;\r\n return ctor !== undefined && methodOf(ctor, \"provideContext\") !== methodOf(Node, \"provideContext\");\r\n}\r\n\r\n/**\r\n * Whether an authored value holds an expression reading another node's prop\r\n * (`[card.x]`), at any depth. An unparsable one counts: it fails the build anyway.\r\n */\r\nexport function hasNodeRef(value: unknown): boolean {\r\n for (const site of expressionOps.collect(value, \"\")) {\r\n const parsed = expressionOps.tryParse(site.source);\r\n if (\"error\" in parsed || parsed.expression.refs.some((ref) => ref.includes(\".\"))) return true;\r\n }\r\n return false;\r\n}\r\n\r\n/**\r\n * Whether writing `key` on a node of `type` leaves every laid-out box unchanged.\r\n *\r\n * Answered only for the library's own classes — a custom node may lay itself out\r\n * from anything — and there only for the props layout never reads.\r\n */\r\nexport function isLayoutNeutralProp(registry: Registry, type: string, key: string): boolean {\r\n const record = registry.node(type);\r\n if (!record || !coreLibrary().ctors.has(record.ctor)) return false;\r\n // Sound has no box, and the 2D walk skips an audio child.\r\n if (record.descriptor.dimension === \"audio\") return true;\r\n return NEUTRAL_KEYS.has(key);\r\n}\r\n\r\nconst LIFECYCLE = new Set([\"removeChildAt\", \"addChildAt\", \"reparent\"]);\r\n\r\nconst VARIABLE_COMMANDS = new Set([\"variableTo\", \"variableSet\"]);\r\n\r\nconst NEUTRAL_KEYS = new Set([\r\n \"x\", \"y\", \"rotation\", \"scale\", \"opacity\", \"fill\", \"stroke\", \"shadow\", \"overlay\",\r\n \"effects\", \"blend\", \"transformOrigin\", \"zoom\", \"lookAt\", \"heading\",\r\n]);\r\n\r\nconst DEFAULT_ROOT: NodeSpec = { id: ROOT_NODE_ID, type: \"canvas2d\", parentId: null, layerOrder: 0, props: {} };\r\n\r\n// Each command's behaviour, as the methods on its target it runs through. A class\r\n// overriding any of them is running something else under the command's name.\r\nconst TO = [\"to\", \"_prepareStep\", \"_writeProp\"];\r\nconst PAINT = [\"command\", \"set\", \"_writeProp\"];\r\n\r\nconst GLOBAL_NODE_COMMANDS: Readonly<Record<string, readonly string[]>> = {\r\n to: TO,\r\n set: [\"set\", \"_writeProp\"],\r\n save: [\"save\"],\r\n fillTo: [\"fillTo\", ...PAINT],\r\n overlayTo: [\"overlayTo\", ...PAINT],\r\n strokeTo: [\"strokeTo\", ...PAINT],\r\n shadowTo: [\"shadowTo\", ...PAINT],\r\n};\r\n\r\nconst NODE_COMMANDS: Readonly<Record<string, readonly string[]>> = {\r\n ...GLOBAL_NODE_COMMANDS,\r\n restore: [\"restore\", \"_prepareStep\", \"_writeProp\"],\r\n fadeTo: [\"fadeTo\", ...TO],\r\n rotateTo: [\"rotateTo\", ...TO],\r\n scaleTo: [\"scaleTo\", ...TO],\r\n layoutTo: [\"layoutTo\", ...TO],\r\n effectTo: [\"effectTo\", ...TO],\r\n progressTo: [\"progressTo\", ...TO],\r\n pulse: [\"pulse\", ...PAINT],\r\n wiggle: [\"wiggle\", ...PAINT],\r\n flash: [\"flash\", ...PAINT],\r\n moveTo: [\"moveTo\", ...TO, \"command\", \"set\"],\r\n zoomTo: [\"zoomTo\", ...TO],\r\n panTo: [\"panTo\", ...TO],\r\n headingTo: [\"headingTo\", ...TO],\r\n countTo: [\"countTo\", ...TO],\r\n append: [\"append\", ...TO],\r\n prepend: [\"prepend\", ...TO],\r\n // Plays its node's sound: scheduled ahead of time, writing nothing.\r\n play: [\"play\"],\r\n};\r\n\r\n/** Named commands' writes. `to`/`set` write their args; absent means \"anything\". */\r\nconst WRITES: Readonly<Record<string, readonly string[]>> = {\r\n fadeTo: [\"opacity\"],\r\n rotateTo: [\"rotation\"],\r\n scaleTo: [\"scale\"],\r\n layoutTo: [\"width\", \"height\", \"padding\"],\r\n effectTo: [\"effects\"],\r\n progressTo: [\"start\", \"end\"],\r\n pulse: [\"scale\"],\r\n wiggle: [\"rotation\"],\r\n flash: [\"start\", \"end\"],\r\n moveTo: [\"x\", \"y\"],\r\n zoomTo: [\"zoom\"],\r\n panTo: [\"lookAt\"],\r\n headingTo: [\"heading\"],\r\n fillTo: [\"fill\"],\r\n overlayTo: [\"overlay\"],\r\n strokeTo: [\"stroke\"],\r\n shadowTo: [\"shadow\"],\r\n play: [],\r\n};\r\n\r\n/** What a known command reads `from` — every command but the stamps. */\r\nconst READS_FROM = new Set(Object.keys(NODE_COMMANDS).filter((type) => type !== \"set\" && type !== \"save\"));\r\n\r\nfunction readsLayout(\r\n type: string,\r\n args: Record<string, unknown>,\r\n props: Record<string, unknown>,\r\n written: readonly string[] | undefined,\r\n): boolean {\r\n // Resolved against the node's own box the moment the step is prepared.\r\n if (hasAlignmentKey(args)) return true;\r\n // Aimed at another node's box.\r\n if (type === \"moveTo\" && typeof args.target === \"string\" && args.target !== \"\") return true;\r\n // An alignment-authored node's x/y are bindings over its box, and a node-ref\r\n // expression may read another node's (`[card.x]` on an aligned card); taking a\r\n // `from`, or a snapshot, evaluates them.\r\n const aligned = hasAlignmentKey(props);\r\n const refBound = nodeRefKeys(props);\r\n if (type === \"save\" || type === \"restore\") return aligned || refBound.size > 0;\r\n if (!READS_FROM.has(type)) return false;\r\n const touched = type === \"append\" || type === \"prepend\" ? [\"text\"] : type === \"countTo\" ? [\"value\"] : written ?? [];\r\n return touched.some((key) => refBound.has(key) || (aligned && (key === \"x\" || key === \"y\")));\r\n}\r\n\r\nfunction writtenKeys(type: string, args: Record<string, unknown>): readonly string[] | undefined {\r\n const named = WRITES[type];\r\n if (named) return named;\r\n if (type !== \"to\" && type !== \"set\") return undefined;\r\n const keys: string[] = [];\r\n for (const key of Object.keys(args)) {\r\n if (key === \"size\") keys.push(\"width\", \"height\");\r\n else if (type === \"to\" && key === \"pivot\") keys.push(\"transformOrigin\");\r\n else if (type === \"to\" && ALIGNMENT_KEYS.includes(key)) keys.push(\"x\", \"y\", \"transformOrigin\");\r\n else keys.push(key);\r\n }\r\n return keys;\r\n}\r\n\r\nfunction hasAlignmentKey(values: Record<string, unknown>): boolean {\r\n return ALIGNMENT_KEYS.some((key) => values[key] !== undefined);\r\n}\r\n\r\nconst REF_KEYS = new WeakMap<object, ReadonlySet<string>>();\r\n\r\n/** The top-level props of a row whose authored value reads another node. */\r\nfunction nodeRefKeys(props: Record<string, unknown>): ReadonlySet<string> {\r\n let keys = REF_KEYS.get(props);\r\n if (!keys) {\r\n const found = new Set<string>();\r\n for (const key of Object.keys(props)) {\r\n if (hasNodeRef(props[key])) found.add(key);\r\n }\r\n REF_KEYS.set(props, (keys = found));\r\n }\r\n return keys;\r\n}\r\n\r\nfunction methodOf(ctor: abstract new (...args: never[]) => unknown, name: string): unknown {\r\n return (ctor.prototype as Record<string, unknown>)[name];\r\n}\r\n\r\nconst KNOWN = new WeakMap<object, Map<readonly string[], boolean>>();\r\n\r\nfunction implementsCore(ctor: NodeConstructor, chain: readonly string[]): boolean {\r\n let byChain = KNOWN.get(ctor);\r\n if (!byChain) KNOWN.set(ctor, (byChain = new Map()));\r\n let known = byChain.get(chain);\r\n if (known === undefined) {\r\n // A method the class lacks entirely is not an override of one.\r\n known = chain.every((name) => {\r\n const impl = methodOf(ctor, name);\r\n return impl === undefined || coreImplementations(name).has(impl);\r\n });\r\n byChain.set(chain, known);\r\n }\r\n return known;\r\n}\r\n\r\ninterface CoreLibrary {\r\n ctors: ReadonlySet<NodeConstructor>;\r\n methods: Map<string, ReadonlySet<unknown>>;\r\n}\r\n\r\nlet core: CoreLibrary | null = null;\r\n\r\nfunction coreLibrary(): CoreLibrary {\r\n if (!core) {\r\n // A registry seeds itself with exactly what the library ships, so a fresh one is that list.\r\n const seeded = new Registry();\r\n core = { ctors: new Set(seeded.nodeKeys().map((key) => seeded.node(key)!.ctor)), methods: new Map() };\r\n }\r\n return core;\r\n}\r\n\r\n/** Every body the library's classes give `name`, base classes included. */\r\nfunction coreImplementations(name: string): ReadonlySet<unknown> {\r\n const library = coreLibrary();\r\n let impls = library.methods.get(name);\r\n if (!impls) {\r\n const found = new Set<unknown>();\r\n for (const ctor of library.ctors) {\r\n for (let proto = ctor.prototype; proto && proto !== Object.prototype; proto = Object.getPrototypeOf(proto)) {\r\n const own = Object.getOwnPropertyDescriptor(proto, name);\r\n if (own && typeof own.value === \"function\") found.add(own.value);\r\n }\r\n }\r\n library.methods.set(name, (impls = found));\r\n }\r\n return impls;\r\n}\r\n"]}
1
+ {"version":3,"file":"command-traits.js","sourceRoot":"","sources":["../../src/document/command-traits.ts"],"names":[],"mappings":"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","sourcesContent":["import { Node } from \"@/components/trees/node/node\";\r\nimport { expressionOps } from \"./expression/ops\";\r\nimport { Registry, type NodeConstructor } from \"./registry\";\r\nimport type { CommandSpec, NodeSpec } from \"./types\";\r\nimport { ROOT_NODE_ID } from \"./types\";\r\n\r\n/**\r\n * What a command can do to the tree around it, read off the document and the\r\n * registry without building anything.\r\n *\r\n * Only the library's own implementations are described: a command resolving to a\r\n * component's method could do anything, so it is `known: false` and assumed to\r\n * read and write layout.\r\n */\r\nexport interface CommandTraits {\r\n scope: \"node\" | \"variable\";\r\n /** Resolves to the library's own implementation, so the rules below hold for it. */\r\n known: boolean;\r\n lifecycle: boolean;\r\n /** Building it can read a laid-out box, so it must be built against a settled tree. */\r\n readsLayout: boolean;\r\n /** Running it can change what layout computes. */\r\n writesLayout: boolean;\r\n}\r\n\r\n/** The nine named alignment props, which position a node against its own laid-out box. */\r\nexport const ALIGNMENT_KEYS: readonly string[] = [\r\n \"center\", \"topLeft\", \"topRight\", \"bottomLeft\", \"bottomRight\",\r\n \"topCenter\", \"bottomCenter\", \"centerLeft\", \"centerRight\",\r\n];\r\n\r\nconst SKIPPED: CommandTraits = { scope: \"node\", known: true, lifecycle: false, readsLayout: false, writesLayout: false };\r\n\r\n/**\r\n * How a document command resolves, as `ClipTimeline._buildPlaced` resolves it,\r\n * and what it does — or `null` when it resolves to nothing (compiling it throws).\r\n * One the build skips — aimed at a placeholder, or unpublished by its target's\r\n * type — writes nothing, which is known.\r\n * `target` is the command's target row; for `targetId: null` a document with no\r\n * explicit root row may pass `undefined`.\r\n */\r\nexport function commandTraits(registry: Registry, spec: CommandSpec, target: NodeSpec | undefined): CommandTraits | null {\r\n const lifecycle = LIFECYCLE.has(spec.type);\r\n const global = registry.command(spec.type);\r\n if (global?.scope === \"variable\") {\r\n const known = VARIABLE_COMMANDS.has(spec.type);\r\n return { scope: \"variable\", known, lifecycle, readsLayout: !known, writesLayout: false };\r\n }\r\n\r\n const row = target ?? (spec.targetId === null ? DEFAULT_ROOT : undefined);\r\n const record = row ? registry.node(row.type) : undefined;\r\n if (!row) return null;\r\n if (!record) return registry.strict ? null : SKIPPED;\r\n\r\n let chain: readonly string[] | undefined;\r\n if (global) {\r\n chain = GLOBAL_NODE_COMMANDS[spec.type];\r\n if (chain && typeof methodOf(record.ctor, chain[0]) !== \"function\") return null;\r\n } else {\r\n const entry = record.commands.get(spec.type);\r\n if (!entry) return registry.strict ? null : SKIPPED;\r\n // A method published under a core command's key is not the core command.\r\n chain = entry.method === spec.type ? NODE_COMMANDS[spec.type] : undefined;\r\n }\r\n\r\n const known = !lifecycle && chain !== undefined && implementsCore(record.ctor, chain);\r\n if (!known) return { scope: \"node\", known, lifecycle, readsLayout: true, writesLayout: true };\r\n\r\n const args = spec.args ?? {};\r\n const props = row.props ?? {};\r\n const written = writtenKeys(spec.type, args);\r\n return {\r\n scope: \"node\",\r\n known,\r\n lifecycle,\r\n readsLayout: readsLayout(spec.type, args, props, written),\r\n writesLayout: written === undefined || written.some((key) => !isLayoutNeutralProp(registry, row.type, key)),\r\n };\r\n}\r\n\r\n/**\r\n * The node ids a command's args name through a `nodeRef` argument — the nodes\r\n * whose boxes it may read when it is built, beside its own target.\r\n */\r\nexport function commandNodeRefs(registry: Registry, spec: CommandSpec, target: NodeSpec | undefined): string[] {\r\n const global = registry.command(spec.type);\r\n const row = target ?? (spec.targetId === null ? DEFAULT_ROOT : undefined);\r\n const descriptors = global\r\n ? (global.scope === \"node\" ? global.args : undefined)\r\n : row ? registry.node(row.type)?.commands.get(spec.type)?.args : undefined;\r\n const refs: string[] = [];\r\n for (const descriptor of descriptors ?? []) {\r\n const value = spec.args?.[descriptor.key];\r\n if (descriptor.kind === \"nodeRef\" && typeof value === \"string\" && value !== \"\") refs.push(value);\r\n }\r\n return refs;\r\n}\r\n\r\n/** Whether `type` hands its descendants a context of its own. */\r\nexport function isContextProvider(registry: Registry, type: string): boolean {\r\n const ctor = registry.node(type)?.ctor;\r\n return ctor !== undefined && methodOf(ctor, \"provideContext\") !== methodOf(Node, \"provideContext\");\r\n}\r\n\r\n/**\r\n * Whether an authored value holds an expression reading another node's prop\r\n * (`[card.x]`), at any depth. An unparsable one counts: it fails the build anyway.\r\n */\r\nexport function hasNodeRef(value: unknown): boolean {\r\n for (const site of expressionOps.collect(value, \"\")) {\r\n const parsed = expressionOps.tryParse(site.source);\r\n if (\"error\" in parsed || parsed.expression.refs.some((ref) => ref.includes(\".\"))) return true;\r\n }\r\n return false;\r\n}\r\n\r\n/**\r\n * Whether writing `key` on a node of `type` leaves every laid-out box unchanged.\r\n *\r\n * Every node's placement is applied after layout; past that, answered only for\r\n * the library's own classes, since a custom node may lay itself out from anything.\r\n */\r\nexport function isLayoutNeutralProp(registry: Registry, type: string, key: string): boolean {\r\n const record = registry.node(type);\r\n if (!record) return false;\r\n // Sound has no box, and the 2D walk skips an audio child.\r\n if (record.descriptor.dimension === \"audio\") return true;\r\n if (isPlacementProp(registry, type, key)) return true;\r\n return coreLibrary().ctors.has(record.ctor) && NEUTRAL_KEYS.has(key);\r\n}\r\n\r\n/** Whether `key` is placement every node of `type` holds as a plain slot, read only once a frame is drawn. */\r\nexport function isPlacementProp(registry: Registry, type: string, key: string): boolean {\r\n const dimension = registry.node(type)?.descriptor.dimension;\r\n return dimension === \"3d\" ? PLACEMENT_3D.has(key) : dimension === \"2d\" && PLACEMENT_2D.has(key);\r\n}\r\n\r\n/**\r\n * Whether a new `key` on `row` can be written onto its live node as a fresh\r\n * build would set it: placement, on a row with no prop its node turns into\r\n * placement when built (`topLeft` binds `x` and `y`).\r\n */\r\nexport function writesPlacementInPlace(registry: Registry, row: NodeSpec, key: string): boolean {\r\n const dimension = registry.node(row.type)?.descriptor.dimension;\r\n const sugar = dimension === \"3d\" ? PLACEMENT_SUGAR_3D : PLACEMENT_SUGAR_2D;\r\n return isPlacementProp(registry, row.type, key) && !Object.keys(row.props).some((prop) => sugar.has(prop));\r\n}\r\n\r\nconst LIFECYCLE = new Set([\"removeChildAt\", \"addChildAt\", \"reparent\"]);\r\n\r\nconst VARIABLE_COMMANDS = new Set([\"variableTo\", \"variableSet\"]);\r\n\r\nconst NEUTRAL_KEYS = new Set([\r\n \"x\", \"y\", \"rotation\", \"scale\", \"opacity\", \"fill\", \"stroke\", \"shadow\", \"overlay\",\r\n \"effects\", \"blend\", \"transformOrigin\", \"zoom\", \"lookAt\", \"heading\",\r\n]);\r\n\r\nconst PLACEMENT_2D = new Set([\"x\", \"y\", \"rotation\", \"scale\", \"opacity\"]);\r\n\r\nconst PLACEMENT_3D = new Set([\"x\", \"y\", \"z\", \"rotationX\", \"rotationY\", \"rotationZ\", \"scaleX\", \"scaleY\", \"scaleZ\"]);\r\n\r\nconst PLACEMENT_SUGAR_2D = new Set([\r\n \"center\", \"topLeft\", \"topRight\", \"bottomLeft\", \"bottomRight\", \"topCenter\", \"bottomCenter\", \"centerLeft\", \"centerRight\",\r\n]);\r\n\r\nconst PLACEMENT_SUGAR_3D = new Set([\"position\", \"rotation\", \"scale\"]);\r\n\r\nconst DEFAULT_ROOT: NodeSpec = { id: ROOT_NODE_ID, type: \"canvas2d\", parentId: null, layerOrder: 0, props: {} };\r\n\r\n// Each command's behaviour, as the methods on its target it runs through. A class\r\n// overriding any of them is running something else under the command's name.\r\nconst TO = [\"to\", \"_prepareStep\", \"_writeProp\"];\r\nconst PAINT = [\"command\", \"set\", \"_writeProp\"];\r\n\r\nconst GLOBAL_NODE_COMMANDS: Readonly<Record<string, readonly string[]>> = {\r\n to: TO,\r\n set: [\"set\", \"_writeProp\"],\r\n save: [\"save\"],\r\n fillTo: [\"fillTo\", ...PAINT],\r\n overlayTo: [\"overlayTo\", ...PAINT],\r\n strokeTo: [\"strokeTo\", ...PAINT],\r\n shadowTo: [\"shadowTo\", ...PAINT],\r\n};\r\n\r\nconst NODE_COMMANDS: Readonly<Record<string, readonly string[]>> = {\r\n ...GLOBAL_NODE_COMMANDS,\r\n restore: [\"restore\", \"_prepareStep\", \"_writeProp\"],\r\n fadeTo: [\"fadeTo\", ...TO],\r\n rotateTo: [\"rotateTo\", ...TO],\r\n scaleTo: [\"scaleTo\", ...TO],\r\n layoutTo: [\"layoutTo\", ...TO],\r\n effectTo: [\"effectTo\", ...TO],\r\n progressTo: [\"progressTo\", ...TO],\r\n pulse: [\"pulse\", ...PAINT],\r\n wiggle: [\"wiggle\", ...PAINT],\r\n flash: [\"flash\", ...PAINT],\r\n moveTo: [\"moveTo\", ...TO, \"command\", \"set\"],\r\n zoomTo: [\"zoomTo\", ...TO],\r\n panTo: [\"panTo\", ...TO],\r\n headingTo: [\"headingTo\", ...TO],\r\n countTo: [\"countTo\", ...TO],\r\n append: [\"append\", ...TO],\r\n prepend: [\"prepend\", ...TO],\r\n // Plays its node's sound: scheduled ahead of time, writing nothing.\r\n play: [\"play\"],\r\n};\r\n\r\n/** Named commands' writes. `to`/`set` write their args; absent means \"anything\". */\r\nconst WRITES: Readonly<Record<string, readonly string[]>> = {\r\n fadeTo: [\"opacity\"],\r\n rotateTo: [\"rotation\"],\r\n scaleTo: [\"scale\"],\r\n layoutTo: [\"width\", \"height\", \"padding\"],\r\n effectTo: [\"effects\"],\r\n progressTo: [\"start\", \"end\"],\r\n pulse: [\"scale\"],\r\n wiggle: [\"rotation\"],\r\n flash: [\"start\", \"end\"],\r\n moveTo: [\"x\", \"y\"],\r\n zoomTo: [\"zoom\"],\r\n panTo: [\"lookAt\"],\r\n headingTo: [\"heading\"],\r\n fillTo: [\"fill\"],\r\n overlayTo: [\"overlay\"],\r\n strokeTo: [\"stroke\"],\r\n shadowTo: [\"shadow\"],\r\n play: [],\r\n};\r\n\r\n/** What a known command reads `from` — every command but the stamps. */\r\nconst READS_FROM = new Set(Object.keys(NODE_COMMANDS).filter((type) => type !== \"set\" && type !== \"save\"));\r\n\r\nfunction readsLayout(\r\n type: string,\r\n args: Record<string, unknown>,\r\n props: Record<string, unknown>,\r\n written: readonly string[] | undefined,\r\n): boolean {\r\n // Resolved against the node's own box the moment the step is prepared.\r\n if (hasAlignmentKey(args)) return true;\r\n // Aimed at another node's box.\r\n if (type === \"moveTo\" && typeof args.target === \"string\" && args.target !== \"\") return true;\r\n // An alignment-authored node's x/y are bindings over its box, and a node-ref\r\n // expression may read another node's (`[card.x]` on an aligned card); taking a\r\n // `from`, or a snapshot, evaluates them.\r\n const aligned = hasAlignmentKey(props);\r\n const refBound = nodeRefKeys(props);\r\n if (type === \"save\" || type === \"restore\") return aligned || refBound.size > 0;\r\n if (!READS_FROM.has(type)) return false;\r\n const touched = type === \"append\" || type === \"prepend\" ? [\"text\"] : type === \"countTo\" ? [\"value\"] : written ?? [];\r\n return touched.some((key) => refBound.has(key) || (aligned && (key === \"x\" || key === \"y\")));\r\n}\r\n\r\nfunction writtenKeys(type: string, args: Record<string, unknown>): readonly string[] | undefined {\r\n const named = WRITES[type];\r\n if (named) return named;\r\n if (type !== \"to\" && type !== \"set\") return undefined;\r\n const keys: string[] = [];\r\n for (const key of Object.keys(args)) {\r\n if (key === \"size\") keys.push(\"width\", \"height\");\r\n else if (type === \"to\" && key === \"pivot\") keys.push(\"transformOrigin\");\r\n else if (type === \"to\" && ALIGNMENT_KEYS.includes(key)) keys.push(\"x\", \"y\", \"transformOrigin\");\r\n else keys.push(key);\r\n }\r\n return keys;\r\n}\r\n\r\nfunction hasAlignmentKey(values: Record<string, unknown>): boolean {\r\n return ALIGNMENT_KEYS.some((key) => values[key] !== undefined);\r\n}\r\n\r\nconst REF_KEYS = new WeakMap<object, ReadonlySet<string>>();\r\n\r\n/** The top-level props of a row whose authored value reads another node. */\r\nfunction nodeRefKeys(props: Record<string, unknown>): ReadonlySet<string> {\r\n let keys = REF_KEYS.get(props);\r\n if (!keys) {\r\n const found = new Set<string>();\r\n for (const key of Object.keys(props)) {\r\n if (hasNodeRef(props[key])) found.add(key);\r\n }\r\n REF_KEYS.set(props, (keys = found));\r\n }\r\n return keys;\r\n}\r\n\r\nfunction methodOf(ctor: abstract new (...args: never[]) => unknown, name: string): unknown {\r\n return (ctor.prototype as Record<string, unknown>)[name];\r\n}\r\n\r\nconst KNOWN = new WeakMap<object, Map<readonly string[], boolean>>();\r\n\r\nfunction implementsCore(ctor: NodeConstructor, chain: readonly string[]): boolean {\r\n let byChain = KNOWN.get(ctor);\r\n if (!byChain) KNOWN.set(ctor, (byChain = new Map()));\r\n let known = byChain.get(chain);\r\n if (known === undefined) {\r\n // A method the class lacks entirely is not an override of one.\r\n known = chain.every((name) => {\r\n const impl = methodOf(ctor, name);\r\n return impl === undefined || coreImplementations(name).has(impl);\r\n });\r\n byChain.set(chain, known);\r\n }\r\n return known;\r\n}\r\n\r\ninterface CoreLibrary {\r\n ctors: ReadonlySet<NodeConstructor>;\r\n methods: Map<string, ReadonlySet<unknown>>;\r\n}\r\n\r\nlet core: CoreLibrary | null = null;\r\n\r\nfunction coreLibrary(): CoreLibrary {\r\n if (!core) {\r\n // A registry seeds itself with exactly what the library ships, so a fresh one is that list.\r\n const seeded = new Registry();\r\n core = { ctors: new Set(seeded.nodeKeys().map((key) => seeded.node(key)!.ctor)), methods: new Map() };\r\n }\r\n return core;\r\n}\r\n\r\n/** Every body the library's classes give `name`, base classes included. */\r\nfunction coreImplementations(name: string): ReadonlySet<unknown> {\r\n const library = coreLibrary();\r\n let impls = library.methods.get(name);\r\n if (!impls) {\r\n const found = new Set<unknown>();\r\n for (const ctor of library.ctors) {\r\n for (let proto = ctor.prototype; proto && proto !== Object.prototype; proto = Object.getPrototypeOf(proto)) {\r\n const own = Object.getOwnPropertyDescriptor(proto, name);\r\n if (own && typeof own.value === \"function\") found.add(own.value);\r\n }\r\n }\r\n library.methods.set(name, (impls = found));\r\n }\r\n return impls;\r\n}\r\n"]}
@@ -2,6 +2,14 @@ export * from "./types.js";
2
2
  export * from "./project.js";
3
3
  export * from "./expression/index.js";
4
4
  export * from "./validate.js";
5
+ export { DOCUMENT_FORMAT_VERSION, DOCUMENT_MIGRATIONS, DocumentTooNewError, documentFormatVersion, migrateDocument, } from "./migrate.js";
6
+ export type { DocumentChange, DocumentMigration, DocumentMigrationResult, JsonDocument, NoteChange } from "./migrate.js";
7
+ export { migrateNodeProps } from "./prop-evolution.js";
8
+ export type { PropEvolution, PropMigration, PropNote } from "./prop-evolution.js";
9
+ export { missingNodeOf } from "./missing-node.js";
10
+ export { registryVocabulary, vocabularyBreaks } from "./vocabulary.js";
11
+ export type { RegistryVocabulary, VocabularyBreak } from "./vocabulary.js";
12
+ export type { MissingNodeInfo } from "./missing-node.js";
5
13
  export * from "./registry.js";
6
14
  export * from "./node-descriptor.js";
7
15
  export { NODE_META, getNodeDescriptor } from "./node-decorator.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
@@ -2,6 +2,10 @@ export * from "./types.js";
2
2
  export * from "./project.js";
3
3
  export * from "./expression/index.js";
4
4
  export * from "./validate.js";
5
+ export { DOCUMENT_FORMAT_VERSION, DOCUMENT_MIGRATIONS, DocumentTooNewError, documentFormatVersion, migrateDocument, } from "./migrate.js";
6
+ export { migrateNodeProps } from "./prop-evolution.js";
7
+ export { missingNodeOf } from "./missing-node.js";
8
+ export { registryVocabulary, vocabularyBreaks } from "./vocabulary.js";
5
9
  export * from "./registry.js";
6
10
  export * from "./node-descriptor.js";
7
11
  export { NODE_META, getNodeDescriptor } from "./node-decorator.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,iFAAiF;AACjF,2EAA2E;AAC3E,mBAAmB","sourcesContent":["export * from \"./types\";\r\nexport * from \"./project\";\r\nexport * from \"./expression\";\r\nexport * from \"./validate\";\r\nexport * from \"./registry\";\r\nexport * from \"./node-descriptor\";\r\nexport { NODE_META, getNodeDescriptor } from \"./node-decorator\";\r\nexport * from \"./placement\";\r\nexport * from \"./timeline\";\r\nexport * from \"./audio\";\r\n// `installBuiltins` is deliberately NOT exported: a `Registry` seeds itself from\r\n// its own constructor, so a host has no module-scope call for a bundler to\r\n// tree-shake away.\r\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGpE,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,iFAAiF;AACjF,2EAA2E;AAC3E,mBAAmB","sourcesContent":["export * from \"./types\";\r\nexport * from \"./project\";\r\nexport * from \"./expression\";\r\nexport * from \"./validate\";\r\nexport {\r\n DOCUMENT_FORMAT_VERSION,\r\n DOCUMENT_MIGRATIONS,\r\n DocumentTooNewError,\r\n documentFormatVersion,\r\n migrateDocument,\r\n} from \"./migrate\";\r\nexport type { DocumentChange, DocumentMigration, DocumentMigrationResult, JsonDocument, NoteChange } from \"./migrate\";\r\nexport { migrateNodeProps } from \"./prop-evolution\";\r\nexport type { PropEvolution, PropMigration, PropNote } from \"./prop-evolution\";\r\nexport { missingNodeOf } from \"./missing-node\";\r\nexport { registryVocabulary, vocabularyBreaks } from \"./vocabulary\";\r\nexport type { RegistryVocabulary, VocabularyBreak } from \"./vocabulary\";\r\nexport type { MissingNodeInfo } from \"./missing-node\";\r\nexport * from \"./registry\";\r\nexport * from \"./node-descriptor\";\r\nexport { NODE_META, getNodeDescriptor } from \"./node-decorator\";\r\nexport * from \"./placement\";\r\nexport * from \"./timeline\";\r\nexport * from \"./audio\";\r\n// `installBuiltins` is deliberately NOT exported: a `Registry` seeds itself from\r\n// its own constructor, so a host has no module-scope call for a bundler to\r\n// tree-shake away.\r\n"]}
@@ -0,0 +1,70 @@
1
+ import type { ProjectDocument } from "./project.js";
2
+ import type { ClipDocument } from "./types.js";
3
+ /**
4
+ * Saved documents outlive the engine that wrote them, so each carries the
5
+ * format it was written in and this module carries every step from one format
6
+ * to the next.
7
+ *
8
+ * A step is a pure function over JSON: it never mutates what it is handed and
9
+ * never needs a registry, so a host can run it over a row it has not opened
10
+ * and a test can pin it with two literals. Steps only ever go up; a document
11
+ * newer than the engine is refused with {@link DocumentTooNewError} rather than
12
+ * read as whatever it happens to resemble.
13
+ */
14
+ /** The format this engine reads natively and writes. A document without `formatVersion` is format 0. */
15
+ export declare const DOCUMENT_FORMAT_VERSION = 2;
16
+ /** A document written by a newer engine than this one. Thrown before anything reads it. */
17
+ export declare class DocumentTooNewError extends Error {
18
+ readonly version: number;
19
+ readonly supported: number;
20
+ constructor(version: number, supported?: number);
21
+ }
22
+ /** A document as JSON, before anything has checked its shape. */
23
+ export type JsonDocument = Record<string, unknown>;
24
+ /** One thing a migration changed. `path` locates it as a `ValidationIssue`'s does. */
25
+ export interface DocumentChange {
26
+ /** The format the step that made it read. */
27
+ from: number;
28
+ path: string;
29
+ message: string;
30
+ }
31
+ /** Records a change at `path`, relative to the document the step was handed. */
32
+ export type NoteChange = (path: string, message: string) => void;
33
+ /** The step from format {@link from} to `from + 1`. */
34
+ export interface DocumentMigration {
35
+ readonly from: number;
36
+ /** What the format change was, for a changelog or a host's log. */
37
+ readonly description: string;
38
+ /** Run on every clip document, standalone or inside a project's track. */
39
+ readonly clip?: (clip: JsonDocument, note: NoteChange) => JsonDocument;
40
+ /** Run on a project's own fields, before its clips. */
41
+ readonly project?: (project: JsonDocument, note: NoteChange) => JsonDocument;
42
+ }
43
+ export interface DocumentMigrationResult<T> {
44
+ /** The input itself when it was already current; otherwise a new document stamped with {@link to}. */
45
+ document: T;
46
+ from: number;
47
+ to: number;
48
+ changes: DocumentChange[];
49
+ }
50
+ /**
51
+ * Every step, oldest first. A release that changes what a stored document
52
+ * means adds the next one here, bumps {@link DOCUMENT_FORMAT_VERSION}, and
53
+ * gives the step a test (`tests/migrate.test.ts`).
54
+ */
55
+ export declare const DOCUMENT_MIGRATIONS: readonly DocumentMigration[];
56
+ /** The format a document says it is in: its `formatVersion`, or 0 when it has none. */
57
+ export declare function documentFormatVersion(doc: unknown): number;
58
+ /**
59
+ * Bring a still, composition, audio or project document up to
60
+ * {@link DOCUMENT_FORMAT_VERSION}.
61
+ *
62
+ * A clip inside a project with no `formatVersion` of its own is read at the
63
+ * project's, since it was written alongside it. Anything that is not a
64
+ * document comes back untouched, for validation to describe.
65
+ */
66
+ export declare function migrateDocument<T extends ProjectDocument | ClipDocument>(doc: T): DocumentMigrationResult<T>;
67
+ export declare function migrateDocument(doc: unknown): DocumentMigrationResult<unknown>;
68
+ /** @internal {@link migrateDocument} over a given list of steps, for a test pinning the runner. */
69
+ export declare function migrateDocumentWith(doc: unknown, migrations: readonly DocumentMigration[], target: number): DocumentMigrationResult<unknown>;
70
+ //# sourceMappingURL=migrate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/document/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;GAUG;AAEH,wGAAwG;AACxG,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,2FAA2F;AAC3F,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAgC;CAS3E;AAED,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC3B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjE,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,CAAC;IACvE,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,CAAC;CAChF;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACtC,sGAAsG;IACtG,QAAQ,EAAE,CAAC,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EA2B3D,CAAC;AA2DF,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ1D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAC9G,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAKhF,mGAAmG;AACnG,wBAAgB,mBAAmB,CAC/B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,MAAM,EAAE,MAAM,GACf,uBAAuB,CAAC,OAAO,CAAC,CAYlC"}