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,448 @@
1
+ import type { Matrix4, Scene } from "three";
2
+ import type { UITransparencyMode } from "../../UITransparencyMode";
3
+ import type { UIProperty } from "../shared";
4
+ import {
5
+ cloneGLProperties,
6
+ cloneProperties,
7
+ convertUIPropertiesToGLProperties,
8
+ extractZIndex,
9
+ } from "../shared";
10
+ import { UIGenericInstancedPlane } from "../UIGenericInstancedPlane/UIGenericInstancedPlane";
11
+ import type { PlaneDescriptor, PlaneState } from "./UIGenericPlaneRegistry.Internal";
12
+
13
+ /**
14
+ * Manages shader plane instances with automatic batching based on zIndex order.
15
+ *
16
+ * Uses dirty/flush pattern:
17
+ * - Mutations update internal state and mark dirty
18
+ * - flush() applies all pending changes to GPU representation
19
+ * - setVisibility is immediate (doesn't affect structure)
20
+ *
21
+ * @internal
22
+ */
23
+ export class UIPlaneRegistry {
24
+ private readonly scene: Scene;
25
+
26
+ // Source of truth
27
+ private readonly handlerToState: Map<number, PlaneState> = new Map();
28
+ private lastHandler = 0;
29
+
30
+ // GPU representation
31
+ private readonly orderedMeshes: UIGenericInstancedPlane[] = [];
32
+ private readonly handlerToDescriptor: Map<number, PlaneDescriptor> = new Map();
33
+
34
+ // Dirty tracking
35
+ private readonly pendingCreate: Set<number> = new Set();
36
+ private readonly pendingDelete: Set<number> = new Set();
37
+ private readonly pendingRelocate: Set<number> = new Set();
38
+ private needsFlush = false;
39
+
40
+ constructor(scene: Scene) {
41
+ this.scene = scene;
42
+ }
43
+
44
+ /**
45
+ * Creates plane with given shader and properties.
46
+ * Properties and transform are cloned; originals can be safely modified.
47
+ * Changes are pending until flush() is called.
48
+ * @returns Plane handler for subsequent operations
49
+ */
50
+ public createPlane(
51
+ source: string,
52
+ properties: Record<string, UIProperty>,
53
+ transform: Matrix4,
54
+ visibility: boolean,
55
+ transparency: UITransparencyMode,
56
+ ): number {
57
+ const handler = this.lastHandler++;
58
+ const glProperties = convertUIPropertiesToGLProperties(cloneProperties(properties));
59
+ const zIndex = extractZIndex(transform);
60
+
61
+ const state: PlaneState = {
62
+ source,
63
+ properties: glProperties,
64
+ transform: transform.clone(),
65
+ visibility,
66
+ transparency,
67
+ zIndex,
68
+ };
69
+
70
+ this.handlerToState.set(handler, state);
71
+ this.pendingCreate.add(handler);
72
+ this.needsFlush = true;
73
+
74
+ return handler;
75
+ }
76
+
77
+ /**
78
+ * Removes plane. Changes are pending until flush() is called.
79
+ */
80
+ public destroyPlane(handler: number): void {
81
+ if (!this.handlerToState.has(handler)) {
82
+ throw new Error(`UIPlaneRegistry.destroyPlane: handler ${handler} not found`);
83
+ }
84
+
85
+ this.handlerToState.delete(handler);
86
+
87
+ // If was pending create, just remove from there
88
+ if (this.pendingCreate.has(handler)) {
89
+ this.pendingCreate.delete(handler);
90
+ return;
91
+ }
92
+
93
+ // Remove from relocate if was there
94
+ this.pendingRelocate.delete(handler);
95
+
96
+ // Mark for deletion
97
+ this.pendingDelete.add(handler);
98
+ this.needsFlush = true;
99
+ }
100
+
101
+ /**
102
+ * Updates plane properties.
103
+ * Values are copied; originals can be safely modified.
104
+ * If texture changes, element will be relocated on flush().
105
+ * Instantiable properties are applied immediately.
106
+ */
107
+ public setProperties(handler: number, properties: Record<string, UIProperty>): void {
108
+ const state = this.resolveState(handler);
109
+ const glProperties = convertUIPropertiesToGLProperties(properties);
110
+
111
+ // Check if any non-instantiable (texture) changed
112
+ let textureChanged = false;
113
+ for (const name in glProperties) {
114
+ const newProp = glProperties[name];
115
+ const oldProp = state.properties[name];
116
+
117
+ if (!newProp.glslTypeInfo.instantiable) {
118
+ if (oldProp.value !== newProp.value) {
119
+ textureChanged = true;
120
+ }
121
+ }
122
+
123
+ // Update state
124
+ state.properties[name] = {
125
+ value: newProp.value,
126
+ glslTypeInfo: newProp.glslTypeInfo,
127
+ };
128
+ }
129
+
130
+ if (textureChanged && !this.pendingCreate.has(handler)) {
131
+ this.pendingRelocate.add(handler);
132
+ this.needsFlush = true;
133
+ } else {
134
+ // Apply immediately if already in mesh and no texture change
135
+ const descriptor = this.handlerToDescriptor.get(handler);
136
+ if (descriptor) {
137
+ descriptor.mesh.setPropertiesAt(descriptor.instanceIndex, glProperties);
138
+ }
139
+ }
140
+ }
141
+
142
+ /**
143
+ * Updates plane transform matrix.
144
+ * Matrix is copied; original can be safely modified.
145
+ * If zIndex changes, element will be relocated on flush().
146
+ */
147
+ public setTransform(handler: number, transform: Matrix4): void {
148
+ const state = this.resolveState(handler);
149
+ const newZIndex = extractZIndex(transform);
150
+ const oldZIndex = state.zIndex;
151
+
152
+ state.transform.copy(transform);
153
+ state.zIndex = newZIndex;
154
+
155
+ if (oldZIndex !== newZIndex && !this.pendingCreate.has(handler)) {
156
+ this.pendingRelocate.add(handler);
157
+ this.needsFlush = true;
158
+ } else {
159
+ // Apply immediately if already in mesh and zIndex unchanged
160
+ const descriptor = this.handlerToDescriptor.get(handler);
161
+ if (descriptor) {
162
+ descriptor.mesh.setTransformAt(descriptor.instanceIndex, transform);
163
+ }
164
+ }
165
+ }
166
+
167
+ /**
168
+ * Updates plane visibility.
169
+ * This is applied immediately (doesn't affect batching structure).
170
+ */
171
+ public setVisibility(handler: number, visibility: boolean): void {
172
+ const state = this.resolveState(handler);
173
+ state.visibility = visibility;
174
+
175
+ // Apply immediately if already in a mesh
176
+ const descriptor = this.handlerToDescriptor.get(handler);
177
+ if (descriptor) {
178
+ descriptor.mesh.setVisibilityAt(descriptor.instanceIndex, visibility);
179
+ }
180
+ }
181
+
182
+ /**
183
+ * Updates plane transparency mode.
184
+ * Element will be relocated on flush() if transparency changes.
185
+ */
186
+ public setTransparency(handler: number, transparency: UITransparencyMode): void {
187
+ const state = this.resolveState(handler);
188
+
189
+ if (state.transparency === transparency) {
190
+ return;
191
+ }
192
+
193
+ state.transparency = transparency;
194
+
195
+ if (!this.pendingCreate.has(handler)) {
196
+ this.pendingRelocate.add(handler);
197
+ this.needsFlush = true;
198
+ }
199
+ }
200
+
201
+ /**
202
+ * Apply all pending changes to GPU representation.
203
+ * Call this before rendering.
204
+ */
205
+ public flush(): void {
206
+ if (!this.needsFlush) {
207
+ return;
208
+ }
209
+
210
+ this.processDeletes();
211
+ this.processRelocates();
212
+ this.processCreates();
213
+ this.mergeCompatibleNeighbors();
214
+ this.cleanupEmptyMeshes();
215
+ this.syncSceneOrder();
216
+
217
+ this.pendingCreate.clear();
218
+ this.pendingDelete.clear();
219
+ this.pendingRelocate.clear();
220
+ this.needsFlush = false;
221
+ }
222
+
223
+ private processDeletes(): void {
224
+ for (const handler of this.pendingDelete) {
225
+ const descriptor = this.handlerToDescriptor.get(handler);
226
+ if (!descriptor) {
227
+ continue; // Already removed
228
+ }
229
+
230
+ const { mesh, instanceIndex } = descriptor;
231
+
232
+ mesh.removeAt(instanceIndex);
233
+ this.shiftHandlerIndices(mesh, instanceIndex + 1, -1);
234
+ this.handlerToDescriptor.delete(handler);
235
+ }
236
+ }
237
+
238
+ private processRelocates(): void {
239
+ for (const handler of this.pendingRelocate) {
240
+ const descriptor = this.handlerToDescriptor.get(handler);
241
+ if (!descriptor) {
242
+ continue; // Not in mesh yet
243
+ }
244
+
245
+ const { mesh, instanceIndex } = descriptor;
246
+
247
+ mesh.removeAt(instanceIndex);
248
+ this.shiftHandlerIndices(mesh, instanceIndex + 1, -1);
249
+ this.handlerToDescriptor.delete(handler);
250
+
251
+ // Will be re-inserted in processCreates
252
+ this.pendingCreate.add(handler);
253
+ }
254
+ }
255
+
256
+ private processCreates(): void {
257
+ if (this.pendingCreate.size === 0) {
258
+ return;
259
+ }
260
+
261
+ // Collect and sort by zIndex
262
+ const toCreate: { handler: number; state: PlaneState }[] = [];
263
+ for (const handler of this.pendingCreate) {
264
+ const state = this.handlerToState.get(handler);
265
+ if (state) {
266
+ toCreate.push({ handler, state });
267
+ }
268
+ }
269
+
270
+ toCreate.sort((a, b) => a.state.zIndex - b.state.zIndex);
271
+
272
+ // Check for duplicate zIndex
273
+ for (let i = 1; i < toCreate.length; i++) {
274
+ if (toCreate[i].state.zIndex === toCreate[i - 1].state.zIndex) {
275
+ throw new Error(
276
+ `UIPlaneRegistry.flush: duplicate zIndex=${toCreate[i].state.zIndex} ` +
277
+ `for handlers ${toCreate[i - 1].handler} and ${toCreate[i].handler}`,
278
+ );
279
+ }
280
+ }
281
+
282
+ // Insert each element
283
+ for (const { handler, state } of toCreate) {
284
+ this.insertSingleElement(handler, state);
285
+ }
286
+ }
287
+
288
+ private insertSingleElement(handler: number, state: PlaneState): void {
289
+ const { source, properties, transform, visibility, transparency, zIndex } = state;
290
+
291
+ // Find compatible mesh
292
+ let candidateMesh: UIGenericInstancedPlane | null = null;
293
+
294
+ for (const mesh of this.orderedMeshes) {
295
+ if (!mesh.isCompatibleWith(source, properties, transparency)) {
296
+ continue;
297
+ }
298
+
299
+ if (mesh.instancesCount === 0) {
300
+ candidateMesh = mesh;
301
+ break;
302
+ }
303
+
304
+ const meshMinZ = mesh.getZIndexAt(0);
305
+ const meshMaxZ = mesh.getZIndexAt(mesh.instancesCount - 1);
306
+
307
+ // Can insert if zIndex fits within or extends the range
308
+ if (zIndex >= meshMinZ - 1 && zIndex <= meshMaxZ + 1) {
309
+ candidateMesh = mesh;
310
+ break;
311
+ }
312
+ }
313
+
314
+ if (candidateMesh) {
315
+ const instanceIndex = this.findInstanceIndexInMesh(candidateMesh, zIndex);
316
+
317
+ candidateMesh.insertAt(instanceIndex, properties, transform, visibility);
318
+ this.shiftHandlerIndices(candidateMesh, instanceIndex, 1);
319
+ this.handlerToDescriptor.set(handler, {
320
+ mesh: candidateMesh,
321
+ instanceIndex,
322
+ });
323
+ } else {
324
+ // Create new mesh
325
+ const meshIndex = this.findMeshIndexForZIndex(zIndex);
326
+
327
+ const mesh = new UIGenericInstancedPlane(source, cloneGLProperties(properties), transparency);
328
+ mesh.insertAt(0, properties, transform, visibility);
329
+
330
+ this.orderedMeshes.splice(meshIndex, 0, mesh);
331
+ this.scene.add(mesh);
332
+
333
+ this.handlerToDescriptor.set(handler, { mesh, instanceIndex: 0 });
334
+ }
335
+ }
336
+
337
+ private mergeCompatibleNeighbors(): void {
338
+ let i = 0;
339
+ while (i < this.orderedMeshes.length - 1) {
340
+ const left = this.orderedMeshes[i];
341
+ const right = this.orderedMeshes[i + 1];
342
+
343
+ if (left.instancesCount === 0 || right.instancesCount === 0) {
344
+ i++;
345
+ continue;
346
+ }
347
+
348
+ const leftMaxZ = left.getZIndexAt(left.instancesCount - 1);
349
+ const rightMinZ = right.getZIndexAt(0);
350
+
351
+ // Check if they can be merged (non-overlapping zIndex ranges and compatible)
352
+ if (
353
+ leftMaxZ < rightMinZ &&
354
+ left.isCompatibleWith(right.source, right.getProperties(), right.transparency)
355
+ ) {
356
+ const indexOffset = left.instancesCount;
357
+ left.merge(right);
358
+ this.remapHandlersAfterMerge(right, left, indexOffset);
359
+
360
+ this.scene.remove(right);
361
+ right.destroy();
362
+ this.orderedMeshes.splice(i + 1, 1);
363
+
364
+ // Don't increment i, check if we can merge again
365
+ continue;
366
+ }
367
+
368
+ i++;
369
+ }
370
+ }
371
+
372
+ private cleanupEmptyMeshes(): void {
373
+ for (let i = this.orderedMeshes.length - 1; i >= 0; i--) {
374
+ const mesh = this.orderedMeshes[i];
375
+ if (mesh.instancesCount === 0) {
376
+ this.scene.remove(mesh);
377
+ mesh.destroy();
378
+ this.orderedMeshes.splice(i, 1);
379
+ }
380
+ }
381
+ }
382
+
383
+ private resolveState(handler: number): PlaneState {
384
+ const state = this.handlerToState.get(handler);
385
+ if (!state) {
386
+ throw new Error(`UIPlaneRegistry.resolveState: handler ${handler} not found`);
387
+ }
388
+ return state;
389
+ }
390
+
391
+ private findMeshIndexForZIndex(zIndex: number): number {
392
+ for (let i = 0; i < this.orderedMeshes.length; i++) {
393
+ const mesh = this.orderedMeshes[i];
394
+ if (mesh.instancesCount > 0 && mesh.getZIndexAt(0) > zIndex) {
395
+ return i;
396
+ }
397
+ }
398
+ return this.orderedMeshes.length;
399
+ }
400
+
401
+ private findInstanceIndexInMesh(mesh: UIGenericInstancedPlane, zIndex: number): number {
402
+ for (let i = 0; i < mesh.instancesCount; i++) {
403
+ if (mesh.getZIndexAt(i) > zIndex) {
404
+ return i;
405
+ }
406
+ }
407
+ return mesh.instancesCount;
408
+ }
409
+
410
+ private shiftHandlerIndices(
411
+ mesh: UIGenericInstancedPlane,
412
+ fromIndex: number,
413
+ delta: number,
414
+ ): void {
415
+ for (const descriptor of this.handlerToDescriptor.values()) {
416
+ if (descriptor.mesh === mesh && descriptor.instanceIndex >= fromIndex) {
417
+ descriptor.instanceIndex += delta;
418
+ }
419
+ }
420
+ }
421
+
422
+ private remapHandlersAfterMerge(
423
+ fromMesh: UIGenericInstancedPlane,
424
+ toMesh: UIGenericInstancedPlane,
425
+ indexOffset: number,
426
+ ): void {
427
+ for (const descriptor of this.handlerToDescriptor.values()) {
428
+ if (descriptor.mesh === fromMesh) {
429
+ descriptor.mesh = toMesh;
430
+ descriptor.instanceIndex += indexOffset;
431
+ }
432
+ }
433
+ }
434
+
435
+ private syncSceneOrder(): void {
436
+ // Sort meshes by their minimum zIndex
437
+ this.orderedMeshes.sort((a, b) => {
438
+ const aZ = a.instancesCount > 0 ? a.getZIndexAt(0) : 0;
439
+ const bZ = b.instancesCount > 0 ? b.getZIndexAt(0) : 0;
440
+ return aZ - bZ;
441
+ });
442
+
443
+ // Update render order
444
+ for (let i = 0; i < this.orderedMeshes.length; i++) {
445
+ this.orderedMeshes[i].renderOrder = i;
446
+ }
447
+ }
448
+ }