feat: add quick fill clipboard foundation

Author: Eric Blackman

Canopy[BP]/scripts/src/classes/QuickFillClipboard.js

@@ -0,0 +1,100 @@
+import { QuickFillContainerPolicy } from "./QuickFillContainerPolicy";
+
+export class QuickFillClipboard {
+    static WildcardAll = 'all';
+
+    constructor({
+        shape,
+        slots = [],
+        wildcardMask = []
+    } = {}) {
+        this.shape = shape;
+        this.slots = slots;
+        this.wildcardMask = wildcardMask;
+    }
+
+    static createDefault() {
+        return new QuickFillClipboard({
+            shape: QuickFillContainerPolicy.AdaptiveShape,
+            wildcardMask: this.WildcardAll
+        });
+    }
+
+    static copy(block, container) {
+        if (!block || !container)
+            return;
+
+        const shape = QuickFillContainerPolicy.getShape(
+            block,
+            container
+        );
+
+        if (!shape)
+            return;
+
+        const slots = [];
+
+        for (let slot = 0; slot < container.size; slot++) {
+            const itemStack = container.getItem(slot);
+
+            slots.push(itemStack?.clone());
+        }
+
+        return new QuickFillClipboard({
+            shape,
+            slots,
+            wildcardMask: new Array(container.size).fill(false)
+        });
+    }
+
+    isCompatibleWith(block, container) {
+        const targetShape = QuickFillContainerPolicy.getShape(
+            block,
+            container
+        );
+
+        return QuickFillContainerPolicy.isCompatible(
+            this.shape,
+            targetShape
+        );
+    }
+
+    isWildcard(slot) {
+        if (this.wildcardMask === QuickFillClipboard.WildcardAll)
+            return true;
+
+        return this.wildcardMask[slot] === true;
+    }
+
+    resolveSlot(slot, heldItem) {
+        if (this.isWildcard(slot))
+            return heldItem?.clone();
+
+        return this.slots[slot]?.clone();
+    }
+
+    getSlotCount(container) {
+        if (this.shape === QuickFillContainerPolicy.AdaptiveShape)
+            return container?.size ?? 0;
+
+        return this.slots.length;
+    }
+
+    hasWildcards() {
+        if (this.wildcardMask === QuickFillClipboard.WildcardAll)
+            return true;
+
+        return this.wildcardMask.some(Boolean);
+    }
+
+    clone() {
+        return new QuickFillClipboard({
+            shape: this.shape,
+            slots: this.slots.map(itemStack => itemStack?.clone()),
+            wildcardMask:
+                this.wildcardMask === QuickFillClipboard.WildcardAll
+                    ? QuickFillClipboard.WildcardAll
+                    : [...this.wildcardMask]
+        });
+    }
+}

Canopy[BP]/scripts/src/classes/QuickFillClipboardController.js

@@ -0,0 +1,128 @@
+import { GameMode } from "@minecraft/server";
+import { QuickFillClipboard } from "./QuickFillClipboard";
+import { QuickFillClipboardExecutor } from "./QuickFillClipboardExecutor";
+import { QuickFillClipboardStore } from "./QuickFillClipboardStore";
+
+export class QuickFillClipboardController {
+    static get(player) {
+        return QuickFillClipboardStore.get(player);
+    }
+
+    static copy(player, block) {
+        const blockInv =
+            block.getComponent('inventory')?.container;
+
+        if (!blockInv)
+            return;
+
+        const clipboard = QuickFillClipboard.copy(
+            block,
+            blockInv
+        );
+
+        if (!clipboard)
+            return;
+
+        QuickFillClipboardStore.set(
+            player,
+            clipboard
+        );
+
+        player.onScreenDisplay.setActionBar(
+            `§7Quick Fill: copied §a${blockInv.size}§7-slot clipboard.`
+        );
+    }
+
+    static apply(player, block, clipboard, isSneaking) {
+        const playerInv =
+            player.getComponent('inventory')?.container;
+
+        const blockInv =
+            block.getComponent('inventory')?.container;
+
+        if (!playerInv || !blockInv)
+            return;
+
+        const result = this.execute(
+            player,
+            block,
+            playerInv,
+            blockInv,
+            clipboard,
+            isSneaking
+        );
+
+        this.sendFeedback(
+            player,
+            result,
+            isSneaking
+        );
+    }
+
+    static execute(
+        player,
+        block,
+        playerInv,
+        blockInv,
+        clipboard,
+        isSneaking
+    ) {
+        if (isSneaking) {
+            return QuickFillClipboardExecutor.remove(
+                playerInv,
+                block,
+                blockInv,
+                clipboard
+            );
+        }
+
+        if (player.getGameMode() === GameMode.Creative) {
+            return QuickFillClipboardExecutor.applyCreative(
+                block,
+                blockInv,
+                clipboard
+            );
+        }
+
+        return QuickFillClipboardExecutor.applySurvival(
+            playerInv,
+            block,
+            blockInv,
+            clipboard
+        );
+    }
+    static deactivate(player) {
+        if (!QuickFillClipboardStore.has(player))
+            return false;
+
+        QuickFillClipboardStore.clear(player);
+        player.onScreenDisplay.setActionBar("Quick Fill clipboard deactivated.");
+        return true;
+    }
+    static sendFeedback(player, result, isRemoving) {
+        if (result?.incompatible) {
+            player.onScreenDisplay.setActionBar(
+                '§cQuick Fill: incompatible container.'
+            );
+            return;
+        }
+
+        if (result?.insufficient) {
+            player.onScreenDisplay.setActionBar(
+                '§cQuick Fill: insufficient resources.'
+            );
+            return;
+        }
+
+        if (!result?.changedSlots)
+            return;
+
+        const action = isRemoving
+            ? 'removed'
+            : 'applied';
+
+        player.onScreenDisplay.setActionBar(
+            `§7Quick Fill: ${action} clipboard (§a${result.changedSlots}§7 slots).`
+        );
+    }
+}