@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
@@ -1,4 +1,4 @@
1
- import type { IAutoMovieConstructionSplit } from "@automovie/interface";
1
+ import type { IAutoMovieConstructionPort, IAutoMovieConstructionSplit } from "@automovie/interface";
2
2
 
3
3
  import type { AutoMovieConstructionSplitSeam } from "./AutoMovieConstructionSplitSeam";
4
4
  import { AutoMovieSolidBlendChain } from "./AutoMovieSolidBlendChain";
@@ -45,6 +45,38 @@ export namespace AutoMovieConstructionSplitBand {
45
45
 
46
46
  /** The station's sign leaving the rail: out of the host into the band, or from the child's rail into the child's kept side. */
47
47
  into: 1 | -1;
48
+
49
+ /**
50
+ * The rail's station at a phase when the rail is a curve round the face (a port's `rails`), mm; absent, `station` at every phase.
51
+ *
52
+ * @evidence contracts/development/common.md#meaningful-documentation States the argument, the unit and the absent case.
53
+ * @evidenceExclude contracts/development/implementation.md#principled-implementation A declared callback slot; the caller's curve is the implementation.
54
+ * @evidenceExclude contracts/development/implementation.md#clear-and-simple-structure A declared callback slot has no body.
55
+ * @evidenceExclude contracts/development/implementation.md#prohibited-implementation-shortcuts A declared callback slot has no body.
56
+ * @evidenceExclude contracts/development/implementation.md#efficient-algorithms A declared callback slot has no body; its cost is the caller's curve.
57
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A declared callback slot coordinates no work.
58
+ * @evidenceExclude contracts/development/implementation.md#bound-retention-and-release-resources A declared callback slot retains nothing.
59
+ */
60
+ along?: (psi: number) => number;
61
+ }
62
+
63
+ /**
64
+ * The rail's station on a side at a phase: its curve's when it has one, else its one station.
65
+ *
66
+ * @param side The side.
67
+ * @param psi The side's phase, radians.
68
+ * @returns The station, mm.
69
+ *
70
+ * @evidence contracts/development/implementation.md#principled-implementation Reads the side's own rail curve, or its one station, so every reader of the child's rail takes the same station at a phase.
71
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One conditional.
72
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The curve is the caller's; nothing is clamped.
73
+ * @evidence contracts/development/common.md#meaningful-documentation States both cases and the units.
74
+ * @evidence contracts/development/implementation.md#efficient-algorithms Constant time beyond the curve's own reading.
75
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure reader coordinates no work.
76
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Retains nothing.
77
+ */
78
+ export function railAt(side: ISide, psi: number): number {
79
+ return side.along === undefined ? side.station : side.along(psi);
48
80
  }
49
81
 
50
82
  /**
@@ -79,6 +111,9 @@ export namespace AutoMovieConstructionSplitBand {
79
111
 
80
112
  /** The curved seam both bands share and the ribbons' turn at each fork, radians of clock (`IAutoMovieConstructionSplit.IProfile`), or absent for the straight chord. */
81
113
  seam?: { curve: AutoMovieConstructionSplitSeam.ISeam; corner: number };
114
+
115
+ /** How the child's rail is matched to the loop (`IAutoMovieConstructionSplit.IChild.correspondence`); absent, by angle. */
116
+ correspondence?: "angle" | "length";
82
117
  }
83
118
 
