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

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 (615) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +2 -4
  3. package/dist/assets/errors.js +4 -5
  4. package/dist/assets/errors.js.map +1 -1
  5. package/dist/assets/scope.d.ts +1 -1
  6. package/dist/assets/scope.d.ts.map +1 -1
  7. package/dist/assets/scope.js +1 -1
  8. package/dist/assets/scope.js.map +1 -1
  9. package/dist/attributes/audio/schedule.d.ts +3 -18
  10. package/dist/attributes/audio/schedule.d.ts.map +1 -1
  11. package/dist/attributes/audio/schedule.js.map +1 -1
  12. package/dist/attributes/index.d.ts +3 -5
  13. package/dist/attributes/index.d.ts.map +1 -1
  14. package/dist/attributes/index.js +2 -2
  15. package/dist/attributes/index.js.map +1 -1
  16. package/dist/attributes/layout/insets.d.ts +1 -1
  17. package/dist/attributes/layout/insets.js.map +1 -1
  18. package/dist/attributes/layout/size.d.ts +1 -1
  19. package/dist/attributes/layout/size.js +1 -1
  20. package/dist/attributes/layout/size.js.map +1 -1
  21. package/dist/attributes/properties/decorator.d.ts +44 -11
  22. package/dist/attributes/properties/decorator.d.ts.map +1 -1
  23. package/dist/attributes/properties/decorator.js +37 -9
  24. package/dist/attributes/properties/decorator.js.map +1 -1
  25. package/dist/attributes/properties/inputs.d.ts +1 -1
  26. package/dist/attributes/properties/inputs.js +1 -1
  27. package/dist/attributes/properties/inputs.js.map +1 -1
  28. package/dist/attributes/properties/typed.d.ts +19 -140
  29. package/dist/attributes/properties/typed.d.ts.map +1 -1
  30. package/dist/attributes/properties/typed.js +12 -108
  31. package/dist/attributes/properties/typed.js.map +1 -1
  32. package/dist/attributes/shape/corners/corner-radius.d.ts +1 -1
  33. package/dist/attributes/shape/corners/corner-radius.js +1 -1
  34. package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
  35. package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts +1 -1
  36. package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
  37. package/dist/attributes/shape/fill/color/parser.d.ts +1 -1
  38. package/dist/attributes/shape/fill/color/parser.js +1 -1
  39. package/dist/attributes/shape/fill/color/parser.js.map +1 -1
  40. package/dist/attributes/shape/fill/implementations/canvas3d.d.ts +2 -2
  41. package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
  42. package/dist/attributes/shape/fill/implementations/shader.d.ts +2 -2
  43. package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
  44. package/dist/attributes/shape/fill/implementations/video.d.ts +1 -1
  45. package/dist/attributes/shape/fill/implementations/video.js +1 -1
  46. package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
  47. package/dist/attributes/shape/fill/lerp.d.ts +1 -1
  48. package/dist/attributes/shape/fill/lerp.js.map +1 -1
  49. package/dist/attributes/shape/filters/chain.d.ts +1 -1
  50. package/dist/attributes/shape/filters/chain.js +1 -1
  51. package/dist/attributes/shape/filters/chain.js.map +1 -1
  52. package/dist/attributes/shape/filters/union.d.ts +4 -3
  53. package/dist/attributes/shape/filters/union.d.ts.map +1 -1
  54. package/dist/attributes/shape/filters/union.js.map +1 -1
  55. package/dist/attributes/shape/path/ops.d.ts +1 -2
  56. package/dist/attributes/shape/path/ops.d.ts.map +1 -1
  57. package/dist/attributes/shape/path/ops.js.map +1 -1
  58. package/dist/attributes/shared/operators.d.ts +2 -2
  59. package/dist/attributes/shared/operators.js.map +1 -1
  60. package/dist/attributes/text/types.d.ts +2 -3
  61. package/dist/attributes/text/types.d.ts.map +1 -1
  62. package/dist/attributes/text/types.js.map +1 -1
  63. package/dist/browser/chunks/chunk-D4FSTPML.js +14 -0
  64. package/dist/browser/chunks/chunk-D4FSTPML.js.map +7 -0
  65. package/dist/browser/chunks/chunk-LKUYVFU3.js +2 -0
  66. package/dist/browser/chunks/chunk-LKUYVFU3.js.map +7 -0
  67. package/dist/browser/chunks/chunk-RTNATFWX.js +5 -0
  68. package/dist/browser/chunks/chunk-RTNATFWX.js.map +7 -0
  69. package/dist/browser/chunks/chunk-ZRPZPWZU.js +3 -0
  70. package/dist/browser/chunks/chunk-ZRPZPWZU.js.map +7 -0
  71. package/dist/browser/component.js +1 -1
  72. package/dist/browser/component.js.map +4 -4
  73. package/dist/browser/experimental.js +2 -0
  74. package/dist/browser/index.js +1 -1
  75. package/dist/browser/index.js.map +4 -4
  76. package/dist/browser/manifest.json +3 -4
  77. package/dist/browser/sdk.js +1 -1
  78. package/dist/component/api.d.ts +508 -0
  79. package/dist/component/api.d.ts.map +1 -0
  80. package/dist/component/api.js +4 -0
  81. package/dist/component/api.js.map +1 -0
  82. package/dist/component/builtins/audio.d.ts +26 -0
  83. package/dist/component/builtins/audio.d.ts.map +1 -0
  84. package/dist/component/builtins/audio.js +41 -0
  85. package/dist/component/builtins/audio.js.map +1 -0
  86. package/dist/component/builtins/canvas3d.d.ts +98 -0
  87. package/dist/component/builtins/canvas3d.d.ts.map +1 -0
  88. package/dist/component/builtins/canvas3d.js +21 -0
  89. package/dist/component/builtins/canvas3d.js.map +1 -0
  90. package/dist/component/builtins/composite.d.ts +56 -0
  91. package/dist/component/builtins/composite.d.ts.map +1 -0
  92. package/dist/component/builtins/composite.js +25 -0
  93. package/dist/component/builtins/composite.js.map +1 -0
  94. package/dist/component/builtins/geometry.d.ts +505 -0
  95. package/dist/component/builtins/geometry.d.ts.map +1 -0
  96. package/dist/component/builtins/geometry.js +107 -0
  97. package/dist/component/builtins/geometry.js.map +1 -0
  98. package/dist/component/builtins/layout.d.ts +88 -0
  99. package/dist/component/builtins/layout.d.ts.map +1 -0
  100. package/dist/component/builtins/layout.js +84 -0
  101. package/dist/component/builtins/layout.js.map +1 -0
  102. package/dist/component/builtins/media.d.ts +95 -0
  103. package/dist/component/builtins/media.d.ts.map +1 -0
  104. package/dist/component/builtins/media.js +149 -0
  105. package/dist/component/builtins/media.js.map +1 -0
  106. package/dist/component/builtins/providers.d.ts +23 -0
  107. package/dist/component/builtins/providers.d.ts.map +1 -0
  108. package/dist/component/builtins/providers.js +30 -0
  109. package/dist/component/builtins/providers.js.map +1 -0
  110. package/dist/component/builtins/text.d.ts +193 -0
  111. package/dist/component/builtins/text.d.ts.map +1 -0
  112. package/dist/component/builtins/text.js +113 -0
  113. package/dist/component/builtins/text.js.map +1 -0
  114. package/dist/component/builtins/three.d.ts +1085 -0
  115. package/dist/component/builtins/three.d.ts.map +1 -0
  116. package/dist/component/builtins/three.js +265 -0
  117. package/dist/component/builtins/three.js.map +1 -0
  118. package/dist/component/clip-of.d.ts +5 -0
  119. package/dist/component/clip-of.d.ts.map +1 -0
  120. package/dist/component/clip-of.js +33 -0
  121. package/dist/component/clip-of.js.map +1 -0
  122. package/dist/component/commands-for.d.ts +19 -0
  123. package/dist/component/commands-for.d.ts.map +1 -0
  124. package/dist/component/commands-for.js +5 -0
  125. package/dist/component/commands-for.js.map +1 -0
  126. package/dist/component/component-audio.d.ts +9 -0
  127. package/dist/component/component-audio.d.ts.map +1 -0
  128. package/dist/component/component-audio.js +18 -0
  129. package/dist/component/component-audio.js.map +1 -0
  130. package/dist/component/component2d.d.ts +9 -0
  131. package/dist/component/component2d.d.ts.map +1 -0
  132. package/dist/component/component2d.js +239 -0
  133. package/dist/component/component2d.js.map +1 -0
  134. package/dist/component/component3d.d.ts +9 -0
  135. package/dist/component/component3d.d.ts.map +1 -0
  136. package/dist/component/component3d.js +99 -0
  137. package/dist/component/component3d.js.map +1 -0
  138. package/dist/component/factory.d.ts +63 -0
  139. package/dist/component/factory.d.ts.map +1 -0
  140. package/dist/component/factory.js +313 -0
  141. package/dist/component/factory.js.map +1 -0
  142. package/dist/component/modules/aim.d.ts +30 -0
  143. package/dist/component/modules/aim.d.ts.map +1 -0
  144. package/dist/component/modules/aim.js +39 -0
  145. package/dist/component/modules/aim.js.map +1 -0
  146. package/dist/component/modules/corners.d.ts +13 -0
  147. package/dist/component/modules/corners.d.ts.map +1 -0
  148. package/dist/component/modules/corners.js +12 -0
  149. package/dist/component/modules/corners.js.map +1 -0
  150. package/dist/component/modules/flow.d.ts +26 -0
  151. package/dist/component/modules/flow.d.ts.map +1 -0
  152. package/dist/component/modules/flow.js +55 -0
  153. package/dist/component/modules/flow.js.map +1 -0
  154. package/dist/component/modules/material.d.ts +40 -0
  155. package/dist/component/modules/material.d.ts.map +1 -0
  156. package/dist/component/modules/material.js +75 -0
  157. package/dist/component/modules/material.js.map +1 -0
  158. package/dist/component/modules/paint.d.ts +71 -0
  159. package/dist/component/modules/paint.d.ts.map +1 -0
  160. package/dist/component/modules/paint.js +106 -0
  161. package/dist/component/modules/paint.js.map +1 -0
  162. package/dist/component/modules/shapes.d.ts +31 -0
  163. package/dist/component/modules/shapes.d.ts.map +1 -0
  164. package/dist/component/modules/shapes.js +43 -0
  165. package/dist/component/modules/shapes.js.map +1 -0
  166. package/dist/component/modules/text-layout.d.ts +26 -0
  167. package/dist/component/modules/text-layout.d.ts.map +1 -0
  168. package/dist/component/modules/text-layout.js +57 -0
  169. package/dist/component/modules/text-layout.js.map +1 -0
  170. package/dist/component/modules/text-style.d.ts +48 -0
  171. package/dist/component/modules/text-style.d.ts.map +1 -0
  172. package/dist/component/modules/text-style.js +63 -0
  173. package/dist/component/modules/text-style.js.map +1 -0
  174. package/dist/component/modules/three-entries.d.ts +23 -0
  175. package/dist/component/modules/three-entries.d.ts.map +1 -0
  176. package/dist/component/modules/three-entries.js +41 -0
  177. package/dist/component/modules/three-entries.js.map +1 -0
  178. package/dist/component/modules/view3d.d.ts +55 -0
  179. package/dist/component/modules/view3d.d.ts.map +1 -0
  180. package/dist/component/modules/view3d.js +160 -0
  181. package/dist/component/modules/view3d.js.map +1 -0
  182. package/dist/component/timeline.d.ts +22 -0
  183. package/dist/component/timeline.d.ts.map +1 -0
  184. package/dist/component/timeline.js +128 -0
  185. package/dist/component/timeline.js.map +1 -0
  186. package/dist/component/type-def.d.ts +26 -0
  187. package/dist/component/type-def.d.ts.map +1 -0
  188. package/dist/component/type-def.js +16 -0
  189. package/dist/component/type-def.js.map +1 -0
  190. package/dist/component/types.d.ts +91 -0
  191. package/dist/component/types.d.ts.map +1 -0
  192. package/dist/component/types.js +88 -0
  193. package/dist/component/types.js.map +1 -0
  194. package/dist/component/views.d.ts +121 -0
  195. package/dist/component/views.d.ts.map +1 -0
  196. package/dist/component/views.js +413 -0
  197. package/dist/component/views.js.map +1 -0
  198. package/dist/component.d.ts +10 -19
  199. package/dist/component.d.ts.map +1 -1
  200. package/dist/component.js +10 -19
  201. package/dist/component.js.map +1 -1
  202. package/dist/components/builtins/audio/audio.d.ts +53 -0
  203. package/dist/components/builtins/audio/audio.d.ts.map +1 -0
  204. package/dist/components/builtins/audio/audio.js +41 -0
  205. package/dist/components/builtins/audio/audio.js.map +1 -0
  206. package/dist/components/builtins/geometry/composite.d.ts +93 -0
  207. package/dist/components/builtins/geometry/composite.d.ts.map +1 -0
  208. package/dist/components/builtins/geometry/composite.js +25 -0
  209. package/dist/components/builtins/geometry/composite.js.map +1 -0
  210. package/dist/components/builtins/geometry/geometry.d.ts +921 -0
  211. package/dist/components/builtins/geometry/geometry.d.ts.map +1 -0
  212. package/dist/components/builtins/geometry/geometry.js +107 -0
  213. package/dist/components/builtins/geometry/geometry.js.map +1 -0
  214. package/dist/components/builtins/geometry/shape-outline.d.ts +93 -0
  215. package/dist/components/builtins/geometry/shape-outline.d.ts.map +1 -0
  216. package/dist/components/builtins/geometry/shape-outline.js +470 -0
  217. package/dist/components/builtins/geometry/shape-outline.js.map +1 -0
  218. package/dist/components/builtins/layout/layout.d.ts +186 -0
  219. package/dist/components/builtins/layout/layout.d.ts.map +1 -0
  220. package/dist/components/builtins/layout/layout.js +84 -0
  221. package/dist/components/builtins/layout/layout.js.map +1 -0
  222. package/dist/components/builtins/media/media.d.ts +240 -0
  223. package/dist/components/builtins/media/media.d.ts.map +1 -0
  224. package/dist/components/builtins/media/media.js +149 -0
  225. package/dist/components/builtins/media/media.js.map +1 -0
  226. package/dist/components/builtins/providers/providers.d.ts +47 -0
  227. package/dist/components/builtins/providers/providers.d.ts.map +1 -0
  228. package/dist/components/builtins/providers/providers.js +30 -0
  229. package/dist/components/builtins/providers/providers.js.map +1 -0
  230. package/dist/components/builtins/text/number-format.d.ts +66 -0
  231. package/dist/components/builtins/text/number-format.d.ts.map +1 -0
  232. package/dist/components/builtins/text/number-format.js +227 -0
  233. package/dist/components/builtins/text/number-format.js.map +1 -0
  234. package/dist/components/builtins/text/number-pattern.d.ts +51 -0
  235. package/dist/components/builtins/text/number-pattern.d.ts.map +1 -0
  236. package/dist/components/builtins/text/number-pattern.js +77 -0
  237. package/dist/components/builtins/text/number-pattern.js.map +1 -0
  238. package/dist/components/builtins/text/text-defaults.d.ts +32 -0
  239. package/dist/components/builtins/text/text-defaults.d.ts.map +1 -0
  240. package/dist/components/builtins/text/text-defaults.js +37 -0
  241. package/dist/components/builtins/text/text-defaults.js.map +1 -0
  242. package/dist/components/builtins/text/text-layout.d.ts +82 -0
  243. package/dist/components/builtins/text/text-layout.d.ts.map +1 -0
  244. package/dist/components/builtins/text/text-layout.js +331 -0
  245. package/dist/components/builtins/text/text-layout.js.map +1 -0
  246. package/dist/components/builtins/text/text.d.ts +409 -0
  247. package/dist/components/builtins/text/text.d.ts.map +1 -0
  248. package/dist/components/builtins/text/text.js +113 -0
  249. package/dist/components/builtins/text/text.js.map +1 -0
  250. package/dist/components/builtins/three/canvas3d.d.ts +245 -0
  251. package/dist/components/builtins/three/canvas3d.d.ts.map +1 -0
  252. package/dist/components/builtins/three/canvas3d.js +21 -0
  253. package/dist/components/builtins/three/canvas3d.js.map +1 -0
  254. package/dist/components/builtins/three/grid-geometry3d.d.ts +62 -0
  255. package/dist/components/builtins/three/grid-geometry3d.d.ts.map +1 -0
  256. package/dist/components/builtins/three/grid-geometry3d.js +114 -0
  257. package/dist/components/builtins/three/grid-geometry3d.js.map +1 -0
  258. package/dist/components/builtins/three/three.d.ts +1889 -0
  259. package/dist/components/builtins/three/three.d.ts.map +1 -0
  260. package/dist/components/builtins/three/three.js +305 -0
  261. package/dist/components/builtins/three/three.js.map +1 -0
  262. package/dist/components/factory/api.d.ts +516 -0
  263. package/dist/components/factory/api.d.ts.map +1 -0
  264. package/dist/components/factory/api.js +4 -0
  265. package/dist/components/factory/api.js.map +1 -0
  266. package/dist/components/factory/clip-of.d.ts +5 -0
  267. package/dist/components/factory/clip-of.d.ts.map +1 -0
  268. package/dist/components/factory/clip-of.js +33 -0
  269. package/dist/components/factory/clip-of.js.map +1 -0
  270. package/dist/components/factory/commands-for.d.ts +19 -0
  271. package/dist/components/factory/commands-for.d.ts.map +1 -0
  272. package/dist/components/factory/commands-for.js +5 -0
  273. package/dist/components/factory/commands-for.js.map +1 -0
  274. package/dist/components/factory/component-audio.d.ts +9 -0
  275. package/dist/components/factory/component-audio.d.ts.map +1 -0
  276. package/dist/components/factory/component-audio.js +18 -0
  277. package/dist/components/factory/component-audio.js.map +1 -0
  278. package/dist/components/factory/component2d.d.ts +8 -0
  279. package/dist/components/factory/component2d.d.ts.map +1 -0
  280. package/dist/components/factory/component2d.js +240 -0
  281. package/dist/components/factory/component2d.js.map +1 -0
  282. package/dist/components/factory/component3d.d.ts +9 -0
  283. package/dist/components/factory/component3d.d.ts.map +1 -0
  284. package/dist/components/factory/component3d.js +99 -0
  285. package/dist/components/factory/component3d.js.map +1 -0
  286. package/dist/components/factory/factory.d.ts +63 -0
  287. package/dist/components/factory/factory.d.ts.map +1 -0
  288. package/dist/components/factory/factory.js +313 -0
  289. package/dist/components/factory/factory.js.map +1 -0
  290. package/dist/components/factory/timeline.d.ts +22 -0
  291. package/dist/components/factory/timeline.d.ts.map +1 -0
  292. package/dist/components/factory/timeline.js +128 -0
  293. package/dist/components/factory/timeline.js.map +1 -0
  294. package/dist/components/factory/type-def.d.ts +26 -0
  295. package/dist/components/factory/type-def.d.ts.map +1 -0
  296. package/dist/components/factory/type-def.js +16 -0
  297. package/dist/components/factory/type-def.js.map +1 -0
  298. package/dist/components/factory/types.d.ts +91 -0
  299. package/dist/components/factory/types.d.ts.map +1 -0
  300. package/dist/components/factory/types.js +88 -0
  301. package/dist/components/factory/types.js.map +1 -0
  302. package/dist/components/factory/views.d.ts +121 -0
  303. package/dist/components/factory/views.d.ts.map +1 -0
  304. package/dist/components/factory/views.js +413 -0
  305. package/dist/components/factory/views.js.map +1 -0
  306. package/dist/components/modules/aim.d.ts +30 -0
  307. package/dist/components/modules/aim.d.ts.map +1 -0
  308. package/dist/components/modules/aim.js +39 -0
  309. package/dist/components/modules/aim.js.map +1 -0
  310. package/dist/components/modules/corners.d.ts +13 -0
  311. package/dist/components/modules/corners.d.ts.map +1 -0
  312. package/dist/components/modules/corners.js +12 -0
  313. package/dist/components/modules/corners.js.map +1 -0
  314. package/dist/components/modules/flow.d.ts +26 -0
  315. package/dist/components/modules/flow.d.ts.map +1 -0
  316. package/dist/components/modules/flow.js +57 -0
  317. package/dist/components/modules/flow.js.map +1 -0
  318. package/dist/components/modules/material.d.ts +40 -0
  319. package/dist/components/modules/material.d.ts.map +1 -0
  320. package/dist/components/modules/material.js +75 -0
  321. package/dist/components/modules/material.js.map +1 -0
  322. package/dist/components/modules/paint.d.ts +71 -0
  323. package/dist/components/modules/paint.d.ts.map +1 -0
  324. package/dist/components/modules/paint.js +106 -0
  325. package/dist/components/modules/paint.js.map +1 -0
  326. package/dist/components/modules/shapes.d.ts +31 -0
  327. package/dist/components/modules/shapes.d.ts.map +1 -0
  328. package/dist/components/modules/shapes.js +43 -0
  329. package/dist/components/modules/shapes.js.map +1 -0
  330. package/dist/components/modules/text-layout.d.ts +26 -0
  331. package/dist/components/modules/text-layout.d.ts.map +1 -0
  332. package/dist/components/modules/text-layout.js +57 -0
  333. package/dist/components/modules/text-layout.js.map +1 -0
  334. package/dist/components/modules/text-style.d.ts +48 -0
  335. package/dist/components/modules/text-style.d.ts.map +1 -0
  336. package/dist/components/modules/text-style.js +63 -0
  337. package/dist/components/modules/text-style.js.map +1 -0
  338. package/dist/components/modules/three-entries.d.ts +23 -0
  339. package/dist/components/modules/three-entries.d.ts.map +1 -0
  340. package/dist/components/modules/three-entries.js +41 -0
  341. package/dist/components/modules/three-entries.js.map +1 -0
  342. package/dist/components/modules/view3d.d.ts +59 -0
  343. package/dist/components/modules/view3d.d.ts.map +1 -0
  344. package/dist/components/modules/view3d.js +171 -0
  345. package/dist/components/modules/view3d.js.map +1 -0
  346. package/dist/components/trees/2d/group-bounds.d.ts +56 -0
  347. package/dist/components/trees/2d/group-bounds.d.ts.map +1 -0
  348. package/dist/components/trees/2d/group-bounds.js +87 -0
  349. package/dist/components/trees/2d/group-bounds.js.map +1 -0
  350. package/dist/components/trees/2d/node-lifecycle.d.ts +46 -0
  351. package/dist/components/trees/2d/node-lifecycle.d.ts.map +1 -0
  352. package/dist/components/trees/2d/node-lifecycle.js +264 -0
  353. package/dist/components/trees/2d/node-lifecycle.js.map +1 -0
  354. package/dist/components/trees/2d/node-motion.d.ts +56 -0
  355. package/dist/components/trees/2d/node-motion.d.ts.map +1 -0
  356. package/dist/components/trees/2d/node-motion.js +86 -0
  357. package/dist/components/trees/2d/node-motion.js.map +1 -0
  358. package/dist/components/trees/2d/node-render.d.ts +36 -0
  359. package/dist/components/trees/2d/node-render.d.ts.map +1 -0
  360. package/dist/components/trees/2d/node-render.js +67 -0
  361. package/dist/components/trees/2d/node-render.js.map +1 -0
  362. package/dist/components/trees/2d/node-space.d.ts +63 -0
  363. package/dist/components/trees/2d/node-space.d.ts.map +1 -0
  364. package/dist/components/trees/2d/node-space.js +131 -0
  365. package/dist/components/trees/2d/node-space.js.map +1 -0
  366. package/dist/components/trees/2d/node-transform.d.ts +55 -0
  367. package/dist/components/trees/2d/node-transform.d.ts.map +1 -0
  368. package/dist/components/trees/2d/node-transform.js +73 -0
  369. package/dist/components/trees/2d/node-transform.js.map +1 -0
  370. package/dist/components/trees/2d/node2d.d.ts +1020 -0
  371. package/dist/components/trees/2d/node2d.d.ts.map +1 -0
  372. package/dist/components/trees/2d/node2d.js +1481 -0
  373. package/dist/components/trees/2d/node2d.js.map +1 -0
  374. package/dist/components/trees/audio/index.d.ts +2 -0
  375. package/dist/components/trees/audio/index.d.ts.map +1 -0
  376. package/dist/components/trees/audio/index.js +2 -0
  377. package/dist/components/trees/audio/index.js.map +1 -0
  378. package/dist/components/trees/audio/node-audio.d.ts +109 -0
  379. package/dist/components/trees/audio/node-audio.d.ts.map +1 -0
  380. package/dist/components/trees/audio/node-audio.js +167 -0
  381. package/dist/components/trees/audio/node-audio.js.map +1 -0
  382. package/dist/components/trees/index.d.ts +10 -0
  383. package/dist/components/trees/index.d.ts.map +1 -0
  384. package/dist/components/trees/index.js +14 -0
  385. package/dist/components/trees/index.js.map +1 -0
  386. package/dist/components/trees/node/node-editor-state.d.ts +53 -0
  387. package/dist/components/trees/node/node-editor-state.d.ts.map +1 -0
  388. package/dist/components/trees/node/node-editor-state.js +23 -0
  389. package/dist/components/trees/node/node-editor-state.js.map +1 -0
  390. package/dist/components/trees/node/node-reactive.d.ts +89 -0
  391. package/dist/components/trees/node/node-reactive.d.ts.map +1 -0
  392. package/dist/components/trees/node/node-reactive.js +135 -0
  393. package/dist/components/trees/node/node-reactive.js.map +1 -0
  394. package/dist/components/trees/node/node-time.d.ts +39 -0
  395. package/dist/components/trees/node/node-time.d.ts.map +1 -0
  396. package/dist/components/trees/node/node-time.js +14 -0
  397. package/dist/components/trees/node/node-time.js.map +1 -0
  398. package/dist/components/trees/node/node-walk.d.ts +46 -0
  399. package/dist/components/trees/node/node-walk.d.ts.map +1 -0
  400. package/dist/components/trees/node/node-walk.js +74 -0
  401. package/dist/components/trees/node/node-walk.js.map +1 -0
  402. package/dist/components/trees/node/node.d.ts +401 -0
  403. package/dist/components/trees/node/node.d.ts.map +1 -0
  404. package/dist/components/trees/node/node.js +680 -0
  405. package/dist/components/trees/node/node.js.map +1 -0
  406. package/dist/components/trees/root/canvas2d-node.d.ts +163 -0
  407. package/dist/components/trees/root/canvas2d-node.d.ts.map +1 -0
  408. package/dist/components/trees/root/canvas2d-node.js +216 -0
  409. package/dist/components/trees/root/canvas2d-node.js.map +1 -0
  410. package/dist/components/trees/three/node3d.d.ts +222 -0
  411. package/dist/components/trees/three/node3d.d.ts.map +1 -0
  412. package/dist/components/trees/three/node3d.js +289 -0
  413. package/dist/components/trees/three/node3d.js.map +1 -0
  414. package/dist/document/audio.d.ts +9 -1
  415. package/dist/document/audio.d.ts.map +1 -1
  416. package/dist/document/audio.js +41 -0
  417. package/dist/document/audio.js.map +1 -1
  418. package/dist/document/builtins.d.ts.map +1 -1
  419. package/dist/document/builtins.js +13 -31
  420. package/dist/document/builtins.js.map +1 -1
  421. package/dist/document/command-traits.d.ts +2 -2
  422. package/dist/document/command-traits.js +4 -1
  423. package/dist/document/command-traits.js.map +1 -1
  424. package/dist/document/deny-globals.d.ts +2 -2
  425. package/dist/document/deny-globals.js +2 -2
  426. package/dist/document/deny-globals.js.map +1 -1
  427. package/dist/document/diff.d.ts.map +1 -1
  428. package/dist/document/diff.js +3 -3
  429. package/dist/document/diff.js.map +1 -1
  430. package/dist/document/doc-index.d.ts.map +1 -1
  431. package/dist/document/doc-index.js +3 -3
  432. package/dist/document/doc-index.js.map +1 -1
  433. package/dist/document/expression/index.d.ts +1 -1
  434. package/dist/document/expression/index.js +1 -1
  435. package/dist/document/expression/index.js.map +1 -1
  436. package/dist/document/expression/ops.js +1 -1
  437. package/dist/document/expression/ops.js.map +1 -1
  438. package/dist/document/index.d.ts +1 -2
  439. package/dist/document/index.d.ts.map +1 -1
  440. package/dist/document/index.js +1 -2
  441. package/dist/document/index.js.map +1 -1
  442. package/dist/document/node-decorator.d.ts +14 -10
  443. package/dist/document/node-decorator.d.ts.map +1 -1
  444. package/dist/document/node-decorator.js +14 -10
  445. package/dist/document/node-decorator.js.map +1 -1
  446. package/dist/document/node-descriptor.d.ts +9 -3
  447. package/dist/document/node-descriptor.d.ts.map +1 -1
  448. package/dist/document/node-descriptor.js.map +1 -1
  449. package/dist/document/placement.js +2 -2
  450. package/dist/document/placement.js.map +1 -1
  451. package/dist/document/registry.d.ts +29 -36
  452. package/dist/document/registry.d.ts.map +1 -1
  453. package/dist/document/registry.js +29 -35
  454. package/dist/document/registry.js.map +1 -1
  455. package/dist/document/settled-index.d.ts +49 -0
  456. package/dist/document/settled-index.d.ts.map +1 -0
  457. package/dist/document/settled-index.js +247 -0
  458. package/dist/document/settled-index.js.map +1 -0
  459. package/dist/document/timeline.d.ts +29 -3
  460. package/dist/document/timeline.d.ts.map +1 -1
  461. package/dist/document/timeline.js +99 -3
  462. package/dist/document/timeline.js.map +1 -1
  463. package/dist/document/types.d.ts +4 -4
  464. package/dist/document/types.js.map +1 -1
  465. package/dist/document/validate.d.ts +1 -1
  466. package/dist/document/validate.js.map +1 -1
  467. package/dist/experimental.d.ts +22 -0
  468. package/dist/experimental.d.ts.map +1 -0
  469. package/dist/experimental.js +20 -0
  470. package/dist/experimental.js.map +1 -0
  471. package/dist/index.d.ts +10 -2
  472. package/dist/index.d.ts.map +1 -1
  473. package/dist/index.js +10 -2
  474. package/dist/index.js.map +1 -1
  475. package/dist/layout/types.d.ts +1 -1
  476. package/dist/layout/types.js.map +1 -1
  477. package/dist/nodes/audio/index.d.ts +2 -2
  478. package/dist/nodes/audio/index.d.ts.map +1 -1
  479. package/dist/nodes/audio/index.js +0 -2
  480. package/dist/nodes/audio/index.js.map +1 -1
  481. package/dist/nodes/audio/sound-node.d.ts +2 -1
  482. package/dist/nodes/audio/sound-node.d.ts.map +1 -1
  483. package/dist/nodes/audio/sound-node.js +3 -0
  484. package/dist/nodes/audio/sound-node.js.map +1 -1
  485. package/dist/nodes/index.d.ts +39 -27
  486. package/dist/nodes/index.d.ts.map +1 -1
  487. package/dist/nodes/index.js +16 -30
  488. package/dist/nodes/index.js.map +1 -1
  489. package/dist/nodes/node/node.d.ts +7 -1
  490. package/dist/nodes/node/node.d.ts.map +1 -1
  491. package/dist/nodes/node/node.js +23 -8
  492. package/dist/nodes/node/node.js.map +1 -1
  493. package/dist/nodes/root/canvas2d-node.d.ts +2 -1
  494. package/dist/nodes/root/canvas2d-node.d.ts.map +1 -1
  495. package/dist/nodes/root/canvas2d-node.js +3 -0
  496. package/dist/nodes/root/canvas2d-node.js.map +1 -1
  497. package/dist/nodes/text/richtext-node.d.ts +0 -5
  498. package/dist/nodes/text/richtext-node.d.ts.map +1 -1
  499. package/dist/nodes/text/richtext-node.js +5 -71
  500. package/dist/nodes/text/richtext-node.js.map +1 -1
  501. package/dist/nodes/text/text-base.d.ts +5 -22
  502. package/dist/nodes/text/text-base.d.ts.map +1 -1
  503. package/dist/nodes/text/text-base.js +12 -363
  504. package/dist/nodes/text/text-base.js.map +1 -1
  505. package/dist/nodes/text/text-layout.d.ts +87 -0
  506. package/dist/nodes/text/text-layout.d.ts.map +1 -0
  507. package/dist/nodes/text/text-layout.js +368 -0
  508. package/dist/nodes/text/text-layout.js.map +1 -0
  509. package/dist/nodes/three/canvas3d-node.d.ts +3 -1
  510. package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
  511. package/dist/nodes/three/canvas3d-node.js +6 -0
  512. package/dist/nodes/three/canvas3d-node.js.map +1 -1
  513. package/dist/props/host.d.ts +1 -1
  514. package/dist/props/host.js.map +1 -1
  515. package/dist/props/slot.d.ts +1 -1
  516. package/dist/props/slot.js +1 -1
  517. package/dist/props/slot.js.map +1 -1
  518. package/dist/render/clip.d.ts +1 -1
  519. package/dist/render/clip.js +1 -1
  520. package/dist/render/clip.js.map +1 -1
  521. package/dist/render/descriptors/rect.js.map +1 -1
  522. package/dist/render/descriptors/text.d.ts +11 -5
  523. package/dist/render/descriptors/text.d.ts.map +1 -1
  524. package/dist/render/descriptors/text.js +7 -1
  525. package/dist/render/descriptors/text.js.map +1 -1
  526. package/dist/render/render-context2d.d.ts +2 -2
  527. package/dist/render/render-context2d.js.map +1 -1
  528. package/dist/render3d/builders.d.ts +1 -1
  529. package/dist/render3d/builders.js +1 -1
  530. package/dist/render3d/builders.js.map +1 -1
  531. package/dist/render3d/graphics3d.d.ts +13 -19
  532. package/dist/render3d/graphics3d.d.ts.map +1 -1
  533. package/dist/render3d/graphics3d.js +13 -19
  534. package/dist/render3d/graphics3d.js.map +1 -1
  535. package/dist/render3d/scene3d.d.ts +1 -1
  536. package/dist/render3d/scene3d.js +1 -1
  537. package/dist/render3d/scene3d.js.map +1 -1
  538. package/dist/render3d/texture.d.ts +2 -2
  539. package/dist/render3d/texture.d.ts.map +1 -1
  540. package/dist/render3d/texture.js.map +1 -1
  541. package/dist/render3d/vector3.d.ts +2 -2
  542. package/dist/render3d/vector3.js +2 -2
  543. package/dist/render3d/vector3.js.map +1 -1
  544. package/dist/runtime/asset-refine.d.ts +1 -1
  545. package/dist/runtime/asset-refine.d.ts.map +1 -1
  546. package/dist/runtime/asset-refine.js +1 -1
  547. package/dist/runtime/asset-refine.js.map +1 -1
  548. package/dist/runtime/asset-update.js +1 -1
  549. package/dist/runtime/asset-update.js.map +1 -1
  550. package/dist/runtime/audio-index.d.ts +0 -11
  551. package/dist/runtime/audio-index.d.ts.map +1 -1
  552. package/dist/runtime/audio-index.js +0 -25
  553. package/dist/runtime/audio-index.js.map +1 -1
  554. package/dist/runtime/clip-instance.d.ts +7 -4
  555. package/dist/runtime/clip-instance.d.ts.map +1 -1
  556. package/dist/runtime/clip-instance.js +21 -7
  557. package/dist/runtime/clip-instance.js.map +1 -1
  558. package/dist/runtime/clip-store.d.ts +11 -3
  559. package/dist/runtime/clip-store.d.ts.map +1 -1
  560. package/dist/runtime/clip-store.js +83 -23
  561. package/dist/runtime/clip-store.js.map +1 -1
  562. package/dist/runtime/engine.d.ts +3 -3
  563. package/dist/runtime/engine.js +2 -2
  564. package/dist/runtime/engine.js.map +1 -1
  565. package/dist/runtime/node-picking.d.ts +2 -2
  566. package/dist/runtime/node-picking.d.ts.map +1 -1
  567. package/dist/runtime/node-picking.js +9 -10
  568. package/dist/runtime/node-picking.js.map +1 -1
  569. package/dist/runtime/node-picking3d.d.ts +12 -5
  570. package/dist/runtime/node-picking3d.d.ts.map +1 -1
  571. package/dist/runtime/node-picking3d.js +6 -1
  572. package/dist/runtime/node-picking3d.js.map +1 -1
  573. package/dist/runtime/playback-controller.d.ts +2 -2
  574. package/dist/runtime/playback-controller.d.ts.map +1 -1
  575. package/dist/runtime/playback-controller.js +1 -1
  576. package/dist/runtime/playback-controller.js.map +1 -1
  577. package/dist/runtime/state-evaluator.d.ts +2 -2
  578. package/dist/runtime/state-evaluator.d.ts.map +1 -1
  579. package/dist/runtime/state-evaluator.js.map +1 -1
  580. package/dist/runtime/text-geometry.d.ts +1 -1
  581. package/dist/runtime/text-geometry.d.ts.map +1 -1
  582. package/dist/runtime/text-geometry.js +6 -3
  583. package/dist/runtime/text-geometry.js.map +1 -1
  584. package/dist/sdk/index.d.ts +46 -21
  585. package/dist/sdk/index.d.ts.map +1 -1
  586. package/dist/sdk/index.js +47 -43
  587. package/dist/sdk/index.js.map +1 -1
  588. package/dist/tween/command-decorator.d.ts +7 -9
  589. package/dist/tween/command-decorator.d.ts.map +1 -1
  590. package/dist/tween/command-decorator.js +2 -2
  591. package/dist/tween/command-decorator.js.map +1 -1
  592. package/dist/tween/command.d.ts +13 -1
  593. package/dist/tween/command.d.ts.map +1 -1
  594. package/dist/tween/command.js +14 -0
  595. package/dist/tween/command.js.map +1 -1
  596. package/dist/tween/index.d.ts +2 -1
  597. package/dist/tween/index.d.ts.map +1 -1
  598. package/dist/tween/index.js +1 -1
  599. package/dist/tween/index.js.map +1 -1
  600. package/dist/tween/loop.d.ts +1 -1
  601. package/dist/tween/loop.js +1 -1
  602. package/dist/tween/loop.js.map +1 -1
  603. package/dist/util/reference.d.ts +6 -6
  604. package/dist/util/reference.js.map +1 -1
  605. package/package.json +7 -10
  606. package/dist/browser/chunks/chunk-FUZVFT3W.js +0 -18
  607. package/dist/browser/chunks/chunk-FUZVFT3W.js.map +0 -7
  608. package/dist/browser/chunks/chunk-QG6C23IJ.js +0 -3
  609. package/dist/browser/chunks/chunk-QG6C23IJ.js.map +0 -7
  610. package/dist/browser/chunks/chunk-SFNJRPBV.js +0 -2
  611. package/dist/browser/chunks/chunk-SFNJRPBV.js.map +0 -7
  612. package/dist/browser/jsx-jsx-dev-runtime.js +0 -2
  613. package/dist/browser/jsx-jsx-runtime.js +0 -2
  614. package/dist/browser/jsx-jsx-runtime.js.map +0 -7
  615. /package/dist/browser/{jsx-jsx-dev-runtime.js.map → experimental.js.map} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/render/descriptors/text.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FontStyle, TextAlign, TextDecoration, VerticalAlign } from \"@/attributes/text/types\";\r\nimport { FillResolved } from \"@/attributes/shape/fill/union\";\r\nimport { StrokeResolved } from \"@/attributes/shape/stroke/stroke\";\r\nimport { PathData } from \"./path\";\r\nimport { ShapeAlignmentInput, ShapeState, resolveShapeAlignment, resolveShapePivot, stripShapeAlignmentKeys } from \"./shape\";\r\nimport { hostTextFamily } from \"@/nodes/node/text-defaults\";\r\n\r\n/**\r\n * One contiguous piece of a Text node split at selection boundaries. Pieces\r\n * carry their effective shaping inputs (`text` plus the five font fields) and\r\n * draw-time overrides applied per shaped run: `opacity` folded into the paint\r\n * alpha, an optional `fill`/`stroke` override (falls back to the node's when\r\n * omitted), and a transform applied about the run's centered position.\r\n *\r\n * Present only when a Text node has active selections; otherwise the node\r\n * renders as a single string with no segments (unchanged behavior).\r\n *\r\n * **Every shaping field is stated, none inherited at draw time.** `fontFamily`,\r\n * `fontSize` and `fontStyle` joined `fontWeight` and `letterSpacing` here so a\r\n * selection can change the *face* of a run and not only its weight — which is\r\n * what an editor built on this needs to offer per-character styling at all. The\r\n * paragraph builder already takes all five per run (it is what `RichText` sets),\r\n * so the cost of the three is a wider segment and nothing else.\r\n *\r\n * They are optional only so an older caller's segments still lay out: absent\r\n * means \"the node's own\", resolved where the paragraph is built rather than\r\n * left for the renderer to guess.\r\n */\r\nexport interface TextSegment {\r\n text: string;\r\n /** Override family for this piece; falls back to the node's when undefined. */\r\n fontFamily?: string;\r\n /** Override size for this piece; falls back to the node's when undefined. */\r\n fontSize?: number;\r\n /** Override slant for this piece; falls back to the node's when undefined. */\r\n fontStyle?: FontStyle;\r\n fontWeight: number;\r\n letterSpacing: number;\r\n /** Override decoration for this piece; falls back to the node's when undefined. */\r\n textDecoration?: TextDecoration;\r\n opacity: number;\r\n x: number;\r\n y: number;\r\n scale: number;\r\n rotation: number;\r\n /** Override fill for this piece; falls back to the node's fill when undefined. */\r\n fill?: FillResolved[];\r\n /** Override stroke for this piece; falls back to the node's stroke when undefined. */\r\n stroke?: StrokeResolved[];\r\n}\r\n\r\n/**\r\n * Whether `segment` only *styles* its characters — no transform of its own.\r\n *\r\n * The caret model can describe a segmented block exactly as long as this holds\r\n * of every piece: differently-styled runs are still one paragraph, laid out and\r\n * measured together, so Skia's own rects for each character are where the glyphs\r\n * are. A piece that is *moved*, turned or scaled about its own centre is not in\r\n * that paragraph's space any more, and a slot measured from it would point at\r\n * where the character would have been. See `textBlockLayout`, which is the one\r\n * caller and turns a false here into \"no caret model for this shape\".\r\n */\r\nexport function isStyleOnlySegment(segment: TextSegment): boolean {\r\n return segment.x === 0 && segment.y === 0\r\n && segment.scale === 1 && segment.rotation === 0;\r\n}\r\n\r\nexport interface TextState extends ShapeState {\r\n text: string;\r\n /**\r\n * A named typography preset to shape against — `theme.typography`'s key, the\r\n * same one a `Text` node's `variant` prop selects.\r\n *\r\n * A node reads its variant once, at bind; a drawn op has no bind step, so it\r\n * is resolved at draw alongside the inherited defaults (see\r\n * `applyGraphicsTextDefaults`). It sits *between* the two: above the\r\n * enclosing `<DefaultTextStyle>`, below anything the op states itself.\r\n *\r\n * Optional, and unresolved names are ignored rather than an error — a scene\r\n * that renames a preset should lose the styling, not fail to draw.\r\n */\r\n variant?: string;\r\n fontSize: number | 'autofit';\r\n fontFamily: string;\r\n fontWeight: number;\r\n fontStyle: FontStyle;\r\n letterSpacing: number;\r\n lineHeight: number;\r\n textAlign: TextAlign;\r\n /** Where the block sits in a box taller or shorter than it; only a `height` gives it one. */\r\n verticalAlign: VerticalAlign;\r\n textDecoration: TextDecoration;\r\n wrap: boolean;\r\n minFontSize: number;\r\n width: number;\r\n height: number;\r\n /**\r\n * Per-piece overrides when the node has active text selections. When set,\r\n * the renderer shapes these pieces together (one paragraph) and paints each\r\n * shaped run with its piece's overrides instead of the node's single fill.\r\n */\r\n segments?: TextSegment[];\r\n /**\r\n * When set, the text is wrapped around this path (text-on-path) instead of\r\n * laid out as straight lines: each glyph is positioned and rotated to follow\r\n * the path, centered on its baseline, and glyphs past the path end are\r\n * clipped. Mutually exclusive with `segments` in v1.\r\n */\r\n path?: PathData | null;\r\n}\r\n\r\n\r\n/**\r\n * The family this text is set in — the last rung of the cascade, and the only\r\n * one that can refuse.\r\n *\r\n * It used to fall back to `\"Arial\"`, which is the wrong shape of answer for a\r\n * renderer whose whole job is that the picture is the one that was asked for:\r\n * substituting a face the *engine* picked produces text in a typeface the author\r\n * never chose, at metrics they never measured, in a frame that looks finished,\r\n * and hides a font that was never declared and so never loaded.\r\n *\r\n * What it falls back to instead is {@link hostTextFamily} — a face the\r\n * **application** named, once, at its composition root, out of the fonts it\r\n * actually vendors. That is a different bargain: a host that ships a typeface\r\n * registers it in every manifest, so a chart axis that nobody styled comes out\r\n * in it and paints glyphs, while the engine still refuses to invent a face of\r\n * its own. A host that declares nothing gets the error below, which is the right\r\n * answer for a headless render whose fonts all come from a manifest.\r\n *\r\n * By the time an op reaches here the whole ladder above has been walked — the op\r\n * or prop itself, a `variant` preset, the enclosing `<DefaultTextStyle>`, then\r\n * the theme's `default` typography preset — so this is only ever reached when\r\n * every one of them was silent. The message names them because \"no font family\"\r\n * is not actionable and \"set one on the text, on a DefaultTextStyle, or as the\r\n * theme's default preset\" is.\r\n *\r\n * Exported so the **measure** path enforces the same policy from the same\r\n * definition. Shaping a paragraph to measure it happens before any op is\r\n * validated, and Skia reads `.length` off every family name — so text with no\r\n * family used to die inside the wasm with `Cannot read properties of undefined`,\r\n * naming no scene, node or prop, while the identical case at draw time produced\r\n * the message above. One policy, two verdicts, and the useless one came first.\r\n */\r\nexport function requireFontFamily(descriptor: { fontFamily?: string; text?: string }): string {\r\n const family = descriptor.fontFamily;\r\n if (typeof family === \"string\" && family !== \"\") return family;\r\n const host = hostTextFamily();\r\n if (host !== \"\") return host;\r\n const text = descriptor.text ? ` drawing \"${descriptor.text.slice(0, 32)}\"` : \"\";\r\n throw new Error(\r\n `Text${text} has no fontFamily. Set one on the text itself, on an `\r\n + `enclosing <DefaultTextStyle>, or as the theme's \\`default\\` typography `\r\n + `preset — there is no fallback face.`,\r\n );\r\n}\r\n\r\nexport function withTextDescriptor(descriptor: Partial<TextState> & ShapeAlignmentInput): TextState {\r\n const width = descriptor.width ?? 0;\r\n const height = descriptor.height ?? 0;\r\n const { x, y, pivot } = resolveShapeAlignment(descriptor, width, height);\r\n return {\r\n ...stripShapeAlignmentKeys(descriptor),\r\n opacity: descriptor.opacity ?? 1,\r\n rotation: descriptor.rotation ?? 0,\r\n scale: descriptor.scale ?? 1,\r\n x,\r\n y,\r\n start: descriptor.start ?? 0,\r\n end: descriptor.end ?? 1,\r\n pivot: resolveShapePivot(pivot),\r\n text: descriptor.text ?? \"\",\r\n fontSize: descriptor.fontSize ?? 48,\r\n fontFamily: requireFontFamily(descriptor),\r\n fontWeight: descriptor.fontWeight ?? 400,\r\n fontStyle: descriptor.fontStyle ?? 'normal',\r\n letterSpacing: descriptor.letterSpacing ?? 0,\r\n lineHeight: descriptor.lineHeight ?? 0,\r\n textAlign: descriptor.textAlign ?? 'center',\r\n verticalAlign: descriptor.verticalAlign ?? 'center',\r\n textDecoration: descriptor.textDecoration ?? 'none',\r\n wrap: descriptor.wrap ?? false,\r\n minFontSize: descriptor.minFontSize ?? 12,\r\n width: descriptor.width ?? 0,\r\n height: descriptor.height ?? 0,\r\n segments: descriptor.segments,\r\n path: descriptor.path ?? null,\r\n };\r\n}\r\n"]}
