@defold-typescript/types 0.23.0 → 0.25.0

package/generated/go.d.ts

@@ -259,7 +259,7 @@ declare global {
      * go.animate("go", "position.y", go.PLAYBACK_LOOP_PINGPONG, 100, vec, 2.0);
      * ```
      */
-    export function animate(url: string | Hash | Url, property: string | Hash, playback: number & { readonly __brand: "go.PLAYBACK_ONCE_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_PINGPONG" } | number & { readonly __brand: "go.PLAYBACK_LOOP_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_PINGPONG" }, to: number | Vector3 | Vector4 | Quaternion, easing: Vector | number & { readonly __brand: "go.EASING_INBACK" } | number & { readonly __brand: "go.EASING_INBOUNCE" } | number & { readonly __brand: "go.EASING_INCIRC" } | number & { readonly __brand: "go.EASING_INCUBIC" } | number & { readonly __brand: "go.EASING_INELASTIC" } | number & { readonly __brand: "go.EASING_INEXPO" } | number & { readonly __brand: "go.EASING_INOUTBACK" } | number & { readonly __brand: "go.EASING_INOUTBOUNCE" } | number & { readonly __brand: "go.EASING_INOUTCIRC" } | number & { readonly __brand: "go.EASING_INOUTCUBIC" } | number & { readonly __brand: "go.EASING_INOUTELASTIC" } | number & { readonly __brand: "go.EASING_INOUTEXPO" } | number & { readonly __brand: "go.EASING_INOUTQUAD" } | number & { readonly __brand: "go.EASING_INOUTQUART" } | number & { readonly __brand: "go.EASING_INOUTQUINT" } | number & { readonly __brand: "go.EASING_INOUTSINE" } | number & { readonly __brand: "go.EASING_INQUAD" } | number & { readonly __brand: "go.EASING_INQUART" } | number & { readonly __brand: "go.EASING_INQUINT" } | number & { readonly __brand: "go.EASING_INSINE" } | number & { readonly __brand: "go.EASING_LINEAR" } | number & { readonly __brand: "go.EASING_OUTBACK" } | number & { readonly __brand: "go.EASING_OUTBOUNCE" } | number & { readonly __brand: "go.EASING_OUTCIRC" } | number & { readonly __brand: "go.EASING_OUTCUBIC" } | number & { readonly __brand: "go.EASING_OUTELASTIC" } | number & { readonly __brand: "go.EASING_OUTEXPO" } | number & { readonly __brand: "go.EASING_OUTINBACK" } | number & { readonly __brand: "go.EASING_OUTINBOUNCE" } | number & { readonly __brand: "go.EASING_OUTINCIRC" } | number & { readonly __brand: "go.EASING_OUTINCUBIC" } | number & { readonly __brand: "go.EASING_OUTINELASTIC" } | number & { readonly __brand: "go.EASING_OUTINEXPO" } | number & { readonly __brand: "go.EASING_OUTINQUAD" } | number & { readonly __brand: "go.EASING_OUTINQUART" } | number & { readonly __brand: "go.EASING_OUTINQUINT" } | number & { readonly __brand: "go.EASING_OUTINSINE" } | number & { readonly __brand: "go.EASING_OUTQUAD" } | number & { readonly __brand: "go.EASING_OUTQUART" } | number & { readonly __brand: "go.EASING_OUTQUINT" } | number & { readonly __brand: "go.EASING_OUTSINE" }, duration: number, delay?: number, complete_function?: (self: unknown, url: unknown, property: unknown) => void): void;
+    export function animate(url: SceneAddress | Hash | Url, property: string | Hash, playback: number & { readonly __brand: "go.PLAYBACK_ONCE_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_PINGPONG" } | number & { readonly __brand: "go.PLAYBACK_LOOP_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_PINGPONG" }, to: number | Vector3 | Vector4 | Quaternion, easing: Vector | number & { readonly __brand: "go.EASING_INBACK" } | number & { readonly __brand: "go.EASING_INBOUNCE" } | number & { readonly __brand: "go.EASING_INCIRC" } | number & { readonly __brand: "go.EASING_INCUBIC" } | number & { readonly __brand: "go.EASING_INELASTIC" } | number & { readonly __brand: "go.EASING_INEXPO" } | number & { readonly __brand: "go.EASING_INOUTBACK" } | number & { readonly __brand: "go.EASING_INOUTBOUNCE" } | number & { readonly __brand: "go.EASING_INOUTCIRC" } | number & { readonly __brand: "go.EASING_INOUTCUBIC" } | number & { readonly __brand: "go.EASING_INOUTELASTIC" } | number & { readonly __brand: "go.EASING_INOUTEXPO" } | number & { readonly __brand: "go.EASING_INOUTQUAD" } | number & { readonly __brand: "go.EASING_INOUTQUART" } | number & { readonly __brand: "go.EASING_INOUTQUINT" } | number & { readonly __brand: "go.EASING_INOUTSINE" } | number & { readonly __brand: "go.EASING_INQUAD" } | number & { readonly __brand: "go.EASING_INQUART" } | number & { readonly __brand: "go.EASING_INQUINT" } | number & { readonly __brand: "go.EASING_INSINE" } | number & { readonly __brand: "go.EASING_LINEAR" } | number & { readonly __brand: "go.EASING_OUTBACK" } | number & { readonly __brand: "go.EASING_OUTBOUNCE" } | number & { readonly __brand: "go.EASING_OUTCIRC" } | number & { readonly __brand: "go.EASING_OUTCUBIC" } | number & { readonly __brand: "go.EASING_OUTELASTIC" } | number & { readonly __brand: "go.EASING_OUTEXPO" } | number & { readonly __brand: "go.EASING_OUTINBACK" } | number & { readonly __brand: "go.EASING_OUTINBOUNCE" } | number & { readonly __brand: "go.EASING_OUTINCIRC" } | number & { readonly __brand: "go.EASING_OUTINCUBIC" } | number & { readonly __brand: "go.EASING_OUTINELASTIC" } | number & { readonly __brand: "go.EASING_OUTINEXPO" } | number & { readonly __brand: "go.EASING_OUTINQUAD" } | number & { readonly __brand: "go.EASING_OUTINQUART" } | number & { readonly __brand: "go.EASING_OUTINQUINT" } | number & { readonly __brand: "go.EASING_OUTINSINE" } | number & { readonly __brand: "go.EASING_OUTQUAD" } | number & { readonly __brand: "go.EASING_OUTQUART" } | number & { readonly __brand: "go.EASING_OUTQUINT" } | number & { readonly __brand: "go.EASING_OUTSINE" }, duration: number, delay?: number, complete_function?: (self: unknown, url: unknown, property: unknown) => void): void;
     /**
      * By calling this function, all or specified stored property animations of the game object or component will be canceled.
      * See the properties guide for which properties can be animated and the animation guide for how to animate them.
@@ -278,7 +278,7 @@ declare global {
      * go.cancel_animations("#sprite");
      * ```
      */
-    export function cancel_animations(url: string | Hash | Url, property?: string | Hash): void;
+    export function cancel_animations(url: SceneAddress | Hash | Url, property?: string | Hash): void;
     /**
      * Delete one or more game objects identified by id. Deletion is asynchronous meaning that
      * the game object(s) are scheduled for deletion which will happen at the end of the current
@@ -313,7 +313,7 @@ declare global {
      * go.delete(ids2, true);
      * ```
      */
-    function _delete(id?: string | Hash | Url | (string | Hash | Url)[], recursive?: boolean): void;
+    function _delete(id?: SceneGameObjectAddress | Hash | Url | (SceneGameObjectAddress | Hash | Url)[], recursive?: boolean): void;
     /**
      * This function can check for game objects in any collection by specifying
      * the collection name in the URL.
@@ -329,7 +329,7 @@ declare global {
      * go.exists("other_collection:/my_game_object");
      * ```
      */
-    export function exists(url: string | Hash | Url): boolean;
+    export function exists(url: SceneGameObjectAddress | Hash | Url): boolean;
     /**
      * This is a callback-function, which is called by the engine when a script component is finalized (destroyed). It can
      * be used to e.g. take some last action, report the finalization to other game object instances, delete spawned objects
@@ -396,7 +396,7 @@ declare global {
      * const parent_id2 = go.get_parent("x");
      * ```
      */
-    export function get_parent(id?: string | Hash | Url): Hash | undefined;
+    export function get_parent(id?: SceneGameObjectAddress | Hash | Url): Hash | undefined;
     /**
      * The position is relative the parent (if any). Use go.get_world_position to retrieve the global world position.
      *
@@ -411,7 +411,7 @@ declare global {
      * const pos = go.get_position("my_gameobject");
      * ```
      */
-    export function get_position(id?: string | Hash | Url): Vector3;
+    export function get_position(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The rotation is relative to the parent (if any). Use go.get_world_rotation to retrieve the global world rotation.
      *
@@ -426,7 +426,7 @@ declare global {
      * const r2 = go.get_rotation("x");
      * ```
      */
-    export function get_rotation(id?: string | Hash | Url): Quaternion;
+    export function get_rotation(id?: SceneGameObjectAddress | Hash | Url): Quaternion;
     /**
      * The scale is relative the parent (if any). Use go.get_world_scale to retrieve the global world 3D scale factor.
      *
@@ -441,7 +441,7 @@ declare global {
      * const s2 = go.get_scale("x");
      * ```
      */
-    export function get_scale(id?: string | Hash | Url): Vector3;
+    export function get_scale(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The uniform scale is relative the parent (if any). If the underlying scale vector is non-uniform the min element of the vector is returned as the uniform scale factor.
      *
@@ -456,7 +456,7 @@ declare global {
      * const s2 = go.get_scale_uniform("x");
      * ```
      */
-    export function get_scale_uniform(id?: string | Hash | Url): number;
+    export function get_scale_uniform(id?: SceneGameObjectAddress | Hash | Url): number;
     /**
      * The function will return the world position calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -473,7 +473,7 @@ declare global {
      * const p2 = go.get_world_position("x");
      * ```
      */
-    export function get_world_position(id?: string | Hash | Url): Vector3;
+    export function get_world_position(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function will return the world rotation calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -490,7 +490,7 @@ declare global {
      * const r2 = go.get_world_rotation("x");
      * ```
      */
-    export function get_world_rotation(id?: string | Hash | Url): Quaternion;
+    export function get_world_rotation(id?: SceneGameObjectAddress | Hash | Url): Quaternion;
     /**
      * The function will return the world 3D scale factor calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -509,7 +509,7 @@ declare global {
      * const s2 = go.get_world_scale("x");
      * ```
      */
-    export function get_world_scale(id?: string | Hash | Url): Vector3;
+    export function get_world_scale(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function will return the world scale factor calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -526,7 +526,7 @@ declare global {
      * const s2 = go.get_world_scale_uniform("x");
      * ```
      */
-    export function get_world_scale_uniform(id?: string | Hash | Url): number;
+    export function get_world_scale_uniform(id?: SceneGameObjectAddress | Hash | Url): number;
     /**
      * The function will return the world transform matrix calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -542,7 +542,7 @@ declare global {
      * const m2 = go.get_world_transform("x");
      * ```
      */
-    export function get_world_transform(id?: string | Hash | Url): Matrix4;
+    export function get_world_transform(id?: SceneGameObjectAddress | Hash | Url): Matrix4;
     /**
      * This is a callback-function, which is called by the engine when a script component is initialized. It can be used
      * to set the initial state of the script.
@@ -879,7 +879,7 @@ declare global {
      * go.set_parent(go.get_id("my_instance"));
      * ```
      */
-    export function set_parent(id?: string | Hash | Url, parent_id?: string | Hash | Url, keep_world_transform?: boolean): void;
+    export function set_parent(id?: SceneGameObjectAddress | Hash | Url, parent_id?: SceneGameObjectAddress | Hash | Url, keep_world_transform?: boolean): void;
     /**
      * The position is relative to the parent (if any). The global world position cannot be manually set.
      *
@@ -897,7 +897,7 @@ declare global {
      * go.set_position(p, "x");
      * ```
      */
-    export function set_position(position: Vector3, id?: string | Hash | Url): void;
+    export function set_position(position: Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The rotation is relative to the parent (if any). The global world rotation cannot be manually set.
      *
@@ -915,7 +915,7 @@ declare global {
      * go.set_rotation(r, "x");
      * ```
      */
-    export function set_rotation(rotation: Quaternion, id?: string | Hash | Url): void;
+    export function set_rotation(rotation: Quaternion, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The scale factor is relative to the parent (if any). The global world scale factor cannot be manually set.
      * See manual to know how physics affected when setting scale from this function.
@@ -933,7 +933,7 @@ declare global {
      * go.set_scale(s2, "obj_id");
      * ```
      */
-    export function set_scale(scale: number | Vector3, id?: string | Hash | Url): void;
+    export function set_scale(scale: number | Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The scale factor is relative to the parent (if any). The global world scale factor cannot be manually set.
      * See manual to know how physics affected when setting scale from this function.
@@ -951,7 +951,7 @@ declare global {
      * go.set_scale_xy(s2, "obj_id"); // z will not be set here, only x and y
      * ```
      */
-    export function set_scale_xy(scale: number | Vector3, id?: string | Hash | Url): void;
+    export function set_scale_xy(scale: number | Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * This is a callback-function, which is called by the engine every frame to update the state of a script component.
      * It can be used to perform any kind of game related tasks, e.g. moving the game object instance.
@@ -994,7 +994,7 @@ declare global {
      * go.update_world_transform("/other");
      * ```
      */
-    export function update_world_transform(id?: string | Hash | Url): void;
+    export function update_world_transform(id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The function uses world transformation calculated at the end of previous frame.
      *
@@ -1009,7 +1009,7 @@ declare global {
      * const new_position = go.world_to_local_position(test_pos, "/child");
      * ```
      */
-    export function world_to_local_position(position: Vector3, url: string | Hash | Url): Vector3;
+    export function world_to_local_position(position: Vector3, url: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function uses world transformation calculated at the end of previous frame.
      *
@@ -1024,7 +1024,7 @@ declare global {
      * const result_transform = go.world_to_local_transform(test_transform, "/child");
      * ```
      */
-    export function world_to_local_transform(transformation: Matrix4, url: string | Hash | Url): Matrix4;
+    export function world_to_local_transform(transformation: Matrix4, url: SceneGameObjectAddress | Hash | Url): Matrix4;
     export { _delete as delete };
     export interface properties {
       /**

package/generated/kinds/editor-script.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="lua-types/5.1" />
+import "../editor";
+import "../editor-vm/http";
+import "../editor-vm/json";
+import "../editor-vm/localization";
+import "../editor-vm/zip";
+import "../editor-vm/zlib";
+import "../editor-vm/tilemap_tiles";
+import "../../src/editor-overloads";
+import "../../src/editor-vm-globals";
+
+export { defineEditorScript, defineEditorCommand } from "../../src/editor";
+export type { EditorCommandQuery, EditorNode } from "../../src/editor";

package/generated/kinds/gui-script.d.ts

@@ -48,6 +48,7 @@ import "../../src/engine-globals";
 import "../../src/go-overloads";
 import "../../src/message-guard";
 import "../../src/msg-overloads";
+import "../../src/scene-addresses";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";

package/generated/kinds/render-script.d.ts

@@ -48,6 +48,7 @@ import "../../src/engine-globals";
 import "../../src/go-overloads";
 import "../../src/message-guard";
 import "../../src/msg-overloads";
+import "../../src/scene-addresses";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";

package/generated/kinds/script.d.ts

@@ -48,6 +48,7 @@ import "../../src/engine-globals";
 import "../../src/go-overloads";
 import "../../src/message-guard";
 import "../../src/msg-overloads";
+import "../../src/scene-addresses";
 import "../../src/vmath-overloads";
 import "../../src/window-event-guard";
 import "../builtin-messages";

package/generated/versions/defold-1.12.4/go.d.ts

@@ -261,7 +261,7 @@ declare global {
      * go.animate("go", "position.y", go.PLAYBACK_LOOP_PINGPONG, 100, vec, 2.0);
      * ```
      */
-    export function animate(url: string | Hash | Url, property: string | Hash, playback: number & { readonly __brand: "go.PLAYBACK_ONCE_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_PINGPONG" } | number & { readonly __brand: "go.PLAYBACK_LOOP_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_PINGPONG" }, to: number | Vector3 | Vector4 | Quaternion, easing: Vector | number & { readonly __brand: "go.EASING_INBACK" } | number & { readonly __brand: "go.EASING_INBOUNCE" } | number & { readonly __brand: "go.EASING_INCIRC" } | number & { readonly __brand: "go.EASING_INCUBIC" } | number & { readonly __brand: "go.EASING_INELASTIC" } | number & { readonly __brand: "go.EASING_INEXPO" } | number & { readonly __brand: "go.EASING_INOUTBACK" } | number & { readonly __brand: "go.EASING_INOUTBOUNCE" } | number & { readonly __brand: "go.EASING_INOUTCIRC" } | number & { readonly __brand: "go.EASING_INOUTCUBIC" } | number & { readonly __brand: "go.EASING_INOUTELASTIC" } | number & { readonly __brand: "go.EASING_INOUTEXPO" } | number & { readonly __brand: "go.EASING_INOUTQUAD" } | number & { readonly __brand: "go.EASING_INOUTQUART" } | number & { readonly __brand: "go.EASING_INOUTQUINT" } | number & { readonly __brand: "go.EASING_INOUTSINE" } | number & { readonly __brand: "go.EASING_INQUAD" } | number & { readonly __brand: "go.EASING_INQUART" } | number & { readonly __brand: "go.EASING_INQUINT" } | number & { readonly __brand: "go.EASING_INSINE" } | number & { readonly __brand: "go.EASING_LINEAR" } | number & { readonly __brand: "go.EASING_OUTBACK" } | number & { readonly __brand: "go.EASING_OUTBOUNCE" } | number & { readonly __brand: "go.EASING_OUTCIRC" } | number & { readonly __brand: "go.EASING_OUTCUBIC" } | number & { readonly __brand: "go.EASING_OUTELASTIC" } | number & { readonly __brand: "go.EASING_OUTEXPO" } | number & { readonly __brand: "go.EASING_OUTINBACK" } | number & { readonly __brand: "go.EASING_OUTINBOUNCE" } | number & { readonly __brand: "go.EASING_OUTINCIRC" } | number & { readonly __brand: "go.EASING_OUTINCUBIC" } | number & { readonly __brand: "go.EASING_OUTINELASTIC" } | number & { readonly __brand: "go.EASING_OUTINEXPO" } | number & { readonly __brand: "go.EASING_OUTINQUAD" } | number & { readonly __brand: "go.EASING_OUTINQUART" } | number & { readonly __brand: "go.EASING_OUTINQUINT" } | number & { readonly __brand: "go.EASING_OUTINSINE" } | number & { readonly __brand: "go.EASING_OUTQUAD" } | number & { readonly __brand: "go.EASING_OUTQUART" } | number & { readonly __brand: "go.EASING_OUTQUINT" } | number & { readonly __brand: "go.EASING_OUTSINE" }, duration: number, delay?: number, complete_function?: (self: unknown, url: unknown, property: unknown) => void): void;
+    export function animate(url: SceneAddress | Hash | Url, property: string | Hash, playback: number & { readonly __brand: "go.PLAYBACK_ONCE_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_ONCE_PINGPONG" } | number & { readonly __brand: "go.PLAYBACK_LOOP_FORWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_BACKWARD" } | number & { readonly __brand: "go.PLAYBACK_LOOP_PINGPONG" }, to: number | Vector3 | Vector4 | Quaternion, easing: Vector | number & { readonly __brand: "go.EASING_INBACK" } | number & { readonly __brand: "go.EASING_INBOUNCE" } | number & { readonly __brand: "go.EASING_INCIRC" } | number & { readonly __brand: "go.EASING_INCUBIC" } | number & { readonly __brand: "go.EASING_INELASTIC" } | number & { readonly __brand: "go.EASING_INEXPO" } | number & { readonly __brand: "go.EASING_INOUTBACK" } | number & { readonly __brand: "go.EASING_INOUTBOUNCE" } | number & { readonly __brand: "go.EASING_INOUTCIRC" } | number & { readonly __brand: "go.EASING_INOUTCUBIC" } | number & { readonly __brand: "go.EASING_INOUTELASTIC" } | number & { readonly __brand: "go.EASING_INOUTEXPO" } | number & { readonly __brand: "go.EASING_INOUTQUAD" } | number & { readonly __brand: "go.EASING_INOUTQUART" } | number & { readonly __brand: "go.EASING_INOUTQUINT" } | number & { readonly __brand: "go.EASING_INOUTSINE" } | number & { readonly __brand: "go.EASING_INQUAD" } | number & { readonly __brand: "go.EASING_INQUART" } | number & { readonly __brand: "go.EASING_INQUINT" } | number & { readonly __brand: "go.EASING_INSINE" } | number & { readonly __brand: "go.EASING_LINEAR" } | number & { readonly __brand: "go.EASING_OUTBACK" } | number & { readonly __brand: "go.EASING_OUTBOUNCE" } | number & { readonly __brand: "go.EASING_OUTCIRC" } | number & { readonly __brand: "go.EASING_OUTCUBIC" } | number & { readonly __brand: "go.EASING_OUTELASTIC" } | number & { readonly __brand: "go.EASING_OUTEXPO" } | number & { readonly __brand: "go.EASING_OUTINBACK" } | number & { readonly __brand: "go.EASING_OUTINBOUNCE" } | number & { readonly __brand: "go.EASING_OUTINCIRC" } | number & { readonly __brand: "go.EASING_OUTINCUBIC" } | number & { readonly __brand: "go.EASING_OUTINELASTIC" } | number & { readonly __brand: "go.EASING_OUTINEXPO" } | number & { readonly __brand: "go.EASING_OUTINQUAD" } | number & { readonly __brand: "go.EASING_OUTINQUART" } | number & { readonly __brand: "go.EASING_OUTINQUINT" } | number & { readonly __brand: "go.EASING_OUTINSINE" } | number & { readonly __brand: "go.EASING_OUTQUAD" } | number & { readonly __brand: "go.EASING_OUTQUART" } | number & { readonly __brand: "go.EASING_OUTQUINT" } | number & { readonly __brand: "go.EASING_OUTSINE" }, duration: number, delay?: number, complete_function?: (self: unknown, url: unknown, property: unknown) => void): void;
     /**
      * By calling this function, all or specified stored property animations of the game object or component will be canceled.
      * See the properties guide for which properties can be animated and the animation guide for how to animate them.
@@ -280,7 +280,7 @@ declare global {
      * go.cancel_animations("#sprite");
      * ```
      */
-    export function cancel_animations(url: string | Hash | Url, property?: string | Hash): void;
+    export function cancel_animations(url: SceneAddress | Hash | Url, property?: string | Hash): void;
     /**
      * Delete one or more game objects identified by id. Deletion is asynchronous meaning that
      * the game object(s) are scheduled for deletion which will happen at the end of the current
@@ -315,7 +315,7 @@ declare global {
      * go.delete(ids2, true);
      * ```
      */
-    function _delete(id?: string | Hash | Url | (string | Hash | Url)[], recursive?: boolean): void;
+    function _delete(id?: SceneGameObjectAddress | Hash | Url | (SceneGameObjectAddress | Hash | Url)[], recursive?: boolean): void;
     /**
      * This function can check for game objects in any collection by specifying
      * the collection name in the URL.
@@ -331,7 +331,7 @@ declare global {
      * go.exists("other_collection:/my_game_object");
      * ```
      */
-    export function exists(url: string | Hash | Url): boolean;
+    export function exists(url: SceneGameObjectAddress | Hash | Url): boolean;
     /**
      * This is a callback-function, which is called by the engine when a script component is finalized (destroyed). It can
      * be used to e.g. take some last action, report the finalization to other game object instances, delete spawned objects
@@ -398,7 +398,7 @@ declare global {
      * const parent_id2 = go.get_parent("x");
      * ```
      */
-    export function get_parent(id?: string | Hash | Url): Hash | undefined;
+    export function get_parent(id?: SceneGameObjectAddress | Hash | Url): Hash | undefined;
     /**
      * The position is relative the parent (if any). Use go.get_world_position to retrieve the global world position.
      *
@@ -413,7 +413,7 @@ declare global {
      * const pos = go.get_position("my_gameobject");
      * ```
      */
-    export function get_position(id?: string | Hash | Url): Vector3;
+    export function get_position(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The rotation is relative to the parent (if any). Use go.get_world_rotation to retrieve the global world rotation.
      *
@@ -428,7 +428,7 @@ declare global {
      * const r2 = go.get_rotation("x");
      * ```
      */
-    export function get_rotation(id?: string | Hash | Url): Quaternion;
+    export function get_rotation(id?: SceneGameObjectAddress | Hash | Url): Quaternion;
     /**
      * The scale is relative the parent (if any). Use go.get_world_scale to retrieve the global world 3D scale factor.
      *
@@ -443,7 +443,7 @@ declare global {
      * const s2 = go.get_scale("x");
      * ```
      */
-    export function get_scale(id?: string | Hash | Url): Vector3;
+    export function get_scale(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The uniform scale is relative the parent (if any). If the underlying scale vector is non-uniform the min element of the vector is returned as the uniform scale factor.
      *
@@ -458,7 +458,7 @@ declare global {
      * const s2 = go.get_scale_uniform("x");
      * ```
      */
-    export function get_scale_uniform(id?: string | Hash | Url): number;
+    export function get_scale_uniform(id?: SceneGameObjectAddress | Hash | Url): number;
     /**
      * The function will return the world position calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -475,7 +475,7 @@ declare global {
      * const p2 = go.get_world_position("x");
      * ```
      */
-    export function get_world_position(id?: string | Hash | Url): Vector3;
+    export function get_world_position(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function will return the world rotation calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -492,7 +492,7 @@ declare global {
      * const r2 = go.get_world_rotation("x");
      * ```
      */
-    export function get_world_rotation(id?: string | Hash | Url): Quaternion;
+    export function get_world_rotation(id?: SceneGameObjectAddress | Hash | Url): Quaternion;
     /**
      * The function will return the world 3D scale factor calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -511,7 +511,7 @@ declare global {
      * const s2 = go.get_world_scale("x");
      * ```
      */
-    export function get_world_scale(id?: string | Hash | Url): Vector3;
+    export function get_world_scale(id?: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function will return the world scale factor calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -528,7 +528,7 @@ declare global {
      * const s2 = go.get_world_scale_uniform("x");
      * ```
      */
-    export function get_world_scale_uniform(id?: string | Hash | Url): number;
+    export function get_world_scale_uniform(id?: SceneGameObjectAddress | Hash | Url): number;
     /**
      * The function will return the world transform matrix calculated at the end of the previous frame.
      * To recalculate it within the current frame, use go.update_world_transform on the instance before calling this.
@@ -544,7 +544,7 @@ declare global {
      * const m2 = go.get_world_transform("x");
      * ```
      */
-    export function get_world_transform(id?: string | Hash | Url): Matrix4;
+    export function get_world_transform(id?: SceneGameObjectAddress | Hash | Url): Matrix4;
     /**
      * This is a callback-function, which is called by the engine when a script component is initialized. It can be used
      * to set the initial state of the script.
@@ -854,7 +854,7 @@ declare global {
      * go.set_parent(go.get_id("my_instance"));
      * ```
      */
-    export function set_parent(id?: string | Hash | Url, parent_id?: string | Hash | Url, keep_world_transform?: boolean): void;
+    export function set_parent(id?: SceneGameObjectAddress | Hash | Url, parent_id?: SceneGameObjectAddress | Hash | Url, keep_world_transform?: boolean): void;
     /**
      * The position is relative to the parent (if any). The global world position cannot be manually set.
      *
@@ -872,7 +872,7 @@ declare global {
      * go.set_position(p, "x");
      * ```
      */
-    export function set_position(position: Vector3, id?: string | Hash | Url): void;
+    export function set_position(position: Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The rotation is relative to the parent (if any). The global world rotation cannot be manually set.
      *
@@ -890,7 +890,7 @@ declare global {
      * go.set_rotation(r, "x");
      * ```
      */
-    export function set_rotation(rotation: Quaternion, id?: string | Hash | Url): void;
+    export function set_rotation(rotation: Quaternion, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The scale factor is relative to the parent (if any). The global world scale factor cannot be manually set.
      * See manual to know how physics affected when setting scale from this function.
@@ -908,7 +908,7 @@ declare global {
      * go.set_scale(s2, "obj_id");
      * ```
      */
-    export function set_scale(scale: number | Vector3, id?: string | Hash | Url): void;
+    export function set_scale(scale: number | Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The scale factor is relative to the parent (if any). The global world scale factor cannot be manually set.
      * See manual to know how physics affected when setting scale from this function.
@@ -926,7 +926,7 @@ declare global {
      * go.set_scale_xy(s2, "obj_id"); // z will not be set here, only x and y
      * ```
      */
-    export function set_scale_xy(scale: number | Vector3, id?: string | Hash | Url): void;
+    export function set_scale_xy(scale: number | Vector3, id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * This is a callback-function, which is called by the engine every frame to update the state of a script component.
      * It can be used to perform any kind of game related tasks, e.g. moving the game object instance.
@@ -969,7 +969,7 @@ declare global {
      * go.update_world_transform("/other");
      * ```
      */
-    export function update_world_transform(id?: string | Hash | Url): void;
+    export function update_world_transform(id?: SceneGameObjectAddress | Hash | Url): void;
     /**
      * The function uses world transformation calculated at the end of previous frame.
      *
@@ -984,7 +984,7 @@ declare global {
      * const new_position = go.world_to_local_position(test_pos, "/child");
      * ```
      */
-    export function world_to_local_position(position: Vector3, url: string | Hash | Url): Vector3;
+    export function world_to_local_position(position: Vector3, url: SceneGameObjectAddress | Hash | Url): Vector3;
     /**
      * The function uses world transformation calculated at the end of previous frame.
      *
@@ -999,7 +999,7 @@ declare global {
      * const result_transform = go.world_to_local_transform(test_transform, "/child");
      * ```
      */
-    export function world_to_local_transform(transformation: Matrix4, url: string | Hash | Url): Matrix4;
+    export function world_to_local_transform(transformation: Matrix4, url: SceneGameObjectAddress | Hash | Url): Matrix4;
     export { _delete as delete };
     export interface properties {
       /**

package/index.d.ts

@@ -5,6 +5,7 @@ import "./src/msg-overloads";
 import "./src/message-guard";
 import "./src/window-event-guard";
 import "./src/message-dispatch";
+import "./src/scene-addresses";
 import "./src/engine-globals";
 import "./generated/b2d";
 import "./generated/b2d_body";
@@ -131,3 +132,8 @@ export {
   type SignatureOverride,
   type SignatureStore,
 } from "./src/signature-store";
+export type {
+  UrlParameterClass,
+  UrlParameterEntry,
+  UrlParameterTable,
+} from "./src/url-parameters";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/types",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "TypeScript types for the Defold engine's Lua APIs.",
   "license": "MIT",
   "repository": {
@@ -27,17 +27,24 @@
     "./render-script": {
       "types": "./generated/kinds/render-script.d.ts"
     },
+    "./editor-script": {
+      "types": "./generated/kinds/editor-script.d.ts"
+    },
     "./core-types": {
       "types": "./src/core-types.ts"
     },
     "./lifecycle": {
       "types": "./src/lifecycle.ts"
     },
+    "./editor": {
+      "types": "./src/editor.ts"
+    },
     "./timers": {
       "types": "./src/timers.d.ts"
     },
     "./api-availability.json": "./api-availability.json",
     "./api-signatures.json": "./api-signatures.json",
+    "./url-parameters.json": "./url-parameters.json",
     "./package.json": "./package.json"
   },
   "files": [
@@ -48,6 +55,7 @@
     "api-migrations.json",
     "api-availability.json",
     "api-signatures.json",
+    "url-parameters.json",
     "index.d.ts",
     "!src/**/*.test.ts",
     "!scripts/**/*.test.ts",

package/scripts/materialize-version.ts

@@ -1,34 +1,61 @@
 import { mkdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { dirname, resolve } from "node:path";
 import {
   type ApiTarget,
   generateModuleDeclaration,
   generateVersionIndex,
   KIND_MODULE_MANIFEST,
-  LUA_STDLIB_REFERENCES,
+  type KindManifestEntry,
+  kindStdlibReferences,
+  loadTargetEditorModules,
   type ResolveTargetOptions,
   resolveTargetModules,
 } from "./regen";
 
-export { KIND_MODULE_MANIFEST } from "./regen";
+export { RUNTIME_KIND_MANIFEST, targetKindManifest } from "./regen";
 
 export interface RenderMaterializedKindIndexOptions {
   readonly kind: string;
   readonly universalModules: readonly string[];
   readonly restrictedModule: string | null;
+  // Set for a kind built from the target's own editor documents. It replaces
+  // the universal set outright — an editor kind is disjoint from the runtime
+  // surface, not a narrowing of it.
+  readonly editorModules?: readonly string[];
+}
+
+// The installed subpath a materialized kind re-exports its factory from: the
+// surface has no relative `src/<module>` to reach, but the package publishes
+// each factory module under its own name.
+function installedFactoryModule(entry: KindManifestEntry): string {
+  const module = (entry.factoryFrom ?? "../../src/lifecycle").split("/").pop();
+  return `@defold-typescript/types/${module}`;
 }
 
 // Render one per-kind subpath for the materialized surface, mirroring
 // `generateKindIndex` but re-exporting the factory from the installed
-// `@defold-typescript/types/lifecycle` subpath (the materialized surface has no
-// relative `src/lifecycle` to reach). Pure: returns a string, no FS.
+// `@defold-typescript/types/<module>` subpath. Pure: returns a string, no FS.
 export function renderMaterializedKindIndex(opts: RenderMaterializedKindIndexOptions): string {
   const entry = KIND_MODULE_MANIFEST.find((e) => e.kind === opts.kind);
   if (!entry) throw new Error(`unknown script kind: ${opts.kind}`);
-  const universal = [...new Set(["engine-globals", ...opts.universalModules])].sort();
-  const lines = universal.map((mod) => `import "../${mod}";`);
-  if (opts.restrictedModule) lines.push(`import "../${opts.restrictedModule}";`);
-  return `${LUA_STDLIB_REFERENCES}${lines.join("\n")}\n\nexport { ${entry.factory} } from "@defold-typescript/types/lifecycle";\nexport type { ScriptProperties, ScriptProperty } from "@defold-typescript/types/lifecycle";\n`;
+  const modules =
+    entry.only === undefined
+      ? [...new Set(["engine-globals", ...opts.universalModules])].sort()
+      : [...(opts.editorModules ?? [])];
+  const lines = modules.map((mod) => `import "../${mod}";`);
+  if (entry.only === undefined && opts.restrictedModule) {
+    lines.push(`import "../${opts.restrictedModule}";`);
+  }
+  const from = installedFactoryModule(entry);
+  const values = [entry.factory, ...(entry.extraExports ?? [])].join(", ");
+  const typeExports = entry.extraTypeExports?.length
+    ? `\nexport type { ${entry.extraTypeExports.join(", ")} } from "${from}";`
+    : "";
+  const properties =
+    entry.propertyTypes === false
+      ? ""
+      : `\nexport type { ScriptProperties, ScriptProperty } from "${from}";`;
+  return `${kindStdlibReferences(entry)}${lines.join("\n")}\n\nexport { ${values} } from "${from}";${typeExports}${properties}\n`;
 }
 
 export interface BuildVersionedSurfaceOptions {
@@ -60,15 +87,25 @@ export async function buildVersionedSurfaceFiles(
   opts: BuildVersionedSurfaceOptions = {},
 ): Promise<VersionedSurfaceFile[]> {
   const exclude = new Set(opts.excludeModules ?? []);
-  const modules = (await resolveTargetModules(target, opts.resolveOpts ?? {})).filter(
-    (entry) => !exclude.has(entry.outFile.replace(/\.d\.ts$/, "")),
+  const kept = (outFile: string): boolean => !exclude.has(outFile.replace(/\.d\.ts$/, ""));
+  const modules = (await resolveTargetModules(target, opts.resolveOpts ?? {})).filter((entry) =>
+    kept(entry.outFile),
   );
+  // The editor documents a target declares are always committed fixtures — the
+  // ref-doc zip carries no editor surface — so they resolve from disk whatever
+  // the target's `source` says.
+  const editorModules = loadTargetEditorModules(
+    target,
+    opts.resolveOpts?.packageRoot ?? undefined,
+  ).filter((entry) => kept(entry.outFile));
 
-  const files: VersionedSurfaceFile[] = modules.map((entry) => ({
+  const files: VersionedSurfaceFile[] = [...modules, ...editorModules].map((entry) => ({
     path: entry.outFile,
     contents: generateModuleDeclaration(entry).contents,
   }));
 
+  // The aggregate entrypoint stays the runtime surface: importing the editor VM
+  // there would drag it into every program that pins this version.
   const versioned = modules.map((entry) => ({ ...entry, versionId: target.id }));
   files.push({ path: "index.d.ts", contents: generateVersionIndex(target.id, versioned) });
 
@@ -94,6 +131,10 @@ export async function materializeVersionedSurface(
   const files = await buildVersionedSurfaceFiles(target, opts);
   mkdirSync(opts.destDir, { recursive: true });
   for (const file of files) {
-    writeFileSync(resolve(opts.destDir, file.path), file.contents);
+    const out = resolve(opts.destDir, file.path);
+    // An editor VM module lands in its own subdirectory, so the sink cannot
+    // assume every file is a direct child of the surface root.
+    mkdirSync(dirname(out), { recursive: true });
+    writeFileSync(out, file.contents);
   }
 }