84
119
  /**
@@ -371,10 +406,181 @@ export namespace AutoMovieConstructionSplitBand {
371
406
  outward,
372
407
  input.child,
373
408
  input.crease,
409
+ input.correspondence ?? "angle",
374
410
  );
375
411
  return typeof made === "string" ? made : { ...made, hostPhases };
376
412
  }
377
413
 
414
+ /**
415
+ * One stretch of a band's loop in a split into more than two: a host arc, or a seam read from one of its forks to the other.
416
+ *
417
+ * @evidence contracts/development/design.md#principled-representation An arc is two host phases and a seam a built curve and the direction the loop reads it in; together they are every stretch a loop is made of.
418
+ * @evidence contracts/development/design.md#minimal-and-owned-surface A discriminated pair and its column count.
419
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Values only; the realization decides the stretches and their columns.
420
+ * @evidence contracts/development/common.md#meaningful-documentation States each field's unit and direction.
421
+ */
422
+ export type IStretch =
423
+ | { kind: "arc"; from: number; to: number; columns: number }
424
+ | { kind: "seam"; curve: AutoMovieConstructionSplitSeam.ISeam; forward: boolean; columns: number };
425
+
426
+ /**
427
+ * What one band of a split into more than two is built from.
428
+ *
429
+ * @evidence contracts/development/design.md#principled-representation The loop's stretches, the host's and the child's sides and the corner turn determine the loop and both ribbons, as one arc and one seam do for a two-way split.
430
+ * @evidence contracts/development/design.md#minimal-and-owned-surface The split's per-band slice of its declaration, in kernel units.
431
+ * @evidence contracts/development/design.md#prohibited-design-shortcuts Values only; admission belongs to the realization.
432
+ * @evidence contracts/development/common.md#meaningful-documentation States each field's role and unit.
433
+ */
434
+ export interface IFanInput {
435
+ /** The band's chain name. */
436
+ name: string;
437
+
438
+ /** The host side: its surface, its end station, `into` leaving the host. */
439
+ host: ISide;
440
+
441
+ /** The child side: its surface, its rail station, `into` into its kept side. */
442
+ child: ISide;
443
+
444
+ /** The loop's stretches in clock order, the first an arc and arcs and seams alternating; their columns sum to the band's. */
445
+ stretches: IStretch[];
446
+
447
+ /** The ribbons' turn at each fork, radians of clock. */
448
+ corner: number;
449
+
450
+ /** The declared crease window, or absent. */
451
+ crease?: IAutoMovieConstructionSplit.ICrease;
452
+
453
+ /** How the child's rail is matched to the loop (IAutoMovieConstructionSplit.IChild.correspondence); absent, by angle. */
454
+ correspondence?: "angle" | "length";
455
+
456
+ /** The share of its length a ribbon keeps at a fork (`IAutoMovieConstructionSplit.IProfile.reach`), in `(0, 1]`; absent, 1. */
457
+ reach?: number;
458
+
459
+ /** Whether the bands leave the host's arc square to its end ring (`IAutoMovieConstructionSplit.IProfile.square`); absent, along its station line. */
460
+ square?: boolean;
461
+ }
462
+
463
+ /**
464
+ * Build one band of a split into more than two, or the reason it cannot be built.
465
+ *
466
+ * The loop runs through its stretches in order: on an arc its columns stand at equal steps of host phase from the arc's first phase, on a
467
+ * seam at equal arclength shares from the fork it is read from, and a seam's first column is the fork that ends the arc before it. The
468
+ * ribbons are a two-way band's (`create`): on an arc the host's own 2-jet, on a seam the seam plane's normal toward the band's own loop,
469
+ * and within `corner` of clock of each fork both turn by the quintic smoothstep to the inward diagonal there, the arc's toward the
470
+ * adjacent seam's ruling inside the host's tangent plane and the seam's toward its direction away from the fork. With `square` an arc's
471
+ * ribbon is the host's 2-jet along the chart line square to the end ring instead of along the station line. Two bands that read one
472
+ * seam from its two ends therefore meet G1 across it.
473
+ *
474
+ * @param input The band's sides, stretches, corner and crease.
475
+ * @returns The band with each column's host phase (NaN on a seam's inner columns), or the refusal.
476
+ *
477
+ * @evidence contracts/development/implementation.md#principled-implementation The two-way band's ribbons applied stretch by stretch, so every seam is ruled and every fork turned alike, and the shared strip builder (`strip`) does the rest.
478
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure Columns, ribbons, then the shared strip.
479
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Refuses a loop that does not start on an arc, a column count that does not add up, a degenerate tangent plane and a seam whose plane holds the direction toward the band.
480
+ * @evidence contracts/development/common.md#meaningful-documentation States the loop, the ribbons, the corner and the refusals.
481
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in columns apart from the strip's correspondence.
482
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Each column's host jet serves its point and its ribbon.
483
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Temporary columns are released; the result is caller-owned.
484
+ */
485
+ export function fan(input: IFanInput, count: number): (IStrip & { phases: number[] }) | string {
486
+ const stretches: IStretch[] = input.stretches;
487
+ if (stretches[0]?.kind !== "arc") return "the loop does not start on an arc";
488
+ if (stretches.reduce((sum: number, s: IStretch): number => sum + s.columns, 0) !== count) return "the stretches' columns do not add up to the band's";
489
+ const n: number = count;
490
+ const step: number = (2 * Math.PI) / n;
491
+
492
+ // Each column: its stretch and its index in it; a stretch's first column is a fork.
493
+ const owner: number[] = [];
494
+ const within: number[] = [];
495
+ stretches.forEach((s: IStretch, i: number): void => {
496
+ for (let j: number = 0; j < s.columns; ++j) {
497
+ owner.push(i);
498
+ within.push(j);
499
+ }
500
+ });
501
+ const previous = (i: number): IStretch => stretches[(i - 1 + stretches.length) % stretches.length]!;
502
+
503
+ // A seam's first column is the fork ending the arc before it: read as that arc's last phase.
504
+ const phases: number[] = owner.map((i: number, k: number): number => {
505
+ const s: IStretch = stretches[i]!;
506
+ if (s.kind === "arc") return s.from + ((s.to - s.from) * within[k]!) / s.columns;
507
+ const before: IStretch = previous(i);
508
+ return within[k] === 0 && before.kind === "arc" ? before.to : NaN;
509
+ });
510
+ const jets: (IAutoMovieSolidSurface.IJet | null)[] = phases.map((phi: number): IAutoMovieSolidSurface.IJet | null => (Number.isNaN(phi) ? null : input.host.surface.jet(input.host.station, phi)));
511
+ const share = (s: Extract<IStretch, { kind: "seam" }>, j: number): number => (s.forward ? j / s.columns : 1 - j / s.columns);
512
+ const loop: Vec3[] = owner.map((i: number, k: number): Vec3 => {
513
+ const jet: IAutoMovieSolidSurface.IJet | null = jets[k]!;
514
+ if (jet !== null) return [jet.p[0]!, jet.p[1]!, jet.p[2]!];
515
+ const s: IStretch = stretches[i]!;
516
+ return s.kind === "seam" ? s.curve.at(share(s, within[k]!)).point : [NaN, NaN, NaN];
517
+ });
518
+ const centroid: Vec3 = scale(loop.reduce((sum: Vec3, p: Vec3): Vec3 => add(sum, p), [0, 0, 0]), 1 / n);
519
+
520
+ // Each seam's ruling: its plane's normal toward this band's loop.
521
+ const ruling: (Vec3 | null)[] = stretches.map((s: IStretch): Vec3 | null => {
522
+ if (s.kind !== "seam") return null;
523
+ const middle: Vec3 = scale(add(s.curve.ends[0], s.curve.ends[1]), 0.5);
524
+ const toward: number = dot(s.curve.normal, sub(centroid, middle));
525
+ return toward === 0 ? null : scale(s.curve.normal, Math.sign(toward));
526
+ });
527
+ if (stretches.some((s: IStretch, i: number): boolean => s.kind === "seam" && ruling[i] === null)) return "a seam plane holds the direction toward the band's loop";
528
+ const turn = (d: number): number => {
529
+ if (!(d < input.corner)) return 0;
530
+ const x: number = d / input.corner;
531
+ return 1 - x * x * x * (10 - 15 * x + 6 * x * x);
532
+ };
533
+ // The ribbons' reach toward each fork (`IAutoMovieConstructionSplit.IProfile.reach`): first derivative by the share, second by its
534
+ // square, so each column only slows across its start and its curvature there, and the band's G2 to the host, are kept.
535
+ const reach: number = input.reach ?? 1;
536
+ const near = (k: number, L: number): AutoMovieSolidRibbon.IRibbon | string => {
537
+ const made: AutoMovieSolidRibbon.IRibbon | string = turned(k, L);
538
+ if (typeof made === "string" || reach === 1) return made;
539
+ const lambda: number = reach + (1 - reach) * (1 - turn(Math.min(within[k]!, stretches[owner[k]!]!.columns - within[k]!) * step));
540
+ return { point: made.point, first: scale(made.first, lambda), second: scale(made.second, lambda * lambda) };
541
+ };
542
+ const turned = (k: number, L: number): AutoMovieSolidRibbon.IRibbon | string => {
543
+ const i: number = owner[k]!;
544
+ const s: IStretch = stretches[i]!;
545
+ const fromStart: number = within[k]! * step;
546
+ const toEnd: number = (s.columns - within[k]!) * step;
547
+ const jet: IAutoMovieSolidSurface.IJet | null = jets[k]!;
548
+ if (jet === null && s.kind === "seam") {
549
+ const reading: AutoMovieConstructionSplitSeam.IPoint = s.curve.at(share(s, within[k]!));
550
+ const angle: number = (Math.PI / 4) * turn(Math.min(fromStart, toEnd));
551
+ const along: Vec3 = scale(reading.tangent, s.forward ? 1 : -1);
552
+ const away: Vec3 = scale(along, fromStart <= toEnd ? 1 : -1);
553
+ return { point: loop[k]!, first: scale(add(scale(ruling[i]!, Math.cos(angle)), scale(away, Math.sin(angle))), L), second: [0, 0, 0] };
554
+ }
555
+ if (jet === null) return `column ${k}: neither on an arc nor on a seam`;
556
+ // The chart direction the band leaves along: the station line, or with `square` the line whose image is square to the end ring,
557
+ // `(into, -into (S_u . S_v) / (S_v . S_v))`, so the host's 2-jet along it keeps the band G2 to the host.
558
+ const across: number = input.square === true && dot(jet.v, jet.v) > 0 ? (-input.host.into * dot(jet.u, jet.v)) / dot(jet.v, jet.v) : 0;
559
+ const hostSpeed: number = norm(add(scale(jet.u, input.host.into), scale(jet.v, across)));
560
+ if (!(hostSpeed > 0)) return `column ${k}: the host's station speed vanishes at its end`;
561
+ const own: AutoMovieSolidRibbon.IRibbon = AutoMovieSolidRibbon.of(input.host.surface, input.host.station, phases[k]!, input.host.into, across, L / hostSpeed);
562
+ // On an arc the nearer fork is its first column or the next seam's; a seam's first column is that seam's own fork.
563
+ const onArc: boolean = s.kind === "arc";
564
+ const d: number = onArc ? Math.min(fromStart, toEnd) : 0;
565
+ const seamIndex: number = onArc ? (fromStart <= toEnd ? (i - 1 + stretches.length) % stretches.length : (i + 1) % stretches.length) : i;
566
+ const w: number = turn(d);
567
+ const lateral: Vec3 | null = ruling[seamIndex] ?? null;
568
+ if (w === 0 || lateral === null) return own;
569
+ const ahead: Vec3 | null = unit(own.first);
570
+ const normal: Vec3 | null = unit(cross(jet.u, jet.v));
571
+ if (ahead === null || normal === null) return `column ${k}: the host's tangent plane is degenerate`;
572
+ const side: Vec3 | null = unit(sub(sub(lateral, scale(normal, dot(lateral, normal))), scale(ahead, dot(lateral, ahead))));
573
+ if (side === null) return `column ${k}: the seam's ruling has no direction in the host's tangent plane square to its ribbon`;
574
+ const angle: number = (Math.PI / 4) * w;
575
+ return { point: own.point, first: scale(add(scale(ahead, Math.cos(angle)), scale(side, Math.sin(angle))), L), second: scale(own.second, 1 - w) };
576
+ };
577
+ const first: IAutoMovieSolidSurface.IJet = jets[0]!;
578
+ const outward: Vec3 | null = unit(scale(cross(first.u, first.v), input.host.surface.orientation));
579
+ if (outward === null) return "the host's tangent plane at the loop's start is degenerate";
580
+ const made: IStrip | string = strip(input.name, loop, near, outward, input.child, input.crease, input.correspondence ?? "angle");
581
+ return typeof made === "string" ? made : { ...made, phases };
582
+ }
583
+
378
584
  /**
379
585
  * A band's strip from its loop to a child's rail: the shared builder of a
380
586
  * split's bands and a port's band.
@@ -393,6 +599,9 @@ export namespace AutoMovieConstructionSplitBand {
393
599
  * @param outward The start surface's outward normal at column 0.
394
600
  * @param child The child side: its surface, its rail station, `into` into its kept side.
395
601
  * @param crease The declared crease window on the child side, or absent.
602
+ * @param correspondence How the child's rail is matched to the loop: by angle about the rail's centroid, or by arclength share.
603
+ * @param ribbons Whether every column takes the band's one common ribbon scale, or its own (`local`).
604
+ * @param profiles A port band's cross profiles, their depths in mm (`IAutoMovieConstructionPort.IProfile`); absent, none.
396
605
  * @returns The strip, or the refusal.
397
606
  */
