@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.carriedRate = carriedRate;
4
+ /**
5
+ * What a rate at a cut adds to a path that starts at rest, so the sum leaves
6
+ * the cut at that rate.
7
+ *
8
+ * A path planned from rest (a minimum-jerk reach, say) joined to a motion
9
+ * that was moving breaks the velocity at the join. Adding the entry rate
10
+ * times this term mends it: the term is the quintic Hermite basis of a unit
11
+ * initial velocity over `duration` seconds, `D (u - 6 u^3 + 8 u^4 - 3 u^5)`
12
+ * with `u = elapsed / D`, the one quintic with zero value, unit slope and
13
+ * zero acceleration at the start and zero value, slope and acceleration at
14
+ * the end. The sum therefore keeps the entry's velocity without a step in
15
+ * acceleration at the cut, and is the planned path again from `duration` on.
16
+ * The term rises to `PEAK` times the duration at a third of it and returns
17
+ * without crossing zero, so a rate `v` displaces the path by at most
18
+ * `PEAK * duration * |v|`: a caller with only so much room shortens the
19
+ * duration to fit it.
20
+ *
21
+ * {@link inertializeOffset} with a zero offset is the same idea with zero
22
+ * jerk at the end instead of zero acceleration at the start; its lobe starts
23
+ * with the acceleration `-8 v / duration`, which shows on a fast limb, so a
24
+ * law that carries a rate into a path of its own uses this term.
25
+ *
26
+ * @param duration Seconds over which the rate is carried; positive.
27
+ * @param elapsed Seconds since the cut; clamped into the duration.
28
+ * @returns Seconds: the displacement per unit rate.
29
+ * @throws {Error} When the duration is not positive and finite, or the elapsed time is not finite.
30
+ *
31
+ * @evidence contracts/development/common.md#meaningful-documentation States the break the term mends, the polynomial and its six end conditions, the peak and the room it bounds, how it differs from `inertializeOffset` and when to use which, the units, the clamp and the thrown inputs.
32
+ * @evidence contracts/development/implementation.md#principled-implementation The quintic Hermite basis function of a unit initial first derivative, fixed by zero value and acceleration at both ends, unit slope at the start and zero at the end; scaling by the duration maps the unit interval to seconds.
33
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One closed-form polynomial in the normalized time; the caller multiplies by its own entry rate, so the term carries no state and no unit of the path.
34
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The elapsed time is clamped into the duration because the basis is defined there and zero at both ends, so the clamp changes no value; a non-positive or non-finite duration is refused instead of answered with zero.
35
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Seven multiplications in constant time, with no algorithm to choose.
36
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of two numbers that coordinates no work across calls.
37
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the result is a local number.
38
+ */
39
+ function carriedRate(duration, elapsed) {
40
+ if (!Number.isFinite(elapsed) ||
41
+ !(duration > 0) ||
42
+ !Number.isFinite(duration))
43
+ throw new Error("A carried rate needs a finite elapsed time and a positive duration");
44
+ const u = Math.min(1, Math.max(0, elapsed / duration));
45
+ const u3 = u * u * u;
46
+ return duration * (u - 6 * u3 + 8 * u3 * u - 3 * u3 * u * u);
47
+ }
48
+ /**
49
+ * Companion constants of {@link carriedRate}.
50
+ *
51
+ * @evidence contracts/development/common.md#meaningful-documentation Names what the namespace holds; its one member states its value, its unit and where the term reaches it.
52
+ * @evidence contracts/development/design.md#principled-representation The peak is the exact rational `16 / 81`, the basis at its stationary point a third of the way, in durations, the unit the function returns per unit rate.
53
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One constant, read by callers that shorten a carry to fit the room they have; it lives beside the function whose polynomial fixes it.
54
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts A plain number derived from the polynomial, with no cast, no optional member and no copy of a value owned elsewhere.
55
+ */
56
+ (function (carriedRate) {
57
+ /** The term's largest value in durations, reached at a third of the duration: `16 / 81`. */
58
+ carriedRate.PEAK = 16 / 81;
59
+ })(carriedRate || (exports.carriedRate = carriedRate = {}));
60
+ //# sourceMappingURL=carriedRate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"carriedRate.js","sourceRoot":"","sources":["../../src/motion/carriedRate.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAA4B,QAAgB,EAAE,OAAe;IAC3D,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAE1B,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,MAAM,CAAC,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC/D,MAAM,EAAE,GAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,WAAiB,WAAW;IAC1B,4FAA4F;IAC/E,gBAAI,GAAW,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC,EAHgB,WAAW,aAtBZ,WAAW,GAsBV,WAAW,QAG3B"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * The width of one residual bucket of a chain fit, model metres: two
3
+ * candidates whose effector misses the target by amounts in the same bucket
4
+ * reach it equally, and the one nearer the reference pose wins
5
+ * (`fitSeededChainToTarget`). A tenth of a micrometre, far below every
6
+ * contact and clearance verdict, which read millimetres, and far above the
7
+ * rounding of a body-scale forward kinematics, so two misses closer than it
8
+ * are one miss, the position tie of a fit ranked position first.
9
+ */
10
+ export declare const PLANT_RESIDUAL_EPSILON: number;
@@ -0,0 +1,14 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PLANT_RESIDUAL_EPSILON = void 0;
4
+ /**
5
+ * The width of one residual bucket of a chain fit, model metres: two
6
+ * candidates whose effector misses the target by amounts in the same bucket
7
+ * reach it equally, and the one nearer the reference pose wins
8
+ * (`fitSeededChainToTarget`). A tenth of a micrometre, far below every
9
+ * contact and clearance verdict, which read millimetres, and far above the
10
+ * rounding of a body-scale forward kinematics, so two misses closer than it
11
+ * are one miss, the position tie of a fit ranked position first.
12
+ */
13
+ exports.PLANT_RESIDUAL_EPSILON = 1e-7;
14
+ //# sourceMappingURL=PLANT_RESIDUAL_EPSILON.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PLANT_RESIDUAL_EPSILON.js","sourceRoot":"","sources":["../../../src/motion/constants/PLANT_RESIDUAL_EPSILON.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACU,QAAA,sBAAsB,GAAW,IAAI,CAAC"}
@@ -1,2 +1,3 @@
1
1
  export * from "./HUMANOID_LEG_CHAINS";
