@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
@@ -87,6 +87,7 @@ export namespace AutoMovieSolidMeshPlan {
87
87
  * @param indexed Whether the consumer drops explicit lifts into a global index buffer; then half-period ties are unavailable.
88
88
  * @param occupied Immutable prior global endpoint-pair keys `minID/maxID`; new interior bridges/ears cannot reuse them. Existing source boundaries retain their identities and final global incidence belongs to the caller.
89
89
  * @param scale Phase scale of the uniform metric the bridges are chosen and the free diagonals legalized in, positive and finite, length units per radian; 1 reads the chart as given.
90
+ * @param local A quadrilateral's own first fundamental form from its vertex IDs and chart points, `[shear, scale]`, which legalization reads in place of `scale` (`legalizeAutoMovieSolidMesh`); absent, the free diagonals are legalized in `scale` too.
90
91
  * @returns Positive native-chart index triples with split-source provenance, or a named construction failure.
91
92
  *
92
93
  * @evidence contracts/development/implementation.md#principled-implementation Subdivides shared constraints, uses explicit left probes and winding to identify hole/periodic boundary components, joins them visibly and validates the indexed ears against the residual source partition.
@@ -105,6 +106,7 @@ export namespace AutoMovieSolidMeshPlan {
105
106
  indexed: boolean = false,
106
107
  occupied?: ReadonlySet<string>,
107
108
  scale: number = 1,
109
+ local?: (ids: readonly number[], charts: readonly [number, number][]) => [number, number],
108
110
  ): IPlan | string {
109
111
  const split: AutoMovieSolidMeshConstraints.IEdge[] | string =
110
112
  AutoMovieSolidMeshConstraints.split(vertices, constraints, period);
@@ -204,6 +206,7 @@ export namespace AutoMovieSolidMeshPlan {
204
206
  indexed,
205
207
  occupied,
206
208
  scale,
209
+ local,
207
210
  );
208
211
  if (typeof legal === "string") return legal;
209
212
  for (const triangle of legal) {
@@ -311,48 +314,88 @@ function bridge(
311
314
  scale: number,
312
315
  ): Candidate | string {
313
316
  type Ranked = { candidate: Candidate; length: number };
314
- /** Visit every candidate with its squared metric length; a string stops the visit. */
315
- const each: (visit: (ranked: Ranked) => void) => string | null = (
316
- visit: (ranked: Ranked) => void,
317
+ /** Whether a pair already holds a prior global edge, which no bridge may reuse. */
318
+ const taken: (a: number, b: number) => boolean = (
319
+ a: number,
320
+ b: number,
321
+ ): boolean =>
322
+ occupied?.has(`${Math.min(a, b)}/${Math.max(a, b)}`) === true;
323
+ /**
324
+ * Visit every candidate of a pair that may hold a bridge, with its squared
325
+ * metric length; a string stops the visit. A taken pair is no candidate, but
326
+ * the visitor asks `taken` itself, and only of a candidate it would keep:
327
+ * the pairs are the product of two boundaries' vertices, and keying every
328
+ * one of them cost more than the search. A pair whose image cannot be
329
+ * represented is refused only when it is not taken, as before.
330
+ */
331
+ const each: (
332
+ visit: (a: number, b: number, turn: number, length: number) => void,
333
+ ) => string | null = (
334
+ visit: (a: number, b: number, turn: number, length: number) => void,
317
335
  ): string | null => {
318
- for (const a of boundaries[selected]!.walk.vertices)
336
+ const span: number = period ?? 0;
337
+ for (const a of boundaries[selected]!.walk.vertices) {
338
+ const first: Point = vertices.get(a)!;
319
339
  for (let j: number = 0; j < boundaries.length; j++) {
320
340
  if (j === selected) continue;
321
341
  for (const b of boundaries[j]!.walk.vertices) {
322
- if (
323
- a === b ||
324
- occupied?.has(`${Math.min(a, b)}/${Math.max(a, b)}`) === true
325
- )
326
- continue;
327
- const first: Point = vertices.get(a)!;
342
+ if (a === b) continue;
328
343
  const last: Point = vertices.get(b)!;
329
344
  const nearest: number =
330
345
  period === undefined
331
346
  ? 0
332
347
  : Math.round((first[1] - last[1]) / period);
333
- if (!Number.isSafeInteger(nearest))
348
+ if (!Number.isSafeInteger(nearest)) {
349
+ if (taken(a, b)) continue;
334
350
  return "visibility bridge cover image is not representable";
335
- const turns: number[] =
336
- period === undefined ? [0] : [nearest - 1, nearest, nearest + 1];
337
- for (const turn of turns) {
338
- const end: Point = [last[0], last[1] + turn * (period ?? 0)];
339
- if (!Number.isSafeInteger(turn) || !end.every(Number.isFinite))
340
- return "visibility bridge endpoint is not representable";
351
+ }
352
+ for (
353
+ let turn: number = period === undefined ? 0 : nearest - 1;
354
+ turn <= (period === undefined ? 0 : nearest + 1);
355
+ turn++
356
+ ) {
357
+ const phase: number = last[1] + turn * span;
341
358
  if (
342
- period !== undefined &&
343
- Math.abs(end[1] - first[1]) > period / 2
344
- )
359
+ !Number.isSafeInteger(turn) ||
360
+ !Number.isFinite(last[0]) ||
361
+ !Number.isFinite(phase)
362
+ ) {
363
+ if (taken(a, b)) break;
364
+ return "visibility bridge endpoint is not representable";
365
+ }
366
+ if (period !== undefined && Math.abs(phase - first[1]) > period / 2)
345
367
  continue;
346
368
  const length: number =
347
- (end[0] - first[0]) ** 2 + (scale * (end[1] - first[1])) ** 2;
348
- if (!Number.isFinite(length))
369
+ (last[0] - first[0]) ** 2 + (scale * (phase - first[1])) ** 2;
370
+ if (!Number.isFinite(length)) {
371
+ if (taken(a, b)) break;
349
372
  return "visibility bridge length is not representable";
350
- visit({ candidate: { a, b, turn }, length });
373
+ }
374
+ visit(a, b, turn, length);
351
375
  }
352
376
  }
353
377
  }
378
+ }
354
379
  return null;
355
380
  };
381
+ /** Whether a candidate comes strictly before a ranked one in the exact total order. */
382
+ const sooner: (
383
+ a: number,
384
+ b: number,
385
+ turn: number,
386
+ length: number,
387
+ than: Ranked,
388
+ ) => boolean = (
389
+ a: number,
390
+ b: number,
391
+ turn: number,
392
+ length: number,
393
+ than: Ranked,
394
+ ): boolean =>
395
+ (length - than.length ||
396
+ a - than.candidate.a ||
397
+ b - than.candidate.b ||
398
+ turn - than.candidate.turn) < 0;
356
399
  /** The exact total order: length, then IDs and turn. */
357
400
  const before: (x: Ranked, y: Ranked) => number = (
358
401
  x: Ranked,
@@ -404,11 +447,14 @@ function bridge(
404
447
 
405
448
  // Each selected vertex's own shortest candidate.
406
449
  const own: Map<number, Ranked> = new Map();
407
- const failed: string | null = each((ranked: Ranked): void => {
408
- const known: Ranked | undefined = own.get(ranked.candidate.a);
409
- if (known === undefined || before(ranked, known) < 0)
410
- own.set(ranked.candidate.a, ranked);
411
- });
450
+ const failed: string | null = each(
451
+ (a: number, b: number, turn: number, length: number): void => {
452
+ const known: Ranked | undefined = own.get(a);
453
+ if (known !== undefined && !sooner(a, b, turn, length, known)) return;
454
+ if (taken(a, b)) return;
455
+ own.set(a, { candidate: { a, b, turn }, length });
456
+ },
457
+ );
412
458
  if (failed !== null) return failed;
413
459
  const label: (c: Candidate) => string = (c: Candidate): string =>
414
460
  `${c.a}/${c.b}/${c.turn}`;
@@ -420,12 +466,11 @@ function bridge(
420
466
 
421
467
  // Every other candidate that could still be shorter than it.
422
468
  const shorter: Ranked[] = [];
423
- each((ranked: Ranked): void => {
424
- if (
425
- (found === null || before(ranked, found) < 0) &&
426
- !tested.has(label(ranked.candidate))
427
- )
428
- shorter.push(ranked);
469
+ each((a: number, b: number, turn: number, length: number): void => {
470
+ if (found !== null && !sooner(a, b, turn, length, found)) return;
471
+ if (taken(a, b)) return;
472
+ const candidate: Candidate = { a, b, turn };
473
+ if (!tested.has(label(candidate))) shorter.push({ candidate, length });
429
474
  });
430
475
  const better: Ranked | string | null = admit(shorter);
431
476
  if (typeof better === "string") return better;
@@ -126,6 +126,68 @@ export namespace AutoMovieSolidRail {
126
126
  hostWidth: number,
127
127
  mode: Mode = "station",
128
128
  ): IRail | null {
129
+ return explain(part, host, curve, keep, partWidth, hostWidth, mode).rail;
130
+ }
131
+
132
+ /**
133
+ * The rails at a curve point with the reading of every premise the solve checks: the quantities it computed, in the order computed, and,
134
+ * when it returns no rail, the premise that failed.
135
+ *
136
+ * @evidence contracts/development/design.md#principled-representation The rail and a nullable refusal partition success from the failed premise; quantities are the solve's own numbers keyed by what they measure.
137
+ * @evidence contracts/development/design.md#minimal-and-owned-surface One record reports what `at` already computes, so a join can name a refusal without a second solver.
138
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts It changes no solve, threshold or result: `at` returns exactly its rail.
139
+ * @evidence contracts/development/common.md#meaningful-documentation States the units of the recorded quantities: mm, chart units and dimensionless dot products.
140
+ */
141
+ export interface IExplanation {
142
+ /** The rails, or null. */
143
+ rail: IRail | null;
144
+
145
+ /** The failed premise, or null with a rail. */
146
+ refusal: string | null;
147
+
148
+ /** The quantities read on the way, by name. */
149
+ quantities: Record<string, number>;
150
+ }
151
+
152
+ /**
153
+ * The rails at a curve point, as `at`, with the quantities read and the failed premise named.
154
+ *
155
+ * @param part The attached part.
156
+ * @param host The host as an atlas.
157
+ * @param curve The curve point.
158
+ * @param keep Which side of the host the part keeps.
159
+ * @param partWidth Positive chord, mm, or a fixed `{ station }` in station mode.
160
+ * @param hostWidth Chord from the curve to the host's rail, mm.
161
+ * @param mode How the part's rail leaves the curve.
162
+ * @returns The explanation; `rail` is what `at` returns.
163
+ *
164
+ * @evidence contracts/development/common.md#meaningful-documentation States that it returns what `at` returns together with the quantities read and the premise a refusal failed, with each parameter's unit and meaning.
165
+ * @evidence contracts/development/implementation.md#principled-implementation The single rail solve, its every early return naming the checked premise it failed.
166
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure `at` reads this one evaluator, so a reported refusal is the solve's own and not a reconstruction.
167
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Records the quantities without changing any of them, and adds no tolerance.
168
+ * @evidence contracts/development/implementation.md#efficient-algorithms Adds a constant number of record writes to the solve.
169
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The same jets and directions feed the record and the rail.
170
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The record is call-local and returned; nothing is retained.
171
+ */
172
+ export function explain(
173
+ part: IAutoMovieSolidSurface,
174
+ host: IAutoMovieSolidAtlas,
175
+ curve: AutoMovieSolidIntersection.IPoint,
176
+ keep: Keep,
177
+ partWidth: number | { station: number },
178
+ hostWidth: number,
179
+ mode: Mode = "station",
180
+ ): IExplanation {
181
+ const quantities: Record<string, number> = {
182
+ face: curve.face,
183
+ s: curve.s,
184
+ phi: curve.phi,
185
+ y: curve.y,
186
+ theta: curve.theta,
187
+ hostWidth,
188
+ ...(typeof partWidth === "number" ? { partWidth } : { partStation: partWidth.station }),
189
+ };
190
+ const refuse = (premise: string): IExplanation => ({ rail: null, refusal: premise, quantities });
129
191
  const a: IJet | null = AutoMovieSolidDomain.jet(part, curve.s, curve.phi);
130
192
  const surface: IAutoMovieSolidSurface = host.faces[curve.face]!;
131
193
  const b: IJet | null = AutoMovieSolidDomain.jet(
@@ -133,10 +195,13 @@ export namespace AutoMovieSolidRail {
133
195
  curve.y,
134
196
  curve.theta,
135
197
  );
136
- if (a === null || b === null) return null;
198
+ if (a === null) return refuse("the part has no jet at the curve point");
199
+ if (b === null) return refuse("the host face has no jet at the curve point");
137
200
  const outA: Vec3 | null = unit(cross(a.u, a.v));
138
201
  const outB: Vec3 | null = unit(cross(b.u, b.v));
139
- if (outA === null || outB === null) return null;
202
+ if (outA === null) return refuse("the part's normal vanishes at the curve point");
203
+ if (outB === null) return refuse("the host's normal vanishes at the curve point");
204
+ quantities.normals = dot(outA, outB);
140
205
  const nA: Vec3 = [
141
206
  outA[0] * part.orientation,
142
207
  outA[1] * part.orientation,
@@ -155,8 +220,11 @@ export namespace AutoMovieSolidRail {
155
220
  let sigma: number;
156
221
  if (mode === "station") {
157
222
  const facing: number = dot(a.u, nB);
158
- if (!(Math.abs(facing) > 0)) return null;
223
+ quantities.facing = facing;
224
+ quantities.stationSpeed = norm(a.u);
225
+ if (!(Math.abs(facing) > 0)) return refuse("the part's station line is parallel to the host (facing 0)");
159
226
  const side: number = facing > 0 === (keep === "outside") ? 1 : -1;
227
+ quantities.side = side;
160
228
  sigma = side;
161
229
  partAcross = [side / norm(a.u), 0];
162
230
  if (typeof partWidth === "number") {
@@ -167,21 +235,26 @@ export namespace AutoMovieSolidRail {
167
235
  curve.point,
168
236
  partWidth,
169
237
  );
170
- if (lambda === null) return null;
238
+ if (lambda === null) return refuse("the part's chord along its station line found no solution");
239
+ quantities.lambda = lambda;
171
240
  s = curve.s + side * lambda;
172
241
  } else {
173
- if (!(side * (partWidth.station - curve.s) > 0)) return null;
242
+ if (!(side * (partWidth.station - curve.s) > 0)) return refuse(`the part's rail station ${partWidth.station} does not lie on its kept side (side ${side}) of the curve point's station ${curve.s}`);
174
243
  s = partWidth.station;
175
244
  }
176
245
  } else {
177
- if (typeof partWidth !== "number") return null;
246
+ if (typeof partWidth !== "number") return refuse("a fixed part station needs the station mode");
178
247
  const e: [number, number] | null = square(
179
248
  a,
180
249
  [curve.rate[0], curve.rate[1]],
181
250
  nB,
182
251
  keep === "outside" ? 1 : -1,
252
+ quantities,
253
+ "part",
183
254
  );
184
- if (e === null) return null;
255
+ if (e === null) return refuse("the part's square direction failed (metric solve, vanishing speed or no side toward the host's normal)");
256
+ quantities.partSquareS = e[0];
257
+ quantities.partSquarePhi = e[1];
185
258
  partAcross = e;
186
259
  sigma = e[0] >= 0 ? 1 : -1;
187
260
  const lambda: number | null = offset(
@@ -195,7 +268,8 @@ export namespace AutoMovieSolidRail {
195
268
  curve.point,
196
269
  partWidth,
197
270
  );
198
- if (lambda === null) return null;
271
+ if (lambda === null) return refuse("the part's chord along its square direction found no solution");
272
+ quantities.lambda = lambda;
199
273
  const refined: [number, number] | null = section(
200
274
  part,
201
275
  [curve.s + lambda * e[0], curve.phi + lambda * e[1]],
@@ -203,20 +277,30 @@ export namespace AutoMovieSolidRail {
203
277
  plane(a, e),
204
278
  partWidth,
205
279
  );
206
- if (refined === null) return null;
280
+ if (refined === null) return refuse("the part's normal-section refinement did not converge");
207
281
  s = refined[0];
208
282
  phi = refined[1];
209
283
  }
284
+ quantities.partS = s;
285
+ quantities.partPhi = phi;
210
286
 
211
287
  // The host's direction square to the preimage, turned toward the
212
288
  // outside of the part.
289
+ quantities.hostRateY = curve.rate[2];
290
+ quantities.hostRateTheta = curve.rate[3];
291
+ quantities.hostToward = dot(cross(b.u, b.v), nA) / (norm(cross(b.u, b.v)) || 1);
213
292
  const across: [number, number] | null = square(
214
293
  b,
215
294
  [curve.rate[2], curve.rate[3]],
216
295
  nA,
217
296
  1,
297
+ quantities,
298
+ "host",
218
299
  );
219
- if (across === null) return null;
300
+ if (across === null) return refuse("the host's square direction failed (metric solve, vanishing speed or no side toward the part's normal)");
301
+ quantities.acrossY = across[0];
302
+ quantities.acrossTheta = across[1];
303
+ const report: { reason: string; numbers: Record<string, number> } = { reason: "", numbers: {} };
220
304
  // The initial chart displacement selects a local branch; every equation
221
305
  // is subsequently read on its actual retained face, including neighbours.
222
306
  const settled: ReturnType<typeof AutoMovieSolidRailSolve.atlas> =
@@ -234,29 +318,41 @@ export namespace AutoMovieSolidRail {
234
318
  STEPS,
235
319
  ROUNDING,
236
320
  SWITCHES,
321
+ report,
237
322
  );
238
- if (settled === null) return null;
323
+ for (const [key, value] of Object.entries(report.numbers)) quantities["atlas." + key] = value;
324
+ if (settled === null) {
325
+ return refuse("the host's normal-section solve across the atlas: " + report.reason);
326
+ }
239
327
  const face: number = settled.face;
240
328
  const hostChart: [number, number] = settled.chart;
241
329
  const direction: [number, number] = settled.direction;
330
+ quantities.hostFace = face;
331
+ quantities.hostY = hostChart[0];
332
+ quantities.hostTheta = hostChart[1];
242
333
  const partJet: IJet | null = AutoMovieSolidDomain.jet(part, s, phi);
243
334
  const hostJet: IJet | null = AutoMovieSolidDomain.jet(
244
335
  host.faces[face]!,
245
336
  hostChart[0],
246
337
  hostChart[1],
247
338
  );
248
- if (partJet === null || hostJet === null) return null;
339
+ if (partJet === null) return refuse("the part has no jet at its rail");
340
+ if (hostJet === null) return refuse("the host face has no jet at its rail");
249
341
  return {
250
- curve,
251
- s,
252
- phi,
253
- sigma,
254
- partAcross,
255
- partPoint: partJet.p,
256
- hostFace: face,
257
- host: hostChart,
258
- across: direction,
259
- hostPoint: hostJet.p,
342
+ rail: {
343
+ curve,
344
+ s,
345
+ phi,
346
+ sigma,
347
+ partAcross,
348
+ partPoint: partJet.p,
349
+ hostFace: face,
350
+ host: hostChart,
351
+ across: direction,
352
+ hostPoint: hostJet.p,
353
+ },
354
+ refusal: null,
355
+ quantities,
260
356
  };
261
357
  }
262
358
 
@@ -294,6 +390,8 @@ export namespace AutoMovieSolidRail {
294
390
  tangent: readonly [number, number],
295
391
  toward: Readonly<Vec3>,
296
392
  side: number,
393
+ note?: Record<string, number>,
394
+ key: string = "",
297
395
  ): [number, number] | null {
298
396
  const E: number = dot(j.u, j.u);
299
397
  const F: number = dot(j.u, j.v);
@@ -314,6 +412,10 @@ export namespace AutoMovieSolidRail {
314
412
  ]),
315
413
  toward,
316
414
  );
415
+ if (note !== undefined) {
416
+ note[key + "Out"] = out / speed;
417
+ note[key + "Speed"] = speed;
418
+ }
317
419
  if (!(Math.abs(out) > 0)) return null;
318
420
  const turn: number = ((out > 0 ? 1 : -1) * side) / speed;
319
421
  return [e[0] * turn, e[1] * turn];
@@ -44,13 +44,14 @@ export namespace AutoMovieSolidRailSolve {
44
44
  * @param steps Newton iteration bound.
45
45
  * @param rounding Original relative plane/chord residual allowance.
46
46
  * @param switches Maximum accepted chart transitions.
47
+ * @param report Filled, when given, with why a null was returned and the face, chart, residuals and remaining switches at that moment.
47
48
  * @returns One actually retained solution, or null on numerical/open-boundary failure.
48
49
  *
49
50
  * @evidence contracts/development/implementation.md#principled-implementation Solves the same plane and squared-chord equations on each actual face; a declared neighbour foot initializes another chart and must satisfy the actual equations before publication.
50
- * @evidence contracts/development/implementation.md#clear-and-simple-structure Face, chart and admitted jet move together through bounded Newton trials; final kept-region membership is separate from original chart ownership.
51
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Face, chart and admitted jet move together through bounded Newton trials; a Newton step stays in its face's kept chart and changes face only by a recorded crossing, never straight back to the face the last crossing left.
51
52
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No exterior surface, coordinate clamp, invented seam or tolerance change is used. Open adjacency, singular solves and exhausted budgets return null; original callback errors propagate.
52
53
  * @evidence contracts/development/common.md#meaningful-documentation Distinguishes an approximate starting chart from a solved retained rail, world-mm residuals from chart coordinates, and local convergence from global branch certification.
53
- * @evidence contracts/development/implementation.md#efficient-algorithms At most steps iterations each use up to twenty backtracking trials and at most switches accepted face changes; atlas and surface callback costs remain part of this bound.
54
+ * @evidence contracts/development/implementation.md#efficient-algorithms At most steps iterations each use up to twenty backtracking trials, a trial past the kept boundary at most 52 bisections of its step share and, when it crosses, one Newton step of up to twenty halvings on the neighbour, and at most switches accepted face changes; atlas and surface callback costs remain part of this bound.
54
55
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Each admitted trial jet supplies both plane/chord residuals and the next accepted Jacobian; no scalar full-chord solve is repeated in each face.
55
56
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources All trial records and borrowed atlas references are call-local; the small returned chart/direction arrays belong to the caller, with no new cache.
56
57
  */
@@ -65,14 +66,59 @@ export namespace AutoMovieSolidRailSolve {
65
66
  steps: number,
66
67
  rounding: number,
67
68
  switches: number,
69
+ report?: { reason: string; numbers: Record<string, number> },
68
70
  ): AtlasSection | null {
69
- if (!(width > 0) || !(norm(m) > 0)) return null;
71
+ const visited: number[] = [face];
72
+ const fail = (reason: string, numbers: Record<string, number> = {}): null => {
73
+ if (report !== undefined) {
74
+ report.reason = reason;
75
+ report.numbers = { ...numbers, ...Object.fromEntries(visited.map((f: number, k: number): [string, number] => ["visit" + k, f])) };
76
+ }
77
+ return null;
78
+ };
79
+ if (!(width > 0) || !(norm(m) > 0)) return fail("no positive chord or no section plane");
70
80
  let left: number = switches;
71
81
  let current: ReturnType<typeof AutoMovieSolidTraceTrial> =
72
82
  AutoMovieSolidTraceTrial(host, face, start[0], start[1], left > 0);
73
- if (current === null) return null;
83
+ if (current === null) return fail("the start chart lies on no face", { face, startU: start[0], startV: start[1] });
74
84
  if (current.crossed) left--;
85
+ // The face the last crossing left: a step is not taken straight back across that seam.
86
+ let came: number | null = current.crossed ? face : null;
75
87
  const scale: number = width + norm(from);
88
+
89
+ /** The plane-and-chord residual of an admitted trial, mm. */
90
+ const residual = (trial: { jet: IJet }): number => {
91
+ const q: Vec3 = sub(trial.jet.p, from);
92
+ return Math.hypot(dot(q, m), (dot(q, q) - width * width) / (2 * width));
93
+ };
94
+
95
+ /** The foot itself, or one Newton step on its face from it, halved within that face's region (kept when the foot is kept), whose residual is below bound; null when none is. */
96
+ const onward = (
97
+ foot: NonNullable<ReturnType<typeof AutoMovieSolidTraceTrial>>,
98
+ bound: number,
99
+ ): ReturnType<typeof AutoMovieSolidTraceTrial> => {
100
+ if (residual(foot) < bound) return foot;
101
+ const j: IJet = foot.jet;
102
+ const r: Vec3 = sub(j.p, from);
103
+ const dx: [number, number] | null = AutoMovieSolidVector.solve2(
104
+ dot(j.u, m),
105
+ dot(j.v, m),
106
+ 2 * dot(r, j.u),
107
+ 2 * dot(r, j.v),
108
+ [-dot(r, m), -(dot(r, r) - width * width)],
109
+ );
110
+ if (dx === null) return null;
111
+ const surface: IAutoMovieSolidSurface = host.faces[foot.face]!;
112
+ const held: boolean = host.kept(foot.face, foot.u, foot.v);
113
+ let k: number = 1;
114
+ for (let trial: number = 0; trial < 20; trial++, k /= 2) {
115
+ const [u1, v1]: [number, number] = [foot.u + k * dx[0], foot.v + k * dx[1]];
116
+ if (!AutoMovieSolidDomain.contains(surface, u1, v1) || (held && !host.kept(foot.face, u1, v1))) continue;
117
+ const next: ReturnType<typeof AutoMovieSolidTraceTrial> = AutoMovieSolidTraceTrial(host, foot.face, u1, v1, false);
118
+ if (next !== null && residual(next) < bound) return next;
119
+ }
120
+ return null;
121
+ };
76
122
  for (let step: number = 0; step < steps; step++) {
77
123
  const j: IJet = current.jet;
78
124
  const r: Vec3 = sub(j.p, from);
@@ -81,24 +127,30 @@ export namespace AutoMovieSolidRailSolve {
81
127
  const done: boolean =
82
128
  Math.abs(f1) <= rounding * scale &&
83
129
  Math.abs(f2) <= 2 * width * rounding * scale;
130
+ if (visited.at(-1) !== current.face) visited.push(current.face);
131
+ const here: Record<string, number> = { step, face: current.face, u: current.u, v: current.v, planeResidual: f1, chordResidual: f2, switchesLeft: left };
84
132
  if (done) {
85
133
  if (host.kept(current.face, current.u, current.v)) {
86
134
  const d: [number, number] | null = project(j, direction);
135
+ if (d !== null && report !== undefined) {
136
+ report.reason = "solved";
137
+ report.numbers = { ...here, ...Object.fromEntries(visited.map((f: number, k: number): [string, number] => ["visit" + k, f])) };
138
+ }
87
139
  return d === null
88
- ? null
140
+ ? fail("the outward direction does not project onto the solved face", here)
89
141
  : {
90
142
  face: current.face,
91
143
  chart: [current.u, current.v],
92
144
  direction: d,
93
145
  };
94
146
  }
95
- if (left === 0) return null;
147
+ if (left === 0) return fail("solved on a trimmed-away part of a face with no chart switch left", here);
96
148
  const next: ReturnType<IAutoMovieSolidAtlas["across"]> = host.across(
97
149
  current.face,
98
150
  current.u,
99
151
  current.v,
100
152
  );
101
- if (next === null) return null;
153
+ if (next === null) return fail("solved on a trimmed-away part of a face with no neighbour across", here);
102
154
  current = AutoMovieSolidTraceTrial(
103
155
  host,
104
156
  next.face,
@@ -106,7 +158,8 @@ export namespace AutoMovieSolidRailSolve {
106
158
  next.v,
107
159
  false,
108
160
  );
109
- if (current === null) return null;
161
+ if (current === null) return fail("the neighbour's foot lies on no face", { ...here, nextFace: next.face, nextU: next.u, nextV: next.v });
162
+ came = here.face!;
110
163
  left--;
111
164
  continue;
112
165
  }
@@ -117,34 +170,72 @@ export namespace AutoMovieSolidRailSolve {
117
170
  2 * dot(r, j.v),
118
171
  [-f1, -f2],
119
172
  );
120
- if (dx === null) return null;
173
+ if (dx === null) return fail("the plane-and-chord Jacobian is singular", here);
121
174
  const merit: number = Math.hypot(f1, f2 / (2 * width));
175
+ const lower = (trial: { jet: IJet }): boolean => residual(trial) < merit;
176
+ // The region a step stays in: the face's kept chart when the iterate is kept, else its owned chart. A first-order start or a mapped
177
+ // foot can stand on a trimmed-away part of its face (the operator body test's beam starts on the column's trimmed part), and from
178
+ // there no step is kept; it moves in the chart as before and leaves by the solved-but-not-kept crossing.
179
+ const face0: number = current.face;
180
+ const held: boolean = host.kept(face0, current.u, current.v);
181
+ const inside = (u: number, v: number): boolean => AutoMovieSolidDomain.contains(host.faces[face0]!, u, v) && (!held || host.kept(face0, u, v));
122
182
  let accepted: boolean = false;
123
183
  let k: number = 1;
124
184
  for (let trial: number = 0; trial < 20; trial++, k /= 2) {
125
- const next: ReturnType<typeof AutoMovieSolidTraceTrial> =
126
- AutoMovieSolidTraceTrial(
127
- host,
128
- current.face,
129
- current.u + k * dx[0],
130
- current.v + k * dx[1],
131
- left > 0,
132
- );
185
+ const [u1, v1]: [number, number] = [current.u + k * dx[0], current.v + k * dx[1]];
186
+ if (!inside(u1, v1)) {
187
+ // A projected Newton step: the step is first clipped at the face's kept boundary (bisected on the step's share), so an iterate near a
188
+ // seam stays on its face; it crosses only when the clipped point does not lower the residual, a switch is left, and the face
189
+ // across is not the one it just left. At a tangent seam each face's linearization overshoots onto the other, and crossing on
190
+ // every overshoot alternated between the two faces until the switches ran out.
191
+ let [lo, hi]: [number, number] = [0, k];
192
+ for (let b: number = 0; b < 52 && inside(current.u + hi * dx[0], current.v + hi * dx[1]) === false && hi - lo > 1e-15 * k; b++) {
193
+ const mid: number = (lo + hi) / 2;
194
+ if (inside(current.u + mid * dx[0], current.v + mid * dx[1])) lo = mid;
195
+ else hi = mid;
196
+ }
197
+ if (lo > 0) {
198
+ const clipped: ReturnType<typeof AutoMovieSolidTraceTrial> = AutoMovieSolidTraceTrial(host, face0, current.u + lo * dx[0], current.v + lo * dx[1], false);
199
+ if (clipped !== null && lower(clipped)) {
200
+ current = clipped;
201
+ accepted = true;
202
+ break;
203
+ }
204
+ }
205
+ if (left === 0) continue;
206
+ // Past the domain the trial crosses at its foot; inside the domain but past the kept region (a trimmed part of the chart) the
207
+ // neighbour across that trim is read explicitly, since the chart itself still evaluates there.
208
+ const beyond: ReturnType<IAutoMovieSolidAtlas["across"]> = AutoMovieSolidDomain.contains(host.faces[face0]!, u1, v1) ? host.across(face0, u1, v1) : null;
209
+ const reached: ReturnType<typeof AutoMovieSolidTraceTrial> = beyond === null ? null : AutoMovieSolidTraceTrial(host, beyond.face, beyond.u, beyond.v, false);
210
+ const crossed: ReturnType<typeof AutoMovieSolidTraceTrial> = reached !== null ? { ...reached, crossed: true } : AutoMovieSolidTraceTrial(host, face0, u1, v1, true);
211
+ if (crossed !== null && !crossed.crossed) continue;
212
+ if (crossed === null || crossed.face === came) continue;
213
+ // The crossing is judged by where the solve goes on the neighbour, not by its foot: the foot is mapped by the boundary's chord
214
+ // share, a different world point from the iterate's (on f1's arm past its armpit band it stood 0.0035 to 0.0113 mm off the
215
+ // section plane, so every foot's residual exceeded the band end's and the crossing was refused though the arm kept a root).
216
+ // It is taken when one Newton step on the neighbour from the foot, backtracked within the neighbour's region, lowers the
217
+ // residual below this iterate's.
218
+ const settled: ReturnType<typeof AutoMovieSolidTraceTrial> = onward(crossed, merit);
219
+ if (settled !== null) {
220
+ left--;
221
+ came = face0;
222
+ current = settled;
223
+ accepted = true;
224
+ break;
225
+ }
226
+ continue;
227
+ }
228
+ const next: ReturnType<typeof AutoMovieSolidTraceTrial> = AutoMovieSolidTraceTrial(host, face0, u1, v1, false);
133
229
  if (next === null) continue;
134
- const q: Vec3 = sub(next.jet.p, from);
135
- if (
136
- Math.hypot(dot(q, m), (dot(q, q) - width * width) / (2 * width)) <
137
- merit
138
- ) {
139
- if (next.crossed) left--;
230
+ if (lower(next)) {
140
231
  current = next;
141
232
  accepted = true;
142
233
  break;
143
234
  }
144
235
  }
145
- if (!accepted) return null;
236
+ if (!accepted) return fail("no Newton trial lowered the residual in twenty halvings", here);
146
237
  }
147
- return null;
238
+ return fail("the Newton iterations ran out", { steps });
148
239
  }
149
240
 
150
241
  /** Unit-world-speed projection of the original kept-side direction. */
@@ -559,6 +559,15 @@ export namespace AutoMovieViewLoft {
559
559
  // them (`{ ...chain, reliefs }`), so the surface and every reader of the
560
560
  // chain, a realized construction face included, carry them.
561
561
  if (part.reliefs !== undefined) chain = { ...chain, reliefs: part.reliefs };
562
+ // Declared ring phases ride on it the same way; a list that is not `samples` phases strictly increasing within one turn is refused.
563
+ if (part.phases !== undefined) {
564
+ const phases: number[] = part.phases;
565
+ if (!(phases.length === part.samples && phases.every((p: number, k: number): boolean => Number.isFinite(p) && (k === 0 || p > phases[k - 1]!)) && phases[phases.length - 1]! - phases[0]! < 2 * Math.PI)) {
566
+ report("ring phases", "the declared ring phases are not `samples` finite phases strictly increasing within one turn");
567
+ return { ...empty(), sections, chains };
568
+ }
569
+ chain = { ...chain, phases: [...phases] };
570
+ }
562
571
  const surface: IAutoMovieSolidSurface | null =
563
572
  AutoMovieSolidChain.surface(chain);
564
573
  if (surface === null)