@minecraft/server-editor 0.1.0-beta.1.26.40-preview.29 → 0.1.0-beta.1.26.40-preview.30

package/index.d.ts

@@ -2298,7 +2298,7 @@ export class BlockUtilities {
      * @throws This function can throw errors.
      */
     fillVolume(
-        volume: minecraftserver.BlockVolumeBase | minecraftserver.CompoundBlockVolume | RelativeVolumeListBlockVolume,
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
         block?: minecraftserver.BlockPermutation | minecraftserver.BlockType | string,
     ): void;
     /**
@@ -2315,7 +2315,7 @@ export class BlockUtilities {
      *
      * @throws This function can throw errors.
      */
-    getContiguousSelection(properties?: ContiguousSelectionProperties): minecraftserver.CompoundBlockVolume;
+    getContiguousSelection(properties?: ContiguousSelectionProperties): RelativeVolumeListBlockVolume;
     /**
      * @remarks
      * This function can't be called in restricted-execution mode.
@@ -2383,6 +2383,77 @@ export class BlockUtilities {
     ): RelativeVolumeListBlockVolume;
 }
 
+export class BlockUtilityTasks {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    fillVolume(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        block?: minecraftserver.BlockPermutation | minecraftserver.BlockType | string,
+        maxBlocksPerTick?: number,
+    ): Promise<number>;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    findObscuredBlocksWithinVolume(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        maxBlocksPerTick?: number,
+    ): Promise<RelativeVolumeListBlockVolume>;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    generateManifest(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        maxBlocksPerTick?: number,
+    ): Promise<BlockUtilityManifest>;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    replaceBlocksInSelection(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        fromBlockIdentifier: string,
+        toBlock?: minecraftserver.BlockPermutation | minecraftserver.BlockType | string,
+        maxBlocksPerTick?: number,
+    ): Promise<number>;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    shrinkWrapVolume(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        maxBlocksPerTick?: number,
+    ): Promise<RelativeVolumeListBlockVolume>;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    trimVolumeToFitContents(
+        volume: minecraftserver.BlockVolumeBase | RelativeVolumeListBlockVolume,
+        retainMarqueeAfterTrimming: boolean,
+        ignoreLiquid: boolean,
+        ignoreNoCollision: boolean,
+        blockMask?: BlockMaskList,
+        maxBlocksPerTick?: number,
+    ): Promise<RelativeVolumeListBlockVolume>;
+}
+
 /**
  * Base for creating new brush shapes
  */
@@ -2613,6 +2684,12 @@ export class BrushShapeManager {
      *
      */
     setInverseEraseMode(inverseEraseMode: boolean): void;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    setPendingTransaction(pendingTransaction?: PendingTransaction): void;
     /**
      * @remarks
      * This function can't be called in restricted-execution mode.
@@ -2733,7 +2810,11 @@ export class ClipboardItem {
      * Success or Failure
      * @throws This function can throw errors.
      */
-    writeToWorld(location: minecraftserver.Vector3, options?: ClipboardWriteOptions): boolean;
+    writeToWorld(
+        location: minecraftserver.Vector3,
+        options?: ClipboardWriteOptions,
+        transaction?: PendingTransaction,
+    ): boolean;
 }
 
 /**
@@ -3471,6 +3552,7 @@ export class ExtensionContext {
     readonly afterEvents: ExtensionContextAfterEvents;
     readonly blockPalette: BlockPaletteManager;
     readonly blockUtilities: BlockUtilities;
+    readonly blockUtilityTasks: BlockUtilityTasks;
     readonly brushShapeManager: BrushShapeManager;
     /**
      * @remarks
@@ -4118,6 +4200,83 @@ export declare abstract class ObservableValidator<T> {
     abstract validate(newValue: T): T | undefined;
 }
 
+export class PendingTransaction {
+    private constructor();
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    addEntityOperation(entity: minecraftserver.Entity, type: EntityOperationType): boolean;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    addUserDefinedOperation(
+        transactionHandlerId: UserDefinedTransactionHandlerId,
+        operationData: string,
+        operationName?: string,
+    ): void;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    commitTrackedChanges(): number;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    discard(): void;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    discardTrackedChanges(): number;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     */
+    isValid(): boolean;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    submit(): void;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    trackBlockChangeArea(from: minecraftserver.Vector3, to: minecraftserver.Vector3): boolean;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    trackBlockChangeList(locations: minecraftserver.Vector3[]): boolean;
+    /**
+     * @remarks
+     * This function can't be called in restricted-execution mode.
+     *
+     * @throws This function can throw errors.
+     */
+    trackBlockChangeVolume(blockVolume: minecraftserver.BlockVolumeBase): boolean;
+}
+
 export class PlaytestManager {
     private constructor();
     /**
@@ -4613,49 +4772,7 @@ export class TransactionManager {
      *
      * @throws This function can throw errors.
      */
-    addEntityOperation(entity: minecraftserver.Entity, type: EntityOperationType): boolean;
-    /**
-     * @remarks
-     * This function can't be called in restricted-execution mode.
-     *
-     * @throws This function can throw errors.
-     */
-    addUserDefinedOperation(
-        transactionHandlerId: UserDefinedTransactionHandlerId,
-        operationData: string,
-        operationName?: string,
-    ): void;
-    /**
-     * @remarks
-     * Commit all of the transaction operations currently attached
-     * to the open transaction record to the manager.  These will
-     * be added as a single transaction manager entry.
-     * The open record will be closed and all tracking operations
-     * will cease.
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @throws This function can throw errors.
-     */
-    commitOpenTransaction(): boolean;
-    /**
-     * @remarks
-     * This function will commit the pending changes caused by any
-     * of the track changes variants.  The changes will be
-     * committed to the currently open transaction, but the
-     * transaction will remain open for further records.
-     * Pending block changes from tracking operations will be added
-     * to the transaction record before submission to the
-     * transaction manager
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @returns
-     * Returns the number of change requests that were being
-     * tracked
-     * @throws This function can throw errors.
-     */
-    commitTrackedChanges(): number;
+    createPendingTransaction(name: string): PendingTransaction;
     /**
      * @remarks
      * This function can't be called in restricted-execution mode.
@@ -4666,52 +4783,6 @@ export class TransactionManager {
         undoClosure: (arg0: string) => void,
         redoClosure: (arg0: string) => void,
     ): UserDefinedTransactionHandlerId;
-    /**
-     * @remarks
-     * Discard the currently open transaction without committing it
-     * to the transaction manager stack.
-     * All records within the transaction will be discarded, and
-     * any tracking requests currently active will be stopped
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @throws This function can throw errors.
-     */
-    discardOpenTransaction(): boolean;
-    /**
-     * @remarks
-     * Discard any pending tracked changes.  This does not affect
-     * the current open transaction contents, only the pending
-     * tracked block operations
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @returns
-     * Returns the number of change requests that were discarded
-     * @throws This function can throw errors.
-     */
-    discardTrackedChanges(): number;
-    /**
-     * @remarks
-     * This function can't be called in restricted-execution mode.
-     *
-     * @throws This function can throw errors.
-     */
-    isBusy(): boolean;
-    /**
-     * @remarks
-     * Open a transaction record which will be a container for any
-     * number of transaction operations.
-     * All transaction operations within a record are grouped and
-     * treated as a single atomic unit
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @param name
-     * Give the transaction record a name
-     * @throws This function can throw errors.
-     */
-    openTransaction(name: string): boolean;
     /**
      * @remarks
      * Perform an redo operation.  This will take the last
@@ -4737,41 +4808,6 @@ export class TransactionManager {
      * @throws This function can throw errors.
      */
     redoSize(): number;
-    /**
-     * @remarks
-     * Begin tracking block changes in a specified area.  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.
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @param from
-     * Min block location of a bounding area
-     * @param to
-     * Max block location of a bounding area
-     * @throws This function can throw errors.
-     */
-    trackBlockChangeArea(from: minecraftserver.Vector3, to: minecraftserver.Vector3): boolean;
-    /**
-     * @remarks
-     * Begin tracking block changes in a list of specified block
-     * locations.
-     *
-     * This function can't be called in restricted-execution mode.
-     *
-     * @param locations
-     * An array of block locations to monitor for changes
-     * @throws This function can throw errors.
-     */
-    trackBlockChangeList(locations: minecraftserver.Vector3[]): boolean;
-    /**
-     * @remarks
-     * This function can't be called in restricted-execution mode.
-     *
-     * @throws This function can throw errors.
-     */
-    trackBlockChangeVolume(blockVolume: minecraftserver.BlockVolumeBase): boolean;
     /**
      * @remarks
      * Perform an undo operation.  This will take the last
@@ -4841,7 +4877,7 @@ export declare class UserDefinedTransactionHandle<T> {
      * @param transactionName
      * A string name that will be associated with this operation
      */
-    addUserDefinedOperation(payload: T, transactionName: string): void;
+    addUserDefinedOperation(payload: T, transactionName: string, pendingTransaction: PendingTransaction): void;
 }
 
 export class UserDefinedTransactionHandlerId {
@@ -6170,6 +6206,16 @@ export interface BlockMaskList {
     maskType: BlockMaskListType;
 }
 
+export interface BlockUtilityManifest {
+    entries: BlockUtilityManifestEntry[];
+    totalBlocks: number;
+}
+
+export interface BlockUtilityManifestEntry {
+    blockIdentifier: string;
+    count: number;
+}
+
 /**
  * Represents a UI session for a given player
  */
@@ -11314,6 +11360,13 @@ export interface ITimelinePlayerOptions extends IPropertyItemOptionsBase {
      *
      */
     groups?: ITimelinePlayerGroup[];
+    /**
+     * @remarks
+     * Callback triggered when the total duration changes (e.g. via
+     * the timeline drag handle).
+     *
+     */
+    onDurationChanged?: (duration: number) => void;
     /**
      * @remarks
      * Callback triggered when the group selection changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server-editor",
-  "version": "0.1.0-beta.1.26.40-preview.29",
+  "version": "0.1.0-beta.1.26.40-preview.30",
   "description": "",
   "contributors": [
     {
@@ -14,8 +14,8 @@
   ],
   "peerDependencies": {
     "@minecraft/common": "^1.0.0",
-    "@minecraft/server": "^2.10.0-beta.1.26.40-preview.29",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.40-preview.29"
+    "@minecraft/server": "^2.10.0-beta.1.26.40-preview.30",
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.26.40-preview.30"
   },
   "license": "MIT"
 }