@automovie/engine 0.0.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 (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -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":";;;AAKA,4EAA4E;AAC5E,MAAM,IAAI,GAAsB;IAC9B,MAAM;IACN,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,eAAe;IACf,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACU,QAAA,mBAAmB,GAE5B,CAAC,GAAG,EAAE;IACR,MAAM,GAAG,GAAwB;QAC/B,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QAC7B,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QAC/B,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;KAC5B,CAAC;IACF,MAAM,KAAK,GAA4B;QACrC,cAAc;QACd,cAAc;QACd,cAAc;QACd,eAAe;QACf,eAAe;QACf,eAAe;KAChB,CAAC;IACF,MAAM,OAAO,GAAwB,EAAE,GAAG,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAgE,EAAE,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,KAAK;QACnB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,MAAM,IAAI,GAAwB;QAChC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QAC7B,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QAC/B,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;KAC5B,CAAC;IACF,4EAA4E;IAC5E,MAAM,KAAK,GAAwB;QACjC,GAAG,IAAI;QACP,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;KACjC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI;YAClB,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,EAA2B,CAAC;gBAC3C,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,cAAc,GAA4B;QAC9C,cAAc;QACd,eAAe;QACf,UAAU;QACV,WAAW;QACX,UAAU;QACV,WAAW;KACZ,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,cAAc;QAC5B,KAAK,CAAC,CAAC,CAAC,GAAG;YACT,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YAC9B,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YAC/B,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;SAC5B,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,EAAE,CAAC"}
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.
@@ -1,38 +1,9 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.decomposeJointRotation = void 0;
4
- const Quaternion_1 = require("../math/Quaternion");
5
- const Vector3_1 = require("../math/Vector3");
6
- const toClinicalAngle_1 = require("../rom/toClinicalAngle");
7
4
  const DEFAULT_JOINT_AXES_1 = require("./constants/DEFAULT_JOINT_AXES");
8
- const jointRomOvershoot_1 = require("./jointRomOvershoot");
5
+ const decomposeJointRotationOnBasis_1 = require("./decomposeJointRotationOnBasis");
9
6
  const normalizeJointAxes_1 = require("./normalizeJointAxes");
10
- const RAD2DEG = 180 / Math.PI;
11
- const QUATERNION_AXES = ["x", "y", "z", "w"];
12
- /**
13
- * Projected cosine below which cancellation is at unit-matrix roundoff and the
14
- * gimbal convention pins one outer angle. Resolvable near-gimbal turns stay active.
15
- */
16
- const GIMBAL_COSINE_EPSILON = 4 * Number.EPSILON;
17
- /** Choose an admitted full-turn alias when one exists; never clamp an angle. */
18
- const periodicAngle = (angle, range) => {
19
- const minimum = range?.min ?? 0;
20
- const maximum = range?.max ?? 0;
21
- if (angle >= minimum && angle <= maximum)
22
- return angle;
23
- const first = Math.ceil((minimum - angle) / 360);
24
- const last = Math.floor((maximum - angle) / 360);
25
- return first > last
26
- ? angle
27
- : angle + 360 * Math.max(first, Math.min(last, 0));
28
- };
29
- const assertFiniteQuaternion = (q) => {
30
- for (const axis of QUATERNION_AXES) {
31
- const value = q[axis];
32
- if (!Number.isFinite(value))
33
- throw new Error(`decomposeJointRotation quaternion.${axis} must be finite, but was ${value}`);
34
- }
35
- };
36
7
  /**
37
8
  * Recover a joint's flexion, abduction and twist, in degrees, from its
38
9
  * bone-local rotation: the inverse of {@link jointToQuaternion} for the same
@@ -46,6 +17,9 @@ const assertFiniteQuaternion = (q) => {
46
17
  * (abduction ±90 for a proximal twist, flexion ±90 for a distal one) only one
47
18
  * combination of the outer angles is determined, so the other outer angle is
48
19
  * pinned to 0 and twist takes the rest; the angles still rebuild the rotation.
20
+ * The pin holds within a projected cosine of the square root of the unit
21
+ * roundoff, about 1.5e-8, where the two outer angles are otherwise rounding
22
+ * noise and the pinned angles rebuild the rotation within 1e-7 radian.
49
23
  * A left-handed basis, such as the default (`flexion × abduction = −twist`),
50
24
  * is extracted against `−twist` and the twist sign restored, so the round trip
51
25
  * holds for any orthonormal basis.
@@ -54,7 +28,7 @@ const assertFiniteQuaternion = (q) => {
54
28
  * `clinical = sign · r + neutral`. A `domain` with a non-null constraint also
55
29
  * considers the rotation's second Euler chart, `(f + 180, 180 − a, t + 180)`
56
30
  * for a proximal twist and `(180 − f, a + 180, t + 180)` for a distal one, and
57
- * full-turn aliases of each that fall inside the constraint's ranges. The
31
+ * the full-turn alias of each angle nearest the constraint's range. The
58
32
  * candidate with the least {@link jointRomOvershoot} wins, the principal chart
59
33
  * on a tie. Every candidate is the same rotation, so a pose no chart can hold
60
34
  * keeps its overshoot instead of being clamped.
@@ -70,7 +44,7 @@ const assertFiniteQuaternion = (q) => {
70
44
  * @param domain Bone and resolved ROM that choose among equivalent charts;
71
45
  * omitted or with a `null` constraint, the principal chart is returned.
72
46
  *
73
- * @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.
47
+ * @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.
74
48
  * @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.
75
49
  * @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.
76
50
  * @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.
@@ -78,104 +52,9 @@ const assertFiniteQuaternion = (q) => {
78
52
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of one rotation that coordinates no work across calls; the arm solve calls it per candidate with a different rotation each time.
79
53
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the caller owns the returned angles.
80
54
  */
81
- const decomposeJointRotation = (q, axes = DEFAULT_JOINT_AXES_1.DEFAULT_JOINT_AXES, frame, domain) => {
82
- assertFiniteQuaternion(q);
83
- const basis = (0, normalizeJointAxes_1.normalizeJointAxes)(axes, "decomposeJointRotation axes");
84
- // Lift a rig-relative extraction into clinical angles (the inverse of
85
- // jointToQuaternion's `frame` map); the identity when no frame is given.
86
- const clinical = (rig) => ({
87
- // toClinicalAngle only returns null for a null input; these are numbers.
88
- flexion: (0, toClinicalAngle_1.toClinicalAngle)(rig.flexion, frame?.flexion),
89
- abduction: (0, toClinicalAngle_1.toClinicalAngle)(rig.abduction, frame?.abduction),
90
- twist: (0, toClinicalAngle_1.toClinicalAngle)(rig.twist, frame?.twist),
91
- });
92
- // Right-handedness of the basis: +1 when flex × abd = +twist. A left-handed
93
- // triple is made right-handed by extracting against −twist, then negating the
94
- // recovered twist (a rotation about −t by θ is one about t by −θ).
95
- const handed = Vector3_1.Vector3.dot(basis.twist, Vector3_1.Vector3.cross(basis.flexion, basis.abduction)) >= 0
96
- ? 1
97
- : -1;
98
- const twistAxis = Vector3_1.Vector3.scale(basis.twist, handed);
99
- const lift = (rig) => {
100
- const principal = clinical(rig);
101
- if (domain === undefined || domain.constraint === null)
102
- return principal;
103
- const constraint = domain.constraint;
104
- const align = (candidate) => ({
105
- flexion: periodicAngle(candidate.flexion, constraint.flexion),
106
- abduction: periodicAngle(candidate.abduction, constraint.abduction),
107
- twist: periodicAngle(candidate.twist, constraint.twist),
108
- });
109
- const alternate = clinical({
110
- flexion: basis.twistPlacement === "distal"
111
- ? 180 - rig.flexion
112
- : rig.flexion + 180,
113
- abduction: basis.twistPlacement === "distal"
114
- ? rig.abduction + 180
115
- : 180 - rig.abduction,
116
- twist: rig.twist + 180 * handed,
117
- });
118
- let selected = principal;
119
- let overshoot = (0, jointRomOvershoot_1.jointRomOvershoot)({ bone: domain.bone, ...selected }, constraint);
120
- for (const candidate of [align(principal), align(alternate)]) {
121
- const next = (0, jointRomOvershoot_1.jointRomOvershoot)({ bone: domain.bone, ...candidate }, constraint);
122
- if (next < overshoot) {
123
- selected = candidate;
124
- overshoot = next;
125
- }
126
- }
127
- return selected;
128
- };
129
- const Rf = Quaternion_1.Quaternion.rotateVector(q, basis.flexion);
130
- const Ra = Quaternion_1.Quaternion.rotateVector(q, basis.abduction);
131
- const Rt = Quaternion_1.Quaternion.rotateVector(q, twistAxis);
132
- // Entries of R' = Mᵀ R M (M = [flex|abd|twist]): R'[i][j] = axisᵢ · (R axisⱼ).
133
- if (basis.twistPlacement === "distal") {
134
- // R = Ry(a)·Rx(f)·Rz(t): R12 = −sin f, R02 = sin a cos f, R22 = cos a cos f,
135
- // R10 = cos f sin t, R11 = cos f cos t (row i: basis axis i, column j:
136
- // basis axis j rotated)
137
- const r12 = Vector3_1.Vector3.dot(basis.abduction, Rt);
138
- const r10 = Vector3_1.Vector3.dot(basis.abduction, Rf);
139
- const r11 = Vector3_1.Vector3.dot(basis.abduction, Ra);
140
- const cosine = Math.hypot(r10, r11);
141
- if (cosine <= GIMBAL_COSINE_EPSILON) {
142
- // with abduction pinned to 0, R = Rx(±90°)·Rz(t): R00 = cos t, R01 = −sin t
143
- const r00 = Vector3_1.Vector3.dot(basis.flexion, Rf);
144
- const r01 = Vector3_1.Vector3.dot(basis.flexion, Ra);
145
- return lift({
146
- flexion: r12 < 0 ? 90 : -90,
147
- abduction: 0,
148
- twist: handed * Math.atan2(-r01, r00) * RAD2DEG,
149
- });
150
- }
151
- return lift({
152
- flexion: Math.atan2(-r12, cosine) * RAD2DEG,
153
- abduction: Math.atan2(Vector3_1.Vector3.dot(basis.flexion, Rt), Vector3_1.Vector3.dot(twistAxis, Rt)) *
154
- RAD2DEG,
155
- twist: handed * Math.atan2(r10, r11) * RAD2DEG,
156
- });
157
- }
158
- const m00 = Vector3_1.Vector3.dot(basis.flexion, Rf);
159
- const m10 = Vector3_1.Vector3.dot(basis.abduction, Rf);
160
- const m20 = Vector3_1.Vector3.dot(twistAxis, Rf);
161
- const m21 = Vector3_1.Vector3.dot(twistAxis, Ra);
162
- const m22 = Vector3_1.Vector3.dot(twistAxis, Rt);
163
- const cosine = Math.hypot(m00, m10);
164
- if (cosine <= GIMBAL_COSINE_EPSILON) {
165
- // Gimbal: abduction = ±90°, flexion folds into twist. Pin flexion = 0.
166
- const m01 = Vector3_1.Vector3.dot(basis.flexion, Ra);
167
- const m11 = Vector3_1.Vector3.dot(basis.abduction, Ra);
168
- // Both gimbals leave only (twist ± flexion) determined; with flexion pinned
169
- // to 0, twist = −atan2(R'[0][1], R'[1][1]) reconstructs the rotation.
170
- const abduction = m20 < 0 ? 90 : -90;
171
- const twist = -Math.atan2(m01, m11) * RAD2DEG;
172
- return lift({ flexion: 0, abduction, twist: handed * twist });
173
- }
174
- return lift({
175
- flexion: Math.atan2(m21, m22) * RAD2DEG,
176
- abduction: Math.atan2(-m20, cosine) * RAD2DEG,
177
- twist: handed * Math.atan2(m10, m00) * RAD2DEG,
178
- });
179
- };
55
+ const decomposeJointRotation = (q, axes = DEFAULT_JOINT_AXES_1.DEFAULT_JOINT_AXES, frame, domain) =>
56
+ // The extraction lives in `decomposeJointRotationOnBasis`, which a solver
57
+ // calls directly on a basis it normalized once; this entry admits the basis.
58
+ (0, decomposeJointRotationOnBasis_1.decomposeJointRotationOnBasis)(q, (0, normalizeJointAxes_1.normalizeJointAxes)(axes, "decomposeJointRotation axes"), frame, domain);
180
59
  exports.decomposeJointRotation = decomposeJointRotation;
181
60
  //# sourceMappingURL=decomposeJointRotation.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"decomposeJointRotation.js","sourceRoot":"","sources":["../../src/kinematics/decomposeJointRotation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"decomposeJointRotation.js","sourceRoot":"","sources":["../../src/kinematics/decomposeJointRotation.ts"],"names":[],"mappings":";;;AAKA,uEAAoE;AACpE,mFAAgF;AAChF,6DAA0D;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACI,MAAM,sBAAsB,GAKE,CACnC,CAAuB,EACvB,IAAI,GAAwB,uCAAkB,EAC9C,KAA2B,EAC3B,MAAsC,EACP,EAAE;AACjC,0EAA0E;AAC1E,6EAA6E;AAC7E,IAAA,6DAA6B,EAC3B,CAAC,EACD,IAAA,uCAAkB,EAAC,IAAI,EAAE,6BAA6B,CAAC,EACvD,KAAK,EACL,MAAM,CACP,CAAC;AAlBS,QAAA,sBAAsB,GAAtB,sBAAsB,CAkB/B"}
@@ -0,0 +1,36 @@
1
+ import { IAutoMovieJointAxes, IAutoMovieQuaternion } from "@automovie/interface";
2
+ import { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
3
+ import { IAutoMovieJointRotationDomain } from "./IAutoMovieJointRotationDomain";
4
+ import { IAutoMovieResolvedJointAngles } from "./IAutoMovieResolvedJointAngles";
5
+ /**
6
+ * {@link decomposeJointRotation} on a basis its caller already admitted and
7
+ * normalized through {@link normalizeJointAxes}: the extraction itself, with
8
+ * no validation of the basis.
9
+ *
10
+ * A solver that decomposes hundreds of candidate rotations of one joint
11
+ * normalizes that joint's basis once and calls this for each candidate, so
12
+ * the basis is checked once per solve rather than once per candidate. The
13
+ * angles, the gimbal convention, the handedness correction, the frame lift
14
+ * and the chart choice are `decomposeJointRotation`'s, which documents them
15
+ * and is this function behind one normalization.
16
+ *
17
+ * Throws on a non-finite quaternion component. A basis that is not
18
+ * orthonormal gives angles that do not rebuild the rotation; nothing here
19
+ * detects it.
20
+ *
21
+ * @param q Bone-local articulation rotation; unit length expected.
22
+ * @param basis Orthonormal clinical axis basis, as `normalizeJointAxes` returns it.
23
+ * @param frame Rest frame lifting rest-relative angles to clinical ones;
24
+ * omitted, the angles stay rest-relative.
25
+ * @param domain Bone and resolved ROM that choose among equivalent charts;
26
+ * omitted or with a `null` constraint, the principal chart is returned.
27
+ *
28
+ * @evidence contracts/development/common.md#meaningful-documentation States what the caller must have done to the basis, why the split exists, that the conventions are `decomposeJointRotation`'s, what is thrown and what an unnormalized basis silently gives.
29
+ * @evidence contracts/development/implementation.md#principled-implementation Closed-form Euler extraction reads each angle's sine and projected cosine through atan2; 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. Among the principal chart, the alternate chart and each angle's full-turn alias nearest its range, the least ROM overshoot wins, and every candidate is the same rotation. A constraint's `swingTwist` is set aside while the readings are ranked, since both readings of one rotation lie equally inside such a gate; the three-angle box ranks them, so the reading a pose reports stays the one it always was.
30
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The extraction, the handedness correction, the clinical lift and the chart choice sit in one inverse because each depends on the others' convention; ROM scoring is delegated to `jointRomOvershoot`, the alias to `nearestAngleAlias` and frame arithmetic to `toClinicalAngle`, and `decomposeJointRotation` is this function behind one normalization.
31
+ * @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, and no bone is special-cased.
32
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three vector rotations, a few dot products and at most three overshoot scores in constant time, an alias that leaves the selected reading unchanged not scored again; taking the basis already normalized removes one validation and normalization from each of the hundreds of candidates a limb fit decomposes.
33
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The caller normalizes a joint's basis once per solve and passes it to every call, which is the reason this entry exists beside `decomposeJointRotation`.
34
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the angles are a new record.
35
+ */
36
+ export declare const decomposeJointRotationOnBasis: (q: IAutoMovieQuaternion, basis: IAutoMovieJointAxes, frame?: IAutoMovieRestFrame | undefined, domain?: IAutoMovieJointRotationDomain | undefined) => IAutoMovieResolvedJointAngles;