@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,251 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fitDigitToTarget = fitDigitToTarget;
4
+ const Quaternion_1 = require("../math/Quaternion");
5
+ const Vector3_1 = require("../math/Vector3");
6
+ const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
7
+ const ROM_TOLERANCE_1 = require("../rom/constants/ROM_TOLERANCE");
8
+ const getConstraint_1 = require("../rom/getConstraint");
9
+ const fitDigitDescent_1 = require("./fitDigitDescent");
10
+ const indexSkeletonTopology_1 = require("./indexSkeletonTopology");
11
+ const resolvePose_1 = require("./resolvePose");
12
+ /**
13
+ * Put a point of a digit (its tip or its pad, a frame on its distal phalanx)
14
+ * on a world point, with the digit's own joints alone, inside their range of
15
+ * motion: the inverse kinematics of one finger or the thumb with the hand
16
+ * where the pose has placed it.
17
+ *
18
+ * Every free axis of every joint of the digit (an axis its constraint does
19
+ * not hold immobile) is a variable, in clinical degrees. The fit has two
20
+ * tasks in priority order. The first puts the effector on the target: its
21
+ * residual is the distance between them. The second, bettered only in what
22
+ * the first leaves free, turns the effector's normal onto the target normal
23
+ * when one is given (the misalignment scaled by the effector's distance from
24
+ * its joint, an arc length, so a degree of tilt counts as the millimetres it
25
+ * swings the phalanx) and keeps a finger's interphalangeal coupling, the
26
+ * distal joint following the middle one at the ratio `coupling` (the
27
+ * coupling of hand animation, DIP = 2/3 PIP, Rijpkema and Girard 1991,
28
+ * SIGGRAPH 25(4):339-348, as relayed by the hand-animation literature;
29
+ * provisional until read at the source), its residual likewise that distance
30
+ * times the angle by which the distal joint misses the ratio. The point
31
+ * goal, optionally eased by soft IK as described below, is never traded
32
+ * against a normal or a coupling it does not allow.
33
+ *
34
+ * Each descent is `fitDigitDescent`: damped task-priority least squares
35
+ * (Nakamura, Hanafusa and Yoshikawa 1987; Chiaverini 1997) with the active
36
+ * set of a projected Newton method (Bertsekas 1982) for the joints on a
37
+ * bound, and Levenberg-Marquardt damping (Madsen, Nielsen and Tingleff 2004).
38
+ * The Jacobians are read by central differences on the engine's own forward
39
+ * kinematics, so the angles mean what `resolvePose` displays, and every
40
+ * trial is projected into the range (`clampJointToSkeleton`) before it is
41
+ * measured. The point counts as reached within the effector's motion for one
42
+ * resolution step of every joint, and a descent stops when its step moves no
43
+ * joint by more than `ROM_TOLERANCE`, the resolution to which the engine
44
+ * resolves a joint's angle.
45
+ * The fit is a continuation: it descends from the pose's own angles for the
46
+ * digit, so a caller that seeds each fit from the one before follows a
47
+ * moving target in one basin, its joints moving continuously. Only when that
48
+ * fit cannot reach the target (the tip farther from it than one joint
49
+ * resolution of every joint would move it) does it restart from the middle
50
+ * of every range, where a digit folded the wrong way round its target is not
51
+ * trapped, keeping the restart only if it comes nearer; it never takes the
52
+ * better of two starts for a target the continued fit reaches, an argmin
53
+ * that would switch basins between neighbouring targets. A caller's `rate`
54
+ * softens the target near full extension, where the exact inverse has an
55
+ * unbounded derivative: the exponential soft IK of Andy Nicholas (2006),
56
+ * demonstrated in Jeremie Passerin's "Control Rig: 5.3: Soft IK" (2024,
57
+ * https://dev.epicgames.com/community/learning/tutorials/y4Ll/unreal-engine-control-rig-5-3-soft-ik).
58
+ * Below the soft band the target is unchanged; within it, some reach is
59
+ * traded for a bounded radial extension rate. The band's width comes from
60
+ * the chain's lengths and the requested rate, not the seed's posture.
61
+ * This controls the full-extension singularity, not every possible change
62
+ * of basin of a constrained digit. The result is
63
+ * deterministic for its input: fixed starts, a fixed order of variables and
64
+ * no random draw. A target outside the digit's workspace is fitted as
65
+ * nearly as this constrained local solve reaches it. With `rate` it fits
66
+ * the eased target instead, so its constrained minimum may differ from
67
+ * the original target's. In either case `residual` reports distance to the
68
+ * original target, including any reach traded away, so a caller refuses
69
+ * or accepts by its own bound.
70
+ *
71
+ * @param input The rig, the posed body, the digit's joints and the effector and target.
72
+ * @returns The digit's fitted joints, the effector's world point and the residual.
73
+ * @throws {Error} When the digit names no joint, a bone cannot be resolved, or `rate` is not finite and positive.
74
+ *
75
+ * @evidence contracts/development/common.md#meaningful-documentation States the variables, the two tasks and their units and order, the coupling's source and status, the method and its sources, the reach and stop rules and their owner, the continuation, determinism and the out-of-reach behaviour.
76
+ * @evidence contracts/development/implementation.md#principled-implementation Damped task-priority least squares (Nakamura et al. 1987, Chiaverini 1997) through `fitDigitDescent` on the engine's forward kinematics, every trial measured after the range clamp, stopping at the engine's joint-angle resolution; continuation from the caller's seed. Optional exponential soft IK eases only the target's radial distance in a band derived from the full-extension curvature.
77
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two residual functions over the digit's variables, one continued descent and a restart only when it cannot reach.
78
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No iteration count and no weight between the tasks: the fit ends at the joint-angle resolution and reports distance from the original target, including any reach soft IK trades away. The width is derived from the chain lengths and `rate`; it does not penalise departure from an arbitrary seed.
79
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each evaluation is one forward kinematics of the rig, linear in its bones; a Jacobian costs two per variable (at most 9 for a digit of three joints) and the active set's probe one clamp per variable; a step solves two small systems of the free variables; a restart, run only for a target the continued fit cannot reach, doubles the work.
80
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; a caller keeps the result by its own plan.
81
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the returned joints belong to the caller.
82
+ */
83
+ function fitDigitToTarget(input) {
84
+ if (input.bones.length === 0)
85
+ throw new Error("A digit fit needs the digit's joints");
86
+ if (input.rate !== undefined &&
87
+ !(Number.isFinite(input.rate) && input.rate > 0))
88
+ throw new Error("A digit fit's rate must be finite and positive");
89
+ const topology = input.topology ?? (0, indexSkeletonTopology_1.indexSkeletonTopology)(input.skeleton);
90
+ const coupling = input.coupling ?? null;
91
+ const target = softTarget(input, topology);
92
+ // The digit's free axes, in the order of its joints.
93
+ const variables = [];
94
+ for (const bone of input.bones) {
95
+ const constraint = (0, getConstraint_1.getConstraint)(bone, input.skeleton.bones.find((b) => b.bone === bone)
96
+ ?.constraint ?? null);
97
+ for (const axis of AXES)
98
+ if (constraint === null || constraint[axis] !== null)
99
+ variables.push({ bone, axis, range: constraint?.[axis] ?? null });
100
+ }
101
+ const clamps = new Map(input.bones.map((bone) => [bone, clampJointToSkeleton_1.clampJointToSkeleton.of(bone, input.skeleton)]));
102
+ const others = input.pose.joints.filter((j) => !input.bones.includes(j.bone));
103
+ // The digit's joints for a vector of variables, projected into the range.
104
+ const joints = (x) => input.bones.map((bone) => {
105
+ const joint = {
106
+ bone,
107
+ flexion: null,
108
+ abduction: null,
109
+ twist: null,
110
+ };
111
+ variables.forEach((v, i) => {
112
+ if (v.bone === bone)
113
+ joint[v.axis] = x[i];
114
+ });
115
+ return clamps.get(bone)(joint);
116
+ });
117
+ const read = (list) => variables.map((v) => {
118
+ const joint = list.find((j) => j.bone === v.bone);
119
+ return joint?.[v.axis] ?? 0;
120
+ });
121
+ // The effector's world frame under the digit's joints.
122
+ const place = (list) => {
123
+ const pose = {
124
+ ...input.pose,
125
+ joints: [...others, ...list],
126
+ };
127
+ const resolved = (0, resolvePose_1.resolvePose)(pose, input.skeleton, input.jointAxes, input.restFrames, topology).find((r) => r.bone === input.effector.bone);
128
+ if (resolved === undefined)
129
+ throw new Error(`A digit fit cannot resolve ${input.effector.bone}`);
130
+ return {
131
+ point: Vector3_1.Vector3.add(resolved.worldPosition, Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.point)),
132
+ normal: Quaternion_1.Quaternion.rotateVector(resolved.worldRotation, input.effector.normal),
133
+ };
134
+ };
135
+ // The primary residual, metres: where the effector is less the target.
136
+ // The secondary, metres: the normal's misalignment and the coupling, each
137
+ // as an arc length on the distal phalanx.
138
+ const length = Vector3_1.Vector3.length(input.effector.point);
139
+ const primary = (x) => {
140
+ const at = place(joints(x));
141
+ return [
142
+ at.point.x - target.x,
143
+ at.point.y - target.y,
144
+ at.point.z - target.z,
145
+ ];
146
+ };
147
+ const secondary = (x) => {
148
+ const list = joints(x);
149
+ const r = [];
150
+ if (input.normal !== undefined) {
151
+ const miss = Vector3_1.Vector3.cross(place(list).normal, Vector3_1.Vector3.normalize(input.normal));
152
+ r.push(miss.x * length, miss.y * length, miss.z * length);
153
+ }
154
+ if (coupling !== null && input.bones.length >= 3) {
155
+ const middle = list[1].flexion ?? 0;
156
+ const distal = list[2].flexion ?? 0;
157
+ r.push(((distal - coupling * middle) * Math.PI * length) / 180);
158
+ }
159
+ return r;
160
+ };
161
+ // The effector's motion for one resolution step of every joint: the
162
+ // nearest the point can be put, so the primary counts as met within it.
163
+ const tolerance = (_x, J1) => variables.reduce((sum, _v, i) => sum + Math.hypot(J1[0][i], J1[1][i], J1[2][i]) * ROM_TOLERANCE_1.ROM_TOLERANCE, 0);
164
+ const jacobian = (x) => [0, 1, 2].map((k) => x.map((_v, i) => {
165
+ const up = [...x];
166
+ const down = [...x];
167
+ up[i] = up[i] + ROM_TOLERANCE_1.ROM_TOLERANCE;
168
+ down[i] = down[i] - ROM_TOLERANCE_1.ROM_TOLERANCE;
169
+ return (primary(up)[k] - primary(down)[k]) / (2 * ROM_TOLERANCE_1.ROM_TOLERANCE);
170
+ }));
171
+ const seed = read(input.pose.joints);
172
+ const descend = (start) => (0, fitDigitDescent_1.fitDigitDescent)({
173
+ start,
174
+ primary,
175
+ secondary,
176
+ project: (x) => read(joints(x)),
177
+ step: ROM_TOLERANCE_1.ROM_TOLERANCE,
178
+ tolerance,
179
+ });
180
+ // Continuation: the descent starts from the pose's own angles, so a
181
+ // caller that seeds each fit from the one before follows the target
182
+ // continuously in one basin. Only a continued fit that cannot reach (its
183
+ // point farther than `tolerance`) restarts from the middle of every range,
184
+ // where a digit folded the wrong way round its target is not trapped, and
185
+ // keeps that fit only when it comes nearer.
186
+ const reach = (x) => Math.hypot(...primary(x));
187
+ const continued = descend(seed);
188
+ let x = continued;
189
+ if (reach(continued) > tolerance(continued, jacobian(continued))) {
190
+ const restarted = descend(variables.map((v) => v.range === null ? 0 : (v.range.min + v.range.max) / 2));
191
+ if (reach(restarted) < reach(continued))
192
+ x = restarted;
193
+ }
194
+ const fitted = joints(x);
195
+ const at = place(fitted);
196
+ return {
197
+ joints: fitted,
198
+ point: at.point,
199
+ normal: at.normal,
200
+ residual: Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(at.point, input.target)),
201
+ };
202
+ }
203
+ /**
204
+ * Exponential soft IK in the radial coordinate: identity below L-s and
205
+ * L-s exp(-(d-(L-s))/s) above it. For a hinge dividing the straight chain
206
+ * into lengths a and b, the cosine rule gives L-d = k theta² + O(theta⁴),
207
+ * k = ab/(2L) (pi/180)² in metres per degree squared. In that leading-order
208
+ * model the inverse's radial rate at the band's start is 1/(2 sqrt(k s))
209
+ * and falls exponentially thereafter, giving s = 1/(4 k rate²), using the
210
+ * smallest hinge curvature. This local model is not a global rate proof
211
+ * for the nonlinear, range-constrained chain.
212
+ * The band is at most the chain's whole length; a chain with no positive
213
+ * internal hinge has no full-extension fold to soften. Link lengths are
214
+ * invariant under the pose; only the base's world place follows it.
215
+ */
216
+ const softTarget = (input, topology) => {
217
+ if (input.rate === undefined)
218
+ return input.target;
219
+ const posed = (0, resolvePose_1.resolvePose)(input.pose, input.skeleton, input.jointAxes, input.restFrames, topology);
220
+ const points = input.bones.map((bone) => {
221
+ const frame = posed.find((p) => p.bone === bone);
222
+ if (frame === undefined)
223
+ throw new Error(`A digit fit cannot resolve ${bone}`);
224
+ return frame.worldPosition;
225
+ });
226
+ const links = points
227
+ .slice(1)
228
+ .map((point, i) => Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(point, points[i])));
229
+ links.push(Vector3_1.Vector3.length(input.effector.point));
230
+ const reach = links.reduce((sum, link) => sum + link, 0);
231
+ let left = 0;
232
+ const curvatures = links
233
+ .slice(0, -1)
234
+ .map((link) => {
235
+ left += link;
236
+ return ((left * (reach - left)) / (2 * reach)) * (Math.PI / 180) ** 2;
237
+ })
238
+ .filter((k) => k > 0);
239
+ if (curvatures.length === 0)
240
+ return input.target;
241
+ const width = Math.min(reach, 1 / (4 * Math.min(...curvatures) * input.rate ** 2));
242
+ const delta = Vector3_1.Vector3.subtract(input.target, points[0]);
243
+ const distance = Vector3_1.Vector3.length(delta);
244
+ if (distance === 0 || distance <= reach - width)
245
+ return input.target;
246
+ const eased = reach - width * Math.exp(-(distance - (reach - width)) / width);
247
+ return Vector3_1.Vector3.add(points[0], Vector3_1.Vector3.scale(delta, eased / distance));
248
+ };
249
+ /** The clinical axes of a joint, in the order variables are read. */
250
+ const AXES = ["flexion", "abduction", "twist"];
251
+ //# sourceMappingURL=fitDigitToTarget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fitDigitToTarget.js","sourceRoot":"","sources":["../../src/kinematics/fitDigitToTarget.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  import { IAutoMovieQuaternion, IAutoMovieVector3 } from "@automovie/interface";
2
2
  import { IAutoMovieChainBone } from "./IAutoMovieChainBone";
