@automovie/engine 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (966) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/analysis/index.d.ts +5 -0
  4. package/lib/analysis/index.js +5 -0
  5. package/lib/analysis/index.js.map +1 -1
  6. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  7. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  8. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  9. package/lib/anthropometry/index.d.ts +1 -0
  10. package/lib/anthropometry/index.js +18 -0
  11. package/lib/anthropometry/index.js.map +1 -0
  12. package/lib/architecture/appendBuiltRegionDefects.d.ts +1 -1
  13. package/lib/architecture/appendBuiltRegionDefects.js +3 -3
  14. package/lib/architecture/appendBuiltRegionDefects.js.map +1 -1
  15. package/lib/architecture/builtOutlineIsClosed.d.ts +1 -1
  16. package/lib/architecture/builtOutlineIsClosed.js +3 -3
  17. package/lib/architecture/builtOutlineIsClosed.js.map +1 -1
  18. package/{src/architecture/constants/PLANAR_EPSILON.ts → lib/architecture/constants/BUILT_PLANAR_EPSILON.d.ts} +1 -1
  19. package/lib/architecture/constants/{PLANAR_EPSILON.js → BUILT_PLANAR_EPSILON.js} +3 -3
  20. package/lib/architecture/constants/BUILT_PLANAR_EPSILON.js.map +1 -0
  21. package/lib/architecture/constants/index.d.ts +1 -1
  22. package/lib/architecture/constants/index.js +1 -1
  23. package/lib/architecture/constants/index.js.map +1 -1
  24. package/lib/architecture/index.d.ts +157 -117
  25. package/lib/architecture/index.js +171 -158
  26. package/lib/architecture/index.js.map +1 -1
  27. package/lib/cache/index.d.ts +9 -0
  28. package/lib/cache/index.js +26 -0
  29. package/lib/cache/index.js.map +1 -0
  30. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  31. package/lib/composition/AutoMovieComposition.js +4 -3
  32. package/lib/composition/AutoMovieComposition.js.map +1 -1
  33. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  34. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  35. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  36. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  37. package/lib/composition/AutoMovieScheduleError.js +51 -0
  38. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  39. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  40. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  41. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  42. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  43. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  44. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  45. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  46. package/lib/composition/index.d.ts +12 -7
  47. package/lib/composition/index.js +12 -2
  48. package/lib/composition/index.js.map +1 -1
  49. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  50. package/lib/composition/markAutoMovieContacts.js +69 -0
  51. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  52. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  53. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  54. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  55. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  56. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  57. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  58. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  59. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  60. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  61. package/lib/constants/index.d.ts +2 -0
  62. package/lib/constants/index.js +2 -0
  63. package/lib/constants/index.js.map +1 -1
  64. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  65. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  66. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  67. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  68. package/lib/drawing/index.d.ts +12 -0
  69. package/lib/drawing/index.js +12 -0
  70. package/lib/drawing/index.js.map +1 -1
  71. package/lib/effectRuntime/index.d.ts +7 -0
  72. package/lib/effectRuntime/index.js +7 -0
  73. package/lib/effectRuntime/index.js.map +1 -1
  74. package/lib/film/compileAttach.js +2 -5
  75. package/lib/film/compileAttach.js.map +1 -1
  76. package/lib/film/compileLaunch.d.ts +2 -2
  77. package/lib/film/compileLaunch.js +4 -3
  78. package/lib/film/compileLaunch.js.map +1 -1
  79. package/lib/film/constants/index.d.ts +3 -0
  80. package/lib/film/constants/index.js +3 -0
  81. package/lib/film/constants/index.js.map +1 -1
  82. package/lib/film/index.d.ts +61 -6
  83. package/lib/film/index.js +61 -12
  84. package/lib/film/index.js.map +1 -1
  85. package/lib/film/propAnchorFrame.js +6 -9
  86. package/lib/film/propAnchorFrame.js.map +1 -1
  87. package/lib/film/stageScene.js +3 -10
  88. package/lib/film/stageScene.js.map +1 -1
  89. package/lib/film/staging/index.d.ts +11 -0
  90. package/lib/film/staging/index.js +28 -0
  91. package/lib/film/staging/index.js.map +1 -0
  92. package/lib/film/staging/lowerLightPlacement.js +4 -7
  93. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  94. package/lib/formationSlotPosition.d.ts +6 -1
  95. package/lib/formationSlotPosition.js +38 -3
  96. package/lib/formationSlotPosition.js.map +1 -1
  97. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  98. package/lib/geometry/IAutoMovieMark.js +3 -0
  99. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  100. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  101. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  102. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  103. package/lib/geometry/constants/index.d.ts +2 -0
  104. package/lib/geometry/constants/index.js +2 -0
  105. package/lib/geometry/constants/index.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  107. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  108. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  109. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  110. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  111. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  112. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  113. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  114. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  115. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  116. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  117. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  118. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  120. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  121. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  123. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  124. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  125. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  126. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  127. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  128. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  129. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  130. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  131. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  132. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  133. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  135. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  136. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  137. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  138. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  139. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  140. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  141. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  142. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  143. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  144. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  145. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  146. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  147. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  148. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  149. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  150. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  151. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  152. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  153. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  154. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  155. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  156. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  157. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  158. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  159. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  160. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  161. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  162. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  163. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  164. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  165. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  166. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  167. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  168. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  169. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  170. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  171. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  172. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  173. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  174. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  175. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  176. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  177. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  178. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  179. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  180. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  181. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  182. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  183. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  184. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  185. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  186. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  187. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  188. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  189. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  190. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  191. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  192. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  193. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  194. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  195. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  196. package/lib/geometry/construction/index.d.ts +82 -2
  197. package/lib/geometry/construction/index.js +82 -2
  198. package/lib/geometry/construction/index.js.map +1 -1
  199. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  200. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  201. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  202. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  203. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  204. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  205. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  206. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  207. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  208. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  209. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  210. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  211. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  212. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  213. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  214. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  215. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  216. package/lib/geometry/curve/index.d.ts +48 -25
  217. package/lib/geometry/curve/index.js +48 -25
  218. package/lib/geometry/curve/index.js.map +1 -1
  219. package/lib/geometry/extract/index.d.ts +0 -1
  220. package/lib/geometry/extract/index.js +0 -1
  221. package/lib/geometry/extract/index.js.map +1 -1
  222. package/lib/geometry/index.d.ts +87 -53
  223. package/lib/geometry/index.js +87 -50
  224. package/lib/geometry/index.js.map +1 -1
  225. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  226. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  227. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  228. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  229. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  230. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  231. package/lib/geometry/sweep/index.d.ts +54 -15
  232. package/lib/geometry/sweep/index.js +54 -1
  233. package/lib/geometry/sweep/index.js.map +1 -1
  234. package/lib/index.d.ts +41 -450
  235. package/lib/index.js +41 -660
  236. package/lib/index.js.map +1 -1
  237. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  238. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  239. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  240. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  241. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  242. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  243. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  244. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  245. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  246. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  247. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  248. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  249. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  250. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  251. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  252. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  253. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  254. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  255. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  256. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  257. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  258. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  259. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  260. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  261. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  262. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  263. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  264. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  265. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  266. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  267. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  268. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  269. package/lib/kinematics/curlChainUntilContact.js +45 -5
  270. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  271. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  272. package/lib/kinematics/decomposeJointRotation.js +10 -131
  273. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  274. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  275. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  276. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  277. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  278. package/lib/kinematics/fitDigitDescent.js +142 -0
  279. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  280. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  281. package/lib/kinematics/fitDigitToTarget.js +251 -0
  282. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  283. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  284. package/lib/kinematics/hingedArmArticulation.js +273 -84
  285. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  286. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  287. package/lib/kinematics/hingedArmSwivel.js +196 -0
  288. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  289. package/lib/kinematics/index.d.ts +30 -7
  290. package/lib/kinematics/index.js +30 -5
  291. package/lib/kinematics/index.js.map +1 -1
  292. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  293. package/lib/kinematics/jointRomOvershoot.js +21 -17
  294. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  295. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  296. package/lib/kinematics/jointToQuaternion.js +4 -19
  297. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  298. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  299. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  300. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  301. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  302. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  303. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  304. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  305. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  306. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  307. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  308. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  309. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  310. package/lib/kinematics/normalizeJointAxes.js +52 -12
  311. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  312. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  313. package/lib/kinematics/poseJointCodec.js +70 -0
  314. package/lib/kinematics/poseJointCodec.js.map +1 -0
  315. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  316. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  317. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  318. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  319. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  320. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  321. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  322. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  323. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  324. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  325. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  326. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  327. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  328. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  329. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  330. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  331. package/lib/kinematics/swingTwistBasis.js +116 -0
  332. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  333. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  334. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  335. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  336. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  337. package/lib/kinematics/swingTwistRange.js +322 -0
  338. package/lib/kinematics/swingTwistRange.js.map +1 -0
  339. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  340. package/lib/kinematics/swingTwistRegion.js +212 -0
  341. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  342. package/lib/kinematics/swivelArcs.d.ts +166 -0
  343. package/lib/kinematics/swivelArcs.js +200 -0
  344. package/lib/kinematics/swivelArcs.js.map +1 -0
  345. package/lib/math/Quaternion.d.ts +29 -2
  346. package/lib/math/Quaternion.js +33 -2
  347. package/lib/math/Quaternion.js.map +1 -1
  348. package/lib/math/Transform.d.ts +50 -0
  349. package/lib/math/Transform.js +58 -0
  350. package/lib/math/Transform.js.map +1 -0
  351. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  352. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  353. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  354. package/lib/math/bracketedBisection.d.ts +33 -0
  355. package/lib/math/bracketedBisection.js +52 -0
  356. package/lib/math/bracketedBisection.js.map +1 -0
  357. package/lib/math/bracketedRoot.d.ts +32 -0
  358. package/lib/math/bracketedRoot.js +76 -0
  359. package/lib/math/bracketedRoot.js.map +1 -0
  360. package/lib/math/constants/index.d.ts +1 -0
  361. package/lib/math/constants/index.js +18 -0
  362. package/lib/math/constants/index.js.map +1 -0
  363. package/lib/math/index.d.ts +64 -5
  364. package/lib/math/index.js +64 -5
  365. package/lib/math/index.js.map +1 -1
  366. package/lib/math/nearestAngleAlias.d.ts +27 -0
  367. package/lib/math/nearestAngleAlias.js +44 -0
  368. package/lib/math/nearestAngleAlias.js.map +1 -0
  369. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  370. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  371. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  372. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  373. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  374. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  375. package/lib/measureAutoMovieGeometryReach.js +2 -4
  376. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  377. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  378. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  379. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  380. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  381. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  382. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  383. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  384. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  385. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  386. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  387. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  388. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  389. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  390. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  391. package/lib/motion/basisOf.d.ts +18 -0
  392. package/lib/motion/basisOf.js +25 -0
  393. package/lib/motion/basisOf.js.map +1 -0
  394. package/lib/motion/carriedAcceleration.d.ts +43 -0
  395. package/lib/motion/carriedAcceleration.js +55 -0
  396. package/lib/motion/carriedAcceleration.js.map +1 -0
  397. package/lib/motion/carriedRate.d.ts +48 -0
  398. package/lib/motion/carriedRate.js +60 -0
  399. package/lib/motion/carriedRate.js.map +1 -0
  400. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  401. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  402. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  403. package/lib/motion/constants/index.d.ts +1 -0
  404. package/lib/motion/constants/index.js +1 -0
  405. package/lib/motion/constants/index.js.map +1 -1
  406. package/lib/motion/fitChainBend.d.ts +23 -0
  407. package/lib/motion/fitChainBend.js +293 -0
  408. package/lib/motion/fitChainBend.js.map +1 -0
  409. package/lib/motion/fitChainToTarget.d.ts +11 -13
  410. package/lib/motion/fitChainToTarget.js +12 -283
  411. package/lib/motion/fitChainToTarget.js.map +1 -1
  412. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  413. package/lib/motion/fitHingedChainCandidate.js +186 -76
  414. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  415. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  416. package/lib/motion/fitHingedRotationError.js +107 -0
  417. package/lib/motion/fitHingedRotationError.js.map +1 -0
  418. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  419. package/lib/motion/fitSeededChainToTarget.js +32 -0
  420. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  421. package/lib/motion/gaitMotion.js +7 -13
  422. package/lib/motion/gaitMotion.js.map +1 -1
  423. package/lib/motion/gestureMotion.js +2 -5
  424. package/lib/motion/gestureMotion.js.map +1 -1
  425. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  426. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  427. package/lib/motion/index.d.ts +40 -9
  428. package/lib/motion/index.js +40 -12
  429. package/lib/motion/index.js.map +1 -1
  430. package/lib/motion/inertializeOffset.d.ts +15 -2
  431. package/lib/motion/inertializeOffset.js +16 -3
  432. package/lib/motion/inertializeOffset.js.map +1 -1
  433. package/lib/motion/inertializePose.d.ts +36 -13
  434. package/lib/motion/inertializePose.js +122 -43
  435. package/lib/motion/inertializePose.js.map +1 -1
  436. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  437. package/lib/motion/integrateAirborneRotation.js +204 -0
  438. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  439. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  440. package/lib/motion/integrateMotionTrajectory.js +156 -0
  441. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  442. package/lib/motion/orientChainEffector.d.ts +1 -1
  443. package/lib/motion/orientChainEffector.js +15 -7
  444. package/lib/motion/orientChainEffector.js.map +1 -1
  445. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  446. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  447. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  448. package/lib/motion/sampleMotion.js +2 -5
  449. package/lib/motion/sampleMotion.js.map +1 -1
  450. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  451. package/lib/motion/samplePoseVelocity.js +126 -38
  452. package/lib/motion/samplePoseVelocity.js.map +1 -1
  453. package/lib/motion/smoothMinimum.d.ts +29 -0
  454. package/lib/motion/smoothMinimum.js +40 -0
  455. package/lib/motion/smoothMinimum.js.map +1 -0
  456. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  457. package/lib/motion/solveAirborneTakeoff.js +324 -0
  458. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  459. package/lib/motion/solveDistalTwist.d.ts +62 -0
  460. package/lib/motion/solveDistalTwist.js +152 -0
  461. package/lib/motion/solveDistalTwist.js.map +1 -0
  462. package/lib/motion/speedProfile.d.ts +175 -0
  463. package/lib/motion/speedProfile.js +261 -0
  464. package/lib/motion/speedProfile.js.map +1 -0
  465. package/lib/motion/splitDistalTwist.d.ts +12 -17
  466. package/lib/motion/splitDistalTwist.js +37 -40
  467. package/lib/motion/splitDistalTwist.js.map +1 -1
  468. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  469. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  470. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  471. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  472. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  473. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  474. package/lib/perform/index.d.ts +10 -0
  475. package/lib/perform/index.js +10 -0
  476. package/lib/perform/index.js.map +1 -1
  477. package/lib/physics/AutoMovieAir.d.ts +21 -0
  478. package/lib/physics/AutoMovieAir.js +26 -0
  479. package/lib/physics/AutoMovieAir.js.map +1 -0
  480. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  481. package/lib/physics/AutoMovieGravity.js +30 -0
  482. package/lib/physics/AutoMovieGravity.js.map +1 -0
  483. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  484. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  485. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  486. package/lib/physics/admitMotionGeometry.js +12 -0
  487. package/lib/physics/admitMotionGeometry.js.map +1 -1
  488. package/lib/physics/bindPhysicalWorld.js +16 -4
  489. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  490. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  491. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  492. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  493. package/lib/physics/deriveCenterOfMass.js +2 -5
  494. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  495. package/lib/physics/derivePhysicalProfile.js +7 -5
  496. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  497. package/lib/physics/index.d.ts +155 -2
  498. package/lib/physics/index.js +155 -2
  499. package/lib/physics/index.js.map +1 -1
  500. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  501. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  502. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  503. package/lib/physics/physicalHullErode.d.ts +25 -0
  504. package/lib/physics/physicalHullErode.js +54 -0
  505. package/lib/physics/physicalHullErode.js.map +1 -0
  506. package/lib/physics/physicalHullFaces.d.ts +56 -0
  507. package/lib/physics/physicalHullFaces.js +151 -0
  508. package/lib/physics/physicalHullFaces.js.map +1 -0
  509. package/lib/physics/physicalHullMass.d.ts +32 -0
  510. package/lib/physics/physicalHullMass.js +80 -0
  511. package/lib/physics/physicalHullMass.js.map +1 -0
  512. package/lib/physics/physicalHullNearest.d.ts +37 -0
  513. package/lib/physics/physicalHullNearest.js +178 -0
  514. package/lib/physics/physicalHullNearest.js.map +1 -0
  515. package/lib/physics/physicalHullSegment.d.ts +34 -0
  516. package/lib/physics/physicalHullSegment.js +276 -0
  517. package/lib/physics/physicalHullSegment.js.map +1 -0
  518. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  519. package/lib/physics/physicalInertiaTensor.js +58 -0
  520. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  521. package/lib/physics/physicalNativeShape.d.ts +1 -1
  522. package/lib/physics/physicalNativeShape.js +15 -4
  523. package/lib/physics/physicalNativeShape.js.map +1 -1
  524. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  525. package/lib/physics/physicalPrincipalAxes.js +96 -0
  526. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  527. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  528. package/lib/physics/physicalShapeBounds.js +26 -2
  529. package/lib/physics/physicalShapeBounds.js.map +1 -1
  530. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  531. package/lib/physics/physicalShapeNearest.js +201 -0
  532. package/lib/physics/physicalShapeNearest.js.map +1 -0
  533. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  534. package/lib/physics/physicalShapeNormal.js +70 -0
  535. package/lib/physics/physicalShapeNormal.js.map +1 -0
  536. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  537. package/lib/physics/physicalShapePairDistance.js +124 -0
  538. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  539. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  540. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  541. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  542. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  543. package/lib/physics/physicalShapeSpan.js +55 -0
  544. package/lib/physics/physicalShapeSpan.js.map +1 -0
  545. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  546. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  547. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  548. package/lib/physics/projectileAt.d.ts +14 -12
  549. package/lib/physics/projectileAt.js +46 -16
  550. package/lib/physics/projectileAt.js.map +1 -1
  551. package/lib/physics/projectileContinue.d.ts +114 -0
  552. package/lib/physics/projectileContinue.js +189 -0
  553. package/lib/physics/projectileContinue.js.map +1 -0
  554. package/lib/physics/projectileDragFlight.d.ts +72 -0
  555. package/lib/physics/projectileDragFlight.js +166 -0
  556. package/lib/physics/projectileDragFlight.js.map +1 -0
  557. package/lib/physics/projectileFirstContact.d.ts +105 -0
  558. package/lib/physics/projectileFirstContact.js +174 -0
  559. package/lib/physics/projectileFirstContact.js.map +1 -0
  560. package/lib/physics/projectileTrajectory.js +3 -2
  561. package/lib/physics/projectileTrajectory.js.map +1 -1
  562. package/lib/physics/solveBallisticLaunch.js +2 -1
  563. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  564. package/lib/physics/solveMovingLaunch.js +2 -1
  565. package/lib/physics/solveMovingLaunch.js.map +1 -1
  566. package/lib/physics/validatePhysicalProfile.js +18 -1
  567. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  568. package/lib/populationRuntime/index.d.ts +6 -0
  569. package/lib/populationRuntime/index.js +6 -0
  570. package/lib/populationRuntime/index.js.map +1 -1
  571. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  572. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  573. package/lib/random/index.d.ts +1 -1
  574. package/lib/random/index.js +1 -0
  575. package/lib/random/index.js.map +1 -1
  576. package/lib/render/index.d.ts +20 -11
  577. package/lib/render/index.js +20 -11
  578. package/lib/render/index.js.map +1 -1
  579. package/lib/resolve/index.d.ts +7 -2
  580. package/lib/resolve/index.js +7 -5
  581. package/lib/resolve/index.js.map +1 -1
  582. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  583. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  584. package/lib/rom/clampJointRom.d.ts +11 -3
  585. package/lib/rom/clampJointRom.js +43 -3
  586. package/lib/rom/clampJointRom.js.map +1 -1
  587. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  588. package/lib/rom/clampJointToSkeleton.js +39 -8
  589. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  590. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  591. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  592. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  593. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  594. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  595. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  596. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  597. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  598. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  599. package/lib/rom/constants/index.d.ts +2 -0
  600. package/lib/rom/constants/index.js +2 -0
  601. package/lib/rom/constants/index.js.map +1 -1
  602. package/lib/rom/index.d.ts +1 -0
  603. package/lib/rom/index.js +1 -0
  604. package/lib/rom/index.js.map +1 -1
  605. package/lib/rom/scanJointRom.d.ts +62 -0
  606. package/lib/rom/scanJointRom.js +117 -0
  607. package/lib/rom/scanJointRom.js.map +1 -0
  608. package/lib/rom/validateJointRom.d.ts +4 -2
  609. package/lib/rom/validateJointRom.js +23 -45
  610. package/lib/rom/validateJointRom.js.map +1 -1
  611. package/lib/service/index.d.ts +9 -0
  612. package/lib/service/index.js +9 -0
  613. package/lib/service/index.js.map +1 -1
  614. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  615. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  616. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  617. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  618. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  619. package/lib/soft/applySoftBodyFriction.js +52 -0
  620. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  621. package/lib/soft/index.d.ts +22 -0
  622. package/lib/soft/index.js +22 -0
  623. package/lib/soft/index.js.map +1 -1
  624. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  625. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  626. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  627. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  628. package/lib/soft/simulateSoftBodyCore.js +108 -16
  629. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  630. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  631. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  632. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  633. package/lib/soft/softBodyBudget.js +7 -0
  634. package/lib/soft/softBodyBudget.js.map +1 -1
  635. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  636. package/lib/soft/softBodyHeldLoads.js +69 -0
  637. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  638. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  639. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  640. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  641. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  642. package/lib/soft/validateSoftAnchors.js +74 -0
  643. package/lib/soft/validateSoftAnchors.js.map +1 -0
  644. package/lib/soft/validateSoftBodyDomain.js +6 -48
  645. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  646. package/lib/soft/validateSoftBounded.d.ts +20 -0
  647. package/lib/soft/validateSoftBounded.js +27 -0
  648. package/lib/soft/validateSoftBounded.js.map +1 -0
  649. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  650. package/lib/soft/validateSoftCompliance.js +54 -0
  651. package/lib/soft/validateSoftCompliance.js.map +1 -0
  652. package/lib/sound/index.d.ts +2 -0
  653. package/lib/sound/index.js +2 -0
  654. package/lib/sound/index.js.map +1 -1
  655. package/lib/text/index.d.ts +1 -0
  656. package/lib/text/index.js +1 -0
  657. package/lib/text/index.js.map +1 -1
  658. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  659. package/lib/validation/AffordanceArticulation.js +142 -0
  660. package/lib/validation/AffordanceArticulation.js.map +1 -0
  661. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  662. package/lib/validation/affordanceFollowedTravel.js +43 -0
  663. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  664. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  665. package/lib/validation/affordanceLeadingTravel.js +99 -0
  666. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  667. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  668. package/lib/validation/affordanceTravelRange.js +39 -0
  669. package/lib/validation/affordanceTravelRange.js.map +1 -0
  670. package/lib/validation/appendShotEventsArtifact.js +12 -0
  671. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  672. package/lib/validation/constants/index.d.ts +3 -3
  673. package/lib/validation/constants/index.js +3 -3
  674. package/lib/validation/constants/index.js.map +1 -1
  675. package/lib/validation/detectFreeFall.js +2 -1
  676. package/lib/validation/detectFreeFall.js.map +1 -1
  677. package/lib/validation/index.d.ts +52 -4
  678. package/lib/validation/index.js +52 -6
  679. package/lib/validation/index.js.map +1 -1
  680. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  681. package/lib/validation/markAutoMovieSlip.js +52 -0
  682. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  683. package/lib/validation/validateAffordance.d.ts +3 -3
  684. package/lib/validation/validateAffordance.js +21 -3
  685. package/lib/validation/validateAffordance.js.map +1 -1
  686. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  687. package/lib/validation/validateAffordanceArticulation.js +183 -0
  688. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  689. package/lib/validation/validateBalanceSupport.d.ts +1 -2
  690. package/lib/validation/validateBalanceSupport.js.map +1 -1
  691. package/lib/validation/validateBody.d.ts +2 -2
  692. package/lib/validation/validateBody.js +27 -3
  693. package/lib/validation/validateBody.js.map +1 -1
  694. package/lib/validation/validateFootSkate.d.ts +1 -2
  695. package/lib/validation/validateFootSkate.js.map +1 -1
  696. package/lib/validation/validateGroundContact.d.ts +1 -2
  697. package/lib/validation/validateGroundContact.js.map +1 -1
  698. package/lib/validation/validateJointConstraint.d.ts +1 -1
  699. package/lib/validation/validateJointConstraint.js +9 -1
  700. package/lib/validation/validateJointConstraint.js.map +1 -1
  701. package/lib/validation/validateModel.js +2 -0
  702. package/lib/validation/validateModel.js.map +1 -1
  703. package/lib/validation/validateSelfIntersection.d.ts +1 -2
  704. package/lib/validation/validateSelfIntersection.js.map +1 -1
  705. package/lib/worldBlock.js +6 -9
  706. package/lib/worldBlock.js.map +1 -1
  707. package/package.json +6 -6
  708. package/src/IAutoMovieFormationPlacement.ts +4 -3
  709. package/src/analysis/index.ts +5 -0
  710. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  711. package/src/anthropometry/index.ts +1 -0
  712. package/src/architecture/appendBuiltRegionDefects.ts +3 -3
  713. package/src/architecture/builtOutlineIsClosed.ts +3 -3
  714. package/{lib/architecture/constants/PLANAR_EPSILON.d.ts → src/architecture/constants/BUILT_PLANAR_EPSILON.ts} +1 -1
  715. package/src/architecture/constants/index.ts +1 -1
  716. package/src/architecture/index.ts +157 -117
  717. package/src/cache/index.ts +9 -0
  718. package/src/composition/AutoMovieComposition.ts +34 -7
  719. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  720. package/src/composition/AutoMovieScheduleError.ts +108 -0
  721. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  722. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  723. package/src/composition/IAutoMovieIntent.ts +9 -7
  724. package/src/composition/index.ts +12 -7
  725. package/src/composition/markAutoMovieContacts.ts +79 -0
  726. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  727. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  728. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  729. package/src/constants/index.ts +2 -0
  730. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  731. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  732. package/src/drawing/index.ts +12 -0
  733. package/src/effectRuntime/index.ts +7 -0
  734. package/src/film/compileAttach.ts +2 -5
  735. package/src/film/compileLaunch.ts +5 -4
  736. package/src/film/constants/index.ts +3 -0
  737. package/src/film/index.ts +61 -6
  738. package/src/film/propAnchorFrame.ts +3 -6
  739. package/src/film/stageScene.ts +3 -10
  740. package/src/film/staging/index.ts +11 -0
  741. package/src/film/staging/lowerLightPlacement.ts +3 -7
  742. package/src/formationSlotPosition.ts +54 -7
  743. package/src/geometry/IAutoMovieMark.ts +115 -0
  744. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  745. package/src/geometry/constants/index.ts +2 -0
  746. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  747. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  748. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  749. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  750. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  751. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  752. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  753. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  754. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  755. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  756. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  757. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  758. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  759. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  760. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  761. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  762. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  763. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  764. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  765. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  766. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  767. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  768. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  769. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  770. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  771. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  772. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  773. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  774. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  775. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  776. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  777. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  778. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  779. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  780. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  781. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  782. package/src/geometry/construction/index.ts +82 -2
  783. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  784. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  785. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  786. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  787. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  788. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  789. package/src/geometry/curve/index.ts +48 -25
  790. package/src/geometry/extract/index.ts +0 -1
  791. package/src/geometry/index.ts +87 -53
  792. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  793. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  794. package/src/geometry/sweep/index.ts +54 -15
  795. package/src/index.ts +41 -450
  796. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  797. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  798. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  799. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  800. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  801. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  802. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  803. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  804. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  805. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  806. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  807. package/src/kinematics/curlChainUntilContact.ts +35 -8
  808. package/src/kinematics/decomposeJointRotation.ts +15 -178
  809. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  810. package/src/kinematics/fitDigitDescent.ts +253 -0
  811. package/src/kinematics/fitDigitToTarget.ts +425 -0
  812. package/src/kinematics/hingedArmArticulation.ts +402 -116
  813. package/src/kinematics/hingedArmSwivel.ts +295 -0
  814. package/src/kinematics/index.ts +30 -12
  815. package/src/kinematics/jointRomOvershoot.ts +30 -19
  816. package/src/kinematics/jointToQuaternion.ts +8 -43
  817. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  818. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  819. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  820. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  821. package/src/kinematics/normalizeJointAxes.ts +66 -12
  822. package/src/kinematics/poseJointCodec.ts +148 -0
  823. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  824. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  825. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  826. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  827. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  828. package/src/kinematics/swingTwistBasis.ts +162 -0
  829. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  830. package/src/kinematics/swingTwistRange.ts +460 -0
  831. package/src/kinematics/swingTwistRegion.ts +298 -0
  832. package/src/kinematics/swivelArcs.ts +245 -0
  833. package/src/math/Quaternion.ts +42 -2
  834. package/src/math/Transform.ts +65 -0
  835. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  836. package/src/math/bracketedBisection.ts +51 -0
  837. package/src/math/bracketedRoot.ts +72 -0
  838. package/src/math/constants/index.ts +1 -0
  839. package/src/math/index.ts +64 -5
  840. package/src/math/nearestAngleAlias.ts +43 -0
  841. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  842. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  843. package/src/measureAutoMovieGeometryReach.ts +2 -4
  844. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  845. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  846. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  847. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  848. package/src/motion/IFitChainToTargetProps.ts +67 -0
  849. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  850. package/src/motion/basisOf.ts +29 -0
  851. package/src/motion/carriedAcceleration.ts +56 -0
  852. package/src/motion/carriedRate.ts +61 -0
  853. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  854. package/src/motion/constants/index.ts +1 -0
  855. package/src/motion/fitChainBend.ts +491 -0
  856. package/src/motion/fitChainToTarget.ts +13 -485
  857. package/src/motion/fitHingedChainCandidate.ts +281 -148
  858. package/src/motion/fitHingedRotationError.ts +164 -0
  859. package/src/motion/fitSeededChainToTarget.ts +34 -0
  860. package/src/motion/gaitMotion.ts +6 -10
  861. package/src/motion/gestureMotion.ts +2 -5
  862. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  863. package/src/motion/index.ts +40 -9
  864. package/src/motion/inertializeOffset.ts +16 -2
  865. package/src/motion/inertializePose.ts +158 -53
  866. package/src/motion/integrateAirborneRotation.ts +334 -0
  867. package/src/motion/integrateMotionTrajectory.ts +309 -0
  868. package/src/motion/orientChainEffector.ts +19 -13
  869. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  870. package/src/motion/sampleMotion.ts +2 -5
  871. package/src/motion/samplePoseVelocity.ts +168 -41
  872. package/src/motion/smoothMinimum.ts +36 -0
  873. package/src/motion/solveAirborneTakeoff.ts +471 -0
  874. package/src/motion/solveDistalTwist.ts +256 -0
  875. package/src/motion/speedProfile.ts +470 -0
  876. package/src/motion/splitDistalTwist.ts +55 -64
  877. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  878. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  879. package/src/perform/index.ts +10 -0
  880. package/src/physics/AutoMovieAir.ts +22 -0
  881. package/src/physics/AutoMovieGravity.ts +28 -0
  882. package/src/physics/IAutoMovieHit.ts +13 -7
  883. package/src/physics/IAutoMovieProjectile.ts +82 -6
  884. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  885. package/src/physics/admitMotionGeometry.ts +16 -0
  886. package/src/physics/bindPhysicalWorld.ts +22 -11
  887. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  888. package/src/physics/deriveCenterOfMass.ts +2 -5
  889. package/src/physics/derivePhysicalProfile.ts +3 -1
  890. package/src/physics/index.ts +155 -2
  891. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  892. package/src/physics/physicalHullErode.ts +72 -0
  893. package/src/physics/physicalHullFaces.ts +215 -0
  894. package/src/physics/physicalHullMass.ts +99 -0
  895. package/src/physics/physicalHullNearest.ts +210 -0
  896. package/src/physics/physicalHullSegment.ts +338 -0
  897. package/src/physics/physicalInertiaTensor.ts +75 -0
  898. package/src/physics/physicalNativeShape.ts +31 -9
  899. package/src/physics/physicalPrincipalAxes.ts +114 -0
  900. package/src/physics/physicalShapeBounds.ts +24 -2
  901. package/src/physics/physicalShapeNearest.ts +287 -0
  902. package/src/physics/physicalShapeNormal.ts +105 -0
  903. package/src/physics/physicalShapePairDistance.ts +153 -0
  904. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  905. package/src/physics/physicalShapeSpan.ts +75 -0
  906. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  907. package/src/physics/projectileAt.ts +61 -20
  908. package/src/physics/projectileContinue.ts +287 -0
  909. package/src/physics/projectileDragFlight.ts +208 -0
  910. package/src/physics/projectileFirstContact.ts +286 -0
  911. package/src/physics/projectileTrajectory.ts +6 -5
  912. package/src/physics/solveBallisticLaunch.ts +2 -1
  913. package/src/physics/solveMovingLaunch.ts +2 -1
  914. package/src/physics/validatePhysicalProfile.ts +20 -1
  915. package/src/populationRuntime/index.ts +6 -0
  916. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  917. package/src/random/index.ts +1 -1
  918. package/src/render/index.ts +20 -11
  919. package/src/resolve/index.ts +7 -2
  920. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  921. package/src/rom/clampJointRom.ts +59 -2
  922. package/src/rom/clampJointToSkeleton.ts +52 -15
  923. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  924. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  925. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  926. package/src/rom/constants/index.ts +2 -0
  927. package/src/rom/index.ts +1 -0
  928. package/src/rom/scanJointRom.ts +169 -0
  929. package/src/rom/validateJointRom.ts +69 -74
  930. package/src/service/index.ts +9 -0
  931. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  932. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  933. package/src/soft/applySoftBodyFriction.ts +65 -0
  934. package/src/soft/index.ts +22 -0
  935. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  936. package/src/soft/simulateSoftBodyCore.ts +127 -15
  937. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  938. package/src/soft/softBodyBudget.ts +11 -0
  939. package/src/soft/softBodyHeldLoads.ts +85 -0
  940. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  941. package/src/soft/validateSoftAnchors.ts +143 -0
  942. package/src/soft/validateSoftBodyDomain.ts +5 -124
  943. package/src/soft/validateSoftBounded.ts +42 -0
  944. package/src/soft/validateSoftCompliance.ts +102 -0
  945. package/src/sound/index.ts +2 -0
  946. package/src/text/index.ts +1 -0
  947. package/src/validation/AffordanceArticulation.ts +173 -0
  948. package/src/validation/affordanceFollowedTravel.ts +40 -0
  949. package/src/validation/affordanceLeadingTravel.ts +108 -0
  950. package/src/validation/affordanceTravelRange.ts +42 -0
  951. package/src/validation/appendShotEventsArtifact.ts +26 -0
  952. package/src/validation/constants/index.ts +3 -3
  953. package/src/validation/detectFreeFall.ts +3 -2
  954. package/src/validation/index.ts +52 -4
  955. package/src/validation/markAutoMovieSlip.ts +65 -0
  956. package/src/validation/validateAffordance.ts +38 -3
  957. package/src/validation/validateAffordanceArticulation.ts +311 -0
  958. package/src/validation/validateBalanceSupport.ts +2 -5
  959. package/src/validation/validateBody.ts +80 -3
  960. package/src/validation/validateFootSkate.ts +1 -1
  961. package/src/validation/validateGroundContact.ts +2 -5
  962. package/src/validation/validateJointConstraint.ts +19 -1
  963. package/src/validation/validateModel.ts +7 -0
  964. package/src/validation/validateSelfIntersection.ts +2 -5
  965. package/src/worldBlock.ts +3 -6
  966. package/lib/architecture/constants/PLANAR_EPSILON.js.map +0 -1
