warcraft-3-w3ts-utils 0.1.3 → 0.1.4

package/dist/utils/item.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unitHasItem = unitHasItem;
+exports.trig_itemRecipeSystem = trig_itemRecipeSystem;
+const w3ts_1 = require("w3ts");
+const misc_1 = require("./misc");
+/**
+ * Checks if the unit has an item in their item slots
+ * @param u
+ * @param itemTypeId
+ * @returns
+ */
+function unitHasItem(u, itemTypeId) {
+    for (let x = 0; x < 6; x++) {
+        if (u.getItemInSlot(x)?.typeId === itemTypeId) {
+            return true;
+        }
+    }
+    return false;
+}
+// Player should pick up recipes when needed. if they are missing items then the recipe cost is refunded
+function trig_itemRecipeSystem() {
+    //takes a set of items
+    //unit or unit clicks
+    const t = w3ts_1.Trigger.create();
+    t.registerAnyUnitEvent(EVENT_PLAYER_UNIT_PICKUP_ITEM);
+    t.addAction(() => {
+        const recipeItem = w3ts_1.Item.fromEvent();
+        const unit = w3ts_1.Unit.fromHandle(GetTriggerUnit());
+        if (!unit || !recipeItem) {
+            return;
+        }
+        //for every item they have, if any has the word recipe, then we check to see if they have the items needed to satisfy the recipe
+        for (let x = 0; x < 6; x++) {
+            const currItem = unit?.getItemInSlot(x);
+            if (currItem?.name.toLowerCase().includes("recipe")) {
+                checkItemRecipeRequirements(unit, currItem);
+            }
+        }
+    });
+}
+function checkItemRecipeRequirements(unit, recipeItem) {
+    if (recipeItem.name.toLowerCase().includes("recipe")) {
+        let requiredItems = null;
+        let itemToCreateId = null;
+        for (const [key, value] of itemRecipesMap.entries()) {
+            if (key.recipeId === recipeItem.typeId) {
+                requiredItems = value;
+                itemToCreateId = key.itemId;
+            }
+        }
+        if (!requiredItems) {
+            print("Missing required items data for the recipe ", recipeItem.name);
+            return;
+        }
+        /**
+         * unique list of item types and their quantity and charges that we found on the unit
+         */
+        const matchingItems = [];
+        //Loop through the units item slots
+        for (let x = 0; x < 6; x++) {
+            const currItem = unit?.getItemInSlot(x);
+            //Check that the current item matches at least one of the item types in the requirement list
+            if (currItem && requiredItems.some((req) => req.itemTypeId === currItem.typeId)) {
+                const alreadyStoredItemIndex = matchingItems.findIndex((itemReq) => itemReq.itemTypeId === currItem.typeId);
+                //If we already came across this item in the unit inventory then increment the quantity
+                if (alreadyStoredItemIndex && matchingItems[alreadyStoredItemIndex]) {
+                    matchingItems[alreadyStoredItemIndex].quantity++;
+                }
+                //otherwise it is our first match with this item type, so add it to our array of matching items
+                else {
+                    matchingItems.push({ itemTypeId: currItem.typeId, quantity: 1, charges: 0 });
+                }
+            }
+        }
+        //Check that every item required is found in the units inventory satisfies the quantity requirement for the recipe
+        const satisfiesRecipe = requiredItems.every((reqItemData) => {
+            const matching = matchingItems?.find((matchingItemData) => matchingItemData.itemTypeId === reqItemData.itemTypeId);
+            if (matching) {
+                return matching.quantity >= reqItemData.quantity;
+            }
+            return false;
+        }) && matchingItems.length > 0;
+        if (!itemToCreateId) {
+            print("Missing the item type id of the item to create for this recipe: ", recipeItem.name);
+        }
+        //destroys more items than it needds to
+        if (satisfiesRecipe && itemToCreateId) {
+            //add the item
+            requiredItems.forEach((req) => {
+                for (let x = 0; x < req.quantity; x++) {
+                    for (let x = 0; x < 6; x++) {
+                        const currItem = unit?.getItemInSlot(x);
+                        if (currItem?.typeId === req.itemTypeId) {
+                            currItem?.destroy();
+                            break;
+                        }
+                    }
+                }
+            });
+            recipeItem.destroy();
+            unit.addItemById(itemToCreateId);
+            (0, misc_1.useTempEffect)(w3ts_1.Effect.create("Abilities\\Spells\\Other\\Monsoon\\MonsoonBoltTarget.mdl", unit.x, unit.y));
+            const clap = w3ts_1.Effect.create("Abilities\\Spells\\Human\\Thunderclap\\ThunderClapCaster.mdl", unit.x, unit.y);
+            clap?.setScaleMatrix(0.5, 0.5, 0.5);
+            (0, misc_1.useTempEffect)(clap);
+        }
+        if (!satisfiesRecipe) {
+            //refund the gold
+            (0, misc_1.notifyPlayer)(`Missing recipe requirements for: ${recipeItem.name}.`);
+        }
+        //use if or rf to store item gold cost in the world editor
+    }
+}
+const itemRecipesMap = new Map([
+// [
+//     { recipeId: ITEMS.recipe_blinkTreads, itemId: ITEMS.blinkTreads },
+//     [
+//         { itemTypeId: ITEMS.bootsOfSpeed, quantity: 1, charges: 0 }, //
+//         { itemTypeId: ITEMS.blinkDagger, quantity: 1, charges: 0 }, //
+//     ],
+// ],
+]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXRlbS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9pdGVtLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBU0Esa0NBUUM7QUFHRCxzREFzQkM7QUExQ0QsK0JBQW1EO0FBQ25ELGlDQUFxRDtBQUVyRDs7Ozs7R0FLRztBQUNILFNBQWdCLFdBQVcsQ0FBQyxDQUFPLEVBQUUsVUFBa0I7SUFDbkQsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDO1FBQ3pCLElBQUksQ0FBQyxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsRUFBRSxNQUFNLEtBQUssVUFBVSxFQUFFLENBQUM7WUFDNUMsT0FBTyxJQUFJLENBQUM7UUFDaEIsQ0FBQztJQUNMLENBQUM7SUFFRCxPQUFPLEtBQUssQ0FBQztBQUNqQixDQUFDO0FBRUQsd0dBQXdHO0FBQ3hHLFNBQWdCLHFCQUFxQjtJQUNqQyxzQkFBc0I7SUFDdEIscUJBQXFCO0lBQ3JCLE1BQU0sQ0FBQyxHQUFHLGNBQU8sQ0FBQyxNQUFNLEVBQUUsQ0FBQztJQUUzQixDQUFDLENBQUMsb0JBQW9CLENBQUMsNkJBQTZCLENBQUMsQ0FBQztJQUN0RCxDQUFDLENBQUMsU0FBUyxDQUFDLEdBQUcsRUFBRTtRQUNiLE1BQU0sVUFBVSxHQUFHLFdBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztRQUNwQyxNQUFNLElBQUksR0FBRyxXQUFJLENBQUMsVUFBVSxDQUFDLGNBQWMsRUFBRSxDQUFDLENBQUM7UUFFL0MsSUFBSSxDQUFDLElBQUksSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQ3ZCLE9BQU87UUFDWCxDQUFDO1FBRUQsZ0lBQWdJO1FBQ2hJLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQztZQUN6QixNQUFNLFFBQVEsR0FBRyxJQUFJ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

package/dist/utils/math.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @deprecated
+ * @param a
+ * @param b
+ * @returns
+ */
+export declare function distanceBetweenCoords(a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}): number;

