@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,141 @@
1
+ import { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
+ import { IAutoMovieChainBone } from "./IAutoMovieChainBone";
3
+ /**
4
+ * The geometry of a two-bone chain whose mid joint bends only about its own
5
+ * hinge, as `hingedArmArticulation` poses it: the hinge angles that reach a
6
+ * target's distance (the chain's bend branches, each stopped inside the mid
7
+ * joint's range), and the root rotation that aims the chain at the target
8
+ * and then turns it by a swivel about its own root-to-effector line, which
9
+ * leaves the effector where it is (Tolani, Goswami and Badler 2000). A
10
+ * swivel and a branch name one pose of the chain for any target, so a
11
+ * caller that holds them while the target moves poses the chain exactly as
12
+ * the articulation does, and `read` recovers them from a posed chain.
13
+ *
14
+ * @evidence contracts/development/common.md#meaningful-documentation States the branches, the aim and swivel, and what a held swivel means.
15
+ * @evidence contracts/development/design.md#principled-representation The swivel parameterisation of Tolani, Goswami and Badler 2000: a hinge angle per branch and a swivel about the root-to-effector line.
16
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The chain, the swivel and three functions: the branches, the pose and its reading; `hingedArmArticulation` poses its candidates through them.
17
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `aimRotation`; the scoring and the sweep stay with `hingedArmArticulation`.
18
+ */
19
+ export declare namespace hingedArmSwivel {
20
+ /**
21
+ * Swivel resolution of `hingedArmArticulation`'s candidate sweep, in
22
+ * degrees.
23
+ *
24
+ * Every candidate lands the effector on the same point, so the step decides
25
+ * only which of the equally exact poses is chosen, never how close the hand
26
+ * gets. One degree gives 360 candidates per bend branch, and the solve runs
27
+ * once per authored action rather than per frame.
28
+ */
29
+ const STEP: number;
30
+ /** The golden-section ratio, `(sqrt(5) - 1) / 2`, by which each refinement pass shrinks the swivel bracket. */
31
+ const GOLDEN: number;
32
+ /**
33
+ * Golden-section passes refining the swivel inside the two-step bracket
34
+ * around each local minimum of the sweep: the fewest that shrink the
35
+ * bracket, `2 STEP`, by `GOLDEN` a pass to within the joint's tolerance
36
+ * (`ROM_TOLERANCE`), since a swivel turns the chain root's joint by itself
37
+ * and a solver need resolve a joint's angle no finer.
38
+ */
39
+ const REFINEMENTS: number;
40
+ /** The width the refinement leaves of a swivel's bracket, degrees: the two-step bracket shrunk by `GOLDEN` per pass, the swivel's resolution, within `ROM_TOLERANCE`. */
41
+ const RESOLUTION: number;
42
+ /**
43
+ * A hinged chain toward a target.
44
+ *
45
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its frame.
46
+ * @evidence contracts/development/design.md#principled-representation The chain's rest geometry, its root's frame and the target, as `hingedArmArticulation` takes them.
47
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Seven members.
48
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `IAutoMovieChainBone`.
49
+ */
50
+ interface IChain {
51
+ /** Chain-root bone (the shoulder or the hip) resolved under the rig's rest FK. */
52
+ upper: IAutoMovieChainBone;
53
+ /** Mid bone's rest offset from the chain root, in the root's bone frame. */
54
+ midOffset: IAutoMovieVector3;
55
+ /** Mid bone's rest rotation relative to the chain root. */
56
+ midRest: IAutoMovieQuaternion;
57
+ /** Effector's rest offset from the mid joint, in the mid bone's frame. */
58
+ endOffset: IAutoMovieVector3;
59
+ /** The mid joint's flexion axis in the mid bone's frame; any length. */
60
+ hinge: IAutoMovieVector3;
61
+ /** World target the effector should land on. */
62
+ target: IAutoMovieVector3;
63
+ /** The mid joint's legal rotation about `hinge`, radians, `min <= max` and no wider than a full turn; every hinge angle is legal when absent. */
64
+ range?: {
65
+ min: number;
66
+ max: number;
67
+ };
68
+ }
69
+ /**
70
+ * One bend branch after the hinge's range.
71
+ *
72
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its unit.
73
+ * @evidence contracts/development/design.md#principled-representation A hinge angle and how far short of the target it stops.
74
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members.
75
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None.
76
+ */
77
+ interface IStop {
78
+ /** The hinge angle, radians, inside the range when one is given. */
79
+ theta: number;
80
+ /** Metres between the chain's span at `theta` and the target distance; `0` for a branch that reaches the distance inside the range. */
81
+ shortfall: number;
82
+ }
83
+ /**
84
+ * The chain's bend branches toward its target: the two hinge angles whose
85
+ * span is the target's distance, `phase + acos` first, or the fully
86
+ * extended or folded one outside the span, each stopped at the nearer limit
87
+ * of the range.
88
+ *
89
+ * @param chain The chain.
90
+ * @returns The branches, in that order, or null for a degenerate chain (`hingedArmArticulation`).
91
+ *
92
+ * @evidence contracts/development/common.md#meaningful-documentation States the order, the stops and the null.
93
+ * @evidence contracts/development/implementation.md#principled-implementation The span is an exact sinusoid in the hinge angle, so its two arccos roots are the only hinge angles reaching the distance.
94
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The sinusoid, its roots, then the range.
95
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The degeneracy thresholds are the engine's shared length scale.
96
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
97
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
98
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
99
+ */
100
+ function branches(chain: IChain): IStop[] | null;
101
+ /**
102
+ * The chain posed at a hinge angle, for any swivel: the mid joint turned by
103
+ * the hinge angle, the root aimed so the chain's root-to-effector line
104
+ * points at the target (`aimRotation`), then turned about that line by the
105
+ * swivel.
106
+ *
107
+ * @param chain The chain.
108
+ * @param theta The hinge angle, radians.
109
+ * @returns The bone-local root and mid rotations at a swivel about the root-to-effector line, degrees.
110
+ *
111
+ * @evidence contracts/development/common.md#meaningful-documentation States the order of the turns and the units.
112
+ * @evidence contracts/development/implementation.md#principled-implementation The swivel about the root-to-effector line is an exact null space of the effector's position.
113
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The hinge, the line and the aim once, then the swivel per call.
114
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
115
+ * @evidence contracts/development/implementation.md#efficient-algorithms The mid direction and the aim are read once for every swivel of a branch.
116
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `aimRotation`.
117
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the branch's mid rotation, line and aim in the returned function only.
118
+ */
119
+ function pose(chain: IChain, theta: number): (swivel: number) => {
120
+ upper: IAutoMovieQuaternion;
121
+ lower: IAutoMovieQuaternion;
122
+ };
123
+ /**
124
+ * The swivel of a posed chain: the root's turn about the chain's
125
+ * root-to-effector line past the aim `pose` gives for its hinge angle.
126
+ *
127
+ * @param chain The chain, its target where the posed effector lies.
128
+ * @param upper The posed bone-local root rotation.
129
+ * @param theta The posed hinge angle, radians.
130
+ * @returns Degrees, in (-180, 180].
131
+ *
132
+ * @evidence contracts/development/common.md#meaningful-documentation States what is read and its range.
133
+ * @evidence contracts/development/implementation.md#principled-implementation The inverse of `pose`: the aim removed, the rest is a turn about the line.
134
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The aim, the remainder, its angle.
135
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
136
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
137
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares `pose`'s aim.
138
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
139
+ */
140
+ function read(chain: IChain, upper: IAutoMovieQuaternion, theta: number): number;
141
+ }
@@ -0,0 +1,196 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.hingedArmSwivel = void 0;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
7
+ const aimRotation_1 = require("./aimRotation");
8
+ /**
9
+ * The geometry of a two-bone chain whose mid joint bends only about its own
10
+ * hinge, as `hingedArmArticulation` poses it: the hinge angles that reach a
11
+ * target's distance (the chain's bend branches, each stopped inside the mid
12
+ * joint's range), and the root rotation that aims the chain at the target
13
+ * and then turns it by a swivel about its own root-to-effector line, which
14
+ * leaves the effector where it is (Tolani, Goswami and Badler 2000). A
15
+ * swivel and a branch name one pose of the chain for any target, so a
16
+ * caller that holds them while the target moves poses the chain exactly as
17
+ * the articulation does, and `read` recovers them from a posed chain.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States the branches, the aim and swivel, and what a held swivel means.
20
+ * @evidence contracts/development/design.md#principled-representation The swivel parameterisation of Tolani, Goswami and Badler 2000: a hinge angle per branch and a swivel about the root-to-effector line.
21
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The chain, the swivel and three functions: the branches, the pose and its reading; `hingedArmArticulation` poses its candidates through them.
22
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `aimRotation`; the scoring and the sweep stay with `hingedArmArticulation`.
23
+ */
24
+ var hingedArmSwivel;
25
+ (function (hingedArmSwivel) {
26
+ /**
27
+ * Swivel resolution of `hingedArmArticulation`'s candidate sweep, in
28
+ * degrees.
29
+ *
30
+ * Every candidate lands the effector on the same point, so the step decides
31
+ * only which of the equally exact poses is chosen, never how close the hand
32
+ * gets. One degree gives 360 candidates per bend branch, and the solve runs
33
+ * once per authored action rather than per frame.
34
+ */
35
+ hingedArmSwivel.STEP = 1;
36
+ /** The golden-section ratio, `(sqrt(5) - 1) / 2`, by which each refinement pass shrinks the swivel bracket. */
37
+ hingedArmSwivel.GOLDEN = (Math.sqrt(5) - 1) / 2;
38
+ /**
39
+ * Golden-section passes refining the swivel inside the two-step bracket
40
+ * around each local minimum of the sweep: the fewest that shrink the
41
+ * bracket, `2 STEP`, by `GOLDEN` a pass to within the joint's tolerance
42
+ * (`ROM_TOLERANCE`), since a swivel turns the chain root's joint by itself
43
+ * and a solver need resolve a joint's angle no finer.
44
+ */
45
+ hingedArmSwivel.REFINEMENTS = Math.ceil(Math.log(ROM_TOLERANCE_1.ROM_TOLERANCE / (2 * hingedArmSwivel.STEP)) / Math.log(hingedArmSwivel.GOLDEN));
46
+ /** The width the refinement leaves of a swivel's bracket, degrees: the two-step bracket shrunk by `GOLDEN` per pass, the swivel's resolution, within `ROM_TOLERANCE`. */
47
+ hingedArmSwivel.RESOLUTION = 2 * hingedArmSwivel.STEP * hingedArmSwivel.GOLDEN ** hingedArmSwivel.REFINEMENTS;
48
+ /**
49
+ * The chain's bend branches toward its target: the two hinge angles whose
50
+ * span is the target's distance, `phase + acos` first, or the fully
51
+ * extended or folded one outside the span, each stopped at the nearer limit
52
+ * of the range.
53
+ *
54
+ * @param chain The chain.
55
+ * @returns The branches, in that order, or null for a degenerate chain (`hingedArmArticulation`).
56
+ *
57
+ * @evidence contracts/development/common.md#meaningful-documentation States the order, the stops and the null.
58
+ * @evidence contracts/development/implementation.md#principled-implementation The span is an exact sinusoid in the hinge angle, so its two arccos roots are the only hinge angles reaching the distance.
59
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The sinusoid, its roots, then the range.
60
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The degeneracy thresholds are the engine's shared length scale.
61
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
62
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
63
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
64
+ */
65
+ function branches(chain) {
66
+ const root = chain.upper.worldPosition;
67
+ if (Vector3_1.Vector3.length(chain.midOffset) < 1e-6 ||
68
+ Vector3_1.Vector3.length(chain.endOffset) < 1e-6)
69
+ return null;
70
+ const distance = Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(chain.target, root));
71
+ if (distance < 1e-6)
72
+ return null;
73
+ if (Vector3_1.Vector3.length(chain.hinge) < 1e-6)
74
+ return null;
75
+ const hinge = Vector3_1.Vector3.normalize(chain.hinge);
76
+ // |m(θ)|² = k + α cos θ + β sin θ, with the far segment split into the part
77
+ // the hinge cannot move (along the hinge) and the part it swings.
78
+ const along = Vector3_1.Vector3.dot(hinge, chain.endOffset);
79
+ const swung = Vector3_1.Vector3.subtract(chain.endOffset, Vector3_1.Vector3.scale(hinge, along));
80
+ const radius = Vector3_1.Vector3.length(swung);
81
+ const rotated = (vector) => Quaternion_1.Quaternion.rotateVector(chain.midRest, vector);
82
+ const k = Vector3_1.Vector3.dot(chain.midOffset, chain.midOffset) +
83
+ Vector3_1.Vector3.dot(chain.endOffset, chain.endOffset) +
84
+ 2 * along * Vector3_1.Vector3.dot(chain.midOffset, rotated(hinge));
85
+ let alpha = 0;
86
+ let beta = 0;
87
+ if (radius >= SPAN_EPSILON) {
88
+ const unit = Vector3_1.Vector3.scale(swung, 1 / radius);
89
+ alpha = 2 * radius * Vector3_1.Vector3.dot(chain.midOffset, rotated(unit));
90
+ beta =
91
+ 2 *
92
+ radius *
93
+ Vector3_1.Vector3.dot(chain.midOffset, rotated(Vector3_1.Vector3.cross(hinge, unit)));
94
+ }
95
+ const span = Math.hypot(alpha, beta);
96
+ if (span < SPAN_EPSILON)
97
+ return null;
98
+ const phase = Math.atan2(beta, alpha);
99
+ const ratio = (distance * distance - k) / span;
100
+ // Outside the span the chain clamps to its extreme, so the effector stops
101
+ // on the reachable shell pointing at the target rather than failing.
102
+ const thetas = ratio >= 1
103
+ ? [phase]
104
+ : ratio <= -1
105
+ ? [phase + Math.PI]
106
+ : [phase + Math.acos(ratio), phase - Math.acos(ratio)];
107
+ const outside = ratio >= 1 || ratio <= -1;
108
+ const short = (theta) => Math.abs(Math.sqrt(Math.max(0, k + alpha * Math.cos(theta) + beta * Math.sin(theta))) - distance);
109
+ // A hinge angle outside the joint's own range stops at the nearer limit,
110
+ // so the effector rests on the legal shell along the line to the target.
111
+ const range = chain.range;
112
+ return thetas.map((theta) => {
113
+ if (range === undefined)
114
+ return { theta, shortfall: outside ? short(theta) : 0 };
115
+ const centre = (range.min + range.max) / 2;
116
+ const wrapped = theta - 2 * Math.PI * Math.round((theta - centre) / (2 * Math.PI));
117
+ const legal = Math.min(range.max, Math.max(range.min, wrapped));
118
+ return {
119
+ theta: legal,
120
+ shortfall: legal === wrapped && !outside ? 0 : short(legal),
121
+ };
122
+ });
123
+ }
124
+ hingedArmSwivel.branches = branches;
125
+ /**
126
+ * The chain posed at a hinge angle, for any swivel: the mid joint turned by
127
+ * the hinge angle, the root aimed so the chain's root-to-effector line
128
+ * points at the target (`aimRotation`), then turned about that line by the
129
+ * swivel.
130
+ *
131
+ * @param chain The chain.
132
+ * @param theta The hinge angle, radians.
133
+ * @returns The bone-local root and mid rotations at a swivel about the root-to-effector line, degrees.
134
+ *
135
+ * @evidence contracts/development/common.md#meaningful-documentation States the order of the turns and the units.
136
+ * @evidence contracts/development/implementation.md#principled-implementation The swivel about the root-to-effector line is an exact null space of the effector's position.
137
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The hinge, the line and the aim once, then the swivel per call.
138
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
139
+ * @evidence contracts/development/implementation.md#efficient-algorithms The mid direction and the aim are read once for every swivel of a branch.
140
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `aimRotation`.
141
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the branch's mid rotation, line and aim in the returned function only.
142
+ */
143
+ function pose(chain, theta) {
144
+ const { lower, line, aim } = aimed(chain, theta);
145
+ return (swivel) => ({
146
+ upper: Quaternion_1.Quaternion.multiply(aim, Quaternion_1.Quaternion.fromAxisAngle(line, swivel)),
147
+ lower,
148
+ });
149
+ }
150
+ hingedArmSwivel.pose = pose;
151
+ /**
152
+ * The swivel of a posed chain: the root's turn about the chain's
153
+ * root-to-effector line past the aim `pose` gives for its hinge angle.
154
+ *
155
+ * @param chain The chain, its target where the posed effector lies.
156
+ * @param upper The posed bone-local root rotation.
157
+ * @param theta The posed hinge angle, radians.
158
+ * @returns Degrees, in (-180, 180].
159
+ *
160
+ * @evidence contracts/development/common.md#meaningful-documentation States what is read and its range.
161
+ * @evidence contracts/development/implementation.md#principled-implementation The inverse of `pose`: the aim removed, the rest is a turn about the line.
162
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The aim, the remainder, its angle.
163
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
164
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work with no algorithm to choose.
165
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares `pose`'s aim.
166
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
167
+ */
168
+ function read(chain, upper, theta) {
169
+ const { line, aim } = aimed(chain, theta);
170
+ const rest = Quaternion_1.Quaternion.multiply(Quaternion_1.Quaternion.inverse(aim), upper);
171
+ const along = rest.x * line.x + rest.y * line.y + rest.z * line.z;
172
+ const degrees = (2 * Math.atan2(along, rest.w) * 180) / Math.PI;
173
+ return degrees > 180
174
+ ? degrees - 360
175
+ : degrees <= -180
176
+ ? degrees + 360
177
+ : degrees;
178
+ }
179
+ hingedArmSwivel.read = read;
180
+ /** The mid rotation, the root-to-effector line in the root's frame and the aim at a hinge angle. */
181
+ function aimed(chain, theta) {
182
+ const lower = Quaternion_1.Quaternion.fromAxisAngle(Vector3_1.Vector3.normalize(chain.hinge), theta * RAD2DEG);
183
+ const mid = Vector3_1.Vector3.add(chain.midOffset, Quaternion_1.Quaternion.rotateVector(chain.midRest, Quaternion_1.Quaternion.rotateVector(lower, chain.endOffset)));
184
+ const goal = Quaternion_1.Quaternion.rotateVector(Quaternion_1.Quaternion.inverse(chain.upper.worldRotation), Vector3_1.Vector3.subtract(chain.target, chain.upper.worldPosition));
185
+ return {
186
+ lower,
187
+ line: Vector3_1.Vector3.normalize(mid),
188
+ aim: (0, aimRotation_1.aimRotation)(mid, goal),
189
+ };
190
+ }
191
+ /** Below this the mid joint cannot change the chain's span at all. */
192
+ const SPAN_EPSILON = 1e-9;
193
+ /** Degrees per radian. */
194
+ const RAD2DEG = 180 / Math.PI;
195
+ })(hingedArmSwivel || (exports.hingedArmSwivel = hingedArmSwivel = {}));
196
+ //# sourceMappingURL=hingedArmSwivel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hingedArmSwivel.js","sourceRoot":"","sources":["../../src/kinematics/hingedArmSwivel.ts"],"names":[],"mappings":"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"}
@@ -4,33 +4,57 @@ export * from "./IAutoMovieChainBone";
4
4
  export * from "./IAutoMovieHingedArticulation";
