Add solution for 2024, day 1

A nice easy one to get the event started. Nothing much to say about
today's challenge.

2024/01/README.md

@@ -0,0 +1,82 @@
+# Day 1: Historian Hysteria
+
+A straightforward challenge to get started with. Nothing much of interest to add.
+
+Rating: **Easy**
+
+## Challenge description
+
+### Part One:
+The **Chief Historian** is always present for the big Christmas sleigh launch, but nobody has seen him in months! Last anyone heard, he was visiting locations that are historically significant to the North Pole; a group of Senior Historians has asked you to accompany them as they check the places they think he was most likely to visit.
+
+As each location is checked, they will mark it on their list with a *star*. They figure the Chief Historian **must** be in one of the first fifty places they'll look, so in order to save Christmas, you need to help them get *fifty stars* on their list before Santa takes off on December 25th.
+
+Collect stars by solving puzzles. Two puzzles will be made available on each day in the Advent calendar; the second puzzle is unlocked when you complete the first. Each puzzle grants *one star*. Good luck!
+
+You haven't even left yet and the group of Elvish Senior Historians has already hit a problem: their list of locations to check is currently **empty**. Eventually, someone decides that the best place to check first would be the Chief Historian's office.
+
+Upon pouring into the office, everyone confirms that the Chief Historian is indeed nowhere to be found. Instead, the Elves discover an assortment of notes and lists of historically significant locations! This seems to be the planning the Chief Historian was doing before he left. Perhaps these notes can be used to determine which locations to search?
+
+Throughout the Chief's office, the historically significant locations are listed not by name but by a unique number called the **location ID**. To make sure they don't miss anything, The Historians split into two groups, each searching the office and trying to create their own complete list of location IDs.
+
+There's just one problem: by holding the two lists up **side by side** (your puzzle input), it quickly becomes clear that the lists aren't very similar. Maybe you can help The Historians reconcile their lists?
+
+For example:
+
+```
+3   4
+4   3
+2   5
+1   3
+3   9
+3   3
+```
+
+Maybe the lists are only off by a small amount! To find out, pair up the numbers and measure how far apart they are. Pair up **the smallest number in the left** list with the **smallest number in the right list**, then the **second-smallest left number** with the **second-smallest right number**, and so on.
+
+Within each pair, figure out **how far apart** the two numbers are; you'll need to **add up all of those distances**. For example, if you pair up a `3` from the left list with a `7` from the right list, the distance apart is `4`; if you pair up a `9` with a `3`, the distance apart is `6`.
+
+In the example list above, the pairs and distances would be as follows:
+
+- The smallest number in the left list is `1`, and the smallest number in the right list is `3`. The distance between them is `2`.
+- The second-smallest number in the left list is `2`, and the second-smallest number in the right list is another `3`. The distance between them is `1`.
+- The third-smallest number in both lists is `3`, so the distance between them is `0`.
+- The next numbers to pair up are `3` and `4`, a distance of `1`.
+- The fifth-smallest numbers in each list are `3` and `5`, a distance of `2`.
+- Finally, the largest number in the left list is `4`, while the largest number in the right list is `9`; these are a distance `5` apart.
+
+To find the **total distance** between the left list and the right list, add up the distances between all of the pairs you found. In the example above, this is `2 + 1 + 0 + 1 + 2 + 5`, a total distance of `11`!
+
+Your actual left and right lists contain many location IDs. **What is the total distance between your lists?**
+
+### Part Two
+Your analysis only confirmed what everyone feared: the two lists of location IDs are indeed very different.
+
+Or are they?
+
+The Historians can't agree on which group made the mistakes **or** how to read most of the Chief's handwriting, but in the commotion you notice an interesting detail: a lot of location IDs appear in both lists! Maybe the other numbers aren't location IDs at all but rather misinterpreted handwriting.
+
+This time, you'll need to figure out exactly how often each number from the left list appears in the right list. Calculate a total **similarity score** by adding up each number in the left list after multiplying it by the number of times that number appears in the right list.
+
+Here are the same example lists again:
+
+```
+3   4
+4   3
+2   5
+1   3
+3   9
+3   3
+```
+For these example lists, here is the process of finding the similarity score:
+
+- The first number in the left list is `3`. It appears in the right list three times, so the similarity score increases by `3 * 3 = 9`.
+- The second number in the left list is `4`. It appears in the right list once, so the similarity score increases by `4 * 1 = 4`.
+- The third number in the left list is `2`. It does not appear in the right list, so the similarity score does not increase (`2 * 0 = 0`).
+- The fourth number, `1`, also does not appear in the right list.
+- The fifth number, `3`, appears in the right list three times; the similarity score increases by `9`.
+- The last number, `3`, appears in the right list three times; the similarity score again increases by `9`.
+
+So, for these example lists, the similarity score at the end of this process is **`31`** (`9 + 4 + 0 + 0 + 9 + 9`).
+
+Once again consider your left and right lists. **What is their similarity score**?

