@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,75 @@
1
+ import type { IAutoMovieVector3 } from "@automovie/interface";
2
+ /**
3
+ * The rigid ring modules of a humanoid body, each a short stack of
4
+ * eight-sided sections around one joint's segment, from the rest skeleton
5
+ * alone: joint positions, tips and girth radii.
6
+ *
7
+ * This is the one statement of the body's simple solid form. The polygon
8
+ * drawing lofts a mesh through each module's rings and the physical profile
9
+ * takes the convex hull of the same ring points as that segment's collider,
10
+ * so what is seen and what collides cannot drift apart.
11
+ *
12
+ * The skeleton is in the Human frame at rest: +X forward, +Y up, +Z left,
13
+ * metres. The trunk's modules share their boundary rings (pelvis floor, hip,
14
+ * waist, chest, shoulder, neck base), widened to the hip and shoulder joint
15
+ * spans; the neck runs from the neck joint to the head joint; the head widens
16
+ * to its girth and closes on a pole at its tip; a palm runs from the wrist
17
+ * toward the mean of the four finger roots as far as the farthest of them, so
18
+ * no knuckle is bare beyond it; a foot is two modules through the
19
+ * subtalar and midfoot joints to the toe roots; every other segment is three
20
+ * round rings from its joint to its end, narrowing to the next segment or
21
+ * bevelled at a leaf. Shoulder, scapula, foot, eye, jaw and atlas joints
22
+ * drive others and carry no module.
23
+ *
24
+ * @param bones The rest joints, parent before child, in the Human frame.
25
+ * @returns The modules in drawing order: hips, spine, head, chest, neck, each
26
+ * side's hand and two foot modules, then every remaining segment in joint
27
+ * order.
28
+ * @throws {Error} When a joint a module is built from is missing.
29
+ *
30
+ * @evidence contracts/development/common.md#meaningful-documentation States the frame, the unit, what each module is built from, which joints carry none, the order of the result and the two consumers the single statement serves.
31
+ * @evidence contracts/development/implementation.md#principled-implementation Every dimension is a joint span or a girth radius of the skeleton; a section widened to a breadth keeps its girth circle's area (depth = r²/breadth), and the two trunk shares are the anthropometric conventions named at their constants.
32
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pure function owns ring selection and ring points for the drawing and for the colliders; it knows no renderer and no physics, only vectors.
33
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No fitted dimension, body-specific branch or skin surface enters; a missing joint is refused rather than replaced. The non-null assertions index fixed-length lists the function builds.
34
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the joints with map lookups: linear in the joint count, eight points per ring.
35
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the rest skeleton, called once when a drawing or a profile is built.
36
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; the returned modules belong to the caller.
37
+ */
38
+ export declare function resolveAutoMovieHumanoidRingModules(bones: readonly resolveAutoMovieHumanoidRingModules.IBone[]): resolveAutoMovieHumanoidRingModules.IModule[];
39
+ /**
40
+ * The skeleton input and the module records.
41
+ *
42
+ * @evidence contracts/development/common.md#meaningful-documentation Names the input joint and the two output records; each member states its frame, unit and meaning.
43
+ * @evidence contracts/development/design.md#principled-representation A module is its ring stack with the frame that generated it and an optional closing pole; a ring keeps both its analytic form (centre, half dimensions) and its eight points, which the mesh and the hull read. The two nullable members name a real absence: no breadth axis, no pole.
44
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by `resolveAutoMovieHumanoidRingModules`; the viewer's polygon drawing and the Human physical profile read every member.
45
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No `any`, `unknown`, index signature or cast. `IBone` is the structural shape of a generated rest joint, declared here because the engine cannot import the viewer's or the Human's record.
46
+ */
47
+ export declare namespace resolveAutoMovieHumanoidRingModules {
48
+ /** One rest joint and the segment leaving it. */
49
+ interface IBone {
50
+ /** Joint identity. */ bone: string;
51
+ /** Parent identity, or null at the root. */ parent: string | null;
52
+ /** Rest joint centre, Human frame metres. */ position: readonly [
53
+ number,
54
+ number,
55
+ number
56
+ ];
57
+ /** Leaf segment endpoint, metres; null when a child ends the segment. */ tip: readonly [number, number, number] | null;
58
+ /** Positive girth radius of the segment, metres. */ radius: number;
59
+ }
60
+ /** One section of a module. */
61
+ interface IRing {
62
+ /** Centre, Human frame metres. */ centre: IAutoMovieVector3;
63
+ /** Half dimension along the module's first in-plane axis, metres. */ depth: number;
64
+ /** Half dimension along its second in-plane axis, metres. */ breadth: number;
65
+ /** The ring's points, counter clockwise about the module axis, Human frame metres. */ points: IAutoMovieVector3[];
66
+ }
67
+ /** One rigid module. */
68
+ interface IModule {
69
+ /** The joint whose segment this module is. */ bone: string;
70
+ /** The direction the rings are stacked along; not a unit. */ axis: IAutoMovieVector3;
71
+ /** The direction of the rings' breadth, or null for the default frame whose depth axis is forward. */ breadth: IAutoMovieVector3 | null;
72
+ /** The stacked sections, first to last along the axis. */ rings: IRing[];
73
+ /** The point closing the last ring, or null for a flat end. */ pole: IAutoMovieVector3 | null;
74
+ }
75
+ }
@@ -0,0 +1,228 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resolveAutoMovieHumanoidRingModules = resolveAutoMovieHumanoidRingModules;
4
+ const Vector3_1 = require("../math/Vector3");
5
+ /**
6
+ * The rigid ring modules of a humanoid body, each a short stack of
7
+ * eight-sided sections around one joint's segment, from the rest skeleton
8
+ * alone: joint positions, tips and girth radii.
9
+ *
10
+ * This is the one statement of the body's simple solid form. The polygon
11
+ * drawing lofts a mesh through each module's rings and the physical profile
12
+ * takes the convex hull of the same ring points as that segment's collider,
13
+ * so what is seen and what collides cannot drift apart.
14
+ *
15
+ * The skeleton is in the Human frame at rest: +X forward, +Y up, +Z left,
16
+ * metres. The trunk's modules share their boundary rings (pelvis floor, hip,
17
+ * waist, chest, shoulder, neck base), widened to the hip and shoulder joint
18
+ * spans; the neck runs from the neck joint to the head joint; the head widens
19
+ * to its girth and closes on a pole at its tip; a palm runs from the wrist
20
+ * toward the mean of the four finger roots as far as the farthest of them, so
21
+ * no knuckle is bare beyond it; a foot is two modules through the
22
+ * subtalar and midfoot joints to the toe roots; every other segment is three
23
+ * round rings from its joint to its end, narrowing to the next segment or
24
+ * bevelled at a leaf. Shoulder, scapula, foot, eye, jaw and atlas joints
25
+ * drive others and carry no module.
26
+ *
27
+ * @param bones The rest joints, parent before child, in the Human frame.
28
+ * @returns The modules in drawing order: hips, spine, head, chest, neck, each
29
+ * side's hand and two foot modules, then every remaining segment in joint
30
+ * order.
31
+ * @throws {Error} When a joint a module is built from is missing.
32
+ *
33
+ * @evidence contracts/development/common.md#meaningful-documentation States the frame, the unit, what each module is built from, which joints carry none, the order of the result and the two consumers the single statement serves.
34
+ * @evidence contracts/development/implementation.md#principled-implementation Every dimension is a joint span or a girth radius of the skeleton; a section widened to a breadth keeps its girth circle's area (depth = r²/breadth), and the two trunk shares are the anthropometric conventions named at their constants.
35
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pure function owns ring selection and ring points for the drawing and for the colliders; it knows no renderer and no physics, only vectors.
36
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No fitted dimension, body-specific branch or skin surface enters; a missing joint is refused rather than replaced. The non-null assertions index fixed-length lists the function builds.
37
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the joints with map lookups: linear in the joint count, eight points per ring.
38
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the rest skeleton, called once when a drawing or a profile is built.
39
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Keeps nothing between calls; the returned modules belong to the caller.
40
+ */
41
+ function resolveAutoMovieHumanoidRingModules(bones) {
42
+ const byName = new Map();
43
+ const children = new Map();
44
+ for (const bone of bones) {
45
+ byName.set(bone.bone, bone);
46
+ if (bone.parent !== null)
47
+ children.set(bone.parent, [...(children.get(bone.parent) ?? []), bone]);
48
+ }
49
+ const boneAt = (name) => {
50
+ const bone = byName.get(name);
51
+ if (bone === undefined)
52
+ throw new Error(`Missing ring module skeleton bone: ${name}`);
53
+ return bone;
54
+ };
55
+ const at = (bone) => vector(bone.position);
56
+ const average = (list) => {
57
+ if (list.length === 0)
58
+ throw new Error("A ring module requires joint endpoints");
59
+ let centre = { x: 0, y: 0, z: 0 };
60
+ for (const bone of list)
61
+ centre = Vector3_1.Vector3.add(centre, at(bone));
62
+ return Vector3_1.Vector3.scale(centre, 1 / list.length);
63
+ };
64
+ const modules = [];
65
+ const drawn = new Set();
66
+ const add = (bone, sections, axis, breadth, pole) => {
67
+ // The section frame: the axis as normal, the first in-plane axis across
68
+ // the breadth axis (forward when none is given), the second along it.
69
+ const normal = Vector3_1.Vector3.scale(axis, 1 / Vector3_1.Vector3.length(axis));
70
+ let u = breadth === null ? { x: 1, y: 0, z: 0 } : Vector3_1.Vector3.cross(breadth, normal);
71
+ u = Vector3_1.Vector3.subtract(u, Vector3_1.Vector3.scale(normal, Vector3_1.Vector3.dot(u, normal)));
72
+ if (Vector3_1.Vector3.dot(u, u) < Number.EPSILON)
73
+ u = Vector3_1.Vector3.subtract({ x: 0, y: 1, z: 0 }, Vector3_1.Vector3.scale(normal, normal.y));
74
+ u = Vector3_1.Vector3.scale(u, 1 / Vector3_1.Vector3.length(u));
75
+ const cross = Vector3_1.Vector3.cross(normal, u);
76
+ const v = Vector3_1.Vector3.scale(cross, 1 / Vector3_1.Vector3.length(cross));
77
+ modules.push({
78
+ bone: bone.bone,
79
+ axis,
80
+ breadth,
81
+ pole,
82
+ rings: sections.map((ring) => ({
83
+ ...ring,
84
+ points: Array.from({ length: SIDES }, (_, index) => {
85
+ const angle = (2 * Math.PI * index) / SIDES;
86
+ return Vector3_1.Vector3.add(ring.centre, Vector3_1.Vector3.add(Vector3_1.Vector3.scale(u, Math.cos(angle) * ring.depth), Vector3_1.Vector3.scale(v, Math.sin(angle) * ring.breadth)));
87
+ }),
88
+ })),
89
+ });
90
+ drawn.add(bone.bone);
91
+ };
92
+ // Shared horizontal boundaries keep the rest torso's adjoining modules
93
+ // aligned.
94
+ const hips = boneAt("hips");
95
+ const spine = boneAt("spine");
96
+ const chest = boneAt("chest");
97
+ const neck = boneAt("neck");
98
+ const head = boneAt("head");
99
+ const span = (left, right, floor) => Math.max(floor, Math.abs(boneAt(left).position[2] - boneAt(right).position[2]) / 2 +
100
+ Math.max(boneAt(left).radius, boneAt(right).radius));
101
+ const hipBreadth = span("leftUpperLeg", "rightUpperLeg", hips.radius);
102
+ const shoulderBreadth = span("leftUpperArm", "rightUpperArm", chest.radius);
103
+ const shoulderCentre = average([
104
+ boneAt("leftUpperArm"),
105
+ boneAt("rightUpperArm"),
106
+ ]);
107
+ const hipRing = section(at(hips), hips.radius, hipBreadth);
108
+ // A trunk is wider than deep: the waist and chest keep their girth radius
109
+ // as depth and widen to the anthropometric share of the shoulder breadth,
110
+ // so the torso does not pinch between the hips and the shoulders.
111
+ const lumbarRing = section(at(spine), spine.radius, Math.max(spine.radius, WAIST_SHARE * shoulderBreadth));
112
+ const chestRing = section(at(chest), chest.radius, Math.max(chest.radius, CHEST_SHARE * shoulderBreadth));
113
+ const pelvisBottom = at(hips);
114
+ pelvisBottom.y -= Math.min(boneAt("leftUpperLeg").radius, boneAt("rightUpperLeg").radius);
115
+ add(hips, [section(pelvisBottom, hips.radius, hipBreadth), hipRing, lumbarRing], UP, null, null);
116
+ add(spine, [lumbarRing, chestRing], UP, null, null);
117
+ // The neck runs between its own joints; the head widens to its girth and
118
+ // closes on its tip, two girth radii above the joint when it has none.
119
+ const crown = head.tip !== null
120
+ ? vector(head.tip)
121
+ : Vector3_1.Vector3.add(at(head), { x: 0, y: 2 * head.radius, z: 0 });
122
+ const neckRings = [
123
+ section(at(neck), neck.radius, neck.radius),
124
+ section(at(head), neck.radius * 0.92, neck.radius * 0.92),
125
+ ];
126
+ add(head, [
127
+ neckRings[1],
128
+ section(Vector3_1.Vector3.lerp(at(head), crown, 0.35), head.radius, head.radius * 0.92),
129
+ section(Vector3_1.Vector3.lerp(at(head), crown, 0.75), head.radius * 0.85, head.radius * 0.8),
130
+ ], UP, null, crown);
131
+ add(chest, [
132
+ chestRing,
133
+ section(shoulderCentre, chest.radius, shoulderBreadth),
134
+ neckRings[0],
135
+ ], UP, null, null);
136
+ add(neck, neckRings, UP, null, null);
137
+ for (const side of ["left", "right"]) {
138
+ const hand = boneAt(`${side}Hand`);
139
+ const roots = [
140
+ "Index",
141
+ "Middle",
142
+ "Ring",
143
+ "Little",
144
+ ].map((digit) => boneAt(`${side}${digit}Proximal`));
145
+ // The palm's axis aims at the mean of the finger roots and its end
146
+ // section sits at the farthest root along that axis, so every finger
147
+ // starts on or inside the palm and no knuckle is left bare beyond it.
148
+ const mean = average(roots);
149
+ const toward = Vector3_1.Vector3.subtract(mean, at(hand));
150
+ const reach = Vector3_1.Vector3.length(toward);
151
+ if (!(reach > 0))
152
+ throw new Error(`The palm of ${hand.bone} has no length to its fingers`);
153
+ const farthest = Math.max(...roots.map((root) => Vector3_1.Vector3.dot(Vector3_1.Vector3.subtract(at(root), at(hand)), toward) / reach));
154
+ const knuckles = Vector3_1.Vector3.add(at(hand), Vector3_1.Vector3.scale(toward, farthest / reach));
155
+ const across = Vector3_1.Vector3.subtract(at(roots[0]), at(roots[3]));
156
+ const width = Vector3_1.Vector3.length(across) / 2 + Math.max(roots[0].radius, roots[3].radius);
157
+ const wrist = Math.min(hand.radius, boneAt(`${side}LowerArm`).radius);
158
+ add(hand, [
159
+ section(at(hand), wrist, wrist),
160
+ section(knuckles, hand.radius, Math.max(width, hand.radius)),
161
+ ], Vector3_1.Vector3.subtract(knuckles, at(hand)), across, null);
162
+ const subtalar = boneAt(`${side}Subtalar`);
163
+ const midfoot = boneAt(`${side}Midfoot`);
164
+ const toes = children.get(midfoot.bone) ?? [];
165
+ const toeCentre = average(toes);
166
+ const footWidth = Math.max(subtalar.radius, ...toes.map((toe) => Math.abs(toe.position[2] - toeCentre.z) + toe.radius));
167
+ add(subtalar, [
168
+ section(at(subtalar), subtalar.radius, subtalar.radius),
169
+ section(at(midfoot), midfoot.radius, footWidth),
170
+ ], Vector3_1.Vector3.subtract(at(midfoot), at(subtalar)), LEFT, null);
171
+ add(midfoot, [
172
+ section(at(midfoot), midfoot.radius, footWidth),
173
+ section(toeCentre, midfoot.radius, footWidth),
174
+ ], Vector3_1.Vector3.subtract(toeCentre, at(midfoot)), LEFT, null);
175
+ }
176
+ // Each remaining segment once. Scapula and foot joints are coincident
177
+ // driving pivots whose descendants carry the form.
178
+ for (const bone of bones) {
179
+ if (drawn.has(bone.bone) ||
180
+ /(?:Shoulder|Scapula|Foot|Eye)$/.test(bone.bone) ||
181
+ bone.bone === "jaw" ||
182
+ bone.bone === "atlas")
183
+ continue;
184
+ const next = (children.get(bone.bone) ?? []).find((child) => child.bone !== "jaw" && !child.bone.endsWith("Eye"));
185
+ const end = bone.tip ?? next?.position;
186
+ if (end === undefined)
187
+ continue;
188
+ const start = at(bone);
189
+ const finish = vector(end);
190
+ const axis = Vector3_1.Vector3.subtract(finish, start);
191
+ if (!(Vector3_1.Vector3.dot(axis, axis) > 0))
192
+ continue;
193
+ const distal = bone.tip === null
194
+ ? Math.min(bone.radius, next?.radius ?? bone.radius)
195
+ : bone.radius * TIP_BEVEL;
196
+ add(bone, [
197
+ { centre: start, depth: bone.radius, breadth: bone.radius },
198
+ {
199
+ centre: Vector3_1.Vector3.lerp(start, finish, 0.5),
200
+ depth: bone.radius,
201
+ breadth: bone.radius,
202
+ },
203
+ { centre: finish, depth: distal, breadth: distal },
204
+ ], axis, null, null);
205
+ }
206
+ return modules;
207
+ }
208
+ /** A position tuple as a vector. */
209
+ const vector = (tuple) => ({
210
+ x: tuple[0],
211
+ y: tuple[1],
212
+ z: tuple[2],
213
+ });
214
+ /** A section that keeps its girth circle's area pi r² when its lateral half width becomes `breadth`: depth = r²/breadth. */
215
+ const section = (centre, radius, breadth) => ({ centre, depth: (radius * radius) / breadth, breadth });
216
+ /** Points per ring: the body's one level of detail, independent of its dimensions. */
217
+ const SIDES = 8;
218
+ /** Waist breadth over shoulder breadth (convention: adult waist breadth about three quarters of biacromial). */
219
+ const WAIST_SHARE = 0.75;
220
+ /** Chest breadth over shoulder breadth (convention: adult chest breadth about 0.85 of biacromial). */
221
+ const CHEST_SHARE = 0.85;
222
+ /** A leaf segment's end ring over its girth radius, the display convention for a bevelled tip. */
223
+ const TIP_BEVEL = 0.5;
224
+ /** The upward axis of the Human frame. */
225
+ const UP = { x: 0, y: 1, z: 0 };
226
+ /** The lateral axis of the Human frame, shared by both sides. */
227
+ const LEFT = { x: 0, y: 0, z: 1 };
228
+ //# sourceMappingURL=resolveAutoMovieHumanoidRingModules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveAutoMovieHumanoidRingModules.js","sourceRoot":"","sources":["../../src/kinematics/resolveAutoMovieHumanoidRingModules.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { AutoMovieHumanoidBone, AutoMovieHumanoidRegion, AutoMovieHumanoidSocket, IAutoMovieSkeleton, IAutoMovieVector3, IAutoMoviePhysicalProfile as P } from "@automovie/interface";
2
- import { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
2
+ import type { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
3
3
  /**
4
4
  * Resolve every anatomical region and contact socket of a canonical humanoid
5
5
  * onto its collision shapes, as bone-local frames that follow any pose.
@@ -11,20 +11,25 @@ import { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
11
11
  * frame; its point is where a ray from the station along the direction
12
12
  * leaves the bone's colliders (exact ray exits of spheres, capsules and boxes;
13
13
  * the colliders are convex and closed, so the union's exit is the largest and
14
- * a station on a face counts as inside), and its
15
- * normal is the direction. This is how authored hit and touch locations are
14
+ * a station on a face counts as inside), and its normal is the outward normal
15
+ * of the collider it leaves there (surfaceNormal): the authored direction
16
+ * only finds the point, as a contact frame's normal is the collision
17
+ * geometry's. A normal read from the direction instead stood up to 44 degrees
18
+ * off the surface (the nape's 24), so a palm laid flat on it sank its heel
19
+ * 14.8 mm into the neck. This is how authored hit and touch locations are
16
20
  * placed on character physics bodies in game engines (a bone plus a local
17
21
  * offset on its collider), generalised so the offset comes from the body's
18
22
  * own shapes and fits any size. The palm, sole, heel and seat regions share
19
- * their sockets' points, and the index fingertip region is the exit of a ray
20
- * along the finger through the distal phalanx's colliders (the hand's when the
21
- * profile has no phalanx segment), riding the distal phalanx.
23
+ * their sockets' points, and every digit's tip and pad ride its distal
24
+ * phalanx (`AutoMovieHumanoidDigitSurfaces`): the tip the exit of a ray along
25
+ * the phalanx, the pad that of a ray from its middle toward the palm.
22
26
  * Sockets of the foot, seat and back are read
23
27
  * from the exact axis bounds of their segment's colliders at rest (heel at
24
28
  * the back of the sole, ball under the toe joint, toe at the front, sole at
25
29
  * the middle, seat under the pelvis, back behind the thorax; when the profile
26
30
  * gives the toes their own segment, the toe socket is the front of the toes'
27
- * colliders and rides the toes bone, so it bends at the ball); the palm is the
31
+ * colliders on the sole's plane and rides the toes bone, so it bends at the
32
+ * ball and bears when the heel rises about the toes' joint); the palm is the
28
33
  * ray exit below the palm's middle, the grip lies 0.025 m out from it, the
29
34
  * radius of a 50 mm handle, the power grip's optimal handle size (Grant,
30
35
  * Habes and Steward 1992), and the fist lies 0.012 m ahead of the middle
@@ -35,13 +40,18 @@ import { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
35
40
  * frame under any pose is the bone's world position plus its world rotation
36
41
  * applied to them.
37
42
  *
43
+ * The left side is the mirror of the right: a left region or socket (and the
44
+ * spleen, the liver's twin) is its right twin's frame mirrored in the median
45
+ * plane (`mirrored`), on the opposite bone, so a left act reads a frame that
46
+ * is the mirror of the right one to the bit, as the rig's own rest is.
47
+ *
38
48
  * @param skeleton The canonical rig.
39
49
  * @param profile Its physical profile, segments keyed by rig bones.
40
50
  * @returns Every region and socket.
41
51
  * @throws {Error} When a bone or segment a definition needs is missing, or a ray misses its colliders.
42
52
  *
43
- * @evidence contracts/development/common.md#meaningful-documentation States the frame premise, how each kind of surface is placed, the cited grip size and the local frame of the result.
44
- * @evidence contracts/development/implementation.md#principled-implementation Exact ray exits through convex colliders from anatomical stations and directions, and exact collider bounds for the sole, seat and back.
53
+ * @evidence contracts/development/common.md#meaningful-documentation States the frame premise, how each kind of surface is placed and its normal read, the measured defect, the cited grip size and the local frame of the result.
54
+ * @evidence contracts/development/implementation.md#principled-implementation Exact ray exits through convex colliders from anatomical stations and directions, each region's normal the exited collider's outward normal there (smoothed across a box's or a hull's edges), and exact collider bounds for the sole, seat and back.
45
55
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Two definition tables, one ray routine and one bounds routine.
46
56
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing bone, segment or hit throws rather than inventing a point.
47
57
  * @evidence contracts/development/implementation.md#efficient-algorithms Linear in definitions times colliders per bone.
@@ -54,7 +64,7 @@ export declare function resolveAutoMovieHumanoidSurfaces(skeleton: IAutoMovieSke
54
64
  *
55
65
  * @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame.
56
66
  * @evidence contracts/development/design.md#principled-representation Bone-local points and unit directions keyed by the closed region and socket unions.
57
- * @evidence contracts/development/design.md#minimal-and-owned-surface The two maps and the posing helper motion laws read.
67
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two maps, the posing helper and the tangent offset motion laws read.
58
68
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Keys are the interface's closed unions, not strings.
59
69
  */
60
70
  export declare namespace resolveAutoMovieHumanoidSurfaces {
@@ -68,6 +78,8 @@ export declare namespace resolveAutoMovieHumanoidSurfaces {
68
78
  normal: IAutoMovieVector3;
69
79
  /** A socket's forward unit direction in the bone's rest frame. */
70
80
  forward?: IAutoMovieVector3;
81
+ /** A region's extent, metres: the radius about its point that is still the region (`AutoMovieHumanoidSurfaceExtents`); absent for a socket and for a point beside a region (`offset`). */
82
+ radius?: number;
71
83
  }
72
84
  /** Every region and socket of one body. */
73
85
  interface ISurfaces {
@@ -88,4 +100,72 @@ export declare namespace resolveAutoMovieHumanoidSurfaces {
88
100
  normal: IAutoMovieVector3;
89
101
  forward?: IAutoMovieVector3;
90
102
  };
103
+ /** A point of a region's tangent plane, measured from the region's own point. */
104
+ interface ITangent {
105
+ /** Toward the head, metres: the rest frame's +Y made perpendicular to the region's direction, or +Z when that direction is within 26 degrees of vertical. */
106
+ up: number;
107
+ /** Across `up` and the region's direction, metres: toward the body's left for a region that faces forward. */
108
+ out: number;
109
+ }
110
+ /**
111
+ * Whether a region is placed by a ray, so `offset` accepts it.
112
+ *
113
+ * @param region The region.
114
+ * @returns False for the palms, soles, heels, seat and the digits' tips and pads, which take a socket's point or a phalanx's line.
115
+ */
116
+ function rayed(region: AutoMovieHumanoidRegion): boolean;
117
+ /**
118
+ * A point of a region's surface beside the region's own point.
119
+ *
120
+ * The region's ray leaves its station along its direction and meets the
121
+ * colliders at the region's point. The offset names a point of the plane
122
+ * through that point, perpendicular to the direction. The result is where
123
+ * the ray from the same station through the offset point leaves the
124
+ * colliders, with the colliders' outward normal there, so it lies on the
125
+ * body's surface for any offset and equals the region's frame at zero.
126
+ *
127
+ * @param skeleton The canonical rig.
128
+ * @param profile Its physical profile, segments keyed by rig bones.
129
+ * @param region A region placed by a ray: every region but the palms, soles, heels, seat and the digits' tips and pads.
130
+ * @param tangent The offset on the region's tangent plane.
131
+ * @returns The bone-local frame of the surface point.
132
+ * @throws {Error} When the region is not placed by a ray, or a bone or segment it needs is missing.
133
+ */
134
+ function offset(skeleton: IAutoMovieSkeleton, profile: P, region: AutoMovieHumanoidRegion, tangent: ITangent): IFrame;
135
+ /**
136
+ * The right twin a left region is the mirror of: the same name on the
137
+ * right, and the liver for the spleen; none for a right or median region.
138
+ *
139
+ * @param region The region.
140
+ * @returns Its right twin, when it is a left region.
141
+ */
142
+ function twin(region: AutoMovieHumanoidRegion): AutoMovieHumanoidRegion | undefined;
143
+ /**
144
+ * Whether a region lies on the median plane, its own mirror image: neither
145
+ * sided nor one of the liver and spleen pair.
146
+ *
147
+ * @param region The region.
148
+ * @returns Whether it is median.
149
+ */
150
+ function median(region: AutoMovieHumanoidRegion): boolean;
151
+ /**
152
+ * A median frame on the median plane to the bit: its point's, normal's and
153
+ * forward's lateral components nought, the frame and its mirror image
154
+ * averaged.
155
+ *
156
+ * @param frame The frame.
157
+ * @returns The frame, its own mirror image.
158
+ */
159
+ function centred(frame: IFrame): IFrame;
160
+ /**
161
+ * A frame's mirror image in the median plane: on the other side's bone,
162
+ * its point, normal and forward with their lateral component negated. A
163
+ * rest frame mirrored across the median plane (`M R M`) maps a bone-local
164
+ * vector to the same vector with its lateral component negated, so the
165
+ * mirror is exact.
166
+ *
167
+ * @param frame The frame.
168
+ * @returns Its mirror image.
169
+ */
170
+ function mirrored(frame: IFrame): IFrame;
91
171
  }