package/dist/utils/math.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceBetweenCoords = distanceBetweenCoords;
+/**
+ * @deprecated
+ * @param a
+ * @param b
+ * @returns
+ */
+function distanceBetweenCoords(a, b) {
+    const deltaX = a.x - b.x;
+    const deltaY = a.y - b.y;
+    const squaredDist = Math.pow(deltaX, 2) + Math.pow(deltaY, 2);
+    const dist = Math.sqrt(squaredDist);
+    return dist;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9tYXRoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBTUEsc0RBT0M7QUFiRDs7Ozs7R0FLRztBQUNILFNBQWdCLHFCQUFxQixDQUFDLENBQTJCLEVBQUUsQ0FBMkI7SUFDMUYsTUFBTSxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3pCLE1BQU0sTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN6QixNQUFNLFdBQVcsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQztJQUM5RCxNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBRXBDLE9BQU8sSUFBSSxDQUFDO0FBQ2hCLENBQUMifQ==

package/dist/utils/minimapIcons.d.ts

@@ -0,0 +1,13 @@
+export type MINIMAP_ICONS = "UI\\Minimap\\MiniMap-ControlPoint.mdl" | "UI\\Minimap\\MiniMap-QuestGiver.mdl" | "UI\\Minimap\\Minimap-QuestObjectiveBonus.mdl" | "UI\\Minimap\\Minimap-QuestObjectivePrimary.mdl" | "UI\\Minimap\\Minimap-QuestTurnIn.mdl" | "UI\\Minimap\\MiniMap-Hero.mdl" | "UI\\Minimap\\Minimap-Ping.mdl" | "UI\\Minimap\\MiniMap-Item.mdl" | "UI\\Minimap\\MiniMap-NeutralBuilding.mdl";
+export declare enum MinimapIconPath {
+    controlPoint = "UI\\Minimap\\MiniMap-ControlPoint.mdl",
+    questGiver = "UI\\Minimap\\MiniMap-QuestGiver.mdl",
+    questObjectiveBonus = "UI\\Minimap\\Minimap-QuestObjectiveBonus.mdl",
+    questObjectivePrimary = "UI\\Minimap\\Minimap-QuestObjectivePrimary.mdl",
+    questTurnIn = "UI\\Minimap\\Minimap-QuestTurnIn.mdl",
+    hero = "UI\\Minimap\\MiniMap-Hero.mdl",
+    item = "UI\\Minimap\\MiniMap-Item.mdl",
+    neutralBuilding = "UI\\Minimap\\MiniMap-NeutralBuilding.mdl",
+    ping = "UI\\Minimap\\Minimap-Ping.mdl"
+}
+export declare const minimapIconPathsSet: Set<MINIMAP_ICONS>;

package/dist/utils/minimapIcons.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minimapIconPathsSet = exports.MinimapIconPath = void 0;
+var MinimapIconPath;
+(function (MinimapIconPath) {
+    MinimapIconPath["controlPoint"] = "UI\\Minimap\\MiniMap-ControlPoint.mdl";
+    MinimapIconPath["questGiver"] = "UI\\Minimap\\MiniMap-QuestGiver.mdl";
+    MinimapIconPath["questObjectiveBonus"] = "UI\\Minimap\\Minimap-QuestObjectiveBonus.mdl";
+    MinimapIconPath["questObjectivePrimary"] = "UI\\Minimap\\Minimap-QuestObjectivePrimary.mdl";
+    MinimapIconPath["questTurnIn"] = "UI\\Minimap\\Minimap-QuestTurnIn.mdl";
+    MinimapIconPath["hero"] = "UI\\Minimap\\MiniMap-Hero.mdl";
+    MinimapIconPath["item"] = "UI\\Minimap\\MiniMap-Item.mdl";
+    MinimapIconPath["neutralBuilding"] = "UI\\Minimap\\MiniMap-NeutralBuilding.mdl";
+    MinimapIconPath["ping"] = "UI\\Minimap\\Minimap-Ping.mdl";
+})(MinimapIconPath || (exports.MinimapIconPath = MinimapIconPath = {}));
+exports.minimapIconPathsSet = new Set([
+    "UI\\Minimap\\MiniMap-ControlPoint.mdl",
+    "UI\\Minimap\\MiniMap-Hero.mdl",
+    "UI\\Minimap\\MiniMap-Item.mdl",
+    "UI\\Minimap\\MiniMap-NeutralBuilding.mdl",
+    "UI\\Minimap\\MiniMap-QuestGiver.mdl",
+    "UI\\Minimap\\Minimap-Ping.mdl",
+    "UI\\Minimap\\Minimap-QuestObjectiveBonus.mdl",
+    "UI\\Minimap\\Minimap-QuestObjectivePrimary.mdl",
+    "UI\\Minimap\\Minimap-QuestTurnIn.mdl",
+]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWluaW1hcEljb25zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL21pbmltYXBJY29ucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFXQSxJQUFZLGVBVVg7QUFWRCxXQUFZLGVBQWU7SUFDdkIseUVBQXNELENBQUE7SUFDdEQscUVBQWtELENBQUE7SUFDbEQsdUZBQW9FLENBQUE7SUFDcEUsMkZBQXdFLENBQUE7SUFDeEUsdUVBQW9ELENBQUE7SUFDcEQseURBQXNDLENBQUE7SUFDdEMseURBQXNDLENBQUE7SUFDdEMsK0VBQTRELENBQUE7SUFDNUQseURBQXNDLENBQUE7QUFDMUMsQ0FBQyxFQVZXLGVBQWUsK0JBQWYsZUFBZSxRQVUxQjtBQUVZLFFBQUEsbUJBQW1CLEdBQUcsSUFBSSxHQUFHLENBQWdCO0lBQ3RELHVDQUF1QztJQUN2QywrQkFBK0I7SUFDL0IsK0JBQStCO0lBQy9CLDBDQUEwQztJQUMxQyxxQ0FBcUM7SUFDckMsK0JBQStCO0lBQy9CLDhDQUE4QztJQUM5QyxnREFBZ0Q7SUFDaEQsc0NBQXNDO0NBQ3pDLENBQUMsQ0FBQyJ9

package/dist/utils/misc.d.ts

@@ -0,0 +1,56 @@
+import { Effect, MapPlayer, Unit } from "w3ts";
+type ProperColors = "goldenrod" | "magenta" | "green" | "yellow" | "red" | "player1-red" | "player2-blue" | "player3-teal" | "player4-purple" | "player5-yellow" | "player6-orange";
+export declare function tColor(text: string | number, color?: ProperColors | null, hex?: PlayerColorHex | string | null, alpha?: string): string;
+/**
+ * Colorizes the string according to the map player
+ */
+export declare function ptColor(player: MapPlayer, text: string): string;
+export declare enum PlayerColorHex {
+    Red = "ff0303",
+    Blue = "0042ff",
+    Teal = "1be7ba",
+    Purple = "550081",
+    Yellow = "fefc00",
+    Orange = "fe890d",
+    Green = "21bf00",
+    Pink = "e45caf",
+    Gray = "939596",
+    LightBlue = "7ebff1",
+    DarkGreen = "106247",
+    Brown = "4f2b05",
+    Maroon = "9c0000",
+    Navy = "0000c3",
+    Turquoise = "00ebff",
+    Violet = "bd00ff",
+    Wheat = "ecce87",
+    Peach = "f7a58b",
+    Mint = "bfff81",
+    Lavender = "dbb8eb",
+    Coal = "4f5055",
+    Snow = "ecf0ff",
+    Emerald = "00781e",
+    Peanut = "a56f34",
+    Black = "2e2d2e"
+}
+/**
+ * Standardized format for notifying player of events.
+ */
+export declare function notifyPlayer(msg: string): void;
+export declare function displayError(msg: string): void;
+/**
+ * Returns degrees or radians?
+ */
+export declare function getRelativeAngleToUnit(unit: Unit, relativeUnit: Unit): number;
+/**
+ * Manages state of effects in this context so you don't have to!
+ */
+export declare function useEffects(): {
+    addEffect: (effect: Effect | undefined) => void;
+    /**
+     * @returns reference to effects array
+     */
+    getEffects: () => Effect[];
+    destroyAllEffects: () => void;
+};
+export declare function useTempEffect(effect: Effect | undefined, duration?: number): void;
+export {};

package/dist/utils/misc.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlayerColorHex = void 0;
+exports.tColor = tColor;
+exports.ptColor = ptColor;
+exports.notifyPlayer = notifyPlayer;
+exports.displayError = displayError;
+exports.getRelativeAngleToUnit = getRelativeAngleToUnit;
+exports.useEffects = useEffects;
+exports.useTempEffect = useTempEffect;
+const w3ts_1 = require("w3ts");
+function tColor(text, color, hex, alpha) {
+    if (color) {
+        return `|cff${properColorHexes.get(color) || "FFFFFF"}${alpha || ""}${text}|r`;
+    }
+    else if (hex) {
+        return `|cff${hex}${alpha || ""}${text}|r`;
+    }
+    return String(text);
+}
+/**
+ * Colorizes the string according to the map player
+ */
+function ptColor(player, text) {
+    return `${tColor(text, undefined, playerColors[player.id])}`;
+}
+const properColorHexes = new Map([
+    ["goldenrod", "ffcc00"],
+    ["green", "00FF00"],
+    ["yellow", "FFFF00"],
+    ["red", "FF0000"],
+    ["magenta", "FF00FF"],
+    ["player1-red", "ff0303"],
+    ["player2-blue", "0042ff"],
+    ["player3-teal", "1ce6b9"],
+    ["player4-purple", "540081"],
+    ["player5-yellow", "fffc00"],
+    ["player6-orange", "fe8a0e"],
+]);
+// enum PlayerColors {
+//     Player1 = "ff0303", // Red
+//     Player2 = "0042ff", // Blue
+//     Player3 = "1be7ba", // Teal
+//     Player4 = "550081", // Purple
+//     Player5 = "fefc00", // Yellow
+//     Player6 = "fe890d", // Orange
+//     Player7 = "21bf00", // Green
+//     Player8 = "e45caf", // Pink
+//     Player9 = "939596", // Gray
+//     Player10 = "7ebff1", // Light Blue
+//     Player11 = "106247", // Dark Green
+//     Player12 = "4f2b05", // Brown
+//     Player13 = "9c0000", // Maroon
+//     Player14 = "0000c3", // Navy
+//     Player15 = "00ebff", // Turquoise
+//     Player16 = "bd00ff", // Violet
+//     Player17 = "ecce87", // Wheat
+//     Player18 = "f7a58b", // Peach
+//     Player19 = "bfff81", // Mint
+//     Player20 = "dbb8eb", // Lavender
+//     Player21 = "4f5055", // Coal
+//     Player22 = "ecf0ff", // Snow
+//     Player23 = "00781e", // Emerald
+//     Player24 = "a56f34", // Peanut
+//     PlayerNeutral = "2e2d2e", // Black
+// }
+var PlayerColorHex;
+(function (PlayerColorHex) {
+    PlayerColorHex["Red"] = "ff0303";
+    PlayerColorHex["Blue"] = "0042ff";
+    PlayerColorHex["Teal"] = "1be7ba";
+    PlayerColorHex["Purple"] = "550081";
+    PlayerColorHex["Yellow"] = "fefc00";
+    PlayerColorHex["Orange"] = "fe890d";
+    PlayerColorHex["Green"] = "21bf00";
+    PlayerColorHex["Pink"] = "e45caf";
+    PlayerColorHex["Gray"] = "939596";
+    PlayerColorHex["LightBlue"] = "7ebff1";
+    PlayerColorHex["DarkGreen"] = "106247";
+    PlayerColorHex["Brown"] = "4f2b05";
+    PlayerColorHex["Maroon"] = "9c0000";
+    PlayerColorHex["Navy"] = "0000c3";
+    PlayerColorHex["Turquoise"] = "00ebff";
+    PlayerColorHex["Violet"] = "bd00ff";
+    PlayerColorHex["Wheat"] = "ecce87";
+    PlayerColorHex["Peach"] = "f7a58b";
+    PlayerColorHex["Mint"] = "bfff81";
+    PlayerColorHex["Lavender"] = "dbb8eb";
+    PlayerColorHex["Coal"] = "4f5055";
+    PlayerColorHex["Snow"] = "ecf0ff";
+    PlayerColorHex["Emerald"] = "00781e";
+    PlayerColorHex["Peanut"] = "a56f34";
+    PlayerColorHex["Black"] = "2e2d2e";
+})(PlayerColorHex || (exports.PlayerColorHex = PlayerColorHex = {}));
+const playerColors = [
+    "ff0303", // Player 1: Red
+    "0042ff", // Player 2: Blue
+    "1be7ba", // Player 3: Teal
+    "550081", // Player 4: Purple
+    "fefc00", // Player 5: Yellow
+    "fe890d", // Player 6: Orange
+    "21bf00", // Player 7: Green
+    "e45caf", // Player 8: Pink
+    "939596", // Player 9: Gray
+    "7ebff1", // Player 10: Light Blue
+    "106247", // Player 11: Dark Green
+    "4f2b05", // Player 12: Brown
+    "9c0000", // Player 13: Maroon
+    "0000c3", // Player 14: Navy
+    "00ebff", // Player 15: Turquoise
+    "bd00ff", // Player 16: Violet
+    "ecce87", // Player 17: Wheat
+    "f7a58b", // Player 18: Peach
+    "bfff81", // Player 19: Mint
+    "dbb8eb", // Player 20: Lavender
+    "4f5055", // Player 21: Coal
+    "ecf0ff", // Player 22: Snow
+    "00781e", // Player 23: Emerald
+    "a56f34", // Player 24: Peanut
+    "2e2d2e", // Player Neutral: Black
+];
+/**
+ * Standardized format for notifying player of events.
+ */
+function notifyPlayer(msg) {
+    print(`${tColor("!", "goldenrod")} - ${msg}`);
+}
+function displayError(msg) {
+    print(`[ ${tColor("WARNING", "red")} ]: ${msg}`);
+}
+/**
+ * Returns degrees or radians?
+ */
+function getRelativeAngleToUnit(unit, relativeUnit) {
+    const locA = GetUnitLoc(unit.handle);
+    const locB = GetUnitLoc(relativeUnit.handle);
+    const angle = AngleBetweenPoints(locA, locB);
+    RemoveLocation(locA);
+    RemoveLocation(locB);
+    return angle;
+}
+/**
+ * Manages state of effects in this context so you don't have to!
+ */
+function useEffects() {
+    const effects = [];
+    return {
+        addEffect: (effect) => {
+            if (effect) {
+                effects.push(effect);
+            }
+        },
+        /**
+         * @returns reference to effects array
+         */
+        getEffects: () => {
+            return effects;
+        },
+        destroyAllEffects: () => {
+            effects.forEach((e) => {
+                e.destroy();
+            });
+        },
+    };
+}
+function useTempEffect(effect, duration = 1.5) {
+    if (effect) {
+        const timer = w3ts_1.Timer.create();
+        timer.start(duration, false, () => {
+            effect.destroy();
+            timer.destroy();
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWlzYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9taXNjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUlBLHdCQVFDO0FBS0QsMEJBRUM7QUFzR0Qsb0NBRUM7QUFFRCxvQ0FFQztBQUtELHdEQVNDO0FBS0QsZ0NBcUJDO0FBRUQsc0NBU0M7QUFsTEQsK0JBQXNEO0FBSXRELFNBQWdCLE1BQU0sQ0FBQyxJQUFxQixFQUFFLEtBQTJCLEVBQUUsR0FBb0MsRUFBRSxLQUFjO0lBQzNILElBQUksS0FBSyxFQUFFLENBQUM7UUFDUixPQUFPLE9BQU8sZ0JBQWdCLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLFFBQVEsR0FBRyxLQUFLLElBQUksRUFBRSxHQUFHLElBQUksSUFBSSxDQUFDO0lBQ25GLENBQUM7U0FBTSxJQUFJLEdBQUcsRUFBRSxDQUFDO1FBQ2IsT0FBTyxPQUFPLEdBQUcsR0FBRyxLQUFLLElBQUksRUFBRSxHQUFHLElBQUksSUFBSSxDQUFDO0lBQy9DLENBQUM7SUFFRCxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUN4QixDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixPQUFPLENBQUMsTUFBaUIsRUFBRSxJQUFZO0lBQ25ELE9BQU8sR0FBRyxNQUFNLENBQUMsSUFBSSxFQUFFLFNBQVMsRUFBRSxZQUFZLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNqRSxDQUFDO0FBRUQsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLEdBQUcsQ0FBdUI7SUFDbkQsQ0FBQyxXQUFXLEVBQUUsUUFBUSxDQUFDO0lBQ3ZCLENBQUMsT0FBTyxFQUFFLFFBQVEsQ0FBQztJQUNuQixDQUFDLFFBQVEsRUFBRSxRQUFRLENBQUM7SUFDcEIsQ0FBQyxLQUFLLEVBQUUsUUFBUSxDQUFDO0lBQ2pCLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQztJQUNyQixDQUFDLGFBQWEsRUFB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

package/dist/utils/physics.d.ts

@@ -0,0 +1,52 @@
+import { Effect, Unit } from "w3ts";
+interface ApplyForceConfig {
+    /**
+     * Default: 0
+     */
+    sustainedForceDuration?: number;
+    /**
+     * Default: -2400 units per second
+     */
+    frictionConstant?: number;
+    /**
+     * The unit will not phase through unpathable areas
+     */
+    obeyPathing?: boolean;
+    whileActive?: (currentSpeed?: number, timeElapsed?: number) => void;
+    onStart?: (currentSpeed?: number, timeElapsed?: number) => void;
+    onEnd?: (currentSpeed?: number, timeElapsed?: number) => void;
+    /**
+     *
+     */
+    targetSpeed?: number;
+    /**
+     * In seconds
+     */
+    accelerationTime?: number;
+    /**
+     * This will be used to decide if the unit the force is applied on is allowed to deviate from their current path.
+     */
+    strictPathing?: boolean;
+    animationIndexNumber?: number;
+    dummyUnitPlayerIndex: number;
+    dummyUnitFourCC: number;
+}
+/**
+ * @param angle degrees
+ * @param unit
+ * @param initialSpeed meters per second
+ * @param affectHeight determines whether or not to change unit height whilst force is applied
+ */
+export declare function applyForce(angle: number, unit: Unit, initialSpeed: number, config: ApplyForceConfig): {
+    destroyForceEffect: (runOnEnd?: boolean) => void;
+};
+/**
+ * @param angle degrees
+ * @param effect
+ * @param initialSpeed meters per second
+ * @param affectHeight determines whether or not to change unit height whilst force is applied
+ */
+export declare function applyForceForEffect(angle: number, effect: Effect, initialSpeed: number, config?: ApplyForceConfig): {
+    destroyForceEffect: () => void;
+};
+export {};