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,64 @@
1
+ import { MathUtils } from 'three';
2
+ import { assertValidNumber } from '../../core/miscellaneous/asserts.js';
3
+ import { resolveUIRangeConfig, BUILTIN_OFFSET_VELOCITY_X, BUILTIN_OFFSET_VELOCITY_Y } from '../miscellaneous/miscellaneous.js';
4
+ import { UISpawnModule } from './UISpawnModule.js';
5
+
6
+ /**
7
+ * Assigns random velocity to particles.
8
+ *
9
+ * Direction and magnitude are chosen independently from their respective ranges.
10
+ */
11
+ class UISpawnRandomVelocity extends UISpawnModule {
12
+ /**
13
+ * @param angle - Direction range in radians. Accepts number, tuple, or range object
14
+ * @param magnitude - Speed range in units/second. Accepts number, tuple, or range object
15
+ */
16
+ constructor(angle = { min: -Math.PI, max: Math.PI }, magnitude = { min: -50, max: 50 }) {
17
+ super();
18
+ /** @internal */
19
+ this.requiredProperties = { builtin: "Matrix4" };
20
+ this._private_angleInternal = resolveUIRangeConfig(angle);
21
+ this._private_magnitudeInternal = resolveUIRangeConfig(magnitude);
22
+ assertValidNumber(this._private_angleInternal.min, "UISpawnRandomVelocity.constructor.angle.min");
23
+ assertValidNumber(this._private_angleInternal.max, "UISpawnRandomVelocity.constructor.angle.max");
24
+ assertValidNumber(this._private_magnitudeInternal.min, "UISpawnRandomVelocity.constructor.magnitude.min");
25
+ assertValidNumber(this._private_magnitudeInternal.max, "UISpawnRandomVelocity.constructor.magnitude.max");
26
+ }
27
+ /** Direction range in radians */
28
+ get angle() {
29
+ return this._private_angleInternal;
30
+ }
31
+ /** Speed range in units/second */
32
+ get magnitude() {
33
+ return this._private_magnitudeInternal;
34
+ }
35
+ /** Direction range in radians */
36
+ set angle(value) {
37
+ this._private_angleInternal = resolveUIRangeConfig(value);
38
+ assertValidNumber(this._private_angleInternal.min, "UISpawnRandomVelocity.angle.min");
39
+ assertValidNumber(this._private_angleInternal.max, "UISpawnRandomVelocity.angle.max");
40
+ }
41
+ /** Speed range in units/second */
42
+ set magnitude(value) {
43
+ this._private_magnitudeInternal = resolveUIRangeConfig(value);
44
+ assertValidNumber(this._private_magnitudeInternal.min, "UISpawnRandomVelocity.magnitude.min");
45
+ assertValidNumber(this._private_magnitudeInternal.max, "UISpawnRandomVelocity.magnitude.max");
46
+ }
47
+ /** @internal */
48
+ spawn(properties, instanceBegin, instanceEnd) {
49
+ const { builtin } = properties;
50
+ const { array, itemSize } = builtin;
51
+ const { min: angleMin, max: angleMax } = this._private_angleInternal;
52
+ const { min: magnitudeMin, max: magnitudeMax } = this._private_magnitudeInternal;
53
+ for (let i = instanceBegin; i < instanceEnd; i++) {
54
+ const itemOffset = i * itemSize;
55
+ const angle = MathUtils.randFloat(angleMin, angleMax);
56
+ const magnitude = MathUtils.randFloat(magnitudeMin, magnitudeMax);
57
+ array[itemOffset + BUILTIN_OFFSET_VELOCITY_X] = Math.cos(angle) * magnitude;
58
+ array[itemOffset + BUILTIN_OFFSET_VELOCITY_Y] = Math.sin(angle) * magnitude;
59
+ }
60
+ builtin.needsUpdate = true;
61
+ }
62
+ }
63
+
64
+ export { UISpawnRandomVelocity };
@@ -0,0 +1,27 @@
1
+ import type { Vector2Like } from "../../core/miscellaneous/math";
2
+ import { type UIVector2Config } from "../miscellaneous/miscellaneous";
3
+ import { UISpawnModule } from "./UISpawnModule";
4
+ /**
5
+ * Spawns particles at random positions within a rectangle.
6
+ *
7
+ * Position is chosen uniformly within the bounds defined by min and max.
8
+ */
9
+ export declare class UISpawnRectangle extends UISpawnModule<{
10
+ builtin: "Matrix4";
11
+ }> {
12
+ private minInternal;
13
+ private maxInternal;
14
+ /**
15
+ * @param min - Bottom-left corner of spawn area
16
+ * @param max - Top-right corner of spawn area
17
+ */
18
+ constructor(min?: UIVector2Config, max?: UIVector2Config);
19
+ /** Bottom-left corner of spawn area */
20
+ get min(): Vector2Like;
21
+ /** Top-right corner of spawn area */
22
+ get max(): Vector2Like;
23
+ /** Bottom-left corner of spawn area */
24
+ set min(value: UIVector2Config);
25
+ /** Top-right corner of spawn area */
26
+ set max(value: UIVector2Config);
27
+ }
@@ -0,0 +1,62 @@
1
+ import { MathUtils } from 'three';
2
+ import { assertValidNumber } from '../../core/miscellaneous/asserts.js';
3
+ import { resolveUIVector2Config, BUILTIN_OFFSET_POSITION_X, BUILTIN_OFFSET_POSITION_Y } from '../miscellaneous/miscellaneous.js';
4
+ import { UISpawnModule } from './UISpawnModule.js';
5
+
6
+ /**
7
+ * Spawns particles at random positions within a rectangle.
8
+ *
9
+ * Position is chosen uniformly within the bounds defined by min and max.
10
+ */
11
+ class UISpawnRectangle extends UISpawnModule {
12
+ /**
13
+ * @param min - Bottom-left corner of spawn area
14
+ * @param max - Top-right corner of spawn area
15
+ */
16
+ constructor(min = { x: -50, y: -50 }, max = { x: 50, y: 50 }) {
17
+ super();
18
+ /** @internal */
19
+ this.requiredProperties = { builtin: "Matrix4" };
20
+ this._private_minInternal = resolveUIVector2Config(min);
21
+ this._private_maxInternal = resolveUIVector2Config(max);
22
+ assertValidNumber(this._private_minInternal.x, "UISpawnRectangle.constructor.min.x");
23
+ assertValidNumber(this._private_minInternal.y, "UISpawnRectangle.constructor.min.y");
24
+ assertValidNumber(this._private_maxInternal.x, "UISpawnRectangle.constructor.max.x");
25
+ assertValidNumber(this._private_maxInternal.y, "UISpawnRectangle.constructor.max.y");
26
+ }
27
+ /** Bottom-left corner of spawn area */
28
+ get min() {
29
+ return this._private_minInternal;
30
+ }
31
+ /** Top-right corner of spawn area */
32
+ get max() {
33
+ return this._private_maxInternal;
34
+ }
35
+ /** Bottom-left corner of spawn area */
36
+ set min(value) {
37
+ this._private_minInternal = resolveUIVector2Config(value);
38
+ assertValidNumber(this._private_minInternal.x, "UISpawnRectangle.min.x");
39
+ assertValidNumber(this._private_minInternal.y, "UISpawnRectangle.min.y");
40
+ }
41
+ /** Top-right corner of spawn area */
42
+ set max(value) {
43
+ this._private_maxInternal = resolveUIVector2Config(value);
44
+ assertValidNumber(this._private_maxInternal.x, "UISpawnRectangle.max.x");
45
+ assertValidNumber(this._private_maxInternal.y, "UISpawnRectangle.max.y");
46
+ }
47
+ /** @internal */
48
+ spawn(properties, instanceBegin, instanceEnd) {
49
+ const { builtin } = properties;
50
+ const { array, itemSize } = builtin;
51
+ const { x: minX, y: minY } = this._private_minInternal;
52
+ const { x: maxX, y: maxY } = this._private_maxInternal;
53
+ for (let i = instanceBegin; i < instanceEnd; i++) {
54
+ const itemOffset = i * itemSize;
55
+ array[itemOffset + BUILTIN_OFFSET_POSITION_X] = MathUtils.randFloat(minX, maxX);
56
+ array[itemOffset + BUILTIN_OFFSET_POSITION_Y] = MathUtils.randFloat(minY, maxY);
57
+ }
58
+ builtin.needsUpdate = true;
59
+ }
60
+ }
61
+
62
+ export { UISpawnRectangle };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "laymur",
3
- "version": "0.17.0",
3
+ "version": "0.17.2",
4
4
  "description": "Constraint-based UI library for Three.js mobile advertisements",
