libram 0.7.11 → 0.7.14

package/dist/ascend.d.ts

@@ -6,6 +6,13 @@ export declare enum Lifestyle {
     normal = 2,
     hardcore = 3
 }
+/**
+ * Get a mapping of permed skills to the extent to which they're permed.
+ *
+ * If a skill is not permed at all, it will not appear in the mapping.
+ *
+ * @returns Permed skills mapping
+ */
 export declare function permedSkills(): Map<Skill, Lifestyle>;
 export declare class AscendError extends Error {
     cause?: Skill | Item | Class | Path | string;
@@ -22,13 +29,16 @@ export declare class AscensionPrepError extends Error {
 declare type MoonSign = number | "mongoose" | "wallaby" | "vole" | "platypus" | "opossum" | "marmot" | "wombat" | "blender" | "packrat" | "degrassi" | "degrassi knoll" | "friendly degrassi knoll" | "knoll" | "canada" | "canadia" | "little canadia" | "gnomads" | "gnomish" | "gnomish gnomads camp";
 /**
  * Hops the gash, perming no skills
+ *
  * @param path path of choice, as a Path object--these exist as properties of Paths
  * @param playerClass Your class of choice for this ascension
  * @param lifestyle 1 for casual, 2 for softcore, 3 for hardcore. Alternately, use the Lifestyle enum
  * @param moon Your moon sign as a string, or the zone you're looking for as a string
  * @param consumable From the astral deli. Pick the container item, not the product.
  * @param pet From the astral pet store.
- * @param permSkills A Map<Skill, Lifestyle> of skills you'd like to perm, ordered by priority.
+ * @param permOptions Options for perming during a player's stay in Valhalla
+ * @param permOptions.permSkills A Map<Skill, Lifestyle> of skills you'd like to perm, ordered by priority.
+ * @param permOptions.neverAbort Whether the ascension shouold abort on failure
  */
 export declare function ascend(path: Path, playerClass: Class, lifestyle: Lifestyle, moon: MoonSign, consumable?: Item | undefined, pet?: Item | undefined, permOptions?: {
     permSkills: Map<Skill, Lifestyle>;
@@ -36,9 +46,15 @@ export declare function ascend(path: Path, playerClass: Class, lifestyle: Lifest
 }): void;
 /**
  * Sets up various iotms you may want to use in the coming ascension
- * @param ascensionItems.garden Garden to switch to.
- * @param ascensionItems An object potentially containing your workshed, garden, chateau, and eudora, all as strings
- * @param throwOnFail If true, this will throw an error when it fails to switch something
+ *
+ * @param ascensionPrep Configuration for various ascension prep settings. Any ommitted key will be kept as-is
+ * @param ascensionPrep.garden Garden to which to switch
+ * @param ascensionPrep.eudora Eudora to which to switch
+ * @param ascensionPrep.chateau Chateau configuration
+ * @param ascensionPrep.chateau.desk Chateau desk configuration
+ * @param ascensionPrep.chateau.ceiling Chateau ceiling configuration
+ * @param ascensionPrep.chateau.nightstand Chateau nightstand configuration
+ * @param ascensionPrep.throwOnFail If true, this will throw an error when it fails to switch something
  */
 export declare function prepareAscension({ garden, eudora, chateau, throwOnFail, }?: {
     garden?: Garden;

package/dist/ascend.js

@@ -10,6 +10,13 @@ export var Lifestyle;
     Lifestyle[Lifestyle["normal"] = 2] = "normal";
     Lifestyle[Lifestyle["hardcore"] = 3] = "hardcore";
 })(Lifestyle || (Lifestyle = {}));
+/**
+ * Get a mapping of permed skills to the extent to which they're permed.
+ *
+ * If a skill is not permed at all, it will not appear in the mapping.
+ *
+ * @returns Permed skills mapping
+ */
 export function permedSkills() {
     return new Map(Array.from(Object.entries(getPermedSkills())).map(([skillName, isHardcore]) => [
         toSkill(skillName),
@@ -89,6 +96,13 @@ export class AscensionPrepError extends Error {
         this.cause = cause;
     }
 }
+/**
+ * Determine the id of the appropriate moon sign.
+ *
+ * @param moon Either a moon sign or the desired unlocked zone name
+ * @param playerClass Class, required for working out a moon sign based on the desired zone
+ * @returns Moon sign id
+ */
 function toMoonId(moon, playerClass) {
     if (typeof moon === "number")
         return moon;
@@ -140,6 +154,11 @@ function toMoonId(moon, playerClass) {
             throw new AscendError("Invalid moon sign!");
     }
 }
+/**
+ * Determine if player is currently in Valhalla
+ *
+ * @returns Whether player is in Valhalla
+ */
 function isInValhalla() {
     const charPaneText = visitUrl("charpane.php");
     // Match the infinity images (inf_small.gif, inf_large.gif)
@@ -150,13 +169,16 @@ function isInValhalla() {
 }
 /**
  * Hops the gash, perming no skills
+ *
  * @param path path of choice, as a Path object--these exist as properties of Paths
  * @param playerClass Your class of choice for this ascension
  * @param lifestyle 1 for casual, 2 for softcore, 3 for hardcore. Alternately, use the Lifestyle enum
  * @param moon Your moon sign as a string, or the zone you're looking for as a string
  * @param consumable From the astral deli. Pick the container item, not the product.
  * @param pet From the astral pet store.
- * @param permSkills A Map<Skill, Lifestyle> of skills you'd like to perm, ordered by priority.
+ * @param permOptions Options for perming during a player's stay in Valhalla
+ * @param permOptions.permSkills A Map<Skill, Lifestyle> of skills you'd like to perm, ordered by priority.
+ * @param permOptions.neverAbort Whether the ascension shouold abort on failure
  */
 export function ascend(path, playerClass, lifestyle, moon, consumable = $item `astral six-pack`, pet = undefined, permOptions) {
     if (playerClass.path !== (path.avatar ? path : Path.none)) {
@@ -215,9 +237,15 @@ export function ascend(path, playerClass, lifestyle, moon, consumable = $item `a
 }
 /**
  * Sets up various iotms you may want to use in the coming ascension
- * @param ascensionItems.garden Garden to switch to.
- * @param ascensionItems An object potentially containing your workshed, garden, chateau, and eudora, all as strings
- * @param throwOnFail If true, this will throw an error when it fails to switch something
+ *
+ * @param ascensionPrep Configuration for various ascension prep settings. Any ommitted key will be kept as-is
+ * @param ascensionPrep.garden Garden to which to switch
+ * @param ascensionPrep.eudora Eudora to which to switch
+ * @param ascensionPrep.chateau Chateau configuration
+ * @param ascensionPrep.chateau.desk Chateau desk configuration
+ * @param ascensionPrep.chateau.ceiling Chateau ceiling configuration
+ * @param ascensionPrep.chateau.nightstand Chateau nightstand configuration
+ * @param ascensionPrep.throwOnFail If true, this will throw an error when it fails to switch something
  */
 export function prepareAscension({ garden, eudora, chateau, throwOnFail, } = {}) {
     throwOnFail = throwOnFail ?? true;

package/dist/challengePaths/2015/CommunityService.d.ts

@@ -7,6 +7,7 @@ export default class CommunityService {
     private maximizeRequirements;
     /**
      * Class to store properties of various CS tests.
+     *
      * @param id The id the game HTML uses to identify the test; this is used primarily in runChoice.
      * @param stat The principle stat the test measures, often used as more easily memorable shorthand for the specific tests
      * @param property The name of the test as a string, often used as part of the string property "csServicesPerformed".
@@ -37,6 +38,7 @@ export default class CommunityService {
     static logTask(name: string, action: () => number | void): void;
     /**
      * Checks the "csServicesPerformed" property to see whether mafia currently believes this test is complete.
+     *
      * @returns Whether mafia currently believes this test is complete.
      */
     isDone(): boolean;
@@ -46,11 +48,13 @@ export default class CommunityService {
     maximize(): void;
     /**
      * Attempts to turn in the test to the Council of Loathing.
+     *
      * @returns Whether mafia believes the test is complete at the end of this function.
      */
     do(): boolean;
     /**
      * Wrapper function that prepares for a test and then completes it, adding time and turn details to the log.
+     *
      * @param prepare A function that does all necessary preparations for this CS test, including choosing your outfit. Optionally returns the number of turns you expect to spend preparing for the test.
      * @param maxTurns We will run the test iff the predicted/actual turns is less than or equal to this parameter.
      * @returns "completed", "failed", or "already completed".
@@ -59,12 +63,14 @@ export default class CommunityService {
     private _verifyIsDone;
     /**
      * Checks council.php to verify that a test is complete; more reliable than isDone, but requires an additional pagehit.
+     *
      * @returns Whether council.php suggests that the test is complete.
      */
     verifyIsDone(): boolean;
     private _actualCost;
     /**
      * Checks council.php for the number of turns this test will take; more reliable than prediction, but requires an additional pagehit.
+     *
      * @returns The number of turns to complete this test according to council.php.
      */
     actualCost(): number;
@@ -81,6 +87,7 @@ export default class CommunityService {
     };
     /**
      * Prints turncount and time details of the test in question.
+     *
      * @param colour The colour (or color) you'd like the log to be printed in.
      */
     static printLog(colour?: string): void;

package/dist/challengePaths/2015/CommunityService.js

@@ -28,6 +28,7 @@ export default class CommunityService {
     maximizeRequirements;
     /**
      * Class to store properties of various CS tests.
+     *
      * @param id The id the game HTML uses to identify the test; this is used primarily in runChoice.
      * @param stat The principle stat the test measures, often used as more easily memorable shorthand for the specific tests
      * @param property The name of the test as a string, often used as part of the string property "csServicesPerformed".
@@ -84,6 +85,7 @@ export default class CommunityService {
     }
     /**
      * Checks the "csServicesPerformed" property to see whether mafia currently believes this test is complete.
+     *
      * @returns Whether mafia currently believes this test is complete.
      */
     isDone() {
@@ -98,6 +100,7 @@ export default class CommunityService {
     }
     /**
      * Attempts to turn in the test to the Council of Loathing.
+     *
      * @returns Whether mafia believes the test is complete at the end of this function.
      */
     do() {
@@ -109,6 +112,7 @@ export default class CommunityService {
     }
     /**
      * Wrapper function that prepares for a test and then completes it, adding time and turn details to the log.
+     *
      * @param prepare A function that does all necessary preparations for this CS test, including choosing your outfit. Optionally returns the number of turns you expect to spend preparing for the test.
      * @param maxTurns We will run the test iff the predicted/actual turns is less than or equal to this parameter.
      * @returns "completed", "failed", or "already completed".
@@ -149,6 +153,7 @@ export default class CommunityService {
     }
     /**
      * Checks council.php to verify that a test is complete; more reliable than isDone, but requires an additional pagehit.
+     *
      * @returns Whether council.php suggests that the test is complete.
      */
     verifyIsDone() {
@@ -160,6 +165,7 @@ export default class CommunityService {
     }
     /**
      * Checks council.php for the number of turns this test will take; more reliable than prediction, but requires an additional pagehit.
+     *
      * @returns The number of turns to complete this test according to council.php.
      */
     actualCost() {
@@ -171,6 +177,7 @@ export default class CommunityService {
     static log = {};
     /**
      * Prints turncount and time details of the test in question.
+     *
      * @param colour The colour (or color) you'd like the log to be printed in.
      */
     static printLog(colour = "blue") {
@@ -246,7 +253,11 @@ export default class CommunityService {
             : 1;
         // We add 0.001 because the floor function sometimes introduces weird rounding errors
         return (60 -
-            Math.floor((multiplier * (getModifier("Item Drop") - familiarItemDrop)) / 30 +
+            Math.floor((multiplier *
+                (getModifier("Item Drop") -
+                    familiarItemDrop -
+                    numericModifier(myThrall(), "Item Drop"))) /
+                30 +
                 0.001) -
             Math.floor((getModifier("Booze Drop") - familiarBoozeDrop) / 15 + 0.001));
     }, new Requirement(["Item Drop", "2 Booze Drop"], {

package/dist/combat.d.ts

@@ -2,6 +2,7 @@ import { Class, Effect, Item, Location, Monster, Skill, Stat } from "kolmafia";
 /**
  * Get the KoL native ID of the macro with name name.
  *
+ * @param name Name of the macro
  * @category Combat
  * @returns {number} The macro ID.
  */
@@ -29,16 +30,20 @@ export declare class Macro {
     name: string;
     /**
      * Convert macro to string.
+     *
+     * @returns BALLS macro
      */
     toString(): string;
     /**
      * Gives your macro a new name to be used when saving an autoattack.
+     *
      * @param name The name to be used when saving as an autoattack.
      * @returns The macro in question
      */
     rename(name: string): this;
     /**
      * Creates a new Macro with a name other than the default name.
+     *
      * @param name The name to assign this macro.
      * @returns A new Macro with the assigned name.
      */
@@ -49,6 +54,8 @@ export declare class Macro {
     save(): void;
     /**
      * Load a saved macro from the Mafia property.
+     *
+     * @returns Loaded macro text
      */
     static load<T extends Macro>(this: Constructor<T>): T;
     /**
@@ -57,18 +64,22 @@ export declare class Macro {
     static clearSaved(): void;
     /**
      * Statefully add one or several steps to a macro.
+     *
      * @param nextSteps The steps to add to the macro.
      * @returns {Macro} This object itself.
      */
     step(...nextSteps: (string | Macro)[]): this;
     /**
      * Statefully add one or several steps to a macro.
+     *
      * @param nextSteps The steps to add to the macro.
      * @returns {Macro} This object itself.
      */
     static step<T extends Macro>(this: Constructor<T>, ...nextSteps: (string | Macro)[]): T;
     /**
      * Submit the built macro to KoL. Only works inside combat.
+     *
+     * @returns Contents of the fight page after macro submission
      */
     submit(): string;
     /**
@@ -77,6 +88,7 @@ export declare class Macro {
     setAutoAttack(): void;
     /**
      * Renames the macro, then sets it as an autoattack.
+     *
      * @param name The name to save the macro under as an autoattack.
      */
     setAutoAttackAs(name: string): void;
@@ -86,27 +98,32 @@ export declare class Macro {
     static clearAutoAttackMacros(): void;
     /**
      * Add an "abort" step to this macro.
+     *
      * @returns {Macro} This object itself.
      */
     abort(): this;
     /**
      * Create a new macro with an "abort" step.
+     *
      * @returns {Macro} This object itself.
      */
     static abort<T extends Macro>(this: Constructor<T>): T;
     /**
      * Add a "runaway" step to this macro.
+     *
      * @returns {Macro} This object itself.
      */
     runaway(): this;
     /**
      * Create a new macro with an "runaway" step.
+     *
      * @returns {Macro} This object itself.
      */
     static runaway<T extends Macro>(this: Constructor<T>): T;
     private static makeBALLSPredicate;
     /**
      * Add an "if" statement to this macro.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param ifTrue Continuation if the condition is true.
      * @returns {Macro} This object itself.
@@ -114,6 +131,7 @@ export declare class Macro {
     if_(condition: PreBALLSPredicate, ifTrue: string | Macro): this;
     /**
      * Create a new macro with an "if" statement.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param ifTrue Continuation if the condition is true.
      * @returns {Macro} This object itself.
@@ -121,6 +139,7 @@ export declare class Macro {
     static if_<T extends Macro>(this: Constructor<T>, condition: PreBALLSPredicate, ifTrue: string | Macro): T;
     /**
      * Add an "if" statement to this macro, inverting the condition.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param ifTrue Continuation if the condition is true.
      * @returns {Macro} This object itself.
@@ -128,6 +147,7 @@ export declare class Macro {
     ifNot(condition: PreBALLSPredicate, ifTrue: string | Macro): this;
     /**
      * Create a new macro with an "if" statement, inverting the condition.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param ifTrue Continuation if the condition is true.
      * @returns {Macro} This object itself.
@@ -135,6 +155,7 @@ export declare class Macro {
     static ifNot<T extends Macro>(this: Constructor<T>, condition: PreBALLSPredicate, ifTrue: string | Macro): T;
     /**
      * Add a "while" statement to this macro.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param contents Loop to repeat while the condition is true.
      * @returns {Macro} This object itself.
@@ -142,6 +163,7 @@ export declare class Macro {
     while_(condition: string, contents: string | Macro): this;
     /**
      * Create a new macro with a "while" statement.
+     *
      * @param condition The BALLS condition for the if statement.
      * @param contents Loop to repeat while the condition is true.
      * @returns {Macro} This object itself.
@@ -149,6 +171,7 @@ export declare class Macro {
     static while_<T extends Macro>(this: Constructor<T>, condition: string, contents: string | Macro): T;
     /**
      * Conditionally add a step to a macro based on a condition evaluated at the time of building the macro.
+     *
      * @param condition The JS condition.
      * @param ifTrue Continuation to add if the condition is true.
      * @param ifFalse Optional input to turn this into an if...else statement.
@@ -157,6 +180,7 @@ export declare class Macro {
     externalIf(condition: boolean, ifTrue: string | Macro, ifFalse?: string | Macro): this;
     /**
      * Create a new macro with a condition evaluated at the time of building the macro.
+     *
      * @param condition The JS condition.
      * @param ifTrue Continuation to add if the condition is true.
      * @param ifFalse Optional input to turn this into an if...else statement.
@@ -165,97 +189,118 @@ export declare class Macro {
     static externalIf<T extends Macro>(this: Constructor<T>, condition: boolean, ifTrue: string | Macro, ifFalse?: string | Macro): T;
     /**
      * Add a repeat step to the macro.
+     *
      * @returns {Macro} This object itself.
      */
     repeat(): this;
     /**
      * Add one or more skill cast steps to the macro.
+     *
      * @param skills Skills to cast.
      * @returns {Macro} This object itself.
      */
     skill(...skills: SkillOrName[]): this;
     /**
      * Create a new macro with one or more skill cast steps.
+     *
      * @param skills Skills to cast.
      * @returns {Macro} This object itself.
      */
     static skill<T extends Macro>(this: Constructor<T>, ...skills: SkillOrName[]): T;
     /**
      * Add one or more skill cast steps to the macro, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try casting.
      * @returns {Macro} This object itself.
      */
     trySkill(...skills: SkillOrName[]): this;
     /**
      * Create a new macro with one or more skill cast steps, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try casting.
      * @returns {Macro} This object itself.
      */
     static trySkill<T extends Macro>(this: Constructor<T>, ...skills: SkillOrName[]): T;
     /**
      * Add one or more skill-cast-and-repeat steps to the macro, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try repeatedly casting.
      * @returns {Macro} This object itself.
      */
     trySkillRepeat(...skills: SkillOrName[]): this;
     /**
      * Create a new macro with one or more skill-cast-and-repeat steps, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try repeatedly casting.
      * @returns {Macro} This object itself.
      */
     static trySkillRepeat<T extends Macro>(this: Constructor<T>, ...skills: SkillOrName[]): T;
     /**
      * Add one or more item steps to the macro.
+     *
      * @param items Items to use. Pass a tuple [item1, item2] to funksling.
      * @returns {Macro} This object itself.
      */
     item(...items: (ItemOrName | [ItemOrName, ItemOrName])[]): this;
     /**
      * Create a new macro with one or more item steps.
+     *
      * @param items Items to use. Pass a tuple [item1, item2] to funksling.
      * @returns {Macro} This object itself.
      */
     static item<T extends Macro>(this: Constructor<T>, ...items: (ItemOrName | [ItemOrName, ItemOrName])[]): T;
     /**
      * Add one or more item steps to the macro, where each step checks to see if you have the item first.
+     *
      * @param items Items to try using. Pass a tuple [item1, item2] to funksling.
      * @returns {Macro} This object itself.
      */
     tryItem(...items: (ItemOrName | [ItemOrName, ItemOrName])[]): this;
     /**
      * Create a new macro with one or more item steps, where each step checks to see if you have the item first.
+     *
      * @param items Items to try using. Pass a tuple [item1, item2] to funksling.
      * @returns {Macro} This object itself.
      */
     static tryItem<T extends Macro>(this: Constructor<T>, ...items: (ItemOrName | [ItemOrName, ItemOrName])[]): T;
     /**
      * Add an attack step to the macro.
+     *
      * @returns {Macro} This object itself.
      */
     attack(): this;
     /**
      * Create a new macro with an attack step.
+     *
      * @returns {Macro} This object itself.
      */
     static attack<T extends Macro>(this: Constructor<T>): T;
     /**
      * Create an if_ statement based on what holiday of loathing it currently is. On non-holidays, returns the original macro, unmutated.
+     *
      * @param macro The macro to place in the if_ statement
+     * @returns This macro with supplied macro wapped in if statement matching holiday wanderers
      */
     ifHolidayWanderer(macro: Macro): this;
     /**
      * Create a new macro starting with an ifHolidayWanderer step.
+     *
      * @param macro The macro to place inside the if_ statement
+     * @returns New macro with supplied macro wrapped in if statement matching holiday wanderers
      */
     static ifHolidayWanderer<T extends Macro>(this: Constructor<T>, macro: Macro): T;
     /**
      * Create an if_ statement based on what holiday of loathing it currently is. On non-holidays, returns the original macro, with the input macro appended.
+     *
      * @param macro The macro to place in the if_ statement.
+     * @returns This macro with supplied macro wrapped in if statement matching monsters that are not holiday wanderers
      */
     ifNotHolidayWanderer(macro: Macro): this;
     /**
      * Create a new macro starting with an ifNotHolidayWanderer step.
+     *
      * @param macro The macro to place inside the if_ statement
+     * @returns New macro with supplied macro wrapped in if statement matching monsters that are not holiday wanderers
      */
     static ifNotHolidayWanderer<T extends Macro>(this: Constructor<T>, macro: Macro): T;
 }
@@ -283,60 +328,70 @@ export declare function adventureMacroAuto(loc: Location, autoMacro: Macro, next
 export declare class StrictMacro extends Macro {
     /**
      * Add one or more skill cast steps to the macro.
+     *
      * @param skills Skills to cast.
      * @returns {StrictMacro} This object itself.
      */
     skill(...skills: Skill[]): this;
     /**
      * Create a new macro with one or more skill cast steps.
+     *
      * @param skills Skills to cast.
      * @returns {StrictMacro} This object itself.
      */
     static skill<T extends StrictMacro>(this: Constructor<T>, ...skills: Skill[]): T;
     /**
      * Add one or more item steps to the macro.
+     *
      * @param items Items to use. Pass a tuple [item1, item2] to funksling.
      * @returns {StrictMacro} This object itself.
      */
     item(...items: (Item | [Item, Item])[]): this;
     /**
      * Create a new macro with one or more item steps.
+     *
      * @param items Items to use. Pass a tuple [item1, item2] to funksling.
      * @returns {StrictMacro} This object itself.
      */
     static item<T extends StrictMacro>(this: Constructor<T>, ...items: (Item | [Item, Item])[]): T;
     /**
      * Add one or more skill cast steps to the macro, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try casting.
      * @returns {StrictMacro} This object itself.
      */
     trySkill(...skills: Skill[]): this;
     /**
      * Create a new macro with one or more skill cast steps, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try casting.
      * @returns {StrictMacro} This object itself.
      */
     static trySkill<T extends StrictMacro>(this: Constructor<T>, ...skills: Skill[]): T;
     /**
      * Add one or more item steps to the macro, where each step checks to see if you have the item first.
+     *
      * @param items Items to try using. Pass a tuple [item1, item2] to funksling.
      * @returns {StrictMacro} This object itself.
      */
     tryItem(...items: (Item | [Item, Item])[]): this;
     /**
      * Create a new macro with one or more item steps, where each step checks to see if you have the item first.
+     *
      * @param items Items to try using. Pass a tuple [item1, item2] to funksling.
      * @returns {StrictMacro} This object itself.
      */
     static tryItem<T extends StrictMacro>(this: Constructor<T>, ...items: (Item | [Item, Item])[]): T;
     /**
      * Add one or more skill-cast-and-repeat steps to the macro, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try repeatedly casting.
      * @returns {StrictMacro} This object itself.
      */
     trySkillRepeat(...skills: Skill[]): this;
     /**
      * Create a new macro with one or more skill-cast-and-repeat steps, where each step checks if you have the skill first.
+     *
      * @param skills Skills to try repeatedly casting.
      * @returns {StrictMacro} This object itself.
      */