@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
@@ -1,24 +1,34 @@
1
1
  import {
2
+ IAutoMovieSoftAnchor,
2
3
  IAutoMovieSoftBodyDomain,
3
4
  IAutoMovieSoftBodyState,
5
+ IAutoMovieSoftCompliance,
6
+ IAutoMovieSoftContact,
4
7
  IAutoMovieSoftWind,
5
8
  IAutoMovieVector3,
6
9
  } from "@automovie/interface";
7
10
 
8
11
  import { IAutoMovieSoftBodyBoundarySample } from "./IAutoMovieSoftBodyBoundarySample";
12
+ import { IAutoMovieSoftBodyObserver } from "./IAutoMovieSoftBodyObserver";
9
13
  import { IAutoMovieSoftBodyResolvedAnchor } from "./IAutoMovieSoftBodyResolvedAnchor";
10
14
  import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
15
+ import { applySoftBodyFriction } from "./applySoftBodyFriction";
11
16
  import { gatherSoftBodyCorrections } from "./gatherSoftBodyCorrections";
12
17
  import { projectSoftBodyContacts } from "./projectSoftBodyContacts";
18
+ import { projectSoftCordSelfContact } from "./projectSoftCordSelfContact";
19
+ import { softBodyHeldLoads } from "./softBodyHeldLoads";
13
20
  import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
14
21
  import { softBodyParticleDistance } from "./softBodyParticleDistance";
15
22
  import { softBodyRestBuffer } from "./softBodyRestBuffer";
23
+ import { solveSoftBodyCompliantSweep } from "./solveSoftBodyCompliantSweep";
16
24
 