1
+ {"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/render/descriptors/text.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FontStyle, TextAlign, TextDecoration, VerticalAlign } from \"@/attributes/text/types\";\r\nimport { FillResolved } from \"@/attributes/shape/fill/union\";\r\nimport { StrokeResolved } from \"@/attributes/shape/stroke/stroke\";\r\nimport { PathData } from \"./path\";\r\nimport { ShapeAlignmentInput, ShapeState, resolveShapeAlignment, resolveShapePivot, stripShapeAlignmentKeys } from \"./shape\";\r\nimport { hostTextFamily } from \"@/components/builtins/text/text-defaults\";\r\n\r\n/**\r\n * The size a segmented block's pieces shape at on an `'autofit'` node: the\r\n * size the layout probes with, since no single piece can be asked for the\r\n * size the block settles on.\r\n */\r\nexport const AUTOFIT_PROBE_SIZE = 100;\r\n\r\n/**\r\n * One contiguous piece of a Text node split at run boundaries. Pieces\r\n * carry their effective shaping inputs (`text` plus the five font fields) and\r\n * draw-time overrides applied per shaped run: `opacity` folded into the paint\r\n * alpha, an optional `fill`/`stroke` override (falls back to the node's when\r\n * omitted), and a transform applied about the run's centered position.\r\n *\r\n * Present only when a Text node has styled runs or a reveal window; otherwise\r\n * the node renders as a single string with no segments.\r\n *\r\n * **Every shaping field is stated, none inherited at draw time.** `fontFamily`,\r\n * `fontSize` and `fontStyle` joined `fontWeight` and `letterSpacing` here so a\r\n * run can change its *face* and not only its weight — which is\r\n * what an editor built on this needs to offer per-character styling at all. The\r\n * paragraph builder already takes all five per run (it is what `RichText` sets),\r\n * so the cost of the three is a wider segment and nothing else.\r\n *\r\n * They are optional only so an older caller's segments still lay out: absent\r\n * means \"the node's own\", resolved where the paragraph is built rather than\r\n * left for the renderer to guess.\r\n */\r\nexport interface TextSegment {\r\n text: string;\r\n /** Override family for this piece; falls back to the node's when undefined. */\r\n fontFamily?: string;\r\n /** Override size for this piece; falls back to the node's when undefined. */\r\n fontSize?: number;\r\n /** Override slant for this piece; falls back to the node's when undefined. */\r\n fontStyle?: FontStyle;\r\n fontWeight: number;\r\n letterSpacing: number;\r\n /** Override decoration for this piece; falls back to the node's when undefined. */\r\n textDecoration?: TextDecoration;\r\n opacity: number;\r\n x: number;\r\n y: number;\r\n scale: number;\r\n rotation: number;\r\n /** Override fill for this piece; falls back to the node's fill when undefined. */\r\n fill?: FillResolved[];\r\n /** Override stroke for this piece; falls back to the node's stroke when undefined. */\r\n stroke?: StrokeResolved[];\r\n}\r\n\r\n/**\r\n * Whether `segment` only *styles* its characters — no transform of its own.\r\n *\r\n * The caret model can describe a segmented block exactly as long as this holds\r\n * of every piece: differently-styled runs are still one paragraph, laid out and\r\n * measured together, so Skia's own rects for each character are where the glyphs\r\n * are. A piece that is *moved*, turned or scaled about its own centre is not in\r\n * that paragraph's space any more, and a slot measured from it would point at\r\n * where the character would have been. See `textBlockLayout`, which is the one\r\n * caller and turns a false here into \"no caret model for this shape\".\r\n */\r\nexport function isStyleOnlySegment(segment: TextSegment): boolean {\r\n return segment.x === 0 && segment.y === 0\r\n && segment.scale === 1 && segment.rotation === 0;\r\n}\r\n\r\nexport interface TextState extends ShapeState {\r\n text: string;\r\n /**\r\n * A named typography preset to shape against — `theme.typography`'s key, the\r\n * same one a `Text` node's `variant` prop selects.\r\n *\r\n * A node reads its variant once, at bind; a drawn op has no bind step, so it\r\n * is resolved at draw alongside the inherited defaults (see\r\n * `applyGraphicsTextDefaults`). It sits *between* the two: above the\r\n * enclosing `<DefaultTextStyle>`, below anything the op states itself.\r\n *\r\n * Optional, and unresolved names are ignored rather than an error — a scene\r\n * that renames a preset should lose the styling, not fail to draw.\r\n */\r\n variant?: string;\r\n fontSize: number | 'autofit';\r\n fontFamily: string;\r\n fontWeight: number;\r\n fontStyle: FontStyle;\r\n letterSpacing: number;\r\n lineHeight: number;\r\n textAlign: TextAlign;\r\n /** Where the block sits in a box taller or shorter than it; only a `height` gives it one. */\r\n verticalAlign: VerticalAlign;\r\n textDecoration: TextDecoration;\r\n wrap: boolean;\r\n minFontSize: number;\r\n width: number;\r\n height: number;\r\n /**\r\n * Per-piece overrides when the node has styled runs. When set,\r\n * the renderer shapes these pieces together (one paragraph) and paints each\r\n * shaped run with its piece's overrides instead of the node's single fill.\r\n */\r\n segments?: TextSegment[];\r\n /**\r\n * When set, the text is wrapped around this path (text-on-path) instead of\r\n * laid out as straight lines: each glyph is positioned and rotated to follow\r\n * the path, centered on its baseline, and glyphs past the path end are\r\n * clipped. Mutually exclusive with `segments` in v1.\r\n */\r\n path?: PathData | null;\r\n}\r\n\r\n\r\n/**\r\n * The family this text is set in — the last rung of the cascade, and the only\r\n * one that can refuse.\r\n *\r\n * It used to fall back to `\"Arial\"`, which is the wrong shape of answer for a\r\n * renderer whose whole job is that the picture is the one that was asked for:\r\n * substituting a face the *engine* picked produces text in a typeface the author\r\n * never chose, at metrics they never measured, in a frame that looks finished,\r\n * and hides a font that was never declared and so never loaded.\r\n *\r\n * What it falls back to instead is {@link hostTextFamily} — a face the\r\n * **application** named, once, at its composition root, out of the fonts it\r\n * actually vendors. That is a different bargain: a host that ships a typeface\r\n * registers it in every manifest, so a chart axis that nobody styled comes out\r\n * in it and paints glyphs, while the engine still refuses to invent a face of\r\n * its own. A host that declares nothing gets the error below, which is the right\r\n * answer for a headless render whose fonts all come from a manifest.\r\n *\r\n * By the time an op reaches here the whole ladder above has been walked — the op\r\n * or prop itself, a `variant` preset, the enclosing `<DefaultTextStyle>`, then\r\n * the theme's `default` typography preset — so this is only ever reached when\r\n * every one of them was silent. The message names them because \"no font family\"\r\n * is not actionable and \"set one on the text, on a DefaultTextStyle, or as the\r\n * theme's default preset\" is.\r\n *\r\n * Exported so the **measure** path enforces the same policy from the same\r\n * definition. Shaping a paragraph to measure it happens before any op is\r\n * validated, and Skia reads `.length` off every family name — so text with no\r\n * family used to die inside the wasm with `Cannot read properties of undefined`,\r\n * naming no scene, node or prop, while the identical case at draw time produced\r\n * the message above. One policy, two verdicts, and the useless one came first.\r\n */\r\nexport function requireFontFamily(descriptor: { fontFamily?: string; text?: string }): string {\r\n const family = descriptor.fontFamily;\r\n if (typeof family === \"string\" && family !== \"\") return family;\r\n const host = hostTextFamily();\r\n if (host !== \"\") return host;\r\n const text = descriptor.text ? ` drawing \"${descriptor.text.slice(0, 32)}\"` : \"\";\r\n throw new Error(\r\n `Text${text} has no fontFamily. Set one on the text itself, on an `\r\n + `enclosing <DefaultTextStyle>, or as the theme's \\`default\\` typography `\r\n + `preset — there is no fallback face.`,\r\n );\r\n}\r\n\r\nexport function withTextDescriptor(descriptor: Partial<TextState> & ShapeAlignmentInput): TextState {\r\n const width = descriptor.width ?? 0;\r\n const height = descriptor.height ?? 0;\r\n const { x, y, pivot } = resolveShapeAlignment(descriptor, width, height);\r\n return {\r\n ...stripShapeAlignmentKeys(descriptor),\r\n opacity: descriptor.opacity ?? 1,\r\n rotation: descriptor.rotation ?? 0,\r\n scale: descriptor.scale ?? 1,\r\n x,\r\n y,\r\n start: descriptor.start ?? 0,\r\n end: descriptor.end ?? 1,\r\n pivot: resolveShapePivot(pivot),\r\n text: descriptor.text ?? \"\",\r\n fontSize: descriptor.fontSize ?? 48,\r\n fontFamily: requireFontFamily(descriptor),\r\n fontWeight: descriptor.fontWeight ?? 400,\r\n fontStyle: descriptor.fontStyle ?? 'normal',\r\n letterSpacing: descriptor.letterSpacing ?? 0,\r\n lineHeight: descriptor.lineHeight ?? 0,\r\n textAlign: descriptor.textAlign ?? 'center',\r\n verticalAlign: descriptor.verticalAlign ?? 'center',\r\n textDecoration: descriptor.textDecoration ?? 'none',\r\n wrap: descriptor.wrap ?? false,\r\n minFontSize: descriptor.minFontSize ?? 12,\r\n width: descriptor.width ?? 0,\r\n height: descriptor.height ?? 0,\r\n segments: descriptor.segments,\r\n path: descriptor.path ?? null,\r\n };\r\n}\r\n"]}
@@ -167,7 +167,7 @@ export interface RenderContext2D extends MeasureContext2D {
167
167
  * Returns `null` when the backend cannot measure this — the default, so a
168
168
  * backend that never needed glyph positions keeps working, and for cases no
169
169
  * caret model fits: text-on-path (glyphs follow a curve, not a line box) and
170
- * a block with active selection segments.
170
+ * a block drawn in styled segments.
171
171
  */
172
172
  layoutTextBlock(state: Partial<TextState>): TextBlockLayout | null;
173
173
  /**
@@ -259,7 +259,7 @@ export interface RenderContext2D extends MeasureContext2D {
259
259
  * True for anything that actually paints, since a fill with `space:'parent'`
260
260
  * resolves against them. A context that only inspects *what* would be drawn
261
261
  * never looks at them, and computing them costs an object allocation per node
262
- * per frame. Nodes check this before doing that work; see `Node2D.beforeRender`.
262
+ * per frame. Nodes check this before doing that work; see `Node2D.renderState`.
263
263
  */
264
264
  readonly readsSpaceRects: boolean;
265
265
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"render-context2d.js","sourceRoot":"","sources":["../../src/render/render-context2d.ts"],"names":[],"mappings":"","sourcesContent":["import type { FontStyle, TextStyle } from \"@/attributes/text/types\";\r\nimport type { TransformState } from \"./descriptors/transform\";\r\nimport type { MeasureContext2D } from \"./measure-context\";\r\nimport type { TextState } from \"./descriptors/text\";\r\nimport type { TextBlockLayout } from \"./text-layout\";\r\nimport type { Graphics2D } from \"./graphics2d\";\r\nimport type { Clip } from \"./clip\";\r\nimport type { Vector2 } from \"@/attributes/layout/vector2\";\r\nimport type { MaskOptions } from \"@/attributes/mask/mask\";\r\nimport type { BooleanOperation } from \"@/attributes/mask/boolean\";\r\nimport type { NodeEffect } from \"@/attributes/shape/effects/union\";\r\nimport type { Size2D } from \"@/attributes/layout/size\";\r\n\r\n/**\r\n * Where an effect scope draws: `'foreground'` warps/filters the node's *own*\r\n * content (its fill, stroke and children), `'backdrop'` warps/filters the canvas\r\n * content already painted *beneath* the node (clipped to its silhouette). See\r\n * {@link RenderContext2D.beginEffects}.\r\n */\r\nexport type EffectTarget = \"foreground\" | \"backdrop\";\r\n\r\n/**\r\n * Pixels produced by {@link RenderContext2D.rasterize}: RGBA8888,\r\n * unpremultiplied, top-down (canvas row order). `width`/`height` are **device**\r\n * px, so they reflect the pixel ratio the renderer actually used rather than the\r\n * logical size that was asked for.\r\n */\r\nexport interface RasterizedSurface {\r\n pixels: Uint8Array;\r\n width: number;\r\n height: number;\r\n}\r\n\r\n/**\r\n * A bounding box in the current node's local space (origin = the node's\r\n * layout-cell centre, the same space shapes are drawn in). `left/top` use the\r\n * canvas convention (y down).\r\n */\r\nexport interface SpaceRect {\r\n left: number;\r\n top: number;\r\n right: number;\r\n bottom: number;\r\n}\r\n\r\n/**\r\n * Reference rects a fill can resolve against, supplied per-node at `begin()`.\r\n * `local` is derived from the drawn shapes themselves and `global` (the\r\n * viewport) is computed by the renderer from the surface size, so only the\r\n * parent frame is passed here.\r\n */\r\nexport interface SpaceRects {\r\n /** The parent node's content rect, in this node's local space. */\r\n parent?: SpaceRect;\r\n}\r\n\r\n/**\r\n * Per-node state supplied to {@link RenderContext2D.begin} for the duration of a\r\n * node's draw scope. Carries the node identity and gradient-space `rects` plus\r\n * the node's per-frame motion, sampled at render time. Motion-driven effects\r\n * (e.g. motion blur) read the current node's `velocity` from this state instead\r\n * of being authored with a fixed direction.\r\n *\r\n * Velocity fields are `0`/`{0,0}` when the motion is unknown — the first frame a\r\n * node renders, or after a time discontinuity (scrub/seek) where no trustworthy\r\n * delta exists.\r\n */\r\nexport interface NodeRenderState {\r\n /** Stable node identifier. */\r\n id: string;\r\n /** Parent / viewport rects in this node's local space. */\r\n rects: SpaceRects;\r\n /** How long this node has existed, in seconds (`NodeTime.elapsed`). */\r\n elapsed: number;\r\n /** The frame delta, in seconds, used to derive displacement from velocity. */\r\n dt: number;\r\n /** Translational velocity in px/sec, world space (y-down). `{0,0}` when unknown. */\r\n velocity: Vector2;\r\n /** Heading of `velocity` in degrees (`atan2(vy, vx)`). `0` when unknown. */\r\n direction: number;\r\n /** Magnitude of `velocity` in px/sec. `0` when unknown. */\r\n speed: number;\r\n /** Rotational velocity in degrees/sec. `0` when unknown. Reserved for radial motion blur. */\r\n angularVelocity: number;\r\n /** Scale velocity in scale-units/sec. `0` when unknown. Reserved for zoom motion blur. */\r\n scaleVelocity: number;\r\n}\r\n\r\n/**\r\n * The drawing surface a `Node2D` paints into — **the whole of what a node may\r\n * ask of a renderer, and nothing else.**\r\n *\r\n * Shapes are never declared directly on the context: they are built with a\r\n * {@link Graphics2D} command list and submitted via {@link draw}. Multiple\r\n * shapes chained on one `Graphics2D` before a paint call are combined into a\r\n * single surface and painted together:\r\n *\r\n * ctx.draw(new Graphics2D().ellipse(...).rect(...).fill(...)); // shared surface\r\n *\r\n * On top of that it carries text measurement — it extends {@link MeasureContext2D}, so\r\n * a node measures and draws through one object — and the higher-level scoping\r\n * operations: transforms, masks, clips, camera, boolean ops, effect scopes.\r\n * `begin(state)` / `end()` bracket each node's draw call so the context can\r\n * track which node is active.\r\n *\r\n * **An interface, with `CanvasRenderContext2D` as its one base class.** What a\r\n * node calls and what a *host* calls are different lists: `execute`,\r\n * `screenshot`, `unmount` and `dispose` drive a render pass and have no business\r\n * being reachable from inside one. Splitting them is what keeps this surface\r\n * the size it is. Every real backend still extends the class, which preserves\r\n * the `draw` to `drawGraphics` invariant that gives them all one implementation\r\n * of text-default resolution.\r\n *\r\n * `RenderContext3D` is its sibling, not its subclass: the two share no members,\r\n * because a 3D scene is described with lights, a camera and meshes rather than\r\n * with paths and paint.\r\n */\r\nexport interface RenderContext2D extends MeasureContext2D {\r\n measureText(\r\n text: string,\r\n fontSize: number,\r\n fontFamily: string,\r\n fontWeight?: number,\r\n letterSpacing?: number,\r\n fontStyle?: FontStyle,\r\n ): Size2D;\r\n\r\n // ---- Inherited text-style defaults ------------------------------------\r\n // `<DefaultTextStyle>` reaches a `Text`/`RichText` node through the context\r\n // map, applied once when the node binds. A raw `Graphics2D` has no node to\r\n // bind, so it inherits the same defaults here instead — pushed around a\r\n // subtree's draw scope, and folded into each `text`/`richText` op by\r\n // `draw()`. Same vocabulary (`TextStyle`), same precedence, two channels.\r\n\r\n /**\r\n * Set text-style defaults for everything drawn until the matching\r\n * {@link popTextStyle} — the drawn-graphics half of `<DefaultTextStyle>`.\r\n *\r\n * `style` is **merged** onto the defaults already in effect, per key, so\r\n * nesting accumulates the way the node channel does: an outer scope's\r\n * `fontFamily` and an inner scope's `fontSize` both apply, and a key set by\r\n * both takes the inner value. Values are resolved (a tweened `fontSize`\r\n * arrives as this frame's number), not callbacks.\r\n *\r\n * Pass `null` to open a scope that inherits **nothing** — not the enclosing\r\n * defaults and not the project's `theme.typography.default`. That is for a\r\n * node whose text is its own vocabulary rather than the document's: `Code`\r\n * does it so a scene-wide serif face doesn't reflow a monospaced code block.\r\n *\r\n * Always pair with `popTextStyle()` in a `finally`; the stack is shared with\r\n * every sibling drawn afterwards.\r\n */\r\n pushTextStyle(style: TextStyle | null): void;\r\n\r\n /** Close the innermost scope opened by {@link pushTextStyle}. */\r\n popTextStyle(): void;\r\n\r\n /**\r\n * The text-style defaults in effect right now: the innermost\r\n * {@link pushTextStyle} scope, or the project's `theme.typography.default`\r\n * when no scope is open — the same preset a `Text` node falls back to, so a\r\n * drawn label and a node label agree on the project's base typography.\r\n */\r\n readonly defaultTextStyle: TextStyle;\r\n\r\n /**\r\n * Replay a built `Graphics2D` against this context.\r\n *\r\n * Resolves the ambient text defaults onto the op list before handing it to\r\n * the backend, which is what keeps the real renderer and the precomp asset\r\n * walk agreeing on which font an under-specified `text` op shapes with: a\r\n * family that one resolves and the other does not is a font that never loads\r\n * and glyphs that never paint.\r\n */\r\n draw(graphics: Graphics2D): void;\r\n\r\n /**\r\n * Lay `state` out the way it would be drawn and report where every character\r\n * landed — see {@link TextBlockLayout} for the space and the caret model.\r\n *\r\n * This is what makes on-canvas text editing possible: glyph positions live\r\n * in the backend's shaper, so a host drawing its own caret and selection has\r\n * no way to compute them, and anything it approximates in the DOM disagrees\r\n * with the render as soon as the font, the line height or the wrapping does.\r\n *\r\n * Takes the whole {@link TextState} rather than a handful of font fields\r\n * because the resolution a caret has to agree with lives in the backend:\r\n * `'autofit'` picks a size from the box, `wrap` turns the width into a wrap\r\n * limit, and `textAlign` places the lines within it. Handing over the same\r\n * descriptor that gets drawn is what keeps the two from drifting apart.\r\n *\r\n * Returns `null` when the backend cannot measure this — the default, so a\r\n * backend that never needed glyph positions keeps working, and for cases no\r\n * caret model fits: text-on-path (glyphs follow a curve, not a line box) and\r\n * a block with active selection segments.\r\n */\r\n layoutTextBlock(state: Partial<TextState>): TextBlockLayout | null;\r\n\r\n /**\r\n * Push a transform (position, rotation, scale, opacity, …) and return the\r\n * context so subsequent draw calls are issued in the transformed space. The\r\n * transform is popped when `end()` is called for the node that pushed it.\r\n */\r\n transform(state: Partial<TransformState>): RenderContext2D;\r\n\r\n /**\r\n * Open a boolean-path collection scope. Shapes drawn until `endBoolean()`\r\n * are gathered (fills/strokes suppressed) and combined with `op`. After\r\n * `endBoolean()` the merged path is left as the active surface, so a\r\n * paint-only `Graphics2D` (`new Graphics2D().fill(...).stroke(...)`)\r\n * submitted via `draw()` styles the combined result.\r\n */\r\n beginBoolean(op: BooleanOperation): void;\r\n endBoolean(): void;\r\n\r\n // Mask scope (imperative) — used by MaskGroup and other node-level callers\r\n // that manage the scope with explicit begin/apply/end:\r\n //\r\n // beginMask({ mode, inverted })\r\n // <render mask child> // child draws its own Graphics2D\r\n // applyMask()\r\n // <render content children> // children draw their own Graphics2D\r\n // endMask()\r\n //\r\n // The chain-friendly form lives on `Graphics2D` (`.mask().applyMask().endMask()`)\r\n // for inline use within a single `draw()`.\r\n //\r\n // For `vector` mode the mask child's path is collected and used as a\r\n // clipPath; fills/strokes are suppressed. For `alpha` and `luminance`\r\n // the mask is rendered into an offscreen layer and combined with content\r\n // via blend modes.\r\n beginMask(options?: MaskOptions): void;\r\n applyMask(): void;\r\n endMask(): void;\r\n\r\n /**\r\n * Push a clip region built from a {@link Clip} command list. The clip's\r\n * shapes are unioned (with `cut()`s subtracted) into a single path and\r\n * intersected with the active clip, so children are confined to that\r\n * compound outline — any silhouette, not just a rect or ellipse. Used both\r\n * for a node's `clip` boundary and to confine backdrop effects (blur,\r\n * magnify) to the node's exact shape. Paired with `endClip()`.\r\n */\r\n beginClip(clip: Clip): void;\r\n /** Pop the most-recently pushed clip region. */\r\n endClip(): void;\r\n\r\n /**\r\n * Open an effect scope over the node, applying `effects` to either the node's\r\n * own content or the content beneath it. Paired with {@link endEffects}.\r\n *\r\n * `target`:\r\n * - `'foreground'` — warps/filters the node's *own* drawing (its fill, stroke\r\n * and children captured between begin/end), like blur. Used for bulge and\r\n * foreground posterize.\r\n * - `'backdrop'` — warps/filters the canvas content already painted *beneath*\r\n * the node, clipped to the active silhouette clip, so the node's own edges\r\n * stay sharp (Figma-style). Used for backdrop-flagged filters (blur,\r\n * grayscale, pixelate, …), magnify, backdrop posterize, and backdrop SkSL.\r\n *\r\n * The renderer decides per effect whether to compose it as an `ImageFilter`\r\n * or run it as a snapshot/redraw shader — callers never route by effect type.\r\n * `width`/`height` are the node's logical size, for size-relative effects\r\n * (e.g. pixelate) and shader lens boxes.\r\n */\r\n beginEffects(effects: NodeEffect[], target: EffectTarget, width: number, height: number): void;\r\n endEffects(): void;\r\n\r\n /**\r\n * Draw `draw` into an offscreen buffer instead of onto the canvas, and hand\r\n * back its pixels. The buffer is `width` × `height` **logical** px with its\r\n * origin at the centre, matching the space a node draws in — so `draw` can be\r\n * an ordinary `render()` call on a node subtree and needs no special casing.\r\n *\r\n * This is what backs `Tex.surface`: `Canvas3D` rasterizes each of its 2D\r\n * sources through here, then hands the pixels to the 3D backend as a texture.\r\n * It runs *inside* the frame that consumes it, so a scrubbed frame is\r\n * identical to a played one.\r\n *\r\n * Returns `null` when the backend cannot rasterize offscreen — the material\r\n * then renders without that map. `pixelRatio` is a ceiling on the buffer's\r\n * device-pixel scale, not a guarantee; the renderer may clamp it.\r\n */\r\n rasterize(\r\n width: number,\r\n height: number,\r\n draw: () => void,\r\n pixelRatio?: number,\r\n ): RasterizedSurface | null;\r\n\r\n /**\r\n * Push a camera viewport. Clips to `viewport` (canvas-space, centred\r\n * coords) and applies the inverse camera transform so children render as\r\n * seen through the lens. `heading` rotates the world counter to the camera\r\n * angle. Paired with `endCamera()`.\r\n *\r\n * @param viewport Bounding rect of the camera node in canvas space.\r\n * @param lookAt World-space point the camera looks at.\r\n * @param zoom Uniform scale applied around `lookAt`.\r\n * @param heading Camera rotation in degrees.\r\n */\r\n beginCamera(viewport: { x: number; y: number; width: number; height: number }, lookAt: Vector2, zoom: number, heading: number): void;\r\n endCamera(): void;\r\n\r\n /**\r\n * Whether this context ever reads `NodeRenderState.rects`.\r\n *\r\n * True for anything that actually paints, since a fill with `space:'parent'`\r\n * resolves against them. A context that only inspects *what* would be drawn\r\n * never looks at them, and computing them costs an object allocation per node\r\n * per frame. Nodes check this before doing that work; see `Node2D.beforeRender`.\r\n */\r\n readonly readsSpaceRects: boolean;\r\n\r\n /**\r\n * Whether this context only cares about *visible* output.\r\n *\r\n * True for anything that paints: a subtree at zero opacity contributes no\r\n * pixels, so walking it produces draw calls the rasterizer will discard.\r\n *\r\n * A context that inspects rather than paints sets this `false`, and that is\r\n * the whole reason this is a capability rather than an unconditional check:\r\n * such a walk exists to discover which images, videos, fonts and effects a\r\n * frame *references* — regardless of whether they can be seen. An invisible\r\n * node's font still has to load, because it may fade in two frames later and\r\n * glyphs that were never registered never paint. Skipping it there is not an\r\n * optimisation, it is a missing asset.\r\n *\r\n * Same shape and same reasoning as {@link readsSpaceRects}: the context\r\n * declares what it needs, and nodes check before doing work that would be\r\n * thrown away. See `Node2D.render`.\r\n */\r\n readonly drawsVisibleOnly: boolean;\r\n\r\n}\r\n\r\n/**\r\n * A render *pass*: a {@link RenderContext2D} plus the per-node scope bracket the\r\n * walk opens around each node.\r\n *\r\n * Split off from the drawing surface because the two have different callers.\r\n * `begin`/`end` are `Node2D.render`'s, once per node, and they push onto a stack\r\n * every fill with `space:'parent'` and every motion-driven effect reads back\r\n * from. A custom node's `renderSelf` calling one would open a scope nothing\r\n * closes — and since `renderSelf` is handed a {@link RenderContext2D}, it now\r\n * cannot.\r\n *\r\n * Every backend implements this; a host driving a render pass holds one.\r\n *\r\n * @internal\r\n */\r\nexport interface RenderPass2D extends RenderContext2D {\r\n /**\r\n * Open a node draw scope. Must be paired with `end()`, also when the scope\r\n * throws. Pushes the node's id and {@link NodeRenderState} (gradient-space\r\n * rects + per-frame motion) for the duration of the scope.\r\n */\r\n begin(state: NodeRenderState): void;\r\n\r\n /** Close the innermost node draw scope opened by `begin()`. */\r\n end(): void;\r\n}\r\n"]}
1
+ {"version":3,"file":"render-context2d.js","sourceRoot":"","sources":["../../src/render/render-context2d.ts"],"names":[],"mappings":"","sourcesContent":["import type { FontStyle, TextStyle } from \"@/attributes/text/types\";\r\nimport type { TransformState } from \"./descriptors/transform\";\r\nimport type { MeasureContext2D } from \"./measure-context\";\r\nimport type { TextState } from \"./descriptors/text\";\r\nimport type { TextBlockLayout } from \"./text-layout\";\r\nimport type { Graphics2D } from \"./graphics2d\";\r\nimport type { Clip } from \"./clip\";\r\nimport type { Vector2 } from \"@/attributes/layout/vector2\";\r\nimport type { MaskOptions } from \"@/attributes/mask/mask\";\r\nimport type { BooleanOperation } from \"@/attributes/mask/boolean\";\r\nimport type { NodeEffect } from \"@/attributes/shape/effects/union\";\r\nimport type { Size2D } from \"@/attributes/layout/size\";\r\n\r\n/**\r\n * Where an effect scope draws: `'foreground'` warps/filters the node's *own*\r\n * content (its fill, stroke and children), `'backdrop'` warps/filters the canvas\r\n * content already painted *beneath* the node (clipped to its silhouette). See\r\n * {@link RenderContext2D.beginEffects}.\r\n */\r\nexport type EffectTarget = \"foreground\" | \"backdrop\";\r\n\r\n/**\r\n * Pixels produced by {@link RenderContext2D.rasterize}: RGBA8888,\r\n * unpremultiplied, top-down (canvas row order). `width`/`height` are **device**\r\n * px, so they reflect the pixel ratio the renderer actually used rather than the\r\n * logical size that was asked for.\r\n */\r\nexport interface RasterizedSurface {\r\n pixels: Uint8Array;\r\n width: number;\r\n height: number;\r\n}\r\n\r\n/**\r\n * A bounding box in the current node's local space (origin = the node's\r\n * layout-cell centre, the same space shapes are drawn in). `left/top` use the\r\n * canvas convention (y down).\r\n */\r\nexport interface SpaceRect {\r\n left: number;\r\n top: number;\r\n right: number;\r\n bottom: number;\r\n}\r\n\r\n/**\r\n * Reference rects a fill can resolve against, supplied per-node at `begin()`.\r\n * `local` is derived from the drawn shapes themselves and `global` (the\r\n * viewport) is computed by the renderer from the surface size, so only the\r\n * parent frame is passed here.\r\n */\r\nexport interface SpaceRects {\r\n /** The parent node's content rect, in this node's local space. */\r\n parent?: SpaceRect;\r\n}\r\n\r\n/**\r\n * Per-node state supplied to {@link RenderContext2D.begin} for the duration of a\r\n * node's draw scope. Carries the node identity and gradient-space `rects` plus\r\n * the node's per-frame motion, sampled at render time. Motion-driven effects\r\n * (e.g. motion blur) read the current node's `velocity` from this state instead\r\n * of being authored with a fixed direction.\r\n *\r\n * Velocity fields are `0`/`{0,0}` when the motion is unknown — the first frame a\r\n * node renders, or after a time discontinuity (scrub/seek) where no trustworthy\r\n * delta exists.\r\n */\r\nexport interface NodeRenderState {\r\n /** Stable node identifier. */\r\n id: string;\r\n /** Parent / viewport rects in this node's local space. */\r\n rects: SpaceRects;\r\n /** How long this node has existed, in seconds (`NodeTime.elapsed`). */\r\n elapsed: number;\r\n /** The frame delta, in seconds, used to derive displacement from velocity. */\r\n dt: number;\r\n /** Translational velocity in px/sec, world space (y-down). `{0,0}` when unknown. */\r\n velocity: Vector2;\r\n /** Heading of `velocity` in degrees (`atan2(vy, vx)`). `0` when unknown. */\r\n direction: number;\r\n /** Magnitude of `velocity` in px/sec. `0` when unknown. */\r\n speed: number;\r\n /** Rotational velocity in degrees/sec. `0` when unknown. Reserved for radial motion blur. */\r\n angularVelocity: number;\r\n /** Scale velocity in scale-units/sec. `0` when unknown. Reserved for zoom motion blur. */\r\n scaleVelocity: number;\r\n}\r\n\r\n/**\r\n * The drawing surface a `Node2D` paints into — **the whole of what a node may\r\n * ask of a renderer, and nothing else.**\r\n *\r\n * Shapes are never declared directly on the context: they are built with a\r\n * {@link Graphics2D} command list and submitted via {@link draw}. Multiple\r\n * shapes chained on one `Graphics2D` before a paint call are combined into a\r\n * single surface and painted together:\r\n *\r\n * ctx.draw(new Graphics2D().ellipse(...).rect(...).fill(...)); // shared surface\r\n *\r\n * On top of that it carries text measurement — it extends {@link MeasureContext2D}, so\r\n * a node measures and draws through one object — and the higher-level scoping\r\n * operations: transforms, masks, clips, camera, boolean ops, effect scopes.\r\n * `begin(state)` / `end()` bracket each node's draw call so the context can\r\n * track which node is active.\r\n *\r\n * **An interface, with `CanvasRenderContext2D` as its one base class.** What a\r\n * node calls and what a *host* calls are different lists: `execute`,\r\n * `screenshot`, `unmount` and `dispose` drive a render pass and have no business\r\n * being reachable from inside one. Splitting them is what keeps this surface\r\n * the size it is. Every real backend still extends the class, which preserves\r\n * the `draw` to `drawGraphics` invariant that gives them all one implementation\r\n * of text-default resolution.\r\n *\r\n * `RenderContext3D` is its sibling, not its subclass: the two share no members,\r\n * because a 3D scene is described with lights, a camera and meshes rather than\r\n * with paths and paint.\r\n */\r\nexport interface RenderContext2D extends MeasureContext2D {\r\n measureText(\r\n text: string,\r\n fontSize: number,\r\n fontFamily: string,\r\n fontWeight?: number,\r\n letterSpacing?: number,\r\n fontStyle?: FontStyle,\r\n ): Size2D;\r\n\r\n // ---- Inherited text-style defaults ------------------------------------\r\n // `<DefaultTextStyle>` reaches a `Text`/`RichText` node through the context\r\n // map, applied once when the node binds. A raw `Graphics2D` has no node to\r\n // bind, so it inherits the same defaults here instead — pushed around a\r\n // subtree's draw scope, and folded into each `text`/`richText` op by\r\n // `draw()`. Same vocabulary (`TextStyle`), same precedence, two channels.\r\n\r\n /**\r\n * Set text-style defaults for everything drawn until the matching\r\n * {@link popTextStyle} — the drawn-graphics half of `<DefaultTextStyle>`.\r\n *\r\n * `style` is **merged** onto the defaults already in effect, per key, so\r\n * nesting accumulates the way the node channel does: an outer scope's\r\n * `fontFamily` and an inner scope's `fontSize` both apply, and a key set by\r\n * both takes the inner value. Values are resolved (a tweened `fontSize`\r\n * arrives as this frame's number), not callbacks.\r\n *\r\n * Pass `null` to open a scope that inherits **nothing** — not the enclosing\r\n * defaults and not the project's `theme.typography.default`. That is for a\r\n * node whose text is its own vocabulary rather than the document's: `Code`\r\n * does it so a scene-wide serif face doesn't reflow a monospaced code block.\r\n *\r\n * Always pair with `popTextStyle()` in a `finally`; the stack is shared with\r\n * every sibling drawn afterwards.\r\n */\r\n pushTextStyle(style: TextStyle | null): void;\r\n\r\n /** Close the innermost scope opened by {@link pushTextStyle}. */\r\n popTextStyle(): void;\r\n\r\n /**\r\n * The text-style defaults in effect right now: the innermost\r\n * {@link pushTextStyle} scope, or the project's `theme.typography.default`\r\n * when no scope is open — the same preset a `Text` node falls back to, so a\r\n * drawn label and a node label agree on the project's base typography.\r\n */\r\n readonly defaultTextStyle: TextStyle;\r\n\r\n /**\r\n * Replay a built `Graphics2D` against this context.\r\n *\r\n * Resolves the ambient text defaults onto the op list before handing it to\r\n * the backend, which is what keeps the real renderer and the precomp asset\r\n * walk agreeing on which font an under-specified `text` op shapes with: a\r\n * family that one resolves and the other does not is a font that never loads\r\n * and glyphs that never paint.\r\n */\r\n draw(graphics: Graphics2D): void;\r\n\r\n /**\r\n * Lay `state` out the way it would be drawn and report where every character\r\n * landed — see {@link TextBlockLayout} for the space and the caret model.\r\n *\r\n * This is what makes on-canvas text editing possible: glyph positions live\r\n * in the backend's shaper, so a host drawing its own caret and selection has\r\n * no way to compute them, and anything it approximates in the DOM disagrees\r\n * with the render as soon as the font, the line height or the wrapping does.\r\n *\r\n * Takes the whole {@link TextState} rather than a handful of font fields\r\n * because the resolution a caret has to agree with lives in the backend:\r\n * `'autofit'` picks a size from the box, `wrap` turns the width into a wrap\r\n * limit, and `textAlign` places the lines within it. Handing over the same\r\n * descriptor that gets drawn is what keeps the two from drifting apart.\r\n *\r\n * Returns `null` when the backend cannot measure this — the default, so a\r\n * backend that never needed glyph positions keeps working, and for cases no\r\n * caret model fits: text-on-path (glyphs follow a curve, not a line box) and\r\n * a block drawn in styled segments.\r\n */\r\n layoutTextBlock(state: Partial<TextState>): TextBlockLayout | null;\r\n\r\n /**\r\n * Push a transform (position, rotation, scale, opacity, …) and return the\r\n * context so subsequent draw calls are issued in the transformed space. The\r\n * transform is popped when `end()` is called for the node that pushed it.\r\n */\r\n transform(state: Partial<TransformState>): RenderContext2D;\r\n\r\n /**\r\n * Open a boolean-path collection scope. Shapes drawn until `endBoolean()`\r\n * are gathered (fills/strokes suppressed) and combined with `op`. After\r\n * `endBoolean()` the merged path is left as the active surface, so a\r\n * paint-only `Graphics2D` (`new Graphics2D().fill(...).stroke(...)`)\r\n * submitted via `draw()` styles the combined result.\r\n */\r\n beginBoolean(op: BooleanOperation): void;\r\n endBoolean(): void;\r\n\r\n // Mask scope (imperative) — used by MaskGroup and other node-level callers\r\n // that manage the scope with explicit begin/apply/end:\r\n //\r\n // beginMask({ mode, inverted })\r\n // <render mask child> // child draws its own Graphics2D\r\n // applyMask()\r\n // <render content children> // children draw their own Graphics2D\r\n // endMask()\r\n //\r\n // The chain-friendly form lives on `Graphics2D` (`.mask().applyMask().endMask()`)\r\n // for inline use within a single `draw()`.\r\n //\r\n // For `vector` mode the mask child's path is collected and used as a\r\n // clipPath; fills/strokes are suppressed. For `alpha` and `luminance`\r\n // the mask is rendered into an offscreen layer and combined with content\r\n // via blend modes.\r\n beginMask(options?: MaskOptions): void;\r\n applyMask(): void;\r\n endMask(): void;\r\n\r\n /**\r\n * Push a clip region built from a {@link Clip} command list. The clip's\r\n * shapes are unioned (with `cut()`s subtracted) into a single path and\r\n * intersected with the active clip, so children are confined to that\r\n * compound outline — any silhouette, not just a rect or ellipse. Used both\r\n * for a node's `clip` boundary and to confine backdrop effects (blur,\r\n * magnify) to the node's exact shape. Paired with `endClip()`.\r\n */\r\n beginClip(clip: Clip): void;\r\n /** Pop the most-recently pushed clip region. */\r\n endClip(): void;\r\n\r\n /**\r\n * Open an effect scope over the node, applying `effects` to either the node's\r\n * own content or the content beneath it. Paired with {@link endEffects}.\r\n *\r\n * `target`:\r\n * - `'foreground'` — warps/filters the node's *own* drawing (its fill, stroke\r\n * and children captured between begin/end), like blur. Used for bulge and\r\n * foreground posterize.\r\n * - `'backdrop'` — warps/filters the canvas content already painted *beneath*\r\n * the node, clipped to the active silhouette clip, so the node's own edges\r\n * stay sharp (Figma-style). Used for backdrop-flagged filters (blur,\r\n * grayscale, pixelate, …), magnify, backdrop posterize, and backdrop SkSL.\r\n *\r\n * The renderer decides per effect whether to compose it as an `ImageFilter`\r\n * or run it as a snapshot/redraw shader — callers never route by effect type.\r\n * `width`/`height` are the node's logical size, for size-relative effects\r\n * (e.g. pixelate) and shader lens boxes.\r\n */\r\n beginEffects(effects: NodeEffect[], target: EffectTarget, width: number, height: number): void;\r\n endEffects(): void;\r\n\r\n /**\r\n * Draw `draw` into an offscreen buffer instead of onto the canvas, and hand\r\n * back its pixels. The buffer is `width` × `height` **logical** px with its\r\n * origin at the centre, matching the space a node draws in — so `draw` can be\r\n * an ordinary `render()` call on a node subtree and needs no special casing.\r\n *\r\n * This is what backs `Tex.surface`: `Canvas3D` rasterizes each of its 2D\r\n * sources through here, then hands the pixels to the 3D backend as a texture.\r\n * It runs *inside* the frame that consumes it, so a scrubbed frame is\r\n * identical to a played one.\r\n *\r\n * Returns `null` when the backend cannot rasterize offscreen — the material\r\n * then renders without that map. `pixelRatio` is a ceiling on the buffer's\r\n * device-pixel scale, not a guarantee; the renderer may clamp it.\r\n */\r\n rasterize(\r\n width: number,\r\n height: number,\r\n draw: () => void,\r\n pixelRatio?: number,\r\n ): RasterizedSurface | null;\r\n\r\n /**\r\n * Push a camera viewport. Clips to `viewport` (canvas-space, centred\r\n * coords) and applies the inverse camera transform so children render as\r\n * seen through the lens. `heading` rotates the world counter to the camera\r\n * angle. Paired with `endCamera()`.\r\n *\r\n * @param viewport Bounding rect of the camera node in canvas space.\r\n * @param lookAt World-space point the camera looks at.\r\n * @param zoom Uniform scale applied around `lookAt`.\r\n * @param heading Camera rotation in degrees.\r\n */\r\n beginCamera(viewport: { x: number; y: number; width: number; height: number }, lookAt: Vector2, zoom: number, heading: number): void;\r\n endCamera(): void;\r\n\r\n /**\r\n * Whether this context ever reads `NodeRenderState.rects`.\r\n *\r\n * True for anything that actually paints, since a fill with `space:'parent'`\r\n * resolves against them. A context that only inspects *what* would be drawn\r\n * never looks at them, and computing them costs an object allocation per node\r\n * per frame. Nodes check this before doing that work; see `Node2D.renderState`.\r\n */\r\n readonly readsSpaceRects: boolean;\r\n\r\n /**\r\n * Whether this context only cares about *visible* output.\r\n *\r\n * True for anything that paints: a subtree at zero opacity contributes no\r\n * pixels, so walking it produces draw calls the rasterizer will discard.\r\n *\r\n * A context that inspects rather than paints sets this `false`, and that is\r\n * the whole reason this is a capability rather than an unconditional check:\r\n * such a walk exists to discover which images, videos, fonts and effects a\r\n * frame *references* — regardless of whether they can be seen. An invisible\r\n * node's font still has to load, because it may fade in two frames later and\r\n * glyphs that were never registered never paint. Skipping it there is not an\r\n * optimisation, it is a missing asset.\r\n *\r\n * Same shape and same reasoning as {@link readsSpaceRects}: the context\r\n * declares what it needs, and nodes check before doing work that would be\r\n * thrown away. See `Node2D.render`.\r\n */\r\n readonly drawsVisibleOnly: boolean;\r\n\r\n}\r\n\r\n/**\r\n * A render *pass*: a {@link RenderContext2D} plus the per-node scope bracket the\r\n * walk opens around each node.\r\n *\r\n * Split off from the drawing surface because the two have different callers.\r\n * `begin`/`end` are `Node2D.render`'s, once per node, and they push onto a stack\r\n * every fill with `space:'parent'` and every motion-driven effect reads back\r\n * from. A custom node's `renderSelf` calling one would open a scope nothing\r\n * closes — and since `renderSelf` is handed a {@link RenderContext2D}, it now\r\n * cannot.\r\n *\r\n * Every backend implements this; a host driving a render pass holds one.\r\n *\r\n * @internal\r\n */\r\nexport interface RenderPass2D extends RenderContext2D {\r\n /**\r\n * Open a node draw scope. Must be paired with `end()`, also when the scope\r\n * throws. Pushes the node's id and {@link NodeRenderState} (gradient-space\r\n * rects + per-frame motion) for the duration of the scope.\r\n */\r\n begin(state: NodeRenderState): void;\r\n\r\n /** Close the innermost node draw scope opened by `begin()`. */\r\n end(): void;\r\n}\r\n"]}
@@ -96,7 +96,7 @@ export declare const Tex: {
96
96
  * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);
