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
@@ -1,524 +0,0 @@
1
- import type { InstancedBufferGeometry, ShaderMaterial } from "three";
2
- import { InstancedBufferAttribute, Matrix4, Mesh } from "three";
3
- import type { UITransparencyMode } from "../../UITransparencyMode";
4
- import type { GLProperty, PlaneData } from "../shared";
5
- import {
6
- arePropertiesPartiallyCompatible,
7
- cloneGLProperties,
8
- cloneProperty,
9
- extractZIndexFromBuffer,
10
- resolveGLSLTypeInfo,
11
- resolvePropertyUniform,
12
- } from "../shared";
13
- import {
14
- buildEmptyInstancedBufferAttribute,
15
- buildMaterial,
16
- CAPACITY_STEP,
17
- copyBetweenBuffers,
18
- INITIAL_CAPACITY,
19
- INSTANCED_PLANE_GEOMETRY,
20
- reconstructValue,
21
- shiftBufferRegion,
22
- writePropertyToArray,
23
- } from "./UIGenericInstancedPlane.Internal";
24
-
25
- /**
26
- * Instanced shader plane mesh for batched rendering.
27
- *
28
- * Operates on indices, not handlers. Registry manages handler→index mapping.
29
- * Elements are ordered by zIndex (ascending) within the buffer.
30
- *
31
- * @internal
32
- */
33
- export class UIGenericInstancedPlane extends Mesh {
34
- public readonly source: string;
35
- public readonly transparency: UITransparencyMode;
36
-
37
- private readonly instancedGeometry: InstancedBufferGeometry;
38
- private readonly shaderMaterial: ShaderMaterial;
39
- private readonly uniformProperties: Record<string, GLProperty>;
40
- private readonly varyingProperties: Record<string, GLProperty>;
41
- private readonly propertyBuffers: Map<string, InstancedBufferAttribute>;
42
-
43
- private capacity: number;
44
- private instancesCountInternal: number;
45
-
46
- constructor(
47
- source: string,
48
- properties: Record<string, GLProperty>,
49
- transparency: UITransparencyMode,
50
- initialCapacity: number = INITIAL_CAPACITY,
51
- ) {
52
- const uniformProperties: Record<string, GLProperty> = {};
53
- const varyingProperties: Record<string, GLProperty> = {
54
- instanceVisibility: {
55
- value: 1,
56
- glslTypeInfo: resolveGLSLTypeInfo("number"),
57
- },
58
- instanceTransform: {
59
- value: new Matrix4().identity(),
60
- glslTypeInfo: resolveGLSLTypeInfo("Matrix4"),
61
- },
62
- };
63
-
64
- for (const name in properties) {
65
- const descriptor = properties[name];
66
- if (descriptor.glslTypeInfo.instantiable) {
67
- varyingProperties[name] = descriptor;
68
- } else {
69
- uniformProperties[name] = descriptor;
70
- }
71
- }
72
-
73
- const instancedGeometry = INSTANCED_PLANE_GEOMETRY.clone();
74
- const shaderMaterial = buildMaterial(
75
- source,
76
- uniformProperties,
77
- varyingProperties,
78
- transparency,
79
- );
80
-
81
- super(instancedGeometry, shaderMaterial);
82
-
83
- this.frustumCulled = false;
84
- this.matrixAutoUpdate = false;
85
- this.matrixWorldAutoUpdate = false;
86
-
87
- this.source = source;
88
- this.transparency = transparency;
89
- this.instancedGeometry = instancedGeometry;
90
- this.shaderMaterial = shaderMaterial;
91
- this.uniformProperties = uniformProperties;
92
- this.varyingProperties = varyingProperties;
93
- this.propertyBuffers = new Map();
94
-
95
- this.capacity = Math.max(
96
- Math.ceil(initialCapacity / CAPACITY_STEP) * CAPACITY_STEP,
97
- CAPACITY_STEP,
98
- );
99
- this.instancesCountInternal = 0;
100
- this.instancedGeometry.instanceCount = 0;
101
-
102
- for (const name in this.varyingProperties) {
103
- const { value } = this.varyingProperties[name];
104
- const attribute = buildEmptyInstancedBufferAttribute(value, this.capacity);
105
- this.instancedGeometry.setAttribute(`a_${name}`, attribute);
106
- this.propertyBuffers.set(name, attribute);
107
- }
108
-
109
- for (const name in this.uniformProperties) {
110
- const { value } = this.uniformProperties[name];
111
- const uniform = resolvePropertyUniform(name, this.shaderMaterial);
112
- uniform.value = value;
113
- }
114
- this.shaderMaterial.uniformsNeedUpdate = true;
115
- }
116
-
117
- /** Current number of active instances */
118
- public get instancesCount(): number {
119
- return this.instancesCountInternal;
120
- }
121
-
122
- /**
123
- * Insert instance at given index. Elements at [index..end) are shifted right.
124
- */
125
- public insertAt(
126
- index: number,
127
- properties: Record<string, GLProperty>,
128
- transform: Matrix4,
129
- visibility: boolean,
130
- ): void {
131
- if (index < 0 || index > this.instancesCountInternal) {
132
- throw new Error(
133
- `UIGenericInstancedPlane.insertAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
134
- );
135
- }
136
-
137
- this.ensureCapacity(this.instancesCountInternal + 1);
138
-
139
- if (index < this.instancesCountInternal) {
140
- this.shiftBuffersRight(index, 1);
141
- }
142
-
143
- this.writeToBuffers(index, properties, transform, visibility);
144
-
145
- this.instancesCountInternal++;
146
- this.instancedGeometry.instanceCount = this.instancesCountInternal;
147
- }
148
-
149
- /**
150
- * Remove instance at given index. Elements at [index+1..end) are shifted left.
151
- */
152
- public removeAt(index: number): void {
153
- if (index < 0 || index >= this.instancesCountInternal) {
154
- throw new Error(
155
- `UIGenericInstancedPlane.removeAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
156
- );
157
- }
158
-
159
- if (index < this.instancesCountInternal - 1) {
160
- this.shiftBuffersLeft(index + 1, 1);
161
- }
162
-
163
- this.instancesCountInternal--;
164
- this.instancedGeometry.instanceCount = this.instancesCountInternal;
165
- }
166
-
167
- /** Update properties at given index */
168
- public setPropertiesAt(index: number, properties: Record<string, GLProperty>): void {
169
- if (index < 0 || index >= this.instancesCountInternal) {
170
- throw new Error(
171
- `UIGenericInstancedPlane.setPropertiesAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
172
- );
173
- }
174
-
175
- for (const name in properties) {
176
- const { value, glslTypeInfo } = properties[name];
177
-
178
- if (glslTypeInfo.instantiable) {
179
- const attribute = this.resolveAttribute(name);
180
- const offset = index * attribute.itemSize;
181
- writePropertyToArray(value, attribute.array as Float32Array, offset);
182
- attribute.needsUpdate = true;
183
- } else {
184
- const uniform = resolvePropertyUniform(name, this.shaderMaterial);
185
- uniform.value = value;
186
- this.shaderMaterial.uniformsNeedUpdate = true;
187
- }
188
- }
189
- }
190
-
191
- /** Update transform at given index */
192
- public setTransformAt(index: number, transform: Matrix4): void {
193
- if (index < 0 || index >= this.instancesCountInternal) {
194
- throw new Error(
195
- `UIGenericInstancedPlane.setTransformAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
196
- );
197
- }
198
-
199
- const attribute = this.resolveAttribute("instanceTransform");
200
- const array = attribute.array as Float32Array;
201
- const offset = index * 16;
202
-
203
- const elements = transform.elements;
204
- for (let j = 0; j < 16; j++) {
205
- array[offset + j] = elements[j];
206
- }
207
- attribute.needsUpdate = true;
208
- }
209
-
210
- /** Update visibility at given index */
211
- public setVisibilityAt(index: number, visible: boolean): void {
212
- if (index < 0 || index >= this.instancesCountInternal) {
213
- throw new Error(
214
- `UIGenericInstancedPlane.setVisibilityAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
215
- );
216
- }
217
-
218
- const attribute = this.resolveAttribute("instanceVisibility");
219
- const array = attribute.array as Float32Array;
220
- array[index] = visible ? 1 : 0;
221
- attribute.needsUpdate = true;
222
- }
223
-
224
- /**
225
- * Extract complete instance data at given index.
226
- * Returns cloned data safe for external use.
227
- */
228
- public extractDataAt(index: number): PlaneData {
229
- if (index < 0 || index >= this.instancesCountInternal) {
230
- throw new Error(
231
- `UIGenericInstancedPlane.extractDataAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
232
- );
233
- }
234
-
235
- const properties: Record<string, GLProperty> = {};
236
-
237
- for (const name in this.uniformProperties) {
238
- const prop = this.uniformProperties[name];
239
- properties[name] = {
240
- value: cloneProperty(prop.value),
241
- glslTypeInfo: prop.glslTypeInfo,
242
- };
243
- }
244
-
245
- for (const name in this.varyingProperties) {
246
- if (name === "instanceVisibility" || name === "instanceTransform") {
247
- continue;
248
- }
249
-
250
- const { value, glslTypeInfo } = this.varyingProperties[name];
251
- const attribute = this.propertyBuffers.get(name) as InstancedBufferAttribute;
252
- const array = attribute.array as Float32Array;
253
- const offset = index * attribute.itemSize;
254
-
255
- properties[name] = {
256
- value: reconstructValue(value, array, offset),
257
- glslTypeInfo,
258
- };
259
- }
260
-
261
- const transformAttribute = this.propertyBuffers.get(
262
- "instanceTransform",
263
- ) as InstancedBufferAttribute;
264
- const transformArray = transformAttribute.array as Float32Array;
265
- const transform = new Matrix4();
266
- transform.fromArray(transformArray, index * 16);
267
-
268
- const visibilityAttribute = this.propertyBuffers.get(
269
- "instanceVisibility",
270
- ) as InstancedBufferAttribute;
271
- const visibilityArray = visibilityAttribute.array as Float32Array;
272
- const visibility = visibilityArray[index] >= 0.5;
273
-
274
- return {
275
- source: this.source,
276
- properties,
277
- transform,
278
- visibility,
279
- transparency: this.transparency,
280
- };
281
- }
282
-
283
- /** Get zIndex at given index (from transform buffer) */
284
- public getZIndexAt(index: number): number {
285
- if (index < 0 || index >= this.instancesCountInternal) {
286
- throw new Error(
287
- `UIGenericInstancedPlane.getZIndexAt.index: out of bounds (index=${index}, count=${this.instancesCountInternal})`,
288
- );
289
- }
290
-
291
- const attribute = this.propertyBuffers.get("instanceTransform") as InstancedBufferAttribute;
292
- return extractZIndexFromBuffer(attribute.array as Float32Array, index);
293
- }
294
-
295
- /**
296
- * Merge another instanced plane into this one (append).
297
- * Other plane becomes empty after merge.
298
- */
299
- public merge(other: UIGenericInstancedPlane): void {
300
- if (other.instancesCountInternal === 0) {
301
- return;
302
- }
303
-
304
- this.ensureCapacity(this.instancesCountInternal + other.instancesCountInternal);
305
-
306
- for (const [name, thisAttribute] of this.propertyBuffers) {
307
- const otherAttribute = other.propertyBuffers.get(name);
308
- if (!otherAttribute) {
309
- throw new Error(`UIGenericInstancedPlane.merge: missing attribute ${name} in source`);
310
- }
311
-
312
- const itemSize = thisAttribute.itemSize;
313
- const srcArray = otherAttribute.array as Float32Array;
314
- const dstArray = thisAttribute.array as Float32Array;
315
-
316
- copyBetweenBuffers(
317
- srcArray,
318
- 0,
319
- dstArray,
320
- this.instancesCountInternal * itemSize,
321
- other.instancesCountInternal * itemSize,
322
- );
323
-
324
- thisAttribute.needsUpdate = true;
325
- }
326
-
327
- this.instancesCountInternal += other.instancesCountInternal;
328
- this.instancedGeometry.instanceCount = this.instancesCountInternal;
329
-
330
- other.instancesCountInternal = 0;
331
- other.instancedGeometry.instanceCount = 0;
332
- }
333
-
334
- /**
335
- * Split this plane at given index.
336
- * Returns new plane with elements [atIndex..end).
337
- * This plane keeps elements [0..atIndex).
338
- */
339
- public split(atIndex: number): UIGenericInstancedPlane {
340
- if (atIndex <= 0 || atIndex >= this.instancesCountInternal) {
341
- throw new Error(
342
- `UIGenericInstancedPlane.split.atIndex: must be in range (0, count) (atIndex=${atIndex}, count=${this.instancesCountInternal})`,
343
- );
344
- }
345
-
346
- const tailCount = this.instancesCountInternal - atIndex;
347
-
348
- const newPlane = new UIGenericInstancedPlane(
349
- this.source,
350
- cloneGLProperties({
351
- ...this.uniformProperties,
352
- ...this.varyingProperties,
353
- }),
354
- this.transparency,
355
- tailCount,
356
- );
357
-
358
- for (const [name, thisAttribute] of this.propertyBuffers) {
359
- const newAttribute = newPlane.propertyBuffers.get(name);
360
- if (!newAttribute) {
361
- throw new Error(`UIGenericInstancedPlane.split: missing attribute ${name} in new plane`);
362
- }
363
-
364
- const itemSize = thisAttribute.itemSize;
365
- const srcArray = thisAttribute.array as Float32Array;
366
- const dstArray = newAttribute.array as Float32Array;
367
-
368
- copyBetweenBuffers(srcArray, atIndex * itemSize, dstArray, 0, tailCount * itemSize);
369
-
370
- newAttribute.needsUpdate = true;
371
- }
372
-
373
- newPlane.instancesCountInternal = tailCount;
374
- newPlane.instancedGeometry.instanceCount = tailCount;
375
-
376
- this.instancesCountInternal = atIndex;
377
- this.instancedGeometry.instanceCount = atIndex;
378
-
379
- return newPlane;
380
- }
381
-
382
- /**
383
- * Check if this plane can accept elements with given parameters.
384
- */
385
- public isCompatibleWith(
386
- source: string,
387
- properties: Record<string, GLProperty>,
388
- transparency: UITransparencyMode,
389
- ): boolean {
390
- if (this.source !== source) {
391
- return false;
392
- }
393
-
394
- if (this.transparency !== transparency) {
395
- return false;
396
- }
397
-
398
- const result = arePropertiesPartiallyCompatible(
399
- { ...this.uniformProperties, ...this.varyingProperties },
400
- properties,
401
- );
402
-
403
- return result;
404
- }
405
-
406
- /** Get all properties configuration (for compatibility checks) */
407
- public getProperties(): Record<string, GLProperty> {
408
- return { ...this.uniformProperties, ...this.varyingProperties };
409
- }
410
-
411
- /** Remove all instances, reset to empty state */
412
- public clearInstances(): void {
413
- this.instancesCountInternal = 0;
414
- this.instancedGeometry.instanceCount = 0;
415
- }
416
-
417
- /** Dispose geometry, material, and clear buffers */
418
- public destroy(): void {
419
- this.instancedGeometry.dispose();
420
- this.shaderMaterial.dispose();
421
- this.propertyBuffers.clear();
422
- }
423
-
424
- private ensureCapacity(requiredCapacity: number): void {
425
- if (requiredCapacity <= this.capacity) {
426
- return;
427
- }
428
-
429
- const newCapacity = Math.ceil(requiredCapacity / CAPACITY_STEP) * CAPACITY_STEP;
430
-
431
- for (const [name, oldAttribute] of this.propertyBuffers) {
432
- const itemSize = oldAttribute.itemSize;
433
- const newArray = new Float32Array(newCapacity * itemSize);
434
- newArray.set(oldAttribute.array as Float32Array);
435
-
436
- const newAttribute = new InstancedBufferAttribute(newArray, itemSize);
437
- this.instancedGeometry.setAttribute(`a_${name}`, newAttribute);
438
- this.propertyBuffers.set(name, newAttribute);
439
- }
440
-
441
- this.capacity = newCapacity;
442
- }
443
-
444
- private shiftBuffersRight(fromIndex: number, delta: number): void {
445
- const elementsToMove = this.instancesCountInternal - fromIndex;
446
- if (elementsToMove <= 0) {
447
- return;
448
- }
449
-
450
- for (const attribute of this.propertyBuffers.values()) {
451
- shiftBufferRegion(
452
- attribute.array as Float32Array,
453
- attribute.itemSize,
454
- fromIndex,
455
- elementsToMove,
456
- delta,
457
- );
458
- attribute.needsUpdate = true;
459
- }
460
- }
461
-
462
- private shiftBuffersLeft(fromIndex: number, delta: number): void {
463
- const elementsToMove = this.instancesCountInternal - fromIndex;
464
- if (elementsToMove <= 0) {
465
- return;
466
- }
467
-
468
- for (const attribute of this.propertyBuffers.values()) {
469
- shiftBufferRegion(
470
- attribute.array as Float32Array,
471
- attribute.itemSize,
472
- fromIndex,
473
- elementsToMove,
474
- -delta,
475
- );
476
- attribute.needsUpdate = true;
477
- }
478
- }
479
-
480
- private writeToBuffers(
481
- index: number,
482
- properties: Record<string, GLProperty>,
483
- transform: Matrix4,
484
- visibility: boolean,
485
- ): void {
486
- const visibilityAttribute = this.resolveAttribute("instanceVisibility");
487
- (visibilityAttribute.array as Float32Array)[index] = visibility ? 1 : 0;
488
- visibilityAttribute.needsUpdate = true;
489
-
490
- const transformAttribute = this.resolveAttribute("instanceTransform");
491
- const transformArray = transformAttribute.array as Float32Array;
492
- const transformOffset = index * 16;
493
- const elements = transform.elements;
494
- for (let j = 0; j < 16; j++) {
495
- transformArray[transformOffset + j] = elements[j];
496
- }
497
- transformAttribute.needsUpdate = true;
498
-
499
- for (const name in properties) {
500
- const { value, glslTypeInfo } = properties[name];
501
-
502
- if (glslTypeInfo.instantiable) {
503
- const attribute = this.propertyBuffers.get(name);
504
- if (attribute) {
505
- const offset = index * attribute.itemSize;
506
- writePropertyToArray(value, attribute.array as Float32Array, offset);
507
- attribute.needsUpdate = true;
508
- }
509
- } else {
510
- const uniform = resolvePropertyUniform(name, this.shaderMaterial);
511
- uniform.value = value;
512
- this.shaderMaterial.uniformsNeedUpdate = true;
513
- }
514
- }
515
- }
516
-
517
- private resolveAttribute(name: string): InstancedBufferAttribute {
518
- const attribute = this.propertyBuffers.get(name);
519
- if (attribute === undefined) {
520
- throw new Error(`UIGenericInstancedPlane.resolveAttribute.name: unknown attribute "${name}"`);
521
- }
522
- return attribute;
523
- }
524
- }