@automovie/engine 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (845) hide show
  1. package/README.md +1 -1
  2. package/lib/IAutoMovieFormationPlacement.d.ts +4 -3
  3. package/lib/anthropometry/AutoMovieHandAnthropometry.d.ts +47 -0
  4. package/lib/anthropometry/AutoMovieHandAnthropometry.js +53 -0
  5. package/lib/anthropometry/AutoMovieHandAnthropometry.js.map +1 -0
  6. package/lib/anthropometry/index.d.ts +1 -0
  7. package/lib/anthropometry/index.js +18 -0
  8. package/lib/anthropometry/index.js.map +1 -0
  9. package/lib/composition/AutoMovieComposition.d.ts +25 -6
  10. package/lib/composition/AutoMovieComposition.js +4 -3
  11. package/lib/composition/AutoMovieComposition.js.map +1 -1
  12. package/lib/composition/AutoMovieScheduleCut.d.ts +53 -0
  13. package/lib/composition/AutoMovieScheduleCut.js +99 -0
  14. package/lib/composition/AutoMovieScheduleCut.js.map +1 -0
  15. package/lib/composition/AutoMovieScheduleError.d.ts +79 -0
  16. package/lib/composition/AutoMovieScheduleError.js +51 -0
  17. package/lib/composition/AutoMovieScheduleError.js.map +1 -0
  18. package/lib/composition/AutoMovieSchedulePlace.d.ts +56 -0
  19. package/lib/composition/AutoMovieSchedulePlace.js +185 -0
  20. package/lib/composition/AutoMovieSchedulePlace.js.map +1 -0
  21. package/lib/composition/AutoMovieScheduleWalk.d.ts +121 -0
  22. package/lib/composition/AutoMovieScheduleWalk.js +161 -0
  23. package/lib/composition/AutoMovieScheduleWalk.js.map +1 -0
  24. package/lib/composition/IAutoMovieIntent.d.ts +9 -6
  25. package/lib/composition/index.d.ts +5 -0
  26. package/lib/composition/index.js +5 -0
  27. package/lib/composition/index.js.map +1 -1
  28. package/lib/composition/markAutoMovieContacts.d.ts +29 -0
  29. package/lib/composition/markAutoMovieContacts.js +69 -0
  30. package/lib/composition/markAutoMovieContacts.js.map +1 -0
  31. package/lib/composition/resolveAutoMovieContactEvents.d.ts +56 -7
  32. package/lib/composition/resolveAutoMovieContactEvents.js +89 -18
  33. package/lib/composition/resolveAutoMovieContactEvents.js.map +1 -1
  34. package/lib/composition/resolveAutoMovieMutualGoal.d.ts +45 -29
  35. package/lib/composition/resolveAutoMovieMutualGoal.js +123 -60
  36. package/lib/composition/resolveAutoMovieMutualGoal.js.map +1 -1
  37. package/lib/composition/resolveAutoMovieSchedule.d.ts +69 -11
  38. package/lib/composition/resolveAutoMovieSchedule.js +32 -103
  39. package/lib/composition/resolveAutoMovieSchedule.js.map +1 -1
  40. package/lib/createAutoMovieGeometryActorReader.js +2 -1
  41. package/lib/createAutoMovieGeometryActorReader.js.map +1 -1
  42. package/lib/describeAutoMovieInstanceSetSubject.js +2 -5
  43. package/lib/describeAutoMovieInstanceSetSubject.js.map +1 -1
  44. package/lib/film/compileAttach.js +2 -5
  45. package/lib/film/compileAttach.js.map +1 -1
  46. package/lib/film/compileLaunch.d.ts +2 -2
  47. package/lib/film/compileLaunch.js +4 -3
  48. package/lib/film/compileLaunch.js.map +1 -1
  49. package/lib/film/propAnchorFrame.js +6 -9
  50. package/lib/film/propAnchorFrame.js.map +1 -1
  51. package/lib/film/stageScene.js +3 -10
  52. package/lib/film/stageScene.js.map +1 -1
  53. package/lib/film/staging/lowerLightPlacement.js +4 -7
  54. package/lib/film/staging/lowerLightPlacement.js.map +1 -1
  55. package/lib/formationSlotPosition.d.ts +6 -1
  56. package/lib/formationSlotPosition.js +38 -3
  57. package/lib/formationSlotPosition.js.map +1 -1
  58. package/lib/geometry/IAutoMovieMark.d.ts +99 -0
  59. package/lib/geometry/IAutoMovieMark.js +3 -0
  60. package/lib/geometry/IAutoMovieMark.js.map +1 -0
  61. package/lib/geometry/IAutoMovieMeshDefect.d.ts +33 -0
  62. package/lib/geometry/IAutoMovieMeshDefect.js +3 -0
  63. package/lib/geometry/IAutoMovieMeshDefect.js.map +1 -0
  64. package/lib/geometry/construction/AutoMovieConstructionAdmission.js +72 -10
  65. package/lib/geometry/construction/AutoMovieConstructionAdmission.js.map +1 -1
  66. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.d.ts +35 -0
  67. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js +155 -0
  68. package/lib/geometry/construction/AutoMovieConstructionBridgeRealize.js.map +1 -0
  69. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js +4 -0
  70. package/lib/geometry/construction/AutoMovieConstructionContinuationRealize.js.map +1 -1
  71. package/lib/geometry/construction/AutoMovieConstructionPortRealize.d.ts +1 -1
  72. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js +38 -14
  73. package/lib/geometry/construction/AutoMovieConstructionPortRealize.js.map +1 -1
  74. package/lib/geometry/construction/AutoMovieConstructionSeeds.d.ts +6 -6
  75. package/lib/geometry/construction/AutoMovieConstructionSeeds.js +34 -11
  76. package/lib/geometry/construction/AutoMovieConstructionSeeds.js.map +1 -1
  77. package/lib/geometry/construction/AutoMovieConstructionSplitBand.d.ts +107 -2
  78. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js +452 -16
  79. package/lib/geometry/construction/AutoMovieConstructionSplitBand.js.map +1 -1
  80. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js +262 -0
  81. package/lib/geometry/construction/AutoMovieConstructionSplitRealize.js.map +1 -1
  82. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.d.ts +28 -2
  83. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js +51 -12
  84. package/lib/geometry/construction/AutoMovieConstructionSplitSeam.js.map +1 -1
  85. package/lib/geometry/construction/AutoMovieConstructionState.d.ts +11 -0
  86. package/lib/geometry/construction/AutoMovieConstructionState.js +5 -0
  87. package/lib/geometry/construction/AutoMovieConstructionState.js.map +1 -1
  88. package/lib/geometry/construction/AutoMovieLoftCapRead.js +3 -2
  89. package/lib/geometry/construction/AutoMovieLoftCapRead.js.map +1 -1
  90. package/lib/geometry/construction/AutoMovieLoftCapSource.js +21 -1
  91. package/lib/geometry/construction/AutoMovieLoftCapSource.js.map +1 -1
  92. package/lib/geometry/construction/AutoMovieLoftJet.js +7 -5
  93. package/lib/geometry/construction/AutoMovieLoftJet.js.map +1 -1
  94. package/lib/geometry/construction/AutoMovieLoftPoint.js +7 -4
  95. package/lib/geometry/construction/AutoMovieLoftPoint.js.map +1 -1
  96. package/lib/geometry/construction/AutoMovieLoftRelief.d.ts +25 -0
  97. package/lib/geometry/construction/AutoMovieLoftRelief.js +37 -0
  98. package/lib/geometry/construction/AutoMovieLoftRelief.js.map +1 -1
  99. package/lib/geometry/construction/AutoMovieLoftViewRead.js +29 -7
  100. package/lib/geometry/construction/AutoMovieLoftViewRead.js.map +1 -1
  101. package/lib/geometry/construction/AutoMovieLoftViewSource.js +4 -2
  102. package/lib/geometry/construction/AutoMovieLoftViewSource.js.map +1 -1
  103. package/lib/geometry/construction/AutoMovieNaturalSpline.d.ts +20 -0
  104. package/lib/geometry/construction/AutoMovieNaturalSpline.js +37 -0
  105. package/lib/geometry/construction/AutoMovieNaturalSpline.js.map +1 -1
  106. package/lib/geometry/construction/AutoMovieSolidBlendChain.d.ts +9 -1
  107. package/lib/geometry/construction/AutoMovieSolidBlendChain.js +13 -8
  108. package/lib/geometry/construction/AutoMovieSolidBlendChain.js.map +1 -1
  109. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js +2 -0
  110. package/lib/geometry/construction/AutoMovieSolidBodyMerge.js.map +1 -1
  111. package/lib/geometry/construction/AutoMovieSolidClip.d.ts +15 -1
  112. package/lib/geometry/construction/AutoMovieSolidClip.js +306 -38
  113. package/lib/geometry/construction/AutoMovieSolidClip.js.map +1 -1
  114. package/lib/geometry/construction/AutoMovieSolidCycle.d.ts +20 -5
  115. package/lib/geometry/construction/AutoMovieSolidCycle.js +68 -16
  116. package/lib/geometry/construction/AutoMovieSolidCycle.js.map +1 -1
  117. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js +89 -41
  118. package/lib/geometry/construction/AutoMovieSolidIntersectionWalk.js.map +1 -1
  119. package/lib/geometry/construction/AutoMovieSolidJoin.d.ts +13 -0
  120. package/lib/geometry/construction/AutoMovieSolidJoin.js +23 -2
  121. package/lib/geometry/construction/AutoMovieSolidJoin.js.map +1 -1
  122. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.d.ts +1 -1
  123. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js +28 -3
  124. package/lib/geometry/construction/AutoMovieSolidMeshConstraints.js.map +1 -1
  125. package/lib/geometry/construction/AutoMovieSolidMeshLoop.d.ts +4 -4
  126. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js +42 -4
  127. package/lib/geometry/construction/AutoMovieSolidMeshLoop.js.map +1 -1
  128. package/lib/geometry/construction/AutoMovieSolidMeshPlan.d.ts +2 -1
  129. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js +57 -25
  130. package/lib/geometry/construction/AutoMovieSolidMeshPlan.js.map +1 -1
  131. package/lib/geometry/construction/AutoMovieSolidRail.d.ts +40 -0
  132. package/lib/geometry/construction/AutoMovieSolidRail.js +101 -31
  133. package/lib/geometry/construction/AutoMovieSolidRail.js.map +1 -1
  134. package/lib/geometry/construction/AutoMovieSolidRailSolve.d.ts +7 -3
  135. package/lib/geometry/construction/AutoMovieSolidRailSolve.js +115 -18
  136. package/lib/geometry/construction/AutoMovieSolidRailSolve.js.map +1 -1
  137. package/lib/geometry/construction/AutoMovieViewLoft.js +9 -0
  138. package/lib/geometry/construction/AutoMovieViewLoft.js.map +1 -1
  139. package/lib/geometry/construction/IAutoMovieConstructionCurve.d.ts +37 -0
  140. package/lib/geometry/construction/IAutoMovieConstructionCurve.js +3 -0
  141. package/lib/geometry/construction/IAutoMovieConstructionCurve.js.map +1 -0
  142. package/lib/geometry/construction/IAutoMovieLoftChain.d.ts +6 -0
  143. package/lib/geometry/construction/IAutoMovieLoftRelief.d.ts +10 -0
  144. package/lib/geometry/construction/IAutoMovieViewPart.d.ts +9 -1
  145. package/lib/geometry/construction/faceAutoMovieSolidMesh.d.ts +3 -3
  146. package/lib/geometry/construction/faceAutoMovieSolidMesh.js +65 -16
  147. package/lib/geometry/construction/faceAutoMovieSolidMesh.js.map +1 -1
  148. package/lib/geometry/construction/fairAutoMovieSolidMesh.d.ts +45 -0
  149. package/lib/geometry/construction/fairAutoMovieSolidMesh.js +270 -0
  150. package/lib/geometry/construction/fairAutoMovieSolidMesh.js.map +1 -0
  151. package/lib/geometry/construction/gridAutoMovieSolidMesh.d.ts +18 -1
  152. package/lib/geometry/construction/gridAutoMovieSolidMesh.js +139 -7
  153. package/lib/geometry/construction/gridAutoMovieSolidMesh.js.map +1 -1
  154. package/lib/geometry/construction/index.d.ts +5 -0
  155. package/lib/geometry/construction/index.js +5 -0
  156. package/lib/geometry/construction/index.js.map +1 -1
  157. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.d.ts +14 -1
  158. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js +26 -4
  159. package/lib/geometry/construction/legalizeAutoMovieSolidMesh.js.map +1 -1
  160. package/lib/geometry/construction/markAutoMovieConstructionCurves.d.ts +33 -0
  161. package/lib/geometry/construction/markAutoMovieConstructionCurves.js +51 -0
  162. package/lib/geometry/construction/markAutoMovieConstructionCurves.js.map +1 -0
  163. package/lib/geometry/construction/orientAutoMovieSolidChart.d.ts +1 -1
  164. package/lib/geometry/construction/orientAutoMovieSolidChart.js +28 -4
  165. package/lib/geometry/construction/orientAutoMovieSolidChart.js.map +1 -1
  166. package/lib/geometry/construction/probeAutoMovieSolidMesh.d.ts +11 -5
  167. package/lib/geometry/construction/probeAutoMovieSolidMesh.js +41 -28
  168. package/lib/geometry/construction/probeAutoMovieSolidMesh.js.map +1 -1
  169. package/lib/geometry/construction/realizeAutoMovieConstruction.js +45 -1
  170. package/lib/geometry/construction/realizeAutoMovieConstruction.js.map +1 -1
  171. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.d.ts +31 -0
  172. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js +234 -0
  173. package/lib/geometry/construction/sampleAutoMovieConstructionCurves.js.map +1 -0
  174. package/lib/geometry/index.d.ts +4 -0
  175. package/lib/geometry/index.js +4 -0
  176. package/lib/geometry/index.js.map +1 -1
  177. package/lib/geometry/markAutoMovieMeshClearance.d.ts +32 -0
  178. package/lib/geometry/markAutoMovieMeshClearance.js +53 -0
  179. package/lib/geometry/markAutoMovieMeshClearance.js.map +1 -0
  180. package/lib/geometry/measureAutoMovieMeshDefects.d.ts +31 -0
  181. package/lib/geometry/measureAutoMovieMeshDefects.js +244 -0
  182. package/lib/geometry/measureAutoMovieMeshDefects.js.map +1 -0
  183. package/lib/index.d.ts +1 -0
  184. package/lib/index.js +1 -0
  185. package/lib/index.js.map +1 -1
  186. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.d.ts +36 -0
  187. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js +67 -0
  188. package/lib/kinematics/AutoMovieHumanoidDigitSurfaces.js.map +1 -0
  189. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.d.ts +28 -0
  190. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js +52 -0
  191. package/lib/kinematics/AutoMovieHumanoidSurfaceExtents.js.map +1 -0
  192. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.d.ts +55 -0
  193. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js +191 -0
  194. package/lib/kinematics/AutoMovieHumanoidSurfaceRays.js.map +1 -0
  195. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.d.ts +49 -0
  196. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js +147 -0
  197. package/lib/kinematics/AutoMovieHumanoidSurfaceRegions.js.map +1 -0
  198. package/lib/kinematics/IAutoMovieHingedArticulation.d.ts +17 -3
  199. package/lib/kinematics/IAutoMoviePoseRig.d.ts +31 -0
  200. package/lib/kinematics/IAutoMoviePoseRig.js +3 -0
  201. package/lib/kinematics/IAutoMoviePoseRig.js.map +1 -0
  202. package/lib/kinematics/IAutoMovieSwivelNear.d.ts +25 -0
  203. package/lib/kinematics/IAutoMovieSwivelNear.js +3 -0
  204. package/lib/kinematics/IAutoMovieSwivelNear.js.map +1 -0
  205. package/lib/kinematics/IAutoMovieSwivelSeed.d.ts +18 -0
  206. package/lib/kinematics/IAutoMovieSwivelSeed.js +3 -0
  207. package/lib/kinematics/IAutoMovieSwivelSeed.js.map +1 -0
  208. package/lib/kinematics/alternateRigJointAngles.d.ts +27 -0
  209. package/lib/kinematics/alternateRigJointAngles.js +34 -0
  210. package/lib/kinematics/alternateRigJointAngles.js.map +1 -0
  211. package/lib/kinematics/boxExcludedSwivels.d.ts +64 -0
  212. package/lib/kinematics/boxExcludedSwivels.js +187 -0
  213. package/lib/kinematics/boxExcludedSwivels.js.map +1 -0
  214. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.d.ts +16 -2
  215. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js +19 -4
  216. package/lib/kinematics/constants/HUMANOID_JOINT_AXES.js.map +1 -1
  217. package/lib/kinematics/curlChainUntilContact.d.ts +16 -0
  218. package/lib/kinematics/curlChainUntilContact.js +45 -5
  219. package/lib/kinematics/curlChainUntilContact.js.map +1 -1
  220. package/lib/kinematics/decomposeJointRotation.d.ts +5 -2
  221. package/lib/kinematics/decomposeJointRotation.js +10 -131
  222. package/lib/kinematics/decomposeJointRotation.js.map +1 -1
  223. package/lib/kinematics/decomposeJointRotationOnBasis.d.ts +36 -0
  224. package/lib/kinematics/decomposeJointRotationOnBasis.js +228 -0
  225. package/lib/kinematics/decomposeJointRotationOnBasis.js.map +1 -0
  226. package/lib/kinematics/fitDigitDescent.d.ts +66 -0
  227. package/lib/kinematics/fitDigitDescent.js +142 -0
  228. package/lib/kinematics/fitDigitDescent.js.map +1 -0
  229. package/lib/kinematics/fitDigitToTarget.d.ts +125 -0
  230. package/lib/kinematics/fitDigitToTarget.js +251 -0
  231. package/lib/kinematics/fitDigitToTarget.js.map +1 -0
  232. package/lib/kinematics/hingedArmArticulation.d.ts +55 -7
  233. package/lib/kinematics/hingedArmArticulation.js +273 -84
  234. package/lib/kinematics/hingedArmArticulation.js.map +1 -1
  235. package/lib/kinematics/hingedArmSwivel.d.ts +141 -0
  236. package/lib/kinematics/hingedArmSwivel.js +196 -0
  237. package/lib/kinematics/hingedArmSwivel.js.map +1 -0
  238. package/lib/kinematics/index.d.ts +24 -0
  239. package/lib/kinematics/index.js +24 -0
  240. package/lib/kinematics/index.js.map +1 -1
  241. package/lib/kinematics/jointRomOvershoot.d.ts +13 -9
  242. package/lib/kinematics/jointRomOvershoot.js +21 -17
  243. package/lib/kinematics/jointRomOvershoot.js.map +1 -1
  244. package/lib/kinematics/jointToQuaternion.d.ts +2 -2
  245. package/lib/kinematics/jointToQuaternion.js +4 -19
  246. package/lib/kinematics/jointToQuaternion.js.map +1 -1
  247. package/lib/kinematics/jointToQuaternionOnBasis.d.ts +34 -0
  248. package/lib/kinematics/jointToQuaternionOnBasis.js +50 -0
  249. package/lib/kinematics/jointToQuaternionOnBasis.js.map +1 -0
  250. package/lib/kinematics/markAutoMovieBalance.d.ts +32 -0
  251. package/lib/kinematics/markAutoMovieBalance.js +65 -0
  252. package/lib/kinematics/markAutoMovieBalance.js.map +1 -0
  253. package/lib/kinematics/markAutoMovieRomOvershoot.d.ts +25 -0
  254. package/lib/kinematics/markAutoMovieRomOvershoot.js +43 -0
  255. package/lib/kinematics/markAutoMovieRomOvershoot.js.map +1 -0
  256. package/lib/kinematics/measureAutoMovieHumanoidBody.js +16 -5
  257. package/lib/kinematics/measureAutoMovieHumanoidBody.js.map +1 -1
  258. package/lib/kinematics/normalizeJointAxes.d.ts +15 -7
  259. package/lib/kinematics/normalizeJointAxes.js +52 -12
  260. package/lib/kinematics/normalizeJointAxes.js.map +1 -1
  261. package/lib/kinematics/poseJointCodec.d.ts +71 -0
  262. package/lib/kinematics/poseJointCodec.js +70 -0
  263. package/lib/kinematics/poseJointCodec.js.map +1 -0
  264. package/lib/kinematics/resolveAutoMovieBalanceOutcome.d.ts +112 -0
  265. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js +168 -0
  266. package/lib/kinematics/resolveAutoMovieBalanceOutcome.js.map +1 -0
  267. package/lib/kinematics/resolveAutoMovieCenterOfMass.d.ts +29 -4
  268. package/lib/kinematics/resolveAutoMovieCenterOfMass.js +42 -8
  269. package/lib/kinematics/resolveAutoMovieCenterOfMass.js.map +1 -1
  270. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.d.ts +75 -0
  271. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js +228 -0
  272. package/lib/kinematics/resolveAutoMovieHumanoidRingModules.js.map +1 -0
  273. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.d.ts +90 -10
  274. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js +183 -258
  275. package/lib/kinematics/resolveAutoMovieHumanoidSurfaces.js.map +1 -1
  276. package/lib/kinematics/resolveAutoMovieMomentum.d.ts +112 -0
  277. package/lib/kinematics/resolveAutoMovieMomentum.js +153 -0
  278. package/lib/kinematics/resolveAutoMovieMomentum.js.map +1 -0
  279. package/lib/kinematics/swingTwistBasis.d.ts +108 -0
  280. package/lib/kinematics/swingTwistBasis.js +116 -0
  281. package/lib/kinematics/swingTwistBasis.js.map +1 -0
  282. package/lib/kinematics/swingTwistExcludedSwivels.d.ts +65 -0
  283. package/lib/kinematics/swingTwistExcludedSwivels.js +138 -0
  284. package/lib/kinematics/swingTwistExcludedSwivels.js.map +1 -0
  285. package/lib/kinematics/swingTwistRange.d.ts +246 -0
  286. package/lib/kinematics/swingTwistRange.js +322 -0
  287. package/lib/kinematics/swingTwistRange.js.map +1 -0
  288. package/lib/kinematics/swingTwistRegion.d.ts +50 -0
  289. package/lib/kinematics/swingTwistRegion.js +212 -0
  290. package/lib/kinematics/swingTwistRegion.js.map +1 -0
  291. package/lib/kinematics/swivelArcs.d.ts +166 -0
  292. package/lib/kinematics/swivelArcs.js +200 -0
  293. package/lib/kinematics/swivelArcs.js.map +1 -0
  294. package/lib/math/Quaternion.d.ts +29 -2
  295. package/lib/math/Quaternion.js +33 -2
  296. package/lib/math/Quaternion.js.map +1 -1
  297. package/lib/math/Transform.d.ts +50 -0
  298. package/lib/math/Transform.js +58 -0
  299. package/lib/math/Transform.js.map +1 -0
  300. package/lib/math/assignAutoMovieMinimumCost.d.ts +18 -0
  301. package/lib/math/assignAutoMovieMinimumCost.js +86 -0
  302. package/lib/math/assignAutoMovieMinimumCost.js.map +1 -0
  303. package/lib/math/bracketedBisection.d.ts +33 -0
  304. package/lib/math/bracketedBisection.js +52 -0
  305. package/lib/math/bracketedBisection.js.map +1 -0
  306. package/lib/math/bracketedRoot.d.ts +32 -0
  307. package/lib/math/bracketedRoot.js +76 -0
  308. package/lib/math/bracketedRoot.js.map +1 -0
  309. package/lib/math/index.d.ts +7 -0
  310. package/lib/math/index.js +7 -0
  311. package/lib/math/index.js.map +1 -1
  312. package/lib/math/nearestAngleAlias.d.ts +27 -0
  313. package/lib/math/nearestAngleAlias.js +44 -0
  314. package/lib/math/nearestAngleAlias.js.map +1 -0
  315. package/lib/math/solveAutoMovieHalfPlaneProgram.d.ts +68 -0
  316. package/lib/math/solveAutoMovieHalfPlaneProgram.js +199 -0
  317. package/lib/math/solveAutoMovieHalfPlaneProgram.js.map +1 -0
  318. package/lib/math/tetrahedralizeAutoMovieDelaunay.d.ts +82 -0
  319. package/lib/math/tetrahedralizeAutoMovieDelaunay.js +187 -0
  320. package/lib/math/tetrahedralizeAutoMovieDelaunay.js.map +1 -0
  321. package/lib/measureAutoMovieGeometryReach.js +2 -4
  322. package/lib/measureAutoMovieGeometryReach.js.map +1 -1
  323. package/lib/motion/AirborneTakeoffLinear.d.ts +22 -0
  324. package/lib/motion/AirborneTakeoffLinear.js +58 -0
  325. package/lib/motion/AirborneTakeoffLinear.js.map +1 -0
  326. package/lib/motion/IAutoMovieCrowdAgent.d.ts +113 -0
  327. package/lib/motion/IAutoMovieCrowdAgent.js +3 -0
  328. package/lib/motion/IAutoMovieCrowdAgent.js.map +1 -0
  329. package/lib/motion/IAutoMovieSeededChainFit.d.ts +32 -0
  330. package/lib/motion/IAutoMovieSeededChainFit.js +3 -0
  331. package/lib/motion/IAutoMovieSeededChainFit.js.map +1 -0
  332. package/lib/motion/IAutoMovieSolvedChainPlant.d.ts +20 -0
  333. package/lib/motion/IFitChainToTargetProps.d.ts +59 -0
  334. package/lib/motion/MotionTrajectoryStepper.d.ts +100 -0
  335. package/lib/motion/MotionTrajectoryStepper.js +357 -0
  336. package/lib/motion/MotionTrajectoryStepper.js.map +1 -0
  337. package/lib/motion/basisOf.d.ts +18 -0
  338. package/lib/motion/basisOf.js +25 -0
  339. package/lib/motion/basisOf.js.map +1 -0
  340. package/lib/motion/carriedAcceleration.d.ts +43 -0
  341. package/lib/motion/carriedAcceleration.js +55 -0
  342. package/lib/motion/carriedAcceleration.js.map +1 -0
  343. package/lib/motion/carriedRate.d.ts +48 -0
  344. package/lib/motion/carriedRate.js +60 -0
  345. package/lib/motion/carriedRate.js.map +1 -0
  346. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.d.ts +10 -0
  347. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js +14 -0
  348. package/lib/motion/constants/PLANT_RESIDUAL_EPSILON.js.map +1 -0
  349. package/lib/motion/constants/index.d.ts +1 -0
  350. package/lib/motion/constants/index.js +1 -0
  351. package/lib/motion/constants/index.js.map +1 -1
  352. package/lib/motion/fitChainBend.d.ts +23 -0
  353. package/lib/motion/fitChainBend.js +293 -0
  354. package/lib/motion/fitChainBend.js.map +1 -0
  355. package/lib/motion/fitChainToTarget.d.ts +11 -13
  356. package/lib/motion/fitChainToTarget.js +12 -283
  357. package/lib/motion/fitChainToTarget.js.map +1 -1
  358. package/lib/motion/fitHingedChainCandidate.d.ts +16 -4
  359. package/lib/motion/fitHingedChainCandidate.js +186 -76
  360. package/lib/motion/fitHingedChainCandidate.js.map +1 -1
  361. package/lib/motion/fitHingedRotationError.d.ts +31 -0
  362. package/lib/motion/fitHingedRotationError.js +107 -0
  363. package/lib/motion/fitHingedRotationError.js.map +1 -0
  364. package/lib/motion/fitSeededChainToTarget.d.ts +20 -0
  365. package/lib/motion/fitSeededChainToTarget.js +32 -0
  366. package/lib/motion/fitSeededChainToTarget.js.map +1 -0
  367. package/lib/motion/gaitMotion.js +7 -13
  368. package/lib/motion/gaitMotion.js.map +1 -1
  369. package/lib/motion/gestureMotion.js +2 -5
  370. package/lib/motion/gestureMotion.js.map +1 -1
  371. package/lib/motion/importedNodeClipToAutoMovieMotion.js +6 -9
  372. package/lib/motion/importedNodeClipToAutoMovieMotion.js.map +1 -1
  373. package/lib/motion/index.d.ts +15 -0
  374. package/lib/motion/index.js +15 -0
  375. package/lib/motion/index.js.map +1 -1
  376. package/lib/motion/inertializeOffset.d.ts +15 -2
  377. package/lib/motion/inertializeOffset.js +16 -3
  378. package/lib/motion/inertializeOffset.js.map +1 -1
  379. package/lib/motion/inertializePose.d.ts +36 -13
  380. package/lib/motion/inertializePose.js +122 -43
  381. package/lib/motion/inertializePose.js.map +1 -1
  382. package/lib/motion/integrateAirborneRotation.d.ts +151 -0
  383. package/lib/motion/integrateAirborneRotation.js +204 -0
  384. package/lib/motion/integrateAirborneRotation.js.map +1 -0
  385. package/lib/motion/integrateMotionTrajectory.d.ts +117 -0
  386. package/lib/motion/integrateMotionTrajectory.js +156 -0
  387. package/lib/motion/integrateMotionTrajectory.js.map +1 -0
  388. package/lib/motion/orientChainEffector.d.ts +1 -1
  389. package/lib/motion/orientChainEffector.js +15 -7
  390. package/lib/motion/orientChainEffector.js.map +1 -1
  391. package/lib/motion/resolveHydrodynamicForce.d.ts +85 -0
  392. package/lib/motion/resolveHydrodynamicForce.js +100 -0
  393. package/lib/motion/resolveHydrodynamicForce.js.map +1 -0
  394. package/lib/motion/sampleMotion.js +2 -5
  395. package/lib/motion/sampleMotion.js.map +1 -1
  396. package/lib/motion/samplePoseVelocity.d.ts +76 -13
  397. package/lib/motion/samplePoseVelocity.js +126 -38
  398. package/lib/motion/samplePoseVelocity.js.map +1 -1
  399. package/lib/motion/smoothMinimum.d.ts +29 -0
  400. package/lib/motion/smoothMinimum.js +40 -0
  401. package/lib/motion/smoothMinimum.js.map +1 -0
  402. package/lib/motion/solveAirborneTakeoff.d.ts +150 -0
  403. package/lib/motion/solveAirborneTakeoff.js +324 -0
  404. package/lib/motion/solveAirborneTakeoff.js.map +1 -0
  405. package/lib/motion/solveDistalTwist.d.ts +62 -0
  406. package/lib/motion/solveDistalTwist.js +152 -0
  407. package/lib/motion/solveDistalTwist.js.map +1 -0
  408. package/lib/motion/speedProfile.d.ts +175 -0
  409. package/lib/motion/speedProfile.js +261 -0
  410. package/lib/motion/speedProfile.js.map +1 -0
  411. package/lib/motion/splitDistalTwist.d.ts +12 -17
  412. package/lib/motion/splitDistalTwist.js +37 -40
  413. package/lib/motion/splitDistalTwist.js.map +1 -1
  414. package/lib/motion/steerAutoMovieCrowd.d.ts +74 -0
  415. package/lib/motion/steerAutoMovieCrowd.js +249 -0
  416. package/lib/motion/steerAutoMovieCrowd.js.map +1 -0
  417. package/lib/motion/steerAutoMovieCrowdGeometry.d.ts +241 -0
  418. package/lib/motion/steerAutoMovieCrowdGeometry.js +470 -0
  419. package/lib/motion/steerAutoMovieCrowdGeometry.js.map +1 -0
  420. package/lib/physics/AutoMovieAir.d.ts +21 -0
  421. package/lib/physics/AutoMovieAir.js +26 -0
  422. package/lib/physics/AutoMovieAir.js.map +1 -0
  423. package/lib/physics/AutoMovieGravity.d.ts +22 -0
  424. package/lib/physics/AutoMovieGravity.js +30 -0
  425. package/lib/physics/AutoMovieGravity.js.map +1 -0
  426. package/lib/physics/IAutoMovieHit.d.ts +11 -7
  427. package/lib/physics/IAutoMovieProjectile.d.ts +65 -6
  428. package/lib/physics/IAutoMovieProjectileState.d.ts +6 -4
  429. package/lib/physics/admitMotionGeometry.js +12 -0
  430. package/lib/physics/admitMotionGeometry.js.map +1 -1
  431. package/lib/physics/bindPhysicalWorld.js +16 -4
  432. package/lib/physics/bindPhysicalWorld.js.map +1 -1
  433. package/lib/physics/combinePhysicalMassProperties.d.ts +2 -1
  434. package/lib/physics/combinePhysicalMassProperties.js +8 -90
  435. package/lib/physics/combinePhysicalMassProperties.js.map +1 -1
  436. package/lib/physics/deriveCenterOfMass.js +2 -5
  437. package/lib/physics/deriveCenterOfMass.js.map +1 -1
  438. package/lib/physics/derivePhysicalProfile.js +7 -5
  439. package/lib/physics/derivePhysicalProfile.js.map +1 -1
  440. package/lib/physics/index.d.ts +17 -0
  441. package/lib/physics/index.js +17 -0
  442. package/lib/physics/index.js.map +1 -1
  443. package/lib/physics/markAutoMovieSkeleton.d.ts +33 -0
  444. package/lib/physics/markAutoMovieSkeleton.js +62 -0
  445. package/lib/physics/markAutoMovieSkeleton.js.map +1 -0
  446. package/lib/physics/physicalHullErode.d.ts +25 -0
  447. package/lib/physics/physicalHullErode.js +54 -0
  448. package/lib/physics/physicalHullErode.js.map +1 -0
  449. package/lib/physics/physicalHullFaces.d.ts +56 -0
  450. package/lib/physics/physicalHullFaces.js +151 -0
  451. package/lib/physics/physicalHullFaces.js.map +1 -0
  452. package/lib/physics/physicalHullMass.d.ts +32 -0
  453. package/lib/physics/physicalHullMass.js +80 -0
  454. package/lib/physics/physicalHullMass.js.map +1 -0
  455. package/lib/physics/physicalHullNearest.d.ts +37 -0
  456. package/lib/physics/physicalHullNearest.js +178 -0
  457. package/lib/physics/physicalHullNearest.js.map +1 -0
  458. package/lib/physics/physicalHullSegment.d.ts +34 -0
  459. package/lib/physics/physicalHullSegment.js +276 -0
  460. package/lib/physics/physicalHullSegment.js.map +1 -0
  461. package/lib/physics/physicalInertiaTensor.d.ts +28 -0
  462. package/lib/physics/physicalInertiaTensor.js +58 -0
  463. package/lib/physics/physicalInertiaTensor.js.map +1 -0
  464. package/lib/physics/physicalNativeShape.d.ts +1 -1
  465. package/lib/physics/physicalNativeShape.js +15 -4
  466. package/lib/physics/physicalNativeShape.js.map +1 -1
  467. package/lib/physics/physicalPrincipalAxes.d.ts +28 -0
  468. package/lib/physics/physicalPrincipalAxes.js +96 -0
  469. package/lib/physics/physicalPrincipalAxes.js.map +1 -0
  470. package/lib/physics/physicalShapeBounds.d.ts +2 -1
  471. package/lib/physics/physicalShapeBounds.js +26 -2
  472. package/lib/physics/physicalShapeBounds.js.map +1 -1
  473. package/lib/physics/physicalShapeNearest.d.ts +70 -0
  474. package/lib/physics/physicalShapeNearest.js +201 -0
  475. package/lib/physics/physicalShapeNearest.js.map +1 -0
  476. package/lib/physics/physicalShapeNormal.d.ts +26 -0
  477. package/lib/physics/physicalShapeNormal.js +70 -0
  478. package/lib/physics/physicalShapeNormal.js.map +1 -0
  479. package/lib/physics/physicalShapePairDistance.d.ts +32 -0
  480. package/lib/physics/physicalShapePairDistance.js +124 -0
  481. package/lib/physics/physicalShapePairDistance.js.map +1 -0
  482. package/lib/physics/physicalShapeSegmentDistance.d.ts +16 -20
  483. package/lib/physics/physicalShapeSegmentDistance.js +18 -70
  484. package/lib/physics/physicalShapeSegmentDistance.js.map +1 -1
  485. package/lib/physics/physicalShapeSpan.d.ts +21 -0
  486. package/lib/physics/physicalShapeSpan.js +55 -0
  487. package/lib/physics/physicalShapeSpan.js.map +1 -0
  488. package/lib/physics/physicalShapeSurfaceAnchor.d.ts +1 -1
  489. package/lib/physics/physicalShapeSurfaceAnchor.js +24 -5
  490. package/lib/physics/physicalShapeSurfaceAnchor.js.map +1 -1
  491. package/lib/physics/projectileAt.d.ts +14 -12
  492. package/lib/physics/projectileAt.js +46 -16
  493. package/lib/physics/projectileAt.js.map +1 -1
  494. package/lib/physics/projectileContinue.d.ts +114 -0
  495. package/lib/physics/projectileContinue.js +189 -0
  496. package/lib/physics/projectileContinue.js.map +1 -0
  497. package/lib/physics/projectileDragFlight.d.ts +72 -0
  498. package/lib/physics/projectileDragFlight.js +166 -0
  499. package/lib/physics/projectileDragFlight.js.map +1 -0
  500. package/lib/physics/projectileFirstContact.d.ts +105 -0
  501. package/lib/physics/projectileFirstContact.js +174 -0
  502. package/lib/physics/projectileFirstContact.js.map +1 -0
  503. package/lib/physics/projectileTrajectory.js +3 -2
  504. package/lib/physics/projectileTrajectory.js.map +1 -1
  505. package/lib/physics/solveBallisticLaunch.js +2 -1
  506. package/lib/physics/solveBallisticLaunch.js.map +1 -1
  507. package/lib/physics/solveMovingLaunch.js +2 -1
  508. package/lib/physics/solveMovingLaunch.js.map +1 -1
  509. package/lib/physics/validatePhysicalProfile.js +18 -1
  510. package/lib/physics/validatePhysicalProfile.js.map +1 -1
  511. package/lib/populationRuntime/materializeCompiledFormation.js +2 -5
  512. package/lib/populationRuntime/materializeCompiledFormation.js.map +1 -1
  513. package/lib/resolve/lowerSkeletonNodes.js +3 -10
  514. package/lib/resolve/lowerSkeletonNodes.js.map +1 -1
  515. package/lib/rom/clampJointRom.d.ts +11 -3
  516. package/lib/rom/clampJointRom.js +43 -3
  517. package/lib/rom/clampJointRom.js.map +1 -1
  518. package/lib/rom/clampJointToSkeleton.d.ts +25 -2
  519. package/lib/rom/clampJointToSkeleton.js +39 -8
  520. package/lib/rom/clampJointToSkeleton.js.map +1 -1
  521. package/lib/rom/constants/ANKLE_DORSIFLEXION.d.ts +18 -0
  522. package/lib/rom/constants/ANKLE_DORSIFLEXION.js +22 -0
  523. package/lib/rom/constants/ANKLE_DORSIFLEXION.js.map +1 -0
  524. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.d.ts +28 -0
  525. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js +129 -39
  526. package/lib/rom/constants/DEFAULT_HUMANOID_ROM.js.map +1 -1
  527. package/lib/rom/constants/ROM_TOLERANCE.d.ts +8 -0
  528. package/lib/rom/constants/ROM_TOLERANCE.js +12 -0
  529. package/lib/rom/constants/ROM_TOLERANCE.js.map +1 -0
  530. package/lib/rom/constants/index.d.ts +2 -0
  531. package/lib/rom/constants/index.js +2 -0
  532. package/lib/rom/constants/index.js.map +1 -1
  533. package/lib/rom/index.d.ts +1 -0
  534. package/lib/rom/index.js +1 -0
  535. package/lib/rom/index.js.map +1 -1
  536. package/lib/rom/scanJointRom.d.ts +62 -0
  537. package/lib/rom/scanJointRom.js +117 -0
  538. package/lib/rom/scanJointRom.js.map +1 -0
  539. package/lib/rom/validateJointRom.d.ts +4 -2
  540. package/lib/rom/validateJointRom.js +23 -45
  541. package/lib/rom/validateJointRom.js.map +1 -1
  542. package/lib/soft/IAutoMovieSoftBodyBoundarySample.d.ts +2 -0
  543. package/lib/soft/IAutoMovieSoftBodyObserver.d.ts +30 -0
  544. package/lib/soft/IAutoMovieSoftBodyObserver.js +3 -0
  545. package/lib/soft/IAutoMovieSoftBodyObserver.js.map +1 -0
  546. package/lib/soft/applySoftBodyFriction.d.ts +34 -0
  547. package/lib/soft/applySoftBodyFriction.js +52 -0
  548. package/lib/soft/applySoftBodyFriction.js.map +1 -0
  549. package/lib/soft/index.d.ts +6 -0
  550. package/lib/soft/index.js +6 -0
  551. package/lib/soft/index.js.map +1 -1
  552. package/lib/soft/projectSoftCordSelfContact.d.ts +53 -0
  553. package/lib/soft/projectSoftCordSelfContact.js +172 -0
  554. package/lib/soft/projectSoftCordSelfContact.js.map +1 -0
  555. package/lib/soft/simulateSoftBodyCore.d.ts +6 -3
  556. package/lib/soft/simulateSoftBodyCore.js +108 -16
  557. package/lib/soft/simulateSoftBodyCore.js.map +1 -1
  558. package/lib/soft/simulateSoftBodyWithBoundaries.d.ts +3 -2
  559. package/lib/soft/simulateSoftBodyWithBoundaries.js +10 -3
  560. package/lib/soft/simulateSoftBodyWithBoundaries.js.map +1 -1
  561. package/lib/soft/softBodyBudget.js +7 -0
  562. package/lib/soft/softBodyBudget.js.map +1 -1
  563. package/lib/soft/softBodyHeldLoads.d.ts +34 -0
  564. package/lib/soft/softBodyHeldLoads.js +69 -0
  565. package/lib/soft/softBodyHeldLoads.js.map +1 -0
  566. package/lib/soft/solveSoftBodyCompliantSweep.d.ts +48 -0
  567. package/lib/soft/solveSoftBodyCompliantSweep.js +86 -0
  568. package/lib/soft/solveSoftBodyCompliantSweep.js.map +1 -0
  569. package/lib/soft/validateSoftAnchors.d.ts +24 -0
  570. package/lib/soft/validateSoftAnchors.js +74 -0
  571. package/lib/soft/validateSoftAnchors.js.map +1 -0
  572. package/lib/soft/validateSoftBodyDomain.js +6 -48
  573. package/lib/soft/validateSoftBodyDomain.js.map +1 -1
  574. package/lib/soft/validateSoftBounded.d.ts +20 -0
  575. package/lib/soft/validateSoftBounded.js +27 -0
  576. package/lib/soft/validateSoftBounded.js.map +1 -0
  577. package/lib/soft/validateSoftCompliance.d.ts +30 -0
  578. package/lib/soft/validateSoftCompliance.js +54 -0
  579. package/lib/soft/validateSoftCompliance.js.map +1 -0
  580. package/lib/validation/AffordanceArticulation.d.ts +69 -0
  581. package/lib/validation/AffordanceArticulation.js +142 -0
  582. package/lib/validation/AffordanceArticulation.js.map +1 -0
  583. package/lib/validation/affordanceFollowedTravel.d.ts +19 -0
  584. package/lib/validation/affordanceFollowedTravel.js +43 -0
  585. package/lib/validation/affordanceFollowedTravel.js.map +1 -0
  586. package/lib/validation/affordanceLeadingTravel.d.ts +21 -0
  587. package/lib/validation/affordanceLeadingTravel.js +99 -0
  588. package/lib/validation/affordanceLeadingTravel.js.map +1 -0
  589. package/lib/validation/affordanceTravelRange.d.ts +21 -0
  590. package/lib/validation/affordanceTravelRange.js +39 -0
  591. package/lib/validation/affordanceTravelRange.js.map +1 -0
  592. package/lib/validation/appendShotEventsArtifact.js +12 -0
  593. package/lib/validation/appendShotEventsArtifact.js.map +1 -1
  594. package/lib/validation/detectFreeFall.js +2 -1
  595. package/lib/validation/detectFreeFall.js.map +1 -1
  596. package/lib/validation/index.d.ts +6 -0
  597. package/lib/validation/index.js +6 -0
  598. package/lib/validation/index.js.map +1 -1
  599. package/lib/validation/markAutoMovieSlip.d.ts +26 -0
  600. package/lib/validation/markAutoMovieSlip.js +52 -0
  601. package/lib/validation/markAutoMovieSlip.js.map +1 -0
  602. package/lib/validation/validateAffordance.d.ts +3 -3
  603. package/lib/validation/validateAffordance.js +21 -3
  604. package/lib/validation/validateAffordance.js.map +1 -1
  605. package/lib/validation/validateAffordanceArticulation.d.ts +19 -0
  606. package/lib/validation/validateAffordanceArticulation.js +183 -0
  607. package/lib/validation/validateAffordanceArticulation.js.map +1 -0
  608. package/lib/validation/validateBody.d.ts +2 -2
  609. package/lib/validation/validateBody.js +27 -3
  610. package/lib/validation/validateBody.js.map +1 -1
  611. package/lib/validation/validateJointConstraint.d.ts +1 -1
  612. package/lib/validation/validateJointConstraint.js +9 -1
  613. package/lib/validation/validateJointConstraint.js.map +1 -1
  614. package/lib/validation/validateModel.js +2 -0
  615. package/lib/validation/validateModel.js.map +1 -1
  616. package/lib/worldBlock.js +6 -9
  617. package/lib/worldBlock.js.map +1 -1
  618. package/package.json +6 -6
  619. package/src/IAutoMovieFormationPlacement.ts +4 -3
  620. package/src/anthropometry/AutoMovieHandAnthropometry.ts +65 -0
  621. package/src/anthropometry/index.ts +1 -0
  622. package/src/composition/AutoMovieComposition.ts +34 -7
  623. package/src/composition/AutoMovieScheduleCut.ts +141 -0
  624. package/src/composition/AutoMovieScheduleError.ts +108 -0
  625. package/src/composition/AutoMovieSchedulePlace.ts +253 -0
  626. package/src/composition/AutoMovieScheduleWalk.ts +215 -0
  627. package/src/composition/IAutoMovieIntent.ts +9 -7
  628. package/src/composition/index.ts +5 -0
  629. package/src/composition/markAutoMovieContacts.ts +79 -0
  630. package/src/composition/resolveAutoMovieContactEvents.ts +160 -19
  631. package/src/composition/resolveAutoMovieMutualGoal.ts +146 -72
  632. package/src/composition/resolveAutoMovieSchedule.ts +106 -145
  633. package/src/createAutoMovieGeometryActorReader.ts +2 -1
  634. package/src/describeAutoMovieInstanceSetSubject.ts +2 -5
  635. package/src/film/compileAttach.ts +2 -5
  636. package/src/film/compileLaunch.ts +5 -4
  637. package/src/film/propAnchorFrame.ts +3 -6
  638. package/src/film/stageScene.ts +3 -10
  639. package/src/film/staging/lowerLightPlacement.ts +3 -7
  640. package/src/formationSlotPosition.ts +54 -7
  641. package/src/geometry/IAutoMovieMark.ts +115 -0
  642. package/src/geometry/IAutoMovieMeshDefect.ts +39 -0
  643. package/src/geometry/construction/AutoMovieConstructionAdmission.ts +98 -13
  644. package/src/geometry/construction/AutoMovieConstructionBridgeRealize.ts +172 -0
  645. package/src/geometry/construction/AutoMovieConstructionContinuationRealize.ts +3 -0
  646. package/src/geometry/construction/AutoMovieConstructionPortRealize.ts +48 -16
  647. package/src/geometry/construction/AutoMovieConstructionSeeds.ts +54 -10
  648. package/src/geometry/construction/AutoMovieConstructionSplitBand.ts +509 -15
  649. package/src/geometry/construction/AutoMovieConstructionSplitRealize.ts +278 -0
  650. package/src/geometry/construction/AutoMovieConstructionSplitSeam.ts +50 -18
  651. package/src/geometry/construction/AutoMovieConstructionState.ts +13 -0
  652. package/src/geometry/construction/AutoMovieLoftCapRead.ts +3 -2
  653. package/src/geometry/construction/AutoMovieLoftCapSource.ts +34 -1
  654. package/src/geometry/construction/AutoMovieLoftJet.ts +10 -5
  655. package/src/geometry/construction/AutoMovieLoftPoint.ts +13 -4
  656. package/src/geometry/construction/AutoMovieLoftRelief.ts +42 -0
  657. package/src/geometry/construction/AutoMovieLoftViewRead.ts +34 -6
  658. package/src/geometry/construction/AutoMovieLoftViewSource.ts +4 -2
  659. package/src/geometry/construction/AutoMovieNaturalSpline.ts +44 -0
  660. package/src/geometry/construction/AutoMovieSolidBlendChain.ts +34 -20
  661. package/src/geometry/construction/AutoMovieSolidBodyMerge.ts +2 -0
  662. package/src/geometry/construction/AutoMovieSolidClip.ts +341 -54
  663. package/src/geometry/construction/AutoMovieSolidCycle.ts +104 -26
  664. package/src/geometry/construction/AutoMovieSolidIntersectionWalk.ts +100 -50
  665. package/src/geometry/construction/AutoMovieSolidJoin.ts +48 -2
  666. package/src/geometry/construction/AutoMovieSolidMeshConstraints.ts +35 -3
  667. package/src/geometry/construction/AutoMovieSolidMeshLoop.ts +55 -4
  668. package/src/geometry/construction/AutoMovieSolidMeshPlan.ts +79 -34
  669. package/src/geometry/construction/AutoMovieSolidRail.ts +124 -22
  670. package/src/geometry/construction/AutoMovieSolidRailSolve.ts +116 -25
  671. package/src/geometry/construction/AutoMovieViewLoft.ts +9 -0
  672. package/src/geometry/construction/IAutoMovieConstructionCurve.ts +42 -0
  673. package/src/geometry/construction/IAutoMovieLoftChain.ts +7 -0
  674. package/src/geometry/construction/IAutoMovieLoftRelief.ts +11 -0
  675. package/src/geometry/construction/IAutoMovieViewPart.ts +10 -1
  676. package/src/geometry/construction/faceAutoMovieSolidMesh.ts +76 -15
  677. package/src/geometry/construction/fairAutoMovieSolidMesh.ts +252 -0
  678. package/src/geometry/construction/gridAutoMovieSolidMesh.ts +173 -8
  679. package/src/geometry/construction/index.ts +5 -0
  680. package/src/geometry/construction/legalizeAutoMovieSolidMesh.ts +28 -2
  681. package/src/geometry/construction/markAutoMovieConstructionCurves.ts +58 -0
  682. package/src/geometry/construction/orientAutoMovieSolidChart.ts +32 -7
  683. package/src/geometry/construction/probeAutoMovieSolidMesh.ts +52 -30
  684. package/src/geometry/construction/realizeAutoMovieConstruction.ts +47 -5
  685. package/src/geometry/construction/sampleAutoMovieConstructionCurves.ts +307 -0
  686. package/src/geometry/index.ts +4 -0
  687. package/src/geometry/markAutoMovieMeshClearance.ts +69 -0
  688. package/src/geometry/measureAutoMovieMeshDefects.ts +327 -0
  689. package/src/index.ts +1 -0
  690. package/src/kinematics/AutoMovieHumanoidDigitSurfaces.ts +110 -0
  691. package/src/kinematics/AutoMovieHumanoidSurfaceExtents.ts +81 -0
  692. package/src/kinematics/AutoMovieHumanoidSurfaceRays.ts +286 -0
  693. package/src/kinematics/AutoMovieHumanoidSurfaceRegions.ts +189 -0
  694. package/src/kinematics/IAutoMovieHingedArticulation.ts +21 -3
  695. package/src/kinematics/IAutoMoviePoseRig.ts +39 -0
  696. package/src/kinematics/IAutoMovieSwivelNear.ts +26 -0
  697. package/src/kinematics/IAutoMovieSwivelSeed.ts +19 -0
  698. package/src/kinematics/alternateRigJointAngles.ts +41 -0
  699. package/src/kinematics/boxExcludedSwivels.ts +260 -0
  700. package/src/kinematics/constants/HUMANOID_JOINT_AXES.ts +19 -4
  701. package/src/kinematics/curlChainUntilContact.ts +35 -8
  702. package/src/kinematics/decomposeJointRotation.ts +15 -178
  703. package/src/kinematics/decomposeJointRotationOnBasis.ts +310 -0
  704. package/src/kinematics/fitDigitDescent.ts +253 -0
  705. package/src/kinematics/fitDigitToTarget.ts +425 -0
  706. package/src/kinematics/hingedArmArticulation.ts +402 -116
  707. package/src/kinematics/hingedArmSwivel.ts +295 -0
  708. package/src/kinematics/index.ts +24 -0
  709. package/src/kinematics/jointRomOvershoot.ts +30 -19
  710. package/src/kinematics/jointToQuaternion.ts +8 -43
  711. package/src/kinematics/jointToQuaternionOnBasis.ts +84 -0
  712. package/src/kinematics/markAutoMovieBalance.ts +75 -0
  713. package/src/kinematics/markAutoMovieRomOvershoot.ts +52 -0
  714. package/src/kinematics/measureAutoMovieHumanoidBody.ts +31 -9
  715. package/src/kinematics/normalizeJointAxes.ts +66 -12
  716. package/src/kinematics/poseJointCodec.ts +148 -0
  717. package/src/kinematics/resolveAutoMovieBalanceOutcome.ts +293 -0
  718. package/src/kinematics/resolveAutoMovieCenterOfMass.ts +63 -10
  719. package/src/kinematics/resolveAutoMovieHumanoidRingModules.ts +434 -0
  720. package/src/kinematics/resolveAutoMovieHumanoidSurfaces.ts +230 -356
  721. package/src/kinematics/resolveAutoMovieMomentum.ts +253 -0
  722. package/src/kinematics/swingTwistBasis.ts +162 -0
  723. package/src/kinematics/swingTwistExcludedSwivels.ts +204 -0
  724. package/src/kinematics/swingTwistRange.ts +460 -0
  725. package/src/kinematics/swingTwistRegion.ts +298 -0
  726. package/src/kinematics/swivelArcs.ts +245 -0
  727. package/src/math/Quaternion.ts +42 -2
  728. package/src/math/Transform.ts +65 -0
  729. package/src/math/assignAutoMovieMinimumCost.ts +86 -0
  730. package/src/math/bracketedBisection.ts +51 -0
  731. package/src/math/bracketedRoot.ts +72 -0
  732. package/src/math/index.ts +7 -0
  733. package/src/math/nearestAngleAlias.ts +43 -0
  734. package/src/math/solveAutoMovieHalfPlaneProgram.ts +288 -0
  735. package/src/math/tetrahedralizeAutoMovieDelaunay.ts +264 -0
  736. package/src/measureAutoMovieGeometryReach.ts +2 -4
  737. package/src/motion/AirborneTakeoffLinear.ts +70 -0
  738. package/src/motion/IAutoMovieCrowdAgent.ts +121 -0
  739. package/src/motion/IAutoMovieSeededChainFit.ts +32 -0
  740. package/src/motion/IAutoMovieSolvedChainPlant.ts +20 -0
  741. package/src/motion/IFitChainToTargetProps.ts +67 -0
  742. package/src/motion/MotionTrajectoryStepper.ts +478 -0
  743. package/src/motion/basisOf.ts +29 -0
  744. package/src/motion/carriedAcceleration.ts +56 -0
  745. package/src/motion/carriedRate.ts +61 -0
  746. package/src/motion/constants/PLANT_RESIDUAL_EPSILON.ts +10 -0
  747. package/src/motion/constants/index.ts +1 -0
  748. package/src/motion/fitChainBend.ts +491 -0
  749. package/src/motion/fitChainToTarget.ts +13 -485
  750. package/src/motion/fitHingedChainCandidate.ts +281 -148
  751. package/src/motion/fitHingedRotationError.ts +164 -0
  752. package/src/motion/fitSeededChainToTarget.ts +34 -0
  753. package/src/motion/gaitMotion.ts +6 -10
  754. package/src/motion/gestureMotion.ts +2 -5
  755. package/src/motion/importedNodeClipToAutoMovieMotion.ts +3 -6
  756. package/src/motion/index.ts +15 -0
  757. package/src/motion/inertializeOffset.ts +16 -2
  758. package/src/motion/inertializePose.ts +158 -53
  759. package/src/motion/integrateAirborneRotation.ts +334 -0
  760. package/src/motion/integrateMotionTrajectory.ts +309 -0
  761. package/src/motion/orientChainEffector.ts +19 -13
  762. package/src/motion/resolveHydrodynamicForce.ts +143 -0
  763. package/src/motion/sampleMotion.ts +2 -5
  764. package/src/motion/samplePoseVelocity.ts +168 -41
  765. package/src/motion/smoothMinimum.ts +36 -0
  766. package/src/motion/solveAirborneTakeoff.ts +471 -0
  767. package/src/motion/solveDistalTwist.ts +256 -0
  768. package/src/motion/speedProfile.ts +470 -0
  769. package/src/motion/splitDistalTwist.ts +55 -64
  770. package/src/motion/steerAutoMovieCrowd.ts +381 -0
  771. package/src/motion/steerAutoMovieCrowdGeometry.ts +592 -0
  772. package/src/physics/AutoMovieAir.ts +22 -0
  773. package/src/physics/AutoMovieGravity.ts +28 -0
  774. package/src/physics/IAutoMovieHit.ts +13 -7
  775. package/src/physics/IAutoMovieProjectile.ts +82 -6
  776. package/src/physics/IAutoMovieProjectileState.ts +10 -4
  777. package/src/physics/admitMotionGeometry.ts +16 -0
  778. package/src/physics/bindPhysicalWorld.ts +22 -11
  779. package/src/physics/combinePhysicalMassProperties.ts +9 -117
  780. package/src/physics/deriveCenterOfMass.ts +2 -5
  781. package/src/physics/derivePhysicalProfile.ts +3 -1
  782. package/src/physics/index.ts +17 -0
  783. package/src/physics/markAutoMovieSkeleton.ts +69 -0
  784. package/src/physics/physicalHullErode.ts +72 -0
  785. package/src/physics/physicalHullFaces.ts +215 -0
  786. package/src/physics/physicalHullMass.ts +99 -0
  787. package/src/physics/physicalHullNearest.ts +210 -0
  788. package/src/physics/physicalHullSegment.ts +338 -0
  789. package/src/physics/physicalInertiaTensor.ts +75 -0
  790. package/src/physics/physicalNativeShape.ts +31 -9
  791. package/src/physics/physicalPrincipalAxes.ts +114 -0
  792. package/src/physics/physicalShapeBounds.ts +24 -2
  793. package/src/physics/physicalShapeNearest.ts +287 -0
  794. package/src/physics/physicalShapeNormal.ts +105 -0
  795. package/src/physics/physicalShapePairDistance.ts +153 -0
  796. package/src/physics/physicalShapeSegmentDistance.ts +18 -92
  797. package/src/physics/physicalShapeSpan.ts +75 -0
  798. package/src/physics/physicalShapeSurfaceAnchor.ts +33 -14
  799. package/src/physics/projectileAt.ts +61 -20
  800. package/src/physics/projectileContinue.ts +287 -0
  801. package/src/physics/projectileDragFlight.ts +208 -0
  802. package/src/physics/projectileFirstContact.ts +286 -0
  803. package/src/physics/projectileTrajectory.ts +6 -5
  804. package/src/physics/solveBallisticLaunch.ts +2 -1
  805. package/src/physics/solveMovingLaunch.ts +2 -1
  806. package/src/physics/validatePhysicalProfile.ts +20 -1
  807. package/src/populationRuntime/materializeCompiledFormation.ts +3 -6
  808. package/src/resolve/lowerSkeletonNodes.ts +3 -10
  809. package/src/rom/clampJointRom.ts +59 -2
  810. package/src/rom/clampJointToSkeleton.ts +52 -15
  811. package/src/rom/constants/ANKLE_DORSIFLEXION.ts +20 -0
  812. package/src/rom/constants/DEFAULT_HUMANOID_ROM.ts +148 -37
  813. package/src/rom/constants/ROM_TOLERANCE.ts +8 -0
  814. package/src/rom/constants/index.ts +2 -0
  815. package/src/rom/index.ts +1 -0
  816. package/src/rom/scanJointRom.ts +169 -0
  817. package/src/rom/validateJointRom.ts +69 -74
  818. package/src/soft/IAutoMovieSoftBodyBoundarySample.ts +3 -0
  819. package/src/soft/IAutoMovieSoftBodyObserver.ts +36 -0
  820. package/src/soft/applySoftBodyFriction.ts +65 -0
  821. package/src/soft/index.ts +6 -0
  822. package/src/soft/projectSoftCordSelfContact.ts +239 -0
  823. package/src/soft/simulateSoftBodyCore.ts +127 -15
  824. package/src/soft/simulateSoftBodyWithBoundaries.ts +16 -2
  825. package/src/soft/softBodyBudget.ts +11 -0
  826. package/src/soft/softBodyHeldLoads.ts +85 -0
  827. package/src/soft/solveSoftBodyCompliantSweep.ts +107 -0
  828. package/src/soft/validateSoftAnchors.ts +143 -0
  829. package/src/soft/validateSoftBodyDomain.ts +5 -124
  830. package/src/soft/validateSoftBounded.ts +42 -0
  831. package/src/soft/validateSoftCompliance.ts +102 -0
  832. package/src/validation/AffordanceArticulation.ts +173 -0
  833. package/src/validation/affordanceFollowedTravel.ts +40 -0
  834. package/src/validation/affordanceLeadingTravel.ts +108 -0
  835. package/src/validation/affordanceTravelRange.ts +42 -0
  836. package/src/validation/appendShotEventsArtifact.ts +26 -0
  837. package/src/validation/detectFreeFall.ts +3 -2
  838. package/src/validation/index.ts +6 -0
  839. package/src/validation/markAutoMovieSlip.ts +65 -0
  840. package/src/validation/validateAffordance.ts +38 -3
  841. package/src/validation/validateAffordanceArticulation.ts +311 -0
  842. package/src/validation/validateBody.ts +80 -3
  843. package/src/validation/validateJointConstraint.ts +19 -1
  844. package/src/validation/validateModel.ts +7 -0
  845. package/src/worldBlock.ts +3 -6
