@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
|
@@ -49,6 +49,7 @@ import "../../../src/message-guard";
|
|
|
49
49
|
import "../../../src/window-event-guard";
|
|
50
50
|
import "../../../src/scene-addresses";
|
|
51
51
|
import "../../../src/go-overloads";
|
|
52
|
+
import "../../../src/component-properties";
|
|
52
53
|
import "../../../src/render-overloads";
|
|
53
54
|
import "../../../src/vmath-overloads";
|
|
54
55
|
|
|
@@ -369,7 +369,7 @@ declare global {
|
|
|
369
369
|
* material.set_textures(resource.material("/my_material.materialc"), { my_texture: resource.texture() });
|
|
370
370
|
* ```
|
|
371
371
|
*/
|
|
372
|
-
function set_textures(path: Hash | string, textures: LuaMap<string, Hash>): void;
|
|
372
|
+
function set_textures(path: Hash | string, textures: LuaMap<string, Hash> | Record<string, Hash>): void;
|
|
373
373
|
/**
|
|
374
374
|
* Sets vertex attributes in a material, if the vertex attributes exist.
|
|
375
375
|
*
|
|
@@ -83,12 +83,16 @@ declare global {
|
|
|
83
83
|
* @returns true if the mesh is visible, false otherwise
|
|
84
84
|
* @example
|
|
85
85
|
* ```ts
|
|
86
|
+
* // shared weapon data, e.g. required from your own module
|
|
87
|
+
* const game = { data: { weapons: { Sword: { damage: 10 } } } };
|
|
88
|
+
*
|
|
86
89
|
* export default defineScript({
|
|
87
|
-
* init(
|
|
90
|
+
* init() {
|
|
88
91
|
* if (model.get_mesh_enabled("#model", "Sword")) {
|
|
89
92
|
* // set properties specific for the sword
|
|
90
|
-
*
|
|
93
|
+
* return { weapon_properties: game.data.weapons["Sword"] };
|
|
91
94
|
* }
|
|
95
|
+
* return { weapon_properties: undefined };
|
|
92
96
|
* },
|
|
93
97
|
* });
|
|
94
98
|
* ```
|
|
@@ -153,9 +157,12 @@ declare global {
|
|
|
153
157
|
* ```ts
|
|
154
158
|
* // The following examples assume that the model has id "model".
|
|
155
159
|
* // How to play the "jump" animation followed by the "run" animation:
|
|
156
|
-
*
|
|
160
|
+
* const url = msg.url("#model");
|
|
161
|
+
*
|
|
162
|
+
* function anim_done(self: unknown, message_id: unknown, message: unknown, sender: unknown) {
|
|
157
163
|
* if (message_id === hash("model_animation_done")) {
|
|
158
|
-
*
|
|
164
|
+
* const { animation_id } = message as { animation_id: Hash };
|
|
165
|
+
* if (animation_id === hash("jump")) {
|
|
159
166
|
* // open animation done, chain with "run"
|
|
160
167
|
* const properties = { blend_duration: 0.2 };
|
|
161
168
|
* model.play_anim(url, "run", go.PLAYBACK_LOOP_FORWARD, properties, anim_done);
|
|
@@ -165,7 +172,6 @@ declare global {
|
|
|
165
172
|
*
|
|
166
173
|
* export default defineScript({
|
|
167
174
|
* init(self) {
|
|
168
|
-
* const url = msg.url("#model");
|
|
169
175
|
* const play_properties = { blend_duration: 0.1 };
|
|
170
176
|
* // first blend during 0.1 sec into the jump, then during 0.2 s into the run animation
|
|
171
177
|
* model.play_anim(url, "jump", go.PLAYBACK_ONCE_FORWARD, play_properties, anim_done);
|
|
@@ -173,7 +179,7 @@ declare global {
|
|
|
173
179
|
* });
|
|
174
180
|
* ```
|
|
175
181
|
*/
|
|
176
|
-
function play_anim(url: string | Hash | Url, anim_id: string | Hash, playback:
|
|
182
|
+
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;
|
|
177
183
|
/**
|
|
178
184
|
* Resets a shader constant for a model component.
|
|
179
185
|
* The constant must be defined in the material assigned to the model.
|
|
@@ -238,7 +244,35 @@ declare global {
|
|
|
238
244
|
/**
|
|
239
245
|
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
240
246
|
*/
|
|
241
|
-
|
|
247
|
+
texture0: Hash;
|
|
248
|
+
/**
|
|
249
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
250
|
+
*/
|
|
251
|
+
texture1: Hash;
|
|
252
|
+
/**
|
|
253
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
254
|
+
*/
|
|
255
|
+
texture2: Hash;
|
|
256
|
+
/**
|
|
257
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
258
|
+
*/
|
|
259
|
+
texture3: Hash;
|
|
260
|
+
/**
|
|
261
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
262
|
+
*/
|
|
263
|
+
texture4: Hash;
|
|
264
|
+
/**
|
|
265
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
266
|
+
*/
|
|
267
|
+
texture5: Hash;
|
|
268
|
+
/**
|
|
269
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
270
|
+
*/
|
|
271
|
+
texture6: Hash;
|
|
272
|
+
/**
|
|
273
|
+
* The texture hash id of the model. Used for getting/setting model texture for unit 0-7
|
|
274
|
+
*/
|
|
275
|
+
texture7: Hash;
|
|
242
276
|
}
|
|
243
277
|
}
|
|
244
278
|
}
|
|
@@ -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
|
* }
|
|
@@ -70,7 +70,7 @@ declare global {
|
|
|
70
70
|
* init(self) {
|
|
71
71
|
* let gravity = physics.get_gravity();
|
|
72
72
|
* // Inverse gravity!
|
|
73
|
-
* gravity = -gravity;
|
|
73
|
+
* gravity = vmath.vector3(-gravity.x, -gravity.y, -gravity.z);
|
|
74
74
|
* physics.set_gravity(gravity);
|
|
75
75
|
* },
|
|
76
76
|
* });
|
|
@@ -200,17 +200,22 @@ declare global {
|
|
|
200
200
|
* @returns It returns a list. If missed it returns `nil`. See ray_cast_response for details on the returned values.
|
|
201
201
|
* @example
|
|
202
202
|
* ```ts
|
|
203
|
+
* function handle_result(hit: { fraction: number; position: Vector3; normal: Vector3; id: Hash; group: Hash; request_id: number }) {
|
|
204
|
+
* // act on the hit (see 'ray_cast_response')
|
|
205
|
+
* }
|
|
206
|
+
*
|
|
203
207
|
* // How to perform a ray cast synchronously:
|
|
204
208
|
* export default defineScript({
|
|
205
|
-
* init(
|
|
206
|
-
*
|
|
209
|
+
* init() {
|
|
210
|
+
* return { groups: [hash("world"), hash("enemy")] };
|
|
207
211
|
* },
|
|
208
212
|
*
|
|
209
213
|
* update(self, dt) {
|
|
210
214
|
* // request ray cast
|
|
211
|
-
* const
|
|
212
|
-
*
|
|
213
|
-
*
|
|
215
|
+
* const from = go.get_world_position();
|
|
216
|
+
* const to = vmath.vector3(from.x, from.y - 100, from.z);
|
|
217
|
+
* const results = physics.raycast(from, to, self.groups, { all: true });
|
|
218
|
+
* if (results !== undefined) {
|
|
214
219
|
* for (const result of results) {
|
|
215
220
|
* handle_result(result);
|
|
216
221
|
* }
|
|
@@ -242,12 +247,14 @@ declare global {
|
|
|
242
247
|
* ```ts
|
|
243
248
|
* // How to perform a ray cast asynchronously:
|
|
244
249
|
* export default defineScript({
|
|
245
|
-
* init(
|
|
246
|
-
*
|
|
250
|
+
* init() {
|
|
251
|
+
* return { my_groups: [hash("my_group1"), hash("my_group2")] };
|
|
247
252
|
* },
|
|
248
253
|
*
|
|
249
254
|
* update(self, dt) {
|
|
250
255
|
* // request ray cast
|
|
256
|
+
* const my_start = go.get_world_position();
|
|
257
|
+
* const my_end = vmath.vector3(my_start.x, my_start.y - 100, my_start.z);
|
|
251
258
|
* physics.raycast_async(my_start, my_end, self.my_groups);
|
|
252
259
|
* },
|
|
253
260
|
*
|
|
@@ -287,8 +294,8 @@ declare global {
|
|
|
287
294
|
* table The callback value data is a table that contains event-related data. See the documentation for details on the messages.
|
|
288
295
|
* @example
|
|
289
296
|
* ```ts
|
|
290
|
-
* function physics_world_listener(self, events) {
|
|
291
|
-
* for (const event of events) {
|
|
297
|
+
* function physics_world_listener(self: unknown, events: unknown) {
|
|
298
|
+
* for (const event of events as Record<string, unknown>[]) {
|
|
292
299
|
* const event_type = event["type"];
|
|
293
300
|
* if (event_type === hash("contact_point_event")) {
|
|
294
301
|
* pprint(event);
|
|
@@ -314,7 +321,7 @@ declare global {
|
|
|
314
321
|
* // relative_velocity = vmath.vector3(0, 0, 0),
|
|
315
322
|
* // },
|
|
316
323
|
* // }
|
|
317
|
-
* } else if (
|
|
324
|
+
* } else if (event_type === hash("collision_event")) {
|
|
318
325
|
* pprint(event);
|
|
319
326
|
* // {
|
|
320
327
|
* // a = {
|
|
@@ -328,7 +335,7 @@ declare global {
|
|
|
328
335
|
* // id = hash: [/go2]
|
|
329
336
|
* // }
|
|
330
337
|
* // }
|
|
331
|
-
* } else if (
|
|
338
|
+
* } else if (event_type === hash("trigger_event")) {
|
|
332
339
|
* pprint(event);
|
|
333
340
|
* // {
|
|
334
341
|
* // enter = true,
|
|
@@ -341,7 +348,7 @@ declare global {
|
|
|
341
348
|
* // id = hash: [/go1]
|
|
342
349
|
* // }
|
|
343
350
|
* // },
|
|
344
|
-
* } else if (
|
|
351
|
+
* } else if (event_type === hash("ray_cast_response")) {
|
|
345
352
|
* pprint(event);
|
|
346
353
|
* // {
|
|
347
354
|
* // group = hash: [default],
|
|
@@ -351,7 +358,7 @@ declare global {
|
|
|
351
358
|
* // normal = vmath.vector3(0, 1, 0),
|
|
352
359
|
* // id = hash: [/go]
|
|
353
360
|
* // }
|
|
354
|
-
* } else if (
|
|
361
|
+
* } else if (event_type === hash("ray_cast_missed")) {
|
|
355
362
|
* pprint(event);
|
|
356
363
|
* // {
|
|
357
364
|
* // request_id = 0
|
|
@@ -407,9 +414,10 @@ declare global {
|
|
|
407
414
|
* @example
|
|
408
415
|
* ```ts
|
|
409
416
|
* export default defineScript({
|
|
410
|
-
* init(
|
|
411
|
-
*
|
|
412
|
-
* physics.set_hflip("#collisionobject",
|
|
417
|
+
* init() {
|
|
418
|
+
* const fliph = true; // set on some condition
|
|
419
|
+
* physics.set_hflip("#collisionobject", fliph);
|
|
420
|
+
* return { fliph };
|
|
413
421
|
* },
|
|
414
422
|
* });
|
|
415
423
|
* ```
|
|
@@ -481,9 +489,10 @@ declare global {
|
|
|
481
489
|
* @example
|
|
482
490
|
* ```ts
|
|
483
491
|
* export default defineScript({
|
|
484
|
-
* init(
|
|
485
|
-
*
|
|
486
|
-
* physics.set_vflip("#collisionobject",
|
|
492
|
+
* init() {
|
|
493
|
+
* const flipv = true; // set on some condition
|
|
494
|
+
* physics.set_vflip("#collisionobject", flipv);
|
|
495
|
+
* return { flipv };
|
|
487
496
|
* },
|
|
488
497
|
* });
|
|
489
498
|
* ```
|
|
@@ -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
|
*/
|
|
@@ -113,6 +115,7 @@ declare global {
|
|
|
113
115
|
* @param text - the string to send to the connected profiler
|
|
114
116
|
* @example
|
|
115
117
|
* ```ts
|
|
118
|
+
* const name = "my_event";
|
|
116
119
|
* profiler.log_text(`Event: ${name}`);
|
|
117
120
|
* ```
|
|
118
121
|
*/
|
|
@@ -125,7 +128,7 @@ declare global {
|
|
|
125
128
|
* ```ts
|
|
126
129
|
* // Show the last recorded frame
|
|
127
130
|
* const recorded_frame_count = profiler.recorded_frame_count();
|
|
128
|
-
* profiler.view_recorded_frame(recorded_frame_count);
|
|
131
|
+
* profiler.view_recorded_frame({ frame: recorded_frame_count });
|
|
129
132
|
* ```
|
|
130
133
|
*/
|
|
131
134
|
function recorded_frame_count(): number;
|
|
@@ -135,6 +138,10 @@ declare global {
|
|
|
135
138
|
* @param name - The name of the scope
|
|
136
139
|
* @example
|
|
137
140
|
* ```ts
|
|
141
|
+
* function test_function() {
|
|
142
|
+
* // the work being measured
|
|
143
|
+
* }
|
|
144
|
+
*
|
|
138
145
|
* // Go back one frame
|
|
139
146
|
* profiler.scope_begin("test_function");
|
|
140
147
|
* test_function();
|
|
@@ -173,7 +180,7 @@ declare global {
|
|
|
173
180
|
* }
|
|
174
181
|
* ```
|
|
175
182
|
*/
|
|
176
|
-
function set_ui_mode(mode:
|
|
183
|
+
function set_ui_mode(mode: profiler.Mode): void;
|
|
177
184
|
/**
|
|
178
185
|
* Set the on-screen profile view mode - minimized or expanded
|
|
179
186
|
*
|
|
@@ -188,7 +195,7 @@ declare global {
|
|
|
188
195
|
* profiler.set_ui_view_mode(profiler.VIEW_MODE_MINIMIZED);
|
|
189
196
|
* ```
|
|
190
197
|
*/
|
|
191
|
-
function set_ui_view_mode(mode:
|
|
198
|
+
function set_ui_view_mode(mode: profiler.ViewMode): void;
|
|
192
199
|
/**
|
|
193
200
|
* Shows or hides the time the engine waits for vsync in the on-screen profiler
|
|
194
201
|
* Each frame the engine waits for vsync and depending on your vsync settings and how much time
|