2
2
  export * from "./LOCOMOTE_GROUND_EPSILON";
3
+ export * from "./PLANT_RESIDUAL_EPSILON";
@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./HUMANOID_LEG_CHAINS"), exports);
18
18
  __exportStar(require("./LOCOMOTE_GROUND_EPSILON"), exports);
19
+ __exportStar(require("./PLANT_RESIDUAL_EPSILON"), exports);
19
20
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/motion/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/motion/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C;AAC1C,2DAAyC"}
@@ -0,0 +1,23 @@
1
+ import type { IAutoMovieSeededChainFit } from "./IAutoMovieSeededChainFit";
2
+ import type { IFitChainToTargetProps } from "./IFitChainToTargetProps";
3
+ /**
4
+ * The bend-plane fit of `fitSeededChainToTarget`, before its effector is
5
+ * oriented, with the seed of its hinged candidate when that candidate is the
6
+ * answer: the hinged swivel candidate first when the mid joint is a hinge,
7
+ * then the bend hint's plane, then the 32-plane sweep and its local
8
+ * halvings, candidates ranked by their clamped residual's bucket
9
+ * (`PLANT_RESIDUAL_EPSILON`), then their turn from the reference pose, then
10
+ * the exact residual.
11
+ *
12
+ * @param input The fit request.
13
+ * @returns The fitted pose and its seed, or null for none.
14
+ *
15
+ * @evidence contracts/development/common.md#meaningful-documentation States the order of the candidates, the ranking and the result.
16
+ * @evidence contracts/development/implementation.md#principled-implementation The swivel parameterisation of Tolani, Goswami and Badler 2000 for a hinged mid joint (`fitHingedChainCandidate`), and a pole vector's bend plane as game-engine two-bone IK takes it, every candidate judged by its clamped forward kinematics.
17
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The search alone: preparation, the analytic solve, the swivel candidate and the candidate's forward kinematics have their own owners.
18
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A degenerate preparation or solve keeps the given pose; no ideal measurement replaces the clamped forward kinematics.
19
+ * @evidence contracts/development/implementation.md#efficient-algorithms At most 34 initial candidates plus 32 minima times 20 refinement candidates, each a constant-size forward kinematics, and the search stops at the first exact one.
20
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every candidate shares the prepared frames, domains and reference angles.
21
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The sweep's arrays hold at most 32 entries and every temporary pose is released with the call.
22
+ */
23
+ export declare const fitChainBend: (input: IFitChainToTargetProps) => IAutoMovieSeededChainFit;
@@ -0,0 +1,293 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fitChainBend = void 0;
4
+ const DEFAULT_JOINT_AXES_1 = require("../kinematics/constants/DEFAULT_JOINT_AXES");
5
+ const jointToQuaternion_1 = require("../kinematics/jointToQuaternion");
6
+ const skeletonJointAxes_1 = require("../kinematics/skeletonJointAxes");
7
+ const Quaternion_1 = require("../math/Quaternion");
8
+ const Vector3_1 = require("../math/Vector3");
9
+ const clampJointToSkeleton_1 = require("../rom/clampJointToSkeleton");
10
+ const PLANT_RESIDUAL_EPSILON_1 = require("./constants/PLANT_RESIDUAL_EPSILON");
11
+ const fitHingedChainCandidate_1 = require("./fitHingedChainCandidate");
12
+ const prepareChainPlant_1 = require("./prepareChainPlant");
13
+ const resolveBoneMap_1 = require("./resolveBoneMap");
14
+ const resolvePreparedChainEffector_1 = require("./resolvePreparedChainEffector");
15
+ const solvePreparedChainPlant_1 = require("./solvePreparedChainPlant");
16
+ /**
17
+ * The bend-plane fit of `fitSeededChainToTarget`, before its effector is
18
+ * oriented, with the seed of its hinged candidate when that candidate is the
19
+ * answer: the hinged swivel candidate first when the mid joint is a hinge,
20
+ * then the bend hint's plane, then the 32-plane sweep and its local
21
+ * halvings, candidates ranked by their clamped residual's bucket
22
+ * (`PLANT_RESIDUAL_EPSILON`), then their turn from the reference pose, then
23
+ * the exact residual.
24
+ *
25
+ * @param input The fit request.
26
+ * @returns The fitted pose and its seed, or null for none.
27
+ *
28
+ * @evidence contracts/development/common.md#meaningful-documentation States the order of the candidates, the ranking and the result.
29
+ * @evidence contracts/development/implementation.md#principled-implementation The swivel parameterisation of Tolani, Goswami and Badler 2000 for a hinged mid joint (`fitHingedChainCandidate`), and a pole vector's bend plane as game-engine two-bone IK takes it, every candidate judged by its clamped forward kinematics.
30
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure The search alone: preparation, the analytic solve, the swivel candidate and the candidate's forward kinematics have their own owners.
31
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A degenerate preparation or solve keeps the given pose; no ideal measurement replaces the clamped forward kinematics.
32
+ * @evidence contracts/development/implementation.md#efficient-algorithms At most 34 initial candidates plus 32 minima times 20 refinement candidates, each a constant-size forward kinematics, and the search stops at the first exact one.
33
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every candidate shares the prepared frames, domains and reference angles.
34
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The sweep's arrays hold at most 32 entries and every temporary pose is released with the call.
35
+ */
36
+ const fitChainBend = (input) => {
37
+ // Declared bone axes take precedence over the host table, once, so the
38
+ // preparation, the analytic solve and the candidate FK read one basis.
39
+ const props = {
40
+ ...input,
41
+ jointAxes: (0, skeletonJointAxes_1.skeletonJointAxes)(input.skeleton, input.jointAxes),
42
+ };
43
+ const prepared = (0, prepareChainPlant_1.prepareChainPlant)(props);
44
+ if (prepared === null)
45
+ return { pose: props.pose, seed: null };
46
+ const solve = (bendNormal) => (0, solvePreparedChainPlant_1.solvePreparedChainPlant)({
47
+ prepared,
48
+ target: props.target,
49
+ bendNormal,
50
+ jointAxes: props.jointAxes,
51
+ restFrames: props.restFrames,
52
+ });
53
+ // A bend hint picks the bend plane the way a pole vector does in game-engine
54
+ // two-bone IK (Unreal's Two Bone IK joint target, Unity's
55
+ // TwoBoneIKConstraint hint): the mid joint is displaced toward the hint's
56
+ // component across the root-to-target axis. Without a hint, the analytic
57
+ // default bends toward world-down and the search below takes over.
58
+ const pole = solve(props.bend === undefined
59
+ ? undefined
60
+ : hintNormal(prepared.upper.worldPosition, props.target, props.bend));
61
+ if (pole === null)
62
+ return { pose: props.pose, seed: null };
63
+ const authored = (0, resolveBoneMap_1.resolveBoneMap)(props.skeleton, props.pose, props.topology, props.jointAxes, props.restFrames).get(props.chain.effector).worldPosition;
64
+ const distance = (position) => Vector3_1.Vector3.length(Vector3_1.Vector3.subtract(position, props.target));
65
+ const reference = props.referencePose ?? props.pose;
66
+ const referenceAngles = new Map(reference.joints.map((joint) => [joint.bone, joint]));
67
+ const authoredAngles = new Map(props.pose.joints.map((joint) => [joint.bone, joint]));
68
+ const rotationDistance = (bone, candidate) => jointRotationDistance(candidate ?? {
69
+ bone,
70
+ flexion: null,
71
+ abduction: null,
72
+ twist: null,
73
+ }, referenceAngles.get(bone), props.jointAxes?.[bone], props.restFrames?.[bone]);
74
+ let best = {
75
+ pose: props.pose,
76
+ residual: distance(authored),
77
+ continuity: props.referencePose === undefined
78
+ ? 0
79
+ : rotationDistance(props.chain.upper, authoredAngles.get(props.chain.upper)) +
80
+ rotationDistance(props.chain.lower, authoredAngles.get(props.chain.lower)),
81
+ };
82
+ const consider = (solved) => {
83
+ const upper = (0, clampJointToSkeleton_1.clampJointToSkeleton)(solved.upper, props.skeleton);
84
+ const lower = (0, clampJointToSkeleton_1.clampJointToSkeleton)(solved.lower, props.skeleton);
85
+ const candidate = {
86
+ ...props.pose,
87
+ joints: [
88
+ ...props.pose.joints.filter((joint) => joint.bone !== props.chain.upper &&
89
+ joint.bone !== props.chain.lower),
90
+ upper,
91
+ lower,
92
+ ],
93
+ };
94
+ const candidateResidual = distance((0, resolvePreparedChainEffector_1.resolvePreparedChainEffector)({
95
+ prepared,
96
+ upper,
97
+ lower,
98
+ jointAxes: props.jointAxes,
99
+ restFrames: props.restFrames,
100
+ }));
101
+ const continuity = jointRotationDistance(upper, referenceAngles.get(upper.bone), props.jointAxes?.[upper.bone], props.restFrames?.[upper.bone]) +
102
+ jointRotationDistance(lower, referenceAngles.get(lower.bone), props.jointAxes?.[lower.bone], props.restFrames?.[lower.bone]);
103
+ const score = {
104
+ residual: candidateResidual,
105
+ continuity,
106
+ };
107
+ if (comparePlantCandidate(score, best) < 0)
108
+ best = {
109
+ pose: candidate,
110
+ residual: candidateResidual,
111
+ continuity,
112
+ };
113
+ return score;
114
+ };
115
+ const canFinish = () => plantResidualBucket(best.residual) === 0 &&
116
+ (props.referencePose === undefined ||
117
+ best.continuity <= PLANT_CONTINUITY_EPSILON);
118
+ // A hinged mid joint (an elbow or a knee, whose abduction is immobile) can
119
+ // bend only about its own flexion axis, while the free-swing candidates
120
+ // turn it about the bend-plane normal and leave an abduction the ROM clamp
121
+ // then removes, moving the effector. The swivel parameterisation (Tolani,
122
+ // Goswami and Badler 2000) fixes the hinge angle from the span and spends
123
+ // the remaining swivel about the root-to-effector axis on the rig's range
124
+ // of motion; `hingedArmArticulation` sweeps it and keeps the candidate with
125
+ // the least ROM overshoot, then the one nearest the bend hint. With a
126
+ // requested effector rotation the swivel also decides whether that rotation
127
+ // is reachable, since the end joint cannot twist about its own length (a
128
+ // wrist turns only with the forearm's distal twist, an ankle only with the
129
+ // whole leg's swivel, the hip's rotation): Tolani's analysis chooses the
130
+ // swivel inside the end joint's limits too, so that candidate leads.
131
+ const hingeAxes = props.jointAxes?.[props.chain.lower] ?? DEFAULT_JOINT_AXES_1.DEFAULT_JOINT_AXES;
132
+ const hingedMid = prepared.lowerDomain.constraint !== null &&
133
+ prepared.lowerDomain.constraint.abduction === null &&
134
+ hingeAxes !== undefined;
135
+ // A hinged chain takes the swivel candidate whenever it reaches, so the
136
+ // choice never alternates between two methods from frame to frame; the
137
+ // hint plane and the sweep remain for a chain the swivel cannot solve.
138
+ if (hingedMid) {
139
+ const hinged = (0, fitHingedChainCandidate_1.fitHingedChainCandidate)(props, prepared, hingeAxes, props.effectorRotation);
140
+ if (hinged !== null) {
141
+ const upper = (0, clampJointToSkeleton_1.clampJointToSkeleton)(hinged.upper, props.skeleton);
142
+ const lower = (0, clampJointToSkeleton_1.clampJointToSkeleton)(hinged.lower, props.skeleton);
143
+ const residual = distance((0, resolvePreparedChainEffector_1.resolvePreparedChainEffector)({
144
+ prepared,
145
+ upper,
146
+ lower,
147
+ jointAxes: props.jointAxes,
148
+ restFrames: props.restFrames,
149
+ }));
150
+ // A limb at its full length, or a knee or an elbow stopped at the end
151
+ // of its range, rests the effector on the reachable shell along the
152
+ // line to the target, the nearest point the chain allows, so that
153
+ // candidate is the answer as well: handing
154
+ // it to the search below would trade it between frames for whichever
155
+ // free-swing candidate the clamp happened to leave a micrometre nearer.
156
+ if (plantResidualBucket(Math.abs(residual - (hinged.shortfall ?? 0))) === 0)
157
+ return {
158
+ pose: {
159
+ ...props.pose,
160
+ joints: [
161
+ ...props.pose.joints.filter((j) => j.bone !== props.chain.upper && j.bone !== props.chain.lower),
162
+ upper,
163
+ lower,
164
+ ],
165
+ },
166
+ seed: hinged.seed ?? null,
167
+ ...(hinged.value === undefined ? {} : { value: hinged.value }),
168
+ };
169
+ consider(hinged);
170
+ }
171
+ }
172
+ consider(pole);
173
+ if (canFinish())
174
+ return { pose: best.pose, seed: null };
175
+ const upper = prepared.upper;
176
+ const reachAxis = Vector3_1.Vector3.normalize(Vector3_1.Vector3.subtract(props.target, upper.worldPosition));
177
+ let primary = Vector3_1.Vector3.subtract(pole.hinge, Vector3_1.Vector3.scale(reachAxis, Vector3_1.Vector3.dot(pole.hinge, reachAxis)));
178
+ if (Vector3_1.Vector3.length(primary) < 1e-6)
179
+ primary = Vector3_1.Vector3.cross(reachAxis, { x: 0, y: -1, z: 0 });
180
+ if (Vector3_1.Vector3.length(primary) < 1e-6)
181
+ primary = Vector3_1.Vector3.cross(reachAxis, { x: 0, y: 0, z: 1 });
182
+ primary = Vector3_1.Vector3.normalize(primary);
183
+ const secondary = Vector3_1.Vector3.normalize(Vector3_1.Vector3.cross(reachAxis, primary));
184
+ const normalAt = (angle) => Vector3_1.Vector3.add(Vector3_1.Vector3.scale(primary, Math.cos(angle)), Vector3_1.Vector3.scale(secondary, Math.sin(angle)));
185
+ if (props.referencePose !== undefined) {
186
+ const referenceJoints = [
187
+ props.chain.upper,
188
+ props.chain.lower,
189
+ ].map((bone) => referenceAngles.get(bone) ?? {
190
+ bone,
191
+ flexion: null,
192
+ abduction: null,
193
+ twist: null,
194
+ });
195
+ const referenceLower = (0, resolveBoneMap_1.resolveBoneMap)(props.skeleton, {
196
+ ...props.pose,
197
+ joints: [
198
+ ...props.pose.joints.filter((joint) => joint.bone !== props.chain.upper &&
199
+ joint.bone !== props.chain.lower),
200
+ ...referenceJoints,
201
+ ],
202
+ }, props.topology, props.jointAxes, props.restFrames).get(props.chain.lower);
203
+ const referenceNormal = Vector3_1.Vector3.cross(reachAxis, Vector3_1.Vector3.subtract(referenceLower.worldPosition, upper.worldPosition));
204
+ if (Vector3_1.Vector3.length(referenceNormal) >= 1e-6) {
205
+ consider(solve(Vector3_1.Vector3.normalize(referenceNormal)));
206
+ if (canFinish())
207
+ return { pose: best.pose, seed: null };
208
+ }
209
+ }
210
+ const segments = 32;
211
+ const sweep = [];
212
+ for (let index = 0; index < segments; ++index) {
213
+ const angle = (2 * Math.PI * index) / segments;
214
+ sweep.push({ angle, ...consider(solve(normalAt(angle))) });
215
+ if (canFinish())
216
+ return { pose: best.pose, seed: null };
217
+ }
218
+ const minima = sweep.filter((entry, index) => {
219
+ const previous = sweep[(index + segments - 1) % segments];
220
+ const next = sweep[(index + 1) % segments];
221
+ const previousOrder = comparePlantCandidate(entry, previous);
222
+ const nextOrder = comparePlantCandidate(entry, next);
223
+ return (previousOrder <= 0 &&
224
+ nextOrder <= 0 &&
225
+ (previousOrder < 0 || nextOrder < 0));
226
+ });
227
+ for (const minimum of minima) {
228
+ let center = minimum;
229
+ let step = (2 * Math.PI) / segments;
230
+ for (let iteration = 0; iteration < 10; ++iteration) {
231
+ step /= 2;
232
+ for (const angle of [center.angle - step, center.angle + step]) {
233
+ const candidate = {
234
+ angle,
235
+ ...consider(solve(normalAt(angle))),
236
+ };
237
+ if (comparePlantCandidate(candidate, center) < 0)
238
+ center = candidate;
239
+ if (canFinish())
240
+ return { pose: best.pose, seed: null };
241
+ }
242
+ }
243
+ }
244
+ return { pose: best.pose, seed: null };
245
+ };
246
+ exports.fitChainBend = fitChainBend;
247
+ const PLANT_CONTINUITY_EPSILON = 1e-12;
248
+ const plantResidualBucket = (residual) => Math.floor(residual / PLANT_RESIDUAL_EPSILON_1.PLANT_RESIDUAL_EPSILON);
249
+ /** Residual buckets are ordered first; continuity breaks equivalent pins. */
250
+ const comparePlantCandidate = (left, right) => {
251
+ const residualOrder = plantResidualBucket(left.residual) - plantResidualBucket(right.residual);
252
+ if (residualOrder !== 0)
253
+ return residualOrder;
254
+ const continuityOrder = left.continuity - right.continuity;
255
+ return continuityOrder === 0
256
+ ? left.residual - right.residual
257
+ : continuityOrder;
258
+ };
259
+ /** Sign-insensitive geodesic distance between two joint rotations. */
260
+ const jointRotationDistance = (joint, reference, axes, restFrame) => {
261
+ const candidate = Quaternion_1.Quaternion.normalize((0, jointToQuaternion_1.jointToQuaternion)(joint, axes, restFrame));
262
+ const prior = Quaternion_1.Quaternion.normalize((0, jointToQuaternion_1.jointToQuaternion)(reference ?? {
263
+ bone: joint.bone,
264
+ flexion: null,
265
+ abduction: null,
266
+ twist: null,
267
+ }, axes, restFrame));
268
+ const angle = Quaternion_1.Quaternion.angle(candidate, prior);
269
+ return angle * angle;
270
+ };
271
+ /**
272
+ * The bend-plane normal that displaces the mid joint toward a hint: the
273
+ * hint's component across the root-to-target axis, crossed as the analytic
274
+ * default crosses world-down (`axis x pole`). A hint on the axis gives no
275
+ * plane, so the default is used.
276
+ *
277
+ * @param root The chain root, model metres.
278
+ * @param target The effector target, model metres.
279
+ * @param bend The hint, model metres.
280
+ * @returns The unit normal, or undefined when the hint lies on the axis.
281
+ */
282
+ function hintNormal(root, target, bend) {
283
+ const axis = Vector3_1.Vector3.subtract(target, root);
284
+ if (Vector3_1.Vector3.length(axis) < 1e-9)
285
+ return undefined;
286
+ const unitAxis = Vector3_1.Vector3.normalize(axis);
287
+ const toward = Vector3_1.Vector3.subtract(bend, root);
288
+ const across = Vector3_1.Vector3.subtract(toward, Vector3_1.Vector3.scale(unitAxis, Vector3_1.Vector3.dot(toward, unitAxis)));
289
+ if (Vector3_1.Vector3.length(across) < 1e-9)
290
+ return undefined;
291
+ return Vector3_1.Vector3.normalize(Vector3_1.Vector3.cross(unitAxis, Vector3_1.Vector3.normalize(across)));
292
+ }
293
+ //# sourceMappingURL=fitChainBend.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fitChainBend.js","sourceRoot":"","sources":["../../src/motion/fitChainBend.ts"],"names":[],"mappings":"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"}
@@ -1,18 +1,16 @@
1
- import { IAutoMoviePose } from "@automovie/interface";
1
+ import type { IAutoMoviePose } from "@automovie/interface";
2
2
  import type { IFitChainToTargetProps } from "./IFitChainToTargetProps";
