refactor: rename /src/utils to /src/aoc --

set of aoc related libs and helper functions, #44

Author: weaponsforge

README.md

@@ -48,7 +48,7 @@ It follows the directory structure:
 > [!NOTE]
 > 📂 dist<br>
 > 📂 src<br>
-> └─ 📂 utils<br>
+> └─ 📂 aoc<br>
 > └─ 📂 sample<br>
 > └─ 📂 2024<br>
 > └─── 📂 2024-12-01<br>
@@ -77,7 +77,7 @@ Each Advent of Code (AOC) event quiz has its folder under **`"/src/<YEAR>/<YYYY-
 
 #### Other Items
 
-- **/src/utils**: Folder containing generic utility helper functions
+- **/src/aoc**: Folder containing generic utility and common AoC helper functions
 - **/src/dist**: Folder containing the JavaScript files compiled from TypeScript (not committed to the repository)
 - **/src/sample**: Miscellaneous random examples
 - **/src/index.ts**: Exports all solutions to AOC quiz answer functions

src/2024/2024-12-01/lib/fileReader.ts

@@ -1,5 +1,5 @@
 import path from 'path'
-import { readFile, directory } from '@/utils/file.js'
+import { readFile, directory } from '@/aoc/file.js'
 
 export type arrayLists = {
   list1: string[];

src/2024/2024-12-01/lib/listTotalDistance.ts

@@ -1,4 +1,4 @@
-import { arrangeArray, ARRAY_ORDERING } from '@/utils/arrays.js'
+import { arrangeArray, ARRAY_ORDERING } from '@/aoc/arrays.js'
 
 /**
  * Calculates the total distance between the smallest value-pairs from list `a` and list `b`

src/2024/2024-12-02/lib/fileReader.ts

@@ -1,5 +1,5 @@
 import path from 'path'
-import { readFile, directory } from '@/utils/file.js'
+import { readFile, directory } from '@/aoc/file.js'
 
 /**
  * Reads the quiz's input file into two (2) string arrays

src/2024/2024-12-03/main.ts

@@ -1,5 +1,5 @@
 import path from 'path'
-import { directory, readFile } from '@/utils/file.js'
+import { directory, readFile } from '@/aoc/file.js'
 import { extractMultiply, extractMultiplyCondition } from './lib/extractMultiply.js'
 
 const dir = directory(import.meta.url)

src/2024/2024-12-04/main.ts

@@ -1,5 +1,5 @@
 import path from 'path'
-import { directory, readFile } from '@/utils/file.js'
+import { directory, readFile } from '@/aoc/file.js'
 import { wordCount } from './lib/wordCount.js'
 import { countMASword } from './lib/xmasCount.js'
 

src/2024/2024-12-05/lib/fileReader.ts

@@ -1,6 +1,6 @@
 import path from 'path'
-import { directory, readFile } from '@/utils/file.js'
-import { uniformArrayElements } from '@/utils/arrays.js'
+import { directory, readFile } from '@/aoc/file.js'
+import { uniformArrayElements } from '@/aoc/arrays.js'
 
 export type Rules = Record<number, number[]>
 

src/2024/2024-12-05/lib/fixOrderingUpdates.ts

@@ -1,5 +1,5 @@
 import { isOrderedReport } from './orderedUpdates.js'
-import { arrayMiddleIndex, uniformArrayElements } from '@/utils/arrays.js'
+import { arrayMiddleIndex, uniformArrayElements } from '@/aoc/arrays.js'
 
 import type { Rules } from './fileReader.js'
 import type { QuizData } from './fileReader.js'

src/2024/2024-12-05/lib/orderedUpdates.ts

@@ -1,5 +1,5 @@
 import type { QuizData, Rules } from './fileReader.js'
-import { uniformArrayElements, arrayMiddleIndex } from '@/utils/arrays.js'
+import { uniformArrayElements, arrayMiddleIndex } from '@/aoc/arrays.js'
 
 /**
  * Checks if an "update" list is correct according to defined "rules"

src/2024/2024-12-06/main.ts

@@ -1,6 +1,6 @@
 import path from 'path'
-import { readAOCInputFile, AOC_OUTPUT_TYPE } from '@/utils/aocInputFile.js'
-import { directory } from '@/utils/file.js'
+import { readAOCInputFile, AOC_OUTPUT_TYPE } from '@/aoc/aocInputFile.js'
+import { directory } from '@/aoc/file.js'
 
 import { guardController } from './lib/guardController.js'
 import { findObstructionPositions } from './lib/guardControllerLoop.js'