@nice2dev/game-engine 1.3.13 → 1.3.14

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 (253) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/package.json +2 -2
  3. package/dist/types/accessibility/index.d.ts +0 -1
  4. package/dist/types/ai/index.d.ts +0 -1
  5. package/dist/types/animation/index.d.ts +0 -1
  6. package/dist/types/audio/HRTFAudio.d.ts +0 -180
  7. package/dist/types/audio/index.d.ts +0 -2
  8. package/dist/types/community/Community.d.ts +0 -112
  9. package/dist/types/community/index.d.ts +0 -1
  10. package/dist/types/core/TypeSafety.d.ts +0 -190
  11. package/dist/types/core/index.d.ts +0 -7
  12. package/dist/types/devtools/AssetStore.d.ts +0 -133
  13. package/dist/types/devtools/index.d.ts +0 -3
  14. package/dist/types/dialogue/index.d.ts +0 -2
  15. package/dist/types/docs/APIPlayground.d.ts +0 -26
  16. package/dist/types/docs/Cookbook.d.ts +0 -18
  17. package/dist/types/docs/Guides.d.ts +0 -18
  18. package/dist/types/docs/index.d.ts +0 -4
  19. package/dist/types/ecs/ECSOptimized.d.ts +0 -131
  20. package/dist/types/ecs/index.d.ts +0 -2
  21. package/dist/types/editor/NiceAnimationTimeline.d.ts +0 -114
  22. package/dist/types/editor/NiceLevelEditor.d.ts +0 -232
  23. package/dist/types/editor/NiceMaterialEditor.d.ts +0 -105
  24. package/dist/types/editor/NiceNodeGraph.d.ts +0 -87
  25. package/dist/types/editor/NiceParticleEditor.d.ts +0 -127
  26. package/dist/types/editor/behavior-tree/BTDebugPanel.d.ts +0 -102
  27. package/dist/types/editor/behavior-tree/BTEditorCanvas.d.ts +0 -79
  28. package/dist/types/editor/behavior-tree/BTEditorNode.d.ts +0 -58
  29. package/dist/types/editor/behavior-tree/BTEditorToolbar.d.ts +0 -75
  30. package/dist/types/editor/behavior-tree/BTNodePalette.d.ts +0 -72
  31. package/dist/types/editor/behavior-tree/BTPropertyPanel.d.ts +0 -66
  32. package/dist/types/editor/behavior-tree/BehaviorTreeEditor.d.ts +0 -186
  33. package/dist/types/editor/behavior-tree/index.d.ts +0 -14
  34. package/dist/types/editor/behavior-tree/serialization.d.ts +0 -30
  35. package/dist/types/editor/behavior-tree/types.d.ts +0 -299
  36. package/dist/types/editor/index.d.ts +0 -20
  37. package/dist/types/editor/state-machine/SMEditorCanvas.d.ts +0 -61
  38. package/dist/types/editor/state-machine/StateMachineEditor.d.ts +0 -139
  39. package/dist/types/editor/state-machine/index.d.ts +0 -11
  40. package/dist/types/editor/state-machine/serialization.d.ts +0 -23
  41. package/dist/types/editor/state-machine/types.d.ts +0 -241
  42. package/dist/types/engine/index.d.ts +0 -2
  43. package/dist/types/enterprise/index.d.ts +0 -1
  44. package/dist/types/epic/index.d.ts +0 -10
  45. package/dist/types/i18n/index.d.ts +0 -2
  46. package/dist/types/input/index.d.ts +0 -3
  47. package/dist/types/kids/index.d.ts +0 -2
  48. package/dist/types/legendary/index.d.ts +0 -57
  49. package/dist/types/monetization/index.d.ts +0 -1
  50. package/dist/types/multiplayer/NiceNetcode.d.ts +0 -434
  51. package/dist/types/multiplayer/index.d.ts +0 -5
  52. package/dist/types/network/index.d.ts +0 -2
  53. package/dist/types/pathfinding/index.d.ts +0 -1
  54. package/dist/types/performance/AssetCompression.d.ts +0 -137
  55. package/dist/types/performance/WASMModules.d.ts +0 -65
  56. package/dist/types/performance/WebGPUCompute.d.ts +0 -71
  57. package/dist/types/performance/index.d.ts +0 -1
  58. package/dist/types/physics/RapierIntegration.d.ts +0 -404
  59. package/dist/types/physics/index.d.ts +0 -2
  60. package/dist/types/plugins/index.d.ts +0 -2
  61. package/dist/types/procedural/index.d.ts +0 -2
  62. package/dist/types/release/index.d.ts +0 -1
  63. package/dist/types/rendering/WebGPUv2.d.ts +0 -173
  64. package/dist/types/rendering/index.d.ts +0 -3
  65. package/dist/types/runtime3d/index.d.ts +0 -2
  66. package/dist/types/scene/index.d.ts +0 -2
  67. package/dist/types/scripting/WasmCompiler.d.ts +0 -182
  68. package/dist/types/scripting/index.d.ts +0 -19
  69. package/dist/types/social/index.d.ts +0 -1
  70. package/dist/types/systems/NiceAI.d.ts +0 -637
  71. package/dist/types/systems/NiceAbility.d.ts +0 -225
  72. package/dist/types/systems/NiceAccessibility.d.ts +0 -230
  73. package/dist/types/systems/NiceAchievement.d.ts +0 -153
  74. package/dist/types/systems/NiceAchievementUI.d.ts +0 -196
  75. package/dist/types/systems/NiceAchievements.d.ts +0 -230
  76. package/dist/types/systems/NiceAction.d.ts +0 -81
  77. package/dist/types/systems/NiceAlchemy.d.ts +0 -195
  78. package/dist/types/systems/NiceAnalytics.d.ts +0 -493
  79. package/dist/types/systems/NiceAnimation.d.ts +0 -350
  80. package/dist/types/systems/NiceArena.d.ts +0 -215
  81. package/dist/types/systems/NiceAssetLoader.d.ts +0 -136
  82. package/dist/types/systems/NiceAuction.d.ts +0 -157
  83. package/dist/types/systems/NiceAudio.d.ts +0 -224
  84. package/dist/types/systems/NiceAugment.d.ts +0 -187
  85. package/dist/types/systems/NiceAura.d.ts +0 -193
  86. package/dist/types/systems/NiceBank.d.ts +0 -158
  87. package/dist/types/systems/NiceBattlePass.d.ts +0 -150
  88. package/dist/types/systems/NiceBehavior.d.ts +0 -160
  89. package/dist/types/systems/NiceBinding.d.ts +0 -96
  90. package/dist/types/systems/NiceBlacksmith.d.ts +0 -221
  91. package/dist/types/systems/NiceBuff.d.ts +0 -177
  92. package/dist/types/systems/NiceBuilding.d.ts +0 -207
  93. package/dist/types/systems/NiceBullet.d.ts +0 -167
  94. package/dist/types/systems/NiceCamera.d.ts +0 -252
  95. package/dist/types/systems/NiceCard.d.ts +0 -171
  96. package/dist/types/systems/NiceChat.d.ts +0 -148
  97. package/dist/types/systems/NiceCheat.d.ts +0 -375
  98. package/dist/types/systems/NiceClimbing.d.ts +0 -186
  99. package/dist/types/systems/NiceCloud.d.ts +0 -422
  100. package/dist/types/systems/NiceCollision.d.ts +0 -238
  101. package/dist/types/systems/NiceCombo.d.ts +0 -131
  102. package/dist/types/systems/NiceCommand.d.ts +0 -112
  103. package/dist/types/systems/NiceCompanion.d.ts +0 -182
  104. package/dist/types/systems/NiceController.d.ts +0 -144
  105. package/dist/types/systems/NiceCooking.d.ts +0 -193
  106. package/dist/types/systems/NiceCoroutine.d.ts +0 -101
  107. package/dist/types/systems/NiceCrafting.d.ts +0 -228
  108. package/dist/types/systems/NiceCutscene.d.ts +0 -437
  109. package/dist/types/systems/NiceDaily.d.ts +0 -133
  110. package/dist/types/systems/NiceDamage.d.ts +0 -271
  111. package/dist/types/systems/NiceDayNight.d.ts +0 -126
  112. package/dist/types/systems/NiceDebug.d.ts +0 -255
  113. package/dist/types/systems/NiceDestructible.d.ts +0 -150
  114. package/dist/types/systems/NiceDialogue.d.ts +0 -629
  115. package/dist/types/systems/NiceDungeon.d.ts +0 -202
  116. package/dist/types/systems/NiceECS.d.ts +0 -151
  117. package/dist/types/systems/NiceEnchant.d.ts +0 -148
  118. package/dist/types/systems/NiceEntityPool.d.ts +0 -127
  119. package/dist/types/systems/NiceEquipment.d.ts +0 -137
  120. package/dist/types/systems/NiceEvent.d.ts +0 -202
  121. package/dist/types/systems/NiceEventBus.d.ts +0 -164
  122. package/dist/types/systems/NiceFaction.d.ts +0 -173
  123. package/dist/types/systems/NiceFarming.d.ts +0 -163
  124. package/dist/types/systems/NiceFishing.d.ts +0 -196
  125. package/dist/types/systems/NiceFlocking.d.ts +0 -156
  126. package/dist/types/systems/NiceFog.d.ts +0 -137
  127. package/dist/types/systems/NiceFormation.d.ts +0 -140
  128. package/dist/types/systems/NiceGacha.d.ts +0 -134
  129. package/dist/types/systems/NiceGambling.d.ts +0 -175
  130. package/dist/types/systems/NiceGem.d.ts +0 -165
  131. package/dist/types/systems/NiceGesture.d.ts +0 -502
  132. package/dist/types/systems/NiceGrappling.d.ts +0 -154
  133. package/dist/types/systems/NiceGrid.d.ts +0 -142
  134. package/dist/types/systems/NiceGuild.d.ts +0 -162
  135. package/dist/types/systems/NiceHaptics.d.ts +0 -112
  136. package/dist/types/systems/NiceHousing.d.ts +0 -197
  137. package/dist/types/systems/NiceInput.d.ts +0 -280
  138. package/dist/types/systems/NiceInventory.d.ts +0 -534
  139. package/dist/types/systems/NiceLOD.d.ts +0 -144
  140. package/dist/types/systems/NiceLeaderboard.d.ts +0 -191
  141. package/dist/types/systems/NiceLevel.d.ts +0 -304
  142. package/dist/types/systems/NiceLighting.d.ts +0 -214
  143. package/dist/types/systems/NiceLocalization.d.ts +0 -148
  144. package/dist/types/systems/NiceLocomotion.d.ts +0 -398
  145. package/dist/types/systems/NiceLogger.d.ts +0 -117
  146. package/dist/types/systems/NiceLoot.d.ts +0 -176
  147. package/dist/types/systems/NiceMail.d.ts +0 -164
  148. package/dist/types/systems/NiceMap.d.ts +0 -234
  149. package/dist/types/systems/NiceMarriage.d.ts +0 -150
  150. package/dist/types/systems/NiceMastery.d.ts +0 -171
  151. package/dist/types/systems/NiceMatch.d.ts +0 -196
  152. package/dist/types/systems/NiceMatch3.d.ts +0 -118
  153. package/dist/types/systems/NiceMessageBus.d.ts +0 -115
  154. package/dist/types/systems/NiceMinimap.d.ts +0 -258
  155. package/dist/types/systems/NiceMining.d.ts +0 -175
  156. package/dist/types/systems/NiceModding.d.ts +0 -452
  157. package/dist/types/systems/NiceMount.d.ts +0 -152
  158. package/dist/types/systems/NiceNavigation.d.ts +0 -307
  159. package/dist/types/systems/NiceNetwork.d.ts +0 -568
  160. package/dist/types/systems/NiceNotification.d.ts +0 -438
  161. package/dist/types/systems/NiceObjective.d.ts +0 -395
  162. package/dist/types/systems/NiceParticle.d.ts +0 -639
  163. package/dist/types/systems/NiceParty.d.ts +0 -168
  164. package/dist/types/systems/NicePerformance.d.ts +0 -144
  165. package/dist/types/systems/NicePet.d.ts +0 -167
  166. package/dist/types/systems/NicePhotoMode.d.ts +0 -270
  167. package/dist/types/systems/NicePhysics.d.ts +0 -326
  168. package/dist/types/systems/NicePlatformer.d.ts +0 -158
  169. package/dist/types/systems/NicePool.d.ts +0 -128
  170. package/dist/types/systems/NicePortal.d.ts +0 -178
  171. package/dist/types/systems/NicePostProcess.d.ts +0 -254
  172. package/dist/types/systems/NiceProcedural.d.ts +0 -202
  173. package/dist/types/systems/NiceProfile.d.ts +0 -223
  174. package/dist/types/systems/NiceProjectile.d.ts +0 -157
  175. package/dist/types/systems/NicePvP.d.ts +0 -199
  176. package/dist/types/systems/NiceQTE.d.ts +0 -160
  177. package/dist/types/systems/NiceQuest.d.ts +0 -620
  178. package/dist/types/systems/NiceRaid.d.ts +0 -215
  179. package/dist/types/systems/NiceRanking.d.ts +0 -399
  180. package/dist/types/systems/NiceReplay.d.ts +0 -180
  181. package/dist/types/systems/NiceReputation.d.ts +0 -151
  182. package/dist/types/systems/NiceResource.d.ts +0 -200
  183. package/dist/types/systems/NiceRhythm.d.ts +0 -148
  184. package/dist/types/systems/NiceRoguelike.d.ts +0 -276
  185. package/dist/types/systems/NiceRune.d.ts +0 -202
  186. package/dist/types/systems/NiceSaveSystem.d.ts +0 -194
  187. package/dist/types/systems/NiceSceneManager.d.ts +0 -112
  188. package/dist/types/systems/NiceScore.d.ts +0 -186
  189. package/dist/types/systems/NiceScreenFX.d.ts +0 -235
  190. package/dist/types/systems/NiceScreenshot.d.ts +0 -443
  191. package/dist/types/systems/NiceScribe.d.ts +0 -239
  192. package/dist/types/systems/NiceSeason.d.ts +0 -176
  193. package/dist/types/systems/NiceSerialization.d.ts +0 -89
  194. package/dist/types/systems/NiceServiceLocator.d.ts +0 -94
  195. package/dist/types/systems/NiceShop.d.ts +0 -528
  196. package/dist/types/systems/NiceSignal.d.ts +0 -112
  197. package/dist/types/systems/NiceSkillTree.d.ts +0 -237
  198. package/dist/types/systems/NiceSocial.d.ts +0 -580
  199. package/dist/types/systems/NiceSpawner.d.ts +0 -237
  200. package/dist/types/systems/NiceSpell.d.ts +0 -216
  201. package/dist/types/systems/NiceState.d.ts +0 -224
  202. package/dist/types/systems/NiceStateMachine.d.ts +0 -108
  203. package/dist/types/systems/NiceStatus.d.ts +0 -116
  204. package/dist/types/systems/NiceStealth.d.ts +0 -204
  205. package/dist/types/systems/NiceSteam.d.ts +0 -255
  206. package/dist/types/systems/NiceStreaming.d.ts +0 -173
  207. package/dist/types/systems/NiceSwimming.d.ts +0 -166
  208. package/dist/types/systems/NiceTalent.d.ts +0 -154
  209. package/dist/types/systems/NiceTarget.d.ts +0 -121
  210. package/dist/types/systems/NiceTerrain.d.ts +0 -143
  211. package/dist/types/systems/NiceTilemap.d.ts +0 -218
  212. package/dist/types/systems/NiceTimer.d.ts +0 -153
  213. package/dist/types/systems/NiceTournament.d.ts +0 -190
  214. package/dist/types/systems/NiceTrading.d.ts +0 -238
  215. package/dist/types/systems/NiceTransmog.d.ts +0 -142
  216. package/dist/types/systems/NiceTutorial.d.ts +0 -248
  217. package/dist/types/systems/NiceTween.d.ts +0 -164
  218. package/dist/types/systems/NiceUI.d.ts +0 -364
  219. package/dist/types/systems/NiceVFX.d.ts +0 -333
  220. package/dist/types/systems/NiceVehicle.d.ts +0 -176
  221. package/dist/types/systems/NiceVoice.d.ts +0 -502
  222. package/dist/types/systems/NiceWater.d.ts +0 -162
  223. package/dist/types/systems/NiceWave.d.ts +0 -174
  224. package/dist/types/systems/NiceWaypoint.d.ts +0 -165
  225. package/dist/types/systems/NiceWeather.d.ts +0 -225
  226. package/dist/types/systems/NiceXR.d.ts +0 -187
  227. package/dist/types/systems/index.d.ts +0 -182
  228. package/dist/types/templates/index.d.ts +0 -2
  229. package/dist/types/tilemap/index.d.ts +0 -1
  230. package/dist/types/tutorials/TutorialEditor.d.ts +0 -43
  231. package/dist/types/tutorials/VoiceNarration.d.ts +0 -75
  232. package/dist/types/tutorials/content/Tutorials_T04.d.ts +0 -3
  233. package/dist/types/tutorials/content/UITutorials.d.ts +0 -14
  234. package/dist/types/tutorials/content/index.d.ts +0 -5
  235. package/dist/types/tutorials/index.d.ts +0 -6
  236. package/dist/types/ui/index.d.ts +0 -2
  237. package/dist/types/visual-scripting/VisualScriptDebugger.d.ts +0 -145
  238. package/dist/types/visual-scripting/VisualScriptExecutor.d.ts +0 -100
  239. package/dist/types/visual-scripting/VisualScriptGraph.d.ts +0 -173
  240. package/dist/types/visual-scripting/VisualScriptNode.d.ts +0 -157
  241. package/dist/types/visual-scripting/index.d.ts +0 -6
  242. package/dist/types/visual-scripting/nodes/ActionNodes.d.ts +0 -152
  243. package/dist/types/visual-scripting/nodes/EventNodes.d.ts +0 -95
  244. package/dist/types/visual-scripting/nodes/FlowControlNodes.d.ts +0 -134
  245. package/dist/types/visual-scripting/nodes/LogicNodes.d.ts +0 -122
  246. package/dist/types/visual-scripting/nodes/MathNodes.d.ts +0 -170
  247. package/dist/types/visual-scripting/nodes/UtilityNodes.d.ts +0 -131
  248. package/dist/types/visual-scripting/nodes/VariableNodes.d.ts +0 -107
  249. package/dist/types/visual-scripting/nodes/index.d.ts +0 -21
  250. package/dist/types/visual-scripting/nodes/registerNodes.d.ts +0 -29
  251. package/dist/types/visual-scripting/types.d.ts +0 -402
  252. package/dist/types/xr/WebXRLayers.d.ts +0 -319
  253. package/dist/types/xr/index.d.ts +0 -2
