@minecraft/server-editor 0.1.0-beta.1.21.2-stable → 0.1.0-beta.1.21.20-preview.22

package/index.d.ts

@@ -14,7 +14,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server-editor",
- *   "version": "0.1.0-beta.1.21.2-stable"
+ *   "version": "0.1.0-beta"
  * }
  * ```
  *
@@ -36,6 +36,28 @@ export enum BlockPaletteItemType {
     Probability = 1,
 }
 
+export enum BrushPipelineOperationType {
+    Include = 0,
+    Exclude = 1,
+}
+
+/**
+ * The possible variants of a color picker.
+ */
+export declare enum ColorPickerVariant {
+    Default = 0,
+    Inline = 1,
+    Expanded = 2,
+}
+
+/**
+ * Predefined action bar items
+ */
+export declare enum CoreActionBarItemType {
+    Redo = 'editor:actionBarItem:redo',
+    Undo = 'editor:actionBarItem:undo',
+}
+
 /**
  * Predefined top level menus for core editor
  */
@@ -115,13 +137,21 @@ export enum CursorTargetMode {
     Face = 1,
 }
 
+export enum DaylightCycle {
+    Normal = 0,
+    AlwaysDay = 1,
+    LockTime = 2,
+}
+
 /**
  * Type of item that can be added to the property pane
  */
 export declare enum EDITOR_PANE_PROPERTY_ITEM_TYPE {
     Action = 'editorUI:Action',
+    BlockList = 'editorUI:BlockList',
     BlockPicker = 'editorUI:BlockPicker',
     Boolean = 'editorUI:Boolean',
+    ColorPicker = 'editorUI:ColorPicker',
     Divider = 'editorUI:Divider',
     Dropdown = 'editorUI:Dropdown',
     Image = 'editorUI:Image',
@@ -166,6 +196,11 @@ export declare enum EditorStatusBarAlignment {
     Left = 1,
 }
 
+export enum EntityOperationType {
+    Create = 0,
+    Delete = 1,
+}
+
 export enum ExportResult {
     ValidWorldExport = 0,
     LevelFetchFailed = 1,
@@ -177,6 +212,14 @@ export enum ExportResult {
     EditorSystemFailure = 7,
 }
 
+export enum GamePublishSetting {
+    NoMultiPlay = 0,
+    InviteOnly = 1,
+    FriendsOnly = 2,
+    FriendsOfFriends = 3,
+    Public = 4,
+}
+
 /**
  * Enumeration representing identifiers for graphics settings
  * properties.
@@ -207,116 +250,559 @@ export declare enum InputModifier {
  * Keyboard key
  */
 export declare enum KeyboardKey {
+    UNDEFINED = 0,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_BACK_SPACE
+     *
+     */
     BACKSPACE = 8,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_TAB
+     *
+     */
     TAB = 9,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_RETURN
+     *
+     */
     ENTER = 13,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_SHIFT
+     *
+     */
     SHIFT = 16,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_CONTROL
+     *
+     */
     CTRL = 17,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_ALT
+     *
+     */
     ALT = 18,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_CAPS_LOCK
+     *
+     */
     CAPS_LOCK = 20,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_ESCAPE
+     *
+     */
     ESCAPE = 27,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_SPACE
+     *
+     */
     SPACE = 32,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_PAGE_UP
+     *
+     */
     PAGE_UP = 33,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_PAGE_DOWN
+     *
+     */
     PAGE_DOWN = 34,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_END
+     *
+     */
     END = 35,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_HOME
+     *
+     */
     HOME = 36,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_LEFT
+     *
+     */
     LEFT = 37,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_UP
+     *
+     */
     UP = 38,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_RIGHT
+     *
+     */
     RIGHT = 39,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_DOWN
+     *
+     */
     DOWN = 40,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_PRINTSCREEN
+     *
+     */
     PRINT_SCREEN = 44,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_INSERT
+     *
+     */
     INSERT = 45,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_DELETE
+     *
+     */
     DELETE = 46,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_0
+     *
+     */
     KEY_0 = 48,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_1
+     *
+     */
     KEY_1 = 49,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_2
+     *
+     */
     KEY_2 = 50,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_3
+     *
+     */
     KEY_3 = 51,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_4
+     *
+     */
     KEY_4 = 52,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_5
+     *
+     */
     KEY_5 = 53,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_6
+     *
+     */
     KEY_6 = 54,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_7
+     *
+     */
     KEY_7 = 55,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_8
+     *
+     */
     KEY_8 = 56,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_9
+     *
+     */
     KEY_9 = 57,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_A
+     *
+     */
     KEY_A = 65,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_B
+     *
+     */
     KEY_B = 66,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_C
+     *
+     */
     KEY_C = 67,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_D
+     *
+     */
     KEY_D = 68,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_E
+     *
+     */
     KEY_E = 69,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F
+     *
+     */
     KEY_F = 70,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_G
+     *
+     */
     KEY_G = 71,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_H
+     *
+     */
     KEY_H = 72,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_I
+     *
+     */
     KEY_I = 73,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_J
+     *
+     */
     KEY_J = 74,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_K
+     *
+     */
     KEY_K = 75,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_L
+     *
+     */
     KEY_L = 76,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_M
+     *
+     */
     KEY_M = 77,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_N
+     *
+     */
     KEY_N = 78,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_O
+     *
+     */
     KEY_O = 79,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_P
+     *
+     */
     KEY_P = 80,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_Q
+     *
+     */
     KEY_Q = 81,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_R
+     *
+     */
     KEY_R = 82,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_S
+     *
+     */
     KEY_S = 83,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_T
+     *
+     */
     KEY_T = 84,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_U
+     *
+     */
     KEY_U = 85,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_V
+     *
+     */
     KEY_V = 86,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_W
+     *
+     */
     KEY_W = 87,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_X
+     *
+     */
     KEY_X = 88,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_Y
+     *
+     */
     KEY_Y = 89,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_Z
+     *
+     */
     KEY_Z = 90,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD0
+     *
+     */
     NUMPAD_0 = 96,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD1
+     *
+     */
     NUMPAD_1 = 97,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD2
+     *
+     */
     NUMPAD_2 = 98,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD3
+     *
+     */
     NUMPAD_3 = 99,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD4
+     *
+     */
     NUMPAD_4 = 100,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD5
+     *
+     */
     NUMPAD_5 = 101,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD6
+     *
+     */
     NUMPAD_6 = 102,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD7
+     *
+     */
     NUMPAD_7 = 103,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD8
+     *
+     */
     NUMPAD_8 = 104,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_NUMPAD9
+     *
+     */
     NUMPAD_9 = 105,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_MULTIPLY
+     *
+     */
     NUMPAD_MULTIPLY = 106,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_ADD
+     *
+     */
     NUMPAD_ADD = 107,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_SEPARATOR
+     *
+     */
     NUMPAD_SEPARATOR = 108,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_SUBTRACT
+     *
+     */
     NUMPAD_SUBTRACT = 109,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_DECIMAL
+     *
+     */
     NUMPAD_DECIMAL = 110,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_DIVIDE
+     *
+     */
     NUMPAD_DIVIDE = 111,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F1
+     *
+     */
     F1 = 112,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F2
+     *
+     */
     F2 = 113,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F3
+     *
+     */
     F3 = 114,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F4
+     *
+     */
     F4 = 115,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F5
+     *
+     */
     F5 = 116,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F6
+     *
+     */
     F6 = 117,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F7
+     *
+     */
     F7 = 118,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F8
+     *
+     */
     F8 = 119,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F9
+     *
+     */
     F9 = 120,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F10
+     *
+     */
     F10 = 121,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F11
+     *
+     */
     F11 = 122,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_F12
+     *
+     */
     F12 = 123,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_COMMA, ie. ','
+     *
+     */
     COMMA = 188,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_PERIOD, ie. '.'
+     *
+     */
     PERIOD = 190,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_SLASH, ie. '/'
+     *
+     */
     SLASH = 191,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_BACK_QUOTE, ie. '`'