398
607
  export function strip(
@@ -402,9 +611,12 @@ export namespace AutoMovieConstructionSplitBand {
402
611
  outward: Vec3,
403
612
  child: ISide,
404
613
  crease?: IAutoMovieConstructionSplit.ICrease,
614
+ correspondence: "angle" | "length" = "angle",
615
+ ribbons: "common" | "column" = "common",
616
+ profiles: readonly IAutoMovieConstructionPort.IProfile[] = [],
405
617
  ): IStrip | string {
406
618
  const n: number = loop.length;
407
- const childPhases: number[] | string = phases(child, loop);
619
+ const childPhases: number[] | string = correspondence === "length" ? lengths(child, loop) : phases(child, loop);
408
620
  if (typeof childPhases === "string") return childPhases;
409
621
 
410
622
  const columns: {
@@ -412,8 +624,9 @@ export namespace AutoMovieConstructionSplitBand {
412
624
  end: AutoMovieSolidRibbon.IRibbon;
413
625
  }[] = [];
414
626
  for (let k: number = 0; k < n; ++k) {
627
+ const station: number = railAt(child, childPhases[k]!);
415
628
  const far: IAutoMovieSolidSurface.IJet = child.surface.jet(
416
- child.station,
629
+ station,
417
630
  childPhases[k]!,
418
631
  );
419
632
  const chord: Vec3 = sub(far.p, loop[k]!);
@@ -425,7 +638,7 @@ export namespace AutoMovieConstructionSplitBand {
425
638
  if (typeof start === "string") return start;
426
639
  const own: AutoMovieSolidRibbon.IRibbon = AutoMovieSolidRibbon.of(
427
640
  child.surface,
428
- child.station,
641
+ station,
429
642
  childPhases[k]!,
430
643
  child.into,
431
644
  0,
@@ -463,8 +676,8 @@ export namespace AutoMovieConstructionSplitBand {
463
676
  // ribbon's first derivative by `f` and its second by `f^2` changes only
464
677
  // the cross parameter's speed, so both rails stay G2. One factor for the
465
678
  // whole band keeps the ribbon fields as smooth along the loop as the
466
- // chord law's. Debt: a factor varying smoothly along the loop would
467
- // keep longer tangents where the turn is gentle.
679
+ // chord law's; a factor varying smoothly along the loop (`local`) keeps
680
+ // longer tangents where the turn is gentle.
468
681
  // A column whose ribbon points back against its chord turns back at any
469
682
  // scale (its child rail point lies behind the side's own tangent
470
683
  // continuation, as where a port's ring and the child's rail differ in
@@ -510,23 +723,41 @@ export namespace AutoMovieConstructionSplitBand {
510
723
  settled = false;
511
724
  }
512
725
  }
726
+
727
+ // Each column's own factor, when the band asks for it (`ribbons:
728
+ // "column"`): the smooth field below each forward column's largest
729
+ // monotone factor, so one hard stretch shortens only its own
730
+ // neighbourhood. A port's single hard stretch (the arm's band behind the
731
+ // armpit held every one of its 192 columns at 0.093 where nine in ten
732
+ // hold at 1) otherwise turns the whole band within a tenth of its chord
733
+ // at both rails, which shows as a line along each rail.
734
+ const field: number[] | string =
735
+ ribbons === "column"
736
+ ? local(columns, backward, factors, forward)
737
+ : columns.map((): number => factor);
738
+ if (typeof field === "string") return field;
513
739
  const scaled: typeof columns = columns.map(
514
- (column: (typeof columns)[number]): (typeof columns)[number] => ({
740
+ (column: (typeof columns)[number], k: number): (typeof columns)[number] => ({
515
741
  start: {
516
742
  point: column.start.point,
517
- first: scale(column.start.first, factor),
518
- second: scale(column.start.second, factor * factor),
743
+ first: scale(column.start.first, field[k]!),
744
+ second: scale(column.start.second, field[k]! * field[k]!),
519
745
  },
520
746
  end: {
521
747
  point: column.end.point,
522
- first: scale(column.end.first, factor),
523
- second: scale(column.end.second, factor * factor),
748
+ first: scale(column.end.first, field[k]!),
749
+ second: scale(column.end.second, field[k]! * field[k]!),
524
750
  },
525
751
  }),
526
752
  );
527
753
 
528
- const published: { chain: IAutoMovieLoftChain; length: number } | null =
754
+ const plain: { chain: IAutoMovieLoftChain; length: number } | null =
529
755
  AutoMovieSolidBlendChain.strip(name, scaled, outward);
756
+ const flat: IAutoMovieSolidSurface | null = plain === null ? null : AutoMovieSolidChain.surface(plain.chain);
757
+ const published: { chain: IAutoMovieLoftChain; length: number } | null =
758
+ profiles.length === 0 || plain === null || flat === null
759
+ ? plain
760
+ : AutoMovieSolidBlendChain.strip(name, scaled, outward, sections(flat, plain.length, n, profiles));
530
761
  if (published === null)
531
762
  return "the strip has no positive span or no outward side";
532
763
  const surface: IAutoMovieSolidSurface | null = AutoMovieSolidChain.surface(
@@ -539,7 +770,97 @@ export namespace AutoMovieConstructionSplitBand {
539
770
  length: published.length,
540
771
  loop: [...loop],
541
772
  childPhases,
542
- scale: { applied: factor, columns: factors, backward },
773
+ scale: { applied: Math.min(...field), columns: factors, backward },
774
+ };
775
+ }
776
+
777
+ /**
778
+ * A profiled band's interior cross sections (`IAutoMovieConstructionPort.IProfile`): at every share any profile names, each column's
779
+ * point and station derivatives on the plain band, per unit share, carried in along the plain band's inward unit normal by the sum of the
780
+ * profiles' depths there, each weighted by its window at the column's clock, with the depth's own slope and bend across the band. The
781
+ * normal's own turn across the band is left out of the derivatives; the strip stays a C2 piecewise quintic through its rails and these
782
+ * sections, and its rails keep their 2-jets.
783
+ *
784
+ * @param plain The plain band's surface: station mm from 0 at the loop to `L` at the rail, phase the loop clock.
785
+ * @param L The plain band's span, mm.
786
+ * @param n The columns, at clocks `2 pi k / n`.
787
+ * @param profiles The profiles, depths in mm.
788
+ * @returns The sections in increasing share.
789
+ */
790
+ function sections(
791
+ plain: IAutoMovieSolidSurface,
792
+ L: number,
793
+ n: number,
794
+ profiles: readonly IAutoMovieConstructionPort.IProfile[],
795
+ ): { t: number; jets: [Vec3, Vec3, Vec3][] }[] {
796
+ const shares: number[] = [...new Set(profiles.flatMap((p: IAutoMovieConstructionPort.IProfile): number[] => p.knots.map((k: [number, number]): number => k[0])))].sort(
797
+ (a: number, b: number): number => a - b,
798
+ );
799
+ const depths: ((t: number) => [number, number, number])[] = profiles.map(
800
+ (p: IAutoMovieConstructionPort.IProfile): ((t: number) => [number, number, number]) =>
801
+ clamped([0, ...p.knots.map((k: [number, number]): number => k[0]), 1], [0, ...p.knots.map((k: [number, number]): number => k[1]), 0]),
802
+ );
803
+ return shares.map((t: number): { t: number; jets: [Vec3, Vec3, Vec3][] } => ({
804
+ t,
805
+ jets: Array.from({ length: n }, (_: unknown, k: number): [Vec3, Vec3, Vec3] => {
806
+ const c: number = (2 * Math.PI * k) / n;
807
+ const jet: IAutoMovieSolidSurface.IJet = plain.jet(t * L, c);
808
+ const p: Vec3 = [jet.p[0], jet.p[1], jet.p[2]];
809
+ const d1: Vec3 = scale([jet.u[0], jet.u[1], jet.u[2]], L);
810
+ const d2: Vec3 = scale([jet.uu[0], jet.uu[1], jet.uu[2]], L * L);
811
+ const normal: Vec3 | null = unit(scale(cross(jet.u, jet.v), plain.orientation));
812
+ let depth: [number, number, number] = [0, 0, 0];
813
+ profiles.forEach((profile: IAutoMovieConstructionPort.IProfile, i: number): void => {
814
+ const w: number = weight(c, profile);
815
+ const [v, s, b]: [number, number, number] = depths[i]!(t);
816
+ depth = [depth[0] + w * v, depth[1] + w * s, depth[2] + w * b];
817
+ });
818
+ if (normal === null) return [p, d1, d2];
819
+ return [sub(p, scale(normal, depth[0])), sub(d1, scale(normal, depth[1])), sub(d2, scale(normal, depth[2]))];
820
+ }),
821
+ }));
822
+ }
823
+
824
+ /**
825
+ * The cubic spline through `(x_i, y_i)` with zero slope at both ends, read as its value and its first and second derivatives: the clamped
826
+ * spline's second derivatives solved by the tridiagonal (Thomas) sweep.
827
+ */
828
+ function clamped(x: readonly number[], y: readonly number[]): (t: number) => [number, number, number] {
829
+ const m: number = x.length;
830
+ const h: number[] = Array.from({ length: m - 1 }, (_: unknown, i: number): number => x[i + 1]! - x[i]!);
831
+ const a: number[] = new Array<number>(m).fill(0);
832
+ const b: number[] = new Array<number>(m).fill(0);
833
+ const c: number[] = new Array<number>(m).fill(0);
834
+ const r: number[] = new Array<number>(m).fill(0);
835
+ b[0] = h[0]! / 3;
836
+ c[0] = h[0]! / 6;
837
+ r[0] = (y[1]! - y[0]!) / h[0]!;
838
+ for (let i: number = 1; i < m - 1; ++i) {
839
+ a[i] = h[i - 1]! / 6;
840
+ b[i] = (h[i - 1]! + h[i]!) / 3;
841
+ c[i] = h[i]! / 6;
842
+ r[i] = (y[i + 1]! - y[i]!) / h[i]! - (y[i]! - y[i - 1]!) / h[i - 1]!;
843
+ }
844
+ a[m - 1] = h[m - 2]! / 6;
845
+ b[m - 1] = h[m - 2]! / 3;
846
+ r[m - 1] = -(y[m - 1]! - y[m - 2]!) / h[m - 2]!;
847
+ for (let i: number = 1; i < m; ++i) {
848
+ const f: number = a[i]! / b[i - 1]!;
849
+ b[i] = b[i]! - f * c[i - 1]!;
850
+ r[i] = r[i]! - f * r[i - 1]!;
851
+ }
852
+ const M: number[] = new Array<number>(m).fill(0);
853
+ M[m - 1] = r[m - 1]! / b[m - 1]!;
854
+ for (let i: number = m - 2; i >= 0; --i) M[i] = (r[i]! - c[i]! * M[i + 1]!) / b[i]!;
855
+ return (t: number): [number, number, number] => {
856
+ let i: number = 0;
857
+ while (i < m - 2 && t > x[i + 1]!) ++i;
858
+ const hi: number = h[i]!;
859
+ const A: number = (x[i + 1]! - t) / hi;
860
+ const B: number = (t - x[i]!) / hi;
861
+ const value: number = A * y[i]! + B * y[i + 1]! + (((A * A * A - A) * M[i]! + (B * B * B - B) * M[i + 1]!) * hi * hi) / 6;
862
+ const slope: number = (y[i + 1]! - y[i]!) / hi + ((-(3 * A * A - 1) * M[i]! + (3 * B * B - 1) * M[i + 1]!) * hi) / 6;
863
+ return [value, slope, A * M[i]! + B * M[i + 1]!];
543
864
  };
544
865
  }
545
866
 
@@ -623,6 +944,88 @@ export namespace AutoMovieConstructionSplitBand {
623
944
  );
624
945
  }
625
946
 
947
+ /**
948
+ * How fast a column's ribbon scale may grow away from a column that needs a smaller one, in natural log per radian of clock: from a
949
+ * column held at a tenth, the field is back at 1 about 0.6 rad round the loop.
950
+ */
951
+ const LOCAL_SLOPE: number = 4;
952
+
953
+ /** The width of the Gaussian that smooths the scale field along the loop, radians of clock: about five columns of 192. */
954
+ const LOCAL_SMOOTH: number = 0.15;
955
+
956
+ /**
957
+ * Each column's own ribbon scale: a field smooth along the loop that stays at or below every forward column's largest monotone scale.
958
+ * In log scale it is the lower envelope of the columns' targets, each widened by `LOCAL_SLOPE` per radian of clock, smoothed by a
959
+ * periodic Gaussian of `LOCAL_SMOOTH`. A column's target starts at its own log scale; where the smoothing carries the field above a
960
+ * column's own (it rounds off the envelope's corner at a hard column) that column's target is pushed down by the excess, and a column
961
+ * that still fails at its field value takes its largest monotone scale below it, and the field is read again, so the field is lowered
962
+ * only about the columns that need it. A backward column takes the field of its neighbours, since it turns back at any scale.
963
+ *
964
+ * @param columns Every column's ribbons, in clock order at `2 pi k / n`.
965
+ * @param backward The indices of the columns that point back against their chord.
966
+ * @param factors The forward columns' largest monotone scales at or below 1, in their order.
967
+ * @param forward The forward columns, in their order.
968
+ * @returns The scale of every column, or the refusal when a column has no monotone scale.
969
+ *
970
+ * Scaling one column's first derivatives by `f` and its second by `f^2`
971
+ * reparameterizes it across the band, so each rail stays G2; a field smooth
972
+ * in the clock keeps the columns' periodic spline interpolation smooth along
973
+ * the loop, and the envelope keeps every forward column monotone. No column
974
+ * is given more than its own monotone scale; a column with none refuses the
975
+ * band as the common scale does. The work is one envelope, one smoothing,
976
+ * one lowering and a check per column, repeated only for a column that
977
+ * fails: O(n^2) for n columns per pass, a few hundred columns once per band,
978
+ * returning one array of n numbers. It is a numeric field over already built
979
+ * columns and coordinates no work, and `create` answers the contracts for
980
+ * the band it builds.
981
+ */
982
+ function local(columns: readonly IColumn[], backward: readonly number[], factors: readonly number[], forward: readonly IColumn[]): number[] | string {
983
+ const n: number = columns.length;
984
+ if (forward.length === 0) return columns.map((): number => 1);
985
+ const turn: number = 2 * Math.PI;
986
+ const own: number[] = columns.map((column: IColumn): number => {
987
+ const i: number = forward.indexOf(column);
988
+ return i < 0 ? Infinity : Math.log(factors[i]!);
989
+ });
990
+ const distance = (j: number, k: number): number => {
991
+ const d: number = Math.abs(j - k) % n;
992
+ return (turn * Math.min(d, n - d)) / n;
993
+ };
994
+ // The targets the envelope is built on: each forward column's own log scale, pushed further down wherever the smoothing still carries
995
+ // the field above the column's own.
996
+ const goal: number[] = [...own];
997
+ for (let pass: number = 0; pass < 64; ++pass) {
998
+ const envelope: number[] = columns.map((_: IColumn, k: number): number => Math.min(0, ...goal.map((g: number, j: number): number => g + LOCAL_SLOPE * distance(j, k))));
999
+ const smooth: number[] = columns.map((_: IColumn, k: number): number => {
1000
+ let [sum, weight]: [number, number] = [0, 0];
1001
+ for (let j: number = 0; j < n; ++j) {
1002
+ const w: number = Math.exp(-((distance(j, k) / LOCAL_SMOOTH) ** 2) / 2);
1003
+ sum += w * envelope[j]!;
1004
+ weight += w;
1005
+ }
1006
+ return sum / weight;
1007
+ });
1008
+ const field: number[] = smooth.map((h: number): number => Math.exp(h));
1009
+ let settled: boolean = true;
1010
+ for (const [k, column] of columns.entries()) {
1011
+ if (backward.includes(k)) continue;
1012
+ if (smooth[k]! > own[k]!) {
1013
+ goal[k] = goal[k]! - (smooth[k]! - own[k]!) - 1e-9;
1014
+ settled = false;
1015
+ continue;
1016
+ }
1017
+ if (monotone(column, field[k]!)) continue;
1018
+ const lower: number | null = largest(column, field[k]!);
1019
+ if (lower === null) return "no ribbon scale keeps every column monotone along its chord";
1020
+ own[k] = Math.log(lower);
1021
+ goal[k] = Math.min(goal[k]!, own[k]!);
1022
+ settled = false;
1023
+ }
1024
+ if (settled) return field;
1025
+ }
1026
+ return "no smooth ribbon scale keeps every column monotone along its chord";
1027
+ }
1028
+
626
1029
  /**
627
1030
  * A column's largest monotone scale found at or below `from`: `from`
628
1031
  * itself when it holds, else halving until it holds (a ribbon pointing
@@ -659,6 +1062,97 @@ export namespace AutoMovieConstructionSplitBand {
659
1062
  return lo;
660
1063
  }
661
1064
 
1065
+ /**
1066
+ * The child's rail phase at each loop point by arclength, for a split's child and a port's alike: the ring is the child's rail read at
1067
+ * its station at each phase (`railAt`, a port's rail curve when it has one), and every column takes the phase that stands as far round
1068
+ * the ring, as a share of the ring's length, as the column stands round the loop, the two run the same way when their Newell normals
1069
+ * agree, from the start on the ring at which the two curves, each about its own centroid, stand closest in the least-squares sense.
1070
+ * Neither curve need be star-shaped about the centroid.
1071
+ */
1072
+ function lengths(child: ISide, loop: readonly Vec3[]): number[] | string {
1073
+ const turn: number = 2 * Math.PI;
1074
+ const samples: number = 8 * loop.length;
1075
+ const at = (psi: number): Vec3 => {
1076
+ const p: readonly number[] = child.surface.point?.(railAt(child, psi), psi) ?? child.surface.jet(railAt(child, psi), psi).p;
1077
+ return [p[0]!, p[1]!, p[2]!];
1078
+ };
1079
+ const ring: Vec3[] = Array.from({ length: samples + 1 }, (_: unknown, j: number): Vec3 => at((turn * j) / samples));
1080
+ const newell = (points: readonly Vec3[]): { centre: Vec3; normal: Vec3 | null } => {
1081
+ let centre: Vec3 = [0, 0, 0];
1082
+ for (const q of points) centre = add(centre, scale(q, 1 / points.length));
1083
+ let area: Vec3 = [0, 0, 0];
1084
+ points.forEach((q: Vec3, j: number): void => {
1085
+ area = add(area, cross(sub(q, centre), sub(points[(j + 1) % points.length]!, centre)));
1086
+ });
1087
+ return { centre, normal: unit(area) };
1088
+ };
1089
+ const rim = newell(ring.slice(0, samples));
1090
+ const lap = newell(loop);
1091
+ if (rim.normal === null) return "the child's rail ring encloses no area";
1092
+ if (lap.normal === null) return "the loop encloses no area";
1093
+ const sense: 1 | -1 = dot(rim.normal, lap.normal) > 0 ? 1 : -1;
1094
+ // Cumulative arclength round the ring at its samples, and round the loop at its columns.
1095
+ const along: number[] = [0];
1096
+ for (let j: number = 1; j <= samples; ++j) along.push(along[j - 1]! + norm(sub(ring[j]!, ring[j - 1]!)));
1097
+ const total: number = along[samples]!;
1098
+ const lapAlong: number[] = [0];
1099
+ for (let k: number = 1; k <= loop.length; ++k) lapAlong.push(lapAlong[k - 1]! + norm(sub(loop[k % loop.length]!, loop[k - 1]!)));
1100
+ const lapTotal: number = lapAlong[loop.length]!;
1101
+ if (!(total > 0 && lapTotal > 0)) return "the child's rail ring or the loop has no length";
1102
+ // The sample at an arclength round the ring: the last whose arclength does not pass it, by bisection.
1103
+ const below = (x: number): number => {
1104
+ let lo: number = 0;
1105
+ let hi: number = samples - 1;
1106
+ while (lo < hi) {
1107
+ const mid: number = (lo + hi + 1) >> 1;
1108
+ if (along[mid]! <= x) lo = mid;
1109
+ else hi = mid - 1;
1110
+ }
1111
+ return lo;
1112
+ };
1113
+ // The phase and the point at an arclength round the ring, read linearly between its samples.
1114
+ const phaseAt = (length: number): number => {
1115
+ const x: number = ((length % total) + total) % total;
1116
+ const j: number = below(x);
1117
+ const span: number = along[j + 1]! - along[j]!;
1118
+ return (turn * (j + (span > 0 ? (x - along[j]!) / span : 0))) / samples;
1119
+ };
1120
+ const pointAt = (length: number): Vec3 => {
1121
+ const x: number = ((length % total) + total) % total;
1122
+ const j: number = below(x);
1123
+ const span: number = along[j + 1]! - along[j]!;
1124
+ const f: number = span > 0 ? (x - along[j]!) / span : 0;
1125
+ return add(scale(ring[j]!, 1 - f), scale(ring[j + 1]!, f));
1126
+ };
1127
+ // Where round the ring the loop's first column lands: of every sample, the one at which the loop's points and the ring's points taken
1128
+ // at the same shares of their lengths stand closest about their own centroids (the least sum of squared distances), the start a loft
1129
+ // between two closed curves takes so that the band does not twist. Read by the angle of the loop's first point about the ring's
1130
+ // centroid, every toe's band of f1's foot turned 14 to 18 degrees about its toe on average.
1131
+ let anchor: number = 0;
1132
+ let least: number = Infinity;
1133
+ for (let j: number = 0; j < samples; ++j) {
1134
+ let cost: number = 0;
1135
+ for (let k: number = 0; k < loop.length && cost < least; ++k) {
1136
+ const d: Vec3 = sub(sub(pointAt(along[j]! + sense * (lapAlong[k]! / lapTotal) * total), rim.centre), sub(loop[k]!, lap.centre));
1137
+ cost += dot(d, d);
1138
+ }
1139
+ if (cost < least) [least, anchor] = [cost, j];
1140
+ }
1141
+ const start: number = along[anchor]!;
1142
+ const out: number[] = [];
1143
+ for (let k: number = 0; k < loop.length; ++k) {
1144
+ const psi: number = phaseAt(start + sense * (lapAlong[k]! / lapTotal) * total);
1145
+ if (k === 0) {
1146
+ out.push(psi);
1147
+ continue;
1148
+ }
1149
+ const step: number = sense * ((((sense * (psi - out[k - 1]!)) % turn) + turn) % turn);
1150
+ if (!(step !== 0)) return `the child's rail phase does not advance at column ${k}`;
1151
+ out.push(out[k - 1]! + step);
1152
+ }
1153
+ return out;
1154
+ }
1155
+
662
1156
  /**
663
1157
  * The child's rail phase at each loop point: the phase whose rail point stands at the loop point's angle about the rail ring's centroid, in the ring's Newell plane; or why none is admitted.
664
1158
  */
@@ -666,8 +1160,8 @@ export namespace AutoMovieConstructionSplitBand {
666
1160
  const turn: number = 2 * Math.PI;
667
1161
  const samples: number = 8 * loop.length;
668
1162
  const at: (psi: number) => Vec3 = (psi: number): Vec3 => [
669
- ...(child.surface.point?.(child.station, psi) ??
670
- child.surface.jet(child.station, psi).p),
1163
+ ...(child.surface.point?.(railAt(child, psi), psi) ??
1164
+ child.surface.jet(railAt(child, psi), psi).p),
671
1165
  ];
672
1166
  const ring: Vec3[] = Array.from(
673
1167
  { length: samples },