3
3
  /**
4
- * Fit a reachable two-bone chain to a model-frame target under the rig's effective ROM, retaining authored non-chain joints. A deterministic finite bend-plane search scores clamped FK and keeps the original pose unless its 1e-7-metre residual bucket improves or equal-bucket continuity improves toward an explicit prior pose; it is a bounded search, not a global-optimum guarantee.
4
+ * Fit a reachable two-bone chain to a model-frame target under the rig's
5
+ * effective ROM, retaining authored non-chain joints: the pose of
6
+ * {@link fitSeededChainToTarget}, for a caller that continues no fit from it.
5
7
  *
6
- * For a hinged mid joint (an elbow or a knee, whose abduction is immobile) the swivel parameterisation of Tolani, Goswami and Badler (2000) comes first and wins whenever it reaches: the hinge angle follows from the span and the swivel about the root-to-target axis is swept for the least range-of-motion overshoot and then the least continuous cost of effector-rotation error, swing from the hint's side and turn from the `referencePose` (`fitHingedChainCandidate`), because a free-swing candidate turns the hinge about the plane normal and the clamp of its abduction moves the effector. Otherwise, and for other chains, the bend hint's plane and then the 32-plane sweep follow, the first exact one winning. When nothing reaches, the least clamped residual is returned, so an unreachable target leaves the effector on the reachable shell, not a pretended reach.
7
- *
8
- * With `effectorRotation`, a mid bone that declares a distal twist (a forearm) first takes the twist share of the requested rotation about its own length (swing-twist decomposition), clamped to its range, and the effector the remaining swing, so pronation and supination are the forearm's and the wrist keeps its place.
9
- *
10
- * @evidence contracts/development/implementation.md#principled-implementation Prepares actual chain frames, solves analytic two-bone candidates, clamps upper/lower joints to rig ROM and measures their actual effector; residual buckets rank first, then squared sign-insensitive quaternion geodesic distance to the prior pose and finally exact residual.
11
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Search policy stays here while preparation, analytic candidate solve and fast candidate FK have single owners; this split exposes the geometry shared by all bend candidates.
12
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Missing/invalid/degenerate preparation and analytic solve preserve the original pose; no ideal target measurement replaces post-clamp FK. A 32-angle sweep and ten local halvings bound the heuristic, with 1e-12 continuity and 1e-6 normal-degeneracy thresholds.
13
- * @evidence contracts/development/common.md#meaningful-documentation States model-metre target, unchanged joints, residual-bucket ranking, prior-pose tie meaning and the bounded-search limitation without claiming every unreachable pin can be solved.
14
- * @evidence contracts/development/implementation.md#efficient-algorithms Preparation and authored/reference FK scale with rig/joints; at most34 initial candidates plus at most32minima times20 refinement candidates use constant-size fast FK, though candidate pose copies scale with authored joints. Early exact-bucket/continuity satisfaction stops the search. A hinged chain adds up to two swivel sweeps of 720 decomposed candidates (360 one-degree swivels per bend branch), each with constant-size quaternion work and, with an effector rotation, two more decompositions; they run only when the hint plane misses or a rotation is requested.
15
- * @evidence contracts/development/implementation.md#reuse-equivalent-work All bend candidates share prepared frames/domains and reference-angle maps; only candidate joints and scores vary, while per-frame parent pose changes force new preparation.
16
- * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Sweep/minima arrays are bounded by32 entries and all temporary poses/maps are released after completion; the caller owns the selected pose, which may be the original, and no handles or background tasks exist.
8
+ * @evidence contracts/development/implementation.md#principled-implementation The pose `fitSeededChainToTarget` fits, unchanged.
9
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One call; the search lives in `fitSeededChainToTarget`.
10
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None: nothing is computed here.
11
+ * @evidence contracts/development/common.md#meaningful-documentation States what is returned and whose fit it is.
12
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms One call, the cost `fitSeededChainToTarget` states.
13
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `fitSeededChainToTarget` whole.
14
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
17
15
  */
18
16
  export declare const fitChainToTarget: (props: IFitChainToTargetProps) => IAutoMoviePose;