@@ -41,6 +41,7 @@ export function AutoMovieConstructionSplitRealize(
41
41
  walk: (node: AutoMovieConstructionNode) => void,
42
42
  report: (node: string, contract: string, detail: string) => void,
43
43
  ): void {
44
+ if ((node.outer ?? []).length > 0) return fan(node, body, state, walk, report);
44
45
  walk(node.host);
45
46
  const hostIndex: number | undefined = state.faces.get(node.hostFace);
46
47
  const hostChain: IAutoMovieLoftChain | undefined = state.chains.get(
@@ -119,6 +120,7 @@ export function AutoMovieConstructionSplitRealize(
119
120
  depth * S,
120
121
  ],
121
122
  ),
123
+ ...(node.profile.heading === undefined ? {} : { heading: node.profile.heading }),
122
124
  });
123
125
  if (typeof curve === "string") return fail(`seam: ${curve}`);
124
126
  seam = { curve, corner: node.profile.corner };
@@ -173,6 +175,7 @@ export function AutoMovieConstructionSplitRealize(
173
175
  child: { surface, station: rail, into },
174
176
  count: n,
175
177
  crease: child.crease,
178
+ ...(child.correspondence === undefined ? {} : { correspondence: child.correspondence }),
176
179
  ...(seam === undefined ? {} : { seam }),
177
180
  });