5
5
  export * from "./IAutoMovieJointAxesIssue";
6
6
  export * from "./IAutoMovieJointRotationDomain";
7
+ export * from "./IAutoMoviePoseRig";
7
8
  export * from "./IAutoMovieResolvedBone";
8
9
  export * from "./IAutoMovieResolvedJointAngles";
9
10
  export * from "./IAutoMovieSkeletonTopology";
11
+ export * from "./IAutoMovieSwivelNear";
12
+ export * from "./IAutoMovieSwivelSeed";
10
13
  export * from "./IAutoMovieTwoBoneArticulation";
11
14
  export * from "./ITwoBoneIK";
12
15
  export * from "./aimRotation";
13
16
  export * from "./aimYawPitch";
17
+ export * from "./alternateRigJointAngles";
14
18
  export * from "./armChainFault";
19
+ export * from "./boxExcludedSwivels";
15
20
  export * from "./clinicalDeviation";
16
21
  export * from "./constants";
17
22
  export * from "./curlChainUntilContact";
18
23
  export * from "./decomposeJointRotation";
24
+ export * from "./decomposeJointRotationOnBasis";
25
+ export * from "./fitDigitDescent";
26
+ export * from "./fitDigitToTarget";
19
27
  export * from "./gazeChainJoints";
20
28
  export * from "./hingedArmArticulation";