+     *
+     */
     BACK_QUOTE = 192,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_OPEN_BRACKET, ie. '['
+     *
+     */
     BRACKET_OPEN = 219,
-    BACK_SLASH = 220,
-    BRACKET_CLOSE = 221,
-    QUOTE = 222,
-}
-
-/**
- * Keyboard Key Actions
- */
-export declare enum KeyInputType {
     /**
      * @remarks
-     * Button was pressed.
+     * KeyboardEvent.DOM_VK_BACK_SLASH, ie. '\'
+     *
+     */
+    BACK_SLASH = 220,
+    /**
+     * @remarks
+     * KeyboardEvent.DOM_VK_CLOSE_BRACKET, ie. ']'
      *
      */
-    Press = 1,
+    BRACKET_CLOSE = 221,
     /**
      * @remarks
-     * Button was released.
+     * KeyboardEvent.DOM_VK_BACK_QUOTE, ie. '"'
      *
      */
-    Release = 2,
+    QUOTE = 222,
 }
 
 /**
@@ -374,6 +860,13 @@ export declare enum MouseInputType {
     DragEnd = 7,
 }
 
+export enum PlayerPermissionLevel {
+    Visitor = 0,
+    Member = 1,
+    Operator = 2,
+    Custom = 3,
+}
+
 export enum PlaytestSessionResult {
     OK = 0,
     InvalidSessionHandle = 1,
@@ -459,6 +952,13 @@ export type IActionPropertyItem<T extends PropertyBag, Prop extends keyof T & st
     replaceBoundAction(action: RegisteredAction<NoArgsAction> | undefined): void;
 };
 
+/**
+ * A property item which supports BlockList properties
+ */
+export type IBlockListPropertyItem<T extends PropertyBag, Prop extends keyof T & string> = IPropertyItem<T, Prop> & {
+    updateBlockList(newBlockList: string[]): void;
+};
+
 /**
  * A property item which supports Dropdown properties
  */
@@ -488,6 +988,7 @@ export type IPlayerUISession<PerPlayerStorage = Record<string, never>> = {
     readonly actionManager: ActionManager;
     readonly inputManager: IGlobalInputManager;
     readonly menuBar: IMenuContainer;
+    readonly actionBar: IActionBar;
     readonly toolRail: IModalToolContainer;
     readonly log: IPlayerLogger;
     readonly extensionContext: ExtensionContext;
@@ -519,6 +1020,23 @@ export type IVector3PropertyItem<T extends PropertyBag, Prop extends keyof T & s
     }): void;
 };
 
+/**
+ * Keyboard binding properties.
+ */
+export type KeyBinding = {
+    key: KeyboardKey;
+    modifier?: InputModifier;
+};
+
+/**
+ * Additional information about key binding.
+ */
+export type KeyBindingInfo = {
+    uniqueId: string;
+    label?: string;
+    tooltip?: string;
+};
+
 /**
  * Modal tool lifecycle event payload
  */
