@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,26 @@
1
+ import type { IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
+ /**
3
+ * The outward unit normal of a collider at a point of its surface: a
4
+ * sphere's radius through it, a capsule's from the nearest point of its
5
+ * axis, and, for a box or a hull, the gradient of the smooth maximum of its
6
+ * face planes (`SMOOTH`): the face normals weighed by how near the point
7
+ * lies to each plane. A point inside a face keeps that face's normal; one
8
+ * that crosses an edge turns its normal continuously from one face's to the
9
+ * next, where a face's own normal would step by the angle between them.
10
+ * The fallback where the radius or the axis offset has no length.
11
+ *
12
+ * @param frame The segment's pose.
13
+ * @param shape The collider.
14
+ * @param point The point of its surface, in the frame `frame` is in.
15
+ * @param fallback The direction returned where the normal has no direction.
16
+ * @returns The outward unit normal.
17
+ *
18
+ * @evidence contracts/development/common.md#meaningful-documentation States each kind's normal, the edge blend and the fallback.
19
+ * @evidence contracts/development/implementation.md#principled-implementation A sphere's and a capsule's exact gradient; a polytope's normal as the gradient of the log-sum-exp smooth maximum of its face planes' signed heights, which is continuous across edges and equals the face's normal inside it.
20
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch per kind, one plane list for the box and the hull.
21
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The weights are taken relative to the highest plane, so none overflows; a degenerate normal falls back instead of normalising a zero vector.
22
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `physicalHullFaces` and the engine's vector and quaternion owners.
23
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in a hull's faces, with no algorithm to choose.
24
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
25
+ */
26
+ export declare function physicalShapeNormal(frame: P.ITransform, shape: P.IShape, point: IAutoMovieVector3, fallback: IAutoMovieVector3): IAutoMovieVector3;
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalShapeNormal = physicalShapeNormal;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const physicalHullFaces_1 = require("./physicalHullFaces");
7
+ /**
8
+ * The outward unit normal of a collider at a point of its surface: a
9
+ * sphere's radius through it, a capsule's from the nearest point of its
10
+ * axis, and, for a box or a hull, the gradient of the smooth maximum of its
11
+ * face planes (`SMOOTH`): the face normals weighed by how near the point
12
+ * lies to each plane. A point inside a face keeps that face's normal; one
13
+ * that crosses an edge turns its normal continuously from one face's to the
14
+ * next, where a face's own normal would step by the angle between them.
15
+ * The fallback where the radius or the axis offset has no length.
16
+ *
17
+ * @param frame The segment's pose.
18
+ * @param shape The collider.
19
+ * @param point The point of its surface, in the frame `frame` is in.
20
+ * @param fallback The direction returned where the normal has no direction.
21
+ * @returns The outward unit normal.
22
+ *
23
+ * @evidence contracts/development/common.md#meaningful-documentation States each kind's normal, the edge blend and the fallback.
24
+ * @evidence contracts/development/implementation.md#principled-implementation A sphere's and a capsule's exact gradient; a polytope's normal as the gradient of the log-sum-exp smooth maximum of its face planes' signed heights, which is continuous across edges and equals the face's normal inside it.
25
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One branch per kind, one plane list for the box and the hull.
26
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The weights are taken relative to the highest plane, so none overflows; a degenerate normal falls back instead of normalising a zero vector.
27
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `physicalHullFaces` and the engine's vector and quaternion owners.
28
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in a hull's faces, with no algorithm to choose.
29
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
30
+ */
31
+ function physicalShapeNormal(frame, shape, point, fallback) {
32
+ const centre = Vector3_1.Vector3.add(frame.position, Quaternion_1.Quaternion.rotateVector(frame.rotation, shape.transform.position));
33
+ const rotation = Quaternion_1.Quaternion.multiply(frame.rotation, shape.transform.rotation);
34
+ const radial = (from) => {
35
+ const r = Vector3_1.Vector3.subtract(point, from);
36
+ return Vector3_1.Vector3.length(r) > BOUNDARY ? Vector3_1.Vector3.normalize(r) : fallback;
37
+ };
38
+ if (shape.kind === "sphere")
39
+ return radial(centre);
40
+ if (shape.kind === "capsule") {
41
+ const axis = Quaternion_1.Quaternion.rotateVector(rotation, {
42
+ x: 0,
43
+ y: 1,
44
+ z: 0,
45
+ });
46
+ const along = Math.max(-shape.halfLength, Math.min(shape.halfLength, Vector3_1.Vector3.dot(Vector3_1.Vector3.subtract(point, centre), axis)));
47
+ return radial(Vector3_1.Vector3.add(centre, Vector3_1.Vector3.scale(axis, along)));
48
+ }
49
+ const o = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(rotation), Vector3_1.Vector3.subtract(point, centre));
50
+ const planes = shape.kind === "hull"
51
+ ? (0, physicalHullFaces_1.physicalHullFaces)(shape.points).faces
52
+ : ["x", "y", "z"].flatMap((k) => [-1, 1].map((sign) => ({
53
+ normal: { x: 0, y: 0, z: 0, [k]: sign },
54
+ offset: shape.halfExtents[k],
55
+ })));
56
+ const heights = planes.map((plane) => Vector3_1.Vector3.dot(plane.normal, o) - plane.offset);
57
+ const top = Math.max(...heights);
58
+ let sum = { x: 0, y: 0, z: 0 };
59
+ planes.forEach((plane, k) => {
60
+ sum = Vector3_1.Vector3.add(sum, Vector3_1.Vector3.scale(plane.normal, Math.exp((heights[k] - top) / SMOOTH)));
61
+ });
62
+ return Vector3_1.Vector3.length(sum) > BOUNDARY
63
+ ? Vector3_1.Vector3.normalize(Quaternion_1.Quaternion.rotateVector(rotation, sum))
64
+ : fallback;
65
+ }
66
+ /** How wide, metres, a box's or a hull's normal blends across an edge (`physicalShapeNormal`), provisional: half the 10 mm a pressed skin gives, so a face's middle keeps its own normal (a face 30 mm off weighs e^-6 of it) and an edge turns within a fingertip's breadth. */
67
+ const SMOOTH = 0.005;
68
+ /** Metres under which a radius or a normal has no direction. */
69
+ const BOUNDARY = 1e-9;
70
+ //# sourceMappingURL=physicalShapeNormal.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalShapeNormal.js","sourceRoot":"","sources":["../../src/physics/physicalShapeNormal.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import type { IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
+ /**
3
+ * The signed distance between two admitted shapes, each placed by its parent
4
+ * pose: positive when they are apart, negative when one enters the other.
5
+ *
6
+ * Every shape is a wire frame widened by a radius: a sphere is its centre and
7
+ * a capsule its axis, widened by their radius; a box and a hull are their
8
+ * edges, widened by nothing. The distance is the least, over both shapes, of
9
+ * the signed distance from one shape's wires to the other shape
10
+ * (`physicalShapeNearest`) less the wires' radius.
11
+ *
12
+ * Apart, this is the exact distance between the two solids: the nearest pair
13
+ * of points of two convex solids lies on a vertex or an edge of one of them,
14
+ * or on the axis of a round one. Overlapping, it is how deep a wire of one
15
+ * lies inside the other, the same depth a capsule's axis reads against a
16
+ * body, so two capsules read their axis distance less both radii.
17
+ *
18
+ * @param poseA The first shape's parent pose, world metres.
19
+ * @param shapeA The first shape.
20
+ * @param poseB The second shape's parent pose, world metres.
21
+ * @param shapeB The second shape.
22
+ * @returns Metres, negative when the shapes overlap.
23
+ *
24
+ * @evidence contracts/development/common.md#meaningful-documentation States the wire frame of each kind, why the reading is exact apart and what it measures when the shapes overlap.
25
+ * @evidence contracts/development/implementation.md#principled-implementation The nearest features of two disjoint convex polytopes are a vertex and a face or two edges (Ericson, Real-Time Collision Detection, 2005, ch. 5 and 9), each of which contains a point of an edge of one polytope, so the least edge-to-solid distance over both is the distance; a round shape is its axis offset by its radius.
26
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One wire frame per shape kind with an exhaustive check, and one loop each way over the single proximity owner; no second distance formula exists here.
27
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance, sample count or margin is added; every wire is queried exactly by the owner.
28
+ * @evidence contracts/development/implementation.md#efficient-algorithms One proximity query per wire of each shape: one for a round shape, twelve for a box, the edge count for a hull, a few dozen for a body module.
29
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A hull's edges are read from the faces `physicalHullFaces` already shares per point list and kept beside them per point list.
30
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The edge lists live in a weak map keyed by the point list, so they go when the shape goes.
31
+ */
32
+ export declare function physicalShapePairDistance(poseA: P.ITransform, shapeA: P.IShape, poseB: P.ITransform, shapeB: P.IShape): number;
@@ -0,0 +1,124 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalShapePairDistance = physicalShapePairDistance;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const physicalHullFaces_1 = require("./physicalHullFaces");
7
+ const physicalShapeNearest_1 = require("./physicalShapeNearest");
8
+ /**
9
+ * The signed distance between two admitted shapes, each placed by its parent
10
+ * pose: positive when they are apart, negative when one enters the other.
11
+ *
12
+ * Every shape is a wire frame widened by a radius: a sphere is its centre and
13
+ * a capsule its axis, widened by their radius; a box and a hull are their
14
+ * edges, widened by nothing. The distance is the least, over both shapes, of
15
+ * the signed distance from one shape's wires to the other shape
16
+ * (`physicalShapeNearest`) less the wires' radius.
17
+ *
18
+ * Apart, this is the exact distance between the two solids: the nearest pair
19
+ * of points of two convex solids lies on a vertex or an edge of one of them,
20
+ * or on the axis of a round one. Overlapping, it is how deep a wire of one
21
+ * lies inside the other, the same depth a capsule's axis reads against a
22
+ * body, so two capsules read their axis distance less both radii.
23
+ *
24
+ * @param poseA The first shape's parent pose, world metres.
25
+ * @param shapeA The first shape.
26
+ * @param poseB The second shape's parent pose, world metres.
27
+ * @param shapeB The second shape.
28
+ * @returns Metres, negative when the shapes overlap.
29
+ *
30
+ * @evidence contracts/development/common.md#meaningful-documentation States the wire frame of each kind, why the reading is exact apart and what it measures when the shapes overlap.
31
+ * @evidence contracts/development/implementation.md#principled-implementation The nearest features of two disjoint convex polytopes are a vertex and a face or two edges (Ericson, Real-Time Collision Detection, 2005, ch. 5 and 9), each of which contains a point of an edge of one polytope, so the least edge-to-solid distance over both is the distance; a round shape is its axis offset by its radius.
32
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One wire frame per shape kind with an exhaustive check, and one loop each way over the single proximity owner; no second distance formula exists here.
33
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance, sample count or margin is added; every wire is queried exactly by the owner.
34
+ * @evidence contracts/development/implementation.md#efficient-algorithms One proximity query per wire of each shape: one for a round shape, twelve for a box, the edge count for a hull, a few dozen for a body module.
35
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work A hull's edges are read from the faces `physicalHullFaces` already shares per point list and kept beside them per point list.
36
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The edge lists live in a weak map keyed by the point list, so they go when the shape goes.
37
+ */
38
+ function physicalShapePairDistance(poseA, shapeA, poseB, shapeB) {
39
+ let least = Infinity;
40
+ for (const [pose, shape, otherPose, other] of [
41
+ [poseA, shapeA, poseB, shapeB],
42
+ [poseB, shapeB, poseA, shapeA],
43
+ ]) {
44
+ const centre = Vector3_1.Vector3.add(pose.position, Quaternion_1.Quaternion.rotateVector(pose.rotation, shape.transform.position));
45
+ const rotation = Quaternion_1.Quaternion.multiply(pose.rotation, shape.transform.rotation);
46
+ const world = (p) => Vector3_1.Vector3.add(centre, Quaternion_1.Quaternion.rotateVector(rotation, p));
47
+ const frame = wires(shape);
48
+ for (const [a, b] of frame.segments)
49
+ least = Math.min(least, (0, physicalShapeNearest_1.physicalShapeNearest)(otherPose, other, world(a), world(b)).distance -
50
+ frame.radius);
51
+ }
52
+ return least;
53
+ }
54
+ /** The wire frame of one shape. */
55
+ const wires = (shape) => {
56
+ if (shape.kind === "sphere")
57
+ return {
58
+ segments: [
59
+ [
60
+ { x: 0, y: 0, z: 0 },
61
+ { x: 0, y: 0, z: 0 },
62
+ ],
63
+ ],
64
+ radius: shape.radius,
65
+ };
66
+ if (shape.kind === "capsule")
67
+ return {
68
+ segments: [
69
+ [
70
+ { x: 0, y: -shape.halfLength, z: 0 },
71
+ { x: 0, y: shape.halfLength, z: 0 },
72
+ ],
73
+ ],
74
+ radius: shape.radius,
75
+ };
76
+ if (shape.kind === "box") {
77
+ const h = shape.halfExtents;
78
+ const segments = [];
79
+ for (const u of [-1, 1])
80
+ for (const v of [-1, 1])
81
+ segments.push([
82
+ { x: -h.x, y: u * h.y, z: v * h.z },
83
+ { x: h.x, y: u * h.y, z: v * h.z },
84
+ ], [
85
+ { x: u * h.x, y: -h.y, z: v * h.z },
86
+ { x: u * h.x, y: h.y, z: v * h.z },
87
+ ], [
88
+ { x: u * h.x, y: v * h.y, z: -h.z },
89
+ { x: u * h.x, y: v * h.y, z: h.z },
90
+ ]);
91
+ return { segments, radius: 0 };
92
+ }
93
+ if (shape.kind === "hull") {
94
+ const known = EDGES.get(shape.points);
95
+ if (known !== undefined)
96
+ return known;
97
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(shape.points);
98
+ const index = new Map();
99
+ const seen = new Set();
100
+ const segments = [];
101
+ for (const face of hull.faces)
102
+ face.loop.forEach((from, at) => {
103
+ const to = face.loop[(at + 1) % face.loop.length];
104
+ for (const p of [from, to])
105
+ if (!index.has(p))
106
+ index.set(p, index.size);
107
+ const i = index.get(from);
108
+ const j = index.get(to);
109
+ const key = i < j ? `${i}:${j}` : `${j}:${i}`;
110
+ if (seen.has(key))
111
+ return;
112
+ seen.add(key);
113
+ segments.push([from, to]);
114
+ });
115
+ const found = { segments, radius: 0 };
116
+ EDGES.set(shape.points, found);
117
+ return found;
118
+ }
119
+ shape;
120
+ throw new Error("Unknown physical shape kind");
121
+ };
122
+ /** Each hull's edges by its point list. */
123
+ const EDGES = new WeakMap();
124
+ //# sourceMappingURL=physicalShapePairDistance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalShapePairDistance.js","sourceRoot":"","sources":["../../src/physics/physicalShapePairDistance.ts"],"names":[],"mappings":"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"}
@@ -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":"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"}