@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -0,0 +1,215 @@
1
+ import type { AutoMovieComposition } from "./AutoMovieComposition";
2
+ import { AutoMovieScheduleError } from "./AutoMovieScheduleError";
3
+ import type { IAutoMovieIntent } from "./IAutoMovieIntent";
4
+ import type { IAutoMovieSchedule } from "./IAutoMovieSchedule";
5
+ import type { resolveAutoMovieSchedule } from "./resolveAutoMovieSchedule";
6
+
7
+ /**
8
+ * The state of one walk of a composition (`resolveAutoMovieSchedule`) and the
9
+ * readings of it every placement shares: the instants an anchor or a cue
10
+ * track offers, the names placed so far, the instant an event names and the
11
+ * intent a part begins with.
12
+ *
13
+ * @evidence contracts/development/common.md#meaningful-documentation States what the walk keeps and what each reading answers.
14
+ * @evidence contracts/development/design.md#principled-representation The placed entries, the anchors' contact instants, the cuts' successors, the anchored entries and the cue tracks are the five things a later placement reads of an earlier one.
15
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One record and four readings, used by the cut, the intent, the `at` placement and the walk itself.
16
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No law and no composition is named; every reading refuses with an `AutoMovieScheduleError`.
17
+ */
18
+ export namespace AutoMovieScheduleWalk {
19
+ /**
20
+ * What one walk keeps.
21
+ *
22
+ * @evidence contracts/development/common.md#meaningful-documentation States each member, its keys and its unit.
23
+ * @evidence contracts/development/design.md#principled-representation The placed entries, the anchors' instants, the cuts' successors, the anchored entries and the cue tracks are the five things a later placement reads of an earlier one.
24
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Six members, all read by the cut, the placements and the walk.
25
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No composition is named and nothing outlives the walk.
26
+ */
27
+ export interface IWalk {
28
+ /** The production's pure laws. */
29
+ laws: resolveAutoMovieSchedule.ILaws;
30
+
31
+ /** Entries placed so far, in walk order. */
32
+ entries: IAutoMovieSchedule.IEntry[];
33
+
34
+ /** Each anchor's contact instant, or its start when it has none, film seconds. */
35
+ anchors: Map<string, number>;
36
+
37
+ /** The index an entry's cut is followed by, by the cut entry's index. */
38
+ interrupted: Map<number, number>;
39
+
40
+ /** The entry each anchor names. */
41
+ anchored: Map<string, IAutoMovieSchedule.IEntry>;
42
+
43
+ /** The cue tracks of the laws. */
44
+ tracks: Map<string, readonly resolveAutoMovieSchedule.ICue[]>;
45
+ }
46
+
47
+ /**
48
+ * A walk with nothing placed.
49
+ *
50
+ * @param laws The production's laws.
51
+ * @returns The walk.
52
+ *
53
+ * @evidence contracts/development/common.md#meaningful-documentation States the input and that nothing is placed.
54
+ * @evidence contracts/development/implementation.md#principled-implementation The tracks are the laws' own cues.
55
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One record.
56
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
57
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
58
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
59
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The record lives as long as the walk.
60
+ */
61
+ export function create(laws: resolveAutoMovieSchedule.ILaws): IWalk {
62
+ return {
63
+ laws,
64
+ entries: [],
65
+ anchors: new Map(),
66
+ interrupted: new Map(),
67
+ anchored: new Map(),
68
+ tracks: new Map(Object.entries(laws.cues ?? {})),
69
+ };
70
+ }
71
+
72
+ /**
73
+ * The named instants of an anchored entry (its events, and its own start
74
+ * and end where it names none so) or of a cue track.
75
+ *
76
+ * @param walk The walk.
77
+ * @param of The anchor or track.
78
+ * @returns The instants, or undefined when nothing of that name is placed.
79
+ *
80
+ * @evidence contracts/development/common.md#meaningful-documentation States the two sources and the start and end added.
81
+ * @evidence contracts/development/implementation.md#principled-implementation An entry always offers its start and its end unless its events name them.
82
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One lookup and one list.
83
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
84
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in the anchor's events.
85
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
86
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
87
+ */
88
+ export function instants(
89
+ walk: IWalk,
90
+ of: string,
91
+ ): readonly resolveAutoMovieSchedule.ICue[] | undefined {
92
+ const entry: IAutoMovieSchedule.IEntry | undefined = walk.anchored.get(of);
93
+
94
+ // A name that is no anchor and no fixed track may be a track the laws
95
+ // compute from what is placed so far (a struck person's hits).
96
+ if (entry === undefined)
97
+ return walk.tracks.get(of) ?? walk.laws.instants?.(of, walk.entries);
98
+ const events: readonly resolveAutoMovieSchedule.ICue[] = entry.events ?? [];
99
+ const named: (name: string) => boolean = (name: string): boolean =>
100
+ events.some(
101
+ (e: resolveAutoMovieSchedule.ICue): boolean => e.name === name,
102
+ );
103
+ return [
104
+ ...(named("start") ? [] : [{ name: "start", seconds: entry.start }]),
105
+ ...events,
106
+ ...(named("end") ? [] : [{ name: "end", seconds: entry.end }]),
107
+ ];
108
+ }
109
+
110
+ /**
111
+ * Every name a later part may align to.
112
+ *
113
+ * @param walk The walk.
114
+ * @returns The anchors and the tracks.
115
+ *
116
+ * @evidence contracts/development/common.md#meaningful-documentation States what is listed.
117
+ * @evidence contracts/development/implementation.md#principled-implementation The names an error offers as alternatives.
118
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One list.
119
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
120
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in the names.
121
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
122
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
123
+ */
124
+ export function placed(walk: IWalk): string[] {
125
+ return [...walk.anchored.keys(), ...walk.tracks.keys()];
126
+ }
127
+
128
+ /**
129
+ * The instant an event names, the `index`-th of that name.
130
+ *
131
+ * @param of The anchor or track the events belong to.
132
+ * @param events Its instants.
133
+ * @param name The event.
134
+ * @param index The occurrence, from 0.
135
+ * @param by The intent that asks, for the error.
136
+ * @returns Film seconds.
137
+ * @throws {AutoMovieScheduleError} When there is no event of that name or that many.
138
+ *
139
+ * @evidence contracts/development/common.md#meaningful-documentation States the inputs and the two refusals.
140
+ * @evidence contracts/development/implementation.md#principled-implementation Events of one name are taken in order, as a score repeats a beat.
141
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One filter and two refusals.
142
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing event or index is refused with the alternatives, not defaulted.
143
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in the events.
144
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
145
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
146
+ */
147
+ export function instant(
148
+ of: string,
149
+ events: readonly resolveAutoMovieSchedule.ICue[],
150
+ name: string,
151
+ index: number,
152
+ by: IAutoMovieIntent | undefined,
153
+ ): number {
154
+ const same: resolveAutoMovieSchedule.ICue[] = events.filter(
155
+ (e: resolveAutoMovieSchedule.ICue): boolean => e.name === name,
156
+ );
157
+ const names: string[] = [
158
+ ...new Set(
159
+ events.map((e: resolveAutoMovieSchedule.ICue): string => e.name),
160
+ ),
161
+ ];
162
+ if (same.length === 0)
163
+ throw new AutoMovieScheduleError(
164
+ `${of} has no event ${name}; its events are ${names.join(", ") || "none"}`,
165
+ {
166
+ code: "event",
167
+ subject: by?.subject,
168
+ capability: by?.capability,
169
+ of,
170
+ value: name,
171
+ alternatives: names,
172
+ },
173
+ );
174
+ const found: resolveAutoMovieSchedule.ICue | undefined = same[index];
175
+ if (found === undefined)
176
+ throw new AutoMovieScheduleError(
177
+ `${of} has ${same.length} ${name} events, so index ${index} names none (the first is 0)`,
178
+ {
179
+ code: "index",
180
+ subject: by?.subject,
181
+ capability: by?.capability,
182
+ of,
183
+ value: index,
184
+ alternatives: same.map(
185
+ (_: resolveAutoMovieSchedule.ICue, i: number): string => String(i),
186
+ ),
187
+ },
188
+ );
189
+ return found.seconds;
190
+ }
191
+
192
+ /**
193
+ * The intent a part begins with.
194
+ *
195
+ * @param node The part.
196
+ * @returns The first intent of a sequence or group, an intent itself, or undefined for an `at` or an empty group.
197
+ *
198
+ * @evidence contracts/development/common.md#meaningful-documentation States what each node kind gives.
199
+ * @evidence contracts/development/implementation.md#principled-implementation The first part is followed down; an `at` begins where its anchor puts it, so it names none.
200
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One recursion.
201
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
202
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Linear in the depth.
203
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work Nothing to reuse.
204
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
205
+ */
206
+ export function leading(
207
+ node: AutoMovieComposition,
208
+ ): IAutoMovieIntent | undefined {
209
+ return node.kind === "intent"
210
+ ? node.intent
211
+ : node.kind === "at" || node.parts[0] === undefined
212
+ ? undefined
213
+ : leading(node.parts[0]);
214
+ }
215
+ }
@@ -13,10 +13,10 @@ import type { IAutoMovieRelationalGoal } from "./IAutoMovieRelationalGoal";
13
13
  * serves any film. Timing, outcomes and state come from the production's