97
97
  * g3.plane({ fill: scope }); // sized for you
98
98
  *
99
- * const stats = <Rect flow="vertical" padding={48}><Text text="CPU" /></Rect>;
99
+ * const stats = new Rect({ flow: "vertical", padding: 48, children: [Text({ text: "CPU" })] });
100
100
  * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });
101
101
  *
102
102
  * `width`/`height` are the buffer's resolution and default to 512. A source
@@ -89,7 +89,7 @@ export const Tex = {
89
89
  * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);
90
90
  * g3.plane({ fill: scope }); // sized for you
91
91
  *
92
- * const stats = <Rect flow="vertical" padding={48}><Text text="CPU" /></Rect>;
92
+ * const stats = new Rect({ flow: "vertical", padding: 48, children: [Text({ text: "CPU" })] });
93
93
  * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });
94
94
  *
95
95
  * `width`/`height` are the buffer's resolution and default to 512. A source
@@ -1 +1 @@
1
- {"version":3,"file":"builders.js","sourceRoot":"","sources":["../../src/render3d/builders.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D,\r\n ConeGeometry3D, CylinderGeometry3D, EdgesGeometry3D, ExtrudeGeometry3D,\r\n Geometry3D, LatheGeometry3D, ModelGeometry3D, ParametricGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D, WireframeGeometry3D,\r\n} from \"./geometry\";\r\nimport type {\r\n BasicMaterial3D, DepthMaterial3D, LambertMaterial3D, LineBasicMaterial3D,\r\n LineDashedMaterial3D, MatcapMaterial3D, NormalMaterial3D, PhongMaterial3D,\r\n PhysicalMaterial3D, PointsMaterial3D, ShaderMaterial3D, ShadowMaterial3D,\r\n SpriteMaterial3D, StandardMaterial3D, ToonMaterial3D,\r\n} from \"./material\";\r\nimport type { DataTexture3D, ImageTexture3D, SurfaceSource3D, SurfaceTexture3D, TextureOptions3D } from \"./texture\";\r\n\r\n/** A descriptor's own params, with the `type` discriminant removed. */\r\ntype ParamsOf<T> = Omit<T, \"type\">;\r\n\r\n/**\r\n * Geometry descriptors.\r\n *\r\n * These are plain values, so hoist one out of the builder and share it across\r\n * meshes — the renderer dedupes by identity, so a shared geometry is uploaded to\r\n * the GPU once no matter how many meshes reference it.\r\n *\r\n * const brick = Geo.box({ width: 1, height: 0.5, depth: 0.5 });\r\n * g.mesh(brick, red, { position: [0, 0, 0] })\r\n * .mesh(brick, red, { position: [1, 0, 0] }); // same GPU buffer\r\n */\r\nexport const Geo = {\r\n box: (o?: ParamsOf<BoxGeometry3D>): BoxGeometry3D => ({ type: \"box\", ...o }),\r\n sphere: (o?: ParamsOf<SphereGeometry3D>): SphereGeometry3D => ({ type: \"sphere\", ...o }),\r\n plane: (o?: ParamsOf<PlaneGeometry3D>): PlaneGeometry3D => ({ type: \"plane\", ...o }),\r\n cylinder: (o?: ParamsOf<CylinderGeometry3D>): CylinderGeometry3D => ({ type: \"cylinder\", ...o }),\r\n cone: (o?: ParamsOf<ConeGeometry3D>): ConeGeometry3D => ({ type: \"cone\", ...o }),\r\n torus: (o?: ParamsOf<TorusGeometry3D>): TorusGeometry3D => ({ type: \"torus\", ...o }),\r\n torusKnot: (o?: ParamsOf<TorusKnotGeometry3D>): TorusKnotGeometry3D => ({ type: \"torusKnot\", ...o }),\r\n circle: (o?: ParamsOf<CircleGeometry3D>): CircleGeometry3D => ({ type: \"circle\", ...o }),\r\n ring: (o?: ParamsOf<RingGeometry3D>): RingGeometry3D => ({ type: \"ring\", ...o }),\r\n capsule: (o?: ParamsOf<CapsuleGeometry3D>): CapsuleGeometry3D => ({ type: \"capsule\", ...o }),\r\n\r\n tetrahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"tetrahedron\", ...o }),\r\n octahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"octahedron\", ...o }),\r\n icosahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"icosahedron\", ...o }),\r\n dodecahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"dodecahedron\", ...o }),\r\n\r\n extrude: (o: ParamsOf<ExtrudeGeometry3D>): ExtrudeGeometry3D => ({ type: \"extrude\", ...o }),\r\n lathe: (o: ParamsOf<LatheGeometry3D>): LatheGeometry3D => ({ type: \"lathe\", ...o }),\r\n tube: (o: ParamsOf<TubeGeometry3D>): TubeGeometry3D => ({ type: \"tube\", ...o }),\r\n\r\n /** Raw vertex buffers — any mesh you can compute. */\r\n buffer: (o: ParamsOf<BufferGeometry3D>): BufferGeometry3D => ({ type: \"buffer\", ...o }),\r\n /** A surface sampled over a `[0,1]²` grid. Sugar over {@link Geo.buffer}. */\r\n parametric: (o: ParamsOf<ParametricGeometry3D>): ParametricGeometry3D => ({ type: \"parametric\", ...o }),\r\n\r\n /** The hard edges of another geometry — a clean outline, no triangulation diagonals. */\r\n edges: (source: Geometry3D, o?: Omit<ParamsOf<EdgesGeometry3D>, \"source\">): EdgesGeometry3D =>\r\n ({ type: \"edges\", source, ...o }),\r\n /** Every triangle edge of another geometry. */\r\n wireframe: (source: Geometry3D): WireframeGeometry3D => ({ type: \"wireframe\", source }),\r\n\r\n model: (src: string, o?: Omit<ParamsOf<ModelGeometry3D>, \"src\">): ModelGeometry3D =>\r\n ({ type: \"modelGeometry\", src, ...o }),\r\n} as const;\r\n\r\n/**\r\n * Material descriptors.\r\n *\r\n * Like geometries these are shareable values — one hoisted material across many\r\n * meshes compiles one shader program instead of N.\r\n *\r\n * Reach for {@link Mat.standard} by default; {@link Mat.physical} only when a\r\n * surface actually needs clearcoat, transmission, sheen or iridescence, since\r\n * those cost more per pixel. {@link Mat.shader} is the full-control escape hatch.\r\n */\r\nexport const Mat = {\r\n basic: (o?: ParamsOf<BasicMaterial3D>): BasicMaterial3D => ({ type: \"basic\", ...o }),\r\n standard: (o?: ParamsOf<StandardMaterial3D>): StandardMaterial3D => ({ type: \"standard\", ...o }),\r\n physical: (o?: ParamsOf<PhysicalMaterial3D>): PhysicalMaterial3D => ({ type: \"physical\", ...o }),\r\n phong: (o?: ParamsOf<PhongMaterial3D>): PhongMaterial3D => ({ type: \"phong\", ...o }),\r\n lambert: (o?: ParamsOf<LambertMaterial3D>): LambertMaterial3D => ({ type: \"lambert\", ...o }),\r\n toon: (o?: ParamsOf<ToonMaterial3D>): ToonMaterial3D => ({ type: \"toon\", ...o }),\r\n normal: (o?: ParamsOf<NormalMaterial3D>): NormalMaterial3D => ({ type: \"normal\", ...o }),\r\n depth: (o?: ParamsOf<DepthMaterial3D>): DepthMaterial3D => ({ type: \"depth\", ...o }),\r\n matcap: (o?: ParamsOf<MatcapMaterial3D>): MatcapMaterial3D => ({ type: \"matcap\", ...o }),\r\n points: (o?: ParamsOf<PointsMaterial3D>): PointsMaterial3D => ({ type: \"points\", ...o }),\r\n lineBasic: (o?: ParamsOf<LineBasicMaterial3D>): LineBasicMaterial3D => ({ type: \"lineBasic\", ...o }),\r\n lineDashed: (o?: ParamsOf<LineDashedMaterial3D>): LineDashedMaterial3D => ({ type: \"lineDashed\", ...o }),\r\n sprite: (o?: ParamsOf<SpriteMaterial3D>): SpriteMaterial3D => ({ type: \"sprite\", ...o }),\r\n shadow: (o?: ParamsOf<ShadowMaterial3D>): ShadowMaterial3D => ({ type: \"shadow\", ...o }),\r\n /** Raw GLSL. Uniform *values* are free to animate; source changes recompile. */\r\n shader: (o: ParamsOf<ShaderMaterial3D>): ShaderMaterial3D => ({ type: \"shader\", ...o }),\r\n} as const;\r\n\r\n/**\r\n * Texture descriptors.\r\n *\r\n * {@link Tex.image} takes a manifest path and is loaded through core's ordinary\r\n * image pipeline, so the pixels are resident before the frame that needs them\r\n * draws. A bare string works anywhere a texture is expected, so `Tex.image` is\r\n * only needed when passing sampler options.\r\n */\r\nexport const Tex = {\r\n image: (src: string, o?: TextureOptions3D): ImageTexture3D => ({ src, ...o }),\r\n /** A texture from raw RGBA8888 bytes — gradient ramps, noise, LUTs. */\r\n data: (\r\n data: ArrayLike<number>,\r\n width: number,\r\n height: number,\r\n o?: TextureOptions3D & { revision?: number },\r\n ): DataTexture3D => ({ data, width, height, ...o }),\r\n /**\r\n * A texture painted from Motion Script's own 2D output — the bridge from 2D\r\n * onto 3D geometry.\r\n *\r\n * `source` is a **value**: a built `Graphics2D` command list, or a `Node2D`\r\n * subtree for anything needing real layout, shaped `Text` or a loaded\r\n * `Image`. Both are passed directly; there is no name to match and nothing\r\n * has to be mounted anywhere in particular.\r\n *\r\n * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);\r\n * g3.plane({ fill: scope }); // sized for you\r\n *\r\n * const stats = <Rect flow=\"vertical\" padding={48}><Text text=\"CPU\" /></Rect>;\r\n * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });\r\n *\r\n * `width`/`height` are the buffer's resolution and default to 512. A source\r\n * handed straight to `fill` gets exactly this treatment with those defaults,\r\n * so the builder is only needed to pin a resolution or a sampler option.\r\n * **Hoist the source** rather than rebuilding it each frame — see\r\n * {@link SurfaceTexture3D}.\r\n */\r\n surface: (\r\n source: SurfaceSource3D,\r\n o?: TextureOptions3D & { width?: number; height?: number; maxPixelRatio?: number },\r\n ): SurfaceTexture3D => ({\r\n width: 512,\r\n height: 512,\r\n ...o,\r\n source,\r\n }),\r\n} as const;\r\n"]}
1
+ {"version":3,"file":"builders.js","sourceRoot":"","sources":["../../src/render3d/builders.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D,\r\n ConeGeometry3D, CylinderGeometry3D, EdgesGeometry3D, ExtrudeGeometry3D,\r\n Geometry3D, LatheGeometry3D, ModelGeometry3D, ParametricGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D, WireframeGeometry3D,\r\n} from \"./geometry\";\r\nimport type {\r\n BasicMaterial3D, DepthMaterial3D, LambertMaterial3D, LineBasicMaterial3D,\r\n LineDashedMaterial3D, MatcapMaterial3D, NormalMaterial3D, PhongMaterial3D,\r\n PhysicalMaterial3D, PointsMaterial3D, ShaderMaterial3D, ShadowMaterial3D,\r\n SpriteMaterial3D, StandardMaterial3D, ToonMaterial3D,\r\n} from \"./material\";\r\nimport type { DataTexture3D, ImageTexture3D, SurfaceSource3D, SurfaceTexture3D, TextureOptions3D } from \"./texture\";\r\n\r\n/** A descriptor's own params, with the `type` discriminant removed. */\r\ntype ParamsOf<T> = Omit<T, \"type\">;\r\n\r\n/**\r\n * Geometry descriptors.\r\n *\r\n * These are plain values, so hoist one out of the builder and share it across\r\n * meshes — the renderer dedupes by identity, so a shared geometry is uploaded to\r\n * the GPU once no matter how many meshes reference it.\r\n *\r\n * const brick = Geo.box({ width: 1, height: 0.5, depth: 0.5 });\r\n * g.mesh(brick, red, { position: [0, 0, 0] })\r\n * .mesh(brick, red, { position: [1, 0, 0] }); // same GPU buffer\r\n */\r\nexport const Geo = {\r\n box: (o?: ParamsOf<BoxGeometry3D>): BoxGeometry3D => ({ type: \"box\", ...o }),\r\n sphere: (o?: ParamsOf<SphereGeometry3D>): SphereGeometry3D => ({ type: \"sphere\", ...o }),\r\n plane: (o?: ParamsOf<PlaneGeometry3D>): PlaneGeometry3D => ({ type: \"plane\", ...o }),\r\n cylinder: (o?: ParamsOf<CylinderGeometry3D>): CylinderGeometry3D => ({ type: \"cylinder\", ...o }),\r\n cone: (o?: ParamsOf<ConeGeometry3D>): ConeGeometry3D => ({ type: \"cone\", ...o }),\r\n torus: (o?: ParamsOf<TorusGeometry3D>): TorusGeometry3D => ({ type: \"torus\", ...o }),\r\n torusKnot: (o?: ParamsOf<TorusKnotGeometry3D>): TorusKnotGeometry3D => ({ type: \"torusKnot\", ...o }),\r\n circle: (o?: ParamsOf<CircleGeometry3D>): CircleGeometry3D => ({ type: \"circle\", ...o }),\r\n ring: (o?: ParamsOf<RingGeometry3D>): RingGeometry3D => ({ type: \"ring\", ...o }),\r\n capsule: (o?: ParamsOf<CapsuleGeometry3D>): CapsuleGeometry3D => ({ type: \"capsule\", ...o }),\r\n\r\n tetrahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"tetrahedron\", ...o }),\r\n octahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"octahedron\", ...o }),\r\n icosahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"icosahedron\", ...o }),\r\n dodecahedron: (o?: Omit<ParamsOf<PolyhedronGeometry3D>, \"shape\">): PolyhedronGeometry3D =>\r\n ({ type: \"polyhedron\", shape: \"dodecahedron\", ...o }),\r\n\r\n extrude: (o: ParamsOf<ExtrudeGeometry3D>): ExtrudeGeometry3D => ({ type: \"extrude\", ...o }),\r\n lathe: (o: ParamsOf<LatheGeometry3D>): LatheGeometry3D => ({ type: \"lathe\", ...o }),\r\n tube: (o: ParamsOf<TubeGeometry3D>): TubeGeometry3D => ({ type: \"tube\", ...o }),\r\n\r\n /** Raw vertex buffers — any mesh you can compute. */\r\n buffer: (o: ParamsOf<BufferGeometry3D>): BufferGeometry3D => ({ type: \"buffer\", ...o }),\r\n /** A surface sampled over a `[0,1]²` grid. Sugar over {@link Geo.buffer}. */\r\n parametric: (o: ParamsOf<ParametricGeometry3D>): ParametricGeometry3D => ({ type: \"parametric\", ...o }),\r\n\r\n /** The hard edges of another geometry — a clean outline, no triangulation diagonals. */\r\n edges: (source: Geometry3D, o?: Omit<ParamsOf<EdgesGeometry3D>, \"source\">): EdgesGeometry3D =>\r\n ({ type: \"edges\", source, ...o }),\r\n /** Every triangle edge of another geometry. */\r\n wireframe: (source: Geometry3D): WireframeGeometry3D => ({ type: \"wireframe\", source }),\r\n\r\n model: (src: string, o?: Omit<ParamsOf<ModelGeometry3D>, \"src\">): ModelGeometry3D =>\r\n ({ type: \"modelGeometry\", src, ...o }),\r\n} as const;\r\n\r\n/**\r\n * Material descriptors.\r\n *\r\n * Like geometries these are shareable values — one hoisted material across many\r\n * meshes compiles one shader program instead of N.\r\n *\r\n * Reach for {@link Mat.standard} by default; {@link Mat.physical} only when a\r\n * surface actually needs clearcoat, transmission, sheen or iridescence, since\r\n * those cost more per pixel. {@link Mat.shader} is the full-control escape hatch.\r\n */\r\nexport const Mat = {\r\n basic: (o?: ParamsOf<BasicMaterial3D>): BasicMaterial3D => ({ type: \"basic\", ...o }),\r\n standard: (o?: ParamsOf<StandardMaterial3D>): StandardMaterial3D => ({ type: \"standard\", ...o }),\r\n physical: (o?: ParamsOf<PhysicalMaterial3D>): PhysicalMaterial3D => ({ type: \"physical\", ...o }),\r\n phong: (o?: ParamsOf<PhongMaterial3D>): PhongMaterial3D => ({ type: \"phong\", ...o }),\r\n lambert: (o?: ParamsOf<LambertMaterial3D>): LambertMaterial3D => ({ type: \"lambert\", ...o }),\r\n toon: (o?: ParamsOf<ToonMaterial3D>): ToonMaterial3D => ({ type: \"toon\", ...o }),\r\n normal: (o?: ParamsOf<NormalMaterial3D>): NormalMaterial3D => ({ type: \"normal\", ...o }),\r\n depth: (o?: ParamsOf<DepthMaterial3D>): DepthMaterial3D => ({ type: \"depth\", ...o }),\r\n matcap: (o?: ParamsOf<MatcapMaterial3D>): MatcapMaterial3D => ({ type: \"matcap\", ...o }),\r\n points: (o?: ParamsOf<PointsMaterial3D>): PointsMaterial3D => ({ type: \"points\", ...o }),\r\n lineBasic: (o?: ParamsOf<LineBasicMaterial3D>): LineBasicMaterial3D => ({ type: \"lineBasic\", ...o }),\r\n lineDashed: (o?: ParamsOf<LineDashedMaterial3D>): LineDashedMaterial3D => ({ type: \"lineDashed\", ...o }),\r\n sprite: (o?: ParamsOf<SpriteMaterial3D>): SpriteMaterial3D => ({ type: \"sprite\", ...o }),\r\n shadow: (o?: ParamsOf<ShadowMaterial3D>): ShadowMaterial3D => ({ type: \"shadow\", ...o }),\r\n /** Raw GLSL. Uniform *values* are free to animate; source changes recompile. */\r\n shader: (o: ParamsOf<ShaderMaterial3D>): ShaderMaterial3D => ({ type: \"shader\", ...o }),\r\n} as const;\r\n\r\n/**\r\n * Texture descriptors.\r\n *\r\n * {@link Tex.image} takes a manifest path and is loaded through core's ordinary\r\n * image pipeline, so the pixels are resident before the frame that needs them\r\n * draws. A bare string works anywhere a texture is expected, so `Tex.image` is\r\n * only needed when passing sampler options.\r\n */\r\nexport const Tex = {\r\n image: (src: string, o?: TextureOptions3D): ImageTexture3D => ({ src, ...o }),\r\n /** A texture from raw RGBA8888 bytes — gradient ramps, noise, LUTs. */\r\n data: (\r\n data: ArrayLike<number>,\r\n width: number,\r\n height: number,\r\n o?: TextureOptions3D & { revision?: number },\r\n ): DataTexture3D => ({ data, width, height, ...o }),\r\n /**\r\n * A texture painted from Motion Script's own 2D output — the bridge from 2D\r\n * onto 3D geometry.\r\n *\r\n * `source` is a **value**: a built `Graphics2D` command list, or a `Node2D`\r\n * subtree for anything needing real layout, shaped `Text` or a loaded\r\n * `Image`. Both are passed directly; there is no name to match and nothing\r\n * has to be mounted anywhere in particular.\r\n *\r\n * const scope = new Graphics2D().line({ points: trace(phase()) }).stroke(…);\r\n * g3.plane({ fill: scope }); // sized for you\r\n *\r\n * const stats = new Rect({ flow: \"vertical\", padding: 48, children: [Text({ text: \"CPU\" })] });\r\n * g3.plane({ fill: Tex.surface(stats, { width: 1024, height: 640 }) });\r\n *\r\n * `width`/`height` are the buffer's resolution and default to 512. A source\r\n * handed straight to `fill` gets exactly this treatment with those defaults,\r\n * so the builder is only needed to pin a resolution or a sampler option.\r\n * **Hoist the source** rather than rebuilding it each frame — see\r\n * {@link SurfaceTexture3D}.\r\n */\r\n surface: (\r\n source: SurfaceSource3D,\r\n o?: TextureOptions3D & { width?: number; height?: number; maxPixelRatio?: number },\r\n ): SurfaceTexture3D => ({\r\n width: 512,\r\n height: 512,\r\n ...o,\r\n source,\r\n }),\r\n} as const;\r\n"]}
@@ -147,10 +147,8 @@ type ParamsOf<G> = Omit<G, "type">;
147
147
  * the `Node3D` tree owns them. The exact division `Graphics2D` and
