@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,29 @@
1
+ import type { IAutoMovieContactReceipt } from "@automovie/interface";
2
+ import type { IAutoMovieMark } from "../geometry/IAutoMovieMark";
3
+ /**
4
+ * Turn the solved contacts acting at one second into inspection marks: one arrow per contact, at the contact point along its normal, as long as the mean force times a stated scale.
5
+ *
6
+ * A receipt acts at `seconds` when the solver measured it: its latest completed step at or before `seconds`, within that step's duration, has a positive finite impulse and no positive separation. The arrow starts at that step's point and runs along its normal, from the first collider toward the second, for `metresPerNewton` times the step's mean force, its impulse over its duration. Geometric receipts, which assert no impulse, draw nothing.
7
+ *
8
+ * The mark has kind `contact`, label `contact force`, colour teal `00c2a8` and path `<body>/<bone>/contact/<receipt id>` of the first collider, in world metres and unanchored.
9
+ *
10
+ * It throws for a scale that is not positive and finite and for an acting step without a positive duration.
11
+ *
12
+ * @param props.receipts Contact episodes, as the composition's contact measurement and the solver record them.
13
+ * @param props.seconds The drawn film second.
14
+ * @param props.metresPerNewton Arrow length per newton of mean force.
15
+ * @returns One mark per acting contact, in the receipts' order.
16
+ *
17
+ * @evidence contracts/development/common.md#meaningful-documentation States when a contact acts, how the arrow's place, direction and length follow from the step, what geometric receipts draw, the kind, label, colour, path and frame, and both refusals.
18
+ * @evidence contracts/development/implementation.md#principled-implementation A step's mean force is its normal impulse over its duration, so the arrow's length is a force on a stated scale; a step is read only once completed at or before the drawn second, so a still never shows a later impulse.
19
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the receipts, each scanned from its last step back to the drawn second.
20
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scale is the caller's stated parameter, and a step without a duration is refused instead of given an arbitrary length.
21
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the receipts' steps in the worst case; each receipt stops at its latest step at or before the second.
22
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one second.
23
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
24
+ */
25
+ export declare function markAutoMovieContacts(props: {
26
+ receipts: readonly IAutoMovieContactReceipt[];
27
+ seconds: number;
28
+ metresPerNewton: number;
29
+ }): IAutoMovieMark[];
@@ -0,0 +1,69 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.markAutoMovieContacts = markAutoMovieContacts;
4
+ /**
5
+ * Turn the solved contacts acting at one second into inspection marks: one arrow per contact, at the contact point along its normal, as long as the mean force times a stated scale.
6
+ *
7
+ * A receipt acts at `seconds` when the solver measured it: its latest completed step at or before `seconds`, within that step's duration, has a positive finite impulse and no positive separation. The arrow starts at that step's point and runs along its normal, from the first collider toward the second, for `metresPerNewton` times the step's mean force, its impulse over its duration. Geometric receipts, which assert no impulse, draw nothing.
8
+ *
9
+ * The mark has kind `contact`, label `contact force`, colour teal `00c2a8` and path `<body>/<bone>/contact/<receipt id>` of the first collider, in world metres and unanchored.
10
+ *
11
+ * It throws for a scale that is not positive and finite and for an acting step without a positive duration.
12
+ *
13
+ * @param props.receipts Contact episodes, as the composition's contact measurement and the solver record them.
14
+ * @param props.seconds The drawn film second.
15
+ * @param props.metresPerNewton Arrow length per newton of mean force.
16
+ * @returns One mark per acting contact, in the receipts' order.
17
+ *
18
+ * @evidence contracts/development/common.md#meaningful-documentation States when a contact acts, how the arrow's place, direction and length follow from the step, what geometric receipts draw, the kind, label, colour, path and frame, and both refusals.
19
+ * @evidence contracts/development/implementation.md#principled-implementation A step's mean force is its normal impulse over its duration, so the arrow's length is a force on a stated scale; a step is read only once completed at or before the drawn second, so a still never shows a later impulse.
20
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the receipts, each scanned from its last step back to the drawn second.
21
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scale is the caller's stated parameter, and a step without a duration is refused instead of given an arbitrary length.
22
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the receipts' steps in the worst case; each receipt stops at its latest step at or before the second.
23
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one second.
24
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
25
+ */
26
+ function markAutoMovieContacts(props) {
27
+ if (!(Number.isFinite(props.metresPerNewton) && props.metresPerNewton > 0))
28
+ throw new Error(`markAutoMovieContacts: metres per newton ${props.metresPerNewton} is not positive and finite`);
29
+ const marks = [];
30
+ for (const receipt of props.receipts) {
31
+ if (receipt.source !== "solver")
32
+ continue;
33
+ const steps = receipt.samples ?? [];
34
+ let step;
35
+ for (let i = steps.length - 1; i >= 0; i--)
36
+ if (steps[i].seconds <= props.seconds + 1e-9) {
37
+ step = steps[i];
38
+ break;
39
+ }
40
+ if (step === undefined ||
41
+ !(step.impulse > 0 && Number.isFinite(step.impulse)) ||
42
+ step.separation > 0)
43
+ continue;
44
+ if (!(step.duration > 0))
45
+ throw new Error(`markAutoMovieContacts: contact ${receipt.id} has a step without a positive duration`);
46
+ if (props.seconds - step.seconds >= step.duration)
47
+ continue;
48
+ const length = (step.impulse / step.duration) * props.metresPerNewton;
49
+ marks.push({
50
+ path: `${receipt.a.body}/${receipt.a.bone}/contact/${receipt.id}`,
51
+ kind: "contact",
52
+ label: "contact force",
53
+ color: 0x00c2a8,
54
+ shape: {
55
+ type: "arrows",
56
+ origins: [step.point.x, step.point.y, step.point.z],
57
+ vectors: [
58
+ step.normal.x * length,
59
+ step.normal.y * length,
60
+ step.normal.z * length,
61
+ ],
62
+ },
63
+ flagged: false,
64
+ anchor: null,
65
+ });
66
+ }
67
+ return marks;
68
+ }
69
+ //# sourceMappingURL=markAutoMovieContacts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markAutoMovieContacts.js","sourceRoot":"","sources":["../../src/composition/markAutoMovieContacts.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,+BAAsC,KAIrC;IACC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,4CAA4C,KAAK,CAAC,eAAe,6BAA6B,CAC/F,CAAC;IACJ,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,KAAK,GACT,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACxB,IAAI,IAAwC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAW,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAChD,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;gBAC9C,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,IACE,IAAI,KAAK,SAAS;YAClB,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,GAAG,CAAC;YAEnB,SAAS;QACX,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,CAAC,EAAE,yCAAyC,CACtF,CAAC;QACJ,IAAI,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,SAAS;QAC5D,MAAM,MAAM,GACV,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,YAAY,OAAO,CAAC,EAAE,EAAE;YACjE,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnD,OAAO,EAAE;oBACP,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM;oBACtB,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM;oBACtB,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM;iBACvB;aACF;YACD,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -8,7 +8,9 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
8
8
  * takes until it meets something), or a capsule, a segment swept by that
