@automovie/engine 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -0,0 +1,264 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+
3
+ import { Vector3 } from "./Vector3";
4
+ import { seededValue } from "./seededValue";
5
+
6
+ /**
7
+ * The Delaunay tetrahedralization of points by Bowyer-Watson insertion
8
+ * in their given order.
9
+ *
10
+ * Coplanar and cospherical points, which a body's symmetric joints always
11
+ * hold, leave the floating-point predicates undecided and the insertion
12
+ * with flat or non-Delaunay tetrahedra. The input is therefore joggled as
13
+ * Qhull's `QJ` joggles it (Barber, Dobkin and Huhdanpaa 1996, "The
14
+ * quickhull algorithm for convex hulls", ACM TOMS 22(4); Qhull `user.h`
15
+ * `qh_JOGGLEdefault` and `geom2.c` `qh_detjoggle`): each coordinate moves
16
+ * by a deterministic amount within `JOGGLE` machine epsilons of the
17
+ * points' largest coordinate, and the mesh is the Delaunay mesh of the
18
+ * joggled points it returns.
19
+ *
20
+ * @param points The points.
21
+ * @returns The mesh, each tetrahedron positively oriented on the joggled points.
22
+ *
23
+ * @evidence contracts/development/common.md#meaningful-documentation States the method, the order, the joggle with its source and the orientation.
24
+ * @evidence contracts/development/implementation.md#principled-implementation Each joggled point removes the tetrahedra whose circumsphere strictly contains it and fans the cavity's boundary faces to it; the enclosing tetrahedron's corners are dropped at the end. The joggle is Qhull's, the default multiple of the round-off, drawn per coordinate from the point's index so the mesh is the same every time.
25
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Enclose, insert, drop.
26
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A point on a circumsphere is left outside it by the strict test, so cospherical points resolve the same way every time.
27
+ * @evidence contracts/development/implementation.md#efficient-algorithms Quadratic in the points at worst: each insertion scans the current tetrahedra.
28
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the points.
29
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
30
+ */
31
+ export function tetrahedralizeAutoMovieDelaunay(
32
+ points: readonly IAutoMovieVector3[],
33
+ ): tetrahedralizeAutoMovieDelaunay.IMesh {
34
+ const n: number = points.length;
35
+
36
+ // Qhull's joggle: each coordinate within `JOGGLE` epsilons of the
37
+ // largest coordinate, drawn from the point's index and axis.
38
+ const largest: number = Math.max(
39
+ ...points.map((p: IAutoMovieVector3): number =>
40
+ Math.max(Math.abs(p.x), Math.abs(p.y), Math.abs(p.z)),
41
+ ),
42
+ Number.MIN_VALUE,
43
+ );
44
+ const amount: number =
45
+ tetrahedralizeAutoMovieDelaunay.JOGGLE * Number.EPSILON * largest;
46
+ const jog = (i: number, axis: number): number =>
47
+ amount *
48
+ (2 * seededValue(tetrahedralizeAutoMovieDelaunay.DOMAIN, i, axis) - 1);
49
+ const joggled: IAutoMovieVector3[] = points.map(
50
+ (p: IAutoMovieVector3, i: number): IAutoMovieVector3 => ({
51
+ x: p.x + jog(i, 0),
52
+ y: p.y + jog(i, 1),
53
+ z: p.z + jog(i, 2),
54
+ }),
55
+ );
56
+ const centre: IAutoMovieVector3 = Vector3.scale(
57
+ joggled.reduce(
58
+ (s: IAutoMovieVector3, p: IAutoMovieVector3): IAutoMovieVector3 =>
59
+ Vector3.add(s, p),
60
+ { x: 0, y: 0, z: 0 },
61
+ ),
62
+ 1 / n,
63
+ );
64
+ const radius: number = Math.max(
65
+ ...joggled.map((p: IAutoMovieVector3): number =>
66
+ Vector3.length(Vector3.subtract(p, centre)),
67
+ ),
68
+ Number.MIN_VALUE,
69
+ );
70
+
71
+ // A regular tetrahedron whose inscribed sphere, a third of its
72
+ // circumradius, holds every point with room: circumradius 9 r gives an
73
+ // insphere of 3 r.
74
+ const far: number = 9 * radius;
75
+ const all: IAutoMovieVector3[] = [
76
+ ...joggled,
77
+ ...[
78
+ { x: 1, y: 1, z: 1 },
79
+ { x: 1, y: -1, z: -1 },
80
+ { x: -1, y: 1, z: -1 },
81
+ { x: -1, y: -1, z: 1 },
82
+ ].map(
83
+ (c: IAutoMovieVector3): IAutoMovieVector3 =>
84
+ Vector3.add(centre, Vector3.scale(c, far / Math.sqrt(3))),
85
+ ),
86
+ ];
87
+ let tetrahedra: [number, number, number, number][] = [
88
+ tetrahedralizeAutoMovieDelaunay.oriented(all, [n, n + 1, n + 2, n + 3]),
89
+ ];
90
+ for (let i: number = 0; i < n; i++) {
91
+ const p: IAutoMovieVector3 = all[i]!;
92
+ const bad: [number, number, number, number][] = [];
93
+ const kept: [number, number, number, number][] = [];
94
+ for (const t of tetrahedra)
95
+ (tetrahedralizeAutoMovieDelaunay.circumscribes(all, t, p)
96
+ ? bad
97
+ : kept
98
+ ).push(t);
99
+ const faces: Map<string, [number, number, number]> = new Map();
100
+ const counts: Map<string, number> = new Map();
101
+ for (const t of bad)
102
+ for (const face of [
103
+ [t[0], t[1], t[2]],
104
+ [t[0], t[1], t[3]],
105
+ [t[0], t[2], t[3]],
106
+ [t[1], t[2], t[3]],
107
+ ] as [number, number, number][]) {
108
+ const key: string = [...face]
109
+ .sort((a: number, b: number): number => a - b)
110
+ .join(",");
111
+ counts.set(key, (counts.get(key) ?? 0) + 1);
112
+ faces.set(key, face);
113
+ }
114
+ for (const [key, face] of faces)
115
+ if (counts.get(key) === 1)
116
+ kept.push(
117
+ tetrahedralizeAutoMovieDelaunay.oriented(all, [
118
+ face[0],
119
+ face[1],
120
+ face[2],
121
+ i,
122
+ ]),
123
+ );
124
+ tetrahedra = kept;
125
+ }
126
+ return {
127
+ tetrahedra: tetrahedra.filter((t: readonly number[]): boolean =>
128
+ t.every((v: number): boolean => v < n),
129
+ ),
130
+ points: joggled,
131
+ };
132
+ }
133
+
134
+ /**
135
+ * Companion types and predicates of {@link tetrahedralizeAutoMovieDelaunay}.
136
+ *
137
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its meaning and convention.
138
+ * @evidence contracts/development/design.md#principled-representation A mesh as its tetrahedra by point index, positively oriented.
139
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The joggle's constants, the mesh, its neighbourhoods, the signed volume and the two predicates the insertion uses.
140
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Indices into the caller's points, with the joggled copies the mesh is built on returned beside them.
141
+ */
142
+ export namespace tetrahedralizeAutoMovieDelaunay {
143
+ /** Qhull's default joggle, in machine epsilons of the largest coordinate (`qh_JOGGLEdefault`). */
144
+ export const JOGGLE: number = 30000;
145
+
146
+ /** The seed domain of the joggle's draws, so no other draw shares them. */
147
+ export const DOMAIN: number = 3438;
148
+
149
+ /** The tetrahedra over the points, each by four indices in positive orientation on the joggled points. */
150
+ export interface IMesh {
151
+ /** The tetrahedra. */
152
+ tetrahedra: readonly (readonly [number, number, number, number])[];
153
+
154
+ /** The joggled points the mesh is Delaunay and positively oriented on, world metres. */
155
+ points: readonly IAutoMovieVector3[];
156
+ }
157
+ /**
158
+ * Each point's neighbours along the mesh's edges, ascending.
159
+ *
160
+ * @param mesh The mesh.
161
+ * @param n The number of points.
162
+ * @returns The neighbour lists by point.
163
+ */
164
+ export function neighbours(mesh: IMesh, n: number): number[][] {
165
+ const sets: Set<number>[] = Array.from(
166
+ { length: n },
167
+ (): Set<number> => new Set(),
168
+ );
169
+ for (const t of mesh.tetrahedra)
170
+ for (let a: number = 0; a < 4; a++)
171
+ for (let b: number = 0; b < 4; b++)
172
+ if (a !== b) sets[t[a]!]!.add(t[b]!);
173
+ return sets.map((s: Set<number>): number[] =>
174
+ [...s].sort((a: number, b: number): number => a - b),
175
+ );
176
+ }
177
+
178
+ /**
179
+ * A tetrahedron's signed volume times six: positive when its fourth
180
+ * point lies on the side the first three's right-hand normal faces.
181
+ *
182
+ * @param points The points.
183
+ * @param t The tetrahedron.
184
+ * @returns Cubic metres times six.
185
+ */
186
+ export function volume(
187
+ points: readonly IAutoMovieVector3[],
188
+ t: readonly [number, number, number, number],
189
+ ): number {
190
+ const a: IAutoMovieVector3 = points[t[0]]!;
191
+ return Vector3.dot(
192
+ Vector3.cross(
193
+ Vector3.subtract(points[t[1]]!, a),
194
+ Vector3.subtract(points[t[2]]!, a),
195
+ ),
196
+ Vector3.subtract(points[t[3]]!, a),
197
+ );
198
+ }
199
+
200
+ /**
201
+ * A tetrahedron's indices ordered to a positive volume.
202
+ *
203
+ * @param points The points.
204
+ * @param t The tetrahedron.
205
+ * @returns The same corners, the first two swapped when the volume is negative.
206
+ */
207
+ export function oriented(
208
+ points: readonly IAutoMovieVector3[],
209
+ t: [number, number, number, number],
210
+ ): [number, number, number, number] {
211
+ return volume(points, t) >= 0 ? t : [t[1], t[0], t[2], t[3]];
212
+ }
213
+
214
+ /**
215
+ * Whether a point lies strictly inside a tetrahedron's circumsphere.
216
+ *
217
+ * @param points The points.
218
+ * @param t The tetrahedron.
219
+ * @param p The point.
220
+ * @returns Whether it lies inside; false for a flat tetrahedron.
221
+ */
222
+ export function circumscribes(
223
+ points: readonly IAutoMovieVector3[],
224
+ t: readonly [number, number, number, number],
225
+ p: IAutoMovieVector3,
226
+ ): boolean {
227
+ // The circumcentre c solves 2 (q_k - a) 夷?c = |q_k|吏?- |a|吏?for the
228
+ // three other corners q_k, by Cramer's rule.
229
+ const a: IAutoMovieVector3 = points[t[0]]!;
230
+ const rows: IAutoMovieVector3[] = [t[1], t[2], t[3]].map(
231
+ (i: number): IAutoMovieVector3 =>
232
+ Vector3.scale(Vector3.subtract(points[i]!, a), 2),
233
+ );
234
+ const rhs: number[] = [t[1], t[2], t[3]].map(
235
+ (i: number): number =>
236
+ Vector3.dot(points[i]!, points[i]!) - Vector3.dot(a, a),
237
+ );
238
+ const det = (
239
+ u: IAutoMovieVector3,
240
+ v: IAutoMovieVector3,
241
+ w: IAutoMovieVector3,
242
+ ): number => Vector3.dot(u, Vector3.cross(v, w));
243
+ const column = (k: number): IAutoMovieVector3[] =>
244
+ rows.map(
245
+ (r: IAutoMovieVector3, i: number): IAutoMovieVector3 =>
246
+ k === 0
247
+ ? { x: rhs[i]!, y: r.y, z: r.z }
248
+ : k === 1
249
+ ? { x: r.x, y: rhs[i]!, z: r.z }
250
+ : { x: r.x, y: r.y, z: rhs[i]! },
251
+ );
252
+ const d: number = det(rows[0]!, rows[1]!, rows[2]!);
253
+ if (d === 0) return false;
254
+ const [cx, cy, cz] = [0, 1, 2].map((k: number): number => {
255
+ const m: IAutoMovieVector3[] = column(k);
256
+ return det(m[0]!, m[1]!, m[2]!) / d;
257
+ }) as [number, number, number];
258
+ const c: IAutoMovieVector3 = { x: cx, y: cy, z: cz };
259
+ return (
260
+ Vector3.length(Vector3.subtract(p, c)) <
261
+ Vector3.length(Vector3.subtract(a, c))
262
+ );
263
+ }
264
+ }
@@ -14,6 +14,7 @@ import { resolvePose } from "./kinematics/resolvePose";
14
14
  import { Quaternion } from "./math/Quaternion";
