@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
@@ -11,7 +11,8 @@
11
11
  * or below it. Membership is read in the chart: the crossing number of the
12
12
  * cycle's polygon for a hole (its phases moved by whole periods to the
13
13
  * cycle's own), and ray-crossing parity for a winding cycle even when that
14
- * cycle turns back in phase. The separate station reader returns only its
14
+ * cycle turns back in phase; a winding cycle sampled from an exact curve
15
+ * crosses each phase line on that curve between the vertices it samples. The separate station reader returns only its
15
16
  * first crossing and is not a general inverse of that predicate.
16
17
  *
17
18
  * @evidence contracts/development/common.md#meaningful-documentation States the four kinds and which side each keeps.
@@ -25,7 +26,7 @@ export namespace AutoMovieSolidCycle {
25
26
  * neighbour mapping per closing polygon segment.
26
27
  *
27
28
  * @evidence contracts/development/design.md#principled-representation Parallel vertex/chart/segment arrays represent a face's boundary and its shared neighbour correspondence without deriving geometry from a rendered mesh.
28
- * @evidence contracts/development/design.md#minimal-and-owned-surface Four fields separate kept-side kind, shared mesh identity, this chart and the adjacent chart's endpoint maps.
29
+ * @evidence contracts/development/design.md#minimal-and-owned-surface Four fields separate kept-side kind, shared mesh identity, this chart and the adjacent chart's endpoint maps; the optional fifth carries the exact curve a winding cycle samples, absent where its chords are its boundary.
29
30
  * @evidence contracts/development/design.md#prohibited-design-shortcuts The type does not validate array lengths, winding, simplicity or inclusive boundary classification; prepared readers require unchanged kind/chart data during their lifetime.
30
31
  * @evidence contracts/development/common.md#meaningful-documentation States coindexing, closing-segment ownership, chart phase unwrapping and which face keeps each side.
31
32
  */
@@ -41,6 +42,21 @@ export namespace AutoMovieSolidCycle {
41
42
 
42
43
  /** Per segment `k` (vertex `k` to `k + 1`, the last closing the cycle): the neighbour face across it. */
43
44
  neighbours: INeighbour[];
45
+
46
+ /**
47
+ * For a winding cycle sampled from an exact curve `u = along(v)` of this chart: the curve's station at a phase. A segment whose two
48
+ * stored vertices both lie on it (`along(v) === u` at each, as the builder evaluated them) is read along the curve between them, not
49
+ * as the chord through them; a vertex inserted later off the curve leaves its segments read as chords. Absent, every segment is a chord.
50
+ *
51
+ * @evidence contracts/development/common.md#meaningful-documentation States which chart the curve is in, which segments read it, and what an inserted off-curve vertex or an absent curve leaves as chords.
52
+ * @evidence contracts/development/implementation.md#principled-implementation The kept edge is the exact curve the neighbouring band ends on (a port's curved rail), so the two faces share one edge instead of a chord standing off it by its sagitta.
53
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One optional reader on the cycle; kept tests read it only on segments whose both stored vertices lie on it, and every other reader keeps the chords.
54
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Adds no tolerance or widened boundary: a segment off the curve is read exactly as before.
55
+ * @evidence contracts/development/implementation.md#efficient-algorithms One evaluation per kept test on a qualifying segment, in place of the chord's interpolation.
56
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work The builder passes the same rail function that placed the cycle's vertices and the band's column ends.
57
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The cycle holds the builder's function for its own lifetime; copies share it and retain nothing else.
58
+ */
59
+ along?: (v: number) => number;
44
60
  }
45
61
 
46
62
  /**
@@ -95,14 +111,14 @@ export namespace AutoMovieSolidCycle {
95
111
  *
96
112
  * @evidence contracts/development/implementation.md#principled-implementation Uses crossing parity in the existing chart branches for all four cycle kinds.
97
113
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Delegates to the same predicate as the prepared reader, without retained state.
98
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Keeps every original inequality and half-period tie; no curve or boundary is moved.
114
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Keeps every original inequality and half-period tie; a winding segment on its cycle's exact curve (`ICycle.along`) reads that curve's station instead of the chord's, and no other boundary is moved.
99
115
  * @evidence contracts/development/common.md#meaningful-documentation The inclusive 'on cycle' wording has an existing strict-parity boundary gap, recorded separately; preparation does not claim to fix it.
100
116
  * @evidence contracts/development/implementation.md#efficient-algorithms Scans S edges, plus the hole/island centre scan, in O(S) time.
101
117
  * @evidence contracts/development/implementation.md#reuse-equivalent-work This live reading caches nothing; prepare is the face-local repeated-query path.
102
118
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Returns a boolean and retains no input or scratch after the call.
103
119
  */
104
120
  export function kept(
105
- cycle: Pick<ICycle, "kind" | "chart">,
121
+ cycle: Pick<ICycle, "kind" | "chart" | "along">,
106
122
  u: number,
107
123
  v: number,
108
124
  period: number | undefined,
@@ -124,12 +140,13 @@ export namespace AutoMovieSolidCycle {
124
140
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The returned closure owns O(S) endpoint scratch, with no global cache; dropping the reader releases those references.
125
141
  */
126
142
  export function prepare(
127
- cycle: Pick<ICycle, "kind" | "chart">,
143
+ cycle: Pick<ICycle, "kind" | "chart" | "along">,
128
144
  period: number | undefined,
129
145
  ): (u: number, v: number) => boolean {
146
+ const curve: ((v: number) => number) | undefined = cycle.along;
130
147
  const prepared: IPrepared =
131
148
  cycle.kind === "hole" || cycle.kind === "island"
132
- ? { centreV: centre(cycle)[1] }
149
+ ? { span: span(cycle) }
133
150
  : {
134
151
  ends: cycle.chart.map(
135
152
  (a: [number, number], k: number): [number, number, number] => {
@@ -138,6 +155,13 @@ export namespace AutoMovieSolidCycle {
138
155
  return windingEnd(a, raw, period ?? 2 * Math.PI);
139
156
  },
140
157
  ),
158
+ ...(curve === undefined
159
+ ? {}
160
+ : {
161
+ on: cycle.chart.map((a: [number, number], k: number): boolean =>
162
+ on(curve, a, cycle.chart[(k + 1) % cycle.chart.length]!),
163
+ ),
164
+ }),
141
165
  };
142
166
  return (u: number, v: number): boolean =>
143
167
  read(cycle, u, v, period, prepared);
@@ -145,12 +169,22 @@ export namespace AutoMovieSolidCycle {
145
169
 
146
170
  /** Cycle-invariant values; coordinates and kind are owned unchanged by the caller. */
147
171
  interface IPrepared {
148
- /** Mean v for hole/island parity, including NaN on an empty chart. */ centreV?: number;
172
+ /** Lowest and highest unwrapped v of a hole or an island (`span`). */ span?: [number, number];
149
173
  /** Original winding endpoint and its integer turn relative to the segment start. */ ends?: [
150
174
  number,
151
175
  number,
152
176
  number,
153
177
  ][];
178
+ /** Per winding segment, whether both its vertices lie on the cycle's exact curve (`ICycle.along`). */ on?: boolean[];
179
+ }
180
+
181
+ /** Whether a segment's two stored vertices lie on the exact curve, as its builder evaluated them. */
182
+ function on(
183
+ curve: (v: number) => number,
184
+ a: readonly [number, number],
185
+ b: readonly [number, number],
186
+ ): boolean {
187
+ return curve(a[1]) === a[0] && curve(b[1]) === b[0];
154
188
  }
155
189
 
156
190
  /** Preserve the original raw endpoint's x/y-before-start-phase access and exception order. */
@@ -164,9 +198,48 @@ export namespace AutoMovieSolidCycle {
164
198
  return [u, v, Math.round((a[1] - v) / period)];
165
199
  }
166
200
 
201
+ /**
202
+ * The lowest and highest phase of a hole or an island along its own unwrapped chart; `[Infinity, -Infinity]` on an empty chart.
203
+ *
204
+ * A hole or an island does not wind round the period, so on the face it bounds one disc, and that disc's images in the unwrapped chart, one
205
+ * per whole period, do not overlap: a point of the face lies inside the cycle when one of its own images lies inside the cycle's polygon.
206
+ * Only an image within the span can. A cycle narrower than half a period on either side of its middle has one such image, the one nearest
207
+ * the middle; a band cut through from rim to rim leaves an island almost a whole period wide, and a cut whose two runs across the band stand
208
+ * apart in phase leaves one wider than a period, where a point near either end has two images within the span and only one of them lies
209
+ * inside (f1's ear: an island 6.6 rad wide about 5.6, a triangle at 8.9 read at its image 2.6 and found outside).
210
+ */
211
+ function span(cycle: Pick<ICycle, "chart">): [number, number] {
212
+ let low: number = Infinity;
213
+ let high: number = -Infinity;
214
+ // Each point's coordinates are read once, `u` then `v`, as `centre` reads them.
215
+ for (const p of cycle.chart) {
216
+ void p[0];
217
+ const v: number = p[1];
218
+ low = Math.min(low, v);
219
+ high = Math.max(high, v);
220
+ }
221
+ return [low, high];
222
+ }
223
+
224
+ /** Crossing parity of the ray from `(u, w)` toward lower `u` against a hole's or an island's polygon, `w` already on the polygon's branch. */
225
+ function crossed(cycle: Pick<ICycle, "chart">, u: number, w: number): boolean {
226
+ const n: number = cycle.chart.length;
227
+ let inside: boolean = false;
228
+ for (let k: number = 0; k < n; k++) {
229
+ const a: [number, number] = cycle.chart[k]!;
230
+ const b: [number, number] = cycle.chart[(k + 1) % n]!;
231
+ if (
232
+ a[1] > w !== b[1] > w &&
233
+ u < a[0] + ((w - a[1]) * (b[0] - a[0])) / (b[1] - a[1])
234
+ )
235
+ inside = !inside;
236
+ }
237
+ return inside;
238
+ }
239
+
167
240
  /** The original parity and tie arithmetic, with optional invariant values. */
168
241
  function read(
169
- cycle: Pick<ICycle, "kind" | "chart">,
242
+ cycle: Pick<ICycle, "kind" | "chart" | "along">,
170
243
  u: number,
171
244
  v: number,
172
245
  period: number | undefined,
@@ -174,21 +247,20 @@ export namespace AutoMovieSolidCycle {
174
247
  ): boolean {
175
248
  const n: number = cycle.chart.length;
176
249
  if (cycle.kind === "hole" || cycle.kind === "island") {
177
- const w: number = shift(
178
- v,
179
- prepared === undefined ? centre(cycle)[1] : prepared.centreV!,
180
- period,
181
- );
182
- let inside: boolean = false;
183
- for (let k: number = 0; k < n; k++) {
184
- const a: [number, number] = cycle.chart[k]!;
185
- const b: [number, number] = cycle.chart[(k + 1) % n]!;
186
- if (
187
- a[1] > w !== b[1] > w &&
188
- u < a[0] + ((w - a[1]) * (b[0] - a[0])) / (b[1] - a[1])
250
+ // The image nearest the span's middle first, then any other image of the point within the span (`span`).
251
+ const [low, high]: [number, number] =
252
+ prepared === undefined ? span(cycle) : prepared.span!;
253
+ const w: number = shift(v, (low + high) / 2, period);
254
+ let inside: boolean = crossed(cycle, u, w);
255
+ if (period !== undefined && period > 0)
256
+ for (
257
+ let k: number = 1;
258
+ !inside && (w - k * period >= low || w + k * period <= high);
259
+ k++
189
260
  )
190
- inside = !inside;
191
- }
261
+ inside =
262
+ (w - k * period >= low && crossed(cycle, u, w - k * period)) ||
263
+ (w + k * period <= high && crossed(cycle, u, w + k * period));
192
264
  return cycle.kind === "island" ? inside : !inside;
193
265
  }
194
266
 
@@ -221,11 +293,17 @@ export namespace AutoMovieSolidCycle {
221
293
  const av: number = a[1] + translation;
222
294
  if (av > w === bv > w) continue;
223
295
 
224
- // The source start coordinates keep the original reached getter sequence.
296
+ // The crossing's station: on the exact curve when the segment samples it, since a face beside this one may end on that curve
297
+ // itself (a port's band ends on the part's curved rail), and the chord between two vertices then stands off it by its sagitta,
298
+ // a strip that belonged to neither face (0.03 mm on f1's arm under its armpit band). Otherwise the chord, the source start
299
+ // coordinates keeping the original reached getter sequence.
300
+ const curve: ((v: number) => number) | undefined = cycle.along;
225
301
  const x: number =
226
- a[0] +
227
- ((w - (a[1] + translation)) * (b[0] - a[0])) /
228
- (bv - (a[1] + translation));
302
+ curve !== undefined && (prepared?.on?.[k] ?? on(curve, a, raw))
303
+ ? curve(w - translation)
304
+ : a[0] +
305
+ ((w - (a[1] + translation)) * (b[0] - a[0])) /
306
+ (bv - (a[1] + translation));
229
307
  if (cycle.kind === "start" ? x <= u : x >= u) count++;
230
308
  }
231
309
  return count % 2 === 1;
@@ -211,53 +211,70 @@ export namespace AutoMovieSolidIntersectionWalk {
211
211
  // The first walk: the loop's length.
212
212
 
213
213
  /** Original phase-sized initial chord, reduced only by existing failed halvings. */
214
- let h: number = (norm(a0.v) * 2 * Math.PI) / count;
215
-
216
- /** Current accepted point of the first length walk. */
217
- let p: IPoint = start;
218
-
219
- /** Current consistently directed tangent. */
220
- let T: Vec3 = T0;
221
-
222
- /** Previous first-walk iterate used by the existing predictor. */
223
- let previous: IPoint | null = null;
224
-
225
- /** Accumulated world chords of the first walk, mm. */
226
- let length: number = 0;
227
-
228
- /** Whether the original ahead-within-one-step test closed the walk. */
229
- let closed: boolean = false;
230
- for (let k: number = 0; k < walkSteps * count; k++) {
231
- /** Displacement from the current point back toward its start. */
232
- const ahead: Vec3 = sub(start.point, p.point);
233
- if (k > 2 && norm(ahead) <= h && dot(ahead, T) > 0) {
234
- length += norm(ahead);
235
- closed = true;
236
- break;
237
- }
238
-
239
- /** Candidate retained through the original failed-halving loop. */
240
- let next: IPoint | null = null;
241
- for (
242
- let halving: number = 0;
243
- halving < AutoMovieSolidTraceSolve.HALVINGS && next === null;
244
- halving++
245
- ) {
246
- next = step(p, T, h, previous);
247
- if (next === null) h /= 2;
214
+ const stride: number = (norm(a0.v) * 2 * Math.PI) / count;
215
+
216
+ /**
217
+ * The first walk round the loop from the seed, along `T0` times `sense`: the loop's length, or why it failed. A closed loop is the same
218
+ * curve walked either way, and a point where the two surfaces nearly touch can be passed from one side when it loses the walk from the
219
+ * other: an ear's mirrored hollow lost its walk at the point its twin passes, the twin walking it the other way round.
220
+ */
221
+ const around: (sense: 1 | -1) => number | string = (sense: 1 | -1): number | string => {
222
+ let h: number = stride;
223
+
224
+ /** Current accepted point of the first length walk. */
225
+ let p: IPoint = start;
226
+
227
+ /** Current consistently directed tangent. */
228
+ let T: Vec3 = scale(T0, sense);
229
+
230
+ /** Previous first-walk iterate used by the existing predictor. */
231
+ let previous: IPoint | null = null;
232
+
233
+ /** Accumulated world chords of the first walk, mm. */
234
+ let length: number = 0;
235
+ for (let k: number = 0; k < walkSteps * count; k++) {
236
+ /** Displacement from the current point back toward its start. */
237
+ const ahead: Vec3 = sub(start.point, p.point);
238
+ if (k > 2 && norm(ahead) <= h && dot(ahead, T) > 0) return length + norm(ahead);
239
+
240
+ /** Candidate retained through the original failed-halving loop. */
241
+ let next: IPoint | null = null;
242
+ for (
243
+ let halving: number = 0;
244
+ halving < AutoMovieSolidTraceSolve.HALVINGS && next === null;
245
+ halving++
246
+ ) {
247
+ next = step(p, T, h, previous);
248
+ if (next === null) h /= 2;
249
+ }
250
+ if (next === null)
251
+ return `lost after ${length} mm of the walk, at [${p.point.map((x: number): string => x.toFixed(1)).join(", ")}] mm on host face ${p.face}`;
252
+ length += norm(sub(next.point, p.point));
253
+ previous = p;
254
+ p = next;
255
+
256
+ // A step that was halved to pass a tight turn grows back once it is
257
+ // past: kept halved, the walk ran out of steps before it came round.
258
+ h = Math.min(stride, 2 * h);
259
+
260
+ /** Continue the first walk with the same tangent orientation. */
261
+ const t: Vec3 | null = tangent(p, T);
262
+ if (t === null) return `the surfaces touch ${length} mm along the walk`;
263
+ T = t;
248
264
  }
249
- if (next === null) return `lost after ${length} mm of the walk`;
250
- length += norm(sub(next.point, p.point));
251
- previous = p;
252
- p = next;
253
-
254
- /** Continue the first walk with the same tangent orientation. */
255
- const t: Vec3 | null = tangent(p, T);
256
- if (t === null) return `the surfaces touch ${length} mm along the walk`;
257
- T = t;
258
- }
259
- if (!closed)
260
265
  return `the walk does not return to its start in ${walkSteps * count} steps`;
266
+ };
267
+
268
+ /** The way round the loop the walks go: along `T0`, or against it where the walk along it was lost and the other way round closes. */
269
+ let sense: 1 | -1 = 1;
270
+ const forth: number | string = around(1);
271
+ let length: number;
272
+ if (typeof forth === "string") {
273
+ const back: number | string = around(-1);
274
+ if (typeof back === "string") return forth;
275
+ sense = -1;
276
+ length = back;
277
+ } else length = forth;
261
278
 
262
279
  // The second walk: equal chords whose last, closing the loop, matches the
263
280
  // others. The first walk's length sums uneven steps, so `length / n`
@@ -277,16 +294,47 @@ export namespace AutoMovieSolidIntersectionWalk {
277
294
  /** Current point of the equal-chord walk. */
278
295
  let q: IPoint = start;
279
296
 
280
- /** Original consistently oriented equal-walk tangent. */
281
- let along: Vec3 = T0;
297
+ /** Original consistently oriented equal-walk tangent, the way round the first walk went. */
298
+ let along: Vec3 = scale(T0, sense);
282
299
 
283
300
  /** Previous equal-walk iterate used by the same predictor. */
284
301
  let before: IPoint | null = null;
285
302
  for (let k: number = 1; k < n; k++) {
286
303
  /** Next accepted point of this fixed-chord reference walk. */
287
- const next: IPoint | null = step(q, along, chord, before);
304
+ let next: IPoint | null = step(q, along, chord, before);
305
+
306
+ // Where the curve turns within less than a chord, the tangent
307
+ // prediction a whole chord ahead is refused. The chord is then walked
308
+ // in halved steps along the curve, as the first walk goes, and the
309
+ // point its length ahead stands in for the one a straight chord ahead.
310
+ if (next === null) {
311
+ let from: IPoint = q;
312
+ let heading: Vec3 = along;
313
+ let last: IPoint | null = before;
314
+ let left: number = chord;
315
+ let h: number = chord / 2;
316
+ for (
317
+ let halving: number = 0;
318
+ left > 1e-9 * chord && halving < AutoMovieSolidTraceSolve.HALVINGS;
319
+
320
+ ) {
321
+ const part: IPoint | null = step(from, heading, Math.min(h, left), last);
322
+ if (part === null) {
323
+ h /= 2;
324
+ halving++;
325
+ continue;
326
+ }
327
+ left -= norm(sub(part.point, from.point));
328
+ last = from;
329
+ from = part;
330
+ const turned: Vec3 | null = tangent(from, heading);
331
+ if (turned === null) break;
332
+ heading = turned;
333
+ }
334
+ if (left <= 1e-9 * chord) next = from;
335
+ }
288
336
  if (next === null)
289
- return `the equal-chord walk is lost at step ${k} of ${n}`;
337
+ return `the equal-chord walk is lost at step ${k} of ${n}, at [${q.point.map((x: number): string => x.toFixed(1)).join(", ")}] mm on host face ${q.face}`;
290
338
  points.push(next.point);
291
339
  before = q;
292
340
  q = next;
@@ -330,8 +378,10 @@ export namespace AutoMovieSolidIntersectionWalk {
330
378
  const c2: number = g1 === g0 ? c1 : c1 - (g1 * (c1 - c0)) / (g1 - g0);
331
379
  [c0, p0, g0, c1] = [c1, p1, g1, c2];
332
380
  }
381
+ // Walked against `T0`, the points are read back in its order from the seed, so the parameter still increases along `n_part x n_host`.
382
+ const ordered: Vec3[] = sense === 1 ? p0 : [p0[0]!, ...p0.slice(1).reverse()];
333
383
  return {
334
- law: AutoMovieSolidTraceLaw.arc(p0),
384
+ law: AutoMovieSolidTraceLaw.arc(ordered),
335
385
  x: [start.s, start.phi, start.y, start.theta],
336
386
  face: start.face,
337
387
  };
@@ -76,6 +76,20 @@ export namespace AutoMovieSolidJoin {
76
76
  */
77
77
  rail(t: number): AutoMovieSolidRail.IRail | null;
78
78
 
79
+ /**
80
+ * Solve the rails at radian parameter t again, reporting the quantities read and the failed premise (`AutoMovieSolidRail.explain`);
81
+ * null when the curve has no point at t.
82
+ *
83
+ * @evidence contracts/development/implementation.md#principled-implementation The same curve point, widths and mode as `rail`, through the same solve.
84
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure A diagnostic reader beside `rail`; it caches nothing.
85
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts It changes no rail: `rail` and the join's checks read their own cache.
86
+ * @evidence contracts/development/common.md#meaningful-documentation States the parameter's units and the null case.
87
+ * @evidence contracts/development/implementation.md#efficient-algorithms One curve correction and one rail solve per call.
88
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses the join's curve and width laws.
89
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing past the call.
90
+ */
91
+ explain(t: number): AutoMovieSolidRail.IExplanation | null;
92
+
79
93
  /**
80
94
  * Read host-first and part-last boundary ribbons at radian parameter t; null means no rail.
81
95
  *
@@ -285,6 +299,38 @@ export namespace AutoMovieSolidJoin {
285
299
  return solved;
286
300
  };
287
301
 
302
+ /** The same solve as `rail`, explained. */
303
+ const explain: IJoin["explain"] = (
304
+ t: number,
305
+ ): AutoMovieSolidRail.IExplanation | null => {
306
+ const p: AutoMovieSolidIntersection.IPoint | null = curve.at(t);
307
+ return p === null
308
+ ? null
309
+ : AutoMovieSolidRail.explain(
310
+ input.part,
311
+ host,
312
+ p,
313
+ keep,
314
+ typeof input.width.part === "function"
315
+ ? input.width.part(t)
316
+ : input.width.part,
317
+ input.width.host(t),
318
+ mode,
319
+ );
320
+ };
321
+
322
+ /** Why the column at t is missing: the rail's failed premise and its quantities, or the ribbons when the rail solved. */
323
+ const missing = (t: number): string => {
324
+ const read: AutoMovieSolidRail.IExplanation | null = explain(t);
325
+ if (read === null) return "the curve has no point there";
326
+ const numbers: string = Object.entries(read.quantities)
327
+ .map(([key, value]: [string, number]): string => `${key} ${Number(value.toPrecision(6))}`)
328
+ .join(", ");
329
+ return read.refusal === null
330
+ ? `the rails solved but their ribbons did not (${numbers})`
331
+ : `${read.refusal} (${numbers})`;
332
+ };
333
+
288
334
  /** Rebuild both surface ribbons at the cached rail; columns themselves are not cached. */
289
335
  const column: IJoin["column"] = (t: number): IColumn | null => {
290
336
  const r: AutoMovieSolidRail.IRail | null = rail(t);
@@ -313,7 +359,7 @@ export namespace AutoMovieSolidJoin {
313
359
  if (c === null)
314
360
  return fail(
315
361
  "rails",
316
- `no rail at t ${p.t} (host width ${input.width.host(p.t)} mm)`,
362
+ `no rail at t ${p.t} (host width ${input.width.host(p.t)} mm): ${missing(p.t)}`,
317
363
  );
318
364
  const outside: string | null =
319
365
  AutoMovieSolidIntersection.beyond(input.part, c.rail.s) ??
@@ -378,7 +424,7 @@ export namespace AutoMovieSolidJoin {
378
424
  part: typeof input.width.part === "function" ? input.width.part(t) : null,
379
425
  });
380
426
  return {
381
- join: { curve, keep, continuity: "G2", rail, column, loop, widths },
427
+ join: { curve, keep, continuity: "G2", rail, explain, column, loop, widths },
382
428
  diagnostics,
383
429
  };
384
430
  }
@@ -121,7 +121,7 @@ export namespace AutoMovieSolidMeshConstraints {
121
121
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One result union exposes a complete partition or the first explicit failure, without mutating caller data.
122
122
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Distinct coincident IDs and proper crossings without an original vertex are refused rather than silently merged or reconstructed. The one-period primitive premise limits cover-image work.
123
123
  * @evidence contracts/development/common.md#meaningful-documentation States lift range, source indices, immutability, failure and absence of world geometry construction.
124
- * @evidence contracts/development/implementation.md#efficient-algorithms O(EV log V plus S squared) work for E segments, V points and S unique pieces, with at most three periodic point/edge images per local comparison.
124
+ * @evidence contracts/development/implementation.md#efficient-algorithms One sort of V points, then each of E segments reads only the points inside its own range of the first coordinate, and of the S squared pairs of unique pieces only those whose ranges of it overlap are compared, with at most three periodic point/edge images per comparison.
125
125
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Reuses each source vertex value and one indexed piece record for all of its inducing segments; no callback effects are shared.
126
126
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Local maps and cut arrays expire with the call; output source incidence storage can grow to O(EV), with no retained global state.
127
127
  */
@@ -143,6 +143,22 @@ export namespace AutoMovieSolidMeshConstraints {
143
143
  )
144
144
  return `constraint vertex ${id} needs an original nonnegative ID and finite chart coordinates`;
145
145
  }
146
+ // The vertices by first coordinate: a vertex lies on a segment only inside
147
+ // the segment's own range of it, which no lift changes, so each segment
148
+ // reads that slice instead of every vertex.
149
+ const sorted: [number, Point][] = [...vertices].sort(
150
+ (x: [number, Point], y: [number, Point]): number => x[1][0] - y[1][0],
151
+ );
152
+ const from: (value: number) => number = (value: number): number => {
153
+ let low: number = 0;
154
+ let high: number = sorted.length;
155
+ while (low < high) {
156
+ const middle: number = (low + high) >> 1;
157
+ if (sorted[middle]![1][0] < value) low = middle + 1;
158
+ else high = middle;
159
+ }
160
+ return low;
161
+ };
146
162
  const pieces: Map<string, IEdge> = new Map();
147
163
  for (let source: number = 0; source < segments.length; source++) {
148
164
  const segment: ISegment = segments[source]!;
@@ -176,8 +192,13 @@ export namespace AutoMovieSolidMeshConstraints {
176
192
  { id: segment.a, turn: 0, point: a },
177
193
  { id: segment.b, turn: segment.turn, point: b },
178
194
  ];
179
- for (const entry of vertices) {
180
- const [id, point]: [number, Point] = entry;
195
+ const highest: number = Math.max(a[0], b[0]);
196
+ for (
197
+ let k: number = from(Math.min(a[0], b[0]));
198
+ k < sorted.length && sorted[k]![1][0] <= highest;
199
+ k++
200
+ ) {
201
+ const [id, point]: [number, Point] = sorted[k]!;
181
202
  const shifts: number[] | null = images(point[1], a[1], b[1], period);
182
203
  if (shifts === null)
183
204
  return `constraint ${source} has an unrepresentable cover image`;
@@ -229,8 +250,19 @@ export namespace AutoMovieSolidMeshConstraints {
229
250
  }
230
251
  }
231
252
  const edges: IEdge[] = [...pieces.values()];
253
+
254
+ // Two pieces whose ranges of the first coordinate are apart cannot cross.
255
+ const range: [number, number][] = edges.map(
256
+ (edge: IEdge): [number, number] => {
257
+ const p: number = vertices.get(edge.a)![0];
258
+ const q: number = vertices.get(edge.b)![0];
259
+ return [Math.min(p, q), Math.max(p, q)];
260
+ },
261
+ );
232
262
  for (let i: number = 0; i < edges.length; i++)
233
263
  for (let j: number = i + 1; j < edges.length; j++) {
264
+ if (range[i]![1] < range[j]![0] || range[j]![1] < range[i]![0])
265
+ continue;
234
266
  const edge: IEdge = edges[i]!;
235
267
  const other: IEdge = edges[j]!;
236
268
  const a: Point = vertices.get(edge.a)!;
@@ -58,10 +58,10 @@ export namespace AutoMovieSolidMeshLoop {
58
58
  * non-transparent reads or effectful descriptor traps are outside this premise.
59
59
  *
60
60
  * @evidence contracts/development/implementation.md#principled-implementation Uses the same parity, metric projection and margin comparisons as keeps; copied chart values change no geometry.
61
- * @evidence contracts/development/implementation.md#clear-and-simple-structure One face-local closure owns lazy loop preparation; no global cache or spatial index is introduced.
62
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Preserves loop order, eager fallback, both distinct periodic rules, full metric scan, sqrt and equality; no tolerance or curve is changed.
63
- * @evidence contracts/development/common.md#meaningful-documentation States numerical snapshot ownership, accessor fallback and the supported descriptor premise.
64
- * @evidence contracts/development/implementation.md#efficient-algorithms Preparation and queries are O(S+L) for S total edges and L loops; invariant shifts/tuples and repeated point metrics are reused.
61
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One face-local closure owns lazy loop preparation and each loop's chart box; no global cache is introduced.
62
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Preserves loop order, eager fallback, both distinct periodic rules, sqrt and equality; the metric scan of a loop is skipped only where a lower bound of the same metric to the loop's chart box strictly exceeds the margin, so the answer is the full scan's and no tolerance or curve is changed.
63
+ * @evidence contracts/development/common.md#meaningful-documentation States numerical snapshot ownership, accessor fallback, the supported descriptor premise and the bound that skips a far loop.
64
+ * @evidence contracts/development/implementation.md#efficient-algorithms Preparation is O(S+L) for S total edges and L loops; a query reads the kept side of each loop and scans only the loops whose box lies within the margin, so a face of many small holes costs each grid point its few near ones.
65
65
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Each new face owns new preparation after edits or rollback; eligible input and jet values stay unchanged while read.
66
66
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Captures O(S+L) scratch for L loops until the returned reader is dropped; the face retains it only through its synchronous call.
67
67
  */
@@ -137,14 +137,59 @@ export namespace AutoMovieSolidMeshLoop {
137
137
  if (state.deltas === undefined) {
138
138
  const chart: [number, number][] = state.chart!.chart;
139
139
  state.deltas = new Float64Array(2 * chart.length);
140
+ let low: number = Infinity;
141
+ let high: number = -Infinity;
142
+ let phase: number = chart[0]?.[1] ?? 0;
143
+ let first: number = phase;
144
+ let last: number = phase;
140
145
  for (let k: number = 0; k < chart.length; k++) {
141
146
  const a: [number, number] = chart[k]!;
142
147
  const b: [number, number] = chart[(k + 1) % chart.length]!;
143
148
  state.deltas[2 * k] = b[0] - a[0];
144
149
  state.deltas[2 * k + 1] =
145
150
  AutoMovieSolidCycle.shift(b[1], a[1], period) - a[1];
151
+ low = Math.min(low, a[0]);
152
+ high = Math.max(high, a[0]);
153
+ first = Math.min(first, phase);
154
+ last = Math.max(last, phase);
155
+ phase += state.deltas[2 * k + 1]!;
146
156
  }
157
+ // The loop's phases unwrapped along its own walk: a box in phase
158
+ // exists only when they stay inside half a period, so every
159
+ // point's nearest lift is the one the segments read.
160
+ const narrow: boolean =
161
+ Number.isFinite(first) &&
162
+ Number.isFinite(last) &&
163
+ (period === undefined || last - first < period / 2);
164
+ state.box = [
165
+ low,
166
+ high,
167
+ narrow ? (first + last) / 2 : NaN,
168
+ narrow ? (last - first) / 2 : NaN,
169
+ ];
147
170
  }
171
+
172
+ // A point farther from the loop's chart box than the margin, by a
173
+ // lower bound of the metric, is farther from every segment: with
174
+ // `c = F / sqrt(E G)`, `E du^2 + 2 F du dv + G dv^2 >=
175
+ // (1 - |c|) (E du^2 + G dv^2)`, and any offset to the loop has
176
+ // `|du|`, `|dv|` at least the gaps to the box. The scan is skipped
177
+ // only on a strict excess, so a tie still reads every segment.
178
+ const box: [number, number, number, number] = state.box!;
179
+ const gapU: number = Math.max(0, box[0] - u, u - box[1]);
180
+ const gapV: number = Number.isNaN(box[2])
181
+ ? 0
182
+ : Math.max(
183
+ 0,
184
+ Math.abs(AutoMovieSolidCycle.shift(v, box[2], period) - box[2]) -
185
+ box[3],
186
+ );
187
+ const shear: number = E > 0 && G > 0 ? Math.abs(F) / Math.sqrt(E * G) : 1;
188
+ if (
189
+ (1 - shear) * (E * gapU * gapU + G * gapV * gapV) >
190
+ margin * margin * (1 + 1e-9)
191
+ )
192
+ continue;
148
193
  if (
149
194
  !(
150
195
  distance(state.chart!, u, v, E, F, G, period, state.deltas) >=
@@ -176,6 +221,12 @@ export namespace AutoMovieSolidMeshLoop {
176
221
  v: number,
177
222
  ) => boolean;
178
223
  /** Metric segment differences, dx/dy per edge. */ deltas?: Float64Array;
224
+ /** The copied chart's box: lowest and highest station, then the middle and half width of its unwrapped phases, NaN when they span half a period or more. */ box?: [
225
+ number,
226
+ number,
227
+ number,
228
+ number,
229
+ ];
179
230
  }
180
231
 
181
232
  /** Copy only own data-valued numerical fields, without invoking ordinary getters. */