laymur 0.15.1 → 0.17.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 (248) hide show
  1. package/.claude/settings.local.json +9 -0
  2. package/.editorconfig +14 -0
  3. package/CLAUDE.md +181 -0
  4. package/README.md +84 -208
  5. package/assets/logotype.png +0 -0
  6. package/eslint.config.js +111 -0
  7. package/package.json +20 -36
  8. package/rollup.config.js +52 -0
  9. package/{dist/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts → src/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.ts} +3 -2
  10. package/src/core/constraints/UIAspectConstraint/UIAspectConstraint.ts +60 -0
  11. package/src/core/constraints/UIConstraint.ts +20 -0
  12. package/src/core/constraints/UICustomConstraint.ts +62 -0
  13. package/{dist/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts → src/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.ts} +3 -2
  14. package/src/core/constraints/UIHeightConstraint/UIHeightConstraint.ts +52 -0
  15. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.ts +13 -0
  16. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.ts +139 -0
  17. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.ts +16 -0
  18. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.ts +189 -0
  19. package/{dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts → src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.ts} +3 -2
  20. package/src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.ts +68 -0
  21. package/{dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts → src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.ts} +9 -8
  22. package/src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.ts +94 -0
  23. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.ts +13 -0
  24. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.ts +135 -0
  25. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.ts +16 -0
  26. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.ts +189 -0
  27. package/{dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts → src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.ts} +3 -2
  28. package/src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.ts +68 -0
  29. package/{dist/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts → src/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.ts} +3 -2
  30. package/src/core/constraints/UIWidthConstraint/UIWidthConstraint.ts +52 -0
  31. package/src/core/constraints/builders/UIConstraint2DBuilder.Internal.ts +84 -0
  32. package/src/core/constraints/builders/UIConstraint2DBuilder.ts +168 -0
  33. package/src/core/constraints/builders/UICoverConstraintBuilder.Internal.ts +15 -0
  34. package/src/core/constraints/builders/UICoverConstraintBuilder.ts +84 -0
  35. package/src/core/constraints/builders/UIFitConstraintBuilder.Internal.ts +15 -0
  36. package/src/core/constraints/builders/UIFitConstraintBuilder.ts +84 -0
  37. package/src/core/elements/UIAnchor/UIAnchor.Internal.ts +13 -0
  38. package/src/core/elements/UIAnchor/UIAnchor.ts +70 -0
  39. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.ts +30 -0
  40. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.ts +355 -0
  41. package/src/core/elements/UIDummy/UIDummy.Internal.ts +33 -0
  42. package/src/core/elements/UIDummy/UIDummy.ts +244 -0
  43. package/src/core/elements/UIElement/UIElement.Internal.ts +13 -0
  44. package/src/core/elements/UIElement/UIElement.ts +127 -0
  45. package/{dist/elements/UIGraphics/UIGraphics.Internal.d.ts → src/core/elements/UIGraphics/UIGraphics.Internal.ts} +7 -5
  46. package/src/core/elements/UIGraphics/UIGraphics.ts +168 -0
  47. package/{dist/elements/UIImage/UIImage.Internal.d.ts → src/core/elements/UIImage/UIImage.Internal.ts} +3 -2
  48. package/src/core/elements/UIImage/UIImage.ts +138 -0
  49. package/src/core/elements/UINineSlice/UINineSlice.Internal.ts +26 -0
  50. package/src/core/elements/UINineSlice/UINineSlice.ts +296 -0
  51. package/src/core/elements/UIProgress/UIProgress.Internal.ts +24 -0
  52. package/src/core/elements/UIProgress/UIProgress.ts +259 -0
  53. package/src/core/elements/UIScene/UIScene.Internal.ts +46 -0
  54. package/src/core/elements/UIScene/UIScene.ts +259 -0
  55. package/{dist/elements/UIText/UIText.Interfaces.d.ts → src/core/elements/UIText/UIText.Interfaces.ts} +21 -16
  56. package/src/core/elements/UIText/UIText.Internal.ts +29 -0
  57. package/src/core/elements/UIText/UIText.Measuring.ts +183 -0
  58. package/src/core/elements/UIText/UIText.Rendering.ts +83 -0
  59. package/src/core/elements/UIText/UIText.ts +376 -0
  60. package/{dist/index.d.ts → src/core/index.ts} +2 -1
  61. package/{dist/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts → src/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.ts} +14 -11
  62. package/src/core/layers/UIFullscreenLayer/UIFullscreenLayer.ts +233 -0
  63. package/{dist/layers/UILayer/UILayer.Internal.d.ts → src/core/layers/UILayer/UILayer.Internal.ts} +15 -11
  64. package/src/core/layers/UILayer/UILayer.ts +156 -0
  65. package/src/core/miscellaneous/UIExpression.ts +142 -0
  66. package/src/core/miscellaneous/UIMode.ts +29 -0
  67. package/src/core/miscellaneous/UIOrientation.ts +18 -0
  68. package/src/core/miscellaneous/UIPriority.ts +63 -0
  69. package/src/core/miscellaneous/UIRelation.ts +39 -0
  70. package/src/core/miscellaneous/UITransparencyMode.ts +9 -0
  71. package/src/core/miscellaneous/area/UIArea.ts +5 -0
  72. package/src/core/miscellaneous/area/UIAreaCircle.ts +32 -0
  73. package/src/core/miscellaneous/area/UIAreaPolygon.ts +50 -0
  74. package/src/core/miscellaneous/area/UIAreaRectangle.ts +38 -0
  75. package/src/core/miscellaneous/area/UIAreaRoundedRectangle.ts +78 -0
  76. package/src/core/miscellaneous/asserts.ts +187 -0
  77. package/src/core/miscellaneous/canvas.ts +73 -0
  78. package/src/core/miscellaneous/color/UIColor.Internal.ts +89 -0
  79. package/src/core/miscellaneous/color/UIColor.ts +844 -0
  80. package/src/core/miscellaneous/computeTransform.ts +127 -0
  81. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.ts +235 -0
  82. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.ts +524 -0
  83. package/{dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts → src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.ts} +10 -8
  84. package/src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.ts +448 -0
  85. package/src/core/miscellaneous/generic-plane/shared.ts +323 -0
  86. package/src/core/miscellaneous/insets/UIInsets.Internal.ts +9 -0
  87. package/src/core/miscellaneous/insets/UIInsets.ts +248 -0
  88. package/src/core/miscellaneous/mask-function/UIProgressMaskFunction.ts +24 -0
  89. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.ts +58 -0
  90. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.ts +52 -0
  91. package/src/core/miscellaneous/math.ts +16 -0
  92. package/src/core/miscellaneous/micro/UIMicro.Internal.ts +33 -0
  93. package/src/core/miscellaneous/micro/UIMicro.ts +222 -0
  94. package/src/core/miscellaneous/resize-policy/UIResizePolicy.ts +8 -0
  95. package/src/core/miscellaneous/resize-policy/UIResizePolicyCover.ts +57 -0
  96. package/src/core/miscellaneous/resize-policy/UIResizePolicyCross.ts +65 -0
  97. package/src/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.ts +65 -0
  98. package/src/core/miscellaneous/resize-policy/UIResizePolicyFit.ts +57 -0
  99. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.ts +65 -0
  100. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.ts +65 -0
  101. package/src/core/miscellaneous/resize-policy/UIResizePolicyNone.ts +11 -0
  102. package/src/core/miscellaneous/shared.ts +73 -0
  103. package/{dist/miscellaneous/text-span/UITextSpan.Internal.d.ts → src/core/miscellaneous/text-span/UITextSpan.Internal.ts} +5 -4
  104. package/src/core/miscellaneous/text-span/UITextSpan.ts +43 -0
  105. package/src/core/miscellaneous/text-style/UITextStyle.Internal.ts +52 -0
  106. package/src/core/miscellaneous/text-style/UITextStyle.ts +479 -0
  107. package/src/core/miscellaneous/texture/UITextureView.Internal.ts +55 -0
  108. package/src/core/miscellaneous/texture/UITextureView.ts +308 -0
  109. package/src/core/miscellaneous/webglCapabilities.ts +129 -0
  110. package/src/core/shaders/UIImage.glsl +10 -0
  111. package/src/core/shaders/UINineSlice.glsl +53 -0
  112. package/src/core/shaders/UIProgress.glsl +15 -0
  113. package/src/core/shaders/UIProgressMaskFunctionCircular.glsl +13 -0
  114. package/src/core/shaders/UIProgressMaskFunctionDirectional.glsl +12 -0
  115. package/src/core/shaders/glsl.d.ts +27 -0
  116. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.ts +23 -0
  117. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.ts +124 -0
  118. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.ts +22 -0
  119. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.ts +101 -0
  120. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.ts +58 -0
  121. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.ts +605 -0
  122. package/src/particles/behaviorModules/UIBehaviorDirectionalGravity.ts +70 -0
  123. package/src/particles/behaviorModules/UIBehaviorModule.ts +20 -0
  124. package/src/particles/behaviorModules/UIBehaviorPointGravity.ts +173 -0
  125. package/src/particles/behaviorModules/UIBehaviorScaleOverLife.ts +104 -0
  126. package/src/particles/behaviorModules/UIBehaviorTorqueDamping.ts +75 -0
  127. package/src/particles/behaviorModules/UIBehaviorTorqueNoise.ts +115 -0
  128. package/src/particles/behaviorModules/UIBehaviorVelocityDamping.ts +77 -0
  129. package/src/particles/behaviorModules/UIBehaviorVelocityNoise.ts +118 -0
  130. package/src/particles/elements/UIEmitter.Internal.ts +22 -0
  131. package/src/particles/elements/UIEmitter.ts +313 -0
  132. package/src/particles/index.ts +18 -0
  133. package/src/particles/instancedParticle/UIInstancedParticle.Internal.ts +263 -0
  134. package/src/particles/instancedParticle/UIInstancedParticle.ts +138 -0
  135. package/src/particles/miscellaneous/miscellaneous.ts +115 -0
  136. package/src/particles/renderingModules/UIRenderingColorOverLife.ts +39 -0
  137. package/src/particles/renderingModules/UIRenderingColorOverVelocity.ts +49 -0
  138. package/src/particles/renderingModules/UIRenderingModule.ts +17 -0
  139. package/src/particles/renderingModules/UIRenderingTexture.ts +30 -0
  140. package/src/particles/shaders/UIRenderingColorOverLife.glsl +4 -0
  141. package/src/particles/shaders/UIRenderingColorOverVelocity.glsl +6 -0
  142. package/src/particles/shaders/UIRenderingTexture.glsl +4 -0
  143. package/src/particles/spawnModules/UISpawnModule.ts +22 -0
  144. package/src/particles/spawnModules/UISpawnOffset.ts +62 -0
  145. package/src/particles/spawnModules/UISpawnRandomLifetime.ts +68 -0
  146. package/src/particles/spawnModules/UISpawnRandomRotation.ts +60 -0
  147. package/src/particles/spawnModules/UISpawnRandomScale.ts +81 -0
  148. package/src/particles/spawnModules/UISpawnRandomTorque.ts +62 -0
  149. package/src/particles/spawnModules/UISpawnRandomVelocity.ts +92 -0
  150. package/src/particles/spawnModules/UISpawnRectangle.ts +81 -0
  151. package/tsconfig.json +29 -0
  152. package/dist/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +0 -22
  153. package/dist/constraints/UIConstraint.d.ts +0 -12
  154. package/dist/constraints/UICustomConstraint.d.ts +0 -28
  155. package/dist/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +0 -20
  156. package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +0 -11
  157. package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +0 -36
  158. package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +0 -14
  159. package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +0 -44
  160. package/dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +0 -22
  161. package/dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +0 -43
  162. package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +0 -11
  163. package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +0 -32
  164. package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +0 -14
  165. package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +0 -44
  166. package/dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +0 -22
  167. package/dist/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +0 -20
  168. package/dist/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +0 -64
  169. package/dist/constraints/builders/UIConstraint2DBuilder.d.ts +0 -46
  170. package/dist/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +0 -13
  171. package/dist/constraints/builders/UICoverConstraintBuilder.d.ts +0 -29
  172. package/dist/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +0 -13
  173. package/dist/constraints/builders/UIFitConstraintBuilder.d.ts +0 -29
  174. package/dist/elements/UIAnchor/UIAnchor.Internal.d.ts +0 -9
  175. package/dist/elements/UIAnchor/UIAnchor.d.ts +0 -32
  176. package/dist/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +0 -27
  177. package/dist/elements/UIAnimatedImage/UIAnimatedImage.d.ts +0 -77
  178. package/dist/elements/UIElement/UIElement.Internal.d.ts +0 -11
  179. package/dist/elements/UIElement/UIElement.d.ts +0 -38
  180. package/dist/elements/UIGraphics/UIGraphics.d.ts +0 -51
  181. package/dist/elements/UIImage/UIImage.d.ts +0 -32
  182. package/dist/elements/UIInputDummy/UIInputDummy.Internal.d.ts +0 -30
  183. package/dist/elements/UIInputDummy/UIInputDummy.d.ts +0 -82
  184. package/dist/elements/UINineSlice/UINineSlice.Internal.d.ts +0 -23
  185. package/dist/elements/UINineSlice/UINineSlice.d.ts +0 -60
  186. package/dist/elements/UIProgress/UIProgress.Internal.d.ts +0 -14
  187. package/dist/elements/UIProgress/UIProgress.d.ts +0 -45
  188. package/dist/elements/UIScene/UIScene.Internal.d.ts +0 -43
  189. package/dist/elements/UIScene/UIScene.d.ts +0 -59
  190. package/dist/elements/UIText/UIText.Internal.d.ts +0 -26
  191. package/dist/elements/UIText/UIText.Measuring.d.ts +0 -50
  192. package/dist/elements/UIText/UIText.Rendering.d.ts +0 -20
  193. package/dist/elements/UIText/UIText.d.ts +0 -71
  194. package/dist/index.js +0 -9236
  195. package/dist/index.js.map +0 -1
  196. package/dist/index.min.js +0 -2
  197. package/dist/index.min.js.map +0 -1
  198. package/dist/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +0 -63
  199. package/dist/layers/UILayer/UILayer.d.ts +0 -49
  200. package/dist/miscellaneous/UIExpression.d.ts +0 -69
  201. package/dist/miscellaneous/UIMode.d.ts +0 -23
  202. package/dist/miscellaneous/UIOrientation.d.ts +0 -15
  203. package/dist/miscellaneous/UIPriority.d.ts +0 -32
  204. package/dist/miscellaneous/UIRelation.d.ts +0 -23
  205. package/dist/miscellaneous/UITransparencyMode.d.ts +0 -9
  206. package/dist/miscellaneous/area/UIArea.d.ts +0 -3
  207. package/dist/miscellaneous/area/UIAreaCircle.d.ts +0 -15
  208. package/dist/miscellaneous/area/UIAreaPolygon.d.ts +0 -12
  209. package/dist/miscellaneous/area/UIAreaRectangle.d.ts +0 -17
  210. package/dist/miscellaneous/area/UIAreaRoundedRectangle.d.ts +0 -21
  211. package/dist/miscellaneous/asserts.d.ts +0 -43
  212. package/dist/miscellaneous/canvas.d.ts +0 -31
  213. package/dist/miscellaneous/color/UIColor.Internal.d.ts +0 -7
  214. package/dist/miscellaneous/color/UIColor.d.ts +0 -234
  215. package/dist/miscellaneous/computeTransform.d.ts +0 -18
  216. package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +0 -19
  217. package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.d.ts +0 -1
  218. package/dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.d.ts +0 -1
  219. package/dist/miscellaneous/generic-plane/shared.d.ts +0 -38
  220. package/dist/miscellaneous/insets/UIInsets.Internal.d.ts +0 -11
  221. package/dist/miscellaneous/insets/UIInsets.d.ts +0 -48
  222. package/dist/miscellaneous/mask-function/UIProgressMaskFunction.d.ts +0 -9
  223. package/dist/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +0 -21
  224. package/dist/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +0 -16
  225. package/dist/miscellaneous/math.d.ts +0 -5
  226. package/dist/miscellaneous/micro/UIMicro.Internal.d.ts +0 -31
  227. package/dist/miscellaneous/micro/UIMicro.d.ts +0 -59
  228. package/dist/miscellaneous/resize-policy/UIResizePolicy.d.ts +0 -3
  229. package/dist/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +0 -22
  230. package/dist/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +0 -22
  231. package/dist/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +0 -22
  232. package/dist/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +0 -22
  233. package/dist/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +0 -22
  234. package/dist/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +0 -22
  235. package/dist/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +0 -5
  236. package/dist/miscellaneous/shared.d.ts +0 -46
  237. package/dist/miscellaneous/text-span/UITextSpan.d.ts +0 -14
  238. package/dist/miscellaneous/text-style/UITextStyle.Internal.d.ts +0 -48
  239. package/dist/miscellaneous/text-style/UITextStyle.d.ts +0 -85
  240. package/dist/miscellaneous/texture/UITextureView.Internal.d.ts +0 -49
  241. package/dist/miscellaneous/texture/UITextureView.d.ts +0 -67
  242. package/dist/miscellaneous/webglCapabilities.d.ts +0 -2
  243. package/dist/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +0 -17
  244. package/dist/wrappers/UIInputWrapper/UIInputWrapper.d.ts +0 -13
  245. package/dist/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +0 -13
  246. package/dist/wrappers/UISceneWrapper/UISceneWrapper.d.ts +0 -20
  247. package/dist/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +0 -49
  248. package/dist/wrappers/UISolverWrapper/UISolverWrapper.d.ts +0 -215