17
25
  /** Integrate an admitted cloth lattice from its authored rest boundary to one absolute fixed step.
18
26
  *
19
- * @evidence contracts/development/implementation.md#principled-implementation Damped prediction, ordered simultaneous Jacobi constraint gathers and discrete collider escape form the existing position-based scheme. Anchors have zero inverse mass and prescribed targets; domain admission and complete moving samples are caller premises. Nonfinite integrated arrays throw, without proving universal stability or collision freedom.
27
+ * Without declared compliance and contact the solve is the plain position-based one, operation for operation. With compliance, each sweep projects the lattice's edges as compliant constraints with their own multipliers (`solveSoftBodyCompliantSweep`); with contact, a collider's push is followed by Coulomb friction (`applySoftBodyFriction`) and a cord that asks for self-collision keeps its segments apart after each sweep (`projectSoftCordSelfContact`). A moving anchor a boundary sample lists as released regains its mass for that step, leaving with the velocity its target last moved at. An observer reads every completed step, with the force each held particle bears when the solve is compliant.
28
+ *
29
+ * @evidence contracts/development/implementation.md#principled-implementation Damped prediction, ordered simultaneous Jacobi constraint gathers or XPBD Gauss-Seidel sweeps (Macklin, Müller and Chentanez 2016), discrete collider escape with optional position-based friction (Macklin et al. 2014) and cord self-contact form the scheme. Anchors have zero inverse mass and prescribed targets while held; domain admission and complete moving samples are caller premises. Nonfinite integrated arrays throw, without proving universal stability or collision freedom.
20
30
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Static and moving-boundary public wrappers delegate to one core, sharing rest-target setup, lattice topology, fold ordering and contact geometry without changing their admission APIs.
21
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every seek replays the fixed clock from rest; no fixture state, adaptive timestep, concealed self-collision pass or substituted moving target changes the declared trajectory.
31
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Every seek replays the fixed clock from rest; no fixture state, adaptive timestep, undeclared self-collision pass or substituted moving target changes the declared trajectory. Self-contact and friction run only when the domain declares contact.
22
32
  * @evidence contracts/development/common.md#meaningful-documentation States absolute replay, caller admission, fixed-order stages and nonfinite failure rather than claiming every admitted large arithmetic input is safe.
23
33
  * @evidence contracts/development/implementation.md#efficient-algorithms For P particles, I sweeps, K target steps, C colliders, B moving capsules and A anchors, setup is O(P+A+S+T) for S states and T selected targets, each step is O(P*I+P*(C+B)+P*A) in the moving-anchor find path, with O(P) working arrays plus supplied boundary storage.
24
34
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Rest lengths, valences, inverse masses and static targets are built once and reused across all steps/sweeps in this solve; changing domains, states or complete boundary sequences starts a new replay, without cross-call cache equivalence.
@@ -29,11 +39,13 @@ export const simulateSoftBodyCore: (
29
39
  step: number,
30
40
  state: string | null,
31
41
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null,
42
+ observer?: IAutoMovieSoftBodyObserver | null,
32
43
  ) => IAutoMovieSoftBodyState = (
33
44
  domain: IAutoMovieSoftBodyDomain,
34
45
  step: number,
35
46
  state: string | null,
36
47
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[] | null,
48
+ observer: IAutoMovieSoftBodyObserver | null = null,
37
49
  ): IAutoMovieSoftBodyState => {
38
50
  if (!Number.isInteger(step) || step < 0)
39
51
  throw new Error(
@@ -97,6 +109,36 @@ export const simulateSoftBodyCore: (
97
109
  }
98
110
  }
99
111
 
112
+ // The compliant solve (XPBD) when the domain declares compliance, with one
113
+ // multiplier per particle and neighbour slot, reset at every step; the
114
+ // plain weighted sweeps otherwise, unchanged.
115
+ const declared: IAutoMovieSoftCompliance | null =
116
+ domain.solver.compliance ?? null;
117
+ const compliance: readonly number[] | null =
118
+ declared === null
119
+ ? null
120
+ : [declared.structural, declared.shear, declared.bend];
121
+ const lambda: Float64Array<ArrayBuffer> | null =
122
+ compliance === null
123
+ ? null
124
+ : new Float64Array(count * SOFT_BODY_NEIGHBOURS.length);
125
+ const contact: IAutoMovieSoftContact | null = domain.contact ?? null;
126
+ const friction: number = contact?.friction ?? 0;
127
+ const cord: boolean =
128
+ contact !== null && domain.selfCollision && (columns === 1 || rows === 1);
129
+ const before: [number, number, number] = [0, 0, 0];
130
+
131
+ // A moving anchor a boundary releases regains its mass and leaves with
132
+ // the velocity its target last moved at, so a dropped corner keeps the
133
+ // hand's motion instead of starting from rest.
134
+ const moving: number[] = domain.anchors
135
+ .filter(
136
+ (anchor: IAutoMovieSoftAnchor): boolean => anchor.binding !== undefined,
137
+ )
138
+ .map((anchor: IAutoMovieSoftAnchor): number => anchor.particle);
139
+ const carried: Float64Array<ArrayBuffer> = new Float64Array(count * 3);
140
+ const free: Uint8Array<ArrayBuffer> = new Uint8Array(count);
141
+
100
142
  const gravity: IAutoMovieVector3 = domain.solver.gravity;
101
143
  const draught: IAutoMovieVector3 = windAxis(domain);
102
144
  let contacts: number = 0;
@@ -104,7 +146,24 @@ export const simulateSoftBodyCore: (
104
146
  for (let index: number = 0; index < step; ++index) {
105
147
  const boundary: IAutoMovieSoftBodyBoundarySample | null =
106
148
  boundaries?.[index + 1] ?? null;
107
- if (boundary !== null) applyResolvedAnchors(position, boundary.anchors);
149
+ if (boundary !== null) {
150
+ for (const anchor of boundary.anchors) {
151
+ const base: number = anchor.particle * 3;
152
+ carried[base] = (anchor.position.x - position[base]) / dt;
153
+ carried[base + 1] = (anchor.position.y - position[base + 1]) / dt;
154
+ carried[base + 2] = (anchor.position.z - position[base + 2]) / dt;
155
+ }
156
+ applyResolvedAnchors(position, boundary.anchors);
157
+ const released: ReadonlySet<number> = new Set(boundary.released ?? []);
158
+ for (const particle of moving) {
159
+ const now: number = released.has(particle) ? 1 : 0;
160
+ if (now === 1 && free[particle] === 0)
161
+ for (let axis: number = 0; axis < 3; ++axis)
162
+ velocity[particle * 3 + axis] = carried[particle * 3 + axis];
163
+ free[particle] = now;
164
+ inverseMass[particle] = now === 1 ? 1 / domain.mass[particle] : 0;
165
+ }
166
+ }
108
167
  const gust: number = windAcceleration(domain, index * dt);
109
168
  contacts = 0;
110
169
 
@@ -132,23 +191,49 @@ export const simulateSoftBodyCore: (
132
191
  predicted[base + 2] = position[base + 2] + velocity[base + 2] * dt;
133
192
  }
134
193
 
194
+ if (lambda !== null) lambda.fill(0);
135
195
  for (let sweep: number = 0; sweep < domain.solver.iterations; ++sweep) {
136
- gatherSoftBodyCorrections({
137
- columns,
138
- rows,
139
- predicted,
140
- correction,
141
- inverseMass,
142
- valence,
143
- restLength,
144
- stiffness,
145
- });
146
- for (let value: number = 0; value < predicted.length; ++value)
147
- predicted[value] += correction[value];
196
+ if (lambda !== null)
197
+ solveSoftBodyCompliantSweep({
198
+ columns,
199
+ rows,
200
+ predicted,
201
+ inverseMass,
202
+ restLength,
203
+ compliance: compliance!,
204
+ lambda,
205
+ dt,
206
+ });
207
+ else {
208
+ gatherSoftBodyCorrections({
209
+ columns,
210
+ rows,
211
+ predicted,
212
+ correction,
213
+ inverseMass,
214
+ valence,
215
+ restLength,
216
+ stiffness,
217
+ });
218
+ for (let value: number = 0; value < predicted.length; ++value)
219
+ predicted[value] += correction[value];
220
+ }
221
+ if (cord)
222
+ projectSoftCordSelfContact({
223
+ count,
224
+ position,
225
+ predicted,
226
+ inverseMass,
227
+ radius: contact!.thickness,
228
+ friction,
229
+ });
148
230
  }
149
231
 
150
232
  for (let particle: number = 0; particle < count; ++particle) {
151
233
  if (inverseMass[particle] === 0) continue;
234
+ before[0] = predicted[particle * 3];
235
+ before[1] = predicted[particle * 3 + 1];
236
+ before[2] = predicted[particle * 3 + 2];
152
237
  contacts = projectSoftBodyContacts(
153
238
  domain.colliders,
154
239
  boundary?.capsules ?? null,
@@ -156,6 +241,14 @@ export const simulateSoftBodyCore: (
156
241
  particle,
157
242
  contacts,
158
243
  );
244
+ if (friction > 0)
245
+ applySoftBodyFriction({
246
+ particle,
247
+ position,
248
+ predicted,
249
+ before,
250
+ friction,
251
+ });
159
252
  }
160
253
 
161
254
  for (let particle: number = 0; particle < count; ++particle) {
@@ -181,6 +274,22 @@ export const simulateSoftBodyCore: (
181
274
  throw new Error(
182
275
  `soft body "${domain.id}" produced a non-finite state at step ${index + 1}`,
183
276
  );
277
+ observer?.step(
278
+ index + 1,
279
+ position,
280
+ velocity,
281
+ lambda === null
282
+ ? EMPTY
283
+ : softBodyHeldLoads({
284
+ columns,
285
+ rows,
286
+ position,
287
+ inverseMass,
288
+ restLength,
289
+ lambda,
290
+ dt,
291
+ }),
292
+ );
184
293
  }
185
294
 
186
295
  let maxSpeed: number = 0;
@@ -232,6 +341,9 @@ export const simulateSoftBodyCore: (
232
341
  };
233
342
  };
234
343
 
344
+ /** The loads of a solve with no multipliers to read them from. */
345
+ const EMPTY: ReadonlyMap<number, IAutoMovieVector3> = new Map();
346
+
235
347
  /** Overwrite each resolved hard target in the working position buffer, leaving unrelated particles untouched. */
