@stats-forge/github-stats-forge-core 0.0.2 → 0.1.0

package/build/cards/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cards/stats.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASnE,qFAAqF;AACrF,QAAA,MAAM,UAAU,8CAA+C,CAAC;AAChE,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AAiLD;;;;;;;;;GASG;AACH,QAAA,MAAM,eAAe,GACnB,OAAO,SAAS,EAChB,UAAS,WAAW,CAAC,eAAe,CAAM,EAC1C,WAAW,MAAM,EACjB,OAAM,KAAK,CAAC,MAAM,CAAM,EACxB,QAAO,KAAK,CAAC,MAAM,CAAM,KACxB,MAyXF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cards/stats.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAqBnE,qFAAqF;AACrF,QAAA,MAAM,UAAU,YAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAChE,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AAoJD;;;;GAIG;AACH,QAAA,MAAM,eAAe,UACZ,SAAS,YACP,WAAW,CAAC,eAAe,CAAC,aAC1B,MAAM,SACX,KAAK,CAAC,MAAM,CAAC,UACZ,KAAK,CAAC,MAAM,CAAC,KACnB,MA0XF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/build/cards/stats.js

@@ -5,6 +5,7 @@ import { I18n } from '../common/I18n.js';
 import { icons, rankIcon } from '../common/icons.js';
 import { buildSearchFilter, clampValue } from '../common/ops.js';
 import { createTextNode, flexLayout, measureText } from '../common/render.js';
+import { atRule, cssComment, el, rule } from '../markup/index.js';
 import { statCardLocales, wakatimeCardLocales } from '../translations.js';
 const CARD_MIN_WIDTH = 287;
 const CARD_DEFAULT_WIDTH = 287;
@@ -12,10 +13,21 @@ const RANK_CARD_MIN_WIDTH = 420;
 const RANK_CARD_DEFAULT_WIDTH = 450;
 const RANK_ONLY_CARD_MIN_WIDTH = 290;
 const RANK_ONLY_CARD_DEFAULT_WIDTH = 290;
+const STAT_FONT_SIZE = 14;
+/** Padding the card keeps at its edges; matches `Card`'s own `paddingX`. */
+const CARD_PADDING_X = 25;
+/** How far a stat row is translated into the card; see `createTextNode`. */
+const STAT_ROW_X = 25;
+/** Room the rank ring needs at the right edge, so a value never runs into it. */
+const RANK_GUTTER = 120;
+/** `createTextNode`'s own label offset, which it applies only when icons are shown. */
+const LABEL_X_OFFSET = 25;
+/** Smallest gap kept between the longest label and its value. */
+const LABEL_VALUE_GAP = 16;
 /** Rank indicators the card can draw; the api validates `rank_icon` against this. */
 const RANK_ICONS = ['default', 'github', 'percentile'];
 /** Long locales that need more space for text. Keep sorted alphabetically. */
