v1.5.0: Complete documentation rewrite - 50+ files with AlisaReactionBot style

- Box-style header comments (Project, Author, License) on every file
- Section headers using double-line box decorators
- Feature markers (// ---- FEATURE: XYZ ----) before every major function
- JSDoc comments for EVERY function with @param, @returns, @example
- Inline notes (NOTE, WARNING, TIP) for non-obvious logic
- Footer END markers on every module
- Matched code style to AlisaReactionBot repository
- All files now searchable by feature name via grep

Author: Shinei Nouzen <157171073+Shineii86@users.noreply.github.com>

src/extractors/schedule.extractor.js

@@ -1,21 +1,63 @@
+/*
+ * ======= • ======= • ======= • ======= • =======• =======
+ * AniKatoAPI — schedule.extractor.js
+ * Repository: https://github.com/Shineii86/AniKatoAPI
+ *
+ * @description
+ *   Extracts anime schedule for a specific date.
+ *   Returns airing times and episode numbers for scheduled anime.
+ *
+ * @exports
+ *   extractSchedule
+ *
+ * @author  Shinei Nouzen
+ * @license MIT
+ * ======= • ======= • ======= • ======= • =======• =======
+ */
+
 import * as cheerio from "cheerio";
 import axios from "axios";
 import { headers } from "../configs/header.config.js";
 import { URLS } from "../configs/dataUrl.js";
 
+// ══════════════════════════════════════════════════════════════
+// SCHEDULE EXTRACTION
+// ══════════════════════════════════════════════════════════════
+
+// ---- FEATURE: Extract anime schedule for a specific date ----
+/**
+ * Fetches and parses the anime schedule for a given date.
+ * Returns airing times and episode numbers for scheduled anime.
+ *
+ * @param {string} date - Date to fetch schedule for (format: YYYY-MM-DD)
+ * @returns {Promise<Array<Object>>} Array of scheduled anime objects
+ * @returns {string} return.slug - URL slug for the anime
+ * @returns {string} return.title - Anime title
+ * @returns {string} return.time - Airing time
+ * @returns {number} return.episode_no - Episode number
+ *
+ * @example
+ *   const schedule = await extractSchedule("2024-01-15");
+ *   console.log(schedule[0].time); // Airing time
+ *   console.log(schedule[0].episode_no); // Episode number
+ */
 const extractSchedule = async (date) => {
   try {
+    // NOTE: The schedule is fetched by appending date parameter to homepage
     const url = `${URLS.home}?date=${date}`;
     const { data } = await axios.get(url, { headers });
     const $ = cheerio.load(data);
 
     const schedule = [];
+
+    // NOTE: Schedule items use different selectors depending on page structure
     $(".schedule-item, .anime-schedule .item").each((i, el) => {
       const slug = $(el).find("a").attr("href")?.split("/watch/").pop() || "";
       const title = $(el).find(".film-name a, .name").text().trim() || "";
       const time = $(el).find(".time, .schedule-time").text().trim() || "";
       const episodeNo = parseInt($(el).find(".episode-no, .ep-num").text().trim()) || 0;
 
+      // NOTE: Only include items with valid slugs
       if (slug) {
         schedule.push({
           slug,
@@ -32,4 +74,6 @@ const extractSchedule = async (date) => {
   }
 };
 
-export { extractSchedule };
+export { extractSchedule };
+
+// ══════════════════════════════════════════════════════════════ END: schedule.extractor.js