29
+ export * from "./hingedArmSwivel";
21
30
  export * from "./indexSkeletonTopology";
22
31
  export * from "./jointRomOvershoot";
23
32
  export * from "./jointToQuaternion";
33
+ export * from "./jointToQuaternionOnBasis";
24
34
  export * from "./measureAutoMovieHumanoidBody";
25
35
  export * from "./normalizeJointAxes";
36
+ export * from "./poseJointCodec";
26
37
  export * from "./reachPose";
27
38
  export * from "./reachableBoneNames";
28
39
  export * from "./resolveAttachment";
40
+ export * from "./resolveAutoMovieBalanceOutcome";
29
41
  export * from "./resolveAutoMovieCenterOfMass";
42
+ export * from "./resolveAutoMovieMomentum";
43
+ export * from "./resolveAutoMovieHumanoidRingModules";
44
+ export * from "./AutoMovieHumanoidDigitSurfaces";
45
+ export * from "./AutoMovieHumanoidSurfaceExtents";
46
+ export * from "./AutoMovieHumanoidSurfaceRays";
47
+ export * from "./AutoMovieHumanoidSurfaceRegions";
30
48
  export * from "./resolveAutoMovieHumanoidSurfaces";
31
49
  export * from "./resolveLookAt";
32
50
  export * from "./resolvePose";