148
148
  * `RenderContext2D` already make in 2D.
149
149
  *
150
- * protected renderSelf(ctx: RenderContext3D): void {
151
- * ctx.draw(new Graphics3D()
152
- * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 }));
153
- * }
150
+ * render: (ctx) => ctx.draw(new Graphics3D()
151
+ * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 })),
154
152
  *
155
153
  * Nothing here touches a renderer: a built `Graphics3D` is handed to a
156
154
  * {@link RenderContext3D}, which splices its ops into the scene being recorded.
@@ -169,23 +167,19 @@ type ParamsOf<G> = Omit<G, "type">;
169
167
  *
170
168
  * ── Animation ─────────────────────────────────────────────────────────────────
171
169
  * A `Graphics3D` is rebuilt from scratch every frame, so animation is just
172
- * reading the node's own props while building:
170
+ * reading the node's own state while building:
173
171
  *
174
- * class Rig extends Canvas3D {
175
- * @property({ default: 0 }) declare spin: number;
176
- * @vector3Property() declare lift: Vector3;
172
+ * const Rig = component3d({
173
+ * key: "rig",
174
+ * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },
175
+ * render: (ctx, s) => ctx.draw(new Graphics3D()
176
+ * .box({ rotation: [0, s.spin, 0], position: s.lift })),
177
+ * });
178
+ * // a `to` of { spin: 360 } over two seconds turns it
177
179
  *
