laymur 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. package/README.md +1 -1
  2. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts +1 -1
  3. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.js +1 -0
  4. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +3 -3
  5. package/dist/core/constraints/UIAspectConstraint/UIAspectConstraint.js +14 -16
  6. package/dist/core/constraints/UIConstraint.d.ts +22 -2
  7. package/dist/core/constraints/UIConstraint.js +26 -3
  8. package/dist/core/constraints/UICustomConstraint.d.ts +4 -4
  9. package/dist/core/constraints/UICustomConstraint.js +15 -15
  10. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts +1 -1
  11. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.js +1 -0
  12. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +3 -3
  13. package/dist/core/constraints/UIHeightConstraint/UIHeightConstraint.js +11 -13
  14. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +1 -1
  15. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.js +1 -3
  16. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +3 -3
  17. package/dist/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.js +30 -30
  18. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +1 -1
  19. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.js +2 -4
  20. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +3 -3
  21. package/dist/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.js +40 -39
  22. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts +1 -1
  23. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.js +1 -0
  24. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +3 -3
  25. package/dist/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.js +13 -15
  26. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts +3 -3
  27. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.js +1 -0
  28. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +13 -7
  29. package/dist/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.js +37 -30
  30. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +1 -1
  31. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.js +1 -3
  32. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +3 -3
  33. package/dist/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.js +30 -30
  34. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +1 -1
  35. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.js +2 -4
  36. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +3 -3
  37. package/dist/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.js +40 -39
  38. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts +1 -1
  39. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.js +1 -0
  40. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +3 -3
  41. package/dist/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.js +13 -15
  42. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts +1 -1
  43. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.js +1 -0
  44. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +3 -3
  45. package/dist/core/constraints/UIWidthConstraint/UIWidthConstraint.js +11 -13
  46. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +3 -3
  47. package/dist/core/constraints/builders/UIConstraint2DBuilder.Internal.js +1 -3
  48. package/dist/core/constraints/builders/UIConstraint2DBuilder.d.ts +11 -11
  49. package/dist/core/constraints/builders/UIConstraint2DBuilder.js +10 -13
  50. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +1 -1
  51. package/dist/core/constraints/builders/UICoverConstraintBuilder.Internal.js +1 -3
  52. package/dist/core/constraints/builders/UICoverConstraintBuilder.d.ts +7 -7
  53. package/dist/core/constraints/builders/UICoverConstraintBuilder.js +10 -13
  54. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +1 -1
  55. package/dist/core/constraints/builders/UIFitConstraintBuilder.Internal.js +1 -3
  56. package/dist/core/constraints/builders/UIFitConstraintBuilder.d.ts +7 -7
  57. package/dist/core/constraints/builders/UIFitConstraintBuilder.js +10 -13
  58. package/dist/core/elements/UIAnchor/UIAnchor.Internal.js +3 -5
  59. package/dist/core/elements/UIAnchor/UIAnchor.d.ts +23 -5
  60. package/dist/core/elements/UIAnchor/UIAnchor.js +42 -8
  61. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +2 -2
  62. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.js +4 -6
  63. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.d.ts +10 -10
  64. package/dist/core/elements/UIAnimatedImage/UIAnimatedImage.js +108 -111
  65. package/dist/core/elements/UIDummy/UIDummy.Internal.d.ts +4 -4
  66. package/dist/core/elements/UIDummy/UIDummy.Internal.js +5 -8
  67. package/dist/core/elements/UIDummy/UIDummy.d.ts +19 -11
  68. package/dist/core/elements/UIDummy/UIDummy.js +59 -42
  69. package/dist/core/elements/UIElement/UIElement.Internal.d.ts +5 -5
  70. package/dist/core/elements/UIElement/UIElement.Internal.js +9 -12
  71. package/dist/core/elements/UIElement/UIElement.d.ts +11 -11
  72. package/dist/core/elements/UIElement/UIElement.js +57 -60
  73. package/dist/core/elements/UIGraphics/UIGraphics.Internal.d.ts +3 -3
  74. package/dist/core/elements/UIGraphics/UIGraphics.Internal.js +4 -7
  75. package/dist/core/elements/UIGraphics/UIGraphics.d.ts +7 -7
  76. package/dist/core/elements/UIGraphics/UIGraphics.js +44 -47
  77. package/dist/core/elements/UIImage/UIImage.Internal.d.ts +2 -2
  78. package/dist/core/elements/UIImage/UIImage.Internal.js +1 -0
  79. package/dist/core/elements/UIImage/UIImage.d.ts +9 -9
  80. package/dist/core/elements/UIImage/UIImage.js +21 -24
  81. package/dist/core/elements/UINineSlice/UINineSlice.Internal.d.ts +3 -3
  82. package/dist/core/elements/UINineSlice/UINineSlice.Internal.js +3 -5
  83. package/dist/core/elements/UINineSlice/UINineSlice.d.ts +12 -12
  84. package/dist/core/elements/UINineSlice/UINineSlice.js +71 -73
  85. package/dist/core/elements/UIProgress/UIProgress.Internal.d.ts +3 -4
  86. package/dist/core/elements/UIProgress/UIProgress.Internal.js +1 -3
  87. package/dist/core/elements/UIProgress/UIProgress.d.ts +10 -10
  88. package/dist/core/elements/UIProgress/UIProgress.js +59 -62
  89. package/dist/core/elements/UIScene/UIScene.Internal.d.ts +3 -3
  90. package/dist/core/elements/UIScene/UIScene.Internal.js +11 -14
  91. package/dist/core/elements/UIScene/UIScene.d.ts +8 -8
  92. package/dist/core/elements/UIScene/UIScene.js +68 -69
  93. package/dist/core/elements/UIText/UIText.Bidi.d.ts +2 -2
  94. package/dist/core/elements/UIText/UIText.Bidi.js +3 -5
  95. package/dist/core/elements/UIText/UIText.Interfaces.d.ts +6 -2
  96. package/dist/core/elements/UIText/UIText.Interfaces.js +1 -0
  97. package/dist/core/elements/UIText/UIText.Internal.d.ts +4 -4
  98. package/dist/core/elements/UIText/UIText.Internal.js +5 -7
  99. package/dist/core/elements/UIText/UIText.Measuring.d.ts +14 -7
  100. package/dist/core/elements/UIText/UIText.Measuring.js +115 -55
  101. package/dist/core/elements/UIText/UIText.Rendering.d.ts +3 -3
  102. package/dist/core/elements/UIText/UIText.Rendering.js +6 -9
  103. package/dist/core/elements/UIText/UIText.d.ts +28 -14
  104. package/dist/core/elements/UIText/UIText.js +181 -141
  105. package/dist/core/index.d.ts +55 -54
  106. package/dist/core/index.js +53 -0
  107. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts +4 -4
  108. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.js +2 -5
  109. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +4 -4
  110. package/dist/core/layers/UIFullscreenLayer/UIFullscreenLayer.js +43 -42
  111. package/dist/core/layers/UILayer/UILayer.Internal.d.ts +2 -2
  112. package/dist/core/layers/UILayer/UILayer.Internal.js +4 -7
  113. package/dist/core/layers/UILayer/UILayer.d.ts +19 -4
  114. package/dist/core/layers/UILayer/UILayer.js +125 -62
  115. package/dist/core/miscellaneous/UIBlendMode.js +1 -3
  116. package/dist/core/miscellaneous/UIExpression.js +16 -19
  117. package/dist/core/miscellaneous/UIMode.js +3 -5
  118. package/dist/core/miscellaneous/UIOrientation.js +2 -4
  119. package/dist/core/miscellaneous/UIPriority.js +5 -8
  120. package/dist/core/miscellaneous/UIRelation.js +5 -8
  121. package/dist/core/miscellaneous/UITransparencyMode.js +1 -3
  122. package/dist/core/miscellaneous/area/UIArea.js +1 -3
  123. package/dist/core/miscellaneous/area/UIAreaCircle.d.ts +1 -1
  124. package/dist/core/miscellaneous/area/UIAreaCircle.js +3 -6
  125. package/dist/core/miscellaneous/area/UIAreaPolygon.d.ts +2 -2
  126. package/dist/core/miscellaneous/area/UIAreaPolygon.js +3 -6
  127. package/dist/core/miscellaneous/area/UIAreaRectangle.d.ts +1 -1
  128. package/dist/core/miscellaneous/area/UIAreaRectangle.js +3 -6
  129. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.d.ts +1 -1
  130. package/dist/core/miscellaneous/area/UIAreaRoundedRectangle.js +3 -6
  131. package/dist/core/miscellaneous/asserts.d.ts +20 -1
  132. package/dist/core/miscellaneous/asserts.js +71 -19
  133. package/dist/core/miscellaneous/canvas.js +13 -7
  134. package/dist/core/miscellaneous/color/UIColor.Internal.d.ts +1 -1
  135. package/dist/core/miscellaneous/color/UIColor.Internal.js +1 -3
  136. package/dist/core/miscellaneous/color/UIColor.d.ts +1 -1
  137. package/dist/core/miscellaneous/color/UIColor.js +202 -205
  138. package/dist/core/miscellaneous/computeTransform.d.ts +1 -1
  139. package/dist/core/miscellaneous/computeTransform.js +4 -7
  140. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +2 -2
  141. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.js +13 -16
  142. package/dist/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.js +115 -118
  143. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts +3 -3
  144. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.js +1 -0
  145. package/dist/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.js +208 -114
  146. package/dist/core/miscellaneous/generic-plane/shared.d.ts +2 -2
  147. package/dist/core/miscellaneous/generic-plane/shared.js +16 -19
  148. package/dist/core/miscellaneous/insets/UIInsets.Internal.js +1 -3
  149. package/dist/core/miscellaneous/insets/UIInsets.d.ts +1 -1
  150. package/dist/core/miscellaneous/insets/UIInsets.js +96 -99
  151. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunction.js +1 -3
  152. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +1 -1
  153. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.js +14 -17
  154. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +2 -2
  155. package/dist/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.js +13 -16
  156. package/dist/core/miscellaneous/math.js +3 -5
  157. package/dist/core/miscellaneous/micro/UIMicro.Internal.js +6 -8
  158. package/dist/core/miscellaneous/micro/UIMicro.d.ts +1 -1
  159. package/dist/core/miscellaneous/micro/UIMicro.js +91 -94
  160. package/dist/core/miscellaneous/resize-policy/UIResizePolicy.js +1 -3
  161. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +1 -1
  162. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCover.js +12 -15
  163. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +1 -1
  164. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCross.js +13 -16
  165. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +1 -1
  166. package/dist/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.js +13 -16
  167. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +1 -1
  168. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFit.js +12 -15
  169. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +1 -1
  170. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.js +13 -16
  171. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +1 -1
  172. package/dist/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.js +13 -16
  173. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +1 -1
  174. package/dist/core/miscellaneous/resize-policy/UIResizePolicyNone.js +3 -6
  175. package/dist/core/miscellaneous/shared.d.ts +1 -1
  176. package/dist/core/miscellaneous/shared.js +4 -7
  177. package/dist/core/miscellaneous/text-span/UITextSpan.Internal.d.ts +1 -1
  178. package/dist/core/miscellaneous/text-span/UITextSpan.Internal.js +1 -0
  179. package/dist/core/miscellaneous/text-span/UITextSpan.d.ts +2 -2
  180. package/dist/core/miscellaneous/text-span/UITextSpan.js +10 -13
  181. package/dist/core/miscellaneous/text-style/UITextStyle.Internal.js +15 -17
  182. package/dist/core/miscellaneous/text-style/UITextStyle.d.ts +13 -2
  183. package/dist/core/miscellaneous/text-style/UITextStyle.js +222 -207
  184. package/dist/core/miscellaneous/texture/UITextureView.Internal.d.ts +7 -0
  185. package/dist/core/miscellaneous/texture/UITextureView.Internal.js +16 -6
  186. package/dist/core/miscellaneous/texture/UITextureView.d.ts +1 -1
  187. package/dist/core/miscellaneous/texture/UITextureView.js +113 -117
  188. package/dist/core/miscellaneous/webglCapabilities.js +3 -4
  189. package/dist/core/shaders/UIImage.d.ts +9 -0
  190. package/dist/core/shaders/UIImage.js +14 -0
  191. package/dist/core/shaders/UINineSlice.d.ts +11 -0
  192. package/dist/core/shaders/UINineSlice.js +57 -0
  193. package/dist/core/shaders/UIProgress.d.ts +14 -0
  194. package/dist/core/shaders/UIProgress.js +21 -0
  195. package/dist/core/shaders/UIProgressMaskFunctionCircular.d.ts +2 -0
  196. package/dist/core/shaders/UIProgressMaskFunctionCircular.js +16 -0
  197. package/dist/core/shaders/UIProgressMaskFunctionDirectional.d.ts +2 -0
  198. package/dist/core/shaders/UIProgressMaskFunctionDirectional.js +15 -0
  199. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +4 -0
  200. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.js +1 -0
  201. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.d.ts +7 -1
  202. package/dist/core/wrappers/UIInputWrapper/UIInputWrapper.js +50 -47
  203. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +5 -2
  204. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.js +1 -0
  205. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.d.ts +11 -3
  206. package/dist/core/wrappers/UISceneWrapper/UISceneWrapper.js +42 -26
  207. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +5 -3
  208. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.js +1 -0
  209. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.d.ts +20 -4
  210. package/dist/core/wrappers/UISolverWrapper/UISolverWrapper.js +138 -117
  211. package/dist/debug/UIAspectDebug.d.ts +3 -3
  212. package/dist/debug/UIAspectDebug.js +64 -68
  213. package/dist/debug/UIConstraintDebug.d.ts +1 -1
  214. package/dist/debug/UIConstraintDebug.js +1 -0
  215. package/dist/debug/UIHeightDebug.d.ts +3 -3
  216. package/dist/debug/UIHeightDebug.js +63 -67
  217. package/dist/debug/UIHorizontalDistanceDebug.d.ts +3 -3
  218. package/dist/debug/UIHorizontalDistanceDebug.js +76 -81
  219. package/dist/debug/UIHorizontalInterpolationDebug.d.ts +3 -3
  220. package/dist/debug/UIHorizontalInterpolationDebug.js +74 -78
  221. package/dist/debug/UILayerDebug.d.ts +1 -1
  222. package/dist/debug/UILayerDebug.js +55 -64
  223. package/dist/debug/UIVerticalDistanceDebug.d.ts +3 -3
  224. package/dist/debug/UIVerticalDistanceDebug.js +76 -81
  225. package/dist/debug/UIVerticalInterpolationDebug.d.ts +3 -3
  226. package/dist/debug/UIVerticalInterpolationDebug.js +74 -78
  227. package/dist/debug/UIWidthDebug.d.ts +3 -3
  228. package/dist/debug/UIWidthDebug.js +63 -67
  229. package/dist/debug/index.d.ts +8 -8
  230. package/dist/debug/index.js +8 -8
  231. package/dist/debug/miscellaneous.js +8 -11
  232. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.d.ts +3 -3
  233. package/dist/particles/behaviorModules/UIBehaviorDirectionalGravity.js +13 -16
  234. package/dist/particles/behaviorModules/UIBehaviorModule.d.ts +1 -1
  235. package/dist/particles/behaviorModules/UIBehaviorModule.js +1 -3
  236. package/dist/particles/behaviorModules/UIBehaviorPointGravity.d.ts +3 -3
  237. package/dist/particles/behaviorModules/UIBehaviorPointGravity.js +37 -40
  238. package/dist/particles/behaviorModules/UIBehaviorScaleOscillation.d.ts +41 -0
  239. package/dist/particles/behaviorModules/UIBehaviorScaleOscillation.js +87 -0
  240. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.d.ts +2 -2
  241. package/dist/particles/behaviorModules/UIBehaviorScaleOverLife.js +17 -20
  242. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.d.ts +2 -2
  243. package/dist/particles/behaviorModules/UIBehaviorTorqueDamping.js +13 -16
  244. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.d.ts +2 -2
  245. package/dist/particles/behaviorModules/UIBehaviorTorqueNoise.js +21 -24
  246. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.d.ts +2 -2
  247. package/dist/particles/behaviorModules/UIBehaviorVelocityDamping.js +13 -16
  248. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.d.ts +2 -2
  249. package/dist/particles/behaviorModules/UIBehaviorVelocityNoise.js +21 -24
  250. package/dist/particles/elements/UIEmitter.Internal.d.ts +2 -2
  251. package/dist/particles/elements/UIEmitter.Internal.js +6 -9
  252. package/dist/particles/elements/UIEmitter.d.ts +17 -11
  253. package/dist/particles/elements/UIEmitter.js +100 -88
  254. package/dist/particles/index.d.ts +20 -18
  255. package/dist/particles/index.js +19 -18
  256. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.d.ts +1 -1
  257. package/dist/particles/instancedParticle/UIInstancedParticle.Internal.js +14 -15
  258. package/dist/particles/instancedParticle/UIInstancedParticle.d.ts +1 -1
  259. package/dist/particles/instancedParticle/UIInstancedParticle.js +29 -32
  260. package/dist/particles/miscellaneous/miscellaneous.d.ts +3 -3
  261. package/dist/particles/miscellaneous/miscellaneous.js +26 -27
  262. package/dist/particles/renderingModules/UIRenderingColorOverLife.d.ts +2 -2
  263. package/dist/particles/renderingModules/UIRenderingColorOverLife.js +5 -8
  264. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.d.ts +2 -2
  265. package/dist/particles/renderingModules/UIRenderingColorOverVelocity.js +6 -9
  266. package/dist/particles/renderingModules/UIRenderingModule.js +1 -3
  267. package/dist/particles/renderingModules/UIRenderingTexture.d.ts +2 -2
  268. package/dist/particles/renderingModules/UIRenderingTexture.js +4 -7
  269. package/dist/particles/shaders/UIRenderingColorOverLife.d.ts +2 -0
  270. package/dist/particles/shaders/UIRenderingColorOverLife.js +7 -0
  271. package/dist/particles/shaders/UIRenderingColorOverVelocity.d.ts +9 -0
  272. package/dist/particles/shaders/UIRenderingColorOverVelocity.js +16 -0
  273. package/dist/particles/shaders/UIRenderingTexture.d.ts +2 -0
  274. package/dist/particles/shaders/UIRenderingTexture.js +7 -0
  275. package/dist/particles/spawnModules/UISpawnModule.d.ts +1 -1
  276. package/dist/particles/spawnModules/UISpawnModule.js +1 -3
  277. package/dist/particles/spawnModules/UISpawnOffset.d.ts +3 -3
  278. package/dist/particles/spawnModules/UISpawnOffset.js +12 -15
  279. package/dist/particles/spawnModules/UISpawnRandomLifetime.d.ts +2 -2
  280. package/dist/particles/spawnModules/UISpawnRandomLifetime.js +13 -16
  281. package/dist/particles/spawnModules/UISpawnRandomRotation.d.ts +2 -2
  282. package/dist/particles/spawnModules/UISpawnRandomRotation.js +13 -16
  283. package/dist/particles/spawnModules/UISpawnRandomScale.d.ts +2 -2
  284. package/dist/particles/spawnModules/UISpawnRandomScale.js +19 -22
  285. package/dist/particles/spawnModules/UISpawnRandomTorque.d.ts +2 -2
  286. package/dist/particles/spawnModules/UISpawnRandomTorque.js +13 -16
  287. package/dist/particles/spawnModules/UISpawnRandomVelocity.d.ts +2 -2
  288. package/dist/particles/spawnModules/UISpawnRandomVelocity.js +21 -24
  289. package/dist/particles/spawnModules/UISpawnRectangle.d.ts +3 -3
  290. package/dist/particles/spawnModules/UISpawnRectangle.js +21 -24
  291. package/package.json +13 -17
  292. package/dist/_virtual/2d.js +0 -3
  293. package/dist/_virtual/3d.js +0 -3
  294. package/dist/_virtual/4d.js +0 -3
  295. package/dist/_virtual/mod.js +0 -5
  296. package/dist/_virtual/mod2.js +0 -3
  297. package/dist/core/shaders/UIImage.glsl.js +0 -3
  298. package/dist/core/shaders/UINineSlice.glsl.js +0 -3
  299. package/dist/core/shaders/UIProgress.glsl.js +0 -3
  300. package/dist/core/shaders/UIProgressMaskFunctionCircular.glsl.js +0 -3
  301. package/dist/core/shaders/UIProgressMaskFunctionDirectional.glsl.js +0 -3
  302. package/dist/index.js +0 -52
  303. package/dist/node_modules/fast-simplex-noise/lib/2d.js +0 -93
  304. package/dist/node_modules/fast-simplex-noise/lib/3d.js +0 -142
  305. package/dist/node_modules/fast-simplex-noise/lib/4d.js +0 -196
  306. package/dist/node_modules/fast-simplex-noise/lib/mod.js +0 -24
  307. package/dist/node_modules/three/examples/jsm/lines/Line2.js +0 -56
  308. package/dist/node_modules/three/examples/jsm/lines/LineGeometry.js +0 -157
  309. package/dist/node_modules/three/examples/jsm/lines/LineMaterial.js +0 -691
  310. package/dist/node_modules/three/examples/jsm/lines/LineSegments2.js +0 -415
  311. package/dist/node_modules/three/examples/jsm/lines/LineSegmentsGeometry.js +0 -289
  312. package/dist/particles/shaders/UIRenderingColorOverLife.glsl.js +0 -3
  313. package/dist/particles/shaders/UIRenderingColorOverVelocity.glsl.js +0 -3
  314. package/dist/particles/shaders/UIRenderingTexture.glsl.js +0 -3