@@ -699,17 +1217,52 @@ export class BlockPalette {
 
 export class BlockPaletteManager {
     private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    addOrReplacePalette(paletteId: string, palette: BlockPalette): void;
+    getPalette(paletteId: string): BlockPalette | undefined;
+    getPaletteIdList(): string[];
+    /**
+     * @throws This function can throw errors.
+     */
+    getPaletteItem(paletteId: string, index: number): IBlockPaletteItem;
+    getPrimaryPalette(): BlockPalette;
     /**
      * @throws This function can throw errors.
      */
     getSelectedBlockType(): minecraftserver.BlockType;
+    getSelectedItem(): IBlockPaletteItem;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    removePalette(paletteId: string): void;
     /**
      * @remarks
      * This function can't be called in read-only mode.
      *
      * @throws This function can throw errors.
      */
-    setSelectedBlockType(block: minecraftserver.BlockType): void;
+    setPaletteItem(paletteId: string, index: number, item: IBlockPaletteItem): void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    setPrimaryPalette(paletteId: string): void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    setSelectedItem(item: IBlockPaletteItem): void;
 }
 
 export class BrushShapeManager {
@@ -724,6 +1277,15 @@ export class BrushShapeManager {
      * @throws This function can throw errors.
      */
     activateBrushShape(name: string): minecraftserver.CompoundBlockVolume;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    getBrushVolume(
+        origin: minecraftserver.Vector3,
+        pipeline: BrushPipelineOperation[],
+    ): minecraftserver.CompoundBlockVolume | undefined;
     /**
      * @remarks
      * This function can't be called in read-only mode.
@@ -752,6 +1314,28 @@ export class BrushShapeManager {
     uiSettingValueChanged(elementName: string, newValue: boolean | number | string | minecraftserver.Vector3): boolean;
 }
 
+export class ClipboardChangeAfterEvent {
+    private constructor();
+    readonly isPrimary: boolean;
+    readonly itemId: string;
+}
+
+export class ClipboardChangeAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(callback: (arg: ClipboardChangeAfterEvent) => void): (arg: ClipboardChangeAfterEvent) => void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    unsubscribe(callback: (arg: ClipboardChangeAfterEvent) => void): void;
+}
+
 /**
  * A ClipboardItem is a handle to an object which represents a
  * set of blocks in a contained bounding area (most likely
@@ -966,6 +1550,27 @@ export class Cursor {
      * @throws This property can throw when used.
      */
     readonly isVisible: boolean;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    attachClipboardItem(item: ClipboardItem): void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    clearAttachment(): void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    getAttachmentProperties(): CursorAttachmentProperties;
     /**
      * @remarks
      * Get the world position of the 3D block cursor
@@ -988,8 +1593,7 @@ export class Cursor {
     /**
      * @remarks
      * Hide the 3D block cursor from view until the corresponding
-     * {@link @minecraft-server-editor.Cursor.show} function is
-     * called
+     * {@link Cursor.show} function is called
      *
      * This function can't be called in read-only mode.
      *
@@ -999,9 +1603,8 @@ export class Cursor {
     /**
      * @remarks
      * Manually offset the 3D block cursor by given amount.
-     * Depending on the {@link
-     * @minecraft-server-editor.CursorProperties.CursorControlMode}
-     * - this function may have no effect
+     * Depending on the {@link CursorProperties.controlMode} - this
+     * function may have no effect
      *
      * This function can't be called in read-only mode.
      *
@@ -1022,6 +1625,13 @@ export class Cursor {
      * @throws This function can throw errors.
      */
     resetToDefaultState(): void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     */
+    setAttachmentProperties(properties: CursorAttachmentProperties): void;
     /**
      * @remarks
      * Set the 3D block cursor properties to a given state
@@ -1045,6 +1655,29 @@ export class Cursor {
     show(): void;
 }
 
+export class CursorAttachmentPropertiesChangeAfterEvent {
+    private constructor();
+    readonly properties: CursorAttachmentProperties;
+}
+
+export class CursorAttachmentPropertyChangeAfterEventSignal {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    subscribe(
+        callback: (arg: CursorAttachmentPropertiesChangeAfterEvent) => void,
+    ): (arg: CursorAttachmentPropertiesChangeAfterEvent) => void;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    unsubscribe(callback: (arg: CursorAttachmentPropertiesChangeAfterEvent) => void): void;
+}
+
 export class CursorPropertiesChangeAfterEvent {
     private constructor();
     readonly properties: CursorProperties;
@@ -1105,7 +1738,7 @@ export class ExportManager {
      *
      * @throws This function can throw errors.
      */
-    beginExportProject(options: ProjectExportOptions): Promise<ExportResult>;
+    beginExportProject(options: GameOptions): Promise<ExportResult>;
     /**
      * @remarks
      * This function can't be called in read-only mode.
@@ -1113,6 +1746,21 @@ export class ExportManager {
      * @throws This function can throw errors.
      */
     canExportProject(): boolean;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     */
+    getGameOptions(useDefault?: boolean): GameOptions;
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     */
+    getGameVersion(): string;
 }
 
 /**
@@ -1249,6 +1897,8 @@ export class ExtensionContext {
  */
 export class ExtensionContextAfterEvents {
     private constructor();
+    readonly clipboardChange: ClipboardChangeAfterEventSignal;
+    readonly cursorAttachmentPropertyChange: CursorAttachmentPropertyChangeAfterEventSignal;
     readonly cursorPropertyChange: CursorPropertyChangeAfterEventSignal;
     /**
      * @remarks
@@ -1474,7 +2124,7 @@ export class PlaytestManager {
      *
      * @throws This function can throw errors.
      */
-    beginPlaytest(options: PlaytestGameOptions): Promise<PlaytestSessionResult>;
+    beginPlaytest(options: GameOptions): Promise<PlaytestSessionResult>;
     /**
      * @remarks
      * This function can't be called in read-only mode.
@@ -1670,7 +2320,7 @@ export class Selection {
      *
      * @param forceRelativity
      * See the description for {@link
-     * @minecraft-server/CompoundBlockVolume.peekLastVolume}
+     * @minecraft/server.CompoundBlockVolume.peekLastVolume}
      * @returns
      * Returns undefined if the stack is empty
      */
@@ -1710,12 +2360,12 @@ export class Selection {
      * This function can't be called in read-only mode.
      *
      * @param other
-     * {@link @minecraft-server/CompoundBlockVolume} - set the
+     * {@link @minecraft/server.CompoundBlockVolume} - set the
      * block component part of this selection to the specified
      * compound block volume.  This will completely replace all
      * block volume definitions in the selection.
-     * {@link @Selection} - replace the selection with the
-     * specified selection
+     * {@link Selection} - replace the selection with the specified
+     * selection
      * @throws This function can throw errors.
      */
     set(other: minecraftserver.CompoundBlockVolume | Selection): void;
@@ -1794,18 +2444,14 @@ export class SettingsManager {
 
 export class SettingsUIElement {
     readonly initialValue: boolean | number | string | minecraftserver.Vector3;
-    readonly max?: number;
-    readonly min?: number;
     readonly name: string;
-    readonly onChange: (arg: boolean | number | string | minecraftserver.Vector3) => boolean;
-    readonly options?: string[];
+    readonly onChange: (arg: boolean | number | string | minecraftserver.Vector3) => void;
+    readonly options: SettingsUIElementOptions;
     constructor(
         name: string,
         initialValue: boolean | number | string | minecraftserver.Vector3,
-        onChange: (arg: boolean | number | string | minecraftserver.Vector3) => boolean,
-        min?: number,
-        max?: number,
-        options?: string[],
+        onChange: (arg: boolean | number | string | minecraftserver.Vector3) => void,
+        options?: SettingsUIElementOptions,
     );
 }
 
@@ -1821,9 +2467,37 @@ export class SimpleBlockPaletteItem extends IBlockPaletteItem {
  * how to use this class and the wrapper framework
  */
 export declare class SimpleToolWrapper implements IDisposable {
+    /**
+     * @remarks
+     * The player UI session that the tool is running in Use this
+     * to access the player UI session, or any of the session's
+     * components
+     *
+     */
     get session(): IPlayerUISession;
+    /**
+     * @remarks
+     * The simple tool instance that is created and managed by the
+     * wrapper Use this to access any of the tools components, or
+     * mess with the tools window visibility
+     *
+     */
     get simpleTool(): ISimpleTool;
+    /**
+     * @remarks
+     * Setup the simple tool instance with the given options This
+     * will create and initialize the simple tool instance
+     *
+     */
     setupSimpleTool(session: IPlayerUISession, options: ISimpleToolOptions): void;
+    /**
+     * @remarks
+     * Teardown the simple tool instance This will call the
+     * teardown function on the simple tool instance This function
+     * is automatically invoked by the Editor Extension system when
+     * the editor is shutting down
+     *
+     */
     teardown(): void;
 }
 
@@ -1865,6 +2539,15 @@ export class SimulationState {
  */
 export class TransactionManager {
     private constructor();
+    /**
+     * @remarks
+     * This function can't be called in read-only mode.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link Error}
+     */
+    addEntityOperation(entity: minecraftserver.Entity, type: EntityOperationType): boolean;
     /**
      * @remarks
      * This function can't be called in read-only mode.
@@ -2000,7 +2683,7 @@ export class TransactionManager {
     /**
      * @remarks
      * Begin tracking block changes in an area defined by a {@link
-     * @minecraft-server/CompoundBlockVolume}.  These will be added
+     * @minecraft/server.CompoundBlockVolume}.  These will be added
      * to a pending changes list.
      * The pending list will be added to the open transaction
      * record when a commit has been issued.
@@ -2008,7 +2691,7 @@ export class TransactionManager {
      * This function can't be called in read-only mode.
      *
      * @param compoundBlockVolume
-     * {@link @minecraft-server/CompoundBlockVolume} to track.
+     * {@link @minecraft/server.CompoundBlockVolume} to track.
      * Only non-void block locations will be tracked -- any changes
      * falling into a void/negative space will not be tracked
      * @throws This function can throw errors.
@@ -2036,7 +2719,7 @@ export class TransactionManager {
      * Selection Volumes can also represent irregular shapes with
      * non-contiguous blocks and this tracking call will honor the
      * actual selected areas in the volume (and not the negative
-     * space) (see {@link @minecraft-server/CompoundBlockVolume}
+     * space) (see {@link @minecraft/server.CompoundBlockVolume}
      * for more details
      *
      * This function can't be called in read-only mode.
@@ -2238,6 +2921,11 @@ export class WidgetStateChangeEventData {
     readonly widget: Widget;
 }
 
+export interface BrushPipelineOperation {
+    blockTypes: minecraftserver.BlockType[];
+    operation: BrushPipelineOperationType;
+}
+
 export interface BrushShape {
     icon: string;
     name: string;
@@ -2289,6 +2977,18 @@ export interface ClipboardWriteOptions {
     rotation?: minecraftserver.StructureRotation;
 }
 
+export interface CursorAttachmentProperties {
+    boundsFillColor?: minecraftserver.RGBA;
+    boundsVisible?: boolean;
+    boundsWireframeColor?: minecraftserver.RGBA;
+    contentsFillColor?: minecraftserver.RGBA;
+    contentsWireframeColor?: minecraftserver.RGBA;
+    mirror?: minecraftserver.StructureMirrorAxis;
+    offset?: minecraftserver.Vector3;
+    origin?: minecraftserver.Vector3;
+    rotation?: minecraftserver.StructureRotation;
+}
+
 /**
  * The CursorProperties interface is used to describe the
  * properties of the Editor 3D block cursor construct.
@@ -2322,6 +3022,7 @@ export interface CursorProperties {
      *
      */
     controlMode?: CursorControlMode;
+    fillColor?: minecraftserver.RGBA;
     /**
      * @remarks
      * The fixed distance from the players feet at which the cursor
@@ -2407,6 +3108,46 @@ export interface ExtensionOptionalParameters {
     toolGroupId?: string;
 }
 
+export interface GameOptions {
+    bonusChest?: boolean;
+    cheats?: boolean;
+    commandBlockEnabled?: boolean;
+    daylightCycle?: DaylightCycle;
+    difficulty?: minecraftserver.Difficulty;
+    dimensionId?: string;
+    disableWeather?: boolean;
+    educationEdition?: boolean;
+    entitiesDropLoot?: boolean;
+    exportType?: ProjectExportType;
+    fireSpreads?: boolean;
+    friendlyFire?: boolean;
+    gameMode?: minecraftserver.GameMode;
+    immediateRespawn?: boolean;
+    keepInventory?: boolean;
+    lanVisibility?: boolean;
+    mobGriefing?: boolean;
+    mobLoot?: boolean;
+    mobSpawning?: boolean;
+    multiplayerGame?: boolean;
+    naturalRegeneration?: boolean;
+    playerAccess?: GamePublishSetting;
+    playerPermissions?: PlayerPermissionLevel;
+    randomTickSpeed?: number;
+    recipeUnlocking?: boolean;
+    respawnBlocksExplode?: boolean;
+    respawnRadius?: number;
+    showCoordinates?: boolean;
+    showDaysPlayed?: boolean;
+    simulationDistance?: number;
+    spawnPosition?: minecraftserver.Vector3;
+    startingMap?: boolean;
+    tileDrops?: boolean;
+    timeOfDay?: number;
+    tntExplodes?: boolean;
+    weather?: number;
+    worldName?: string;
+}
+
 /**
  * A properties class for the global instance of the logger
  * object.
@@ -2432,18 +3173,6 @@ export interface LogProperties {
     tags?: string[];
 }
 
-export interface PlaytestGameOptions {
-    alwaysDay?: boolean;
-    difficulty?: minecraftserver.Difficulty;
-    dimensionId?: string;
-    disableWeather?: boolean;
-    gameMode?: minecraftserver.GameMode;
-    showCoordinates?: boolean;
-    spawnPosition?: minecraftserver.Vector3;
-    timeOfDay?: number;
-    weather?: number;
-}
-
 export interface ProjectExportOptions {
     alwaysDay?: boolean;
     difficulty?: minecraftserver.Difficulty;
@@ -2454,6 +3183,13 @@ export interface ProjectExportOptions {
     initialTimOfDay?: number;
 }
 
+export interface SettingsUIElementOptions {
+    dropdownItems?: string[];
+    max?: number;
+    min?: number;
+    refreshOnChange?: boolean;
+}
+
 export interface WidgetCreateOptions {
     initialVisibility?: boolean;
     isSelectable?: boolean;
@@ -2493,58 +3229,155 @@ export interface ActionManager {
 export interface BuiltInUIManager {
     /**
      * @remarks
-     * Navigates to the documentation site.
+     * Navigates to the documentation site.
+     *
+     */
+    navigateToDocumentation(): void;
+    /**
+     * @remarks
+     * Navigates to the feedback site
+     *
+     */
+    navigateToFeedback(): void;
+    /**
+     * @remarks
+     * Navigates to the pause screen
+     *
+     */
+    navigateToPauseScreen(): void;
+    /**
+     * @remarks
+     * Updates the visibility of the log panel
+     *
+     */
+    updateLogPanelVisibility(visibility: boolean): void;
+    /**
+     * @remarks
+     * Updates the visibility of the control demo
+     *
+     */
+    updateUISettingsPanelVisibility(visibility: boolean): void;
+    /**
+     * @remarks
+     * Updates the visibility of the welcome panel
+     *
+     */
+    updateWelcomePanelVisibility(visibility: boolean): void;
+}
+
+/**
+ *  An event that can be subscribed to. You can use the token,
+ * returned from the subscribe method, to clean up handlers.
+ */
+export declare interface EventSink<T> {
+    /**
+     * @remarks
+     * Subscribes an event handler to a particular subscription.
+     *
+     * @param handler
+     * Handler function to subscribe with.
+     * @returns
+     * An event handler subscription token that can be used to
+     * unsubscribe and clean-up handlers.
+     */
+    subscribe(handler: EventHandler<T>): IEventToken;
+}
+
+/**
+ * Manager for IActionBarItem objects.
+ */
+export interface IActionBar {
+    /**
+     * @remarks
+     * Add a new action bar item to the collection.
+     *
+     * @param id
+     * Unique item identifier.
+     * @param action
+     * Action to be invoked.
+     * @param props
+     * Configuration for the item to create.
+     */
+    registerItem(
+        id: string,
+        action: RegisteredAction<NoArgsAction>,
+        props: IActionBarItemCreationParams,
+    ): IActionBarItem;
+    /**
+     * @remarks
+     * Remove an action item from the collection.
+     *
+     * @param id
+     * Unique item identifier.
+     */
+    unregisterItem(id: string): void;
+}
+
+/**
+ * Registered item handle in the Action Bar collection.
+ */
+export interface IActionBarItem {
+    /**
+     * @remarks
+     * Returns the current enabled state of the item.
+     *
+     */
+    getEnabled: () => boolean;
+    /**
+     * @remarks
+     * Unique identifier of the item.
+     *
+     */
+    readonly id: string;
+    /**
+     * @remarks
+     * Text label of the item.
      *
      */
-    navigateToDocumentation(): void;
+    readonly label: string;
     /**
      * @remarks
-     * Navigates to the feedback site
+     * Modify enabled state of the item.
      *
      */
-    navigateToFeedback(): void;
+    setEnabled: (enabled: boolean) => void;
+}
+
+/**
+ * Properties required to create an Action Bar item.
+ */
+export interface IActionBarItemCreationParams {
     /**
      * @remarks
-     * Navigates to the pause screen
+     * Initial enabled state of the item. If not defined, default
+     * is true.
      *
      */
-    navigateToPauseScreen(): void;
+    enabled?: boolean;
     /**
      * @remarks
-     * Updates the visibility of the log panel
+     * Icon resource for the item.
      *
      */
-    updateLogPanelVisibility(visibility: boolean): void;
+    icon: string;
     /**
      * @remarks
-     * Updates the visibility of the control demo
+     * Text label for item.
      *
      */
-    updateUISettingsPanelVisibility(visibility: boolean): void;
+    label: string;
     /**
      * @remarks
-     * Updates the visibility of the welcome panel
+     * Tooltip description for the item.
      *
      */
-    updateWelcomePanelVisibility(visibility: boolean): void;
-}
-
-/**
- *  An event that can be subscribed to. You can use the token,
- * returned from the subscribe method, to clean up handlers.
- */
-export declare interface EventSink<T> {
+    tooltipDescription?: string;
     /**
      * @remarks
-     * Subscribes an event handler to a particular subscription.
+     * Tooltip title for the item.
      *
-     * @param handler
-     * Handler function to subscribe with.
-     * @returns
-     * An event handler subscription token that can be used to
-     * unsubscribe and clean-up handlers.
      */
-    subscribe(handler: EventHandler<T>): IEventToken;
+    tooltipTitle?: string;
 }
 
 /**
@@ -2559,22 +3392,19 @@ export interface IDisposable {
     teardown(): void;
 }
 
+/**
+ * Properties of dropdown property item children
+ */
 export interface IDropdownItem {
     /**
      * @remarks
-     * Fallback display text if no loc ID
-     *
-     */
-    readonly displayAltText: string;
-    /**
-     * @remarks
-     * Loc ID (resolved on client)
+     * Localized display text of the dropdown item.
      *
      */
-    readonly displayStringId: string;
+    readonly label: string;
     /**
      * @remarks
-     * The selectable value of the DropDown item.
+     * The selectable value of the dropdown item.
      *
      */
     readonly value: number;
@@ -2611,8 +3441,8 @@ export interface IGlobalInputManager {
     registerKeyBinding(
         inputContextId: EditorInputContext,
         action: SupportedKeyboardActionTypes,
-        button: KeyboardKey,
-        modifier?: InputModifier,
+        binding: KeyBinding,
+        info?: KeyBindingInfo,
     ): void;
 }
 
@@ -2624,6 +3454,12 @@ export interface IMenu {
      *
      */
     checked?: boolean;
+    /**
+     * @remarks
+     * The menu will be in either an enabled or disabled state
+     *
+     */
+    enabled: boolean;
     /**
      * @remarks
      * Unique ID for the menu
@@ -2678,16 +3514,16 @@ export interface IMenuCreationParams {
     checked?: boolean;
     /**
      * @remarks
-     * Loc ID (resolved on client)
+     * Whether the menu should be enabled or disabled
      *
      */
-    displayStringId?: string;
+    enabled?: boolean;
     /**
      * @remarks
-     * The name of the menu
+     * Localized display text of the menu
      *
      */
-    name: string;
+    label: string;
     /**
      * @remarks
      * Custom unique identifier that will replace random id
@@ -2712,7 +3548,7 @@ export interface IModalTool {
     bindPropertyPane(pane: IPropertyPane): void;
     dispose(): void;
     hide(): void;
-    registerKeyBinding(action: SupportedKeyboardActionTypes, button: KeyboardKey, modifier?: InputModifier): void;
+    registerKeyBinding(action: SupportedKeyboardActionTypes, binding: KeyBinding, info?: KeyBindingInfo): void;
     registerMouseButtonBinding(action: SupportedMouseActionTypes): void;
     registerMouseDragBinding(action: SupportedMouseActionTypes): void;
     registerMouseWheelBinding(action: SupportedMouseActionTypes): void;
@@ -2846,16 +3682,10 @@ export interface IPropertyItemOptions {
     onChange?: OnChangeCallback<PropertyBag, string>;
     /**
      * @remarks
-     * Fallback display text if no loc ID
-     *
-     */
-    titleAltText?: string;
-    /**
-     * @remarks
-     * Loc ID (resolved on client)
+     * Localized title of the property item
      *
      */
-    titleStringId?: string;
+    title?: string;
     /**
      * @remarks
      * If the item should be visible in the UI.
@@ -2864,6 +3694,11 @@ export interface IPropertyItemOptions {
     visible?: boolean;
 }
 
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IPropertyItemOptionsBlockList extends IPropertyItemOptions {
+    blockList: string[];
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export interface IPropertyItemOptionsBool extends IPropertyItemOptions {
     /**
@@ -2885,6 +3720,12 @@ export interface IPropertyItemOptionsButton extends IPropertyItemOptions {
     variant?: ButtonVariant;
 }
 
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IPropertyItemOptionsColorPicker extends IPropertyItemOptions {
+    showAlpha?: boolean;
+    variant?: ColorPickerVariant;
+}
+
 // @ts-ignore Class inheritance allowed for native defined classes
 export interface IPropertyItemOptionsDataPicker extends IPropertyItemOptions {
     /**
@@ -2913,6 +3754,13 @@ export interface IPropertyItemOptionsImage extends IPropertyItemOptions {
 
 // @ts-ignore Class inheritance allowed for native defined classes
 export interface IPropertyItemOptionsNumber extends IPropertyItemOptions {
+    /**
+     * @remarks
+     * If we should treat the number as floating point. By default
+     * is false
+     *
+     */
+    isFloat?: boolean;
     /**
      * @remarks
      * The min possible value for the number.
@@ -2955,8 +3803,8 @@ export interface IPropertyItemOptionsTable extends IPropertyItemOptions {
  */
 // @ts-ignore Class inheritance allowed for native defined classes
 export interface IPropertyItemOptionsText extends IPropertyItemOptions {
-    border: boolean;
-    valueStringId: string;
+    border?: boolean;
+    valueStringId?: string;
 }
 
 // @ts-ignore Class inheritance allowed for native defined classes
@@ -3037,16 +3885,10 @@ export interface IPropertyPane {
     readonly parentPaneId?: string;
     /**
      * @remarks
-     * Fallback display text if no loc ID
-     *
-     */
-    titleAltText: string;
-    /**
-     * @remarks
-     * Loc ID (resolved on client)
+     * Localized title of the property pane
      *
      */
-    titleStringId: string;
+    title: string;
     /**
      * @remarks
      * Check visibility of the pane
@@ -3059,6 +3901,17 @@ export interface IPropertyPane {
      *
      */
     width?: number;
+    /**
+     * @remarks
+     * Adds a block list to the pane.
+     *
+     */
+    addBlockList(options?: IPropertyItemOptionsBlockList): IBlockListPropertyItem<
+        {
+            EMPTY: undefined;
+        },
+        'EMPTY'
+    >;
     /**
      * @remarks
      * Adds a BlockPicker item to the pane.
@@ -3094,6 +3947,16 @@ export interface IPropertyPane {
         },
         'EMPTY'
     >;
+    /**
+     * @remarks
+     * Adds a color picker item to the pane.
+     *
+     */
+    addColorPicker<T extends PropertyBag, Prop extends keyof T & string>(
+        obj: T,
+        property: Prop,
+        options?: IPropertyItemOptionsColorPicker,
+    ): IPropertyItem<T, Prop>;
     /**
      * @remarks
      * Adds an divider item to the pane.
@@ -3127,6 +3990,8 @@ export interface IPropertyPane {
     ): IPropertyItem<T, Prop>;
     /**
      * @remarks
+     * Adds an image item to the pane.
+     *
      */
     addImage<T extends PropertyBag, Prop extends keyof T & string>(
         obj: T,
@@ -3235,23 +4100,10 @@ export interface IPropertyPaneOptions {
     direction?: LayoutDirection;
     /**
      * @remarks
-     * Fallback display text if no loc ID
-     *
-     */
-    titleAltText: string;
-    /**
-     * @remarks
-     * Loc ID (resolved on client)
-     *
-     */
-    titleStringId: string;
-    /**
-     * @remarks
-     * Width of the panel in rem. This property is ignored in case
-     * of sub panes
+     * Localized title of the property pane
      *
      */
-    width?: number;
+    title: string;
 }
 
 export interface IPropertyTableCellItem {
@@ -3303,57 +4155,137 @@ export interface IRegisterExtensionOptionalParameters {
  * the editor evolves.
  */
 export interface ISimpleTool {
+    /**
+     * @remarks
+     * Get a reference to the menu component that was automatically
+     * created for the tool This generally only happens if the tool
+     * is a global tool (i.e. has a pane and does not have a tool
+     * rail component) In this case a menu item is automatically
+     * created and some visibility controls are inserted. If you
+     * have additional menu options you want to add, this is the
+     * ideal control to add children to
+     *
+     */
     get menu(): IMenu | undefined;
+    /**
+     * @remarks
+     * Get the tool name
+     *
+     */
     get name(): string;
+    /**
+     * @remarks
+     * Get a reference to the root (primary) property pane
+     * component - if no component was requested, this function
+     * will throw an error
+     *
+     */
     get pane(): ISimpleToolPaneComponent;
+    /**
+     * @remarks
+     * Get a reference to the IPlayerUISession. This is the primary
+     * interface to the editor UI and all of the editor extension
+     * controls
+     *
+     */
     get session(): IPlayerUISession;
+    /**
+     * @remarks
+     * Get a reference to the status bar component - if no
+     * component was requested, this function will throw an error
+     *
+     */
     get statusBar(): ISimpleToolStatusBarComponent;
+    /**
+     * @remarks
+     * Get a reference to the tool rail component - if no component
+     * was requested, this function will throw an error
+     *
+     */
     get toolRail(): ISimpleToolRailComponent;
     /**
      * @remarks
+     * Find a pane or subpane by it's unique ID.
+     *
      */
     findPane(idString: string): ISimpleToolPaneComponent | undefined;
     /**
      * @remarks
+     * Hide a particular pane or subpane by it's unique ID. If no
+     * ID is provided (or cannot be found) the function will throw
+     * an error Although the parent pane is used to execute the
+     * visibility request, the hidePane function will NOT affect
+     * the visibility of any sibling panes -- so it is possible to
+     * hide all of the child panes of a parent using this function
+     *
      */
     hidePane(idString?: string): void;
     /**
      * @remarks
+     * Send a tagged Debug log message to the console. The tag will
+     * contain the tool name
+     *
      */
     logDebug(message: string): void;
     /**
      * @remarks
+     * Send a tagged Error log message to the console. The tag will
+     * contain the tool name
+     *
      */
     logError(message: string): void;
     /**
      * @remarks
+     * Send a tagged Informational log message to the console. The
+     * tag will contain the tool name
+     *
      */
     logInfo(message: string): void;
     /**
      * @remarks
+     * Send a tagged Warning log message to the console. The tag
+     * will contain the tool name
+     *
      */
     logWarn(message: string): void;
     /**
      * @remarks
+     * Show a particular pane or subpane by it's unique ID. If no
+     * ID is provided (or cannot be found) the function will throw
+     * an error Note that the showPane function (when used with a
+     * child pane) will use the parent pane to execute the
+     * visibility request. In this case, if the child panes are
+     * marked as mututally exclusive, then the siblings of the
+     * requested pane will be hidden
+     *
      */
     showPane(idString?: string): void;
     /**
      * @remarks
+     * Much like the showPane function, but will hide all other
+     * panes that are not the requested pane irrespective of the
+     * exclusivity setting
+     *
      */
     showPaneExclusively(idString: string): void;
     /**
      * @remarks
+     * A teardown function implemented by the ISimpleTool
+     * implementation, and is called by the system during editor
+     * extension shutdown. Don't override this function - instead,
+     * implement the onTeardown event in the ISimpleToolOptions
+     * structure
+     *
      */
     teardown(): void;
 }
 
 /**
- * Define a (key & modifier) pair for the simple tool
- * activation key binding
+ * Define a key binding for the simple tool activation
  */
-export interface ISimpleToolKeyPair {
-    button: KeyboardKey;
-    buttonModifier: InputModifier;
+export interface ISimpleToolKeyBinding {
+    binding: KeyBinding;
+    info?: KeyBindingInfo;
 }
 
 /**
@@ -3361,12 +4293,61 @@ export interface ISimpleToolKeyPair {
  * simple tool, and the optional components that are desired.
  */
 export interface ISimpleToolOptions {
-    activationKeyBinding?: ISimpleToolKeyPair;
+    /**
+     * @remarks
+     * A key binding that will activate the tool. Note that if the
+     * tool is a modal tool, then the key binding will be tied to
+     * the tool rail activation, and appear as a tooltip on the
+     * tool rail button. If the tool is a global tool, then the key
+     * binding will be tied to a menu item in the View menu, and
+     * appear as a stateful menu item which will control the pane
+     * visibility. If there's no pane required, then the key
+     * binding is ignored
+     *
+     */
+    activationKeyBinding?: ISimpleToolKeyBinding;
+    /**
+     * @remarks
+     * The name of the tool. This will be used to identify the tool
+     * in the UI and logs and will be used in the View \> [Tool
+     * Name] menu item (if it's a global tool)
+     *
+     */
     name: string;
+    /**
+     * @remarks
+     * The finalize function is executed after each of the
+     * components have been created and finalized during
+     * construction
+     *
+     */
     onFinalize?: (tool: ISimpleTool) => void;
+    /**
+     * @remarks
+     * The teardown function is executed when the tool is being
+     * torn down and only after the individual components have
+     * executed their own teardown functions
+     *
+     */
     onTeardown?: (tool: ISimpleTool) => void;
+    /**
+     * @remarks
+     * The options structure for an optional property pane
+     * component
+     *
+     */
     propertyPaneOptions?: ISimpleToolPaneOptions;
+    /**
+     * @remarks
+     * The options structure for an optional status bar component
+     *
+     */
     statusBarOptions?: ISimpleToolStatusBarOptions;
+    /**
+     * @remarks
+     * The options structure for an optional tool rail component
+     *
+     */
     toolRailOptions?: ISimpleToolRailOptions;
 }
 
@@ -3385,26 +4366,83 @@ export interface ISimpleToolOptions {
  * to the creator/user)
  */
 export interface ISimpleToolPaneComponent {
+    /**
+     * @remarks
+     * Get a list of the unique ID's of all of the child panes
+     *
+     */
     get childPaneList(): string[];
+    /**
+     * @remarks
+     * Get the unique ID of the pane
+     *
+     */
     get id(): string;
+    /**
+     * @remarks
+     * Check the visibility of the pane
+     *
+     */
     get isVisible(): boolean;
+    /**
+     * @remarks
+     * Get a reference to actual property pane implementation that
+     * was constructed by the tool. This reference is used to
+     * construct the UI components that are displayed in the pane.
+     *
+     */
     get pane(): IPropertyPane;
+    /**
+     * @remarks
+     * Get a reference to the IPlayerUISession. This is the primary
+     * interface to the editor UI and all of the editor extension
+     * controls
+     *
+     */
     get session(): IPlayerUISession;
+    /**
+     * @remarks
+     * Get a reference to the parent tool.
+     *
+     */
     get simpleTool(): ISimpleTool;
     /**
      * @remarks
+     * Find a pane reference by unique ID
+     *
      */
     findPane(idString: string): ISimpleToolPaneComponent | undefined;
     /**
      * @remarks
+     * Hide the pane. Although the parent pane is used to execute
+     * the visibility request, the hidePane function will NOT
+     * affect the visibility of any sibling panes -- so it is
+     * possible to hide all of the child panes of a parent using
+     * this function
+     *
      */
     hidePane(): void;
     /**
      * @remarks
+     * This causes the reconstruction of the pane (and the child
+     * panes) as if the tool was being constructed for the first
+     * time. This is unfortunately necessary until such time that
+     * all of our UI components are able to communicate dynamically
+     * with their client counterparts. Certain controls require a
+     * full teardown and reconstruction to properly update their
+     * state. This is undergoing code changes and should become
+     * unnecessary in the future.
+     *
      */
     reconstructPane(): void;
     /**
      * @remarks
+     * Show the pane. Note, if this is a sub-pane, then this
+     * function will ask the parent for permission to show, and may
+     * result in the visibility of any sibling panes to change as a
+     * result (depending on the `mutually exclusive visibility`
+     * flag)
+     *
      */
     showPane(): void;
 }
@@ -3426,22 +4464,77 @@ export interface ISimpleToolPaneComponent {
  * pane to finalize itself.
  */
 export interface ISimpleToolPaneOptions {
+    /**
+     * @remarks
+     * The id of the child pane that should be visible when the
+     * parent pane is first shown, or the editor tool is
+     * constructed and finalized
+     *
+     */
     childPaneInitiallyVisible?: string;
+    /**
+     * @remarks
+     * An optional array of child panes. These panes are set up
+     * exactly the same as the top level pane, but are displayed as
+     * children inside the parent pane.
+     *
+     */
     childPanes?: ISimpleToolPaneOptions[];
+    /**
+     * @remarks
+     * An optional flag to indicate whether the child panes are
+     * mutually exclusive. If this is true, then only one child
+     * pane can be visible at a time. If this is false, then
+     * multiple child panes can be visible at the same time.
+     * Visibility is controlled either through `showPane` or
+     * `hidePane` functions of the `ISimpleToolPaneComponent` or
+     * through the visibility methods in the top level tool
+     * (`ISimpleTool`)
+     *
+     */
     childPanesMutuallyExclusive?: boolean;
+    /**
+     * @remarks
+     * The unique identifier for this pane. This is used to
+     * identify the pane in the tool's pane hierarchy.
+     *
+     */
     id: string;
     onBeginFinalize?: (pane: ISimpleToolPaneComponent) => void;
     onEndFinalize?: (pane: ISimpleToolPaneComponent) => void;
     onHide?: (pane: ISimpleToolPaneComponent) => void;
     onShow?: (pane: ISimpleToolPaneComponent) => void;
     onTeardown?: (pane: ISimpleToolPaneComponent) => void;
-    titleAltText: string;
-    titleStringId?: string;
+    /**
+     * @remarks
+     * The title of the pane. This will be displayed in the title
+     * bar of the pane.
+     *
+     */
+    title: string;
 }
 
 export interface ISimpleToolRailComponent {
+    /**
+     * @remarks
+     * Get a reference to the IPlayerUISession. This is the primary
+     * interface to the editor UI and all of the editor extension
+     * controls
+     *
+     */
     get session(): IPlayerUISession;
+    /**
+     * @remarks
+     * Get a reference to the parent tool.
+     *
+     */
     get simpleTool(): ISimpleTool;
+    /**
+     * @remarks
+     * Get the implementation interface of the underlying tool rail
+     * component
+     *
+     */
     get toolRail(): IModalTool;
 }
 
@@ -3459,15 +4552,32 @@ export interface ISimpleToolRailComponent {
  * gameplay interaction
  */
 export interface ISimpleToolRailOptions {
-    displayAltText: string;
-    displayStringId?: string;
+    /**
+     * @remarks
+     * The icon for the tool rail button. This is generally a URL
+     * to an image file in the editor extension resource pack e.g.
+     * `pack://textures/my-tool-icon.png`
+     *
+     */
     icon: string;
     onActivate?: (component: ISimpleToolRailComponent) => void;
     onDeactivate?: (component: ISimpleToolRailComponent) => void;
     onFinalize?: (component: ISimpleToolRailComponent) => void;
     onTeardown?: (component: ISimpleToolRailComponent) => void;
-    tooltipAltText: string;
-    tooltipStringId?: string;
+    /**
+     * @remarks
+     * The text for the tool title
+     *
+     */
+    title: string;
+    /**
+     * @remarks
+     * The tooltip description for the tool. Note: if an activation
+     * key binding was added to `ISimpleToolOptions`, then the key
+     * binding will be appended to the tooltip string.
+     *
+     */
+    tooltip: string;
 }
 
 export interface ISimpleToolStatusBarComponent {
@@ -3483,13 +4593,36 @@ export interface ISimpleToolStatusBarComponent {
  * status bar item for a simple tool.
  */
 export interface ISimpleToolStatusBarOptions {
+    /**
+     * @remarks
+     * The alignment of the status bar item within the parent
+     * status bar container
+     *
+     */
     alignment: EditorStatusBarAlignment;
+    /**
+     * @remarks
+     * The text for the status bar item
+     *
+     */
     displayAltText: string;
     onFinalize?: (statusBar: ISimpleToolStatusBarComponent) => void;
     onHide?: (statusBar: ISimpleToolStatusBarComponent) => void;
     onShow?: (statusBar: ISimpleToolStatusBarComponent) => void;
     onTeardown?: (statusBar: ISimpleToolStatusBarComponent) => void;
+    /**
+     * @remarks
+     * The size of the status bar item within the parent status bar
+     * container
+     *
+     */
     size: number;
+    /**
+     * @remarks
+     * Determine the status bar visibility based on the existence
+     * and visibility of the tool's root property pane
+     *
+     */
     visibility?: SimpleToolStatusBarVisibility;
 }
 
@@ -3516,34 +4649,34 @@ export interface IStatusBarItem {
 export interface ModalToolCreationParameters {
     /**
      * @remarks
-     * The displayed string for the tool
+     * Icon, if any (from resource pack on client)
      *
      */
-    displayAltText: string;
+    icon?: string;
     /**
      * @remarks
-     * Loc ID (resolved on client)
+     * Modal input context identifier
      *
      */
-    displayStringId?: string;
+    inputContextId?: string;
     /**
      * @remarks
-     * Icon, if any (from resource pack on client)
+     * Localized text label for modal input context
      *
      */
-    icon?: string;
+    inputContextLabel?: string;
     /**
      * @remarks
-     * tooltipAltText alt text, if any
+     * Title of the tool
      *
      */
-    tooltipAltText?: string;
+    title: string;
     /**
      * @remarks
-     * Tooltip localization string ID
+     * Tooltip description of the toll
      *
      */
-    tooltipStringId?: string;
+    tooltip?: string;
 }
 
 /**
@@ -3576,6 +4709,20 @@ export declare function executeLargeOperation(
     selection: Selection,
     operation: (blockLocation: minecraftserver.Vector3) => void,
 ): Promise<void>;
+/**
+ * @remarks
+ * Executes an operation over a BlockLocationIterator via
+ * chunks to allow splitting operation over multiple game ticks
+ *
+ * @param blockLocationIterator
+ * the selection to iterator over
+ * @param operation
+ * the operation to apply over each block location
+ */
+export declare function executeLargeOperationFromIterator(
+    blockLocationIterator: minecraftserver.BlockLocationIterator,
+    operation: (blockLocation: minecraftserver.Vector3) => void,
+): Promise<void>;
 /**
  * @remarks
  * Returns a string array of the default block types for the
@@ -3586,13 +4733,6 @@ export declare function executeLargeOperation(
  * Default allowed block list
  */
 export declare function getBlockPickerDefaultAllowBlockList(): string[];
-/**
- * @remarks
- * Adds the resource pack editor prefix and returns the full
- * localization ID
- *
- */
-export declare function getLocalizationId(locId: string): string;
 /**
  * @remarks
  * Registers an editor extension into Minecraft. This function