236
348
  const applyResolvedAnchors: (
237
349
  position: Float64Array<ArrayBufferLike>,
@@ -7,9 +7,10 @@ import {
7
7
  } from "@automovie/interface";
8
8
 
9
9
  import { IAutoMovieSoftBodyBoundarySample } from "./IAutoMovieSoftBodyBoundarySample";
10
+ import { IAutoMovieSoftBodyObserver } from "./IAutoMovieSoftBodyObserver";
10
11
  import { simulateSoftBodyCore } from "./simulateSoftBodyCore";
11
12
 
12
- /** Replay cloth against a complete resolved moving boundary for every absolute step from zero through the target. Static colliders remain active. This public API currently reaches portable tests through the wearable resolver; no production/viewer host wires that live solver.
13
+ /** Replay cloth against a complete resolved moving boundary for every absolute step from zero through the target. Static colliders remain active. Each sample holds every authored moving anchor or releases it; an observer reads every completed step. This public API currently reaches portable tests through the wearable resolver; no production/viewer host wires that live solver.
13
14
  *
14
15
  * @evidence contracts/development/implementation.md#principled-implementation Every boundary step, moving-anchor particle and body-capsule id must cover its authored counterpart exactly, with finite target vectors and positive finite radii, before the shared fixed-clock core runs. Core domain validity remains a separate caller premise.
15
16
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Boundary completeness is checked once before integration, while one shared core owns both static and moving trajectories and their numeric ordering.
@@ -24,11 +25,13 @@ export const simulateSoftBodyWithBoundaries: (
24
25
  step: number,
25
26
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[],
26
27
  state?: string | null,
28
+ observer?: IAutoMovieSoftBodyObserver | null,
27
29
  ) => IAutoMovieSoftBodyState = (
28
30
  domain: IAutoMovieSoftBodyDomain,
29
31
  step: number,
30
32
  boundaries: readonly IAutoMovieSoftBodyBoundarySample[],
31
33
  state: string | null = null,
34
+ observer: IAutoMovieSoftBodyObserver | null = null,
32
35
  ): IAutoMovieSoftBodyState => {
33
36
  if (boundaries.length !== step + 1)
34
37
  throw new Error(
@@ -80,6 +83,17 @@ export const simulateSoftBodyWithBoundaries: (
80
83
  particles.add(anchor.particle);
81
84
  assertVector(anchor.position, `moving boundary[${index}] anchor`);
82
85
  }
86
+ for (const particle of boundary.released ?? []) {
87
+ if (!movingAnchorParticles.has(particle))
88
+ throw new Error(
89
+ `soft body "${domain.id}" moving boundary[${index}] releases particle ${particle}, which is not an authored moving anchor`,
90
+ );
91
+ if (particles.has(particle))
92
+ throw new Error(
93
+ `soft body "${domain.id}" moving boundary[${index}] both holds and releases particle ${particle}`,
94
+ );
95
+ particles.add(particle);
96
+ }
83
97
  for (const particle of movingAnchorParticles)
84
98
  if (!particles.has(particle))
85
99
  throw new Error(
@@ -113,7 +127,7 @@ export const simulateSoftBodyWithBoundaries: (
113
127
  `soft body "${domain.id}" moving boundary[${index}] is missing authored body capsule "${id}"`,
114
128
  );
115
129
  }
116
- return simulateSoftBodyCore(domain, step, state, boundaries);
130
+ return simulateSoftBodyCore(domain, step, state, boundaries, observer);
117
131
  };
118
132
 
119
133
  /** Refuse a nonfinite resolved moving-boundary vector. */
@@ -32,6 +32,15 @@ export const softBodyBudget: (
32
32
  const structural: number = span(columns, 1) * rows + columns * span(rows, 1);
33
33
  const shear: number = 2 * quads;
34
34
  const bend: number = span(columns, 2) * rows + columns * span(rows, 2);
35
+
36
+ // A cord's self-contact pairs every two segments that share no particle.
37
+ const segments: number = particles - 1;
38
+ const selfContact: boolean =
39
+ (domain.contact ?? null) !== null &&
40
+ domain.selfCollision &&
41
+ (columns === 1 || rows === 1);
42
+ const pairs: number =
43
+ selfContact && segments > 2 ? ((segments - 1) * (segments - 2)) / 2 : 0;
35
44
  return {
36
45
  domain: domain.id,
37
46
  particles,
@@ -47,6 +56,8 @@ export const softBodyBudget: (
47
56
  (structural + shear + bend) *
48
57
  domain.solver.iterations *
49
58
  domain.solver.maxSteps,
59
+ worstCaseSelfContactPairs:
60
+ pairs * domain.solver.iterations * domain.solver.maxSteps,
50
61
  travel: softBodyTravelNumber(domain),
51
62
  };
52
63
  };
@@ -0,0 +1,85 @@
1
+ import { IAutoMovieVector3 } from "@automovie/interface";
2
+
3
+ import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
4
+ import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
5
+
6
+ /**
7
+ * The force each held particle (an anchor, of zero inverse mass) bears from
8
+ * the compliant constraints that tie it to the rest of the lattice, at the
9
+ * end of a step: the pull a hand holding a cord's end feels.
10
+ *
11
+ * In XPBD a constraint's force is its gradient times its multiplier over the
12
+ * step squared (Macklin, Müller and Chentanez 2016, MIG 2016, equation 9's
13
+ * relation f = grad C^T lambda / dt^2). For an edge from particle i to k
14
+ * with unit direction n from k to i, the force on k is -lambda n / dt^2; a
15
+ * stretched edge has a negative multiplier, so the force points from the
16
+ * held particle into the body that hangs from it. The direction is read at
17
+ * the step's final positions, where the last sweep left the edge.
18
+ *
19
+ * @param props The lattice, the step's positions, the inverse masses, the rest lengths, the multipliers and the step.
20
+ * @returns The force on every held particle that a constraint pulls, newtons, world frame, by particle.
21
+ *
22
+ * @evidence contracts/development/common.md#meaningful-documentation States the relation with its source, the sign and where the direction is read.
23
+ * @evidence contracts/development/implementation.md#principled-implementation XPBD's constraint force from its multiplier.
24
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the edges that touch a held particle.
25
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An edge between two held particles carries no load onto the body and is skipped; a collapsed edge has no direction and is skipped.
26
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in particles times the twelve-slot stencil.
27
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Read once per step from that step's multipliers.
28
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Returns a fresh map of at most one entry per held particle.
29
+ */
30
+ export const softBodyHeldLoads: (props: {
31
+ columns: number;
32
+ rows: number;
33
+ position: Float64Array<ArrayBufferLike>;
34
+ inverseMass: Float64Array<ArrayBufferLike>;
35
+ restLength: Float64Array<ArrayBufferLike>;
36
+ lambda: Float64Array<ArrayBufferLike>;
37
+ dt: number;
38
+ }) => ReadonlyMap<number, IAutoMovieVector3> = (props: {
39
+ columns: number;
40
+ rows: number;
41
+ position: Float64Array<ArrayBufferLike>;
42
+ inverseMass: Float64Array<ArrayBufferLike>;
43
+ restLength: Float64Array<ArrayBufferLike>;
44
+ lambda: Float64Array<ArrayBufferLike>;
45
+ dt: number;
46
+ }): ReadonlyMap<number, IAutoMovieVector3> => {
47
+ const { columns, rows, position, inverseMass }: typeof props = props;
48
+ const slots: number = SOFT_BODY_NEIGHBOURS.length;
49
+ const scale: number = 1 / (props.dt * props.dt);
50
+ const out: Map<number, IAutoMovieVector3> = new Map();
51
+ const add = (particle: number, x: number, y: number, z: number): void => {
52
+ const was: IAutoMovieVector3 = out.get(particle) ?? { x: 0, y: 0, z: 0 };
53
+ out.set(particle, { x: was.x + x, y: was.y + y, z: was.z + z });
54
+ };
55
+ for (let row: number = 0; row < rows; ++row)
56
+ for (let column: number = 0; column < columns; ++column) {
57
+ const particle: number = row * columns + column;
58
+ for (let at: number = 0; at < slots; ++at) {
59
+ if (props.restLength[particle * slots + at] < 0) continue;
60
+ const other: number = softBodyNeighbourOf(
61
+ columns,
62
+ rows,
63
+ column,
64
+ row,
65
+ at,
66
+ );
67
+ if (other < particle) continue;
68
+ const heldI: boolean = inverseMass[particle] === 0;
69
+ const heldK: boolean = inverseMass[other] === 0;
70
+ if (heldI === heldK) continue;
71
+ const dx: number = position[particle * 3] - position[other * 3];
72
+ const dy: number = position[particle * 3 + 1] - position[other * 3 + 1];
73
+ const dz: number = position[particle * 3 + 2] - position[other * 3 + 2];
74
+ const length: number = Math.sqrt(dx * dx + dy * dy + dz * dz);
75
+ if (length === 0) continue;
76
+ const f: number =
77
+ (props.lambda[particle * slots + at] * scale) / length;
78
+
79
+ // On i the force is +lambda n / dt^2, on k it is -lambda n / dt^2.
80
+ if (heldI) add(particle, f * dx, f * dy, f * dz);
81
+ else add(other, -f * dx, -f * dy, -f * dz);
82
+ }
83
+ }
84
+ return out;
85
+ };
@@ -0,0 +1,107 @@
1
+ import { SOFT_BODY_NEIGHBOURS } from "./SOFT_BODY_NEIGHBOURS";
2
+ import { softBodyNeighbourOf } from "./softBodyNeighbourOf";
3
+
4
+ /**
5
+ * Run one sweep of compliant distance constraints over a lattice, in place:
6
+ * every edge of the lattice, its row and column neighbours, its diagonals
7
+ * and its second neighbours, projected one after another with its Lagrange
8
+ * multiplier, the extended position-based dynamics of Macklin, Müller and
9
+ * Chentanez 2016 ("XPBD: position-based simulation of compliant constrained
10
+ * dynamics", MIG 2016, pp. 49-54, equations 18 and 17).
11
+ *
12
+ * For an edge between particles i and k with rest length l, the constraint
13
+ * is C = |x_i - x_k| - l, its gradient the unit direction n from k to i, and
14
+ * the time-scaled compliance alpha~ = alpha / dt^2 with alpha the family's
15
+ * compliance in metres per newton. The multiplier's increment is
16
+ * dlambda = (-C - alpha~ lambda) / (w_i + w_k + alpha~), and the particles
17
+ * move by w_i dlambda n and -w_k dlambda n, w the inverse masses. Unlike the
18
+ * relaxation weight of the plain position-based solver, the stiffness this
19
+ * gives does not depend on the sweep count or the step (the paper's section
20
+ * 4), so a cord's stretch and bend are the same at 4 and at 16 sweeps. A
21
+ * compliance of zero is an inextensible edge. On a cord, a one-wide
22
+ * lattice, the second neighbours are its bending constraint in distance form:
23
+ * the distance between the ends of two consecutive segments, which is
24
+ * regular at a straight rest where the angle between the segments is not
25
+ * differentiable.
26
+ *
27
+ * Edges are visited in a fixed order (row-major particles, each with the
28
+ * neighbours that follow it in `SOFT_BODY_NEIGHBOURS`), so a solve is
29
+ * deterministic. `lambda` holds one multiplier per particle and neighbour
30
+ * slot and is reset by the caller at the start of each step.
31
+ *
32
+ * @param props The lattice, the working buffers and the step.
33
+ *
34
+ * @evidence contracts/development/common.md#meaningful-documentation States the constraint, its gradient, the multiplier update with its source equations, the units of compliance, the bending form and the order.
35
+ * @evidence contracts/development/implementation.md#principled-implementation XPBD's Gauss-Seidel update of each distance constraint with its own multiplier (Macklin, Müller and Chentanez 2016).
36
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over edges in a fixed order sharing the lattice's neighbour table.
37
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A collapsed edge (zero current length) has no direction and is skipped, as the plain solver skips it; an edge between two anchors moves nothing.
38
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in particles times the twelve-slot stencil, with no allocation.
39
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Each sweep reads the positions the last one left; nothing is cached.
40
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Writes only the caller's predicted and multiplier buffers.
41
+ */
42
+ export const solveSoftBodyCompliantSweep: (props: {
43
+ columns: number;
44
+ rows: number;
45
+ predicted: Float64Array<ArrayBufferLike>;
46
+ inverseMass: Float64Array<ArrayBufferLike>;
47
+ restLength: Float64Array<ArrayBufferLike>;
48
+ compliance: readonly number[];
49
+ lambda: Float64Array<ArrayBufferLike>;
50
+ dt: number;
51
+ }) => void = (props: {
52
+ columns: number;
53
+ rows: number;
54
+ predicted: Float64Array<ArrayBufferLike>;
55
+ inverseMass: Float64Array<ArrayBufferLike>;
56
+ restLength: Float64Array<ArrayBufferLike>;
57
+ compliance: readonly number[];
58
+ lambda: Float64Array<ArrayBufferLike>;
59
+ dt: number;
60
+ }): void => {
61
+ const { columns, rows, predicted, inverseMass, lambda }: typeof props = props;
62
+ const slots: number = SOFT_BODY_NEIGHBOURS.length;
63
+ const scale: number = 1 / (props.dt * props.dt);
64
+ for (let row: number = 0; row < rows; ++row)
65
+ for (let column: number = 0; column < columns; ++column) {
66
+ const particle: number = row * columns + column;
67
+ for (let at: number = 0; at < slots; ++at) {
68
+ const rest: number = props.restLength[particle * slots + at];
69
+ if (rest < 0) continue;
70
+ const other: number = softBodyNeighbourOf(
71
+ columns,
72
+ rows,
73
+ column,
74
+ row,
75
+ at,
76
+ );
77
+
78
+ // Each edge once: from the particle with the lower index.
79
+ if (other < particle) continue;
80
+ const wi: number = inverseMass[particle];
81
+ const wk: number = inverseMass[other];
82
+ const tilde: number =
83
+ props.compliance[SOFT_BODY_NEIGHBOURS[at][2]] * scale;
84
+ if (wi + wk + tilde === 0) continue;
85
+ const dx: number = predicted[particle * 3] - predicted[other * 3];
86
+ const dy: number =
87
+ predicted[particle * 3 + 1] - predicted[other * 3 + 1];
88
+ const dz: number =
89
+ predicted[particle * 3 + 2] - predicted[other * 3 + 2];
90
+ const length: number = Math.sqrt(dx * dx + dy * dy + dz * dz);
91
+ if (length === 0) continue;
92
+ const slot: number = particle * slots + at;
93
+ const delta: number =
94
+ (-(length - rest) - tilde * lambda[slot]) / (wi + wk + tilde);
95
+ lambda[slot] += delta;
96
+ const nx: number = dx / length;
97
+ const ny: number = dy / length;
98
+ const nz: number = dz / length;
99
+ predicted[particle * 3] += wi * delta * nx;
100
+ predicted[particle * 3 + 1] += wi * delta * ny;
101
+ predicted[particle * 3 + 2] += wi * delta * nz;
102
+ predicted[other * 3] -= wk * delta * nx;
103
+ predicted[other * 3 + 1] -= wk * delta * ny;
104
+ predicted[other * 3 + 2] -= wk * delta * nz;
105
+ }
106
+ }
107
+ };
@@ -0,0 +1,143 @@
1
+ import {
2
+ IAutoMovieSoftAnchor,
3
+ IAutoMovieSoftAnchorPose,
4
+ IAutoMovieSoftBodyDomain,
5
+ IAutoMovieSoftNamedState,
6
+ } from "@automovie/interface";
7
+
8
+ import { ViolationCollector } from "../validation/ViolationCollector";
9
+ import { SOFT_MAX_ANCHORS } from "./constants/SOFT_MAX_ANCHORS";
10
+ import { SOFT_MAX_STATES } from "./constants/SOFT_MAX_STATES";
11
+ import { validateSoftBounded as bounded } from "./validateSoftBounded";
12
+ import { validateSoftIdentity as identity } from "./validateSoftIdentity";
13
+ import { validateSoftInteger as integer } from "./validateSoftInteger";
14
+ import { validateSoftVector as vector } from "./validateSoftVector";
15
+
16
+ /**
17
+ * Validate a soft-body domain's anchors and its named states: the anchors'
18
+ * budget, identities, particles (each held by one anchor only), static
19
+ * positions and moving bindings, then the states' budget, identities and the
20
+ * anchors each poses (declared, posed once, finite). Split from
21
+ * `validateSoftBodyDomain`, which calls it at the same place, so its
22
+ * findings keep their order.
23
+ *
24
+ * @param out The collector the domain's validation writes to.
25
+ * @param root The domain's path.
26
+ * @param domain The domain.
27
+ * @param count The lattice's particle count.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States every rule and why the findings keep their order.
30
+ * @evidence contracts/development/implementation.md#principled-implementation Budget, identity, integer-range and vector admission through the shared primitive validators, and reference joins through the anchors' identity set.
31
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the anchors, then one over the states and their poses.
32
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A second anchor on a particle, a moving anchor with a static position, a blank binding identity and an undeclared or repeated pose are each reported, never repaired.
33
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in anchors plus state poses, with one identity set per collection.
34
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the shared primitive validators.
35
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The identity sets belong to the call; only the caller's collector is written.
36
+ */
37
+ export const validateSoftAnchors: (
38
+ out: ViolationCollector,
39
+ root: string,
40
+ domain: IAutoMovieSoftBodyDomain,
41
+ count: number,
42
+ ) => void = (
43
+ out: ViolationCollector,
44
+ root: string,
45
+ domain: IAutoMovieSoftBodyDomain,
46
+ count: number,
47
+ ): void => {
48
+ bounded(
49
+ out,
50
+ `${root}.anchors`,
51
+ "anchors",
52
+ domain.anchors.length,
53
+ SOFT_MAX_ANCHORS,
54
+ );
55
+ const anchorIds: Set<string> = new Set<string>();
56
+ const anchoredParticles: Set<number> = new Set<number>();
57
+ domain.anchors.forEach(
58
+ (anchor: IAutoMovieSoftAnchor, index: number): void => {
59
+ const path: string = `${root}.anchors[${index}]`;
60
+ identity(out, path, "anchor", anchor.id, anchorIds);
61
+ integer(
62
+ out,
63
+ `${path}.particle`,
64
+ "anchor particle",
65
+ anchor.particle,
66
+ 0,
67
+ count - 1,
68
+ );
69
+ if (anchoredParticles.has(anchor.particle))
70
+ out.push(
71
+ "type",
72
+ `${path}.particle`,
73
+ `particle ${anchor.particle} is already held by another anchor`,
74
+ anchor.particle,
75
+ );
76
+ anchoredParticles.add(anchor.particle);
77
+ if (anchor.position !== null)
78
+ vector(out, `${path}.position`, anchor.position);
79
+ if (anchor.binding !== undefined) {
80
+ if (anchor.position !== null)
81
+ out.push(
82
+ "type",
83
+ `${path}.position`,
84
+ "a moving anchor must leave its static world position null",
85
+ anchor.position,
86
+ );
87
+ if (anchor.binding.kind === "node") {
88
+ if (anchor.binding.node.trim().length === 0)
89
+ out.push(
90
+ "type",
91
+ `${path}.binding.node`,
92
+ "moving anchor node identity must be non-empty",
93
+ anchor.binding.node,
94
+ );
95
+ } else if (anchor.binding.actor.trim().length === 0)
96
+ out.push(
97
+ "type",
98
+ `${path}.binding.actor`,
99
+ "moving anchor actor identity must be non-empty",
100
+ anchor.binding.actor,
101
+ );
102
+ vector(out, `${path}.binding.offset`, anchor.binding.offset);
103
+ }
104
+ },
105
+ );
106
+
107
+ bounded(
108
+ out,
109
+ `${root}.states`,
110
+ "named states",
111
+ domain.states.length,
112
+ SOFT_MAX_STATES,
113
+ );
114
+ const stateIds: Set<string> = new Set<string>();
115
+ domain.states.forEach(
116
+ (state: IAutoMovieSoftNamedState, index: number): void => {
117
+ const path: string = `${root}.states[${index}]`;
118
+ identity(out, path, "named state", state.id, stateIds);
119
+ const posed: Set<string> = new Set<string>();
120
+ state.anchors.forEach(
121
+ (pose: IAutoMovieSoftAnchorPose, at: number): void => {
122
+ const posePath: string = `${path}.anchors[${at}]`;
123
+ if (!anchorIds.has(pose.anchor))
124
+ out.push(
125
+ "type",
126
+ `${posePath}.anchor`,
127
+ `named state cites anchor "${pose.anchor}", which the domain does not declare`,
128
+ pose.anchor,
129
+ );
130
+ else if (posed.has(pose.anchor))
131
+ out.push(
132
+ "type",
133
+ `${posePath}.anchor`,
134
+ `named state poses anchor "${pose.anchor}" twice`,
135
+ pose.anchor,
136
+ );
137
+ posed.add(pose.anchor);
138
+ vector(out, `${posePath}.position`, pose.position);
139
+ },
140
+ );
141
+ },
142
+ );
143
+ };