14
14
  * pure functions handed to `resolveAutoMovieSchedule`.
15
15
  *
16
- * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (One subject's intended action: the smallest unit a production composes) and documents 5 documented members as stated in this comment.
17
- * @evidence contracts/development/design.md#principled-representation Represents One subject's intended action: the smallest unit a production composes: interface of 5 members (`subject`, `capability`, `goal`, `anchor`, `parameters`). Optional members `goal`, `anchor`, `parameters` express documented absence, and the ranges its member docs state are left to runtime validation.
18
- * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the module that declares `IAutoMovieIntent` in packages/engine/src/composition/IAutoMovieIntent.ts; its surface is the 5 members listed and the text shows 14 other files naming it, mostly movies (8), packages/engine (5), test (1), so no member is declared for a presumed future need.
19
- * @evidence contracts/development/design.md#prohibited-design-shortcuts Scanning the declaration finds no `any`, a use of `unknown`, no index signature and no cast; 3 optional members (`goal`, `anchor`, `parameters`) are independent fields rather than alternatives of one another as far as their docs state; it duplicates no type that another owner declares as far as a name search shows. The widening above is the remaining shortcut and is not justified here.
16
+ * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (One subject's intended action: the smallest unit a production composes), that the engine never reads `capability`, and documents all 6 members, including the four forms of `until` with their units (a share in [0, 1], a metre distance) and what an unreached proximity does.
17
+ * @evidence contracts/development/design.md#principled-representation Represents One subject's intended action: interface of 6 members (`subject`, `capability`, `goal`, `anchor`, `parameters`, `until`). Optional members express documented absence (no relation, no anchor, no data, runs to its end); `until` is a union discriminated by its keys, `share`, `event`, `of` with `event`, or `proximity`, and the ranges its docs state are left to runtime validation by the resolver.
18
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the module that declares `IAutoMovieIntent` in packages/engine/src/composition/IAutoMovieIntent.ts and read by `resolveAutoMovieSchedule` and the productions' composition builders; every member is read by one of them, so none is declared for a presumed future need.
19
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The one widening is `parameters`, `Readonly<Record<string, unknown>>`: production data the engine copies untouched and only the production's own timing, outcome and state functions read, so the engine cannot give it a shape. There is no `any`, no cast and no index signature elsewhere; the five optional members are independent fields rather than alternatives, and `until`'s alternatives are a union, not optional fields.
20
20
  */
21
21
  export interface IAutoMovieIntent {
22
22
  /** Stable id of the acting subject. */
@@ -42,10 +42,12 @@ export interface IAutoMovieIntent {
42
42
  * - `{ event }`: at one of its own named events
43
43
  * (`resolveAutoMovieSchedule.ITiming.events`);
44
44
  * - `{ of, event }`: when an event of the intent anchored `of`, usually
45
- * another subject's action, happens;
45
+ * another subject's action, or of a cue track named `of`, happens;
46
+ * `index` picks which occurrence where the name repeats;
46
47
  * - `{ proximity }`: when the subject's `effector` region first comes within
47
48
  * `distance` metres of `target` (zero is contact), which the production's
48
- * `until` law finds from its motion.
49
+ * `until` law finds from its motion; a proximity the motion never
50
+ * reaches cuts nothing, and the action runs to its end.
49
51
  *
50
52
  * The entry then ends at the cut and the next part of a sequence starts
51
53
  * there. The production's legality rules decide whether the cut is declared;
@@ -54,7 +56,7 @@ export interface IAutoMovieIntent {
54
56
  until?:
55
57
  | { share: number }
56
58
  | { event: string }
57
- | { of: string; event: string }
59
+ | { of: string; event: string; index?: number }
58
60
  | {
59
61
  proximity: {
60
62
  /** The subject's own region that approaches. */
@@ -1,5 +1,9 @@
1
1
  export * from "./AutoMovieChain";
2
2
  export * from "./AutoMovieComposition";
3
+ export * from "./AutoMovieScheduleCut";
4
+ export * from "./AutoMovieScheduleError";
5
+ export * from "./AutoMovieSchedulePlace";
6
+ export * from "./AutoMovieScheduleWalk";
3
7
  export * from "./IAutoMovieFramingGoal";
4
8
  export * from "./IAutoMovieIntent";
5
9
  export * from "./IAutoMovieRelationalGoal";
@@ -17,3 +21,4 @@ export * from "./resolveAutoMovieOutcome";
17
21
  export * from "./resolveAutoMovieRelationalGoal";
18
22
  export * from "./resolveAutoMovieSchedule";
19
23
  export * from "./resolveAutoMovieZone";
24
+ export * from "./markAutoMovieContacts";
@@ -0,0 +1,79 @@
1
+ import type { IAutoMovieContactReceipt } from "@automovie/interface";
2
+
3
+ import type { IAutoMovieMark } from "../geometry/IAutoMovieMark";
4
+
5
+ /**
6
+ * Turn the solved contacts acting at one second into inspection marks: one arrow per contact, at the contact point along its normal, as long as the mean force times a stated scale.
7
+ *
8
+ * A receipt acts at `seconds` when the solver measured it: its latest completed step at or before `seconds`, within that step's duration, has a positive finite impulse and no positive separation. The arrow starts at that step's point and runs along its normal, from the first collider toward the second, for `metresPerNewton` times the step's mean force, its impulse over its duration. Geometric receipts, which assert no impulse, draw nothing.
9
+ *
10
+ * The mark has kind `contact`, label `contact force`, colour teal `00c2a8` and path `<body>/<bone>/contact/<receipt id>` of the first collider, in world metres and unanchored.
11
+ *
12
+ * It throws for a scale that is not positive and finite and for an acting step without a positive duration.
13
+ *
14
+ * @param props.receipts Contact episodes, as the composition's contact measurement and the solver record them.
15
+ * @param props.seconds The drawn film second.
16
+ * @param props.metresPerNewton Arrow length per newton of mean force.
17
+ * @returns One mark per acting contact, in the receipts' order.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States when a contact acts, how the arrow's place, direction and length follow from the step, what geometric receipts draw, the kind, label, colour, path and frame, and both refusals.
20
+ * @evidence contracts/development/implementation.md#principled-implementation A step's mean force is its normal impulse over its duration, so the arrow's length is a force on a stated scale; a step is read only once completed at or before the drawn second, so a still never shows a later impulse.
21
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass over the receipts, each scanned from its last step back to the drawn second.
22
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scale is the caller's stated parameter, and a step without a duration is refused instead of given an arbitrary length.
23
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the receipts' steps in the worst case; each receipt stops at its latest step at or before the second.
24
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of one second.
25
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh marks and keeps nothing.
26
+ */
27
+ export function markAutoMovieContacts(props: {
28
+ receipts: readonly IAutoMovieContactReceipt[];
29
+ seconds: number;
30
+ metresPerNewton: number;
31
+ }): IAutoMovieMark[] {
32
+ if (!(Number.isFinite(props.metresPerNewton) && props.metresPerNewton > 0))
33
+ throw new Error(
34
+ `markAutoMovieContacts: metres per newton ${props.metresPerNewton} is not positive and finite`,
35
+ );
36
+ const marks: IAutoMovieMark[] = [];
37
+ for (const receipt of props.receipts) {
38
+ if (receipt.source !== "solver") continue;
39
+ const steps: NonNullable<IAutoMovieContactReceipt["samples"]> =
40
+ receipt.samples ?? [];
41
+ let step: (typeof steps)[number] | undefined;
42
+ for (let i: number = steps.length - 1; i >= 0; i--)
43
+ if (steps[i]!.seconds <= props.seconds + 1e-9) {
44
+ step = steps[i];
45
+ break;
46
+ }
47
+ if (
48
+ step === undefined ||
49
+ !(step.impulse > 0 && Number.isFinite(step.impulse)) ||
50
+ step.separation > 0
51
+ )
52
+ continue;
53
+ if (!(step.duration > 0))
54
+ throw new Error(
55
+ `markAutoMovieContacts: contact ${receipt.id} has a step without a positive duration`,
56
+ );
57
+ if (props.seconds - step.seconds >= step.duration) continue;
58
+ const length: number =
59
+ (step.impulse / step.duration) * props.metresPerNewton;
60
+ marks.push({
61
+ path: `${receipt.a.body}/${receipt.a.bone}/contact/${receipt.id}`,
62
+ kind: "contact",
63
+ label: "contact force",
64
+ color: 0x00c2a8,
65
+ shape: {
66
+ type: "arrows",
67
+ origins: [step.point.x, step.point.y, step.point.z],
68
+ vectors: [
69
+ step.normal.x * length,
70
+ step.normal.y * length,
71
+ step.normal.z * length,
72
+ ],
73
+ },
74
+ flagged: false,
75
+ anchor: null,
76
+ });
77
+ }
78
+ return marks;
79
+ }
@@ -9,7 +9,9 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
9
9
  * takes until it meets something), or a capsule, a segment swept by that
10
10
  * radius, when it also gives the axis's other end: a shin, a forearm, any
11
11
  * limb segment that strikes along its length, so another body crossing the
12
- * segment between its ends is met, not passed between sparse points. Every
12
+ * segment between its ends is met, not passed between sparse points; a
13
+ * tapered capsule's radius runs linearly from one end to the other, as a
14
+ * limb narrows from one joint to the next. Every
13
15
  * body is a signed distance at a second, from a point and, for capsule
14
16
  * weapons, from a segment (the least signed distance over the segment's
15
17
  * points). Both may depend on which weapons have already stopped, because a
@@ -24,24 +26,41 @@ import type { IAutoMovieVector3 } from "@automovie/interface";
24
26
  * bisections of the first crossing, so the result is deterministic; a
25
27
  * contact shorter than one step (a weapon and a body passing through each
26
28
  * other within it) is the scan's stated blind spot, so the step must stay
27
- * below the time either needs to cross the other's thickness. Ties in
29
+ * below the time either needs to cross the other's thickness. A weapon
30
+ * that states the span it is live in (`from`, `to`) is scanned only on the
31
+ * scan's own steps that reach into that span, since outside it the weapon
32
+ * meets nothing; the steps are the same as a scan of the whole span, so the
33
+ * result is too, and a performance of many strikes scans each strike over
34
+ * its own window instead of over the whole performance. Since only the
35
+ * earliest impact is stopped, each round scans the weapons in the order
36
+ * they become live and no weapon past the earliest impact found so far: one
37
+ * that becomes live after it cannot be earlier. Ties in
28
38
  * time are broken by the weapons' ids, and a weapon that touches the moment
29
39
  * another stops is stopped at that same second, so the result does not
30
40
  * depend on the order the weapons are listed in.
31
41
  *
42
+ * A contact is mutual. A weapon and the body that carries it are two
43
+ * measures of one limb (a capsule and that body's signed distance), and they
44
+ * need not agree to the millimetre, so of two limbs swung into each other
45
+ * one weapon touches the other body before the other weapon touches back.
46
+ * When the part a weapon meets carries a weapon of its own that is still
47
+ * moving (the body says so through `carried`), that weapon stops at the same
48
+ * second against the striker's body: neither limb is driven on into the one
49
+ * that has already stopped on it.
50
+ *
32
51
  * This resolves simultaneous strikes consistently: two fists crossing each
33
52
  * other's arms, two shins meeting, a block that arrives first. It is a
34
53
  * kinematic resolution of contact times, not a force simulation.
35
54
  *
36
55
  * @param input The weapons, the bodies and the span.
37
56
  * @returns The stops, in time order.
38
- * @throws {Error} When the span or the step is not positive, a weapon id repeats, or a capsule weapon meets a body that measures no segment.
57
+ * @throws {Error} When the span or the step is not positive, a weapon id repeats, a weapon's live span is not finite or ends before it begins, a tail radius is given without a tail or is not a finite non-negative length, a capsule weapon meets a body that measures no segment, or a body names a carried weapon that is not its own.
39
58
  *
40
59
  * @evidence contracts/development/common.md#meaningful-documentation States the method, its determinism, its tie rule and what it does not model.
41
60
  * @evidence contracts/development/implementation.md#principled-implementation The time-ordered event loop of impulse-based simulation over continuous first-impact times.
42
61
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One loop over events and one first-impact search.
43
62
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Invalid spans, steps and repeated ids throw, and a capsule weapon is never reduced to its end points when a body cannot measure a segment: that throws.
44
- * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons: quadratic in weapons times the scan's samples, for the handful of weapons one exchange holds.
63
+ * @evidence contracts/development/implementation.md#efficient-algorithms Each event re-scans the remaining weapons, each over the scan's samples inside its own live span and no later than the earliest impact found in that round: a performance of many strikes in sequence costs in proportion to its strikes, where scanning every weapon over the whole span after every event cost the square of them.
45
64
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input; callers memoise.
46
65
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
47
66
  */
@@ -55,32 +74,95 @@ export function resolveAutoMovieContactEvents(
55
74
  for (const w of input.weapons) {
56
75
  if (ids.has(w.id)) throw new Error(`Repeated contact weapon ${w.id}`);
57
76
  ids.add(w.id);
77
+ if (
78
+ (w.from !== undefined && !Number.isFinite(w.from)) ||
79
+ (w.to !== undefined && !Number.isFinite(w.to)) ||
80
+ (w.from !== undefined && w.to !== undefined && w.to < w.from)
81
+ )
82
+ throw new Error(
83
+ `Contact weapon ${w.id} has a live span that is not finite or ends before it begins`,
84
+ );
85
+ if (
86
+ w.tailRadius !== undefined &&
87
+ (w.tail === undefined ||
88
+ !Number.isFinite(w.tailRadius) ||
89
+ w.tailRadius < 0)
90
+ )
91
+ throw new Error(
92
+ `Contact weapon ${w.id} has a tail radius without a tail, or one that is not a finite non-negative length`,
93
+ );
58
94
  }
59
95
  const stopped: Map<string, number> = new Map();
60
96
  const events: resolveAutoMovieContactEvents.IEvent[] = [];
61
- const weapons = [...input.weapons].sort((a, b) =>
62
- a.id < b.id ? -1 : a.id > b.id ? 1 : 0,
97
+ // In the order the weapons become live, so the earliest impact is found
98
+ // early and bounds the scans after it; ties in time go to the lesser id.
99
+ const weapons: resolveAutoMovieContactEvents.IWeapon[] = [
100
+ ...input.weapons,
101
+ ].sort(
102
+ (
103
+ a: resolveAutoMovieContactEvents.IWeapon,
104
+ b: resolveAutoMovieContactEvents.IWeapon,
105
+ ): number =>
106
+ (a.from ?? -Infinity) - (b.from ?? -Infinity) ||
107
+ (a.id < b.id ? -1 : a.id > b.id ? 1 : 0),
63
108
  );
64
109
  for (;;) {
65
110
  let best: resolveAutoMovieContactEvents.IEvent | undefined;
66
111
  const after: number = events.at(-1)?.seconds ?? input.from;
67
112
  for (const weapon of weapons) {
68
113
  if (stopped.has(weapon.id)) continue;
69
- const hit = firstImpact(
114
+ if (best !== undefined && (weapon.from ?? -Infinity) > best.seconds)
115
+ break;
116
+ const hit: { against: string; seconds: number } | undefined = firstImpact(
70
117
  weapon,
71
118
  input,
72
119
  stopped,
73
120
  Math.max(input.from, after),
121
+ best?.seconds ?? Infinity,
74
122
  );
75
123
  if (
76
124
  hit !== undefined &&
77
- (best === undefined || hit.seconds < best.seconds)
125
+ (best === undefined ||
126
+ hit.seconds < best.seconds ||
127
+ (hit.seconds === best.seconds && weapon.id < best.weapon))
78
128
  )
79
129
  best = { weapon: weapon.id, ...hit };
80
130
  }
81
131
  if (best === undefined) return events;
132
+
133
+ // The contact is mutual: when the part met carries a weapon of its own
134
+ // that is still moving, that weapon has met the striker in the same
135
+ // touch and stops at the same second.
136
+ const striker: resolveAutoMovieContactEvents.IWeapon = weapons.find(
137
+ (w: resolveAutoMovieContactEvents.IWeapon): boolean =>
138
+ w.id === best!.weapon,
139
+ )!;
140
+ const p: IAutoMovieVector3 = striker.position(best.seconds, stopped);
141
+ const own: string | undefined = input.bodies
142
+ .find(
143
+ (b: resolveAutoMovieContactEvents.IBody): boolean =>
144
+ b.id === best!.against,
145
+ )
146
+ ?.carried?.(
147
+ p,
148
+ striker.tail?.(best.seconds, stopped) ?? p,
149
+ best.seconds,
150
+ stopped,
151
+ striker.owner,
152
+ );
82
153
  stopped.set(best.weapon, best.seconds);
83
154
  events.push(best);
155
+ if (own === undefined) continue;
156
+ if (
157
+ !weapons.some(
158
+ (w: resolveAutoMovieContactEvents.IWeapon): boolean =>
159
+ w.id === own && w.owner === best!.against,
160
+ )
161
+ )
162
+ throw new Error(`Body ${best.against} carries no contact weapon ${own}`);
163
+ if (stopped.has(own)) continue;
164
+ stopped.set(own, best.seconds);
165
+ events.push({ weapon: own, against: striker.owner, seconds: best.seconds });
84
166
  }
85
167
  }
86
168
 
@@ -88,7 +170,7 @@ export function resolveAutoMovieContactEvents(
88
170
  * Companion types of {@link resolveAutoMovieContactEvents}.
89
171
  *
90
172
  * @evidence contracts/development/common.md#meaningful-documentation Documents each member's frame and unit.
91
- * @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
173
+ * @evidence contracts/development/design.md#principled-representation Weapons are moving spheres or capsules (an optional axis end, and an optional radius there for a tapered one), bodies signed distances from a point and optionally from a segment, both functions of seconds and of the stops so far.
92
174
  * @evidence contracts/development/design.md#minimal-and-owned-surface What callers provide and read.
93
175
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Reuses the interface vector.
94
176
  */
@@ -104,9 +186,23 @@ export namespace resolveAutoMovieContactEvents {
104
186
  /** The body carrying it, whose own distance it ignores. */
105
187
  owner: string;
106
188
 
107
- /** The sphere's radius, metres. */
189
+ /** The sphere's radius, metres; a capsule's radius at `position`. */
108
190
  radius: number;
109
191
 
192
+ /**
193
+ * A tapered capsule's radius at `tail`, metres: the capsule then narrows
194
+ * (or widens) linearly from `radius` at `position` to this, the round
195
+ * cone of a limb whose girth changes from one joint to the next. Absent
196
+ * for a sphere and for a capsule of one radius.
197
+ */
198
+ tailRadius?: number;
199
+
200
+ /** When the weapon starts to be live, seconds, finite; it meets nothing before, whatever its path says. The span's start when absent. */
201
+ from?: number;
202
+
203
+ /** When it stops being live, seconds, finite and not before `from`; it meets nothing after, whatever its path says. The span's end when absent. */
204
+ to?: number;
205
+
110
206
  /**
111
207
  * The sphere's centre on its free path at a second, world metres.
112
208
  *
@@ -148,11 +244,16 @@ export namespace resolveAutoMovieContactEvents {
148
244
  * The signed distance from a segment to the body's surface at a second,
149
245
  * metres: the least signed distance over the segment's points, positive
150
246
  * when the whole segment is outside. Required to meet capsule weapons.
247
+ * Given a taper, the segment is widened by a radius running linearly
248
+ * from its first end's to its other end's, and the distance is that
249
+ * tapered capsule's: the least over its points of the distance less the
250
+ * radius there.
151
251
  *
152
252
  * @param a The segment's first end, world metres.
153
253
  * @param b Its other end, world metres.
154
254
  * @param seconds Seconds.
155
255
  * @param stops The stops so far.
256
+ * @param taper The radii at `a` and at `b`, metres, for a tapered capsule weapon.
156
257
  * @returns Metres.
157
258
  */
158
259
  axis?(
@@ -160,7 +261,29 @@ export namespace resolveAutoMovieContactEvents {
160
261
  b: IAutoMovieVector3,
161
262
  seconds: number,
162
263
  stops: IStops,
264
+ taper?: readonly [number, number],
163
265
  ): number;
266
+
267
+ /**
268
+ * The body's own weapon carried by the part a striking weapon met, when
269
+ * that weapon is still on its free path at the second: the contact is
270
+ * mutual, so it stops with the striker. Absent, or undefined, when the
271
+ * part met carries none.
272
+ *
273
+ * @param a The striking weapon's centre, or its axis's first end, world metres.
274
+ * @param b The axis's other end; the centre again for a sphere.
275
+ * @param seconds The contact second.
276
+ * @param stops The stops before this contact.
277
+ * @param by The id of the body carrying the striking weapon.
278
+ * @returns The id of one of this body's weapons, or undefined.
279
+ */
280
+ carried?(
281
+ a: IAutoMovieVector3,
282
+ b: IAutoMovieVector3,
283
+ seconds: number,
284
+ stops: IStops,
285
+ by: string,
286
+ ): string | undefined;
164
287
  }
165
288
 
166
289
  /** The input. */
@@ -194,14 +317,20 @@ export namespace resolveAutoMovieContactEvents {
194
317
  }
195
318
  }
196
319
 
197
- /** A weapon's first impact from a second on, against the bodies it does not belong to. */
320
+ /** A weapon's first impact from a second on, against the bodies it does not belong to; undefined when it has none, or none before `horizon`. */
198
321
  function firstImpact(
199
322
  weapon: resolveAutoMovieContactEvents.IWeapon,
200
323
  input: resolveAutoMovieContactEvents.IInput,
201
324
  stops: resolveAutoMovieContactEvents.IStops,
202
325
  from: number,
326
+ horizon: number,
203
327
  ): { against: string; seconds: number } | undefined {
328
+ const live: number = weapon.from ?? -Infinity;
329
+ const until: number = Math.min(input.to, weapon.to ?? Infinity);
204
330
  const gap = (t: number): { distance: number; against: string } => {
331
+ // Outside its live span the weapon meets nothing, whatever its path.
332
+ if (t < live || t > (weapon.to ?? Infinity))
333
+ return { distance: Infinity, against: "" };
205
334
  const p: IAutoMovieVector3 = weapon.position(t, stops);
206
335
  const q: IAutoMovieVector3 | undefined = weapon.tail?.(t, stops);
207
336
  let best: { distance: number; against: string } = {
@@ -219,17 +348,29 @@ function firstImpact(
219
348
  `Body ${body.id} measures no segment for capsule weapon ${weapon.id}`,
220
349
  );
221
350
  const d: number =
222
- (q === undefined
223
- ? body.distance(p, t, stops)
224
- : body.axis!(p, q, t, stops)) - weapon.radius;
351
+ q === undefined
352
+ ? body.distance(p, t, stops) - weapon.radius
353
+ : weapon.tailRadius === undefined
354
+ ? body.axis!(p, q, t, stops) - weapon.radius
355
+ : body.axis!(p, q, t, stops, [weapon.radius, weapon.tailRadius]);
225
356
  if (d < best.distance) best = { distance: d, against: body.id };
226
357
  }
227
358
  return best;
228
359
  };
229
- const start = gap(from);
230
- if (start.distance <= 0) return { against: start.against, seconds: from };
231
- let previous: number = from;
232
- for (let k: number = 1; ; k++) {
360
+ // Outside its live span the weapon meets nothing, so the scan starts at
361
+ // the last of its steps before that span and ends at the first step past
362
+ // it: the same steps, and so the same result, as scanning from `from`.
363
+ if (until < from) return undefined;
364
+ const first: number =
365
+ live > from ? Math.max(1, Math.floor((live - from) / input.step)) : 1;
366
+ if (first === 1) {
367
+ const start: { distance: number; against: string } = gap(from);
368
+ if (start.distance <= 0) return { against: start.against, seconds: from };
369
+ }
370
+ let previous: number = first === 1 ? from : from + (first - 1) * input.step;
371
+ for (let k: number = first; ; k++) {
372
+ // An impact found past this step would come after `horizon`.
373
+ if (previous >= horizon) return undefined;
233
374
  const t: number = Math.min(input.to, from + k * input.step);
234
375
  if (gap(t).distance <= 0) {
235
376
  let lo: number = previous;
@@ -241,7 +382,7 @@ function firstImpact(
241
382
  }
242
383
  return { against: gap(hi).against, seconds: hi };
243
384
  }
244
- if (t >= input.to) return undefined;
385
+ if (t >= until) return undefined;
245
386
  previous = t;
246
387
  }
247
388
  }