178
- * protected buildScene3D(scene: Scene3D): void {
179
- * scene.draw(new Graphics3D()
180
- * .box({ rotation: [0, this.spin, 0], position: this.lift }));
181
- * }
182
- * }
183
- * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })
184
- *
185
- * Note `@vector3Property` rather than a bare `@property`. A prop holding a
186
- * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,
187
- * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it
188
- * alone; the attribute-typed decorators carry the right one already.
180
+ * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit
181
+ * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing
182
+ * to interpolate it with and leaves it alone.
189
183
  *
190
184
  * ── Reconciliation identity ───────────────────────────────────────────────────
191
185
  * The renderer caches one live 3D object per op and mutates it between frames
@@ -1 +1 @@
1
- {"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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"}
@@ -94,10 +94,8 @@ function pickGeometry(source, type) {
94
94
  * the `Node3D` tree owns them. The exact division `Graphics2D` and
95
95
  * `RenderContext2D` already make in 2D.
96
96
  *
97
- * protected renderSelf(ctx: RenderContext3D): void {
98
- * ctx.draw(new Graphics3D()
99
- * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 }));
100
- * }
97
+ * render: (ctx) => ctx.draw(new Graphics3D()
98
+ * .box({ width: 2, cornerRadius: 0.15, fill: "#e0533d", roughness: 0.3 })),
101
99
  *