15
15
  import { Vector3 } from "./math/Vector3";
16
16
  import { validatePose } from "./validation/validatePose";
17
+ import { Transform } from "./math/Transform";
17
18
 
18
19
  /**
19
20
  * Measure each available arm's rest-chain reach gap in model metres at shot-local seconds; report solved-pose ROM separately and refuse degenerate node scale or absent arm chains.
@@ -63,10 +64,7 @@ export function measureAutoMovieGeometryReach(
63
64
  const localTarget: IAutoMovieVector3 | null =
64
65
  nodeLocal === null || spatial.poseRoot === null
65
66
  ? nodeLocal
66
- : toModelPoint(nodeLocal, {
67
- ...spatial.poseRoot,
68
- scale: { x: 1, y: 1, z: 1 },
69
- });
67
+ : toModelPoint(nodeLocal, Transform.of(spatial.poseRoot.translation, spatial.poseRoot.rotation));
70
68
 
71
69
  if (localTarget === null)
72
70
  throw new Error(
@@ -0,0 +1,70 @@
1
+ import type {
2
+ IAutoMovieQuaternion,
3
+ IAutoMovieVector3,
4
+ } from "@automovie/interface";
5
+
6
+ import { resolveAutoMovieMomentum } from "../kinematics/resolveAutoMovieMomentum";
7
+ import { Quaternion } from "../math/Quaternion";
8
+ import { physicalInertiaTensor } from "../physics/physicalInertiaTensor";
9
+ import { integrateMotionTrajectory } from "./integrateMotionTrajectory";
10
+ import type { solveAirborneTakeoff } from "./solveAirborneTakeoff";
11
+
12
+ /**
13
+ * The linearized shooting relation `angle = turning L - lagging` in the
14
+ * take-off frame: `turning = integral I^-1 dt`, `lagging = integral I^-1 h dt`.
15
+ *
16
+ * @param props The shape history, flight and optional integration step.
17
+ * @param into The rotation from the root's axes into the take-off frame.
18
+ * @returns The matrix in seconds per kg m² and the relative-motion angle in radians.
19
+ *
20
+ * @evidence contracts/development/common.md#meaningful-documentation States the linear relation, both integrals, frames and units.
21
+ * @evidence contracts/development/implementation.md#principled-implementation Composite Simpson quadrature on the integration grid; rotating the principal inverse tensor uses the same tensor sum as physical inertia. This holds the body's orientation at the take-off frame and is a start for shooting, not the nonlinear flight's answer.
22
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One quadrature loop and one tensor application per node.
23
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Neither a fitted mean inertia nor an assumed planar shape replaces the history.
24
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three history reads per grid interval; the history shares repeated nodes.
25
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the momentum tensor product and physical tensor rotation; the caller shares the history with every shooting integration.
26
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Only the two returned numerical arrays escape; no cache or process is owned here.
27
+ */
28
+ export function AirborneTakeoffLinear(
29
+ props: Pick<solveAirborneTakeoff.IProps, "history" | "t0" | "t1" | "h">,
30
+ into: IAutoMovieQuaternion,
31
+ ): { turning: number[][]; lagging: number[] } {
32
+ const step: number = props.h ?? integrateMotionTrajectory.STEP;
33
+ const steps: number = Math.ceil((props.t1 - props.t0) / step);
34
+ const turning: number[][] = [0, 1, 2].map((): number[] => [0, 0, 0]);
35
+ const lagging: number[] = [0, 0, 0];
36
+ const origin: IAutoMovieVector3 = { x: 0, y: 0, z: 0 };
37
+ for (let k: number = 0; k < steps; k++) {
38
+ const a: number = props.t0 + k * step;
39
+ const b: number = k === steps - 1 ? props.t1 : a + step;
40
+ for (const [t, weight] of [
41
+ [a, (b - a) / 6],
42
+ [(a + b) / 2, (4 * (b - a)) / 6],
43
+ [b, (b - a) / 6],
44
+ ] as const) {
45
+ const { inertia, relative } = props.history(t);
46
+ const { x, y, z } = inertia.moments;
47
+ const inverse: number[][] = physicalInertiaTensor(
48
+ [
49
+ {
50
+ mass: 0,
51
+ centerOfMass: origin,
52
+ inertia: { x: 1 / x, y: 1 / y, z: 1 / z },
53
+ inertiaRotation: Quaternion.multiply(into, inertia.rotation),
54
+ },
55
+ ],
56
+ origin,
57
+ );
58
+ const lag: IAutoMovieVector3 = resolveAutoMovieMomentum.apply(
59
+ inverse,
60
+ Quaternion.rotateVector(into, relative),
61
+ );
62
+ [lag.x, lag.y, lag.z].forEach((v: number, i: number): void => {
63
+ lagging[i]! += weight * v;
64
+ for (let j: number = 0; j < 3; j++)
65
+ turning[i]![j]! += weight * inverse[i]![j]!;
66
+ });
67
+ }
68
+ }
69
+ return { turning, lagging };
70
+ }
@@ -0,0 +1,121 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+
3
+ /**
4
+ * One agent of a plan-time crowd steering pass (`steerAutoMovieCrowd`): a disc on the floor that heads for its goals at its own desired speed and avoids the others and the obstacles.
5
+ *
6
+ * Positions are world metres on the floor plan (`y` is not read), speeds metres per second, times film seconds. Nothing in it names a person: a walker, a horse or a cart is an agent with its own radius and speed.
7
+ *
8
+ * @evidence contracts/development/common.md#meaningful-documentation States what an agent is, its units and frames, and that it carries no vocabulary.
9
+ * @evidence contracts/development/design.md#principled-representation The agent of the social force model (Helbing and Molnar 1995): a position, a goal, a radius and a desired speed, with the start second and herding share of Helbing, Farkas and Vicsek 2000.
10
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the engine's steering pass; the motions package builds agents from members and the props planner from vehicles and herds.
11
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts A goal is a point or an ordered list of points, never a scripted course; the course is the pass's output.
12
+ */
13
+ export interface IAutoMovieCrowdAgent {
14
+ /** Where it stands at the pass's first second, world metres. */
15
+ at: IAutoMovieVector3;
16
+
17
+ /** Where it heads: one point, or points passed in order, the last its destination; world metres. */
18
+ goal: IAutoMovieVector3 | readonly IAutoMovieVector3[];
19
+
20
+ /** Its disc's radius, metres, positive: half a walker's shoulder breadth. */
21
+ radius: number;
22
+
23
+ /** Its desired speed, metres per second, positive. */
24
+ speed: number;
25
+
26
+ /** The fastest it may go, metres per second, at least `speed`; 1.3 times `speed` when absent (Helbing and Molnar 1995). */
27
+ maximum?: number;
28
+
29
+ /** The film second it sets off; it stands still before. */
30
+ start: number;
31
+
32
+ /** Its herding share in [0, 1]: the weight of its neighbours' mean heading against its own (Helbing, Farkas and Vicsek 2000); 0 when absent. */
33
+ herding?: number;
34
+ }
35
+
36
+ /**
37
+ * Companion types of {@link IAutoMovieCrowdAgent}.
38
+ */
39
+ export namespace IAutoMovieCrowdAgent {
40
+ /**
41
+ * Something the agents steer round.
42
+ *
43
+ * @evidence contracts/development/common.md#meaningful-documentation States its footprint's frame with and without a motion, and that a motion is pure.
44
+ * @evidence contracts/development/design.md#principled-representation A convex footprint on the floor plan and an optional rigid placement by film second.
45
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two members the pass reads; the motions package maps its obstacles onto it.
46
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts A still obstacle carries no motion rather than a constant function.
47
+ */
48
+ export interface IObstacle {
49
+ /** A convex footprint's corners in order: world metres without a motion, its own frame (x to its left, z ahead) with one; `y` is not read. */
50
+ footprint: readonly IAutoMovieVector3[];
51
+
52
+ /**
53
+ * Pure placement at a film second: world position in metres and yaw in
54
+ * degrees. The footprint stays fixed in world space when absent. The
55
+ * reader also samples neighbouring instants to estimate velocity.
56
+ *
57
+ * @evidence contracts/development/common.md#meaningful-documentation States purity, timebase, output units, absence and neighbouring-time reads.
58
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation A callback declaration; its supplied function owns the placement method.
59
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure No callback body is declared here.
60
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts This signature computes no placement.
61
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms The callback's implementation owns its evaluation cost.
62
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work The signature coordinates no evaluations or cache.
63
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The signature acquires and retains no resources.
64
+ */
65
+ motion?: (seconds: number) => { position: IAutoMovieVector3; yaw: number };
66
+ }
67
+
68
+ /**
69
+ * One agent's planned course.
70
+ *
71
+ * @evidence contracts/development/common.md#meaningful-documentation States the reader's units, the held ends and the meaning of a null arrival.
72
+ * @evidence contracts/development/design.md#principled-representation A course read by film second, and the first second within its radius of its destination.
73
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What HumanCrowd.steer and the props planner read.
74
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No arrival is invented: an agent that does not arrive reads null.
75
+ */
76
+ export interface ICourse {
77
+ /**
78
+ * World position in metres and velocity in metres per second at a film
79
+ * second, held at the pass's ends outside it.
80
+ *
81
+ * @evidence contracts/development/common.md#meaningful-documentation States the timebase, result frames and units, and held-end behavior.
82
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation A course-reader signature; the steering pass's supplied function owns sampling.
83
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure No sampling body is declared here.
84
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts This declaration computes no trajectory state.
85
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Evaluation cost belongs to the supplied reader.
86
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work This signature owns no trajectory memo or coordinated reads.
87
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources This signature retains no trajectory or handle.
88
+ */
89
+ at: (seconds: number) => {
90
+ position: IAutoMovieVector3;
91
+ velocity: IAutoMovieVector3;
92
+ };
93
+
94
+ /** The first second it stands within its radius of its destination, or null when it does not arrive within the pass. */
95
+ arrival: number | null;
96
+ }
97
+
98
+ /**
99
+ * Two discs, or a disc and an obstacle, that overlapped for longer than one step.
100
+ *
101
+ * @evidence contracts/development/common.md#meaningful-documentation States each member's meaning and unit.
102
+ * @evidence contracts/development/design.md#principled-representation The two parties by index, when the overlap began and how deep it was.
103
+ * @evidence contracts/development/design.md#minimal-and-owned-surface What a caller names in its refusal.
104
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts other and obstacle are exclusive by construction: exactly one is null.
105
+ */
106
+ export interface IContact {
107
+ /** The first agent's index. */
108
+ agent: number;
109
+
110
+ /** What it overlapped: another agent, or an obstacle, by index. */
111
+ other:
112
+ | { kind: "agent"; index: number }
113
+ | { kind: "obstacle"; index: number };
114
+
115
+ /** The film second the overlap began. */
116
+ seconds: number;
117
+
118
+ /** How deep they overlapped there, metres. */
119
+ depth: number;
120
+ }
121
+ }
@@ -0,0 +1,32 @@
1
+ import type { IAutoMoviePose } from "@automovie/interface";
2
+
3
+ import type { IAutoMovieSwivelSeed } from "../kinematics/IAutoMovieSwivelSeed";
4
+
5
+ /**
6
+ * A chain fit with the seed that continues it: the fitted pose, and the
7
+ * branch and swivel of its hinged candidate when that candidate is the
8
+ * answer (`fitSeededChainToTarget`).
9
+ *
10
+ * @evidence contracts/development/design.md#principled-representation The pose a fit returns and the two numbers that name its hinged candidate for any target.
11
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The answer, its seed and, for a fit with a strain, the value it was chosen by, which a caller ranking keys by their fits reads.
12
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses `IAutoMovieSwivelSeed`; null states there is no seed rather than inventing one.
13
+ * @evidence contracts/development/common.md#meaningful-documentation States both members and when the seed is null.
14
+ */
15
+ export interface IAutoMovieSeededChainFit {
16
+ /** The fitted pose, as `fitChainToTarget` returns it. */
17
+ pose: IAutoMoviePose;
18
+
19
+ /** The seed of the hinged candidate that is the answer; null when another candidate, or none, is. */
20
+ seed: IAutoMovieSwivelSeed | null;
21
+
22
+ /**
23
+ * What the answer scored, when it is a hinged candidate fitted with a
24
+ * strain (`fitChainToTarget`'s `strain`): its overshoot in degrees, 0
25
+ * when it is legal; the hand's rotation error in degrees, the least over
26
+ * the legal swivels to within the joints' tolerance; and the strain of the
27
+ * swivel chosen among those. With a positive overshoot no swivel is legal
28
+ * and the error and the strain are the least-overshoot candidate's. Absent
29
+ * for any other fit.
30
+ */
31
+ value?: { overshoot: number; error: number; strain: number };
32
+ }
@@ -3,6 +3,8 @@ import type {
3
3
  IAutoMovieVector3,
4
4
  } from "@automovie/interface";
