@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
@@ -8,103 +8,177 @@ import { Vector3 } from "../math/Vector3";
8
8
  *
9
9
  * Neither person's goal is the other's hand, which moves; both aim at one
10
10
  * shared point both can reach comfortably, the way joint-action studies find
11
- * people converge on it. Horizontally it is the midpoint between the two
12
- * acting shoulders: human-human handovers take place at the midpoint between
13
- * the partners (Hansen et al. 2017, Human-human handover tasks and how
14
- * distance and object mass matter, Perceptual and Motor Skills 124(1), reviewed
15
- * by Kopnarski et al. 2023, Front. Psychol. 14:1147296), and each person then
16
- * travels the same horizontal share. Vertically it is the mean of the two
17
- * heights at which each person's hand would hang at that horizontal distance
18
- * with the arm at its comfortable reach `reach` (the shoulder-to-hand distance
19
- * of the family's working elbow flexion): `y = shoulder.y - sqrt(reach^2 -
20
- * h^2)` for a half gap `h`, or the shoulder's own height when `h` exceeds the
21
- * comfortable reach. A taller partner therefore raises the point, as the
11
+ * people converge on it. Each person has a comfortable reach, the
12
+ * shoulder-to-hand distance of the family's working elbow flexion, and the
13
+ * point is where both arms are at it at once: in the vertical plane through
14
+ * the two acting shoulders, the lower of the two points that lie one
15
+ * comfortable reach from each shoulder, so the hands meet below the line
16
+ * between the shoulders. For two equal people that is the midpoint between
17
+ * them, where human-human handovers take place (Hansen et al. 2017,
18
+ * Human-human handover tasks and how distance and object mass matter,
19
+ * Perceptual and Motor Skills 124(1), reviewed by Kopnarski et al. 2023,
20
+ * Front. Psychol. 14:1147296), `sqrt(reach^2 - h^2)` below the shoulders at
21
+ * the horizontal half gap `h`. Between people of unequal stature the same
22
+ * rule moves the point up and toward the taller one, who reaches down more
23
+ * steeply and less far forward while the shorter one reaches forward: the
22
24
  * exchange height rises with stature (Sutiphotinun et al. 2020, reviewed by
23
- * Kopnarski 2023), and either partner's comfortable reach is honoured on
24
- * average. When the partners' statures differ so much that this mean lies
25
- * beyond one straight arm (a child and a tall adult), the height moves to the
26
- * nearest one inside the band of heights both straight arms reach at that
27
- * horizontal distance, so the shorter partner reaches up or the taller down
28
- * only as far as the other cannot.
25
+ * Kopnarski 2023). The rule for unequal partners is provisional, as no study
26
+ * of the clasp point of partners of unequal stature or arm length was
27
+ * located; it replaces a horizontal division with a mean height that left
28
+ * the taller partner's arm straight at the end of its reach.
29
29
  *
30
- * A meeting is refused, not stretched, when no height lies within both
31
- * straight arms' reach: the error gives both limits and the widest shoulder
32
- * gap the pair can close (the band only narrows as the gap widens, so it is
33
- * found by bisection), so the author moves the people instead of receiving
34
- * an arm torn off its shoulder.
30
+ * Shoulders farther apart than the two comfortable reaches leave no such
31
+ * point, so both arms extend by one common factor of their comfortable
32
+ * reaches and the hands meet on the line between the shoulders; shoulders
33
+ * nearer than the difference of the reaches shorten both the same way. An
34
+ * action that has its own preferred contact height (`height`, as an object
35
+ * is handed over at chest height) passes it: the point then lies at that
36
+ * height where both arms are the same fraction of their comfortable reaches
37
+ * (by bisection along the horizontal line between the shoulders, on which
38
+ * one distance grows as the other shrinks), and the height is moved to the
39
+ * nearest one inside the band both straight arms reach there.
40
+ *
41
+ * A meeting is refused, not stretched, when it lies beyond a straight arm:
42
+ * the error gives both limits and the widest horizontal shoulder gap the
43
+ * pair can close, so the author moves the people instead of receiving an arm
44
+ * torn off its shoulder.
35
45
  *
36
46
  * @param input Both sides' acting shoulders and reaches.
37
47
  * @returns The meeting point and each side's shoulder distance to it.
38
- * @throws {Error} When a reach is not positive, a comfortable reach exceeds its limit, or the point lies beyond a limit.
48
+ * @throws {Error} When a reach is not positive or exceeds its limit, the shoulders coincide, or the point lies beyond a limit.
39
49
  *
40
- * @evidence contracts/development/common.md#meaningful-documentation States the horizontal and vertical rules with their sources, the frame and units, and the refusal.
41
- * @evidence contracts/development/implementation.md#principled-implementation Midpoint location (Hansen 2017) and a comfortable-reach hand height from the right triangle of the arm, the shoulder height and the half gap.
42
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One closed-form point projected into one reachable band, and one feasibility check.
43
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm; the projection only moves the height inside both arms' reach.
44
- * @evidence contracts/development/implementation.md#efficient-algorithms Constant work; a refusal adds a fixed 50-step bisection.
50
+ * @evidence contracts/development/common.md#meaningful-documentation States the rule with its sources, the wide and the preferred-height cases, the frame and units, and the refusal.
51
+ * @evidence contracts/development/implementation.md#principled-implementation The midpoint of equal arms (Hansen 2017) generalised to the one point at which both arms hold their comfortable reach: the intersection of two spheres in the shoulders' vertical plane.
52
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One common extension factor, one two-circle intersection, and for a preferred height one bisection and one band.
53
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts An unreachable meeting is refused with the feasible gap, never clamped onto an arm; a preferred height only moves inside both arms' reach.
54
+ * @evidence contracts/development/implementation.md#efficient-algorithms Closed form; a preferred height adds a fixed 50-step bisection, and its refusal another.
45
55
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of its input.
46
56
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Allocates its result only.
47
57
  */
48
58
  export function resolveAutoMovieMutualGoal(input: {
49
59
  /** One person. */ a: resolveAutoMovieMutualGoal.ISide;
50
60
  /** The other person. */ b: resolveAutoMovieMutualGoal.ISide;
61
+ /**
62
+ * The height the action itself prefers for the contact, world metres, when
63
+ * it has one (an object handed over at chest height): the point lies at it,
64
+ * or at the nearest height both straight arms reach.
65
+ */
66
+ height?: number;
51
67
  }): resolveAutoMovieMutualGoal.IGoal {
52
- for (const side of [input.a, input.b])
68
+ const a: resolveAutoMovieMutualGoal.ISide = input.a;
69
+ const b: resolveAutoMovieMutualGoal.ISide = input.b;
70
+ for (const side of [a, b])
53
71
  if (!(side.reach > 0 && side.limit >= side.reach))
54
72
  throw new Error(
55
73
  `A mutual goal needs 0 < reach <= limit, but had reach ${side.reach} and limit ${side.limit}`,
56
74
  );
57
- const half: number =
58
- Math.hypot(
59
- input.b.shoulder.x - input.a.shoulder.x,
60
- input.b.shoulder.z - input.a.shoulder.z,
61
- ) / 2;
62
- const height = (side: resolveAutoMovieMutualGoal.ISide): number =>
63
- side.shoulder.y -
64
- Math.sqrt(Math.max(0, side.reach * side.reach - half * half));
75
+ const span: IAutoMovieVector3 = Vector3.subtract(b.shoulder, a.shoulder);
76
+ const apart: number = Vector3.length(span);
77
+ if (!(apart > 1e-9))
78
+ throw new Error("A mutual goal needs two shoulders at different places");
79
+ const gap: number = Math.hypot(span.x, span.z);
80
+ const refuse = (closable: number): Error =>
81
+ new Error(
82
+ `The hands cannot meet: no point lies within both arms' reach of ${a.limit.toFixed(3)} m and ${b.limit.toFixed(3)} m at a shoulder gap of ${gap.toFixed(3)} m; bring the shoulders within about ${closable.toFixed(3)} m of each other`,
83
+ );
84
+ const done = (
85
+ point: IAutoMovieVector3,
86
+ ): resolveAutoMovieMutualGoal.IGoal => ({
87
+ point,
88
+ distance: [
89
+ Vector3.length(Vector3.subtract(point, a.shoulder)),
90
+ Vector3.length(Vector3.subtract(point, b.shoulder)),
91
+ ],
92
+ });
65
93
 