@@ -0,0 +1,298 @@
1
+ import type {
2
+ IAutoMovieAngleRange,
3
+ IAutoMovieJointAxes,
4
+ IAutoMovieJointConstraint,
5
+ IAutoMovieVector3,
6
+ } from "@automovie/interface";
7
+
8
+ import { Quaternion } from "../math/Quaternion";
9
+ import { Vector3 } from "../math/Vector3";
10
+ import { nearestAngleAlias } from "../math/nearestAngleAlias";
11
+ import { positiveModulo } from "../math/positiveModulo";
12
+ import type { IAutoMovieRestFrame } from "../rom/IAutoMovieRestFrame";
13
+ import { swingConeAngle } from "../rom/swingConeAngle";
14
+ import { toClinicalAngle } from "../rom/toClinicalAngle";
15
+ import { toRigAngle } from "../rom/toRigAngle";
16
+ import { swingTwistBasis } from "./swingTwistBasis";
17
+
18
+ /**
19
+ * The swing region of a ball joint: the farthest the limb may point from its
20
+ * rest direction along each great circle, read once off the constraint's
21
+ * flexion and abduction intervals and kept.
22
+ *
23
+ * The region is the star of the directions the intervals reach with no twist
24
+ * (and the constraint's `swingDeg`), widened for a proximal twist by the reach
25
+ * of every twist in its interval, and raised so it turns no faster than
26
+ * `SLOPE` with the azimuth. `swingTwistRange` reads its radius and brings a
27
+ * rotation back into it.
28
+ *
29
+ * @evidence contracts/development/common.md#meaningful-documentation States what the region is, how its table is built from the constraint and what it is widened and raised by.
30
+ * @evidence contracts/development/design.md#principled-representation The region is a radius per great circle, the representation a radial projection needs.
31
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One function, the table of a constraint; the reading and the projection are `swingTwistRange`'s.
32
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint is named: the axes, the rest frame and the intervals are the caller's.
33
+ */
34
+ export namespace swingTwistRegion {
35
+ /**
36
+ * The joint's frame the region is read in: its axes and its rest frame.
37
+ *
38
+ * @evidence contracts/development/common.md#meaningful-documentation States that the axes are the joint's clinical basis, that the rest frame lifts its angles and that an absent frame leaves them rest-relative.
39
+ * @evidence contracts/development/design.md#principled-representation The caller's clinical axis basis and rest frame, the two things that turn a rotation's angles into the joint's clinical ones.
40
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members, both read by the table and by the key it is kept under.
41
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No joint or bone is named, and the members are the engine's own types.
42
+ */
43
+ export interface IJoint {
44
+ /** The joint's clinical axes. */
45
+ axes: IAutoMovieJointAxes;
46
+
47
+ /** The rest frame its clinical angles are lifted by. */
48
+ frame?: IAutoMovieRestFrame | undefined;
49
+ }
50
+
51
+ /**
52
+ * The radius table of a constraint on a joint's frame.
53
+ *
54
+ * @param constraint The constraint.
55
+ * @param joint The joint's axes and rest frame.
56
+ * @returns The radius on each of `swingTwistBasis.RAYS` great circles, degrees; built on first use and kept.
57
+ *
58
+ * @evidence contracts/development/common.md#meaningful-documentation States the table, its units and that it is kept.
59
+ * @evidence contracts/development/implementation.md#principled-implementation Each radius is the farthest reached swing found by a scan from the far end and a bisection, widened for a proximal twist and raised to the slope bound.
60
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A lookup by identity, and the build in three steps on a miss.
61
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The scan runs from the far end, so a ray the ranges leave and re-enter keeps its farthest reach. `SLOPE` (3) is provisional; `SCAN` and `HALVINGS` are resolutions.
62
+ * @evidence contracts/development/implementation.md#efficient-algorithms A hit is three map reads by identity, no serialization; a miss builds the table once per constraint, axes and frame: on each of `swingTwistBasis.RAYS` (360) rays a scan of up to 360 half-degree steps and 20 bisections, each one reach test of two flexions; the widening reads one ray per degree of the twist's interval; the raise compares every pair of rays, 360 squared.
63
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Every call after the first reads the kept table.
64
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The tables are kept in weak maps keyed by the constraint and the axes and released with either; the frame map under them holds the rest-frame records, which are table constants.
65
+ */
66
+ export function table(
67
+ constraint: IAutoMovieJointConstraint,
68
+ joint: IJoint,
69
+ ): Float64Array {
70
+ let byAxes:
71
+ | WeakMap<IAutoMovieJointAxes, Map<object, Float64Array>>
72
+ | undefined = TABLES.get(constraint);
73
+ if (byAxes === undefined) {
74
+ byAxes = new WeakMap();
75
+ TABLES.set(constraint, byAxes);
76
+ }
77
+ let byFrame: Map<object, Float64Array> | undefined = byAxes.get(joint.axes);
78
+ if (byFrame === undefined) {
79
+ byFrame = new Map();
80
+ byAxes.set(joint.axes, byFrame);
81
+ }
82
+ const frame: object = joint.frame ?? NO_FRAME;
83
+ let kept: Float64Array | undefined = byFrame.get(frame);
84
+ if (kept === undefined) {
85
+ kept = build(constraint, joint);
86
+ byFrame.set(frame, kept);
87
+ }
88
+ return kept;
89
+ }
90
+ }
91
+
92
+ /** The radius tables, by the identity of the constraint, the axes and the rest frame: the tables of a rig are kept as long as its records are. */
93
+ const TABLES: WeakMap<
94
+ IAutoMovieJointConstraint,
95
+ WeakMap<IAutoMovieJointAxes, Map<object, Float64Array>>
96
+ > = new WeakMap();
97
+
98
+ /** The key of a joint read with no rest frame. */
99
+ const NO_FRAME: object = Object.freeze({});
100
+
101
+ /** The fastest the region's radius may change with the azimuth, degrees per degree (provisional: three, so a projection's step is at most about three times the azimuth's step). */
102
+ const SLOPE: number = 3;
103
+
104
+ /** The step of the scan for the farthest reached swing on a ray, degrees. */
105
+ const SCAN: number = 0.5;
106
+
107
+ /** The bisections that refine it: twenty halve half a degree to under a millionth. */
108
+ const HALVINGS: number = 20;
109
+
110
+ /** The region's radius on each ray: reached, widened and raised. */
111
+ function build(
112
+ constraint: IAutoMovieJointConstraint,
113
+ joint: swingTwistRegion.IJoint,
114
+ ): Float64Array {
115
+ // The limb points no farther from rest than its stated reach, which keeps
116
+ // the rest direction's antipode outside (`ISwingTwist.reach`).
117
+ const cap: number = constraint.swingTwist?.reach ?? 180;
118
+ return raise(widen(reach(constraint, joint), constraint, joint)).map(
119
+ (radius: number): number => Math.min(cap, radius),
120
+ );
121
+ }
122
+
123
+ /**
124
+ * The farthest swing along each ray at which the flexion and abduction
125
+ * intervals reach the direction, found by a scan from the far end in `SCAN`
126
+ * degree steps toward the rest direction and refined by `HALVINGS` bisections.
127
+ */
128
+ function reach(
129
+ constraint: IAutoMovieJointConstraint,
130
+ joint: swingTwistRegion.IJoint,
131
+ ): Float64Array {
132
+ const basis: swingTwistBasis.IBasis = swingTwistBasis.of(joint.axes);
133
+ const table: Float64Array = new Float64Array(swingTwistBasis.RAYS);
134
+ for (let ray: number = 0; ray < swingTwistBasis.RAYS; ++ray) {
135
+ const azimuth: number = (360 * ray) / swingTwistBasis.RAYS;
136
+ const inside: (swing: number) => boolean = (swing: number): boolean =>
137
+ reached(
138
+ constraint,
139
+ joint,
140
+ basis,
141
+ swingTwistBasis.direction(basis, swing, azimuth),
142
+ );
143
+ let hi: number = 180;
144
+ let lo: number = 0;
145
+ for (let swing: number = 180 - SCAN; swing > 0; swing -= SCAN) {
146
+ if (inside(swing)) {
147
+ lo = swing;
148
+ break;
149
+ }
150
+ hi = swing;
151
+ }
152
+ for (let i: number = 0; i < HALVINGS && lo > 0; ++i) {
153
+ const mid: number = (lo + hi) / 2;
154
+ if (inside(mid)) lo = mid;
155
+ else hi = mid;
156
+ }
157
+ table[ray] = lo;
158
+ }
159
+ return table;
160
+ }
161
+
162
+ /**
163
+ * A proximal twist turns about the rest axis outside the flexion and the
164
+ * abduction, so it carries every reached direction around the rest direction
165
+ * by its own angle: on a hip flexed forward it swings the thigh sideways. The
166
+ * directions its interval reaches are then those of no twist turned by any
167
+ * twist in it, which shifts each ray's reach along the azimuth.
168
+ */
169
+ function widen(
170
+ table: Float64Array,
171
+ constraint: IAutoMovieJointConstraint,
172
+ joint: swingTwistRegion.IJoint,
173
+ ): Float64Array {
174
+ const twist: IAutoMovieAngleRange | null = constraint.twist;
175
+ if (joint.axes.twistPlacement === "distal" || twist === null) return table;
176
+ const ends: readonly number[] = [
177
+ toRigAngle(twist.min, joint.frame?.twist)!,
178
+ toRigAngle(twist.max, joint.frame?.twist)!,
179
+ ];
180
+ const low: number = Math.min(...ends);
181
+ const high: number = Math.max(...ends);
182
+ const width: number = 360 / swingTwistBasis.RAYS;
183
+ const turned: Float64Array = new Float64Array(swingTwistBasis.RAYS);
184
+ for (let ray: number = 0; ray < swingTwistBasis.RAYS; ++ray) {
185
+ let most: number = table[ray]!;
186
+ for (let shift: number = low; shift <= high + 1e-9; shift += width) {
187
+ const from: number = positiveModulo(
188
+ Math.round(ray - shift / width),
189
+ swingTwistBasis.RAYS,
190
+ );
191
+ most = Math.max(most, table[from]!);
192
+ }
193
+ turned[ray] = most;
194
+ }
195
+ return turned;
196
+ }
197
+
198
+ /**
199
+ * Where the region's edge runs along a ray the farthest reach jumps between
200
+ * two rays, and a projection along the rays would jump with it. So the radius
201
+ * is raised to the least function at or above it that turns no faster than
202
+ * `SLOPE` degrees of radius per degree of azimuth: the region gains a sliver
203
+ * beside such an edge and loses nothing.
204
+ */
205
+ function raise(table: Float64Array): Float64Array {
206
+ const raised: Float64Array = new Float64Array(swingTwistBasis.RAYS);
207
+ const width: number = 360 / swingTwistBasis.RAYS;
208
+ for (let ray: number = 0; ray < swingTwistBasis.RAYS; ++ray) {
209
+ let most: number = 0;
210
+ for (let other: number = 0; other < swingTwistBasis.RAYS; ++other) {
211
+ const apart: number = Math.min(
212
+ Math.abs(ray - other),
213
+ swingTwistBasis.RAYS - Math.abs(ray - other),
214
+ );
215
+ most = Math.max(most, table[other]! - SLOPE * apart * width);
216
+ }
217
+ raised[ray] = Math.min(180, most);
218
+ }
219
+ return raised;
220
+ }
221
+
222
+ /**
223
+ * Whether the flexion and abduction intervals, with no twist and within the
224
+ * swing cone, reach a direction in either reading. With no twist the rotation
225
+ * is the abduction's after the flexion's, in either order of the twist: the
226
+ * flexion turns `u` within the plane normal to the flexion axis, and the
227
+ * abduction then turns it about its own axis, which keeps the part along that
228
+ * axis, so that part gives the flexion twice and the abduction follows for
229
+ * each.
230
+ */
231
+ function reached(
232
+ constraint: IAutoMovieJointConstraint,
233
+ joint: swingTwistRegion.IJoint,
234
+ basis: swingTwistBasis.IBasis,
235
+ direction: IAutoMovieVector3,
236
+ ): boolean {
237
+ const flexion: IAutoMovieAngleRange = constraint.flexion!;
238
+ const abduction: IAutoMovieAngleRange = constraint.abduction!;
239
+ const admits: (rigFlexion: number, rigAbduction: number) => boolean = (
240
+ rigFlexion: number,
241
+ rigAbduction: number,
242
+ ): boolean => {
243
+ const f: number = nearestAngleAlias(
244
+ toClinicalAngle(rigFlexion, joint.frame?.flexion)!,
245
+ flexion,
246
+ );
247
+ const a: number = nearestAngleAlias(
248
+ toClinicalAngle(rigAbduction, joint.frame?.abduction)!,
249
+ abduction,
250
+ );
251
+ return (
252
+ f >= flexion.min &&
253
+ f <= flexion.max &&
254
+ a >= abduction.min &&
255
+ a <= abduction.max &&
256
+ (typeof constraint.swingDeg !== "number" ||
257
+ swingConeAngle(f, a) <= constraint.swingDeg)
258
+ );
259
+ };
260
+ const across: number = Vector3.dot(Vector3.cross(basis.f, basis.u), basis.a);
261
+ const first: number =
262
+ Math.asin(
263
+ swingTwistBasis.clamp(Vector3.dot(direction, basis.a) / across, -1, 1),
264
+ ) * swingTwistBasis.DEG;
265
+ for (const f of [first, 180 - first]) {
266
+ const swung: IAutoMovieVector3 = Quaternion.rotateVector(
267
+ Quaternion.fromAxisAngle(basis.f, f),
268
+ basis.u,
269
+ );
270
+ const from: IAutoMovieVector3 = flat(swung, basis.a);
271
+ const to: IAutoMovieVector3 = flat(direction, basis.a);
272
+ if (Vector3.length(from) < 1e-9 || Vector3.length(to) < 1e-9) {
273
+ // On the abduction axis any abduction keeps the direction.
274
+ for (const a of [
275
+ abduction.min,
276
+ abduction.max,
277
+ (abduction.min + abduction.max) / 2,
278
+ ])
279
+ if (admits(f, toRigAngle(a, joint.frame?.abduction)!)) return true;
280
+ continue;
281
+ }
282
+ const a: number =
283
+ Math.atan2(
284
+ Vector3.dot(basis.a, Vector3.cross(from, to)),
285
+ Vector3.dot(from, to),
286
+ ) * swingTwistBasis.DEG;
287
+ if (admits(f, a)) return true;
288
+ }
289
+ return false;
290
+ }
291
+
292
+ /** A vector with its part along a unit axis taken off. */
293
+ function flat(
294
+ v: IAutoMovieVector3,
295
+ axis: IAutoMovieVector3,
296
+ ): IAutoMovieVector3 {
297
+ return Vector3.subtract(v, Vector3.scale(axis, Vector3.dot(v, axis)));
298
+ }
@@ -0,0 +1,245 @@
1
+ import { Quaternion } from "../math/Quaternion";
2
+
3
+ /**
4
+ * Sinusoids of a swivel and the arcs of swivels where they lie above a
5
+ * margin. Whatever is turned about a fixed axis by a swivel `ψ` reads, in any
6
+ * fixed linear measure, `a + b cos ψ + c sin ψ` (Rodrigues' formula): an
7
+ * entry of the rotation, a coordinate of a point it carries. Such a sinusoid
8
+ * is fitted exactly from its values at 0, 90 and 180 degrees, it exceeds a
9
+ * margin on the one arc between its two arccos roots, and a union of such
10
+ * arcs over one turn says which swivels some condition refuses.
11
+ * `boxExcludedSwivels` reads a joint box's bounds this way, and a caller
12
+ * bounding a point carried by the swivel (an elbow on its circle) reads its
13
+ * half-planes the same way.
14
+ *
15
+ * @evidence contracts/development/common.md#meaningful-documentation States why each reading is a sinusoid, how one is fitted, where it exceeds a margin and what a union of arcs answers.
16
+ * @evidence contracts/development/design.md#principled-representation A sinusoid is its three coefficients and an arc its two ends, degrees; a union is disjoint arcs over a turn and the one after it, or every swivel.
17
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The two records and the fit, the two combinations, the arc of one sinusoid, the union and its two readings: what `boxExcludedSwivels` and a point's bound share.
18
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Exact roots, never sampling; the margin is the caller's.
19
+ */
20
+ export namespace swivelArcs {
21
+ /**
22
+ * `a + b cos ψ + c sin ψ` of a swivel `ψ`.
23
+ *
24
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its term.
25
+ * @evidence contracts/development/design.md#principled-representation The three coefficients of a sinusoid.
26
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Three members.
27
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None optional.
28
+ */
29
+ export interface ISinusoid {
30
+ /** The constant term. */
31
+ a: number;
32
+
33
+ /** The cosine's coefficient. */
34
+ b: number;
35
+
36
+ /** The sine's coefficient. */
37
+ c: number;
38
+ }
39
+
40
+ /**
41
+ * An interval of swivels, degrees, `from` up to `to`.
42
+ *
43
+ * @evidence contracts/development/common.md#meaningful-documentation Each member states its end and unit.
44
+ * @evidence contracts/development/design.md#principled-representation The two ends of an arc.
45
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members.
46
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts None optional.
47
+ */
48
+ export interface IArc {
49
+ /** The start, degrees. */
50
+ from: number;
51
+
52
+ /** The end, degrees, not before `from`. */
53
+ to: number;
54
+ }
55
+
56
+ /**
57
+ * The sinusoid through its values at swivels 0, 90 and 180 degrees.
58
+ *
59
+ * @param zero Its value at 0.
60
+ * @param quarter Its value at 90.
61
+ * @param half Its value at 180.
62
+ * @returns The sinusoid.
63
+ *
64
+ * @evidence contracts/development/common.md#meaningful-documentation States the three samples and the result.
65
+ * @evidence contracts/development/implementation.md#principled-implementation `a + b` at 0, `a + c` at 90 and `a - b` at 180 solve exactly for the three coefficients.
66
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Three expressions.
67
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Exact for any reading of a rotation turned about a fixed axis.
68
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
69
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The one fit of a joint box's entries and of a point's bounds.
70
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
71
+ */
72
+ export function fitted(
73
+ zero: number,
74
+ quarter: number,
75
+ half: number,
76
+ ): ISinusoid {
77
+ const a: number = (zero + half) / 2;
78
+ return { a, b: (zero - half) / 2, c: quarter - a };
79
+ }
80
+
81
+ /**
82
+ * A sinusoid times a number.
83
+ *
84
+ * @param f The sinusoid.
85
+ * @param by The factor.
86
+ * @returns `by · f`.
87
+ *
88
+ * @evidence contracts/development/common.md#meaningful-documentation States the result.
89
+ * @evidence contracts/development/implementation.md#principled-implementation Sinusoids of one swivel are a vector space.
90
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One record.
91
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
92
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
93
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shared by every bound.
94
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
95
+ */
96
+ export function scaled(f: ISinusoid, by: number): ISinusoid {
97
+ return { a: f.a * by, b: f.b * by, c: f.c * by };
98
+ }
99
+
100
+ /**
101
+ * Two sinusoids combined.
102
+ *
103
+ * @param f The first.
104
+ * @param u Its factor.
105
+ * @param g The second.
106
+ * @param v Its factor.
107
+ * @returns `u·f + v·g`.
108
+ *
109
+ * @evidence contracts/development/common.md#meaningful-documentation States the result.
110
+ * @evidence contracts/development/implementation.md#principled-implementation Sinusoids of one swivel are a vector space.
111
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One record.
112
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
113
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
114
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shared by every bound.
115
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
116
+ */
117
+ export function combined(
118
+ f: ISinusoid,
119
+ u: number,
120
+ g: ISinusoid,
121
+ v: number,
122
+ ): ISinusoid {
123
+ return { a: u * f.a + v * g.a, b: u * f.b + v * g.b, c: u * f.c + v * g.c };
124
+ }
125
+
126
+ /**
127
+ * The swivels where a sinusoid exceeds a margin.
128
+ *
129
+ * @param f The sinusoid.
130
+ * @param margin The margin.
131
+ * @returns The arc between its roots, degrees; every swivel when its least exceeds the margin; none when its greatest does not.
132
+ *
133
+ * @evidence contracts/development/common.md#meaningful-documentation States the three cases.
134
+ * @evidence contracts/development/implementation.md#principled-implementation `a + R cos(ψ - ψ₀)` with `R = hypot(b, c)` and `ψ₀ = atan2(c, b)` exceeds the margin within `acos((margin - a) / R)` of `ψ₀`.
135
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Two tests and one arc.
136
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The roots are exact.
137
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Constant work.
138
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shared by every bound.
139
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
140
+ */
141
+ export function above(f: ISinusoid, margin: number): IArc | "all" | null {
142
+ const radius: number = Math.hypot(f.b, f.c);
143
+ if (f.a - radius > margin) return "all";
144
+ if (f.a + radius <= margin) return null;
145
+ const centre: number = Math.atan2(f.c, f.b) / Quaternion.DEG2RAD;
146
+ const half: number =
147
+ Math.acos((margin - f.a) / radius) / Quaternion.DEG2RAD;
148
+ return { from: centre - half, to: centre + half };
149
+ }
150
+
151
+ /**
152
+ * Arcs merged into disjoint intervals covering one full turn from 0 and the
153
+ * one after it, so an interval starting in [0, 360) lies in the union
154
+ * exactly when one merged interval holds it.
155
+ *
156
+ * @param arcs The arcs, degrees, any turn.
157
+ * @returns The merged intervals in order, or every swivel when they cover a turn.
158
+ *
159
+ * @evidence contracts/development/common.md#meaningful-documentation States the cover and the "every swivel" case.
160
+ * @evidence contracts/development/implementation.md#principled-implementation Each arc taken into its turn and copied a turn either way, then sorted and merged, so an arc across 0 or 360 is whole.
161
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Copy, sort, merge.
162
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
163
+ * @evidence contracts/development/implementation.md#efficient-algorithms Three pieces an arc, one sort.
164
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Built once per fit and read by every test of it.
165
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns a fresh list.
166
+ */
167
+ export function union(arcs: readonly IArc[]): IArc[] | "all" {
168
+ const pieces: IArc[] = [];
169
+ for (const arc of arcs) {
170
+ const from: number = arc.from - 360 * Math.floor(arc.from / 360);
171
+ for (const turn of [-360, 0, 360])
172
+ pieces.push({
173
+ from: from + turn,
174
+ to: from + (arc.to - arc.from) + turn,
175
+ });
176
+ }
177
+ pieces.sort((x: IArc, y: IArc): number => x.from - y.from);
178
+ const out: IArc[] = [];
179
+ for (const piece of pieces) {
180
+ const last: IArc | undefined = out[out.length - 1];
181
+ if (last !== undefined && piece.from <= last.to)
182
+ last.to = Math.max(last.to, piece.to);
183
+ else out.push({ ...piece });
184
+ }
185
+ if (out.some((arc: IArc): boolean => arc.from <= 0 && arc.to >= 360))
186
+ return "all";
187
+ return out;
188
+ }
189
+
190
+ /**
191
+ * Whether every swivel from `low` to `high` degrees lies in a union.
192
+ *
193
+ * @param merged The union (`union`).
194
+ * @param low The interval's start, degrees.
195
+ * @param high Its end, degrees, at most a turn after `low`.
196
+ * @returns Whether one merged interval holds it.
197
+ *
198
+ * @evidence contracts/development/common.md#meaningful-documentation States the test.
199
+ * @evidence contracts/development/implementation.md#principled-implementation The interval taken into the turn `union` covers twice.
200
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One scan.
201
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts None.
202
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the few merged intervals.
203
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Read by every test of one union.
204
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
205
+ */
206
+ export function covers(
207
+ merged: readonly IArc[] | "all",
208
+ low: number,
209
+ high: number,
210
+ ): boolean {
211
+ if (merged === "all") return true;
212
+ const turns: number = 360 * Math.floor(low / 360);
213
+ return merged.some(
214
+ (arc: IArc): boolean => arc.from <= low - turns && arc.to >= high - turns,
215
+ );
216
+ }
217
+
218
+ /**
219
+ * The swivel nearest a given one that lies outside a union.
220
+ *
221
+ * @param merged The union (`union`).
222
+ * @param swivel The swivel, degrees.
223
+ * @returns The swivel itself when outside, else the nearer end of the merged interval holding it, degrees in that interval's turn; null when the union is every swivel.
224
+ *
225
+ * @evidence contracts/development/common.md#meaningful-documentation States the three results.
226
+ * @evidence contracts/development/implementation.md#principled-implementation Merged intervals are disjoint, so a swivel inside one leaves the union first at one of its two ends.
227
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One lookup and one comparison.
228
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The end is the exact root.
229
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the few merged intervals.
230
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reads `union`'s cover.
231
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A pure function that retains nothing.
232
+ */
233
+ export function nearest(
234
+ merged: readonly IArc[] | "all",
235
+ swivel: number,
236
+ ): number | null {
237
+ if (merged === "all") return null;
238
+ const at: number = swivel - 360 * Math.floor(swivel / 360);
239
+ const holding: IArc | undefined = merged.find(
240
+ (arc: IArc): boolean => arc.from <= at && at <= arc.to,
241
+ );
242
+ if (holding === undefined) return swivel;
243
+ return at - holding.from <= holding.to - at ? holding.from : holding.to;
244
+ }
245
+ }
@@ -17,8 +17,8 @@ import { QUATERNION_NLERP_DOT_THRESHOLD } from "./constants/QUATERNION_NLERP_DOT
17
17
  * leaves its inputs unchanged and returns a new value.