33
51
  export * from "./skeletonJointAxes";
34
52
  export * from "./solveTwoBoneIK";
53
+ export * from "./swingTwistBasis";
54
+ export * from "./swingTwistRange";
55
+ export * from "./swingTwistRegion";
56
+ export * from "./swivelArcs";
35
57
  export * from "./twoBoneChainArticulation";
36
58
  export * from "./validateJointAxesBasis";
59
+ export * from "./markAutoMovieBalance";
60
+ export * from "./markAutoMovieRomOvershoot";
@@ -20,34 +20,58 @@ __exportStar(require("./IAutoMovieChainBone"), exports);
20
20
  __exportStar(require("./IAutoMovieHingedArticulation"), exports);
21
21
  __exportStar(require("./IAutoMovieJointAxesIssue"), exports);
22
22
  __exportStar(require("./IAutoMovieJointRotationDomain"), exports);
23
+ __exportStar(require("./IAutoMoviePoseRig"), exports);
23
24
  __exportStar(require("./IAutoMovieResolvedBone"), exports);
24
25
  __exportStar(require("./IAutoMovieResolvedJointAngles"), exports);
25
26
  __exportStar(require("./IAutoMovieSkeletonTopology"), exports);
27
+ __exportStar(require("./IAutoMovieSwivelNear"), exports);
28
+ __exportStar(require("./IAutoMovieSwivelSeed"), exports);
26
29
  __exportStar(require("./IAutoMovieTwoBoneArticulation"), exports);
