typescript-to-gdscript 0.1.0 → 0.1.2

package/typings/classes/SpriteFrames.d.ts

@@ -17,10 +17,10 @@ declare class SpriteFrames extends Resource {
    * Duplicates the animation `anim_from` to a new animation named `anim_to`. Fails if `anim_to` already exists, or if `anim_from` does not exist.
    */
   duplicate_animation(anim_from: string, anim_to: string): void;
-  /**
-   * Returns `true` if the given animation is configured to loop when it finishes playing. Otherwise, returns `false`.
-   */
+  /** Returns `true` if `get_animation_loop_mode(anim) == LOOP_LINEAR`. Otherwise, returns `false`. */
   get_animation_loop(anim: string): boolean;
+  /** Returns the loop mode for the `anim` animation. */
+  get_animation_loop_mode(anim: string): int;
   /**
    * Returns an array containing the names associated to each animation. Values are placed in alphabetical order.
    */
@@ -45,13 +45,29 @@ declare class SpriteFrames extends Resource {
   /** Changes the `anim` animation's name to `newname`. */
   rename_animation(anim: string, newname: string): void;
   /**
-   * If `loop` is `true`, the `anim` animation will loop when it reaches the end, or the start if it is played in reverse.
+   * If `loop` is `false` equivalent to `set_animation_loop_mode(LOOP_NONE)`.
+   * If `loop` is `true` equivalent to `set_animation_loop_mode(LOOP_LINEAR)`.
    */
   set_animation_loop(anim: string, loop: boolean): void;
+  /** Sets the `loop_mode` for the `anim` animation. */
+  set_animation_loop_mode(anim: string, loop_mode: int): void;
   /** Sets the speed for the `anim` animation in frames per second. */
   set_animation_speed(anim: string, fps: float): void;
   /**
    * Sets the `texture` and the `duration` of the frame `idx` in the `anim` animation. `duration` specifies the relative duration, see {@link get_frame_duration} for details.
    */
   set_frame(anim: string, idx: int, texture: Texture2D, duration?: float): void;
+
+  // enum LoopMode
+  /** The animation plays once and stops when it reaches the end, or the start if played in reverse. */
+  static readonly LOOP_NONE: int;
+  /**
+   * The animation restarts from the beginning when it reaches the end, or from the end if played in reverse, repeating continuously.
+   */
+  static readonly LOOP_LINEAR: int;
+  /**
+   * The animation alternates direction each time it reaches the end or start, playing forward and then in reverse repeatedly.
+   * **Note:** Both {@link AnimatedSprite2D} and {@link AnimatedSprite3D} play the first/last frame for its duration only once at each end of the animation loop (instead of twice, once per forward/backward animation direction).
+   */
+  static readonly LOOP_PINGPONG: int;
 }

package/typings/classes/StreamPeerExtension.d.ts

@@ -5,6 +5,6 @@ declare class StreamPeerExtension extends StreamPeer {
   _get_available_bytes(): int;
   _get_data(r_buffer: int, r_bytes: int, r_received: int): int;
   _get_partial_data(r_buffer: int, r_bytes: int, r_received: int): int;
-  _put_data(p_data: int, p_bytes: int, r_sent: int): int;
-  _put_partial_data(p_data: int, p_bytes: int, r_sent: int): int;
+  _put_data(data: int, bytes: int, r_sent: int): int;
+  _put_partial_data(data: int, bytes: int, r_sent: int): int;
 }

package/typings/classes/TabBar.d.ts

@@ -40,6 +40,26 @@ declare class TabBar extends Control {
   tab_close_display_policy: int;
   /** The number of tabs currently in the bar. */
   tab_count: int;
+  /**
+   * If `true`, the tab at `index` is disabled.
+   * **Note:** `index` is a value in the `0 .. tab_count - 1` range.
+   */
+  'tab_{index}/disabled': boolean;
+  /**
+   * If `true`, the tab at `index` is hidden.
+   * **Note:** `index` is a value in the `0 .. tab_count - 1` range.
+   */
+  'tab_{index}/icon': Texture2D | null;
+  /**
+   * The title text of the tab at `index`.
+   * **Note:** `index` is a value in the `0 .. tab_count - 1` range.
+   */
+  'tab_{index}/title': string;
+  /**
+   * The tooltip text of the tab at `index`.
+   * **Note:** `index` is a value in the `0 .. tab_count - 1` range.
+   */
+  'tab_{index}/tooltip': string;
   /**
    * {@link TabBar}s with the same rearrange group ID will allow dragging the tabs between them. Enable drag with {@link drag_to_rearrange_enabled}.
    * Setting this to `-1` will disable rearranging between {@link TabBar}s.

package/typings/classes/TabContainer.d.ts

@@ -3,9 +3,7 @@
 
 /** A container that creates a tab for each child control, displaying only the active tab's control. */
 declare class TabContainer extends Container {
-  /**
-   * If `true`, all tabs are drawn in front of the panel. If `false`, inactive tabs are drawn behind the panel.
-   */
+  /** This doesn't do anything. */
   all_tabs_in_front: boolean;
   /**
    * If `true`, tabs overflowing this node's width will be hidden, displaying two navigation buttons instead. Otherwise, this node's minimum size is updated so that all tabs are visible.
@@ -31,6 +29,26 @@ declare class TabContainer extends Container {
   tab_alignment: int;
   /** The focus access mode for the internal {@link TabBar} node. */
   tab_focus_mode: int;
+  /**
+   * If `true`, the tab at `index` is disabled.
+   * **Note:** `index` is a value in the `0 .. get_tab_count() - 1` range.
+   */
+  'tab_{index}/disabled': boolean;
+  /**
+   * If `true`, the tab at `index` is hidden.
+   * **Note:** `index` is a value in the `0 .. get_tab_count() - 1` range.
+   */
+  'tab_{index}/hidden': boolean;
+  /**
+   * The title text of the tab at `index`.
+   * **Note:** `index` is a value in the `0 .. get_tab_count() - 1` range.
+   */
+  'tab_{index}/icon': Texture2D | null;
+  /**
+   * The tooltip text of the tab at `index`.
+   * **Note:** `index` is a value in the `0 .. get_tab_count() - 1` range.
+   */
+  'tab_{index}/title': string;
   /** The horizontal alignment of the tabs. */
   tabs_position: int;
   /**

package/typings/classes/TextEdit.d.ts

@@ -85,11 +85,11 @@ declare class TextEdit extends Control {
    */
   mouse_default_cursor_shape: int;
   /**
-   * If `true`, {@link TextEdit} will disable vertical scroll and fit minimum height to the number of visible lines. When both this property and {@link scroll_fit_content_width} are `true`, no scrollbars will be displayed.
+   * If `true`, {@link TextEdit} fits its minimum height to the number of visible lines instead of scrolling vertically. If a maximum height is set (for example via {@link Control.custom_maximum_size}) and content exceeds it, a vertical scrollbar is shown.
    */
   scroll_fit_content_height: boolean;
   /**
-   * If `true`, {@link TextEdit} will disable horizontal scroll and fit minimum width to the widest line in the text. When both this property and {@link scroll_fit_content_height} are `true`, no scrollbars will be displayed.
+   * If `true`, {@link TextEdit} fits its minimum width to the widest line instead of scrolling horizontally. If a maximum width is set (for example via {@link Control.custom_maximum_size}) and content exceeds it, a horizontal scrollbar is shown.
    */
   scroll_fit_content_width: boolean;
   /** If there is a horizontal scrollbar, this determines the current horizontal scroll value in pixels. */

package/typings/classes/TextServer.d.ts

@@ -148,6 +148,20 @@ declare class TextServer extends RefCounted {
    * Returns oversampling factor override. If set to a positive value, overrides the oversampling factor of the viewport this font is used in. See {@link Viewport.oversampling}. This value doesn't override the [code skip-lint]oversampling[/code] parameter of [code skip-lint]draw_*[/code] methods. Used by dynamic fonts only.
    */
   font_get_oversampling(font_rid: RID): float;
+  /**
+   * Returns the array in the predefined color palette at `index`. Palette contains all colors used to render font glyphs. Each palette has the same number of colors. Colors can be overridden using {@link font_set_palette_custom_colors}.
+   */
+  font_get_palette_colors(font_rid: RID, index: int): PackedColorArray;
+  /**
+   * Returns the number of predefined color palettes. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
+   */
+  font_get_palette_count(font_rid: RID): int;
+  /** Returns array of custom colors to override predefined palette. */
+  font_get_palette_custom_colors(font_rid: RID): PackedColorArray;
+  /**
+   * Returns the name of the predefined color palette at `index`. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
+   */
+  font_get_palette_name(font_rid: RID, index: int): string;
   /** Returns scaling factor of the color bitmap font. */
   font_get_scale(font_rid: RID, size: int): float;
   /** Returns `true` if support override is enabled for the `script`. */
@@ -190,6 +204,8 @@ declare class TextServer extends RefCounted {
   font_get_underline_position(font_rid: RID, size: int): float;
   /** Returns thickness of the underline in pixels. */
   font_get_underline_thickness(font_rid: RID, size: int): float;
+  /** Returns used palette index. */
+  font_get_used_palette(font_rid: RID): int;
   /**
    * Returns variation coordinates for the specified font cache entry. See {@link font_supported_variation_list} for more info.
    */
@@ -302,7 +318,7 @@ declare class TextServer extends RefCounted {
   /**
    * If set to `true`, color modulation is applied when drawing colored glyphs, otherwise it's applied to the monochrome glyphs only.
    */
-  font_set_modulate_color_glyphs(font_rid: RID, force_autohinter: boolean): void;
+  font_set_modulate_color_glyphs(font_rid: RID, modulate: boolean): void;
   /**
    * Sets the width of the range around the shape between the minimum and maximum representable signed distance.
    */
@@ -322,6 +338,10 @@ declare class TextServer extends RefCounted {
    * If set to a positive value, overrides the oversampling factor of the viewport this font is used in. See {@link Viewport.oversampling}. This value doesn't override the [code skip-lint]oversampling[/code] parameter of [code skip-lint]draw_*[/code] methods. Used by dynamic fonts only.
    */
   font_set_oversampling(font_rid: RID, oversampling: float): void;
+  /**
+   * Sets array of custom colors to override predefined palette. Set to empty array to reset overrides. Use `Color(0, 0, 0, 0)`, to keep predefined palette color at specific position.
+   */
+  font_set_palette_custom_colors(font_rid: RID, colors: PackedColorArray | Array<unknown>): void;
   /** Sets scaling factor of the color bitmap font. */
   font_set_scale(font_rid: RID, size: int, scale: float): void;
   /** Adds override for {@link font_is_script_supported}. */
@@ -355,6 +375,8 @@ declare class TextServer extends RefCounted {
   font_set_underline_position(font_rid: RID, size: int, underline_position: float): void;
   /** Sets thickness of the underline in pixels. */
   font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float): void;
+  /** Sets used palette index. */
+  font_set_used_palette(font_rid: RID, index: int): void;
   /**
    * Sets variation coordinates for the specified font cache entry. See {@link font_supported_variation_list} for more info.
    */

package/typings/classes/TextServerExtension.d.ts

@@ -112,6 +112,20 @@ declare class TextServerExtension extends TextServer {
    * Returns oversampling factor override. If set to a positive value, overrides the oversampling factor of the viewport this font is used in. See {@link Viewport.oversampling}. This value doesn't override the [code skip-lint]oversampling[/code] parameter of [code skip-lint]draw_*[/code] methods. Used by dynamic fonts only.
    */
   _font_get_oversampling(font_rid: RID): float;
+  /**
+   * Returns the array in the predefined color palette at `index`. Palette contains all colors used to render font glyphs. Each palette has the same number of colors. Colors can be overridden using {@link _font_set_palette_custom_colors}.
+   */
+  _font_get_palette_colors(font_rid: RID, index: int): PackedColorArray;
+  /**
+   * Returns the number of predefined color palettes. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
+   */
+  _font_get_palette_count(font_rid: RID): int;
+  /** Returns array of custom colors to override predefined palette. */
+  _font_get_palette_custom_colors(font_rid: RID): PackedColorArray;
+  /**
+   * Returns the name of the predefined color palette at `index`. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
+   */
+  _font_get_palette_name(font_rid: RID, index: int): string;
   /** Returns scaling factor of the color bitmap font. */
   _font_get_scale(font_rid: RID, size: int): float;
   /** Returns `true` if support override is enabled for the `script`. */
@@ -154,6 +168,8 @@ declare class TextServerExtension extends TextServer {
   _font_get_underline_position(font_rid: RID, size: int): float;
   /** Returns thickness of the underline in pixels. */
   _font_get_underline_thickness(font_rid: RID, size: int): float;
+  /** Returns used palette index. */
+  _font_get_used_palette(font_rid: RID): int;
   /** Returns variation coordinates for the specified font cache entry. */
   _font_get_variation_coordinates(font_rid: RID): Dictionary;
   /**
@@ -272,6 +288,10 @@ declare class TextServerExtension extends TextServer {
    * If set to a positive value, overrides the oversampling factor of the viewport this font is used in. See {@link Viewport.oversampling}. This value doesn't override the [code skip-lint]oversampling[/code] parameter of [code skip-lint]draw_*[/code] methods. Used by dynamic fonts only.
    */
   _font_set_oversampling(font_rid: RID, oversampling: float): void;
+  /**
+   * Sets array of custom colors to override predefined palette. Set to empty array to reset overrides. Use `Color(0, 0, 0, 0)`, to keep predefined palette color at specific position.
+   */
+  _font_set_palette_custom_colors(font_rid: RID, colors: PackedColorArray | Array<unknown>): void;
   /** Sets scaling factor of the color bitmap font. */
   _font_set_scale(font_rid: RID, size: int, scale: float): void;
   /** Adds override for {@link _font_is_script_supported}. */
@@ -298,6 +318,8 @@ declare class TextServerExtension extends TextServer {
   _font_set_underline_position(font_rid: RID, size: int, underline_position: float): void;
   /** Sets thickness of the underline in pixels. */
   _font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float): void;
+  /** Sets used palette index. */
+  _font_set_used_palette(font_rid: RID, index: int): void;
   /** Sets variation coordinates for the specified font cache entry. */
   _font_set_variation_coordinates(font_rid: RID, variation_coordinates: Dictionary): void;
   /**
@@ -426,7 +448,7 @@ declare class TextServerExtension extends TextServer {
   /**
    * Returns shapes of the carets corresponding to the character offset `position` in the text. Returned caret shape is 1 pixel wide rectangle.
    */
-  _shaped_text_get_carets(shaped: RID, position: int, caret: unknown): void;
+  _shaped_text_get_carets(shaped: RID, position: int, r_caret: unknown): void;
   /** Returns array of the composite character boundaries. */
   _shaped_text_get_character_breaks(shaped: RID): PackedInt32Array;
   /** Returns ellipsis character used for text clipping. */

package/typings/classes/TileSet.d.ts

@@ -70,6 +70,8 @@ declare class TileSet extends Resource {
   add_terrain_set(to_position?: int): void;
   /** Clears tile proxies pointing to invalid tiles. */
   cleanup_invalid_tile_proxies(): void;
+  /** Clears all terrain properties for the given terrain set. */
+  clear_terrains(terrain_set: int): void;
   /** Clears all tile proxies. */
   clear_tile_proxies(): void;
   /**
@@ -218,7 +220,7 @@ declare class TileSet extends Resource {
    * Creates a coordinates-level proxy for the given identifiers. A proxy will map set of tile identifiers to another set of identifiers. The alternative tile ID is kept the same when using coordinates-level proxies.
    * Proxied tiles can be automatically replaced in TileMapLayer nodes using the editor.
    */
-  set_coords_level_tile_proxy(p_source_from: int, coords_from: Vector2i | Vector2, source_to: int, coords_to: Vector2i | Vector2): void;
+  set_coords_level_tile_proxy(source_from: int, coords_from: Vector2i | Vector2, source_to: int, coords_to: Vector2i | Vector2): void;
   /**
    * Sets the name of the custom data layer identified by the given index. Names are identifiers of the layer therefore if the name is already taken it will fail and raise an error.
    */

package/typings/classes/Tree.d.ts

@@ -132,14 +132,23 @@ declare class Tree extends Control {
   get_column_title_tooltip_text(column: int): string;
   /** Returns the column's width in pixels. */
   get_column_width(column: int): int;
+  /**
+   * Returns the internal canvas item designated for custom drawing. See {@link TreeItem.set_custom_draw_callback}.
+   * **Note:** This canvas item clears automatically on each Tree draw call.
+   */
+  get_custom_drawing_canvas_item(): RID;
   /**
    * Returns the rectangle for custom popups. Helper to create custom cell controls that display a popup. See {@link TreeItem.set_cell_mode}.
    */
   get_custom_popup_rect(): Rect2;
   /**
-   * Returns the drop section at `position`, or -100 if no item is there.
-   * Values -1, 0, or 1 will be returned for the "above item", "on item", and "below item" drop sections, respectively. See {@link DropModeFlags} for a description of each drop section.
-   * To get the item which the returned drop section is relative to, use {@link get_item_at_position}.
+   * Returns the drop section at `position`, as permitted by enabled {@link DropModeFlags}.
+   * - `-1` if the position is **above** the item. Typically used to insert as the item's previous sibling.
+   * - `0` if the position is **on** the item. Typically used to insert as the item's last child.
+   * - `1` if the position is **below** the item, when the item has no children. Typically used to insert as the item's next sibling. If the item *does* have children, this section is still reachable by hovering to the left of the item's collapse arrow, and below.
+   * - `2` if the position is **below** the item, when the item has children. Typically used to insert as the item's first child.
+   * - `-100` if the position is not over any item, or no {@link DropModeFlags} are set.
+   * See {@link DropModeFlags} for a description of each drop region. To get the item which the returned drop section refers to, use {@link get_item_at_position}.
    */
   get_drop_section_at_position(position: Vector2 | Vector2i): int;
   /**
@@ -272,18 +281,18 @@ declare class Tree extends Control {
   static readonly SELECT_MULTI: int;
   // enum DropModeFlags
   /**
-   * Disables all drop sections, but still allows to detect the "on item" drop section by {@link get_drop_section_at_position}.
+   * Disables all drop sections.
    * **Note:** This is the default flag, it has no effect when combined with other flags.
    */
   static readonly DROP_MODE_DISABLED: int;
   /**
    * Enables the "on item" drop section. This drop section covers the entire item.
-   * When combined with {@link DROP_MODE_INBETWEEN}, this drop section halves the height and stays centered vertically.
+   * When combined with {@link DROP_MODE_INBETWEEN}, this drop section halves in height and stays centered vertically.
    */
   static readonly DROP_MODE_ON_ITEM: int;
   /**
-   * Enables "above item" and "below item" drop sections. The "above item" drop section covers the top half of the item, and the "below item" drop section covers the bottom half.
-   * When combined with {@link DROP_MODE_ON_ITEM}, these drop sections halves the height and stays on top / bottom accordingly.
+   * Enables "above item" and "below item" drop sections. The "above item" drop section covers the top half of the item, while the "below item" drop section covers the bottom half, and extends downward to the left of any children.
+   * When combined with {@link DROP_MODE_ON_ITEM}, these drop sections halve in height and stay at the top and bottom respectively.
    */
   static readonly DROP_MODE_INBETWEEN: int;
   // enum ScrollHintMode

package/typings/classes/TreeItem.d.ts

@@ -175,6 +175,8 @@ declare class TreeItem extends GodotObject {
   get_tooltip_text(column: int): string;
   /** Returns the {@link Tree} that owns this TreeItem. */
   get_tree(): Tree | null;
+  /** Returns `true` if this {@link TreeItem} is allowed to accept children. */
+  is_accepting_children(): boolean;
   /**
    * Returns `true` if this {@link TreeItem}, or any of its descendants, is collapsed.
    * If `only_visible` is `true` it ignores non-visible {@link TreeItem}s.
@@ -217,8 +219,12 @@ declare class TreeItem extends GodotObject {
    * **Note:** If you want to move a child from one {@link Tree} to another, then instead of removing and adding it manually you can use {@link move_before} or {@link move_after}.
    */
   remove_child(child: TreeItem): void;
-  /** Selects the given `column`. */
-  select(column: int): void;
+  /**
+   * Selects the given `column`. If `set_as_cursor` is `true`, the {@link Tree}'s cursor will be moved to this item (only matters if {@link Tree.select_mode} is set to {@link Tree.SELECT_MULTI}).
+   */
+  select(column: int, set_as_cursor?: boolean): void;
+  /** Sets {@link TreeItem}'s ability to accept children. */
+  set_accept_children(allowed: boolean): void;
   /**
    * Sets the given column's auto translate mode to `mode`.
    * All columns use {@link Node.AUTO_TRANSLATE_MODE_INHERIT} by default, which uses the same auto translate mode as the {@link Tree} itself.
@@ -265,6 +271,7 @@ declare class TreeItem extends GodotObject {
   /**
    * Sets the given column's custom draw callback. Use an empty {@link Callable} ([code skip-lint]Callable()[/code]) to clear the custom callback. The cell has to be in {@link CELL_MODE_CUSTOM} to use this feature.
    * The `callback` should accept two arguments: the {@link TreeItem} that is drawn and its position and size as a {@link Rect2}.
+   * To draw custom content over the native style, please use {@link Tree.get_custom_drawing_canvas_item}.
    */
   set_custom_draw_callback(column: int, callback: Callable): void;
   /** Sets custom font used to draw text in the given `column`. */

package/typings/classes/UndoRedo.d.ts

@@ -68,13 +68,13 @@ declare class UndoRedo extends GodotObject {
    * Returns `true` if the {@link UndoRedo} is currently committing the action, i.e. running its "do" method or property change (see {@link commit_action}).
    */
   is_committing_action(): boolean;
-  /** Redo the last action. */
+  /** Redo the last action. Returns `false` if there was no action to redo. */
   redo(): boolean;
   /**
    * Marks the next "do" and "undo" operations to be processed even if the action gets merged with another in the {@link MERGE_ENDS} mode. Return to normal operation using {@link end_force_keep_in_merge_ends}.
    */
   start_force_keep_in_merge_ends(): void;
-  /** Undo the last action. */
+  /** Undo the last action. Returns `false` if there was no action to undo. */
   undo(): boolean;
 
   /** Called when {@link undo} or {@link redo} was called. */

package/typings/classes/Vector2.d.ts

@@ -74,11 +74,13 @@ declare interface Vector2 {
    */
   direction_to(to: Vector2 | Vector2i): Vector2;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector2 | Vector2i): float;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector2 | Vector2i): float;
   /**
    * Returns the dot product of this vector and `with`. This can be used to compare the angle between two vectors. For example, this can be used to determine whether an enemy is facing the player.

package/typings/classes/Vector2i.d.ts

@@ -21,11 +21,13 @@ declare interface Vector2i {
    */
   clampi(min: int, max: int): Vector2i;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector2i | Vector2): int;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector2i | Vector2): float;
   /** Returns the length (magnitude) of this vector. */
   length(): float;

package/typings/classes/Vector3.d.ts

@@ -56,11 +56,13 @@ declare interface Vector3 {
    */
   direction_to(to: Vector3 | Vector3i): Vector3;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector3 | Vector3i): float;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector3 | Vector3i): float;
   /**
    * Returns the dot product of this vector and `with`. This can be used to compare the angle between two vectors. For example, this can be used to determine whether an enemy is facing the player.

package/typings/classes/Vector3i.d.ts

@@ -21,11 +21,13 @@ declare interface Vector3i {
    */
   clampi(min: int, max: int): Vector3i;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector3i | Vector3): int;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector3i | Vector3): float;
   /** Returns the length (magnitude) of this vector. */
   length(): float;

package/typings/classes/Vector4.d.ts

@@ -38,11 +38,13 @@ declare interface Vector4 {
    */
   direction_to(to: Vector4 | Vector4i): Vector4;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector4 | Vector4i): float;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector4 | Vector4i): float;
   /** Returns the dot product of this vector and `with`. */
   dot(with_: Vector4 | Vector4i): float;

package/typings/classes/Vector4i.d.ts

@@ -23,11 +23,13 @@ declare interface Vector4i {
    */
   clampi(min: int, max: int): Vector4i;
   /**
-   * Returns the squared distance between this vector and `to`.
+   * Returns the squared Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
    * This method runs faster than {@link distance_to}, so prefer it if you need to compare vectors or need the squared distance for some formula.
    */
   distance_squared_to(to: Vector4i | Vector4): int;
-  /** Returns the distance between this vector and `to`. */
+  /**
+   * Returns the Euclidean distance (https://en.wikipedia.org/wiki/Euclidean_distance) between this vector and `to`.
+   */
   distance_to(to: Vector4i | Vector4): float;
   /** Returns the length (magnitude) of this vector. */
   length(): float;

package/typings/classes/Viewport.d.ts

@@ -152,8 +152,9 @@ declare class Viewport extends Node {
   /**
    * Affects the final texture sharpness by reading from a lower or higher mipmap (also called "texture LOD bias"). Negative values make mipmapped textures sharper but grainier when viewed at a distance, while positive values make mipmapped textures blurrier (even when up close).
    * Enabling temporal antialiasing ({@link use_taa}) will automatically apply a `-0.5` offset to this value, while enabling FXAA ({@link screen_space_aa}) will automatically apply a `-0.25` offset to this value. If both TAA and FXAA are enabled at the same time, an offset of `-0.75` is applied to this value.
-   * **Note:** If {@link scaling_3d_scale} is lower than `1.0` (exclusive), {@link texture_mipmap_bias} is used to adjust the automatic mipmap bias which is calculated internally based on the scale factor. The formula for this is `log2(scaling_3d_scale) + mipmap_bias`.
    * To control this property on the root viewport, set the {@link ProjectSettings.rendering/textures/default_filters/texture_mipmap_bias} project setting.
+   * **Note:** If {@link scaling_3d_scale} is lower than `1.0` (exclusive), {@link texture_mipmap_bias} is used to adjust the automatic mipmap bias which is calculated internally based on the scale factor. The formula for this is `log2(scaling_3d_scale) + mipmap_bias`.
+   * **Note:** This property is only supported in the Forward+ and Mobile renderers, not Compatibility. In Compatibility, this property is always treated as if it was set to `0.0`.
    */
   texture_mipmap_bias: float;
   /**
@@ -531,6 +532,11 @@ declare class Viewport extends Node {
    * **Note:** Only supported when the Metal rendering driver is in use, which limits this scaling mode to macOS and iOS.
    */
   static readonly SCALING_3D_MODE_METALFX_TEMPORAL: int;
+  /**
+   * Use nearest-neighbor filtering for the viewport's 3D buffer. This looks crisper than {@link SCALING_3D_MODE_BILINEAR} and has no additional rendering cost. The amount of scaling can be set using {@link scaling_3d_scale}. Values greater than `1.0` are not supported and bilinear downsampling will be used instead. A value of `1.0` disables scaling.
+   * **Note:** When using the **Nearest** scaling mode, to avoid uneven pixel scaling, it's highly recommended to use a value equal to an integer divisor with a dividend of `1`. For example, it's best to use a scale of `0.5` (1/2), `0.3333` (1/3), `0.25` (1/4), `0.2` (1/5), and so on.
+   */
+  static readonly SCALING_3D_MODE_NEAREST: int;
   /** Represents the size of the {@link Scaling3DMode} enum. */
   static readonly SCALING_3D_MODE_MAX: int;
   // enum MSAA
@@ -728,6 +734,16 @@ declare class Viewport extends Node {
    * **Note:** Only supported when using the Forward+ or Mobile rendering methods.
    */
   static readonly DEBUG_DRAW_INTERNAL_BUFFER: int;
+  /**
+   * Draws the cluster used by {@link AreaLight3D} nodes to optimize light rendering.
+   * **Note:** Only supported when using the Forward+ rendering method.
+   */
+  static readonly DEBUG_DRAW_CLUSTER_AREA_LIGHTS: int;
+  /**
+   * Draws the atlas used by {@link AreaLight3D} nodes in the upper left quadrant of the {@link Viewport}.
+   * **Note:** Only supported when using the Forward+ or Mobile rendering method.
+   */
+  static readonly DEBUG_DRAW_AREA_LIGHT_ATLAS: int;
   // enum DefaultCanvasItemTextureFilter
   /**
    * The texture filter reads from the nearest pixel only. This makes the texture look pixelated from up close, and grainy from a distance (due to mipmaps not being sampled).

package/typings/classes/Window.d.ts

@@ -288,8 +288,8 @@ declare class Window extends Viewport {
   /** Returns layout direction and text writing direction. */
   get_layout_direction(): int;
   /**
-   * Returns the maximum value for linear color components that can be displayed in this window, regardless of SDR or HDR output. Returns `1.0` if HDR is not enabled or not supported. This value is used by tonemapping and other {@link Environment} effects to ensure that bright colors are presented in the range that can be displayed by this window.
-   * When using the Linear tonemapper without {@link Environment} effects or no {@link WorldEnvironment}, use the returned value to scale content to maximize the screen's brightness, such as for lasers or other bright effects. The following is an example that produces the brightest purple color that the screen can produce:
+   * Returns the maximum value for linear color components that can be displayed in this window, regardless of SDR or HDR output. Returns `1.0` if HDR is not enabled or not supported. The {@link output_max_linear_value_changed} signal will be emitted whenever this value changes.
+   * This value is used by tonemapping and other {@link Environment} effects to ensure that bright colors are presented in the range that can be displayed by this window. When using this maximum linear value in your project, it should only be used to present colors directly to the screen without tonemapping and without influencing lighting, post-processing effects, or surrounding color. The following is an example that produces the brightest purple color that the screen can produce:
    * **Note:** You will need to convert sRGB colors to linear before multiplying by this value to get correct results.
    */
   get_output_max_linear_value(): float;
@@ -593,6 +593,10 @@ declare class Window extends Viewport {
    * Emitted when the mouse event is received by the custom decoration area defined by {@link nonclient_area}, and normal input to the window is blocked (such as when it has an exclusive child opened). `event`'s position is in the embedder's coordinate system.
    */
   nonclient_window_input: Signal<[InputEvent]>;
+  /**
+   * Emitted 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. `output_max_linear_value` is the new value.
+   */
+  output_max_linear_value_changed: Signal<[float]>;
   /** Emitted when the {@link NOTIFICATION_THEME_CHANGED} notification is sent. */
   theme_changed: Signal<[]>;
   /** Emitted when window title bar text is changed. */
@@ -644,39 +648,45 @@ declare class Window extends Viewport {
   // enum Flags
   /**
    * The window can't be resized by dragging its resize grip. It's still possible to resize the window using {@link size}. This flag is ignored for full screen windows. Set with {@link unresizable}.
+   * **Note:** This flag is implemented on Linux (X11), macOS, Windows, and embedded windows.
    */
   static readonly FLAG_RESIZE_DISABLED: int;
   /**
    * The window do not have native title bar and other decorations. This flag is ignored for full-screen windows. Set with {@link borderless}.
+   * **Note:** This flag is implemented on Linux (X11/Wayland), macOS, Windows, and embedded windows.
    */
   static readonly FLAG_BORDERLESS: int;
   /**
    * The window is floating on top of all other windows. This flag is ignored for full-screen windows. Set with {@link always_on_top}.
+   * **Note:** This flag is implemented on Linux (X11), macOS, Windows, and embedded windows.
    */
   static readonly FLAG_ALWAYS_ON_TOP: int;
   /**
    * The window background can be transparent. Set with {@link transparent}.
    * **Note:** This flag has no effect if either {@link ProjectSettings.display/window/per_pixel_transparency/allowed}, or the window's {@link Viewport.transparent_bg} is set to `false`.
+   * **Note:** Transparency support is implemented on Linux (X11/Wayland), macOS, Windows, and embedded windows.
    */
   static readonly FLAG_TRANSPARENT: int;
   /**
    * The window can't be focused. No-focus window will ignore all input, except mouse clicks. Set with {@link unfocusable}.
+   * **Note:** This flag is implemented on Linux (X11), macOS, Windows, and embedded windows.
    */
   static readonly FLAG_NO_FOCUS: int;
   /**
    * Window is part of menu or {@link OptionButton} dropdown. This flag can't be changed when the window is visible. An active popup window will exclusively receive all input, without stealing focus from its parent. Popup windows are automatically closed when uses click outside it, or when an application is switched. Popup window must have transient parent set (see {@link transient}).
-   * **Note:** This flag has no effect in embedded windows (unless said window is a {@link Popup}).
+   * **Note:** This flag is implemented on Linux (X11/Wayland), macOS, Windows, and embedded {@link Popup} windows.
    */
   static readonly FLAG_POPUP: int;
   /**
    * Window content is expanded to the full size of the window. Unlike borderless window, the frame is left intact and can be used to resize the window, title bar is transparent, but have minimize/maximize/close buttons. Set with {@link extend_to_title}.
-   * **Note:** This flag is implemented only on macOS.
    * **Note:** This flag has no effect in embedded windows.
+   * **Note:** This flag is implemented only on macOS.
    */
   static readonly FLAG_EXTEND_TO_TITLE: int;
   /**
    * All mouse events are passed to the underlying window of the same application.
    * **Note:** This flag has no effect in embedded windows.
+   * **Note:** This flag is implemented on Linux (X11), macOS, Windows.
    */
   static readonly FLAG_MOUSE_PASSTHROUGH: int;
   /**
@@ -694,16 +704,20 @@ declare class Window extends Viewport {
   static readonly FLAG_EXCLUDE_FROM_CAPTURE: int;
   /**
    * Signals the window manager that this window is supposed to be an implementation-defined "popup" (usually a floating, borderless, untileable and immovable child window).
+   * **Note:** This flag has no effect in embedded windows.
+   * **Note:** This flag is implemented on Linux (Wayland).
    */
   static readonly FLAG_POPUP_WM_HINT: int;
   /**
    * Window minimize button is disabled.
-   * **Note:** This flag is implemented on macOS and Windows.
+   * **Note:** This flag has no effect in embedded windows.
+   * **Note:** This flag is implemented on Linux (X11), macOS, and Windows.
    */
   static readonly FLAG_MINIMIZE_DISABLED: int;
   /**
    * Window maximize button is disabled.
-   * **Note:** This flag is implemented on macOS and Windows.
+   * **Note:** This flag has no effect in embedded windows.
+   * **Note:** This flag is implemented on Linux (X11), macOS, and Windows.
    */
   static readonly FLAG_MAXIMIZE_DISABLED: int;
   /** Max value of the {@link Flags}. */