5
5
 
6
+ import type { IAutoMovieSwivelSeed } from "../kinematics/IAutoMovieSwivelSeed";
7
+
6
8
  /**
7
9
  * Clinical articulation of a two-link target candidate before final clamping.
8
10
  * The caller evaluates its effective ROM and actual FK residual; this record
@@ -22,4 +24,22 @@ export interface IAutoMovieSolvedChainPlant {
22
24
 
23
25
  /** Original hinge direction in the resolved model frame. */
24
26
  hinge: IAutoMovieVector3;
27
+
28
+ /**
29
+ * Metres the candidate rests short of (or past) the target along the line
30
+ * from the chain root, because the distance lies outside the chain's span
31
+ * or its mid joint stopped at a limit of its flexion range; absent or `0`
32
+ * when a legal hinge angle reaches the distance.
33
+ */
34
+ shortfall?: number;
35
+
36
+ /**
37
+ * The branch and swivel a hinged chain's candidate was chosen at, the seed
38
+ * a fit of a nearby target continues from (`IAutoMovieSwivelNear`); absent
39
+ * for a candidate of another chain.
40
+ */
41
+ seed?: IAutoMovieSwivelSeed;
42
+
43
+ /** What a hinged chain's candidate fitted with a strain scored (`IAutoMovieSeededChainFit.value`); absent otherwise. */
44
+ value?: { overshoot: number; error: number; strain: number };
25
45
  }