18
18
  *
19
19
  * @evidence contracts/development/common.md#meaningful-documentation States the component order, where quaternions come from and go, the unit-length premise for rotation arguments, and that every function returns a new value.
20
- * @evidence contracts/development/design.md#principled-representation Represents Pure quaternion math over , components `(x, y, z, w)` in glTF order: companion namespace of 11 members (`identity`, `DEG2RAD`, `EULER_AXES`, `multiply`, `normalize`, `inverse`, ...); units and frames named in its text: quaternion, radians, degree, world, local. It has no optional member, so no absent-value state combines with another.
21
- * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the module that declares `Quaternion` in packages/engine/src/math/Quaternion.ts; its surface is the 11 members listed and the text shows 335 other files naming it, mostly packages/engine (134), test (78), movies (62), so no member is declared for a presumed future need.
20
+ * @evidence contracts/development/design.md#principled-representation Represents Pure quaternion math over , components `(x, y, z, w)` in glTF order: companion namespace of 12 members (`identity`, `DEG2RAD`, `EULER_AXES`, `multiply`, `normalize`, `inverse`, ...); units and frames named in its text: quaternion, radians, degree, world, local. It has no optional member, so no absent-value state combines with another.
21
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Owned by the module that declares `Quaternion` in packages/engine/src/math/Quaternion.ts; its surface is the 12 members listed and the text shows 335 other files naming it, mostly packages/engine (134), test (78), movies (62), so no member is declared for a presumed future need.
22
22
  * @evidence contracts/development/design.md#prohibited-design-shortcuts Scanning the declaration finds no `any`, no `unknown`, no index signature and no cast; it duplicates no type that another owner declares as far as a name search shows.
