@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,34 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.alternateRigJointAngles = void 0;
4
+ /**
5
+ * The second Euler chart of a joint rotation, in rest-relative (rig)
6
+ * degrees: the other triple that composes to the same rotation.
7
+ *
8
+ * A distal twist composes `Ry(a)·Rx(f)·Rz(t)`, whose second chart is
9
+ * `(180 − f, a + 180, t + 180)`; a proximal twist composes `Rz(t)·Ry(a)·Rx(f)`,
10
+ * whose second chart is `(f + 180, 180 − a, t + 180)`. A left-handed basis is
11
+ * extracted against `−twist`, so its twist takes `−180` where a right-handed
12
+ * one takes `+180`, the same rotation by a full turn. No angle is wrapped:
13
+ * the caller chooses the full-turn alias it needs.
14
+ *
15
+ * @param rig The rest-relative angles of one chart, degrees.
16
+ * @param placement Where the basis places the twist; absent means proximal.
17
+ * @param handed `1` for a right-handed basis (`flexion × abduction = +twist`), `-1` for a left-handed one.
18
+ * @returns The other chart's rest-relative angles, degrees.
19
+ *
20
+ * @evidence contracts/development/implementation.md#principled-implementation The two charts of a three-angle composition differ by a half turn of each outer angle and the reflection of the middle one about its right angle, which leaves every entry of the composed matrix unchanged.
21
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One record of three sums; `decomposeJointRotationOnBasis` scores it against a range, so the chart rule is written once.
22
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No angle is wrapped or clamped and no bone is named.
23
+ * @evidence contracts/development/common.md#meaningful-documentation States both composition orders with their second chart, the handedness term, the unit and that aliases are the caller's.
24
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three additions.
25
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of three numbers with nothing to share between calls.
26
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned angles.
27
+ */
28
+ const alternateRigJointAngles = (rig, placement, handed) => ({
29
+ flexion: placement === "distal" ? 180 - rig.flexion : rig.flexion + 180,
30
+ abduction: placement === "distal" ? rig.abduction + 180 : 180 - rig.abduction,
31
+ twist: rig.twist + 180 * handed,
32
+ });
33
+ exports.alternateRigJointAngles = alternateRigJointAngles;
34
+ //# sourceMappingURL=alternateRigJointAngles.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"alternateRigJointAngles.js","sourceRoot":"","sources":["../../src/kinematics/alternateRigJointAngles.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,uBAAuB,GAIC,CACnC,GAAkC,EAClC,SAAmD,EACnD,MAAc,EACiB,EAAE,CAAC,CAAC;IACnC,OAAO,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG;IACvE,SAAS,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,SAAS;IAC7E,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,GAAG,MAAM;CAChC,CAAC,CAAC;AAZU,QAAA,uBAAuB,GAAvB,uBAAuB,CAYjC"}
@@ -0,0 +1,64 @@
1
+ import { IAutoMovieJointAxes, IAutoMovieJointConstraint, IAutoMovieQuaternion } from "@automovie/interface";
2
+ import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
3
+ import type { swingTwistRange } from "./swingTwistRange";
4
+ /**
5
+ * The swivels a joint's three-angle box provably refuses: for a joint whose
6
+ * bone-local rotation is a fixed rotation turned about a fixed axis by the
7
+ * swivel (the chain root of `hingedArmSwivel.pose`), a test of whether every
8
+ * swivel from `low` to `high` degrees reads past the joint's box in both of
9
+ * the charts `decomposeJointRotationOnBasis` chooses between, so that
10
+ * `jointRomOvershoot` scores each of them above zero.
11
+ *
12
+ * A rotation turned about a fixed axis by `ψ` has a matrix whose every entry
13
+ * is `a + b cos ψ + c sin ψ` (Rodrigues' formula between two fixed
14
+ * rotations), so every entry the decomposition reads is such a sinusoid,
15
+ * fitted exactly from the rotation at 0, 90 and 180 degrees. Each clinical
16
+ * bound is then a sinusoid's sign. The middle angle of the composition
17
+ * (`atan2(s, cos)` with a non-negative cosine, so `asin(s)`) lies past a
18
+ * bound `q` where `s - sin q` is positive; an outer angle `atan2(y, x)` lies
19
+ * past the upper end `β` of an interval no wider than a half turn where
20
+ * `y cos β - x sin β` (the vector's length times `sin(δ - β)`) is positive,
21
+ * and past the lower end `α` where `x sin α - y cos α` is. The alternate
22
+ * chart (`alternateRigJointAngles`) turns each outer angle by a half turn,
23
+ * negating its vector, and reflects the middle angle about its right angle.
24
+ * Where one such sinusoid exceeds `MARGIN`, its exact roots bound an arc of
25
+ * swivels (`φ ± acos((MARGIN - a) / R)`), and a reading is refused on the
26
+ * union of its axes' arcs.
27
+ *
28
+ * Every refusal is certain. A sinusoid above `MARGIN` puts its angle past
29
+ * the bound by more than `MARGIN` radians, the joints' tolerance
30
+ * (`ROM_TOLERANCE`, about 1.7e-4), far beyond the rounding of the fit, of
31
+ * the arc's ends and of the decomposition itself (near 1e-15); and an outer
32
+ * angle's vector is then longer than `MARGIN`, past the gimbal band
33
+ * (`sqrt(ε)`, 1.5e-8) inside which the decomposition pins that angle
34
+ * instead. A joint gated by swing and twist, which the box does not score,
35
+ * is read by its range instead (`swingTwistExcludedSwivels`) when the frame
36
+ * the overshoot reads it in is given, and refuses nothing otherwise; an
37
+ * axis without an interval, an outer interval wider than a half turn
38
+ * (whose refusal is an intersection, not a union, of two arcs) and a middle
39
+ * interval met twice by the half turn the middle angle covers refuse
40
+ * nothing, so the test only ever says less than the box would.
41
+ *
42
+ * @param props The joint and its rotation by swivel.
43
+ * @returns Whether every swivel in `[low, high]`, degrees, is refused; a joint with nothing to refuse refuses no swivel.
44
+ *
45
+ * @evidence contracts/development/common.md#meaningful-documentation States the premise on the rotation, why each entry is a sinusoid, each bound's sinusoid for both charts, the margin and why every refusal is certain, and every case that refuses nothing.
46
+ * @evidence contracts/development/implementation.md#principled-implementation Rodrigues' formula makes each entry an exact sinusoid in the swivel, so each bound's crossing swivels are a sinusoid's two arccos roots, and an angle's interval maps through the rest frame and the chart exactly as `decomposeJointRotationOnBasis` and `alternateRigJointAngles` read it.
47
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The entries are fitted once, each reading's axes give their bound sinusoids, the sinusoids their arcs, the arcs one merged list per reading, and the test reads the lists.
48
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Sound by construction, never by sampling: an arc is refused only from its sinusoid's roots with the joints' tolerance to spare, and a case the analysis does not cover refuses nothing rather than guessing.
49
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three rotations and nine dot products each fit the entries, a few arcs per reading are merged once, and each test is a scan of a handful of merged arcs.
50
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The fit, the arcs, their union and its test are `swivelArcs`'s, shared with a point's bounds; the arcs are built once per rotation and read by every test of its sweep.
51
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the two merged arc lists in the returned test only.
52
+ */
53
+ export declare function boxExcludedSwivels(props: {
54
+ /** The joint's clinical basis, admitted and normalized (`normalizeJointAxes`). */
55
+ basis: IAutoMovieJointAxes;
56
+ /** The rest frame lifting the joint's rest-relative angles to clinical ones; omitted, they are clinical. */
57
+ frame?: IAutoMovieRestFrame | undefined;
58
+ /** The joint's resolved range of motion, as the decomposition's domain and the overshoot read it; `null` refuses nothing. */
59
+ constraint: IAutoMovieJointConstraint | null;
60
+ /** The frame a swing-twist gate is read in, as the overshoot reads it (`scanJointRom`); omitted, a gated joint refuses nothing. */
61
+ joint?: swingTwistRange.IJoint | undefined;
62
+ /** The joint's bone-local rotation at a swivel, degrees: a fixed rotation turned about a fixed axis by the swivel. */
63
+ rotation: (swivel: number) => IAutoMovieQuaternion;
64
+ }): (low: number, high: number) => boolean;
@@ -0,0 +1,187 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.boxExcludedSwivels = boxExcludedSwivels;
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 swingTwistExcludedSwivels_1 = require("./swingTwistExcludedSwivels");
8
+ const swivelArcs_1 = require("./swivelArcs");
9
+ /**
10
+ * The swivels a joint's three-angle box provably refuses: for a joint whose
11
+ * bone-local rotation is a fixed rotation turned about a fixed axis by the
12
+ * swivel (the chain root of `hingedArmSwivel.pose`), a test of whether every
13
+ * swivel from `low` to `high` degrees reads past the joint's box in both of
14
+ * the charts `decomposeJointRotationOnBasis` chooses between, so that
15
+ * `jointRomOvershoot` scores each of them above zero.
16
+ *
17
+ * A rotation turned about a fixed axis by `ψ` has a matrix whose every entry
18
+ * is `a + b cos ψ + c sin ψ` (Rodrigues' formula between two fixed
19
+ * rotations), so every entry the decomposition reads is such a sinusoid,
20
+ * fitted exactly from the rotation at 0, 90 and 180 degrees. Each clinical
21
+ * bound is then a sinusoid's sign. The middle angle of the composition
22
+ * (`atan2(s, cos)` with a non-negative cosine, so `asin(s)`) lies past a
23
+ * bound `q` where `s - sin q` is positive; an outer angle `atan2(y, x)` lies
24
+ * past the upper end `β` of an interval no wider than a half turn where
25
+ * `y cos β - x sin β` (the vector's length times `sin(δ - β)`) is positive,
26
+ * and past the lower end `α` where `x sin α - y cos α` is. The alternate
27
+ * chart (`alternateRigJointAngles`) turns each outer angle by a half turn,
28
+ * negating its vector, and reflects the middle angle about its right angle.
29
+ * Where one such sinusoid exceeds `MARGIN`, its exact roots bound an arc of
30
+ * swivels (`φ ± acos((MARGIN - a) / R)`), and a reading is refused on the
31
+ * union of its axes' arcs.
32
+ *
33
+ * Every refusal is certain. A sinusoid above `MARGIN` puts its angle past
34
+ * the bound by more than `MARGIN` radians, the joints' tolerance
35
+ * (`ROM_TOLERANCE`, about 1.7e-4), far beyond the rounding of the fit, of
36
+ * the arc's ends and of the decomposition itself (near 1e-15); and an outer
37
+ * angle's vector is then longer than `MARGIN`, past the gimbal band
38
+ * (`sqrt(ε)`, 1.5e-8) inside which the decomposition pins that angle
39
+ * instead. A joint gated by swing and twist, which the box does not score,
40
+ * is read by its range instead (`swingTwistExcludedSwivels`) when the frame
41
+ * the overshoot reads it in is given, and refuses nothing otherwise; an
42
+ * axis without an interval, an outer interval wider than a half turn
43
+ * (whose refusal is an intersection, not a union, of two arcs) and a middle
44
+ * interval met twice by the half turn the middle angle covers refuse
45
+ * nothing, so the test only ever says less than the box would.
46
+ *
47
+ * @param props The joint and its rotation by swivel.
48
+ * @returns Whether every swivel in `[low, high]`, degrees, is refused; a joint with nothing to refuse refuses no swivel.
49
+ *
50
+ * @evidence contracts/development/common.md#meaningful-documentation States the premise on the rotation, why each entry is a sinusoid, each bound's sinusoid for both charts, the margin and why every refusal is certain, and every case that refuses nothing.
51
+ * @evidence contracts/development/implementation.md#principled-implementation Rodrigues' formula makes each entry an exact sinusoid in the swivel, so each bound's crossing swivels are a sinusoid's two arccos roots, and an angle's interval maps through the rest frame and the chart exactly as `decomposeJointRotationOnBasis` and `alternateRigJointAngles` read it.
52
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The entries are fitted once, each reading's axes give their bound sinusoids, the sinusoids their arcs, the arcs one merged list per reading, and the test reads the lists.
53
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Sound by construction, never by sampling: an arc is refused only from its sinusoid's roots with the joints' tolerance to spare, and a case the analysis does not cover refuses nothing rather than guessing.
54
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three rotations and nine dot products each fit the entries, a few arcs per reading are merged once, and each test is a scan of a handful of merged arcs.
55
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The fit, the arcs, their union and its test are `swivelArcs`'s, shared with a point's bounds; the arcs are built once per rotation and read by every test of its sweep.
56
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains the two merged arc lists in the returned test only.
57
+ */
58
+ function boxExcludedSwivels(props) {
59
+ const constraint = props.constraint;
60
+ if (constraint === null)
61
+ return () => false;
62
+ if (constraint.swingTwist !== undefined && constraint.swingTwist !== null)
63
+ return props.joint === undefined
64
+ ? () => false
65
+ : (0, swingTwistExcludedSwivels_1.swingTwistExcludedSwivels)({
66
+ basis: props.basis,
67
+ frame: props.frame,
68
+ constraint,
69
+ joint: props.joint,
70
+ rotation: props.rotation,
71
+ });
72
+ const basis = props.basis;
73
+ const handed = Vector3_1.Vector3.dot(basis.twist, Vector3_1.Vector3.cross(basis.flexion, basis.abduction)) >= 0
74
+ ? 1
75
+ : -1;
76
+ const axes = [
77
+ basis.flexion,
78
+ basis.abduction,
79
+ Vector3_1.Vector3.scale(basis.twist, handed),
80
+ ];
81
+ // The entries R'[i][j] = axisᵢ · (R axisⱼ) at swivels 0, 90 and 180.
82
+ const sampled = [0, 90, 180].map((swivel) => {
83
+ const q = props.rotation(swivel);
84
+ const turned = axes.map((axis) => Quaternion_1.Quaternion.rotateVector(q, axis));
85
+ return axes.map((row) => turned.map((column) => Vector3_1.Vector3.dot(row, column)));
86
+ });
87
+ const entry = (i, j) => {
88
+ const [zero, quarter, half] = sampled.map((m) => m[i][j]);
89
+ return swivelArcs_1.swivelArcs.fitted(zero, quarter, half);
90
+ };
91
+ // How each clinical axis is read from the entries (as
92
+ // `decomposeJointRotationOnBasis` reads it): a distal twist composes
93
+ // Ry(a)·Rx(f)·Rz(t), with flexion in the middle; a proximal one
94
+ // Rz(t)·Ry(a)·Rx(f), with abduction in the middle.
95
+ const reading = basis.twistPlacement === "distal"
96
+ ? {
97
+ flexion: { sine: swivelArcs_1.swivelArcs.scaled(entry(1, 2), -1) },
98
+ abduction: { y: entry(0, 2), x: entry(2, 2), turn: 1 },
99
+ twist: { y: entry(1, 0), x: entry(1, 1), turn: handed },
100
+ }
101
+ : {
102
+ flexion: { y: entry(2, 1), x: entry(2, 2), turn: 1 },
103
+ abduction: { sine: swivelArcs_1.swivelArcs.scaled(entry(2, 0), -1) },
104
+ twist: { y: entry(1, 0), x: entry(0, 0), turn: handed },
105
+ };
106
+ // Each chart's refused swivels: the union of its axes' arcs.
107
+ const charts = [false, true].map((alternate) => {
108
+ const arcs = [];
109
+ for (const axis of AXES) {
110
+ const range = constraint[axis];
111
+ if (range === null)
112
+ continue;
113
+ const read = reading[axis];
114
+ for (const bound of bounds(read, rig(range, props.frame?.[axis]), alternate)) {
115
+ const arc = swivelArcs_1.swivelArcs.above(bound, MARGIN);
116
+ if (arc === "all")
117
+ return "all";
118
+ if (arc !== null)
119
+ arcs.push(arc);
120
+ }
121
+ }
122
+ return swivelArcs_1.swivelArcs.union(arcs);
123
+ });
124
+ return (low, high) => charts.every((chart) => swivelArcs_1.swivelArcs.covers(chart, low, high));
125
+ }
126
+ /**
127
+ * How far past a bound, in sine or projected units, a reading must lie to be
128
+ * refused: the joints' tolerance (`ROM_TOLERANCE`) in radians, past the
129
+ * rounding of every step and the decomposition's gimbal band.
130
+ */
131
+ const MARGIN = (ROM_TOLERANCE_1.ROM_TOLERANCE * Math.PI) / 180;
132
+ /** The three clinical axes. */
133
+ const AXES = ["flexion", "abduction", "twist"];
134
+ /** A clinical interval as rest-relative degrees, ordered (the inverse of `toClinicalAngle`). */
135
+ function rig(range, frame) {
136
+ const sign = frame?.sign ?? 1;
137
+ const neutral = frame?.neutral ?? 0;
138
+ const ends = [
139
+ (range.min - neutral) * sign,
140
+ (range.max - neutral) * sign,
141
+ ];
142
+ return [Math.min(...ends), Math.max(...ends)];
143
+ }
144
+ /**
145
+ * The sinusoids positive where one chart's reading of an axis lies past its
146
+ * rest-relative interval `[lo, hi]`, any full-turn alias of the angle
147
+ * considered (`nearestAngleAlias`); none where the analysis cannot refuse.
148
+ */
149
+ function bounds(read, [lo, hi], alternate) {
150
+ if (hi - lo >= 360)
151
+ return [];
152
+ if ("sine" in read) {
153
+ // The middle angle is asin(s), or in the alternate chart 180 - asin(s),
154
+ // which lies in [lo, hi] exactly where asin(s) lies in [180 - hi, 180 - lo].
155
+ const [from, to] = alternate ? [180 - hi, 180 - lo] : [lo, hi];
156
+ const first = Math.ceil((-90 - to) / 360);
157
+ const last = Math.floor((90 - from) / 360);
158
+ if (last < first)
159
+ return [{ a: 1, b: 0, c: 0 }];
160
+ if (last > first)
161
+ return [];
162
+ const p = Math.max(from + 360 * first, -90);
163
+ const q = Math.min(to + 360 * first, 90);
164
+ const out = [];
165
+ if (q < 90)
166
+ out.push({
167
+ ...read.sine,
168
+ a: read.sine.a - Math.sin(q * Quaternion_1.Quaternion.DEG2RAD),
169
+ });
170
+ if (p > -90)
171
+ out.push(swivelArcs_1.swivelArcs.scaled({ ...read.sine, a: read.sine.a - Math.sin(p * Quaternion_1.Quaternion.DEG2RAD) }, -1));
172
+ return out;
173
+ }
174
+ // An outer angle δ = atan2(y, x) reads `turn · δ`, or a half turn more in
175
+ // the alternate chart, where the vector is negated.
176
+ if (hi - lo > 180)
177
+ return [];
178
+ const ends = [lo * read.turn, hi * read.turn];
179
+ const alpha = Math.min(...ends) * Quaternion_1.Quaternion.DEG2RAD;
180
+ const beta = Math.max(...ends) * Quaternion_1.Quaternion.DEG2RAD;
181
+ const sign = alternate ? -1 : 1;
182
+ return [
183
+ swivelArcs_1.swivelArcs.scaled(swivelArcs_1.swivelArcs.combined(read.y, Math.cos(beta), read.x, -Math.sin(beta)), sign),
184
+ swivelArcs_1.swivelArcs.scaled(swivelArcs_1.swivelArcs.combined(read.x, Math.sin(alpha), read.y, -Math.cos(alpha)), sign),
185
+ ];
186
+ }
187
+ //# sourceMappingURL=boxExcludedSwivels.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"boxExcludedSwivels.js","sourceRoot":"","sources":["../../src/kinematics/boxExcludedSwivels.ts"],"names":[],"mappings":"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"}
@@ -37,8 +37,22 @@ import { AutoMovieHumanoidBone, IAutoMovieJointAxes } from "@automovie/interface
37
37
  * The forearm's twist is pronation and supination, which happens beyond the