@@ -0,0 +1,39 @@
1
+ import { Operator } from "@lume/kiwi";
2
+
3
+ /** Relational operators for constraints */
4
+ export enum UIRelation {
5
+ /** Equality: LHS = RHS */
6
+ EQUAL = 0,
7
+ /** Less than or equal: LHS ≤ RHS */
8
+ LESS_THAN = 1,
9
+ /** Greater than or equal: LHS ≥ RHS */
10
+ GREATER_THAN = 2,
11
+ }
12
+
13
+ /**
14
+ * Converts relation to solver operator.
15
+ * @param relation Relation type
16
+ * @returns Solver operator
17
+ * @throws If relation is invalid
18
+ */
19
+ export function convertRelation(relation: UIRelation): Operator {
20
+ switch (relation) {
21
+ case UIRelation.EQUAL:
22
+ return Operator.Eq;
23
+ case UIRelation.LESS_THAN:
24
+ return Operator.Le;
25
+ case UIRelation.GREATER_THAN:
26
+ return Operator.Ge;
27
+ default:
28
+ throw new Error(`convertRelation.relation: invalid relation`);
29
+ }
30
+ }
31
+
32
+ /**
33
+ * Resolves optional relation.
34
+ * @param relation Relation to resolve
35
+ * @returns Relation or EQUAL if undefined
36
+ */
37
+ export function resolveRelation(relation?: UIRelation): UIRelation {
38
+ return relation ?? UIRelation.EQUAL;
39
+ }
@@ -0,0 +1,9 @@
1
+ /** Transparency rendering modes */
2
+ export enum UITransparencyMode {
3
+ /** Binary transparency. Best performance. */
4
+ CLIP = 0,
5
+ /** Dithered transparency. Good performance. */
6
+ HASH = 1,
7
+ /** Alpha blending. Best quality, requires depth sorting. */
8
+ BLEND = 2,
9
+ }
@@ -0,0 +1,5 @@
1
+ /** Base class for interaction area shapes */
2
+ export abstract class UIArea {
3
+ /** @internal */
4
+ public abstract contains(pointX: number, pointY: number): boolean;
5
+ }
@@ -0,0 +1,32 @@
1
+ import { assertValidNonNegativeNumber, assertValidNumber } from "../asserts";
2
+ import { UIArea } from "./UIArea";
3
+
4
+ /** Circular interaction area */
5
+ export class UIAreaCircle extends UIArea {
6
+ /**
7
+ * Creates circular area.
8
+ *
9
+ * @param centerX - Center X in normalized coordinates (0 to 1)
10
+ * @param centerY - Center Y in normalized coordinates (0 to 1)
11
+ * @param radius - Radius in normalized coordinates (0 to 1)
12
+ */
13
+ constructor(
14
+ public centerX: number,
15
+ public centerY: number,
16
+ public radius: number,
17
+ ) {
18
+ super();
19
+ assertValidNonNegativeNumber(centerX, "UIAreaCircle.constructor.centerX");
20
+ assertValidNonNegativeNumber(centerY, "UIAreaCircle.constructor.centerY");
21
+ assertValidNonNegativeNumber(radius, "UIAreaCircle.constructor.radius");
22
+ }
23
+
24
+ /** @internal */
25
+ public contains(pointX: number, pointY: number): boolean {
26
+ assertValidNumber(pointX, "UIAreaCircle.contains.pointX");
27
+ assertValidNumber(pointY, "UIAreaCircle.contains.pointY");
28
+ const deltaX = pointX - this.centerX;
29
+ const deltaY = pointY - this.centerY;
30
+ return deltaX * deltaX + deltaY * deltaY <= this.radius * this.radius;
31
+ }
32
+ }
@@ -0,0 +1,50 @@
1
+ import { assertValidNumber } from "../asserts";
2
+ import type { Vector2Like } from "../math";
3
+ import { UIArea } from "./UIArea";
4
+
5
+ /** Polygonal interaction area using ray casting */
6
+ export class UIAreaPolygon extends UIArea {
7
+ /**
8
+ * Creates polygonal area.
9
+ *
10
+ * @param vertices - Vertices in normalized coordinates (0 to 1)
11
+ */
12
+ constructor(public vertices: Vector2Like[]) {
13
+ super();
14
+ }
15
+
16
+ /** @internal */
17
+ public contains(pointX: number, pointY: number): boolean {
18
+ assertValidNumber(pointX, "UIAreaPolygon.contains.pointX");
19
+ assertValidNumber(pointY, "UIAreaPolygon.contains.pointY");
20
+ const vertexCount = this.vertices.length;
21
+ if (vertexCount < 3) {
22
+ return false;
23
+ }
24
+
25
+ let inside = false;
26
+
27
+ for (
28
+ let index = 0, previousIndex = vertexCount - 1;
29
+ index < vertexCount;
30
+ previousIndex = index++
31
+ ) {
32
+ const currentVertex = this.vertices[index];
33
+ const previousVertex = this.vertices[previousIndex];
34
+
35
+ const currentX = currentVertex.x;
36
+ const currentY = currentVertex.y;
37
+ const previousX = previousVertex.x;
38
+ const previousY = previousVertex.y;
39
+
40
+ if (
41
+ currentY > pointY !== previousY > pointY &&
42
+ pointX < ((previousX - currentX) * (pointY - currentY)) / (previousY - currentY) + currentX
43
+ ) {
44
+ inside = !inside;
45
+ }
46
+ }
47
+
48
+ return inside;
49
+ }
50
+ }
@@ -0,0 +1,38 @@
1
+ import { assertValidNonNegativeNumber, assertValidNumber } from "../asserts";
2
+ import { UIArea } from "./UIArea";
3
+
4
+ /** Rectangular interaction area */
5
+ export class UIAreaRectangle extends UIArea {
6
+ /**
7
+ * Creates rectangular area.
8
+ *
9
+ * @param x - X position in normalized coordinates (0 to 1)
10
+ * @param y - Y position in normalized coordinates (0 to 1)
11
+ * @param width - Width in normalized coordinates (0 to 1)
12
+ * @param height - Height in normalized coordinates (0 to 1)
13
+ */
14
+ constructor(
15
+ public x: number,
16
+ public y: number,
17
+ public width: number,
18
+ public height: number,
19
+ ) {
20
+ super();
21
+ assertValidNonNegativeNumber(x, "UIAreaRectangle.constructor.x");
22
+ assertValidNonNegativeNumber(y, "UIAreaRectangle.constructor.y");
23
+ assertValidNonNegativeNumber(width, "UIAreaRectangle.constructor.width");
24
+ assertValidNonNegativeNumber(height, "UIAreaRectangle.constructor.height");
25
+ }
26
+
27
+ /** @internal */
28
+ public contains(pointX: number, pointY: number): boolean {
29
+ assertValidNumber(pointX, "UIAreaRectangle.contains.pointX");
30
+ assertValidNumber(pointY, "UIAreaRectangle.contains.pointY");
31
+ return (
32
+ pointX >= this.x &&
33
+ pointX <= this.x + this.width &&
34
+ pointY >= this.y &&
35
+ pointY <= this.y + this.height
36
+ );
37
+ }
38
+ }
@@ -0,0 +1,78 @@
1
+ import { assertValidNonNegativeNumber, assertValidNumber } from "../asserts";
2
+ import { UIArea } from "./UIArea";
3
+
4
+ /** Rectangular interaction area with rounded corners */
5
+ export class UIAreaRoundedRectangle extends UIArea {
6
+ /**
7
+ * Creates rounded rectangular area.
8
+ *
9
+ * Radius clamped to half of smallest dimension.
10
+ *
11
+ * @param x - X position in normalized coordinates (0 to 1)
12
+ * @param y - Y position in normalized coordinates (0 to 1)
13
+ * @param width - Width in normalized coordinates (0 to 1)
14
+ * @param height - Height in normalized coordinates (0 to 1)
15
+ * @param radius - Corner radius in normalized coordinates (0 to 1)
16
+ */
17
+ constructor(
18
+ public x: number,
19
+ public y: number,
20
+ public width: number,
21
+ public height: number,
22
+ public radius: number,
23
+ ) {
24
+ super();
25
+ assertValidNonNegativeNumber(x, "UIAreaRoundedRectangle.constructor.x");
26
+ assertValidNonNegativeNumber(y, "UIAreaRoundedRectangle.constructor.y");
27
+ assertValidNonNegativeNumber(width, "UIAreaRoundedRectangle.constructor.width");
28
+ assertValidNonNegativeNumber(height, "UIAreaRoundedRectangle.constructor.height");
29
+ assertValidNonNegativeNumber(radius, "UIAreaRoundedRectangle.constructor.radius");
30
+ this.radius = Math.min(radius, Math.min(width, height) / 2);
31
+ }
32
+
33
+ /** @internal */
34
+ public contains(pointX: number, pointY: number): boolean {
35
+ assertValidNumber(pointX, "UIAreaRoundedRectangle.contains.pointX");
36
+ assertValidNumber(pointY, "UIAreaRoundedRectangle.contains.pointY");
37
+ const left = this.x;
38
+ const right = this.x + this.width;
39
+ const top = this.y;
40
+ const bottom = this.y + this.height;
41
+
42
+ if (pointX < left || pointX > right || pointY < top || pointY > bottom) {
43
+ return false;
44
+ }
45
+
46
+ const cornerLeft = left + this.radius;
47
+ const cornerRight = right - this.radius;
48
+ const cornerTop = top + this.radius;
49
+ const cornerBottom = bottom - this.radius;
50
+
51
+ if (pointX >= cornerLeft && pointX <= cornerRight) {
52
+ return true;
53
+ }
54
+
55
+ if (pointY >= cornerTop && pointY <= cornerBottom) {
56
+ return true;
57
+ }
58
+
59
+ let centerX: number;
60
+ let centerY: number;
61
+
62
+ if (pointX < cornerLeft) {
63
+ centerX = cornerLeft;
64
+ } else {
65
+ centerX = cornerRight;
66
+ }
67
+
68
+ if (pointY < cornerTop) {
69
+ centerY = cornerTop;
70
+ } else {
71
+ centerY = cornerBottom;
72
+ }
73
+
74
+ const deltaX = pointX - centerX;
75
+ const deltaY = pointY - centerY;
76
+ return deltaX * deltaX + deltaY * deltaY <= this.radius * this.radius;
77
+ }
78
+ }
@@ -0,0 +1,187 @@
1
+ import { UILayer } from "../layers/UILayer/UILayer";
2
+ import { EPSILON } from "./math";
3
+ import { isUILayerElement } from "./shared";
4
+
5
+ /**
6
+ * Validates value is finite number within safe range.
7
+ * @param value Number to validate
8
+ * @param subject Value name for error messages
9
+ * @throws If value is not finite or exceeds safe range
10
+ */
11
+ export function assertValidNumber(value: number, subject: string): void {
12
+ if (process.env.NODE_ENV !== "production") {
13
+ if (!Number.isFinite(value)) {
14
+ throw new Error(`${subject}: value must be a finite number`);
15
+ }
16
+
17
+ if (Math.abs(value) > Number.MAX_SAFE_INTEGER) {
18
+ throw new Error(`${subject}: value exceeds maximum safe integer range`);
19
+ }
20
+ }
21
+ }
22
+
23
+ /**
24
+ * Validates value is positive (>= EPSILON).
25
+ * @param value Number to validate
26
+ * @param subject Value name for error messages
27
+ * @throws If value is invalid or below EPSILON
28
+ */
29
+ export function assertValidPositiveNumber(value: number, subject: string): void {
30
+ if (process.env.NODE_ENV !== "production") {
31
+ assertValidNumber(value, subject);
32
+ if (value < EPSILON) {
33
+ throw new Error(`${subject}: value must be greater than or equal to ${EPSILON}`);
34
+ }
35
+ }
36
+ }
37
+
38
+ /**
39
+ * Validates value is non-negative (>= 0).
40
+ * @param value Number to validate
41
+ * @param subject Value name for error messages
42
+ * @throws If value is invalid or negative
43
+ */
44
+ export function assertValidNonNegativeNumber(value: number, subject: string): void {
45
+ if (process.env.NODE_ENV !== "production") {
46
+ assertValidNumber(value, subject);
47
+ if (value < 0) {
48
+ throw new Error(`${subject}: value must be greater than or equal to 0`);
49
+ }
50
+ }
51
+ }
52
+
53
+ /**
54
+ * Validates constraint arguments are from same layer.
55
+ * @param a First constraint subject
56
+ * @param b Second constraint subject
57
+ * @param subject Constraint name for error messages
58
+ * @returns Common layer for both subjects
59
+ * @throws If subjects are invalid or from different layers
60
+ */
61
+ export function assertValidConstraintArguments(a: unknown, b: unknown, subject: string): UILayer {
62
+ if (process.env.NODE_ENV !== "production") {
63
+ if (a instanceof UILayer && b instanceof UILayer) {
64
+ throw new Error(`${subject}: layer cannot be snapped to another layer`);
65
+ }
66
+
67
+ let layerA: UILayer;
68
+ let layerB: UILayer;
69
+
70
+ if (a instanceof UILayer) {
71
+ layerA = a;
72
+ } else if (isUILayerElement(a)) {
73
+ layerA = a.layer;
74
+ } else {
75
+ throw new Error(`${subject}: A must be a UILayer or a UILayerElement`);
76
+ }
77
+
78
+ if (b instanceof UILayer) {
79
+ layerB = b;
80
+ } else if (isUILayerElement(b)) {
81
+ layerB = b.layer;
82
+ } else {
83
+ throw new Error(`${subject}: B must be a UILayer or a UILayerElement`);
84
+ }
85
+
86
+ if (layerA !== layerB) {
87
+ throw new Error(`${subject}: elements must be on the same layer`);
88
+ }
89
+
90
+ return layerA;
91
+ }
92
+
93
+ if (a instanceof UILayer) {
94
+ return a;
95
+ }
96
+ if (isUILayerElement(a)) {
97
+ return a.layer;
98
+ }
99
+ if (b instanceof UILayer) {
100
+ return b;
101
+ }
102
+ if (isUILayerElement(b)) {
103
+ return b.layer;
104
+ }
105
+
106
+ throw new Error(`${subject}: no valid subjects found`);
107
+ }
108
+
109
+ /**
110
+ * Validates interpolation constraint subjects.
111
+ * @param subject Constraint name for error messages
112
+ * @param a First element
113
+ * @param b Second element
114
+ * @param c Element to interpolate
115
+ * @param anchorA Anchor on element A
116
+ * @param anchorB Anchor on element B
117
+ * @returns Common layer for all subjects
118
+ * @throws If subjects violate interpolation constraints
119
+ */
120
+ export function assertValidInterpolationConstraintArguments(
121
+ subject: string,
122
+ a: unknown,
123
+ b: unknown,
124
+ c: unknown,
125
+ anchorA: number,
126
+ anchorB: number,
127
+ ): UILayer {
128
+ if (process.env.NODE_ENV !== "production") {
129
+ if (c instanceof UILayer) {
130
+ throw new Error(`${subject}: C cannot be a layer`);
131
+ }
132
+
133
+ if (!isUILayerElement(c)) {
134
+ throw new Error(`${subject}: C must be a UILayerElement`);
135
+ }
136
+
137
+ let layerA: UILayer;
138
+ let layerB: UILayer;
139
+
140
+ if (a instanceof UILayer || isUILayerElement(a)) {
141
+ layerA = a instanceof UILayer ? a : a.layer;
142
+ } else {
143
+ throw new Error(`${subject}: A must be UILayer or UILayerElement`);
144
+ }
145
+
146
+ if (b instanceof UILayer || isUILayerElement(b)) {
147
+ layerB = b instanceof UILayer ? b : b.layer;
148
+ } else {
149
+ throw new Error(`${subject}: B must be UILayer or UILayerElement`);
150
+ }
151
+
152
+ const layerC = c.layer;
153
+
154
+ if (layerA !== layerB || layerA !== layerC) {
155
+ throw new Error(`${subject}: all elements must be on the same layer`);
156
+ }
157
+
158
+ if (c === a || c === b) {
159
+ throw new Error(`${subject}: C cannot be equal to A or B`);
160
+ }
161
+
162
+ if (a === b) {
163
+ if (Math.abs(anchorA - anchorB) <= EPSILON) {
164
+ throw new Error(
165
+ `${subject}: when A and B are the same, anchorA and anchorB must differ by more than ${EPSILON}`,
166
+ );
167
+ }
168
+ }
169
+
170
+ return layerA;
171
+ }
172
+
173
+ if (isUILayerElement(a)) {
174
+ return a.layer;
175
+ }
176
+ if (isUILayerElement(b)) {
177
+ return b.layer;
178
+ }
179
+ if (a instanceof UILayer) {
180
+ return a;
181
+ }
182
+ if (b instanceof UILayer) {
183
+ return b;
184
+ }
185
+
186
+ throw new Error(`${subject}: no valid subjects found`);
187
+ }
@@ -0,0 +1,73 @@
1
+ import {
2
+ CanvasTexture,
3
+ ClampToEdgeWrapping,
4
+ LinearFilter,
5
+ RGBAFormat,
6
+ UnsignedByteType,
7
+ UVMapping,
8
+ SRGBColorSpace,
9
+ NoColorSpace,
10
+ } from "three";
11
+ import { checkOffscreenCanvasSupport, checkSRGBSupport } from "./webglCapabilities";
12
+
13
+ /** Canvas type that works both in main thread and workers */
14
+ export type UICanvas = HTMLCanvasElement | OffscreenCanvas;
15
+
16
+ /** 2D rendering context type for UICanvas */
17
+ export type UICanvasRenderingContext2D =
18
+ | CanvasRenderingContext2D
19
+ | OffscreenCanvasRenderingContext2D;
20
+
21
+ /**
22
+ * Creates a canvas using OffscreenCanvas if available, otherwise falls back to HTMLCanvasElement.
23
+ *
24
+ * @param width - Canvas width in pixels
25
+ * @param height - Canvas height in pixels
26
+ * @returns Canvas instance
27
+ */
28
+ export function createCanvas(width: number, height: number): UICanvas {
29
+ if (checkOffscreenCanvasSupport()) {
30
+ return new OffscreenCanvas(width, height);
31
+ }
32
+ const canvasElement = document.createElement("canvas");
33
+ canvasElement.width = width;
34
+ canvasElement.height = height;
35
+ return canvasElement;
36
+ }
37
+
38
+ /**
39
+ * Gets the 2D rendering context for a UICanvas.
40
+ *
41
+ * @param canvas - Canvas instance
42
+ * @returns 2D rendering context or null
43
+ */
44
+ export function getCanvas2DContext(canvas: UICanvas): UICanvasRenderingContext2D | null {
45
+ return canvas.getContext("2d");
46
+ }
47
+
48
+ /**
49
+ * Creates a CanvasTexture with maximum WebGL1/WebGL2 compatibility.
50
+ * - ClampToEdge wrapping (required for NPOT in WebGL1)
51
+ * - Linear filtering without mipmaps (NPOT-safe)
52
+ * - RGBA/UnsignedByte format (no extensions needed)
53
+ * - sRGB colorspace only if supported
54
+ *
55
+ * @param canvas - Source canvas
56
+ * @returns Configured CanvasTexture
57
+ */
58
+ export function createCanvasTexture(canvas: UICanvas): CanvasTexture {
59
+ const texture = new CanvasTexture(
60
+ canvas,
61
+ UVMapping,
62
+ ClampToEdgeWrapping,
63
+ ClampToEdgeWrapping,
64
+ LinearFilter,
65
+ LinearFilter,
66
+ RGBAFormat,
67
+ UnsignedByteType,
68
+ 1,
69
+ );
70
+ texture.colorSpace = checkSRGBSupport() ? SRGBColorSpace : NoColorSpace;
71
+ texture.generateMipmaps = false;
72
+ return texture;
73
+ }
@@ -0,0 +1,89 @@
1
+ import type { Color } from "three";
2
+ import type { UIColor } from "./UIColor";
3
+
4
+ /** Color configuration as Three.js Color, hex number, hex string, or UIColor */
5
+ export type UIColorConfig = Color | number | string | UIColor;
6
+
7
+ /** Predefined color names */
8
+ export type UIColorName =
9
+ | "black"
10
+ | "white"
11
+ | "red"
12
+ | "green"
13
+ | "blue"
14
+ | "yellow"
15
+ | "cyan"
16
+ | "magenta"
17
+ | "gray"
18
+ | "grey"
19
+ | "silver"
20
+ | "maroon"
21
+ | "olive"
22
+ | "lime"
23
+ | "aqua"
24
+ | "teal"
25
+ | "navy"
26
+ | "fuchsia"
27
+ | "purple"
28
+ | "orange"
29
+ | "pink"
30
+ | "brown"
31
+ | "gold"
32
+ | "violet"
33
+ | "indigo"
34
+ | "coral"
35
+ | "salmon"
36
+ | "khaki"
37
+ | "plum"
38
+ | "orchid"
39
+ | "tan"
40
+ | "beige"
41
+ | "mint"
42
+ | "lavender"
43
+ | "crimson"
44
+ | "azure"
45
+ | "ivory"
46
+ | "snow";
47
+
48
+ export const COLORS: Record<string, number | undefined> = {
49
+ black: 0x000000,
50
+ white: 0xffffff,
51
+ red: 0xff0000,
52
+ green: 0x008000,
53
+ blue: 0x0000ff,
54
+ yellow: 0xffff00,
55
+ cyan: 0x00ffff,
56
+ magenta: 0xff00ff,
57
+
58
+ gray: 0x808080,
59
+ grey: 0x808080,
60
+ silver: 0xc0c0c0,
61
+ maroon: 0x800000,
62
+ olive: 0x808000,
63
+ lime: 0x00ff00,
64
+ aqua: 0x00ffff,
65
+ teal: 0x008080,
66
+ navy: 0x000080,
67
+ fuchsia: 0xff00ff,
68
+ purple: 0x800080,
69
+
70
+ orange: 0xffa500,
71
+ pink: 0xffc0cb,
72
+ brown: 0xa52a2a,
73
+ gold: 0xffd700,
74
+ violet: 0xee82ee,
75
+ indigo: 0x4b0082,
76
+ coral: 0xff7f50,
77
+ salmon: 0xfa8072,
78
+ khaki: 0xf0e68c,
79
+ plum: 0xdda0dd,
80
+ orchid: 0xda70d6,
81
+ tan: 0xd2b48c,
82
+ beige: 0xf5f5dc,
83
+ mint: 0x98fb98,
84
+ lavender: 0xe6e6fa,
85
+ crimson: 0xdc143c,
86
+ azure: 0xf0ffff,
87
+ ivory: 0xfffff0,
88
+ snow: 0xfffafa,
89
+ };