add: --target flag for ap-calc + rewrite README for ap-calc

Author: Mitsunee

README.md

@@ -39,10 +39,15 @@ Script that lists event welfare Servants that have not yet been released on the
 ### AP Calc
 
 ```
-pnpm ap-calc [-m,--max <num>] [-n,--node <num>] <current-ap> [<current-timer>]
+pnpm ap-calc [-m,--max <num>] [-n,--node <num>] [-t,--target <num>] <current-ap> [<current-timer>]
 ```
 
-Simple AP Calculator that calculates time to Max AP and, if given a node cost via `-n` (or `--node`) time until each possible run can be done. Output is given as a table with time (24h notation) and delta until that point. Max AP is assumed to be `144`, but can be overriden with `-m` (or `--max`). Values for current ap and time until next AP are positional, with current timer being optional.
+Simple AP Calculator that calculates time to Max AP and targets based on node cost or target AP. Output is given as a table with time (24h notation) and delta until that point.
+
+- `-m`,`--max`: Override for Max AP (Default: `144`)
+- `-n`,`--node`: Node Cost (shows all possible future runs; optional)
+- `-t`,`--target`: Sets target AP (optional)
+- Positional: Values for current ap (num; required) and time until next AP (either as `M:SS` or `MSS`; optional)
 
 ## Cache
 

src/ap-calc/script.ts

@@ -8,6 +8,7 @@ const args = parseArgs({
   options: {
     verbose: { type: "boolean", short: "v", default: false },
     max: { type: "string", short: "m", default: "144" },
+    target: { type: "string", short: "t" },
     node: { type: "string", short: "n" }
   },
   allowPositionals: true
@@ -37,6 +38,8 @@ async function main() {
   // parse args
   let apMax = parseInt(args.values.max);
   let nodeCost = args.values.node ? parseInt(args.values.node) : undefined;
+  let targetAP = args.values.target ? parseInt(args.values.target) : undefined;
+
   if (isNaN(apMax) || apMax < 20) {
     log.error(
       `Could not parse argument for --max '${args.values.max}'. Argument must integer >= 20`
@@ -50,6 +53,12 @@ async function main() {
     );
     nodeCost = undefined;
   }
+  if (typeof targetAP == "number" && (isNaN(targetAP) || targetAP < 1)) {
+    log.error(
+      `Could not parse argument for --target '${args.values.target}'. Argument must be integer > 0`
+    );
+    targetAP = undefined;
+  }
 
   // parse positionals
   const apCurr = parseInt(args.positionals[0] || "");
@@ -88,6 +97,17 @@ async function main() {
     }
   }
 
+  if (targetAP) {
+    const deltaTargetAP = targetAP - apCurr;
+    const deltaTargetSeconds = (deltaTargetAP - 1) * 300 + timerSeconds;
+    table.push(
+      Object.assign(
+        { ap: targetAP, title: "Target" },
+        timeDiffer(deltaTargetSeconds)
+      )
+    );
+  }
+
   // handle max AP
   const deltaMaxAP = apMax - apCurr;
   const deltaMaxSeconds = (deltaMaxAP - 1) * 300 + timerSeconds;
@@ -99,6 +119,7 @@ async function main() {
   console.table(
     table
       .filter(run => run.ap >= apCurr)
+      .sort((a, b) => a.ap - b.ap)
       .reduce(
         (obj, { title, ...row }) => {
           obj[title] = row;