@@ -8,6 +8,7 @@ import type {
8
8
  } from "@automovie/interface";
9
9
 
10
10
  import type { IAutoMovieSkeletonTopology } from "../kinematics/IAutoMovieSkeletonTopology";
11
+ import type { IAutoMovieSwivelNear } from "../kinematics/IAutoMovieSwivelNear";
11
12
  import type { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
12
13
  import type { IAutoMoviePlantChain } from "./IAutoMoviePlantChain";
13
14
 
@@ -56,6 +57,17 @@ export interface IFitChainToTargetProps {
56
57
  */
57
58
  referencePose?: IAutoMoviePose;
58
59
 
60
+ /**
61
+ * How much a degree of joint turn from `referencePose` counts in a hinged
62
+ * chain's swivel choice, in degrees of effector error; 1 when omitted. A
63
+ * caller approaching the reference's instant raises it continuously from
64
+ * near 0 to 1, so the reference decides between two nearly tied swivels
65
+ * before the approach reaches them without pulling the limb early on, and
66
+ * the chosen swivel stays continuous in time. Only the swivel's continuous
67
+ * cost reads it; must be finite and non-negative.
68
+ */
69
+ referenceWeight?: number;
70
+
59
71
  /**
60
72
  * A model-frame point the mid joint (a knee or an elbow) bends toward, the
61
73
  * pole vector of game-engine two-bone IK. Omitted, a hinged chain (elbow,
@@ -67,9 +79,64 @@ export interface IFitChainToTargetProps {
67
79
  */
68
80
  bend?: IAutoMovieVector3;
69
81
 
82
+ /**
83
+ * A hinged chain's strain of a candidate, non-negative: the candidate's
84
+ * bone-local root and mid rotations and the mid bone's world rotation. When
85
+ * given, a hinged chain's swivels are ranked by task priority (Siciliano
86
+ * and Slotine 1991): legality, then the effector's rotation error, two
87
+ * errors within the joints' tolerance being one, then the turn from
88
+ * `referencePose` when one is given, else this strain, so the
89
+ * elbow takes its place of least strain among the swivels that turn the
90
+ * hand best (Tolani, Goswami and Badler 2000: the elbow's place on its
91
+ * swivel circle chosen by a cost of the joints), and `bend` is not read.
92
+ * The fit reports the value it chose by (`IAutoMovieSeededChainFit.value`).
93
+ * Omitted, `bend` is the hint.
94
+ *
95
+ * @evidence contracts/development/common.md#meaningful-documentation States the three quaternion frames, non-negative score, task priority, reported value and absence behavior; the score's scale is the caller's.
96
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation A candidate-score callback declaration; its caller owns the strain method.
97
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure No strain callback body is declared here.
98
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts This signature computes no candidate score.
99
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms The supplied callback owns its per-candidate evaluation cost.
100
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work The signature owns no candidate cache or shared evaluation.
101
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The signature acquires and retains nothing.
102
+ */
103
+ strain?: (
104
+ upper: IAutoMovieQuaternion,
105
+ lower: IAutoMovieQuaternion,
106
+ lowerWorld: IAutoMovieQuaternion,
107
+ ) => number;
108
+
70
109
  /**
71
110
  * The effector's model-frame rotation, as `resolvePose` reports world
72
111
  * rotations; omitted, the effector keeps the pose's own angles.
73
112
  */
74
113
  effectorRotation?: IAutoMovieQuaternion;
114
+
115
+ /**
116
+ * What a hinged chain must keep clear of beyond the rig's own ranges, such
117
+ * as the body the limb belongs to: given a candidate's mid joint and end
118
+ * joint in the pose's resolved model-metre frame, the degrees that candidate
119
+ * counts as out of range, 0 when it is allowed and never negative. It adds
120
+ * to the range of motion overshoot the swivel choice ranks first, so an
121
+ * obstructed swivel loses to a clear one whatever the bend hint, the
122
+ * reference or the effector's rotation prefer. Omitted, only the rig's
123
+ * ranges decide.
124
+ *
125
+ * @evidence contracts/development/common.md#meaningful-documentation States the two arguments and their frame, the degrees returned, that 0 means allowed and the result is never negative, how it ranks against the range of motion overshoot and what an absent callback means.
126
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation A callback type with no body: the caller's function owns the method.
127
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure A callback type with no body: the caller's function owns the structure.
128
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts A callback type with no body: nothing here computes a value.
129
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms A callback type with no body: the cost is the caller's, once per candidate swivel.
130
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A callback type with no body: it shares nothing.
131
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A callback type with no body: it acquires and retains nothing.
132
+ */
133
+ obstruction?: (mid: IAutoMovieVector3, end: IAutoMovieVector3) => number;
134
+
135
+ /**
136
+ * A hinged chain's fit of a nearby target to continue, its seed and the
137
+ * tolerance its swivel is refined to (`IAutoMovieSwivelNear`), in place of
138
+ * the sweep over every swivel; omitted, the swivel is swept. A caller reads
139
+ * a seed from `fitSeededChainToTarget`.
140
+ */
141
+ near?: IAutoMovieSwivelNear;
75
142
  }