9
9
  * radius, when it also gives the axis's other end: a shin, a forearm, any
10
10
  * limb segment that strikes along its length, so another body crossing the
11
- * segment between its ends is met, not passed between sparse points. Every
11
+ * segment between its ends is met, not passed between sparse points; a
12
+ * tapered capsule's radius runs linearly from one end to the other, as a
13
+ * limb narrows from one joint to the next. Every
12
14
  * body is a signed distance at a second, from a point and, for capsule
13
15
  * weapons, from a segment (the least signed distance over the segment's
14
16
  * points). Both may depend on which weapons have already stopped, because a
@@ -23,24 +25,41 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
23
25
  * bisections of the first crossing, so the result is deterministic; a
24
26
  * contact shorter than one step (a weapon and a body passing through each
25
27
  * other within it) is the scan's stated blind spot, so the step must stay
26
- * below the time either needs to cross the other's thickness. Ties in
28
+ * below the time either needs to cross the other's thickness. A weapon
29
+ * that states the span it is live in (`from`, `to`) is scanned only on the
30
+ * scan's own steps that reach into that span, since outside it the weapon
31
+ * meets nothing; the steps are the same as a scan of the whole span, so the
32
+ * result is too, and a performance of many strikes scans each strike over
33
+ * its own window instead of over the whole performance. Since only the
34
+ * earliest impact is stopped, each round scans the weapons in the order
35
+ * they become live and no weapon past the earliest impact found so far: one
36
+ * that becomes live after it cannot be earlier. Ties in
27
37
  * time are broken by the weapons' ids, and a weapon that touches the moment
