typescript-to-gdscript 0.1.0 → 0.1.2

package/typings/classes/IterateIK3D.d.ts

@@ -43,7 +43,8 @@ declare class IterateIK3D extends ChainIK3D {
    * Returns the joint limitation rotation offset at `joint` in the bone chain's joint list.
    * Rotation is done in the local space which is constructed by the bone direction (in general parent to child) as the +Y axis and {@link get_joint_limitation_right_axis_vector} as the +X axis.
    * If the +X and +Y axes are not orthogonal, the +X axis is implicitly modified to make it orthogonal.
-   * Also, if the length of {@link get_joint_limitation_right_axis_vector} is zero, the space is created by rotating the bone rest using the shortest arc that rotates the +Y axis of the bone rest to match the bone direction.
+   * Also, if the length of {@link get_joint_limitation_right_axis_vector} is zero, the space is created by rotating the reference pose using the shortest arc that rotates the +Y axis of the reference pose to match the bone direction.
+   * In here, the reference pose is the bone pose immediately before processing IK.
    */
   get_joint_limitation_rotation_offset(index: int, joint: int): Quaternion;
   /** Returns the rotation axis at `joint` in the bone chain's joint list. */
@@ -65,12 +66,14 @@ declare class IterateIK3D extends ChainIK3D {
    * Sets the joint limitation rotation offset at `joint` in the bone chain's joint list.
    * Rotation is done in the local space which is constructed by the bone direction (in general parent to child) as the +Y axis and {@link get_joint_limitation_right_axis_vector} as the +X axis.
    * If the +X and +Y axes are not orthogonal, the +X axis is implicitly modified to make it orthogonal.
-   * Also, if the length of {@link get_joint_limitation_right_axis_vector} is zero, the space is created by rotating the bone rest using the shortest arc that rotates the +Y axis of the bone rest to match the bone direction.
+   * Also, if the length of {@link get_joint_limitation_right_axis_vector} is zero, the space is created by rotating the reference pose using the shortest arc that rotates the +Y axis of the reference pose to match the bone direction.
+   * In here, the reference pose is the bone pose immediately before processing IK.
    */
   set_joint_limitation_rotation_offset(index: int, joint: int, offset: Quaternion | Basis): void;
   /**
    * Sets the rotation axis at `joint` in the bone chain's joint list.
-   * The axes are based on the {@link Skeleton3D.get_bone_rest}'s space, if `axis` is {@link SkeletonModifier3D.ROTATION_AXIS_CUSTOM}, you can specify any axis.
+   * The axes are based on the reference pose's space, if `axis` is {@link SkeletonModifier3D.ROTATION_AXIS_CUSTOM}, you can specify any axis.
+   * In here, the reference pose is the bone pose immediately before processing IK.
    * **Note:** The rotation axis and the forward vector shouldn't be colinear to avoid unintended rotation since {@link ChainIK3D} does not factor in twisting forces.
    */
   set_joint_rotation_axis(index: int, joint: int, axis: int): void;

package/typings/classes/JavaClassWrapper.d.ts

@@ -3,6 +3,19 @@
 
 /** Provides access to the Java Native Interface. */
 declare interface JavaClassWrapper extends GodotObject {
+  /**
+   * Creates a {@link JavaObject} implementing the given Java interfaces using the given {@link Object} as the implementation.
+   * The `object` must contain methods signatures matching the methods signatures from the passed Java `interfaces`. Invoking methods from the Java `interfaces` will route to the matching `object` method.
+   * **Note:** This method only works on Android. On every other platform, this method will always return `null`.
+   */
+  create_proxy(object: GodotObject, interfaces: PackedStringArray | Array<unknown>): JavaObject | null;
+  /**
+   * Creates a {@link JavaObject} implementing the Java Single Abstract Method (SAM) interface using the Godot {@link Callable} as the implementation.
+   * The `sam_interface` **must be** a Java SAM interface, meaning it must only have a single abstract method to implement.
+   * The `callable` must be able to handle the same parameter types as the SAM interface method, and must provide the same return type. The `callable` will be invoked as a callback, passing the arguments from the Java SAM interface method.
+   * **Note:** This method only works on Android. On every other platform, this method will always return `null`.
+   */
+  create_sam_callback(sam_interface: string | NodePath, callable: Callable): JavaObject | null;
   /**
    * Returns the Java exception from the last call into a Java class. If there was no exception, it will return `null`.
    * **Note:** This method only works on Android. On every other platform, this method will always return `null`.

package/typings/classes/JavaScriptBridge.d.ts

@@ -34,7 +34,7 @@ declare interface JavaScriptBridge extends GodotObject {
    */
   get_interface(interface_: string | NodePath): JavaScriptObject | null;
   /**
-   * Returns `true` if the given `javascript_object` is of type `ArrayBuffer` (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer), `DataView` (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView), or one of the many typed array objects (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray).
+   * Returns `true` if the given `javascript_object` is of type ArrayBuffer (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer), DataView (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView), or one of the many typed array objects (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray).
    */
   is_js_buffer(javascript_object: JavaScriptObject): boolean;
   /**

package/typings/classes/Label.d.ts

@@ -5,6 +5,7 @@
 declare class Label extends Control {
   /**
    * If set to something other than {@link TextServer.AUTOWRAP_OFF}, the text gets wrapped inside the node's bounding rectangle. If you resize the node, it will change its height automatically to show all the text.
+   * **Note:** Labels with autowrapping enabled must have a custom maximum width configured to work correctly, either through the Label's own {@link Control.custom_maximum_size} or as a result of a propagated maximum size from a parent Control with {@link Control.propagate_maximum_size} enabled.
    */
   autowrap_mode: int;
   /**

package/typings/classes/LabelSettings.d.ts

@@ -27,8 +27,33 @@ declare class LabelSettings extends Resource {
   shadow_size: int;
   /** The number of stacked outlines. */
   stacked_outline_count: int;
+  /**
+   * The color of the outline at `index`.
+   * **Note:** `index` is a value in the `0 .. stacked_outline_count - 1` range.
+   */
+  'stacked_outline_{index}/color': Color;
+  /**
+   * The size of the outline at `index`.
+   * **Note:** `index` is a value in the `0 .. stacked_outline_count - 1` range.
+   */
+  'stacked_outline_{index}/size': int;
   /** The number of stacked shadows. */
   stacked_shadow_count: int;
+  /**
+   * The color of the shadow at `index`.
+   * **Note:** `index` is a value in the `0 .. stacked_shadow_count - 1` range.
+   */
+  'stacked_shadow_{index}/color': Color;
+  /**
+   * The offset of the shadow at `index`.
+   * **Note:** `index` is a value in the `0 .. stacked_shadow_count - 1` range.
+   */
+  'stacked_shadow_{index}/offset': Vector2;
+  /**
+   * The size of the shadow outline at `index`.
+   * **Note:** `index` is a value in the `0 .. stacked_shadow_count - 1` range.
+   */
+  'stacked_shadow_{index}/outline_size': int;
   set_font(value: Font | null): void;
   get_font(): Font | null;
   set_font_color(value: Color): void;

package/typings/classes/Light3D.d.ts

@@ -76,7 +76,7 @@ declare class Light3D extends VisualInstance3D {
    */
   light_projector: Texture2D | null;
   /**
-   * The size of the light in Godot units. Only available for {@link OmniLight3D}s and {@link SpotLight3D}s. Increasing this value will make the light fade out slower and shadows appear blurrier (also called percentage-closer soft shadows, or PCSS). This can be used to simulate area lights to an extent. Increasing this value above `0.0` for lights with shadows enabled will have a noticeable performance cost due to PCSS.
+   * The simulated size of the light in Godot units, affecting shading and shadows. For {@link OmniLight3D}s and {@link SpotLight3D}s, increasing this value simulates a spherical area light, expanding the size of specular highlights. If shadows are enabled, a penumbra is rendered, making shadows appear blurrier. For {@link AreaLight3D}s, only the shadows are affected. Penumbras are simulated with percentage-closer soft shadows, or PCSS, which has a noticeable performance cost for values above `0.0`.
    * **Note:** {@link light_size} is not affected by {@link Node3D.scale} (the light's scale or its parent's scale).
    * **Note:** PCSS for positional lights is only supported in the Forward+ and Mobile rendering methods, not Compatibility.
    */

package/typings/classes/Logger.d.ts

@@ -8,7 +8,7 @@ declare class Logger extends RefCounted {
    * The type of error provided by `error_type` is described in the {@link ErrorType} enumeration.
    * Additionally, `script_backtraces` provides backtraces for each of the script languages. These will only contain stack frames in editor builds and debug builds by default. To enable them for release builds as well, you need to enable {@link ProjectSettings.debug/settings/gdscript/always_track_call_stacks}.
    * **Warning:** This method will be called from threads other than the main thread, possibly at the same time, so you will need to have some kind of thread-safety in your implementation of it, like a {@link Mutex}.
-   * **Note:** `script_backtraces` will not contain any captured variables, due to its prohibitively high cost. To get those you will need to capture the backtraces yourself, from within the {@link Logger} virtual methods, using {@link Engine.capture_script_backtraces}.
+   * **Note:** `script_backtraces` will not contain any captured variables, due to its prohibitively high cost. To get those, you will need to capture the backtraces yourself, from within the {@link Logger} virtual methods, using {@link Engine.capture_script_backtraces}.
    * **Note:** Logging errors from this method using functions like {@link @GlobalScope.push_error} or {@link @GlobalScope.push_warning} is not supported, as it could cause infinite recursion. These errors will only show up in the console output.
    */
   _log_error(function_: string | NodePath, file: string | NodePath, line: int, code: string | NodePath, rationale: string | NodePath, editor_notify: boolean, error_type: int, script_backtraces: Array<ScriptBacktrace>): void;

package/typings/classes/LookAtModifier3D.d.ts

@@ -68,7 +68,7 @@ declare class LookAtModifier3D extends SkeletonModifier3D {
   primary_rotation_axis: int;
   /**
    * The relative option. If `true`, the rotation is applied relative to the pose. If `false`, the rotation is applied relative to the rest. It means to replace the current pose with the {@link LookAtModifier3D}'s result.
-   * **Note:** This option affects the base angle for {@link use_angle_limitation} unlike {@link IterateIK3D}'s {@link JointLimitation3D}. Since the {@link LookAtModifier3D} relies strongly on Euler rotation, the axis that determines the limitation and the actual rotation are strongly tied together.
+   * **Note:** This option affects the base angle for {@link use_angle_limitation}. Since the {@link LookAtModifier3D} relies strongly on Euler rotation, the axis that determines the limitation and the actual rotation are strongly tied together.
    */
   relative: boolean;
   /** The threshold to start damping for {@link secondary_limit_angle}. */

package/typings/classes/MenuButton.d.ts

@@ -10,6 +10,41 @@ declare class MenuButton extends Button {
    * The number of items currently in the list.
    */
   action_mode: int;
+  /**
+   * The checkable item type of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/checkable': int;
+  /**
+   * If `true`, the item at `index` is checked.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/checked': boolean;
+  /**
+   * If `true`, the item at `index` is disabled.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/disabled': boolean;
+  /**
+   * The icon of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/icon': Texture2D | null;
+  /**
+   * The ID of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/id': int;
+  /**
+   * If `true`, the item at `index` is a separator.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/separator': boolean;
+  /**
+   * The text of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/text': string;
   /**
    * If `true`, when the cursor hovers above another {@link MenuButton} within the same parent which also has {@link switch_on_hover} enabled, it will close the current {@link MenuButton} and open the other one.
    */

package/typings/classes/MeshLibrary.d.ts

@@ -12,6 +12,8 @@ declare class MeshLibrary extends Resource {
   create_item(id: int): void;
   /** Returns the first item with the given name, or `-1` if no item is found. */
   find_item_by_name(name: string | NodePath): int;
+  /** Returns the number of items present in the library. */
+  get_item_count(): int;
   /** Returns the list of item IDs in use. */
   get_item_list(): PackedInt32Array;
   /** Returns the item's mesh. */

package/typings/classes/MovieWriter.d.ts

@@ -11,6 +11,8 @@ declare class MovieWriter extends GodotObject {
    * Called when the audio speaker mode used for recording the audio is requested by the engine. This can affect the number of output channels in the resulting audio file/stream. Defaults to {@link AudioServer.SPEAKER_MODE_STEREO} if {@link _get_audio_speaker_mode} is not overridden.
    */
   _get_audio_speaker_mode(): int;
+  /** Returns the list of supported filename extensions for movies written with this {@link MovieWriter}. */
+  _get_supported_extensions(): PackedStringArray;
   /**
    * Called when the engine determines whether this {@link MovieWriter} is able to handle the file at `path`. Must return `true` if this {@link MovieWriter} is able to handle the given file path, `false` otherwise. Typically, {@link _handles_file} is overridden as follows to allow the user to record a file at any path with a given file extension:
    */

package/typings/classes/MultiplayerPeerExtension.d.ts

@@ -6,9 +6,9 @@ declare class MultiplayerPeerExtension extends MultiplayerPeer {
   /** Called when the multiplayer peer should be immediately closed (see {@link MultiplayerPeer.close}). */
   _close(): void;
   /**
-   * Called when the connected `p_peer` should be forcibly disconnected (see {@link MultiplayerPeer.disconnect_peer}).
+   * Called when the connected `peer` should be forcibly disconnected (see {@link MultiplayerPeer.disconnect_peer}).
    */
-  _disconnect_peer(p_peer: int, p_force: boolean): void;
+  _disconnect_peer(peer: int, force: boolean): void;
   /** Called when the available packet count is internally requested by the {@link MultiplayerAPI}. */
   _get_available_packet_count(): int;
   /**
@@ -64,27 +64,27 @@ declare class MultiplayerPeerExtension extends MultiplayerPeer {
   /** Called when the {@link MultiplayerAPI} is polled. See {@link MultiplayerAPI.poll}. */
   _poll(): void;
   /**
-   * Called when a packet needs to be sent by the {@link MultiplayerAPI}, with `p_buffer_size` being the size of the binary `p_buffer` in bytes.
+   * Called when a packet needs to be sent by the {@link MultiplayerAPI}, with `buffer_size` being the size of the binary `buffer` in bytes.
    */
-  _put_packet(p_buffer: int, p_buffer_size: int): int;
+  _put_packet(buffer: int, buffer_size: int): int;
   /**
    * Called when a packet needs to be sent by the {@link MultiplayerAPI}, if {@link _put_packet} isn't implemented. Use this when extending this class via GDScript.
    */
-  _put_packet_script(p_buffer: PackedByteArray | Array<unknown>): int;
+  _put_packet_script(buffer: PackedByteArray | Array<unknown>): int;
   /**
    * Called when the "refuse new connections" status is set on this {@link MultiplayerPeer} (see {@link MultiplayerPeer.refuse_new_connections}).
    */
-  _set_refuse_new_connections(p_enable: boolean): void;
+  _set_refuse_new_connections(enable: boolean): void;
   /**
    * Called when the target peer to use is set for this {@link MultiplayerPeer} (see {@link MultiplayerPeer.set_target_peer}).
    */
-  _set_target_peer(p_peer: int): void;
+  _set_target_peer(peer: int): void;
   /**
    * Called when the channel to use is set for this {@link MultiplayerPeer} (see {@link MultiplayerPeer.transfer_channel}).
    */
-  _set_transfer_channel(p_channel: int): void;
+  _set_transfer_channel(channel: int): void;
   /**
    * Called when the transfer mode is set on this {@link MultiplayerPeer} (see {@link MultiplayerPeer.transfer_mode}).
    */
-  _set_transfer_mode(p_mode: int): void;
+  _set_transfer_mode(mode: int): void;
 }

package/typings/classes/Node.d.ts

@@ -561,6 +561,7 @@ declare class Node extends GodotObject {
   /**
    * Changes the parent of this {@link Node} to the `new_parent`. The node needs to already have a parent. The node's {@link owner} is preserved if its owner is still reachable from the new location (i.e., the node is still a descendant of the new parent after the operation).
    * If `keep_global_transform` is `true`, the node's global transform will be preserved if supported. {@link Node2D}, {@link Node3D} and {@link Control} support this argument (but {@link Control} keeps only position).
+   * **Warning:** If {@link ProjectSettings.physics/common/physics_interpolation} is enabled and reparenting causes a large change in global transform, the object may appear to move from its old position to its new one over the next physics tick. To avoid this, call {@link reset_physics_interpolation} after reparenting.
    */
   reparent(new_parent: Node, keep_global_transform?: boolean): void;
   /**
@@ -960,6 +961,11 @@ declare class Node extends GodotObject {
   static readonly NOTIFICATION_VP_MOUSE_EXIT: int;
   /** Notification received when the window is moved. */
   static readonly NOTIFICATION_WM_POSITION_CHANGED: int;
+  /**
+   * Notification received when the output max linear value returned by {@link Window.get_output_max_linear_value} has changed.
+   * This occurs when HDR output is enabled or disabled and when any HDR output luminance values of the window have changed, such as when the player adjusts their screen brightness setting or moves the window to a different screen.
+   */
+  static readonly NOTIFICATION_WM_OUTPUT_MAX_LINEAR_VALUE_CHANGED: int;
   /**
    * Notification received from the OS when the application is exceeding its allocated memory.
    * Implemented only on iOS.

package/typings/classes/Node3D.d.ts

@@ -50,7 +50,7 @@ declare class Node3D extends Node {
    * - The {@link Vector3.x} is the angle around the local X axis (pitch);
    * - The {@link Vector3.y} is the angle around the local Y axis (yaw);
    * - The {@link Vector3.z} is the angle around the local Z axis (roll).
-   * The order of each consecutive rotation can be changed with {@link rotation_order} (see {@link EulerOrder} constants). By default, the YXZ convention is used ({@link EULER_ORDER_YXZ}).
+   * The order of each consecutive rotation can be changed with {@link rotation_order} (see {@link EulerOrder} constants). In Godot, Euler angles always use intrinsic order. By default, the intrinsic YXZ convention is used ({@link EULER_ORDER_YXZ}).
    * **Note:** This property is edited in degrees in the inspector. If you want to use degrees in a script, use {@link rotation_degrees}.
    */
   rotation: Vector3;
@@ -62,7 +62,7 @@ declare class Node3D extends Node {
   /** How this node's rotation and scale are displayed in the Inspector dock. */
   rotation_edit_mode: int;
   /**
-   * The axis rotation order of the {@link rotation} property. The final orientation is calculated by rotating around the local X, Y, and Z axis in this order.
+   * The axis rotation order of the {@link rotation} property. In Godot, Euler angles always use intrinsic order, meaning that the final orientation is calculated by rotating around the local axes in this order.
    */
   rotation_order: int;
   /**
@@ -293,10 +293,12 @@ declare class Node3D extends Node {
 
   // enum RotationEditMode
   /**
-   * The rotation is edited using a {@link Vector3} in Euler angles (https://en.wikipedia.org/wiki/Euler_angles).
+   * The rotation is edited using a {@link Vector3} in Euler angles (https://en.wikipedia.org/wiki/Euler_angles). In Godot, Euler angles always use intrinsic order, meaning that rotation happens around the local axes of the object.
    */
   static readonly ROTATION_EDIT_MODE_EULER: int;
-  /** The rotation is edited using a {@link Quaternion}. */
+  /**
+   * The rotation is edited using a {@link Quaternion}. Quaternions avoid gimbal lock ($DOCS_URL/tutorials/3d/using_transforms.html) and having to choose an order of rotation, but are less intuitive. Quaternion rotation is mostly the same as rotors in 3D geometric algebra, except that the numbers are labeled differently.
+   */
   static readonly ROTATION_EDIT_MODE_QUATERNION: int;
   /**
    * The rotation is edited using a {@link Basis}. In this mode, the raw {@link basis}'s axes can be freely modified, but the {@link scale} property is not available.

package/typings/classes/OS.d.ts

@@ -485,7 +485,7 @@ declare interface OS extends GodotObject {
    * - `OS.shell_open("C:\\Users\\name\\Downloads")` on Windows opens the file explorer at the user's Downloads folder.
    * - `OS.shell_open("C:/Users/name/Downloads")` also works on Windows and opens the file explorer at the user's Downloads folder.
    * - `OS.shell_open("https://godotengine.org")` opens the default web browser on the official Godot website.
-   * - `OS.shell_open("mailto:example@example.com")` opens the default email client with the "To" field set to `example@example.com`. See RFC 2368 - The `mailto` URL scheme (https://datatracker.ietf.org/doc/html/rfc2368) for a list of fields that can be added.
+   * - `OS.shell_open("mailto:example@example.com")` opens the default email client with the "To" field set to `example@example.com`. See RFC 2368 - The mailto URL scheme (https://datatracker.ietf.org/doc/html/rfc2368) for a list of fields that can be added.
    * Use {@link ProjectSettings.globalize_path} to convert a `res://` or `user://` project path into a system path for use with this method.
    * **Note:** Use {@link String.uri_encode} to encode characters within URLs in a URL-safe, portable way. This is especially required for line breaks. Otherwise, {@link shell_open} may not work correctly in a project exported to the Web platform.
    * **Note:** This method is implemented on Android, iOS, Web, Linux, macOS and Windows.

package/typings/classes/Object.d.ts

@@ -8,6 +8,7 @@ declare class GodotObject {
    * Combined with {@link _set} and {@link _get_property_list}, this method allows defining custom properties, which is particularly useful for editor plugins.
    * **Note:** This method is not called when getting built-in properties of an object, including properties defined with .
    * **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via `super` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. The call chain will stop on the first class that returns a non-`null` value.
+   * **Warning:** This method must be thread-safe ($DOCS_URL/tutorials/performance/thread_safe_apis.html) if overridden. Otherwise, the engine may crash when trying to save a resource containing the object.
    */
   _get(property: string): unknown;
   /**
@@ -18,6 +19,7 @@ declare class GodotObject {
    * **Note:** This method is intended for advanced purposes. For most common use cases, the scripting languages offer easier ways to handle properties. See , , , etc. If you want to customize exported properties, use {@link _validate_property}.
    * **Note:** If the object's script is not , this method will not be called in the editor.
    * **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via `super` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy.
+   * **Warning:** This method must be thread-safe ($DOCS_URL/tutorials/performance/thread_safe_apis.html) if overridden. Otherwise, the engine may crash when trying to save a resource containing the object.
    */
   _get_property_list(): Array<Dictionary>;
   /**
@@ -32,7 +34,8 @@ declare class GodotObject {
   _iter_get(iter: unknown): unknown;
   /**
    * Initializes the iterator. `iter` stores the iteration state. Since GDScript does not support passing arguments by reference, a single-element array is used as a wrapper. Returns `true` so long as the iterator has not reached the end.
-   * **Note:** Alternatively, you can ignore `iter` and use the object's state instead, see online docs ($DOCS_URL/tutorials/scripting/gdscript/gdscript_advanced.html#custom-iterators) for an example. Note that in this case you will not be able to reuse the same iterator instance in nested loops. Also, make sure you reset the iterator state in this method if you want to reuse the same instance multiple times.
+   * **Note:** Avoid storing iterator state in a member variable, use the `iter` parameter instead. Otherwise, you won't be able to reuse the same iterator instance in nested loops.
+   * See also online docs ($DOCS_URL/tutorials/scripting/gdscript/gdscript_advanced.html#custom-iterators).
    */
   _iter_init(iter: Array<unknown> | PackedByteArray | PackedColorArray | PackedFloat32Array | PackedFloat64Array | PackedInt32Array | PackedInt64Array | PackedStringArray | PackedVector2Array | PackedVector3Array | PackedVector4Array): boolean;
   /**
@@ -108,7 +111,7 @@ declare class GodotObject {
   callv<N extends string, A extends any[], R>(
   this: Record<N, (...args: A) => R>,
   method: N,
-  args: A
+  args: A,
   ): R;
   callv(method: string, args: any[]): unknown;
   /**
@@ -141,10 +144,7 @@ declare class GodotObject {
   signal: N,
   ...args: A
   ): Error.OK | Error.ERR_UNAVAILABLE;
-  emit_signal(
-  signal: string,
-  ...args: any[]
-  ): Error.OK | Error.ERR_UNAVAILABLE;
+  emit_signal(signal: string, ...args: any[]): Error.OK | Error.ERR_UNAVAILABLE;
   /**
    * Deletes the object from memory. Pre-existing references to the object become invalid, and any attempt to access them will result in a runtime error. Checking the references with {@link @GlobalScope.is_instance_valid} will return `false`. This is equivalent to the `memdelete` function in GDExtension C++.
    */
@@ -265,13 +265,16 @@ declare class GodotObject {
    * Returns `true` if the object inherits from the given `class`. See also {@link get_class}.
    * **Note:** This method ignores `class_name` declarations in the object's script.
    */
-  is_class(class_: string | NodePath): boolean;
+  is_class(class_: string): boolean;
   /**
    * Returns `true` if a connection exists between the given `signal` name and `callable`.
    * **Note:** In C#, `signal` must be in snake_case when referring to built-in Godot signals. Prefer using the names exposed in the `SignalName` class to avoid allocating a new {@link StringName} on each call.
    */
   is_connected(signal: string, callable: Callable): boolean;
-  /** Returns `true` if the {@link Node.queue_free} method was called for the object. */
+  /**
+   * Returns `true` if the methods {@link Node.queue_free} or {@link SceneTree.queue_delete} was called for the object.
+   * **Note:** This method does not return `true` on children of the node that {@link Node.queue_free} has been called on, even though they will be freed together with the parent.
+   */
   is_queued_for_deletion(): boolean;
   /**
    * Sends the given `what` notification to all classes inherited by the object, triggering calls to {@link _notification}, starting from the highest ancestor (the {@link Object} class) and going down to the object's script.

package/typings/classes/OptimizedTranslation.d.ts

@@ -4,9 +4,9 @@
 /** An optimized translation. */
 declare class OptimizedTranslation extends Translation {
   /**
-   * Generates and sets an optimized translation from the given {@link Translation} resource.
+   * Generates and sets an optimized translation from the given {@link Translation} resource. Returns `true` if successful.
    * **Note:** Messages in `from` should not use context or plural forms.
    * **Note:** This method is intended to be used in the editor. It does nothing when called from an exported project.
    */
-  generate(from_: Translation): void;
+  generate(from_: Translation): boolean;
 }

package/typings/classes/OptionButton.d.ts

@@ -9,8 +9,6 @@ declare class OptionButton extends Button {
    * If `true`, the currently selected item can be selected again.
    */
   action_mode: int;
-  /** Enables the {@link PopupMenu} search bar if the item count is greater than `0`. */
-  enable_search_bar_on_item_count: int;
   /**
    * If `true`, minimum size will be determined by the longest item's text, instead of the currently selected one's.
    * **Note:** For performance reasons, the minimum size doesn't update immediately when adding, removing or modifying items.
@@ -18,15 +16,63 @@ declare class OptionButton extends Button {
   fit_to_longest_item: boolean;
   /** The number of items to select from. */
   item_count: int;
+  /**
+   * If `true`, the item at `index` is disabled.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/disabled': boolean;
+  /**
+   * The icon of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/icon': Texture2D | null;
+  /**
+   * The ID of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/id': int;
+  /**
+   * If `true`, the item at `index` is a separator.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/separator': boolean;
+  /**
+   * The text of the item at `index`.
+   * **Note:** `index` is a value in the `0 .. item_count - 1` range.
+   */
+  'popup/item_{index}/text': string;
+  /**
+   * If `true`, shows a search bar at the top of the {@link PopupMenu} for filtering items. See {@link search_bar_min_item_count} for dynamically controlling its visibility based on the number of items.
+   */
+  search_bar_enabled: boolean;
+  /**
+   * If `true`, enables fuzzy searching in the {@link PopupMenu} search bar. This allows the search results to include items that almost match the search query, as well items that match the individual characters of the search query, but not in sequence.
+   * Use {@link search_bar_fuzzy_search_max_misses} to set the maximum number of mismatches allowed in the search results.
+   */
+  search_bar_fuzzy_search_enabled: boolean;
+  /**
+   * Sets the maximum number of mismatches allowed in each search result when fuzzy searching is enabled for the {@link PopupMenu} search bar. Any item with more mismatches will be hidden from the search results.
+   */
+  search_bar_fuzzy_search_max_misses: int;
+  /**
+   * Sets the minimum number of items required for the {@link PopupMenu} search bar to be visible. {@link search_bar_enabled} must be `true` for this to have any effect.
+   */
+  search_bar_min_item_count: int;
   /** The index of the currently selected item, or `-1` if no item is selected. */
   selected: int;
   toggle_mode: boolean;
-  set_search_bar_enabled_on_item_count(value: int): void;
-  get_search_bar_enabled_on_item_count(): int;
   set_fit_to_longest_item(value: boolean): void;
   is_fit_to_longest_item(): boolean;
   set_item_count(value: int): void;
   get_item_count(): int;
+  set_search_bar_enabled(value: boolean): void;
+  is_search_bar_enabled(): boolean;
+  set_search_bar_fuzzy_search_enabled(value: boolean): void;
+  is_search_bar_fuzzy_search_enabled(): boolean;
+  set_search_bar_fuzzy_search_max_misses(value: int): void;
+  get_search_bar_fuzzy_search_max_misses(): int;
+  set_search_bar_min_item_count(value: int): void;
+  get_search_bar_min_item_count(): int;
   _select_int(value: int): void;
   get_selected(): int;
 
@@ -86,8 +132,6 @@ declare class OptionButton extends Button {
   is_item_disabled(idx: int): boolean;
   /** Returns `true` if the item at index `idx` is marked as a separator. */
   is_item_separator(idx: int): boolean;
-  /** Returns `true` if the search bar is enabled. */
-  is_search_bar_enabled(): boolean;
   /** Removes the item at index `idx`. */
   remove_item(idx: int): void;
   /**
@@ -125,7 +169,7 @@ declare class OptionButton extends Button {
   show_popup(): void;
 
   /**
-   * Emitted when the user navigates to an item using the {@link ProjectSettings.input/ui_up} or {@link ProjectSettings.input/ui_down} input actions. The index of the item selected is passed as argument.
+   * Emitted when the user navigates to an item using the {@link ProjectSettings.input/ui_up} or {@link ProjectSettings.input/ui_down} input actions. The index of the item focused is passed as argument.
    */
   item_focused: Signal<[int]>;
   /**

package/typings/classes/PacketPeerExtension.d.ts

@@ -5,5 +5,5 @@ declare class PacketPeerExtension extends PacketPeer {
   _get_available_packet_count(): int;
   _get_max_packet_size(): int;
   _get_packet(r_buffer: int, r_buffer_size: int): int;
-  _put_packet(p_buffer: int, p_buffer_size: int): int;
+  _put_packet(buffer: int, buffer_size: int): int;
 }

package/typings/classes/ParticleProcessMaterial.d.ts

@@ -209,6 +209,11 @@ declare class ParticleProcessMaterial extends Material {
   particle_flag_damping_as_friction: boolean;
   /** If `true`, particles will not move on the z axis. */
   particle_flag_disable_z: boolean;
+  /**
+   * If `true`, particles will inherit the scale of the emitter.
+   * **Note:** This has no effect when {@link GPUParticles3D.local_coords} is `true`, since particles in local space are already affected by the emitter's scale.
+   */
+  particle_flag_inherit_emitter_scale: boolean;
   /** If `true`, particles rotate around Y axis by {@link angle_min}. */
   particle_flag_rotate_y: boolean;
   /** Each particle's radial acceleration will vary along this {@link CurveTexture}. */
@@ -234,6 +239,32 @@ declare class ParticleProcessMaterial extends Material {
    * **Note:** Animated velocities will not be affected by damping, use {@link velocity_limit_curve} instead.
    */
   radial_velocity_min: float;
+  /** The maximum 3D orientation, in degrees. Works only in 3D and if {@link use_rotation_3d} is enabled. */
+  rotation_3d_max: Vector3;
+  /** The minimum 3D orientation, in degrees. Works only in 3D and if {@link use_rotation_3d} is enabled. */
+  rotation_3d_min: Vector3;
+  /**
+   * Rotation velocity curve over lifetime, per-axis. Enable {@link use_rotation_velocity_3d} to use this.
+   */
+  rotation_velocity_3d_curve: Texture2D | null;
+  /**
+   * Maximum 3D rotation velocity on the particle's local axis. Enable {@link use_rotation_velocity_3d} to use this.
+   */
+  rotation_velocity_3d_max: Vector3;
+  /**
+   * Minimum 3D rotation velocity on the particle's local axis. Enable {@link use_rotation_velocity_3d} to use this.
+   */
+  rotation_velocity_3d_min: Vector3;
+  /**
+   * The maximum value of the random scale vector for each particle.
+   * Works only if {@link use_scale_3d} is enabled.
+   */
+  scale_3d_max: Vector3;
+  /**
+   * The minimum value of the random scale vector for each particle.
+   * Works only if {@link use_scale_3d} is enabled.
+   */
+  scale_3d_min: Vector3;
   /**
    * Each particle's scale will vary along this {@link CurveTexture} over its lifetime. If a {@link CurveXYZTexture} is supplied instead, the scale will be separated per-axis.
    */
@@ -340,6 +371,12 @@ declare class ParticleProcessMaterial extends Material {
    * The turbulence noise strength. Increasing this will result in a stronger, more contrasting, flow pattern.
    */
   turbulence_noise_strength: float;
+  /** Enable the usage of {@link rotation_3d_min} and {@link rotation_3d_max}. */
+  use_rotation_3d: boolean;
+  /** Enable 3D rotation velocity. */
+  use_rotation_velocity_3d: boolean;
+  /** Enable the usage of {@link scale_3d_min} and {@link scale_3d_max}. */
+  use_scale_3d: boolean;
   /** A {@link CurveTexture} that defines the maximum velocity of a particle during its lifetime. */
   velocity_limit_curve: Texture2D | null;
   /** A pivot point used to calculate radial and orbital velocity of particles. */
@@ -402,6 +439,20 @@ declare class ParticleProcessMaterial extends Material {
   get_inherit_velocity_ratio(): float;
   set_lifetime_randomness(value: float): void;
   get_lifetime_randomness(): float;
+  set_rotation_3d_max(value: Vector3 | Vector3i): void;
+  get_rotation_3d_max(): Vector3;
+  set_rotation_3d_min(value: Vector3 | Vector3i): void;
+  get_rotation_3d_min(): Vector3;
+  set_rotation_velocity_3d_curve(value: Texture2D | null): void;
+  get_rotation_velocity_3d_curve(): Texture2D | null;
+  set_rotation_velocity_3d_max(value: Vector3 | Vector3i): void;
+  get_rotation_velocity_3d_max(): Vector3;
+  set_rotation_velocity_3d_min(value: Vector3 | Vector3i): void;
+  get_rotation_velocity_3d_min(): Vector3;
+  set_scale_3d_max(value: Vector3 | Vector3i): void;
+  get_scale_3d_max(): Vector3;
+  set_scale_3d_min(value: Vector3 | Vector3i): void;
+  get_scale_3d_min(): Vector3;
   set_spread(value: float): void;
   get_spread(): float;
   set_sub_emitter_amount_at_collision(value: int): void;
@@ -426,6 +477,12 @@ declare class ParticleProcessMaterial extends Material {
   get_turbulence_noise_speed_random(): float;
   set_turbulence_noise_strength(value: float): void;
   get_turbulence_noise_strength(): float;
+  set_use_rotation_3d(value: boolean): void;
+  is_using_rotation_3d(): boolean;
+  set_using_rotation_velocity_3d(value: boolean): void;
+  is_using_rotation_velocity_3d(): boolean;
+  set_use_scale_3d(value: boolean): void;
+  is_using_scale_3d(): boolean;
   set_velocity_limit_curve(value: Texture2D | null): void;
   get_velocity_limit_curve(): Texture2D | null;
   set_velocity_pivot(value: Vector3 | Vector3i): void;
@@ -545,6 +602,7 @@ declare class ParticleProcessMaterial extends Material {
   /** Use with {@link set_particle_flag} to set {@link particle_flag_disable_z}. */
   static readonly PARTICLE_FLAG_DISABLE_Z: int;
   static readonly PARTICLE_FLAG_DAMPING_AS_FRICTION: int;
+  static readonly PARTICLE_FLAG_INHERIT_EMITTER_SCALE: int;
   /** Represents the size of the {@link ParticleFlags} enum. */
   static readonly PARTICLE_FLAG_MAX: int;
   // enum EmissionShape

package/typings/classes/PhysicsDirectSpaceState2DExtension.d.ts

@@ -5,11 +5,11 @@
  * Provides virtual methods that can be overridden to create custom {@link PhysicsDirectSpaceState2D} implementations.
  */
 declare class PhysicsDirectSpaceState2DExtension extends PhysicsDirectSpaceState2D {
-  _cast_motion(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, closest_safe: float, closest_unsafe: float): boolean;
-  _collide_shape(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, results: void, max_results: int, result_count: int): boolean;
-  _intersect_point(position: Vector2 | Vector2i, canvas_instance_id: int, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, results: unknown, max_results: int): int;
-  _intersect_ray(from_: Vector2 | Vector2i, to: Vector2 | Vector2i, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, hit_from_inside: boolean, result: unknown): boolean;
-  _intersect_shape(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, result: unknown, max_results: int): int;
-  _rest_info(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, rest_info: unknown): boolean;
+  _cast_motion(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, r_closest_safe: float, r_closest_unsafe: float): boolean;
+  _collide_shape(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, r_results: void, max_results: int, r_result_count: int): boolean;
+  _intersect_point(position: Vector2 | Vector2i, canvas_instance_id: int, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, r_results: unknown, max_results: int): int;
+  _intersect_ray(from_: Vector2 | Vector2i, to: Vector2 | Vector2i, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, hit_from_inside: boolean, r_result: unknown): boolean;
+  _intersect_shape(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, r_result: unknown, max_results: int): int;
+  _rest_info(shape_rid: RID, transform: Transform2D, motion: Vector2 | Vector2i, margin: float, collision_mask: int, collide_with_bodies: boolean, collide_with_areas: boolean, r_rest_info: unknown): boolean;
   is_body_excluded_from_query(body: RID): boolean;
 }