@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,37 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The nearest surface point of a convex hull to a point in the hull's own
4
+ * frame, with the outward normal there and the signed distance, negative
5
+ * inside.
6
+ *
7
+ * Inside, the nearest surface point is the projection onto the face whose
8
+ * plane is closest, and the normal is that face's. Outside, it is the
9
+ * projection onto a facing face when that projection falls within the face's
10
+ * loop, and otherwise the nearest point on the edges of the facing faces;
11
+ * the normal then points from the surface point to the query point.
12
+ *
13
+ * The planes and the edges are read from flat arrays built once per hull: a
14
+ * projection falls within a face's loop when it lies on the inner side of
15
+ * each edge, which is the sign of one product with the edge's inward
16
+ * direction in the face (the face normal crossed with the edge), as the
17
+ * query point and its projection differ along the normal only.
18
+ *
19
+ * @param points The hull's shape-local points, metres, spanning a volume.
20
+ * @param p The query point in the same frame.
21
+ * @returns The signed distance in metres, the surface point and the outward
22
+ * unit normal, both in the points' frame.
23
+ * @throws {Error} When the points span no volume.
24
+ *
25
+ * @evidence contracts/development/common.md#meaningful-documentation States both cases, which feature gives the point and the normal in each, the sign, the frame and the flat form the test reads.
26
+ * @evidence contracts/development/implementation.md#principled-implementation The signed distance of a convex polytope from its half-space form (Ericson, Real-Time Collision Detection, section 5.1): the greatest plane distance when no plane is in front, and the Voronoi region of a face or an edge of the facing faces otherwise; a vertex region is the end of an edge. The inner-side test is the edge's triple product with the projection written as one product with the precomputed in-face direction.
27
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of point-to-hull proximity; `physicalShapeNearest` composes it with the shape frame, and `physicalHullSegment` owns the segment. The scalar arithmetic stays inline over typed arrays because the collision probes call it for every probe and shape at every iterate.
28
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance widens or narrows the distance; the hull's own coplanarity tolerance only decides when the offset is too short to carry a direction, where the facing plane's normal is exact. The non-null assertions index faces by bounded indices.
29
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the face planes, and outside one product per edge of the facing faces with a nearest point only where the test fails, compared squared with one root at the end; the flat arrays are built once per hull and the plane distances reuse one module buffer.
30
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The faces come from `physicalHullFaces`, and their flat form is built once per hull and shared by every query through a `WeakMap`.
31
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one flat form per live hull record and releases it with the hull; the distance buffer grows to the largest hull queried and is overwritten by each call.
32
+ */
33
+ export declare function physicalHullNearest(points: readonly IAutoMovieVector3[], p: IAutoMovieVector3): {
34
+ distance: number;
35
+ point: IAutoMovieVector3;
36
+ normal: IAutoMovieVector3;
37
+ };
@@ -0,0 +1,178 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalHullNearest = physicalHullNearest;
4
+ const physicalHullFaces_1 = require("./physicalHullFaces");
5
+ /**
6
+ * The nearest surface point of a convex hull to a point in the hull's own
7
+ * frame, with the outward normal there and the signed distance, negative
8
+ * inside.
9
+ *
10
+ * Inside, the nearest surface point is the projection onto the face whose
11
+ * plane is closest, and the normal is that face's. Outside, it is the
12
+ * projection onto a facing face when that projection falls within the face's
13
+ * loop, and otherwise the nearest point on the edges of the facing faces;
14
+ * the normal then points from the surface point to the query point.
15
+ *
16
+ * The planes and the edges are read from flat arrays built once per hull: a
17
+ * projection falls within a face's loop when it lies on the inner side of
18
+ * each edge, which is the sign of one product with the edge's inward
19
+ * direction in the face (the face normal crossed with the edge), as the
20
+ * query point and its projection differ along the normal only.
21
+ *
22
+ * @param points The hull's shape-local points, metres, spanning a volume.
23
+ * @param p The query point in the same frame.
24
+ * @returns The signed distance in metres, the surface point and the outward
25
+ * unit normal, both in the points' frame.
26
+ * @throws {Error} When the points span no volume.
27
+ *
28
+ * @evidence contracts/development/common.md#meaningful-documentation States both cases, which feature gives the point and the normal in each, the sign, the frame and the flat form the test reads.
29
+ * @evidence contracts/development/implementation.md#principled-implementation The signed distance of a convex polytope from its half-space form (Ericson, Real-Time Collision Detection, section 5.1): the greatest plane distance when no plane is in front, and the Voronoi region of a face or an edge of the facing faces otherwise; a vertex region is the end of an edge. The inner-side test is the edge's triple product with the projection written as one product with the precomputed in-face direction.
30
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of point-to-hull proximity; `physicalShapeNearest` composes it with the shape frame, and `physicalHullSegment` owns the segment. The scalar arithmetic stays inline over typed arrays because the collision probes call it for every probe and shape at every iterate.
31
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance widens or narrows the distance; the hull's own coplanarity tolerance only decides when the offset is too short to carry a direction, where the facing plane's normal is exact. The non-null assertions index faces by bounded indices.
32
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the face planes, and outside one product per edge of the facing faces with a nearest point only where the test fails, compared squared with one root at the end; the flat arrays are built once per hull and the plane distances reuse one module buffer.
33
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The faces come from `physicalHullFaces`, and their flat form is built once per hull and shared by every query through a `WeakMap`.
34
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The `WeakMap` holds one flat form per live hull record and releases it with the hull; the distance buffer grows to the largest hull queried and is overwritten by each call.
35
+ */
36
+ function physicalHullNearest(points, p) {
37
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(points);
38
+ if (!hull.faces.length)
39
+ throw new Error("A hull must span a volume");
40
+ const flat = flattened(hull);
41
+ const planes = flat.planes;
42
+ const count = hull.faces.length;
43
+ if (DISTANCES.length < count)
44
+ DISTANCES = new Float64Array(count);
45
+ const distances = DISTANCES;
46
+ const px = p.x;
47
+ const py = p.y;
48
+ const pz = p.z;
49
+ let deepest = 0;
50
+ let depth = -Infinity;
51
+ for (let f = 0; f < count; f++) {
52
+ const d = planes[4 * f] * px +
53
+ planes[4 * f + 1] * py +
54
+ planes[4 * f + 2] * pz -
55
+ planes[4 * f + 3];
56
+ distances[f] = d;
57
+ if (d > depth) {
58
+ depth = d;
59
+ deepest = f;
60
+ }
61
+ }
62
+ const outward = hull.faces[deepest].normal;
63
+ if (depth <= 0)
64
+ return {
65
+ distance: depth,
66
+ point: {
67
+ x: px - depth * outward.x,
68
+ y: py - depth * outward.y,
69
+ z: pz - depth * outward.z,
70
+ },
71
+ normal: outward,
72
+ };
73
+ const edges = flat.edges;
74
+ let least = Infinity;
75
+ let bx = 0;
76
+ let by = 0;
77
+ let bz = 0;
78
+ for (let f = 0; f < count; f++) {
79
+ const d = distances[f];
80
+ if (!(d > 0))
81
+ continue;
82
+ let within = true;
83
+ for (let e = flat.starts[f]; e < flat.starts[f + 1]; e++) {
84
+ const o = EDGE * e;
85
+ // The projection is on the inner side of a counter clockwise edge.
86
+ if (edges[o + 7] * px +
87
+ edges[o + 8] * py +
88
+ edges[o + 9] * pz -
89
+ edges[o + 10] >=
90
+ 0)
91
+ continue;
92
+ within = false;
93
+ const fx = edges[o];
94
+ const fy = edges[o + 1];
95
+ const fz = edges[o + 2];
96
+ const ex = edges[o + 3];
97
+ const ey = edges[o + 4];
98
+ const ez = edges[o + 5];
99
+ const along = Math.min(1, Math.max(0, ((px - fx) * ex + (py - fy) * ey + (pz - fz) * ez) / edges[o + 6]));
100
+ const cx = fx + ex * along;
101
+ const cy = fy + ey * along;
102
+ const cz = fz + ez * along;
103
+ const gap = (px - cx) * (px - cx) + (py - cy) * (py - cy) + (pz - cz) * (pz - cz);
104
+ if (gap < least) {
105
+ least = gap;
106
+ bx = cx;
107
+ by = cy;
108
+ bz = cz;
109
+ }
110
+ }
111
+ if (within) {
112
+ const n = hull.faces[f].normal;
113
+ return {
114
+ distance: d,
115
+ point: { x: px - d * n.x, y: py - d * n.y, z: pz - d * n.z },
116
+ normal: d > hull.tolerance ? { x: n.x, y: n.y, z: n.z } : outward,
117
+ };
118
+ }
119
+ }
120
+ const best = Math.sqrt(least);
121
+ return {
122
+ distance: best,
123
+ point: { x: bx, y: by, z: bz },
124
+ normal: best > hull.tolerance
125
+ ? { x: (px - bx) / best, y: (py - by) / best, z: (pz - bz) / best }
126
+ : outward,
127
+ };
128
+ }
129
+ /** The numbers stored per edge. */
130
+ const EDGE = 11;
131
+ /** Each hull's flat form, released with the hull. */
132
+ const FLATS = new WeakMap();
133
+ /** The plane distances of the current query, reused by every call. */
134
+ let DISTANCES = new Float64Array(64);
135
+ /** A hull's flat form, built once. */
136
+ const flattened = (hull) => {
137
+ const known = FLATS.get(hull);
138
+ if (known !== undefined)
139
+ return known;
140
+ const planes = new Float64Array(4 * hull.faces.length);
141
+ const starts = new Int32Array(hull.faces.length + 1);
142
+ const total = hull.faces.reduce((sum, face) => sum + face.loop.length, 0);
143
+ const edges = new Float64Array(EDGE * total);
144
+ let e = 0;
145
+ hull.faces.forEach((face, f) => {
146
+ const n = face.normal;
147
+ planes.set([n.x, n.y, n.z, face.offset], 4 * f);
148
+ starts[f] = e;
149
+ face.loop.forEach((from, i) => {
150
+ const to = face.loop[(i + 1) % face.loop.length];
151
+ const ex = to.x - from.x;
152
+ const ey = to.y - from.y;
153
+ const ez = to.z - from.z;
154
+ const mx = n.y * ez - n.z * ey;
155
+ const my = n.z * ex - n.x * ez;
156
+ const mz = n.x * ey - n.y * ex;
157
+ edges.set([
158
+ from.x,
159
+ from.y,
160
+ from.z,
161
+ ex,
162
+ ey,
163
+ ez,
164
+ ex * ex + ey * ey + ez * ez,
165
+ mx,
166
+ my,
167
+ mz,
168
+ mx * from.x + my * from.y + mz * from.z,
169
+ ], EDGE * e);
170
+ e++;
171
+ });
172
+ });
173
+ starts[hull.faces.length] = e;
174
+ const flat = { planes, starts, edges };
175
+ FLATS.set(hull, flat);
176
+ return flat;
177
+ };
178
+ //# sourceMappingURL=physicalHullNearest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalHullNearest.js","sourceRoot":"","sources":["../../src/physics/physicalHullNearest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The unit parameter of the point of a segment nearest a convex hull, or
4
+ * deepest inside it, in the hull's own frame.
5
+ *
6
+ * Apart, the nearest pair of a hull and a segment is the point of their
7
+ * Minkowski difference nearest the origin, which the Gilbert-Johnson-Keerthi
8
+ * iteration finds exactly for two polytopes: each step adds the difference's
9
+ * support point against the current nearest point and keeps the face of the
10
+ * simplex nearest the origin (Ericson's region tests), and the segment
11
+ * parameter is the barycentric mix of the simplex's segment ends. Once the
12
+ * difference reaches within the hull's tolerance of the origin, the segment
13
+ * meets the hull, and its deepest point minimises the greatest face plane
14
+ * distance along it: a convex piecewise linear function of the parameter,
15
+ * whose least value the walk along its upper envelope reaches exactly. A
16
+ * segment that only grazes the hull within the tolerance takes the
17
+ * iteration's parameter: that of its nearest point, or of the origin's
18
+ * barycentric mix when a tetrahedron of the difference holds the origin.
19
+ *
20
+ * @param points The hull's shape-local points, metres, spanning a volume.
21
+ * @param a The segment's start, at parameter 0, in the same frame.
22
+ * @param b Its end, at parameter 1.
23
+ * @returns The parameter in [0, 1].
24
+ * @throws {Error} When the points span no volume.
25
+ *
26
+ * @evidence contracts/development/common.md#meaningful-documentation States both cases, the method of each, the parameter's meaning, the frame and the grazing case.
27
+ * @evidence contracts/development/implementation.md#principled-implementation The distance of two convex polytopes by Gilbert, Johnson and Keerthi (IEEE J Robot Autom 4:193, 1988) with the nearest point of a simplex by Voronoi region tests (Ericson, Real-Time Collision Detection, sections 5.1.5 and 5.1.6), and the deepest point as the one-variable linear program min over t of max over faces, solved by walking its upper envelope; both are exact for polytopes.
28
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of segment-to-hull proximity; `physicalShapeNearest` reads the point, normal and distance at this parameter from `physicalHullNearest`, the single owner of the point query.
29
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The only tolerance is the hull's own coplanarity tolerance, which separates a meeting from a gap; the iteration bound is the count of distinct support pairs, which the strictly shrinking nearest point cannot revisit. The non-null assertions index the simplex and the faces by bounded indices.
30
+ * @evidence contracts/development/implementation.md#efficient-algorithms A few support scans over the hull's vertices apart, and one pass over the faces per envelope piece within, in place of the 47 point queries of a golden-section search.
31
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the hull and the segment; the faces and vertices it reads are shared by `physicalHullFaces`.
32
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
33
+ */
34
+ export declare function physicalHullSegment(points: readonly IAutoMovieVector3[], a: IAutoMovieVector3, b: IAutoMovieVector3): number;
@@ -0,0 +1,276 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.physicalHullSegment = physicalHullSegment;
4
+ const physicalHullFaces_1 = require("./physicalHullFaces");
5
+ /**
6
+ * The unit parameter of the point of a segment nearest a convex hull, or
7
+ * deepest inside it, in the hull's own frame.
8
+ *
9
+ * Apart, the nearest pair of a hull and a segment is the point of their
10
+ * Minkowski difference nearest the origin, which the Gilbert-Johnson-Keerthi
11
+ * iteration finds exactly for two polytopes: each step adds the difference's
12
+ * support point against the current nearest point and keeps the face of the
13
+ * simplex nearest the origin (Ericson's region tests), and the segment
14
+ * parameter is the barycentric mix of the simplex's segment ends. Once the
15
+ * difference reaches within the hull's tolerance of the origin, the segment
16
+ * meets the hull, and its deepest point minimises the greatest face plane
17
+ * distance along it: a convex piecewise linear function of the parameter,
18
+ * whose least value the walk along its upper envelope reaches exactly. A
19
+ * segment that only grazes the hull within the tolerance takes the
20
+ * iteration's parameter: that of its nearest point, or of the origin's
21
+ * barycentric mix when a tetrahedron of the difference holds the origin.
22
+ *
23
+ * @param points The hull's shape-local points, metres, spanning a volume.
24
+ * @param a The segment's start, at parameter 0, in the same frame.
25
+ * @param b Its end, at parameter 1.
26
+ * @returns The parameter in [0, 1].
27
+ * @throws {Error} When the points span no volume.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States both cases, the method of each, the parameter's meaning, the frame and the grazing case.
30
+ * @evidence contracts/development/implementation.md#principled-implementation The distance of two convex polytopes by Gilbert, Johnson and Keerthi (IEEE J Robot Autom 4:193, 1988) with the nearest point of a simplex by Voronoi region tests (Ericson, Real-Time Collision Detection, sections 5.1.5 and 5.1.6), and the deepest point as the one-variable linear program min over t of max over faces, solved by walking its upper envelope; both are exact for polytopes.
31
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The single owner of segment-to-hull proximity; `physicalShapeNearest` reads the point, normal and distance at this parameter from `physicalHullNearest`, the single owner of the point query.
32
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The only tolerance is the hull's own coplanarity tolerance, which separates a meeting from a gap; the iteration bound is the count of distinct support pairs, which the strictly shrinking nearest point cannot revisit. The non-null assertions index the simplex and the faces by bounded indices.
33
+ * @evidence contracts/development/implementation.md#efficient-algorithms A few support scans over the hull's vertices apart, and one pass over the faces per envelope piece within, in place of the 47 point queries of a golden-section search.
34
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the hull and the segment; the faces and vertices it reads are shared by `physicalHullFaces`.
35
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; its temporaries die with the call.
36
+ */
37
+ function physicalHullSegment(points, a, b) {
38
+ const hull = (0, physicalHullFaces_1.physicalHullFaces)(points);
39
+ if (!hull.faces.length)
40
+ throw new Error("A hull must span a volume");
41
+ const support = (d) => {
42
+ let vertex = 0;
43
+ let most = -Infinity;
44
+ hull.vertices.forEach((p, i) => {
45
+ const along = dot(p, d);
46
+ if (along > most) {
47
+ most = along;
48
+ vertex = i;
49
+ }
50
+ });
51
+ const end = dot(d, a) <= dot(d, b) ? 0 : 1;
52
+ return { w: minus(hull.vertices[vertex], end === 0 ? a : b), vertex, end };
53
+ };
54
+ const first = support(minus(a, hull.centre));
55
+ let simplex = alone(first);
56
+ let v = first.w;
57
+ let parameter = first.end;
58
+ const limit = 2 * hull.vertices.length + 1;
59
+ for (let step = 0; step < limit; step++) {
60
+ const vv = dot(v, v);
61
+ if (vv <= hull.tolerance * hull.tolerance)
62
+ return deepest(hull, a, b) ?? parameter;
63
+ const next = support({ x: -v.x, y: -v.y, z: -v.z });
64
+ // The difference lies where v.x >= v.w, so |v| - v.w/|v| bounds the gap.
65
+ if (vv - dot(v, next.w) <= hull.tolerance * Math.sqrt(vv))
66
+ break;
67
+ if (simplex.some((s) => s.vertex === next.vertex && s.end === next.end))
68
+ break;
69
+ const grown = [...simplex, next];
70
+ const reduced = nearest(grown);
71
+ if (reduced === null)
72
+ return deepest(hull, a, b) ?? enclosing(grown) ?? parameter;
73
+ const u = combined(reduced);
74
+ if (!(dot(u, u) < vv))
75
+ break;
76
+ simplex = reduced;
77
+ v = u;
78
+ parameter = reduced.reduce((sum, s) => sum + s.weight * s.end, 0);
79
+ }
80
+ return Math.min(1, Math.max(0, parameter));
81
+ }
82
+ const dot = (p, q) => p.x * q.x + p.y * q.y + p.z * q.z;
83
+ const minus = (p, q) => ({ x: p.x - q.x, y: p.y - q.y, z: p.z - q.z });
84
+ const cross = (p, q) => ({
85
+ x: p.y * q.z - p.z * q.y,
86
+ y: p.z * q.x - p.x * q.z,
87
+ z: p.x * q.y - p.y * q.x,
88
+ });
89
+ const combined = (simplex) => simplex.reduce((sum, s) => ({
90
+ x: sum.x + s.weight * s.w.x,
91
+ y: sum.y + s.weight * s.w.y,
92
+ z: sum.z + s.weight * s.w.z,
93
+ }), { x: 0, y: 0, z: 0 });
94
+ const weighted = (pairs) => pairs
95
+ .filter(([, weight]) => weight > 0)
96
+ .map(([s, weight]) => ({
97
+ w: s.w,
98
+ vertex: s.vertex,
99
+ end: s.end,
100
+ weight,
101
+ }));
102
+ const alone = (s) => [
103
+ { w: s.w, vertex: s.vertex, end: s.end, weight: 1 },
104
+ ];
105
+ /**
106
+ * The smallest face of a simplex holding its point nearest the origin, with
107
+ * that point's weights; null when the origin lies inside a tetrahedron.
108
+ */
109
+ const nearest = (simplex) => {
110
+ if (simplex.length === 1)
111
+ return alone(simplex[0]);
112
+ if (simplex.length === 2)
113
+ return edge(simplex[0], simplex[1]);
114
+ if (simplex.length === 3)
115
+ return triangle(simplex[0], simplex[1], simplex[2]);
116
+ const p = simplex[0];
117
+ const q = simplex[1];
118
+ const r = simplex[2];
119
+ const s = simplex[3];
120
+ let best = null;
121
+ let least = Infinity;
122
+ // A face is a candidate when the origin lies beyond it from the fourth
123
+ // vertex; a flat tetrahedron offers every face.
124
+ for (const [i, j, k, opposite] of [
125
+ [p, q, r, s],
126
+ [p, r, s, q],
127
+ [p, s, q, r],
128
+ [q, s, r, p],
129
+ ]) {
130
+ const n = cross(minus(j.w, i.w), minus(k.w, i.w));
131
+ const side = dot(minus(opposite.w, i.w), n);
132
+ if (!(-dot(i.w, n) * side < 0) && side !== 0)
133
+ continue;
134
+ const face = triangle(i, j, k);
135
+ const u = combined(face);
136
+ if (dot(u, u) < least) {
137
+ least = dot(u, u);
138
+ best = face;
139
+ }
140
+ }
141
+ return best;
142
+ };
143
+ /**
144
+ * The segment parameter of the origin's barycentric mix in a tetrahedron of
145
+ * the difference that holds it, by its signed sub-volumes; null for a flat
146
+ * tetrahedron.
147
+ */
148
+ const enclosing = (simplex) => {
149
+ const volume = (p, q, r, s) => dot(minus(q, p), cross(minus(r, p), minus(s, p)));
150
+ const p = simplex[0].w;
151
+ const q = simplex[1].w;
152
+ const r = simplex[2].w;
153
+ const s = simplex[3].w;
154
+ const origin = { x: 0, y: 0, z: 0 };
155
+ const total = volume(p, q, r, s);
156
+ if (total === 0)
157
+ return null;
158
+ const weights = [
159
+ volume(origin, q, r, s),
160
+ volume(p, origin, r, s),
161
+ volume(p, q, origin, s),
162
+ volume(p, q, r, origin),
163
+ ];
164
+ return Math.min(1, Math.max(0, weights.reduce((sum, w, i) => sum + (w / total) * simplex[i].end, 0)));
165
+ };
166
+ /** The point of a segment of the difference nearest the origin. */
167
+ const edge = (p, q) => {
168
+ const e = minus(q.w, p.w);
169
+ const ee = dot(e, e);
170
+ const t = ee > 0 ? -dot(p.w, e) / ee : 0;
171
+ if (t <= 0)
172
+ return alone(p);
173
+ if (t >= 1)
174
+ return alone(q);
175
+ return weighted([
176
+ [p, 1 - t],
177
+ [q, t],
178
+ ]);
179
+ };
180
+ /** The point of a triangle of the difference nearest the origin (Ericson 5.1.5). */
181
+ const triangle = (p, q, r) => {
182
+ const ab = minus(q.w, p.w);
183
+ const ac = minus(r.w, p.w);
184
+ const d1 = -dot(ab, p.w);
185
+ const d2 = -dot(ac, p.w);
186
+ if (d1 <= 0 && d2 <= 0)
187
+ return alone(p);
188
+ const d3 = -dot(ab, q.w);
189
+ const d4 = -dot(ac, q.w);
190
+ if (d3 >= 0 && d4 <= d3)
191
+ return alone(q);
192
+ const vc = d1 * d4 - d3 * d2;
193
+ if (vc <= 0 && d1 >= 0 && d3 <= 0) {
194
+ const t = d1 / (d1 - d3);
195
+ return weighted([
196
+ [p, 1 - t],
197
+ [q, t],
198
+ ]);
199
+ }
200
+ const d5 = -dot(ab, r.w);
201
+ const d6 = -dot(ac, r.w);
202
+ if (d6 >= 0 && d5 <= d6)
203
+ return alone(r);
204
+ const vb = d5 * d2 - d1 * d6;
205
+ if (vb <= 0 && d2 >= 0 && d6 <= 0) {
206
+ const t = d2 / (d2 - d6);
207
+ return weighted([
208
+ [p, 1 - t],
209
+ [r, t],
210
+ ]);
211
+ }
212
+ const va = d3 * d6 - d5 * d4;
213
+ if (va <= 0 && d4 - d3 >= 0 && d5 - d6 >= 0) {
214
+ const t = (d4 - d3) / (d4 - d3 + (d5 - d6));
215
+ return weighted([
216
+ [q, 1 - t],
217
+ [r, t],
218
+ ]);
219
+ }
220
+ const total = va + vb + vc;
221
+ // A triangle of no area: the nearest of its edges.
222
+ if (!(total > 0)) {
223
+ let best = edge(p, q);
224
+ for (const candidate of [edge(q, r), edge(p, r)]) {
225
+ const u = combined(candidate);
226
+ const w = combined(best);
227
+ if (dot(u, u) < dot(w, w))
228
+ best = candidate;
229
+ }
230
+ return best;
231
+ }
232
+ return weighted([
233
+ [p, va / total],
234
+ [q, vb / total],
235
+ [r, vc / total],
236
+ ]);
237
+ };
238
+ /**
239
+ * The parameter minimising the greatest face plane distance along the
240
+ * segment, when that least value is not positive; null when the segment
241
+ * stays outside every face plane's reach, so it does not enter the hull.
242
+ */
243
+ const deepest = (hull, a, b) => {
244
+ const e = minus(b, a);
245
+ const level = hull.faces.map((f) => dot(f.normal, a) - f.offset);
246
+ const slope = hull.faces.map((f) => dot(f.normal, e));
247
+ // The plane greatest just after the start: the steepest among equals.
248
+ let current = 0;
249
+ level.forEach((l, f) => {
250
+ if (l > level[current] ||
251
+ (l === level[current] && slope[f] > slope[current]))
252
+ current = f;
253
+ });
254
+ let t = 0;
255
+ while (slope[current] < 0) {
256
+ let meet = 1;
257
+ let after = -1;
258
+ for (let f = 0; f < level.length; f++) {
259
+ if (!(slope[f] > slope[current]))
260
+ continue;
261
+ const s = (level[current] - level[f]) / (slope[f] - slope[current]);
262
+ if (s < meet || (s === meet && after >= 0 && slope[f] > slope[after])) {
263
+ meet = s;
264
+ after = f;
265
+ }
266
+ }
267
+ if (after < 0) {
268
+ t = 1;
269
+ break;
270
+ }
271
+ t = Math.max(t, meet);
272
+ current = after;
273
+ }
274
+ return level[current] + slope[current] * t > 0 ? null : t;
275
+ };
276
+ //# sourceMappingURL=physicalHullSegment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"physicalHullSegment.js","sourceRoot":"","sources":["../../src/physics/physicalHullSegment.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ import type { combinePhysicalMassProperties } from "./combinePhysicalMassProperties";
3
+ /**
4
+ * The inertia tensor of rigid parts about one point, in their common frame:
5
+ * each part's principal tensor turned into that frame, `R diag(I) R^T`, plus
6
+ * its mass moved to the point by the parallel-axis theorem, `m (|d|² E - d dᵀ)`
7
+ * with `d` the part's centre less the point.
8
+ *
9
+ * The one owner of that sum in the engine: `combinePhysicalMassProperties`
10
+ * reads it about the parts' combined centre, and the whole-body momentum of a
11
+ * posed body (`resolveAutoMovieMomentum`) about the body's centre of mass. A
12
+ * part may have zero principal moments, a point mass such as a held load; the
13
+ * caller admits its inputs, since what counts as admissible differs between
14
+ * them.
15
+ *
16
+ * @param parts The parts, each with its mass, centre and principal frame in the common frame.
17
+ * @param about The point the tensor is taken about, in the common frame.
18
+ * @returns The symmetric tensor, three rows of three, in the parts' mass and length units (kg m² for SI parts).
19
+ *
20
+ * @evidence contracts/development/common.md#meaningful-documentation States the two terms of the sum, the frame, the units, the zero-moment part and who admits the inputs.
21
+ * @evidence contracts/development/implementation.md#principled-implementation The rotation of a principal tensor into another frame, `R diag(I) R^T`, written as the sum over the principal axes `a_k` of `I_k a_k a_kᵀ`, and the parallel-axis (Huygens-Steiner) theorem for the shift of each part's mass to the point; both are exact, so the sum is the rigid assembly's tensor.
22
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One accumulation over the parts; the principal frame's axes are read once per part.
23
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No input is clamped or skipped: a non-finite input yields a non-finite tensor that the caller's admission refuses.
24
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the parts: three axis rotations and nine entries per part.
25
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its arguments with nothing to share between calls.
26
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned rows are fresh.
27
+ */
28
+ export declare function physicalInertiaTensor(parts: readonly combinePhysicalMassProperties.IPart[], about: IAutoMovieVector3): number[][];