3
3
  import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
4
+ import { IAutoMovieSwivelNear } from "./IAutoMovieSwivelNear";
4
5
  /**
5
6
  * Two-bone arm IK whose mid joint bends only about its own flexion hinge, with
6
7
  * the chain root's free swivel spent on the rig's range of motion.
@@ -16,14 +17,52 @@ import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
16
17
  * with `R = hypot(α, β)` and `φ = atan2(β, α)`: an arccos whose two roots are
17
18
  * the chain's two bend branches. A target outside the reachable span takes the
18
19
  * fully extended or fully folded root, so the effector stops on the reachable
19
- * shell along the line to the target.
20
+ * shell along the line to the target. A root outside the mid joint's own
21
+ * `range` stops at the nearer limit in the same way, the effector resting on
22
+ * the legal shell along that line and the result reporting the `shortfall`;
23
+ * of two branches the one stopping nearer the target is swept, because a
24
+ * candidate past the hinge's limit would be clamped by the caller afterwards
25
+ * and land somewhere no candidate was scored at.
20
26
  *
21
27
  * The root joint first aims `m(θ)` at the target, then any extra rotation
22
28
  * about `m(θ)` leaves the effector where it is. The function sweeps that swivel
23
- * in `SWIVEL_STEP` increments on each branch and keeps the candidate with the
24
- * least `overshoot`, compared exactly, then the least `deviation`, both from
25
- * `score`. The caller owns the decomposition and the rig's ROM, so the
26
- * geometry here holds no rig policy.
29
+ * in `SWIVEL_STEP` increments on each branch, ordering candidates by the least
30
+ * `overshoot` (legal, zero, ahead of any other exactly; two positive ones
31
+ * tied within the decomposition's rounding, `OVERSHOOT_ROUNDING`), then the
32
+ * least `deviation`, both from
33
+ * `score`. Every local minimum of a sweep is then refined between its
34
+ * neighbouring steps by golden-section search under the same ordering, and
35
+ * the best of the sweeps and the refinements is returned. A pass whose two
36
+ * probes tie closes the bracket onto both, so a request mirrored left to
37
+ * right, whose probes are the same two exchanged, refines to the mirrored
38
+ * swivel. So the chosen pose
39
+ * follows a moving target continuously rather than in swivel steps, a legal
40
+ * interval narrower than one step is still found from the dip it leaves in
41
+ * the sweep, and between two basins the truly better one wins rather than the
42
+ * one a sample happened to fall nearer the bottom of. The caller owns the
43
+ * decomposition and the rig's ROM, so the geometry here holds no rig policy.
44
+ *
45
+ * A caller that can certify swivels its score refuses (`excluded`) spares
46
+ * their scoring, and the pose is still the full sweep's. A step is skipped
47
+ * when every swivel within two steps of it is refused, and a step whose
48
+ * bracket, a step either way, is refused is not refined; every other step is
49
+ * scored and compared with its true neighbours, since a step that is not
50
+ * skipped and could be refined has both neighbours scored. When the pruned
51
+ * sweep finds a legal candidate, the full sweep's answer is that candidate:
52
+ * a refused swivel, a step or a refinement inside a refused bracket, is
53
+ * never legal, so it can never be ahead of a legal candidate (legality is
54
+ * compared exactly); every legal candidate of the full sweep is a scored
55
+ * step or the refinement of a step that is scored with the same neighbours,
56
+ * so it is the same candidate in both; and the ordering among legal
57
+ * candidates, met in the same order, is the same. When the pruned sweep
58
+ * finds none, the full sweep decides, so a chain that cannot reach legally
59
+ * still returns its least overshoot.
60
+ *
61
+ * A caller continuing a fit of a nearby target (`near`) skips the sweep: the
62
+ * seed's branch, its swivel refined within one step either way by the same
63
+ * golden-section search under the same ordering, to the seed's `tolerance`
64
+ * (`IAutoMovieSwivelNear`). Every result names its branch and swivel, the
65
+ * seed a nearby fit continues from.
27
66
  *
28
67
  * Returns `null` for a degenerate chain: a mid or end offset shorter than
29
68
  * `1e-6`, a target within `1e-6` of the chain root, a hinge shorter than
@@ -34,9 +73,9 @@ import { IAutoMovieHingedArticulation } from "./IAutoMovieHingedArticulation";
34
73
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Pure chain geometry with the ROM policy injected through `score`, so `reachPose` owns the clinical decomposition and constraints while this function owns the branches and the sweep; the shared `aimRotation` aims the root.
35
74
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No rig, side or target is special-cased; the degeneracy thresholds are the engine's shared length scale, and a chain that cannot reach legally returns its least overshoot instead of being clamped into range.
36
75
  * @evidence contracts/development/common.md#meaningful-documentation States the hinge-only elbow, the span formula and its branches, the out-of-span behavior, the swivel sweep and its ordering, who owns scoring, every `null` case with its threshold, and each input's frame.
37
- * @evidence contracts/development/implementation.md#efficient-algorithms At most two branches times 360 swivel steps, each one quaternion product plus one `score` call, so cost is constant per solve and dominated by `score`; the step is a resolution choice among equally exact poses, and the solve runs once per authored arm action.
76
+ * @evidence contracts/development/implementation.md#efficient-algorithms At most two branches times 360 swivel steps plus 42 refinement probes per local minimum of a sweep (one more for each tied pass, at most 82), each one quaternion product plus one `score` call, so cost is bounded per solve and dominated by `score`; a level sweep refines nothing, and the step is a resolution choice among equally exact poses. A continued fit scores only its refinement, two probes and log(tolerance / 2 STEP) / log(GOLDEN) passes, 25 at the 3.8e-5 degrees a velocity read for a 0.4 s inertialization needs (`samplePoseVelocity.tolerance`). Steps a caller certifies refused are not scored, which leaves the answer the full sweep's and, when no legal candidate remains, costs one more full sweep.
38
77
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Each hinge branch computes its mid direction and aim once for the whole swivel sweep; scores cannot be shared because the caller evaluates distinct shoulder rotations under its own constraints.
39
- * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps only the current best candidate during the sweep and retains nothing after it; the caller owns the returned rotations.
78
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps one branch's 360 scored candidates during its sweep and retains nothing after the solve; the caller owns the returned rotations.
40
79
  */
41
80
  export declare const hingedArmArticulation: (props: {
42
81
  upper: IAutoMovieChainBone;
@@ -45,8 +84,17 @@ export declare const hingedArmArticulation: (props: {
45
84
  endOffset: IAutoMovieVector3;
46
85
  hinge: IAutoMovieVector3;
47
86
  target: IAutoMovieVector3;
87
+ range?: {
88
+ min: number;
89
+ max: number;
90
+ };
48
91
  score: (upper: IAutoMovieQuaternion, lower: IAutoMovieQuaternion) => {
49
92
  overshoot: number;
50
93
  deviation: number;
94
+ exact?: () => number;
95
+ tiebreak?: () => number;
51
96
  };
97
+ excluded?: (upper: (swivel: number) => IAutoMovieQuaternion) => (low: number, high: number) => boolean;
98
+ near?: IAutoMovieSwivelNear;
99
+ tie?: number;
52
100
  }) => IAutoMovieHingedArticulation | null;