27
30
  __exportStar(require("./ITwoBoneIK"), exports);
28
31
  __exportStar(require("./aimRotation"), exports);
29
32
  __exportStar(require("./aimYawPitch"), exports);
33
+ __exportStar(require("./alternateRigJointAngles"), exports);
30
34
  __exportStar(require("./armChainFault"), exports);
35
+ __exportStar(require("./boxExcludedSwivels"), exports);
31
36
  __exportStar(require("./clinicalDeviation"), exports);
32
37
  __exportStar(require("./constants"), exports);
33
38
  __exportStar(require("./curlChainUntilContact"), exports);
34
39
  __exportStar(require("./decomposeJointRotation"), exports);
40
+ __exportStar(require("./decomposeJointRotationOnBasis"), exports);
41
+ __exportStar(require("./fitDigitDescent"), exports);
42
+ __exportStar(require("./fitDigitToTarget"), exports);
35
43
  __exportStar(require("./gazeChainJoints"), exports);
36
44
  __exportStar(require("./hingedArmArticulation"), exports);
45
+ __exportStar(require("./hingedArmSwivel"), exports);
37
46
  __exportStar(require("./indexSkeletonTopology"), exports);
38
47
  __exportStar(require("./jointRomOvershoot"), exports);
39
48
  __exportStar(require("./jointToQuaternion"), exports);
49
+ __exportStar(require("./jointToQuaternionOnBasis"), exports);
40
50
  __exportStar(require("./measureAutoMovieHumanoidBody"), exports);
41
51
  __exportStar(require("./normalizeJointAxes"), exports);
52
+ __exportStar(require("./poseJointCodec"), exports);
42
53
  __exportStar(require("./reachPose"), exports);
43
54
  __exportStar(require("./reachableBoneNames"), exports);
44
55
  __exportStar(require("./resolveAttachment"), exports);
56
+ __exportStar(require("./resolveAutoMovieBalanceOutcome"), exports);
45
57
  __exportStar(require("./resolveAutoMovieCenterOfMass"), exports);
