{"id":23112542,"url":"https://github.com/techsupportz/adventofcode-2024","last_synced_at":"2025-04-03T23:45:39.581Z","repository":{"id":265865375,"uuid":"896742371","full_name":"TechSupportz/adventofcode-2024","owner":"TechSupportz","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-07T06:57:50.000Z","size":82,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-09T11:41:52.033Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TechSupportz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-01T07:17:09.000Z","updated_at":"2024-12-07T06:57:53.000Z","dependencies_parsed_at":"2025-01-07T12:16:54.795Z","dependency_job_id":null,"html_url":"https://github.com/TechSupportz/adventofcode-2024","commit_stats":null,"previous_names":["techsupportz/adventofcode-2024"],"tags_count":0,"template":false,"template_full_name":"edge33/AdventOfCode-typescript-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechSupportz%2Fadventofcode-2024","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechSupportz%2Fadventofcode-2024/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechSupportz%2Fadventofcode-2024/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechSupportz%2Fadventofcode-2024/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TechSupportz","download_url":"https://codeload.github.com/TechSupportz/adventofcode-2024/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247097975,"owners_count":20883127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-17T02:18:24.692Z","updated_at":"2025-04-03T23:45:39.553Z","avatar_url":"https://github.com/TechSupportz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎄 AdventOfCode-typescript-template 🎄\n\nThis is a TypeScript boilerplate for Advent of Code.\n\nbuilt with ❤️ and:\n\n- [typescript](https://www.typescriptlang.org/) 👨‍💻\n- [vitest](https://vitest.dev/) 🧪\n- [bun](https://bun.sh/) 🧅\n\n## 👷‍♂️ Project structure\n\nthe project has the following structure:\n\n```\nsrc\n- days: contains the solutions for the puzzles\n- scripts: utility scripts for development lifecycle\n- types: types and interfaces\n- utils: utility scripts used for development and problem solving (i.e read an input file)\n```\n\n## 🚀 Getting started\n\nThis readme assumes you are using [pnpm](https://pnpm.io/) as package manager, but any other package manager will do.\n\nThe runtime used for this project is bun [bun](https://bun.sh/), check the docs for installing it.\n\ninstall all required dependencies with `pnpm i`\n\n## 🎄 Adding a new puzzle\n\nwhen the new AoC puzzle is available run `pnpm init-day {day}`\n\nreplace `{day}` with the number of the advent day, i.e. `pnpm init-day 2`.\n\nThis command will create a new directory in the `days` folder with the following content\n\n- `Puzzle.ts`: the boilerplate module with the placeholder methods for solving both daily puzzles\n- `index.txt`: the input file where to add the puzzle input\n\nThe structure of the boilerplate module is the following:\n\n```typescript\nconst first = (input: string) =\u003e {\n  console.log(input);\n  return 'solution 1';\n};\n\nconst expectedFirstSolution = 'solution 1';\n\nconst second = (input: string) =\u003e {\n  console.log(input);\n  return 'solution 2';\n};\n\nconst expectedSecondSolution = 'solution 2';\n\nexport { first, expectedFirstSolution, second, expectedSecondSolution };\n```\n\n## 🔧 Development\n\nWhen your solution is ready, or when you want to start developing incrementally (watch mode) run `pnpm dev {day}` where {day} is the day you are working on, i.e. `pnpm dev 1` will run the puzzle class for day 1.\n\n## 🧪 Testing\n\nYou can run test for all puzzles agains their expected output with `pnpm t` this will test all the solutions in the `days` folder\n\n## 🛫 Contributing\n\nEvery contribution is welcome. Just fork this repo and open a MR with your changes, and don't forget to add your name to the contributors section of this README.\n\n## 👨👩 Contributors\n\n[Francesco Maida](https://edge33.github.io)\n\n[Devin Spikowski](https://github.com/vegeta897)\n\n[Nitish Thiyagarajan](https://www.tnitish.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechsupportz%2Fadventofcode-2024","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechsupportz%2Fadventofcode-2024","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechsupportz%2Fadventofcode-2024/lists"}