libram 0.8.32 → 0.8.34

package/dist/resources/2010/CrownOfThrones.d.ts

@@ -1,6 +1,6 @@
 import { Familiar, Item } from "kolmafia";
 import { NumericModifier } from "../../modifierTypes";
-export declare type FamiliarRider = {
+export type FamiliarRider = {
     familiar: Familiar;
     drops: number | Item[] | Map<Item, number>;
     probability: number;
@@ -17,7 +17,7 @@ export declare const ridingFamiliars: readonly FamiliarRider[];
  * @returns Rider value (in meat)
  */
 export declare function valueRider(rider: FamiliarRider, modifierValueFunction: (familiar: Familiar) => number, dropsValueFunction: (drops: Item[] | Map<Item, number>) => number, ignoreLimitedDrops?: boolean): number;
-declare type RiderMode = {
+type RiderMode = {
     modifierValueFunction: (familiar: Familiar) => number;
     dropsValueFunction: (drops: Item[] | Map<Item, number>) => number;
     ignoreLimitedDrops: boolean;

package/dist/resources/2012/ReagnimatedGnome.d.ts

@@ -10,7 +10,7 @@ export declare const bodyParts: {
     readonly kgnee: Item;
     readonly foot: Item;
 };
-export declare type BodyPart = keyof typeof bodyParts;
+export type BodyPart = keyof typeof bodyParts;
 /**
  * @returns Reagnimated Gnome parts that have already been retrieved from the arena
  */

package/dist/resources/2013/Florist.d.ts

@@ -1,7 +1,7 @@
 import { Location } from "kolmafia";
 import { EnvironmentType } from "../../lib";
 import { Modifiers } from "../../modifier";
-declare type SpecialFlowerAbility = "Delevels Enemy" | "Blocks Attacks" | "Poison";
+type SpecialFlowerAbility = "Delevels Enemy" | "Blocks Attacks" | "Poison";
 declare class Flower {
     name: string;
     id: number;

package/dist/resources/2014/CrimboShrub.d.ts

@@ -7,7 +7,7 @@ declare const Toppers: {
     readonly Mysticality: 2;
     readonly Moxie: 3;
 };
-declare type ShrubTopper = keyof typeof Toppers;
+type ShrubTopper = keyof typeof Toppers;
 declare const Lights: {
     readonly "Prismatic Damage": 1;
     readonly "Hot Damage": 2;
@@ -16,19 +16,19 @@ declare const Lights: {
     readonly "Spooky Damage": 5;
     readonly "Sleaze Damage": 6;
 };
-declare type ShrubLights = keyof typeof Lights;
+type ShrubLights = keyof typeof Lights;
 declare const Garland: {
     readonly "HP Regen": 1;
     readonly "PvP Fights": 2;
     readonly Blocking: 3;
 };
-declare type ShrubGarland = keyof typeof Garland;
+type ShrubGarland = keyof typeof Garland;
 declare const Gifts: {
     readonly "Yellow Ray": 1;
     readonly "Red Ray": 2;
     readonly Gifts: 3;
 };
-declare type ShrubGifts = keyof typeof Gifts;
+type ShrubGifts = keyof typeof Gifts;
 /**
  * Decorates our Crimbo Shrub with the chosen decour, if able
  *

package/dist/resources/2015/ChateauMantegna.d.ts

@@ -22,9 +22,9 @@ export declare function fightPainting(...combatParams: CombatParams): string;
 export declare const desks: readonly ["fancy stationery set", "Swiss piggy bank", "continental juice bar"];
 export declare const ceilings: readonly ["antler chandelier", "ceiling fan", "artificial skylight"];
 export declare const nightstands: readonly ["foreign language tapes", "bowl of potpourri", "electric muscle stimulator"];
-export declare type Desk = typeof desks[number];
-export declare type Ceiling = typeof ceilings[number];
-export declare type Nightstand = typeof nightstands[number];
+export type Desk = (typeof desks)[number];
+export type Ceiling = (typeof ceilings)[number];
+export type Nightstand = (typeof nightstands)[number];
 /**
  * @returns The currently installed desk in your chateau; `null` for none
  */

package/dist/resources/2015/DeckOfEveryCard.d.ts

@@ -3,7 +3,7 @@
  */
 export declare function have(): boolean;
 export declare const cards: readonly ["X of Clubs", "X of Diamonds", "X of Hearts", "X of Spades", "X of Papayas", "X of Kumquats", "X of Salads", "X of Cups", "X of Coins", "X of Swords", "X of Wands", "XVI - The Tower", "Professor Plum", "Spare Tire", "Extra Tank", "Sheep", "Year of Plenty", "Mine", "Laboratory", "Plains", "Swamp", "Mountain", "Forest", "Island", "Lead Pipe", "Rope", "Wrench", "Candlestick", "Knife", "Revolver", "Gift Card", "1952 Mickey Mantle", "XXI - The World", "III - The Empress", "VI - The Lovers", "Healing Salve", "Dark Ritual", "Lightning Bolt", "Giant Growth", "Ancestral Recall", "XI - Strength", "I - The Magician", "0 - The Fool", "X - The Wheel of Fortune", "The Race Card", "Green Card", "IV - The Emperor", "IX - The Hermit", "Werewolf", "The Hive", "XVII - The Star", "VII - The Chariot", "XV - The Devil", "V - The Hierophant", "Fire Elemental", "Christmas Card", "Go Fish", "Goblin Sapper", "II - The High Priestess", "XIV - Temperance", "XVIII - The Moon", "Hunky Fireman Card", "Aquarius Horoscope", "XII - The Hanged Man", "Suit Warehouse Discount Card", "Pirate Birthday Card", "Plantable Greeting Card", "Slimer Trading Card", "XIII - Death", "Unstable Portal"];
-export declare type Card = typeof cards[number];
+export type Card = (typeof cards)[number];
 /**
  * @returns The number of cards we've drawn so far today--remember, cheating counts as 5
  */

package/dist/resources/2016/SourceTerminal.d.ts

@@ -98,7 +98,7 @@ export declare const Items: Map<Item, string>;
  * @returns Whether the `cliExecute` succeeded
  */
 export declare function extrude(item: Item): boolean;
-declare type Chip = "INGRAM" | "DIAGRAM" | "ASHRAM" | "SCRAM" | "TRIGRAM" | "CRAM" | "DRAM" | "TRAM";
+type Chip = "INGRAM" | "DIAGRAM" | "ASHRAM" | "SCRAM" | "TRIGRAM" | "CRAM" | "DRAM" | "TRAM";
 /**
  * @returns chips currently installed to player's Source Terminal
  */

package/dist/resources/2017/Horsery.d.ts

@@ -3,7 +3,7 @@ import { Modifiers } from "../..";
  * @returns Whether or not the horsery is available
  */
 export declare function have(): boolean;
-export declare type Horse = "pale" | "dark" | "normal" | "crazy";
+export type Horse = "pale" | "dark" | "normal" | "crazy";
 /**
  * @returns Your current horse; `null` if you are horseless
  */

package/dist/resources/2017/Pantogram.d.ts

@@ -7,7 +7,7 @@ export declare function have(): boolean;
  * @returns Do we `have` pantogram pants?
  */
 export declare function havePants(): boolean;
-declare type PantogramAlignment = "Muscle" | "Moxie" | "Mysticality";
+type PantogramAlignment = "Muscle" | "Moxie" | "Mysticality";
 declare const Element: {
     "Hot Resistance: 2": number;
     "Cold Resistance: 2": number;
@@ -15,7 +15,7 @@ declare const Element: {
     "Sleaze Resistance: 2": number;
     "Stench Resistance: 2": number;
 };
-declare type PantogramElement = keyof typeof Element;
+type PantogramElement = keyof typeof Element;
 declare const LeftSacrifice: {
     "Maximum HP: 40": number[];
     "Maximum MP: 20": number[];
@@ -27,7 +27,7 @@ declare const LeftSacrifice: {
     "MP Regen Max: 20": (number | Item)[];
     "Mana Cost: -3": (number | Item)[];
 };
-declare type PantogramSacrificeL = keyof typeof LeftSacrifice;
+type PantogramSacrificeL = keyof typeof LeftSacrifice;
 declare const MiddleSacrifice: {
     "Combat Rate: -5": number[];
     "Combat Rate: 5": number[];
@@ -41,7 +41,7 @@ declare const MiddleSacrifice: {
     "Avatar: Purple": (number | Item)[];
     "Drops Items: true": (number | Item)[];
 };
-declare type PantogramSacrificeM = keyof typeof MiddleSacrifice;
+type PantogramSacrificeM = keyof typeof MiddleSacrifice;
 declare const RightSacrifice: {
     "Weapon Damage: 20": number[];
     "Spell Damage Percent: 20": number[];
@@ -56,8 +56,8 @@ declare const RightSacrifice: {
     "Mysticality Experience Percent: 25": (number | Item)[];
     "Moxie Experience Percent: 25": (number | Item)[];
 };
-declare type PantogramSacrificeR = keyof typeof RightSacrifice;
-declare type Pants = {
+type PantogramSacrificeR = keyof typeof RightSacrifice;
+type Pants = {
     alignment: PantogramAlignment;
     element: PantogramElement;
     leftSac: PantogramSacrificeL;

package/dist/resources/2017/Spacegate.d.ts

@@ -62,7 +62,7 @@ export declare function hazardEquipment(hazards: string): Item[];
  * @returns Whether you successfully acquired all necessary equipment
  */
 export declare function getHazardEquipment(): boolean;
-declare type Vaccine = "Rainbow" | "Broad-Spectrum" | "Emotional" | "Elemental Resistance" | "Stats" | "Monster Level";
+type Vaccine = "Rainbow" | "Broad-Spectrum" | "Emotional" | "Elemental Resistance" | "Stats" | "Monster Level";
 /**
  * Gets the requested Spacegate Vaccine Buff
  *

package/dist/resources/2017/TunnelOfLove.d.ts

@@ -25,9 +25,9 @@ export declare function couldUseLoveEnamorang(): boolean;
  */
 export declare function getLovEnamorangMonster(): Monster | null;
 export declare const LovEnamorang: Copier;
-declare type LOVEquipment = "LOV Eardigan" | "LOV Epaulettes" | "LOV Earring";
-declare type LOVEffect = "Lovebotamy" | "Open Heart Surgery" | "Wandering Eye Surgery";
-declare type LOVExtra = "LOV Enamorang" | "LOV Emotionizer" | "LOV Extraterrestrial Chocolate" | "LOV Echinacea Bouquet" | "LOV Elephant" | "toast" | null;
+type LOVEquipment = "LOV Eardigan" | "LOV Epaulettes" | "LOV Earring";
+type LOVEffect = "Lovebotamy" | "Open Heart Surgery" | "Wandering Eye Surgery";
+type LOVExtra = "LOV Enamorang" | "LOV Emotionizer" | "LOV Extraterrestrial Chocolate" | "LOV Echinacea Bouquet" | "LOV Elephant" | "toast" | null;
 /**
  * Fight all LOV monsters and get buffs/equipment.
  *

package/dist/resources/2018/LatteLoversMembersMug.d.ts

@@ -363,7 +363,7 @@ declare const INGREDIENTS: {
         readonly location: null;
     };
 };
-export declare type Ingredient = keyof typeof INGREDIENTS;
+export type Ingredient = keyof typeof INGREDIENTS;
 /**
  * @returns An array consisting of the Ingredients you've unlocked so far this ascension
  */
@@ -384,7 +384,7 @@ export declare function modifierOf(ingredient: Ingredient): Modifiers;
  * @param ingredient A latte ingredient
  * @returns The location that can be used to unlock said ingredient; null if the ingredient is free
  */
-export declare function locationOf<T extends Ingredient>(ingredient: T): typeof INGREDIENTS[T]["location"];
+export declare function locationOf<T extends Ingredient>(ingredient: T): (typeof INGREDIENTS)[T]["location"];
 /**
  * @returns An array consisting of all Ingredients currently in your latte
  */

package/dist/resources/2018/SongBoom.d.ts

@@ -9,7 +9,7 @@ declare const keywords: {
     "These Fists Were Made for Punchin'": string;
     "Total Eclipse of Your Meat": string;
 };
-export declare type SongBoomSong = keyof typeof keywords | null;
+export type SongBoomSong = keyof typeof keywords | null;
 export declare const songBoomSongs: Set<string>;
 /**
  * @returns The `SongBoomSong` you currently have active; `null` if none is active at this time

package/dist/resources/2019/BeachComb.d.ts

@@ -27,7 +27,7 @@ export declare const head: {
 /**
  * Column starts at 0, rows at 1
  */
-export declare type BeachTile = {
+export type BeachTile = {
     minute: number;
     row: number;
     column: number;

package/dist/resources/2020/RetroCape.d.ts

@@ -21,8 +21,8 @@ declare const Heroes: {
         "Maximum MP": number;
     };
 };
-declare type Hero = keyof typeof Heroes;
-declare type Mode = "hold" | "thrill" | "kiss" | "kill";
+type Hero = keyof typeof Heroes;
+type Mode = "hold" | "thrill" | "kiss" | "kill";
 export declare const currentHero: () => "vampire" | "heck" | "robot";
 export declare const currentMode: () => Mode;
 /**

package/dist/resources/2022/AutumnAton.d.ts

@@ -37,7 +37,7 @@ export declare function availableLocations(): Location[];
  * The mafia names for the autumn-aton upgrades
  */
 export declare const possibleUpgrades: readonly ["leftarm1", "leftleg1", "rightarm1", "rightleg1", "base_blackhat", "cowcatcher", "periscope", "radardish", "dualexhaust"];
-export declare type Upgrade = typeof possibleUpgrades[number];
+export type Upgrade = (typeof possibleUpgrades)[number];
 /**
  * @returns An array containing the upgrades that you currently have on your autumn-aton.
  */

package/dist/resources/2022/JuneCleaver.d.ts

@@ -38,10 +38,10 @@ export declare const choices: readonly [1467, 1468, 1469, 1470, 1471, 1472, 1473
  *
  * @returns An array consisting of the cleaver choice adventures currently in the queue.
  */
-export declare function queue(): typeof choices[number][];
+export declare function queue(): (typeof choices)[number][];
 /**
  * Determines which choices are currently eligible to be encountered with your June cleaver
  *
  * @returns An array consisting of the cleaver choice adventures not currently in the queue.
  */
-export declare function choicesAvailable(): typeof choices[number][];
+export declare function choicesAvailable(): (typeof choices)[number][];

package/dist/resources/2022/TrainSet.d.ts

@@ -112,7 +112,7 @@ export declare function effect(station: Station): Effect | null;
  * @returns The effect associated with given station, under the influence of coal
  */
 export declare function doubledEffect(station: Station): Effect | null;
-export declare type Cycle = Tuple<Station, 8>;
+export type Cycle = Tuple<Station, 8>;
 /**
  * Determines the current configuration of train stations
  *

package/dist/resources/2023/ClosedCircuitPayphone.d.ts

@@ -22,7 +22,7 @@ declare const INGRESS_RIFTS: {
     readonly plains: Location;
     readonly town_right: Location;
 };
-export declare type Ingress = "" | keyof typeof INGRESS_RIFTS;
+export type Ingress = "" | keyof typeof INGRESS_RIFTS;
 /**
  * @returns Your current `shadowRiftIngress`; `null` if none is set this ascension
  */

package/dist/resources/2023/CursedMonkeyPaw.d.ts

@@ -7,7 +7,7 @@ export declare function have(): boolean;
  * @returns The number of monkey paw wishes we have remaining
  */
 export declare function wishes(): number;
-export declare type WishableItemsFilters = Partial<{
+export type WishableItemsFilters = Partial<{
     location: (location: Location) => boolean;
     monster: (monster: Monster) => boolean;
     drop: (itemDrop: {

package/dist/resources/2024/AprilingBandHelmet.d.ts

@@ -4,10 +4,10 @@ import { Effect, Item } from "kolmafia";
  */
 export declare function have(): boolean;
 export declare const MARCHING_SONGS: readonly ["Apriling Band Patrol Beat", "Apriling Band Battle Cadence", "Apriling Band Celebration Bop"];
-export declare type MarchingSong = typeof MARCHING_SONGS[number];
+export type MarchingSong = (typeof MARCHING_SONGS)[number];
 export declare const MARCHING_SONG_EFFECTS: readonly Effect[];
 export declare const INSTRUMENTS: readonly ["Apriling band saxophone", "Apriling band quad tom", "Apriling band tuba", "Apriling band staff", "Apriling band piccolo"];
-export declare type Instrument = typeof INSTRUMENTS[number];
+export type Instrument = (typeof INSTRUMENTS)[number];
 export declare const INSTRUMENT_ITEMS: readonly Item[];
 /**
  * @returns Whether we can currently join a new section of our Apriling band

package/dist/resources/2024/ChestMimic.d.ts

@@ -37,7 +37,7 @@ export declare function differentiate(monster: Monster, ...combatParams: CombatP
 /**
  * Check how many of a monster is available to differentiate into
  *
- * @param monster The monster to differentiate your egg into; may behave weirdly with name collisions
+ * @param monster The monster to differentiate your egg into
  * @returns How many of a Monster we can differentiate
  */
 export declare function differentiableQuantity(monster: Monster): number;

package/dist/resources/2024/ChestMimic.js

@@ -1,8 +1,7 @@
-import { availableAmount, runChoice, runCombat, toMonster, visitUrl, xpath, } from "kolmafia";
+import { itemAmount, runChoice, runCombat, toMonster, visitUrl, xpath, } from "kolmafia";
 import { directlyUse, examine, have as have_ } from "../../lib";
 import { get } from "../../property";
 import { $familiar, $item } from "../../template-string";
-import { clamp } from "../../utils";
 const familiar = $familiar `Chest Mimic`;
 /**
  * @returns Whether you `have` the Chest Mimic familiar.
@@ -110,18 +109,16 @@ export function differentiate(monster, ...combatParams) {
 /**
  * Check how many of a monster is available to differentiate into
  *
- * @param monster The monster to differentiate your egg into; may behave weirdly with name collisions
+ * @param monster The monster to differentiate your egg into
  * @returns How many of a Monster we can differentiate
  */
 export function differentiableQuantity(monster) {
     if (!have_($item `mimic egg`))
         return 0;
-    const regex = new RegExp(`<!-- monsterid: ${monster.id}-->(?:\\s\\((\\d+)\\))?`);
+    const regex = new RegExp(`<!-- monsterid:${monster.id} --> \\((\\d+)\\)`);
     const page = examine($item `mimic egg`);
     const match = page.match(regex);
-    if (!match)
+    if (!match?.[1])
         return 0;
-    if (!match[1])
-        return 1;
-    return clamp(Number(match[1]), 1, availableAmount($item `mimic egg`));
+    return Math.min(Number(match[1]), itemAmount($item `mimic egg`));
 }

package/dist/resources/2024/MayamCalendar.d.ts

@@ -0,0 +1,66 @@
+import { Effect, Item } from "kolmafia";
+export declare const RINGS: readonly [readonly ["yam1", "sword", "eye", "chair", "fur", "vessel"], readonly ["lightning", "bottle", "meat", "wood", "yam2"], readonly ["yam3", "wall", "cheese", "eyepatch"], readonly ["explosion", "clock", "yam4"]];
+export type MayamSymbol = (typeof RINGS)[number][number];
+export type Ring<N extends number> = (typeof RINGS)[N][number];
+export type Combination = [Ring<0>, Ring<1>, Ring<2>, Ring<3>];
+export type CombinationString = `${Ring<0>} ${Ring<1>} ${Ring<2>} ${Ring<3>}`;
+/**
+ * @returns Whether you `have` the Mayam calendar
+ */
+export declare function have(): boolean;
+/**
+ * Determine whether a certain Mayam symbol is available for use today
+ *
+ * @param {MayamSymbol} symbol The symbol to check
+ * @returns Whether or not the given symbol is available for use
+ */
+export declare function available(symbol: MayamSymbol): boolean;
+/**
+ * Determine whether a certain Mayam combination is available for use today
+ *
+ * @param {...Combination} combination The combination to check
+ * @returns Whether or not the given combination is available for use
+ */
+export declare function available(...combination: Combination): boolean;
+/**
+ * @returns The remaining number of uses you have of your Mayam calendar today
+ */
+export declare function remainingUses(): number;
+/**
+ * Enter a combination in the Mayam calendar
+ * @param combination The combination to submit, either as a single string or as a series of symbols
+ * @returns Whether we succeeded in our endeavor
+ */
+export declare function submit(...combination: Combination | [CombinationString]): boolean;
+export declare const RESONANCES: Readonly<{
+    "eye yam2 eyepatch yam4": Item;
+    "vessel yam2 cheese explosion": Item;
+    "yam1 meat cheese yam4": Item;
+    "sword yam2 eyepatch explosion": Item;
+    "fur lightning eyepatch yam4": Item;
+    "yam1 lightning yam3 clock": Item;
+    "fur yam2 wall yam4": Item;
+    "yam1 yam2 yam3 explosion": Item;
+    "yam1 meat eyepatch yam4": Item;
+    "chair yam2 yam3 clock": Effect;
+    "yam1 yam2 cheese clock": Effect;
+}>;
+/**
+ * Find the combination needed to get a particular resonance
+ * @param target The Item or Effect granted by the resonance
+ * @returns The combination needed, or null if none such exists
+ */
+export declare function resonanceFor(target: Item | Effect): Combination | null;
+/**
+ * Determines whether an item can be obtained via resonance at this moment
+ * @param target The target Item or Effect for your resonance
+ * @returns Whether or not you can currently use that resonance
+ */
+export declare function resonanceAvailable(target: Item | Effect): boolean;
+/**
+ * Determine what Item or Effect results from a particular resonance
+ *
+ * @param combination The combination to check, either as a single string or a series of symbols
+ * @returns The Item or Effect of the resonance, if it is indeed a resonance; `null` otherwise
+ */
+export declare function getResonanceResult(...combination: Combination | [CombinationString]): Item | Effect | null;

package/dist/resources/2024/MayamCalendar.js

@@ -0,0 +1,92 @@
+import { cliExecute } from "kolmafia";
+import { have as have_ } from "../../lib";
+import { get } from "../../property";
+import { $effect, $item } from "../../template-string";
+export const RINGS = Object.freeze([
+    ["yam1", "sword", "eye", "chair", "fur", "vessel"],
+    ["lightning", "bottle", "meat", "wood", "yam2"],
+    ["yam3", "wall", "cheese", "eyepatch"],
+    ["explosion", "clock", "yam4"],
+]);
+/**
+ * @returns Whether you `have` the Mayam calendar
+ */
+export function have() {
+    return have_($item `Mayam Calendar`);
+}
+const symbolsUsed = () => get("_mayamSymbolsUsed").split(",");
+/**
+ * Determine whether certain Mayam symbols are available for use today
+ *
+ * @param {...MayamSymbol[]} symbols The symbols to check
+ * @returns Whether or not the given symbols are all available for use
+ */
+export function available(...symbols) {
+    return symbols.every((symbol) => !symbolsUsed().includes(symbol));
+}
+/**
+ * @returns The remaining number of uses you have of your Mayam calendar today
+ */
+export function remainingUses() {
+    return RINGS[3].filter((symbol) => available(symbol)).length;
+}
+const toCombination = (combination) => combination.length === 1
+    ? combination[0].split(" ")
+    : combination;
+/**
+ * Enter a combination in the Mayam calendar
+ * @param combination The combination to submit, either as a single string or as a series of symbols
+ * @returns Whether we succeeded in our endeavor
+ */
+export function submit(...combination) {
+    if (!available(...toCombination(combination))) {
+        return false;
+    }
+    return cliExecute(`mayam ring ${combination.join(" ")}`);
+}
+export const RESONANCES = Object.freeze({
+    "eye yam2 eyepatch yam4": $item `Mayam spinach`,
+    "vessel yam2 cheese explosion": $item `stuffed yam stinkbomb`,
+    "yam1 meat cheese yam4": $item `yam and swiss`,
+    "sword yam2 eyepatch explosion": $item `yam cannon`,
+    "fur lightning eyepatch yam4": $item `tiny yam cannon`,
+    "yam1 lightning yam3 clock": $item `yam battery`,
+    "fur yam2 wall yam4": $item `furry yam buckler`,
+    "yam1 yam2 yam3 explosion": $item `thanksgiving bomb`,
+    "yam1 meat eyepatch yam4": $item `yamtility belt`,
+    "chair yam2 yam3 clock": $effect `Caught Yam-Handed`,
+    "yam1 yam2 cheese clock": $effect `Memories of Cheesier Age`,
+});
+/**
+ * Find the combination needed to get a particular resonance
+ * @param target The Item or Effect granted by the resonance
+ * @returns The combination needed, or null if none such exists
+ */
+export function resonanceFor(target) {
+    return ([...Object.entries(RESONANCES)]
+        .find(([, value]) => value === target)?.[0]
+        .split(" ") ?? null);
+}
+/**
+ * Determines whether an item can be obtained via resonance at this moment
+ * @param target The target Item or Effect for your resonance
+ * @returns Whether or not you can currently use that resonance
+ */
+export function resonanceAvailable(target) {
+    const resonance = resonanceFor(target);
+    return !!resonance && available(...resonance);
+}
+/**
+ * Determine what Item or Effect results from a particular resonance
+ *
+ * @param combination The combination to check, either as a single string or a series of symbols
+ * @returns The Item or Effect of the resonance, if it is indeed a resonance; `null` otherwise
+ */
+export function getResonanceResult(...combination) {
+    const combinationString = combination.length === 1
+        ? combination[0]
+        : combination.join(" ");
+    return combinationString in RESONANCES
+        ? RESONANCES[combinationString]
+        : null;
+}

package/dist/resources/index.d.ts

@@ -49,6 +49,7 @@ import * as ClosedCircuitPayphone from "./2023/ClosedCircuitPayphone";
 import * as CursedMonkeyPaw from "./2023/CursedMonkeyPaw";
 import * as AprilingBandHelmet from "./2024/AprilingBandHelmet";
 import * as ChestMimic from "./2024/ChestMimic";
-export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
+import * as MayamCalendar from "./2024/MayamCalendar";
+export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
 export * from "./putty-likes";
 export * from "./LibramSummon";

package/dist/resources/index.js

@@ -49,6 +49,7 @@ import * as ClosedCircuitPayphone from "./2023/ClosedCircuitPayphone";
 import * as CursedMonkeyPaw from "./2023/CursedMonkeyPaw";
 import * as AprilingBandHelmet from "./2024/AprilingBandHelmet";
 import * as ChestMimic from "./2024/ChestMimic";
-export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
+import * as MayamCalendar from "./2024/MayamCalendar";
+export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
 export * from "./putty-likes";
 export * from "./LibramSummon";

package/dist/url.d.ts

@@ -1,9 +1,9 @@
 export declare const EMPTY_VALUE: unique symbol;
-declare type QValue = string | number | boolean | typeof EMPTY_VALUE;
-export declare type QueryList = readonly (readonly [key: string, value: QValue])[];
-export declare type QueryObject = Record<string, QValue>;
-export declare type Query = QueryList | QueryObject;
-declare type Options = {
+type QValue = string | number | boolean | typeof EMPTY_VALUE;
+export type QueryList = readonly (readonly [key: string, value: QValue])[];
+export type QueryObject = Record<string, QValue>;
+export type Query = QueryList | QueryObject;
+type Options = {
     method?: "GET" | "POST";
 };
 /**

package/dist/utils.d.ts

@@ -66,7 +66,7 @@ export declare function countedMapToString<T>(map: Map<T, number>): string;
  */
 export declare function sum<S extends string | number | symbol, T extends {
     [s in S]: number;
-}>(addends: T[], property: S): number;
+}>(addends: readonly T[], property: S): number;
 /**
  * Sum an array of numbers.
  *
@@ -74,7 +74,7 @@ export declare function sum<S extends string | number | symbol, T extends {
  * @param mappingFunction Mapping function to turn addends into actual numbers.
  * @returns Sum of numbers
  */
-export declare function sum<T>(addends: T[], mappingFunction: (element: T) => number): number;
+export declare function sum<T>(addends: readonly T[], mappingFunction: (element: T) => number): number;
 /**
  * Sum array of numbers
  *
@@ -116,8 +116,8 @@ export declare function maxBy<T>(array: T[] | readonly T[], optimizer: (element:
 export declare function maxBy<S extends string | number | symbol, T extends {
     [x in S]: number;
 }>(array: T[] | readonly T[], key: S, reverse?: boolean): T;
-export declare type Tuple<T, N extends number> = N extends N ? number extends N ? T[] : _tupleOf<T, N, []> : never;
-declare type _tupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : _tupleOf<T, N, [T, ...R]>;
+export type Tuple<T, N extends number> = N extends N ? number extends N ? T[] : _tupleOf<T, N, []> : never;
+type _tupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : _tupleOf<T, N, [T, ...R]>;
 /**
  * Compare arrays shallowly
  *
@@ -130,7 +130,7 @@ export declare function arrayEquals<T>(left: T[] | readonly T[], right: T[] | re
  * Type that extends any non-function entity--like a string, number, or array--into a itself and a no-input function that returns it.
  * Used to interact with objects that could either be functions or static values.
  */
-export declare type Delayed<T, S extends any[] = never[]> = [T] extends [
+export type Delayed<T, S extends any[] = never[]> = [T] extends [
     (...args: any) => any
 ] ? never : T | ((...args: S) => T);
 /**
@@ -145,7 +145,7 @@ export declare function undelay<T, S extends any[] = never[]>(delayedObject: Del
  * An object keyed by string type T, with values of S.
  *  or contains a 'default' parameter to use as a fallback.
  */
-export declare type Switch<T extends string, S> = Record<T, S> | (Partial<{
+export type Switch<T extends string, S> = Record<T, S> | (Partial<{
     [x in T]: S;
 }> & {
     default: S;
@@ -177,9 +177,9 @@ export declare function random<T>(array: T[]): T;
  * @returns Word in title case
  */
 export declare const tc: (word: string) => string;
-declare type Enumerate<N extends number, A extends number[] = []> = A["length"] extends N ? A[number] : Enumerate<N, [...A, A["length"]]>;
+type Enumerate<N extends number, A extends number[] = []> = A["length"] extends N ? A[number] : Enumerate<N, [...A, A["length"]]>;
 /**
  * Integers on the interval [A, B).
  */
-export declare type Range<A extends number, B extends number> = Exclude<Enumerate<B>, Enumerate<A>>;
+export type Range<A extends number, B extends number> = Exclude<Enumerate<B>, Enumerate<A>>;
 export {};

package/dist/utils.js

@@ -240,7 +240,8 @@ export function flat(arr, depth = Infinity) {
     let flatArray = [];
     for (const item of arr) {
         if (Array.isArray(item) && depth > 0) {
-            flatArray = flatArray.concat(flat(item, depth - 1));
+            const child = flat(item, depth - 1);
+            flatArray = flatArray.concat(child);
         }
         else {
             flatArray.push(item);