38
38
  * elbow's hinge, so the lower arms declare a distal twist
39
39
  * (`AutoMovieJointTwistPlacement`): twisting a bent forearm turns it about its
40
- * own length and leaves where it points unchanged. Every other bone keeps the
41
- * proximal default.
40
+ * own length and leaves where it points unchanged.
41
+ *
42
+ * The upper arms declare a distal twist too. The humerus's internal and
43
+ * external rotation turns it about its own length wherever the arm points,
44
+ * which only the distal order composes. In the proximal order the twist turns
45
+ * about the T-pose arm line, fixed in the shoulder girdle: for an arm in the
46
+ * sagittal plane (hanging, swinging, reaching forward) that line is the
47
+ * flexion axis carried there by the 90 degree abduction from rest, so flexion
48
+ * and twist turn about one axis, the chart is at its gimbal for every such
49
+ * pose, and the arm's rotation about its length has no coordinate of its own
50
+ * there. With the distal order `flexion` and `abduction` alone place the arm
51
+ * (its line's latitude toward the front and its longitude in the frontal
52
+ * plane) and `twist` is the humeral rotation; the only gimbal left is the arm
53
+ * pointing straight forward or back, where abduction and twist turn about the
54
+ * arm's own line. A pose with no twist is the same rotation in both orders.
55
+ * Every other bone keeps the proximal default.
42
56
  *