58
+ __exportStar(require("./resolveAutoMovieMomentum"), exports);
59
+ __exportStar(require("./resolveAutoMovieHumanoidRingModules"), exports);
60
+ __exportStar(require("./AutoMovieHumanoidDigitSurfaces"), exports);
61
+ __exportStar(require("./AutoMovieHumanoidSurfaceExtents"), exports);
62
+ __exportStar(require("./AutoMovieHumanoidSurfaceRays"), exports);
63
+ __exportStar(require("./AutoMovieHumanoidSurfaceRegions"), exports);
46
64
  __exportStar(require("./resolveAutoMovieHumanoidSurfaces"), exports);
47
65
  __exportStar(require("./resolveLookAt"), exports);
48
66
  __exportStar(require("./resolvePose"), exports);
49
67
  __exportStar(require("./skeletonJointAxes"), exports);
50
68
  __exportStar(require("./solveTwoBoneIK"), exports);
69
+ __exportStar(require("./swingTwistBasis"), exports);
70
+ __exportStar(require("./swingTwistRange"), exports);
71
+ __exportStar(require("./swingTwistRegion"), exports);
72
+ __exportStar(require("./swivelArcs"), exports);
51
73
  __exportStar(require("./twoBoneChainArticulation"), exports);
52
74
  __exportStar(require("./validateJointAxesBasis"), exports);
75
+ __exportStar(require("./markAutoMovieBalance"), exports);
76
+ __exportStar(require("./markAutoMovieRomOvershoot"), exports);
53
77
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kinematics/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,4DAA0C;AAC1C,wDAAsC;AACtC,iEAA+C;AAC/C,6DAA2C;AAC3C,kEAAgD;AAChD,2DAAyC;AACzC,kEAAgD;AAChD,+DAA6C;AAC7C,kEAAgD;AAChD,+CAA6B;AAC7B,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,sDAAoC;AACpC,8CAA4B;AAC5B,0DAAwC;AACxC,2DAAyC;AACzC,oDAAkC;AAClC,0DAAwC;AACxC,0DAAwC;AACxC,sDAAoC;AACpC,sDAAoC;AACpC,iEAA+C;AAC/C,uDAAqC;AACrC,8CAA4B;AAC5B,uDAAqC;AACrC,sDAAoC;AACpC,iEAA+C;AAC/C,qEAAmD;AACnD,kDAAgC;AAChC,gDAA8B;AAC9B,sDAAoC;AACpC,mDAAiC;AACjC,6DAA2C;AAC3C,2DAAyC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kinematics/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,4DAA0C;AAC1C,wDAAsC;AACtC,iEAA+C;AAC/C,6DAA2C;AAC3C,kEAAgD;AAChD,sDAAoC;AACpC,2DAAyC;AACzC,kEAAgD;AAChD,+DAA6C;AAC7C,yDAAuC;AACvC,yDAAuC;AACvC,kEAAgD;AAChD,+CAA6B;AAC7B,gDAA8B;AAC9B,gDAA8B;AAC9B,4DAA0C;AAC1C,kDAAgC;AAChC,uDAAqC;AACrC,sDAAoC;AACpC,8CAA4B;AAC5B,0DAAwC;AACxC,2DAAyC;AACzC,kEAAgD;AAChD,oDAAkC;AAClC,qDAAmC;AACnC,oDAAkC;AAClC,0DAAwC;AACxC,oDAAkC;AAClC,0DAAwC;AACxC,sDAAoC;AACpC,sDAAoC;AACpC,6DAA2C;AAC3C,iEAA+C;AAC/C,uDAAqC;AACrC,mDAAiC;AACjC,8CAA4B;AAC5B,uDAAqC;AACrC,sDAAoC;AACpC,mEAAiD;AACjD,iEAA+C;AAC/C,6DAA2C;AAC3C,wEAAsD;AACtD,mEAAiD;AACjD,oEAAkD;AAClD,iEAA+C;AAC/C,oEAAkD;AAClD,qEAAmD;AACnD,kDAAgC;AAChC,gDAA8B;AAC9B,sDAAoC;AACpC,mDAAiC;AACjC,oDAAkC;AAClC,oDAAkC;AAClC,qDAAmC;AACnC,+CAA6B;AAC7B,6DAA2C;AAC3C,2DAAyC;AACzC,yDAAuC;AACvC,8DAA4C"}
@@ -1,23 +1,27 @@
1
1
  import { IAutoMovieJointConstraint, IAutoMovieJointPose } from "@automovie/interface";