178
181
  if (typeof band === "string") return fail(`band ${child.band}: ${band}`);
@@ -377,6 +380,281 @@ export function AutoMovieConstructionSplitRealize(
377
380
  }
378
381
  }
379
382
 
383
+ /**
384
+ * Realize a split into more than two (`IAutoMovieConstructionSplit.outer`): the host's open end divided by its nested seams into the
385
+ * children's loops, each spanned to its child's rail by a band (`AutoMovieConstructionSplitBand.fan`), every arc's ring points, every seam's
386
+ * inner points and every rail shared vertex for vertex between the faces that bound them.
387
+ *
388
+ * Each band gives a quarter of its columns to each seam it takes and the rest to its arcs, so the two bands beside a seam read it at the
389
+ * same shares. A broken premise restores the checkpoint and records one diagnostic under the split's name, as a two-way split does.
390
+ *
391
+ * Every fork is one ring vertex, every seam point one vertex read by both its bands, and every cycle names the face across each edge, so
392
+ * no vertex is welded by distance and no child is kept without its siblings. Admission, seams, children and bands come first, then one
393
+ * mutation block of vertices and cycles, linear in children times columns. The body retains the ring, seam and rail vertices, one face
394
+ * per band and its cycles; the checkpoint is released when the node settles.
395
+ */
396
+ function fan(
397
+ node: IAutoMovieConstructionSplit,
398
+ body: AutoMovieSolidBody.IBody,
399
+ state: AutoMovieConstructionState.IState,
400
+ walk: (node: AutoMovieConstructionNode) => void,
401
+ report: (node: string, contract: string, detail: string) => void,
402
+ ): void {
403
+ walk(node.host);
404
+ const hostIndex: number | undefined = state.faces.get(node.hostFace);
405
+ const hostChain: IAutoMovieLoftChain | undefined = state.chains.get(node.hostFace);
406
+ if (hostIndex === undefined || hostChain === undefined) return report(node.name, "host face", `the host face ${node.hostFace} was not realized`);
407
+ const hostKind: "start" | "end" = node.hostEnd === "bottom" ? "start" : "end";
408
+ if (closed(hostChain, node.hostEnd)) return report(node.name, "split end", `the host face's ${node.hostEnd} end closes in a pole`);
409
+ if (cut(body, hostIndex, hostKind)) return report(node.name, "split end", `the host face's ${node.hostEnd} end is already cut away or shared`);
410
+ const snapshot: AutoMovieConstructionState.ISnapshot = AutoMovieConstructionState.snap(body, state);
411
+ const fail = (detail: string): void => {
412
+ report(node.name, "split", detail);
413
+ AutoMovieConstructionState.restore(body, state, snapshot);
414
+ };
415
+ try {
416
+ const n: number = node.count;
417
+ const q: number = n / 4;
418
+ const turn: number = 2 * Math.PI;
419
+ const step: number = turn / n;
420
+ const clock = (k: number): number => k * step;
421
+ const host: IAutoMovieSolidSurface = body.faces[hostIndex]!.surface;
422
+ const hostStation: number = end(hostChain, node.hostEnd);
423
+ const hostInto: 1 | -1 = node.hostEnd === "bottom" ? -1 : 1;
424
+ const layer: IAutoMovieLoftChain.ILayer = hostChain.layers[node.hostEnd === "bottom" ? 0 : hostChain.layers.length - 1]!;
425
+ const frame: AutoMovieLoftFrame.IFrame = layer.frame ?? AutoMovieLoftFrame.horizontal(layer.y);
426
+ const normal: Vec3 | null = AutoMovieSolidVector.unit(AutoMovieSolidVector.scale(AutoMovieSolidVector.cross(frame.v, frame.u), hostInto));
427
+ if (normal === null) return fail("the host's end section has no plane");
428
+
429
+ // The seams, innermost first, each built once so both its bands read one curve.
430
+ const seams: IAutoMovieConstructionSplit.ISeam[] = [{ seam: node.seam, ...(node.profile === undefined ? {} : { profile: node.profile }) }, ...(node.outer ?? [])];
431
+ const S: number = seams.length;
432
+ const curves: AutoMovieConstructionSplitSeam.ISeam[] = [];
433
+ for (const [j, s] of seams.entries()) {
434
+ const made: AutoMovieConstructionSplitSeam.ISeam | string =
435
+ s.profile === undefined
436
+ ? AutoMovieConstructionSplitSeam.straight({ host, station: hostStation, seam: s.seam, normal })
437
+ : AutoMovieConstructionSplitSeam.create({ host, station: hostStation, into: hostInto, seam: s.seam, normal, knots: s.profile.knots.map(([along, depth]: [number, number]): [number, number] => [along * AutoMovieConstructionViews.SCALE, depth * AutoMovieConstructionViews.SCALE]), ...(s.profile.heading === undefined ? {} : { heading: s.profile.heading }) });
438
+ if (typeof made === "string") return fail(`seam ${j}: ${made}`);
439
+ curves.push(made);
440
+ }
441
+ const corner: number = seams.find((s: IAutoMovieConstructionSplit.ISeam): boolean => s.profile !== undefined)?.profile?.corner ?? 0;
442
+ const reach: number | undefined = seams.find((s: IAutoMovieConstructionSplit.ISeam): boolean => s.profile !== undefined)?.profile?.reach;
443
+ const square: boolean = seams.find((s: IAutoMovieConstructionSplit.ISeam): boolean => s.profile !== undefined)?.profile?.square === true;
444
+ const a = (j: number): number => seams[j]!.seam[0];
445
+ const b = (j: number): number => seams[j]!.seam[1];
446
+
447
+ // Each child's loop: arcs in increasing host phase, seams between them (`IAutoMovieConstructionSplit.outer`). An arc names the fork it
448
+ // starts at, `a` or `b` and its seam.
449
+ type Arc = { kind: "arc"; from: number; to: number; columns: number; fork: string };
450
+ type Seam = { kind: "seam"; index: number; forward: boolean; columns: number };
451
+ const plan: (Arc | Seam)[][] = Array.from({ length: S + 1 }, (_: unknown, c: number): (Arc | Seam)[] =>
452
+ c === 0
453
+ ? [{ kind: "arc", from: a(0), to: b(0), columns: 3 * q, fork: "a0" }, { kind: "seam", index: 0, forward: false, columns: q }]
454
+ : c === S
455
+ ? [{ kind: "arc", from: b(S - 1), to: a(S - 1) + turn, columns: 3 * q, fork: "b" + (S - 1) }, { kind: "seam", index: S - 1, forward: true, columns: q }]
456
+ : [
457
+ { kind: "arc", from: a(c), to: a(c - 1), columns: q, fork: "a" + c },
458
+ { kind: "seam", index: c - 1, forward: true, columns: q },
459
+ { kind: "arc", from: b(c - 1), to: b(c), columns: q, fork: "b" + (c - 1) },
460
+ { kind: "seam", index: c, forward: false, columns: q },
461
+ ],
462
+ );
463
+
464
+ // The children, once the host's end and seams are admitted.
465
+ for (const child of node.children) walk(child.part);
466
+ const children: { index: number; surface: IAutoMovieSolidSurface; rail: number; kind: "start" | "end"; band: AutoMovieConstructionSplitBand.IStrip & { phases: number[] } }[] = [];
467
+ for (const [c, child] of node.children.entries()) {
468
+ const index: number | undefined = state.faces.get(child.partFace);
469
+ const chain: IAutoMovieLoftChain | undefined = state.chains.get(child.partFace);
470
+ if (index === undefined || index < snapshot.faces || chain === undefined) return fail(`the child face ${child.partFace} was not realized`);
471
+ const kind: "start" | "end" = child.partEnd === "bottom" ? "start" : "end";
472
+ if (cut(body, index, kind)) return fail(`the child face ${child.partFace}'s ${child.partEnd} side is already cut away`);
473
+ const surface: IAutoMovieSolidSurface = body.faces[index]!.surface;
474
+ const into: 1 | -1 = child.partEnd === "bottom" ? 1 : -1;
475
+ const rail: number = end(chain, child.partEnd) + into * child.rail * AutoMovieConstructionViews.SCALE;
476
+ const [first, last]: [number, number] = surface.domain ?? [chain.layers[0]!.y, chain.layers[chain.layers.length - 1]!.y];
477
+ if (!(rail > first && rail < last)) return fail(`the child face ${child.partFace}'s rail at station ${rail} mm lies outside its domain [${first}, ${last}] mm`);
478
+ const band: (AutoMovieConstructionSplitBand.IStrip & { phases: number[] }) | string = AutoMovieConstructionSplitBand.fan(
479
+ {
480
+ name: child.band,
481
+ host: { surface: host, station: hostStation, into: hostInto },
482
+ child: { surface, station: rail, into },
483
+ stretches: plan[c]!.map((s: Arc | Seam): AutoMovieConstructionSplitBand.IStretch => (s.kind === "arc" ? { kind: "arc", from: s.from, to: s.to, columns: s.columns } : { kind: "seam", curve: curves[s.index]!, forward: s.forward, columns: s.columns })),
484
+ corner,
485
+ ...(reach === undefined ? {} : { reach }),
486
+ ...(square ? { square } : {}),
487
+ ...(child.crease === undefined ? {} : { crease: child.crease }),
488
+ ...(child.correspondence === undefined ? {} : { correspondence: child.correspondence }),
489
+ },
490
+ n,
491
+ );
492
+ if (typeof band === "string") return fail(`band ${child.band}: ${band}`);
493
+ children.push({ index, surface, rail, kind, band });
494
+ }
495
+
496
+ // Each band's column: its stretch and the index in it.
497
+ const columns: { stretch: Arc | Seam; j: number; previous: Arc | Seam }[][] = plan.map((stretches: (Arc | Seam)[]): { stretch: Arc | Seam; j: number; previous: Arc | Seam }[] =>
498
+ stretches.flatMap((stretch: Arc | Seam, i: number): { stretch: Arc | Seam; j: number; previous: Arc | Seam }[] => Array.from({ length: stretch.columns }, (_: unknown, j: number): { stretch: Arc | Seam; j: number; previous: Arc | Seam } => ({ stretch, j, previous: stretches[(i - 1 + stretches.length) % stretches.length]! }))),
499
+ );
500
+ // Where a seam's share index `i` (from its fork `a`, 0..q) stands in a band: its column, or past its last column the next stretch's first.
501
+ const shareColumn = (c: number, seam: number, i: number): number | null => {
502
+ let k: number = 0;
503
+ for (const stretch of plan[c]!) {
504
+ if (stretch.kind === "seam" && stretch.index === seam) {
505
+ const j: number = stretch.forward ? i : q - i;
506
+ return k + j;
507
+ }
508
+ k += stretch.columns;
509
+ }
510
+ return null;
511
+ };
512
+ const beside = (seam: number): [number, number] => [seam, seam + 1];
513
+
514
+ // Shared vertices: ring points by arc and column (a fork is its arc's first), seam points by seam and share, rails per child.
515
+ const mesh: AutoMovieSolidMesh.IMesh = body.mesh;
516
+ const hostOwner: number = AutoMovieSolidMesh.owner(mesh, host);
517
+ const ring: Map<string, number> = new Map();
518
+ const ringVertex = (fork: string, j: number, phi: number): number => {
519
+ const key: string = fork + ":" + j;
520
+ let v: number | undefined = ring.get(key);
521
+ if (v === undefined) ring.set(key, (v = AutoMovieSolidMesh.vertex(mesh, host.jet(hostStation, phi).p, hostOwner, hostStation, phi)));
522
+ return v;
523
+ };
524
+ // The fork an arc ends at is the first column of the arc that starts there.
525
+ const arcs: Arc[] = plan.flatMap((stretches: (Arc | Seam)[]): Arc[] => stretches.filter((s: Arc | Seam): s is Arc => s.kind === "arc"));
526
+ const forkOf = (phi: number): string => {
527
+ const at: Arc | undefined = arcs.find((x: Arc): boolean => Math.abs(((x.from - phi) % turn + turn + Math.PI) % turn - Math.PI) < 1e-12);
528
+ if (at === undefined) throw new Error("a fork that starts no arc");
529
+ return at.fork;
530
+ };
531
+ const seamPoints: Map<string, number> = new Map();
532
+ const loops: number[][] = children.map((child: (typeof children)[number], c: number): number[] =>
533
+ columns[c]!.map(({ stretch, j, previous }: { stretch: Arc | Seam; j: number; previous: Arc | Seam }, k: number): number => {
534
+ if (stretch.kind === "arc") return ringVertex(stretch.fork, j, child.band.phases[k]!);
535
+ if (j === 0 && previous.kind === "arc") return ringVertex(forkOf(previous.to), 0, previous.to);
536
+ const i: number = stretch.forward ? j : q - j;
537
+ const key: string = stretch.index + ":" + i;
538
+ let v: number | undefined = seamPoints.get(key);
539
+ if (v === undefined) seamPoints.set(key, (v = AutoMovieSolidMesh.vertex(mesh, child.band.surface.jet(0, clock(k)).p, AutoMovieSolidMesh.owner(mesh, child.band.surface), 0, clock(k))));
540
+ return v;
541
+ }),
542
+ );
543
+ const rails: number[][] = children.map((child: (typeof children)[number]): number[] => {
544
+ const owner: number = AutoMovieSolidMesh.owner(mesh, child.surface);
545
+ return child.band.childPhases.map((psi: number): number => AutoMovieSolidMesh.vertex(mesh, child.surface.jet(child.rail, psi).p, owner, child.rail, psi));
546
+ });
547
+
548
+ // The band faces.
549
+ const faces: number[] = children.map(
550
+ (child: (typeof children)[number]): number =>
551
+ body.faces.push({
552
+ surface: child.band.surface,
553
+ stations: graded(child.band.length, node.rows, child.band.loop),
554
+ phases: Array.from({ length: n }, (_: unknown, k: number): number => clock(k)),
555
+ cycles: [],
556
+ }) - 1,
557
+ );
558
+
559
+ // The host's end cycle: every arc's columns in increasing host phase.
560
+ const ordered: { c: number; k: number }[] = children
561
+ .flatMap((_: (typeof children)[number], c: number): { c: number; k: number }[] => columns[c]!.flatMap((col: { stretch: Arc | Seam }, k: number): { c: number; k: number }[] => (col.stretch.kind === "arc" ? [{ c, k }] : [])))
562
+ .sort((x: { c: number; k: number }, y: { c: number; k: number }): number => children[x.c]!.band.phases[x.k]! - children[y.c]!.band.phases[y.k]!);
563
+ body.faces[hostIndex]!.cycles.push({
564
+ kind: hostKind,
565
+ vertices: ordered.map(({ c, k }: { c: number; k: number }): number => loops[c]![k]!),
566
+ chart: ordered.map(({ c, k }: { c: number; k: number }): [number, number] => [hostStation, children[c]!.band.phases[k]!]),
567
+ neighbours: ordered.map(({ c, k }: { c: number; k: number }): AutoMovieSolidCycle.INeighbour => ({ face: faces[c]!, from: [0, clock(k)], to: [0, clock(k + 1)] })),
568
+ });
569
+
570
+ children.forEach((child: (typeof children)[number], c: number): void => {
571
+ const loop: number[] = loops[c]!;
572
+ body.faces[faces[c]!]!.cycles.push(
573
+ {
574
+ kind: "start",
575
+ vertices: loop,
576
+ chart: loop.map((_: number, k: number): [number, number] => [0, clock(k)]),
577
+ neighbours: loop.map((_: number, k: number): AutoMovieSolidCycle.INeighbour => {
578
+ const { stretch } = columns[c]![k]!;
579
+ if (stretch.kind === "arc") return { face: hostIndex, from: [hostStation, child.band.phases[k]!], to: [hostStation, child.band.phases[k + 1]!] };
580
+ // On a seam: the same two points in the other band beside it.
581
+ const j: number = columns[c]![k]!.j;
582
+ const i1: number = stretch.forward ? j : q - j;
583
+ const i2: number = stretch.forward ? j + 1 : q - j - 1;
584
+ const [left, right]: [number, number] = beside(stretch.index);
585
+ const other: number = c === left ? right : left;
586
+ const otherStretch: Seam = plan[other]!.find((s: Arc | Seam): s is Seam => s.kind === "seam" && s.index === stretch.index)!;
587
+ const from: number = clock(shareColumn(other, stretch.index, i1)!);
588
+ return { face: faces[other]!, from: [0, from], to: [0, from + (otherStretch.forward ? i2 - i1 : i1 - i2) * step] };
589
+ }),
590
+ },
591
+ {
592
+ kind: "end",
593
+ vertices: rails[c]!.slice(),
594
+ chart: rails[c]!.map((_: number, k: number): [number, number] => [child.band.length, clock(k)]),
595
+ neighbours: rails[c]!.map((_: number, k: number): AutoMovieSolidCycle.INeighbour => ({
596
+ face: child.index,
597
+ from: [child.rail, child.band.childPhases[k]!],
598
+ to: [child.rail, k + 1 < n ? child.band.childPhases[k + 1]! : child.band.childPhases[0]! + Math.sign(child.band.childPhases[n - 1]! - child.band.childPhases[0]!) * turn],
599
+ })),
600
+ },
601
+ );
602
+
603
+ // The child's rail cycle in increasing child phase.
604
+ const rising: boolean = child.band.childPhases[n - 1]! > child.band.childPhases[0]!;
605
+ const order: number[] = Array.from({ length: n }, (_: unknown, j: number): number => (rising ? j : n - 1 - j));
606
+ body.faces[child.index]!.cycles.push({
607
+ kind: child.kind,
608
+ vertices: order.map((k: number): number => rails[c]![k]!),
609
+ chart: order.map((k: number): [number, number] => [child.rail, child.band.childPhases[k]!]),
610
+ neighbours: order.map((k: number, j: number): AutoMovieSolidCycle.INeighbour => {
611
+ const next: number = order[(j + 1) % n]!;
612
+ const wraps: boolean = j + 1 === n;
613
+ return { face: faces[c]!, from: [child.band.length, clock(k)], to: [child.band.length, clock(next) + (wraps ? (rising ? turn : -turn) : 0)] };
614
+ }),
615
+ });
616
+ state.faces.set(node.children[c]!.band, faces[c]!);
617
+ state.chains.set(node.children[c]!.band, child.band.chain);
618
+ state.chainList.push(child.band.chain);
619
+ state.chainSurfaces.push(child.band.surface);
620
+ });
621
+
622
+ // Each seam's forks, the ring vertices its two arcs start at, are faired once the skin is drawn over a disc the declared share of the
623
+ // seam's chord across (`IAutoMovieConstructionSplit.IProfile.fair`).
624
+ seams.forEach((s: IAutoMovieConstructionSplit.ISeam, j: number): void => {
625
+ const fair: number | [number, number] | undefined = s.profile?.fair;
626
+ if (fair === undefined) return;
627
+ const chord: number = AutoMovieSolidVector.norm(AutoMovieSolidVector.sub(curves[j]!.ends[1], curves[j]!.ends[0]));
628
+ const shares: [number, number] = typeof fair === "number" ? [fair, fair] : fair;
629
+ (state.fairs ??= []).push({ vertices: [ring.get("a" + j + ":0")!], radius: shares[0] * chord }, { vertices: [ring.get("b" + j + ":0")!], radius: shares[1] * chord });
630
+ });
631
+ } catch (error: unknown) {
632
+ AutoMovieConstructionState.restore(body, state, snapshot);
633
+ if (!(error instanceof AutoMovieLoftAdmissionError)) throw error;
634
+ report(node.name, "split", error.message);
635
+ }
636
+ }
637
+
638
+ /**
639
+ * The grid stations of a band of a split into more than two: from the loop, rows as tall as the loop's columns are apart on average, each
640
+ * half again as tall as the one before until it reaches the declared `length / rows`, then that, scaled to end at the child's rail. At a
641
+ * fork the loop turns a quarter turn between the host's ring and the seam, and the band's columns fan through that turn within a distance
642
+ * of the loop the size of their own spacing; rows `length / rows` apart, up to 2 mm against columns 0.2 to 1 mm apart, drew the band's
643
+ * first triangles across the fan, folded back between the host and the seam (a quarter of a hand's finger forks stood as spikes).
644
+ */
645
+ function graded(length: number, rows: number, loop: readonly Vec3[]): number[] {
646
+ let perimeter: number = 0;
647
+ loop.forEach((p: Vec3, k: number): void => {
648
+ perimeter += AutoMovieSolidVector.norm(AutoMovieSolidVector.sub(loop[(k + 1) % loop.length]!, p));
649
+ });
650
+ const coarse: number = length / rows;
651
+ const stations: number[] = [0];
652
+ for (let h: number = Math.min(coarse, perimeter / loop.length); stations.at(-1)! < length - 1e-9; h = Math.min(coarse, 1.5 * h)) stations.push(stations.at(-1)! + h);
653
+ // The last station is the band's length itself, never its scaled image: `s * (length / s)` may round past the length, outside the
654
+ // band's own domain, and its face's grid was then refused ("unavailable source physical2"), as f1's -Z little finger's band was.
655
+ const scale: number = length / stations.at(-1)!;
656
+ return stations.map((s: number, k: number): number => (k === stations.length - 1 ? length : s * scale));
657
+ }
380
658
  /** A real pole cannot be split. */