102
100
  * Nothing here touches a renderer: a built `Graphics3D` is handed to a
103
101
  * {@link RenderContext3D}, which splices its ops into the scene being recorded.
@@ -116,23 +114,19 @@ function pickGeometry(source, type) {
116
114
  *
117
115
  * ── Animation ─────────────────────────────────────────────────────────────────
118
116
  * A `Graphics3D` is rebuilt from scratch every frame, so animation is just
119
- * reading the node's own props while building:
117
+ * reading the node's own state while building:
120
118
  *
121
- * class Rig extends Canvas3D {
122
- * @property({ default: 0 }) declare spin: number;
123
- * @vector3Property() declare lift: Vector3;
119
+ * const Rig = component3d({
120
+ * key: "rig",
121
+ * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },
122
+ * render: (ctx, s) => ctx.draw(new Graphics3D()
123
+ * .box({ rotation: [0, s.spin, 0], position: s.lift })),
124
+ * });
125
+ * // a `to` of { spin: 360 } over two seconds turns it
124
126
  *
125
- * protected buildScene3D(scene: Scene3D): void {
126
- * scene.draw(new Graphics3D()
127
- * .box({ rotation: [0, this.spin, 0], position: this.lift }));
128
- * }
129
- * }
130
- * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })
131
- *
132
- * Note `@vector3Property` rather than a bare `@property`. A prop holding a
133
- * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,
134
- * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it
135
- * alone; the attribute-typed decorators carry the right one already.
127
+ * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit
128
+ * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing
129
+ * to interpolate it with and leaves it alone.
136
130
  *
