From db3930c360cf6fde000959a9712dd7f4fd7428d2 Mon Sep 17 00:00:00 2001
From: Alexandr Garbuzov <qwerty541zxc@gmail.com>
Date: Thu, 10 Aug 2023 09:41:35 +0300
Subject: [PATCH] Refactor: Top langs card: Use typedef tags inside data
 fetcher (#3061)

---
 src/fetchers/top-languages-fetcher.js | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/fetchers/top-languages-fetcher.js b/src/fetchers/top-languages-fetcher.js
index b57d901afb0a77..1f386c1df682a8 100644
--- a/src/fetchers/top-languages-fetcher.js
+++ b/src/fetchers/top-languages-fetcher.js
@@ -8,12 +8,17 @@ import {
   wrapTextMultiline,
 } from "../common/utils.js";
 
+/**
+ * @typedef {import("axios").AxiosRequestHeaders} AxiosRequestHeaders Axios request headers.
+ * @typedef {import("axios").AxiosResponse} AxiosResponse Axios response.
+ */
+
 /**
  * Top languages fetcher object.
  *
- * @param {import('axios').AxiosRequestHeaders} variables Fetcher variables.
+ * @param {AxiosRequestHeaders} variables Fetcher variables.
  * @param {string} token GitHub token.
- * @returns {Promise<import('../common/types').StatsFetcherResponse>} Languages fetcher response.
+ * @returns {Promise<AxiosResponse>} Languages fetcher response.
  */
 const fetcher = (variables, token) => {
   return request(
@@ -47,12 +52,18 @@ const fetcher = (variables, token) => {
   );
 };
 
+/**
+ * @typedef {import("./types").TopLangData} TopLangData Top languages data.
+ */
+
 /**
  * Fetch top languages for a given username.
  *
  * @param {string} username GitHub username.
  * @param {string[]} exclude_repo List of repositories to exclude.
- * @returns {Promise<import("./types").TopLangData>} Top languages data.
+ * @param {number} size_weight Weightage to be given to size.
+ * @param {number} count_weight Weightage to be given to count.
+ * @returns {Promise<TopLangData>} Top languages data.
  */
 const fetchTopLanguages = async (
   username,