28
38
  * another stops is stopped at that same second, so the result does not
29
39
  * depend on the order the weapons are listed in.
30
40
  *
41
+ * A contact is mutual. A weapon and the body that carries it are two
42
+ * measures of one limb (a capsule and that body's signed distance), and they
43
+ * need not agree to the millimetre, so of two limbs swung into each other
44
+ * one weapon touches the other body before the other weapon touches back.
45
+ * When the part a weapon meets carries a weapon of its own that is still
46
+ * moving (the body says so through `carried`), that weapon stops at the same
47
+ * second against the striker's body: neither limb is driven on into the one
48
+ * that has already stopped on it.
49
+ *
31
50
  * This resolves simultaneous strikes consistently: two fists crossing each
32
51
  * other's arms, two shins meeting, a block that arrives first. It is a
33
52
  * kinematic resolution of contact times, not a force simulation.
34
53
  *
35
54
  * @param input The weapons, the bodies and the span.
36
55
  * @returns The stops, in time order.
37
- * @throws {Error} When the span or the step is not positive, a weapon id repeats, or a capsule weapon meets a body that measures no segment.
56
+ * @throws {Error} When the span or the step is not positive, a weapon id repeats, a weapon's live span is not finite or ends before it begins, a tail radius is given without a tail or is not a finite non-negative length, a capsule weapon meets a body that measures no segment, or a body names a carried weapon that is not its own.
38
57
  *
39
58
  * @evidence contracts/development/common.md#meaningful-documentation States the method, its determinism, its tie rule and what it does not model.
40
59
  * @evidence contracts/development/implementation.md#principled-implementation The time-ordered event loop of impulse-based simulation over continuous first-impact times.
41
60
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over events and one first-impact search.
42
61
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Invalid spans, steps and repeated ids throw, and a capsule weapon is never reduced to its end points when a body cannot measure a segment: that throws.
43
- * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons: quadratic in weapons times the scan's samples, for the handful of weapons one exchange holds.
62
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons, each over the scan's samples inside its own live span and no later than the earliest impact found in that round: a performance of many strikes in sequence costs in proportion to its strikes, where scanning every weapon over the whole span after every event cost the square of them.
44
63
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; callers memoise.
45
64
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
46
65
  */
@@ -49,7 +68,7 @@ export declare function resolveAutoMovieContactEvents(input: resolveAutoMovieCon
49
68
  * Companion types of {@link resolveAutoMovieContactEvents}.
50
69
  *
51
70
  * @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
52
- * @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
71
+ * @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end, and an optional radius there for a tapered one), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
53
72
  * @evidence contracts/development/design.md#minimal-and-owned-surface What callers provide and read.
54
73
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface vector.
55
74
  */
@@ -62,8 +81,19 @@ export declare namespace resolveAutoMovieContactEvents {
62
81
  id: string;
63
82
  /** The body carrying it, whose own distance it ignores. */
64
83
  owner: string;
65
- /** The sphere's radius, metres. */
84
+ /** The sphere's radius, metres; a capsule's radius at `position`. */
66
85
  radius: number;
86
+ /**
87
+ * A tapered capsule's radius at `tail`, metres: the capsule then narrows
88
+ * (or widens) linearly from `radius` at `position` to this, the round
89
+ * cone of a limb whose girth changes from one joint to the next. Absent
90
+ * for a sphere and for a capsule of one radius.
91
+ */
92
+ tailRadius?: number;
93
+ /** When the weapon starts to be live, seconds, finite; it meets nothing before, whatever its path says. The span's start when absent. */
94
+ from?: number;
95
+ /** When it stops being live, seconds, finite and not before `from`; it meets nothing after, whatever its path says. The span's end when absent. */
96
+ to?: number;
67
97
  /**
68
98
  * The sphere's centre on its free path at a second, world metres.
69
99
  *
@@ -101,14 +131,33 @@ export declare namespace resolveAutoMovieContactEvents {
101
131
  * The signed distance from a segment to the body's surface at a second,
102
132
  * metres: the least signed distance over the segment's points, positive
103
133
  * when the whole segment is outside. Required to meet capsule weapons.
134
+ * Given a taper, the segment is widened by a radius running linearly
135
+ * from its first end's to its other end's, and the distance is that
136
+ * tapered capsule's: the least over its points of the distance less the
137
+ * radius there.
104
138
  *
105
139
  * @param a The segment's first end, world metres.
106
140
  * @param b Its other end, world metres.
107
141
  * @param seconds Seconds.
108
142
  * @param stops The stops so far.
143
+ * @param taper The radii at `a` and at `b`, metres, for a tapered capsule weapon.
109
144
  * @returns Metres.
110
145
  */
111
- axis?(a: IAutoMovieVector3, b: IAutoMovieVector3, seconds: number, stops: IStops): number;
146
+ axis?(a: IAutoMovieVector3, b: IAutoMovieVector3, seconds: number, stops: IStops, taper?: readonly [number, number]): number;
147
+ /**
148
+ * The body's own weapon carried by the part a striking weapon met, when
149
+ * that weapon is still on its free path at the second: the contact is
150
+ * mutual, so it stops with the striker. Absent, or undefined, when the
151
+ * part met carries none.
152
+ *
153
+ * @param a The striking weapon's centre, or its axis's first end, world metres.
154
+ * @param b The axis's other end; the centre again for a sphere.
155
+ * @param seconds The contact second.
156
+ * @param stops The stops before this contact.
157
+ * @param by The id of the body carrying the striking weapon.
158
+ * @returns The id of one of this body's weapons, or undefined.
159
+ */
160
+ carried?(a: IAutoMovieVector3, b: IAutoMovieVector3, seconds: number, stops: IStops, by: string): string | undefined;
112
161
  }
113
162
  /** The input. */
114
163
  interface IInput {
@@ -10,7 +10,9 @@ exports.resolveAutoMovieContactEvents = resolveAutoMovieContactEvents;
10
10
  * takes until it meets something), or a capsule, a segment swept by that
11
11
  * radius, when it also gives the axis's other end: a shin, a forearm, any
12
12
  * limb segment that strikes along its length, so another body crossing the
13
- * segment between its ends is met, not passed between sparse points. Every
13
+ * segment between its ends is met, not passed between sparse points; a
14
+ * tapered capsule's radius runs linearly from one end to the other, as a
15
+ * limb narrows from one joint to the next. Every
14
16
  * body is a signed distance at a second, from a point and, for capsule
15
17
  * weapons, from a segment (the least signed distance over the segment's
16
18
  * points). Both may depend on which weapons have already stopped, because a
@@ -25,24 +27,41 @@ exports.resolveAutoMovieContactEvents = resolveAutoMovieContactEvents;
25
27
  * bisections of the first crossing, so the result is deterministic; a
26
28
  * contact shorter than one step (a weapon and a body passing through each
27
29
  * other within it) is the scan's stated blind spot, so the step must stay
28
- * below the time either needs to cross the other's thickness. Ties in
30
+ * below the time either needs to cross the other's thickness. A weapon
31
+ * that states the span it is live in (`from`, `to`) is scanned only on the
32
+ * scan's own steps that reach into that span, since outside it the weapon
33
+ * meets nothing; the steps are the same as a scan of the whole span, so the
34
+ * result is too, and a performance of many strikes scans each strike over
35
+ * its own window instead of over the whole performance. Since only the
36
+ * earliest impact is stopped, each round scans the weapons in the order
37
+ * they become live and no weapon past the earliest impact found so far: one
38
+ * that becomes live after it cannot be earlier. Ties in
29
39
  * time are broken by the weapons' ids, and a weapon that touches the moment
30
40
  * another stops is stopped at that same second, so the result does not
31
41
  * depend on the order the weapons are listed in.
32
42
  *
43
+ * A contact is mutual. A weapon and the body that carries it are two
44
+ * measures of one limb (a capsule and that body's signed distance), and they
45
+ * need not agree to the millimetre, so of two limbs swung into each other
46
+ * one weapon touches the other body before the other weapon touches back.
47
+ * When the part a weapon meets carries a weapon of its own that is still
48
+ * moving (the body says so through `carried`), that weapon stops at the same
49
+ * second against the striker's body: neither limb is driven on into the one
50
+ * that has already stopped on it.
51
+ *
33
52
  * This resolves simultaneous strikes consistently: two fists crossing each
34
53
  * other's arms, two shins meeting, a block that arrives first. It is a
35
54
  * kinematic resolution of contact times, not a force simulation.
36
55
  *
37
56
  * @param input The weapons, the bodies and the span.
38
57
  * @returns The stops, in time order.
39
- * @throws {Error} When the span or the step is not positive, a weapon id repeats, or a capsule weapon meets a body that measures no segment.
58
+ * @throws {Error} When the span or the step is not positive, a weapon id repeats, a weapon's live span is not finite or ends before it begins, a tail radius is given without a tail or is not a finite non-negative length, a capsule weapon meets a body that measures no segment, or a body names a carried weapon that is not its own.
40
59
  *
41
60
  * @evidence contracts/development/common.md#meaningful-documentation States the method, its determinism, its tie rule and what it does not model.
42
61
  * @evidence contracts/development/implementation.md#principled-implementation The time-ordered event loop of impulse-based simulation over continuous first-impact times.
43
62
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over events and one first-impact search.
44
63
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Invalid spans, steps and repeated ids throw, and a capsule weapon is never reduced to its end points when a body cannot measure a segment: that throws.
45
- * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons: quadratic in weapons times the scan's samples, for the handful of weapons one exchange holds.
64
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons, each over the scan's samples inside its own live span and no later than the earliest impact found in that round: a performance of many strikes in sequence costs in proportion to its strikes, where scanning every weapon over the whole span after every event cost the square of them.
46
65
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; callers memoise.
47
66
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
48
67
  */
@@ -56,30 +75,69 @@ function resolveAutoMovieContactEvents(input) {
56
75
  if (ids.has(w.id))
57
76
  throw new Error(`Repeated contact weapon ${w.id}`);
58
77
  ids.add(w.id);
78
+ if ((w.from !== undefined && !Number.isFinite(w.from)) ||
79
+ (w.to !== undefined && !Number.isFinite(w.to)) ||
80
+ (w.from !== undefined && w.to !== undefined && w.to < w.from))
81
+ throw new Error(`Contact weapon ${w.id} has a live span that is not finite or ends before it begins`);
82
+ if (w.tailRadius !== undefined &&
83
+ (w.tail === undefined ||
84
+ !Number.isFinite(w.tailRadius) ||
85
+ w.tailRadius < 0))
86
+ throw new Error(`Contact weapon ${w.id} has a tail radius without a tail, or one that is not a finite non-negative length`);
59
87
  }
60
88
  const stopped = new Map();
61
89
  const events = [];
62
- const weapons = [...input.weapons].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
90
+ // In the order the weapons become live, so the earliest impact is found
91
+ // early and bounds the scans after it; ties in time go to the lesser id.
92
+ const weapons = [
93
+ ...input.weapons,
94
+ ].sort((a, b) => (a.from ?? -Infinity) - (b.from ?? -Infinity) ||
95
+ (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
63
96
  for (;;) {
64
97
  let best;
65
98
  const after = events.at(-1)?.seconds ?? input.from;
66
99
  for (const weapon of weapons) {
67
100
  if (stopped.has(weapon.id))
68
101
  continue;
69
- const hit = firstImpact(weapon, input, stopped, Math.max(input.from, after));
102
+ if (best !== undefined && (weapon.from ?? -Infinity) > best.seconds)
103
+ break;
104
+ const hit = firstImpact(weapon, input, stopped, Math.max(input.from, after), best?.seconds ?? Infinity);
70
105
  if (hit !== undefined &&
71
- (best === undefined || hit.seconds < best.seconds))
106
+ (best === undefined ||
107
+ hit.seconds < best.seconds ||
108
+ (hit.seconds === best.seconds && weapon.id < best.weapon)))
72
109
  best = { weapon: weapon.id, ...hit };
73
110
  }
74
111
  if (best === undefined)
75
112
  return events;
113
+ // The contact is mutual: when the part met carries a weapon of its own
114
+ // that is still moving, that weapon has met the striker in the same
115
+ // touch and stops at the same second.
116
+ const striker = weapons.find((w) => w.id === best.weapon);
117
+ const p = striker.position(best.seconds, stopped);
118
+ const own = input.bodies
119
+ .find((b) => b.id === best.against)
120
+ ?.carried?.(p, striker.tail?.(best.seconds, stopped) ?? p, best.seconds, stopped, striker.owner);
76
121
  stopped.set(best.weapon, best.seconds);
77
122
  events.push(best);
123
+ if (own === undefined)
124
+ continue;
125
+ if (!weapons.some((w) => w.id === own && w.owner === best.against))
126
+ throw new Error(`Body ${best.against} carries no contact weapon ${own}`);
127
+ if (stopped.has(own))
128
+ continue;
129
+ stopped.set(own, best.seconds);
130
+ events.push({ weapon: own, against: striker.owner, seconds: best.seconds });
78
131
  }
79
132
  }
80
- /** A weapon's first impact from a second on, against the bodies it does not belong to. */
81
- function firstImpact(weapon, input, stops, from) {
133
+ /** A weapon's first impact from a second on, against the bodies it does not belong to; undefined when it has none, or none before `horizon`. */
134
+ function firstImpact(weapon, input, stops, from, horizon) {
135
+ const live = weapon.from ?? -Infinity;
136
+ const until = Math.min(input.to, weapon.to ?? Infinity);
82
137
  const gap = (t) => {
138
+ // Outside its live span the weapon meets nothing, whatever its path.
139
+ if (t < live || t > (weapon.to ?? Infinity))
140
+ return { distance: Infinity, against: "" };
83
141
  const p = weapon.position(t, stops);
84
142
  const q = weapon.tail?.(t, stops);
85
143
  let best = {
@@ -94,19 +152,32 @@ function firstImpact(weapon, input, stops, from) {
94
152
  // representation exists to remove.
95
153
  if (q !== undefined && body.axis === undefined)
96
154
  throw new Error(`Body ${body.id} measures no segment for capsule weapon ${weapon.id}`);
97
- const d = (q === undefined
98
- ? body.distance(p, t, stops)
99
- : body.axis(p, q, t, stops)) - weapon.radius;
155
+ const d = q === undefined
156
+ ? body.distance(p, t, stops) - weapon.radius
157
+ : weapon.tailRadius === undefined
158
+ ? body.axis(p, q, t, stops) - weapon.radius
159
+ : body.axis(p, q, t, stops, [weapon.radius, weapon.tailRadius]);
100
160
  if (d < best.distance)
101
161
  best = { distance: d, against: body.id };
102
162
  }
103
163
  return best;
104
164
  };
105
- const start = gap(from);
106
- if (start.distance <= 0)
107
- return { against: start.against, seconds: from };
108
- let previous = from;
109
- for (let k = 1;; k++) {
165
+ // Outside its live span the weapon meets nothing, so the scan starts at
166
+ // the last of its steps before that span and ends at the first step past
167
+ // it: the same steps, and so the same result, as scanning from `from`.
168
+ if (until < from)
169
+ return undefined;
170
+ const first = live > from ? Math.max(1, Math.floor((live - from) / input.step)) : 1;
171
+ if (first === 1) {
172
+ const start = gap(from);
173
+ if (start.distance <= 0)
174
+ return { against: start.against, seconds: from };
175
+ }
176
+ let previous = first === 1 ? from : from + (first - 1) * input.step;
177
+ for (let k = first;; k++) {
178
+ // An impact found past this step would come after `horizon`.
179
+ if (previous >= horizon)
180
+ return undefined;
110
181
  const t = Math.min(input.to, from + k * input.step);
111
182
  if (gap(t).distance <= 0) {
112
183
  let lo = previous;
@@ -120,7 +191,7 @@ function firstImpact(weapon, input, stops, from) {
120
191
  }
121
192
  return { against: gap(hi).against, seconds: hi };
122
193
  }
123
- if (t >= input.to)
194
+ if (t >= until)
124
195
  return undefined;
125
196
  previous = t;
126
197
  }
@@ -1 +1 @@
1
- {"version":3,"file":"resolveAutoMovieContactEvents.js","sourceRoot":"","sources":["../../src/composition/resolveAutoMovieContactEvents.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resolveAutoMovieContactEvents.js","sourceRoot":"","sources":["../../src/composition/resolveAutoMovieContactEvents.ts"],"names":[],"mappings":"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"}
@@ -5,46 +5,62 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
5
5
  *
6
6
  * Neither person's goal is the other's hand, which moves; both aim at one
7
7
  * shared point both can reach comfortably, the way joint-action studies find
8
- * people converge on it. Horizontally it is the midpoint between the two
9
- * acting shoulders: human-human handovers take place at the midpoint between
10
- * the partners (Hansen et al. 2017, Human-human handover tasks and how
11
- * distance and object mass matter, Perceptual and Motor Skills 124(1), reviewed
12
- * by Kopnarski et al. 2023, Front. Psychol. 14:1147296), and each person then
13
- * travels the same horizontal share. Vertically it is the mean of the two
14
- * heights at which each person's hand would hang at that horizontal distance
15
- * with the arm at its comfortable reach `reach` (the shoulder-to-hand distance
16
- * of the family's working elbow flexion): `y = shoulder.y - sqrt(reach^2 -
17
- * h^2)` for a half gap `h`, or the shoulder's own height when `h` exceeds the
18
- * comfortable reach. A taller partner therefore raises the point, as the
8
+ * people converge on it. Each person has a comfortable reach, the
9
+ * shoulder-to-hand distance of the family's working elbow flexion, and the
10
+ * point is where both arms are at it at once: in the vertical plane through
11
+ * the two acting shoulders, the lower of the two points that lie one
12
+ * comfortable reach from each shoulder, so the hands meet below the line
13
+ * between the shoulders. For two equal people that is the midpoint between
14
+ * them, where human-human handovers take place (Hansen et al. 2017,
15
+ * Human-human handover tasks and how distance and object mass matter,
16
+ * Perceptual and Motor Skills 124(1), reviewed by Kopnarski et al. 2023,
17
+ * Front. Psychol. 14:1147296), `sqrt(reach^2 - h^2)` below the shoulders at
18
+ * the horizontal half gap `h`. Between people of unequal stature the same
19
+ * rule moves the point up and toward the taller one, who reaches down more
20
+ * steeply and less far forward while the shorter one reaches forward: the
19
21
  * exchange height rises with stature (Sutiphotinun et al. 2020, reviewed by
20
- * Kopnarski 2023), and either partner's comfortable reach is honoured on
21
- * average. When the partners' statures differ so much that this mean lies
22
- * beyond one straight arm (a child and a tall adult), the height moves to the
23
- * nearest one inside the band of heights both straight arms reach at that
24
- * horizontal distance, so the shorter partner reaches up or the taller down
25
- * only as far as the other cannot.
22
+ * Kopnarski 2023). The rule for unequal partners is provisional, as no study
23
+ * of the clasp point of partners of unequal stature or arm length was
24
+ * located; it replaces a horizontal division with a mean height that left
25
+ * the taller partner's arm straight at the end of its reach.
26
26
  *
27
- * A meeting is refused, not stretched, when no height lies within both
28
- * straight arms' reach: the error gives both limits and the widest shoulder
29
- * gap the pair can close (the band only narrows as the gap widens, so it is
30
- * found by bisection), so the author moves the people instead of receiving
31
- * an arm torn off its shoulder.
27
+ * Shoulders farther apart than the two comfortable reaches leave no such
28
+ * point, so both arms extend by one common factor of their comfortable
29
+ * reaches and the hands meet on the line between the shoulders; shoulders
30
+ * nearer than the difference of the reaches shorten both the same way. An
31
+ * action that has its own preferred contact height (`height`, as an object
32
+ * is handed over at chest height) passes it: the point then lies at that
33
+ * height where both arms are the same fraction of their comfortable reaches
34
+ * (by bisection along the horizontal line between the shoulders, on which
35
+ * one distance grows as the other shrinks), and the height is moved to the
36
+ * nearest one inside the band both straight arms reach there.
37
+ *
38
+ * A meeting is refused, not stretched, when it lies beyond a straight arm:
39
+ * the error gives both limits and the widest horizontal shoulder gap the
40
+ * pair can close, so the author moves the people instead of receiving an arm
41
+ * torn off its shoulder.
32
42
  *
33
43
  * @param input Both sides' acting shoulders and reaches.
34
44
  * @returns The meeting point and each side's shoulder distance to it.
35
- * @throws {Error} When a reach is not positive, a comfortable reach exceeds its limit, or the point lies beyond a limit.
45
+ * @throws {Error} When a reach is not positive or exceeds its limit, the shoulders coincide, or the point lies beyond a limit.
36
46
  *
37
- * @evidence contracts/development/common.md#meaningful-documentation States the horizontal and vertical rules with their sources, the frame and units, and the refusal.
38
- * @evidence contracts/development/implementation.md#principled-implementation Midpoint location (Hansen 2017) and a comfortable-reach hand height from the right triangle of the arm, the shoulder height and the half gap.
39
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One closed-form point projected into one reachable band, and one feasibility check.
40
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm; the projection only moves the height inside both arms' reach.
41
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant work; a refusal adds a fixed 50-step bisection.
47
+ * @evidence contracts/development/common.md#meaningful-documentation States the rule with its sources, the wide and the preferred-height cases, the frame and units, and the refusal.
48
+ * @evidence contracts/development/implementation.md#principled-implementation The midpoint of equal arms (Hansen 2017) generalised to the one point at which both arms hold their comfortable reach: the intersection of two spheres in the shoulders' vertical plane.
49
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One common extension factor, one two-circle intersection, and for a preferred height one bisection and one band.
50
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm; a preferred height only moves inside both arms' reach.
51
+ * @evidence contracts/development/implementation.md#efficient-algorithms Closed form; a preferred height adds a fixed 50-step bisection, and its refusal another.
42
52
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input.
43
53
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Allocates its result only.
44
54
  */
45
55
  export declare function resolveAutoMovieMutualGoal(input: {
46
56
  /** One person. */ a: resolveAutoMovieMutualGoal.ISide;
47
57
  /** The other person. */ b: resolveAutoMovieMutualGoal.ISide;
58
+ /**
59
+ * The height the action itself prefers for the contact, world metres, when
60
+ * it has one (an object handed over at chest height): the point lies at it,
61
+ * or at the nearest height both straight arms reach.
62
+ */
63
+ height?: number;
48
64
  }): resolveAutoMovieMutualGoal.IGoal;
49
65
  /**
50
66
  * Companion types of {@link resolveAutoMovieMutualGoal}.
@@ -52,7 +68,7 @@ export declare function resolveAutoMovieMutualGoal(input: {
52
68
  * @evidence contracts/development/common.md#meaningful-documentation Documents each member's unit and frame.
53
69
  * @evidence contracts/development/design.md#principled-representation A world shoulder with two reach lengths per side; a world point with two distances.
54
70
  * @evidence contracts/development/design.md#minimal-and-owned-surface What a two-person reaching law passes and reads.
55
- * @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and its arm lengths.
71
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and two lengths.
56
72
  */
57
73
  export declare namespace resolveAutoMovieMutualGoal {
58
74
  /** One person's acting arm. */