23
23
  */
24
24
  export namespace Quaternion {
@@ -351,4 +351,44 @@ export namespace Quaternion {
351
351
  w: a.w * wa + bw * wb,
352
352
  });
353
353
  };
354
+
355
+ /**
356
+ * The angle of the rotation that takes `a` to `b`, in radians within
357
+ * `[0, π]`: the geodesic distance between the two rotations. `q` and `-q`
358
+ * are the same rotation, so negating either argument changes nothing.
359
+ *
360
+ * The angle is `2 atan2(|v|, |w|)` of the relative quaternion
361
+ * `inverse(a) * b`, with `v` its vector part and `w` its scalar part. The
362
+ * shorter formula `2 acos |a · b|` reads a small angle from how far a
363
+ * cosine falls short of 1, which binary64 resolves only to about 1.1e-16,
364
+ * so it returns every angle below about 3e-8 radian as 0 or as one of a few
365
+ * steps that size; the vector part keeps full relative precision there. A
366
+ * search that ranks candidates by this angle needs that precision to settle
367
+ * on the same candidate for mirrored inputs.
368
+ *
369
+ * @param a Unit rotation.
370
+ * @param b Unit rotation.
371
+ * @returns The angle in radians.
372
+ *
373
+ * @evidence contracts/development/implementation.md#principled-implementation The relative rotation of two unit quaternions is `inverse(a) * b`, whose vector part has length `sin(θ/2)` and whose scalar part is `cos(θ/2)`; reading the half angle from both through atan2 is accurate at every angle, where arccosine of the dot product loses all digits of an angle below the square root of the unit roundoff.
374
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One owner for the distance between rotations that the chain fit's reference term, its effector error and its continuity order all read, composed from this namespace's own `inverse` and `multiply`.
375
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No clamp of a dot product and no threshold: the absolute scalar part is the stated identification of `q` with `-q`, and the result is exact to rounding for every pair.
376
+ * @evidence contracts/development/common.md#meaningful-documentation States the unit, the range, the sign insensitivity, the formula and why the shorter arccosine form is not used, and the unit-length premise of both arguments.
377
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms One Hamilton product, one hypotenuse and one arctangent in constant time, with no algorithm to choose.
378
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure function of two rotations that coordinates no work across calls.
379
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Creates two temporary quaternions and returns a number; nothing is retained.
380
+ */
381
+ export const angle: (
382
+ a: IAutoMovieQuaternion,
383
+ b: IAutoMovieQuaternion,
384
+ ) => number = (a: IAutoMovieQuaternion, b: IAutoMovieQuaternion): number => {
385
+ const relative: IAutoMovieQuaternion = multiply(inverse(a), b);
386
+ return (
387
+ 2 *
388
+ Math.atan2(
389
+ Math.hypot(relative.x, relative.y, relative.z),
390
+ Math.abs(relative.w),
391
+ )
392
+ );
393
+ };
354
394
  }