@@ -1,15 +1,14 @@
1
- import { Color, MathUtils, WebGLRenderTarget, UnsignedByteType, LinearFilter, RGBAFormat, Matrix3, Scene, PerspectiveCamera } from 'three';
2
- import { assertValidPositiveNumber } from '../../miscellaneous/asserts.js';
3
- import { UIColor } from '../../miscellaneous/color/UIColor.js';
4
- import source from '../../shaders/UIImage.glsl.js';
5
- import { DUMMY_DEFAULT_WIDTH, DUMMY_DEFAULT_HEIGHT } from '../UIDummy/UIDummy.Internal.js';
6
- import { UIElement } from '../UIElement/UIElement.js';
7
- import { SCENE_DEFAULT_RESOLUTION_FACTOR, SCENE_MIN_RESOLUTION_FACTOR, SCENE_MAX_RESOLUTION_FACTOR, SCENE_DEFAULT_USE_DEPTH, SCENE_DEFAULT_CLEAR_COLOR, SCENE_DEFAULT_CAMERA_FOV, SCENE_DEFAULT_CAMERA_NEAR, SCENE_DEFAULT_CAMERA_FAR, SCENE_DEFAULT_UPDATE_MODE, UISceneUpdateMode } from './UIScene.Internal.js';
8
-
1
+ import { Color, LinearFilter, MathUtils, Matrix3, PerspectiveCamera, RGBAFormat, Scene, UnsignedByteType, WebGLRenderTarget, } from "three";
2
+ import { assertValidPositiveNumber } from "../../miscellaneous/asserts.js";
3
+ import { UIColor } from "../../miscellaneous/color/UIColor.js";
4
+ import source from "../../shaders/UIImage.js";
5
+ import { DUMMY_DEFAULT_HEIGHT, DUMMY_DEFAULT_WIDTH, } from "../UIDummy/UIDummy.Internal.js";
6
+ import { UIElement } from "../UIElement/UIElement.js";
7
+ import { SCENE_DEFAULT_CAMERA_FAR, SCENE_DEFAULT_CAMERA_FOV, SCENE_DEFAULT_CAMERA_NEAR, SCENE_DEFAULT_CLEAR_COLOR, SCENE_DEFAULT_RESOLUTION_FACTOR, SCENE_DEFAULT_UPDATE_MODE, SCENE_DEFAULT_USE_DEPTH, SCENE_MAX_RESOLUTION_FACTOR, SCENE_MIN_RESOLUTION_FACTOR, UISceneUpdateMode, } from "./UIScene.Internal.js";
9
8
  let previousClearColor = new Color();