@@ -1,164 +0,0 @@
1
- export type TweenId = string;
2
- export type EasingName = 'linear' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic' | 'easeInQuart' | 'easeOutQuart' | 'easeInOutQuart' | 'easeInQuint' | 'easeOutQuint' | 'easeInOutQuint' | 'easeInSine' | 'easeOutSine' | 'easeInOutSine' | 'easeInExpo' | 'easeOutExpo' | 'easeInOutExpo' | 'easeInCirc' | 'easeOutCirc' | 'easeInOutCirc' | 'easeInElastic' | 'easeOutElastic' | 'easeInOutElastic' | 'easeInBack' | 'easeOutBack' | 'easeInOutBack' | 'easeInBounce' | 'easeOutBounce' | 'easeInOutBounce';
3
- export type EasingFn = (t: number) => number;
4
- export type LoopMode = 'none' | 'loop' | 'pingpong' | 'yoyo';
5
- export declare const EASINGS: Record<EasingName, EasingFn>;
6
- export interface TweenProperty<T = unknown> {
7
- key: string;
8
- from: T;
9
- to: T;
10
- current?: T;
11
- }
12
- export interface TweenConfig<T = Record<string, number>> {
13
- /** Target object */
14
- target: T;
15
- /** Properties to tween { x: 100, y: 200 } */
16
- properties: Partial<Record<keyof T, number | string>>;
17
- /** Duration in seconds */
18
- duration: number;
19
- /** Easing function */
20
- easing?: EasingName | EasingFn;
21
- /** Delay before start */
22
- delay?: number;
23
- /** Loop mode */
24
- loop?: LoopMode;
25
- /** Number of loops (-1 = infinite) */
26
- loopCount?: number;
27
- /** Time scale */
28
- timeScale?: number;
29
- /** Start paused */
30
- paused?: boolean;
31
- /** Relative values (add to current) */
32
- relative?: boolean;
33
- /** Callbacks */
34
- onStart?: () => void;
35
- onUpdate?: (progress: number) => void;
36
- onComplete?: () => void;
37
- onLoop?: (loopIndex: number) => void;
38
- }
39
- export interface TweenState {
40
- id: TweenId;
41
- elapsed: number;
42
- delayRemaining: number;
43
- progress: number;
44
- easedProgress: number;
45
- loopsCompleted: number;
46
- direction: 1 | -1;
47
- started: boolean;
48
- paused: boolean;
49
- finished: boolean;
50
- timeScale: number;
51
- }
52
- export interface RGB {
53
- r: number;
54
- g: number;
55
- b: number;
56
- }
57
- export interface RGBA extends RGB {
58
- a: number;
59
- }
60
- export type TweenEventType = 'tween-created' | 'tween-started' | 'tween-update' | 'tween-paused' | 'tween-resumed' | 'tween-completed' | 'tween-loop' | 'tween-cancelled';
61
- export interface TweenEvent {
62
- type: TweenEventType;
63
- timestamp: number;
64
- tweenId: TweenId;
65
- data?: unknown;
66
- }
67
- export type TweenEventCallback = (event: TweenEvent) => void;
68
- declare class Tween<T extends Record<string, unknown>> {
69
- readonly id: TweenId;
70
- private target;
71
- private properties;
72
- private config;
73
- private state;
74
- private parentSystem?;
75
- constructor(id: TweenId, config: TweenConfig<T>, parentSystem?: NiceTween);
76
- update(deltaTime: number): boolean;
77
- private handleCompletion;
78
- pause(): this;
79
- resume(): this;
80
- stop(): this;
81
- reset(): this;
82
- setTimeScale(scale: number): this;
83
- delay(seconds: number): this;
84
- duration(seconds: number): this;
85
- ease(easing: EasingName | EasingFn): this;
86
- loop(mode?: LoopMode, count?: number): this;
87
- onStart(callback: () => void): this;
88
- onUpdate(callback: (progress: number) => void): this;
89
- onComplete(callback: () => void): this;
90
- getState(): TweenState;
91
- isFinished(): boolean;
92
- isPaused(): boolean;
93
- getProgress(): number;
94
- }
95
- export declare class NiceTween {
96
- private tweens;
97
- private eventListeners;
98
- private idCounter;
99
- private globalTimeScale;
100
- private globalPaused;
101
- on(event: TweenEventType, callback: TweenEventCallback): () => void;
102
- private emit;
103
- create<T extends Record<string, unknown>>(config: TweenConfig<T>): Tween<T>;
104
- to<T extends Record<string, unknown>>(target: T, properties: Partial<Record<keyof T, number | string>>, duration: number): Tween<T>;
105
- from<T extends Record<string, unknown>>(target: T, properties: Partial<Record<keyof T, number | string>>, duration: number): Tween<T>;
106
- fromTo<T extends Record<string, unknown>>(target: T, fromProps: Partial<Record<keyof T, number>>, toProps: Partial<Record<keyof T, number>>, duration: number): Tween<T>;
107
- sequence(): TweenSequence;
108
- parallel(...tweens: Tween<Record<string, unknown>>[]): Promise<void>;
109
- update(deltaTime: number): void;
110
- get(id: TweenId): Tween<Record<string, unknown>> | undefined;
111
- pauseAll(): void;
112
- resumeAll(): void;
113
- stopAll(): void;
114
- setGlobalTimeScale(scale: number): void;
115
- getActiveCount(): number;
116
- destroy(): void;
117
- }
118
- export declare class TweenSequence {
119
- private system;
120
- private items;
121
- private currentIndex;
122
- private currentWait;
123
- private running;
124
- private paused;
125
- private onCompleteCallback?;
126
- constructor(system: NiceTween);
127
- add<T extends Record<string, unknown>>(target: T, properties: Partial<Record<keyof T, number | string>>, duration: number, offset?: number): this;
128
- call(callback: () => void): this;
129
- wait(duration: number): this;
130
- onComplete(callback: () => void): this;
131
- play(): this;
132
- pause(): this;
133
- resume(): this;
134
- stop(): this;
135
- private processNext;
136
- }
137
- export declare function createTweenSystem(): NiceTween;
138
- export declare function lerpColor(from: RGB, to: RGB, t: number): RGB;
139
- export declare function hexToRgb(hex: string): RGB;
140
- export declare function rgbToHex(rgb: RGB): string;
141
- export declare function tweenPath(points: Array<{
142
- x: number;
143
- y: number;
144
- }>, t: number): {
145
- x: number;
146
- y: number;
147
- };
148
- export declare function bezierPoint(p0: {
149
- x: number;
150
- y: number;
151
- }, p1: {
152
- x: number;
153
- y: number;
154
- }, p2: {
155
- x: number;
156
- y: number;
157
- }, p3: {
158
- x: number;
159
- y: number;
160
- }, t: number): {
161
- x: number;
162
- y: number;
163
- };
164
- export { EASINGS as TWEEN_EASINGS };
@@ -1,364 +0,0 @@
1
- /**
2
- * NiceUI - Game Engine UI System
3
- *
4
- * Comprehensive game UI system supporting:
5
- * - Widget hierarchy and layout
6
- * - Anchoring and positioning
7
- * - Input handling (mouse, touch, gamepad)
8
- * - Animations and transitions
9
- * - Theming and styling
10
- * - HUD elements
11
- * - Menus and dialogs
12
- * - Health bars, minimaps, inventories
13
- * - Focus and navigation
14
- * - Localization integration
15
- *
16
- * @packageDocumentation
17
- */
18
- import { EventEmitter } from 'events';
19
- export type WidgetId = string;
20
- export type LayerId = string;
21
- export type StyleId = string;
22
- export type WidgetType = 'panel' | 'label' | 'button' | 'image' | 'progressBar' | 'slider' | 'checkbox' | 'textInput' | 'dropdown' | 'list' | 'scrollView' | 'grid' | 'window' | 'tooltip' | 'custom';
23
- export type AnchorPreset = 'topLeft' | 'topCenter' | 'topRight' | 'middleLeft' | 'middleCenter' | 'middleRight' | 'bottomLeft' | 'bottomCenter' | 'bottomRight' | 'stretchHorizontal' | 'stretchVertical' | 'stretchAll';
24
- export type LayoutType = 'none' | 'horizontal' | 'vertical' | 'grid';
25
- export interface Vec2 {
26
- x: number;
27
- y: number;
28
- }
29
- export interface Rect {
30
- x: number;
31
- y: number;
32
- width: number;
33
- height: number;
34
- }
35
- export interface Color {
36
- r: number;
37
- g: number;
38
- b: number;
39
- a: number;
40
- }
41
- export interface Padding {
42
- top: number;
43
- right: number;
44
- bottom: number;
45
- left: number;
46
- }
47
- export interface TextStyle {
48
- fontFamily?: string;
49
- fontSize?: number;
50
- fontWeight?: 'normal' | 'bold' | 'light';
51
- fontStyle?: 'normal' | 'italic';
52
- color?: Color;
53
- alignment?: 'left' | 'center' | 'right';
54
- verticalAlignment?: 'top' | 'middle' | 'bottom';
55
- lineHeight?: number;
56
- letterSpacing?: number;
57
- wordWrap?: boolean;
58
- overflow?: 'visible' | 'hidden' | 'ellipsis';
59
- shadow?: {
60
- offset: Vec2;
61
- blur: number;
62
- color: Color;
63
- };
64
- outline?: {
65
- width: number;
66
- color: Color;
67
- };
68
- }
69
- export interface BackgroundStyle {
70
- color?: Color;
71
- gradient?: {
72
- type: 'linear' | 'radial';
73
- colors: Color[];
74
- stops?: number[];
75
- angle?: number;
76
- };
77
- image?: string;
78
- imageScale?: 'stretch' | 'fit' | 'fill' | 'tile' | 'none';
79
- imageTint?: Color;
80
- }
81
- export interface BorderStyle {
82
- width: number;
83
- color: Color;
84
- radius?: number | {
85
- topLeft: number;
86
- topRight: number;
87
- bottomRight: number;
88
- bottomLeft: number;
89
- };
90
- }
91
- export interface WidgetStyle {
92
- id?: StyleId;
93
- name?: string;
94
- width?: number | 'auto' | string;
95
- height?: number | 'auto' | string;
96
- minWidth?: number;
97
- maxWidth?: number;
98
- minHeight?: number;
99
- maxHeight?: number;
100
- padding?: Padding | number;
101
- margin?: Padding | number;
102
- background?: BackgroundStyle;
103
- border?: BorderStyle;
104
- opacity?: number;
105
- text?: TextStyle;
106
- cursor?: 'default' | 'pointer' | 'text' | 'grab' | 'not-allowed' | 'none';
107
- transition?: {
108
- properties: string[];
109
- duration: number;
110
- easing?: string;
111
- delay?: number;
112
- };
113
- hover?: Partial<WidgetStyle>;
114
- active?: Partial<WidgetStyle>;
115
- disabled?: Partial<WidgetStyle>;
116
- focused?: Partial<WidgetStyle>;
117
- }
118
- export interface Theme {
119
- id: string;
120
- name: string;
121
- styles: Map<StyleId, WidgetStyle>;
122
- colors: {
123
- primary: Color;
124
- secondary: Color;
125
- background: Color;
126
- surface: Color;
127
- error: Color;
128
- success: Color;
129
- warning: Color;
130
- text: Color;
131
- textSecondary: Color;
132
- };
133
- typography: {
134
- fontFamily: string;
135
- fontSizeBase: number;
136
- fontSizeSmall: number;
137
- fontSizeLarge: number;
138
- };
139
- }
140
- export interface WidgetConfig {
141
- id?: WidgetId;
142
- type: WidgetType;
143
- name?: string;
144
- position?: Vec2;
145
- size?: Vec2;
146
- anchor?: AnchorPreset | {
147
- min: Vec2;
148
- max: Vec2;
149
- };
150
- pivot?: Vec2;
151
- offset?: Rect;
152
- layout?: {
153
- type: LayoutType;
154
- spacing?: number;
155
- padding?: Padding | number;
156
- childAlignment?: 'start' | 'center' | 'end' | 'stretch';
157
- reverseOrder?: boolean;
158
- gridColumns?: number;
159
- gridCellSize?: Vec2;
160
- };
161
- style?: WidgetStyle;
162
- styleId?: StyleId;
163
- text?: string;
164
- image?: string;
165
- value?: number | string | boolean;
166
- placeholder?: string;
167
- visible?: boolean;
168
- enabled?: boolean;
169
- focusable?: boolean;
170
- draggable?: boolean;
171
- children?: WidgetConfig[];
172
- onClick?: (widget: Widget) => void;
173
- onHover?: (widget: Widget, hovering: boolean) => void;
174
- onFocus?: (widget: Widget, focused: boolean) => void;
175
- onChange?: (widget: Widget, value: unknown) => void;
176
- onDrag?: (widget: Widget, delta: Vec2) => void;
177
- data?: Record<string, unknown>;
178
- }
179
- export interface Widget {
180
- id: WidgetId;
181
- type: WidgetType;
182
- name: string;
183
- parent?: Widget;
184
- children: Widget[];
185
- layer: LayerId;
186
- localPosition: Vec2;
187
- globalPosition: Vec2;
188
- size: Vec2;
189
- pivot: Vec2;
190
- scale: Vec2;
191
- rotation: number;
192
- computedRect: Rect;
193
- contentRect: Rect;
194
- layout?: WidgetConfig['layout'];
195
- anchor: {
196
- min: Vec2;
197
- max: Vec2;
198
- };
199
- offset: Rect;
200
- style: WidgetStyle;
201
- computedStyle: WidgetStyle;
202
- text: string;
203
- image?: string;
204
- value: unknown;
205
- placeholder: string;
206
- visible: boolean;
207
- enabled: boolean;
208
- focusable: boolean;
209
- draggable: boolean;
210
- isHovered: boolean;
211
- isFocused: boolean;
212
- isPressed: boolean;
213
- isDragging: boolean;
214
- onClick?: (widget: Widget) => void;
215
- onHover?: (widget: Widget, hovering: boolean) => void;
216
- onFocus?: (widget: Widget, focused: boolean) => void;
217
- onChange?: (widget: Widget, value: unknown) => void;
218
- onDrag?: (widget: Widget, delta: Vec2) => void;
219
- data: Record<string, unknown>;
220
- }
221
- export interface UILayer {
222
- id: LayerId;
223
- name: string;
224
- sortOrder: number;
225
- visible: boolean;
226
- widgets: WidgetId[];
227
- }
228
- export interface InputState {
229
- mousePosition: Vec2;
230
- mouseButtons: boolean[];
231
- touches: Array<{
232
- id: number;
233
- position: Vec2;
234
- phase: 'began' | 'moved' | 'ended';
235
- }>;
236
- hoveredWidget?: WidgetId;
237
- focusedWidget?: WidgetId;
238
- draggedWidget?: WidgetId;
239
- dragStart?: Vec2;
240
- }
241
- export type EasingFunction = (t: number) => number;
242
- export interface UIAnimation {
243
- id: string;
244
- widgetId: WidgetId;
245
- property: string;
246
- from: unknown;
247
- to: unknown;
248
- duration: number;
249
- elapsed: number;
250
- easing: EasingFunction;
251
- onComplete?: () => void;
252
- isPlaying: boolean;
253
- }
254
- export type UIEventType = 'click' | 'double-click' | 'hover-enter' | 'hover-exit' | 'focus' | 'blur' | 'value-changed' | 'drag-start' | 'drag' | 'drag-end' | 'key-down' | 'key-up' | 'submit';
255
- export interface UIEvent {
256
- type: UIEventType;
257
- widget: Widget;
258
- value?: unknown;
259
- position?: Vec2;
260
- delta?: Vec2;
261
- key?: string;
262
- timestamp: number;
263
- }
264
- export type UIEventCallback = (event: UIEvent) => void;
265
- export interface UIConfig {
266
- screenWidth: number;
267
- screenHeight: number;
268
- pixelRatio: number;
269
- defaultFontFamily: string;
270
- defaultFontSize: number;
271
- doubleClickTime: number;
272
- dragThreshold: number;
273
- tooltipDelay: number;
274
- focusNavigation: boolean;
275
- gamepadEnabled: boolean;
276
- }
277
- export declare const DEFAULT_UI_CONFIG: UIConfig;
278
- export declare const DEFAULT_STYLE: WidgetStyle;
279
- export declare const Easings: Record<string, EasingFunction>;
280
- export declare class NiceUI extends EventEmitter {
281
- private config;
282
- private widgets;
283
- private layers;
284
- private rootWidgets;
285
- private themes;
286
- private currentTheme?;
287
- private styles;
288
- private animations;
289
- private inputState;
290
- private lastClickTime;
291
- private lastClickWidget?;
292
- private tooltipTimer?;
293
- private destroyed;
294
- constructor(config?: Partial<UIConfig>);
295
- createLayer(id: LayerId, sortOrder?: number): UILayer;
296
- getLayer(layerId: LayerId): UILayer | undefined;
297
- setLayerVisible(layerId: LayerId, visible: boolean): void;
298
- removeLayer(layerId: LayerId): void;
299
- createWidget(config: WidgetConfig, parentId?: WidgetId, layerId?: LayerId): Widget;
300
- getWidget(widgetId: WidgetId): Widget | undefined;
301
- getWidgetByName(name: string): Widget | undefined;
302
- removeWidget(widgetId: WidgetId): void;
303
- setWidgetPosition(widgetId: WidgetId, position: Vec2): void;
304
- setWidgetSize(widgetId: WidgetId, size: Vec2): void;
305
- setWidgetVisible(widgetId: WidgetId, visible: boolean): void;
306
- setWidgetEnabled(widgetId: WidgetId, enabled: boolean): void;
307
- setWidgetText(widgetId: WidgetId, text: string): void;
308
- setWidgetValue(widgetId: WidgetId, value: unknown): void;
309
- setWidgetStyle(widgetId: WidgetId, style: Partial<WidgetStyle>): void;
310
- private updateWidgetLayout;
311
- private applyLayout;
312
- refreshLayout(): void;
313
- registerStyle(id: StyleId, style: WidgetStyle): void;
314
- getStyle(styleId: StyleId): WidgetStyle | undefined;
315
- private mergeStyles;
316
- private updateComputedStyle;
317
- registerTheme(theme: Theme): void;
318
- setTheme(themeId: string): void;
319
- getTheme(): Theme | undefined;
320
- handleMouseMove(x: number, y: number): void;
321
- handleMouseDown(button?: number): void;
322
- handleMouseUp(button?: number): void;
323
- handleKeyDown(key: string): void;
324
- handleKeyUp(key: string): void;
325
- setFocus(widgetId: WidgetId): void;
326
- clearFocus(): void;
327
- focusNext(): void;
328
- focusPrevious(): void;
329
- hitTest(x: number, y: number): Widget | undefined;
330
- private hitTestWidget;
331
- animate(widgetId: WidgetId, property: string, to: unknown, duration: number, options?: {
332
- easing?: string | EasingFunction;
333
- onComplete?: () => void;
334
- }): string;
335
- stopAnimation(animationId: string): void;
336
- stopAllAnimations(widgetId?: WidgetId): void;
337
- private getWidgetProperty;
338
- private setWidgetProperty;
339
- update(deltaTime: number): void;
340
- private interpolateValue;
341
- private isVec2;
342
- private isColor;
343
- private emitEvent;
344
- on(event: 'ui', callback: UIEventCallback): this;
345
- off(event: 'ui', callback: UIEventCallback): this;
346
- getAllWidgets(): Widget[];
347
- getVisibleWidgets(): Widget[];
348
- setScreenSize(width: number, height: number): void;
349
- getStats(): {
350
- widgets: number;
351
- layers: number;
352
- animations: number;
353
- styles: number;
354
- themes: number;
355
- };
356
- clear(): void;
357
- destroy(): void;
358
- }
359
- export declare function createUISystem(config?: Partial<UIConfig>): NiceUI;
360
- export declare function createPanel(ui: NiceUI, config?: Partial<WidgetConfig>): Widget;
361
- export declare function createLabel(ui: NiceUI, text: string, config?: Partial<WidgetConfig>): Widget;
362
- export declare function createButton(ui: NiceUI, text: string, onClick: (widget: Widget) => void, config?: Partial<WidgetConfig>): Widget;
363
- export declare function createProgressBar(ui: NiceUI, value: number, config?: Partial<WidgetConfig>): Widget;
364
- export declare function createTextInput(ui: NiceUI, placeholder?: string, config?: Partial<WidgetConfig>): Widget;