@egret/engine 0.0.0-stage → 7.0.2

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 (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,119 @@
1
+ /** A point in 3D as x, y and z. */
2
+ export type Point3D = [number, number, number];
3
+ /** A point in 2D as x and y. */
4
+ export type Point2D = [number, number];
5
+ /** The most points and divisions a curve has. */
6
+ export declare const CURVE3D_LIMITS: Readonly<{
7
+ readonly maxPoints: 65536;
8
+ readonly maxDivisions: 16384;
9
+ }>;
10
+ /** Base for every curve: subclasses implement getPoint(t) for t in [0, 1]. */
11
+ export declare abstract class Curve3D {
12
+ #private;
13
+ /** Samples used to measure length and to map distance to parameter. */
14
+ arcLengthDivisions: number;
15
+ /** Position at parameter `t` in [0, 1]. The parameter need not advance at constant speed. */
16
+ abstract getPoint(t: number, out?: Point3D): Point3D;
17
+ /** Call after changing the curve's control points. */
18
+ invalidate(): void;
19
+ /** Cumulative chord lengths at each arc-length division. */
20
+ getLengths(): Float64Array;
21
+ getLength(): number;
22
+ /** Parameter t that lies the fraction `u` of the way along the curve by distance. */
23
+ parameterAt(u: number): number;
24
+ /** Position the fraction `u` of the way along the curve, at constant speed. */
25
+ getPointAt(u: number, out?: Point3D): Point3D;
26
+ /** Unit tangent at parameter `t`, by central difference. */
27
+ getTangent(t: number, out?: Point3D): Point3D;
28
+ getTangentAt(u: number, out?: Point3D): Point3D;
29
+ /** `divisions + 1` points at equal parameter steps. */
30
+ getPoints(divisions?: number): Point3D[];
31
+ /** `divisions + 1` points at equal distances. */
32
+ getSpacedPoints(divisions?: number): Point3D[];
33
+ /**
34
+ * Tangent, normal and binormal at `segments + 1` stations, transported
35
+ * along the curve without twisting. A closed curve's last frame is rotated
36
+ * to meet its first.
37
+ */
38
+ computeFrames(segments: number, closed?: boolean): {
39
+ tangents: Point3D[];
40
+ normals: Point3D[];
41
+ binormals: Point3D[];
42
+ };
43
+ }
44
+ /** A straight line between two points, as a curve. */
45
+ export declare class LineCurve3D extends Curve3D {
46
+ readonly start: Point3D;
47
+ readonly end: Point3D;
48
+ constructor(start: ArrayLike<number>, end: ArrayLike<number>);
49
+ getPoint(t: number, out?: Point3D): Point3D;
50
+ }
51
+ /** A quadratic Bézier curve through three control points. */
52
+ export declare class QuadraticBezierCurve3D extends Curve3D {
53
+ readonly p0: Point3D;
54
+ readonly p1: Point3D;
55
+ readonly p2: Point3D;
56
+ constructor(p0: ArrayLike<number>, p1: ArrayLike<number>, p2: ArrayLike<number>);
57
+ getPoint(t: number, out?: Point3D): Point3D;
58
+ }
59
+ /** A cubic Bézier curve through four control points. */
60
+ export declare class CubicBezierCurve3D extends Curve3D {
61
+ readonly p0: Point3D;
62
+ readonly p1: Point3D;
63
+ readonly p2: Point3D;
64
+ readonly p3: Point3D;
65
+ constructor(p0: ArrayLike<number>, p1: ArrayLike<number>, p2: ArrayLike<number>, p3: ArrayLike<number>);
66
+ getPoint(t: number, out?: Point3D): Point3D;
67
+ }
68
+ /** How a Catmull-Rom curve is parameterized between its points. */
69
+ export type CatmullRomKind3D = 'centripetal' | 'chordal' | 'uniform';
70
+ /** Smooth curve through every control point. Centripetal spacing avoids loops and cusps. */
71
+ export declare class CatmullRomCurve3D extends Curve3D {
72
+ readonly points: Point3D[];
73
+ closed: boolean;
74
+ kind: CatmullRomKind3D;
75
+ constructor(points: readonly ArrayLike<number>[], options?: {
76
+ readonly closed?: boolean;
77
+ readonly kind?: CatmullRomKind3D;
78
+ });
79
+ getPoint(t: number, out?: Point3D): Point3D;
80
+ }
81
+ /** Several curves joined end to end and traversed as one, by length. */
82
+ export declare class CurvePath3D extends Curve3D {
83
+ readonly curves: Curve3D[];
84
+ add(curve: Curve3D): this;
85
+ getPoint(t: number, out?: Point3D): Point3D;
86
+ }
87
+ /** A 2D outline built with pen commands; used as a contour or a hole. */
88
+ export declare class Path2D3D {
89
+ /** Flattened vertices in drawing order. */
90
+ readonly points: Point2D[];
91
+ /** Segments used for each curved command. */
92
+ curveSegments: number;
93
+ moveTo(x: number, y: number): this;
94
+ lineTo(x: number, y: number): this;
95
+ private last;
96
+ quadraticCurveTo(cx: number, cy: number, x: number, y: number): this;
97
+ bezierCurveTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): this;
98
+ /** Circular arc around (cx, cy); angles in radians, counter-clockwise unless `clockwise`. */
99
+ arc(cx: number, cy: number, radius: number, startAngle: number, endAngle: number, clockwise?: boolean): this;
100
+ /** Outline without a repeated closing vertex. */
101
+ contour(): Point2D[];
102
+ }
103
+ /** A filled outline with optional holes. */
104
+ export declare class Shape3D extends Path2D3D {
105
+ readonly holes: Path2D3D[];
106
+ constructor(points?: readonly (readonly [number, number])[]);
107
+ }
108
+ /** The signed area of a 2D polygon: positive when its points run counterclockwise. */
109
+ export declare function signedArea2D(points: readonly Point2D[]): number;
110
+ /**
111
+ * Triangulate an outline with holes by ear clipping. Returns the merged
112
+ * vertex list (outer contour counter-clockwise, then each hole) and triangle
113
+ * indices into it.
114
+ */
115
+ export declare function triangulateShape3D(contour: readonly Point2D[], holes?: readonly (readonly Point2D[])[]): {
116
+ vertices: Point2D[];
117
+ indices: number[];
118
+ };
119
+ //# sourceMappingURL=Curves3D.d.ts.map
@@ -0,0 +1,460 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Parametric curves in 3D and flat outlines in 2D. Curves answer positions
3
+ // and tangents by parameter or by distance travelled, and feed the tube,
4
+ // lathe, extrude and shape geometries. Points are plain [x, y, z] arrays.
5
+ import { World3DError, requireCount3D, requireFinite3D } from './core3D.js';
6
+ /** The most points and divisions a curve has. */
7
+ export const CURVE3D_LIMITS = Object.freeze({ maxPoints: 65536, maxDivisions: 16384 });
8
+ function point(value, field) {
9
+ if (!value || value.length < 3)
10
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
11
+ return [requireFinite3D(value[0], field), requireFinite3D(value[1], field), requireFinite3D(value[2], field)];
12
+ }
13
+ /** Base for every curve: subclasses implement getPoint(t) for t in [0, 1]. */
14
+ export class Curve3D {
15
+ /** Samples used to measure length and to map distance to parameter. */
16
+ arcLengthDivisions = 200;
17
+ #lengths;
18
+ /** Call after changing the curve's control points. */
19
+ invalidate() {
20
+ this.#lengths = undefined;
21
+ }
22
+ /** Cumulative chord lengths at each arc-length division. */
23
+ getLengths() {
24
+ const divisions = Math.max(1, Math.min(Math.floor(this.arcLengthDivisions), CURVE3D_LIMITS.maxDivisions));
25
+ if (this.#lengths && this.#lengths.length === divisions + 1)
26
+ return this.#lengths;
27
+ const lengths = new Float64Array(divisions + 1), previous = [0, 0, 0], current = [0, 0, 0];
28
+ this.getPoint(0, previous);
29
+ for (let i = 1; i <= divisions; i++) {
30
+ this.getPoint(i / divisions, current);
31
+ lengths[i] =
32
+ lengths[i - 1] + Math.hypot(current[0] - previous[0], current[1] - previous[1], current[2] - previous[2]);
33
+ previous[0] = current[0];
34
+ previous[1] = current[1];
35
+ previous[2] = current[2];
36
+ }
37
+ return (this.#lengths = lengths);
38
+ }
39
+ getLength() {
40
+ const lengths = this.getLengths();
41
+ return lengths[lengths.length - 1];
42
+ }
43
+ /** Parameter t that lies the fraction `u` of the way along the curve by distance. */
44
+ parameterAt(u) {
45
+ const lengths = this.getLengths(), last = lengths.length - 1, target = Math.min(Math.max(u, 0), 1) * lengths[last];
46
+ let low = 0, high = last;
47
+ while (low < high - 1) {
48
+ const middle = (low + high) >> 1;
49
+ if (lengths[middle] <= target)
50
+ low = middle;
51
+ else
52
+ high = middle;
53
+ }
54
+ const span = lengths[high] - lengths[low];
55
+ return (low + (span > 0 ? (target - lengths[low]) / span : 0)) / last;
56
+ }
57
+ /** Position the fraction `u` of the way along the curve, at constant speed. */
58
+ getPointAt(u, out) {
59
+ return this.getPoint(this.parameterAt(u), out);
60
+ }
61
+ /** Unit tangent at parameter `t`, by central difference. */
62
+ getTangent(t, out = [0, 0, 0]) {
63
+ const delta = 1e-4, a = this.getPoint(Math.max(t - delta, 0)), b = this.getPoint(Math.min(t + delta, 1));
64
+ const x = b[0] - a[0], y = b[1] - a[1], z = b[2] - a[2], length = Math.hypot(x, y, z) || 1;
65
+ out[0] = x / length;
66
+ out[1] = y / length;
67
+ out[2] = z / length;
68
+ return out;
69
+ }
70
+ getTangentAt(u, out) {
71
+ return this.getTangent(this.parameterAt(u), out);
72
+ }
73
+ /** `divisions + 1` points at equal parameter steps. */
74
+ getPoints(divisions = 32) {
75
+ const count = Math.max(1, requireCount3D(divisions, 'divisions', CURVE3D_LIMITS.maxDivisions)), points = [];
76
+ for (let i = 0; i <= count; i++)
77
+ points.push(this.getPoint(i / count));
78
+ return points;
79
+ }
80
+ /** `divisions + 1` points at equal distances. */
81
+ getSpacedPoints(divisions = 32) {
82
+ const count = Math.max(1, requireCount3D(divisions, 'divisions', CURVE3D_LIMITS.maxDivisions)), points = [];
83
+ for (let i = 0; i <= count; i++)
84
+ points.push(this.getPointAt(i / count));
85
+ return points;
86
+ }
87
+ /**
88
+ * Tangent, normal and binormal at `segments + 1` stations, transported
89
+ * along the curve without twisting. A closed curve's last frame is rotated
90
+ * to meet its first.
91
+ */
92
+ computeFrames(segments, closed = false) {
93
+ const count = Math.max(1, requireCount3D(segments, 'segments', CURVE3D_LIMITS.maxDivisions));
94
+ const tangents = [], normals = [], binormals = [];
95
+ for (let i = 0; i <= count; i++)
96
+ tangents.push(this.getTangentAt(i / count));
97
+ // Start with the world axis least aligned with the first tangent.
98
+ const t0 = tangents[0], ax = Math.abs(t0[0]), ay = Math.abs(t0[1]), az = Math.abs(t0[2]);
99
+ const seed = ax <= ay && ax <= az ? [1, 0, 0] : ay <= az ? [0, 1, 0] : [0, 0, 1];
100
+ const first = normalize(cross(cross(t0, seed), t0));
101
+ normals.push(first);
102
+ binormals.push(cross(t0, first));
103
+ for (let i = 1; i <= count; i++) {
104
+ const previous = tangents[i - 1], tangent = tangents[i], axis = cross(previous, tangent), length = Math.hypot(axis[0], axis[1], axis[2]);
105
+ let normal = normals[i - 1];
106
+ if (length > 1e-9) {
107
+ const angle = Math.acos(Math.min(Math.max(previous[0] * tangent[0] + previous[1] * tangent[1] + previous[2] * tangent[2], -1), 1));
108
+ normal = rotate(normal, [axis[0] / length, axis[1] / length, axis[2] / length], angle);
109
+ }
110
+ normals.push(normal);
111
+ binormals.push(cross(tangent, normal));
112
+ }
113
+ if (closed) {
114
+ // Spread the leftover twist evenly so the seam closes.
115
+ const a = normals[0], b = normals[count];
116
+ let twist = Math.acos(Math.min(Math.max(a[0] * b[0] + a[1] * b[1] + a[2] * b[2], -1), 1)) / count;
117
+ const side = cross(a, b);
118
+ if (tangents[0][0] * side[0] + tangents[0][1] * side[1] + tangents[0][2] * side[2] > 0)
119
+ twist = -twist;
120
+ for (let i = 1; i <= count; i++) {
121
+ normals[i] = rotate(normals[i], tangents[i], twist * i);
122
+ binormals[i] = cross(tangents[i], normals[i]);
123
+ }
124
+ }
125
+ return { tangents, normals, binormals };
126
+ }
127
+ }
128
+ function cross(a, b) {
129
+ return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
130
+ }
131
+ function normalize(a) {
132
+ const length = Math.hypot(a[0], a[1], a[2]) || 1;
133
+ return [a[0] / length, a[1] / length, a[2] / length];
134
+ }
135
+ /** Rotate `v` about a unit `axis` (Rodrigues). */
136
+ function rotate(v, axis, angle) {
137
+ const c = Math.cos(angle), s = Math.sin(angle), d = (axis[0] * v[0] + axis[1] * v[1] + axis[2] * v[2]) * (1 - c), k = cross(axis, v);
138
+ return [v[0] * c + k[0] * s + axis[0] * d, v[1] * c + k[1] * s + axis[1] * d, v[2] * c + k[2] * s + axis[2] * d];
139
+ }
140
+ /** A straight line between two points, as a curve. */
141
+ export class LineCurve3D extends Curve3D {
142
+ start;
143
+ end;
144
+ constructor(start, end) {
145
+ super();
146
+ this.start = point(start, 'start');
147
+ this.end = point(end, 'end');
148
+ }
149
+ getPoint(t, out = [0, 0, 0]) {
150
+ const a = this.start, b = this.end;
151
+ out[0] = a[0] + (b[0] - a[0]) * t;
152
+ out[1] = a[1] + (b[1] - a[1]) * t;
153
+ out[2] = a[2] + (b[2] - a[2]) * t;
154
+ return out;
155
+ }
156
+ }
157
+ /** A quadratic Bézier curve through three control points. */
158
+ export class QuadraticBezierCurve3D extends Curve3D {
159
+ p0;
160
+ p1;
161
+ p2;
162
+ constructor(p0, p1, p2) {
163
+ super();
164
+ this.p0 = point(p0, 'p0');
165
+ this.p1 = point(p1, 'p1');
166
+ this.p2 = point(p2, 'p2');
167
+ }
168
+ getPoint(t, out = [0, 0, 0]) {
169
+ const k = 1 - t, a = k * k, b = 2 * k * t, c = t * t;
170
+ for (let i = 0; i < 3; i++)
171
+ out[i] = a * this.p0[i] + b * this.p1[i] + c * this.p2[i];
172
+ return out;
173
+ }
174
+ }
175
+ /** A cubic Bézier curve through four control points. */
176
+ export class CubicBezierCurve3D extends Curve3D {
177
+ p0;
178
+ p1;
179
+ p2;
180
+ p3;
181
+ constructor(p0, p1, p2, p3) {
182
+ super();
183
+ this.p0 = point(p0, 'p0');
184
+ this.p1 = point(p1, 'p1');
185
+ this.p2 = point(p2, 'p2');
186
+ this.p3 = point(p3, 'p3');
187
+ }
188
+ getPoint(t, out = [0, 0, 0]) {
189
+ const k = 1 - t, a = k * k * k, b = 3 * k * k * t, c = 3 * k * t * t, d = t * t * t;
190
+ for (let i = 0; i < 3; i++)
191
+ out[i] = a * this.p0[i] + b * this.p1[i] + c * this.p2[i] + d * this.p3[i];
192
+ return out;
193
+ }
194
+ }
195
+ /** Smooth curve through every control point. Centripetal spacing avoids loops and cusps. */
196
+ export class CatmullRomCurve3D extends Curve3D {
197
+ points;
198
+ closed;
199
+ kind;
200
+ constructor(points, options = {}) {
201
+ super();
202
+ if (!Array.isArray(points) || points.length < 2 || points.length > CURVE3D_LIMITS.maxPoints)
203
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'curve points');
204
+ this.points = points.map(p => point(p, 'curve point'));
205
+ this.closed = options.closed ?? false;
206
+ this.kind = options.kind ?? 'centripetal';
207
+ }
208
+ getPoint(t, out = [0, 0, 0]) {
209
+ const points = this.points, count = points.length, scaled = Math.min(Math.max(t, 0), 1) * (this.closed ? count : count - 1);
210
+ let index = Math.floor(scaled), weight = scaled - index;
211
+ if (!this.closed && index >= count - 1) {
212
+ index = count - 2;
213
+ weight = 1;
214
+ }
215
+ const at = (i) => {
216
+ if (this.closed)
217
+ return points[((i % count) + count) % count];
218
+ if (i < 0) {
219
+ const a = points[0], b = points[1];
220
+ return [2 * a[0] - b[0], 2 * a[1] - b[1], 2 * a[2] - b[2]];
221
+ } // mirrored end
222
+ if (i >= count) {
223
+ const a = points[count - 1], b = points[count - 2];
224
+ return [2 * a[0] - b[0], 2 * a[1] - b[1], 2 * a[2] - b[2]];
225
+ }
226
+ return points[i];
227
+ };
228
+ const p0 = at(index - 1), p1 = at(index), p2 = at(index + 1), p3 = at(index + 2);
229
+ const power = this.kind === 'uniform' ? 0 : this.kind === 'chordal' ? 0.5 : 0.25;
230
+ let dt0 = Math.pow((p1[0] - p0[0]) ** 2 + (p1[1] - p0[1]) ** 2 + (p1[2] - p0[2]) ** 2, power);
231
+ let dt1 = Math.pow((p2[0] - p1[0]) ** 2 + (p2[1] - p1[1]) ** 2 + (p2[2] - p1[2]) ** 2, power);
232
+ let dt2 = Math.pow((p3[0] - p2[0]) ** 2 + (p3[1] - p2[1]) ** 2 + (p3[2] - p2[2]) ** 2, power);
233
+ // Repeated points give zero intervals; fall back to the neighbouring one.
234
+ if (dt1 < 1e-6)
235
+ dt1 = 1;
236
+ if (dt0 < 1e-6)
237
+ dt0 = dt1;
238
+ if (dt2 < 1e-6)
239
+ dt2 = dt1;
240
+ for (let i = 0; i < 3; i++) {
241
+ const x0 = p0[i], x1 = p1[i], x2 = p2[i], x3 = p3[i];
242
+ const t1 = ((x1 - x0) / dt0 - (x2 - x0) / (dt0 + dt1) + (x2 - x1) / dt1) * dt1, t2 = ((x2 - x1) / dt1 - (x3 - x1) / (dt1 + dt2) + (x3 - x2) / dt2) * dt1;
243
+ const c2 = -3 * x1 + 3 * x2 - 2 * t1 - t2, c3 = 2 * x1 - 2 * x2 + t1 + t2;
244
+ out[i] = x1 + t1 * weight + c2 * weight * weight + c3 * weight * weight * weight;
245
+ }
246
+ return out;
247
+ }
248
+ }
249
+ /** Several curves joined end to end and traversed as one, by length. */
250
+ export class CurvePath3D extends Curve3D {
251
+ curves = [];
252
+ add(curve) {
253
+ this.curves.push(curve);
254
+ this.invalidate();
255
+ return this;
256
+ }
257
+ getPoint(t, out = [0, 0, 0]) {
258
+ const curves = this.curves;
259
+ if (curves.length === 0)
260
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'empty curve path');
261
+ let total = 0;
262
+ for (const curve of curves)
263
+ total += curve.getLength();
264
+ let target = Math.min(Math.max(t, 0), 1) * total;
265
+ for (let i = 0; i < curves.length; i++) {
266
+ const length = curves[i].getLength();
267
+ if (target <= length || i === curves.length - 1)
268
+ return curves[i].getPointAt(length > 0 ? Math.min(target / length, 1) : 0, out);
269
+ target -= length;
270
+ }
271
+ return out;
272
+ }
273
+ }
274
+ // ---- flat outlines ----------------------------------------------------------------
275
+ /** A 2D outline built with pen commands; used as a contour or a hole. */
276
+ export class Path2D3D {
277
+ /** Flattened vertices in drawing order. */
278
+ points = [];
279
+ /** Segments used for each curved command. */
280
+ curveSegments = 12;
281
+ moveTo(x, y) {
282
+ this.points.push([requireFinite3D(x, 'x'), requireFinite3D(y, 'y')]);
283
+ return this;
284
+ }
285
+ lineTo(x, y) {
286
+ return this.moveTo(x, y);
287
+ }
288
+ last() {
289
+ const last = this.points[this.points.length - 1];
290
+ if (!last)
291
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'path needs moveTo first');
292
+ return last;
293
+ }
294
+ quadraticCurveTo(cx, cy, x, y) {
295
+ const [x0, y0] = this.last(), n = this.curveSegments;
296
+ for (let i = 1; i <= n; i++) {
297
+ const t = i / n, k = 1 - t;
298
+ this.points.push([k * k * x0 + 2 * k * t * cx + t * t * x, k * k * y0 + 2 * k * t * cy + t * t * y]);
299
+ }
300
+ return this;
301
+ }
302
+ bezierCurveTo(c1x, c1y, c2x, c2y, x, y) {
303
+ const [x0, y0] = this.last(), n = this.curveSegments;
304
+ for (let i = 1; i <= n; i++) {
305
+ const t = i / n, k = 1 - t, a = k * k * k, b = 3 * k * k * t, c = 3 * k * t * t, d = t * t * t;
306
+ this.points.push([a * x0 + b * c1x + c * c2x + d * x, a * y0 + b * c1y + c * c2y + d * y]);
307
+ }
308
+ return this;
309
+ }
310
+ /** Circular arc around (cx, cy); angles in radians, counter-clockwise unless `clockwise`. */
311
+ arc(cx, cy, radius, startAngle, endAngle, clockwise = false) {
312
+ let sweep = endAngle - startAngle;
313
+ if (clockwise && sweep > 0)
314
+ sweep -= Math.PI * 2;
315
+ else if (!clockwise && sweep < 0)
316
+ sweep += Math.PI * 2;
317
+ const n = Math.max(2, Math.ceil((Math.abs(sweep) / (Math.PI * 2)) * this.curveSegments * 4));
318
+ for (let i = 0; i <= n; i++) {
319
+ const angle = startAngle + (sweep * i) / n;
320
+ this.points.push([cx + Math.cos(angle) * radius, cy + Math.sin(angle) * radius]);
321
+ }
322
+ return this;
323
+ }
324
+ /** Outline without a repeated closing vertex. */
325
+ contour() {
326
+ const points = this.points.slice(), first = points[0], last = points[points.length - 1];
327
+ if (points.length > 1 &&
328
+ first &&
329
+ last &&
330
+ Math.abs(first[0] - last[0]) < 1e-9 &&
331
+ Math.abs(first[1] - last[1]) < 1e-9)
332
+ points.pop();
333
+ if (points.length < 3)
334
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'outline needs three points');
335
+ return points;
336
+ }
337
+ }
338
+ /** A filled outline with optional holes. */
339
+ export class Shape3D extends Path2D3D {
340
+ holes = [];
341
+ constructor(points) {
342
+ super();
343
+ if (points)
344
+ for (const p of points)
345
+ this.moveTo(p[0], p[1]);
346
+ }
347
+ }
348
+ /** The signed area of a 2D polygon: positive when its points run counterclockwise. */
349
+ export function signedArea2D(points) {
350
+ let area = 0;
351
+ for (let i = 0, j = points.length - 1; i < points.length; j = i++)
352
+ area += points[j][0] * points[i][1] - points[i][0] * points[j][1];
353
+ return area / 2;
354
+ }
355
+ /**
356
+ * Triangulate an outline with holes by ear clipping. Returns the merged
357
+ * vertex list (outer contour counter-clockwise, then each hole) and triangle
358
+ * indices into it.
359
+ */
360
+ export function triangulateShape3D(contour, holes = []) {
361
+ const outer = contour.slice();
362
+ if (signedArea2D(outer) < 0)
363
+ outer.reverse();
364
+ const vertices = outer.slice();
365
+ // Working polygon as indices into `vertices`; holes are spliced in through bridges.
366
+ let ring = outer.map((_, i) => i);
367
+ const prepared = holes
368
+ .map(hole => {
369
+ const copy = hole.slice();
370
+ if (signedArea2D(copy) > 0)
371
+ copy.reverse();
372
+ return copy;
373
+ })
374
+ .sort((a, b) => Math.max(...b.map(p => p[0])) - Math.max(...a.map(p => p[0])));
375
+ for (const hole of prepared) {
376
+ const base = vertices.length;
377
+ vertices.push(...hole);
378
+ // Bridge from the hole's rightmost vertex to a visible ring vertex.
379
+ let holeIndex = 0;
380
+ for (let i = 1; i < hole.length; i++)
381
+ if (hole[i][0] > hole[holeIndex][0])
382
+ holeIndex = i;
383
+ const h = hole[holeIndex];
384
+ let best = -1, bestDistance = Infinity;
385
+ for (let i = 0; i < ring.length; i++) {
386
+ const candidate = vertices[ring[i]], distance = (candidate[0] - h[0]) ** 2 + (candidate[1] - h[1]) ** 2;
387
+ if (distance >= bestDistance)
388
+ continue;
389
+ let blocked = false;
390
+ for (let j = 0; j < ring.length && !blocked; j++) {
391
+ const a = ring[j], b = ring[(j + 1) % ring.length];
392
+ if (a === ring[i] || b === ring[i])
393
+ continue;
394
+ blocked = segmentsCross(h, candidate, vertices[a], vertices[b]);
395
+ }
396
+ for (let j = 0; j < hole.length && !blocked; j++) {
397
+ const a = j, b = (j + 1) % hole.length;
398
+ if (a === holeIndex || b === holeIndex)
399
+ continue;
400
+ blocked = segmentsCross(h, candidate, hole[a], hole[b]);
401
+ }
402
+ if (!blocked) {
403
+ best = i;
404
+ bestDistance = distance;
405
+ }
406
+ }
407
+ if (best < 0)
408
+ best = 0;
409
+ const loop = [];
410
+ for (let i = 0; i <= hole.length; i++)
411
+ loop.push(base + ((holeIndex + i) % hole.length));
412
+ ring = [...ring.slice(0, best + 1), ...loop, ring[best], ...ring.slice(best + 1)];
413
+ }
414
+ const indices = [];
415
+ let guard = ring.length * ring.length + 16;
416
+ while (ring.length > 3 && guard-- > 0) {
417
+ let clipped = false;
418
+ for (let i = 0; i < ring.length; i++) {
419
+ const ia = ring[(i + ring.length - 1) % ring.length], ib = ring[i], ic = ring[(i + 1) % ring.length];
420
+ const a = vertices[ia], b = vertices[ib], c = vertices[ic];
421
+ if ((b[0] - a[0]) * (c[1] - a[1]) - (b[1] - a[1]) * (c[0] - a[0]) <= 1e-12)
422
+ continue; // reflex or flat corner
423
+ let empty = true;
424
+ for (const other of ring) {
425
+ if (other === ia || other === ib || other === ic)
426
+ continue;
427
+ const p = vertices[other];
428
+ // Bridge duplicates share coordinates with a corner; they are not inside.
429
+ if ((p[0] === a[0] && p[1] === a[1]) || (p[0] === b[0] && p[1] === b[1]) || (p[0] === c[0] && p[1] === c[1]))
430
+ continue;
431
+ if (insideTriangle(p, a, b, c)) {
432
+ empty = false;
433
+ break;
434
+ }
435
+ }
436
+ if (!empty)
437
+ continue;
438
+ indices.push(ia, ib, ic);
439
+ ring.splice(i, 1);
440
+ clipped = true;
441
+ break;
442
+ }
443
+ if (!clipped)
444
+ break; // Degenerate input: stop instead of looping forever.
445
+ }
446
+ if (ring.length === 3)
447
+ indices.push(ring[0], ring[1], ring[2]);
448
+ return { vertices, indices };
449
+ }
450
+ function insideTriangle(p, a, b, c) {
451
+ const d1 = (p[0] - b[0]) * (a[1] - b[1]) - (a[0] - b[0]) * (p[1] - b[1]), d2 = (p[0] - c[0]) * (b[1] - c[1]) - (b[0] - c[0]) * (p[1] - c[1]);
452
+ const d3 = (p[0] - a[0]) * (c[1] - a[1]) - (c[0] - a[0]) * (p[1] - a[1]);
453
+ return !((d1 < 0 || d2 < 0 || d3 < 0) && (d1 > 0 || d2 > 0 || d3 > 0));
454
+ }
455
+ function segmentsCross(p1, p2, p3, p4) {
456
+ const d = (a, b, c) => (b[0] - a[0]) * (c[1] - a[1]) - (b[1] - a[1]) * (c[0] - a[0]);
457
+ const d1 = d(p3, p4, p1), d2 = d(p3, p4, p2), d3 = d(p1, p2, p3), d4 = d(p1, p2, p4);
458
+ return ((d1 > 0 && d2 < 0) || (d1 < 0 && d2 > 0)) && ((d3 > 0 && d4 < 0) || (d3 < 0 && d4 > 0));
459
+ }
460
+ //# sourceMappingURL=Curves3D.js.map
@@ -0,0 +1,43 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import type { Material3D } from './Material3D.js';
3
+ import { Mesh3D } from './Mesh3D.js';
4
+ /** The most triangles a decal has. */
5
+ export declare const DECAL3D_LIMITS: Readonly<{
6
+ readonly maxTriangles: 262144;
7
+ }>;
8
+ /** A decal to make: where it goes and which way it faces, its size and depth, its rotation, and the steepest surface it covers. */
9
+ export interface DecalOptions3D {
10
+ /** Center of the decal on the surface, in world space. */
11
+ readonly position: ArrayLike<number>;
12
+ /** Direction the decal faces, away from the surface, in world space: usually the hit normal. */
13
+ readonly normal: ArrayLike<number>;
14
+ /** Width and height on the surface and the depth of the box around it. Defaults: 1, 1 and half the larger of the two. */
15
+ readonly width?: number;
16
+ readonly height?: number;
17
+ readonly depth?: number;
18
+ /** Turn about the normal, in radians. */
19
+ readonly rotation?: number;
20
+ /** Which way is up for the decal when the surface leaves a choice. Default +Y, or +Z on a floor. */
21
+ readonly up?: ArrayLike<number>;
22
+ /** Faces turned further than this from the decal's direction are left out, in radians. Default about 80 degrees. */
23
+ readonly maxAngle?: number;
24
+ /** Lift off the surface along each vertex normal, against flicker. Default 0.002. */
25
+ readonly offset?: number;
26
+ }
27
+ /**
28
+ * Cut the part of a mesh's surface that lies inside the decal box. The
29
+ * result is in the mesh's local space, with coordinates running 0 to 1 across
30
+ * the box, or undefined when nothing is inside. A skinned mesh is cut in its
31
+ * bind pose, where `position` and `normal` must lie too, and the result keeps
32
+ * joints and weights so it can follow the same skeleton. Interpolated weights
33
+ * approximate the posed surface where the source vertices have different weights.
34
+ */
35
+ export declare function createDecalGeometry3D(mesh: Mesh3D, options: DecalOptions3D): Geometry3D | undefined;
36
+ /**
37
+ * A decal mesh on a target mesh, added as its child so it moves with it.
38
+ * The material is used as given except that it stops writing depth and gains a
39
+ * depth offset when it has none. On a skinned mesh the decal follows the
40
+ * skeleton. Returns undefined when the box misses the surface.
41
+ */
42
+ export declare function createDecal3D(mesh: Mesh3D, material: Material3D, options: DecalOptions3D): Mesh3D | undefined;
43
+ //# sourceMappingURL=Decal3D.d.ts.map