2024/01/helpers/parse-input.ts

@@ -0,0 +1,25 @@
+type LocationLists = number[][];
+
+/* ========================================================================== */
+
+/**
+ * Returns lists of location IDs, sorted in descending order.
+ */
+export function parseInput(input: string): LocationLists {
+	const lines = input.split('\n');
+
+	const left: number[] = [];
+	const right: number[] = [];
+
+	for (const line of lines) {
+		const [leftValue, rightValue] = line.split('   ');
+
+		left.push(Number(leftValue));
+		right.push(Number(rightValue));
+	}
+
+	return [
+		left.sort(),
+		right.sort()
+	];
+}

2024/01/part-1.ts

@@ -0,0 +1,19 @@
+import { parseInput } from './helpers/parse-input.js';
+
+/* ========================================================================== */
+
+async function solver(input: string): Promise<number> {
+	const [left, right] = parseInput(input);
+
+	return left.reduce<number>(
+		(total, locationId, index) => total + Math.abs(locationId - right[index]),
+		0
+	);
+}
+
+/* ========================================================================== */
+
+export default {
+	prompt: 'The total distance between the lists',
+	solver
+} satisfies Solution;

2024/01/part-2.ts

@@ -0,0 +1,26 @@
+import { parseInput } from './helpers/parse-input.js';
+
+/* ========================================================================== */
+
+async function solver(input: string): Promise<number> {
+	const [left, right] = parseInput(input);
+	const locationCount: Record<number, number> = {};
+
+	// Iterate over all the location IDs and count how many times that location
+	// ID is present in the list.
+	right.forEach(locationId => {
+		locationCount[locationId] = (locationCount[locationId] ?? 0) + 1;
+	});
+
+	return left.reduce<number>(
+		(total, locationId) => total + Math.abs(locationId * (locationCount[locationId] ?? 0)),
+		0
+	);
+}
+
+/* ========================================================================== */
+
+export default {
+	prompt: 'Their similarity score is',
+	solver
+} satisfies Solution;

2024/README.md

@@ -0,0 +1,16 @@
+# 2024 Challenge index
+
+A list of the challenges for 2024. I've rated each challenge on how difficult I found it so solve. For a description of what challenges I've faced, see the README for a specific day.
+
+|                                     | Part 1 | Part 2 |
+| ----------------------------------- | ------ | ------ |
+| [Day 1: Historian Hysteria](./01/): | Easy   | Easy   |
+
+## Legend
+
+| Rating  | Description
+| ------- | ------------
+| Easy    | The challenge was easy to solve, it didn't pose a problem.
+| Medium  | I was able to solve it but was struggling with some part of the challenge.
+| Hard    | It took a long time to find a solution. I probably used some external help like Reddit posts for the specific challenge.
+| Extreme | I was unable to solve it. My solution is taken from someone else and I tried to learn from it what I could.