381
659
  function closed(chain: IAutoMovieLoftChain, side: "bottom" | "top"): boolean {
382
660
  return chain.pole?.end === side || chain.opposite?.end === side;
@@ -8,7 +8,7 @@ const { add, cross, dot, norm, scale, sub, unit } = AutoMovieSolidVector;
8
8
  /**
9
9
  * A split's curved seam (`IAutoMovieConstructionSplit.IProfile`): the curve both bands start from in place of the straight chord, in the seam plane that holds the chord and the host end's outward normal.
10
10
  *
11
- * The curve is the clamped cubic spline, on chord-length parameters (mm), through the seam's first end (the host's end ring at phase `a`), the authored knots and its second end (phase `b`). At each end its unit tangent is the line where the host's tangent plane meets the seam plane: out of the host at the first end, into it at the second. The seam therefore leaves both forks along the host's own surface. Columns read it at equal arclength shares.
11
+ * The curve is the clamped cubic spline, on chord-length parameters (mm) between its knots, so it is parameterized by its own course and may run out along the host before it turns across the end, through the seam's first end (the host's end ring at phase `a`), the authored knots and its second end (phase `b`). At each end its unit tangent is the line where the host's tangent plane meets the seam plane: out of the host at the first end, into it at the second. The seam therefore leaves both forks along the host's own surface. Columns read it at equal arclength shares.
12
12
  *
13
13
  * @evidence contracts/development/common.md#meaningful-documentation States the plane, the curve, its end tangents, its parameter and its refusals.
14
14
  * @evidence contracts/development/design.md#principled-representation Represents A split's curved seam (`IAutoMovieConstructionSplit.IProfile`): the curve both bands start from in place of the straight chord, in the seam plane that holds the chord and the host end's outward normal: companion namespace of 4 members (`IPoint`, `ISeam`, `create`, `GAUSS`); units and frames named in its text: second, radians, world. It has no optional member, so no absent-value state combines with another.
@@ -75,11 +75,12 @@ export namespace AutoMovieConstructionSplitSeam {
75
75
  * @param input.seam The seam's host phases `[a, b]`, radians.
76
76
  * @param input.normal The host end section's unit normal out of the host.
77
77
  * @param input.knots The interior knots `[along, depth]`, mm.
78
+ * @param input.heading A direction the plane holds in place of the end normal (`IAutoMovieConstructionSplit.IProfile.heading`), or absent.
78
79
  * @returns The seam, or the refusal.
79
80
  *
80
81
  * @evidence contracts/development/implementation.md#principled-implementation Plane from the chord and the end normal, end tangents from the host's tangent planes, then the clamped spline and its arclength.
81
82
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One pass: plane, knots, tangents, solve, lengths.
82
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Refuses a collapsed chord, an end normal along the chord, knots that do not advance inside the chord, and an end whose tangent plane holds no direction of the seam plane.
83
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Refuses a collapsed chord, an end normal along the chord, a knot outside the chord's span or on its neighbour, and an end whose tangent plane holds no direction of the seam plane.
83
84
  * @evidence contracts/development/common.md#meaningful-documentation States its refusals in its result.
84
85
  * @evidence contracts/development/implementation.md#efficient-algorithms Linear in knots.
85
86
  * @evidence contracts/development/implementation.md#reuse-equivalent-work The two end jets serve both the ends and their tangents.
@@ -92,6 +93,7 @@ export namespace AutoMovieConstructionSplitSeam {
92
93
  seam: [number, number];
93
94
  normal: Vec3;
94
95
  knots: readonly (readonly [number, number])[];
96
+ heading?: Vec3;
95
97
  }): ISeam | string {
96
98
  const first: IAutoMovieSolidSurface.IJet = input.host.jet(
97
99
  input.station,
@@ -106,28 +108,27 @@ export namespace AutoMovieConstructionSplitSeam {
106
108
  const chord: number = norm(sub(B, A));
107
109
  const e1: Vec3 | null = unit(sub(B, A));
108
110
  if (e1 === null) return "the seam's ends coincide";
109
- const e2: Vec3 | null = unit(
110
- sub(input.normal, scale(e1, dot(input.normal, e1))),
111
- );
112
- if (e2 === null)
113
- return "the host end's normal runs along the chord, so no seam plane stands";
111
+ // The plane's second axis: the declared heading, or the end normal, square to the chord and out of the host.
112
+ const toward: Vec3 = input.heading ?? input.normal;
113
+ const square: Vec3 | null = unit(sub(toward, scale(e1, dot(toward, e1))));
114
+ if (square === null)
115
+ return input.heading === undefined ? "the host end's normal runs along the chord, so no seam plane stands" : "the seam's heading runs along the chord, so no seam plane stands";
116
+ const e2: Vec3 = dot(square, input.normal) < 0 ? scale(square, -1) : square;
114
117
  const normal: Vec3 = cross(e1, e2);
115
118
 
116
- // Knots in the plane's coordinates: (along e1 from A, along e2), mm.
119
+ // Knots in the plane's coordinates: (along e1 from A, along e2), mm. The
120
+ // spline below is parameterized by chord length between knots, so a knot
121
+ // need not advance along the chord: a seam may first run out along the
122
+ // host before it turns across the end. Each knot stays within the
123
+ // chord's span; coincident neighbours are refused with the spans below.
117
124
  const points: [number, number][] = [[0, 0]];
118
125
  for (const [along, depth] of input.knots) {
119
- if (
120
- !(
121
- Number.isFinite(along) &&
122
- Number.isFinite(depth) &&
123
- along > points[points.length - 1]![0]
124
- )
125
- )
126
- return `the seam's knot (${along}, ${depth}) mm does not advance along the chord`;
126
+ if (!(Number.isFinite(along) && Number.isFinite(depth)))
127
+ return `the seam's knot (${along}, ${depth}) mm is not finite`;
128
+ if (!(along >= 0 && along <= chord))
129
+ return `the seam's knot (${along}, ${depth}) mm stands beyond the chord's span [0, ${chord}] mm`;
127
130
  points.push([along, depth]);
128
131
  }
129
- if (!(points[points.length - 1]![0] < chord))
130
- return `the seam's last knot stands at or beyond the chord's length ${chord} mm`;
131
132
  points.push([chord, 0]);
132
133
 
133
134
  // End tangents: the host's tangent plane meets the seam plane along
@@ -295,6 +296,37 @@ export namespace AutoMovieConstructionSplitSeam {
295
296
  };
296
297
  }
297
298
 
299
+ /**
300
+ * The straight chord between the seam's forks read as a seam, in the same plane a curved one stands in, for a split into more than two
301
+ * whose seam declares no profile.
302
+ *
303
+ * @param input.host The host face's surface.
304
+ * @param input.station The host's end station, mm.
305
+ * @param input.seam The seam's host phases `[a, b]`, radians.
306
+ * @param input.normal The host end section's unit normal out of the host.
307
+ * @returns The chord as a seam, or the refusal.
308
+ *
309
+ * @evidence contracts/development/implementation.md#principled-implementation The chord and its plane are the ones `create` builds its curve in, so a straight and a curved seam are ruled alike.
310
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Ends, plane, then a linear reader.
311
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Refuses coincident forks and an end normal along the chord, as `create` does.
312
+ * @evidence contracts/development/common.md#meaningful-documentation States its plane and its refusals.
313
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant time per reading.
314
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The two end jets serve both ends and the plane.
315
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Retains two ends and one normal.
316
+ */
317
+ export function straight(input: { host: IAutoMovieSolidSurface; station: number; seam: [number, number]; normal: Vec3 }): ISeam | string {
318
+ const pa: readonly number[] = input.host.jet(input.station, input.seam[0]).p;
319
+ const pb: readonly number[] = input.host.jet(input.station, input.seam[1]).p;
320
+ const A: Vec3 = [pa[0]!, pa[1]!, pa[2]!];
321
+ const B: Vec3 = [pb[0]!, pb[1]!, pb[2]!];
322
+ const e1: Vec3 | null = unit(sub(B, A));
323
+ if (e1 === null) return "the seam's ends coincide";
324
+ const e2: Vec3 | null = unit(sub(input.normal, scale(e1, dot(input.normal, e1))));
325
+ if (e2 === null) return "the host end's normal runs along the chord, so no seam plane stands";
326
+ const length: number = norm(sub(B, A));
327
+ return { ends: [A, B], normal: cross(e1, e2), length, at: (t: number): IPoint => ({ point: add(A, scale(e1, Math.min(1, Math.max(0, t)) * length)), tangent: e1 }) };
328
+ }
329
+
298
330
  /** 8-point Gauss-Legendre nodes and weights on [-1, 1]. */
299
331
  const GAUSS: [number, number][] = [
300
332
  [-0.9602898564975363, 0.1012285362903763],
@@ -48,6 +48,12 @@ export namespace AutoMovieConstructionState {
48
48
  /** Actual collapsed profile ends awaiting drawn-boundary admission. */
49
49
  profileEnds?: AutoMovieConstructionProfileBody.IEnd[];
50
50
 
51
+ /**
52
+ * The regions the drawn skin is faired over (`fairAutoMovieSolidMesh`), each about its sources, mesh vertices, or about every vertex a
53
+ * surface owns once the skin is drawn (a merge's blend), each radius mm; absent, none.
54
+ */
55
+ fairs?: { vertices?: number[]; surface?: IAutoMovieSolidSurface; radius: number }[];
56
+
51
57
  /** The kept joins. */
52
58
  joins: AutoMovieConstructionRealization.IJoin[];
53
59
 
@@ -141,6 +147,9 @@ export namespace AutoMovieConstructionState {
141
147
  /** Actual collapsed-end record count. */
142
148
  profileEnds: number;
143
149
 
150
+ /** The fairing disc list's length; zero when the state keeps none. */
151
+ fairs: number;
152
+
144
153
  /** The kept join list's length. */
145
154
  joins: number;
146
155
 
@@ -183,6 +192,7 @@ export namespace AutoMovieConstructionState {
183
192
  blendSurfaces: state.blendSurfaces.length,
184
193
  profiles: state.profiles?.length ?? 0,
185
194
  profileEnds: state.profileEnds?.length ?? 0,
195
+ fairs: state.fairs?.length ?? 0,
186
196
  joins: state.joins.length,
187
197
  trims: state.trims.length,
188
198
  };
@@ -227,6 +237,7 @@ export namespace AutoMovieConstructionState {
227
237
  if (state.profiles !== undefined) state.profiles.length = s.profiles;
228
238
  if (state.profileEnds !== undefined)
229
239
  state.profileEnds.length = s.profileEnds;
240
+ if (state.fairs !== undefined) state.fairs.length = s.fairs;
230
241
  state.joins.length = s.joins;
231
242
  state.trims.length = s.trims;
232
243
  }
@@ -249,6 +260,8 @@ export namespace AutoMovieConstructionState {
249
260
  to: [n.to[0], n.to[1]],
250
261
  }),
251
262
  ),
263
+ // The exact curve is a pure function of the chart, shared rather than copied.
264
+ ...(c.along === undefined ? {} : { along: c.along }),
252
265
  };
253
266
  }
