laymur 0.17.0 → 0.17.2

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 (396) hide show
  1. package/README.md +5 -0
  2. package/{src/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.ts → dist/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts} +2 -3
  3. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +22 -0
  4. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.js +41 -0
  5. package/dist/core/constraints/UIConstraint.d.ts +12 -0
  6. package/dist/core/constraints/UIConstraint.js +11 -0
  7. package/dist/core/constraints/UICustomConstraint.d.ts +28 -0
  8. package/dist/core/constraints/UICustomConstraint.js +37 -0
  9. package/{src/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.ts → dist/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts} +2 -3
  10. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +20 -0
  11. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.js +34 -0
  12. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +11 -0
  13. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.js +3 -0
  14. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +36 -0
  15. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.js +100 -0
  16. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +14 -0
  17. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.js +4 -0
  18. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +44 -0
  19. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.js +136 -0
  20. package/{src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.ts → dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts} +2 -3
  21. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +22 -0
  22. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.js +40 -0
  23. package/{src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.ts → dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts} +8 -9
  24. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +43 -0
  25. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.js +71 -0
  26. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +11 -0
  27. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.js +3 -0
  28. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +32 -0
  29. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.js +100 -0
  30. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +14 -0
  31. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.js +4 -0
  32. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +44 -0
  33. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.js +136 -0
  34. package/{src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.ts → dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts} +2 -3
  35. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +22 -0
  36. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.js +40 -0
  37. package/{src/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.ts → dist/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts} +2 -3
  38. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +20 -0
  39. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.js +34 -0
  40. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +64 -0
  41. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.js +19 -0
  42. package/dist/core/constraints/builders/UIConstraint2DBuilder.d.ts +46 -0
  43. package/dist/core/constraints/builders/UIConstraint2DBuilder.js +138 -0
  44. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +13 -0
  45. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.js +3 -0
  46. package/dist/core/constraints/builders/UICoverConstraintBuilder.d.ts +29 -0
  47. package/dist/core/constraints/builders/UICoverConstraintBuilder.js +63 -0
  48. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +13 -0
  49. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.js +3 -0
  50. package/dist/core/constraints/builders/UIFitConstraintBuilder.d.ts +29 -0
  51. package/dist/core/constraints/builders/UIFitConstraintBuilder.js +63 -0
  52. package/dist/core/elements/UIAnchor/UIAnchor.Internal.d.ts +12 -0
  53. package/dist/core/elements/UIAnchor/UIAnchor.Internal.js +5 -0
  54. package/dist/core/elements/UIAnchor/UIAnchor.d.ts +32 -0
  55. package/dist/core/elements/UIAnchor/UIAnchor.js +49 -0
  56. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +27 -0
  57. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.js +15 -0
  58. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.d.ts +77 -0
  59. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.js +259 -0
  60. package/dist/core/elements/UIDummy/UIDummy.Internal.d.ts +30 -0
  61. package/dist/core/elements/UIDummy/UIDummy.Internal.js +8 -0
  62. package/dist/core/elements/UIDummy/UIDummy.d.ts +82 -0
  63. package/dist/core/elements/UIDummy/UIDummy.js +173 -0
  64. package/{src/core/elements/UIElement/UIElement.Internal.ts → dist/core/elements/UIElement/UIElement.Internal.d.ts} +5 -7
  65. package/dist/core/elements/UIElement/UIElement.Internal.js +5 -0
  66. package/dist/core/elements/UIElement/UIElement.d.ts +38 -0
  67. package/dist/core/elements/UIElement/UIElement.js +74 -0
  68. package/{src/core/elements/UIGraphics/UIGraphics.Internal.ts → dist/core/elements/UIGraphics/UIGraphics.Internal.d.ts} +5 -7
  69. package/dist/core/elements/UIGraphics/UIGraphics.Internal.js +7 -0
  70. package/dist/core/elements/UIGraphics/UIGraphics.d.ts +51 -0
  71. package/dist/core/elements/UIGraphics/UIGraphics.js +126 -0
  72. package/{src/core/elements/UIImage/UIImage.Internal.ts → dist/core/elements/UIImage/UIImage.Internal.d.ts} +2 -3
  73. package/dist/core/elements/UIImage/UIImage.d.ts +32 -0
  74. package/dist/core/elements/UIImage/UIImage.js +85 -0
  75. package/dist/core/elements/UINineSlice/UINineSlice.Internal.d.ts +23 -0
  76. package/dist/core/elements/UINineSlice/UINineSlice.Internal.js +12 -0
  77. package/dist/core/elements/UINineSlice/UINineSlice.d.ts +60 -0
  78. package/dist/core/elements/UINineSlice/UINineSlice.js +188 -0
  79. package/dist/core/elements/UIProgress/UIProgress.Internal.d.ts +14 -0
  80. package/dist/core/elements/UIProgress/UIProgress.Internal.js +3 -0
  81. package/dist/core/elements/UIProgress/UIProgress.d.ts +45 -0
  82. package/dist/core/elements/UIProgress/UIProgress.js +165 -0
  83. package/dist/core/elements/UIScene/UIScene.Internal.d.ts +43 -0
  84. package/dist/core/elements/UIScene/UIScene.Internal.js +27 -0
  85. package/dist/core/elements/UIScene/UIScene.d.ts +59 -0
  86. package/dist/core/elements/UIScene/UIScene.js +157 -0
  87. package/{src/core/elements/UIText/UIText.Interfaces.ts → dist/core/elements/UIText/UIText.Interfaces.d.ts} +16 -21
  88. package/dist/core/elements/UIText/UIText.Internal.d.ts +26 -0
  89. package/dist/core/elements/UIText/UIText.Internal.js +12 -0
  90. package/dist/core/elements/UIText/UIText.Measuring.d.ts +50 -0
  91. package/dist/core/elements/UIText/UIText.Measuring.js +153 -0
  92. package/dist/core/elements/UIText/UIText.Rendering.d.ts +20 -0
  93. package/dist/core/elements/UIText/UIText.Rendering.js +61 -0
  94. package/dist/core/elements/UIText/UIText.d.ts +71 -0
  95. package/dist/core/elements/UIText/UIText.js +265 -0
  96. package/{src/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.ts → dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts} +11 -14
  97. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.js +5 -0
  98. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +63 -0
  99. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.js +147 -0
  100. package/{src/core/layers/UILayer/UILayer.Internal.ts → dist/core/layers/UILayer/UILayer.Internal.d.ts} +11 -15
  101. package/dist/core/layers/UILayer/UILayer.Internal.js +7 -0
  102. package/dist/core/layers/UILayer/UILayer.d.ts +49 -0
  103. package/dist/core/layers/UILayer/UILayer.js +113 -0
  104. package/dist/core/miscellaneous/UIExpression.d.ts +69 -0
  105. package/dist/core/miscellaneous/UIExpression.js +128 -0
  106. package/dist/core/miscellaneous/UIMode.d.ts +23 -0
  107. package/dist/core/miscellaneous/UIMode.js +30 -0
  108. package/dist/core/miscellaneous/UIOrientation.d.ts +15 -0
  109. package/dist/core/miscellaneous/UIOrientation.js +20 -0
  110. package/dist/core/miscellaneous/UIPriority.d.ts +32 -0
  111. package/dist/core/miscellaneous/UIPriority.js +63 -0
  112. package/dist/core/miscellaneous/UIRelation.d.ts +23 -0
  113. package/dist/core/miscellaneous/UIRelation.js +40 -0
  114. package/dist/core/miscellaneous/UITransparencyMode.d.ts +9 -0
  115. package/dist/core/miscellaneous/UITransparencyMode.js +12 -0
  116. package/dist/core/miscellaneous/area/UIArea.d.ts +3 -0
  117. package/dist/core/miscellaneous/area/UIArea.js +5 -0
  118. package/dist/core/miscellaneous/area/UIAreaCircle.d.ts +15 -0
  119. package/dist/core/miscellaneous/area/UIAreaCircle.js +32 -0
  120. package/dist/core/miscellaneous/area/UIAreaPolygon.d.ts +12 -0
  121. package/dist/core/miscellaneous/area/UIAreaPolygon.js +40 -0
  122. package/dist/core/miscellaneous/area/UIAreaRectangle.d.ts +17 -0
  123. package/dist/core/miscellaneous/area/UIAreaRectangle.js +36 -0
  124. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.d.ts +21 -0
  125. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.js +72 -0
  126. package/dist/core/miscellaneous/asserts.d.ts +43 -0
  127. package/dist/core/miscellaneous/asserts.js +163 -0
  128. package/dist/core/miscellaneous/canvas.d.ts +31 -0
  129. package/dist/core/miscellaneous/canvas.js +37 -0
  130. package/dist/core/miscellaneous/color/UIColor.Internal.d.ts +7 -0
  131. package/dist/core/miscellaneous/color/UIColor.Internal.js +42 -0
  132. package/dist/core/miscellaneous/color/UIColor.d.ts +234 -0
  133. package/dist/core/miscellaneous/color/UIColor.js +636 -0
  134. package/dist/core/miscellaneous/computeTransform.d.ts +18 -0
  135. package/dist/core/miscellaneous/computeTransform.js +82 -0
  136. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +19 -0
  137. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.js +168 -0
  138. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.d.ts +1 -0
  139. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.js +349 -0
  140. package/{src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.ts → dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts} +8 -10
  141. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.d.ts +1 -0
  142. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.js +357 -0
  143. package/dist/core/miscellaneous/generic-plane/shared.d.ts +38 -0
  144. package/dist/core/miscellaneous/generic-plane/shared.js +228 -0
  145. package/dist/core/miscellaneous/insets/UIInsets.Internal.d.ts +11 -0
  146. package/dist/core/miscellaneous/insets/UIInsets.Internal.js +3 -0
  147. package/dist/core/miscellaneous/insets/UIInsets.d.ts +48 -0
  148. package/dist/core/miscellaneous/insets/UIInsets.js +224 -0
  149. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunction.d.ts +9 -0
  150. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunction.js +19 -0
  151. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +21 -0
  152. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.js +51 -0
  153. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +16 -0
  154. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.js +48 -0
  155. package/dist/core/miscellaneous/math.d.ts +7 -0
  156. package/dist/core/miscellaneous/math.js +11 -0
  157. package/dist/core/miscellaneous/micro/UIMicro.Internal.d.ts +31 -0
  158. package/dist/core/miscellaneous/micro/UIMicro.Internal.js +15 -0
  159. package/dist/core/miscellaneous/micro/UIMicro.d.ts +59 -0
  160. package/dist/core/miscellaneous/micro/UIMicro.js +181 -0
  161. package/dist/core/miscellaneous/resize-policy/UIResizePolicy.d.ts +3 -0
  162. package/dist/core/miscellaneous/resize-policy/UIResizePolicy.js +9 -0
  163. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +22 -0
  164. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.js +50 -0
  165. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +22 -0
  166. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.js +52 -0
  167. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +22 -0
  168. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.js +52 -0
  169. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +22 -0
  170. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.js +50 -0
  171. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +22 -0
  172. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.js +52 -0
  173. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +22 -0
  174. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.js +52 -0
  175. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +5 -0
  176. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.js +13 -0
  177. package/dist/core/miscellaneous/shared.d.ts +46 -0
  178. package/dist/core/miscellaneous/shared.js +37 -0
  179. package/{src/core/miscellaneous/text-span/UITextSpan.Internal.ts → dist/core/miscellaneous/text-span/UITextSpan.Internal.d.ts} +4 -5
  180. package/dist/core/miscellaneous/text-span/UITextSpan.d.ts +14 -0
  181. package/dist/core/miscellaneous/text-span/UITextSpan.js +36 -0
  182. package/dist/core/miscellaneous/text-style/UITextStyle.Internal.d.ts +48 -0
  183. package/dist/core/miscellaneous/text-style/UITextStyle.Internal.js +17 -0
  184. package/dist/core/miscellaneous/text-style/UITextStyle.d.ts +85 -0
  185. package/dist/core/miscellaneous/text-style/UITextStyle.js +372 -0
  186. package/dist/core/miscellaneous/texture/UITextureView.Internal.d.ts +49 -0
  187. package/dist/core/miscellaneous/texture/UITextureView.Internal.js +6 -0
  188. package/dist/core/miscellaneous/texture/UITextureView.d.ts +67 -0
  189. package/dist/core/miscellaneous/texture/UITextureView.js +234 -0
  190. package/dist/core/miscellaneous/webglCapabilities.d.ts +2 -0
  191. package/dist/core/miscellaneous/webglCapabilities.js +103 -0
  192. package/dist/core/shaders/UIImage.glsl.js +3 -0
  193. package/dist/core/shaders/UINineSlice.glsl.js +3 -0
  194. package/dist/core/shaders/UIProgress.glsl.js +3 -0
  195. package/dist/core/shaders/UIProgressMaskFunctionCircular.glsl.js +3 -0
  196. package/dist/core/shaders/UIProgressMaskFunctionDirectional.glsl.js +3 -0
  197. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +17 -0
  198. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.d.ts +13 -0
  199. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.js +108 -0
  200. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +13 -0
  201. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.d.ts +20 -0
  202. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.js +75 -0
  203. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +49 -0
  204. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.d.ts +215 -0
  205. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.js +505 -0
  206. package/dist/index.js +51 -0
  207. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.d.ts +21 -0
  208. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.js +47 -0
  209. package/dist/particles/behaviorModules/UIBehaviorModule.d.ts +14 -0
  210. package/dist/particles/behaviorModules/UIBehaviorModule.js +9 -0
  211. package/dist/particles/behaviorModules/UIBehaviorPointGravity.d.ts +39 -0
  212. package/dist/particles/behaviorModules/UIBehaviorPointGravity.js +110 -0
  213. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.d.ts +22 -0
  214. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.js +66 -0
  215. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.d.ts +20 -0
  216. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.js +48 -0
  217. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.d.ts +26 -0
  218. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.js +66 -0
  219. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.d.ts +20 -0
  220. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.js +49 -0
  221. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.d.ts +26 -0
  222. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.js +70 -0
  223. package/dist/particles/elements/UIEmitter.Internal.d.ts +15 -0
  224. package/dist/particles/elements/UIEmitter.Internal.js +11 -0
  225. package/dist/particles/elements/UIEmitter.d.ts +68 -0
  226. package/dist/particles/elements/UIEmitter.js +203 -0
  227. package/dist/particles/index.js +18 -0
  228. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.d.ts +13 -0
  229. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.js +211 -0
  230. package/dist/particles/instancedParticle/UIInstancedParticle.d.ts +17 -0
  231. package/dist/particles/instancedParticle/UIInstancedParticle.js +93 -0
  232. package/dist/particles/miscellaneous/miscellaneous.d.ts +32 -0
  233. package/dist/particles/miscellaneous/miscellaneous.js +67 -0
  234. package/dist/particles/renderingModules/UIRenderingColorOverLife.d.ts +14 -0
  235. package/dist/particles/renderingModules/UIRenderingColorOverLife.js +32 -0
  236. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.d.ts +15 -0
  237. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.js +37 -0
  238. package/dist/particles/renderingModules/UIRenderingModule.d.ts +8 -0
  239. package/dist/particles/renderingModules/UIRenderingModule.js +9 -0
  240. package/dist/particles/renderingModules/UIRenderingTexture.d.ts +14 -0
  241. package/dist/particles/renderingModules/UIRenderingTexture.js +26 -0
  242. package/dist/particles/shaders/UIRenderingColorOverLife.glsl.js +3 -0
  243. package/dist/particles/shaders/UIRenderingColorOverVelocity.glsl.js +3 -0
  244. package/dist/particles/shaders/UIRenderingTexture.glsl.js +3 -0
  245. package/dist/particles/spawnModules/UISpawnModule.d.ts +9 -0
  246. package/dist/particles/spawnModules/UISpawnModule.js +9 -0
  247. package/dist/particles/spawnModules/UISpawnOffset.d.ts +21 -0
  248. package/dist/particles/spawnModules/UISpawnOffset.js +46 -0
  249. package/dist/particles/spawnModules/UISpawnRandomLifetime.d.ts +20 -0
  250. package/dist/particles/spawnModules/UISpawnRandomLifetime.js +47 -0
  251. package/dist/particles/spawnModules/UISpawnRandomRotation.d.ts +20 -0
  252. package/dist/particles/spawnModules/UISpawnRandomRotation.js +45 -0
  253. package/dist/particles/spawnModules/UISpawnRandomScale.d.ts +26 -0
  254. package/dist/particles/spawnModules/UISpawnRandomScale.js +60 -0
  255. package/dist/particles/spawnModules/UISpawnRandomTorque.d.ts +20 -0
  256. package/dist/particles/spawnModules/UISpawnRandomTorque.js +45 -0
  257. package/dist/particles/spawnModules/UISpawnRandomVelocity.d.ts +26 -0
  258. package/dist/particles/spawnModules/UISpawnRandomVelocity.js +64 -0
  259. package/dist/particles/spawnModules/UISpawnRectangle.d.ts +27 -0
  260. package/dist/particles/spawnModules/UISpawnRectangle.js +62 -0
  261. package/package.json +8 -1
  262. package/.claude/settings.local.json +0 -9
  263. package/.editorconfig +0 -14
  264. package/CLAUDE.md +0 -181
  265. package/assets/logotype.png +0 -0
  266. package/eslint.config.js +0 -111
  267. package/rollup.config.js +0 -52
  268. package/src/core/constraints/UIAspectConstraint/UIAspectConstraint.ts +0 -60
  269. package/src/core/constraints/UIConstraint.ts +0 -20
  270. package/src/core/constraints/UICustomConstraint.ts +0 -62
  271. package/src/core/constraints/UIHeightConstraint/UIHeightConstraint.ts +0 -52
  272. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.ts +0 -13
  273. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.ts +0 -139
  274. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.ts +0 -16
  275. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.ts +0 -189
  276. package/src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.ts +0 -68
  277. package/src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.ts +0 -94
  278. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.ts +0 -13
  279. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.ts +0 -135
  280. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.ts +0 -16
  281. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.ts +0 -189
  282. package/src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.ts +0 -68
  283. package/src/core/constraints/UIWidthConstraint/UIWidthConstraint.ts +0 -52
  284. package/src/core/constraints/builders/UIConstraint2DBuilder.Internal.ts +0 -84
  285. package/src/core/constraints/builders/UIConstraint2DBuilder.ts +0 -168
  286. package/src/core/constraints/builders/UICoverConstraintBuilder.Internal.ts +0 -15
  287. package/src/core/constraints/builders/UICoverConstraintBuilder.ts +0 -84
  288. package/src/core/constraints/builders/UIFitConstraintBuilder.Internal.ts +0 -15
  289. package/src/core/constraints/builders/UIFitConstraintBuilder.ts +0 -84
  290. package/src/core/elements/UIAnchor/UIAnchor.Internal.ts +0 -13
  291. package/src/core/elements/UIAnchor/UIAnchor.ts +0 -70
  292. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.ts +0 -30
  293. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.ts +0 -355
  294. package/src/core/elements/UIDummy/UIDummy.Internal.ts +0 -33
  295. package/src/core/elements/UIDummy/UIDummy.ts +0 -244
  296. package/src/core/elements/UIElement/UIElement.ts +0 -127
  297. package/src/core/elements/UIGraphics/UIGraphics.ts +0 -168
  298. package/src/core/elements/UIImage/UIImage.ts +0 -138
  299. package/src/core/elements/UINineSlice/UINineSlice.Internal.ts +0 -26
  300. package/src/core/elements/UINineSlice/UINineSlice.ts +0 -296
  301. package/src/core/elements/UIProgress/UIProgress.Internal.ts +0 -24
  302. package/src/core/elements/UIProgress/UIProgress.ts +0 -259
  303. package/src/core/elements/UIScene/UIScene.Internal.ts +0 -46
  304. package/src/core/elements/UIScene/UIScene.ts +0 -259
  305. package/src/core/elements/UIText/UIText.Internal.ts +0 -29
  306. package/src/core/elements/UIText/UIText.Measuring.ts +0 -183
  307. package/src/core/elements/UIText/UIText.Rendering.ts +0 -83
  308. package/src/core/elements/UIText/UIText.ts +0 -376
  309. package/src/core/layers/UIFullscreenLayer/UIFullscreenLayer.ts +0 -233
  310. package/src/core/layers/UILayer/UILayer.ts +0 -156
  311. package/src/core/miscellaneous/UIExpression.ts +0 -142
  312. package/src/core/miscellaneous/UIMode.ts +0 -29
  313. package/src/core/miscellaneous/UIOrientation.ts +0 -18
  314. package/src/core/miscellaneous/UIPriority.ts +0 -63
  315. package/src/core/miscellaneous/UIRelation.ts +0 -39
  316. package/src/core/miscellaneous/UITransparencyMode.ts +0 -9
  317. package/src/core/miscellaneous/area/UIArea.ts +0 -5
  318. package/src/core/miscellaneous/area/UIAreaCircle.ts +0 -32
  319. package/src/core/miscellaneous/area/UIAreaPolygon.ts +0 -50
  320. package/src/core/miscellaneous/area/UIAreaRectangle.ts +0 -38
  321. package/src/core/miscellaneous/area/UIAreaRoundedRectangle.ts +0 -78
  322. package/src/core/miscellaneous/asserts.ts +0 -187
  323. package/src/core/miscellaneous/canvas.ts +0 -73
  324. package/src/core/miscellaneous/color/UIColor.Internal.ts +0 -89
  325. package/src/core/miscellaneous/color/UIColor.ts +0 -844
  326. package/src/core/miscellaneous/computeTransform.ts +0 -127
  327. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.ts +0 -235
  328. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.ts +0 -524
  329. package/src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.ts +0 -448
  330. package/src/core/miscellaneous/generic-plane/shared.ts +0 -323
  331. package/src/core/miscellaneous/insets/UIInsets.Internal.ts +0 -9
  332. package/src/core/miscellaneous/insets/UIInsets.ts +0 -248
  333. package/src/core/miscellaneous/mask-function/UIProgressMaskFunction.ts +0 -24
  334. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.ts +0 -58
  335. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.ts +0 -52
  336. package/src/core/miscellaneous/math.ts +0 -16
  337. package/src/core/miscellaneous/micro/UIMicro.Internal.ts +0 -33
  338. package/src/core/miscellaneous/micro/UIMicro.ts +0 -222
  339. package/src/core/miscellaneous/resize-policy/UIResizePolicy.ts +0 -8
  340. package/src/core/miscellaneous/resize-policy/UIResizePolicyCover.ts +0 -57
  341. package/src/core/miscellaneous/resize-policy/UIResizePolicyCross.ts +0 -65
  342. package/src/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.ts +0 -65
  343. package/src/core/miscellaneous/resize-policy/UIResizePolicyFit.ts +0 -57
  344. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.ts +0 -65
  345. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.ts +0 -65
  346. package/src/core/miscellaneous/resize-policy/UIResizePolicyNone.ts +0 -11
  347. package/src/core/miscellaneous/shared.ts +0 -73
  348. package/src/core/miscellaneous/text-span/UITextSpan.ts +0 -43
  349. package/src/core/miscellaneous/text-style/UITextStyle.Internal.ts +0 -52
  350. package/src/core/miscellaneous/text-style/UITextStyle.ts +0 -479
  351. package/src/core/miscellaneous/texture/UITextureView.Internal.ts +0 -55
  352. package/src/core/miscellaneous/texture/UITextureView.ts +0 -308
  353. package/src/core/miscellaneous/webglCapabilities.ts +0 -129
  354. package/src/core/shaders/UIImage.glsl +0 -10
  355. package/src/core/shaders/UINineSlice.glsl +0 -53
  356. package/src/core/shaders/UIProgress.glsl +0 -15
  357. package/src/core/shaders/UIProgressMaskFunctionCircular.glsl +0 -13
  358. package/src/core/shaders/UIProgressMaskFunctionDirectional.glsl +0 -12
  359. package/src/core/shaders/glsl.d.ts +0 -27
  360. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.ts +0 -23
  361. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.ts +0 -124
  362. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.ts +0 -22
  363. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.ts +0 -101
  364. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.ts +0 -58
  365. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.ts +0 -605
  366. package/src/particles/behaviorModules/UIBehaviorDirectionalGravity.ts +0 -70
  367. package/src/particles/behaviorModules/UIBehaviorModule.ts +0 -20
  368. package/src/particles/behaviorModules/UIBehaviorPointGravity.ts +0 -173
  369. package/src/particles/behaviorModules/UIBehaviorScaleOverLife.ts +0 -104
  370. package/src/particles/behaviorModules/UIBehaviorTorqueDamping.ts +0 -75
  371. package/src/particles/behaviorModules/UIBehaviorTorqueNoise.ts +0 -115
  372. package/src/particles/behaviorModules/UIBehaviorVelocityDamping.ts +0 -77
  373. package/src/particles/behaviorModules/UIBehaviorVelocityNoise.ts +0 -118
  374. package/src/particles/elements/UIEmitter.Internal.ts +0 -22
  375. package/src/particles/elements/UIEmitter.ts +0 -313
  376. package/src/particles/instancedParticle/UIInstancedParticle.Internal.ts +0 -263
  377. package/src/particles/instancedParticle/UIInstancedParticle.ts +0 -138
  378. package/src/particles/miscellaneous/miscellaneous.ts +0 -115
  379. package/src/particles/renderingModules/UIRenderingColorOverLife.ts +0 -39
  380. package/src/particles/renderingModules/UIRenderingColorOverVelocity.ts +0 -49
  381. package/src/particles/renderingModules/UIRenderingModule.ts +0 -17
  382. package/src/particles/renderingModules/UIRenderingTexture.ts +0 -30
  383. package/src/particles/shaders/UIRenderingColorOverLife.glsl +0 -4
  384. package/src/particles/shaders/UIRenderingColorOverVelocity.glsl +0 -6
  385. package/src/particles/shaders/UIRenderingTexture.glsl +0 -4
  386. package/src/particles/spawnModules/UISpawnModule.ts +0 -22
  387. package/src/particles/spawnModules/UISpawnOffset.ts +0 -62
  388. package/src/particles/spawnModules/UISpawnRandomLifetime.ts +0 -68
  389. package/src/particles/spawnModules/UISpawnRandomRotation.ts +0 -60
  390. package/src/particles/spawnModules/UISpawnRandomScale.ts +0 -81
  391. package/src/particles/spawnModules/UISpawnRandomTorque.ts +0 -62
  392. package/src/particles/spawnModules/UISpawnRandomVelocity.ts +0 -92
  393. package/src/particles/spawnModules/UISpawnRectangle.ts +0 -81
  394. package/tsconfig.json +0 -29
  395. /package/{src/core/index.ts → dist/core/index.d.ts} +0 -0
  396. /package/{src/particles/index.ts → dist/particles/index.d.ts} +0 -0
