@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,110 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ AutoMovieHumanoidRegion,
4
+ IAutoMovieVector3,
5
+ IAutoMoviePhysicalProfile as P,
6
+ } from "@automovie/interface";
7
+
8
+ import { Vector3 } from "../math/Vector3";
9
+ import type { AutoMovieHumanoidSurfaceRays } from "./AutoMovieHumanoidSurfaceRays";
10
+ import type { resolveAutoMovieHumanoidSurfaces } from "./resolveAutoMovieHumanoidSurfaces";
11
+
12
+ /**
13
+ * The tip and the pad of every digit of both hands, as bone-local frames on
14
+ * each digit's distal phalanx.
15
+ *
16
+ * A digit's tip is where a ray from its last joint, along its distal
17
+ * phalanx (the line from the joint before it), leaves the phalanx's
18
+ * colliders, with the exited collider's outward normal: the index fingertip
19
+ * as `resolveAutoMovieHumanoidSurfaces` has always placed it, now for every
20
+ * digit. Its pad is the palmar face of the same phalanx: where a ray from the
21
+ * middle of the phalanx, between the last joint and the tip, leaves the
22
+ * colliders toward the palm's side. The palm faces -Y in the canonical rest
23
+ * (`HUMANOID_REST_FRAME`), so the palmar direction is -Y made perpendicular
24
+ * to the phalanx; the rig's thumb lies in the palm's plane with its nail up,
25
+ * so its pad faces the same side. A profile with no segment for a phalanx
26
+ * reads the hand's colliders instead, as the index tip did.
27
+ *
28
+ * Both sides are resolved; the caller replaces each left frame with its right
29
+ * twin's mirror image, as it does for every region.
30
+ *
31
+ * @param rays The rest-pose readers of the body (`AutoMovieHumanoidSurfaceRays.tools`).
32
+ * @param profile The body's physical profile, segments keyed by rig bones.
33
+ * @returns The tip and pad frames of every digit, keyed by region.
34
+ * @throws {Error} When a digit bone is missing or a ray misses its colliders.
35
+ *
36
+ * @evidence contracts/development/common.md#meaningful-documentation States where each tip and pad lies, the palmar direction's premise, the fallback to the hand's colliders and the frame of the result.
37
+ * @evidence contracts/development/implementation.md#principled-implementation Exact ray exits through the phalanx's convex colliders from anatomical stations (the last joint along the phalanx; the phalanx's middle toward the palm), each normal the exited collider's own, the method every rayed region uses.
38
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over sides and digits writes two frames each, through the caller's own ray readers.
39
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every length is the body's own joints and colliders; the index tip keeps the station, direction and bone it had, so its frame is unchanged.
40
+ * @evidence contracts/development/implementation.md#efficient-algorithms Twenty rays, each linear in one segment's colliders, once per body.
41
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the body; its caller resolves once per body.
42
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns a fresh record and retains nothing.
43
+ */
44
+ export function AutoMovieHumanoidDigitSurfaces(
45
+ rays: Pick<
46
+ ReturnType<typeof AutoMovieHumanoidSurfaceRays.tools>,
47
+ "at" | "local" | "surface"
48
+ >,
49
+ profile: P,
50
+ ): Partial<
51
+ Record<AutoMovieHumanoidRegion, resolveAutoMovieHumanoidSurfaces.IFrame>
52
+ > {
53
+ const out: Partial<
54
+ Record<AutoMovieHumanoidRegion, resolveAutoMovieHumanoidSurfaces.IFrame>
55
+ > = {};
56
+ const down: IAutoMovieVector3 = { x: 0, y: -1, z: 0 };
57
+ for (const Side of ["Left", "Right"] as const) {
58
+ const side: string = Side.toLowerCase();
59
+ for (const digit of DIGITS) {
60
+ const bone = (segment: string): AutoMovieHumanoidBone =>
61
+ `${side}${digit}${segment}` as AutoMovieHumanoidBone;
62
+ const distal: AutoMovieHumanoidBone = bone("Distal");
63
+ const joint: IAutoMovieVector3 = rays.at(distal).worldPosition;
64
+ const along: IAutoMovieVector3 = Vector3.subtract(
65
+ joint,
66
+ rays.at(bone(digit === "Thumb" ? "Proximal" : "Intermediate"))
67
+ .worldPosition,
68
+ );
69
+
70
+ // The phalanx's own colliders, or the hand's when the profile gives
71
+ // the phalanx none.
72
+ const phalanx: AutoMovieHumanoidBone = profile.segments.some(
73
+ (x: P.ISegment): boolean => x.bone === distal,
74
+ )
75
+ ? distal
76
+ : (`${side}Hand` as AutoMovieHumanoidBone);
77
+ const name: string = digit.toLowerCase();
78
+ const tip: AutoMovieHumanoidSurfaceRays.ISurfacePoint = rays.surface(
79
+ phalanx,
80
+ joint,
81
+ along,
82
+ );
83
+ out[`${name}Tip${Side}` as AutoMovieHumanoidRegion] = rays.local(
84
+ distal,
85
+ tip.point,
86
+ tip.normal,
87
+ );
88
+
89
+ // The pad: from the phalanx's middle toward the palm's side.
90
+ const unit: IAutoMovieVector3 = Vector3.normalize(along);
91
+ const palmar: IAutoMovieVector3 = Vector3.normalize(
92
+ Vector3.subtract(down, Vector3.scale(unit, Vector3.dot(down, unit))),
93
+ );
94
+ const pad: AutoMovieHumanoidSurfaceRays.ISurfacePoint = rays.surface(
95
+ phalanx,
96
+ Vector3.lerp(joint, tip.point, 0.5),
97
+ palmar,
98
+ );
99
+ out[`${name}Pad${Side}` as AutoMovieHumanoidRegion] = rays.local(
100
+ distal,
101
+ pad.point,
102
+ pad.normal,
103
+ );
104
+ }
105
+ }
106
+ return out;
107
+ }
108
+
109
+ /** The digits, as their rig bone names spell them. */
110
+ const DIGITS = ["Thumb", "Index", "Middle", "Ring", "Little"] as const;
@@ -0,0 +1,81 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ AutoMovieHumanoidRegion,
4
+ IAutoMovieVector3,
5
+ } from "@automovie/interface";
6
+
7
+ import { Quaternion } from "../math/Quaternion";
8
+ import { Vector3 } from "../math/Vector3";
9
+ import type { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
10
+ import type { resolveAutoMovieHumanoidSurfaces } from "./resolveAutoMovieHumanoidSurfaces";
11
+
12
+ /**
13
+ * The extent of every region of a body: the radius of the disc about the
14
+ * region's point that is still that region, read from the body's own rest
15
+ * pose. A named region of the skin reaches until the next one begins, so
16
+ * its disc reaches half way to the nearest other region that faces the
17
+ * same way (two discs overlap on the surface only where they face it from
18
+ * one side, so a palm and the back of the same hand, a chest and an upper
19
+ * back, are never each other's bound), and no farther than half its
20
+ * segment's least breadth, so the disc stays on the face of the segment it
21
+ * lies on (a forearm's disc does not wrap round to the arm's other side).
22
+ * No region is smaller than the 10 mm a pressed skin gives, the contact
23
+ * tolerance a hand on it is read against.
24
+ *
25
+ * @evidence contracts/development/common.md#meaningful-documentation States what an extent is, the two bounds with their anatomical basis and the floor.
26
+ * @evidence contracts/development/implementation.md#principled-implementation A region is an area of the skin between its neighbours: a disc about its point, bounded by the half distance to the nearest neighbour facing the same way and by its segment's half breadth.
27
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass places every region in the world, a second reads each one's two bounds and the floor.
28
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every length is the body's own: its regions' places and its colliders' bounds; no region is special-cased.
29
+ * @evidence contracts/development/implementation.md#efficient-algorithms Quadratic in the regions, a few dozen per body, resolved once per body.
30
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of the body; its caller resolves once per body.
31
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns a fresh record and retains nothing.
32
+ */
33
+ export function AutoMovieHumanoidSurfaceExtents(
34
+ regions: Readonly<
35
+ Record<AutoMovieHumanoidRegion, resolveAutoMovieHumanoidSurfaces.IFrame>
36
+ >,
37
+ at: (bone: AutoMovieHumanoidBone) => IAutoMovieResolvedBone,
38
+ bounds: (bone: AutoMovieHumanoidBone) => {
39
+ min: IAutoMovieVector3;
40
+ max: IAutoMovieVector3;
41
+ },
42
+ ): Record<AutoMovieHumanoidRegion, number> {
43
+ const placed = Object.entries(regions).map(
44
+ ([name, frame]: [string, resolveAutoMovieHumanoidSurfaces.IFrame]) => {
45
+ const bone: IAutoMovieResolvedBone = at(frame.bone);
46
+ return {
47
+ name: name as AutoMovieHumanoidRegion,
48
+ bone: frame.bone,
49
+ point: Vector3.add(
50
+ bone.worldPosition,
51
+ Quaternion.rotateVector(bone.worldRotation, frame.point),
52
+ ),
53
+ normal: Quaternion.rotateVector(bone.worldRotation, frame.normal),
54
+ };
55
+ },
56
+ );
57
+ const out = {} as Record<AutoMovieHumanoidRegion, number>;
58
+ for (const region of placed) {
59
+ let nearest: number = Infinity;
60
+ for (const other of placed)
61
+ if (
62
+ other.name !== region.name &&
63
+ Vector3.dot(other.normal, region.normal) > 0
64
+ )
65
+ nearest = Math.min(
66
+ nearest,
67
+ Vector3.length(Vector3.subtract(other.point, region.point)),
68
+ );
69
+ const box = bounds(region.bone);
70
+ const breadth: number = Math.min(
71
+ box.max.x - box.min.x,
72
+ box.max.y - box.min.y,
73
+ box.max.z - box.min.z,
74
+ );
75
+ out[region.name] = Math.max(CONTACT, Math.min(nearest / 2, breadth / 2));
76
+ }
77
+ return out;
78
+ }
79
+
80
+ /** The least extent of a region, metres: the 10 mm a pressed skin gives, the tolerance a contact on it is read against. */
81
+ const CONTACT: number = 0.01;
@@ -0,0 +1,286 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ IAutoMovieQuaternion,
4
+ IAutoMovieSkeleton,
5
+ IAutoMovieVector3,
6
+ IAutoMoviePhysicalProfile as P,
7
+ } from "@automovie/interface";
8
+
9
+ import { Quaternion } from "../math/Quaternion";
10
+ import { Vector3 } from "../math/Vector3";
11
+ import { physicalHullFaces } from "../physics/physicalHullFaces";
12
+ import { physicalShapeBounds } from "../physics/physicalShapeBounds";
13
+ import { physicalShapeNormal } from "../physics/physicalShapeNormal";
14
+ import type { AutoMovieHumanoidSurfaceRegions } from "./AutoMovieHumanoidSurfaceRegions";
15
+ import type { IAutoMovieResolvedBone } from "./IAutoMovieResolvedBone";
16
+ import type { resolveAutoMovieHumanoidSurfaces } from "./resolveAutoMovieHumanoidSurfaces";
17
+ import { resolvePose } from "./resolvePose";
18
+
19
+ /**
20
+ * The rest-pose readers a humanoid's surfaces are resolved with
21
+ * (`resolveAutoMovieHumanoidSurfaces`): its bones, segments, collider
22
+ * bounds, bone-local frames, stations, and the exits of rays from them
23
+ * through the colliders with the colliders' outward normal there.
24
+ *
25
+ * @evidence contracts/development/common.md#meaningful-documentation States the readers and their reader.
26
+ * @evidence contracts/development/design.md#principled-representation Exact ray exits through convex colliders and the exited collider's outward normal (`physicalShapeNormal`).
27
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One reader bundle and the exit record.
28
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts A missing bone, segment or hit throws rather than inventing a point.
29
+ */
30
+ export namespace AutoMovieHumanoidSurfaceRays {
31
+ /** The farthest distance along a unit ray at which it is still inside a shape, or -Infinity on a miss. */
32
+ function shapeExit(
33
+ frame: P.ITransform,
34
+ shape: P.IShape,
35
+ origin: IAutoMovieVector3,
36
+ d: IAutoMovieVector3,
37
+ ): number {
38
+ const centre: IAutoMovieVector3 = Vector3.add(
39
+ frame.position,
40
+ Quaternion.rotateVector(frame.rotation, shape.transform.position),
41
+ );
42
+ const rotation: IAutoMovieQuaternion = Quaternion.multiply(
43
+ frame.rotation,
44
+ shape.transform.rotation,
45
+ );
46
+ const sphere = (c: IAutoMovieVector3, r: number): number => {
47
+ const oc: IAutoMovieVector3 = Vector3.subtract(origin, c);
48
+ const b: number = Vector3.dot(oc, d);
49
+ const disc: number = b * b - (Vector3.dot(oc, oc) - r * r);
50
+ return disc < -BOUNDARY * r
51
+ ? -Infinity
52
+ : -b + Math.sqrt(Math.max(0, disc));
53
+ };
54
+ if (shape.kind === "sphere") return sphere(centre, shape.radius);
55
+ if (shape.kind === "capsule") {
56
+ const axis: IAutoMovieVector3 = Quaternion.rotateVector(rotation, {
57
+ x: 0,
58
+ y: 1,
59
+ z: 0,
60
+ });
61
+ const a: IAutoMovieVector3 = Vector3.subtract(
62
+ centre,
63
+ Vector3.scale(axis, shape.halfLength),
64
+ );
65
+ let far: number = Math.max(
66
+ sphere(a, shape.radius),
67
+ sphere(
68
+ Vector3.add(centre, Vector3.scale(axis, shape.halfLength)),
69
+ shape.radius,
70
+ ),
71
+ );
72
+ // The cylinder: the ray's component across the axis meets the radius.
73
+ const oc: IAutoMovieVector3 = Vector3.subtract(origin, a);
74
+ const dp: IAutoMovieVector3 = Vector3.subtract(
75
+ d,
76
+ Vector3.scale(axis, Vector3.dot(d, axis)),
77
+ );
78
+ const op: IAutoMovieVector3 = Vector3.subtract(
79
+ oc,
80
+ Vector3.scale(axis, Vector3.dot(oc, axis)),
81
+ );
82
+ const qa: number = Vector3.dot(dp, dp);
83
+ if (qa > 1e-12) {
84
+ const qb: number = Vector3.dot(op, dp);
85
+ const disc: number =
86
+ qb * qb - qa * (Vector3.dot(op, op) - shape.radius * shape.radius);
87
+ if (disc >= 0) {
88
+ const t: number = (-qb + Math.sqrt(disc)) / qa;
89
+ const along: number = Vector3.dot(
90
+ Vector3.add(oc, Vector3.scale(d, t)),
91
+ axis,
92
+ );
93
+ if (along >= 0 && along <= 2 * shape.halfLength)
94
+ far = Math.max(far, t);
95
+ }
96
+ }
97
+ return far;
98
+ }
99
+ const inverse: IAutoMovieQuaternion = Quaternion.inverse(rotation);
100
+ const o: IAutoMovieVector3 = Quaternion.rotateVector(
101
+ inverse,
102
+ Vector3.subtract(origin, centre),
103
+ );
104
+ const dir: IAutoMovieVector3 = Quaternion.rotateVector(inverse, d);
105
+ let near: number = -Infinity;
106
+ let far: number = Infinity;
107
+ if (shape.kind === "hull") {
108
+ // Clip the ray against every face plane: it enters through the planes
109
+ // it runs against and leaves through the ones it runs with.
110
+ for (const face of physicalHullFaces(shape.points).faces) {
111
+ const speed: number = Vector3.dot(face.normal, dir);
112
+ const height: number = Vector3.dot(face.normal, o) - face.offset;
113
+ if (Math.abs(speed) < 1e-12) {
114
+ if (height > BOUNDARY) return -Infinity;
115
+ continue;
116
+ }
117
+ if (speed < 0) near = Math.max(near, -height / speed);
118
+ else far = Math.min(far, -height / speed);
119
+ }
120
+ return near <= far ? far : -Infinity;
121
+ }
122
+ if (shape.kind !== "box") {
123
+ shape satisfies never;
124
+ throw new Error("Unknown physical shape kind");
125
+ }
126
+ for (const k of ["x", "y", "z"] as const) {
127
+ const h: number = shape.halfExtents[k];
128
+ if (Math.abs(dir[k]) < 1e-12) {
129
+ if (Math.abs(o[k]) > h + BOUNDARY) return -Infinity;
130
+ continue;
131
+ }
132
+ const t1: number = (-h - o[k]) / dir[k];
133
+ const t2: number = (h - o[k]) / dir[k];
134
+ near = Math.max(near, Math.min(t1, t2));
135
+ far = Math.min(far, Math.max(t1, t2));
136
+ }
137
+ return near <= far ? far : -Infinity;
138
+ }
139
+
140
+ /**
141
+ * A point where a ray leaves a segment's colliders, with their outward
142
+ * normal there.
143
+ *
144
+ * @evidence contracts/development/common.md#meaningful-documentation States what the point and the normal are and in which frame.
145
+ * @evidence contracts/development/design.md#principled-representation A surface sample: a world point and the collider's outward unit normal at it.
146
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two members a region frame is built from.
147
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None; the normal is the exited collider's own, not the ray's direction.
148
+ */
149
+ export interface ISurfacePoint {
150
+ /** The point, world metres in the rest pose. */
151
+ point: IAutoMovieVector3;
152
+
153
+ /** The outward unit normal there. */
154
+ normal: IAutoMovieVector3;
155
+ }
156
+
157
+ /**
158
+ * The rest pose readers every surface is resolved with: bones, segments,
159
+ * collider bounds, bone-local frames, stations and ray exits of one body.
160
+ *
161
+ * @evidence contracts/development/common.md#meaningful-documentation Names each reader the record returns and the body it reads.
162
+ * @evidence contracts/development/implementation.md#principled-implementation The rest pose resolved once; bounds are the union of the colliders' exact bounds; a ray's exit is the farthest exit over the segment's convex colliders, its normal that collider's.
163
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Six small closures over one rest pose map.
164
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing bone, segment or hit throws rather than inventing a point.
165
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pose resolution; each read is linear in one segment's colliders.
166
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every reader shares the one resolved rest pose.
167
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The closures retain only the one body's rest pose, released with them.
168
+ */
169
+ export function tools(skeleton: IAutoMovieSkeleton, profile: P) {
170
+ const rest: Map<AutoMovieHumanoidBone, IAutoMovieResolvedBone> = new Map(
171
+ resolvePose(
172
+ { skeleton: skeleton.id, root: null, joints: [] },
173
+ skeleton,
174
+ ).map(
175
+ (
176
+ r: IAutoMovieResolvedBone,
177
+ ): [AutoMovieHumanoidBone, IAutoMovieResolvedBone] => [r.bone, r],
178
+ ),
179
+ );
180
+ const at = (bone: AutoMovieHumanoidBone): IAutoMovieResolvedBone => {
181
+ const r: IAutoMovieResolvedBone | undefined = rest.get(bone);
182
+ if (r === undefined)
183
+ throw new Error(`Surfaces need the rig bone ${bone}`);
184
+ return r;
185
+ };
186
+ const segment = (bone: AutoMovieHumanoidBone): P.ISegment => {
187
+ const s: P.ISegment | undefined = profile.segments.find(
188
+ (x: P.ISegment): boolean => x.bone === bone,
189
+ );
190
+ if (s === undefined)
191
+ throw new Error(`Surfaces need the profile segment ${bone}`);
192
+ return s;
193
+ };
194
+ const bounds = (
195
+ bone: AutoMovieHumanoidBone,
196
+ ): { min: IAutoMovieVector3; max: IAutoMovieVector3 } => {
197
+ const s: P.ISegment = segment(bone);
198
+ const min: IAutoMovieVector3 = { x: Infinity, y: Infinity, z: Infinity };
199
+ const max: IAutoMovieVector3 = {
200
+ x: -Infinity,
201
+ y: -Infinity,
202
+ z: -Infinity,
203
+ };
204
+ for (const shape of s.shapes) {
205
+ const b: { min: IAutoMovieVector3; max: IAutoMovieVector3 } =
206
+ physicalShapeBounds(s.neutral, shape);
207
+ for (const k of ["x", "y", "z"] as const) {
208
+ min[k] = Math.min(min[k], b.min[k]);
209
+ max[k] = Math.max(max[k], b.max[k]);
210
+ }
211
+ }
212
+ return { min, max };
213
+ };
214
+ const local = (
215
+ bone: AutoMovieHumanoidBone,
216
+ world: IAutoMovieVector3,
217
+ direction: IAutoMovieVector3,
218
+ forward?: IAutoMovieVector3,
219
+ ): resolveAutoMovieHumanoidSurfaces.IFrame => {
220
+ const r: IAutoMovieResolvedBone = at(bone);
221
+ const inverse: IAutoMovieQuaternion = Quaternion.inverse(r.worldRotation);
222
+ return {
223
+ bone,
224
+ point: Quaternion.rotateVector(
225
+ inverse,
226
+ Vector3.subtract(world, r.worldPosition),
227
+ ),
228
+ normal: Quaternion.rotateVector(inverse, Vector3.normalize(direction)),
229
+ ...(forward === undefined
230
+ ? {}
231
+ : {
232
+ forward: Quaternion.rotateVector(
233
+ inverse,
234
+ Vector3.normalize(forward),
235
+ ),
236
+ }),
237
+ };
238
+ };
239
+ const station = (
240
+ s: AutoMovieHumanoidSurfaceRegions.IStation,
241
+ ): IAutoMovieVector3 => {
242
+ if (s.toward === "centre") {
243
+ const b = bounds(s.bone);
244
+ return Vector3.scale(Vector3.add(b.min, b.max), 0.5);
245
+ }
246
+ return Vector3.lerp(
247
+ at(s.bone).worldPosition,
248
+ at(s.toward).worldPosition,
249
+ s.share,
250
+ );
251
+ };
252
+ const surface = (
253
+ bone: AutoMovieHumanoidBone,
254
+ origin: IAutoMovieVector3,
255
+ direction: IAutoMovieVector3,
256
+ ): ISurfacePoint => {
257
+ const d: IAutoMovieVector3 = Vector3.normalize(direction);
258
+ const s: P.ISegment = segment(bone);
259
+ let far: number = -Infinity;
260
+ let left: P.IShape | undefined;
261
+ for (const shape of s.shapes) {
262
+ const t: number = shapeExit(s.neutral, shape, origin, d);
263
+ if (t > far) {
264
+ far = t;
265
+ left = shape;
266
+ }
267
+ }
268
+ if (!(far > -Infinity) || left === undefined)
269
+ throw new Error(`A surface ray from ${bone} misses its colliders`);
270
+ const point: IAutoMovieVector3 = Vector3.add(
271
+ origin,
272
+ Vector3.scale(d, far),
273
+ );
274
+ return { point, normal: physicalShapeNormal(s.neutral, left, point, d) };
275
+ };
276
+ const exit = (
277
+ bone: AutoMovieHumanoidBone,
278
+ origin: IAutoMovieVector3,
279
+ direction: IAutoMovieVector3,
280
+ ): IAutoMovieVector3 => surface(bone, origin, direction).point;
281
+ return { at, bounds, local, station, exit, surface };
282
+ }
283
+ }
284
+
285
+ /** Metres a station may sit outside a collider and still count as on it: the colliders are closed sets, so a station on a face or a cap must not miss by rounding. */
286
+ const BOUNDARY: number = 1e-9;
@@ -0,0 +1,189 @@
1
+ import type {
2
+ AutoMovieHumanoidBone,
3
+ AutoMovieHumanoidRegion,
4
+ IAutoMovieVector3,
5
+ } from "@automovie/interface";
6
+
7
+ /**
8
+ * The definitions of the anatomical regions a humanoid's surfaces resolve
9
+ * (`resolveAutoMovieHumanoidSurfaces`): each region's station on a bone's
10
+ * segment and its outward direction in the rest frame, the ray that finds
11
+ * its point on the colliders.
12
+ *
13
+ * @evidence contracts/development/common.md#meaningful-documentation States what the table holds and who reads it.
14
+ * @evidence contracts/development/design.md#principled-representation A station (a bone, a joint it leans toward, a share) and a direction per region, both sides from one table.
15
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The station and definition records and the table the resolver reads.
16
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Keys are the interface's closed region union.
17
+ */
18
+ export namespace AutoMovieHumanoidSurfaceRegions {
19
+ /**
20
+ * Where on a segment a region's ray starts: a share of the way from a
21
+ * bone's joint toward a child joint, or the centre of the bone's collider
22
+ * bounds.
23
+ *
24
+ * @evidence contracts/development/common.md#meaningful-documentation States the two forms a station takes.
25
+ * @evidence contracts/development/design.md#principled-representation A bone, the joint it leans toward or the bounds centre, and a share.
26
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The three members the surface resolver reads.
27
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Bones are the interface's closed bone union.
28
+ */
29
+ export interface IStation {
30
+ /** The bone. */
31
+ bone: AutoMovieHumanoidBone;
32
+
33
+ /** A child joint to interpolate toward, or the colliders' bounds centre. */
34
+ toward: AutoMovieHumanoidBone | "centre";
35
+
36
+ /** Share of the way toward the child joint. */
37
+ share: number;
38
+ }
39
+
40
+ /**
41
+ * A region's station and rest-frame outward direction: the ray whose exit
42
+ * through the segment's colliders is the region's point.
43
+ *
44
+ * @evidence contracts/development/common.md#meaningful-documentation States what the pair defines.
45
+ * @evidence contracts/development/design.md#principled-representation A ray: an origin on the segment and a direction in the rest frame.
46
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two members a region needs.
47
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None; the point itself is read from the colliders, never stored.
48
+ */
49
+ export interface IDefinition {
50
+ /** Ray origin. */
51
+ station: IStation;
52
+
53
+ /** Outward direction in the T-pose rest frame. */
54
+ direction: IAutoMovieVector3;
55
+ }
56
+
57
+ /** Every region's definition, both sides from one table: +X is the body's left. */
58
+ export const TABLE: Readonly<
59
+ Partial<Record<AutoMovieHumanoidRegion, IDefinition>>
60
+ > = (() => {
61
+ const v = (x: number, y: number, z: number): IAutoMovieVector3 => ({
62
+ x,
63
+ y,
64
+ z,
65
+ });
66
+ const head: IStation = { bone: "head", toward: "centre", share: 0 };
67
+ const neck: IStation = { bone: "neck", toward: "head", share: 0.5 };
68
+ const chest = (share: number): IStation => ({
69
+ bone: "chest",
70
+ toward: "neck",
71
+ share,
72
+ });
73
+ const spine = (share: number): IStation => ({
74
+ bone: "spine",
75
+ toward: "chest",
76
+ share,
77
+ });
78
+ const table: Partial<Record<AutoMovieHumanoidRegion, IDefinition>> = {
79
+ crown: { station: head, direction: v(0, 1, 0) },
80
+ forehead: { station: head, direction: v(0, 0.45, 1) },
81
+ face: { station: head, direction: v(0, 0, 1) },
82
+ noseBridge: { station: head, direction: v(0, 0.1, 1) },
83
+ nose: { station: head, direction: v(0, -0.15, 1) },
84
+ mouth: { station: head, direction: v(0, -0.4, 1) },
85
+ chin: { station: head, direction: v(0, -0.75, 0.65) },
86
+ headBack: { station: head, direction: v(0, 0, -1) },
87
+ throat: { station: neck, direction: v(0, 0, 1) },
88
+ nape: { station: neck, direction: v(0, 0, -1) },
89
+ sternum: { station: chest(0.5), direction: v(0, 0, 1) },
90
+ solarPlexus: { station: chest(0), direction: v(0, 0, 1) },
91
+ liver: { station: chest(0.1), direction: v(-0.8, 0, 0.6) },
92
+ spleen: { station: chest(0.1), direction: v(0.8, 0, 0.6) },
93
+ upperBack: { station: chest(0.5), direction: v(0, 0, -1) },
94
+ abdomen: { station: spine(0.4), direction: v(0, 0, 1) },
95
+ lowerBack: { station: spine(0.4), direction: v(0, 0, -1) },
96
+ groin: {
97
+ station: { bone: "hips", toward: "centre", share: 0 },
98
+ direction: v(0, -0.6, 0.8),
99
+ },
100
+ };
101
+ for (const [Side, x] of [
102
+ ["Left", 1],
103
+ ["Right", -1],
104
+ ] as const) {
105
+ const s = (name: string): AutoMovieHumanoidBone =>
106
+ `${Side.toLowerCase()}${name}` as AutoMovieHumanoidBone;
107
+ const set = (name: string, def: IDefinition): void => {
108
+ table[`${name}${Side}` as AutoMovieHumanoidRegion] = def;
109
+ };
110
+ set("jaw", { station: head, direction: v(0.7 * x, -0.55, 0.45) });
111
+ // The cheek: the zygomatic prominence over the buccal area, at the
112
+ // nose's height (its ray's -0.15) and 40 degrees out from the face's
113
+ // forward ray, tan 40 = 0.84 (provisional).
114
+ set("cheek", { station: head, direction: v(0.84 * x, -0.15, 1) });
115
+ set("temple", { station: head, direction: v(x, 0.25, 0.3) });
116
+ set("ear", { station: head, direction: v(x, 0, 0) });
117
+ set("neck", { station: neck, direction: v(x, 0, 0) });
118
+ set("chest", { station: chest(0.55), direction: v(0.45 * x, 0, 1) });
119
+ set("ribs", { station: chest(0.25), direction: v(x, 0, 0.15) });
120
+ set("kidney", { station: spine(0.8), direction: v(0.6 * x, 0, -0.8) });
121
+ set("hip", {
122
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0 },
123
+ direction: v(x, 0, 0),
124
+ });
125
+ // The top of the shoulder over the acromion, on the thorax's collider
126
+ // at nine tenths of the way from the chest's joint to the shoulder's,
127
+ // facing up and a little out along the trapezius' slope
128
+ // (provisional). It rode the upper arm's capsule before; with the arm
129
+ // hanging, that point and its normal turned to the arm's outer side.
130
+ set("shoulder", {
131
+ station: { bone: "chest", toward: s("UpperArm"), share: 0.9 },
132
+ direction: v(0.3 * x, 1, 0),
133
+ });
134
+ set("upperArm", {
135
+ station: { bone: s("UpperArm"), toward: s("LowerArm"), share: 0.5 },
136
+ direction: v(0, 1, 0),
137
+ });
138
+ set("elbow", {
139
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0 },
140
+ direction: v(0, 0, -1),
141
+ });
142
+ set("forearm", {
143
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0.5 },
144
+ direction: v(0, 1, 0),
145
+ });
146
+ set("wrist", {
147
+ station: { bone: s("LowerArm"), toward: s("Hand"), share: 0.95 },
148
+ direction: v(0, 1, 0),
149
+ });
150
+ set("pocketFront", {
151
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.15 },
152
+ direction: v(0.35 * x, 0, 1),
153
+ });
154
+ set("handBack", {
155
+ station: { bone: s("Hand"), toward: s("MiddleProximal"), share: 0.5 },
156
+ direction: v(0, 1, 0),
157
+ });
158
+ set("thighFront", {
159
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
160
+ direction: v(0, 0, 1),
161
+ });
162
+ set("thighOuter", {
163
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
164
+ direction: v(x, 0, 0),
165
+ });
166
+ set("thighInner", {
167
+ station: { bone: s("UpperLeg"), toward: s("LowerLeg"), share: 0.5 },
168
+ direction: v(-x, 0, 0),
169
+ });
170
+ set("knee", {
171
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0 },
172
+ direction: v(0, 0, 1),
173
+ });
174
+ set("shin", {
175
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0.5 },
176
+ direction: v(0, 0, 1),
177
+ });
178
+ set("calf", {
179
+ station: { bone: s("LowerLeg"), toward: s("Foot"), share: 0.35 },
180
+ direction: v(0, 0, -1),
181
+ });
182
+ set("footTop", {
183
+ station: { bone: s("Foot"), toward: s("Toes"), share: 0.5 },
184
+ direction: v(0, 1, 0),
185
+ });
186
+ }
187
+ return table;
188
+ })();
189
+ }