@defold-typescript/types 0.38.0 → 0.40.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.
- package/api-availability.json +117 -0
- package/api-signatures.json +586 -480
- package/examples/translations.json +356 -180
- package/generated/b2d_body.d.ts +7 -4
- package/generated/b2d_shape.d.ts +23 -1
- package/generated/buffer.d.ts +34 -19
- package/generated/camera.d.ts +3 -2
- package/generated/collectionfactory.d.ts +17 -12
- package/generated/collectionproxy.d.ts +2 -2
- package/generated/compute.d.ts +1 -1
- package/generated/factory.d.ts +2 -1
- package/generated/go.d.ts +150 -91
- package/generated/graphics.d.ts +54 -0
- package/generated/gui.d.ts +117 -71
- package/generated/html5.d.ts +4 -2
- package/generated/http.d.ts +8 -2
- package/generated/image.d.ts +24 -15
- package/generated/kinds/gui-script.d.ts +1 -0
- package/generated/kinds/render-script.d.ts +1 -0
- package/generated/kinds/script.d.ts +1 -0
- package/generated/material.d.ts +1 -1
- package/generated/model.d.ts +41 -7
- package/generated/particlefx.d.ts +1 -1
- package/generated/physics.d.ts +29 -20
- package/generated/profiler.d.ts +10 -3
- package/generated/render.d.ts +293 -111
- package/generated/resource.d.ts +243 -226
- package/generated/socket.d.ts +33 -18
- package/generated/sound.d.ts +6 -5
- package/generated/sprite.d.ts +9 -1
- package/generated/sys.d.ts +44 -27
- package/generated/tilemap.d.ts +25 -19
- package/generated/timer.d.ts +33 -24
- package/generated/versions/defold-1.12.4/buffer.d.ts +34 -19
- package/generated/versions/defold-1.12.4/camera.d.ts +3 -2
- package/generated/versions/defold-1.12.4/collectionfactory.d.ts +17 -12
- package/generated/versions/defold-1.12.4/collectionproxy.d.ts +1 -1
- package/generated/versions/defold-1.12.4/factory.d.ts +2 -1
- package/generated/versions/defold-1.12.4/go.d.ts +150 -91
- package/generated/versions/defold-1.12.4/graphics.d.ts +2 -0
- package/generated/versions/defold-1.12.4/gui.d.ts +109 -69
- package/generated/versions/defold-1.12.4/html5.d.ts +4 -2
- package/generated/versions/defold-1.12.4/http.d.ts +8 -2
- package/generated/versions/defold-1.12.4/image.d.ts +24 -15
- package/generated/versions/defold-1.12.4/index.d.ts +1 -0
- package/generated/versions/defold-1.12.4/model.d.ts +41 -7
- package/generated/versions/defold-1.12.4/particlefx.d.ts +1 -1
- package/generated/versions/defold-1.12.4/physics.d.ts +29 -20
- package/generated/versions/defold-1.12.4/profiler.d.ts +10 -3
- package/generated/versions/defold-1.12.4/render.d.ts +292 -110
- package/generated/versions/defold-1.12.4/resource.d.ts +243 -226
- package/generated/versions/defold-1.12.4/socket.d.ts +33 -18
- package/generated/versions/defold-1.12.4/sound.d.ts +6 -5
- package/generated/versions/defold-1.12.4/sprite.d.ts +9 -1
- package/generated/versions/defold-1.12.4/sys.d.ts +44 -27
- package/generated/versions/defold-1.12.4/tilemap.d.ts +25 -19
- package/generated/versions/defold-1.12.4/timer.d.ts +33 -24
- package/generated/versions/defold-1.12.4/vmath.d.ts +18 -10
- package/generated/versions/defold-1.12.4/window.d.ts +5 -3
- package/generated/versions/defold-1.13.0/b2d_body.d.ts +7 -4
- package/generated/versions/defold-1.13.0/b2d_shape.d.ts +23 -1
- package/generated/versions/defold-1.13.0/buffer.d.ts +34 -19
- package/generated/versions/defold-1.13.0/camera.d.ts +3 -2
- package/generated/versions/defold-1.13.0/collectionfactory.d.ts +17 -12
- package/generated/versions/defold-1.13.0/collectionproxy.d.ts +1 -1
- package/generated/versions/defold-1.13.0/compute.d.ts +1 -1
- package/generated/versions/defold-1.13.0/factory.d.ts +2 -1
- package/generated/versions/defold-1.13.0/go.d.ts +150 -91
- package/generated/versions/defold-1.13.0/graphics.d.ts +50 -0
- package/generated/versions/defold-1.13.0/gui.d.ts +109 -69
- package/generated/versions/defold-1.13.0/html5.d.ts +4 -2
- package/generated/versions/defold-1.13.0/http.d.ts +8 -2
- package/generated/versions/defold-1.13.0/image.d.ts +24 -15
- package/generated/versions/defold-1.13.0/index.d.ts +1 -0
- package/generated/versions/defold-1.13.0/material.d.ts +1 -1
- package/generated/versions/defold-1.13.0/model.d.ts +41 -7
- package/generated/versions/defold-1.13.0/particlefx.d.ts +1 -1
- package/generated/versions/defold-1.13.0/physics.d.ts +29 -20
- package/generated/versions/defold-1.13.0/profiler.d.ts +10 -3
- package/generated/versions/defold-1.13.0/render.d.ts +293 -111
- package/generated/versions/defold-1.13.0/resource.d.ts +243 -226
- package/generated/versions/defold-1.13.0/socket.d.ts +33 -18
- package/generated/versions/defold-1.13.0/sound.d.ts +6 -5
- package/generated/versions/defold-1.13.0/sprite.d.ts +9 -1
- package/generated/versions/defold-1.13.0/sys.d.ts +44 -27
- package/generated/versions/defold-1.13.0/tilemap.d.ts +25 -19
- package/generated/versions/defold-1.13.0/timer.d.ts +33 -24
- package/generated/versions/defold-1.13.0/vmath.d.ts +18 -10
- package/generated/versions/defold-1.13.0/window.d.ts +5 -3
- package/generated/vmath.d.ts +18 -10
- package/generated/window.d.ts +5 -3
- package/index.d.ts +1 -0
- package/package.json +2 -1
- package/scripts/generate-api-signatures.ts +2 -1
- package/scripts/prose-constants.ts +96 -0
- package/scripts/regen.ts +6 -2
- package/src/api-doc.ts +8 -0
- package/src/component-properties.d.ts +33 -0
- package/src/core-types.ts +4 -2
- package/src/custom-messages.d.ts +4 -3
- package/src/doc-comment.ts +247 -43
- package/src/emit-dts.ts +958 -57
- package/src/engine-globals.d.ts +2 -2
- package/src/example-store.ts +26 -0
- package/src/go-overloads.d.ts +11 -10
- package/src/index.ts +9 -0
- package/src/param-correction-provenance.ts +67 -0
- package/src/render-overloads.d.ts +15 -17
- package/src/script-api.ts +3 -1
|
@@ -42,6 +42,7 @@ import "../../../src/message-guard";
|
|
|
42
42
|
import "../../../src/window-event-guard";
|
|
43
43
|
import "../../../src/scene-addresses";
|
|
44
44
|
import "../../../src/go-overloads";
|
|
45
|
+
import "../../../src/component-properties";
|
|
45
46
|
import "../../../src/render-overloads";
|
|
46
47
|
import "../../../src/vmath-overloads";
|
|
47
48
|
|
|
@@ -68,12 +68,16 @@ declare global {
|
|
|
68
68
|
* @returns true if the mesh is visible, false otherwise
|
|
69
69
|
* @example
|
|
70
70
|
* ```ts
|
|
71
|
+
* // shared weapon data, e.g. required from your own module
|
|
72
|
+
* const game = { data: { weapons: { Sword: { damage: 10 } } } };
|
|
73
|
+
*
|
|
71
74
|
* export default defineScript({
|
|
72
|
-
* init(
|
|
75
|
+
* init() {
|
|
73
76
|
* if (model.get_mesh_enabled("#model", "Sword")) {
|
|
74
77
|
* // set properties specific for the sword
|
|
75
|
-
*
|
|
78
|
+
* return { weapon_properties: game.data.weapons["Sword"] };
|
|
76
79
|
* }
|
|
80
|
+
* return { weapon_properties: undefined };
|
|
77
81
|
* },
|
|
78
82
|
* });
|
|
79
83
|
* ```
|
|
@@ -138,9 +142,12 @@ declare global {
|
|
|
138
142
|
* ```ts
|
|
139
143
|
* // The following examples assume that the model has id "model".
|
|
140
144
|
* // How to play the "jump" animation followed by the "run" animation:
|
|
141
|
-
*
|
|
145
|
+
* const url = msg.url("#model");
|
|
146
|
+
*
|
|
147
|
+
* function anim_done(self: unknown, message_id: unknown, message: unknown, sender: unknown) {
|
|
142
148
|
* if (message_id === hash("model_animation_done")) {
|
|
143
|
-
*
|
|
149
|
+
* const { animation_id } = message as { animation_id: Hash };
|
|
150
|
+
* if (animation_id === hash("jump")) {
|
|
144
151
|
* // open animation done, chain with "run"
|
|
145
152
|
* const properties = { blend_duration: 0.2 };
|
|
146
153
|
* model.play_anim(url, "run", go.PLAYBACK_LOOP_FORWARD, properties, anim_done);
|
|
@@ -150,7 +157,6 @@ declare global {
|
|
|
150
157
|
*
|
|
151
158
|
* export default defineScript({
|
|
152
159
|
* init(self) {
|
|
153
|
-
* const url = msg.url("#model");
|
|
154
160
|
* const play_properties = { blend_duration: 0.1 };
|
|
155
161
|
* // first blend during 0.1 sec into the jump, then during 0.2 s into the run animation
|
|
156
162
|
* model.play_anim(url, "jump", go.PLAYBACK_ONCE_FORWARD, play_properties, anim_done);
|
|
@@ -158,7 +164,7 @@ declare global {
|
|
|
158
164
|
* });
|
|
159
165
|
* ```
|
|
160
166
|
*/
|
|
161
|
-
function play_anim(url: string | Hash | Url, anim_id: string | Hash, playback:
|
|
167
|
+
function play_anim(url: string | Hash | Url, anim_id: string | Hash, playback: go.Playback, play_properties?: { blend_duration?: number; offset?: number; playback_rate?: number }, complete_function?: (self: unknown, message_id: unknown, message: unknown, sender: unknown) => void): void;
|
|
162
168
|
/**
|
|
163
169
|
* Enable or disable visibility of a mesh
|
|
164
170
|
*
|
|
@@ -197,7 +203,35 @@ declare global {
|
|
|
197
203
|
/**
|
|
198
204
|
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
199
205
|
*/
|
|
200
|
-
|
|
206
|
+
texture0: Hash;
|
|
207
|
+
/**
|
|
208
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
209
|
+
*/
|
|
210
|
+
texture1: Hash;
|
|
211
|
+
/**
|
|
212
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
213
|
+
*/
|
|
214
|
+
texture2: Hash;
|
|
215
|
+
/**
|
|
216
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
217
|
+
*/
|
|
218
|
+
texture3: Hash;
|
|
219
|
+
/**
|
|
220
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
221
|
+
*/
|
|
222
|
+
texture4: Hash;
|
|
223
|
+
/**
|
|
224
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
225
|
+
*/
|
|
226
|
+
texture5: Hash;
|
|
227
|
+
/**
|
|
228
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
229
|
+
*/
|
|
230
|
+
texture6: Hash;
|
|
231
|
+
/**
|
|
232
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
233
|
+
*/
|
|
234
|
+
texture7: Hash;
|
|
201
235
|
}
|
|
202
236
|
}
|
|
203
237
|
}
|
|
@@ -53,7 +53,7 @@ declare global {
|
|
|
53
53
|
* // How to play a particle fx when a game object is created.
|
|
54
54
|
* // The callback receives the hash of the path to the particlefx, the hash of the id
|
|
55
55
|
* // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
|
|
56
|
-
* function emitter_state_change(self, id, emitter, state) {
|
|
56
|
+
* function emitter_state_change(self: unknown, id: unknown, emitter: unknown, state: unknown) {
|
|
57
57
|
* if (emitter === hash("exhaust") && state === particlefx.EMITTER_STATE_POSTSPAWN) {
|
|
58
58
|
* // exhaust is done spawning particles...
|
|
59
59
|
* }
|
|
@@ -72,7 +72,7 @@ declare global {
|
|
|
72
72
|
* init(self) {
|
|
73
73
|
* let gravity = physics.get_gravity();
|
|
74
74
|
* // Inverse gravity!
|
|
75
|
-
* gravity = -gravity;
|
|
75
|
+
* gravity = vmath.vector3(-gravity.x, -gravity.y, -gravity.z);
|
|
76
76
|
* physics.set_gravity(gravity);
|
|
77
77
|
* },
|
|
78
78
|
* });
|
|
@@ -202,17 +202,22 @@ declare global {
|
|
|
202
202
|
* @returns It returns a list. If missed it returns `nil`. See ray_cast_response for details on the returned values.
|
|
203
203
|
* @example
|
|
204
204
|
* ```ts
|
|
205
|
+
* function handle_result(hit: { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }) {
|
|
206
|
+
* // act on the hit (see 'ray_cast_response')
|
|
207
|
+
* }
|
|
208
|
+
*
|
|
205
209
|
* // How to perform a ray cast synchronously:
|
|
206
210
|
* export default defineScript({
|
|
207
|
-
* init(
|
|
208
|
-
*
|
|
211
|
+
* init() {
|
|
212
|
+
* return { groups: [hash("world"), hash("enemy")] };
|
|
209
213
|
* },
|
|
210
214
|
*
|
|
211
215
|
* update(self, dt) {
|
|
212
216
|
* // request ray cast
|
|
213
|
-
* const
|
|
214
|
-
*
|
|
215
|
-
*
|
|
217
|
+
* const from = go.get_world_position();
|
|
218
|
+
* const to = vmath.vector3(from.x, from.y - 100, from.z);
|
|
219
|
+
* const results = physics.raycast(from, to, self.groups, { all: true });
|
|
220
|
+
* if (results !== undefined) {
|
|
216
221
|
* for (const result of results) {
|
|
217
222
|
* handle_result(result);
|
|
218
223
|
* }
|
|
@@ -244,12 +249,14 @@ declare global {
|
|
|
244
249
|
* ```ts
|
|
245
250
|
* // How to perform a ray cast asynchronously:
|
|
246
251
|
* export default defineScript({
|
|
247
|
-
* init(
|
|
248
|
-
*
|
|
252
|
+
* init() {
|
|
253
|
+
* return { my_groups: [hash("my_group1"), hash("my_group2")] };
|
|
249
254
|
* },
|
|
250
255
|
*
|
|
251
256
|
* update(self, dt) {
|
|
252
257
|
* // request ray cast
|
|
258
|
+
* const my_start = go.get_world_position();
|
|
259
|
+
* const my_end = vmath.vector3(my_start.x, my_start.y - 100, my_start.z);
|
|
253
260
|
* physics.raycast_async(my_start, my_end, self.my_groups);
|
|
254
261
|
* },
|
|
255
262
|
*
|
|
@@ -289,8 +296,8 @@ declare global {
|
|
|
289
296
|
* table The callback value data is a table that contains event-related data. See the documentation for details on the messages.
|
|
290
297
|
* @example
|
|
291
298
|
* ```ts
|
|
292
|
-
* function physics_world_listener(self, events) {
|
|
293
|
-
* for (const event of events) {
|
|
299
|
+
* function physics_world_listener(self: unknown, events: unknown) {
|
|
300
|
+
* for (const event of events as Record<string, unknown>[]) {
|
|
294
301
|
* const event_type = event["type"];
|
|
295
302
|
* if (event_type === hash("contact_point_event")) {
|
|
296
303
|
* pprint(event);
|
|
@@ -316,7 +323,7 @@ declare global {
|
|
|
316
323
|
* // relative_velocity = vmath.vector3(0, 0, 0),
|
|
317
324
|
* // },
|
|
318
325
|
* // }
|
|
319
|
-
* } else if (
|
|
326
|
+
* } else if (event_type === hash("collision_event")) {
|
|
320
327
|
* pprint(event);
|
|
321
328
|
* // {
|
|
322
329
|
* // a = {
|
|
@@ -330,7 +337,7 @@ declare global {
|
|
|
330
337
|
* // id = hash: [/go2]
|
|
331
338
|
* // }
|
|
332
339
|
* // }
|
|
333
|
-
* } else if (
|
|
340
|
+
* } else if (event_type === hash("trigger_event")) {
|
|
334
341
|
* pprint(event);
|
|
335
342
|
* // {
|
|
336
343
|
* // enter = true,
|
|
@@ -343,7 +350,7 @@ declare global {
|
|
|
343
350
|
* // id = hash: [/go1]
|
|
344
351
|
* // }
|
|
345
352
|
* // },
|
|
346
|
-
* } else if (
|
|
353
|
+
* } else if (event_type === hash("ray_cast_response")) {
|
|
347
354
|
* pprint(event);
|
|
348
355
|
* // {
|
|
349
356
|
* // group = hash: [default],
|
|
@@ -353,7 +360,7 @@ declare global {
|
|
|
353
360
|
* // normal = vmath.vector3(0, 1, 0),
|
|
354
361
|
* // id = hash: [/go]
|
|
355
362
|
* // }
|
|
356
|
-
* } else if (
|
|
363
|
+
* } else if (event_type === hash("ray_cast_missed")) {
|
|
357
364
|
* pprint(event);
|
|
358
365
|
* // {
|
|
359
366
|
* // request_id = 0
|
|
@@ -409,9 +416,10 @@ declare global {
|
|
|
409
416
|
* @example
|
|
410
417
|
* ```ts
|
|
411
418
|
* export default defineScript({
|
|
412
|
-
* init(
|
|
413
|
-
*
|
|
414
|
-
* physics.set_hflip("#collisionobject",
|
|
419
|
+
* init() {
|
|
420
|
+
* const fliph = true; // set on some condition
|
|
421
|
+
* physics.set_hflip("#collisionobject", fliph);
|
|
422
|
+
* return { fliph };
|
|
415
423
|
* },
|
|
416
424
|
* });
|
|
417
425
|
* ```
|
|
@@ -483,9 +491,10 @@ declare global {
|
|
|
483
491
|
* @example
|
|
484
492
|
* ```ts
|
|
485
493
|
* export default defineScript({
|
|
486
|
-
* init(
|
|
487
|
-
*
|
|
488
|
-
* physics.set_vflip("#collisionobject",
|
|
494
|
+
* init() {
|
|
495
|
+
* const flipv = true; // set on some condition
|
|
496
|
+
* physics.set_vflip("#collisionobject", flipv);
|
|
497
|
+
* return { flipv };
|
|
489
498
|
* },
|
|
490
499
|
* });
|
|
491
500
|
* ```
|
|
@@ -5,6 +5,8 @@ declare global {
|
|
|
5
5
|
* More detailed [profiling](https://www.defold.com/manuals/profiling/) and [debugging](http://www.defold.com/manuals/debugging/) information available in the manuals.
|
|
6
6
|
*/
|
|
7
7
|
namespace profiler {
|
|
8
|
+
type Mode = typeof profiler.MODE_RUN | typeof profiler.MODE_PAUSE | typeof profiler.MODE_SHOW_PEAK_FRAME | typeof profiler.MODE_RECORD;
|
|
9
|
+
type ViewMode = typeof profiler.VIEW_MODE_FULL | typeof profiler.VIEW_MODE_MINIMIZED;
|
|
8
10
|
/**
|
|
9
11
|
* pause on current frame
|
|
10
12
|
*/
|
|
@@ -114,6 +116,7 @@ declare global {
|
|
|
114
116
|
* @param text - the string to send to the connected profiler
|
|
115
117
|
* @example
|
|
116
118
|
* ```ts
|
|
119
|
+
* const name = "my_event";
|
|
117
120
|
* profiler.log_text(`Event: ${name}`);
|
|
118
121
|
* ```
|
|
119
122
|
*/
|
|
@@ -126,7 +129,7 @@ declare global {
|
|
|
126
129
|
* ```ts
|
|
127
130
|
* // Show the last recorded frame
|
|
128
131
|
* const recorded_frame_count = profiler.recorded_frame_count();
|
|
129
|
-
* profiler.view_recorded_frame(recorded_frame_count);
|
|
132
|
+
* profiler.view_recorded_frame({ frame: recorded_frame_count });
|
|
130
133
|
* ```
|
|
131
134
|
*/
|
|
132
135
|
function recorded_frame_count(): number;
|
|
@@ -136,6 +139,10 @@ declare global {
|
|
|
136
139
|
* @param name - The name of the scope
|
|
137
140
|
* @example
|
|
138
141
|
* ```ts
|
|
142
|
+
* function test_function() {
|
|
143
|
+
* // the work being measured
|
|
144
|
+
* }
|
|
145
|
+
*
|
|
139
146
|
* // Go back one frame
|
|
140
147
|
* profiler.scope_begin("test_function");
|
|
141
148
|
* test_function();
|
|
@@ -174,7 +181,7 @@ declare global {
|
|
|
174
181
|
* }
|
|
175
182
|
* ```
|
|
176
183
|
*/
|
|
177
|
-
function set_ui_mode(mode:
|
|
184
|
+
function set_ui_mode(mode: profiler.Mode): void;
|
|
178
185
|
/**
|
|
179
186
|
* Set the on-screen profile view mode - minimized or expanded
|
|
180
187
|
*
|
|
@@ -189,7 +196,7 @@ declare global {
|
|
|
189
196
|
* profiler.set_ui_view_mode(profiler.VIEW_MODE_MINIMIZED);
|
|
190
197
|
* ```
|
|
191
198
|
*/
|
|
192
|
-
function set_ui_view_mode(mode:
|
|
199
|
+
function set_ui_view_mode(mode: profiler.ViewMode): void;
|
|
193
200
|
/**
|
|
194
201
|
* Shows or hides the time the engine waits for vsync in the on-screen profiler
|
|
195
202
|
* Each frame the engine waits for vsync and depending on your vsync settings and how much time
|