-const LONG_LOCALES = [
+const LONG_LOCALES = new Set([
     'az',
     'bg',
     'cs',
@@ -42,112 +54,75 @@ const LONG_LOCALES = [
     'uk-ua',
     'uz',
     'zh-tw',
-];
+]);
 /**
  * Calculates progress along the boundary of the circle, i.e. its circumference.
  *
- * @param value The rank value to calculate progress for.
  * @returns Progress value.
  */
 const calculateCircleProgress = (value) => {
     const radius = 40;
-    const c = Math.PI * (radius * 2);
-    if (value < 0) {
-        value = 0;
-    }
-    if (value > 100) {
-        value = 100;
-    }
-    return ((100 - value) / 100) * c;
+    const circumference = Math.PI * (radius * 2);
+    const clamped = Math.min(Math.max(value, 0), 100);
+    return ((100 - clamped) / 100) * circumference;
 };
 /**
  * Retrieves the animation to display progress along the circumference of circle
  * from the beginning to the given value in a clockwise direction.
  *
- * @param props The props object.
- * @param props.progress The progress value to animate to.
  * @returns Progress animation css.
  */
-const getProgressAnimation = ({ progress }) => {
-    return `
-    @keyframes rankAnimation {
-      from {
-        stroke-dashoffset: ${calculateCircleProgress(0)};
-      }
-      to {
-        stroke-dashoffset: ${calculateCircleProgress(progress)};
-      }
-    }
-  `;
-};
+const getProgressAnimation = ({ progress }) => atRule('@keyframes rankAnimation', rule('from', { 'stroke-dashoffset': calculateCircleProgress(0) }), rule('to', { 'stroke-dashoffset': calculateCircleProgress(progress) }));
 /**
  * Retrieves CSS styles for a card.
  *
- * @param colors The colors to use for the card.
- * @param colors.textColor The text color.
- * @param colors.iconColor The icon color.
- * @param colors.ringColor The ring color.
- * @param colors.show_icons Whether to show icons.
- * @param colors.progress The progress value to animate to.
  * @returns Card CSS styles.
  */
-const getStyles = ({ textColor, iconColor, ringColor, show_icons, progress, }) => {
-    return `
-    .stat {
-      font: 600 14px 'Segoe UI', Ubuntu, "Helvetica Neue", Sans-Serif; fill: ${textColor};
-    }
-    @supports(-moz-appearance: auto) {
-      /* Selector detects Firefox */
-      .stat { font-size:12px; }
-    }
-    .stagger {
-      opacity: 0;
-      animation: fadeInAnimation 0.3s ease-in-out forwards;
-    }
-    .rank-text {
-      font: 800 24px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${textColor};
-      animation: scaleInAnimation 0.3s ease-in-out forwards;
-    }
-    .rank-percentile-header {
-      font-size: 14px;
-    }
-    .rank-percentile-text {
-      font-size: 16px;
-    }
-    
-    .not_bold { font-weight: 400 }
-    .bold { font-weight: 700 }
-    .icon {
-      fill: ${iconColor};
-      display: ${show_icons ? 'block' : 'none'};
-    }
-
-    .rank-circle-rim {
-      stroke: ${ringColor};
-      fill: none;
-      stroke-width: 6;
-      opacity: 0.2;
-    }
-    .rank-circle {
-      stroke: ${ringColor};
-      stroke-dasharray: 250;
-      fill: none;
-      stroke-width: 6;
-      stroke-linecap: round;
-      opacity: 0.8;
-      transform-origin: -10px 8px;
-      transform: rotate(-90deg);
-      animation: rankAnimation 1s forwards ease-in-out;
-    }
-    ${getProgressAnimation({ progress })}
-  `;
-};
+const getStyles = ({ textColor, iconColor, ringColor, show_icons, progress, }) => [
+    rule('.stat', {
+        font: `400 ${STAT_FONT_SIZE}px 'Segoe UI', Ubuntu, "Helvetica Neue", Sans-Serif`,
+        fill: textColor,
+        'font-variant-numeric': 'tabular-nums',
+    }),
+    atRule('@supports(-moz-appearance: auto)', cssComment('Selector detects Firefox'), rule('.stat', { 'font-size': '12px' })),
+    rule('.stagger', { opacity: 0, animation: 'fadeInAnimation 0.3s ease-in-out forwards' }),
+    rule('.rank-text', {
+        font: "700 22px 'Segoe UI', Ubuntu, Sans-Serif",
+        fill: textColor,
+        animation: 'scaleInAnimation 0.3s ease-in-out forwards',
+    }),
+    rule('.rank-percentile-header', { 'font-size': '14px' }),
+    rule('.rank-percentile-text', { 'font-size': '16px' }),
+    cssComment('Labels recede so that the values read first.'),
+    rule('.not_bold', { 'font-weight': 400, opacity: 0.75 }),
+    rule('.bold', { 'font-weight': 600 }),
+    rule('.icon', {
+        fill: iconColor,
+        opacity: 0.75,
+        display: show_icons ? 'block' : 'none',
+    }),
+    rule('.rank-circle-rim', {
+        stroke: ringColor,
+        fill: 'none',
+        'stroke-width': 4,
+        opacity: 0.15,
+    }),
+    rule('.rank-circle', {
+        stroke: ringColor,
+        'stroke-dasharray': 250,
+        fill: 'none',
+        'stroke-width': 4,
+        'stroke-linecap': 'round',
+        opacity: 1,
+        'transform-origin': '-10px 8px',
+        transform: 'rotate(-90deg)',
+        animation: 'rankAnimation 0.8s forwards ease-in-out',
+    }),
+    getProgressAnimation({ progress }),
+];
 /**
  * Return the label for commits according to the selected options
  *
- * @param include_all_commits Option to include all years
- * @param commits_year Option to include only selected year
- * @param i18n The I18n instance.
  * @returns The label corresponding to the options.
  */
 const getTotalCommitsYearLabel = (include_all_commits, commits_year, i18n) => include_all_commits
@@ -158,17 +133,12 @@ const getTotalCommitsYearLabel = (include_all_commits, commits_year, i18n) => in
 /**
  * Renders the stats card.
  *
- * @param stats The stats data.
- * @param options The card options.
- * @param username GitHub username, used to build stat search links.
- * @param repo Repositories to scope the search links to.
- * @param owner Owners to scope the search links to.
  * @returns The stats card SVG object.
  */
 const renderStatsCard = (stats, options = {}, username, repo = [], owner = []) => {
     const { name, totalStars, totalCommits, totalIssues, totalPRs, totalPRsMerged, mergedPRsPercentage, totalReviews, totalDiscussionsStarted, totalDiscussionsAnswered, contributedTo, allTimeContributedTo, totalPRsAuthored, totalPRsCommented, totalPRsReviewed, totalIssuesAuthored, totalIssuesCommented, totalContributions, rank, } = stats;
     const { hide = [], show_icons = false, hide_title = false, hide_border = false, card_width, hide_rank = false, include_all_commits = false, commits_year, line_height = 25, text_bold = true, custom_title, border_radius, number_format = 'short', number_precision, locale, disable_animations = false, rank_icon = 'default', show = [], } = options;
-    const lheight = parseInt(String(line_height), 10);
+    const lheight = Number.parseInt(String(line_height), 10);
     const { lightColors, darkColors } = getLightDarkColors(options);
     const apostrophe = /s$/i.test(name.trim()) ? '' : 's';
     const i18n = new I18n({
@@ -179,12 +149,13 @@ const renderStatsCard = (stats, options = {}, username, repo = [], owner = []) =
         },
     });
     // Meta data for creating text nodes with createTextNode function
-    const STATS = {};
-    STATS['stars'] = {
-        icon: icons.star,
-        label: i18n.t('statcard.totalstars'),
-        value: totalStars,
-        id: 'stars',
+    const STATS = {
+        stars: {
+            icon: icons.star,
+            label: i18n.t('statcard.totalstars'),
+            value: totalStars,
+            id: 'stars',
+        },
     };
     if (show.includes('contributions')) {
         STATS['contributions'] = {
@@ -316,71 +287,70 @@ const renderStatsCard = (stats, options = {}, username, repo = [], owner = []) =
             id: 'all_time_contribs',
         };
     }
-    const isLongLocale = locale ? LONG_LOCALES.includes(locale) : false;
-    // check if all used labels are short
-    const longLabels = Object.entries(STATS)
-        .filter(([key]) => !hide.includes(key))
-        .some(([, stat]) => stat.label.length > 18);
-    // filter out hidden stats defined by user & create the text nodes
-    const statItems = Object.entries(STATS)
-        .filter(([key]) => !hide.includes(key))
-        // pass index so that we can calculate the line spacing
-        .map(([, stat], index) => createTextNode({
-        icon: stat.icon,
-        label: stat.label,
-        value: stat.value,
-        id: stat.id,
-        unitSymbol: stat.unitSymbol,
-        index,
-        showIcons: show_icons,
-        shiftValuePos: 29.01 + (longLabels ? 50 : 0) + (isLongLocale ? 50 : 0),
-        bold: text_bold,
-        numberFormat: number_format,
-        numberPrecision: number_precision,
-        link: stat.link,
-    }));
-    if (statItems.length === 0 && hide_rank) {
+    const isLongLocale = locale ? LONG_LOCALES.has(locale) : false;
+    // filter out hidden stats defined by user
+    const visibleStats = Object.entries(STATS).filter(([key]) => !hide.includes(key));
+    if (visibleStats.length === 0 && hide_rank) {
         throw new CardError('Could not render stats card.', {
             code: 'invalid_param',
             secondaryMessage: 'Either stats or rank are required.',
         });
     }
-    // Calculate the card height depending on how many items there are
-    // but if rank circle is visible clamp the minimum height to `150`
-    const height = Math.max(45 + (statItems.length + 1) * lheight, hide_rank ? 0 : statItems.length ? 150 : 180);
+    // check if all used labels are short
+    const longLabels = visibleStats.some(([, stat]) => stat.label.length > 18);
+    // The rank ring sets the floor: 150 beside the stats, 180 when it is the whole card.
+    const height = Math.max(45 + (visibleStats.length + 1) * lheight, hide_rank ? 0 : visibleStats.length > 0 ? 150 : 180);
     // the lower the user's percentile the better
     const progress = 100 - rank.percentile;
-    const calculateTextWidth = () => {
-        return measureText(custom_title
-            ? custom_title
-            : statItems.length
-                ? i18n.t('statcard.title')
-                : i18n.t('statcard.ranktitle'));
-    };
+    const calculateTextWidth = () => measureText(custom_title ||
+        (visibleStats.length > 0 ? i18n.t('statcard.title') : i18n.t('statcard.ranktitle')));
     /*
       When hide_rank=true, the minimum card width is 270 px + the title length and padding.
       When hide_rank=false, the minimum card_width is 340 px + the icon width (if show_icons=true).
       Numbers are picked by looking at existing dimensions on production.
     */
-    const iconWidth = show_icons && statItems.length ? 16 + /* padding */ 1 : 0;
+    const iconWidth = show_icons && visibleStats.length > 0 ? 16 + /* padding */ 1 : 0;
     const minCardWidth = (hide_rank
         ? clampValue(50 /* padding */ + calculateTextWidth() * 2, CARD_MIN_WIDTH, Infinity)
-        : statItems.length
+        : visibleStats.length > 0
             ? RANK_CARD_MIN_WIDTH
             : RANK_ONLY_CARD_MIN_WIDTH) + iconWidth;
     const defaultCardWidth = (hide_rank
         ? CARD_DEFAULT_WIDTH
-        : statItems.length
+        : visibleStats.length > 0
             ? RANK_CARD_DEFAULT_WIDTH
             : RANK_ONLY_CARD_DEFAULT_WIDTH) + iconWidth;
     const width = card_width
-        ? isNaN(card_width)
+        ? Number.isNaN(card_width)
             ? Math.max(defaultCardWidth, minCardWidth)
             : card_width
         : Math.max(defaultCardWidth, minCardWidth);
+    // A value ends at the card's inner edge, clear of the rank ring — or right after
+    // the longest label, on a card too narrow for that.
+    const widestLabel = visibleStats.length > 0
+        ? Math.max(...visibleStats.map(([, stat]) => measureText(`${stat.label}:`, STAT_FONT_SIZE)))
+        : 0;
+    const valueAnchorX = Math.round(Math.max(width - CARD_PADDING_X - STAT_ROW_X - (hide_rank ? 0 : RANK_GUTTER), (show_icons ? LABEL_X_OFFSET : 0) + widestLabel + LABEL_VALUE_GAP));
+    // pass index so that we can calculate the line spacing
+    const statItems = visibleStats.map(([, stat], index) => createTextNode({
+        icon: stat.icon,
+        label: stat.label,
+        value: stat.value,
+        id: stat.id,
+        unitSymbol: stat.unitSymbol,
+        index,
+        showIcons: show_icons,
+        shiftValuePos: 29.01 + (longLabels ? 50 : 0) + (isLongLocale ? 50 : 0),
+        valueAnchorX,
+        bold: text_bold,
+        labelBold: false,
+        numberFormat: number_format,
+        numberPrecision: number_precision,
+        link: stat.link,
+    }));
     const card = new Card({
         customTitle: custom_title,
-        defaultTitle: statItems.length ? i18n.t('statcard.title') : i18n.t('statcard.ranktitle'),
+        defaultTitle: visibleStats.length > 0 ? i18n.t('statcard.title') : i18n.t('statcard.ranktitle'),
         width,
         height,
         border_radius,
@@ -404,34 +374,24 @@ const renderStatsCard = (stats, options = {}, username, repo = [], owner = []) =
      * @returns Rank circle translation value.
      */
     const calculateRankXTranslation = () => {
-        if (statItems.length) {
+        if (visibleStats.length > 0) {
             const minXTranslation = RANK_CARD_MIN_WIDTH + iconWidth - 70;
             if (width > RANK_CARD_DEFAULT_WIDTH) {
                 const xMaxExpansion = minXTranslation + (450 - minCardWidth) / 2;
                 return xMaxExpansion + width - RANK_CARD_DEFAULT_WIDTH;
             }
-            else {
-                return minXTranslation + (width - minCardWidth) / 2;
-            }
-        }
-        else {
-            return width / 2 + 20 - 10;
+            return minXTranslation + (width - minCardWidth) / 2;
         }
+        return width / 2 + 20 - 10;
     };
     // Conditionally rendered elements
-    const rankCircle = hide_rank
-        ? ''
-        : `<g data-testid="rank-circle"
-          transform="translate(${calculateRankXTranslation()}, ${height / 2 - 50})">
-        <circle class="rank-circle-rim" cx="-10" cy="8" r="40" />
-        <circle class="rank-circle" cx="-10" cy="8" r="40" />
-        <g class="rank-text">
-          ${rankIcon(rank_icon, rank.level, rank.percentile)}
-        </g>
-      </g>`;
+    const rankCircle = !hide_rank &&
+        el('g', {
+            'data-testid': 'rank-circle',
+            transform: `translate(${calculateRankXTranslation()}, ${height / 2 - 50})`,
+        }, el('circle', { class: 'rank-circle-rim', cx: -10, cy: 8, r: 40 }), el('circle', { class: 'rank-circle', cx: -10, cy: 8, r: 40 }), el('g', { class: 'rank-text' }, rankIcon(rank_icon, rank.level, rank.percentile)));
     // Accessibility Labels
-    const labels = Object.entries(STATS)
-        .filter(([key]) => !hide.includes(key))
+    const labels = visibleStats
         .map(([key, stat]) => {
         if (key === 'commits') {
             return `${i18n.t('statcard.commits')} ${getTotalCommitsYearLabel(include_all_commits, commits_year, i18n)} : ${stat.value}`;
@@ -443,15 +403,9 @@ const renderStatsCard = (stats, options = {}, username, repo = [], owner = []) =
         title: `${card.title}, Rank: ${rank.level}`,
         desc: labels,
     });
-    return card.render(`
-    ${rankCircle}
-    <svg x="0" y="0">
-      ${flexLayout({
-        items: statItems,
-        gap: lheight,
-        direction: 'column',
-    }).join('')}
-    </svg>
-  `);
+    return card.render([
+        rankCircle,
+        el('svg', { x: 0, y: 0 }, flexLayout({ items: statItems, gap: lheight, direction: 'column' })),
+    ]);
 };
 export { RANK_ICONS, renderStatsCard };

package/build/cards/top-languages.d.ts

@@ -1,11 +1,11 @@
-import type { Lang, TopLangData } from '../fetchers/types.js';
-import type { CardOptions, CommonCardOptions } from './options.js';
+import type { Lang, TopLangData } from '../fetchers/types.ts';
+import type { CardOptions, CommonCardOptions } from './options.ts';
 declare const MIN_CARD_WIDTH = 280;
 /** Layouts the card can draw; the api validates `layout` against this. */
-declare const TOP_LANG_LAYOUTS: readonly ["compact", "normal", "donut", "donut-vertical", "pie"];
+declare const TOP_LANG_LAYOUTS: readonly ['compact', 'normal', 'donut', 'donut-vertical', 'pie'];
 type TopLangLayout = (typeof TOP_LANG_LAYOUTS)[number];
 /** How a language's value is shown; the api validates `stats_format` against this. */
-declare const TOP_LANG_STATS_FORMATS: readonly ["percentages", "bytes"];
+declare const TOP_LANG_STATS_FORMATS: readonly ['percentages', 'bytes'];
 type TopLangStatsFormat = (typeof TOP_LANG_STATS_FORMATS)[number];
 interface TopLangOptions extends CommonCardOptions {
     locale: string;
@@ -24,31 +24,24 @@ interface TopLangOptions extends CommonCardOptions {
 /**
  * Retrieves the programming language whose name is the longest.
  *
- * @param arr Array of programming languages.
  * @returns Longest programming language object.
  */
-declare const getLongestLang: (arr: Array<Lang>) => Pick<Lang, "name" | "size" | "color">;
+declare const getLongestLang: (arr: Array<Lang>) => Pick<Lang, 'name' | 'size' | 'color'>;
 /**
  * Convert degrees to radians.
  *
- * @param angleInDegrees Angle in degrees.
  * @returns Angle in radians.
  */
 declare const degreesToRadians: (angleInDegrees: number) => number;
 /**
  * Convert radians to degrees.
  *
- * @param angleInRadians Angle in radians.
  * @returns Angle in degrees.
  */
 declare const radiansToDegrees: (angleInRadians: number) => number;
 /**
  * Convert polar coordinates to cartesian coordinates.
  *
- * @param centerX Center x coordinate.
- * @param centerY Center y coordinate.
- * @param radius Radius of the circle.
- * @param angleInDegrees Angle in degrees.
  * @returns Cartesian coordinates.
  */
 declare const polarToCartesian: (centerX: number, centerY: number, radius: number, angleInDegrees: number) => {
@@ -58,10 +51,6 @@ declare const polarToCartesian: (centerX: number, centerY: number, radius: numbe
 /**
  * Convert cartesian coordinates to polar coordinates.
  *
- * @param centerX Center x coordinate.
- * @param centerY Center y coordinate.
- * @param x Point x coordinate.
- * @param y Point y coordinate.
  * @returns Polar coordinates.
  */
 declare const cartesianToPolar: (centerX: number, centerY: number, x: number, y: number) => {
@@ -71,58 +60,48 @@ declare const cartesianToPolar: (centerX: number, centerY: number, x: number, y:
 /**
  * Calculates length of circle.
  *
- * @param radius Radius of the circle.
  * @returns The length of the circle.
  */
 declare const getCircleLength: (radius: number) => number;
 /**
  * Calculates height for the compact layout.
  *
- * @param totalLangs Total number of languages.
  * @returns Card height.
  */
 declare const calculateCompactLayoutHeight: (totalLangs: number) => number;
 /**
  * Calculates height for the normal layout.
  *
- * @param totalLangs Total number of languages.
  * @returns Card height.
  */
 declare const calculateNormalLayoutHeight: (totalLangs: number) => number;
 /**
  * Calculates height for the donut layout.
  *
- * @param totalLangs Total number of languages.
  * @returns Card height.
  */
 declare const calculateDonutLayoutHeight: (totalLangs: number) => number;
 /**
  * Calculates height for the donut vertical layout.
  *
- * @param totalLangs Total number of languages.
  * @returns Card height.
  */
 declare const calculateDonutVerticalLayoutHeight: (totalLangs: number) => number;
 /**
  * Calculates height for the pie layout.
  *
- * @param totalLangs Total number of languages.
  * @returns Card height.
  */
 declare const calculatePieLayoutHeight: (totalLangs: number) => number;
 /**
  * Calculates the center translation needed to keep the donut chart centred.
  *
- * @param totalLangs Total number of languages.
  * @returns Donut center translation.
  */
 declare const donutCenterTranslation: (totalLangs: number) => number;
 /**
  * Trim top languages to lang_count while also hiding certain languages.
  *
- * @param topLangs Top languages.
- * @param langs_count Number of languages to show.
- * @param hide Languages to hide.
  * @returns Trimmed top languages and total size.
  */
 declare const trimTopLanguages: (topLangs: TopLangData, langs_count: number, hide?: Array<string>) => {
@@ -132,9 +111,6 @@ declare const trimTopLanguages: (topLangs: TopLangData, langs_count: number, hid
 /**
  * Get default languages count for provided card layout.
  *
- * @param props Function properties.
- * @param props.layout Input layout string.
- * @param props.hide_progress Input hide_progress parameter value.
  * @returns Default languages count for input layout.
  */
 declare const getDefaultLanguagesCountByLayout: ({ layout, hide_progress, }: {
@@ -144,8 +120,6 @@ declare const getDefaultLanguagesCountByLayout: ({ layout, hide_progress, }: {
 /**
  * Renders card that display user's most frequently used programming languages.
  *
- * @param topLangs User's most frequently used programming languages.
- * @param options Card options.
  * @returns Language card SVG object.
  */
 declare const renderTopLanguages: (topLangs: TopLangData, options?: CardOptions<TopLangOptions>) => string;

package/build/cards/top-languages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"top-languages.d.ts","sourceRoot":"","sources":["../../src/cards/top-languages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"top-languages.d.ts","sourceRoot":"","sources":["../../src/cards/top-languages.ts"],"names":[],"mappings":"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"}