Skip to content

Connect, collaborate, and grow with a community of TypeScript developers

Stubbing more pages on AOT (#1589)

bautistaaae6d4abc2aed3
diff --git a/apps/aot/README.md b/apps/aot/README.md
index c4033664..cd714396 100644
--- a/apps/aot/README.md
+++ b/apps/aot/README.md
@@ -1,36 +1,7 @@
-This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
+## Running in development
-## Getting Started
-
-First, run the development server:
-
-```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
-
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
-
-This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
-
-## Learn More
-
-To learn more about Next.js, take a look at the following resources:
-
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
-
-## Deploy on Vercel
-
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
-
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
+- Seed your database with `pnpm db:prod:seed`
+- Create a separate github oauth app for aot. Follow the same directions you did for the TypeHero app. Callback url should be `http://localhost:3003/api/auth/callback/github`
+- Change NEXT_AUTH_URL to `http://localhost:3003`. This will allow you to make sure your oauth flow works locally.
+ - Need to figure out a way to be able to sign into both typehero and aot locally but good enough ™
+- Navigate to `http://localhost:3003` to see the app running locally.
diff --git a/apps/aot/src/app/events/[year]/[day]/layout.tsx b/apps/aot/src/app/events/[year]/[day]/layout.tsx
new file mode 100644
index 00000000..582f0d49
--- /dev/null
+++ b/apps/aot/src/app/events/[year]/[day]/layout.tsx
@@ -0,0 +1,12 @@
+export default function EventsByYearLayout({
+ children, // will be a page or nested layout
+}: {
+ children: React.ReactNode;
+}) {
+ return (
+ <section>
+ Layout for DAY
+ {children}
+ </section>
+ );
+}
diff --git a/apps/aot/src/app/events/[year]/[day]/page.tsx b/apps/aot/src/app/events/[year]/[day]/page.tsx
new file mode 100644
index 00000000..1737bc9d
--- /dev/null
+++ b/apps/aot/src/app/events/[year]/[day]/page.tsx
@@ -0,0 +1,14 @@
+import { api } from '~/trpc/server';
+
+interface Props {
+ params: {
+ year: string;
+ day: string;
+ };
+}
+
+export default async function Challenges({ params: { year, day } }: Props) {
+ const challenge = await api.event.getEventChallengeBySlug({ slug: `${year}-${day}` });
+
+ return <pre>{JSON.stringify(challenge, null, 2)}</pre>;
+}
diff --git a/apps/aot/src/app/events/[year]/layout.tsx b/apps/aot/src/app/events/[year]/layout.tsx
new file mode 100644
index 00000000..35b42a86
--- /dev/null
+++ b/apps/aot/src/app/events/[year]/layout.tsx
@@ -0,0 +1,12 @@
+export default function EventsByYearLayout({
+ children, // will be a page or nested layout
+}: {
+ children: React.ReactNode;
+}) {
+ return (
+ <section>
+ Layout for events/year
+ {children}
+ </section>
+ );
+}
diff --git a/apps/aot/src/app/events/[year]/page.tsx b/apps/aot/src/app/events/[year]/page.tsx
new file mode 100644
index 00000000..ab57a5f0
--- /dev/null
+++ b/apps/aot/src/app/events/[year]/page.tsx
@@ -0,0 +1,26 @@
+import Link from 'next/link';
+import { api } from '~/trpc/server';
+
+interface Props {
+ params: {
+ year: string;
+ };
+}
+
+export default async function EventByYearLandingPage({ params: { year } }: Props) {
+ const event = await api.event.getEventChallengesByYear({ year });
+ return (
+ <div>
+ <h1>Challenges for {year}</h1>
+ <ul>
+ {event.trackChallenges.map((trackChallenge) => (
+ <li key={trackChallenge.challenge.slug}>
+ <Link href={`/events/${year}/${trackChallenge.challenge.slug.split('-').at(-1)}`}>
+ {trackChallenge.challenge.name}
+ </Link>
+ </li>
+ ))}
+ </ul>
+ </div>
+ );
+}
diff --git a/apps/aot/src/app/events/page.tsx b/apps/aot/src/app/events/page.tsx
index c2e64531..e794536d 100644
--- a/apps/aot/src/app/events/page.tsx
+++ b/apps/aot/src/app/events/page.tsx
@@ -1,13 +1,18 @@
+import Link from 'next/link';
import { api } from '~/trpc/server';
export default async function Page() {
const events = await api.event.getAll();
return (
- <div>
+ <ul>
{events.map((event) => {
- const name = event.slug.split('-').at(-1);
- return <div key={event.id}>{name}</div>;
+ const year = event.slug.split('-').at(-1);
+ return (
+ <li key={event.slug}>
+ <Link href={`/events/${year}`}>{year}</Link>
+ </li>
+ );
})}
- </div>
+ </ul>
);
}
diff --git a/apps/aot/src/server/api/routers/event.ts b/apps/aot/src/server/api/routers/event.ts
index 9d99f666..326d7cbb 100644
--- a/apps/aot/src/server/api/routers/event.ts
+++ b/apps/aot/src/server/api/routers/event.ts
@@ -1,6 +1,7 @@
+import { z } from 'zod';
import { createTRPCRouter, publicProcedure } from '~/server/api/trpc';
-const AOT_TRACKS = ['advent-of-typescript-2023'];
+const AOT_TRACKS = ['advent-of-typescript-2023', 'advent-of-typescript-2024'];
export const eventRouter = createTRPCRouter({
getAll: publicProcedure.query(async ({ ctx }) => {
const aotEvents = await ctx.db.track.findMany({
@@ -12,4 +13,58 @@ export const eventRouter = createTRPCRouter({
});
return aotEvents;
}),
+ getEventChallengeBySlug: publicProcedure
+ .input(
+ z.object({
+ slug: z.string(),
+ }),
+ )
+ .query(async ({ ctx, input }) => {
+ // @TODO: actually select fields
+ const challenges = await ctx.db.challenge.findFirstOrThrow({
+ where: {
+ slug: input.slug,
+ },
+ });
+
+ return challenges;
+ }),
+ getEventChallengesByYear: publicProcedure
+ .input(
+ z.object({
+ year: z.string(),
+ }),
+ )
+ .query(async ({ ctx, input }) => {
+ const challenges = await ctx.db.track.findFirstOrThrow({
+ where: {
+ slug: `advent-of-typescript-${input.year}`,
+ },
+ select: {
+ trackChallenges: {
+ orderBy: {
+ orderId: 'asc',
+ },
+ include: {
+ challenge: {
+ include: {
+ submission: {
+ where: {
+ userId: ctx.session?.user?.id || '',
+ },
+ },
+ user: {
+ select: {
+ name: true,
+ },
+ },
+ },
+ },
+ },
+ },
+ },
+ });
+
+ return challenges;
+ }),
});
diff --git a/challenges/aot/2023/1/metadata.json b/challenges/aot/2023/1/metadata.json
index 221ee862..cc69122d 100644
--- a/challenges/aot/2023/1/metadata.json
+++ b/challenges/aot/2023/1/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-1",
+ "id": "2023-1",
"label": "Day One",
"description": "Day one of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/10/metadata.json b/challenges/aot/2023/10/metadata.json
index 10e317f9..a9f83bd7 100644
--- a/challenges/aot/2023/10/metadata.json
+++ b/challenges/aot/2023/10/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-10",
+ "id": "2023-10",
"label": "Day Ten",
"description": "Day ten of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/11/metadata.json b/challenges/aot/2023/11/metadata.json
index eaf52ed3..9032f74b 100644
--- a/challenges/aot/2023/11/metadata.json
+++ b/challenges/aot/2023/11/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-11",
+ "id": "2023-11",
"label": "Day Eleven",
"description": "Day eleven of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/12/metadata.json b/challenges/aot/2023/12/metadata.json
index 2ea9c0ba..981ab85f 100644
--- a/challenges/aot/2023/12/metadata.json
+++ b/challenges/aot/2023/12/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-12",
+ "id": "2023-12",
"label": "Day Twelve",
"description": "Day twelve of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/13/metadata.json b/challenges/aot/2023/13/metadata.json
index 2b09a96f..76538697 100644
--- a/challenges/aot/2023/13/metadata.json
+++ b/challenges/aot/2023/13/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-13",
+ "id": "2023-13",
"label": "Day Thirteen",
"description": "Day thirteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/14/metadata.json b/challenges/aot/2023/14/metadata.json
index 8c28432c..cb6efad9 100644
--- a/challenges/aot/2023/14/metadata.json
+++ b/challenges/aot/2023/14/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-14",
+ "id": "2023-14",
"label": "Day Fourteen",
"description": "Day fourteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/15/metadata.json b/challenges/aot/2023/15/metadata.json
index 900f68d8..18b308d1 100644
--- a/challenges/aot/2023/15/metadata.json
+++ b/challenges/aot/2023/15/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-15",
+ "id": "2023-15",
"label": "Day Fifteen",
"description": "Day fifteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/16/metadata.json b/challenges/aot/2023/16/metadata.json
index c87ddac6..bcd003b5 100644
--- a/challenges/aot/2023/16/metadata.json
+++ b/challenges/aot/2023/16/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-16",
+ "id": "2023-16",
"label": "Day Sixteen",
"description": "Day sixteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/17/metadata.json b/challenges/aot/2023/17/metadata.json
index 56cf3bf9..47ffd54f 100644
--- a/challenges/aot/2023/17/metadata.json
+++ b/challenges/aot/2023/17/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-17",
+ "id": "2023-17",
"label": "Day Seventeen",
"description": "Day seventeen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/18/metadata.json b/challenges/aot/2023/18/metadata.json
index 7f8c06cf..466d6300 100644
--- a/challenges/aot/2023/18/metadata.json
+++ b/challenges/aot/2023/18/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-18",
+ "id": "2023-18",
"label": "Day Eighteen",
"description": "Day eighteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/19/metadata.json b/challenges/aot/2023/19/metadata.json
index a20f0e75..2a5bc118 100644
--- a/challenges/aot/2023/19/metadata.json
+++ b/challenges/aot/2023/19/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-19",
+ "id": "2023-19",
"label": "Day Nineteen",
"description": "Day nineteen of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/2/metadata.json b/challenges/aot/2023/2/metadata.json
index 36d7e6c3..9460b1dc 100644
--- a/challenges/aot/2023/2/metadata.json
+++ b/challenges/aot/2023/2/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-3",
+ "id": "2023-3",
"label": "Day Three",
"description": "Day three of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/20/metadata.json b/challenges/aot/2023/20/metadata.json
index 8c451da4..672191b7 100644
--- a/challenges/aot/2023/20/metadata.json
+++ b/challenges/aot/2023/20/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-20",
+ "id": "2023-20",
"label": "Day Twenty",
"description": "Day twenty of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/21/metadata.json b/challenges/aot/2023/21/metadata.json
index 9f1c0dc4..77c6813f 100644
--- a/challenges/aot/2023/21/metadata.json
+++ b/challenges/aot/2023/21/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-21",
+ "id": "2023-21",
"label": "Day Twenty One",
"description": "Day twenty one of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/22/metadata.json b/challenges/aot/2023/22/metadata.json
index 4468eb64..5384dec2 100644
--- a/challenges/aot/2023/22/metadata.json
+++ b/challenges/aot/2023/22/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-22",
+ "id": "2023-22",
"label": "Day Twenty Two",
"description": "Day twenty two of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/23/metadata.json b/challenges/aot/2023/23/metadata.json
index 7af5bcdf..f9299e4b 100644
--- a/challenges/aot/2023/23/metadata.json
+++ b/challenges/aot/2023/23/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-23",
+ "id": "2023-23",
"label": "Day Twenty Three",
"description": "Day twenty three of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/24/metadata.json b/challenges/aot/2023/24/metadata.json
index a973ec36..63903624 100644
--- a/challenges/aot/2023/24/metadata.json
+++ b/challenges/aot/2023/24/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-24",
+ "id": "2023-24",
"label": "Day Twenty Four",
"description": "Day twenty four of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/25/metadata.json b/challenges/aot/2023/25/metadata.json
index 6df580b5..5872f806 100644
--- a/challenges/aot/2023/25/metadata.json
+++ b/challenges/aot/2023/25/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-25",
+ "id": "2023-25",
"label": "Day Twenty Five",
"description": "Day twenty five of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/3/metadata.json b/challenges/aot/2023/3/metadata.json
index 2fe658a7..a763aedc 100644
--- a/challenges/aot/2023/3/metadata.json
+++ b/challenges/aot/2023/3/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-2",
+ "id": "2023-2",
"label": "Day Two",
"description": "Day two of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/4/metadata.json b/challenges/aot/2023/4/metadata.json
index 9e33e6f3..61b6935d 100644
--- a/challenges/aot/2023/4/metadata.json
+++ b/challenges/aot/2023/4/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-4",
+ "id": "2023-4",
"label": "Day Four",
"description": "Day four of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/5/metadata.json b/challenges/aot/2023/5/metadata.json
index e60124bb..4ee10f8b 100644
--- a/challenges/aot/2023/5/metadata.json
+++ b/challenges/aot/2023/5/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-5",
+ "id": "2023-5",
"label": "Day Five",
"description": "Day five of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/6/metadata.json b/challenges/aot/2023/6/metadata.json
index 2d62b84b..df17bf80 100644
--- a/challenges/aot/2023/6/metadata.json
+++ b/challenges/aot/2023/6/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-6",
+ "id": "2023-6",
"label": "Day Six",
"description": "Day six of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/7/metadata.json b/challenges/aot/2023/7/metadata.json
index 1cf4d61b..9483e7e5 100644
--- a/challenges/aot/2023/7/metadata.json
+++ b/challenges/aot/2023/7/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-7",
+ "id": "2023-7",
"label": "Day Seven",
"description": "Day seven of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/8/metadata.json b/challenges/aot/2023/8/metadata.json
index 112c5c1e..71f6d824 100644
--- a/challenges/aot/2023/8/metadata.json
+++ b/challenges/aot/2023/8/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-8",
+ "id": "2023-8",
"label": "Day Eight",
"description": "Day eight of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2023/9/metadata.json b/challenges/aot/2023/9/metadata.json
index 50ac6290..36bb24ff 100644
--- a/challenges/aot/2023/9/metadata.json
+++ b/challenges/aot/2023/9/metadata.json
@@ -1,5 +1,5 @@
{
- "id": "day-9",
+ "id": "2023-9",
"label": "Day Nine",
"description": "Day nine of Advent of Typescript",
"difficulty": "event",
diff --git a/challenges/aot/2024/1/metadata.json b/challenges/aot/2024/1/metadata.json
new file mode 100644
index 00000000..119c5721
--- /dev/null
+++ b/challenges/aot/2024/1/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-1",
+ "label": "2024 Day One",
+ "description": "2024 Day one of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/1/prompt.md b/challenges/aot/2024/1/prompt.md
new file mode 100644
index 00000000..6dfaed0c
--- /dev/null
+++ b/challenges/aot/2024/1/prompt.md
@@ -0,0 +1,12 @@
+## Christmas Cookies
+
+It's December 1st! That means it's almost time for the big day! Santa has a preparation regimen that involves, of course, eating lots of delicious cookies.
+
+Santa's elves have provided Santa an API whereby Santa can submit his favorite cookie flavors. This year his favorites are:
+
+- `ginger-bread`
+- `chocolate-chip`
+
+But the elves have some kind of fancy code-gen build step (built in Rust, of course), so all Santa needs to do is update the `SantasFavoriteCookies` type to accept either of his favorite cookies.
+
+Can you help?
diff --git a/apps/aot/src/server/api/routers/challenge.ts b/challenges/aot/2024/1/solutions/1.ts
similarity index 100%
rename from apps/aot/src/server/api/routers/challenge.ts
rename to challenges/aot/2024/1/solutions/1.ts
diff --git a/challenges/aot/2024/1/tests.ts b/challenges/aot/2024/1/tests.ts
new file mode 100644
index 00000000..33f1ac91
--- /dev/null
+++ b/challenges/aot/2024/1/tests.ts
@@ -0,0 +1,6 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = SantasFavoriteCookies;
+// ^?
+type test_0_expected = 'ginger-bread' | 'chocolate-chip';
+type test_0 = Expect<Equal<test_0_actual, test_0_expected>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/1/tsconfig.json b/challenges/aot/2024/1/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/1/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/1/user.ts b/challenges/aot/2024/1/user.ts
new file mode 100644
index 00000000..c04366b9
--- /dev/null
+++ b/challenges/aot/2024/1/user.ts
@@ -0,0 +1 @@
+type SantasFavoriteCookies = unknown;
diff --git a/challenges/aot/2024/10/metadata.json b/challenges/aot/2024/10/metadata.json
new file mode 100644
index 00000000..bfd80838
--- /dev/null
+++ b/challenges/aot/2024/10/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-10",
+ "label": "2024 Day Ten",
+ "description": "2024 Day ten of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/10/prompt.md b/challenges/aot/2024/10/prompt.md
new file mode 100644
index 00000000..e69c8f7c
--- /dev/null
+++ b/challenges/aot/2024/10/prompt.md
@@ -0,0 +1,19 @@
+## Christmas Street Suffix Tester
+
+It's a little known fact that Santa's reindeer are orienteering experts. They're very particular, actually.
+
+To do this work well, they need to do some basic validation on the addresses. There were hopes among some reindeer to introduce a validation library this year, but there was simply too much infighting. It's kindof a mess. You see..
+
+- Comet and Vixen want to use Zod because they heard from a YouTuber they like that it's the best (they haven't actually looked ito anything else).
+- Cupid and Rudolph are simply too used to JSON Schema with AJV. They don't want to learn a new thing. They both had popular webpack plugins in the past that are no longer used by anyone and now they're a little bitter about change (in general).
+- Then you have Prancer. Prancer doesn't see the point in validation. Prance feels that validating inputs pollutes the code with type gymnastics that add ever so little joy to the development experience. Yep. Even the reindeer have one of _these_ on their team in 2023.
+- Meanwhile, Blitzen is pushing hard for typia because it's so fast (naturally).
+- Dancer and Donner don't seem to ever be able to articulate their opinions and usually just follow the rest of the group.
+
+## The Type's API
+
+So, for this year.. nothing fancy. We'll have to just write a `StreetSuffixTester` from scratch.
+
+This type will take two generic arguments. The first is for the street, and the second is for the suffix we're testing against.
+
+If the street ends with the suffix then the type should return `true` (otherwise, `false`).
diff --git a/challenges/aot/2024/10/solutions/1.ts b/challenges/aot/2024/10/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/10/tests.ts b/challenges/aot/2024/10/tests.ts
new file mode 100644
index 00000000..c605b1f1
--- /dev/null
+++ b/challenges/aot/2024/10/tests.ts
@@ -0,0 +1,21 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = StreetSuffixTester<'Candy Cane Way', 'Way'>;
+// ^?
+type test_0_expected = true;
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = StreetSuffixTester<'Chocalate Drive', 'Drive'>;
+// ^?
+type test_1_expected = true;
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = StreetSuffixTester<'Sugar Lane', 'Drive'>;
+// ^?
+type test_2_expected = false;
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type test_3_actual = StreetSuffixTester<'Fifth Dimensional Nebulo 9', 'invalid'>;
+// ^?
+type test_3_expected = false;
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/10/tsconfig.json b/challenges/aot/2024/10/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/10/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/10/user.ts b/challenges/aot/2024/10/user.ts
new file mode 100644
index 00000000..97b252d8
--- /dev/null
+++ b/challenges/aot/2024/10/user.ts
@@ -0,0 +1 @@
+type StreetSuffixTester = unknown;
diff --git a/challenges/aot/2024/11/metadata.json b/challenges/aot/2024/11/metadata.json
new file mode 100644
index 00000000..fae68a2a
--- /dev/null
+++ b/challenges/aot/2024/11/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-11",
+ "label": "2024 Day Eleven",
+ "description": "2024 Day eleven of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/11/prompt.md b/challenges/aot/2024/11/prompt.md
new file mode 100644
index 00000000..c8f631bf
--- /dev/null
+++ b/challenges/aot/2024/11/prompt.md
@@ -0,0 +1,23 @@
+## Protect the List
+
+_\[a conversation overhead two elves, Wunorse and Alabaster, at Santa's workshop on a monday morning after all the elves were forced to work all weekend\]_
+
+> _\[Wurnose\]_ The world will not know peace until every consultant involved in pushing SOC2 is dead and in the ground.
+>
+> _\[Alabaster\]_ Rough weekend?
+>
+> _\[Wurnose\]_ Yes. And now I've just gotten word from the higher-ups that I have to make our entire codebase's types readonly. DEEP readonly.
+>
+> _\[Alabaster\]_ Ouch. But at least it'll be better because _something something functional programming superiority something something_..
+>
+> _\[Wurnose\]_ That's not the point. The point is that there _IS NO POINT_. They're saying this is a requirement of SOC2. This doesn't have the slightest thing to do with SOC2. It's literally security theater at this point. And we're the puppets.
+>
+> _\[Alabaster\]_ Let's try to use this as an excuse to port the codebase to Rust where everything's immutable by default.
+>
+> _\[Wurnose\]_ I already tried that. They said Rust is too new and untested. They're considering Go, though.
+>
+> _\[Alabaster\]_ Lol dafuq? Rust is older than Go by like 3 years. Ok. Sorry I asked. Let's implement DeepReadonly then!
+
+## The API
+
+`SantaListProtector` takes in an arbitrary type as an input and modifies that type to be readonly. The trick here is that it must also work for any nested objects.
diff --git a/challenges/aot/2024/11/solutions/1.ts b/challenges/aot/2024/11/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/11/tests.ts b/challenges/aot/2024/11/tests.ts
new file mode 100644
index 00000000..886abf25
--- /dev/null
+++ b/challenges/aot/2024/11/tests.ts
@@ -0,0 +1,65 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = SantaListProtector<{
+ // ^?
+ hacksore: () => 'naughty';
+ trash: string;
+ elliot: {
+ penny: boolean;
+ candace: {
+ address: {
+ street: {
+ name: 'candy cane way';
+ num: number;
+ };
+ k: 'hello';
+ };
+ children: [
+ 'harry',
+ {
+ saying: ['hey'];
+ },
+ ];
+ };
+ };
+}>;
+type test_0_expected = {
+ readonly hacksore: () => 'naughty';
+ readonly trash: string;
+ readonly elliot: {
+ readonly penny: boolean;
+ readonly candace: {
+ readonly address: {
+ readonly street: {
+ readonly name: 'candy cane way';
+ readonly num: number;
+ };
+ readonly k: 'hello';
+ };
+ readonly children: readonly [
+ 'harry',
+ {
+ readonly saying: readonly ['hey'];
+ },
+ ];
+ };
+ };
+};
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = SantaListProtector<{
+ // ^?
+ theo: () => 'naughty';
+ prime: string;
+ netflix: {
+ isChill: boolean;
+ };
+}>;
+type test_1_expected = {
+ readonly theo: () => 'naughty';
+ readonly prime: string;
+ readonly netflix: {
+ readonly isChill: boolean;
+ };
+};
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
diff --git a/challenges/aot/2024/11/tsconfig.json b/challenges/aot/2024/11/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/11/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/11/user.ts b/challenges/aot/2024/11/user.ts
new file mode 100644
index 00000000..f9659921
--- /dev/null
+++ b/challenges/aot/2024/11/user.ts
@@ -0,0 +1 @@
+type SantaListProtector = unknown;
diff --git a/challenges/aot/2024/12/metadata.json b/challenges/aot/2024/12/metadata.json
new file mode 100644
index 00000000..5f9ee0d1
--- /dev/null
+++ b/challenges/aot/2024/12/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-12",
+ "label": "2024 Day Twelve",
+ "description": "2024 Day twelve of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/12/prompt.md b/challenges/aot/2024/12/prompt.md
new file mode 100644
index 00000000..dfe53821
--- /dev/null
+++ b/challenges/aot/2024/12/prompt.md
@@ -0,0 +1,9 @@
+## Find Santa
+
+Strange as it may sound.. Santa went to college with someone that works at a big silicon valley networking company. They've been buddies for years. So much so that in 2023 Santa pushed the workshop's board until they approved budget to get WiFi on the entire campus. That way Santa can browse TikTok as he walks from building to building across the campus.
+
+But after all that doomscrolling, Santa realized he has lost himself in a Christmas tree forest! A search team of elves has been deployed to find him, but he needs to give them more information about where he is among the trees.
+
+`FindSanta` is a type that takes a tuple as its only argument and returns the index where Santa is located. Let's help Santa get back to the thing he's best at: inspiring leadership.
+
+> note: `never` is returned if Santa cannot be found among the trees
diff --git a/challenges/aot/2024/12/solutions/1.ts b/challenges/aot/2024/12/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/12/tests.ts b/challenges/aot/2024/12/tests.ts
new file mode 100644
index 00000000..ee98a036
--- /dev/null
+++ b/challenges/aot/2024/12/tests.ts
@@ -0,0 +1,31 @@
+import { Expect, Equal } from 'type-testing';
+
+type Forest0 = ['🎅🏼', '🎄', '🎄', '🎄'];
+type test_0_actual = FindSanta<Forest0>;
+// ^?
+type test_0_expected = 0;
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type Forest1 = ['🎄', '🎅🏼', '🎄', '🎄', '🎄', '🎄'];
+type test_1_actual = FindSanta<Forest1>;
+// ^?
+type test_1_expected = 1;
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type Forest2 = ['🎄', '🎄', '🎅🏼', '🎄'];
+type test_2_actual = FindSanta<Forest2>;
+// ^?
+type test_2_expected = 2;
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type Forest3 = ['🎄', '🎄', '🎄', '🎅🏼', '🎄'];
+type test_3_actual = FindSanta<Forest3>;
+// ^?
+type test_3_expected = 3;
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
+
+type Forest4 = ['🎄', '🎄', '🎄', '🎄'];
+type test_4_actual = FindSanta<Forest4>;
+// ^?
+type test_4_expected = never;
+type test_4 = Expect<Equal<test_4_expected, test_4_actual>>;
diff --git a/challenges/aot/2024/12/tsconfig.json b/challenges/aot/2024/12/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/12/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/12/user.ts b/challenges/aot/2024/12/user.ts
new file mode 100644
index 00000000..94196628
--- /dev/null
+++ b/challenges/aot/2024/12/user.ts
@@ -0,0 +1 @@
+type FindSanta = unknown;
diff --git a/challenges/aot/2024/13/metadata.json b/challenges/aot/2024/13/metadata.json
new file mode 100644
index 00000000..d9deaaee
--- /dev/null
+++ b/challenges/aot/2024/13/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-13",
+ "label": "2024 Day Thirteen",
+ "description": "2024 Day thirteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/13/prompt.md b/challenges/aot/2024/13/prompt.md
new file mode 100644
index 00000000..66f98a84
--- /dev/null
+++ b/challenges/aot/2024/13/prompt.md
@@ -0,0 +1,10 @@
+## Count the Days
+
+The elves are SPENT. They need some motivation. They are (literally) counting down the days until Christmas.
+
+> _side note on performance bonuses.._
+> Santa promised that this year they'd get a bonus on the 26th (as well as an extra 2 PAID days off over the course of the next year!). Santa actually promised this last year (and the year before) but no one got a bonus because (according to Santa) "global warming has caused rising sea levels which in turn has eaten coastline, causing a need for many repairs at some of the high-density apartment complexes Santa owns in Florida, resulting in lower cashflow for the parent organization". That's what he said, anyway.
+
+So, as a small token of our appreciation, let's help the elves by implementing a type, `DayCounter`, that they can use to keep track of how many days are remaining before Christmas.
+
+The first argument is the beginning of the count (inclusive), and the second argument is the last number to count to (also inclusive). It should return a union of numbers representing the remaining days.
diff --git a/challenges/aot/2024/13/solutions/1.ts b/challenges/aot/2024/13/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/13/tests.ts b/challenges/aot/2024/13/tests.ts
new file mode 100644
index 00000000..e7c0963e
--- /dev/null
+++ b/challenges/aot/2024/13/tests.ts
@@ -0,0 +1,16 @@
+import { Expect, Equal } from 'type-testing';
+
+type TwelveDaysOfChristmas = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+type test_0_actual = DayCounter<1, 12>;
+// ^?
+type test_0_expected = TwelveDaysOfChristmas;
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type DaysUntilChristmas =
+ | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
+ | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20
+ | 21 | 22 | 23 | 24 | 25;
+type test_1_actual = DayCounter<1, 25>;
+// ^?
+type test_1_expected = DaysUntilChristmas;
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/13/tsconfig.json b/challenges/aot/2024/13/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/13/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/13/user.ts b/challenges/aot/2024/13/user.ts
new file mode 100644
index 00000000..add6793e
--- /dev/null
+++ b/challenges/aot/2024/13/user.ts
@@ -0,0 +1 @@
+type DayCounter = unknown;
diff --git a/challenges/aot/2024/14/metadata.json b/challenges/aot/2024/14/metadata.json
new file mode 100644
index 00000000..210c5f13
--- /dev/null
+++ b/challenges/aot/2024/14/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-14",
+ "label": "2024 Day Fourteen",
+ "description": "2024 Day fourteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/14/prompt.md b/challenges/aot/2024/14/prompt.md
new file mode 100644
index 00000000..179649df
--- /dev/null
+++ b/challenges/aot/2024/14/prompt.md
@@ -0,0 +1,29 @@
+## Naughty List Decipher
+
+_\[early on the morning of Thursday December 14th, Santa stumbles into office greeted by Bernard, the head elf..\]_
+
+> _\[Bernard\]_ YOU'RE A MESS. Were you out partying.. on a WEDNESDAY?? AGAIN??!!!
+>
+> _\[Santa\]_ It seems as such. Some investors were in town so we went over to the Mistletoe Lounge and things got a little out of hand.
+>
+> _\[Bernard\]_ I oughta report you to HR. Seriously. This is getting out of control.
+>
+> _\[Santa\]_ We're like a family here; no need for formal HR processes!
+>
+> _\[Bernard\]_ Where's the list for today's naughty kids? We're behind on coal lump production.
+>
+> _\[Santa\]_ Umm.
+>
+> _\[Bernard\]_ You're joking. Tell me you're joking. You lost the list _again_?
+>
+> _\[Santa\]_ Well, not _lost_ per se.
+>
+> _\[Bernard\]_ Then where is it?
+>
+> _\[Santa\]_ I have it.. but I only scribbled down the names real quick with slashes in between them.
+
+## Covering for Santa, again.
+
+Looks like we're gonna need to pick up the slack for Santa yet again. He's got a list like `"melkey/prime/theo/trash"` and we need to turn it into a union of strings `"melkey" | "prime" | "theo" | "trash"`.
+
+Let's get this done before the rest of the elves find out.
diff --git a/challenges/aot/2024/14/solutions/1.ts b/challenges/aot/2024/14/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/14/tests.ts b/challenges/aot/2024/14/tests.ts
new file mode 100644
index 00000000..93147353
--- /dev/null
+++ b/challenges/aot/2024/14/tests.ts
@@ -0,0 +1,16 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = DecipherNaughtyList<'timmy/jimmy'>;
+// ^?
+type test_0_expected = 'jimmy' | 'timmy';
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = DecipherNaughtyList<'elliot'>;
+// ^?
+type test_1_expected = 'elliot';
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = DecipherNaughtyList<'melkey/prime/theo/trash'>;
+// ^?
+type test_2_expected = 'melkey' | 'prime' | 'theo' | 'trash';
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
diff --git a/challenges/aot/2024/14/tsconfig.json b/challenges/aot/2024/14/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/14/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/14/user.ts b/challenges/aot/2024/14/user.ts
new file mode 100644
index 00000000..f4c57f11
--- /dev/null
+++ b/challenges/aot/2024/14/user.ts
@@ -0,0 +1 @@
+type DecipherNaughyList = unknown;
diff --git a/challenges/aot/2024/15/metadata.json b/challenges/aot/2024/15/metadata.json
new file mode 100644
index 00000000..e97496cf
--- /dev/null
+++ b/challenges/aot/2024/15/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-15",
+ "label": "2024 Day Fifteen",
+ "description": "2024 Day fifteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/15/prompt.md b/challenges/aot/2024/15/prompt.md
new file mode 100644
index 00000000..abb58d7b
--- /dev/null
+++ b/challenges/aot/2024/15/prompt.md
@@ -0,0 +1,42 @@
+## Box The Toys!
+
+_\[Santa walks by as Bernard, the head elf, is yelling at the other elves..\]_
+
+> _\[Bernard (to his staff)\]_ LET'S GO ELVES! LET'S GO! KEEP BOXING TOYS!
+>
+> _\[Santa\]_ Bernard.. Seems like it's not going well.
+>
+> _\[Bernard\]_ Was anyone asking you!?
+>
+> _\[Santa\]_ Did you deploy the new toy boxing API yesterday?
+>
+> _\[Bernard\]_ No, we didn't get to it. Julius called out sick.
+>
+> _\[Santa\]_ Taking too many sick days shows a lack of commitment. We should get rid of Julius.
+>
+> _\[Bernard (rolling eyes)\]_ And then not replace him? Yeah. No Thanks.
+>
+> _\[Santa\]_ Well it was on the sprint and today's the last day of the sprint.
+>
+> _\[Bernard\]_ We don't deploy on Fridays.
+>
+> _\[Santa\]_ Aren't we doing continuous deployment now? You had this whole big thing at the last shareholder meeting about it?
+>
+> _\[Bernard\]_ No. For the 100th time. We're doing continuous _delivery_, which is completely different and gives us control over when we deploy.
+>
+> _\[Santa\]_ Well I need that `BoxToys` type. If you can't handle this project, Bernard, there are plenty of other elves who can. I need your full commitment.
+>
+> _\[Bernard\]_ Ok. Fine. I'll do it myself.
+>
+> _\[Santa\]_ That's what I like to see!
+
+## The `BoxToys` API
+
+The `BoxToys` type takes two arguments:
+
+1. the name of a toy
+2. the number of of boxes we need for this toy
+
+And the type will return a tuple containing that toy that number of times.
+
+But there's one little thing.. We need to support the number of boxes being a union. That means our resulting tuple can also be a union. Check out `test_nutcracker` in the tests to see how that works.
diff --git a/challenges/aot/2024/15/solutions/1.ts b/challenges/aot/2024/15/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/15/tests.ts b/challenges/aot/2024/15/tests.ts
new file mode 100644
index 00000000..cf7ab550
--- /dev/null
+++ b/challenges/aot/2024/15/tests.ts
@@ -0,0 +1,13 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_doll_actual = BoxToys<'doll', 1>;
+// ^?
+type test_doll_expected = ['doll'];
+type test_doll = Expect<Equal<test_doll_expected, test_doll_actual>>;
+
+type test_nutcracker_actual = BoxToys<'nutcracker', 3 | 4>;
+// ^?
+type test_nutcracker_expected =
+ | ['nutcracker', 'nutcracker', 'nutcracker']
+ | ['nutcracker', 'nutcracker', 'nutcracker', 'nutcracker'];
+type test_nutcracker = Expect<Equal<test_nutcracker_expected, test_nutcracker_actual>>;
diff --git a/challenges/aot/2024/15/tsconfig.json b/challenges/aot/2024/15/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/15/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/15/user.ts b/challenges/aot/2024/15/user.ts
new file mode 100644
index 00000000..566a0022
--- /dev/null
+++ b/challenges/aot/2024/15/user.ts
@@ -0,0 +1 @@
+type BoxToys = unknown;
diff --git a/challenges/aot/2024/16/metadata.json b/challenges/aot/2024/16/metadata.json
new file mode 100644
index 00000000..54d69b25
--- /dev/null
+++ b/challenges/aot/2024/16/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-16",
+ "label": "2024 Day Sixteen",
+ "description": "2024 Day sixteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/16/prompt.md b/challenges/aot/2024/16/prompt.md
new file mode 100644
index 00000000..ac6b3788
--- /dev/null
+++ b/challenges/aot/2024/16/prompt.md
@@ -0,0 +1,9 @@
+## Find Santa (part 2)
+
+Since the episode with him getting lost on Tuesday (Day 12), the elves have started to get concerned about Santa getting lost again, but deeper in the forest. Since Santa's college buddy got WiFi installed in the whole property, Santa just wanders around scrolling TikTok without looking where he's going. Santa claimed that the reason the whole campus needed WiFi (even the forest) was to "future-proof the business" and "attract top talent" but it's beginning to seem like it was so he could personally get better phone service (cell reception in the north pole isn't great and without 116th H.R.7302, neither is the rural internet speed).
+
+Sure enough. It happened again. Santa got lost, again, but this time much deeper in the forest.
+
+This time we have to search columns as well as rows to find him.
+
+The `FindSanta` takes only one argument, the forest (an array of arrays), and returns the `[Row, Column]` indices where Santa is located. Then an elf search team can be deployed to retrieve him.
diff --git a/challenges/aot/2024/16/solutions/1.ts b/challenges/aot/2024/16/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/16/tests.ts b/challenges/aot/2024/16/tests.ts
new file mode 100644
index 00000000..5eba19b2
--- /dev/null
+++ b/challenges/aot/2024/16/tests.ts
@@ -0,0 +1,56 @@
+import { Expect, Equal } from 'type-testing';
+
+type Forest0 = [
+ ['🎅🏼', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+];
+type test_0_actual = FindSanta<Forest0>;
+// ^?
+type test_0_expected = [0, 0];
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type Forest1 = [
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎅🏼', '🎄', '🎄'],
+];
+type test_1_actual = FindSanta<Forest1>;
+// ^?
+type test_1_expected = [3, 1];
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type Forest2 = [
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎅🏼', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+];
+type test_2_actual = FindSanta<Forest2>;
+// ^?
+type test_2_expected = [2, 2];
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type Forest3 = [
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎅🏼', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+];
+type test_3_actual = FindSanta<Forest3>;
+// ^?
+type test_3_expected = [2, 1];
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
+
+type Forest4 = [
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎅🏼', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+ ['🎄', '🎄', '🎄', '🎄'],
+];
+type test_4_actual = FindSanta<Forest4>;
+// ^?
+type test_4_expected = [1, 2];
+type test_4 = Expect<Equal<test_4_expected, test_4_actual>>;
diff --git a/challenges/aot/2024/16/tsconfig.json b/challenges/aot/2024/16/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/16/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/16/user.ts b/challenges/aot/2024/16/user.ts
new file mode 100644
index 00000000..94196628
--- /dev/null
+++ b/challenges/aot/2024/16/user.ts
@@ -0,0 +1 @@
+type FindSanta = unknown;
diff --git a/challenges/aot/2024/17/metadata.json b/challenges/aot/2024/17/metadata.json
new file mode 100644
index 00000000..ab990087
--- /dev/null
+++ b/challenges/aot/2024/17/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-17",
+ "label": "2024 Day Seventeen",
+ "description": "2024 Day seventeen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/17/prompt.md b/challenges/aot/2024/17/prompt.md
new file mode 100644
index 00000000..d04c0269
--- /dev/null
+++ b/challenges/aot/2024/17/prompt.md
@@ -0,0 +1,18 @@
+## Rock, Paper, Scissors
+
+It's Sunday and there's one week to go before the big day (Christmas Eve) when the elfs' work for the year will finally be complete. For the last 20 years the only game the elves have had to play together is StarCraft. They're looking for a fresh game to play.
+
+So, they get the idea to try a Rock, Paper, Scissors tournament.
+
+But the elves are sorta nerdy so they want to accomplish this using TypeScript types. The `WhoWins` should type to correctly determine the winner in a Rock-Paper-Scissors game. The first argument is the opponent and the second argument is you!
+
+## What's Rock, Paper, Scissors?
+
+In case you haven't played it before, basically:
+
+- it's a two player game where each player picks one of three options: Rock (👊🏻), Paper (🖐🏾), and Scissors (✌🏽)
+- game rules:
+ - Rock crushes Scissors (Rock wins)
+ - Scissors cuts Paper (Scissors wins)
+ - Paper covers Rock (Paper wins)
+ - otherwise, a draw
diff --git a/challenges/aot/2024/17/solutions/1.ts b/challenges/aot/2024/17/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/17/tests.ts b/challenges/aot/2024/17/tests.ts
new file mode 100644
index 00000000..47fedd6a
--- /dev/null
+++ b/challenges/aot/2024/17/tests.ts
@@ -0,0 +1,46 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = WhoWins<'👊🏻', '🖐🏾'>;
+// ^?
+type test_0_expected = 'win';
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = WhoWins<'👊🏻', '✌🏽'>;
+// ^?
+type test_1_expected = 'lose';
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = WhoWins<'👊🏻', '👊🏻'>;
+// ^?
+type test_2_expected = 'draw';
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type test_3_actual = WhoWins<'🖐🏾', '👊🏻'>;
+// ^?
+type test_3_expected = 'lose';
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
+
+type test_4_actual = WhoWins<'🖐🏾', '✌🏽'>;
+// ^?
+type test_4_expected = 'win';
+type test_4 = Expect<Equal<test_4_expected, test_4_actual>>;
+
+type test_5_actual = WhoWins<'🖐🏾', '🖐🏾'>;
+// ^?
+type test_5_expected = 'draw';
+type test_5 = Expect<Equal<test_5_expected, test_5_actual>>;
+
+type test_6_actual = WhoWins<'✌🏽', '👊🏻'>;
+// ^?
+type test_6_expected = 'win';
+type test_6 = Expect<Equal<test_6_expected, test_6_actual>>;
+
+type test_7_actual = WhoWins<'✌🏽', '✌🏽'>;
+// ^?
+type test_7_expected = 'draw';
+type test_7 = Expect<Equal<test_7_expected, test_7_actual>>;
+
+type test_8_actual = WhoWins<'✌🏽', '🖐🏾'>;
+// ^?
+type test_8_expected = 'lose';
+type test_8 = Expect<Equal<test_8_expected, test_8_actual>>;
diff --git a/challenges/aot/2024/17/tsconfig.json b/challenges/aot/2024/17/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/17/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/17/user.ts b/challenges/aot/2024/17/user.ts
new file mode 100644
index 00000000..55284ce3
--- /dev/null
+++ b/challenges/aot/2024/17/user.ts
@@ -0,0 +1,3 @@
+type RockPaperScissors = '👊🏻' | '🖐🏾' | '✌🏽';
+
+type WhoWins = unknown;
diff --git a/challenges/aot/2024/18/metadata.json b/challenges/aot/2024/18/metadata.json
new file mode 100644
index 00000000..de3192e9
--- /dev/null
+++ b/challenges/aot/2024/18/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-18",
+ "label": "2024 Day Eighteen",
+ "description": "2024 Day eighteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/18/prompt.md b/challenges/aot/2024/18/prompt.md
new file mode 100644
index 00000000..e5e2190b
--- /dev/null
+++ b/challenges/aot/2024/18/prompt.md
@@ -0,0 +1,13 @@
+## Santa's Remaining Deliveries
+
+Santa needs your help to count the number of presents he has to deliver! He's got all kinds of presents, from video game consoles (🎮), stuffed animals (🧸), toy cars (🏎️), books (📚), and more!
+
+We need a general purpose type that can take a tuple of items as its first arguemnt and an item to search for as the second argument. It should return a count of the item specified.
+
+For example:
+
+```ts
+Count<['👟', '👟', '💻', '🎸', '🧩', '👟', '🧸'], '👟'>;
+```
+
+should return `3` because there are three `👟`.
diff --git a/challenges/aot/2024/18/solutions/1.ts b/challenges/aot/2024/18/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/18/tests.ts b/challenges/aot/2024/18/tests.ts
new file mode 100644
index 00000000..0c8a1c4b
--- /dev/null
+++ b/challenges/aot/2024/18/tests.ts
@@ -0,0 +1,47 @@
+import { Expect, Equal } from 'type-testing';
+
+
+type ToySack = [
+ '🎸', '🎧', '👟', '👟', '💻', '🪀', '🧩', '🎮',
+ '🎨', '🕹️', '📱', '🧩', '🧸', '🎧', '👟', '🚲',
+ '📚', '⌚', '🎨', '👟', '🎸', '🧸', '👟', '🎸',
+ '📱', '🎧', '🎮', '🎒', '📱', '🧩', '🧩', '🚲',
+ '🕹️', '🧵', '📱', '🕹️', '🕰️', '🧢', '🕹️', '👟',
+ '🧸', '📚', '🧁', '🧩', '🎸', '🎮', '🧁', '📚',
+ '💻', '⌚', '🛹', '🧁', '🧣', '🪁', '🎸', '🧸',
+ '🧸', '🧸', '🧩', '🪁', '🏎️', '🏎️', '🧁', '📚',
+ '🧸', '🕶️', '💻', '⌚', '⌚', '🕶️', '🎧', '🎧',
+ '🎧', '💻', '👟', '🎸', '💻', '🪐', '📚', '🎨',
+ '📱', '🎧', '📱', '🎸', '🏎️', '👟', '🚲', '📱',
+ '🚲', '🎸'
+];
+
+type test_0_actual = Count<ToySack, '👟'>;
+// ^?
+type test_0_expected = 8;
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = Count<ToySack, '🧦'>;
+// ^?
+type test_1_expected = 0;
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = Count<ToySack, '🧩'>;
+// ^?
+type test_2_expected = 6;
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type test_3_actual = Count<ToySack, '🛹'>;
+// ^?
+type test_3_expected = 1;
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
+
+type test_4_actual = Count<ToySack, '🏎️'>;
+// ^?
+type test_4_expected = 3;
+type test_4 = Expect<Equal<test_4_expected, test_4_actual>>;
+
+type test_5_actual = Count<ToySack, '📚'>;
+// ^?
+type test_5_expected = 5;
+type test_5 = Expect<Equal<test_5_expected, test_5_actual>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/18/tsconfig.json b/challenges/aot/2024/18/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/18/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/18/user.ts b/challenges/aot/2024/18/user.ts
new file mode 100644
index 00000000..46f36921
--- /dev/null
+++ b/challenges/aot/2024/18/user.ts
@@ -0,0 +1 @@
+type Count = unknown;
diff --git a/challenges/aot/2024/19/metadata.json b/challenges/aot/2024/19/metadata.json
new file mode 100644
index 00000000..ff223e87
--- /dev/null
+++ b/challenges/aot/2024/19/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-19",
+ "label": "2024 Day Nineteen",
+ "description": "2024 Day nineteen of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/19/prompt.md b/challenges/aot/2024/19/prompt.md
new file mode 100644
index 00000000..b802a8ba
--- /dev/null
+++ b/challenges/aot/2024/19/prompt.md
@@ -0,0 +1,40 @@
+<!-- prettier-ignore -->
+## Help Santa Embezzle Funds
+
+The shady WiFi installment by Santa's college buddy in Days 12 and 16 aren't the only questionable business dealing Santa is involved in. Another of Santa's friends from college, Tod, is a partial owner of the X Games (an "extreme sports" version of the Olympics). In recent years, Santa realized that he can use his position of power at the toy factory to embezzle funds through a shell corporation that he started with Tod. The shell corporation, Icecap Assets Management, Inc., recently acquired a skateboard and scooter manufacturer, SkateScoot Syndicate. It's perfect timing because in 2022 Icecap had acquired another company that makes surfboards and bmx bikes, RideWave Dynamics.
+
+Now, all that's left to do is make sure that every child gets a skateboard or a scooter! Then the funds will be laundered to Icecap via SkateScoot and RideWave, after which Santa and Tod can then take total control of the funds.
+
+Santa made himself a list like this:
+
+```ts
+type List = [2, 1, 3, 3, 1, 2, 2, 1];
+```
+
+And since Santa doesn't want to raise suspicion (by giving the same thing to every kid) he figures he'll alternate like this:
+
+1. '🛹' (skateboard)
+2. '🚲' (bmx bike)
+3. '🛴' (scooter)
+4. '🏄' (surfboard)
+5. (loop back to skateboard)
+
+```ts
+type Result = [
+ '🛹',
+ '🛹',
+ '🚲',
+ '🛴',
+ '🛴',
+ '🛴',
+ '🏄',
+ '🏄',
+ '🏄',
+ '🛹',
+ '🚲',
+ '🚲',
+ '🛴',
+ '🛴',
+ '🏄',
+];
+```
diff --git a/challenges/aot/2024/19/solutions/1.ts b/challenges/aot/2024/19/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/19/tests.ts b/challenges/aot/2024/19/tests.ts
new file mode 100644
index 00000000..051b6ac6
--- /dev/null
+++ b/challenges/aot/2024/19/tests.ts
@@ -0,0 +1,40 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = Rebuild<[2, 1, 3, 3, 1, 1, 2]>;
+// ^?
+type test_0_expected = [
+ '🛹', '🛹',
+ '🚲',
+ '🛴', '🛴', '🛴',
+ '🏄', '🏄', '🏄',
+ '🛹',
+ '🚲',
+ '🛴', '🛴',
+];
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = Rebuild<[3, 3, 2, 1, 2, 1, 2]>;
+// ^?
+type test_1_expected = [
+ '🛹', '🛹', '🛹',
+ '🚲', '🚲', '🚲',
+ '🛴', '🛴',
+ '🏄',
+ '🛹', '🛹',
+ '🚲',
+ '🛴', '🛴'
+];
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = Rebuild<[2, 3, 3, 5, 1, 1, 2]>;
+// ^?
+type test_2_expected = [
+ '🛹', '🛹',
+ '🚲', '🚲', '🚲',
+ '🛴', '🛴', '🛴',
+ '🏄', '🏄', '🏄', '🏄', '🏄',
+ '🛹',
+ '🚲',
+ '🛴', '🛴',
+];
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/19/tsconfig.json b/challenges/aot/2024/19/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/19/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/19/user.ts b/challenges/aot/2024/19/user.ts
new file mode 100644
index 00000000..d3ea55f8
--- /dev/null
+++ b/challenges/aot/2024/19/user.ts
@@ -0,0 +1 @@
+type Rebuild = unknown;
diff --git a/challenges/aot/2024/2/metadata.json b/challenges/aot/2024/2/metadata.json
new file mode 100644
index 00000000..38ecb15f
--- /dev/null
+++ b/challenges/aot/2024/2/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-3",
+ "label": "2024 Day Three",
+ "description": "2024 Day three of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/2/prompt.md b/challenges/aot/2024/2/prompt.md
new file mode 100644
index 00000000..f89103b8
--- /dev/null
+++ b/challenges/aot/2024/2/prompt.md
@@ -0,0 +1,9 @@
+## The Gift Wrapper
+
+Did you know that there's also monetary inflation at the North Pole? You betcha, there is. And after 200+ years without a pay raise, Santa's elves are beginning to discuss a general strike.
+
+December 3rd is just about the worst time imaginable for such a strike, and Santa's desperate to calm the elves down. If he can just wrap a few presents, maybe the elves will forget that they're being paid well below market rate (don't worry: the North Pole's actually still a Deleware-based startup so therefore it's ok).
+
+There's a `GiftWrapper` type to help keep the wrapping process organized, but it needs something... it needs some way to be parameterized. What we have so far is nice as a _generic_ (\*wink wink\*) starting point... but it needs some way to provide specific values for `Present`, `From`, and `To` at the type layer..
+
+Please help! Otherwise the reindeer might catch wind of this and start a strike of their own in solidarity with the elves!
diff --git a/challenges/aot/2024/2/solutions/1.ts b/challenges/aot/2024/2/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/2/tests.ts b/challenges/aot/2024/2/tests.ts
new file mode 100644
index 00000000..27477a88
--- /dev/null
+++ b/challenges/aot/2024/2/tests.ts
@@ -0,0 +1,25 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_SantaToTrash_actual = GiftWrapper<'Car', 'Santa', 'Trash'>;
+// ^?
+type test_SantaToTrash_expected = { present: 'Car', from: 'Santa', to: 'Trash' };
+type test_SantaToTrash = Expect<Equal<
+ test_SantaToTrash_actual,
+ test_SantaToTrash_expected
+>>;
+
+type test_TrashToPrime_actual = GiftWrapper<'vscode', 'Trash', 'Prime'>;
+// ^?
+type test_TrashToPrime_expected = { present: 'vscode', from: 'Trash', to: 'Prime' };
+type test_TrashToPrime = Expect<Equal<
+ test_TrashToPrime_actual,
+ test_TrashToPrime_expected
+>>;
+
+type test_DanToEvan_actual = GiftWrapper<'javascript', 'Dan', 'Evan'>;
+// ^?
+type test_DanToEvan_expected = { present: 'javascript', from: 'Dan', to: 'Evan' };
+type test_DanToEvan = Expect<Equal<
+ test_DanToEvan_actual,
+ test_DanToEvan_expected
+>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/2/tsconfig.json b/challenges/aot/2024/2/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/2/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/2/user.ts b/challenges/aot/2024/2/user.ts
new file mode 100644
index 00000000..6d13f972
--- /dev/null
+++ b/challenges/aot/2024/2/user.ts
@@ -0,0 +1,5 @@
+type GiftWrapper = {
+ present: unknown;
+ from: unknown;
+ to: unknown;
+};
diff --git a/challenges/aot/2024/20/metadata.json b/challenges/aot/2024/20/metadata.json
new file mode 100644
index 00000000..fe622bd9
--- /dev/null
+++ b/challenges/aot/2024/20/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-20",
+ "label": "2024 Day Twenty",
+ "description": "2024 Day twenty of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/20/prompt.md b/challenges/aot/2024/20/prompt.md
new file mode 100644
index 00000000..c690e4f1
--- /dev/null
+++ b/challenges/aot/2024/20/prompt.md
@@ -0,0 +1,28 @@
+## TypeScript ASCII Art!
+
+Your goal for this challenge is to take an input like `Hi` and turn it into ASCII art!
+
+So for example `Hi` would turn into:
+
+```
+█ █ █
+█▀█ █
+▀ ▀ █
+```
+
+### _but there's a twist!_
+
+You'll also need to handle newlines! Take a look at the tests to see some examples of that in action.
+
+Enjoy!
+
+---
+
+...wait
+
+....what's that.....
+
+> _**!! BREAKING NEWS JUST-IN FROM THE TYPEHERO INVESTIGATIVE REPORTING TEAM !!**_
+>
+> We have just received word that the term "ASCII art" is commonly used to refer to text-based visual art in general. That means that although characters are not part of the ISO-8859-1 character encoding set, it's still ASCII art! We also just received word that pencil lead has actually been made of graphite since the 16th century but we all still call it "lead" even though it's not made from the 82nd atomic element, lead(!!).
+> News, Sports, and Weather at 11. Back to you Carol.
diff --git a/challenges/aot/2024/20/solutions/1.ts b/challenges/aot/2024/20/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/20/tests.ts b/challenges/aot/2024/20/tests.ts
new file mode 100644
index 00000000..cc360199
--- /dev/null
+++ b/challenges/aot/2024/20/tests.ts
@@ -0,0 +1,55 @@
+import { Equal, Expect } from "type-testing";
+
+type test_0_actual = ToAsciiArt<" * : * Merry * : * \n Christmas ">;
+// ^?
+type test_0_expected = [
+ "░░░░░#░░░█▄░▄█ █▀▀ █▀█ █▀█ █ █ ░░░#░░░░░",
+ "░░░#░░░#░█ ▀ █ █▀▀ ██▀ ██▀ ▀█▀ ░#░░░#░░░",
+ "░░░░░#░░░▀ ░░▀ ▀▀▀ ▀ ▀ ▀ ▀ ░▀ ░░░░#░░░░░",
+ "░░█▀▀ █ █ █▀█ █ █▀▀ ▀█▀ █▄░▄█ █▀█ █▀▀ ░░",
+ "░░█ ░░█▀█ ██▀ █ ▀▀█ ░█ ░█ ▀ █ █▀█ ▀▀█ ░░",
+ "░░▀▀▀ ▀ ▀ ▀ ▀ ▀ ▀▀▀ ░▀ ░▀ ░░▀ ▀ ▀ ▀▀▀ ░░",
+];
+type test_0 = Expect<Equal<test_0_actual, test_0_expected>>;
+
+type test_1_actual = ToAsciiArt<" Happy new \n * : * : * Year * : * : * ">;
+// ^?
+type test_1_expected = [
+ "░░█ █ █▀█ █▀█ █▀█ █ █ ░█▄░█ █▀▀ █ ░░█ ░░",
+ "░░█▀█ █▀█ █▀▀ █▀▀ ▀█▀ ░█ ▀█ █▀▀ █▄▀▄█ ░░",
+ "░░▀ ▀ ▀ ▀ ▀ ░░▀ ░░░▀ ░░▀ ░▀ ▀▀▀ ▀ ░ ▀ ░░",
+ "░░░░#░░░#░░░█ █ █▀▀ █▀█ █▀█ ░░░#░░░#░░░░",
+ "░░#░░░#░░░#░▀█▀ █▀▀ █▀█ ██▀ ░#░░░#░░░#░░",
+ "░░░░#░░░#░░░░▀ ░▀▀▀ ▀ ▀ ▀ ▀ ░░░#░░░#░░░░",
+];
+type test_1 = Expect<Equal<test_1_actual, test_1_expected>>;
+
+type test_2_actual = ToAsciiArt<" * : * : * : * : * : * \n Trash \n * : * : * : * : * : * ">;
+// ^?
+type test_2_expected = [
+ "░░░░#░░░#░░░#░░░#░░░#░░░",
+ "░░#░░░#░░░#░░░#░░░#░░░#░",
+ "░░░░#░░░#░░░#░░░#░░░#░░░",
+ "░░▀█▀ █▀█ █▀█ █▀▀ █ █ ░░",
+ "░░░█ ░██▀ █▀█ ▀▀█ █▀█ ░░",
+ "░░░▀ ░▀ ▀ ▀ ▀ ▀▀▀ ▀ ▀ ░░",
+ "░░░░#░░░#░░░#░░░#░░░#░░░",
+ "░░#░░░#░░░#░░░#░░░#░░░#░",
+ "░░░░#░░░#░░░#░░░#░░░#░░░",
+];
+type test_2 = Expect<Equal<test_2_actual, test_2_expected>>;
+
+type test_3_actual = ToAsciiArt<" : * : * : * : * : * : * : \n Ecyrbe \n : * : * : * : * : * : * : ">;
+// ^?
+type test_3_expected = [
+ "░░#░░░#░░░#░░░#░░░#░░░#░░░#░",
+ "░░░░#░░░#░░░#░░░#░░░#░░░#░░░",
+ "░░#░░░#░░░#░░░#░░░#░░░#░░░#░",
+ "░░█▀▀ █▀▀ █ █ █▀█ █▀▄ █▀▀ ░░",
+ "░░█▀▀ █ ░░▀█▀ ██▀ █▀▄ █▀▀ ░░",
+ "░░▀▀▀ ▀▀▀ ░▀ ░▀ ▀ ▀▀ ▀▀▀ ░░",
+ "░░#░░░#░░░#░░░#░░░#░░░#░░░#░",
+ "░░░░#░░░#░░░#░░░#░░░#░░░#░░░",
+ "░░#░░░#░░░#░░░#░░░#░░░#░░░#░",
+];
+type test_3 = Expect<Equal<test_3_actual, test_3_expected>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/20/tsconfig.json b/challenges/aot/2024/20/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/20/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/20/user.ts b/challenges/aot/2024/20/user.ts
new file mode 100644
index 00000000..09a61486
--- /dev/null
+++ b/challenges/aot/2024/20/user.ts
@@ -0,0 +1,90 @@
+// prettier-ignore
+type Letters = {
+ A: [
+ '█▀█ ',
+ '█▀█ ',
+ '▀ ▀ ',
+ ],
+ B: [
+ '█▀▄ ',
+ '█▀▄ ',
+ '▀▀ '
+ ],
+ C: [
+ '█▀▀ ',
+ '█ ░░',
+ '▀▀▀ '
+ ],
+ E: [
+ '█▀▀ ',
+ '█▀▀ ',
+ '▀▀▀ '
+ ],
+ H: [
+ '█ █ ',
+ '█▀█ ',
+ '▀ ▀ '
+ ],
+ I: [
+ '█ ',
+ '█ ',
+ '▀ '
+ ],
+ M: [
+ '█▄░▄█ ',
+ '█ ▀ █ ',
+ '▀ ░░▀ '
+ ],
+ N: [
+ '█▄░█ ',
+ '█ ▀█ ',
+ '▀ ░▀ '
+ ],
+ P: [
+ '█▀█ ',
+ '█▀▀ ',
+ '▀ ░░'
+ ],
+ R: [
+ '█▀█ ',
+ '██▀ ',
+ '▀ ▀ '
+ ],
+ S: [
+ '█▀▀ ',
+ '▀▀█ ',
+ '▀▀▀ '
+ ],
+ T: [
+ '▀█▀ ',
+ '░█ ░',
+ '░▀ ░'
+ ],
+ Y: [
+ '█ █ ',
+ '▀█▀ ',
+ '░▀ ░'
+ ],
+ W: [
+ '█ ░░█ ',
+ '█▄▀▄█ ',
+ '▀ ░ ▀ '
+ ],
+ ' ': [
+ '░',
+ '░',
+ '░'
+ ],
+ ':': [
+ '#',
+ '░',
+ '#'
+ ],
+ '*': [
+ '░',
+ '#',
+ '░'
+ ],
+};
+
+type ToAsciiArt = unknown;
diff --git a/challenges/aot/2024/21/metadata.json b/challenges/aot/2024/21/metadata.json
new file mode 100644
index 00000000..b54e7b83
--- /dev/null
+++ b/challenges/aot/2024/21/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-21",
+ "label": "2024 Day Twenty One",
+ "description": "2024 Day twenty one of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/21/prompt.md b/challenges/aot/2024/21/prompt.md
new file mode 100644
index 00000000..149453b6
--- /dev/null
+++ b/challenges/aot/2024/21/prompt.md
@@ -0,0 +1,10 @@
+## What is Tic Tac Toe?
+
+Tic-Tac-Toe is a two-player game where players alternate marking `❌`s and `⭕`s in a 3x3 grid, aiming to get three in a row.
+
+> fun fact:
+> Did you know that tic tac toe is widely considered to be the first computer video game ever created?! That's right! A S Douglas [implemented it](<https://en.wikipedia.org/wiki/OXO_(video_game)>) all the way back in 1952, the same year as the coronation of Queen Elizabeth II.
+
+## Solving Tic Tac Toe
+
+Your goal for this challenge is to use TypeScript types to encode the game logic of Tic Tac Toe. Eventually, every game will end with one of the players winning or a draw.
diff --git a/challenges/aot/2024/21/solutions/1.ts b/challenges/aot/2024/21/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/21/tests.ts b/challenges/aot/2024/21/tests.ts
new file mode 100644
index 00000000..b6d93780
--- /dev/null
+++ b/challenges/aot/2024/21/tests.ts
@@ -0,0 +1,115 @@
+import { Equal, Expect } from 'type-testing';
+
+type test_move1_actual = TicTacToe<NewGame, 'top-center'>;
+// ^?
+type test_move1_expected = {
+ board: [
+ [ ' ', '❌', ' ' ],
+ [ ' ', ' ', ' ' ],
+ [ ' ', ' ', ' ' ]
+ ];
+ state: '⭕';
+};
+type test_move1 = Expect<Equal<test_move1_actual, test_move1_expected>>;
+
+type test_move2_actual = TicTacToe<test_move1_actual, 'top-left'>;
+// ^?
+type test_move2_expected = {
+ board: [
+ ['⭕', '❌', ' '],
+ [' ', ' ', ' '],
+ [' ', ' ', ' ']];
+ state: '❌';
+}
+type test_move2 = Expect<Equal<test_move2_actual, test_move2_expected>>;
+
+type test_move3_actual = TicTacToe<test_move2_actual, 'middle-center'>;
+// ^?
+type test_move3_expected = {
+ board: [
+ [ '⭕', '❌', ' ' ],
+ [ ' ', '❌', ' ' ],
+ [ ' ', ' ', ' ' ]
+ ];
+ state: '⭕';
+};
+type test_move3 = Expect<Equal<test_move3_actual, test_move3_expected>>;
+
+type test_move4_actual = TicTacToe<test_move3_actual, 'bottom-left'>;
+// ^?
+type test_move4_expected = {
+ board: [
+ [ '⭕', '❌', ' ' ],
+ [ ' ', '❌', ' ' ],
+ [ '⭕', ' ', ' ' ]
+ ];
+ state: '❌';
+};
+type test_move4 = Expect<Equal<test_move4_actual, test_move4_expected>>;
+
+
+type test_x_win_actual = TicTacToe<test_move4_actual, 'bottom-center'>;
+// ^?
+type test_x_win_expected = {
+ board: [
+ [ '⭕', '❌', ' ' ],
+ [ ' ', '❌', ' ' ],
+ [ '⭕', '❌', ' ' ]
+ ];
+ state: '❌ Won';
+};
+type test_x_win = Expect<Equal<test_x_win_actual, test_x_win_expected>>;
+
+type type_move5_actual = TicTacToe<test_move4_actual, 'bottom-right'>;
+// ^?
+type type_move5_expected = {
+ board: [
+ [ '⭕', '❌', ' ' ],
+ [ ' ', '❌', ' ' ],
+ [ '⭕', ' ', '❌' ]
+ ];
+ state: '⭕';
+};
+type test_move5 = Expect<Equal<type_move5_actual, type_move5_expected>>;
+
+type test_o_win_actual = TicTacToe<type_move5_actual, 'middle-left'>;
+// ^?
+type test_o_win_expected = {
+ board: [
+ [ '⭕', '❌', ' ' ],
+ [ '⭕', '❌', ' ' ],
+ [ '⭕', ' ', '❌' ]
+ ];
+ state: '⭕ Won';
+};
+
+// invalid move don't change the board and state
+type test_invalid_actual = TicTacToe<test_move1_actual, 'top-center'>;
+// ^?
+type test_invalid_expected = {
+ board: [
+ [ ' ', '❌', ' ' ],
+ [ ' ', ' ', ' ' ],
+ [ ' ', ' ', ' ' ]
+ ];
+ state: '⭕';
+};
+type test_invalid = Expect<Equal<test_invalid_actual, test_invalid_expected>>;
+
+type test_before_draw = {
+ board: [
+ ['⭕', '❌', '⭕'],
+ ['⭕', '❌', '❌'],
+ ['❌', '⭕', ' ']];
+ state: '⭕';
+}
+type test_draw_actual = TicTacToe<test_before_draw, 'bottom-right'>;
+// ^?
+type test_draw_expected = {
+ board: [
+ ['⭕', '❌', '⭕'],
+ ['⭕', '❌', '❌'],
+ ['❌', '⭕', '⭕']];
+ state: 'Draw';
+}
+type test_draw = Expect<Equal<test_draw_actual, test_draw_expected>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/21/tsconfig.json b/challenges/aot/2024/21/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/21/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/21/user.ts b/challenges/aot/2024/21/user.ts
new file mode 100644
index 00000000..724211b2
--- /dev/null
+++ b/challenges/aot/2024/21/user.ts
@@ -0,0 +1,23 @@
+// prettier-ignore
+type TicTacToeChip = '❌' | '⭕';
+type TicTacToeEndState = '❌ Won' | '⭕ Won' | 'Draw';
+type TicTacToeState = TicTacToeChip | TicTacToeEndState;
+type TicTacToeEmptyCell = ' ';
+type TicTacToeCell = TicTacToeChip | TicTacToeEmptyCell;
+type TicTacToeYPositions = 'top' | 'middle' | 'bottom';
+type TicTacToeXPositions = 'left' | 'center' | 'right';
+type TicTacToePositions = `${TicTacToeYPositions}-${TicTacToeXPositions}`;
+type TicTactToeBoard = TicTacToeCell[][];
+type TicTacToeGame = {
+ board: TicTactToeBoard;
+ state: TicTacToeState;
+};
+
+type EmptyBoard = [[' ', ' ', ' '], [' ', ' ', ' '], [' ', ' ', ' ']];
+
+type NewGame = {
+ board: EmptyBoard;
+ state: '❌';
+};
+
+type TicTacToe = unknown;
diff --git a/challenges/aot/2024/22/metadata.json b/challenges/aot/2024/22/metadata.json
new file mode 100644
index 00000000..a830ecc4
--- /dev/null
+++ b/challenges/aot/2024/22/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-22",
+ "label": "2024 Day Twenty Two",
+ "description": "2024 Day twenty two of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/22/prompt.md b/challenges/aot/2024/22/prompt.md
new file mode 100644
index 00000000..a290541d
--- /dev/null
+++ b/challenges/aot/2024/22/prompt.md
@@ -0,0 +1,27 @@
+## Reindeer Sudoku
+
+Santa's reindeer sure do like to cause trouble! This time they've decided to make a game out of arranging themselves into a Sudoku board.
+
+Before arranging themselves in this configuration, the reindeer left Santa a foreboding message:
+
+> SaNtA.... yOu MuSt ImPleMeNt ThE `Validate` TyPe To DeTerMinE WhEThEr OuR SuDokU ConFiGuRaTiOn Is vALid
+
+Oh.. and what's that... also Vixen seems to have left a separate note
+
+> _make sure `Validate` is a predicate_
+>
+> - _Vixen_
+
+Well that's sorta condescending. Vixen seems to be assuming we already know that a "predicate" is just a fancy computer science term for a function that returns `true` or `false`. Oh well. That's Vixen for you.
+
+## What is Sudoku
+
+If you're not already familiar: Sudoku is a logic-based number placement puzzle. Here are the basic rules:
+
+- Grid Structure: The game is played on a 9x9 grid, divided into nine 3x3 subgrids or "regions."
+- Number Placement: The objective is to fill the grid with numbers from 1 to 9.
+- Row Constraint: Every row must contain each number from 1 to 9 without repeating.
+- Column Constraint: Every column must also contain each number from 1 to 9 without repeating.
+- Region Constraint: Each of the nine 3x3 regions must contain each number from 1 to 9, again without repetition.
+
+Normally you solve the puzzle by logically deducing the numbers for the empty cells, ensuring that all rows, columns, and 3x3 regions have numbers from 1 to 9 according to the rules. However, in this case the cells are all already filled in and your mission is to instead determine whether the configuration follows the rules of Sudoku.
diff --git a/challenges/aot/2024/22/solutions/1.ts b/challenges/aot/2024/22/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/22/tests.ts b/challenges/aot/2024/22/tests.ts
new file mode 100644
index 00000000..d4925614
--- /dev/null
+++ b/challenges/aot/2024/22/tests.ts
@@ -0,0 +1,85 @@
+import { Equal, Expect } from 'type-testing';
+
+type test_sudoku_1_actual = Validate<[
+// ^?
+ [['💨', '💃', '🦌'], ['☄️', '❤️', '🌩️'], ['🌟', '⚡', '🔴']],
+ [['🌟', '⚡', '🔴'], ['💨', '💃', '🦌'], ['☄️', '❤️', '🌩️']],
+ [['☄️', '❤️', '🌩️'], ['🌟', '⚡', '🔴'], ['💨', '💃', '🦌']],
+ [['🦌', '💨', '💃'], ['⚡', '☄️', '❤️'], ['🔴', '🌩️', '🌟']],
+ [['🌩️', '🔴', '🌟'], ['🦌', '💨', '💃'], ['⚡', '☄️', '❤️']],
+ [['⚡', '☄️', '❤️'], ['🌩️', '🔴', '🌟'], ['🦌', '💨', '💃']],
+ [['💃', '🦌', '💨'], ['❤️', '🌟', '☄️'], ['🌩️', '🔴', '⚡']],
+ [['🔴', '🌩️', '⚡'], ['💃', '🦌', '💨'], ['❤️', '🌟', '☄️']],
+ [['❤️', '🌟', '☄️'], ['🔴', '🌩️', '⚡'], ['💃', '🦌', '💨']]
+]>;
+type test_sudoku_1 = Expect<Equal<test_sudoku_1_actual, true>>;
+
+type test_sudoku_2_actual = Validate<[
+// ^?
+ [['🌩️', '💨', '☄️'], ['🌟', '🦌', '⚡'], ['❤️', '🔴', '💃']],
+ [['🌟', '⚡', '❤️'], ['🔴', '💃', '☄️'], ['🌩️', '💨', '🦌']],
+ [['🔴', '🦌', '💃'], ['💨', '❤️', '🌩️'], ['🌟', '⚡', '☄️']],
+ [['❤️', '☄️', '🌩️'], ['💃', '⚡', '🔴'], ['💨', '🦌', '🌟']],
+ [['🦌', '💃', '⚡'], ['🌩️', '🌟', '💨'], ['🔴', '☄️', '❤️']],
+ [['💨', '🌟', '🔴'], ['🦌', '☄️', '❤️'], ['⚡', '💃', '🌩️']],
+ [['☄️', '🔴', '💨'], ['❤️', '🌩️', '🦌'], ['💃', '🌟', '⚡']],
+ [['💃', '❤️', '🦌'], ['⚡', '🔴', '🌟'], ['☄️', '🌩️', '💨']],
+ [['⚡', '🌩️', '🌟'], ['☄️', '💨', '💃'], ['🦌', '❤️', '🔴']]
+]>;
+type test_sudoku_2 = Expect<Equal<test_sudoku_2_actual, true>>;
+
+type test_sudoku_3_actual = Validate<[
+// ^?
+ [['🦌', '🔴', '💃'], ['🌩️', '☄️', '💨'], ['⚡', '❤️', '🌟']],
+ [['🌟', '⚡', '💨'], ['❤️', '💃', '🔴'], ['☄️', '🌩️', '🦌']],
+ [['☄️', '🌩️', '❤️'], ['⚡', '🌟', '🦌'], ['💃', '🔴', '💨']],
+ [['🌩️', '💃', '🔴'], ['🦌', '💨', '⚡'], ['🌟', '☄️', '❤️']],
+ [['❤️', '☄️', '⚡'], ['💃', '🌩️', '🌟'], ['🦌', '💨', '🔴']],
+ [['💨', '🌟', '🦌'], ['☄️', '🔴', '❤️'], ['🌩️', '💃', '⚡']],
+ [['💃', '💨', '🌟'], ['🔴', '🦌', '☄️'], ['❤️', '⚡', '🌩️']],
+ [['🔴', '❤️', '☄️'], ['🌟', '⚡', '🌩️'], ['💨', '🦌', '💃']],
+ [['⚡', '🦌', '🌩️'], ['💨', '❤️', '💃'], ['🔴', '🌟', '☄️']]
+]>;
+type test_sudoku_3 = Expect<Equal<test_sudoku_3_actual, true>>;
+
+type test_sudoku_4_actual = Validate<[
+// ^?
+ [['💨', '💃', '🦌'], ['☄️', '❤️', '🌩️'], ['🌟', '⚡', '🔴']],
+ [['🌟', '⚡', '🔴'], ['💨', '💃', '🦌'], ['☄️', '❤️', '🌩️']],
+ [['☄️', '❤️', '🌩️'], ['🌟', '⚡', '🔴'], ['💨', '💃', '🦌']],
+ [['🦌', '💨', '💃'], ['⚡', '☄️', '❤️'], ['🔴', '🌩️', '🌟']],
+ [['🌩️', '🔴', '🌟'], ['🦌', '💨', '💃'], ['⚡', '☄️', '❤️']],
+ [['⚡', '☄️', '❤️'], ['🌩️', '🔴', '🌟'], ['🦌', '💨', '💃']],
+ [['💃', '🦌', '💨'], ['❤️', '🌟', '☄️'], ['⚡', '🔴', '🌟']],
+ [['🔴', '🌩️', '⚡'], ['💃', '🦌', '💨'], ['❤️', '🌟', '☄️']],
+ [['❤️', '🌟', '☄️'], ['🔴', '🌩️', '⚡'], ['💃', '🦌', '💨']]
+]>;
+type test_sudoku_4 = Expect<Equal<test_sudoku_4_actual, false>>;
+
+type test_sudoku_5_actual = Validate<[
+// ^?
+ [['🌩️', '💨', '☄️'], ['🌟', '🦌', '⚡'], ['❤️', '🔴', '💃']],
+ [['🌟', '⚡', '❤️'], ['🔴', '💃', '☄️'], ['🌩️', '💨', '🦌']],
+ [['🔴', '🦌', '💃'], ['💨', '❤️', '🌩️'], ['🌟', '⚡', '☄️']],
+ [['❤️', '☄️', '🌩️'], ['💃', '⚡', '🔴'], ['💨', '🦌', '🌟']],
+ [['🦌', '💃', '⚡'], ['🌩️', '🌟', '💨'], ['🔴', '☄️', '❤️']],
+ [['💨', '🌟', '🔴'], ['🦌', '☄️', '❤️'], ['⚡', '💃', '🌩️']],
+ [['☄️', '🔴', '💨'], ['❤️', '💃', '🦌'], ['💃', '🌟', '⚡']],
+ [['💃', '❤️', '🦌'], ['⚡', '🔴', '🌟'], ['☄️', '🌩️', '💨']],
+ [['⚡', '🌩️', '🌟'], ['☄️', '💨', '💃'], ['🦌', '❤️', '🔴']]
+]>;
+type test_sudoku_5 = Expect<Equal<test_sudoku_5_actual, false>>;
+
+type test_sudoku_6_actual = Validate<[
+// ^?
+ [['⚡', '🔴', '🌩️'], ['🦌', '❤️', '💨'], ['💨', '🌟', '☄️']],
+ [['❤️', '🦌', '🌟'], ['💨', '🌟', '🔴'], ['💃', '⚡', '🌩️']],
+ [['💨', '💃', '🌟'], ['☄️', '⚡', '🌩️'], ['🔴', '❤️', '🦌']],
+ [['🦌', '⚡', '🔴'], ['❤️', '💃', '💨'], ['☄️', '🌩️', '🌟']],
+ [['🌟', '🌩️', '💃'], ['⚡', '🔴', '☄️'], ['❤️', '🦌', '💨']],
+ [['☄️', '💨', '❤️'], ['🌟', '🌩️', '🦌'], ['⚡', '💃', '🔴']],
+ [['🌩️', '☄️', '💨'], ['💃', '🦌', '⚡'], ['🌟', '🔴', '❤️']],
+ [['🔴', '❤️', '⚡'], ['🌩️', '☄️', '🌟'], ['🦌', '💨', '💃']],
+ [['💃', '🌟', '🦌'], ['🔴', '💨', '❤️'], ['🌩️', '☄️', '⚡']]
+]>;
+type test_sudoku_6 = Expect<Equal<test_sudoku_6_actual, false>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/22/tsconfig.json b/challenges/aot/2024/22/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/22/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/22/user.ts b/challenges/aot/2024/22/user.ts
new file mode 100644
index 00000000..71106e05
--- /dev/null
+++ b/challenges/aot/2024/22/user.ts
@@ -0,0 +1,30 @@
+/** because "dashing" implies speed */
+type Dasher = '💨';
+
+/** representing dancing or grace */
+type Dancer = '💃';
+
+/** a deer, prancing */
+type Prancer = '🦌';
+
+/** a star for the dazzling, slightly mischievous Vixen */
+type Vixen = '🌟';
+
+/** for the celestial body that shares its name */
+type Comet = '☄️';
+
+/** symbolizing love, as Cupid is the god of love */
+type Cupid = '❤️';
+
+/** representing thunder, as "Donner" means thunder in German */
+type Donner = '🌩️';
+
+/** meaning lightning in German, hence the lightning bolt */
+type Blitzen = '⚡';
+
+/** for his famous red nose */
+type Rudolph = '🔴';
+
+type Reindeer = Dasher | Dancer | Prancer | Vixen | Comet | Cupid | Donner | Blitzen | Rudolph;
+
+type Validate = unknown;
diff --git a/challenges/aot/2024/23/metadata.json b/challenges/aot/2024/23/metadata.json
new file mode 100644
index 00000000..32d7081b
--- /dev/null
+++ b/challenges/aot/2024/23/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-23",
+ "label": "2024 Day Twenty Three",
+ "description": "2024 Day twenty three of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/23/prompt.md b/challenges/aot/2024/23/prompt.md
new file mode 100644
index 00000000..4f6d94ac
--- /dev/null
+++ b/challenges/aot/2024/23/prompt.md
@@ -0,0 +1,15 @@
+## Connect 4, but in TypeScript types
+
+Your goal for this challenge is to implement Connect 4 in TypeScript types.
+
+Each cell in the game can contain `🔴` or `🟡` or be empty (` `). You're provided with a rough layout of how to organize the board in the `EmptyBoard` type. The game state is represented by an object with a `board` property and a `state` property (which keeps track of which player is next up to play).
+
+## What is Connect 4
+
+In case you haven't played it before: Connect 4 is a game in which the players choose a color and then take turns dropping colored tokens into a six-row, seven-column vertically suspended grid. The pieces fall straight down, occupying the lowest available space within the column. The objective of the game is to be the first to form a horizontal, vertical, or diagonal line of four of one's own tokens.
+
+> fun fact:
+> Connect 4 is also known as Connect Four, Four Up, Plot Four, Find Four, Captain's Mistress, Four in a Row, Drop Four, and Gravitrips in the Soviet Union
+
+> another fun fact:
+> Connect 4 was "solved" by James Allen and Victor Allis (independently from one another.. like two weeks apart!) in 1988. They couldn't do a full brute-force proof at the time, but 7 years later John Tromp in the Netherlands did it with a database on a Sun Microsystems and Silicon Graphics International worksations (for a combined total of 40,000 computation hours!).
diff --git a/challenges/aot/2024/23/solutions/1.ts b/challenges/aot/2024/23/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/23/tests.ts b/challenges/aot/2024/23/tests.ts
new file mode 100644
index 00000000..b698e498
--- /dev/null
+++ b/challenges/aot/2024/23/tests.ts
@@ -0,0 +1,211 @@
+import { Expect, Equal } from "type-testing";
+
+type test_move1_actual = Connect4<NewGame, 0>;
+// ^?
+type test_move1_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ];
+ state: "🔴";
+};
+type test_move1 = Expect<Equal<test_move1_actual, test_move1_expected>>;
+
+type test_move2_actual = Connect4<test_move1_actual, 0>;
+// ^?
+type test_move2_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🔴", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ];
+ state: "🟡";
+};
+type test_move2 = Expect<Equal<test_move2_actual, test_move2_expected>>;
+
+type test_move3_actual = Connect4<test_move2_actual, 0>;
+// ^?
+type test_move3_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ["🔴", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ];
+ state: "🔴";
+};
+type test_move3 = Expect<Equal<test_move3_actual, test_move3_expected>>;
+
+type test_move4_actual = Connect4<test_move3_actual, 1>;
+// ^?
+type test_move4_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ["🔴", " ", " ", " ", " ", " ", " "],
+ ["🟡", "🔴", " ", " ", " ", " ", " "],
+ ];
+ state: "🟡";
+};
+type test_move4 = Expect<Equal<test_move4_actual, test_move4_expected>>;
+
+type test_move5_actual = Connect4<test_move4_actual, 2>;
+// ^?
+type test_move5_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ["🔴", " ", " ", " ", " ", " ", " "],
+ ["🟡", "🔴", "🟡", " ", " ", " ", " "],
+ ];
+ state: "🔴";
+};
+type test_move5 = Expect<Equal<test_move5_actual, test_move5_expected>>;
+
+type test_move6_actual = Connect4<test_move5_actual, 1>;
+// ^?
+type test_move6_expected = {
+ board: [
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ [" ", " ", " ", " ", " ", " ", " "],
+ ["🟡", " ", " ", " ", " ", " ", " "],
+ ["🔴", "🔴", " ", " ", " ", " ", " "],
+ ["🟡", "🔴", "🟡", " ", " ", " ", " "],
+ ];
+ state: "🟡";
+};
+type test_move6 = Expect<Equal<test_move6_actual, test_move6_expected>>;
+
+type test_red_win_actual = Connect4<
+ {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', '🔴', '🔴', ' ', ' ', ' ', ' '],
+ ['🟡', '🔴', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🔴';
+ },
+ 3
+>;
+
+type test_red_win_expected = {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', '🔴', '🔴', '🔴', ' ', ' ', ' '],
+ ['🟡', '🔴', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🔴 Won';
+};
+
+type test_red_win = Expect<Equal<test_red_win_actual, test_red_win_expected>>;
+
+type test_yellow_win_actual = Connect4<
+ {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', ' ', '🔴', '🔴', ' ', ' ', ' '],
+ ['🟡', ' ', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🟡';
+ },
+ 1
+>;
+
+type test_yellow_win_expected = {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🟡', ' ', ' ', ' ', ' ', ' ', ' '],
+ ['🔴', ' ', '🔴', '🔴', ' ', ' ', ' '],
+ ['🟡', '🟡', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🟡 Won';
+};
+
+type test_yellow_win = Expect<
+ Equal<test_yellow_win_actual, test_yellow_win_expected>
+>;
+
+type test_diagonal_yellow_win_actual = Connect4<
+ {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', '🟡', '🔴', ' ', ' ', ' '],
+ ['🔴', '🟡', '🔴', '🔴', ' ', ' ', ' '],
+ ['🟡', '🔴', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🟡';
+ },
+ 3
+>;
+
+type test_diagonal_yellow_win_expected = {
+ board: [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', '🟡', ' ', ' ', ' '],
+ [' ', ' ', '🟡', '🔴', ' ', ' ', ' '],
+ ['🔴', '🟡', '🔴', '🔴', ' ', ' ', ' '],
+ ['🟡', '🔴', '🟡', '🟡', ' ', ' ', ' ']
+ ];
+ state: '🟡 Won';
+};
+
+type test_diagonal_yellow_win = Expect<
+ Equal<test_diagonal_yellow_win_actual, test_diagonal_yellow_win_expected>
+>;
+
+type test_draw_actual = Connect4<
+ {
+ board: [
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', ' '],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴'],
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', '🟡'],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴'],
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', '🟡'],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴']
+ ];
+ state: '🟡';
+ },
+ 6
+>;
+
+type test_draw_expected = {
+ board: [
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', '🟡'],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴'],
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', '🟡'],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴'],
+ ['🟡', '🔴', '🔴', '🟡', '🟡', '🔴', '🟡'],
+ ['🔴', '🟡', '🟡', '🔴', '🔴', '🟡', '🔴']
+ ];
+ state: 'Draw';
+};
+
+type test_draw = Expect<Equal<test_draw_actual, test_draw_expected>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/23/tsconfig.json b/challenges/aot/2024/23/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/23/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/23/user.ts b/challenges/aot/2024/23/user.ts
new file mode 100644
index 00000000..b4d34685
--- /dev/null
+++ b/challenges/aot/2024/23/user.ts
@@ -0,0 +1,19 @@
+type Connect4Chips = '🔴' | '🟡';
+type Connect4Cell = Connect4Chips | ' ';
+type Connect4State = '🔴' | '🟡' | '🔴 Won' | '🟡 Won' | 'Draw';
+
+type EmptyBoard = [
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+ [' ', ' ', ' ', ' ', ' ', ' ', ' '],
+];
+
+type NewGame = {
+ board: EmptyBoard;
+ state: '🟡';
+};
+
+type Connect4 = unknown;
diff --git a/challenges/aot/2024/24/metadata.json b/challenges/aot/2024/24/metadata.json
new file mode 100644
index 00000000..c870386d
--- /dev/null
+++ b/challenges/aot/2024/24/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-24",
+ "label": "2024 Day Twenty Four",
+ "description": "2024 Day twenty four of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/24/prompt.md b/challenges/aot/2024/24/prompt.md
new file mode 100644
index 00000000..3e2670c0
--- /dev/null
+++ b/challenges/aot/2024/24/prompt.md
@@ -0,0 +1,17 @@
+## Santa is _stuck_!
+
+Santa is craving cookies! But Alas, he's stuck in a dense North Polar forest.
+
+Implement `Move` so Santa ('🎅') can find his way to the end of the maze.
+
+As a reward, if Santa escapes the maze, fill it with `DELICIOUS_COOKIES` ('🍪').
+
+Santa can only move through alleys (' ') and not through the trees ('🎄').
+
+## Solving the maze
+
+This challenge is going to be a culmination of all the days that came before.
+
+## Thank You!
+
+We just want to say thank you for joining us for the first Advent of TypeScript™! We hope to do many more years in the future! Don't hesitate to leave feedback and tell us what you thought of it!
diff --git a/challenges/aot/2024/24/solutions/1.ts b/challenges/aot/2024/24/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/24/tests.ts b/challenges/aot/2024/24/tests.ts
new file mode 100644
index 00000000..6d9284f7
--- /dev/null
+++ b/challenges/aot/2024/24/tests.ts
@@ -0,0 +1,286 @@
+import { Expect, Equal } from "type-testing";
+
+type Maze0 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎅", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+
+// can't move up!
+type test_maze0_up_actual = Move<Maze0, 'up'>;
+// ^?
+type test_maze0_up = Expect<Equal<test_maze0_up_actual, Maze0>>;
+
+
+// but Santa can move down!
+type test_maze0_down_actual = Move<Maze0, 'down'>;
+// ^?
+type Maze1 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎅", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze0_down = Expect<Equal<test_maze0_down_actual, Maze1>>;
+
+
+// Santa can move down again!
+type test_maze1_down_actual = Move<Maze1, 'down'>;
+type Maze2 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎅", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze1_down = Expect<Equal<test_maze1_down_actual, Maze2>>;
+
+
+// can't move left!
+type test_maze2_left_actual = Move<Maze2, 'left'>;
+// ^?
+type test_maze2_left = Expect<Equal<test_maze2_left_actual, Maze2>>;
+
+
+// if Santa moves up, it's back to Maze1!
+type test_maze2_up_actual = Move<Maze2, 'up'>;
+// ^?
+type test_maze2_up = Expect<Equal<test_maze2_up_actual, Maze1>>;
+
+
+// can't move right!
+type test_maze2_right_actual = Move<Maze2, 'right'>;
+// ^?
+type test_maze2_right = Expect<Equal<test_maze2_right_actual, Maze2>>;
+
+
+// we exhausted all other options! guess we gotta go down!
+type test_maze2_down_actual = Move<Maze2, 'down'>;
+// ^?
+type Maze3 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", "🎅", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze2_down = Expect<Equal<test_maze2_down_actual, Maze3>>;
+
+
+// maybe we just gotta go down all the time?
+type test_maze3_down_actual = Move<Maze3, 'down'>;
+// ^?
+type Maze4 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", "🎅", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze3_down = Expect<Equal<test_maze3_down_actual, Maze4>>;
+
+
+// let's go left this time just to change it up?
+type test_maze4_left_actual = Move<Maze4, 'left'>;
+// ^?
+type Maze5 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", "🎅", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+// it worked!
+type test_maze4_left = Expect<Equal<test_maze4_left_actual, Maze5>>;
+
+
+// couldn't hurt to try left again?
+type test_maze5_left_actual = Move<Maze5, 'left'>;
+// ^?
+type Maze6 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", "🎅", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze5_left = Expect<Equal<test_maze5_left_actual, Maze6>>;
+
+
+// three time's a charm?
+type test_maze6_left_actual = Move<Maze6, 'left'>;
+// ^?
+// lol, nope.
+type test_maze6_left = Expect<Equal<test_maze6_left_actual, Maze6>>;
+
+
+// we haven't tried up yet (?)
+type test_maze6_up_actual = Move<Maze6, 'up'>;
+// ^?
+type Maze7 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", "🎅", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+// NOICE.
+type test_maze6_up = Expect<Equal<test_maze6_up_actual, Maze7>>;
+
+
+// maybe another left??
+type test_maze7_left_actual = Move<Maze7, 'left'>;
+// ^?
+type Maze8 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", "🎅", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze7_left = Expect<Equal<test_maze7_left_actual, Maze8>>;
+
+
+// haven't tried a right yet.. let's give it a go!
+type test_maze7_right_actual = Move<Maze8, 'right'>;
+// ^?
+// not this time...
+type test_maze7_right = Expect<Equal<test_maze7_right_actual, Maze7>>;
+
+
+// probably just need to stick with left then
+type test_maze8_left_actual = Move<Maze8, 'left'>;
+// ^?
+type Maze9 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", "🎅", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze8_left = Expect<Equal<test_maze8_left_actual, Maze9>>;
+
+
+// why fix what's not broken?
+type test_maze9_left_actual = Move<Maze9, 'left'>;
+// ^?
+type Maze10 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", "🎅", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze9_left = Expect<Equal<test_maze9_left_actual, Maze10>>;
+
+
+// do you smell cookies?? it's coming from down..
+type test_maze10_down_actual = Move<Maze10, 'down'>;
+// ^?
+type Maze11 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ [" ", "🎅", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze10_down = Expect<Equal<test_maze10_down_actual, Maze11>>;
+
+
+// the cookies must be freshly baked. I hope there's also the customary glass of milk!
+type test_maze11_left_actual = Move<Maze11, 'left'>;
+// ^?
+type Maze12 = [
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", " ", " ", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", " ", "🎄"],
+ ["🎅", " ", "🎄", "🎄", " ", " ", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", "🎄", "🎄", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", " ", " ", " ", " ", "🎄", " ", "🎄", "🎄", "🎄"],
+ ["🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄", "🎄"],
+];
+type test_maze11_left = Expect<Equal<test_maze11_left_actual, Maze12>>;
+
+
+// COOKIES!!!!!
+type test_maze12_left_actual = Move<Maze12, 'left'>;
+// ^?
+type MazeWin = [
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+ ["🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪", "🍪"],
+];
+type test_maze12_left = Expect<Equal<test_maze12_left_actual, MazeWin>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/24/tsconfig.json b/challenges/aot/2024/24/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/24/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/24/user.ts b/challenges/aot/2024/24/user.ts
new file mode 100644
index 00000000..bf681144
--- /dev/null
+++ b/challenges/aot/2024/24/user.ts
@@ -0,0 +1,6 @@
+type Alley = ' ';
+type MazeItem = '🎄' | '🎅' | Alley;
+type DELICIOUS_COOKIES = '🍪';
+type MazeMatrix = MazeItem[][];
+type Directions = 'up' | 'down' | 'left' | 'right';
+type Move = unknown;
diff --git a/challenges/aot/2024/25/metadata.json b/challenges/aot/2024/25/metadata.json
new file mode 100644
index 00000000..d3e19154
--- /dev/null
+++ b/challenges/aot/2024/25/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-25",
+ "label": "2024 Day Twenty Five",
+ "description": "2024 Day twenty five of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/25/prompt.md b/challenges/aot/2024/25/prompt.md
new file mode 100644
index 00000000..34f65683
--- /dev/null
+++ b/challenges/aot/2024/25/prompt.md
@@ -0,0 +1,15 @@
+## YOU DID IT!
+
+Hey everyone! I just wanted to say thank you for participating in the very first Advent of Typescript. Your interest and enthusiasm meant a lot and made this whole experience awesome. Thanks again for being part of this adventure!
+
+### A HUGE THANKS TO
+
+@dimitropoulos @mattpocock @ecyrbe
+
+Without your expertise and guidance this wouldn't have been possible.
+
+@hacksore @PickleNik @QuiiBz @jhechtf @ggrandi @ayrock-dev @maxdemaio @aadamw @zaCKoZAck0 @odicho @basokant @anthonyshew @is-it-ayush and to the rest of the contributors. I am forever grateful for what we have accomplished together.
+
+Until next year!
+
+Trash
diff --git a/challenges/aot/2024/25/solutions/1.ts b/challenges/aot/2024/25/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/25/tests.ts b/challenges/aot/2024/25/tests.ts
new file mode 100644
index 00000000..2f911fe5
--- /dev/null
+++ b/challenges/aot/2024/25/tests.ts
@@ -0,0 +1,3 @@
+import { Expect, Equal } from 'type-testing';
+
+type ThankYouSoMuch = Expect<Equal<true, true>>;
diff --git a/challenges/aot/2024/25/tsconfig.json b/challenges/aot/2024/25/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/25/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/25/user.ts b/challenges/aot/2024/25/user.ts
new file mode 100644
index 00000000..5018edc4
--- /dev/null
+++ b/challenges/aot/2024/25/user.ts
@@ -0,0 +1 @@
+// submit and claim your badge!
diff --git a/challenges/aot/2024/3/metadata.json b/challenges/aot/2024/3/metadata.json
new file mode 100644
index 00000000..2ad965eb
--- /dev/null
+++ b/challenges/aot/2024/3/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-2",
+ "label": "2024 Day Two",
+ "description": "2024 Day two of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/3/prompt.md b/challenges/aot/2024/3/prompt.md
new file mode 100644
index 00000000..79692b63
--- /dev/null
+++ b/challenges/aot/2024/3/prompt.md
@@ -0,0 +1,11 @@
+## Christmas Cookie Inventory
+
+Phew! Yesterday's tactic worked. Santa got down-and-dirty with the elves on the factory floor and they seem to have stopped planning their strike.
+
+With one small exception.. Unfortunately, two pesky elves (Jingle and Jangle) have realized that the 300 year stock options vesting cliff that Santa put into the elves' contract isn't quite typical. Jingle and Jangle already joined forces with Hermey (who has nothing to lose because he'd rather be a dentist than make toys) and they're beginning to cause a fuss.
+
+Santa noticed that a lot of this discussion is happening during cookie inventory. Help Santa speed up the process so these conversations are cut short.
+
+Take a look at the `cookieInventory` variable in the tests. Your goal is to update `CookieSurveyInput` so that it will return a union of all of the names of the various different cookies.
+
+Good luck! As Santa always says: "your hard work will pay off eventually, just be patient".
diff --git a/challenges/aot/2024/3/solutions/1.ts b/challenges/aot/2024/3/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/3/tests.ts b/challenges/aot/2024/3/tests.ts
new file mode 100644
index 00000000..94e53e75
--- /dev/null
+++ b/challenges/aot/2024/3/tests.ts
@@ -0,0 +1,34 @@
+import { Expect, Equal } from "type-testing";
+
+const cookieInventory = {
+ chocolate: 1,
+ sugar: 20,
+ gingerBread: 10,
+ peanutButter: 30,
+ snickeDoodle: 73,
+}
+type test_cookies_actual = CookieSurveyInput<typeof cookieInventory>;
+// ^?
+type test_cookies_expected = "chocolate" | "sugar" | "gingerBread" | "peanutButter" | "snickeDoodle";
+type test_cookies = Expect<
+ Equal<
+ test_cookies_actual,
+ test_cookies_expected
+ >
+>;
+
+const unrelated = {
+ hi: 1,
+ hi2: 1,
+ hi3: 1,
+ hi4: 1,
+ hi5: 1,
+ hi6: 1,
+ hi7: 1,
+}
+type test_unrelated_actual = CookieSurveyInput<typeof unrelated>;
+// ^?
+type test_unrealted_expected = "hi" | "hi2" | "hi3" | "hi4" | "hi5" | "hi6" | "hi7"
+type test_unrelated = Expect<
+ Equal<test_unrelated_actual, test_unrealted_expected>
+>;
\ No newline at end of file
diff --git a/challenges/aot/2024/3/tsconfig.json b/challenges/aot/2024/3/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/3/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/3/user.ts b/challenges/aot/2024/3/user.ts
new file mode 100644
index 00000000..f7556893
--- /dev/null
+++ b/challenges/aot/2024/3/user.ts
@@ -0,0 +1 @@
+type CookieSurveyInput = unknown;
diff --git a/challenges/aot/2024/4/metadata.json b/challenges/aot/2024/4/metadata.json
new file mode 100644
index 00000000..1cb61d60
--- /dev/null
+++ b/challenges/aot/2024/4/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-4",
+ "label": "2024 Day Four",
+ "description": "2024 Day four of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/4/prompt.md b/challenges/aot/2024/4/prompt.md
new file mode 100644
index 00000000..3994d174
--- /dev/null
+++ b/challenges/aot/2024/4/prompt.md
@@ -0,0 +1,21 @@
+## Christmas Present Delivery Addresses
+
+_\[a conversation in the North Pole kitchenette on the morning of December 4th between Santa and the head elf, Bernard\]_
+
+> _\[Bernard\]_ This is bullshit, Kris. I've been leading the Elves for 200+ years. Don't you trust that I know what I'm talking about?? WE NEED TO GROW THE TEAM. We're running a skeleton-crew here.
+>
+> _\[Santa\]_ Remember, we're like a family here; we all make sacrifices! _We're still a startup!_
+>
+> _\[Bernard\]_ I swear to you. I think if I hear another hussle-culture quip from you.... I think my little elf head will explode.
+>
+> _\[Santa\]_ If you can stick to it now and get us through one more year, there will definitely be rewards down the line.
+>
+> _\[Bernard\]_ I don't know why I even bothered asking...
+
+Clearly, Bernard is a bit disgruntled. Can you blame him? Alas, there's still more work to do. Bernard walks away and mutters to himself:
+
+> _\[Bernard\]_ Guess it's time to drag myself through another pointless TypeScript type challenge with no practical application.
+
+Poor Bernard. Let's help him out.
+
+Today's task is to craft a type (`PresentDeliveryList`) that takes an object type as an input and then replaces the values at each property with an `Address`. We don't know in advance what properties will be provided, which is why it needs to be a generic type. Otherwise Bernard would probably just copy/pasta it to get through the day.
diff --git a/challenges/aot/2024/4/solutions/1.ts b/challenges/aot/2024/4/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/4/tests.ts b/challenges/aot/2024/4/tests.ts
new file mode 100644
index 00000000..a85ed9f6
--- /dev/null
+++ b/challenges/aot/2024/4/tests.ts
@@ -0,0 +1,35 @@
+import { Expect, Equal } from 'type-testing';
+
+type MixedBehaviorList = {
+ john: { behavior: 'good' };
+ jimmy: { behavior: 'bad' };
+ sara: { behavior: 'good' };
+ suzy: { behavior: 'good' };
+ chris: { behavior: 'good' };
+ penny: { behavior: 'bad' };
+};
+type test_MixedBehaviorTest_actual = PresentDeliveryList<MixedBehaviorList>;
+// ^?
+type test_MixedBehaviorTest_expected = {
+ john: Address;
+ jimmy: Address;
+ sara: Address;
+ suzy: Address;
+ chris: Address;
+ penny: Address;
+};
+type test_MixedBehaviorTest = Expect<
+ Equal<test_MixedBehaviorTest_actual, test_MixedBehaviorTest_expected>
+>;
+
+type Unrelated = {
+ hello: { hello: 'hello' };
+ world: { world: 'world' };
+};
+type test_Unrelated_actual = PresentDeliveryList<Unrelated>;
+// ^?
+type test_Unrelated_expected = {
+ hello: Address;
+ world: Address;
+};
+type test_Unrelated = Expect<Equal<test_Unrelated_actual, test_Unrelated_expected>>;
diff --git a/challenges/aot/2024/4/tsconfig.json b/challenges/aot/2024/4/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/4/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/4/user.ts b/challenges/aot/2024/4/user.ts
new file mode 100644
index 00000000..bb959f39
--- /dev/null
+++ b/challenges/aot/2024/4/user.ts
@@ -0,0 +1,2 @@
+type Address = { address: string; city: string };
+type PresentDeliveryList = unknown;
diff --git a/challenges/aot/2024/5/metadata.json b/challenges/aot/2024/5/metadata.json
new file mode 100644
index 00000000..54107a4a
--- /dev/null
+++ b/challenges/aot/2024/5/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-5",
+ "label": "2024 Day Five",
+ "description": "2024 Day five of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/5/prompt.md b/challenges/aot/2024/5/prompt.md
new file mode 100644
index 00000000..452d8f82
--- /dev/null
+++ b/challenges/aot/2024/5/prompt.md
@@ -0,0 +1,29 @@
+## Organize Santa's List
+
+_\[The elves walk into work early on the morning of December 5th. A sign that reads "we're all about passion, not just paychecks" hangs above the entrance to the factory floor.\]_
+
+It's been a tough year for Santa's workshop. The elves are a little behind schedule on getting Santa his list. Santa _reallly really_ likes to see the full list of names far in advance of Christmas Eve when he makes his deliveries.
+
+Normally the elves get lists like this
+
+```ts
+const badList = ['Tommy', 'Trash', 'Queen Blattaria' /* ... many more ... */];
+const goodList = ['Jon', 'David', 'Captain Spectacular' /* ... many more ... */];
+```
+
+And they copy-pasta all the values into a TypeScript type to provide to Santa like this
+
+```ts
+type SantasList = [
+ 'Tommy',
+ 'Trash',
+ 'Queen Blattaria' /* ... many more ... */,
+ 'Jon',
+ 'David',
+ 'Captain Spectacular' /* ... many more ... */,
+];
+```
+
+But there's a problem.. There's one elf on the team, Frymagen, that constantly reminds the others how incredible his Vim skills are. So he has always done it in years past. However this year, Frymagen got one of those MacBook Pros without the escape key and his Vim speed is drastically reduced. We need to find a better way to get Santa his list.
+
+Let's implement `SantasList` such that it can be passed the types for the `badList` and `goodList` and it will return a TypeScript tuple with the values of both lists combined.
diff --git a/challenges/aot/2024/5/solutions/1.ts b/challenges/aot/2024/5/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/5/tests.ts b/challenges/aot/2024/5/tests.ts
new file mode 100644
index 00000000..ab4908d6
--- /dev/null
+++ b/challenges/aot/2024/5/tests.ts
@@ -0,0 +1,32 @@
+import { Expect, Equal } from 'type-testing';
+
+const bads = ['tommy', 'trash'] as const;
+const goods = ['bash', 'tru'] as const;
+
+type test_0_actual = SantasList<typeof bads, typeof goods>;
+// ^?
+type test_0_expected = ['tommy', 'trash', 'bash', 'tru'];
+type test_0 = Expect<Equal<test_0_actual, test_0_expected>>;
+
+type test_1_actual = SantasList<[], []>;
+// ^?
+type test_1_expected = [];
+type test_1 = Expect<Equal<test_1_actual, test_1_expected>>;
+
+type test_2_actual = SantasList<[], ['trash']>;
+// ^?
+type test_2_expected = ['trash'];
+type test_2 = Expect<Equal<test_2_actual, test_2_expected>>;
+
+type test_3_actual = SantasList<['john'], ['ashley', 'elliot', 'ziltoid']>;
+// ^?
+type test_3_expected = ['john', 'ashley', 'elliot', 'ziltoid'];
+type test_3 = Expect<Equal<test_3_actual, test_3_expected>>;
+
+type test_4_actual = SantasList<['1', 2, '3'], [false, boolean, '4', ['nested']]>;
+// ^?
+type test_4_expected = ['1', 2, '3', false, boolean, '4', ['nested']];
+type test_4 = Expect<Equal<test_4_actual, test_4_expected>>;
+
+// @ts-expect-error
+type error_0 = SantasList<null, undefined>;
diff --git a/challenges/aot/2024/5/tsconfig.json b/challenges/aot/2024/5/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/5/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/5/user.ts b/challenges/aot/2024/5/user.ts
new file mode 100644
index 00000000..d8f0a7c8
--- /dev/null
+++ b/challenges/aot/2024/5/user.ts
@@ -0,0 +1 @@
+type SantasList = unknown;
diff --git a/challenges/aot/2024/6/metadata.json b/challenges/aot/2024/6/metadata.json
new file mode 100644
index 00000000..e8f5e9d1
--- /dev/null
+++ b/challenges/aot/2024/6/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-6",
+ "label": "2024 Day Six",
+ "description": "2024 Day six of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/6/prompt.md b/challenges/aot/2024/6/prompt.md
new file mode 100644
index 00000000..93d8215f
--- /dev/null
+++ b/challenges/aot/2024/6/prompt.md
@@ -0,0 +1,28 @@
+## Filtering The Children (part 1)
+
+As you may be aware, kids that are naughty get a lump of coal and kids that are nice get a toy. Santa's sorta controlling, honestly, and he likes being able to manipulate the data by filtering out the naughty kids on some days, and filtering out the nice kids on other days.
+
+So, Santa walks over to the (open floorplan) office where the engineering team sits. Although he's just addressing the engineers, the rest of the office is distracted because they can clearly hear him since there are no walls.
+
+> _\[Santa\]_ You know, this job is a great opportunity for you elves, even without high pay! You're gaining valuable experience, which is more important than money!
+>
+> _\[elves\]_ _grumble grumble_ ok. cool. do you need something?
+>
+> _\[Santa\]_ YES! So glad you asked! I'd like an idea of how many kids have been nice. I want to be able to filter out all the naughty kids sometimes, and filter out the nice kids other times.
+>
+> _\[elf manager\]_ ok. that's fine. we'll add a ticket for the next sprint..
+>
+> _\[Santa\]_ Oh! No time for story points and JIRA tickets, I'm afraid! I need this done _pronto!_
+>
+> _\[elf manager\]_ we use Linear, but ok sure. we'll drop everything we're doing.
+
+## Can you help?
+
+You're an engineer too. Can you help the elf team?
+
+The first parameter of `FilterChildrenBy` is just a union of all the children's naughty/nice status. The second parameter is the thing we want to exclude from the final resulting type.
+
+Take a look at the tests. There, you'll see some examples.
+
+> Note:
+> _the engineering team manager triple checked with Santa because this seems like a strange way to keep track of naughty and nice children, but Santa ensured the manager that this is exactly what he wants._
diff --git a/challenges/aot/2024/6/solutions/1.ts b/challenges/aot/2024/6/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/6/tests.ts b/challenges/aot/2024/6/tests.ts
new file mode 100644
index 00000000..7af1ca1f
--- /dev/null
+++ b/challenges/aot/2024/6/tests.ts
@@ -0,0 +1,25 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = FilterChildrenBy<
+ // ^?
+ 'nice' | 'nice' | 'nice',
+ 'naughty'
+>;
+type test_0_expected = 'nice';
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = FilterChildrenBy<
+ // ^?
+ 'nice' | 'naughty' | 'naughty',
+ 'naughty'
+>;
+type test_1_expected = 'nice';
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = FilterChildrenBy<
+ // ^?
+ string | number | (() => void),
+ Function
+>;
+type test_2_expected = string | number;
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
diff --git a/challenges/aot/2024/6/tsconfig.json b/challenges/aot/2024/6/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/6/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/6/user.ts b/challenges/aot/2024/6/user.ts
new file mode 100644
index 00000000..222059f5
--- /dev/null
+++ b/challenges/aot/2024/6/user.ts
@@ -0,0 +1 @@
+type FilterChildrenBy = unknown;
diff --git a/challenges/aot/2024/7/metadata.json b/challenges/aot/2024/7/metadata.json
new file mode 100644
index 00000000..c1269b02
--- /dev/null
+++ b/challenges/aot/2024/7/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-7",
+ "label": "2024 Day Seven",
+ "description": "2024 Day seven of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/7/prompt.md b/challenges/aot/2024/7/prompt.md
new file mode 100644
index 00000000..84f39649
--- /dev/null
+++ b/challenges/aot/2024/7/prompt.md
@@ -0,0 +1,25 @@
+## Filtering The Children (part 2)
+
+_\[transcript of a slack conversation at 11:23pm between Santa and Chipper (one of the elves that worked on the filtering code from yesterday)\]_
+
+> _\[Santa\]_ We've got a big problem. That code that you gave me yesterday doesn't work!
+>
+> _\[Chipper\]_ what doesn't work about it?
+>
+> _\[Santa\]_ It turns out I need the data formatted in a completely different way! The inputs and outputs all need to be different.
+>
+> _\[Chipper\]_ ok, so it sounds like the requirements have changed. did you ask my manager? it's late and I'm relaxing. I'm in the middle of a game of League of Legends.
+>
+> _\[Santa\]_ Is that like RuneScape? Well anyway, would you mind helping me out in a pinch? Think of this as paying your dues for a better position later!
+>
+> _\[Chipper\]_ ok. I guess.
+>
+> _\[Santa\]_ Wonderful! Here are the inputs and outputs! That oughta be plenty for you! Ok, I gotta get some rest for a golf game I'm having tomorrow. Signing off!
+
+## Developing From The Tests
+
+As you can see, sometimes leadership like Santa manage to convince themselves they have fantastic product vision, you'll get little more than basic inputs and outputs, and you'll have to figure out the behavior from there. Don't be flustered. Take a look at the tests and try to figure out what the behavior is supposed to be.
+
+Start by identifying the inputs for our `AppendGood` type. Ask yourself if there should be any generic type constraints on the inputs (there may not need to be, or at least right away).
+
+Then try to set up a scaffold that will at least return the same values for each property. Your next step is to transform the properties somehow..
diff --git a/challenges/aot/2024/7/solutions/1.ts b/challenges/aot/2024/7/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/7/tests.ts b/challenges/aot/2024/7/tests.ts
new file mode 100644
index 00000000..f15a1867
--- /dev/null
+++ b/challenges/aot/2024/7/tests.ts
@@ -0,0 +1,29 @@
+import { Expect, Equal } from 'type-testing';
+
+type WellBehavedList = {
+ tom: { address: '1 candy cane lane' };
+ timmy: { address: '43 chocolate dr' };
+ trash: { address: '637 starlight way' };
+ candace: { address: '12 aurora' };
+};
+type test_wellBehaved_actual = AppendGood<WellBehavedList>;
+// ^?
+type test_wellBehaved_expected = {
+ good_tom: { address: '1 candy cane lane' };
+ good_timmy: { address: '43 chocolate dr' };
+ good_trash: { address: '637 starlight way' };
+ good_candace: { address: '12 aurora' };
+};
+type test_wellBehaved = Expect<Equal<test_wellBehaved_expected, test_wellBehaved_actual>>;
+
+type Unrelated = {
+ dont: 'cheat';
+ play: 'fair';
+};
+type test_Unrelated_actual = AppendGood<Unrelated>;
+// ^?
+type test_Unrelated_expected = {
+ good_dont: 'cheat';
+ good_play: 'fair';
+};
+type test_Unrelated = Expect<Equal<test_Unrelated_expected, test_Unrelated_actual>>;
diff --git a/challenges/aot/2024/7/tsconfig.json b/challenges/aot/2024/7/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/7/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/7/user.ts b/challenges/aot/2024/7/user.ts
new file mode 100644
index 00000000..ee19a61a
--- /dev/null
+++ b/challenges/aot/2024/7/user.ts
@@ -0,0 +1 @@
+type AppendGood = unknown;
diff --git a/challenges/aot/2024/8/metadata.json b/challenges/aot/2024/8/metadata.json
new file mode 100644
index 00000000..2723671b
--- /dev/null
+++ b/challenges/aot/2024/8/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-8",
+ "label": "2024 Day Eight",
+ "description": "2024 Day eight of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/8/prompt.md b/challenges/aot/2024/8/prompt.md
new file mode 100644
index 00000000..5c4f4cb4
--- /dev/null
+++ b/challenges/aot/2024/8/prompt.md
@@ -0,0 +1,31 @@
+## Filtering The Children (part 3)
+
+Yet again, Santa has made a request to change the children filtering code. This time he just sent an email to the entire engineering team (which is absolutely _not_ the process, but since Santa is sometimes a bit difficult to communicate with, no one has yet had the courage to tell him). Here's the contents of the email.
+
+```http
+POST /sendmail HTTP/1.1
+Host: mail.hohoholdings.com
+Content-Type: text/plain; charset=utf-8
+Content-Length: 420
+
+Subject: Code Changes Needed
+
+Hello beloved team!
+
+Looks like we need some changes to the code again!
+
+1. there are sometimes naughty kids in the same list
+1. turns out I don't actually need to see the nice children in the list, after all
+1. my golf game ran late this morning.. so since the other two changes were quick to implement, I'm sure this will be just as fast, right?!
+
+- Kris Kringle
+ "at Santa's workshop, we value loyalty over all else"
+```
+
+Wow. What a pointless email. For once, calling a meeting would have been better.
+
+Good thing we got some experience reading the tests because this email may as well have said "do work. thanks." (lol).
+
+Off to the tests to see how this is actually supposed to work!
diff --git a/challenges/aot/2024/8/solutions/1.ts b/challenges/aot/2024/8/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/8/tests.ts b/challenges/aot/2024/8/tests.ts
new file mode 100644
index 00000000..978f1f71
--- /dev/null
+++ b/challenges/aot/2024/8/tests.ts
@@ -0,0 +1,25 @@
+import { Expect, Equal } from 'type-testing';
+
+type SantasList = {
+ naughty_tom: { address: '1 candy cane lane' };
+ good_timmy: { address: '43 chocolate dr' };
+ naughty_trash: { address: '637 starlight way' };
+ naughty_candace: { address: '12 aurora' };
+};
+type test_wellBehaved_actual = RemoveNaughtyChildren<SantasList>;
+// ^?
+type test_wellBehaved_expected = {
+ good_timmy: { address: '43 chocolate dr' };
+};
+type test_wellBehaved = Expect<Equal<test_wellBehaved_expected, test_wellBehaved_actual>>;
+
+type Unrelated = {
+ dont: 'cheat';
+ naughty_play: 'fair';
+};
+type test_Unrelated_actual = RemoveNaughtyChildren<Unrelated>;
+// ^?
+type test_Unrelated_expected = {
+ dont: 'cheat';
+};
+type test_Unrelated = Expect<Equal<test_Unrelated_expected, test_Unrelated_actual>>;
diff --git a/challenges/aot/2024/8/tsconfig.json b/challenges/aot/2024/8/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/8/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/8/user.ts b/challenges/aot/2024/8/user.ts
new file mode 100644
index 00000000..501134c5
--- /dev/null
+++ b/challenges/aot/2024/8/user.ts
@@ -0,0 +1 @@
+type RemoveNaughtyChildren = unknown;
diff --git a/challenges/aot/2024/9/metadata.json b/challenges/aot/2024/9/metadata.json
new file mode 100644
index 00000000..dae03f73
--- /dev/null
+++ b/challenges/aot/2024/9/metadata.json
@@ -0,0 +1,8 @@
+{
+ "id": "2024-9",
+ "label": "2024 Day Nine",
+ "description": "2024 Day nine of Advent of Typescript",
+ "difficulty": "event",
+ "prerequisites": [],
+ "author": "TypeHero"
+}
diff --git a/challenges/aot/2024/9/prompt.md b/challenges/aot/2024/9/prompt.md
new file mode 100644
index 00000000..db42c6ef
--- /dev/null
+++ b/challenges/aot/2024/9/prompt.md
@@ -0,0 +1,19 @@
+## Is Santa Dyslexic?
+
+_\[it's early Saturday morning and the team has been working overtime. Santa storms into the factory floor shouting..\]_
+
+> _\[Santa\]_ Don't you elves take any pride in your work?!?! Others would love to have your job for much less pay! I asked for a simple type that will reverse strings!! How hard is that?!? What do we even pay you for??
+
+_\[unfortunately, Santa is conveniently forgetting that the `Reverse` type was cut from the sprint (which... of course... he agreed to)\]_
+
+> _\[floor manager\]_ Ok. We never got acceptance criteria for that ticket.
+>
+> _\[Santa\]_ How difficult is it to understand what Reverse does!? `'rehsaD'` should be transformed into `'Dasher'`, `'recnaD'` should be transformed into `'Dancer'`, `'recnarP'` should be transformed into `'Prancer'`.. DO I NEED TO KEEP GOING?
+>
+> _\[floor manager\]_ Well you might be surprised. For example, what should happen to multi-codepoint unicode characters?
+>
+> _\[Santa\]_ What are you on about with all that accessibility stuff again!
+>
+> _\[floor manager\]_ Accessibility is important, sir.
+>
+> _\[Santa\]_ Look, this is just an MVP. We can add accessibility later. Just get me my `Reverse` type! I'm having a hard time reading this stuff otherwise!
diff --git a/challenges/aot/2024/9/solutions/1.ts b/challenges/aot/2024/9/solutions/1.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/challenges/aot/2024/9/tests.ts b/challenges/aot/2024/9/tests.ts
new file mode 100644
index 00000000..e69f8b18
--- /dev/null
+++ b/challenges/aot/2024/9/tests.ts
@@ -0,0 +1,46 @@
+import { Expect, Equal } from 'type-testing';
+
+type test_0_actual = Reverse<'rehsaD'>;
+// ^?
+type test_0_expected = 'Dasher';
+type test_0 = Expect<Equal<test_0_expected, test_0_actual>>;
+
+type test_1_actual = Reverse<'recnaD'>;
+// ^?
+type test_1_expected = 'Dancer';
+type test_1 = Expect<Equal<test_1_expected, test_1_actual>>;
+
+type test_2_actual = Reverse<'recnarP'>;
+// ^?
+type test_2_expected = 'Prancer';
+type test_2 = Expect<Equal<test_2_expected, test_2_actual>>;
+
+type test_3_actual = Reverse<'nexiV'>;
+// ^?
+type test_3_expected = 'Vixen';
+type test_3 = Expect<Equal<test_3_expected, test_3_actual>>;
+
+type test_4_actual = Reverse<'temoC'>;
+// ^?
+type test_4_expected = 'Comet';
+type test_4 = Expect<Equal<test_4_expected, test_4_actual>>;
+
+type test_5_actual = Reverse<'dipuC'>;
+// ^?
+type test_5_expected = 'Cupid';
+type test_5 = Expect<Equal<test_5_expected, test_5_actual>>;
+
+type test_6_actual = Reverse<'rennoD'>;
+// ^?
+type test_6_expected = 'Donner';
+type test_6 = Expect<Equal<test_6_expected, test_6_actual>>;
+
+type test_7_actual = Reverse<'neztilB'>;
+// ^?
+type test_7_expected = 'Blitzen';
+type test_7 = Expect<Equal<test_7_expected, test_7_actual>>;
+
+type test_8_actual = Reverse<'hploduR'>;
+// ^?
+type test_8_expected = 'Rudolph';
+type test_8 = Expect<Equal<test_8_expected, test_8_actual>>;
\ No newline at end of file
diff --git a/challenges/aot/2024/9/tsconfig.json b/challenges/aot/2024/9/tsconfig.json
new file mode 100644
index 00000000..d8de5a26
--- /dev/null
+++ b/challenges/aot/2024/9/tsconfig.json
@@ -0,0 +1,7 @@
+{
+ "compilerOptions": {
+ "strict": true,
+ "exactOptionalPropertyTypes": true,
+ "noUncheckedIndexedAccess": true
+ }
+}
diff --git a/challenges/aot/2024/9/user.ts b/challenges/aot/2024/9/user.ts
new file mode 100644
index 00000000..f584f7ce
--- /dev/null
+++ b/challenges/aot/2024/9/user.ts
@@ -0,0 +1 @@
+type Reverse = unknown;
diff --git a/packages/db/seed/prod.ts b/packages/db/seed/prod.ts
index e376076d..da696581 100644
--- a/packages/db/seed/prod.ts
+++ b/packages/db/seed/prod.ts
@@ -78,31 +78,31 @@ try {
where: {
slug: {
in: [
- 'day-1',
- 'day-2',
- 'day-3',
- 'day-4',
- 'day-5',
- 'day-6',
- 'day-7',
- 'day-8',
- 'day-9',
- 'day-10',
- 'day-11',
- 'day-12',
- 'day-13',
- 'day-14',
- 'day-15',
- 'day-16',
- 'day-17',
- 'day-18',
- 'day-19',
- 'day-20',
- 'day-21',
- 'day-22',
- 'day-23',
- 'day-24',
- 'day-25',
+ '2023-1',
+ '2023-2',
+ '2023-3',
+ '2023-4',
+ '2023-5',
+ '2023-6',
+ '2023-7',
+ '2023-8',
+ '2023-9',
+ '2023-10',
+ '2023-11',
+ '2023-12',
+ '2023-13',
+ '2023-14',
+ '2023-15',
+ '2023-16',
+ '2023-17',
+ '2023-18',
+ '2023-19',
+ '2023-20',
+ '2023-21',
+ '2023-22',
+ '2023-23',
+ '2023-24',
+ '2023-25',
],
},
},