254
267
  }
@@ -85,9 +85,10 @@ export namespace AutoMovieLoftCapRead {
85
85
  throw new AutoMovieLoftAdmissionError(
86
86
  "A deformed pole has no retained collapsed cap value.",
87
87
  );
88
+ const [e, e1] = AutoMovieLoftRelief.direction(relief, phi);
88
89
  for (let k: number = 0; k < 3; k++) {
89
- p[k]! += h[0] * relief.axis[k]!;
90
- t[k]! += h[2] * relief.axis[k]!;
90
+ p[k]! += h[0] * e[k]!;
91
+ t[k]! += h[2] * e[k]! + h[0] * e1[k]!;
91
92
  }
92
93
  }
93
94
  if (![...p, ...t].every(Number.isFinite))
@@ -158,8 +158,41 @@ function binding(layer: IAutoMovieLoftChain.ILayer): string {
158
158
  ]);
159
159
  }
160
160
 
161
- /** Reject stale ownership before any actual geometry callback is evaluated. */
161
+ /** What a cap source was last checked against: the chain, its end layer and the pole's point, by identity and value. */
162
+ interface IChecked {
163
+ /** The chain the source was checked on. */
164
+ chain: Chain;
165
+
166
+ /** That chain's end layer at the time. */
167
+ layer: IAutoMovieLoftChain.ILayer;
168
+
169
+ /** The pole record it was checked with. */
170
+ pole: Pole;
171
+ }
172
+
173
+ /** The last passed check of each cap source, released with it. */
174
+ const CHECKED: WeakMap<AutoMovieLoftCapSource.ISource, IChecked> = new WeakMap();
175
+
176
+ /**
177
+ * Reject stale ownership before any actual geometry callback is evaluated.
178
+ *
179
+ * The full check serialises the end layer and the section data to compare them with the source's bindings. It ran for every station read
180
+ * outside the principal rows, a sixth of a capped body's realization. Chains, layers and sources are immutable while they are read, so a
181
+ * source that passed against the same chain, end layer and pole objects is not serialised again; any of them replaced is checked in full.
182
+ */
162
183
  function validate(chain: Chain, pole: Pole): void {
184
+ const source: AutoMovieLoftCapSource.ISource = pole.source!;
185
+ const end: IAutoMovieLoftChain.ILayer | undefined = chain.layers[pole.end === "bottom" ? 0 : chain.layers.length - 1];
186
+ if (source !== null && typeof source === "object") {
187
+ const passed: IChecked | undefined = CHECKED.get(source);
188
+ if (passed !== undefined && passed.chain === chain && passed.layer === end && passed.pole === pole) return;
189
+ }
190
+ check(chain, pole);
191
+ CHECKED.set(source, { chain, layer: end!, pole });
192
+ }
193
+
194
+ /** The full check of a cap source against its chain's end. */
195
+ function check(chain: Chain, pole: Pole): void {
163
196
  const source: AutoMovieLoftCapSource.ISource = pole.source!;
164
197
  if (
165
198
  source === null ||
@@ -130,17 +130,22 @@ export namespace AutoMovieLoftJet {
130
130
  // Hermite of its values, quintic where it carries curvatures, as in AutoMovieLoftChain.ring.
131
131
  if (station.lift !== undefined) lift(jet, station.lift, n, t);
132
132
 
133
- // Reliefs move points along their fixed axes.
133
+ // Reliefs move points along their axes: `P += h e`, with `e` fixed or
134
+ // turning with the phase alone, so `e_s = 0` and the product rule gives
135
+ // `h_t e + h e'` and `h_tt e + 2 h_t e' + h e''` in phase.
134
136
  for (const relief of chain.reliefs ?? []) {
135
137
  const h: number[] = AutoMovieLoftRelief.jet(relief, s, t);
136
138
  if (h.every((x: number): boolean => x === 0)) continue;
137
- const e: V = relief.axis;
139
+ const [e, e1, e2]: [V, V, V] = AutoMovieLoftRelief.direction(relief, t);
138
140
  jet.p = sum(jet.p, scale(e, h[0]!));
139
141
  jet.s = sum(jet.s, scale(e, h[1]!));
140
- jet.t = sum(jet.t, scale(e, h[2]!));
142
+ jet.t = sum(sum(jet.t, scale(e, h[2]!)), scale(e1, h[0]!));
141
143
  jet.ss = sum(jet.ss, scale(e, h[3]!));
142
- jet.st = sum(jet.st, scale(e, h[4]!));
143
- jet.tt = sum(jet.tt, scale(e, h[5]!));
144
+ jet.st = sum(sum(jet.st, scale(e, h[4]!)), scale(e1, h[1]!));
145
+ jet.tt = sum(
146
+ sum(sum(jet.tt, scale(e, h[5]!)), scale(e1, 2 * h[2]!)),
147
+ scale(e2, h[0]!),
148
+ );
144
149
  }
145
150
  if (
146
151
  !Object.values(jet).every((row: V): boolean => row.every(Number.isFinite))
@@ -77,7 +77,11 @@ export namespace AutoMovieLoftPoint {
77
77
  for (const relief of chain.reliefs ?? []) {
78
78
  const d: number = AutoMovieLoftRelief.height(relief, s, t)[0];
79
79
  if (d === 0) continue;
80
- for (let k: number = 0; k < 3; k++) q[k]! += d * relief.axis[k]!;
80
+ const e: [number, number, number] = AutoMovieLoftRelief.direction(
81
+ relief,
82
+ t,
83
+ )[0];
84
+ for (let k: number = 0; k < 3; k++) q[k]! += d * e[k]!;
81
85
  }
82
86
  if (source !== null && !q.every(Number.isFinite))
83
87
  throw new Error("The actual native point has no finite world value.");
@@ -179,9 +183,10 @@ export namespace AutoMovieLoftPoint {
179
183
  s,
180
184
  t,
181
185
  );
186
+ const [e, e1] = AutoMovieLoftRelief.direction(relief, t);
182
187
  for (let k: number = 0; k < 3; k++) {
183
- p[k]! += h[0] * relief.axis[k]!;
184
- dt[k]! += h[2] * relief.axis[k]!;
188
+ p[k]! += h[0] * e[k]!;
189
+ dt[k]! += h[2] * e[k]! + h[0] * e1[k]!;
185
190
  }
186
191
  }
187
192
  if (![...p, ...dt].every(Number.isFinite))
@@ -311,7 +316,11 @@ export namespace AutoMovieLoftPoint {
311
316
  for (const relief of chain.reliefs ?? []) {
312
317
  const d: number = AutoMovieLoftRelief.height(relief, s, t)[0];
313
318
  if (d === 0) continue;
314
- for (let k: number = 0; k < 3; k++) q[k]! += d * relief.axis[k]!;
319
+ const e: [number, number, number] = AutoMovieLoftRelief.direction(
320
+ relief,
321
+ t,
322
+ )[0];
323
+ for (let k: number = 0; k < 3; k++) q[k]! += d * e[k]!;
315
324
  }
316
325
  return q;
317
326
  };
@@ -153,6 +153,45 @@ export namespace AutoMovieLoftRelief {
153
153
  return out;
154
154
  }
155
155
 
156
+ /**
157
+ * The world direction the relief's height moves a base point along at a
158
+ * phase, with its first and second derivatives in phase.
159
+ *
160
+ * A fixed axis is its own direction with zero derivatives. With `turn`,
161
+ * the direction is `e(t) = cos(t - c) axis + sin(t - c) turn` about the
162
+ * window's middle phase `c`, so `e' = -sin(t - c) axis + cos(t - c) turn`
163
+ * and `e'' = -e`. It does not depend on the station.
164
+ *
165
+ * @param relief Relief whose direction is read.
166
+ * @param t Base phase, radians, any real value.
167
+ * @returns `[e, e_t, e_tt]`, each a world vector.
168
+ *
169
+ * @evidence contracts/development/implementation.md#principled-implementation The turning direction is a rotation in the plane of two fixed world vectors, so its phase derivatives are the rotation's own and its station derivatives vanish; a displaced point `p + h e` then differentiates by the product rule its callers apply.
170
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One reader serves the point, phase-tangent and second-order jet callers, with the fixed axis as the case of no turn.
171
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No difference of sampled directions; a fixed axis returns exact zeros.
172
+ * @evidence contracts/development/common.md#meaningful-documentation States the law, its centre and all three returned orders.
173
+ * @evidence contracts/development/implementation.md#efficient-algorithms One sine and one cosine per call, or none for a fixed axis.
174
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure direction reading coordinates no shared work.
175
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Returns fresh vectors and retains nothing.
176
+ */
177
+ export function direction(
178
+ relief: IAutoMovieLoftRelief,
179
+ t: number,
180
+ ): [V3, V3, V3] {
181
+ const a: V3 = relief.axis;
182
+ if (relief.turn === undefined) return [a, [0, 0, 0], [0, 0, 0]];
183
+ const b: V3 = relief.turn;
184
+ const x: number = t - (relief.phases[0] + width(relief) / 2);
185
+ const c: number = Math.cos(x);
186
+ const s: number = Math.sin(x);
187
+ const e: V3 = [c * a[0] + s * b[0], c * a[1] + s * b[1], c * a[2] + s * b[2]];
188
+ return [
189
+ e,
190
+ [c * b[0] - s * a[0], c * b[1] - s * a[1], c * b[2] - s * a[2]],
191
+ [-e[0], -e[1], -e[2]],
192
+ ];
193
+ }
194
+
156
195
  /**
157
196
  * Phase width of a finite window, radians, in `(0, 2 pi]`; equal endpoints mean one turn.
158
197
  *
@@ -170,6 +209,9 @@ export namespace AutoMovieLoftRelief {
170
209
  }
171
210
  }
172
211
 
212
+ /** A world vector. */
213
+ type V3 = [number, number, number];
214
+
173
215
  /** Phase reduced to `[0, 2 pi)`. */
174
216
  function wrap(t: number): number {
175
217
  const r: number = t % (2 * Math.PI);