@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,478 @@
1
+ import type {
2
+ IAutoMovieQuaternion,
3
+ IAutoMovieVector3,
4
+ } from "@automovie/interface";
5
+
6
+ import { Quaternion } from "../math/Quaternion";
7
+ import { Vector3 } from "../math/Vector3";
8
+ import type { integrateMotionTrajectory } from "./integrateMotionTrajectory";
9
+
10
+ /**
11
+ * The steppers of {@link integrateMotionTrajectory} on the exponential map:
12
+ * the orientation's turn by a rotation vector, the inverse differential of
13
+ * the exponential, and the error-controlled Dormand-Prince 5(4) path with
14
+ * its dense output.
15
+ *
16
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its formula, its order and its source.
17
+ * @evidence contracts/development/design.md#principled-representation The orientation advanced in the Lie algebra of rotations, a rotation vector relative to a step's start, by Runge-Kutta-Munthe-Kaas; the vector state and that vector share one tableau, one error norm and one continuous extension.
18
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What the integrator's fixed and adaptive paths share, and the adaptive path itself; only the integrator reads it.
19
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The adaptive path is opt-in, so the fixed grid's every number stays as it was for every caller that does not ask for it.
20
+ */
21
+ export namespace MotionTrajectoryStepper {
22
+ /**
23
+ * An orientation turned in its own frame by a rotation vector: `q * exp(v / 2)`, the rotation by `|v|` radians about `v` in the body's frame.
24
+ *
25
+ * @param q The orientation, or null for a state without one.
26
+ * @param v The rotation vector, radians, body frame; absent for none.
27
+ * @returns The turned orientation, or null.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States the quaternion composition, body frame, radian input and missing-orientation result.
30
+ * @evidence contracts/development/implementation.md#principled-implementation Converts the rotation-vector length to the degree unit Quaternion.fromAxisAngle accepts, then right-multiplies its exponential into the current orientation; integrator callers supply normalized orientations and finite vectors.
31
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Missing and zero turns preserve the input; the remaining path delegates axis-angle construction and quaternion composition to their owners.
32
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Uses the supplied rotation vector without a fixture-specific axis or minimum angle.
33
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms A fixed number of scalar and quaternion operations.
34
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure scalar-sized calculation with no cross-request work.
35
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; a zero or absent turn returns the borrowed input.
36
+ */
37
+ export function turn(
38
+ q: IAutoMovieQuaternion | null,
39
+ v: IAutoMovieVector3 | undefined,
40
+ ): IAutoMovieQuaternion | null {
41
+ if (q === null || v === undefined) return q;
42
+ const angle: number = Math.hypot(v.x, v.y, v.z);
43
+ if (angle === 0) return q;
44
+ return Quaternion.multiply(
45
+ q,
46
+ Quaternion.fromAxisAngle(v, (angle * 180) / Math.PI),
47
+ );
48
+ }
49
+
50
+ /**
51
+ * A vector scaled, or absent when absent.
52
+ *
53
+ * @param v The vector, or undefined.
54
+ * @param s The scale.
55
+ * @returns `s v`, or undefined.
56
+ *
57
+ * @evidence contracts/development/common.md#meaningful-documentation States component scaling and preservation of an absent vector.
58
+ * @evidence contracts/development/implementation.md#principled-implementation Multiplies all three components by the supplied scale; the caller owns its units and the finite-input premise.
59
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One absence branch and one vector literal.
60
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No replacement value is invented for an absent orientation rate.
61
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Three multiplications with no input-sized traversal.
62
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work No repeated request or retained calculation is coordinated.
63
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The returned vector is caller-owned; no state or resource is retained.
64
+ */
65
+ export function scaled(
66
+ v: IAutoMovieVector3 | undefined,
67
+ s: number,
68
+ ): IAutoMovieVector3 | undefined {
69
+ return v === undefined ? undefined : { x: s * v.x, y: s * v.y, z: s * v.z };
70
+ }
71
+
72
+ /**
73
+ * The derivative of a rotation vector `r` that turns the body at a body-frame
74
+ * rate `w`, for an orientation `q exp(r)`: the inverse differential of the
75
+ * exponential map, `w + r × w / 2 + r × (r × w) / 12`, its Bernoulli series
76
+ * truncated after the second bracket, which keeps a Runge-Kutta-Munthe-Kaas
77
+ * step of order 4, and of order 5 too, since the third Bernoulli number
78
+ * that would enter next is zero (Munthe-Kaas 1999, "High order Runge-Kutta
79
+ * methods on manifolds", Appl Numer Math 29:115-127; Iserles, Munthe-Kaas,
80
+ * Nørsett and Zanna 2000, "Lie-group methods", Acta Numerica 9; the
81
+ * truncation's order is checked here by the trajectory's own tests). The
82
+ * signs are the body frame's: for `q̇ = q ŵ / 2`, the rate of `q exp(r)` is
83
+ * `ṙ - r × ṙ / 2 + ...`, whose inverse this is.
84
+ *
85
+ * @param r The rotation vector, radians; absent for a state without orientation.
86
+ * @param w The body-frame rate, radians per second.
87
+ * @returns The vector's derivative, radians per second, or undefined.
88
+ *
89
+ * @evidence contracts/development/common.md#meaningful-documentation Gives the body-frame inverse differential, angular units, truncated terms and absent-orientation behavior.
90
+ * @evidence contracts/development/implementation.md#principled-implementation Evaluates the cited Bernoulli expansion through the double cross product with coefficients one half and one twelfth; this is the local RKMK series, not an exact inverse differential at arbitrary rotation-vector magnitude.
91
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two shared cross products followed by componentwise accumulation.
92
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The coefficients are the stated series coefficients; missing orientation leaves the supplied rate unchanged rather than choosing a body axis.
93
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant-size vector arithmetic.
94
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the first cross product in the double bracket and the shared Vector3.cross implementation.
95
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function retaining no input or intermediate between calls.
96
+ */
97
+ export function dexpinv(
98
+ r: IAutoMovieVector3 | undefined,
99
+ w: IAutoMovieVector3 | undefined,
100
+ ): IAutoMovieVector3 | undefined {
101
+ if (r === undefined || w === undefined) return w;
102
+ const a: IAutoMovieVector3 = Vector3.cross(r, w);
103
+ const b: IAutoMovieVector3 = Vector3.cross(r, a);
104
+ return {
105
+ x: w.x + a.x / 2 + b.x / 12,
106
+ y: w.y + a.y / 2 + b.y / 12,
107
+ z: w.z + a.z / 2 + b.z / 12,
108
+ };
109
+ }
110
+
111
+ /**
112
+ * The Dormand-Prince 5(4) pair's nodes, its stages' coefficients (the last
113
+ * row its fifth-order weights, so the last stage is the next step's first)
114
+ * and the difference of its fifth- and fourth-order weights, the step's
115
+ * error estimate (Dormand and Prince 1980, J Comput Appl Math 6:19-26),
116
+ * each read digit by digit from Hairer and Wanner's DOPRI5 code, its
117
+ * subroutine CDOPRI's `c`, `a` and `e`, as the MESA project's port
118
+ * `num/private/mod_dopri5.f` carries it
119
+ * (https://mesastar.org/mesa/num/private/mod_dopri5.f.gcov.html); the
120
+ * coefficients that code leaves out (`a72`, `e2`) are zero.
121
+ */
122
+ const C: readonly number[] = [0, 1 / 5, 3 / 10, 4 / 5, 8 / 9, 1, 1];
123
+
124
+ /** The stages' coefficients, row `i` for stage `i + 1`. */
125
+ const A: readonly (readonly number[])[] = [
126
+ [],
127
+ [1 / 5],
128
+ [3 / 40, 9 / 40],
129
+ [44 / 45, -56 / 15, 32 / 9],
130
+ [19372 / 6561, -25360 / 2187, 64448 / 6561, -212 / 729],
131
+ [9017 / 3168, -355 / 33, 46732 / 5247, 49 / 176, -5103 / 18656],
132
+ [35 / 384, 0, 500 / 1113, 125 / 192, -2187 / 6784, 11 / 84],
133
+ ];
134
+
135
+ /** The fifth-order weights less the fourth-order ones. */
136
+ const E: readonly number[] = [
137
+ 71 / 57600,
138
+ 0,
139
+ -71 / 16695,
140
+ 71 / 1920,
141
+ -17253 / 339200,
142
+ 22 / 525,
143
+ -1 / 40,
144
+ ];
145
+
146
+ /**
147
+ * The continuous extension's fourth-order coefficients, read digit by
148
+ * digit from the same code's `d` (its `d2` left out, zero), used as its
149
+ * DOPCOR stores the dense output and CONTD5 reads it: with `ydiff` the
150
+ * step's change and `bspl = h k1 - ydiff`, the terms `ydiff`, `bspl`,
151
+ * `ydiff - h k7 - bspl` and `h Σ dⱼ kⱼ`, read at the step's share `θ` as
152
+ * `θ (ydiff + (1 - θ)(bspl + θ (term3 + (1 - θ) term4)))`.
153
+ */
154
+ const D: readonly number[] = [
155
+ -12715105075 / 11282082432,
156
+ 0,
157
+ 87487479700 / 32700410799,
158
+ -10690763975 / 1880347072,
159
+ 701980252875 / 199316789632,
160
+ -1453857185 / 822651844,
161
+ 69997945 / 29380423,
162
+ ];
163
+
164
+ /**
165
+ * The step controller, as the same code's DOPCOR defaults and applies it,
166
+ * read there line by line: the safety factor `safe`, the bounds `fac1`
167
+ * and `fac2` on a step's change, the stabilizing exponent `beta` on the
168
+ * last accepted error, the floor `previous` on that error (its `facold`,
169
+ * which also starts there), and the share `stretch` of a step past which
170
+ * the last one is taken to the end at once (its `1.01`).
171
+ */
172
+ const CONTROL: Readonly<{
173
+ safety: number;
174
+ least: number;
175
+ most: number;
176
+ beta: number;
177
+ previous: number;
178
+ stretch: number;
179
+ }> = {
180
+ safety: 0.9,
181
+ least: 0.2,
182
+ most: 10,
183
+ beta: 0.04,
184
+ previous: 1e-4,
185
+ stretch: 1.01,
186
+ };
187
+
188
+ /** One accepted step's dense output. */
189
+ interface IStep {
190
+ /** Its start and length, seconds. */
191
+ t: number;
192
+ h: number;
193
+
194
+ /** The vector state at its start and the five continuous-extension terms. */
195
+ x: number[];
196
+ terms: number[][];
197
+
198
+ /** The orientation at its start and the rotation vector's five terms. */
199
+ q: IAutoMovieQuaternion | null;
200
+ turns: IAutoMovieVector3[];
201
+ }
202
+
203
+ /**
204
+ * A trajectory by the Dormand-Prince 5(4) pair under error control: each
205
+ * step's error estimate, the difference of its two orders, is weighed
206
+ * component by component against `absolute + relative × |value|` (the
207
+ * vector state's larger of its two ends, as DOPCOR weighs it; the
208
+ * orientation's rotation vector over the step by its length, this
209
+ * module's extension of the same norm to the Lie algebra) in the
210
+ * root-mean-square norm, a step is accepted when that norm is at most one,
211
+ * and the next step follows DOPCOR's controller (`CONTROL`); a read between
212
+ * knots is the pair's continuous extension of order four, the orientation
213
+ * the step's start turned by its rotation vector's extension.
214
+ *
215
+ * @param props The integrator's props, with a tolerance.
216
+ * @param rate The admitted right-hand side.
217
+ * @param step The first step tried, seconds, positive.
218
+ * @returns The trajectory, its knots the accepted steps' ends.
219
+ * @throws {Error} When a step shrinks below the resolution of its time: a right-hand side the tolerance cannot follow.
220
+ *
221
+ * @evidence contracts/development/common.md#meaningful-documentation States the accepted-error norm, dense interpolation, time units, admitted callback and time-resolution failure.
222
+ * @evidence contracts/development/implementation.md#principled-implementation Uses the cited Dormand-Prince tableau and controller with the RKMK rotation-vector differential; integrateMotionTrajectory admits the finite interval, initial state, tolerance and callback results. The embedded estimate controls local step admission and does not certify a global physical error bound.
223
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Form trial stages, measure their error, reject or retain the continuous extension, then expose binary-search sampling over accepted steps.
224
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Tableau and controller constants retain their cited provenance; no fixture-specific time grid, cached answer or tolerance relaxation is introduced.
225
+ * @evidence contracts/development/implementation.md#efficient-algorithms For n scalar components, A accepted and R rejected trials, integration adds O((A+R)n) vector work and six right-hand-side calls per trial after the initial call; retained dense output is O(An), and each read costs O(log A+n). The tolerance can require arbitrarily many steps before the time-resolution failure.
226
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the accepted last stage as the next first stage and stores dense coefficients once so repeated reads do not reintegrate.
227
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Trial arrays die after rejection or acceptance; the returned reader retains accepted steps and endpoint state for its lifetime. Retention grows with accepted-step count and has no fixed byte bound; the operation acquires no external handle or task.
228
+ */
229
+ export function dormandPrince(
230
+ props: integrateMotionTrajectory.IProps,
231
+ rate: (
232
+ t: number,
233
+ x: readonly number[],
234
+ q: IAutoMovieQuaternion | null,
235
+ ) => integrateMotionTrajectory.IRate,
236
+ step: number,
237
+ ): integrateMotionTrajectory.ITrajectory {
238
+ const { t0, t1 } = props;
239
+ const { relative, absolute } = props.tolerance!;
240
+ const oriented: boolean = props.q0 !== undefined;
241
+ const n: number = props.x0.length;
242
+ const first: number = Math.min(step, t1 - t0);
243
+ const steps: IStep[] = [];
244
+ let t: number = t0;
245
+ let x: number[] = [...props.x0];
246
+ let q: IAutoMovieQuaternion | null = oriented
247
+ ? Quaternion.normalize(props.q0!)
248
+ : null;
249
+ let k1: integrateMotionTrajectory.IRate = rate(t, x, q);
250
+ let h: number = first;
251
+ let rejected: boolean = false;
252
+ let previous: number = CONTROL.previous;
253
+ const exponent: number = 0.2 - CONTROL.beta * 0.75;
254
+ while (t < t1) {
255
+ const last: boolean = t + CONTROL.stretch * h - t1 > 0;
256
+ if (last) h = t1 - t;
257
+ if (0.1 * Math.abs(h) <= Math.abs(t) * Number.EPSILON || !(t + h > t))
258
+ throw new Error(
259
+ `integrateMotionTrajectory: the step shrank below the resolution of ${t} s`,
260
+ );
261
+ // The stages, the orientation's in the algebra from the step's start.
262
+ const ks: integrateMotionTrajectory.IRate[] = [k1];
263
+ const us: (IAutoMovieVector3 | undefined)[] = [k1.w];
264
+ const vs: (IAutoMovieVector3 | undefined)[] = [undefined];
265
+ for (let i: number = 1; i < 7; i++) {
266
+ const row: readonly number[] = A[i]!;
267
+ const xi: number[] = x.map(
268
+ (v: number, c: number): number =>
269
+ v +
270
+ h *
271
+ row.reduce(
272
+ (s: number, a: number, j: number): number =>
273
+ s + a * ks[j]!.dx[c]!,
274
+ 0,
275
+ ),
276
+ );
277
+ const vi: IAutoMovieVector3 | undefined = oriented
278
+ ? sum(row, us, h)
279
+ : undefined;
280
+ const ki: integrateMotionTrajectory.IRate = rate(
281
+ t + C[i]! * h,
282
+ xi,
283
+ turn(q, vi),
284
+ );
285
+ ks.push(ki);
286
+ vs.push(vi);
287
+ us.push(dexpinv(vi, ki.w));
288
+ }
289
+ const xn: number[] = x.map(
290
+ (v: number, c: number): number =>
291
+ v +
292
+ h *
293
+ A[6]!.reduce(
294
+ (s: number, a: number, j: number): number =>
295
+ s + a * ks[j]!.dx[c]!,
296
+ 0,
297
+ ),
298
+ );
299
+ const r: IAutoMovieVector3 | undefined = vs[6];
300
+
301
+ // The error norm, root mean square over the components.
302
+ let squares: number = 0;
303
+ for (let c: number = 0; c < n; c++) {
304
+ const e: number =
305
+ h *
306
+ E.reduce(
307
+ (s: number, w: number, j: number): number => s + w * ks[j]!.dx[c]!,
308
+ 0,
309
+ );
310
+ squares += ratio(
311
+ e,
312
+ absolute + relative * Math.max(Math.abs(x[c]!), Math.abs(xn[c]!)),
313
+ );
314
+ }
315
+ if (oriented) {
316
+ const e: IAutoMovieVector3 = sum(E, us, h)!;
317
+ const scale: number = absolute + relative * Vector3.length(r!);
318
+ squares += ratio(e.x, scale) + ratio(e.y, scale) + ratio(e.z, scale);
319
+ }
320
+ const norm: number = Math.sqrt(squares / (n + (oriented ? 3 : 0)));
321
+ const stretched: number = norm ** exponent;
322
+ if (!(norm <= 1)) {
323
+ h /= Math.min(1 / CONTROL.least, stretched / CONTROL.safety);
324
+ rejected = true;
325
+ continue;
326
+ }
327
+ const shrink: number = Math.max(
328
+ 1 / CONTROL.most,
329
+ Math.min(
330
+ 1 / CONTROL.least,
331
+ stretched / previous ** CONTROL.beta / CONTROL.safety,
332
+ ),
333
+ );
334
+ const next: number = rejected ? Math.min(h / shrink, h) : h / shrink;
335
+ previous = Math.max(norm, CONTROL.previous);
336
+
337
+ // Accepted: keep the continuous extension and step on from the last stage.
338
+ const k7: integrateMotionTrajectory.IRate = ks[6]!;
339
+ const terms: number[][] = x.map((v: number, c: number): number[] => {
340
+ const diff: number = xn[c]! - v;
341
+ const spline: number = h * ks[0]!.dx[c]! - diff;
342
+ return [
343
+ diff,
344
+ spline,
345
+ diff - h * k7.dx[c]! - spline,
346
+ h *
347
+ D.reduce(
348
+ (s: number, d: number, j: number): number =>
349
+ s + d * ks[j]!.dx[c]!,
350
+ 0,
351
+ ),
352
+ ];
353
+ });
354
+ const turns: IAutoMovieVector3[] = [];
355
+ if (oriented) {
356
+ const diff: IAutoMovieVector3 = r!;
357
+ const spline: IAutoMovieVector3 = Vector3.subtract(
358
+ Vector3.scale(us[0]!, h),
359
+ diff,
360
+ );
361
+ turns.push(
362
+ diff,
363
+ spline,
364
+ Vector3.subtract(
365
+ Vector3.subtract(diff, Vector3.scale(us[6]!, h)),
366
+ spline,
367
+ ),
368
+ sum(D, us, h)!,
369
+ );
370
+ }
371
+ steps.push({ t, h, x, terms, q, turns });
372
+ t = last ? t1 : t + h;
373
+ x = xn;
374
+ q = oriented ? Quaternion.normalize(turn(q, r)!) : null;
375
+ k1 = k7;
376
+ rejected = false;
377
+ h = next;
378
+ }
379
+
380
+ const times: number[] = [...steps.map((s: IStep): number => s.t), t1];
381
+ const end: integrateMotionTrajectory.IState = { x, q };
382
+ return {
383
+ t0,
384
+ t1,
385
+ h: first,
386
+ knots: times.length,
387
+ times,
388
+ at: (time: number): integrateMotionTrajectory.IState => {
389
+ if (!(time < t1)) return { x: [...end.x], q: end.q };
390
+ const at: number = Math.max(t0, time);
391
+ let lo: number = 0;
392
+ let hi: number = steps.length - 1;
393
+ while (lo < hi) {
394
+ const mid: number = (lo + hi + 1) >> 1;
395
+ if (steps[mid]!.t <= at) lo = mid;
396
+ else hi = mid - 1;
397
+ }
398
+ const s: IStep = steps[lo]!;
399
+ const u: number = (at - s.t) / s.h;
400
+ const w: number = 1 - u;
401
+ const along = (a: number, b: number, c: number, d: number): number =>
402
+ u * (a + w * (b + u * (c + w * d)));
403
+ return {
404
+ x: s.x.map(
405
+ (v: number, c: number): number =>
406
+ v +
407
+ along(
408
+ s.terms[c]![0]!,
409
+ s.terms[c]![1]!,
410
+ s.terms[c]![2]!,
411
+ s.terms[c]![3]!,
412
+ ),
413
+ ),
414
+ q:
415
+ s.q === null
416
+ ? null
417
+ : turn(s.q, {
418
+ x: along(
419
+ s.turns[0]!.x,
420
+ s.turns[1]!.x,
421
+ s.turns[2]!.x,
422
+ s.turns[3]!.x,
423
+ ),
424
+ y: along(
425
+ s.turns[0]!.y,
426
+ s.turns[1]!.y,
427
+ s.turns[2]!.y,
428
+ s.turns[3]!.y,
429
+ ),
430
+ z: along(
431
+ s.turns[0]!.z,
432
+ s.turns[1]!.z,
433
+ s.turns[2]!.z,
434
+ s.turns[3]!.z,
435
+ ),
436
+ }),
437
+ };
438
+ },
439
+ };
440
+ }
441
+
442
+ /**
443
+ * A weighted sum of rotation-vector rates times a step: `h Σ wⱼ uⱼ`.
444
+ *
445
+ * @param weights The weights, as many as the rates or fewer.
446
+ * @param us The rates.
447
+ * @param h The step.
448
+ * @returns The vector, or undefined for a state without orientation.
449
+ */
450
+ function sum(
451
+ weights: readonly number[],
452
+ us: readonly (IAutoMovieVector3 | undefined)[],
453
+ h: number,
454
+ ): IAutoMovieVector3 | undefined {
455
+ if (us[0] === undefined) return undefined;
456
+ let x: number = 0;
457
+ let y: number = 0;
458
+ let z: number = 0;
459
+ weights.forEach((w: number, j: number): void => {
460
+ if (w === 0) return;
461
+ x += w * us[j]!.x;
462
+ y += w * us[j]!.y;
463
+ z += w * us[j]!.z;
464
+ });
465
+ return { x: h * x, y: h * y, z: h * z };
466
+ }
467
+
468
+ /**
469
+ * One component's squared share of the error norm, zero for no error.
470
+ *
471
+ * @param e The component's error estimate.
472
+ * @param scale Its tolerance.
473
+ * @returns `(e / scale)²`, zero when `e` is zero.
474
+ */
475
+ function ratio(e: number, scale: number): number {
476
+ return e === 0 ? 0 : (e / scale) ** 2;
477
+ }
478
+ }
@@ -0,0 +1,29 @@
1
+ import type { IAutoMovieJointAxes } from "@automovie/interface";
2
+
3
+ import { DEFAULT_JOINT_AXES } from "../kinematics/constants/DEFAULT_JOINT_AXES";
4
+ import { normalizeJointAxes } from "../kinematics/normalizeJointAxes";
5
+
6
+ /**
7
+ * A joint's clinical basis as `decomposeJointRotationOnBasis` reads it: the
8
+ * given axes, or the default ones, admitted and normalized exactly as
9
+ * `decomposeJointRotation` would for each call, done here once per fit.
10
+ *
11
+ * @param axes The bone's clinical axes; omitted, the default basis.
12
+ * @returns The orthonormal basis.
13
+ *
14
+ * @evidence contracts/development/common.md#meaningful-documentation States what is admitted, its default and why once per fit.
15
+ * @evidence contracts/development/implementation.md#principled-implementation The same admission the decomposition makes, so a basis read here is the one it reads.
16
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure One call.
17
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts None.
18
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
19
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses `normalizeJointAxes`, which remembers a record's basis.
20
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
21
+ */
22
+ export function basisOf(
23
+ axes: IAutoMovieJointAxes | undefined,
24
+ ): IAutoMovieJointAxes {
25
+ return normalizeJointAxes(
26
+ axes ?? DEFAULT_JOINT_AXES,
27
+ "decomposeJointRotation axes",
28
+ );
29
+ }
@@ -0,0 +1,56 @@
1
+ /**
2
+ * What an acceleration at a cut adds to a path that starts without one, so
3
+ * the sum leaves the cut with that acceleration.
4
+ *
5
+ * The companion of {@link carriedRate} one derivative up: the quintic Hermite
6
+ * basis of a unit initial acceleration over `duration` seconds,
7
+ * `D^2 u^2 (1 - u)^3 / 2` with `u = elapsed / D`, the one quintic with zero
8
+ * value and slope and unit acceleration at the start and zero value, slope
9
+ * and acceleration at the end. A minimum-jerk path, `carriedRate` and this
10
+ * term together are the quintic through any value, rate and acceleration at
11
+ * one end and rest at the other, so two motions joined with all three matched
12
+ * meet without a step in acceleration. Read backwards in time, with
13
+ * `duration - elapsed`, the term sets the acceleration a path arrives with;
14
+ * an acceleration keeps its sign under that mirror, where a rate changes it.
15
+ * The term rises to `PEAK` times the squared duration at two fifths of it and
16
+ * returns without crossing zero.
17
+ *
18
+ * @param duration Seconds over which the acceleration is carried; positive.
19
+ * @param elapsed Seconds since the cut; clamped into the duration.
20
+ * @returns Seconds squared: the displacement per unit acceleration.
21
+ * @throws {Error} When the duration is not positive and finite, or the elapsed time is not finite.
22
+ *
23
+ * @evidence contracts/development/common.md#meaningful-documentation States the polynomial and its six end conditions, how it completes the quintic with `carriedRate`, the backward reading and its sign, the peak, the units, the clamp and the thrown inputs.
24
+ * @evidence contracts/development/implementation.md#principled-implementation The quintic Hermite basis function of a unit initial second derivative, fixed by zero value and slope at both ends, unit acceleration at the start and zero at the end; scaling by the squared duration maps the unit interval to seconds.
25
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One closed-form polynomial in the normalized time; the caller multiplies by its own acceleration, so the term carries no state and no unit of the path.
26
+ * @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.
27
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Six multiplications in constant time, with no algorithm to choose.
28
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of two numbers that coordinates no work across calls.
29
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the result is a local number.
30
+ */
31
+ export function carriedAcceleration(duration: number, elapsed: number): number {
32
+ if (
33
+ !Number.isFinite(elapsed) ||
34
+ !(duration > 0) ||
35
+ !Number.isFinite(duration)
36
+ )
37
+ throw new Error(
38
+ "A carried acceleration needs a finite elapsed time and a positive duration",
39
+ );
40
+ const u: number = Math.min(1, Math.max(0, elapsed / duration));
41
+ const rest: number = 1 - u;
42
+ return (duration * duration * u * u * rest * rest * rest) / 2;
43
+ }
44
+
45
+ /**
46
+ * Companion constants of {@link carriedAcceleration}.
47
+ *
48
+ * @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.
49
+ * @evidence contracts/development/design.md#principled-representation The peak is the exact rational `54 / 3125`, the basis at its stationary point two fifths of the way, in squared durations, the unit the function returns per unit acceleration.
50
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One constant, read by callers that bound how far a carried acceleration displaces a path; it lives beside the function whose polynomial fixes it.
51
+ * @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.
52
+ */
53
+ export namespace carriedAcceleration {
54
+ /** The term's largest value in squared durations, reached at two fifths of the duration: `54 / 3125`. */
55
+ export const PEAK: number = 54 / 3125;
56
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * What a rate at a cut adds to a path that starts at rest, so the sum leaves
3
+ * the cut at that rate.
4
+ *
5
+ * A path planned from rest (a minimum-jerk reach, say) joined to a motion
6
+ * that was moving breaks the velocity at the join. Adding the entry rate
7
+ * times this term mends it: the term is the quintic Hermite basis of a unit
8
+ * initial velocity over `duration` seconds, `D (u - 6 u^3 + 8 u^4 - 3 u^5)`
9
+ * with `u = elapsed / D`, the one quintic with zero value, unit slope and
10
+ * zero acceleration at the start and zero value, slope and acceleration at
11
+ * the end. The sum therefore keeps the entry's velocity without a step in
12
+ * acceleration at the cut, and is the planned path again from `duration` on.
13
+ * The term rises to `PEAK` times the duration at a third of it and returns
14
+ * without crossing zero, so a rate `v` displaces the path by at most
15
+ * `PEAK * duration * |v|`: a caller with only so much room shortens the
16
+ * duration to fit it.
17
+ *
18
+ * {@link inertializeOffset} with a zero offset is the same idea with zero
19
+ * jerk at the end instead of zero acceleration at the start; its lobe starts
20
+ * with the acceleration `-8 v / duration`, which shows on a fast limb, so a
21
+ * law that carries a rate into a path of its own uses this term.
22
+ *
23
+ * @param duration Seconds over which the rate is carried; positive.
24
+ * @param elapsed Seconds since the cut; clamped into the duration.
25
+ * @returns Seconds: the displacement per unit rate.
26
+ * @throws {Error} When the duration is not positive and finite, or the elapsed time is not finite.
27
+ *
28
+ * @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.
29
+ * @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.
30
+ * @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.
31
+ * @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.
32
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Seven multiplications in constant time, with no algorithm to choose.
33
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of two numbers that coordinates no work across calls.
34
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing; the result is a local number.
35
+ */
36
+ export function carriedRate(duration: number, elapsed: number): number {
37
+ if (
38
+ !Number.isFinite(elapsed) ||
39
+ !(duration > 0) ||
40
+ !Number.isFinite(duration)
41
+ )
42
+ throw new Error(
43
+ "A carried rate needs a finite elapsed time and a positive duration",
44
+ );
45
+ const u: number = Math.min(1, Math.max(0, elapsed / duration));
46
+ const u3: number = u * u * u;
47
+ return duration * (u - 6 * u3 + 8 * u3 * u - 3 * u3 * u * u);
48
+ }
49
+
50
+ /**
51
+ * Companion constants of {@link carriedRate}.
52
+ *
53
+ * @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.
54
+ * @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.
55
+ * @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.
56
+ * @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.
57
+ */
58
+ export namespace carriedRate {
59
+ /** The term's largest value in durations, reached at a third of the duration: `16 / 81`. */
60
+ export const PEAK: number = 16 / 81;
61
+ }
@@ -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 const PLANT_RESIDUAL_EPSILON: number = 1e-7;
@@ -1,2 +1,3 @@
1
1
  export * from "./HUMANOID_LEG_CHAINS";
2
2
  export * from "./LOCOMOTE_GROUND_EPSILON";
3
+ export * from "./PLANT_RESIDUAL_EPSILON";