@@ -0,0 +1,65 @@
1
+ import type {
2
+ IAutoMovieQuaternion,
3
+ IAutoMovieTransform,
4
+ IAutoMovieVector3,
5
+ } from "@automovie/interface";
6
+
7
+ import { Quaternion } from "./Quaternion";
8
+
9
+ /**
10
+ * The one constructor of {@link IAutoMovieTransform} records: a translation,
11
+ * a rotation and a per-axis scale, metres, a unit quaternion and
12
+ * dimensionless factors.
13
+ *
14
+ * A frame that does not scale carries the unit scale, `(1, 1, 1)`; it is
15
+ * written here once instead of at every site that builds a frame. Every
16
+ * function returns a new record, because callers spread and build on the
17
+ * frames they are given and must never alias one shared record.
18
+ *
19
+ * @evidence contracts/development/common.md#meaningful-documentation States what the record holds, its units, the unit scale's meaning and that every call returns a new record.
20
+ * @evidence contracts/development/design.md#principled-representation The interface's transform record built from its three parts, the scale defaulting to the identity of scaling.
21
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Two members: the identity transform and the transform of given parts.
22
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts No shared constant record: each frame owns its components, as `Quaternion.identity` does.
23
+ */
24
+ export namespace Transform {
25
+ /**
26
+ * A new identity transform: no translation, no rotation and the unit scale.
27
+ *
28
+ * @returns The transform.
29
+ *
30
+ * @evidence contracts/development/common.md#meaningful-documentation States the three parts and that each call returns a new record.
31
+ * @evidence contracts/development/implementation.md#principled-implementation The neutral element of composing transforms: the zero translation, the identity rotation and the unit scale.
32
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One call of `of` with the zero translation and the identity rotation.
33
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Returns the same exact value for every call, never a cached record.
34
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms Three literal parts in constant time.
35
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A fresh record is the contract, so sharing one would be wrong rather than cheaper.
36
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Each record owns its components and nothing is retained.
37
+ */
38
+ export const identity: () => IAutoMovieTransform = (): IAutoMovieTransform =>
39
+ of({ x: 0, y: 0, z: 0 }, Quaternion.identity());
40
+
41
+ /**
42
+ * A new transform of a translation and a rotation, and a scale that is the
43
+ * unit scale when absent.
44
+ *
45
+ * @param translation World or parent-frame metres.
46
+ * @param rotation A unit quaternion.
47
+ * @param scale Per-axis factors, strictly positive; `(1, 1, 1)` when absent.
48
+ * @returns The transform.
49
+ *
50
+ * @evidence contracts/development/common.md#meaningful-documentation States each part's unit, the scale's default and the result.
51
+ * @evidence contracts/development/implementation.md#principled-implementation The record of its three parts, the unscaled frame's scale the identity of scaling.
52
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One literal from the parts.
53
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The parts are taken as given; the scale's positivity is the caller's premise, which the engine's transform validation checks.
54
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms One record in constant time.
55
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure constructor of its arguments.
56
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources Returns a new record; the default scale is new on each call.
57
+ */
58
+ export function of(
59
+ translation: IAutoMovieVector3,
60
+ rotation: IAutoMovieQuaternion,
61
+ scale: IAutoMovieVector3 = { x: 1, y: 1, z: 1 },
62
+ ): IAutoMovieTransform {
63
+ return { translation, rotation, scale };
64
+ }
65
+ }