5
5
  "keywords": [
6
6
  "ui",
@@ -24,6 +24,13 @@
24
24
  "build": "npm run clean && rollup -c",
25
25
  "prepublishOnly": "npm run build"
26
26
  },
27
+ "main": "./dist/index.js",
28
+ "module": "./dist/index.js",
29
+ "files": [
30
+ "dist",
31
+ "README.md",
32
+ "LICENSE"
33
+ ],
27
34
  "exports": {
28
35
  ".": {
29
36
  "import": "./dist/index.js",
@@ -1,9 +0,0 @@
1
- {
2
- "permissions": {
3
- "allow": [
4
- "mcp__acp__Edit",
5
- "mcp__acp__Bash",
6
- "mcp__acp__Write"
7
- ]
8
- }
9
- }
package/.editorconfig DELETED
@@ -1,14 +0,0 @@
1
- root = true
2
-
3
- [*]
4
- charset = utf-8
5
- end_of_line = lf
6
- insert_final_newline = true
7
- trim_trailing_whitespace = true
8
- indent_style = space
9
- indent_size = 2
10
- tab_width = 2
11
- max_line_length = 100
12
-
13
- [*.md]
14
- trim_trailing_whitespace = false
package/CLAUDE.md DELETED
@@ -1,181 +0,0 @@
1
- # CLAUDE.md
2
-
3
- This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4
-
5
- ## Project Overview
6
-
7
- Laymur is a constraint-based UI library for Three.js mobile advertisements where bundle size is critical. It uses the Cassowary constraint solving algorithm (via Kiwi.js) to handle responsive layouts across different screen sizes and orientations.
8
-
9
- **Current Status**: Early Alpha (v0.15.0) - APIs may change
10
-
11
- ## Build Commands
12
-
13
- ```bash
14
- # Clean build artifacts
15
- npm run clean
16
-
17
- # Development build (unminified)
18
- npm run build
19
-
20
- # Production build (minified, console.log stripped)
21
- npm run build:prod
22
-
23
- # Pre-publish (runs automatically before npm publish)
24
- npm run prepublishOnly
25
- ```
26
-
27
- The build outputs two files:
28
-
29
- - `dist/index.js` - Development build with source maps
30
- - `dist/index.min.js` - Production build with aggressive minification
31
-
32
- ## Architecture Overview
33
-
34
- ### Core Architecture Layers
35
-
36
- 1. **Layers** (`src/layers/`)
37
- - Entry point for UI hierarchy
38
- - `UIFullscreenLayer` handles browser window scaling and input events
39
- - Owns three wrapper systems: Scene, Solver, and Input
40
-
41
- 2. **Elements** (`src/elements/`)
42
- - Visual UI components that live on layers
43
- - All elements extend from `UIElement` → `UIDummy` → `UIAnchor`
44
- - Elements have both constraint-based layout (x, y, width, height) and visual transforms (`micro`)
45
-
46
- 3. **Constraints** (`src/constraints/`)
47
- - Define relationships between element positions and sizes
48
- - Solved using Kiwi.js (Cassowary algorithm)
49
- - Constraints can be orientation-aware (horizontal/vertical/always)
50
-
51
- 4. **Wrappers** (`src/wrappers/`)
52
- - `UISolverWrapper` - Manages Kiwi.js constraint solver
53
- - `UISceneWrapper` - Manages Three.js rendering via plane registry
54
- - `UIInputWrapper` - Manages pointer event catching and propagation
55
-
56
- ### Event System (Ferrsign)
57
-
58
- The library uses **Ferrsign** for type-safe event handling:
59
-
60
- - `Ferrsign0` - Events with no arguments
61
- - `Ferrsign1` - Events with 1 argument
62
- - `Ferrsign2` - Events with 2 arguments
63
- - `Ferrsign3` - Events with 3 arguments
64
- - For 4+ arguments, wrap in an object
65
-
66
- **Important**: Event data types are defined in `.Internal.ts` files:
67
-
68
- - `UIInputEventData` in `UIDummy.Internal.ts`
69
- - `UIFullscreenLayerInputEventData` in `UIFullscreenLayer.Internal.ts`
70
-
71
- ### File Organization Patterns
72
-
73
- Each component follows this structure:
74
-
75
- - `Component.ts` - Main implementation
76
- - `Component.Internal.ts` - Internal types, interfaces, constants, event data types
77
-
78
- **Import Convention**: Use `type {} from` not `{ type } from`:
79
-
80
- ```typescript
81
- // ✓ Correct
82
- import { Ferrsign1 } from "ferrsign";
83
- import type { FerrsignView1 } from "ferrsign";
84
-
85
- // ✗ Wrong
86
- import { Ferrsign1, type FerrsignView1 } from "ferrsign";
87
- ```
88
-
89
- Type imports must be in the beginning of files, not inline (`import type { X }` not `type X = import("...")`).
90
-
91
- ### Coordinate System
92
-
93
- - Origin (0, 0) is **bottom-left** of the layer
94
- - Y increases upward (opposite of DOM)
95
- - All positions and sizes use world units (not pixels)
96
- - Elements have two transform systems:
97
- - **Constraint layout**: x, y, width, height (affects constraints)
98
- - **Visual transforms**: `element.micro.*` (doesn't affect constraints)
99
-
100
- ### Rendering Pipeline
101
-
102
- 1. Layer calls `solverWrapper.updateVariables()` if dirty
103
- 2. Layer emits `signalRendering` event
104
- 3. Elements update their plane transforms if dirty
105
- 4. `UISceneWrapper` renders all visible planes via `UIGenericPlaneRegistry`
106
- 5. Dirty flags are cleared
107
-
108
- ### Shader System
109
-
110
- - Shaders are in `src/shaders/` as `.glsl` files
111
- - Imported as strings via rollup-plugin-string
112
- - Minified during production build (comments/whitespace removed)
113
- - Each element type has its own shader with custom uniforms
114
-
115
- ## Key Design Principles
116
-
117
- 1. **Bundle Size Optimization**
118
- - Private properties prefixed with `_` are mangled in production
119
- - Aggressive terser settings in production build
120
- - No unused code - tree-shakeable exports
121
-
122
- 2. **Constraint-Based Layout**
123
- - Elements don't directly set their own positions
124
- - Constraints define relationships, solver calculates final values
125
- - Use `UISolverWrapper.suggestVariableValue()` for direct position hints
126
-
127
- 3. **Separation of Layout and Transforms**
128
- - Constraints control layout (x, y, width, height)
129
- - `UIMicro` controls visual transforms (rotation, scale, offset)
130
- - This allows animations without recalculating constraints
131
-
132
- 4. **Dirty Flag System**
133
- - Solver, input, and individual elements track dirty state
134
- - Only recalculate when necessary
135
- - `setDirtyFalse()` called after updates
136
-
137
- ## Common Patterns
138
-
139
- ### Adding a New Element Type
140
-
141
- 1. Create `UINewElement.ts` and `UINewElement.Internal.ts`
142
- 2. Extend `UIElement` (or `UIDummy` if interactive)
143
- 3. Define shader in `src/shaders/UINewElement.glsl`
144
- 4. Register plane with `sceneWrapper.createPlane()`
145
- 5. Subscribe to `layer.signalRendering` for updates
146
- 6. Export from `src/index.ts`
147
-
148
- ### Adding Event Support
149
-
150
- 1. Define event data interface in `.Internal.ts` file
151
- 2. Create private `Ferrsign*` fields in class
152
- 3. Create public getters returning `FerrsignView*`
153
- 4. Emit events with `signalName.emit(...)`
154
- 5. Export event data type from `src/index.ts`
155
-
156
- ### Working with Constraints
157
-
158
- Constraints are active when:
159
-
160
- - Priority > 0
161
- - Enabled = true
162
- - Orientation matches (ALWAYS, or current layer orientation)
163
-
164
- Priority levels (0-1000, higher = stronger):
165
-
166
- - P0-P3: Strong constraints (layout structure)
167
- - P4-P6: Medium constraints (sizing)
168
- - P7-P9: Weak constraints (suggestions)
169
-
170
- ## Dependencies
171
-
172
- - **@lume/kiwi** (^0.4.4) - Cassowary constraint solver
173
- - **ferrsign** (^0.0.4) - Type-safe event system
174
- - **three** (peer, >=0.157.0 <0.180.0) - 3D rendering
175
-
176
- ## Notes
177
-
178
- - The library assumes strict TypeScript (`strict: true`)
179
- - No tests currently - early alpha stage
180
- - Designed for mobile ad scenarios (small bundle, responsive)
181
- - Works best for relatively simple UI layouts
Binary file
package/eslint.config.js DELETED
@@ -1,111 +0,0 @@
1
- import tsPlugin from "@typescript-eslint/eslint-plugin";
2
- import tsParser from "@typescript-eslint/parser";
3
-
4
- export default [
5
- {
6
- files: ["src/**/*.ts"],
7
- ignores: ["dist/**", "node_modules/**"],
8
- languageOptions: {
9
- parser: tsParser,
10
- parserOptions: {
11
- project: "./tsconfig.json",
12
- tsconfigRootDir: process.cwd(),
13
- sourceType: "module",
14
- },
15
- },
16
- plugins: {
17
- "@typescript-eslint": tsPlugin,
18
- },
19
- rules: {
20
- "@typescript-eslint/use-unknown-in-catch-callback-variable": "error",
21
- "@typescript-eslint/unified-signatures": "error",
22
- "@typescript-eslint/switch-exhaustiveness-check": "error",
23
- "@typescript-eslint/strict-boolean-expressions": "error",
24
- "@typescript-eslint/restrict-plus-operands": "error",
25
- "@typescript-eslint/prefer-return-this-type": "error",
26
- "@typescript-eslint/prefer-regexp-exec": "error",
27
- "@typescript-eslint/prefer-literal-enum-member": "error",
28
- "@typescript-eslint/prefer-find": "error",
29
- "@typescript-eslint/prefer-enum-initializers": "error",
30
- "@typescript-eslint/no-wrapper-object-types": "error",
31
- "@typescript-eslint/no-unsafe-function-type": "error",
32
- "@typescript-eslint/no-unsafe-enum-comparison": "error",
33
- "@typescript-eslint/no-unnecessary-type-conversion": "error",
34
- "@typescript-eslint/no-unnecessary-type-constraint": "error",
35
- "@typescript-eslint/no-unnecessary-template-expression": "error",
36
- "@typescript-eslint/no-unnecessary-qualifier": "error",
37
- "@typescript-eslint/no-unnecessary-parameter-property-assignment": "error",
38
- "@typescript-eslint/no-unnecessary-boolean-literal-compare": "error",
39
- "@typescript-eslint/no-this-alias": "error",
40
- "@typescript-eslint/no-redundant-type-constituents": "error",
41
- "no-loop-func": "off",
42
- "@typescript-eslint/no-loop-func": "error",
43
- "@typescript-eslint/no-extra-non-null-assertion": "error",
44
- "@typescript-eslint/no-empty-object-type": "error",
45
- "@typescript-eslint/no-duplicate-type-constituents": "error",
46
- "@typescript-eslint/no-duplicate-enum-values": "error",
47
- "@typescript-eslint/no-import-type-side-effects": "error",
48
- "@typescript-eslint/require-await": "error",
49
-
50
- "no-unused-vars": "off",
51
- "@typescript-eslint/no-unused-vars": "error",
52
- "no-console": "error",
53
- "no-debugger": "error",
54
- "no-implicit-coercion": "error",
55
- "no-extend-native": "error",
56
- eqeqeq: ["error", "always"],
57
- curly: ["error", "all"],
58
-
59
- "@typescript-eslint/explicit-function-return-type": ["error", { allowExpressions: false }],
60
- "@typescript-eslint/explicit-module-boundary-types": "error",
61
- "@typescript-eslint/no-explicit-any": "error",
62
- "@typescript-eslint/no-inferrable-types": "warn",
63
- "@typescript-eslint/no-floating-promises": "error",
64
- "@typescript-eslint/no-misused-promises": "error",
65
- "@typescript-eslint/no-unnecessary-type-assertion": "error",
66
- "@typescript-eslint/no-unnecessary-condition": "warn",
67
- "@typescript-eslint/no-non-null-assertion": "warn",
68
- "@typescript-eslint/ban-ts-comment": [
69
- "error",
70
- { "ts-expect-error": "allow-with-description" },
71
- ],
72
- "@typescript-eslint/prefer-readonly": "error",
73
- "@typescript-eslint/prefer-optional-chain": "error",
74
- "@typescript-eslint/consistent-type-imports": "error",
75
- "@typescript-eslint/consistent-type-definitions": ["error", "interface"],
76
- "@typescript-eslint/prefer-nullish-coalescing": "error",
77
- "@typescript-eslint/prefer-string-starts-ends-with": "error",
78
- "@typescript-eslint/prefer-includes": "error",
79
- "@typescript-eslint/prefer-reduce-type-parameter": "error",
80
- "@typescript-eslint/prefer-function-type": "error",
81
- "@typescript-eslint/array-type": ["error", { default: "array" }],
82
- "@typescript-eslint/prefer-for-of": "error",
83
-
84
- "@typescript-eslint/member-ordering": "warn",
85
- "@typescript-eslint/naming-convention": [
86
- "error",
87
- { selector: "default", format: ["camelCase"] },
88
- { selector: "variableLike", format: ["camelCase", "UPPER_CASE"] },
89
- { selector: "typeLike", format: ["PascalCase"] },
90
- { selector: "enumMember", format: ["UPPER_CASE"] },
91
- {
92
- selector: "property",
93
- format: ["camelCase"],
94
- leadingUnderscore: "allow",
95
- },
96
- {
97
- selector: "classProperty",
98
- format: ["camelCase"],
99
- modifiers: ["private"],
100
- },
101
- ],
102
- "@typescript-eslint/explicit-member-accessibility": [
103
- "error",
104
- {
105
- accessibility: "explicit",
106
- overrides: { constructors: "no-public" },
107
- },
108
- ],
109
- },
110
- },
111
- ];
package/rollup.config.js DELETED
@@ -1,52 +0,0 @@
1
- import { nodeResolve } from "@rollup/plugin-node-resolve";
2
- import typescript from "rollup-plugin-typescript2";
3
- import minifyPrivatesTransformer from "ts-transformer-minify-privates";
4
- import { string } from "rollup-plugin-string";
5
-
6
- const sharedPlugins = [
7
- nodeResolve({ extensions: [".js", ".ts"] }),
8
- {
9
- name: "minify-shaders",
10
- transform(code, id) {
11
- if (/\.(glsl|fs|vs|frag|vert)$/.test(id)) {
12
- return {
13
- code: code
14
- .replace(/\/\*[\s\S]*?\*\//g, "")
15
- .replace(/\/\/[^\n]*/g, "")
16
- .replace(/\s*([{}(),=;+\-*/<>])\s*/g, "$1")
17
- .replace(/\s+/g, " ")
18
- .trim(),
19
- map: null,
20
- };
21
- }
22
- },
23
- },
24
- string({
25
- include: ["**/*.glsl", "**/*.fs", "**/*.vs", "**/*.frag", "**/*.vert"],
26
- }),
27
- typescript({
28
- tsconfig: "tsconfig.json",
29
- useTsconfigDeclarationDir: true,
30
- transformers: [
31
- (service) => ({
32
- before: [minifyPrivatesTransformer.default(service.getProgram())],
33
- after: [],
34
- }),
35
- ],
36
- }),
37
- ];
38
-
39
- export default {
40
- input: {
41
- index: "src/core/index.ts",
42
- "particles/index": "src/particles/index.ts",
43
- },
44
- output: {
45
- dir: "dist",
46
- format: "esm",
47
- preserveModules: true,
48
- preserveModulesRoot: "src",
49
- },
50
- external: ["three", "@lume/kiwi", "ferrsign"],
51
- plugins: sharedPlugins,
52
- };
@@ -1,60 +0,0 @@
1
- import { assertValidPositiveNumber } from "../../miscellaneous/asserts";
2
- import type { UILayerElement, UIPlaneElement } from "../../miscellaneous/shared";
3
- import { UIExpression } from "../../miscellaneous/UIExpression";
4
- import { UISingleParameterConstraint } from "../UISingleParameterConstraint/UISingleParameterConstraint";
5
- import type { UIAspectConstraintOptions } from "./UIAspectConstraint.Internal";
6
-
7
- /** Maintains element aspect ratio (width = height * aspect) */
8
- export class UIAspectConstraint extends UISingleParameterConstraint {
9
- /** Solver constraint descriptor */
10
- protected override readonly constraint: number;
11
-
12
- /** Current aspect ratio */
13
- private aspectInternal: number;
14
-
15
- /**
16
- * @param element Element to constrain
17
- * @param options Aspect configuration. Defaults to element's current ratio.
18
- */
19
- constructor(
20
- private readonly element: UIPlaneElement & UILayerElement,
21
- options: Partial<UIAspectConstraintOptions> = {},
22
- ) {
23
- if (options.aspect !== undefined) {
24
- assertValidPositiveNumber(options.aspect, "UIAspectConstraint.constructor.options.aspect");
25
- }
26
-
27
- super(element.layer, options);
28
-
29
- this.aspectInternal = options.aspect ?? element.width / element.height;
30
- this.constraint = this.solverWrapper.createConstraint(
31
- this.buildLHS(),
32
- new UIExpression(0),
33
- this.relation,
34
- this.priority,
35
- this.isConstraintEnabled(),
36
- );
37
- }
38
-
39
- /** Current aspect ratio (width/height) */
40
- public get aspect(): number {
41
- return this.aspectInternal;
42
- }
43
-
44
- /** Updates aspect ratio */
45
- public set aspect(value: number) {
46
- assertValidPositiveNumber(value, "UIAspectConstraint.aspect");
47
- if (this.aspectInternal !== value) {
48
- this.aspectInternal = value;
49
- this.solverWrapper.setConstraintLHS(this.constraint, this.buildLHS());
50
- }
51
- }
52
-
53
- /** Builds constraint expression: width - (height * aspect) = 0 */
54
- private buildLHS(): UIExpression {
55
- return new UIExpression(0, [
56
- [this.element.wVariable, 1],
57
- [this.element.hVariable, -this.aspectInternal],
58
- ]);
59
- }
60
- }
@@ -1,20 +0,0 @@
1
- import type { UILayer } from "../layers/UILayer/UILayer";
2
- import type { UISolverWrapperView } from "../wrappers/UISolverWrapper/UISolverWrapper.Internal";
3
-
4
- /** Base class for layout constraints */
5
- export abstract class UIConstraint {
6
- /** Optional constraint name */
7
- public name: string;
8
-
9
- /** Constraint solver wrapper */
10
- protected readonly solverWrapper: UISolverWrapperView;
11
-
12
- /** @param layer Layer containing this constraint */
13
- constructor(
14
- public readonly layer: UILayer,
15
- name?: string,
16
- ) {
17
- this.solverWrapper = this.layer.solverWrapper;
18
- this.name = name ?? "";
19
- }
20
- }