@automovie/engine 0.0.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 (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -1,33 +1,29 @@
1
1
  import type { IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
2
  /**
3
3
  * The signed distance, metres, from a world segment to an admitted sphere, Y
4
- * capsule or oriented box placed by a parent pose: the least distance over
5
- * the segment's points to the shape's surface, negative when the segment
6
- * enters it. A segment whose two ends coincide is a point, so this is also
7
- * the point-to-shape distance.
4
+ * capsule, oriented box or convex hull placed by a parent pose: the least
5
+ * distance over the segment's points to the shape's surface, negative when
6
+ * the segment enters it. A segment whose two ends coincide is a point, so
7
+ * this is also the point-to-shape distance. A segment widened by a radius
8
+ * running linearly from `a` to `b` (a tapered capsule) reads its own signed
9
+ * distance: the least over its points of the distance less the radius there.
8
10
  *
9
- * The shape's frame is the parent pose composed with the shape's own
10
- * transform, as in `physicalShapeBounds`. A sphere is its centre point and a
11
- * capsule its axis segment, each widened by the radius, so both reduce to
12
- * the closest points between two segments (`closestPointsBetweenSegments`,
13
- * Eberly 2023). A box uses its exact signed distance (the outside distance
14
- * of the clamped excess, or the largest negative excess inside); that
15
- * function is convex in space and so convex along the segment, and 44
16
- * golden-section steps narrow the segment's unit parameter below 1e-9 before
17
- * the least of both ends and the two final probes is taken.
11
+ * It is the distance of `physicalShapeNearest`, which owns the frame
12
+ * composition and the method for each shape kind.
18
13
  *
19
14
  * @param pose The shape's parent pose, world metres.
20
15
  * @param shape The admitted shape.
21
16
  * @param a One end of the segment, world metres.
22
17
  * @param b The other end, world metres.
18
+ * @param taper The radii the segment is widened by at `a` and at `b`, metres; absent for the bare segment.
23
19
  * @returns The signed distance, metres; negative inside.
24
20
  *
25
- * @evidence contracts/development/common.md#meaningful-documentation States the frame composition, the sign, the point case and the method for each shape kind with its precision.
26
- * @evidence contracts/development/implementation.md#principled-implementation Spheres and capsules are segments widened by a radius, so their distance is the engine's exact closest-segment-points query less the radius; a box's signed distance is convex, so golden-section search along the segment finds its minimum to 1e-9 of the parameter without missing an entry.
27
- * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of shape-to-segment distance: the frame composition, then one branch per shape kind, reusing `closestPointsBetweenSegments` instead of restating it; `curlChainUntilContact` and the motions colliders call this.
28
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance is added to the distance; the 44 golden-section steps are the count that narrows a unit interval below 1e-9 (0.618^44 ≈ 6.4e-10), and the shape's dimensions are taken as admitted by the profile.
29
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant work per call: one closest-segment query for a sphere or capsule, 46 box evaluations for a box.
30
- * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its four arguments; callers that query many shapes hold their own placed frames.
21
+ * @evidence contracts/development/common.md#meaningful-documentation States the sign, the point case and which owner computes the reading.
22
+ * @evidence contracts/development/implementation.md#principled-implementation The distance member of the one proximity reading, so a distance and a contact point taken for the same shape and segment cannot disagree.
23
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One delegation to `physicalShapeNearest`; `curlChainUntilContact` and the motions colliders call this when the distance is all they need.
24
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance, cast or branch; the value is the owner's.
25
+ * @evidence contracts/development/implementation.md#efficient-algorithms The owner's constant work per call and nothing more.
26
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its arguments; callers that query many shapes hold their own placed frames.
31
27
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
32
28
  */
33
- export declare function physicalShapeSegmentDistance(pose: P.ITransform, shape: P.IShape, a: IAutoMovieVector3, b: IAutoMovieVector3): number;
29
+ export declare function physicalShapeSegmentDistance(pose: P.ITransform, shape: P.IShape, a: IAutoMovieVector3, b: IAutoMovieVector3, taper?: readonly [number, number]): number;
@@ -1,87 +1,35 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.physicalShapeSegmentDistance = physicalShapeSegmentDistance;
4
- const Quaternion_1 = require("../math/Quaternion");
5
- const Vector3_1 = require("../math/Vector3");
6
- const closestPointsBetweenSegments_1 = require("../math/closestPointsBetweenSegments");
4
+ const physicalShapeNearest_1 = require("./physicalShapeNearest");
7
5
  /**
8
6
  * The signed distance, metres, from a world segment to an admitted sphere, Y
9
- * capsule or oriented box placed by a parent pose: the least distance over
10
- * the segment's points to the shape's surface, negative when the segment
11
- * enters it. A segment whose two ends coincide is a point, so this is also
12
- * the point-to-shape distance.
7
+ * capsule, oriented box or convex hull placed by a parent pose: the least
8
+ * distance over the segment's points to the shape's surface, negative when
9
+ * the segment enters it. A segment whose two ends coincide is a point, so
10
+ * this is also the point-to-shape distance. A segment widened by a radius
11
+ * running linearly from `a` to `b` (a tapered capsule) reads its own signed
12
+ * distance: the least over its points of the distance less the radius there.
13
13
  *
14
- * The shape's frame is the parent pose composed with the shape's own
15
- * transform, as in `physicalShapeBounds`. A sphere is its centre point and a
16
- * capsule its axis segment, each widened by the radius, so both reduce to
17
- * the closest points between two segments (`closestPointsBetweenSegments`,
18
- * Eberly 2023). A box uses its exact signed distance (the outside distance
19
- * of the clamped excess, or the largest negative excess inside); that
20
- * function is convex in space and so convex along the segment, and 44
21
- * golden-section steps narrow the segment's unit parameter below 1e-9 before
22
- * the least of both ends and the two final probes is taken.
14
+ * It is the distance of `physicalShapeNearest`, which owns the frame
15
+ * composition and the method for each shape kind.
23
16
  *
24
17
  * @param pose The shape's parent pose, world metres.
25
18
  * @param shape The admitted shape.
26
19
  * @param a One end of the segment, world metres.
27
20
  * @param b The other end, world metres.
21
+ * @param taper The radii the segment is widened by at `a` and at `b`, metres; absent for the bare segment.
28
22
  * @returns The signed distance, metres; negative inside.
29
23
  *
30
- * @evidence contracts/development/common.md#meaningful-documentation States the frame composition, the sign, the point case and the method for each shape kind with its precision.
31
- * @evidence contracts/development/implementation.md#principled-implementation Spheres and capsules are segments widened by a radius, so their distance is the engine's exact closest-segment-points query less the radius; a box's signed distance is convex, so golden-section search along the segment finds its minimum to 1e-9 of the parameter without missing an entry.
32
- * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of shape-to-segment distance: the frame composition, then one branch per shape kind, reusing `closestPointsBetweenSegments` instead of restating it; `curlChainUntilContact` and the motions colliders call this.
33
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance is added to the distance; the 44 golden-section steps are the count that narrows a unit interval below 1e-9 (0.618^44 ≈ 6.4e-10), and the shape's dimensions are taken as admitted by the profile.
34
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant work per call: one closest-segment query for a sphere or capsule, 46 box evaluations for a box.
35
- * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its four arguments; callers that query many shapes hold their own placed frames.
24
+ * @evidence contracts/development/common.md#meaningful-documentation States the sign, the point case and which owner computes the reading.
25
+ * @evidence contracts/development/implementation.md#principled-implementation The distance member of the one proximity reading, so a distance and a contact point taken for the same shape and segment cannot disagree.
26
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One delegation to `physicalShapeNearest`; `curlChainUntilContact` and the motions colliders call this when the distance is all they need.
27
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance, cast or branch; the value is the owner's.
28
+ * @evidence contracts/development/implementation.md#efficient-algorithms The owner's constant work per call and nothing more.
29
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its arguments; callers that query many shapes hold their own placed frames.
36
30
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
37
31
  */
38
- function physicalShapeSegmentDistance(pose, shape, a, b) {
39
- const centre = Vector3_1.Vector3.add(pose.position, Quaternion_1.Quaternion.rotateVector(pose.rotation, shape.transform.position));
40
- const rotation = Quaternion_1.Quaternion.multiply(pose.rotation, shape.transform.rotation);
41
- if (shape.kind === "sphere")
42
- return ((0, closestPointsBetweenSegments_1.closestPointsBetweenSegments)(a, b, centre, centre).distance - shape.radius);
43
- if (shape.kind === "capsule") {
44
- const axis = Quaternion_1.Quaternion.rotateVector(rotation, {
45
- x: 0,
46
- y: shape.halfLength,
47
- z: 0,
48
- });
49
- return ((0, closestPointsBetweenSegments_1.closestPointsBetweenSegments)(a, b, Vector3_1.Vector3.subtract(centre, axis), Vector3_1.Vector3.add(centre, axis)).distance - shape.radius);
50
- }
51
- const inverse = Quaternion_1.Quaternion.inverse(rotation);
52
- const la = Quaternion_1.Quaternion.rotateVector(inverse, Vector3_1.Vector3.subtract(a, centre));
53
- const lb = Quaternion_1.Quaternion.rotateVector(inverse, Vector3_1.Vector3.subtract(b, centre));
54
- const h = shape.halfExtents;
55
- const box = (t) => {
56
- const qx = Math.abs(la.x + (lb.x - la.x) * t) - h.x;
57
- const qy = Math.abs(la.y + (lb.y - la.y) * t) - h.y;
58
- const qz = Math.abs(la.z + (lb.z - la.z) * t) - h.z;
59
- return (Math.hypot(Math.max(qx, 0), Math.max(qy, 0), Math.max(qz, 0)) +
60
- Math.min(Math.max(qx, qy, qz), 0));
61
- };
62
- const ratio = (Math.sqrt(5) - 1) / 2;
63
- let lo = 0;
64
- let hi = 1;
65
- let c = hi - ratio * (hi - lo);
66
- let d = lo + ratio * (hi - lo);
67
- let fc = box(c);
68
- let fd = box(d);
69
- for (let i = 0; i < 44; i++) {
70
- if (fc <= fd) {
71
- hi = d;
72
- d = c;
73
- fd = fc;
74
- c = hi - ratio * (hi - lo);
75
- fc = box(c);
76
- }
77
- else {
78
- lo = c;
79
- c = d;
80
- fc = fd;
81
- d = lo + ratio * (hi - lo);
82
- fd = box(d);
83
- }
84
- }
85
- return Math.min(box(0), box(1), fc, fd);
32
+ function physicalShapeSegmentDistance(pose, shape, a, b, taper) {
33
+ return (0, physicalShapeNearest_1.physicalShapeNearest)(pose, shape, a, b, taper).distance;
86
34
  }
87
35
  //# sourceMappingURL=physicalShapeSegmentDistance.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"physicalShapeSegmentDistance.js","sourceRoot":"","sources":["../../src/physics/physicalShapeSegmentDistance.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"physicalShapeSegmentDistance.js","sourceRoot":"","sources":["../../src/physics/physicalShapeSegmentDistance.ts"],"names":[],"mappings":";;;AAKA,iEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,sCACE,IAAkB,EAClB,KAAe,EACf,CAAoB,EACpB,CAAoB,EACpB,KAAiC;IAEjC,OAAO,IAAA,2CAAoB,EAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC;AACjE,CAAC"}
@@ -0,0 +1,21 @@
1
+ import type { IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
+ /**
3
+ * The interval an admitted shape covers along a world direction: the lowest
4
+ * and highest projections of its points onto a unit axis, metres from the
5
+ * world origin. The shape is placed by its parent pose composed with its own
6
+ * transform.
7
+ *
8
+ * @param pose The shape's parent pose, world metres.
9
+ * @param shape The shape.
10
+ * @param axis A unit direction, world frame.
11
+ * @returns The low and high projections, metres along the axis.
12
+ *
13
+ * @evidence contracts/development/common.md#meaningful-documentation States the interval, its frame and unit and how the shape is placed.
14
+ * @evidence contracts/development/implementation.md#principled-implementation The support function of each convex kind along the axis and its opposite: a sphere's radius, a capsule's projected half axis plus its radius, a box's projected half extents summed, a hull's extreme projected point (Ericson, Real-Time Collision Detection, 2005, ch. 9.5.3).
15
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch per shape kind with an exhaustive check.
16
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No margin or sampling; every kind is projected exactly and an unknown kind throws.
17
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant for a sphere, capsule and box, linear in a hull's points.
18
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its inputs.
19
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
20
+ */
21
+ export declare function physicalShapeSpan(pose: P.ITransform, shape: P.IShape, axis: IAutoMovieVector3): readonly [number, number];
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalShapeSpan = physicalShapeSpan;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ /**
7
+ * The interval an admitted shape covers along a world direction: the lowest
8
+ * and highest projections of its points onto a unit axis, metres from the
9
+ * world origin. The shape is placed by its parent pose composed with its own
10
+ * transform.
11
+ *
12
+ * @param pose The shape's parent pose, world metres.
13
+ * @param shape The shape.
14
+ * @param axis A unit direction, world frame.
15
+ * @returns The low and high projections, metres along the axis.
16
+ *
17
+ * @evidence contracts/development/common.md#meaningful-documentation States the interval, its frame and unit and how the shape is placed.
18
+ * @evidence contracts/development/implementation.md#principled-implementation The support function of each convex kind along the axis and its opposite: a sphere's radius, a capsule's projected half axis plus its radius, a box's projected half extents summed, a hull's extreme projected point (Ericson, Real-Time Collision Detection, 2005, ch. 9.5.3).
19
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch per shape kind with an exhaustive check.
20
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No margin or sampling; every kind is projected exactly and an unknown kind throws.
21
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant for a sphere, capsule and box, linear in a hull's points.
22
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its inputs.
23
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
24
+ */
25
+ function physicalShapeSpan(pose, shape, axis) {
26
+ const rotation = Quaternion_1.Quaternion.multiply(pose.rotation, shape.transform.rotation);
27
+ const centre = Vector3_1.Vector3.dot(Vector3_1.Vector3.add(pose.position, Quaternion_1.Quaternion.rotateVector(pose.rotation, shape.transform.position)), axis);
28
+ // The axis in the shape's own frame, so local points project directly.
29
+ const local = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(rotation), axis);
30
+ if (shape.kind === "sphere")
31
+ return [centre - shape.radius, centre + shape.radius];
32
+ if (shape.kind === "capsule") {
33
+ const half = shape.radius + shape.halfLength * Math.abs(local.y);
34
+ return [centre - half, centre + half];
35
+ }
36
+ if (shape.kind === "box") {
37
+ const half = shape.halfExtents.x * Math.abs(local.x) +
38
+ shape.halfExtents.y * Math.abs(local.y) +
39
+ shape.halfExtents.z * Math.abs(local.z);
40
+ return [centre - half, centre + half];
41
+ }
42
+ if (shape.kind === "hull") {
43
+ let lo = Infinity;
44
+ let hi = -Infinity;
45
+ for (const point of shape.points) {
46
+ const along = Vector3_1.Vector3.dot(point, local);
47
+ lo = Math.min(lo, along);
48
+ hi = Math.max(hi, along);
49
+ }
50
+ return [centre + lo, centre + hi];
51
+ }
52
+ shape;
53
+ throw new Error("Unknown physical shape kind");
54
+ }
55
+ //# sourceMappingURL=physicalShapeSpan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalShapeSpan.js","sourceRoot":"","sources":["../../src/physics/physicalShapeSpan.ts"],"names":[],"mappings":";;;AAMA,mDAAgD;AAChD,6CAA0C;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,2BACE,IAAkB,EAClB,KAAe,EACf,IAAuB;IAEvB,MAAM,QAAQ,GAAyB,uBAAU,CAAC,QAAQ,CACxD,IAAI,CAAC,QAAQ,EACb,KAAK,CAAC,SAAS,CAAC,QAAQ,CACzB,CAAC;IACF,MAAM,MAAM,GAAW,iBAAO,CAAC,GAAG,CAChC,iBAAO,CAAC,GAAG,CACT,IAAI,CAAC,QAAQ,EACb,uBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CACjE,EACD,IAAI,CACL,CAAC;IACF,uEAAuE;IACvE,MAAM,KAAK,GAAsB,uBAAU,CAAC,YAAY,CACtD,uBAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC5B,IAAI,CACL,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QACzB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAW,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GACR,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,EAAE,GAAW,QAAQ,CAAC;QAC1B,IAAI,EAAE,GAAW,CAAC,QAAQ,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,KAAK,GAAW,iBAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAChD,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACzB,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,KAAqB,CAAC;IACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import type { IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
2
  /**
3
- * A collider's exact support surface in a specified bone-local outward direction. Capsule ties select the segment midpoint rather than an arbitrary cap; boxes select the face centre on tied coordinates.
3
+ * A collider's exact support surface in a specified bone-local outward direction. Capsule ties select the segment midpoint rather than an arbitrary cap; boxes select the face centre on tied coordinates; hulls select the mean of the tied vertices.
4
4
  *
5
5
  * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (A collider's exact support surface in a specified bone-local outward direction) as stated in this comment.
6
6
  * @evidence contracts/development/implementation.md#principled-implementation Implements the documented behavior (A collider's exact support surface in a specified bone-local outward direction) directly over its typed inputs (`pose`, `shape`, `normal`) as a fixed number of statements with no loop or recursion in the body, delegating to `Quaternion.rotateVector`, `Vector3.normalize`, `Quaternion.multiply`, `Quaternion.inverse`, `Math.abs`; the premises are the units, frames and ranges stated in its parameter documentation, enforced only where the body performs no validation and relies on its callers. Beyond structural 0, 1 and 2 the body uses the literal 1e-12, whose basis this answer does not independently establish and a reviewer must confirm.
@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.physicalShapeSurfaceAnchor = physicalShapeSurfaceAnchor;
4
4
  const Quaternion_1 = require("../math/Quaternion");
5
5
  const Vector3_1 = require("../math/Vector3");
6
+ const physicalHullFaces_1 = require("./physicalHullFaces");
6
7
  /**
7
- * A collider's exact support surface in a specified bone-local outward direction. Capsule ties select the segment midpoint rather than an arbitrary cap; boxes select the face centre on tied coordinates.
8
+ * A collider's exact support surface in a specified bone-local outward direction. Capsule ties select the segment midpoint rather than an arbitrary cap; boxes select the face centre on tied coordinates; hulls select the mean of the tied vertices.
8
9
  *
9
10
  * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (A collider's exact support surface in a specified bone-local outward direction) as stated in this comment.
10
11
  * @evidence contracts/development/implementation.md#principled-implementation Implements the documented behavior (A collider's exact support surface in a specified bone-local outward direction) directly over its typed inputs (`pose`, `shape`, `normal`) as a fixed number of statements with no loop or recursion in the body, delegating to `Quaternion.rotateVector`, `Vector3.normalize`, `Quaternion.multiply`, `Quaternion.inverse`, `Math.abs`; the premises are the units, frames and ranges stated in its parameter documentation, enforced only where the body performs no validation and relies on its callers. Beyond structural 0, 1 and 2 the body uses the literal 1e-12, whose basis this answer does not independently establish and a reviewer must confirm.
@@ -19,17 +20,35 @@ function physicalShapeSurfaceAnchor(pose, shape, normal) {
19
20
  const rotation = Quaternion_1.Quaternion.multiply(pose.rotation, shape.transform.rotation);
20
21
  const direction = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(rotation), world);
21
22
  const sign = (value) => Math.abs(value) < 1e-12 ? 0 : Math.sign(value);
22
- const point = shape.kind === "box"
23
- ? {
23
+ let point;
24
+ if (shape.kind === "box")
25
+ point = {
24
26
  x: sign(direction.x) * shape.halfExtents.x,
25
27
  y: sign(direction.y) * shape.halfExtents.y,
26
28
  z: sign(direction.z) * shape.halfExtents.z,
27
- }
28
- : Vector3_1.Vector3.add(Vector3_1.Vector3.scale(direction, shape.radius), {
29
+ };
30
+ else if (shape.kind === "sphere" || shape.kind === "capsule")
31
+ point = Vector3_1.Vector3.add(Vector3_1.Vector3.scale(direction, shape.radius), {
29
32
  x: 0,
30
33
  y: shape.kind === "capsule" ? sign(direction.y) * shape.halfLength : 0,
31
34
  z: 0,
32
35
  });
36
+ else if (shape.kind === "hull") {
37
+ // The support feature: the mean of the vertices farthest along the
38
+ // direction, a vertex, an edge midpoint or a face's vertex mean.
39
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(shape.points);
40
+ let reach = -Infinity;
41
+ for (const vertex of hull.vertices)
42
+ reach = Math.max(reach, Vector3_1.Vector3.dot(vertex, direction));
43
+ const support = hull.vertices.filter((vertex) => Vector3_1.Vector3.dot(vertex, direction) >= reach - hull.tolerance);
44
+ point = { x: 0, y: 0, z: 0 };
45
+ for (const vertex of support)
46
+ point = Vector3_1.Vector3.add(point, Vector3_1.Vector3.scale(vertex, 1 / support.length));
47
+ }
48
+ else {
49
+ shape;
50
+ throw new Error("Unknown physical shape kind");
51
+ }
33
52
  return {
34
53
  point: Vector3_1.Vector3.add(Vector3_1.Vector3.add(pose.position, Quaternion_1.Quaternion.rotateVector(pose.rotation, shape.transform.position)), Quaternion_1.Quaternion.rotateVector(rotation, point)),
35
54
  normal: world,
@@ -1 +1 @@
1
- {"version":3,"file":"physicalShapeSurfaceAnchor.js","sourceRoot":"","sources":["../../src/physics/physicalShapeSurfaceAnchor.ts"],"names":[],"mappings":";;;AAKA,mDAAgD;AAChD,6CAA0C;AAE1C;;;;;;;;;;GAUG;AACH,oCACE,IAAkB,EAClB,KAAe,EACf,MAAyB;IAEzB,MAAM,KAAK,GAAsB,uBAAU,CAAC,YAAY,CACtD,IAAI,CAAC,QAAQ,EACb,iBAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAC1B,CAAC;IACF,MAAM,QAAQ,GAA6B,uBAAU,CAAC,QAAQ,CAC5D,IAAI,CAAC,QAAQ,EACb,KAAK,CAAC,SAAS,CAAC,QAAQ,CACzB,CAAC;IACF,MAAM,SAAS,GAAsB,uBAAU,CAAC,YAAY,CAC1D,uBAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC5B,KAAK,CACN,CAAC;IACF,MAAM,IAAI,GAA8B,CAAC,KAAa,EAAU,EAAE,CAChE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,KAAK;QAClB,CAAC,CAAC;YACE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;SAC3C;QACH,CAAC,CAAC,iBAAO,CAAC,GAAG,CAAC,iBAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;YAClD,CAAC,EAAE,CAAC;YACJ,CAAC,EACC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC,EAAE,CAAC;SACL,CAAC,CAAC;IACT,OAAO;QACL,KAAK,EAAE,iBAAO,CAAC,GAAG,CAChB,iBAAO,CAAC,GAAG,CACT,IAAI,CAAC,QAAQ,EACb,uBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CACjE,EACD,uBAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CACzC;QACD,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"physicalShapeSurfaceAnchor.js","sourceRoot":"","sources":["../../src/physics/physicalShapeSurfaceAnchor.ts"],"names":[],"mappings":";;;AAKA,mDAAgD;AAChD,6CAA0C;AAC1C,2DAAwD;AAExD;;;;;;;;;;GAUG;AACH,oCACE,IAAkB,EAClB,KAAe,EACf,MAAyB;IAEzB,MAAM,KAAK,GAAsB,uBAAU,CAAC,YAAY,CACtD,IAAI,CAAC,QAAQ,EACb,iBAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAC1B,CAAC;IACF,MAAM,QAAQ,GAA6B,uBAAU,CAAC,QAAQ,CAC5D,IAAI,CAAC,QAAQ,EACb,KAAK,CAAC,SAAS,CAAC,QAAQ,CACzB,CAAC;IACF,MAAM,SAAS,GAAsB,uBAAU,CAAC,YAAY,CAC1D,uBAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC5B,KAAK,CACN,CAAC;IACF,MAAM,IAAI,GAA8B,CAAC,KAAa,EAAU,EAAE,CAChE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,KAAwB,CAAC;IAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QACtB,KAAK,GAAG;YACN,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;SAC3C,CAAC;SACC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC1D,KAAK,GAAG,iBAAO,CAAC,GAAG,CAAC,iBAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;YAC1D,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,CAAC;SACL,CAAC,CAAC;SACA,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,mEAAmE;QACnE,iEAAiE;QACjE,MAAM,IAAI,GAA4B,IAAA,qCAAiB,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,KAAK,GAAW,CAAC,QAAQ,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ;YAChC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAwB,IAAI,CAAC,QAAQ,CAAC,MAAM,CACvD,CAAC,MAAyB,EAAW,EAAE,CACrC,iBAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAC3D,CAAC;QACF,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO;YAC1B,KAAK,GAAG,iBAAO,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,KAAqB,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO;QACL,KAAK,EAAE,iBAAO,CAAC,GAAG,CAChB,iBAAO,CAAC,GAAG,CACT,IAAI,CAAC,QAAQ,EACb,uBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CACjE,EACD,uBAAU,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CACzC;QACD,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}
@@ -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
+ }