@automovie/engine 0.1.0 → 0.2.0

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 (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -1,18 +1,20 @@
1
1
  import { IAutoMovieProjectile } from "./IAutoMovieProjectile";
2
2
  import { IAutoMovieProjectileState } from "./IAutoMovieProjectileState";
3
3
  /**
4
- * Evaluate a {@link IAutoMovieProjectile} at time `t` seconds (closed form, no
5
- * integration error): `p = origin + v·t + ½·g·t²`, `v(t) = v + g·t`. The
6
- * velocity also gives the flight direction, so a renderer can orient the arrow
7
- * along its arc (e.g. via `aimRotation`).
4
+ * Evaluate a {@link IAutoMovieProjectile} at time `t` seconds. Without drag,
5
+ * the closed form with no integration error: `p = origin + v·t + ½·g·t²`,
6
+ * `v(t) = v + g·t`. With drag, the integrated flight of
7
+ * {@link projectileDragFlight}, which holds the launch state before `t = 0`.
8
+ * With an attitude, the state also carries the body's rotation: the model's
9
+ * `+Z` turned onto the velocity, the launch rotation turned about the spin
10
+ * axis by the rate times `t`, or the launch rotation kept.
8
11
  *
9
- *
10
- * @evidence contracts/development/implementation.md#principled-implementation Evaluate p0+v0*t+g*t^2/2 and v0+g*t for constant world acceleration. Inputs and time must be finite; finite arithmetic can still overflow, and negative finite time evaluates the same equations backwards.
11
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One analytic state evaluation is shared by launch and trajectory callers, avoiding an integration state machine.
12
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Gravity and launch vectors are caller inputs rather than actor-specific constants; invalid components throw instead of returning a fabricated state.
13
- * @evidence contracts/development/common.md#meaningful-documentation Docs give metre, second and metre-per-second-squared units, fresh vectors, finite admission and constant-acceleration scope.
14
- * @evidence contracts/development/implementation.md#efficient-algorithms A fixed number of vector scalar operations gives O(1) time and two output vectors per instant.
15
- * @evidence contracts/development/implementation.md#reuse-equivalent-work Trajectory and collision sampling reuse this equation owner, not results across mutable projectile/time pairs.
16
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Each state transfers to the caller; the launch record is borrowed and no integration history or resource is retained.
12
+ * @evidence contracts/development/implementation.md#principled-implementation Evaluate p0+v0*t+g*t^2/2 and v0+g*t for constant world acceleration, or read the quadratic-drag flight integrated by the engine's one integrator; a spin is the launch rotation composed with the rotation about the body axis by rate*t. Inputs and time must be finite; finite arithmetic can still overflow, and negative finite time evaluates the closed form backwards.
13
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch on drag for the centre and one on the attitude's kind for the rotation; the integration lives in its own owner.
14
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Gravity, launch, drag and spin are caller inputs rather than actor-specific constants; invalid components throw instead of returning a fabricated state. Without drag and attitude the record returned is the one this function always returned, bit for bit.
15
+ * @evidence contracts/development/common.md#meaningful-documentation Docs give metre, second and metre-per-second-squared units, the drag branch, the attitudes, fresh vectors and finite admission.
16
+ * @evidence contracts/development/implementation.md#efficient-algorithms A fixed number of vector operations per instant without drag; with drag, a memoised flight's chunk lookup and Hermite read.
17
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A drag flight is integrated once per projectile record by its owner and read by every call.
18
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Each state transfers to the caller; the drag flight is held weakly by its record.
17
19
  */
18
20
  export declare const projectileAt: (p: IAutoMovieProjectile, t: number) => IAutoMovieProjectileState;
@@ -1,27 +1,36 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.projectileAt = void 0;
4
+ const aimRotation_1 = require("../kinematics/aimRotation");
5
+ const Quaternion_1 = require("../math/Quaternion");
4
6
  const Vector3_1 = require("../math/Vector3");
7
+ const projectileDragFlight_1 = require("./projectileDragFlight");
5
8
  const VECTOR_AXES = ["x", "y", "z"];
9
+ /** A projectile model faces +Z; a velocity attitude turns that onto the flight. */
10
+ const FORWARD = { x: 0, y: 0, z: 1 };
11
+ /** The identity rotation, a launch rotation left unstated. */
12
+ const IDENTITY = { x: 0, y: 0, z: 0, w: 1 };
6
13
  const assertFiniteVector = (name, vector) => {
7
14
  for (const axis of VECTOR_AXES)
8
15
  if (!Number.isFinite(vector[axis]))
9
16
  throw new RangeError(`projectile ${name}.${axis} must be finite, but was ${vector[axis]}`);
10
17
  };
11
18
  /**
12
- * Evaluate a {@link IAutoMovieProjectile} at time `t` seconds (closed form, no
13
- * integration error): `p = origin + v·t + ½·g·t²`, `v(t) = v + g·t`. The
14
- * velocity also gives the flight direction, so a renderer can orient the arrow
15
- * along its arc (e.g. via `aimRotation`).
19
+ * Evaluate a {@link IAutoMovieProjectile} at time `t` seconds. Without drag,
20
+ * the closed form with no integration error: `p = origin + v·t + ½·g·t²`,
21
+ * `v(t) = v + g·t`. With drag, the integrated flight of
22
+ * {@link projectileDragFlight}, which holds the launch state before `t = 0`.
23
+ * With an attitude, the state also carries the body's rotation: the model's
24
+ * `+Z` turned onto the velocity, the launch rotation turned about the spin
25
+ * axis by the rate times `t`, or the launch rotation kept.
16
26
  *
17
- *
18
- * @evidence contracts/development/implementation.md#principled-implementation Evaluate p0+v0*t+g*t^2/2 and v0+g*t for constant world acceleration. Inputs and time must be finite; finite arithmetic can still overflow, and negative finite time evaluates the same equations backwards.
19
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One analytic state evaluation is shared by launch and trajectory callers, avoiding an integration state machine.
20
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Gravity and launch vectors are caller inputs rather than actor-specific constants; invalid components throw instead of returning a fabricated state.
21
- * @evidence contracts/development/common.md#meaningful-documentation Docs give metre, second and metre-per-second-squared units, fresh vectors, finite admission and constant-acceleration scope.
22
- * @evidence contracts/development/implementation.md#efficient-algorithms A fixed number of vector scalar operations gives O(1) time and two output vectors per instant.
23
- * @evidence contracts/development/implementation.md#reuse-equivalent-work Trajectory and collision sampling reuse this equation owner, not results across mutable projectile/time pairs.
24
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Each state transfers to the caller; the launch record is borrowed and no integration history or resource is retained.
27
+ * @evidence contracts/development/implementation.md#principled-implementation Evaluate p0+v0*t+g*t^2/2 and v0+g*t for constant world acceleration, or read the quadratic-drag flight integrated by the engine's one integrator; a spin is the launch rotation composed with the rotation about the body axis by rate*t. Inputs and time must be finite; finite arithmetic can still overflow, and negative finite time evaluates the closed form backwards.
28
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch on drag for the centre and one on the attitude's kind for the rotation; the integration lives in its own owner.
29
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Gravity, launch, drag and spin are caller inputs rather than actor-specific constants; invalid components throw instead of returning a fabricated state. Without drag and attitude the record returned is the one this function always returned, bit for bit.
30
+ * @evidence contracts/development/common.md#meaningful-documentation Docs give metre, second and metre-per-second-squared units, the drag branch, the attitudes, fresh vectors and finite admission.
31
+ * @evidence contracts/development/implementation.md#efficient-algorithms A fixed number of vector operations per instant without drag; with drag, a memoised flight's chunk lookup and Hermite read.
32
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A drag flight is integrated once per projectile record by its owner and read by every call.
33
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Each state transfers to the caller; the drag flight is held weakly by its record.
25
34
  */
26
35
  const projectileAt = (p, t) => {
27
36
  if (!Number.isFinite(t))
@@ -29,10 +38,31 @@ const projectileAt = (p, t) => {
29
38
  assertFiniteVector("origin", p.origin);
30
39
  assertFiniteVector("velocity", p.velocity);
31
40
  assertFiniteVector("gravity", p.gravity);
32
- return {
33
- position: Vector3_1.Vector3.add(Vector3_1.Vector3.add(p.origin, Vector3_1.Vector3.scale(p.velocity, t)), Vector3_1.Vector3.scale(p.gravity, 0.5 * t * t)),
34
- velocity: Vector3_1.Vector3.add(p.velocity, Vector3_1.Vector3.scale(p.gravity, t)),
35
- };
41
+ const state = p.drag === undefined
42
+ ? {
43
+ position: Vector3_1.Vector3.add(Vector3_1.Vector3.add(p.origin, Vector3_1.Vector3.scale(p.velocity, t)), Vector3_1.Vector3.scale(p.gravity, 0.5 * t * t)),
44
+ velocity: Vector3_1.Vector3.add(p.velocity, Vector3_1.Vector3.scale(p.gravity, t)),
45
+ }
46
+ : (0, projectileDragFlight_1.projectileDragFlight)(p).at(t);
47
+ if (p.attitude === undefined)
48
+ return state;
49
+ switch (p.attitude.kind) {
50
+ case "velocity":
51
+ return {
52
+ ...state,
53
+ rotation: Vector3_1.Vector3.length(state.velocity) > 0
54
+ ? (0, aimRotation_1.aimRotation)(FORWARD, state.velocity)
55
+ : IDENTITY,
56
+ };
57
+ case "spin":
58
+ assertFiniteVector("attitude axis", p.attitude.axis);
59
+ return {
60
+ ...state,
61
+ rotation: Quaternion_1.Quaternion.normalize(Quaternion_1.Quaternion.multiply(p.attitude.rotation ?? IDENTITY, Quaternion_1.Quaternion.fromAxisAngle(p.attitude.axis, p.attitude.rate * t))),
62
+ };
63
+ case "fixed":
64
+ return { ...state, rotation: p.attitude.rotation ?? IDENTITY };
65
+ }
36
66
  };
37
67
  exports.projectileAt = projectileAt;
38
68
  //# sourceMappingURL=projectileAt.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"projectileAt.js","sourceRoot":"","sources":["../../src/physics/projectileAt.ts"],"names":[],"mappings":";;;AAEA,6CAA0C;AAI1C,MAAM,WAAW,GAA6B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEvE,MAAM,kBAAkB,GAAsD,CAC5E,IAAY,EACZ,MAAyB,EACnB,EAAE;IACR,KAAK,MAAM,IAAI,IAAI,WAAW;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,IAAI,UAAU,CAClB,cAAc,IAAI,IAAI,IAAI,4BAA4B,MAAM,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;AACR,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACI,MAAM,YAAY,GAGQ,CAC/B,CAAuB,EACvB,CAAS,EACkB,EAAE;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrB,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,EAAE,CAAC,CAAC;IACvE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,kBAAkB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,QAAQ,EAAE,iBAAO,CAAC,GAAG,CACnB,iBAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,iBAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EACnD,iBAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CACtC;QACD,QAAQ,EAAE,iBAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,iBAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;KAC/D,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,YAAY,GAAZ,YAAY,CAoBvB"}
1
+ {"version":3,"file":"projectileAt.js","sourceRoot":"","sources":["../../src/physics/projectileAt.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import type { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
+ import type { IAutoMovieHit } from "./IAutoMovieHit";
3
+ import type { IAutoMovieProjectile } from "./IAutoMovieProjectile";
4
+ import type { IAutoMovieProjectileState } from "./IAutoMovieProjectileState";
5
+ /**
6
+ * What a projectile does after a contact, by the outcome the caller decided:
7
+ *
8
+ * - `stick`: it stops at the contact, its point carried `depth` on along its
9
+ * velocity into the struck body, and rests there;
10
+ * - `bounce`: it leaves on a new flight from the contact, its velocity's
11
+ * normal part reversed and scaled by the restitution and its tangential
12
+ * part reduced by Coulomb friction's impulse, `min(mu (1 + e) |v_n|,
13
+ * |v_t|)` (the rigid-body impact model of Brach, Mechanical Impact
14
+ * Dynamics, 1991, ch. 4); when `roll` is given and the rebound would rise
15
+ * less than the body's radius above the surface, it rolls instead;
16
+ * - `roll`: it rolls along the surface with its velocity's tangential part,
17
+ * slowed at the rolling-resistance coefficient times the gravity pressing
18
+ * it on the surface, `a = c |g_n|`, to rest at `v^2 / (2 a)`;
19
+ * - `pass`: it continues through on the same flight, losing a share of its
20
+ * speed.
21
+ *
22
+ * Every coefficient is the caller's: the engine names no projectile. The
23
+ * gravity's pull along a tilted surface is not modelled in a roll, so a roll
24
+ * on a slope keeps the deceleration of a level one (stated, not hidden).
25
+ *
26
+ * @param projectile The flight that made contact.
27
+ * @param hit Its contact, with the surface's normal.
28
+ * @param outcome What happens.
29
+ * @returns The segment that follows, timed from the original flight's launch.
30
+ * @throws {RangeError} When the hit has no normal, or a coefficient is negative or not finite.
31
+ *
32
+ * @evidence contracts/development/common.md#meaningful-documentation States every outcome's law, its source and the slope it does not model.
33
+ * @evidence contracts/development/implementation.md#principled-implementation Newton's restitution on the normal part and Coulomb's impulse limit on the tangential part; constant deceleration for a roll.
34
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Read the state at contact, split the velocity on the normal, one branch per outcome.
35
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Coefficients are inputs; a rebound below the radius becomes a roll only when the caller gives one.
36
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant work per contact.
37
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A new flight is a projectile record read by `projectileAt` like the first.
38
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
39
+ */
40
+ export declare function projectileContinue(projectile: IAutoMovieProjectile, hit: IAutoMovieHit, outcome: projectileContinue.Outcome): projectileContinue.Segment;
41
+ /**
42
+ * Companion types and the roll's reader of {@link projectileContinue}.
43
+ *
44
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and time base.
45
+ * @evidence contracts/development/design.md#principled-representation A closed union of four outcomes and of three segments: a new flight, a roll and a rest.
46
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What a caller decides and what it reads back.
47
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Every coefficient is the caller's.
48
+ */
49
+ export declare namespace projectileContinue {
50
+ /** What happens at a contact. */
51
+ type Outcome = {
52
+ /** It stops in the struck body. */
53
+ kind: "stick";
54
+ /** How far its point goes on into the body, metres. */
55
+ depth: number;
56
+ } | {
57
+ /** It rebounds. */
58
+ kind: "bounce";
59
+ /** Newton's coefficient of restitution of the normal speed, 0 to 1. */
60
+ restitution: number;
61
+ /** Coulomb's friction coefficient of the contact. */
62
+ friction: number;
63
+ /** Roll instead once a rebound rises less than `radius`, at the rolling resistance `resistance`. */
64
+ roll?: {
65
+ radius: number;
66
+ resistance: number;
67
+ };
68
+ } | {
69
+ /** It rolls on the surface. */
70
+ kind: "roll";
71
+ /** The rolling-resistance coefficient, dimensionless. */
72
+ resistance: number;
73
+ } | {
74
+ /** It passes through. */
75
+ kind: "pass";
76
+ /** The share of its speed it loses, 0 to 1. */
77
+ loss: number;
78
+ };
79
+ /** What follows a contact; every `from` is seconds since the original launch. */
80
+ type Segment = {
81
+ /** A new flight, whose own time zero is `from`. */
82
+ kind: "flight";
83
+ from: number;
84
+ projectile: IAutoMovieProjectile;
85
+ } | {
86
+ /** A roll from `origin` until `until`, then at rest. */
87
+ kind: "roll";
88
+ from: number;
89
+ origin: IAutoMovieVector3;
90
+ /** Velocity at the roll's start, m/s, along the surface. */
91
+ velocity: IAutoMovieVector3;
92
+ /** Deceleration, m/s². */
93
+ deceleration: number;
94
+ /** Seconds since the launch it comes to rest; Infinity on a frictionless roll. */
95
+ until: number;
96
+ rotation?: IAutoMovieQuaternion;
97
+ } | {
98
+ /** At rest. */
99
+ kind: "rest";
100
+ from: number;
101
+ position: IAutoMovieVector3;
102
+ rotation?: IAutoMovieQuaternion;
103
+ };
104
+ /**
105
+ * A segment's centre and velocity at a second since the original launch:
106
+ * a flight read from its own time zero, a roll's constant deceleration to
107
+ * rest, a rest's place.
108
+ *
109
+ * @param segment The segment.
110
+ * @param seconds Seconds since the original launch, at or after `from`.
111
+ * @returns The state.
112
+ */
113
+ function at(segment: Segment, seconds: number): IAutoMovieProjectileState;
114
+ }
@@ -0,0 +1,189 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.projectileContinue = projectileContinue;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ const projectileAt_1 = require("./projectileAt");
6
+ /**
7
+ * What a projectile does after a contact, by the outcome the caller decided:
8
+ *
9
+ * - `stick`: it stops at the contact, its point carried `depth` on along its
10
+ * velocity into the struck body, and rests there;
11
+ * - `bounce`: it leaves on a new flight from the contact, its velocity's
12
+ * normal part reversed and scaled by the restitution and its tangential
13
+ * part reduced by Coulomb friction's impulse, `min(mu (1 + e) |v_n|,
14
+ * |v_t|)` (the rigid-body impact model of Brach, Mechanical Impact
15
+ * Dynamics, 1991, ch. 4); when `roll` is given and the rebound would rise
16
+ * less than the body's radius above the surface, it rolls instead;
17
+ * - `roll`: it rolls along the surface with its velocity's tangential part,
18
+ * slowed at the rolling-resistance coefficient times the gravity pressing
19
+ * it on the surface, `a = c |g_n|`, to rest at `v^2 / (2 a)`;
20
+ * - `pass`: it continues through on the same flight, losing a share of its
21
+ * speed.
22
+ *
23
+ * Every coefficient is the caller's: the engine names no projectile. The
24
+ * gravity's pull along a tilted surface is not modelled in a roll, so a roll
25
+ * on a slope keeps the deceleration of a level one (stated, not hidden).
26
+ *
27
+ * @param projectile The flight that made contact.
28
+ * @param hit Its contact, with the surface's normal.
29
+ * @param outcome What happens.
30
+ * @returns The segment that follows, timed from the original flight's launch.
31
+ * @throws {RangeError} When the hit has no normal, or a coefficient is negative or not finite.
32
+ *
33
+ * @evidence contracts/development/common.md#meaningful-documentation States every outcome's law, its source and the slope it does not model.
34
+ * @evidence contracts/development/implementation.md#principled-implementation Newton's restitution on the normal part and Coulomb's impulse limit on the tangential part; constant deceleration for a roll.
35
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Read the state at contact, split the velocity on the normal, one branch per outcome.
36
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Coefficients are inputs; a rebound below the radius becomes a roll only when the caller gives one.
37
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant work per contact.
38
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A new flight is a projectile record read by `projectileAt` like the first.
39
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
40
+ */
41
+ function projectileContinue(projectile, hit, outcome) {
42
+ if (hit.normal === undefined)
43
+ throw new RangeError("a projectile continues only from a contact with a normal");
44
+ const state = (0, projectileAt_1.projectileAt)(projectile, hit.time);
45
+ const n = Vector3_1.Vector3.normalize(hit.normal);
46
+ const vn = Vector3_1.Vector3.dot(state.velocity, n);
47
+ const normal = Vector3_1.Vector3.scale(n, vn);
48
+ const tangent = Vector3_1.Vector3.subtract(state.velocity, normal);
49
+ const admit = (name, value) => {
50
+ if (!(Number.isFinite(value) && value >= 0))
51
+ throw new RangeError(`projectile ${name} must be finite and non-negative, but was ${value}`);
52
+ };
53
+ const held = state.rotation === undefined ? {} : { rotation: state.rotation };
54
+ const roll = (velocity, resistance) => {
55
+ admit("rolling resistance", resistance);
56
+ const deceleration = resistance * Math.abs(Vector3_1.Vector3.dot(projectile.gravity, n));
57
+ const speed = Vector3_1.Vector3.length(velocity);
58
+ const lasting = deceleration > 0 ? speed / deceleration : speed > 0 ? Infinity : 0;
59
+ return {
60
+ kind: "roll",
61
+ from: hit.time,
62
+ origin: state.position,
63
+ velocity,
64
+ deceleration,
65
+ until: hit.time + lasting,
66
+ ...held,
67
+ };
68
+ };
69
+ switch (outcome.kind) {
70
+ case "stick": {
71
+ admit("embedding depth", outcome.depth);
72
+ const speed = Vector3_1.Vector3.length(state.velocity);
73
+ return {
74
+ kind: "rest",
75
+ from: hit.time,
76
+ position: speed > 0
77
+ ? Vector3_1.Vector3.add(state.position, Vector3_1.Vector3.scale(state.velocity, outcome.depth / speed))
78
+ : state.position,
79
+ ...held,
80
+ };
81
+ }
82
+ case "bounce": {
83
+ admit("restitution", outcome.restitution);
84
+ admit("friction", outcome.friction);
85
+ const rebound = -outcome.restitution * vn;
86
+ const slip = Vector3_1.Vector3.length(tangent);
87
+ const kept = slip > 0
88
+ ? Math.max(0, slip -
89
+ outcome.friction * (1 + outcome.restitution) * Math.abs(vn)) / slip
90
+ : 0;
91
+ const velocity = Vector3_1.Vector3.add(Vector3_1.Vector3.scale(n, rebound), Vector3_1.Vector3.scale(tangent, kept));
92
+ // A rebound that rises less than the body's radius rolls instead.
93
+ const pull = Math.abs(Vector3_1.Vector3.dot(projectile.gravity, n));
94
+ if (outcome.roll !== undefined &&
95
+ (pull > 0 ? (rebound * rebound) / (2 * pull) : Infinity) <
96
+ outcome.roll.radius)
97
+ return roll(Vector3_1.Vector3.scale(tangent, kept), outcome.roll.resistance);
98
+ return {
99
+ kind: "flight",
100
+ from: hit.time,
101
+ projectile: {
102
+ ...projectile,
103
+ origin: state.position,
104
+ velocity,
105
+ ...(projectile.attitude === undefined ||
106
+ projectile.attitude.kind === "velocity"
107
+ ? {}
108
+ : {
109
+ attitude: {
110
+ ...projectile.attitude,
111
+ ...(state.rotation === undefined
112
+ ? {}
113
+ : { rotation: state.rotation }),
114
+ },
115
+ }),
116
+ },
117
+ };
118
+ }
119
+ case "roll":
120
+ return roll(tangent, outcome.resistance);
121
+ case "pass": {
122
+ admit("speed loss", outcome.loss);
123
+ return {
124
+ kind: "flight",
125
+ from: hit.time,
126
+ projectile: {
127
+ ...projectile,
128
+ origin: state.position,
129
+ velocity: Vector3_1.Vector3.scale(state.velocity, Math.max(0, 1 - outcome.loss)),
130
+ ...(projectile.attitude === undefined ||
131
+ projectile.attitude.kind === "velocity"
132
+ ? {}
133
+ : {
134
+ attitude: {
135
+ ...projectile.attitude,
136
+ ...(state.rotation === undefined
137
+ ? {}
138
+ : { rotation: state.rotation }),
139
+ },
140
+ }),
141
+ },
142
+ };
143
+ }
144
+ }
145
+ }
146
+ /**
147
+ * Companion types and the roll's reader of {@link projectileContinue}.
148
+ *
149
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and time base.
150
+ * @evidence contracts/development/design.md#principled-representation A closed union of four outcomes and of three segments: a new flight, a roll and a rest.
151
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What a caller decides and what it reads back.
152
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Every coefficient is the caller's.
153
+ */
154
+ (function (projectileContinue) {
155
+ /**
156
+ * A segment's centre and velocity at a second since the original launch:
157
+ * a flight read from its own time zero, a roll's constant deceleration to
158
+ * rest, a rest's place.
159
+ *
160
+ * @param segment The segment.
161
+ * @param seconds Seconds since the original launch, at or after `from`.
162
+ * @returns The state.
163
+ */
164
+ function at(segment, seconds) {
165
+ switch (segment.kind) {
166
+ case "flight":
167
+ return (0, projectileAt_1.projectileAt)(segment.projectile, seconds - segment.from);
168
+ case "roll": {
169
+ const t = Math.min(seconds, segment.until) - segment.from;
170
+ const speed = Vector3_1.Vector3.length(segment.velocity);
171
+ const along = speed > 0 ? Vector3_1.Vector3.scale(segment.velocity, 1 / speed) : segment.velocity;
172
+ const moving = Math.max(0, speed - segment.deceleration * t);
173
+ return {
174
+ position: Vector3_1.Vector3.add(segment.origin, Vector3_1.Vector3.scale(along, speed * t - 0.5 * segment.deceleration * t * t)),
175
+ velocity: Vector3_1.Vector3.scale(along, moving),
176
+ ...(segment.rotation === undefined ? {} : { rotation: segment.rotation }),
177
+ };
178
+ }
179
+ case "rest":
180
+ return {
181
+ position: segment.position,
182
+ velocity: { x: 0, y: 0, z: 0 },
183
+ ...(segment.rotation === undefined ? {} : { rotation: segment.rotation }),
184
+ };
185
+ }
186
+ }
187
+ projectileContinue.at = at;
188
+ })(projectileContinue || (exports.projectileContinue = projectileContinue = {}));
189
+ //# sourceMappingURL=projectileContinue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projectileContinue.js","sourceRoot":"","sources":["../../src/physics/projectileContinue.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ import type { IAutoMovieProjectile } from "./IAutoMovieProjectile";
2
+ import type { IAutoMovieProjectileState } from "./IAutoMovieProjectileState";
3
+ /**
4
+ * A projectile's flight under gravity and quadratic drag, read by time:
5
+ * `dx/dt = v`, `dv/dt = gravity - k |v| v` with `k = rho Cd A / (2 m)`,
6
+ * solved by the engine's one fixed-step integrator
7
+ * (`integrateMotionTrajectory`, classical Runge-Kutta read by cubic Hermite)
8
+ * from the launch.
9
+ *
10
+ * The step is chosen once per flight by step doubling (Press et al.,
11
+ * Numerical Recipes, 3rd ed., 2007, sec. 17.2): from the integrator's own
12
+ * default step, the step is halved until one step and two half steps from
13
+ * the launch differ, divided by 15 (the fourth-order method's
14
+ * `2^4 - 1`), by no more than `TOLERANCE` metres per second of the step,
15
+ * so the error over a flight of `T` seconds stays near `TOLERANCE T`. The
16
+ * probe starts at the launch with the speed the flight can reach at most:
17
+ * a body faster than its terminal speed `sqrt(|g| / k)` only slows, one
18
+ * slower only approaches it, so the speed never exceeds the larger of the
19
+ * two, where the drag's acceleration is largest. The halving stops at the
20
+ * 52 bits of a double's mantissa, past which a step cannot shrink.
21
+ *
22
+ * The flight is integrated in chunks of `CHUNK` steps, each started from the
23
+ * previous chunk's end, so a read far along the flight integrates only up to
24
+ * its chunk, and every chunk depends on the launch alone: reads in any order
25
+ * give the same values. Times before the launch read the launch state.
26
+ *
27
+ * @param projectile A projectile with drag.
28
+ * @returns The flight's reader.
29
+ * @throws {RangeError} When the drag's mass is not positive, or its coefficient, area or density is negative or not finite.
30
+ *
31
+ * @evidence contracts/development/common.md#meaningful-documentation States the equations, the step rule with its source, the speed bound, the chunks and the held start.
32
+ * @evidence contracts/development/implementation.md#principled-implementation The quadratic drag law integrated by classical RK4 at a step from step doubling's error estimate, at the state where the drag's acceleration is largest.
33
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Admit, choose the step, then integrate chunks lazily in order.
34
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The step comes from a stated tolerance, never from the frame grid; with zero drag the integrator reproduces the closed form, since RK4 and the cubic Hermite are exact for a quadratic path.
35
+ * @evidence contracts/development/implementation.md#efficient-algorithms Four right-hand-side evaluations per step, only up to the chunk read; a read is a chunk index and a Hermite evaluation.
36
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The integrator is the engine's one; the flight is memoised per projectile record, so every read of one launch shares one integration.
37
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The memo is a weak map keyed by the projectile record, so the knots go with the record.
38
+ */
39
+ export declare function projectileDragFlight(projectile: IAutoMovieProjectile): projectileDragFlight.IFlight;
40
+ /**
41
+ * Companion types and constants of {@link projectileDragFlight}.
42
+ *
43
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its unit and why it has its value.
44
+ * @evidence contracts/development/design.md#principled-representation A flight is its chosen step and a reader by time.
45
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What `projectileAt` and a contact search read.
46
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The tolerance is derived from the acceptance it serves.
47
+ */
48
+ export declare namespace projectileDragFlight {
49
+ /**
50
+ * The error a flight may gather per second, metres: a tenth of the
51
+ * millimetre within which a flight's arrival is accepted (#3470: an arrow's
52
+ * arrival within 1 ms and 1 mm), so a flight of up to ten seconds stays
53
+ * inside it.
54
+ */
55
+ const TOLERANCE: number;
56
+ /** Steps per chunk: a memory bound no flight reads, about a thousand knots of six numbers per chunk. */
57
+ const CHUNK: number;
58
+ /** A drag flight's reader. */
59
+ interface IFlight {
60
+ /** The integration step, seconds. */
61
+ step: number;
62
+ /** The largest speed the flight reaches, m/s: the launch speed or the terminal speed, whichever is larger. */
63
+ fastest: number;
64
+ /**
65
+ * The state at a second after the launch.
66
+ *
67
+ * @param seconds Seconds since the launch; before it, the launch state.
68
+ * @returns Position and velocity.
69
+ */
70
+ at(seconds: number): IAutoMovieProjectileState;
71
+ }
72
+ }