10
9
  let previousClearAlpha = 0;
11
10
  /** Renders Three.js scene to texture */
12
- class UIScene extends UIElement {
11
+ export class UIScene extends UIElement {
13
12
  /**
14
13
  * Creates a new UIScene instance.
15
14
  *
@@ -38,127 +37,127 @@ class UIScene extends UIElement {
38
37
  textureTransform: new Matrix3(),
39
38
  color,
40
39
  }, options);
41
- this._private_evenFrame = true;
42
- this._private_updateRequired = false;
43
- this._private_resolutionFactorDirty = false;
44
- this._private_propertyDirty = false;
45
- this._private_colorInternal = color;
46
- this._private_clearColorInternal = new UIColor(options.clearColor ?? SCENE_DEFAULT_CLEAR_COLOR);
47
- this._private_renderTarget = renderTarget;
48
- this._private_sceneInternal = options.scene ?? new Scene();
49
- this._private_cameraInternal =
40
+ this.evenFrame = true;
41
+ this.updateRequired = false;
42
+ this.resolutionFactorDirty = false;
43
+ this.propertyDirty = false;
44
+ this.colorInternal = color;
45
+ this.clearColorInternal = new UIColor(options.clearColor ?? SCENE_DEFAULT_CLEAR_COLOR);
46
+ this.renderTarget = renderTarget;
47
+ this.sceneInternal = options.scene ?? new Scene();
48
+ this.cameraInternal =
50
49
  options.camera ??
51
50
  new PerspectiveCamera(SCENE_DEFAULT_CAMERA_FOV, w / h, SCENE_DEFAULT_CAMERA_NEAR, SCENE_DEFAULT_CAMERA_FAR);
52
- this._private_resolutionFactorInternal = resolutionFactor;
53
- this._private_updateModeInternal = options.updateMode ?? SCENE_DEFAULT_UPDATE_MODE;
54
- this._private_propertyDirty = options.updateMode !== UISceneUpdateMode.MANUAL;
51
+ this.resolutionFactorInternal = resolutionFactor;
52
+ this.updateModeInternal = options.updateMode ?? SCENE_DEFAULT_UPDATE_MODE;
53
+ this.propertyDirty = options.updateMode !== UISceneUpdateMode.MANUAL;
55
54
  }
56
55
  /** Camera used for rendering */
57
56
  get camera() {
58
- return this._private_cameraInternal;
57
+ return this.cameraInternal;
59
58
  }
60
59
  /** Background color for render target */
61
60
  get clearColor() {
62
- return this._private_clearColorInternal;
61
+ return this.clearColorInternal;
63
62
  }
64
63
  /** Multiplicative tint. Alpha channel controls opacity. */
65
64
  get color() {
66
- return this._private_colorInternal;
65
+ return this.colorInternal;
67
66
  }
68
67
  /** Render target resolution multiplier. Range 0.1 to 2.0. */
69
68
  get resolutionFactor() {
70
- return this._private_resolutionFactorInternal;
69
+ return this.resolutionFactorInternal;
71
70
  }
72
71
  /** Three.js scene to render */
73
72
  get scene() {
74
- return this._private_sceneInternal;
73
+ return this.sceneInternal;
75
74
  }
76
75
  /** Controls when scene re-renders */
77
76
  get updateMode() {
78
- return this._private_updateModeInternal;
77
+ return this.updateModeInternal;
79
78
  }
80
79
  /** Camera used for rendering */
81
80
  set camera(value) {
82
- if (this._private_cameraInternal !== value) {
83
- this._private_cameraInternal = value;
84
- this._private_propertyDirty = true;
81
+ if (this.cameraInternal !== value) {
82
+ this.cameraInternal = value;
83
+ this.propertyDirty = true;
85
84
  }
86
85
  }
87
86
  /** Background color for render target */
88
87
  set clearColor(value) {
89
- this._private_clearColorInternal.set(value);
88
+ this.clearColorInternal.set(value);
90
89
  }
91
90
  /** Multiplicative tint. Alpha channel controls opacity. */
92
91
  set color(value) {
93
- this._private_colorInternal.set(value);
92
+ this.colorInternal.set(value);
94
93
  }
95
94
  /** Render target resolution multiplier. Range 0.1 to 2.0. */
96
95
  set resolutionFactor(value) {
97
96
  assertValidPositiveNumber(value, "UIScene.resolutionFactor");
98
97
  value = MathUtils.clamp(value, SCENE_MIN_RESOLUTION_FACTOR, SCENE_MAX_RESOLUTION_FACTOR);
99
- if (this._private_resolutionFactorInternal !== value) {
100
- this._private_resolutionFactorInternal = value;
101
- this._private_resolutionFactorDirty = true;
98
+ if (this.resolutionFactorInternal !== value) {
99
+ this.resolutionFactorInternal = value;
100
+ this.resolutionFactorDirty = true;
102
101
  }
103
102
  }
104
103
  /** Three.js scene to render */
105
104
  set scene(value) {
106
- if (this._private_sceneInternal !== value) {
107
- this._private_sceneInternal = value;
108
- this._private_propertyDirty = true;
105
+ if (this.sceneInternal !== value) {
106
+ this.sceneInternal = value;
107
+ this.propertyDirty = true;
109
108
  }
110
109
  }
111
110
  /** Controls when scene re-renders */
112
111
  set updateMode(value) {
113
- if (this._private_updateModeInternal !== value) {
114
- this._private_updateModeInternal = value;
115
- this._private_propertyDirty = true;
112
+ if (this.updateModeInternal !== value) {
113
+ this.updateModeInternal = value;
114
+ this.propertyDirty = true;
116
115
  }
117
116
  }
118
- /** Removes element and frees resources */
119
- destroy() {
120
- this._private_renderTarget.dispose();
121
- super.destroy();
122
- }
123
117
  /** Triggers re-render on next frame. Useful in MANUAL mode. */
124
118
  requestUpdate() {
125
- this._private_updateRequired = true;
119
+ this.updateRequired = true;
120
+ }
121
+ /** Frees resources of the scene */
122
+ destroyInternal() {
123
+ this.renderTarget.dispose();
124
+ super.destroyInternal();
126
125
  }
127
126
  onWillRender(renderer, deltaTime) {
128
- this._private_evenFrame = !this._private_evenFrame;
129
- const isFramebufferDirty = this._private_updateRequired ||
130
- this._private_updateModeInternal === UISceneUpdateMode.EVERY_FRAME ||
131
- (this._private_updateModeInternal === UISceneUpdateMode.EVERY_SECOND_FRAME && this._private_evenFrame) ||
132
- (this._private_updateModeInternal === UISceneUpdateMode.ON_PROPERTIES_CHANGE && this._private_propertyDirty) ||
133
- this._private_colorInternal.dirty ||
134
- this._private_clearColorInternal.dirty ||
135
- (this._private_updateModeInternal === UISceneUpdateMode.ON_DIMENSIONS_CHANGE &&
136
- (this._private_resolutionFactorDirty || this.solverWrapper.dirty));
127
+ this.evenFrame = !this.evenFrame;
128
+ const isFramebufferDirty = this.updateRequired ||
129
+ this.updateModeInternal === UISceneUpdateMode.EVERY_FRAME ||
130
+ (this.updateModeInternal === UISceneUpdateMode.EVERY_SECOND_FRAME &&
131
+ this.evenFrame) ||
132
+ (this.updateModeInternal === UISceneUpdateMode.ON_PROPERTIES_CHANGE &&
133
+ this.propertyDirty) ||
134
+ this.colorInternal.dirty ||
135
+ this.clearColorInternal.dirty ||
136
+ (this.updateModeInternal === UISceneUpdateMode.ON_DIMENSIONS_CHANGE &&
137
+ (this.resolutionFactorDirty || this.solverWrapper.dirty));
137
138
  if (isFramebufferDirty) {
138
- if (this._private_resolutionFactorDirty || this.solverWrapper.dirty) {
139
- this._private_renderTarget.setSize(this.width * this._private_resolutionFactorInternal, this.height * this._private_resolutionFactorInternal);
140
- this._private_resolutionFactorDirty = false;
139
+ if (this.resolutionFactorDirty || this.solverWrapper.dirty) {
140
+ this.renderTarget.setSize(this.width * this.resolutionFactorInternal, this.height * this.resolutionFactorInternal);
141
+ this.resolutionFactorDirty = false;
141
142
  }
142
- if (this._private_colorInternal.dirty) {
143
+ if (this.colorInternal.dirty) {
143
144
  this.sceneWrapper.setProperties(this.planeHandler, {
144
- color: this._private_colorInternal,
145
+ color: this.colorInternal,
145
146
  });
146
- this._private_colorInternal.setDirtyFalse();
147
+ this.colorInternal.setDirtyFalse();
147
148
  }
148
149
  const previousRenderTarget = renderer.getRenderTarget();
149
150
  previousClearColor = renderer.getClearColor(previousClearColor);
150
151
  previousClearAlpha = renderer.getClearAlpha();
151
- renderer.setClearColor(this._private_clearColorInternal.getHexRGB(), this._private_clearColorInternal.a);
152
- renderer.setRenderTarget(this._private_renderTarget);
152
+ renderer.setClearColor(this.clearColorInternal.getHexRGB(), this.clearColorInternal.a);
153
+ renderer.setRenderTarget(this.renderTarget);
153
154
  renderer.clear(true, true, false);
154
- renderer.render(this._private_sceneInternal, this._private_cameraInternal);
155
+ renderer.render(this.sceneInternal, this.cameraInternal);
155
156
  renderer.setRenderTarget(previousRenderTarget);
156
157
  renderer.setClearColor(previousClearColor, previousClearAlpha);
157
- this._private_propertyDirty = false;
158
- this._private_updateRequired = false;
158
+ this.propertyDirty = false;
159
+ this.updateRequired = false;
159
160
  }
160
161
  super.onWillRender(renderer, deltaTime);
161
162
  }
162
163
  }
163
-
164
- export { UIScene };
@@ -1,5 +1,5 @@
1
- import type { UITextSpan } from "../../miscellaneous/text-span/UITextSpan";
2
- import type { UITextChunk } from "./UIText.Interfaces";
1
+ import type { UITextSpan } from "../../miscellaneous/text-span/UITextSpan.js";
2
+ import type { UITextChunk } from "./UIText.Interfaces.js";
3
3
  /**
4
4
  * Detects the directional class used to order a chunk among its neighbours.
5
5
  * Digit only chunks are ordered left to right in both paragraph directions.
@@ -64,7 +64,7 @@ function reverseChunkRange(textChunks, from, to) {
64
64
  * @param text Chunk text
65
65
  * @returns Directional class of the chunk
66
66
  */
67
- function detectBidiClass(text) {
67
+ export function detectBidiClass(text) {
68
68
  const strongClass = detectStrongClass(text);
69
69
  if (strongClass !== BIDI_NEUTRAL) {
70
70
  return strongClass;
@@ -77,7 +77,7 @@ function detectBidiClass(text) {
77
77
  * @param textSpans Text spans in logical order
78
78
  * @returns Whether the paragraph reads right to left
79
79
  */
80
- function detectIsRTL(textSpans) {
80
+ export function detectIsRTL(textSpans) {
81
81
  for (const textSpan of textSpans) {
82
82
  const strongClass = detectStrongClass(textSpan.text);
83
83
  if (strongClass !== BIDI_NEUTRAL) {
@@ -94,7 +94,7 @@ function detectIsRTL(textSpans) {
94
94
  * @param isRTL Whether the paragraph reads right to left
95
95
  * @returns Chunks in visual order, or the same array when reordering is not needed
96
96
  */
97
- function reorderChunksVisually(textChunks, isRTL) {
97
+ export function reorderChunksVisually(textChunks, isRTL) {
98
98
  if (!isRTL && !textChunks.some((textChunk) => textChunk.bidiClass === BIDI_RTL)) {
99
99
  return textChunks;
100
100
  }
@@ -129,5 +129,3 @@ function reorderChunksVisually(textChunks, isRTL) {
129
129
  }
130
130
  return result;
131
131
  }
132
-
133
- export { detectBidiClass, detectIsRTL, reorderChunksVisually };
@@ -1,5 +1,5 @@
1
- import type { UITextSpanConfig } from "../../miscellaneous/text-span/UITextSpan.Internal";
2
- import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal";
1
+ import type { UITextSpanConfig } from "../../miscellaneous/text-span/UITextSpan.Internal.js";
2
+ import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal.js";
3
3
  /** Text content configuration */
4
4
  export type UITextContent = (UITextSpanConfig | string)[] | UITextSpanConfig | string;
5
5
  /** Text dimensions */
@@ -15,6 +15,10 @@ export interface UIChunkMetrics extends UITextSize {
15
15
  baseline: number;
16
16
  /** Line height in pixels */
17
17
  lineHeight: number;
18
+ /** How far the glyphs reach left of the start of the advance, in pixels */
19
+ overhangLeft: number;
20
+ /** How far the glyphs reach right of the end of the advance, in pixels */
21
+ overhangRight: number;
18
22
  }
19
23
  /** Styled text chunk */
20
24
  export interface UITextChunk {
@@ -0,0 +1 @@
1
+ export {};
@@ -1,7 +1,7 @@
1
- import type { UIColorConfig } from "../../miscellaneous/color/UIColor.Internal";
2
- import type { UIInsetsConfig } from "../../miscellaneous/insets/UIInsets.Internal";
3
- import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal";
4
- import type { UIElementOptions } from "../UIElement/UIElement.Internal";
1
+ import type { UIColorConfig } from "../../miscellaneous/color/UIColor.Internal.js";
2
+ import type { UIInsetsConfig } from "../../miscellaneous/insets/UIInsets.Internal.js";
3
+ import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal.js";
4
+ import type { UIElementOptions } from "../UIElement/UIElement.Internal.js";
5
5
  /** Base direction used for bidirectional text reordering */
6
6
  export declare enum UITextDirection {
7
7
  /** Detect from the first strong directional character of the content */
@@ -1,5 +1,5 @@
1
1
  /** Base direction used for bidirectional text reordering */
2
- var UITextDirection;
2
+ export var UITextDirection;
3
3
  (function (UITextDirection) {
4
4
  /** Detect from the first strong directional character of the content */
5
5
  UITextDirection[UITextDirection["AUTO"] = 0] = "AUTO";
@@ -9,15 +9,13 @@ var UITextDirection;
9
9
  UITextDirection[UITextDirection["RTL"] = 2] = "RTL";
10
10
  })(UITextDirection || (UITextDirection = {}));
11
11
  /** Controls how text adapts to element size */
12
- var UITextResizeMode;
12
+ export var UITextResizeMode;
13
13
  (function (UITextResizeMode) {
14
14
  /** Break text into multiple lines when narrower than content*/
15
15
  UITextResizeMode[UITextResizeMode["BREAK"] = 0] = "BREAK";
16
16
  /** Scale text to fit fixed element size */
17
17
  UITextResizeMode[UITextResizeMode["SCALE"] = 1] = "SCALE";
18
18
  })(UITextResizeMode || (UITextResizeMode = {}));
19
- const TEXT_DEFAULT_MAX_LINE_WIDTH = 1024;
20
- const TEXT_DEFAULT_RESIZE_MODE = UITextResizeMode.SCALE;
21
- const TEXT_DEFAULT_DIRECTION = UITextDirection.AUTO;
22
-
23
- export { TEXT_DEFAULT_DIRECTION, TEXT_DEFAULT_MAX_LINE_WIDTH, TEXT_DEFAULT_RESIZE_MODE, UITextDirection, UITextResizeMode };
19
+ export const TEXT_DEFAULT_MAX_LINE_WIDTH = 1024;
20
+ export const TEXT_DEFAULT_RESIZE_MODE = UITextResizeMode.SCALE;
21
+ export const TEXT_DEFAULT_DIRECTION = UITextDirection.AUTO;
@@ -1,8 +1,8 @@
1
- import type { UICanvasRenderingContext2D } from "../../miscellaneous/canvas";
2
- import type { UITextSpan } from "../../miscellaneous/text-span/UITextSpan";
3
- import { UITextStyle } from "../../miscellaneous/text-style/UITextStyle";
4
- import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal";
5
- import type { UIChunkMetrics, UITextChunk, UITextLine, UITextSize } from "./UIText.Interfaces";
1
+ import type { UICanvasRenderingContext2D } from "../../miscellaneous/canvas.js";
2
+ import type { UITextSpan } from "../../miscellaneous/text-span/UITextSpan.js";
3
+ import { UITextStyle } from "../../miscellaneous/text-style/UITextStyle.js";
4
+ import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal.js";
5
+ import type { UIChunkMetrics, UITextChunk, UITextLine, UITextSize } from "./UIText.Interfaces.js";
6
6
  /**
7
7
  * Applies font of a resolved style to a canvas context.
8
8
  * Shared by measuring and rendering so both stay in sync.
@@ -12,6 +12,7 @@ import type { UIChunkMetrics, UITextChunk, UITextLine, UITextSize } from "./UITe
12
12
  export declare function applyFontStyle(context: UICanvasRenderingContext2D, textStyle: UITextStyleConfig): void;
13
13
  /**
14
14
  * Splits text into renderable chunks.
15
+ * No-break spaces stay inside words, so a line never breaks at them.
15
16
  * @param text Text to split
16
17
  * @returns Array of words, spaces, and newlines
17
18
  */
@@ -26,11 +27,16 @@ export declare function splitTextIntoChunks(text: string): string[];
26
27
  export declare function measureTextChunk(context: UICanvasRenderingContext2D, text: string, textStyle: UITextStyleConfig): UIChunkMetrics;
27
28
  /**
28
29
  * Builds text lines with word wrapping.
30
+ * Spaces behave as in a browser: a space never moves to the next line by itself, spaces at the
31
+ * end of a line are not part of it, and a line made by wrapping does not start with a space.
32
+ * Spaces at the start of the text and after a newline are kept. A newline always ends a line,
33
+ * so two newlines in a row leave an empty line.
29
34
  * @param maxWidth Maximum line width in pixels
30
35
  * @param textChunks Measured text chunks
36
+ * @param isRTL Whether the paragraph reads right to left
31
37
  * @returns Array of text lines
32
38
  */
33
- export declare function buildTextLines(maxWidth: number, textChunks: UITextChunk[]): UITextLine[];
39
+ export declare function buildTextLines(maxWidth: number, textChunks: UITextChunk[], isRTL: boolean): UITextLine[];
34
40
  /**
35
41
  * Calculates total text size from lines.
36
42
  * The box spans from the ascent of the first line to the descent of the last one.
@@ -51,9 +57,10 @@ export declare function buildTextChunks(context: UICanvasRenderingContext2D, tex
51
57
  * Calculates text layout parameters.
52
58
  * @param textChunks Measured text chunks
53
59
  * @param maxLineWidth Maximum line width in pixels
60
+ * @param isRTL Whether the paragraph reads right to left
54
61
  * @returns Lines and total size
55
62
  */
56
- export declare function calculateTextContentParameters(textChunks: UITextChunk[], maxLineWidth: number): {
63
+ export declare function calculateTextContentParameters(textChunks: UITextChunk[], maxLineWidth: number, isRTL: boolean): {
57
64
  lines: UITextLine[];
58
65
  size: UITextSize;
59
66
  };
@@ -1,22 +1,39 @@
1
- import { UITextStyle } from '../../miscellaneous/text-style/UITextStyle.js';
2
- import { detectBidiClass } from './UIText.Bidi.js';
3
-
1
+ import { UITextStyle } from "../../miscellaneous/text-style/UITextStyle.js";
2
+ import { detectBidiClass, reorderChunksVisually } from "./UIText.Bidi.js";
4
3
  /**
5
4
  * Applies font of a resolved style to a canvas context.
6
5
  * Shared by measuring and rendering so both stay in sync.
7
6
  * @param context Canvas context to configure
8
7
  * @param textStyle Resolved text style
9
8
  */
10
- function applyFontStyle(context, textStyle) {
9
+ export function applyFontStyle(context, textStyle) {
11
10
  context.font = `${textStyle.fontStyle} ${textStyle.fontWeight} ${textStyle.fontSize}px "${textStyle.fontFamily}"`;
12
11
  }
13
12
  /**
14
13
  * Splits text into renderable chunks.
14
+ * No-break spaces stay inside words, so a line never breaks at them.
15
15
  * @param text Text to split
16
16
  * @returns Array of words, spaces, and newlines
17
17
  */
18
- function splitTextIntoChunks(text) {
19
- return text.match(/\S+|\s|\n/g) ?? [];
18
+ export function splitTextIntoChunks(text) {
19
+ return text.match(/(?:\S|[\u00A0\u2007\u202F])+|\s/g) ?? [];
20
+ }
21
+ /**
22
+ * Checks whether a chunk is a breakable space, which may end a line and is not drawn there.
23
+ * @param textChunk Chunk to check
24
+ * @returns True for a single breakable whitespace character other than a newline
25
+ */
26
+ function isBreakableSpace(textChunk) {
27
+ return textChunk.text !== "\n" && /^\s$/.test(textChunk.text);
28
+ }
29
+ /**
30
+ * Rounds an overhang up; a negative or missing value means none, so a line never gets narrower
31
+ * than its advances.
32
+ * @param value Overhang in pixels
33
+ * @returns Overhang in whole pixels, at least 0
34
+ */
35
+ function ceilOverhang(value) {
36
+ return value > 0 ? Math.ceil(value) : 0;
20
37
  }
21
38
  /**
22
39
  * Measures single text chunk.
@@ -25,7 +42,7 @@ function splitTextIntoChunks(text) {
25
42
  * @param textStyle Resolved text style
26
43
  * @returns Chunk metrics
27
44
  */
28
- function measureTextChunk(context, text, textStyle) {
45
+ export function measureTextChunk(context, text, textStyle) {
29
46
  applyFontStyle(context, textStyle);
30
47
  if (text === "\n") {
31
48
  return {
@@ -33,82 +50,125 @@ function measureTextChunk(context, text, textStyle) {
33
50
  height: textStyle.lineHeight,
34
51
  baseline: 0,
35
52
  lineHeight: textStyle.lineHeight,
53
+ overhangLeft: 0,
54
+ overhangRight: 0,
36
55
  };
37
56
  }
38
57
  const metrics = context.measureText(text);
39
58
  const ascent = Math.ceil(metrics.actualBoundingBoxAscent);
40
59
  const descent = Math.ceil(metrics.actualBoundingBoxDescent);
60
+ const width = Math.ceil(metrics.width);
41
61
  return {
42
- width: Math.ceil(metrics.width),
62
+ width,
43
63
  height: ascent + descent,
44
64
  baseline: ascent,
45
65
  lineHeight: textStyle.lineHeight,
66
+ overhangLeft: ceilOverhang(metrics.actualBoundingBoxLeft),
67
+ overhangRight: ceilOverhang(metrics.actualBoundingBoxRight - width),
46
68
  };
47
69
  }
48
70
  /**
49
- * Appends a line built from accumulated metrics.
50
- * Ascent and descent are separate because the tallest and deepest chunks may differ.
51
- * @param lines Lines to append to
52
- * @param chunks Chunks of the line
53
- * @param width Line width in pixels
54
- * @param ascent Maximum chunk ascent in pixels
55
- * @param descent Maximum chunk descent in pixels
56
- * @param lineHeight Maximum chunk line height in pixels
71
+ * Builds a line from its chunks in logical order.
72
+ * The width spans the glyphs, not only their advances: the left overhang of the visually first
73
+ * chunk and the right overhang of the visually last one are part of it, so italic and swash
74
+ * glyphs at the line edges are not cut.
75
+ * @param chunks Chunks of the line without trailing spaces
76
+ * @param emptyLineHeight Line height used when the line has no chunks
77
+ * @param isRTL Whether the paragraph reads right to left
78
+ * @returns Text line
57
79
  */
58
- function pushTextLine(lines, chunks, width, ascent, descent, lineHeight) {
59
- lines.push({
80
+ function buildTextLine(chunks, emptyLineHeight, isRTL) {
81
+ if (chunks.length === 0) {
82
+ return {
83
+ chunks,
84
+ width: 0,
85
+ height: 0,
86
+ baseline: 0,
87
+ lineHeight: emptyLineHeight,
88
+ overhangLeft: 0,
89
+ overhangRight: 0,
90
+ };
91
+ }
92
+ let advance = 0;
93
+ let ascent = 0;
94
+ let descent = 0;
95
+ let lineHeight = 0;
96
+ for (const chunk of chunks) {
97
+ advance += chunk.metrics.width;
98
+ ascent = Math.max(ascent, chunk.metrics.baseline);
99
+ descent = Math.max(descent, chunk.metrics.height - chunk.metrics.baseline);
100
+ lineHeight = Math.max(lineHeight, chunk.metrics.lineHeight);
101
+ }
102
+ const visualChunks = reorderChunksVisually(chunks, isRTL);
103
+ const overhangLeft = visualChunks[0].metrics.overhangLeft;
104
+ const overhangRight = visualChunks[visualChunks.length - 1].metrics.overhangRight;
105
+ return {
60
106
  chunks,
61
- width,
107
+ width: overhangLeft + advance + overhangRight,
62
108
  height: ascent + descent,
63
109
  baseline: ascent,
64
110
  lineHeight,
65
- });
111
+ overhangLeft,
112
+ overhangRight,
113
+ };
114
+ }
115
+ /**
116
+ * Removes breakable spaces from the end of a line.
117
+ * @param chunks Chunks of the line in logical order
118
+ * @returns The same chunks without trailing spaces
119
+ */
120
+ function trimTrailingSpaces(chunks) {
121
+ let end = chunks.length;
122
+ while (end > 0 && isBreakableSpace(chunks[end - 1])) {
123
+ end--;
124
+ }
125
+ return end === chunks.length ? chunks : chunks.slice(0, end);
66
126
  }
67
127
  /**
68
128
  * Builds text lines with word wrapping.
129
+ * Spaces behave as in a browser: a space never moves to the next line by itself, spaces at the
130
+ * end of a line are not part of it, and a line made by wrapping does not start with a space.
131
+ * Spaces at the start of the text and after a newline are kept. A newline always ends a line,
132
+ * so two newlines in a row leave an empty line.
69
133
  * @param maxWidth Maximum line width in pixels
70
134
  * @param textChunks Measured text chunks
135
+ * @param isRTL Whether the paragraph reads right to left
71
136
  * @returns Array of text lines
72
137
  */
73
- function buildTextLines(maxWidth, textChunks) {
138
+ export function buildTextLines(maxWidth, textChunks, isRTL) {
74
139
  const lines = [];
75
140
  let currentLine = [];
76
- let currentWidth = 0;
77
- let currentAscent = 0;
78
- let currentDescent = 0;
79
141
  let currentLineHeight = 0;
142
+ let isWrapped = false;
143
+ const pushLine = () => {
144
+ lines.push(buildTextLine(trimTrailingSpaces(currentLine), currentLineHeight, isRTL));
145
+ currentLine = [];
146
+ currentLineHeight = 0;
147
+ };
80
148
  for (const textChunk of textChunks) {
81
- const ascent = textChunk.metrics.baseline;
82
- const descent = textChunk.metrics.height - textChunk.metrics.baseline;
83
149
  if (textChunk.text === "\n") {
84
- if (currentLine.length > 0) {
85
- pushTextLine(lines, currentLine, currentWidth, currentAscent, currentDescent, currentLineHeight);
86
- }
87
- currentLine = [];
88
- currentWidth = 0;
89
- currentAscent = 0;
90
- currentDescent = 0;
91
- currentLineHeight = 0;
150
+ currentLineHeight = Math.max(currentLineHeight, textChunk.metrics.lineHeight);
151
+ pushLine();
152
+ isWrapped = false;
92
153
  continue;
93
154
  }
94
- if (currentLine.length === 0 || currentWidth + textChunk.metrics.width <= maxWidth) {
95
- currentLine.push(textChunk);
96
- currentWidth += textChunk.metrics.width;
97
- currentAscent = Math.max(currentAscent, ascent);
98
- currentDescent = Math.max(currentDescent, descent);
99
- currentLineHeight = Math.max(currentLineHeight, textChunk.metrics.lineHeight);
155
+ if (isBreakableSpace(textChunk)) {
156
+ if (!(isWrapped && currentLine.length === 0)) {
157
+ currentLine.push(textChunk);
158
+ currentLineHeight = Math.max(currentLineHeight, textChunk.metrics.lineHeight);
159
+ }
160
+ continue;
100
161
  }
101
- else {
102
- pushTextLine(lines, currentLine, currentWidth, currentAscent, currentDescent, currentLineHeight);
103
- currentLine = [textChunk];
104
- currentWidth = textChunk.metrics.width;
105
- currentAscent = ascent;
106
- currentDescent = descent;
107
- currentLineHeight = textChunk.metrics.lineHeight;
162
+ const candidate = trimTrailingSpaces(currentLine).length === 0 ? null : [...currentLine, textChunk];
163
+ if (candidate && buildTextLine(candidate, 0, isRTL).width > maxWidth) {
164
+ pushLine();
165
+ isWrapped = true;
108
166
  }
167
+ currentLine.push(textChunk);
168
+ currentLineHeight = Math.max(currentLineHeight, textChunk.metrics.lineHeight);
109
169
  }
110
- if (currentLine.length > 0) {
111
- pushTextLine(lines, currentLine, currentWidth, currentAscent, currentDescent, currentLineHeight);
170
+ if (trimTrailingSpaces(currentLine).length > 0) {
171
+ pushLine();
112
172
  }
113
173
  return lines;
114
174
  }
@@ -118,7 +178,7 @@ function buildTextLines(maxWidth, textChunks) {
118
178
  * @param lines Text lines
119
179
  * @returns Total width and height
120
180
  */
121
- function calculateTextSize(lines) {
181
+ export function calculateTextSize(lines) {
122
182
  if (lines.length === 0) {
123
183
  return { width: 0, height: 0 };
124
184
  }
@@ -138,8 +198,9 @@ function calculateTextSize(lines) {
138
198
  * @param isRTL Whether the paragraph reads right to left
139
199
  * @returns Measured text chunks
140
200
  */
141
- function buildTextChunks(context, textSpans, commonStyle, isRTL) {
201
+ export function buildTextChunks(context, textSpans, commonStyle, isRTL) {
142
202
  context.direction = isRTL ? "rtl" : "ltr";
203
+ context.textAlign = "left";
143
204
  const textChunks = [];
144
205
  for (const textSpan of textSpans) {
145
206
  const textStyle = UITextStyle.resolve(textSpan.style, commonStyle);
@@ -159,12 +220,11 @@ function buildTextChunks(context, textSpans, commonStyle, isRTL) {
159
220
  * Calculates text layout parameters.
160
221
  * @param textChunks Measured text chunks
161
222
  * @param maxLineWidth Maximum line width in pixels
223
+ * @param isRTL Whether the paragraph reads right to left
162
224
  * @returns Lines and total size
163
225
  */
164
- function calculateTextContentParameters(textChunks, maxLineWidth) {
165
- const lines = buildTextLines(maxLineWidth, textChunks);
226
+ export function calculateTextContentParameters(textChunks, maxLineWidth, isRTL) {
227
+ const lines = buildTextLines(maxLineWidth, textChunks, isRTL);
166
228
  const size = calculateTextSize(lines);
167
229
  return { lines, size };
168
230
  }
169
-
170
- export { applyFontStyle, buildTextChunks, buildTextLines, calculateTextContentParameters, calculateTextSize, measureTextChunk, splitTextIntoChunks };
@@ -1,6 +1,6 @@
1
- import type { UICanvasRenderingContext2D } from "../../miscellaneous/canvas";
2
- import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal";
3
- import type { UITextLine } from "./UIText.Interfaces";
1
+ import type { UICanvasRenderingContext2D } from "../../miscellaneous/canvas.js";
2
+ import type { UITextStyleConfig } from "../../miscellaneous/text-style/UITextStyle.Internal.js";
3
+ import type { UITextLine } from "./UIText.Interfaces.js";
4
4
  /**
5
5
  * Renders single text chunk.
6
6
  * @param x X coordinate in pixels