66
- // The heights each straight arm can reach at that horizontal distance; the
67
- // comfortable mean is moved into the band both share.
68
- const band = (
69
- side: resolveAutoMovieMutualGoal.ISide,
70
- h: number,
71
- ): [number, number] => {
72
- const drop: number = Math.sqrt(
73
- Math.max(0, side.limit * side.limit - h * h),
94
+ if (input.height === undefined) {
95
+ // The common factor both comfortable reaches are scaled by: 1 while the
96
+ // two spheres intersect, else the nearest factor at which they touch.
97
+ const factor: number = Math.min(
98
+ Math.max(1, apart / (a.reach + b.reach)),
99
+ apart / Math.abs(a.reach - b.reach),
74
100
  );
75
- return [side.shoulder.y - drop, side.shoulder.y + drop];
76
- };
77
- const shared = (h: number): [number, number] => {
78
- const [a0, a1] = band(input.a, h);
79
- const [b0, b1] = band(input.b, h);
80
- return [Math.max(a0, b0), Math.min(a1, b1)];
101
+ const most: number = Math.min(a.limit / a.reach, b.limit / b.reach);
102
+ if (factor > most) {
103
+ const widest: number = most * (a.reach + b.reach);
104
+ throw refuse(Math.sqrt(Math.max(0, widest * widest - span.y * span.y)));
105
+ }
106
+ const axis: IAutoMovieVector3 = Vector3.scale(span, 1 / apart);
107
+ const reach: number = factor * a.reach;
108
+ const along: number =
109
+ (reach * reach - factor * factor * b.reach * b.reach + apart * apart) /
110
+ (2 * apart);
111
+ const off: number = Math.sqrt(Math.max(0, reach * reach - along * along));
112
+ // Downward across the line between the shoulders; one shoulder straight
113
+ // above the other leaves no such direction and no offset to place.
114
+ const down: IAutoMovieVector3 = Vector3.subtract(
115
+ { x: 0, y: -1, z: 0 },
116
+ Vector3.scale(axis, -axis.y),
117
+ );
118
+ const length: number = Vector3.length(down);
119
+ return done(
120
+ Vector3.add(
121
+ Vector3.add(a.shoulder, Vector3.scale(axis, along)),
122
+ length > 1e-9
123
+ ? Vector3.scale(down, off / length)
124
+ : { x: 0, y: 0, z: 0 },
125
+ ),
126
+ );
127
+ }
128
+
129
+ // A preferred height: along the horizontal line between the shoulders, the
130
+ // place where both arms are the same fraction of their comfortable reaches.
131
+ const preferred: number = input.height;
132
+ const meet = (g: number): { share: number; low: number; high: number } => {
133
+ const excess = (t: number): number =>
134
+ Math.hypot(t, preferred - a.shoulder.y) * b.reach -
135
+ Math.hypot(g - t, preferred - b.shoulder.y) * a.reach;
136
+ let lo: number = 0;
137
+ let hi: number = g;
138
+ if (excess(lo) >= 0) hi = lo;
139
+ else if (excess(hi) <= 0) lo = hi;
140
+ else
141
+ for (let i: number = 0; i < 50; i++) {
142
+ const mid: number = (lo + hi) / 2;
143
+ if (excess(mid) < 0) lo = mid;
144
+ else hi = mid;
145
+ }
146
+ const t: number = (lo + hi) / 2;
147
+ // The heights each straight arm reaches at its horizontal distance.
148
+ const reachA: number = Math.sqrt(Math.max(0, a.limit * a.limit - t * t));
149
+ const reachB: number = Math.sqrt(
150
+ Math.max(0, b.limit * b.limit - (g - t) * (g - t)),
151
+ );
152
+ const beyond: boolean = t > a.limit || g - t > b.limit;
153
+ return {
154
+ share: g > 1e-9 ? t / g : 0,
155
+ low: beyond
156
+ ? Infinity
157
+ : Math.max(a.shoulder.y - reachA, b.shoulder.y - reachB),
158
+ high: beyond
159
+ ? -Infinity
160
+ : Math.min(a.shoulder.y + reachA, b.shoulder.y + reachB),
161
+ };
81
162
  };
82
- const [low, high] = shared(half);
83
- if (half > Math.min(input.a.limit, input.b.limit) || low > high) {
84
- // The widest closable gap, by bisection on the half gap: the shared band
85
- // only narrows as the gap widens.
163
+ const { share, low, high } = meet(gap);
164
+ if (low > high) {
165
+ // The widest closable gap, by bisection: the shared band only narrows as
166
+ // the gap widens.
86
167
  let lo: number = 0;
87
- let hi: number = Math.min(input.a.limit, input.b.limit);
168
+ let hi: number = a.limit + b.limit;
88
169
  for (let i: number = 0; i < 50; i++) {
89
170
  const mid: number = (lo + hi) / 2;
90
- const [l, u] = shared(mid);
91
- if (l <= u) lo = mid;
171
+ const band = meet(mid);
172
+ if (band.low <= band.high) lo = mid;
92
173
  else hi = mid;
93
174
  }
94
- throw new Error(
95
- `The hands cannot meet: no height lies within both arms' reach of ${input.a.limit.toFixed(3)} m and ${input.b.limit.toFixed(3)} m at a shoulder gap of ${(2 * half).toFixed(3)} m; bring the shoulders within about ${(2 * lo).toFixed(3)} m of each other`,
96
- );
175
+ throw refuse(lo);
97
176
  }
98
- const point: IAutoMovieVector3 = {
99
- x: (input.a.shoulder.x + input.b.shoulder.x) / 2,
100
- y: Math.min(high, Math.max(low, (height(input.a) + height(input.b)) / 2)),
101
- z: (input.a.shoulder.z + input.b.shoulder.z) / 2,
102
- };
103
- const distance: [number, number] = [
104
- Vector3.length(Vector3.subtract(point, input.a.shoulder)),
105
- Vector3.length(Vector3.subtract(point, input.b.shoulder)),
106
- ];
107
- return { point, distance };
177
+ return done({
178
+ x: a.shoulder.x + share * span.x,
179
+ y: Math.min(high, Math.max(low, preferred)),
180
+ z: a.shoulder.z + share * span.z,
181
+ });
108
182
  }
109
183
 
110
184
  /**
@@ -113,7 +187,7 @@ export function resolveAutoMovieMutualGoal(input: {
113
187
  * @evidence contracts/development/common.md#meaningful-documentation Documents each member's unit and frame.
114
188
  * @evidence contracts/development/design.md#principled-representation A world shoulder with two reach lengths per side; a world point with two distances.
115
189
  * @evidence contracts/development/design.md#minimal-and-owned-surface What a two-person reaching law passes and reads.
116
- * @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and its arm lengths.
190
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No body type: any rig supplies a shoulder and two lengths.
117
191
  */
118
192
  export namespace resolveAutoMovieMutualGoal {
119
193
  /** One person's acting arm. */
@@ -1,6 +1,8 @@
1
1
  import type { IAutoMovieMotionEvent } from "@automovie/interface";
2
2
 
3
3
  import type { AutoMovieComposition } from "./AutoMovieComposition";
4
+ import { AutoMovieSchedulePlace } from "./AutoMovieSchedulePlace";
5
+ import { AutoMovieScheduleWalk } from "./AutoMovieScheduleWalk";
4
6
  import type { IAutoMovieIntent } from "./IAutoMovieIntent";
5
7
  import type { IAutoMovieSchedule } from "./IAutoMovieSchedule";
6
8
 
@@ -12,9 +14,15 @@ import type { IAutoMovieSchedule } from "./IAutoMovieSchedule";
12
14
  * start and ends at the latest end; `at` starts its part at the named
13
15
  * anchor's contact instant (its start when the timing gives no contact) plus
14
16
  * the offset, and the walk continues after the later of the cursor and that
15
- * part's end. An intent with `until` ends at its cut (a share of its
16
- * duration, or the share of one of the events its timing names) and drops a
17
- * contact after the cut; the entry records the cut, and the entry the next
17
+ * part's end. An `at` that names an `event` reads that instant of the anchor,
18
+ * which may then be a cue track of the laws, and one that names `align` asks
19
+ * the laws' `align` when its part must start for that instant of the part's
20
+ * first intent to fall there. An intent with `until` ends at its cut (a share of its
21
+ * duration, the share of one of the events its timing names, or the share at
22
+ * which the `until` law finds a proximity) and drops a contact after the cut;
23
+ * a proximity the law reports as never met leaves the intent uncut, so it
24
+ * runs to its end, while laws with no `until` at all cannot place a proximity
25
+ * cut and throw; the entry records the cut, and the entry the next
18
26
  * part of a sequence places there records it as `interruptedBy`. For each
19
27
  * intent the production's `timing` gives its duration
20
28
  * and optional contact offset, then `outcome` and `state` read the entries
@@ -25,10 +33,10 @@ import type { IAutoMovieSchedule } from "./IAutoMovieSchedule";
25
33
  * @param laws The production's pure timing, outcome and state functions.
26
34
  * @returns The frozen schedule.
27
35
  * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (Place a composition on the film clock with the production's pure laws) and documents parameters `composition`, `laws`, the returned value as stated in this comment.
28
- * @evidence contracts/development/implementation.md#principled-implementation Implements the documented behavior (Place a composition on the film clock with the production's pure laws) directly over its typed inputs (`composition`, `laws`) as 4 sequential passes (reduce over node.parts; reduce over node.parts; map over sorted) plus a sort, delegating to `laws.timing`, `Number.isFinite`, `laws.outcome`, `laws.state`, `entries.push`; the premises are the units, frames and ranges stated in its parameter documentation, enforced only where the body throws (4 throw sites). Apart from structural 0, 1 and 2 the body uses no numeric literal.
29
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One operation of 78 lines and 6 top-level statements that reuses `laws.timing`, `Number.isFinite`, `laws.outcome`, `laws.state`, `entries.push` from their owners instead of copying them; it adds no option, layer or abstraction beyond its documented parameters.
30
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Scanning the body finds no `any`, type assertion, non-null assertion, suppression directive or TODO, and no branch keyed on a consumer, fixture or expected answer; values come from its parameters.
31
- * @evidence contracts/development/implementation.md#efficient-algorithms Cost is driven by the sizes of `composition`, `laws`; the dominant cost is 4 sequential passes (reduce over node.parts; reduce over node.parts; map over sorted) plus a sort, performed once per call with 17 allocation sites (literals and constructed values). No speedup is claimed and none is measured.
36
+ * @evidence contracts/development/implementation.md#principled-implementation A single depth-first walk of the composition tree in declaration order, the interval-placement scheme of a timeline composer: a sequence chains ends to starts, a parallel group takes the latest end, an `at` takes an anchor's instant plus an offset. The premises are seconds on the film clock, the laws being pure (the same inputs give the same schedule, and an aligned part is timed again at the start `laws.align` returns), and every reference resolving to a placed anchor, a cue track or an event, which the walk checks and refuses with an `AutoMovieScheduleError` naming the code, the subject and capability, the value and the alternatives (anchor, event, index, duplicate, share, timing and law). A cut is a share in [0, 1] of the duration, found from a share, an own event, another anchor's or a cue track's event, or the `until` law's proximity share; a proximity never met cuts nothing. A start-aligned part places once, an aligned one asks `laws.align` first.
37
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One recursive `place` over the four node kinds: the sequence and the group are its own joints, an intent and an `at` are placed by `AutoMovieSchedulePlace`, the cut by `AutoMovieScheduleCut`, and the instant lookups and the walk's state are `AutoMovieScheduleWalk`'s; the error shapes sit in `AutoMovieScheduleError`.
38
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Scanning the body finds no `any`, suppression directive or TODO, and no branch keyed on a consumer, fixture or expected answer; two non-null assertions (`entries[first]!`, `interrupted.get(e.index)!`) follow a length or `has` check. The only numeric literals are the structural 0 and 1 of the [0, 1] share range and indices; every value comes from the composition or the laws.
39
+ * @evidence contracts/development/implementation.md#efficient-algorithms One pass over the n nodes of the composition; each anchor lookup is a map read, and each event lookup builds the anchor's instants and filters them, O(e) in that anchor's events. The result is one sort of the m entries, O(m log m), and one loop over their ends for the duration. No speedup is claimed and none is measured.
32
40
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work The operation coordinates no requests, phases or consumers and holds no cache: each call recomputes from its arguments and shares nothing, which is correct because its result depends only on them.
33
41
  * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources The function acquires no handle, timer, listener or task and keeps no state between calls; its 17 allocation sites become the returned value or die with the call, so nothing grows.
34
42
  */
@@ -36,136 +44,23 @@ export function resolveAutoMovieSchedule(
36
44
  composition: AutoMovieComposition,
37
45
  laws: resolveAutoMovieSchedule.ILaws,
38
46
  ): IAutoMovieSchedule {
39
- const entries: IAutoMovieSchedule.IEntry[] = [];
40
- const anchors: Map<string, number> = new Map();
41
- const interrupted: Map<number, number> = new Map();
42
- const anchored: Map<string, IAutoMovieSchedule.IEntry> = new Map();
47
+ const walk: AutoMovieScheduleWalk.IWalk = AutoMovieScheduleWalk.create(laws);
43
48
  const place = (node: AutoMovieComposition, start: number): number => {
44
- if (node.kind === "intent") {
45
- const context: resolveAutoMovieSchedule.IContext = { start, entries };
46
- const timing: resolveAutoMovieSchedule.ITiming = laws.timing(
47
- node.intent,
48
- context,
49
- );
50
- if (!(timing.duration >= 0) || !Number.isFinite(timing.duration))
51
- throw new Error(
52
- `Invalid duration of ${node.intent.subject}.${node.intent.capability}`,
53
- );
54
- if (
55
- timing.contact !== undefined &&
56
- !(timing.contact >= 0 && timing.contact <= timing.duration)
57
- )
58
- throw new Error(
59
- `Contact outside ${node.intent.subject}.${node.intent.capability}`,
60
- );
61
- // A cut ends the entry early at a share or a named event; a contact
62
- // after the cut never happens.
63
- const until: IAutoMovieIntent["until"] = node.intent.until;
64
- let cut: { share: number; event?: string } | undefined;
65
- if (until !== undefined) {
66
- if ("proximity" in until) {
67
- const share: number | undefined = laws.until?.(
68
- node.intent,
69
- { start, duration: timing.duration },
70
- context,
71
- );
72
- if (share === undefined)
73
- throw new Error(
74
- `${node.intent.subject}.${node.intent.capability} cuts on proximity, which these laws cannot resolve`,
75
- );
76
- cut = { share };
77
- } else if ("of" in until) {
78
- const other: IAutoMovieSchedule.IEntry | undefined = anchored.get(
79
- until.of,
80
- );
81
- if (other === undefined)
82
- throw new Error(
83
- `Cut of ${node.intent.subject}.${node.intent.capability} waits for ${until.of}, which is not placed earlier`,
84
- );
85
- const event: { name: string; seconds: number } | undefined =
86
- other.events?.find(
87
- (e: { name: string; seconds: number }): boolean =>
88
- e.name === until.event,
89
- );
90
- if (event === undefined)
91
- throw new Error(
92
- `${until.of} has no event ${until.event}; its events are ${(other.events ?? []).map((e: { name: string }): string => e.name).join(", ") || "none"}`,
93
- );
94
- cut = {
95
- share:
96
- timing.duration === 0
97
- ? 0
98
- : (event.seconds - start) / timing.duration,
99
- event: `${until.of}.${until.event}`,
100
- };
101
- } else if ("event" in until) {
102
- const event: IAutoMovieMotionEvent | undefined = timing.events?.find(
103
- (e: IAutoMovieMotionEvent): boolean => e.name === until.event,
104
- );
105
- if (event === undefined)
106
- throw new Error(
107
- `${node.intent.subject}.${node.intent.capability} has no event ${until.event}; its events are ${(timing.events ?? []).map((e: IAutoMovieMotionEvent): string => e.name).join(", ") || "none"}`,
108
- );
109
- cut = { share: event.share, event: event.name };
110
- } else cut = { share: until.share };
111
- if (!(cut.share >= 0 && cut.share <= 1))
112
- throw new Error(
113
- `Cut share of ${node.intent.subject}.${node.intent.capability} lies outside [0, 1]`,
114
- );
115
- }
116
- const length: number =
117
- cut === undefined ? timing.duration : cut.share * timing.duration;
118
- const draft: IAutoMovieSchedule.IEntry = {
119
- index: entries.length,
120
- subject: node.intent.subject,
121
- intent: node.intent,
122
- start,
123
- ...(timing.contact === undefined || timing.contact > length
124
- ? {}
125
- : { contact: start + timing.contact }),
126
- end: start + length,
127
- ...(cut === undefined ? {} : { cut }),
128
- ...(timing.events === undefined
129
- ? {}
130
- : {
131
- events: timing.events.map(
132
- (
133
- e: IAutoMovieMotionEvent,
134
- ): { name: string; seconds: number } => ({
135
- name: e.name,
136
- seconds: start + e.share * timing.duration,
137
- }),
138
- ),
139
- }),
140
- };
141
- const outcome: string | undefined = laws.outcome?.(draft, context);
142
- const state: unknown = laws.state?.(draft, context);
143
- entries.push({
144
- ...draft,
145
- ...(outcome === undefined ? {} : { outcome }),
146
- ...(state === undefined ? {} : { state }),
147
- });
148
- if (node.intent.anchor !== undefined) {
149
- if (anchors.has(node.intent.anchor))
150
- throw new Error(`Duplicate composition anchor ${node.intent.anchor}`);
151
- anchors.set(node.intent.anchor, draft.contact ?? start);
152
- anchored.set(node.intent.anchor, draft);
153
- }
154
- return draft.end;
155
- }
49
+ if (node.kind === "intent")
50
+ return AutoMovieSchedulePlace.intent(walk, node.intent, start);
156
51
  if (node.kind === "sequence") {
157
52
  // The entry an intent's cut interrupts is the first one the next part places.
158
53
  let cutIndex: number | undefined;
159
54
  return node.parts.reduce(
160
55
  (at: number, part: AutoMovieComposition): number => {
161
- const first: number = entries.length;
56
+ const first: number = walk.entries.length;
162
57
  const end: number = place(part, at);
163
- if (cutIndex !== undefined && entries.length > first)
164
- interrupted.set(cutIndex, first);
58
+ if (cutIndex !== undefined && walk.entries.length > first)
59
+ walk.interrupted.set(cutIndex, first);
165
60
  cutIndex =
166
61
  part.kind === "intent" &&
167
- entries.length === first + 1 &&
168
- entries[first]!.cut !== undefined
62
+ walk.entries.length === first + 1 &&
63
+ walk.entries[first]!.cut !== undefined
169
64
  ? first
170
65
  : undefined;
171
66
  return end;
@@ -179,41 +74,37 @@ export function resolveAutoMovieSchedule(
179
74
  Math.max(end, place(part, start)),
180
75
  start,
181
76
  );
182
- const anchor: number | undefined = anchors.get(node.anchor);
183
- if (anchor === undefined)
184
- throw new Error(
185
- `Composition anchor ${node.anchor} is not placed earlier`,
186
- );
187
- return Math.max(start, place(node.part, anchor + node.offset));
77
+ return AutoMovieSchedulePlace.at(walk, node, start, place);
188
78
  };
189
79
  const end: number = place(composition, 0);
190
- const sorted: IAutoMovieSchedule.IEntry[] = [...entries].sort(
80
+ const sorted: IAutoMovieSchedule.IEntry[] = [...walk.entries].sort(
191
81
  (a: IAutoMovieSchedule.IEntry, b: IAutoMovieSchedule.IEntry): number =>
192
82
  a.start - b.start || a.index - b.index,
193
83
  );
84
+ let duration: number = end;
85
+ for (const entry of walk.entries)
86
+ if (entry.end > duration) duration = entry.end;
194
87
  return Object.freeze({
195
88
  entries: Object.freeze(
196
89
  sorted.map((e: IAutoMovieSchedule.IEntry) =>
197
90
  Object.freeze(
198
- interrupted.has(e.index)
199
- ? { ...e, interruptedBy: interrupted.get(e.index)! }
91
+ walk.interrupted.has(e.index)
92
+ ? { ...e, interruptedBy: walk.interrupted.get(e.index)! }
200
93
  : e,
201
94
  ),
202
95
  ),
203
96
  ),
204
- duration: Math.max(
205
- end,
206
- ...entries.map((e: IAutoMovieSchedule.IEntry): number => e.end),
207
- ),
97
+ duration,
208
98
  });
209
99
  }
100
+
210
101
  /**
211
102
  * Companion types of {@link resolveAutoMovieSchedule}.
212
103
  *
213
- * @evidence contracts/development/common.md#meaningful-documentation Gives the purpose (Companion types of ) and documents 3 documented members as stated in this comment.
214
- * @evidence contracts/development/design.md#principled-representation Represents Companion types of : companion namespace of 3 members (`IContext`, `ITiming`, `ILaws`); units and frames named in its text: seconds. It has no optional member, so no absent-value state combines with another.
215
- * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the module that declares `resolveAutoMovieSchedule` in packages/engine/src/composition/resolveAutoMovieSchedule.ts; its surface is the 3 members listed and the text shows 8 other files naming it, mostly movies (5), packages/engine (2), test (1), so no member is declared for a presumed future need.
216
- * @evidence contracts/development/design.md#prohibited-design-shortcuts Scanning the declaration finds no `any`, a use of `unknown`, no index signature and no cast; 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.
104
+ * @evidence contracts/development/common.md#meaningful-documentation Documents each of the 5 members (`IContext`, `IAlignment`, `ITiming`, `ICue`, `ILaws`): what the laws see, in film seconds, and what each law returns or leaves absent.
105
+ * @evidence contracts/development/design.md#principled-representation Companion namespace of 5 members; every time is seconds on the film clock, a cut is a share of the duration, and the optional laws (`cues`, `align`, `until`, `outcome`, `state`) state what an absent one means: no tracks, an alignment or proximity cut that throws a `law` error, no outcome, no state.
106
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by `resolveAutoMovieSchedule`, whose `laws` argument is typed by `ILaws`; the motions' performance supplies the laws and reads `IContext`, `IAlignment` and `ICue`, so no member is declared for a presumed future need.
107
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts The one widening is `ILaws.state`, which returns `unknown` because the production owns the shape of its state snapshot and the engine only stores it on the entry; there is no `any`, no index signature and no cast, and the types of `@automovie/interface` are imported, not duplicated.
217
108
  */
218
109
  export namespace resolveAutoMovieSchedule {
219
110
  /** What the laws see while an intent is placed. */
@@ -225,6 +116,32 @@ export namespace resolveAutoMovieSchedule {
225
116
  entries: readonly IAutoMovieSchedule.IEntry[];
226
117
  }
227
118
 
119
+ /**
120
+ * What the laws see while an aligned part's start is found: the placing
121
+ * context, and the instant the part is aligned to with every instant the
122
+ * same anchor or track offers, so laws that cannot meet the one asked can
123
+ * say which later one they can.
124
+ */
125
+ export interface IAlignment extends IContext {
126
+ /** The instant aligned to. */
127
+ anchor: {
128
+ /** The anchor or cue track. */
129
+ of: string;
130
+
131
+ /** The event named; the anchor's contact or start when absent. */
132
+ event?: string;
133
+
134
+ /** The occurrence of the event, from 0; the first when absent. */
135
+ index?: number;
136
+
137
+ /** Seconds added to the instant. */
138
+ offset: number;
139
+
140
+ /** Every named instant of the anchor or track, in film seconds. */
141
+ instants: readonly ICue[];
142
+ };
143
+ }
144
+
228
145
  /** An intent's timing. */
229
146
  export interface ITiming {
230
147
  /** Seconds the intent takes; nonnegative. */
@@ -237,8 +154,52 @@ export namespace resolveAutoMovieSchedule {
237
154
  events?: readonly IAutoMovieMotionEvent[];
238
155
  }
239
156
 
157
+ /** A named instant of a cue track or of a placed entry. */
158
+ export interface ICue {
159
+ /** The instant's name; a track may repeat one, as a score repeats `beat`. */
160
+ name: string;
161
+
162
+ /** Film seconds. */
163
+ seconds: number;
164
+ }
165
+
240
166
  /** The production's pure laws. */
241
167
  export interface ILaws {
168
+ /**
169
+ * Tracks of named instants that belong to no intent, by track name: a
170
+ * dialogue's line starts and accents, a score's beats. A part aligns to
171
+ * one and an intent is cut on one as on an anchored intent's events.
172
+ */
173
+ cues?: Readonly<Record<string, readonly ICue[]>>;
174
+
175
+ /**
176
+ * The instants of a track the laws compute from what is placed so far,
177
+ * read when an `at` names neither an anchor nor a track of `cues`: the
178
+ * hits a struck person has received, known only once their strikers
179
+ * are placed. Undefined for a name the laws do not know, which the
180
+ * walk then refuses as a missing anchor. Pure in the entries given.
181
+ *
182
+ * @param of The track's name.
183
+ * @param entries Entries placed so far, in walk order.
184
+ * @returns The instants, or undefined.
185
+ */
186
+ instants?(
187
+ of: string,
188
+ entries: readonly IAutoMovieSchedule.IEntry[],
189
+ ): readonly ICue[] | undefined;
190
+
191
+ /**
192
+ * The second an intent must start at for its named instant to fall on a
193
+ * target second. It places nothing: the intent is timed again when it
194
+ * is placed at the second returned.
195
+ */
196
+ align?(
197
+ intent: IAutoMovieIntent,
198
+ instant: string,
199
+ target: number,
200
+ context: IAlignment,
201
+ ): number;
202
+
242
203
  /** Duration and contact of an intent. */
243
204
  timing(intent: IAutoMovieIntent, context: IContext): ITiming;
244
205
 
@@ -14,6 +14,7 @@ import { HUMANOID_JOINT_AXES } from "./kinematics/constants/HUMANOID_JOINT_AXES"
14
14
  import { resolvePose } from "./kinematics/resolvePose";
15
15
  import { sampleMotion } from "./motion/sampleMotion";
16
16
  import { sampleClipSequence } from "./resolve/sampleClipSequence";
17
+ import { Transform } from "./math/Transform";
17
18
 
18
19
  /**
19
20
  * Read actor roots, bones and pose summaries from borrowed compiled shots at shot-local seconds; ambiguous actors and unresolved records throw.
@@ -125,7 +126,7 @@ const resolveSelector: (
125
126
  spatial.poseRoot === null
126
127
  ? bone.worldPosition
127
128
  : placeTransformedPoint(
128
- { ...spatial.poseRoot, scale: { x: 1, y: 1, z: 1 } },
129
+ Transform.of(spatial.poseRoot.translation, spatial.poseRoot.rotation),
129
130
  bone.worldPosition,
130
131
  );
131
132
  return placeTransformedPoint(spatial.nodeTransform, rootPoint);