@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
@@ -14,7 +14,7 @@ type Point = readonly [number, number];
14
14
  /** World-space millimetre vector. */
15
15
  type Vec3 = AutoMovieSolidVector.Vec3;
16
16
  /** Existing vector lengths and analytic chart-cross arithmetic. */
17
- const { cross, norm }: typeof AutoMovieSolidVector = AutoMovieSolidVector;
17
+ const { cross, norm, sub }: typeof AutoMovieSolidVector = AutoMovieSolidVector;
18
18
 
19
19
  /** One locally evaluated, not yet published sampling point. */
20
20
  interface Sample {
@@ -64,6 +64,24 @@ interface Grid {
64
64
  * the length unit, so a body in another unit legalizes alike.
65
65
  */
66
66
  metric: number;
67
+
68
+ /**
69
+ * A quadrilateral's own first fundamental form, as the map
70
+ * `(u, v) -> (u + shear v, scale v)` under which its chart lengths are its
71
+ * skin's up to one factor: the least-squares linear map `J` from its four
72
+ * chart points to their skin points about their centroids, with
73
+ * `E = |J_u|^2`, `F = J_u . J_v`, `G = |J_v|^2`, `shear = F / E` and
74
+ * `scale = sqrt(G / E - shear^2)`. Residual legalization reads it, so a face
75
+ * whose metric changes across it is made Delaunay in the metric each
76
+ * quadrilateral actually spans, not the face's mean: beside the armscye's
77
+ * loop the trunk spans 231 mm a radian where its mean is about half that,
78
+ * and triangles fair in the mean metric stood 4 to 7 degrees thin on the
79
+ * skin and folded 135 degrees. Read instead from the grid jets of the cell
80
+ * holding the centroid, a band's corner column at f1's crotch fork, where
81
+ * the band's columns converge within one cell, took the wrong diagonal and
82
+ * folded 63 degrees. Points with no skin point yet read the face's mean.
83
+ */
84
+ local: (ids: readonly number[], charts: readonly Point[]) => [number, number];
67
85
  }
68
86
 
69
87
  /**
@@ -89,7 +107,7 @@ interface Grid {
89
107
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One local record carries provisional points, indexed constraints and full-cell triangles; domain assembly and residual triangulation have separate owners.
90
108
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts A missing retained grid is not an empty source. No trim index is reconstructed/welded, no full cell is admitted solely from corner flags and no mesh mutation occurs before all downstream planning succeeds.
91
109
  * @evidence contracts/development/common.md#meaningful-documentation States copied-jet lifetime, station-major exceptions, foreign-owner face charts, conservative cell exclusion and immutable-source premise. Periodic trim primitives use the local half-period family consumed by the existing kept-side reader.
92
- * @evidence contracts/development/implementation.md#efficient-algorithms Reads G grid jets once and performs O(G(S+L)) true-cut classification, O(C(S+D)) conservative cell tests and O(G(S+D)) boundary-contact scans for S cut segments, D domain authority segments and C cells. Domain work and the cost of each source predicate are additional, not constant-time assumptions.
110
+ * @evidence contracts/development/implementation.md#efficient-algorithms Reads G grid jets once and performs O(G(S+L)) true-cut classification, conservative cell tests over only the barriers whose station range meets each cell's interval (bucketed once in O((S+D) R) for R intervals) and O(G(S+D)) boundary-contact scans for S cut segments, D domain authority segments and C cells. Domain work and the cost of each source predicate are additional, not constant-time assumptions.
93
111
  * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares station/phase spacings, copied jets and grid-index reservations; source readers and full-cell lookup serve all residual queries within this face.
94
112
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources O(G+S+L) grid/constraint/catalogue state is local; returned closures retain their source readers and cell table only until the caller finishes this face, with no global cache.
95
113
  */
@@ -203,6 +221,50 @@ export function gridAutoMovieSolidMesh(
203
221
  reserved.set(key, id);
204
222
  return id;
205
223
  };
224
+
225
+ // A quadrilateral's own first fundamental form: the least-squares linear map from its four chart points to their skin points about
226
+ // their centroids, `J = (sum dX dC^T)(sum dC dC^T)^-1`, read as the shear and scale of `J^T J` over its first entry.
227
+ const point = (id: number): readonly number[] | undefined =>
228
+ id < base
229
+ ? [mesh.positions[3 * id]!, mesh.positions[3 * id + 1]!, mesh.positions[3 * id + 2]!]
230
+ : samples.get(id)?.point;
231
+ const local = (ids: readonly number[], charts: readonly Point[]): [number, number] => {
232
+ const skins: (readonly number[] | undefined)[] = ids.map(point);
233
+ if (skins.some((x: readonly number[] | undefined): boolean => x === undefined)) return [0, metric];
234
+ const n: number = charts.length;
235
+ const cu: number = charts.reduce((s: number, c: Point): number => s + c[0], 0) / n;
236
+ const cv: number = charts.reduce((s: number, c: Point): number => s + c[1], 0) / n;
237
+ const mean: number[] = [0, 1, 2].map((a: number): number => skins.reduce((s: number, x: readonly number[] | undefined): number => s + x![a]!, 0) / n);
238
+ let suu: number = 0;
239
+ let suv: number = 0;
240
+ let svv: number = 0;
241
+ const xu: number[] = [0, 0, 0];
242
+ const xv: number[] = [0, 0, 0];
243
+ charts.forEach((c: Point, k: number): void => {
244
+ const du: number = c[0] - cu;
245
+ const dv: number = c[1] - cv;
246
+ suu += du * du;
247
+ suv += du * dv;
248
+ svv += dv * dv;
249
+ for (let a: number = 0; a < 3; a++) {
250
+ const dx: number = skins[k]![a]! - mean[a]!;
251
+ xu[a] = xu[a]! + dx * du;
252
+ xv[a] = xv[a]! + dx * dv;
253
+ }
254
+ });
255
+ const det: number = suu * svv - suv * suv;
256
+ if (!(det > 0)) return [0, metric];
257
+ const su: number[] = [0, 1, 2].map((a: number): number => (xu[a]! * svv - xv[a]! * suv) / det);
258
+ const sv: number[] = [0, 1, 2].map((a: number): number => (xv[a]! * suu - xu[a]! * suv) / det);
259
+ const e: number = su[0]! ** 2 + su[1]! ** 2 + su[2]! ** 2;
260
+ const f: number = su[0]! * sv[0]! + su[1]! * sv[1]! + su[2]! * sv[2]!;
261
+ const g: number = sv[0]! ** 2 + sv[1]! ** 2 + sv[2]! ** 2;
262
+ const shear: number = f / e;
263
+ const scale: number = Math.sqrt(g / e - shear * shear);
264
+ return Number.isFinite(shear) && Number.isFinite(scale) && scale > 0
265
+ ? [shear, scale]
266
+ : [0, metric];
267
+ };
206
268
  const classify: ReturnType<typeof AutoMovieSolidMeshLoop.prepare> =
207
269
  AutoMovieSolidMeshLoop.prepare(loops, period);
208
270
  const du: number[] = stations.map((u: number, i: number): number =>
@@ -246,8 +308,30 @@ export function gridAutoMovieSolidMesh(
246
308
  (): boolean[] => new Array<boolean>(columns).fill(false),
247
309
  );
248
310
  const full: AutoMovieSolidMeshPlan.ITriangle[] = [];
311
+ const cuts: { a: number; b: number; c: number; d: number; wrap: number; choice: "first" | "other" | "tie"; first: number; other: number }[] = [];
249
312
  const boundary: Map<string, AutoMovieSolidMeshConstraints.ISegment> =
250
313
  new Map();
314
+
315
+ // The barriers each station interval can meet, in their own order: a
316
+ // barrier whose station range misses an interval touches none of its cells,
317
+ // so each cell reads only its interval's few instead of the face's all.
318
+ const crossing: number[][] = Array.from(
319
+ { length: Math.max(0, stations.length - 1) },
320
+ (): number[] => [],
321
+ );
322
+ for (const [index, edge] of barriers.entries()) {
323
+ const a: Point | undefined = chart.get(edge.a);
324
+ const b: Point | undefined = chart.get(edge.b);
325
+ // A barrier without both chart points is offered to every interval, so
326
+ // the cell test meets it exactly as before.
327
+ const low: number =
328
+ a === undefined || b === undefined ? -Infinity : Math.min(a[0], b[0]);
329
+ const high: number =
330
+ a === undefined || b === undefined ? Infinity : Math.max(a[0], b[0]);
331
+ for (let i: number = 0; i + 1 < stations.length; i++)
332
+ if (!(high < stations[i]! || low > stations[i + 1]!))
333
+ crossing[i]!.push(index);
334
+ }
251
335
  for (let i: number = 0; i + 1 < stations.length; i++)
252
336
  for (let j: number = 0; j < columns; j++) {
253
337
  const next: number = (j + 1) % phases.length;
@@ -263,6 +347,7 @@ export function gridAutoMovieSolidMesh(
263
347
  const touched: boolean | string = touches(
264
348
  chart,
265
349
  barriers,
350
+ crossing[i]!,
266
351
  stations[i]!,
267
352
  stations[i + 1]!,
268
353
  phases[j]!,
@@ -278,10 +363,21 @@ export function gridAutoMovieSolidMesh(
278
363
  const c: number = at(i + 1, next);
279
364
  const d: number = at(i, next);
280
365
  const wrap: number = next === 0 ? 1 : 0;
281
- full.push(
282
- { vertices: [a, b, c], lifts: [0, 0, wrap] },
283
- { vertices: [a, c, d], lifts: [0, wrap, wrap] },
284
- );
366
+
367
+ // A full cell is cut from its first corner unless its other diagonal
368
+ // bends the cell's two triangles against each other by well under half
369
+ // as much (`BEND`). Cut always from its first corner, a cell sheared by
370
+ // a chart whose phase lines wind round the part took the diagonal
371
+ // across the skin's curve, and its two triangles stood at different
372
+ // slopes in a check over the whole face (f1's deltoid). Cut by the sign
373
+ // of the Delaunay test in the cell's own form, nearly square cells took
374
+ // either diagonal by rounding, and where the choice changed a zigzag
375
+ // line ran across the face (f1's upper lip).
376
+ // A cell neither of whose splits is clearly flatter takes the diagonal its face's other such cells take, decided once for the face
377
+ // below (`DIAGONAL`), so the rule reads the geometry alone and a chart and its mirror image cut mirror-image cells.
378
+ const [pa, pb, pc, pd]: Vec3[] = [jets[i]![j]!.p, jets[i + 1]![j]!.p, jets[i + 1]![next]!.p, jets[i]![next]!.p];
379
+ const [first, other]: number[] = [bend(pa, pb, pc, pd), bend(pb, pc, pd, pa)];
380
+ cuts.push({ a, b, c, d, wrap, choice: other < BEND * first ? "other" : first < BEND * other ? "first" : "tie", first: norm(sub(pc, pa)), other: norm(sub(pd, pb)) });
285
381
  for (const edge of [
286
382
  { a, b, turn: 0 },
287
383
  { a: b, b: c, turn: wrap },
@@ -296,6 +392,27 @@ export function gridAutoMovieSolidMesh(
296
392
  else boundary.set(key, edge);
297
393
  }
298
394
  }
395
+
396
+ // The face's undecided cells all take the diagonal family that is the shorter in sum over them (`DIAGONAL`). The sums are compared
397
+ // relatively: on a face whose two families are equally long (a prism's or a cylinder's cells) they differ only by rounding, which
398
+ // changes with the face's size, so an exact comparison cut the same face differently at two scales.
399
+ const ties: { first: number; other: number }[] = cuts.filter((cut: (typeof cuts)[number]): boolean => cut.choice === "tie");
400
+ const sums: { first: number; other: number } = {
401
+ first: ties.reduce((sum: number, cut: { first: number; other: number }): number => sum + cut.first, 0),
402
+ other: ties.reduce((sum: number, cut: { first: number; other: number }): number => sum + cut.other, 0),
403
+ };
404
+ const tie: "first" | "other" = sums.other < sums.first * (1 - DIAGONAL_ROUNDING) ? "other" : "first";
405
+ for (const cut of cuts)
406
+ if ((cut.choice === "tie" ? tie : cut.choice) === "other")
407
+ full.push(
408
+ { vertices: [cut.a, cut.b, cut.d], lifts: [0, 0, cut.wrap] },
409
+ { vertices: [cut.b, cut.c, cut.d], lifts: [0, cut.wrap, cut.wrap] },
410
+ );
411
+ else
412
+ full.push(
413
+ { vertices: [cut.a, cut.b, cut.c], lifts: [0, 0, cut.wrap] },
414
+ { vertices: [cut.a, cut.c, cut.d], lifts: [0, cut.wrap, cut.wrap] },
415
+ );
299
416
  const readers: ((u: number, v: number) => boolean)[] = loops.map(
300
417
  (loop: AutoMovieSolidMesh.ILoop): ((u: number, v: number) => boolean) =>
301
418
  AutoMovieSolidCycle.prepare(loop, period),
@@ -371,9 +488,55 @@ export function gridAutoMovieSolidMesh(
371
488
  source,
372
489
  residual,
373
490
  metric,
491
+ local,
374
492
  };
375
493
  }
376
494
 
495
+ /**
496
+ * Share of the first-corner split's bend below which a full cell takes its
497
+ * other diagonal (`bend`). A cell whose two splits bend alike, as the nearly
498
+ * square cells over f1's upper lip do, keeps its first corner, so a face is
499
+ * cut alike wherever no split is clearly flatter. Compared on
500
+ * `shoulder.high-oblique` and `head.front`: at 0.5 the deltoid's cap kept its
501
+ * check; at 0.9 the check is gone but for a few cells at its top edge and the
502
+ * lip is cut as it was before any cell was turned.
503
+ *
504
+ * A cell neither of whose splits bends under this share of the other's is
505
+ * undecided, and all of a face's undecided cells take one diagonal family:
506
+ * the one whose diagonals are the shorter in sum over them. Undecided cells
507
+ * had kept their first corner, which is the chart's, not the skin's: a
508
+ * mirrored chart runs its phases the other way, so its first corner is the
509
+ * original's other one, and f1's -Z hand was cut unlike the +Z hand's mirror
510
+ * image (its vertices 0.5 mm off, 2 mm once the fork fills slid along those
511
+ * edges). Read on lengths summed over the face, a face cut alike stays cut
512
+ * alike and its mirror is cut as its mirror image; only a face whose two
513
+ * families sum to exactly the same length falls back to the first corner.
514
+ */
515
+ const BEND: number = 0.9;
516
+
517
+ /**
518
+ * Relative difference under which a face's two diagonal families count as equally long, and its undecided cells keep the first corner.
519
+ * Summing some thousands of lengths carries a relative rounding near 1e-13, so 1e-9 stands four decades above the noise and far under
520
+ * any difference a face's shape makes; `test_construction_determinism` realizes one assembly at two sizes and requires the same cells.
521
+ */
522
+ const DIAGONAL_ROUNDING: number = 1e-9;
523
+
524
+ /**
525
+ * The angle between the unit normals of the two triangles a quadrilateral is
526
+ * cut into along its diagonal `p`..`r`, radians, from `(p, q, r)` and
527
+ * `(p, r, s)`; 0 for a planar or degenerate quadrilateral.
528
+ */
529
+ function bend(p: Vec3, q: Vec3, r: Vec3, s: Vec3): number {
530
+ const minus = (x: Vec3, y: Vec3): Vec3 => [x[0] - y[0], x[1] - y[1], x[2] - y[2]];
531
+ const n1: Vec3 = cross(minus(q, p), minus(r, p));
532
+ const n2: Vec3 = cross(minus(r, p), minus(s, p));
533
+ const l1: number = norm(n1);
534
+ const l2: number = norm(n2);
535
+ if (!(l1 > 0 && l2 > 0)) return 0;
536
+ const cosine: number = (n1[0] * n2[0] + n1[1] * n2[1] + n1[2] * n2[2]) / (l1 * l2);
537
+ return Math.acos(Math.max(-1, Math.min(1, cosine)));
538
+ }
539
+
377
540
  /** Copy one coherent reading before a subsequent source call can reuse its storage. */
378
541
  function copy(
379
542
  jet: IAutoMovieSolidSurface.IJet,
@@ -402,10 +565,11 @@ function copy(
402
565
  };
403
566
  }
404
567
 
405
- /** True cuts retain their conservative bound; exactly consumed domain sides do not discard a source grid cell. */
568
+ /** True cuts retain their conservative bound; exactly consumed domain sides do not discard a source grid cell. `candidates` are the indices of the barriers whose station range meets the cell's, in increasing order. */
406
569
  function touches(
407
570
  chart: ReadonlyMap<number, Point>,
408
571
  trim: readonly AutoMovieSolidMeshConstraints.ISegment[],
572
+ candidates: readonly number[],
409
573
  u0: number,
410
574
  u1: number,
411
575
  v0: number,
@@ -413,7 +577,8 @@ function touches(
413
577
  period: number | undefined,
414
578
  domainFrom: number,
415
579
  ): boolean | string {
416
- for (const [index, edge] of trim.entries()) {
580
+ for (const index of candidates) {
581
+ const edge: AutoMovieSolidMeshConstraints.ISegment = trim[index]!;
417
582
  const a: Point = chart.get(edge.a)!;
418
583
  const b: Point = chart.get(edge.b)!;
419
584
  if (Math.max(a[0], b[0]) < u0 || Math.min(a[0], b[0]) > u1) continue;
@@ -8,6 +8,7 @@ export * from "./AutoMovieConicHermiteField";
8
8
  export * from "./AutoMovieConicPreparation";
9
9
  export * from "./AutoMovieConstructionAdmission";
10
10
  export * from "./AutoMovieConstructionBoundary";
11
+ export * from "./AutoMovieConstructionBridgeRealize";
11
12
  export * from "./AutoMovieConstructionContinuation";
12
13
  export * from "./AutoMovieConstructionContinuationRealize";
13
14
  export * from "./AutoMovieConstructionKnownPort";
@@ -113,6 +114,7 @@ export * from "./AutoMovieViewSectionConic";
113
114
  export * from "./AutoMovieViewSectionField";
114
115
  export * from "./AutoMovieViewSectionRange";
115
116
  export * from "./AutoMovieViewSectionReading";
117
+ export * from "./IAutoMovieConstructionCurve";
116
118
  export * from "./IAutoMovieConstructionKnownPortSource";
117
119
  export * from "./IAutoMovieConstructionProfileSource";
118
120
  export * from "./IAutoMovieLoftChain";
@@ -123,10 +125,12 @@ export * from "./IAutoMovieViewPart";
123
125
  export * from "./distanceAutoMovieViewOutline";
124
126
  export * from "./domainAutoMovieSolidMesh";
125
127
  export * from "./faceAutoMovieSolidMesh";
128
+ export * from "./fairAutoMovieSolidMesh";
126
129
  export * from "./gridAutoMovieSolidMesh";
127
130
  export * from "./incircleAutoMovieSolidChart";
128
131
  export * from "./insertAutoMovieSolidMeshPoints";
129
132
  export * from "./legalizeAutoMovieSolidMesh";
133
+ export * from "./markAutoMovieConstructionCurves";
130
134
  export * from "./openAutoMovieSolidMesh";
131
135
  export * from "./orientAutoMovieSolidChart";
132
136
  export * from "./probeAutoMovieSolidMesh";
@@ -134,6 +138,7 @@ export * from "./realizeAutoMovieConstruction";
134
138
  export * from "./rollAutoMovieViewAxis";
135
139
  export * from "./rootsAutoMovieViewPolynomial";
136
140
  export * from "./rootsAutoMovieViewSinPolynomial";
141
+ export * from "./sampleAutoMovieConstructionCurves";
137
142
  export * from "./supportAutoMovieViewOutline";
138
143
  export * from "./triangulateAutoMovieSolidBoundary";
139
144
  export * from "./witnessAutoMovieSolidChartTriangle";
@@ -40,6 +40,18 @@ interface Side {
40
40
  * occur for `n` vertices (Edelsbrunner 2001, Geometry and Topology for Mesh
41
41
  * Generation); a longer run is a named failure.
42
42
  *
43
+ * A face whose metric changes across it is legalized in its local first
44
+ * fundamental form instead (`local`): each quadrilateral is read about its own
45
+ * centroid under the form its four points span, shear included, the anisotropic Delaunay
46
+ * criterion of the same authors with the metric frozen per test. A face's
47
+ * mean scale left the trunk's triangles beside the armscye's loop, where the
48
+ * skin spans twice the mean per radian, 4 to 7 degrees thin on the skin; read
49
+ * without the shear, a twisted band took the longer diagonal of its quads. A
50
+ * flip and its reverse read one quadrilateral and so one form, so no pair of
51
+ * flips undoes itself; the
52
+ * lifting argument no longer bounds longer cycles, and the same flip count
53
+ * stays the named failure.
54
+ *
43
55
  * Every source constraint (trim, domain and retained-cell boundaries) is
44
56
  * fixed, so the rails, their vertices and the seam they share with another
45
57
  * face are unchanged. A flip is admitted only when both new triangles keep the
@@ -58,6 +70,7 @@ interface Side {
58
70
  * @param indexed Whether the consumer drops lifts into a global index buffer, which forbids a half-period span.
59
71
  * @param occupied Prior global endpoint pairs `minID/maxID` a new diagonal cannot reuse.
60
72
  * @param scale Phase scale of the uniform metric, positive and finite, in length units per radian.
73
+ * @param local A quadrilateral's own first fundamental form from its four vertex IDs and their chart points in its cover, as `[shear, scale]` for the map `(u, v) -> (u + shear v, scale v)`, read in place of `scale`, so the face is Delaunay in the metric each quadrilateral spans; absent, `scale` holds everywhere with no shear. A flip and its reverse read the same four points and so the same form.
61
74
  * @returns New positive triangle occurrences over the same region and vertices, or the broken premise.
62
75
  *
63
76
  * @evidence contracts/development/implementation.md#principled-implementation Lawson's flip algorithm reaches the constrained Delaunay triangulation by exact lifted in-circle and orientation signs on one scaled chart that carries the length unit; the planner's own representability rules admit each flip.
@@ -76,6 +89,7 @@ export function legalizeAutoMovieSolidMesh(
76
89
  indexed: boolean,
77
90
  occupied: ReadonlySet<string> | undefined,
78
91
  scale: number,
92
+ local?: (ids: readonly number[], charts: readonly [number, number][]) => [number, number],
79
93
  ): AutoMovieSolidMeshPlan.ITriangle[] | string {
80
94
  if (!(Number.isFinite(scale) && scale > 0))
81
95
  return "legalization metric scale must be positive and finite";
@@ -175,6 +189,7 @@ export function legalizeAutoMovieSolidMesh(
175
189
  period,
176
190
  indexed,
177
191
  scale,
192
+ local,
178
193
  );
179
194
  if (made === null) continue;
180
195
  const apart: string = pair(made[0].vertices[1], made[0].vertices[2]);
@@ -214,7 +229,8 @@ function flip(
214
229
  two: Side,
215
230
  period: number | undefined,
216
231
  indexed: boolean,
217
- scale: number,
232
+ uniform: number,
233
+ local: ((ids: readonly number[], charts: readonly [number, number][]) => [number, number]) | undefined,
218
234
  ): [AutoMovieSolidMeshPlan.ITriangle, AutoMovieSolidMeshPlan.ITriangle] | null {
219
235
  const t1: AutoMovieSolidMeshPlan.ITriangle = triangles[one.triangle]!;
220
236
  const t2: AutoMovieSolidMeshPlan.ITriangle = triangles[two.triangle]!;
@@ -244,8 +260,18 @@ function flip(
244
260
  });
245
261
  if (!points.every((point: Point): boolean => point.every(Number.isFinite)))
246
262
  return null;
263
+ // The quadrilateral read about its own centroid under the metric there: the uniform phase scale, or the local form's shear and scale.
264
+ const cu: number = (points[0]![0] + points[1]![0] + points[2]![0] + points[3]![0]) / 4;
265
+ const cv: number = (points[0]![1] + points[1]![1] + points[2]![1] + points[3]![1]) / 4;
266
+ const [shear, scale]: [number, number] =
267
+ local === undefined ? [0, uniform] : local(ids, points as [number, number][]);
268
+ if (!(Number.isFinite(shear) && Number.isFinite(scale) && scale > 0))
269
+ return null;
247
270
  const scaled: Point[] = points.map(
248
- (point: Point): Point => [point[0], point[1] * scale],
271
+ (point: Point): Point => [
272
+ point[0] - cu + shear * (point[1] - cv),
273
+ (point[1] - cv) * scale,
274
+ ],
249
275
  );
250
276
  if (!scaled.every((point: Point): boolean => point.every(Number.isFinite)))
251
277
  return null;
@@ -0,0 +1,58 @@
1
+ import type { IAutoMovieMark } from "../IAutoMovieMark";
2
+ import type { IAutoMovieConstructionCurve } from "./IAutoMovieConstructionCurve";
3
+
4
+ /**
5
+ * Turn the construction curves of one built form into inspection marks that follow the scene object the form was built into.
6
+ *
7
+ * Each curve becomes one polyline mark, closed for a section ring, of kind `curve/section`, `curve/guide` or `curve/axis`. Its path is `anchor` followed by the curve's `id`, such as `hero/torso/section/3`, so a pattern that selects the form's object selects its curves, and one pattern can name one ring. The curve's points are the form at rest in the object's local frame, which is why the object is the anchor. A curve the sampler flagged stays flagged.
8
+ *
9
+ * | Kind | Label | Colour |
10
+ * | --- | --- | --- |
11
+ * | `curve/section` | `section curve` | Blue `59a0f4` |
12
+ * | `curve/guide` | `guide curve` | Green `59cb89` |
13
+ * | `curve/axis` | `axis curve` | Cyan `00e5ff` |
14
+ *
15
+ * ```ts
16
+ * const marks = markAutoMovieConstructionCurves(
17
+ * sampleAutoMovieConstructionCurves(realization),
18
+ * "hero",
19
+ * );
20
+ * ```
21
+ *
22
+ * @param curves The curves of one form, as `sampleAutoMovieConstructionCurves` returns them.
23
+ * @param anchor Path of the scene object the form was built into, or the empty string for the scene root.
24
+ * @returns One mark per curve, in the curves' order.
25
+ *
26
+ * @evidence contracts/development/common.md#meaningful-documentation States what each curve becomes, the kind, path, frame and flag rules, tabulates each kind's label and colour, and shows the call beside the sampler.
27
+ * @evidence contracts/development/implementation.md#principled-implementation The sampler reads a realization in its object's frame at rest, so each curve keeps its points untouched and names that object as its anchor; the curve's id already carries its part and ordinal, so the path is the anchor's path followed by the id.
28
+ * @evidence contracts/development/implementation.md#clear-and-simple-structure One map over the curves with one fixed table of the three kinds' legend entries.
29
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts The colours are the hues the inspection has always drawn these kinds in, one per kind so none can be mistaken for another, and no part or chain name is read.
30
+ * @evidence contracts/development/implementation.md#efficient-algorithms Linear in the curves; each mark shares its curve's point array instead of copying it.
31
+ * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work A pure conversion of its arguments that coordinates nothing across calls.
32
+ * @evidence contracts/development/implementation.md#bound-retention-and-release-resources The marks borrow the curves' point arrays, so a caller that changes a curve changes its mark; nothing else is kept.
33
+ */
34
+ export function markAutoMovieConstructionCurves(
35
+ curves: readonly IAutoMovieConstructionCurve[],
36
+ anchor: string,
37
+ ): IAutoMovieMark[] {
38
+ return curves.map(
39
+ (curve: IAutoMovieConstructionCurve): IAutoMovieMark => ({
40
+ path: anchor === "" ? curve.id : `${anchor}/${curve.id}`,
41
+ kind: `curve/${curve.kind}`,
42
+ label: LEGEND[curve.kind].label,
43
+ color: LEGEND[curve.kind].color,
44
+ shape: { type: "polyline", points: curve.points, closed: curve.closed },
45
+ flagged: curve.flagged,
46
+ anchor,
47
+ }),
48
+ );
49
+ }
50
+
51
+ /** Legend text and colour of each curve kind, keyed so the compiler refuses a kind without one. */
52
+ const LEGEND: Readonly<
53
+ Record<IAutoMovieConstructionCurve.Kind, { label: string; color: number }>
54
+ > = {
55
+ section: { label: "section curve", color: 0x59a0f4 },
56
+ guide: { label: "guide curve", color: 0x59cb89 },
57
+ axis: { label: "axis curve", color: 0x00e5ff },
58
+ };
@@ -29,7 +29,7 @@ interface Dyadic {
29
29
  * @evidence contracts/development/implementation.md#clear-and-simple-structure One sign predicate owns the arithmetic used by native-chart boundary splitting; dyadic decoding stays private.
30
30
  * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts No tolerance classifies nearby distinct points as equal, and this predicate neither moves coordinates nor merges vertex identities. Exact predicates do not certify a separately rounded intersection construction.
31
31
  * @evidence contracts/development/common.md#meaningful-documentation States input finiteness, represented-number semantics, sign convention, exact fallback and invalid-input failure.
32
- * @evidence contracts/development/implementation.md#efficient-algorithms Ordinary separated determinants use constant floating arithmetic. Ambiguous cases decode six doubles and use bounded-size integer shifts/products; binary64 exponent range bounds those integers independently of face population.
32
+ * @evidence contracts/development/implementation.md#efficient-algorithms Ordinary separated determinants use constant floating arithmetic, and so does a triple in which a point shares a coordinate with the third, whose sign is one product's read from signs; such triples are the common case on a grid and took the integer path before. Remaining ambiguous cases decode six doubles and use bounded-size integer shifts/products; binary64 exponent range bounds those integers independently of face population.
33
33
  * @evidenceExclude contracts/development/implementation.md#reuse-equivalent-work This pure predicate coordinates no source evaluations or requests and caches no geometry.
34
34
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources One synchronous module-local eight-byte decoding view is retained; integer/tuple scratch is call-local and no input reference survives.
35
35
  */
@@ -44,7 +44,16 @@ export function orientAutoMovieSolidChart(
44
44
  const by: number = b[1];
45
45
  const cx: number = c[0];
46
46
  const cy: number = c[1];
47
- if (![ax, ay, bx, by, cx, cy].every(Number.isFinite))
47
+ if (
48
+ !(
49
+ Number.isFinite(ax) &&
50
+ Number.isFinite(ay) &&
51
+ Number.isFinite(bx) &&
52
+ Number.isFinite(by) &&
53
+ Number.isFinite(cx) &&
54
+ Number.isFinite(cy)
55
+ )
56
+ )
48
57
  throw new RangeError("Chart orientation needs finite coordinates");
49
58
 
50
59
  // Axis-aligned constraints need only order comparisons, even at extreme scales.
@@ -56,18 +65,29 @@ export function orientAutoMovieSolidChart(
56
65
  const y0: number = ay - cy;
57
66
  const x1: number = bx - cx;
58
67
  const y1: number = by - cy;
68
+
69
+ // A point that shares a coordinate with `c` makes one product of the
70
+ // determinant exactly zero: a difference of two finite doubles is zero only
71
+ // when they are equal, and otherwise carries its true sign even when it
72
+ // rounds, underflows to a subnormal or overflows. The determinant's sign is
73
+ // then the other product's, read from signs alone. Points of one grid share
74
+ // coordinates all the time, and without this they all took the integer path.
75
+ if (x0 === 0 || y1 === 0) return 0 - Math.sign(y0) * Math.sign(x1);
76
+ if (y0 === 0 || x1 === 0) return 0 + Math.sign(x0) * Math.sign(y1);
59
77
  const left: number = x0 * y1;
60
78
  const right: number = y0 * x1;
61
79
  const determinant: number = left - right;
62
80
  const bound: number = 8 * Number.EPSILON * (Math.abs(left) + Math.abs(right));
63
81
 
64
82
  // The filter's relative-error premise excludes subnormal intermediates.
65
- // Zero products take the exact path too, rather than hiding underflow.
83
+ // Underflowed products take the exact path too, rather than hiding underflow.
66
84
  if (
67
- [x0, y0, x1, y1, left, right].every(
68
- (value: number): boolean =>
69
- Number.isFinite(value) && Math.abs(value) >= NORMAL,
70
- ) &&
85
+ normal(x0) &&
86
+ normal(y0) &&
87
+ normal(x1) &&
88
+ normal(y1) &&
89
+ normal(left) &&
90
+ normal(right) &&
71
91
  Number.isFinite(determinant) &&
72
92
  Number.isFinite(bound) &&
73
93
  bound > 0 &&
@@ -93,6 +113,11 @@ export function orientAutoMovieSolidChart(
93
113
  return exact > 0n ? 1 : exact < 0n ? -1 : 0;
94
114
  }
95
115
 
116
+ /** Whether a value is finite and of at least the smallest normal magnitude. */
117
+ function normal(value: number): boolean {
118
+ return Number.isFinite(value) && Math.abs(value) >= NORMAL;
119
+ }
120
+
96
121
  /** Decode a finite double without arithmetic on its significand. Calls are synchronous and have no callbacks. */
97
122
  function decode(value: number): Dyadic {
98
123
  VIEW.setFloat64(0, value, false);
@@ -9,12 +9,18 @@ type Point = readonly [number, number];
9
9
  /**
10
10
  * Select a represented left-side probe with an independently checked corridor.
11
11
  *
12
- * @evidence contracts/development/implementation.md#principled-implementation Floating edge clearance proposes a nearby point; exact represented-point orientation and the empty-triangle witness verify connection to the requested boundary side before membership is read.
12
+ * A boundary walk is one face cycle: the face lies on the left of every one of its edges, so a probe witnessed beside any edge reads that
13
+ * face's membership. The edges are tried in walk order and the first witnessed corridor is returned. Reading the first edge alone failed
14
+ * where a curve met a straight constraint at a grazing angle: the curve's last vertex stood 1e-14 off the line, a few units of the last
15
+ * place at the chart's scale, so its short edge to the line had no represented corridor on either side, though the face beside every other
16
+ * edge of the same walk was wide.
17
+ *
18
+ * @evidence contracts/development/implementation.md#principled-implementation Floating edge clearance proposes a nearby point; exact represented-point orientation and the empty-triangle witness verify connection to the requested boundary side before membership is read. Any edge of a face cycle bounds the same face, so trying the next edge does not change which face is read.
13
19
  * @evidence contracts/development/implementation.md#clear-and-simple-structure Probe construction is one responsibility shared by component classification; the witness owns exact partition checks and Plan owns membership.
14
- * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Does not call approximate distance an exact bound. At most 64 smaller proposals are attempted; unrepresentable clearance or exhausted local search returns an explicit failure, not an empty region.
15
- * @evidence contracts/development/common.md#meaningful-documentation States represented-number corridor meaning, one-period primitive premise and finite search/precision failure.
16
- * @evidence contracts/development/implementation.md#efficient-algorithms Scans S segments for a proposal and at most 64 witnesses with O(V+S) exact-predicate work each; no source callback is evaluated here.
17
- * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares original indexed endpoints, one edge length and the proposed clearance across attempts; source membership remains with Plan.
20
+ * @evidence contracts/development/implementation.md#prohibited-implementation-shortcuts Does not call approximate distance an exact bound. At most 64 smaller proposals are attempted per edge; unrepresentable cover arithmetic returns an explicit failure, and a walk none of whose edges admits a corridor returns the named failure, not an empty region.
21
+ * @evidence contracts/development/common.md#meaningful-documentation States represented-number corridor meaning, face-cycle premise, one-period primitive premise and finite search/precision failure.
22
+ * @evidence contracts/development/implementation.md#efficient-algorithms Scans S segments for a proposal and at most 64 witnesses with O(V+S) exact-predicate work each, per edge tried; the first edge serves every walk that is not degenerate there.
23
+ * @evidence contracts/development/implementation.md#reuse-equivalent-work Shares original indexed endpoints, one edge length and the proposed clearance across attempts on one edge; source membership remains with Plan.
18
24
  * @evidence contracts/development/implementation.md#bound-retention-and-release-resources Probe, local image arrays and witness scratch expire on return; no source map, callback or cache is retained.
19
25
  */
20
26
  export function probeAutoMovieSolidMesh(
@@ -23,37 +29,57 @@ export function probeAutoMovieSolidMesh(
23
29
  walk: AutoMovieSolidMeshIncidence.IWalk,
24
30
  period: number | undefined,
25
31
  ): Point | string {
26
- if (walk.vertices.length === 0)
27
- return "visibility has an empty boundary walk";
28
- const target: number =
29
- walk.vertices.length > 1 ? walk.vertices[1]! : walk.vertices[0]!;
30
- const first: Point = vertices.get(walk.vertices[0]!)!;
31
- const stored: Point = vertices.get(target)!;
32
- const turn: number = walk.lifts[1] ?? walk.winding;
33
- const end: Point = [stored[0], stored[1] + turn * (period ?? 0)];
32
+ const count: number = walk.vertices.length;
33
+ if (count === 0) return "visibility has an empty boundary walk";
34
+ for (let k: number = 0; k < count; k++) {
35
+ // Edge k from the walk's k-th vertex to the next, read in the cover image where the k-th vertex is unlifted.
36
+ const next: number = (k + 1) % count;
37
+ const turn: number =
38
+ (next === 0 ? walk.winding : walk.lifts[next]!) - walk.lifts[k]!;
39
+ const found: Point | string | null = corridor(
40
+ vertices,
41
+ edges,
42
+ { a: walk.vertices[k]!, b: walk.vertices[next]!, turn },
43
+ period,
44
+ );
45
+ if (typeof found === "string") return found;
46
+ if (found !== null)
47
+ return k === 0 || walk.lifts[k] === 0
48
+ ? found
49
+ : [found[0], found[1] + walk.lifts[k]! * (period ?? 0)];
50
+ }
51
+ return "visibility left-side probe has no admitted represented corridor";
52
+ }
53
+
54
+ /** A witnessed probe on the left of one boundary edge, null when that edge admits no represented corridor, or a named arithmetic failure. */
55
+ function corridor(
56
+ vertices: ReadonlyMap<number, Point>,
57
+ edges: readonly AutoMovieSolidMeshConstraints.ISegment[],
58
+ edge: AutoMovieSolidMeshConstraints.ISegment,
59
+ period: number | undefined,
60
+ ): Point | string | null {
61
+ const first: Point = vertices.get(edge.a)!;
62
+ const stored: Point = vertices.get(edge.b)!;
63
+ const end: Point = [stored[0], stored[1] + edge.turn * (period ?? 0)];
34
64
  const middle: Point = midpoint(first, end);
35
65
  const dx: number = end[0] - first[0];
36
66
  const dy: number = end[1] - first[1];
37
67
  const length: number = Math.hypot(dx, dy);
38
68
  let clearance: number = length / 2;
39
- const own: string = key({
40
- a: walk.vertices[0]!,
41
- b: target,
42
- turn,
43
- });
44
- for (const edge of edges) {
45
- const a: Point = vertices.get(edge.a)!;
46
- const b: Point = vertices.get(edge.b)!;
69
+ const own: string = key(edge);
70
+ for (const other of edges) {
71
+ const a: Point = vertices.get(other.a)!;
72
+ const b: Point = vertices.get(other.b)!;
47
73
  const shifts: number[] | null = images(a[1], first, end, period);
48
74
  if (shifts === null)
49
75
  return "visibility probe cover image is not representable";
50
76
  for (const image of shifts) {
51
77
  const c: Point = [a[0], a[1] + image * (period ?? 0)];
52
- const d: Point = [b[0], b[1] + (image + edge.turn) * (period ?? 0)];
78
+ const d: Point = [b[0], b[1] + (image + other.turn) * (period ?? 0)];
53
79
  if (![...c, ...d].every(Number.isFinite))
54
80
  return "visibility probe cover coordinates are not representable";
55
81
  if (
56
- key(edge) === own &&
82
+ key(other) === own &&
57
83
  ((c[0] === first[0] &&
58
84
  c[1] === first[1] &&
59
85
  d[0] === end[0] &&
@@ -67,6 +93,7 @@ export function probeAutoMovieSolidMesh(
67
93
  clearance = Math.min(clearance, distance(middle, c, d));
68
94
  }
69
95
  }
96
+ // Another constraint through this edge's midpoint, or an edge too short to measure, leaves this edge no corridor.
70
97
  if (
71
98
  !(
72
99
  Number.isFinite(clearance) &&
@@ -75,12 +102,7 @@ export function probeAutoMovieSolidMesh(
75
102
  length > 0
76
103
  )
77
104
  )
78
- return "visibility boundary clearance is not representable";
79
- const edge: AutoMovieSolidMeshConstraints.ISegment = {
80
- a: walk.vertices[0]!,
81
- b: target,
82
- turn,
83
- };
105
+ return null;
84
106
  for (let attempt: number = 0; attempt < 64; attempt++) {
85
107
  const step: number = clearance / 4;
86
108
  const probe: Point = [
@@ -103,7 +125,7 @@ export function probeAutoMovieSolidMesh(
103
125
  }
104
126
  clearance /= 2;
105
127
  }
106
- return "visibility left-side probe has no admitted represented corridor";
128
+ return null;
107
129
  }
108
130
 
109
131
  /** Floating distance proposes a probe only; witness checks decide the represented corridor. */