2
+ import type { swingTwistRange } from "./swingTwistRange";
2
3
  /**
3
4
  * The total range-of-motion overshoot of one joint's clinical angles, in
4
5
  * degrees, or `0` when the joint is within its constraint.
5
6
  *
6
- * It sums the `overshoot` of every violation {@link validateJointRom} reports,
7
- * the same check the pose gate runs, so a solver that ranks candidates by this
8
- * number cannot judge itself by a kinder rule than the gate. A non-finite angle
9
- * is reported without an overshoot and scores `Infinity`, so it never wins a
10
- * ranking. A `null` constraint scores `0`.
7
+ * It sums the overshoot of every fault {@link scanJointRom} reports, the
8
+ * measure the pose gate's `validateJointRom` words into its violations, so a
9
+ * solver that ranks candidates by this number cannot judge itself by a kinder
10
+ * rule than the gate, and a ranking over hundreds of candidates builds no
11
+ * message for any of them. A non-finite angle is reported without an
12
+ * overshoot and scores `Infinity`, so it never wins a ranking. A `null`
13
+ * constraint scores `0`.
11
14
  *
12
15
  * @param joint Clinical angles of one joint; `null` axes are at rest.
13
16
  * @param constraint The joint's resolved ROM, or `null` when unconstrained.
17
+ * @param rig The bone's frame as the caller's rig resolves it, for a joint gated by swing and twist; the humanoid tables' when absent.
14
18
  *
15
19
  * @evidence contracts/development/implementation.md#principled-implementation Reduces the gate's own per-axis and swing-cone violations to one comparable sum, so ordering by it is ordering by the gate's distances; a violation without a measured distance is a non-finite angle, which the sum treats as infinitely far instead of free.
16
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Wraps `validateJointRom` instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
20
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Sums `scanJointRom`'s faults instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
17
21
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adds no tolerance and no special case for any bone or axis; the `Infinity` score is the stated meaning of an unmeasurable violation, not a compensation.
18
22
  * @evidence contracts/development/common.md#meaningful-documentation States the unit, the zero answer, that the gate's check is reused and why, the `Infinity` case, and what `null` means for the constraint and for an axis.
19
- * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four violations, constant per call; the short-lived collector is the gate's own message-building path, accepted so the score cannot drift from the gate.
23
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four faults, constant per call, with no message and no collector built; the gate words the same faults, so the score cannot drift from it.
20
24
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one joint and constraint that coordinates no work across calls.
21
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Owns one `ViolationCollector` holding at most four violations for the duration of the call; it is unreachable after the sum returns, and nothing is retained.
25
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the sum is a local number.
22
26
  */
23
- export declare const jointRomOvershoot: (joint: IAutoMovieJointPose, constraint: IAutoMovieJointConstraint | null) => number;
27
+ export declare const jointRomOvershoot: (joint: IAutoMovieJointPose, constraint: IAutoMovieJointConstraint | null, rig?: swingTwistRange.IJoint) => number;
@@ -1,41 +1,45 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.jointRomOvershoot = void 0;
4
- const validateJointRom_1 = require("../rom/validateJointRom");
5
- const ViolationCollector_1 = require("../validation/ViolationCollector");
4
+ const scanJointRom_1 = require("../rom/scanJointRom");
6
5
  /**
7
6
  * The total range-of-motion overshoot of one joint's clinical angles, in
8
7
  * degrees, or `0` when the joint is within its constraint.
9
8
  *
10
- * It sums the `overshoot` of every violation {@link validateJointRom} reports,
11
- * the same check the pose gate runs, so a solver that ranks candidates by this
12
- * number cannot judge itself by a kinder rule than the gate. A non-finite angle
13
- * is reported without an overshoot and scores `Infinity`, so it never wins a
14
- * ranking. A `null` constraint scores `0`.
9
+ * It sums the overshoot of every fault {@link scanJointRom} reports, the
10
+ * measure the pose gate's `validateJointRom` words into its violations, so a
11
+ * solver that ranks candidates by this number cannot judge itself by a kinder
12
+ * rule than the gate, and a ranking over hundreds of candidates builds no
13
+ * message for any of them. A non-finite angle is reported without an
14
+ * overshoot and scores `Infinity`, so it never wins a ranking. A `null`
15
+ * constraint scores `0`.
15
16
  *
16
17
  * @param joint Clinical angles of one joint; `null` axes are at rest.
17
18
  * @param constraint The joint's resolved ROM, or `null` when unconstrained.
19
+ * @param rig The bone's frame as the caller's rig resolves it, for a joint gated by swing and twist; the humanoid tables' when absent.
18
20
  *
19
21
  * @evidence contracts/development/implementation.md#principled-implementation Reduces the gate's own per-axis and swing-cone violations to one comparable sum, so ordering by it is ordering by the gate's distances; a violation without a measured distance is a non-finite angle, which the sum treats as infinitely far instead of free.
20
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Wraps `validateJointRom` instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
22
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Sums `scanJointRom`'s faults instead of restating its limits, so `decomposeJointRotation`'s chart choice and `reachPose`'s candidate scoring read exactly the rule `validatePose` enforces.
21
23
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adds no tolerance and no special case for any bone or axis; the `Infinity` score is the stated meaning of an unmeasurable violation, not a compensation.
22
24
  * @evidence contracts/development/common.md#meaningful-documentation States the unit, the zero answer, that the gate's check is reused and why, the `Infinity` case, and what `null` means for the constraint and for an axis.
23
- * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four violations, constant per call; the short-lived collector is the gate's own message-building path, accepted so the score cannot drift from the gate.
25
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three axis checks plus at most one swing-cone check and a sum over at most four faults, constant per call, with no message and no collector built; the gate words the same faults, so the score cannot drift from it.
24
26
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one joint and constraint that coordinates no work across calls.
25
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Owns one `ViolationCollector` holding at most four violations for the duration of the call; it is unreachable after the sum returns, and nothing is retained.
27
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the sum is a local number.
26
28
  */