137
131
  * ── Reconciliation identity ───────────────────────────────────────────────────
138
132
  * The renderer caches one live 3D object per op and mutates it between frames
@@ -1 +1 @@
1
- {"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoE5C;;;;;GAKG;AACH,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;CACpE,CAAC,CAAC;AAkDH,MAAM,cAAc,GAAG;IACnB,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ;IACvD,SAAS,EAAE,QAAQ,EAAE,aAAa;CAC5B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,uBAAuB,GAAG;IAC5B,SAAS,EAAE,WAAW,EAAE,WAAW;IACnC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc;IAC3D,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW;IACnE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO;CACrC,CAAC;AAEX,kEAAkE;AAClE,MAAM,cAAc,GAAsB,CAAC,GAAG,uBAAuB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAEpG;;;;;GAKG;AACH,SAAS,aAAa,CAAC,MAAc;IACjC,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,GAAwC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAA8B,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAA2B;IAClE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAE1D,MAAM,QAAQ,GAA4B,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAExF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAEpD,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IACD,OAAO,QAAiC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,SAAS,YAAY,CAAI,MAAc,EAAE,IAAY;IACjD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3C,IAAK,cAAoC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAClE,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAQ,CAAC;AACpB,CAAC;AAKD,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,OAAO,UAAU;IACX,IAAI,GAAmB,EAAE,CAAC;IAElC,2EAA2E;IACnE,MAAM,CAAC,EAAgB;QAC3B,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,IAAI,CACA,QAAoB,EACpB,QAA6C,EAC7C,SAAuB;QAEvB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;YAC1C,SAAS;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,sEAAsE;IAC9D,KAAK,CAAC,IAAwB,EAAE,OAAyB;QAC7D,MAAM,MAAM,GAAoB,OAAO,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CACZ,YAAY,CAAa,MAAM,EAAE,IAAI,CAAC,EACtC,0BAA0B,CAAC,MAAM,CAAC,EAClC,aAAa,CAAC,MAAM,CAAC,CACxB,CAAC;IACN,CAAC;IAED,GAAG,CAAC,OAAmD;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,CAAC,OAAsD;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,OAAqD;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,QAAQ,CAAC,OAAwD;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,OAAoD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,OAAqD;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,SAAS,CAAC,OAAyD;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,OAAsD;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,OAAoD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,OAAuD;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,UAAU,CAAC,OAAyD;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,OAAsD;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,OAAoD;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,OAAmD;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,4EAA4E;IAE5E;;;;;;OAMG;IACH,SAAS,CACL,QAAoB,EACpB,QAAoB,EACpB,SAAiC,EACjC,OAAgE;QAEhE,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,QAAQ;YACR,SAAS;YACT,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,2EAA2E;IAC3E,MAAM,CACF,QAAoB,EACpB,QAAqB,EACrB,SAAuB;QAEvB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxC,SAAS;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,OAYU;QACX,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAElF,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,QAAQ,GAAe,QAAQ,IAAI;YACrC,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;YAC7D,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS;gBAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBACzE,CAAC,CAAC,EAAE,CAAC;YACT,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAO,CAAC,EAAE;YAC1E,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YACvD,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,OAAiF;QACpF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAe,QAAQ,IAAI;YACrC,IAAI,EAAE,QAAQ;YACd,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAIS;QACX,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,OAAO;YACb,GAAG;YACH,SAAS,EAAE,SAAS,KAAK,SAAS;gBAC9B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAA6B,CAAC;YAC5E,QAAQ;YACR,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4EAA4E;IAE5E,4DAA4D;IAC5D,GAAG;QACC,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IAClC,CAAC;CACJ;AAkBD,6EAA6E;AAC7E,SAAS,aAAa,CAAC,MAA+B;IAClD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,KAA4C,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"./geometry\";\r\nimport type { Material3D, Shading3D } from \"./material\";\r\nimport type { Texture3D } from \"./texture\";\r\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\r\nimport { inspectDrawable3D } from \"./inert\";\r\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\r\nimport type { Vector3Input } from \"./vector3\";\r\n\r\n// ─── Ops ─────────────────────────────────────────────────────────────────────\r\n\r\n/** One clip of a model's baked animation, sampled at an explicit time. */\r\nexport interface ModelAnimation3D {\r\n /** Clip name, or its index in the file. Defaults to the first clip. */\r\n clip?: string | number;\r\n /**\r\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\r\n * time rather than advancing by a delta, which is what keeps a model's\r\n * animation identical whether the frame was reached by playing forward or by\r\n * scrubbing backwards.\r\n */\r\n time: number;\r\n /** Blend weight, for cross-fading clips. Default 1. */\r\n weight?: number;\r\n}\r\n\r\n/**\r\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\r\n * or in order and closed back to the start.\r\n */\r\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\r\n\r\n/**\r\n * One recorded operation in a {@link Graphics3D} command list.\r\n *\r\n * Every op draws something. Hierarchy, lights and the camera are *scene*\r\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\r\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\r\n *\r\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\r\n * because in a 3D scene graph they are properties of an object rather than\r\n * children of it.\r\n */\r\nexport type Graphics3DOp =\r\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\r\n | {\r\n kind: \"instances\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n /** Per-instance placement. Length drives the instance count. */\r\n instances: readonly Transform3D[];\r\n /** Per-instance tint. Needs a material that reads instance colour. */\r\n colors?: readonly Color[];\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"line\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n mode: LineMode3D;\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"model\";\r\n src: string;\r\n animation?: readonly ModelAnimation3D[];\r\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\r\n override?: Readonly<Record<string, Material3D>>;\r\n transform?: Transform3D;\r\n };\r\n\r\n/**\r\n * Op kinds that put something in the scene (as opposed to shaping the tree).\r\n *\r\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\r\n * `camera` — so \"is anything actually drawn here\" has a single definition.\r\n */\r\n/** @internal */\r\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\r\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\r\n]);\r\n\r\n// ─── Shorthand ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Material fields promoted onto the geometry sugar methods, so the common case is\r\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\r\n *\r\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\r\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\r\n * (how light behaves on it) rather than colour, which is the line Spline's\r\n * material panel draws too and the reason those stay separate fields.\r\n *\r\n * These desugar at record time into a full {@link Material3D} — `standard` by\r\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\r\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\r\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\r\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\r\n */\r\nexport interface MaterialShorthand3D {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material?: Material3D | readonly Material3D[];\r\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\r\n fill?: Fill3D;\r\n opacity?: number;\r\n roughness?: number;\r\n metalness?: number;\r\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n normalMap?: Texture3D;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n aoMap?: Texture3D;\r\n alphaMap?: Texture3D;\r\n envMapIntensity?: number;\r\n wireframe?: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n vertexColors?: boolean;\r\n blend?: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit?: boolean;\r\n}\r\n\r\n/** Transform + material shorthand, accepted by every geometry sugar method. */\r\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\r\n\r\nconst TRANSFORM_KEYS = [\r\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\r\n \"visible\", \"shadow\", \"renderOrder\",\r\n] as const;\r\n\r\n/**\r\n * Shorthand keys copied straight onto the built descriptor.\r\n *\r\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\r\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\r\n */\r\nconst MATERIAL_SHORTHAND_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/** Every key the shorthand owns, for stripping a geometry bag. */\r\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\r\n\r\n/**\r\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\r\n * the concrete option types at each call site pass without a cast, and returns\r\n * `undefined` rather than `{}` when there is nothing to apply — an absent\r\n * transform lets the renderer skip the matrix write entirely.\r\n */\r\nfunction pickTransform(source: object): Transform3D | undefined {\r\n const bag = source as Record<string, unknown>;\r\n let out: Record<string, unknown> | undefined;\r\n for (const key of TRANSFORM_KEYS) {\r\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\r\n }\r\n return out as Transform3D | undefined;\r\n}\r\n\r\n/**\r\n * Build the material a shorthand bag describes. Always returns one, so a recorded\r\n * drawable op never has to be interpreted with \"…or the default\" in mind.\r\n *\r\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\r\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\r\n * two chances for a node and a builder call to paint differently.\r\n *\r\n * @internal\r\n */\r\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\r\n if (source.material !== undefined) return source.material;\r\n\r\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\r\n\r\n const fill = resolveFill3D(source.fill);\r\n if (fill.color !== undefined) material.color = fill.color;\r\n if (fill.map !== undefined) material.map = fill.map;\r\n\r\n for (const key of MATERIAL_SHORTHAND_KEYS) {\r\n const value = (source as Record<string, unknown>)[key];\r\n if (value !== undefined) material[key] = value;\r\n }\r\n return material as unknown as Material3D;\r\n}\r\n\r\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\r\nfunction pickGeometry<T>(source: object, type: string): T {\r\n const bag = source as Record<string, unknown>;\r\n const out: Record<string, unknown> = { type };\r\n for (const key in bag) {\r\n if (SHORTHAND_KEYS.includes(key)) continue;\r\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\r\n if (bag[key] !== undefined) out[key] = bag[key];\r\n }\r\n return out as T;\r\n}\r\n\r\n/** Geometry params only, with `type` and the inherited passthrough removed. */\r\ntype ParamsOf<G> = Omit<G, \"type\">;\r\n\r\n// ─── Recorder ────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * What one 3D node draws — the `Graphics2D` of 3D.\r\n *\r\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\r\n * sprites, models), each with its own geometry, material and local transform.\r\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\r\n * because those are properties of a *scene* rather than of a thing in one, and\r\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\r\n * `RenderContext2D` already make in 2D.\r\n *\r\n * protected renderSelf(ctx: RenderContext3D): void {\r\n * ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 }));\r\n * }\r\n *\r\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\r\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\r\n *\r\n * ── One flat bag, deliberately ────────────────────────────────────────────────\r\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\r\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\r\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\r\n * belongs to exactly one object, because a mesh *is* geometry plus material.\r\n * A chained `.box().fill()` would imply a group material that has nothing to\r\n * scope over, so the shape and what it is made of are stated together instead.\r\n *\r\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\r\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\r\n * matching the engine's 2D `rotation`. The renderer converts.\r\n *\r\n * ── Animation ─────────────────────────────────────────────────────────────────\r\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\r\n * reading the node's own props while building:\r\n *\r\n * class Rig extends Canvas3D {\r\n * @property({ default: 0 }) declare spin: number;\r\n * @vector3Property() declare lift: Vector3;\r\n *\r\n * protected buildScene3D(scene: Scene3D): void {\r\n * scene.draw(new Graphics3D()\r\n * .box({ rotation: [0, this.spin, 0], position: this.lift }));\r\n * }\r\n * }\r\n * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })\r\n *\r\n * Note `@vector3Property` rather than a bare `@property`. A prop holding a\r\n * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,\r\n * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it\r\n * alone; the attribute-typed decorators carry the right one already.\r\n *\r\n * ── Reconciliation identity ───────────────────────────────────────────────────\r\n * The renderer caches one live 3D object per op and mutates it between frames\r\n * rather than rebuilding. Identity is **derived**: it comes from the owning\r\n * `Node3D` plus a signature of what the op actually draws, so a builder that\r\n * emits ops conditionally reuses the right cache entry with nothing written by\r\n * hand. There is no `key` to set.\r\n *\r\n * ── What is cheap to animate ──────────────────────────────────────────────────\r\n * Transforms and most material values are in-place writes, so they cost nothing\r\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\r\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\r\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\r\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\r\n * set once, not tweened.\r\n */\r\nexport class Graphics3D {\r\n private _ops: Graphics3DOp[] = [];\r\n\r\n /** Append one op, flagging (in development) inputs no renderer acts on. */\r\n private record(op: Graphics3DOp): void {\r\n inspectDrawable3D(op);\r\n this._ops.push(op);\r\n }\r\n\r\n // ─── Meshes ──────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record a mesh from an explicit geometry and material. The geometry sugar\r\n * methods below all funnel here.\r\n */\r\n mesh(\r\n geometry: Geometry3D,\r\n material?: Material3D | readonly Material3D[],\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"mesh\",\r\n geometry,\r\n material: material ?? { type: \"standard\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\r\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\r\n const source: MeshShorthand3D = options ?? {};\r\n return this.mesh(\r\n pickGeometry<Geometry3D>(source, type),\r\n resolveMaterialShorthand3D(source),\r\n pickTransform(source),\r\n );\r\n }\r\n\r\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"box\", options);\r\n }\r\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"sphere\", options);\r\n }\r\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"plane\", options);\r\n }\r\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cylinder\", options);\r\n }\r\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cone\", options);\r\n }\r\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torus\", options);\r\n }\r\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torusKnot\", options);\r\n }\r\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"circle\", options);\r\n }\r\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"ring\", options);\r\n }\r\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"capsule\", options);\r\n }\r\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"polyhedron\", options);\r\n }\r\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"extrude\", options);\r\n }\r\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"lathe\", options);\r\n }\r\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"tube\", options);\r\n }\r\n\r\n // ─── Other drawables ─────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record many copies of one geometry in a single draw call. The way to put\r\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\r\n *\r\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\r\n * positions.map(p => ({ position: p })))\r\n */\r\n instances(\r\n geometry: Geometry3D,\r\n material: Material3D,\r\n instances: readonly Transform3D[],\r\n options?: { colors?: readonly Color[]; transform?: Transform3D },\r\n ): this {\r\n this.record({\r\n kind: \"instances\",\r\n geometry,\r\n material,\r\n instances,\r\n colors: options?.colors,\r\n transform: options?.transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\r\n points(\r\n geometry: Geometry3D,\r\n material?: Material3D,\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"points\",\r\n geometry,\r\n material: material ?? { type: \"points\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a line. Give it either explicit `points` or a `geometry` (typically\r\n * `Geo.edges(...)` for a wireframe outline).\r\n *\r\n * `closed` joins the last point back to the first, as the 2D `line` op's\r\n * own field does. `segments` treats the points as disjoint start/end pairs\r\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\r\n * confuse it with: a line is drawn from the points it is given.)\r\n */\r\n line(options: {\r\n points?: readonly Vector3Input[];\r\n geometry?: Geometry3D;\r\n material?: Material3D;\r\n /** Join the last point back to the first. */\r\n closed?: boolean;\r\n /** Treat the points as disjoint start/end pairs. */\r\n segments?: boolean;\r\n /** The line's paint. Cap and join have no meaning on a GL line. */\r\n stroke?: LineStroke3D;\r\n opacity?: number;\r\n transform?: Transform3D;\r\n } & Transform3D): this {\r\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\r\n\r\n if (!points && !geometry) {\r\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\r\n }\r\n\r\n const resolved: Material3D = material ?? {\r\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\r\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\r\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\r\n ...(stroke?.dash !== undefined\r\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\r\n : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n\r\n this.record({\r\n kind: \"line\",\r\n geometry: geometry ?? { type: \"buffer\", position: flattenPoints(points!) },\r\n material: resolved,\r\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a camera-facing textured quad. */\r\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\r\n const { fill, material, opacity } = options;\r\n const paint = resolveFill3D(fill);\r\n const resolved: Material3D = material ?? {\r\n type: \"sprite\",\r\n ...(paint.map !== undefined ? { map: paint.map } : {}),\r\n ...(paint.color !== undefined ? { color: paint.color } : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n this.record({\r\n kind: \"sprite\",\r\n material: resolved,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\r\n * resolves to an empty slot and draws nothing, and in development the first\r\n * one recorded warns.\r\n *\r\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\r\n * a model stays frame-identical under scrubbing.\r\n */\r\n model(options: {\r\n src: string;\r\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\r\n override?: Readonly<Record<string, Material3D>>;\r\n } & Transform3D): this {\r\n const { src, animation, override } = options;\r\n this.record({\r\n kind: \"model\",\r\n src,\r\n animation: animation === undefined\r\n ? undefined\r\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\r\n override,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n // ─── Consumption ─────────────────────────────────────────────────────────\r\n\r\n /** The recorded ops, in order. Replayed by the renderer. */\r\n ops(): readonly Graphics3DOp[] {\r\n return this._ops;\r\n }\r\n\r\n /** True when this node draws nothing. */\r\n isEmpty(): boolean {\r\n return this._ops.length === 0;\r\n }\r\n}\r\n\r\n/**\r\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\r\n *\r\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\r\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\r\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\r\n * thick line, draw a `tube`.\r\n */\r\nexport interface LineStroke3D {\r\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\r\n fill?: Color;\r\n weight?: number;\r\n /** Dash and gap lengths, in world units. */\r\n dash?: readonly [number, number?];\r\n}\r\n\r\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\r\nfunction flattenPoints(points: readonly Vector3Input[]): number[] {\r\n const out: number[] = [];\r\n for (const point of points) {\r\n if (typeof point === \"number\") {\r\n out.push(point, point, point);\r\n } else if (Array.isArray(point)) {\r\n out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);\r\n }\r\n }\r\n return out;\r\n}\r\n"]}
1
+ {"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"./geometry\";\r\nimport type { Material3D, Shading3D } from \"./material\";\r\nimport type { Texture3D } from \"./texture\";\r\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\r\nimport { inspectDrawable3D } from \"./inert\";\r\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\r\nimport type { Vector3Input } from \"./vector3\";\r\n\r\n// ─── Ops ─────────────────────────────────────────────────────────────────────\r\n\r\n/** One clip of a model's baked animation, sampled at an explicit time. */\r\nexport interface ModelAnimation3D {\r\n /** Clip name, or its index in the file. Defaults to the first clip. */\r\n clip?: string | number;\r\n /**\r\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\r\n * time rather than advancing by a delta, which is what keeps a model's\r\n * animation identical whether the frame was reached by playing forward or by\r\n * scrubbing backwards.\r\n */\r\n time: number;\r\n /** Blend weight, for cross-fading clips. Default 1. */\r\n weight?: number;\r\n}\r\n\r\n/**\r\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\r\n * or in order and closed back to the start.\r\n */\r\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\r\n\r\n/**\r\n * One recorded operation in a {@link Graphics3D} command list.\r\n *\r\n * Every op draws something. Hierarchy, lights and the camera are *scene*\r\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\r\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\r\n *\r\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\r\n * because in a 3D scene graph they are properties of an object rather than\r\n * children of it.\r\n */\r\nexport type Graphics3DOp =\r\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\r\n | {\r\n kind: \"instances\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n /** Per-instance placement. Length drives the instance count. */\r\n instances: readonly Transform3D[];\r\n /** Per-instance tint. Needs a material that reads instance colour. */\r\n colors?: readonly Color[];\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"line\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n mode: LineMode3D;\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"model\";\r\n src: string;\r\n animation?: readonly ModelAnimation3D[];\r\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\r\n override?: Readonly<Record<string, Material3D>>;\r\n transform?: Transform3D;\r\n };\r\n\r\n/**\r\n * Op kinds that put something in the scene (as opposed to shaping the tree).\r\n *\r\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\r\n * `camera` — so \"is anything actually drawn here\" has a single definition.\r\n */\r\n/** @internal */\r\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\r\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\r\n]);\r\n\r\n// ─── Shorthand ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Material fields promoted onto the geometry sugar methods, so the common case is\r\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\r\n *\r\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\r\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\r\n * (how light behaves on it) rather than colour, which is the line Spline's\r\n * material panel draws too and the reason those stay separate fields.\r\n *\r\n * These desugar at record time into a full {@link Material3D} — `standard` by\r\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\r\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\r\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\r\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\r\n */\r\nexport interface MaterialShorthand3D {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material?: Material3D | readonly Material3D[];\r\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\r\n fill?: Fill3D;\r\n opacity?: number;\r\n roughness?: number;\r\n metalness?: number;\r\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n normalMap?: Texture3D;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n aoMap?: Texture3D;\r\n alphaMap?: Texture3D;\r\n envMapIntensity?: number;\r\n wireframe?: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n vertexColors?: boolean;\r\n blend?: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit?: boolean;\r\n}\r\n\r\n/** Transform + material shorthand, accepted by every geometry sugar method. */\r\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\r\n\r\nconst TRANSFORM_KEYS = [\r\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\r\n \"visible\", \"shadow\", \"renderOrder\",\r\n] as const;\r\n\r\n/**\r\n * Shorthand keys copied straight onto the built descriptor.\r\n *\r\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\r\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\r\n */\r\nconst MATERIAL_SHORTHAND_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/** Every key the shorthand owns, for stripping a geometry bag. */\r\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\r\n\r\n/**\r\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\r\n * the concrete option types at each call site pass without a cast, and returns\r\n * `undefined` rather than `{}` when there is nothing to apply — an absent\r\n * transform lets the renderer skip the matrix write entirely.\r\n */\r\nfunction pickTransform(source: object): Transform3D | undefined {\r\n const bag = source as Record<string, unknown>;\r\n let out: Record<string, unknown> | undefined;\r\n for (const key of TRANSFORM_KEYS) {\r\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\r\n }\r\n return out as Transform3D | undefined;\r\n}\r\n\r\n/**\r\n * Build the material a shorthand bag describes. Always returns one, so a recorded\r\n * drawable op never has to be interpreted with \"…or the default\" in mind.\r\n *\r\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\r\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\r\n * two chances for a node and a builder call to paint differently.\r\n *\r\n * @internal\r\n */\r\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\r\n if (source.material !== undefined) return source.material;\r\n\r\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\r\n\r\n const fill = resolveFill3D(source.fill);\r\n if (fill.color !== undefined) material.color = fill.color;\r\n if (fill.map !== undefined) material.map = fill.map;\r\n\r\n for (const key of MATERIAL_SHORTHAND_KEYS) {\r\n const value = (source as Record<string, unknown>)[key];\r\n if (value !== undefined) material[key] = value;\r\n }\r\n return material as unknown as Material3D;\r\n}\r\n\r\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\r\nfunction pickGeometry<T>(source: object, type: string): T {\r\n const bag = source as Record<string, unknown>;\r\n const out: Record<string, unknown> = { type };\r\n for (const key in bag) {\r\n if (SHORTHAND_KEYS.includes(key)) continue;\r\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\r\n if (bag[key] !== undefined) out[key] = bag[key];\r\n }\r\n return out as T;\r\n}\r\n\r\n/** Geometry params only, with `type` and the inherited passthrough removed. */\r\ntype ParamsOf<G> = Omit<G, \"type\">;\r\n\r\n// ─── Recorder ────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * What one 3D node draws — the `Graphics2D` of 3D.\r\n *\r\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\r\n * sprites, models), each with its own geometry, material and local transform.\r\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\r\n * because those are properties of a *scene* rather than of a thing in one, and\r\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\r\n * `RenderContext2D` already make in 2D.\r\n *\r\n * render: (ctx) => ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 })),\r\n *\r\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\r\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\r\n *\r\n * ── One flat bag, deliberately ────────────────────────────────────────────────\r\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\r\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\r\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\r\n * belongs to exactly one object, because a mesh *is* geometry plus material.\r\n * A chained `.box().fill()` would imply a group material that has nothing to\r\n * scope over, so the shape and what it is made of are stated together instead.\r\n *\r\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\r\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\r\n * matching the engine's 2D `rotation`. The renderer converts.\r\n *\r\n * ── Animation ─────────────────────────────────────────────────────────────────\r\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\r\n * reading the node's own state while building:\r\n *\r\n * const Rig = component3d({\r\n * key: \"rig\",\r\n * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },\r\n * render: (ctx, s) => ctx.draw(new Graphics3D()\r\n * .box({ rotation: [0, s.spin, 0], position: s.lift })),\r\n * });\r\n * // a `to` of { spin: 360 } over two seconds turns it\r\n *\r\n * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit\r\n * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing\r\n * to interpolate it with and leaves it alone.\r\n *\r\n * ── Reconciliation identity ───────────────────────────────────────────────────\r\n * The renderer caches one live 3D object per op and mutates it between frames\r\n * rather than rebuilding. Identity is **derived**: it comes from the owning\r\n * `Node3D` plus a signature of what the op actually draws, so a builder that\r\n * emits ops conditionally reuses the right cache entry with nothing written by\r\n * hand. There is no `key` to set.\r\n *\r\n * ── What is cheap to animate ──────────────────────────────────────────────────\r\n * Transforms and most material values are in-place writes, so they cost nothing\r\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\r\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\r\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\r\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\r\n * set once, not tweened.\r\n */\r\nexport class Graphics3D {\r\n private _ops: Graphics3DOp[] = [];\r\n\r\n /** Append one op, flagging (in development) inputs no renderer acts on. */\r\n private record(op: Graphics3DOp): void {\r\n inspectDrawable3D(op);\r\n this._ops.push(op);\r\n }\r\n\r\n // ─── Meshes ──────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record a mesh from an explicit geometry and material. The geometry sugar\r\n * methods below all funnel here.\r\n */\r\n mesh(\r\n geometry: Geometry3D,\r\n material?: Material3D | readonly Material3D[],\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"mesh\",\r\n geometry,\r\n material: material ?? { type: \"standard\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\r\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\r\n const source: MeshShorthand3D = options ?? {};\r\n return this.mesh(\r\n pickGeometry<Geometry3D>(source, type),\r\n resolveMaterialShorthand3D(source),\r\n pickTransform(source),\r\n );\r\n }\r\n\r\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"box\", options);\r\n }\r\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"sphere\", options);\r\n }\r\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"plane\", options);\r\n }\r\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cylinder\", options);\r\n }\r\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cone\", options);\r\n }\r\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torus\", options);\r\n }\r\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torusKnot\", options);\r\n }\r\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"circle\", options);\r\n }\r\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"ring\", options);\r\n }\r\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"capsule\", options);\r\n }\r\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"polyhedron\", options);\r\n }\r\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"extrude\", options);\r\n }\r\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"lathe\", options);\r\n }\r\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"tube\", options);\r\n }\r\n\r\n // ─── Other drawables ─────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record many copies of one geometry in a single draw call. The way to put\r\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\r\n *\r\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\r\n * positions.map(p => ({ position: p })))\r\n */\r\n instances(\r\n geometry: Geometry3D,\r\n material: Material3D,\r\n instances: readonly Transform3D[],\r\n options?: { colors?: readonly Color[]; transform?: Transform3D },\r\n ): this {\r\n this.record({\r\n kind: \"instances\",\r\n geometry,\r\n material,\r\n instances,\r\n colors: options?.colors,\r\n transform: options?.transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\r\n points(\r\n geometry: Geometry3D,\r\n material?: Material3D,\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"points\",\r\n geometry,\r\n material: material ?? { type: \"points\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a line. Give it either explicit `points` or a `geometry` (typically\r\n * `Geo.edges(...)` for a wireframe outline).\r\n *\r\n * `closed` joins the last point back to the first, as the 2D `line` op's\r\n * own field does. `segments` treats the points as disjoint start/end pairs\r\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\r\n * confuse it with: a line is drawn from the points it is given.)\r\n */\r\n line(options: {\r\n points?: readonly Vector3Input[];\r\n geometry?: Geometry3D;\r\n material?: Material3D;\r\n /** Join the last point back to the first. */\r\n closed?: boolean;\r\n /** Treat the points as disjoint start/end pairs. */\r\n segments?: boolean;\r\n /** The line's paint. Cap and join have no meaning on a GL line. */\r\n stroke?: LineStroke3D;\r\n opacity?: number;\r\n transform?: Transform3D;\r\n } & Transform3D): this {\r\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\r\n\r\n if (!points && !geometry) {\r\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\r\n }\r\n\r\n const resolved: Material3D = material ?? {\r\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\r\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\r\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\r\n ...(stroke?.dash !== undefined\r\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\r\n : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n\r\n this.record({\r\n kind: \"line\",\r\n geometry: geometry ?? { type: \"buffer\", position: flattenPoints(points!) },\r\n material: resolved,\r\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a camera-facing textured quad. */\r\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\r\n const { fill, material, opacity } = options;\r\n const paint = resolveFill3D(fill);\r\n const resolved: Material3D = material ?? {\r\n type: \"sprite\",\r\n ...(paint.map !== undefined ? { map: paint.map } : {}),\r\n ...(paint.color !== undefined ? { color: paint.color } : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n this.record({\r\n kind: \"sprite\",\r\n material: resolved,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\r\n * resolves to an empty slot and draws nothing, and in development the first\r\n * one recorded warns.\r\n *\r\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\r\n * a model stays frame-identical under scrubbing.\r\n */\r\n model(options: {\r\n src: string;\r\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\r\n override?: Readonly<Record<string, Material3D>>;\r\n } & Transform3D): this {\r\n const { src, animation, override } = options;\r\n this.record({\r\n kind: \"model\",\r\n src,\r\n animation: animation === undefined\r\n ? undefined\r\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\r\n override,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n // ─── Consumption ─────────────────────────────────────────────────────────\r\n\r\n /** The recorded ops, in order. Replayed by the renderer. */\r\n ops(): readonly Graphics3DOp[] {\r\n return this._ops;\r\n }\r\n\r\n /** True when this node draws nothing. */\r\n isEmpty(): boolean {\r\n return this._ops.length === 0;\r\n }\r\n}\r\n\r\n/**\r\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\r\n *\r\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\r\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\r\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\r\n * thick line, draw a `tube`.\r\n */\r\nexport interface LineStroke3D {\r\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\r\n fill?: Color;\r\n weight?: number;\r\n /** Dash and gap lengths, in world units. */\r\n dash?: readonly [number, number?];\r\n}\r\n\r\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\r\nfunction flattenPoints(points: readonly Vector3Input[]): number[] {\r\n const out: number[] = [];\r\n for (const point of points) {\r\n if (typeof point === \"number\") {\r\n out.push(point, point, point);\r\n } else if (Array.isArray(point)) {\r\n out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);\r\n }\r\n }\r\n return out;\r\n}\r\n"]}
@@ -46,7 +46,7 @@ export type Scene3DOp = {
46
46
  * .light({ type: "ambient", intensity: 0.4 })
47
47
  * .draw(new Graphics3D().box({ width: 2, fill: "tomato" }));
48
48
  *
49
- * <Text text="DEPTH" fontSize={320} fill={scene} />
49
+ * Text({ text: "DEPTH", fontSize: 320, fill: scene })
50
50
  *
51
51
  * A bare `Scene3D` coerces to a `canvas3D` fill the way a bare CSS string coerces
52
52
  * to a solid one, so `fill={scene}` and `fill={["#0b0d12", scene]}` both work.
@@ -19,7 +19,7 @@ import { warnInert3D } from "./inert.js";
19
19
  * .light({ type: "ambient", intensity: 0.4 })
20
20
  * .draw(new Graphics3D().box({ width: 2, fill: "tomato" }));
21
21
  *
22
- * <Text text="DEPTH" fontSize={320} fill={scene} />
22
+ * Text({ text: "DEPTH", fontSize: 320, fill: scene })
23
23
  *
24
24
  * A bare `Scene3D` coerces to a `canvas3D` fill the way a bare CSS string coerces
25
25
  * to a solid one, so `fill={scene}` and `fill={["#0b0d12", scene]}` both work.