@@ -0,0 +1,505 @@
1
+ import { Solver, Variable, Constraint, Expression } from '@lume/kiwi';
2
+ import { UIExpression } from '../../miscellaneous/UIExpression.js';
3
+ import { UIPriority, convertPriority } from '../../miscellaneous/UIPriority.js';
4
+ import { UIRelation, convertRelation } from '../../miscellaneous/UIRelation.js';
5
+
6
+ /**
7
+ * Wrapper around the Kiwi constraint solver providing enhanced UI-specific functionality.
8
+ *
9
+ * UISolverWrapper abstracts the Kiwi (Cassowary) constraint solver to provide a more
10
+ * UI-friendly interface with additional features like dynamic constraint modification,
11
+ * required variables (P0 priority), partial constraint updates, and automatic solver
12
+ * recovery. It manages variables and constraints through index-based references,
13
+ * allowing for easy tracking and modification of layout constraints.
14
+ *
15
+ * Key features:
16
+ * - Index-based variable and constraint management
17
+ * - Required variables with P0 priority (always satisfied)
18
+ * - Dynamic constraint modification without full rebuilds
19
+ * - Automatic solver recovery on constraint conflicts
20
+ * - Lazy evaluation with recalculation flags
21
+ *
22
+ * @see {@link UIExpression} - Expression system for constraint definitions
23
+ * @see {@link UIPriority} - Priority levels for variables and constraints
24
+ * @see {@link UIRelation} - Relational operators for constraints
25
+ */
26
+ class UISolverWrapper {
27
+ constructor() {
28
+ /** @internal */
29
+ this.dirty = false;
30
+ /** The underlying Kiwi solver instance, undefined when solver needs rebuilding. */
31
+ this._private_solver = new Solver();
32
+ /** Flag indicating whether variable values need recalculation. */
33
+ this._private_recalculationRequired = false;
34
+ /** Map of variable indices to their descriptions. */
35
+ this._private_variables = new Map();
36
+ /** Counter for generating unique variable indices. */
37
+ this._private_lastVariableIndex = 0;
38
+ /** Map of constraint indices to their descriptions. */
39
+ this._private_constraints = new Map();
40
+ /** Counter for generating unique constraint indices. */
41
+ this._private_lastConstraintIndex = 0;
42
+ }
43
+ /**
44
+ * Creates a new solver variable with the specified value and priority.
45
+ *
46
+ * Variables with P0 priority are treated as required (must be satisfied exactly)
47
+ * and are implemented using equality constraints. Other priorities use edit
48
+ * variables that can be adjusted by the solver.
49
+ *
50
+ * @param value - Initial value for the variable
51
+ * @param priority - Priority level for constraint solving
52
+ * @returns Unique index identifier for the created variable
53
+ */
54
+ createVariable(value, priority) {
55
+ const index = this._private_lastVariableIndex++;
56
+ const variable = new Variable();
57
+ if (priority === UIPriority.P0) {
58
+ const description = { variable, priority, value };
59
+ this._private_variables.set(index, description);
60
+ description.constraint = this._private_buildConstraint(new UIExpression(0, [[index, 1]]), new UIExpression(value), UIRelation.EQUAL, priority);
61
+ try {
62
+ this._private_solver?.addConstraint(description.constraint);
63
+ }
64
+ catch {
65
+ this._private_solver = undefined;
66
+ }
67
+ }
68
+ else {
69
+ this._private_variables.set(index, { variable, priority, value });
70
+ try {
71
+ this._private_solver?.addEditVariable(variable, convertPriority(priority));
72
+ this._private_solver?.suggestValue(variable, value);
73
+ }
74
+ catch {
75
+ this._private_solver = undefined;
76
+ }
77
+ }
78
+ this._private_recalculationRequired = true;
79
+ this.dirty = true;
80
+ return index;
81
+ }
82
+ /**
83
+ * Removes a variable from the solver system.
84
+ *
85
+ * The variable must not be referenced by any existing constraints.
86
+ * Cleans up both the variable itself and any associated required constraint.
87
+ *
88
+ * @param index - Index of the variable to remove
89
+ * @throws Will throw an error if the variable doesn't exist or is still in use
90
+ */
91
+ removeVariable(index) {
92
+ const description = this._private_variables.get(index);
93
+ if (description === undefined) {
94
+ throw new Error(`UISolverWrapper.removeVariable.index: variable does not exist`);
95
+ }
96
+ for (const cDescription of this._private_constraints.values()) {
97
+ if (cDescription.lhs.hasTerm(index) || cDescription.rhs.hasTerm(index)) {
98
+ throw new Error(`UISolverWrapper.removeVariable.index: variable is used in constraint`);
99
+ }
100
+ }
101
+ try {
102
+ description.constraint
103
+ ? this._private_solver?.removeConstraint(description.constraint)
104
+ : this._private_solver?.removeEditVariable(description.variable);
105
+ }
106
+ catch {
107
+ this._private_solver = undefined;
108
+ }
109
+ this._private_variables.delete(index);
110
+ this._private_recalculationRequired = true;
111
+ this.dirty = true;
112
+ }
113
+ /**
114
+ * Suggests a new value for an existing variable.
115
+ *
116
+ * For P0 priority variables, rebuilds the associated constraint.
117
+ * For other priorities, suggests the value to the solver's edit system.
118
+ * Only triggers updates if the value actually changes.
119
+ *
120
+ * @param index - Index of the variable to update
121
+ * @param value - New suggested value
122
+ * @throws Will throw an error if the variable doesn't exist
123
+ */
124
+ suggestVariableValue(index, value) {
125
+ const description = this._private_variables.get(index);
126
+ if (description === undefined) {
127
+ throw new Error(`UISolverWrapper.suggestVariableValue.index: variable does not exist`);
128
+ }
129
+ if (description.value !== value) {
130
+ description.value = value;
131
+ if (description.constraint) {
132
+ description.constraint = this._private_rebuildConstraint(description.constraint, new UIExpression().plus(index, 1), new UIExpression(description.value), UIRelation.EQUAL, description.priority);
133
+ }
134
+ else {
135
+ this._private_solver?.suggestValue(description.variable, value);
136
+ }
137
+ this._private_recalculationRequired = true;
138
+ this.dirty = true;
139
+ }
140
+ }
141
+ /**
142
+ * Changes the priority of an existing variable.
143
+ *
144
+ * Switching to/from P0 priority changes how the variable is handled:
145
+ * - P0: Creates required constraint (must be satisfied exactly)
146
+ * - Other: Uses edit variable system (can be adjusted by solver)
147
+ *
148
+ * @param index - Index of the variable to modify
149
+ * @param priority - New priority level
150
+ * @throws Will throw an error if the variable doesn't exist
151
+ */
152
+ setVariablePriority(index, priority) {
153
+ const description = this._private_variables.get(index);
154
+ if (description === undefined) {
155
+ throw new Error(`UISolverWrapper.setVariablePriority.index: variable does not exist`);
156
+ }
157
+ if (priority !== description.priority) {
158
+ description.priority = priority;
159
+ if (description.priority === UIPriority.P0) {
160
+ const lhs = new UIExpression().plus(index, 1);
161
+ const rhs = new UIExpression(description.value);
162
+ description.constraint = this._private_buildConstraint(lhs, rhs, UIRelation.EQUAL, description.priority);
163
+ try {
164
+ this._private_solver?.addConstraint(description.constraint);
165
+ }
166
+ catch {
167
+ this._private_solver = undefined;
168
+ }
169
+ }
170
+ else {
171
+ if (description.constraint) {
172
+ try {
173
+ this._private_solver?.removeConstraint(description.constraint);
174
+ }
175
+ catch {
176
+ this._private_solver = undefined;
177
+ }
178
+ }
179
+ description.constraint = undefined;
180
+ this._private_rebuildVariable(index, description);
181
+ }
182
+ this._private_recalculationRequired = true;
183
+ this.dirty = true;
184
+ }
185
+ }
186
+ /**
187
+ * Reads the current solved value of a variable.
188
+ *
189
+ * Triggers solver recalculation if needed and rebuilds the solver
190
+ * if it was invalidated due to constraint conflicts.
191
+ *
192
+ * @param index - Index of the variable to read
193
+ * @returns Current solved value of the variable
194
+ * @throws Will throw an error if the variable doesn't exist
195
+ */
196
+ readVariableValue(index) {
197
+ const description = this._private_variables.get(index);
198
+ if (description === undefined) {
199
+ throw new Error(`UISolverWrapper.readVariableValue.index: variable does not exist`);
200
+ }
201
+ if (this._private_solver === undefined) {
202
+ this._private_rebuildSolver();
203
+ }
204
+ if (this._private_recalculationRequired) {
205
+ this._private_solver?.updateVariables();
206
+ this._private_recalculationRequired = false;
207
+ }
208
+ return description.variable.value();
209
+ }
210
+ /**
211
+ * Creates a new constraint between two expressions.
212
+ *
213
+ * Constraints can be enabled or disabled, and all properties can be
214
+ * modified later without recreating the constraint.
215
+ *
216
+ * @param lhs - Left-hand side expression
217
+ * @param rhs - Right-hand side expression
218
+ * @param relation - Relational operator (equal, less than, greater than)
219
+ * @param priority - Priority level for constraint solving
220
+ * @param enabled - Whether the constraint is initially active
221
+ * @returns Unique index identifier for the created constraint
222
+ */
223
+ createConstraint(lhs, rhs, relation, priority, enabled) {
224
+ const index = this._private_lastConstraintIndex++;
225
+ const constraint = this._private_buildConstraint(lhs, rhs, relation, priority);
226
+ this._private_constraints.set(index, {
227
+ constraint,
228
+ lhs: lhs.clone(),
229
+ rhs: rhs.clone(),
230
+ priority,
231
+ relation,
232
+ enabled,
233
+ });
234
+ if (enabled) {
235
+ try {
236
+ this._private_solver?.addConstraint(constraint);
237
+ }
238
+ catch {
239
+ this._private_solver = undefined;
240
+ }
241
+ this._private_recalculationRequired = true;
242
+ this.dirty = true;
243
+ }
244
+ return index;
245
+ }
246
+ /**
247
+ * Removes a constraint from the solver system.
248
+ *
249
+ * If the constraint is currently enabled, it will be removed from
250
+ * the active solver before deletion.
251
+ *
252
+ * @param index - Index of the constraint to remove
253
+ * @throws Will throw an error if the constraint doesn't exist
254
+ */
255
+ removeConstraint(index) {
256
+ const description = this._private_constraints.get(index);
257
+ if (description === undefined) {
258
+ throw new Error(`UISolverWrapper.removeConstraint.index: constraint does not exist`);
259
+ }
260
+ if (description.enabled) {
261
+ try {
262
+ this._private_solver?.removeConstraint(description.constraint);
263
+ }
264
+ catch {
265
+ this._private_solver = undefined;
266
+ }
267
+ }
268
+ this._private_constraints.delete(index);
269
+ this._private_recalculationRequired = true;
270
+ this.dirty = true;
271
+ }
272
+ /**
273
+ * Updates the left-hand side expression of an existing constraint.
274
+ *
275
+ * Rebuilds the underlying constraint with the new expression while
276
+ * preserving all other properties.
277
+ *
278
+ * @param index - Index of the constraint to modify
279
+ * @param lhs - New left-hand side expression
280
+ * @throws Will throw an error if the constraint doesn't exist
281
+ */
282
+ setConstraintLHS(index, lhs) {
283
+ const description = this._private_constraints.get(index);
284
+ if (description === undefined) {
285
+ throw new Error(`UISolverWrapper.setConstraintLHS.index: constraint does not exist`);
286
+ }
287
+ description.lhs.copy(lhs);
288
+ this._private_rebuildConstraintByDescription(description);
289
+ this._private_recalculationRequired = true;
290
+ this.dirty = true;
291
+ }
292
+ /**
293
+ * Updates the right-hand side expression of an existing constraint.
294
+ *
295
+ * Rebuilds the underlying constraint with the new expression while
296
+ * preserving all other properties.
297
+ *
298
+ * @param index - Index of the constraint to modify
299
+ * @param rhs - New right-hand side expression
300
+ * @throws Will throw an error if the constraint doesn't exist
301
+ */
302
+ setConstraintRHS(index, rhs) {
303
+ const description = this._private_constraints.get(index);
304
+ if (description === undefined) {
305
+ throw new Error(`UISolverWrapper.setConstraintRHS.index: constraint does not exist`);
306
+ }
307
+ description.rhs.copy(rhs);
308
+ this._private_rebuildConstraintByDescription(description);
309
+ this._private_recalculationRequired = true;
310
+ this.dirty = true;
311
+ }
312
+ /**
313
+ * Updates the relational operator of an existing constraint.
314
+ *
315
+ * Changes how the left and right expressions are compared
316
+ * (equal, less than, greater than).
317
+ *
318
+ * @param index - Index of the constraint to modify
319
+ * @param relation - New relational operator
320
+ * @throws Will throw an error if the constraint doesn't exist
321
+ */
322
+ setConstraintRelation(index, relation) {
323
+ const description = this._private_constraints.get(index);
324
+ if (description === undefined) {
325
+ throw new Error(`UISolverWrapper.setConstraintRelation.index: constraint does not exist`);
326
+ }
327
+ if (description.relation !== relation) {
328
+ description.relation = relation;
329
+ this._private_rebuildConstraintByDescription(description);
330
+ this._private_recalculationRequired = true;
331
+ this.dirty = true;
332
+ }
333
+ }
334
+ /**
335
+ * Updates the priority level of an existing constraint.
336
+ *
337
+ * Higher priority constraints are more likely to be satisfied
338
+ * when conflicts arise.
339
+ *
340
+ * @param index - Index of the constraint to modify
341
+ * @param priority - New priority level
342
+ * @throws Will throw an error if the constraint doesn't exist
343
+ */
344
+ setConstraintPriority(index, priority) {
345
+ const description = this._private_constraints.get(index);
346
+ if (description === undefined) {
347
+ throw new Error(`UISolverWrapper.setConstraintPriority.index: constraint does not exist`);
348
+ }
349
+ if (description.priority !== priority) {
350
+ description.priority = priority;
351
+ this._private_rebuildConstraintByDescription(description);
352
+ this._private_recalculationRequired = true;
353
+ this.dirty = true;
354
+ }
355
+ }
356
+ /**
357
+ * Enables or disables an existing constraint.
358
+ *
359
+ * Disabled constraints are not considered during solving but
360
+ * remain in the system for potential re-enabling.
361
+ *
362
+ * @param index - Index of the constraint to modify
363
+ * @param enabled - Whether the constraint should be active
364
+ * @throws Will throw an error if the constraint doesn't exist
365
+ */
366
+ setConstraintEnabled(index, enabled) {
367
+ const description = this._private_constraints.get(index);
368
+ if (description === undefined) {
369
+ throw new Error(`UISolverWrapper.setConstraintEnabled.index: constraint does not exist`);
370
+ }
371
+ if (enabled !== description.enabled) {
372
+ description.enabled = enabled;
373
+ try {
374
+ description.enabled
375
+ ? this._private_solver?.addConstraint(description.constraint)
376
+ : this._private_solver?.removeConstraint(description.constraint);
377
+ }
378
+ catch {
379
+ this._private_solver = undefined;
380
+ }
381
+ this._private_recalculationRequired = true;
382
+ this.dirty = true;
383
+ }
384
+ }
385
+ /**
386
+ * Rebuilds a variable in the solver system with new properties.
387
+ *
388
+ * Temporarily removes all constraints that reference the variable,
389
+ * updates the variable configuration, then rebuilds and re-adds
390
+ * the dependent constraints.
391
+ */
392
+ _private_rebuildVariable(index, description) {
393
+ const dependConstraints = [];
394
+ for (const cDescription of this._private_constraints.values()) {
395
+ if (cDescription.lhs.hasTerm(index) || cDescription.rhs.hasTerm(index)) {
396
+ try {
397
+ this._private_solver?.removeConstraint(cDescription.constraint);
398
+ }
399
+ catch {
400
+ this._private_solver = undefined;
401
+ }
402
+ dependConstraints.push(cDescription);
403
+ }
404
+ }
405
+ this._private_solver?.removeEditVariable(description.variable);
406
+ this._private_solver?.addEditVariable(description.variable, convertPriority(description.priority));
407
+ for (const cDescription of dependConstraints) {
408
+ cDescription.constraint = this._private_buildConstraint(cDescription.lhs, cDescription.rhs, cDescription.relation, cDescription.priority);
409
+ }
410
+ for (const cDescription of dependConstraints) {
411
+ try {
412
+ this._private_solver?.addConstraint(cDescription.constraint);
413
+ }
414
+ catch {
415
+ this._private_solver = undefined;
416
+ break;
417
+ }
418
+ }
419
+ }
420
+ /**
421
+ * Rebuilds a constraint based on its current description.
422
+ *
423
+ * Uses different rebuild strategies depending on whether the
424
+ * constraint is currently enabled.
425
+ */
426
+ _private_rebuildConstraintByDescription(description) {
427
+ description.constraint = description.enabled
428
+ ? this._private_rebuildConstraint(description.constraint, description.lhs, description.rhs, description.relation, description.priority)
429
+ : this._private_buildConstraint(description.lhs, description.rhs, description.relation, description.priority);
430
+ }
431
+ /**
432
+ * Rebuilds a constraint by removing the old one and creating a new one.
433
+ *
434
+ * Safely handles solver state transitions and constraint replacement.
435
+ */
436
+ _private_rebuildConstraint(oldConstraint, lhs, rhs, relation, priority) {
437
+ try {
438
+ this._private_solver?.removeConstraint(oldConstraint);
439
+ }
440
+ catch {
441
+ this._private_solver = undefined;
442
+ }
443
+ const constraint = this._private_buildConstraint(lhs, rhs, relation, priority);
444
+ try {
445
+ this._private_solver?.addConstraint(constraint);
446
+ }
447
+ catch {
448
+ this._private_solver = undefined;
449
+ }
450
+ return constraint;
451
+ }
452
+ /**
453
+ * Creates a new Kiwi constraint from UI expressions and parameters.
454
+ *
455
+ * Converts UI-level expressions and enums to Kiwi-compatible formats.
456
+ */
457
+ _private_buildConstraint(lhs, rhs, relation, priority) {
458
+ return new Constraint(this._private_convertExpression(lhs), convertRelation(relation), this._private_convertExpression(rhs), convertPriority(priority));
459
+ }
460
+ /**
461
+ * Converts a UIExpression to a Kiwi Expression.
462
+ *
463
+ * Maps variable indices to their corresponding Kiwi Variable instances
464
+ * and preserves coefficients and constants.
465
+ */
466
+ _private_convertExpression(expression) {
467
+ return new Expression(...expression.prepareTerms().map(([variableIndex, coefficient]) => {
468
+ const description = this._private_variables.get(variableIndex);
469
+ if (description === undefined) {
470
+ throw new Error(`UISolverWrapper.convertExpression.expression: variable does not exist`);
471
+ }
472
+ return [coefficient, description.variable];
473
+ }), expression.constant);
474
+ }
475
+ /**
476
+ * Completely rebuilds the solver from scratch.
477
+ *
478
+ * Re-adds all variables and constraints to a fresh solver instance.
479
+ * Used for recovery when the solver enters an invalid state.
480
+ */
481
+ _private_rebuildSolver() {
482
+ if (this._private_solver) {
483
+ throw new Error("UISolverWrapper.rebuildSolver: solver already exists");
484
+ }
485
+ this._private_solver = new Solver();
486
+ for (const description of this._private_variables.values()) {
487
+ if (description.constraint) {
488
+ this._private_solver.addConstraint(description.constraint);
489
+ }
490
+ else {
491
+ this._private_solver.addEditVariable(description.variable, convertPriority(description.priority));
492
+ this._private_solver.suggestValue(description.variable, description.value);
493
+ }
494
+ }
495
+ for (const description of this._private_constraints.values()) {
496
+ if (description.enabled) {
497
+ this._private_solver.addConstraint(description.constraint);
498
+ }
499
+ }
500
+ this._private_recalculationRequired = true;
501
+ this.dirty = true;
502
+ }
503
+ }
504
+
505
+ export { UISolverWrapper };
package/dist/index.js ADDED
@@ -0,0 +1,51 @@
1
+ export { UIConstraint2DBuilder } from './core/constraints/builders/UIConstraint2DBuilder.js';
2
+ export { UICoverConstraintBuilder } from './core/constraints/builders/UICoverConstraintBuilder.js';
3
+ export { UIFitConstraintBuilder } from './core/constraints/builders/UIFitConstraintBuilder.js';
4
+ export { UIAspectConstraint } from './core/constraints/UIAspectConstraint/UIAspectConstraint.js';
5
+ export { UICustomConstraint } from './core/constraints/UICustomConstraint.js';
6
+ export { UIHeightConstraint } from './core/constraints/UIHeightConstraint/UIHeightConstraint.js';
7
+ export { UIHorizontalDistanceConstraint } from './core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.js';
8
+ export { UIHorizontalInterpolationConstraint } from './core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.js';
9
+ export { UIHorizontalProportionConstraint } from './core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.js';
10
+ export { UISingleParameterConstraint } from './core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.js';
11
+ export { UIVerticalDistanceConstraint } from './core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.js';
12
+ export { UIVerticalInterpolationConstraint } from './core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.js';
13
+ export { UIVerticalProportionConstraint } from './core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.js';
14
+ export { UIWidthConstraint } from './core/constraints/UIWidthConstraint/UIWidthConstraint.js';
15
+ export { UIAnchor } from './core/elements/UIAnchor/UIAnchor.js';
16
+ export { UIAnimatedImage } from './core/elements/UIAnimatedImage/UIAnimatedImage.js';
17
+ export { UIAnimatedImageLoopMode } from './core/elements/UIAnimatedImage/UIAnimatedImage.Internal.js';
18
+ export { UIDummy } from './core/elements/UIDummy/UIDummy.js';
19
+ export { UIGraphics } from './core/elements/UIGraphics/UIGraphics.js';
20
+ export { UIImage } from './core/elements/UIImage/UIImage.js';
21
+ export { UINineSlice } from './core/elements/UINineSlice/UINineSlice.js';
22
+ export { UINineSliceRegionMode } from './core/elements/UINineSlice/UINineSlice.Internal.js';
23
+ export { UIProgress } from './core/elements/UIProgress/UIProgress.js';
24
+ export { UIScene } from './core/elements/UIScene/UIScene.js';
25
+ export { UISceneUpdateMode } from './core/elements/UIScene/UIScene.Internal.js';
26
+ export { UIText } from './core/elements/UIText/UIText.js';
27
+ export { UITextResizeMode } from './core/elements/UIText/UIText.Internal.js';
28
+ export { UIFullscreenLayer } from './core/layers/UIFullscreenLayer/UIFullscreenLayer.js';
29
+ export { UILayer } from './core/layers/UILayer/UILayer.js';
30
+ export { UIAreaCircle } from './core/miscellaneous/area/UIAreaCircle.js';
31
+ export { UIAreaPolygon } from './core/miscellaneous/area/UIAreaPolygon.js';
32
+ export { UIAreaRectangle } from './core/miscellaneous/area/UIAreaRectangle.js';
33
+ export { UIAreaRoundedRectangle } from './core/miscellaneous/area/UIAreaRoundedRectangle.js';
34
+ export { UIColor } from './core/miscellaneous/color/UIColor.js';
35
+ export { UIProgressMaskFunctionCircular } from './core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.js';
36
+ export { UIProgressMaskFunctionDirectional } from './core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.js';
37
+ export { UIMicro } from './core/miscellaneous/micro/UIMicro.js';
38
+ export { UIMicroAnchorMode } from './core/miscellaneous/micro/UIMicro.Internal.js';
39
+ export { UIResizePolicyCover } from './core/miscellaneous/resize-policy/UIResizePolicyCover.js';
40
+ export { UIResizePolicyCross } from './core/miscellaneous/resize-policy/UIResizePolicyCross.js';
41
+ export { UIResizePolicyCrossInverted } from './core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.js';
42
+ export { UIResizePolicyFit } from './core/miscellaneous/resize-policy/UIResizePolicyFit.js';
43
+ export { UIResizePolicyFixedHeight } from './core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.js';
44
+ export { UIResizePolicyFixedWidth } from './core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.js';
45
+ export { UIResizePolicyNone } from './core/miscellaneous/resize-policy/UIResizePolicyNone.js';
46
+ export { UIExpression } from './core/miscellaneous/UIExpression.js';
47
+ export { UIMode } from './core/miscellaneous/UIMode.js';
48
+ export { UIOrientation } from './core/miscellaneous/UIOrientation.js';
49
+ export { UIPriority } from './core/miscellaneous/UIPriority.js';
50
+ export { UIRelation } from './core/miscellaneous/UIRelation.js';
51
+ export { UITransparencyMode } from './core/miscellaneous/UITransparencyMode.js';
@@ -0,0 +1,21 @@
1
+ import type { Vector2Like } from "../../core/miscellaneous/math";
2
+ import { type UIVector2Config } from "../miscellaneous/miscellaneous";
3
+ import { UIBehaviorModule } from "./UIBehaviorModule";
4
+ /**
5
+ * Applies constant acceleration to all particles.
6
+ *
7
+ * Adds the direction vector to particle velocity each frame.
8
+ */
9
+ export declare class UIBehaviorDirectionalGravity extends UIBehaviorModule<{
10
+ builtin: "Matrix4";
11
+ }> {
12
+ private directionInternal;
13
+ /**
14
+ * @param direction - Acceleration vector in units/second²
15
+ */
16
+ constructor(direction: Vector2Like);
17
+ /** Acceleration vector in units/second² */
18
+ get direction(): Vector2Like;
19
+ /** Acceleration vector in units/second² */
20
+ set direction(value: UIVector2Config);
21
+ }
@@ -0,0 +1,47 @@
1
+ import { assertValidNumber } from '../../core/miscellaneous/asserts.js';
2
+ import { resolveUIVector2Config, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y } from '../miscellaneous/miscellaneous.js';
3
+ import { UIBehaviorModule } from './UIBehaviorModule.js';
4
+
5
+ /**
6
+ * Applies constant acceleration to all particles.
7
+ *
8
+ * Adds the direction vector to particle velocity each frame.
9
+ */
10
+ class UIBehaviorDirectionalGravity extends UIBehaviorModule {
11
+ /**
12
+ * @param direction - Acceleration vector in units/second²
13
+ */
14
+ constructor(direction) {
15
+ super();
16
+ /** @internal */
17
+ this.requiredProperties = { builtin: "Matrix4" };
18
+ this._private_directionInternal = resolveUIVector2Config(direction);
19
+ assertValidNumber(this._private_directionInternal.x, "UIBehaviorDirectionalGravity.constructor.direction.x");
20
+ assertValidNumber(this._private_directionInternal.y, "UIBehaviorDirectionalGravity.constructor.direction.y");
21
+ }
22
+ /** Acceleration vector in units/second² */
23
+ get direction() {
24
+ return this._private_directionInternal;
25
+ }
26
+ /** Acceleration vector in units/second² */
27
+ set direction(value) {
28
+ this._private_directionInternal = resolveUIVector2Config(value);
29
+ assertValidNumber(this._private_directionInternal.x, "UIBehaviorDirectionalGravity.direction.x");
30
+ assertValidNumber(this._private_directionInternal.y, "UIBehaviorDirectionalGravity.direction.y");
31
+ }
32
+ /** @internal */
33
+ update(properties, instanceCount, deltaTime) {
34
+ const { builtin } = properties;
35
+ const { array, itemSize } = builtin;
36
+ const offsetX = this._private_directionInternal.x * deltaTime;
37
+ const offsetY = this._private_directionInternal.y * deltaTime;
38
+ for (let i = 0; i < instanceCount; i++) {
39
+ const itemOffset = i * itemSize;
40
+ array[itemOffset + BUILTIN_OFFSET_VELOCITY_X] += offsetX;
41
+ array[itemOffset + BUILTIN_OFFSET_VELOCITY_Y] += offsetY;
42
+ }
43
+ builtin.needsUpdate = true;
44
+ }
45
+ }
46
+
47
+ export { UIBehaviorDirectionalGravity };
@@ -0,0 +1,14 @@
1
+ import type { InstancedBufferAttribute } from "three";
2
+ import type { UIPropertyName } from "../../core/miscellaneous/generic-plane/shared";
3
+ /**
4
+ * Base class for particle behavior modules.
5
+ *
6
+ * Behavior modules update particle properties each frame.
7
+ */
8
+ export declare abstract class UIBehaviorModule<T extends Record<string, UIPropertyName> = Record<string, UIPropertyName>> {
9
+ abstract readonly requiredProperties: T;
10
+ abstract update(properties: {
11
+ [K in keyof T]: InstancedBufferAttribute;
12
+ }, instanceCount: number, deltaTime: number): void;
13
+ destroy?(): void;
14
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Base class for particle behavior modules.
3
+ *
4
+ * Behavior modules update particle properties each frame.
5
+ */
6
+ class UIBehaviorModule {
7
+ }
8
+
9
+ export { UIBehaviorModule };