27
- const jointRomOvershoot = (joint, constraint) => {
29
+ const jointRomOvershoot = (joint, constraint, rig) => {
28
30
  if (constraint === null)
29
31
  return 0;
30
- const collector = new ViolationCollector_1.ViolationCollector();
31
- (0, validateJointRom_1.validateJointRom)({ joint, constraint, path: "$candidate", collector });
32
- return collector.items.reduce(
33
- // A violation with no overshoot is not a free one. `validateJointRom` omits
34
- // the measure exactly when the angle is NOT FINITE, which is worse than any
32
+ let total = 0;
33
+ (0, scanJointRom_1.scanJointRom)(joint, constraint,
34
+ // A fault with no overshoot is not a free one. `scanJointRom` omits the
35
+ // measure exactly when the angle is NOT FINITE, which is worse than any
35
36
  // distance past a limit and has no distance to report. Scoring it `0` would
36
37
  // rank a malformed candidate as perfectly legal and let it win the
37
38
  // selection outright, so it is scored as unusable instead.
38
- (total, item) => total + (item.overshoot ?? Number.POSITIVE_INFINITY), 0);
39
+ (_part, _actual, overshoot) => {
40
+ total += overshoot ?? Number.POSITIVE_INFINITY;
41
+ }, rig);
42
+ return total;
39
43
  };
40
44
  exports.jointRomOvershoot = jointRomOvershoot;
41
45
  //# sourceMappingURL=jointRomOvershoot.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"jointRomOvershoot.js","sourceRoot":"","sources":["../../src/kinematics/jointRomOvershoot.ts"],"names":[],"mappings":";;;AAMA,8DAA2D;AAC3D,yEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,iBAAiB,GAGhB,CACZ,KAA0B,EAC1B,UAA4C,EACpC,EAAE;IACV,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,SAAS,GAAuB,IAAI,uCAAkB,EAAE,CAAC;IAC/D,IAAA,mCAAgB,EAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;IACvE,OAAO,SAAS,CAAC,KAAK,CAAC,MAAM;IAC3B,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,mEAAmE;IACnE,2DAA2D;IAC3D,CAAC,KAAa,EAAE,IAAmC,EAAU,EAAE,CAC7D,KAAK,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,EACtD,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,iBAAiB,GAAjB,iBAAiB,CAoB5B"}
1
+ {"version":3,"file":"jointRomOvershoot.js","sourceRoot":"","sources":["../../src/kinematics/jointRomOvershoot.ts"],"names":[],"mappings":";;;AAKA,sDAAmD;AAGnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,iBAAiB,GAIhB,CACZ,KAA0B,EAC1B,UAA4C,EAC5C,GAA4B,EACpB,EAAE;IACV,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,KAAK,GAAW,CAAC,CAAC;IACtB,IAAA,2BAAY,EACV,KAAK,EACL,UAAU;IACV,wEAAwE;IACxE,wEAAwE;IACxE,4EAA4E;IAC5E,mEAAmE;IACnE,2DAA2D;IAC3D,CACE,KAAwB,EACxB,OAAe,EACf,SAA6B,EACvB,EAAE;QACR,KAAK,IAAI,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC;IACjD,CAAC,EACD,GAAG,CACJ,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AA7BW,QAAA,iBAAiB,GAAjB,iBAAiB,CA6B5B"}
@@ -36,10 +36,10 @@ type AutoMovieClinicalAxis = "flexion" | "abduction" | "twist";
36
36
  * omitted, the angles are already rest-relative.
37
37
  *
38
38
  * @evidence contracts/development/implementation.md#principled-implementation An intrinsic Euler composition of three axis-angle quaternions in a declared order, which is a rotation for any orthonormal basis; `normalizeJointAxes` enforces that basis and the frame map is the exact affine inverse of `toClinicalAngle`, so `decomposeJointRotation` round-trips it.
39
- * @evidence contracts/development/implementation.md#clear-and-simple-structure The forward half of the joint convention, used by `resolvePose` for every articulated bone; basis checking lives in `normalizeJointAxes` and frame arithmetic in `toRigAngle`, so the forward and inverse maps share those rules.
39
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The forward half of the joint convention, used by `resolvePose` for every articulated bone: `jointToQuaternionOnBasis` behind one `normalizeJointAxes`, so basis checking and composition each live in one place and the forward and inverse maps share those rules.
40
40
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Reads every bone through its declared axes and frame; a `null` angle is the documented rest rotation, and a non-finite angle throws instead of becoming zero.
41
41
  * @evidence contracts/development/common.md#meaningful-documentation States each axis and its default, both composition orders and when each applies, what `null` means, the frame map and its purpose, the inverse function, the thrown inputs, and each parameter's default.
42
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant time: one basis validation and normalization, three axis-angle quaternions and two products.
42
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant time: one basis admission (a remembered record costs ten comparisons), three axis-angle quaternions and two products.
43
43
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one joint that coordinates no work across calls.
44
44
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned quaternion.
45
45
  */