laymur 0.17.0 → 0.17.1

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 (395) hide show
  1. package/{src/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.ts → dist/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts} +2 -3
  2. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +22 -0
  3. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.js +41 -0
  4. package/dist/core/constraints/UIConstraint.d.ts +12 -0
  5. package/dist/core/constraints/UIConstraint.js +11 -0
  6. package/dist/core/constraints/UICustomConstraint.d.ts +28 -0
  7. package/dist/core/constraints/UICustomConstraint.js +37 -0
  8. package/{src/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.ts → dist/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts} +2 -3
  9. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +20 -0
  10. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.js +34 -0
  11. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +11 -0
  12. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.js +3 -0
  13. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +36 -0
  14. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.js +100 -0
  15. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +14 -0
  16. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.js +4 -0
  17. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +44 -0
  18. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.js +136 -0
  19. package/{src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.ts → dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts} +2 -3
  20. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +22 -0
  21. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.js +40 -0
  22. package/{src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.ts → dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts} +8 -9
  23. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +43 -0
  24. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.js +71 -0
  25. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +11 -0
  26. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.js +3 -0
  27. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +32 -0
  28. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.js +100 -0
  29. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +14 -0
  30. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.js +4 -0
  31. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +44 -0
  32. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.js +136 -0
  33. package/{src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.ts → dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts} +2 -3
  34. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +22 -0
  35. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.js +40 -0
  36. package/{src/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.ts → dist/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts} +2 -3
  37. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +20 -0
  38. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.js +34 -0
  39. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +64 -0
  40. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.js +19 -0
  41. package/dist/core/constraints/builders/UIConstraint2DBuilder.d.ts +46 -0
  42. package/dist/core/constraints/builders/UIConstraint2DBuilder.js +138 -0
  43. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +13 -0
  44. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.js +3 -0
  45. package/dist/core/constraints/builders/UICoverConstraintBuilder.d.ts +29 -0
  46. package/dist/core/constraints/builders/UICoverConstraintBuilder.js +63 -0
  47. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +13 -0
  48. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.js +3 -0
  49. package/dist/core/constraints/builders/UIFitConstraintBuilder.d.ts +29 -0
  50. package/dist/core/constraints/builders/UIFitConstraintBuilder.js +63 -0
  51. package/dist/core/elements/UIAnchor/UIAnchor.Internal.d.ts +12 -0
  52. package/dist/core/elements/UIAnchor/UIAnchor.Internal.js +5 -0
  53. package/dist/core/elements/UIAnchor/UIAnchor.d.ts +32 -0
  54. package/dist/core/elements/UIAnchor/UIAnchor.js +49 -0
  55. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +27 -0
  56. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.js +15 -0
  57. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.d.ts +77 -0
  58. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.js +259 -0
  59. package/dist/core/elements/UIDummy/UIDummy.Internal.d.ts +30 -0
  60. package/dist/core/elements/UIDummy/UIDummy.Internal.js +8 -0
  61. package/dist/core/elements/UIDummy/UIDummy.d.ts +82 -0
  62. package/dist/core/elements/UIDummy/UIDummy.js +173 -0
  63. package/{src/core/elements/UIElement/UIElement.Internal.ts → dist/core/elements/UIElement/UIElement.Internal.d.ts} +5 -7
  64. package/dist/core/elements/UIElement/UIElement.Internal.js +5 -0
  65. package/dist/core/elements/UIElement/UIElement.d.ts +38 -0
  66. package/dist/core/elements/UIElement/UIElement.js +74 -0
  67. package/{src/core/elements/UIGraphics/UIGraphics.Internal.ts → dist/core/elements/UIGraphics/UIGraphics.Internal.d.ts} +5 -7
  68. package/dist/core/elements/UIGraphics/UIGraphics.Internal.js +7 -0
  69. package/dist/core/elements/UIGraphics/UIGraphics.d.ts +51 -0
  70. package/dist/core/elements/UIGraphics/UIGraphics.js +126 -0
  71. package/{src/core/elements/UIImage/UIImage.Internal.ts → dist/core/elements/UIImage/UIImage.Internal.d.ts} +2 -3
  72. package/dist/core/elements/UIImage/UIImage.d.ts +32 -0
  73. package/dist/core/elements/UIImage/UIImage.js +85 -0
  74. package/dist/core/elements/UINineSlice/UINineSlice.Internal.d.ts +23 -0
  75. package/dist/core/elements/UINineSlice/UINineSlice.Internal.js +12 -0
  76. package/dist/core/elements/UINineSlice/UINineSlice.d.ts +60 -0
  77. package/dist/core/elements/UINineSlice/UINineSlice.js +188 -0
  78. package/dist/core/elements/UIProgress/UIProgress.Internal.d.ts +14 -0
  79. package/dist/core/elements/UIProgress/UIProgress.Internal.js +3 -0
  80. package/dist/core/elements/UIProgress/UIProgress.d.ts +45 -0
  81. package/dist/core/elements/UIProgress/UIProgress.js +165 -0
  82. package/dist/core/elements/UIScene/UIScene.Internal.d.ts +43 -0
  83. package/dist/core/elements/UIScene/UIScene.Internal.js +27 -0
  84. package/dist/core/elements/UIScene/UIScene.d.ts +59 -0
  85. package/dist/core/elements/UIScene/UIScene.js +157 -0
  86. package/{src/core/elements/UIText/UIText.Interfaces.ts → dist/core/elements/UIText/UIText.Interfaces.d.ts} +16 -21
  87. package/dist/core/elements/UIText/UIText.Internal.d.ts +26 -0
  88. package/dist/core/elements/UIText/UIText.Internal.js +12 -0
  89. package/dist/core/elements/UIText/UIText.Measuring.d.ts +50 -0
  90. package/dist/core/elements/UIText/UIText.Measuring.js +153 -0
  91. package/dist/core/elements/UIText/UIText.Rendering.d.ts +20 -0
  92. package/dist/core/elements/UIText/UIText.Rendering.js +61 -0
  93. package/dist/core/elements/UIText/UIText.d.ts +71 -0
  94. package/dist/core/elements/UIText/UIText.js +265 -0
  95. package/{src/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.ts → dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts} +11 -14
  96. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.js +5 -0
  97. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +63 -0
  98. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.js +147 -0
  99. package/{src/core/layers/UILayer/UILayer.Internal.ts → dist/core/layers/UILayer/UILayer.Internal.d.ts} +11 -15
  100. package/dist/core/layers/UILayer/UILayer.Internal.js +7 -0
  101. package/dist/core/layers/UILayer/UILayer.d.ts +49 -0
  102. package/dist/core/layers/UILayer/UILayer.js +113 -0
  103. package/dist/core/miscellaneous/UIExpression.d.ts +69 -0
  104. package/dist/core/miscellaneous/UIExpression.js +128 -0
  105. package/dist/core/miscellaneous/UIMode.d.ts +23 -0
  106. package/dist/core/miscellaneous/UIMode.js +30 -0
  107. package/dist/core/miscellaneous/UIOrientation.d.ts +15 -0
  108. package/dist/core/miscellaneous/UIOrientation.js +20 -0
  109. package/dist/core/miscellaneous/UIPriority.d.ts +32 -0
  110. package/dist/core/miscellaneous/UIPriority.js +63 -0
  111. package/dist/core/miscellaneous/UIRelation.d.ts +23 -0
  112. package/dist/core/miscellaneous/UIRelation.js +40 -0
  113. package/dist/core/miscellaneous/UITransparencyMode.d.ts +9 -0
  114. package/dist/core/miscellaneous/UITransparencyMode.js +12 -0
  115. package/dist/core/miscellaneous/area/UIArea.d.ts +3 -0
  116. package/dist/core/miscellaneous/area/UIArea.js +5 -0
  117. package/dist/core/miscellaneous/area/UIAreaCircle.d.ts +15 -0
  118. package/dist/core/miscellaneous/area/UIAreaCircle.js +32 -0
  119. package/dist/core/miscellaneous/area/UIAreaPolygon.d.ts +12 -0
  120. package/dist/core/miscellaneous/area/UIAreaPolygon.js +40 -0
  121. package/dist/core/miscellaneous/area/UIAreaRectangle.d.ts +17 -0
  122. package/dist/core/miscellaneous/area/UIAreaRectangle.js +36 -0
  123. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.d.ts +21 -0
  124. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.js +72 -0
  125. package/dist/core/miscellaneous/asserts.d.ts +43 -0
  126. package/dist/core/miscellaneous/asserts.js +163 -0
  127. package/dist/core/miscellaneous/canvas.d.ts +31 -0
  128. package/dist/core/miscellaneous/canvas.js +37 -0
  129. package/dist/core/miscellaneous/color/UIColor.Internal.d.ts +7 -0
  130. package/dist/core/miscellaneous/color/UIColor.Internal.js +42 -0
  131. package/dist/core/miscellaneous/color/UIColor.d.ts +234 -0
  132. package/dist/core/miscellaneous/color/UIColor.js +636 -0
  133. package/dist/core/miscellaneous/computeTransform.d.ts +18 -0
  134. package/dist/core/miscellaneous/computeTransform.js +82 -0
  135. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +19 -0
  136. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.js +168 -0
  137. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.d.ts +1 -0
  138. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.js +349 -0
  139. package/{src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.ts → dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts} +8 -10
  140. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.d.ts +1 -0
  141. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.js +357 -0
  142. package/dist/core/miscellaneous/generic-plane/shared.d.ts +38 -0
  143. package/dist/core/miscellaneous/generic-plane/shared.js +228 -0
  144. package/dist/core/miscellaneous/insets/UIInsets.Internal.d.ts +11 -0
  145. package/dist/core/miscellaneous/insets/UIInsets.Internal.js +3 -0
  146. package/dist/core/miscellaneous/insets/UIInsets.d.ts +48 -0
  147. package/dist/core/miscellaneous/insets/UIInsets.js +224 -0
  148. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunction.d.ts +9 -0
  149. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunction.js +19 -0
  150. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +21 -0
  151. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.js +51 -0
  152. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +16 -0
  153. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.js +48 -0
  154. package/dist/core/miscellaneous/math.d.ts +7 -0
  155. package/dist/core/miscellaneous/math.js +11 -0
  156. package/dist/core/miscellaneous/micro/UIMicro.Internal.d.ts +31 -0
  157. package/dist/core/miscellaneous/micro/UIMicro.Internal.js +15 -0
  158. package/dist/core/miscellaneous/micro/UIMicro.d.ts +59 -0
  159. package/dist/core/miscellaneous/micro/UIMicro.js +181 -0
  160. package/dist/core/miscellaneous/resize-policy/UIResizePolicy.d.ts +3 -0
  161. package/dist/core/miscellaneous/resize-policy/UIResizePolicy.js +9 -0
  162. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +22 -0
  163. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.js +50 -0
  164. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +22 -0
  165. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.js +52 -0
  166. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +22 -0
  167. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.js +52 -0
  168. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +22 -0
  169. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.js +50 -0
  170. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +22 -0
  171. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.js +52 -0
  172. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +22 -0
  173. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.js +52 -0
  174. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +5 -0
  175. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.js +13 -0
  176. package/dist/core/miscellaneous/shared.d.ts +46 -0
  177. package/dist/core/miscellaneous/shared.js +37 -0
  178. package/{src/core/miscellaneous/text-span/UITextSpan.Internal.ts → dist/core/miscellaneous/text-span/UITextSpan.Internal.d.ts} +4 -5
  179. package/dist/core/miscellaneous/text-span/UITextSpan.d.ts +14 -0
  180. package/dist/core/miscellaneous/text-span/UITextSpan.js +36 -0
  181. package/dist/core/miscellaneous/text-style/UITextStyle.Internal.d.ts +48 -0
  182. package/dist/core/miscellaneous/text-style/UITextStyle.Internal.js +17 -0
  183. package/dist/core/miscellaneous/text-style/UITextStyle.d.ts +85 -0
  184. package/dist/core/miscellaneous/text-style/UITextStyle.js +372 -0
  185. package/dist/core/miscellaneous/texture/UITextureView.Internal.d.ts +49 -0
  186. package/dist/core/miscellaneous/texture/UITextureView.Internal.js +6 -0
  187. package/dist/core/miscellaneous/texture/UITextureView.d.ts +67 -0
  188. package/dist/core/miscellaneous/texture/UITextureView.js +234 -0
  189. package/dist/core/miscellaneous/webglCapabilities.d.ts +2 -0
  190. package/dist/core/miscellaneous/webglCapabilities.js +103 -0
  191. package/dist/core/shaders/UIImage.glsl.js +3 -0
  192. package/dist/core/shaders/UINineSlice.glsl.js +3 -0
  193. package/dist/core/shaders/UIProgress.glsl.js +3 -0
  194. package/dist/core/shaders/UIProgressMaskFunctionCircular.glsl.js +3 -0
  195. package/dist/core/shaders/UIProgressMaskFunctionDirectional.glsl.js +3 -0
  196. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +17 -0
  197. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.d.ts +13 -0
  198. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.js +108 -0
  199. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +13 -0
  200. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.d.ts +20 -0
  201. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.js +75 -0
  202. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +49 -0
  203. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.d.ts +215 -0
  204. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.js +505 -0
  205. package/dist/index.js +51 -0
  206. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.d.ts +21 -0
  207. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.js +47 -0
  208. package/dist/particles/behaviorModules/UIBehaviorModule.d.ts +14 -0
  209. package/dist/particles/behaviorModules/UIBehaviorModule.js +9 -0
  210. package/dist/particles/behaviorModules/UIBehaviorPointGravity.d.ts +39 -0
  211. package/dist/particles/behaviorModules/UIBehaviorPointGravity.js +110 -0
  212. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.d.ts +22 -0
  213. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.js +66 -0
  214. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.d.ts +20 -0
  215. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.js +48 -0
  216. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.d.ts +26 -0
  217. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.js +66 -0
  218. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.d.ts +20 -0
  219. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.js +49 -0
  220. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.d.ts +26 -0
  221. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.js +70 -0
  222. package/dist/particles/elements/UIEmitter.Internal.d.ts +15 -0
  223. package/dist/particles/elements/UIEmitter.Internal.js +11 -0
  224. package/dist/particles/elements/UIEmitter.d.ts +68 -0
  225. package/dist/particles/elements/UIEmitter.js +203 -0
  226. package/dist/particles/index.js +18 -0
  227. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.d.ts +13 -0
  228. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.js +211 -0
  229. package/dist/particles/instancedParticle/UIInstancedParticle.d.ts +17 -0
  230. package/dist/particles/instancedParticle/UIInstancedParticle.js +93 -0
  231. package/dist/particles/miscellaneous/miscellaneous.d.ts +32 -0
  232. package/dist/particles/miscellaneous/miscellaneous.js +67 -0
  233. package/dist/particles/renderingModules/UIRenderingColorOverLife.d.ts +14 -0
  234. package/dist/particles/renderingModules/UIRenderingColorOverLife.js +32 -0
  235. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.d.ts +15 -0
  236. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.js +37 -0
  237. package/dist/particles/renderingModules/UIRenderingModule.d.ts +8 -0
  238. package/dist/particles/renderingModules/UIRenderingModule.js +9 -0
  239. package/dist/particles/renderingModules/UIRenderingTexture.d.ts +14 -0
  240. package/dist/particles/renderingModules/UIRenderingTexture.js +26 -0
  241. package/dist/particles/shaders/UIRenderingColorOverLife.glsl.js +3 -0
  242. package/dist/particles/shaders/UIRenderingColorOverVelocity.glsl.js +3 -0
  243. package/dist/particles/shaders/UIRenderingTexture.glsl.js +3 -0
  244. package/dist/particles/spawnModules/UISpawnModule.d.ts +9 -0
  245. package/dist/particles/spawnModules/UISpawnModule.js +9 -0
  246. package/dist/particles/spawnModules/UISpawnOffset.d.ts +21 -0
  247. package/dist/particles/spawnModules/UISpawnOffset.js +46 -0
  248. package/dist/particles/spawnModules/UISpawnRandomLifetime.d.ts +20 -0
  249. package/dist/particles/spawnModules/UISpawnRandomLifetime.js +47 -0
  250. package/dist/particles/spawnModules/UISpawnRandomRotation.d.ts +20 -0
  251. package/dist/particles/spawnModules/UISpawnRandomRotation.js +45 -0
  252. package/dist/particles/spawnModules/UISpawnRandomScale.d.ts +26 -0
  253. package/dist/particles/spawnModules/UISpawnRandomScale.js +60 -0
  254. package/dist/particles/spawnModules/UISpawnRandomTorque.d.ts +20 -0
  255. package/dist/particles/spawnModules/UISpawnRandomTorque.js +45 -0
  256. package/dist/particles/spawnModules/UISpawnRandomVelocity.d.ts +26 -0
  257. package/dist/particles/spawnModules/UISpawnRandomVelocity.js +64 -0
  258. package/dist/particles/spawnModules/UISpawnRectangle.d.ts +27 -0
  259. package/dist/particles/spawnModules/UISpawnRectangle.js +62 -0
  260. package/package.json +8 -1
  261. package/.claude/settings.local.json +0 -9
  262. package/.editorconfig +0 -14
  263. package/CLAUDE.md +0 -181
  264. package/assets/logotype.png +0 -0
  265. package/eslint.config.js +0 -111
  266. package/rollup.config.js +0 -52
  267. package/src/core/constraints/UIAspectConstraint/UIAspectConstraint.ts +0 -60
  268. package/src/core/constraints/UIConstraint.ts +0 -20
  269. package/src/core/constraints/UICustomConstraint.ts +0 -62
  270. package/src/core/constraints/UIHeightConstraint/UIHeightConstraint.ts +0 -52
  271. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.ts +0 -13
  272. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.ts +0 -139
  273. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.ts +0 -16
  274. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.ts +0 -189
  275. package/src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.ts +0 -68
  276. package/src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.ts +0 -94
  277. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.ts +0 -13
  278. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.ts +0 -135
  279. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.ts +0 -16
  280. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.ts +0 -189
  281. package/src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.ts +0 -68
  282. package/src/core/constraints/UIWidthConstraint/UIWidthConstraint.ts +0 -52
  283. package/src/core/constraints/builders/UIConstraint2DBuilder.Internal.ts +0 -84
  284. package/src/core/constraints/builders/UIConstraint2DBuilder.ts +0 -168
  285. package/src/core/constraints/builders/UICoverConstraintBuilder.Internal.ts +0 -15
  286. package/src/core/constraints/builders/UICoverConstraintBuilder.ts +0 -84
  287. package/src/core/constraints/builders/UIFitConstraintBuilder.Internal.ts +0 -15
  288. package/src/core/constraints/builders/UIFitConstraintBuilder.ts +0 -84
  289. package/src/core/elements/UIAnchor/UIAnchor.Internal.ts +0 -13
  290. package/src/core/elements/UIAnchor/UIAnchor.ts +0 -70
  291. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.ts +0 -30
  292. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.ts +0 -355
  293. package/src/core/elements/UIDummy/UIDummy.Internal.ts +0 -33
  294. package/src/core/elements/UIDummy/UIDummy.ts +0 -244
  295. package/src/core/elements/UIElement/UIElement.ts +0 -127
  296. package/src/core/elements/UIGraphics/UIGraphics.ts +0 -168
  297. package/src/core/elements/UIImage/UIImage.ts +0 -138
  298. package/src/core/elements/UINineSlice/UINineSlice.Internal.ts +0 -26
  299. package/src/core/elements/UINineSlice/UINineSlice.ts +0 -296
  300. package/src/core/elements/UIProgress/UIProgress.Internal.ts +0 -24
  301. package/src/core/elements/UIProgress/UIProgress.ts +0 -259
  302. package/src/core/elements/UIScene/UIScene.Internal.ts +0 -46
  303. package/src/core/elements/UIScene/UIScene.ts +0 -259
  304. package/src/core/elements/UIText/UIText.Internal.ts +0 -29
  305. package/src/core/elements/UIText/UIText.Measuring.ts +0 -183
  306. package/src/core/elements/UIText/UIText.Rendering.ts +0 -83
  307. package/src/core/elements/UIText/UIText.ts +0 -376
  308. package/src/core/layers/UIFullscreenLayer/UIFullscreenLayer.ts +0 -233
  309. package/src/core/layers/UILayer/UILayer.ts +0 -156
  310. package/src/core/miscellaneous/UIExpression.ts +0 -142
  311. package/src/core/miscellaneous/UIMode.ts +0 -29
  312. package/src/core/miscellaneous/UIOrientation.ts +0 -18
  313. package/src/core/miscellaneous/UIPriority.ts +0 -63
  314. package/src/core/miscellaneous/UIRelation.ts +0 -39
  315. package/src/core/miscellaneous/UITransparencyMode.ts +0 -9
  316. package/src/core/miscellaneous/area/UIArea.ts +0 -5
  317. package/src/core/miscellaneous/area/UIAreaCircle.ts +0 -32
  318. package/src/core/miscellaneous/area/UIAreaPolygon.ts +0 -50
  319. package/src/core/miscellaneous/area/UIAreaRectangle.ts +0 -38
  320. package/src/core/miscellaneous/area/UIAreaRoundedRectangle.ts +0 -78
  321. package/src/core/miscellaneous/asserts.ts +0 -187
  322. package/src/core/miscellaneous/canvas.ts +0 -73
  323. package/src/core/miscellaneous/color/UIColor.Internal.ts +0 -89
  324. package/src/core/miscellaneous/color/UIColor.ts +0 -844
  325. package/src/core/miscellaneous/computeTransform.ts +0 -127
  326. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.ts +0 -235
  327. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.ts +0 -524
  328. package/src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.ts +0 -448
  329. package/src/core/miscellaneous/generic-plane/shared.ts +0 -323
  330. package/src/core/miscellaneous/insets/UIInsets.Internal.ts +0 -9
  331. package/src/core/miscellaneous/insets/UIInsets.ts +0 -248
  332. package/src/core/miscellaneous/mask-function/UIProgressMaskFunction.ts +0 -24
  333. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.ts +0 -58
  334. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.ts +0 -52
  335. package/src/core/miscellaneous/math.ts +0 -16
  336. package/src/core/miscellaneous/micro/UIMicro.Internal.ts +0 -33
  337. package/src/core/miscellaneous/micro/UIMicro.ts +0 -222
  338. package/src/core/miscellaneous/resize-policy/UIResizePolicy.ts +0 -8
  339. package/src/core/miscellaneous/resize-policy/UIResizePolicyCover.ts +0 -57
  340. package/src/core/miscellaneous/resize-policy/UIResizePolicyCross.ts +0 -65
  341. package/src/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.ts +0 -65
  342. package/src/core/miscellaneous/resize-policy/UIResizePolicyFit.ts +0 -57
  343. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.ts +0 -65
  344. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.ts +0 -65
  345. package/src/core/miscellaneous/resize-policy/UIResizePolicyNone.ts +0 -11
  346. package/src/core/miscellaneous/shared.ts +0 -73
  347. package/src/core/miscellaneous/text-span/UITextSpan.ts +0 -43
  348. package/src/core/miscellaneous/text-style/UITextStyle.Internal.ts +0 -52
  349. package/src/core/miscellaneous/text-style/UITextStyle.ts +0 -479
  350. package/src/core/miscellaneous/texture/UITextureView.Internal.ts +0 -55
  351. package/src/core/miscellaneous/texture/UITextureView.ts +0 -308
  352. package/src/core/miscellaneous/webglCapabilities.ts +0 -129
  353. package/src/core/shaders/UIImage.glsl +0 -10
  354. package/src/core/shaders/UINineSlice.glsl +0 -53
  355. package/src/core/shaders/UIProgress.glsl +0 -15
  356. package/src/core/shaders/UIProgressMaskFunctionCircular.glsl +0 -13
  357. package/src/core/shaders/UIProgressMaskFunctionDirectional.glsl +0 -12
  358. package/src/core/shaders/glsl.d.ts +0 -27
  359. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.ts +0 -23
  360. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.ts +0 -124
  361. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.ts +0 -22
  362. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.ts +0 -101
  363. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.ts +0 -58
  364. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.ts +0 -605
  365. package/src/particles/behaviorModules/UIBehaviorDirectionalGravity.ts +0 -70
  366. package/src/particles/behaviorModules/UIBehaviorModule.ts +0 -20
  367. package/src/particles/behaviorModules/UIBehaviorPointGravity.ts +0 -173
  368. package/src/particles/behaviorModules/UIBehaviorScaleOverLife.ts +0 -104
  369. package/src/particles/behaviorModules/UIBehaviorTorqueDamping.ts +0 -75
  370. package/src/particles/behaviorModules/UIBehaviorTorqueNoise.ts +0 -115
  371. package/src/particles/behaviorModules/UIBehaviorVelocityDamping.ts +0 -77
  372. package/src/particles/behaviorModules/UIBehaviorVelocityNoise.ts +0 -118
  373. package/src/particles/elements/UIEmitter.Internal.ts +0 -22
  374. package/src/particles/elements/UIEmitter.ts +0 -313
  375. package/src/particles/instancedParticle/UIInstancedParticle.Internal.ts +0 -263
  376. package/src/particles/instancedParticle/UIInstancedParticle.ts +0 -138
  377. package/src/particles/miscellaneous/miscellaneous.ts +0 -115
  378. package/src/particles/renderingModules/UIRenderingColorOverLife.ts +0 -39
  379. package/src/particles/renderingModules/UIRenderingColorOverVelocity.ts +0 -49
  380. package/src/particles/renderingModules/UIRenderingModule.ts +0 -17
  381. package/src/particles/renderingModules/UIRenderingTexture.ts +0 -30
  382. package/src/particles/shaders/UIRenderingColorOverLife.glsl +0 -4
  383. package/src/particles/shaders/UIRenderingColorOverVelocity.glsl +0 -6
  384. package/src/particles/shaders/UIRenderingTexture.glsl +0 -4
  385. package/src/particles/spawnModules/UISpawnModule.ts +0 -22
  386. package/src/particles/spawnModules/UISpawnOffset.ts +0 -62
  387. package/src/particles/spawnModules/UISpawnRandomLifetime.ts +0 -68
  388. package/src/particles/spawnModules/UISpawnRandomRotation.ts +0 -60
  389. package/src/particles/spawnModules/UISpawnRandomScale.ts +0 -81
  390. package/src/particles/spawnModules/UISpawnRandomTorque.ts +0 -62
  391. package/src/particles/spawnModules/UISpawnRandomVelocity.ts +0 -92
  392. package/src/particles/spawnModules/UISpawnRectangle.ts +0 -81
  393. package/tsconfig.json +0 -29
  394. /package/{src/core/index.ts → dist/core/index.d.ts} +0 -0
  395. /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.1",
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
- }