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