43
57
  * Opt in by passing this to {@link resolvePose} / `applyPose`; a bone that
44
58
  * declares its own `axes` keeps them, and a bone absent from both uses
@@ -58,8 +58,22 @@ const HAND = [
58
58
  * The forearm's twist is pronation and supination, which happens beyond the
59
59
  * elbow's hinge, so the lower arms declare a distal twist
60
60
  * (`AutoMovieJointTwistPlacement`): twisting a bent forearm turns it about its
61
- * own length and leaves where it points unchanged. Every other bone keeps the
62
- * proximal default.
61
+ * own length and leaves where it points unchanged.
62
+ *
63
+ * The upper arms declare a distal twist too. The humerus's internal and
64
+ * external rotation turns it about its own length wherever the arm points,
65
+ * which only the distal order composes. In the proximal order the twist turns
66
+ * about the T-pose arm line, fixed in the shoulder girdle: for an arm in the
67
+ * sagittal plane (hanging, swinging, reaching forward) that line is the
68
+ * flexion axis carried there by the 90 degree abduction from rest, so flexion
69
+ * and twist turn about one axis, the chart is at its gimbal for every such
70
+ * pose, and the arm's rotation about its length has no coordinate of its own
71
+ * there. With the distal order `flexion` and `abduction` alone place the arm
72
+ * (its line's latitude toward the front and its longitude in the frontal
73
+ * plane) and `twist` is the humeral rotation; the only gimbal left is the arm
74
+ * pointing straight forward or back, where abduction and twist turn about the
75
+ * arm's own line. A pose with no twist is the same rotation in both orders.
76
+ * Every other bone keeps the proximal default.
63
77
  *
64
78
  * Opt in by passing this to {@link resolvePose} / `applyPose`; a bone that
65
79
  * declares its own `axes` keeps them, and a bone absent from both uses
@@ -80,10 +94,11 @@ exports.HUMANOID_JOINT_AXES = (() => {
80
94
  "rightUpperArm",
81
95
  "rightLowerArm",
82
96
  ];
83
- const forearm = { ...arm, twistPlacement: "distal" };
97
+ // the humerus and the forearm turn about their own length beyond the swing
98
+ const turning = { ...arm, twistPlacement: "distal" };
84
99
  const table = {};
85
100
  for (const s of slots)
86
- table[s] = s === "leftLowerArm" || s === "rightLowerArm" ? forearm : arm;
101
+ table[s] = s === "leftShoulder" || s === "rightShoulder" ? arm : turning;
87
102
  const hand = {
88
103
  flexion: { x: 0, y: 0, z: 1 },
89
104
  abduction: { x: 0, y: 1, z: 0 },
@@ -1 +1 @@
1
- {"version":3,"file":"HUMANOID_JOINT_AXES.js","sourceRoot":"","sources":["../../../src/kinematics/constants/HUMANOID_JOINT_AXES.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"HUMANOID_JOINT_AXES.js","sourceRoot":"","sources":["../../../src/kinematics/constants/HUMANOID_JOINT_AXES.ts"],"names":[],"mappings":"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"}
@@ -66,6 +66,22 @@ export declare function curlChainUntilContact(input: curlChainUntilContact.IInpu
66
66
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the physical profile's shape union and the resolver's axes and rest frames.
67
67
  */
68
68
  export declare namespace curlChainUntilContact {
69
+ /**
70
+ * How far a curled digit's angle may move with the limb that carries it,
71
+ * degrees: a point the limb carries moves by no more than the limb's reach
72
+ * times the joints' tolerance (`ROM_TOLERANCE`, in radians) when the
73
+ * limb's chain is resolved to it, and a digit that closes on a contact
74
+ * follows the hand by about as far at its tip, which at its lever (the
75
+ * length from the joint to the digit's tip) turns it by this angle. A
76
+ * curl solves its own contact far finer (a step bisected 30 times); this
77
+ * is the change a curled digit shows when the limb's resolution moves the
78
+ * hand, not the curl's precision.
79
+ *
80
+ * @param reach The limb's reach, metres: its two segments' lengths.
81
+ * @param lever The joint's lever, metres: its length to the digit's tip.
82
+ * @returns Degrees.
83
+ */
84
+ function resolution(reach: number, lever: number): number;
69
85
  /** The curl request. */
70
86
  interface IInput {
71
87
  /** The rig, whose range of motion caps every flexion. */
@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.curlChainUntilContact = curlChainUntilContact;
4
4
  const Quaternion_1 = require("../math/Quaternion");
5
5
  const Vector3_1 = require("../math/Vector3");
6
+ const physicalHullFaces_1 = require("../physics/physicalHullFaces");
6
7
  const physicalShapeSegmentDistance_1 = require("../physics/physicalShapeSegmentDistance");
7
8
  const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
9
+ const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
8
10
  const resolvePose_1 = require("./resolvePose");
9
11
  /**
10
12
  * Close articulated chains (fingers and thumb) around an object: each
@@ -150,15 +152,53 @@ function curlChainUntilContact(input) {
150
152
  }
151
153
  return { pose: pose(), chains: reports };
152
154
  }
155
+ /**
156
+ * Companion types of {@link curlChainUntilContact}.
157
+ *
158
+ * @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
159
+ * @evidence contracts/development/design.md#principled-representation Chains of rig bones with a tip and a radius, world-placed physical shapes, and per-chain angles and gaps in degrees and metres.
160
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What a grasping consumer passes and reads.
161
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the physical profile's shape union and the resolver's axes and rest frames.
162
+ */
163
+ (function (curlChainUntilContact) {
164
+ /**
165
+ * How far a curled digit's angle may move with the limb that carries it,
166
+ * degrees: a point the limb carries moves by no more than the limb's reach
167
+ * times the joints' tolerance (`ROM_TOLERANCE`, in radians) when the
168
+ * limb's chain is resolved to it, and a digit that closes on a contact
169
+ * follows the hand by about as far at its tip, which at its lever (the
170
+ * length from the joint to the digit's tip) turns it by this angle. A
171
+ * curl solves its own contact far finer (a step bisected 30 times); this
172
+ * is the change a curled digit shows when the limb's resolution moves the
173
+ * hand, not the curl's precision.
174
+ *
175
+ * @param reach The limb's reach, metres: its two segments' lengths.
176
+ * @param lever The joint's lever, metres: its length to the digit's tip.
177
+ * @returns Degrees.
178
+ */
179
+ function resolution(reach, lever) {
180
+ return (ROM_TOLERANCE_1.ROM_TOLERANCE * reach) / lever;
181
+ }
182
+ curlChainUntilContact.resolution = resolution;
183
+ })(curlChainUntilContact || (exports.curlChainUntilContact = curlChainUntilContact = {}));
153
184
  /** Refuse a shape whose dimensions cannot give a distance. */
154
185
  function validate(shape) {
155
- const ok = shape.kind === "sphere"
156
- ? shape.radius > 0
157
- : shape.kind === "capsule"
158
- ? shape.radius > 0 && shape.halfLength >= 0
159
- : shape.halfExtents.x > 0 &&
186
+ let ok;
187
+ if (shape.kind === "sphere")
188
+ ok = shape.radius > 0;
189
+ else if (shape.kind === "capsule")
190
+ ok = shape.radius > 0 && shape.halfLength >= 0;
191
+ else if (shape.kind === "box")
192
+ ok =
193
+ shape.halfExtents.x > 0 &&
160
194
  shape.halfExtents.y > 0 &&
161
195
  shape.halfExtents.z > 0;
196
+ else if (shape.kind === "hull")
197
+ ok = (0, physicalHullFaces_1.physicalHullFaces)(shape.points).faces.length >= 4;
198
+ else {
199
+ shape;
200
+ ok = false;
201
+ }
162
202
  if (!ok)
163
203
  throw new Error(`A collider ${shape.id} has non-positive dimensions`);
164
204
  }
@@ -1 +1 @@
1
- {"version":3,"file":"curlChainUntilContact.js","sourceRoot":"","sources":["../../src/kinematics/curlChainUntilContact.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"curlChainUntilContact.js","sourceRoot":"","sources":["../../src/kinematics/curlChainUntilContact.ts"],"names":[],"mappings":"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"}
@@ -15,6 +15,9 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
15
15
  * (abduction ±90 for a proximal twist, flexion ±90 for a distal one) only one
16
16
  * combination of the outer angles is determined, so the other outer angle is
17
17
  * pinned to 0 and twist takes the rest; the angles still rebuild the rotation.
18
+ * The pin holds within a projected cosine of the square root of the unit
19
+ * roundoff, about 1.5e-8, where the two outer angles are otherwise rounding
20
+ * noise and the pinned angles rebuild the rotation within 1e-7 radian.
18
21
  * A left-handed basis, such as the default (`flexion × abduction = −twist`),
19
22
  * is extracted against `−twist` and the twist sign restored, so the round trip
20
23
  * holds for any orthonormal basis.
@@ -23,7 +26,7 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
23
26
  * `clinical = sign · r + neutral`. A `domain` with a non-null constraint also
24
27
  * considers the rotation's second Euler chart, `(f + 180, 180 − a, t + 180)`
25
28
  * for a proximal twist and `(180 − f, a + 180, t + 180)` for a distal one, and
26
- * full-turn aliases of each that fall inside the constraint's ranges. The
29
+ * the full-turn alias of each angle nearest the constraint's range. The
27
30
  * candidate with the least {@link jointRomOvershoot} wins, the principal chart
28
31
  * on a tie. Every candidate is the same rotation, so a pose no chart can hold
29
32
  * keeps its overshoot instead of being clamped.
@@ -39,7 +42,7 @@ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
39
42
  * @param domain Bone and resolved ROM that choose among equivalent charts;
40
43
  * omitted or with a `null` constraint, the principal chart is returned.
41
44
  *
42
- * @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only cosine at four binary64 unit epsilons takes the undetermined-angle convention. Normalized orthogonal axes and unit input rotations are the premises, and alternate charts/full turns retain the same rotation up to roundoff.
45
+ * @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads sine and projected cosine through atan2, preserving resolvable near-gimbal rotations that asin can round to ninety degrees; only a projected cosine within the square root of the binary64 unit roundoff, where a rounding error and the pin's truncation error meet, takes the undetermined-angle convention. Normalized orthogonal axes and unit input rotations are the premises, and alternate charts/full turns retain the same rotation up to roundoff.
43
46
  * @evidence contracts/development/implementation.md#clear-and-simple-structure The extraction, the handedness correction, the clinical lift and the ROM chart choice sit in one inverse because each depends on the others' convention; ROM scoring is delegated to `jointRomOvershoot` and frame arithmetic to `toClinicalAngle`, so the gate and this inverse read one rule.
44
47
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Selection compares the caller's unchanged constraint and never clamps an angle into range; the gimbal pin is the standard convention for an undetermined pair, not a compensation, and no bone is special-cased.
45
48
  * @evidence contracts/development/common.md#meaningful-documentation States the inverse relationship, both composition orders, the gimbal convention, the handedness correction, the frame lift, both alternate charts and the tie rule, the thrown inputs, the unit-quaternion premise, and each parameter's default.