@lizardbyte/contribkit 2025.922.2626 → 2026.518.124816

package/README.md

@@ -1,7 +1,7 @@
 # ContribKit
 
 [![GitHub stars](https://img.shields.io/github/stars/lizardbyte/contribkit.svg?logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit)
-[![GitHub Workflow Status (CI)](https://img.shields.io/github/actions/workflow/status/lizardbyte/contribkit/ci.yml.svg?branch=master&label=CI%20build&logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit/actions/workflows/CI.yml?query=branch%3Amaster)
+[![GitHub Workflow Status (CI)](https://img.shields.io/github/actions/workflow/status/lizardbyte/contribkit/_ci-node.yml.svg?branch=master&label=CI%20build&logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit/actions/workflows/_ci-node.yml?query=branch%3Amaster)
 [![Codecov](https://img.shields.io/codecov/c/gh/LizardByte/contribkit?token=WBivqQDwFw&style=for-the-badge&logo=codecov&label=codecov)](https://codecov.io/gh/LizardByte/contribkit)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/%40lizardbyte%2Fcontribkit?style=for-the-badge&logo=npm&label=npm%20downloads/m)](https://www.npmjs.com/package/@lizardbyte/contribkit)
 [![NPM Version](https://img.shields.io/npm/v/%40lizardbyte%2Fcontribkit?style=for-the-badge&logo=npm&label=npm%20version)](https://www.npmjs.com/package/@lizardbyte/contribkit)
@@ -13,7 +13,8 @@ Supports:
 
 - Contributors:
   - [**CrowdIn**](https://crowdin.com)
-  - [**GitHub**](https://github.com)
+  - [**GitHub Contributors**](https://github.com) (contributors to a specific repository)
+  - [**GitHub Contributions**](https://github.com) (merged PRs aggregated by repository owner across all repos for a single user)
   - [**Gitlab**](https://gitlab.com)
 - Sponsors:
   - [**GitHub Sponsors**](https://github.com/sponsors)
@@ -37,11 +38,25 @@ CONTRIBKIT_CROWDIN_MIN_TRANSLATIONS=1
 
 ; GitHubContributors provider.
 ; Token requires the `public_repo` and `read:user` scopes.
+; This provider tracks all contributors to a specific repository.
 CONTRIBKIT_GITHUB_CONTRIBUTORS_TOKEN=
 CONTRIBKIT_GITHUB_CONTRIBUTORS_LOGIN=
 CONTRIBKIT_GITHUB_CONTRIBUTORS_MIN=1
 CONTRIBKIT_GITHUB_CONTRIBUTORS_REPO=
 
+; GitHubContributions provider.
+; Token requires the `read:user` scope.
+; This provider aggregates merged pull requests across all repositories by repository owner (user or organization).
+; Each owner appears once with the total merged PRs you authored to their repos.
+; Avatar and link point to the owner (or to the repo if only one repo per owner).
+; Only merged PRs are counted - open or closed-without-merge PRs are excluded.
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_TOKEN=
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGIN=
+; Optional: Cap the maximum contribution count per org/user (useful for circles visualization)
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_MAX=
+; Optional: Apply logarithmic scaling to reduce dominance of high contributors (true/false)
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGARITHMIC=
+
 ; GitlabContributors provider.
 ; Token requires the `read_api` and `read_user` scopes.
 CONTRIBKIT_GITLAB_CONTRIBUTORS_TOKEN=
@@ -96,9 +111,26 @@ CONTRIBKIT_LIBERAPAY_LOGIN=
 > This will require different env variables to be set for each provider, and to be created from separate
 > commands.
 
+#### GitHub Provider Options
+
+There are two GitHub contributor providers available:
+
+- **GitHubContributors**: Tracks all contributors to a specific repository (e.g., `owner/repo`). Each contributor appears once with their actual contribution count to that repository.
+- **GitHubContributions**: Aggregates a single user's **merged pull requests** across all repositories, grouped by repository owner (user or organization). Each owner appears once with the total merged PRs. The avatar and link point to the owner (or to the specific repo if only one repo per owner).
+
+Use **GitHubContributors** when you want to showcase everyone who has contributed to your project with their contribution counts.
+Use **GitHubContributions** when you want to understand where a single user's completed contributions (merged PRs) have gone, without overwhelming duplicates per repo under the same owner.
+
+**GitHubContributions accuracy**:
+- Counts only **merged** pull requests - open or closed-without-merge PRs are excluded
+- Discovers repos via **2 sources**:
+  1. **contributionsCollection** - Yearly commit timeline (full history) for discovering repositories you have committed to
+  2. **Search API** - Repositories where you have merged PRs (`is:pr is:merged author:login`)
+- When an owner has only one repo, the link points to that repo; otherwise to the owner profile
+
 Run:
 
-```base
+```bash
 npx contribkit
 ```
 
@@ -133,6 +165,11 @@ export default defineConfig({
     // ...
   },
 
+  // For contributor providers:
+  githubContributions: {
+    login: 'username',
+  },
+
   // Rendering configs
   width: 800,
   renderer: 'tiers', // or 'circles'

package/dist/chunks/index.mjs

@@ -43,6 +43,12 @@ class Queue {
 
 		this.#head = this.#head.next;
 		this.#size--;
+
+		// Clean up tail reference when queue becomes empty
+		if (!this.#head) {
+			this.#tail = undefined;
+		}
+
 		return current.value;
 	}
 
@@ -84,61 +90,70 @@ class Queue {
 }
 
 function pLimit(concurrency) {
+	let rejectOnClear = false;
+
+	if (typeof concurrency === 'object') {
+		({concurrency, rejectOnClear = false} = concurrency);
+	}
+
 	validateConcurrency(concurrency);
 
+	if (typeof rejectOnClear !== 'boolean') {
+		throw new TypeError('Expected `rejectOnClear` to be a boolean');
+	}
+
 	const queue = new Queue();
 	let activeCount = 0;
 
 	const resumeNext = () => {
+		// Process the next queued function if we're under the concurrency limit
 		if (activeCount < concurrency && queue.size > 0) {
-			queue.dequeue()();
-			// Since `pendingCount` has been decreased by one, increase `activeCount` by one.
 			activeCount++;
+			queue.dequeue().run();
 		}
 	};
 
 	const next = () => {
 		activeCount--;
-
 		resumeNext();
 	};
 
 	const run = async (function_, resolve, arguments_) => {
+		// Execute the function and capture the result promise
 		const result = (async () => function_(...arguments_))();
 
+		// Resolve immediately with the promise (don't wait for completion)
 		resolve(result);
 
+		// Wait for the function to complete (success or failure)
+		// We catch errors here to prevent unhandled rejections,
+		// but the original promise rejection is preserved for the caller
 		try {
 			await result;
 		} catch {}
 
+		// Decrement active count and process next queued function
 		next();
 	};
 
-	const enqueue = (function_, resolve, arguments_) => {
-		// Queue `internalResolve` instead of the `run` function
-		// to preserve asynchronous context.
-		new Promise(internalResolve => {
-			queue.enqueue(internalResolve);
-		}).then(
-			run.bind(undefined, function_, resolve, arguments_),
-		);
-
-		(async () => {
-			// This function needs to wait until the next microtask before comparing
-			// `activeCount` to `concurrency`, because `activeCount` is updated asynchronously
-			// after the `internalResolve` function is dequeued and called. The comparison in the if-statement
-			// needs to happen asynchronously as well to get an up-to-date value for `activeCount`.
-			await Promise.resolve();
-
-			if (activeCount < concurrency) {
-				resumeNext();
-			}
-		})();
+	const enqueue = (function_, resolve, reject, arguments_) => {
+		const queueItem = {reject};
+
+		// Queue the internal resolve function instead of the run function
+		// to preserve the asynchronous execution context.
+		new Promise(internalResolve => { // eslint-disable-line promise/param-names
+			queueItem.run = internalResolve;
+			queue.enqueue(queueItem);
+		}).then(run.bind(undefined, function_, resolve, arguments_)); // eslint-disable-line promise/prefer-await-to-then
+
+		// Start processing immediately if we haven't reached the concurrency limit
+		if (activeCount < concurrency) {
+			resumeNext();
+		}
 	};
 
-	const generator = (function_, ...arguments_) => new Promise(resolve => {
-		enqueue(function_, resolve, arguments_);
+	const generator = (function_, ...arguments_) => new Promise((resolve, reject) => {
+		enqueue(function_, resolve, reject, arguments_);
 	});
 
 	Object.defineProperties(generator, {
@@ -150,7 +165,16 @@ function pLimit(concurrency) {
 		},
 		clearQueue: {
 			value() {
-				queue.clear();
+				if (!rejectOnClear) {
+					queue.clear();
+					return;
+				}
+
+				const abortError = AbortSignal.abort().reason;
+
+				while (queue.size > 0) {
+					queue.dequeue().reject(abortError);
+				}
 			},
 		},
 		concurrency: {
@@ -168,6 +192,12 @@ function pLimit(concurrency) {
 				});
 			},
 		},
+		map: {
+			async value(iterable, function_) {
+				const promises = Array.from(iterable, (value, index) => this(function_, value, index));
+				return Promise.all(promises);
+			},
+		},
 	});
 
 	return generator;

package/dist/chunks/index3.mjs

@@ -193,48 +193,6 @@ function requireLodash_escaperegexp () {
 	return lodash_escaperegexp;
 }
 
-/**
- * lodash 4.0.0 (Custom Build) <https://lodash.com/>
- * Build: `lodash modularize exports="npm" -o ./`
- * Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>
- * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
- * Copyright 2009-2016 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
- * Available under MIT license <https://lodash.com/license>
- */
-
-var lodash_isnil;
-var hasRequiredLodash_isnil;
-
-function requireLodash_isnil () {
-	if (hasRequiredLodash_isnil) return lodash_isnil;
-	hasRequiredLodash_isnil = 1;
-	/**
-	 * Checks if `value` is `null` or `undefined`.
-	 *
-	 * @static
-	 * @memberOf _
-	 * @category Lang
-	 * @param {*} value The value to check.
-	 * @returns {boolean} Returns `true` if `value` is nullish, else `false`.
-	 * @example
-	 *
-	 * _.isNil(null);
-	 * // => true
-	 *
-	 * _.isNil(void 0);
-	 * // => true
-	 *
-	 * _.isNil(NaN);
-	 * // => false
-	 */
-	function isNil(value) {
-	  return value == null;
-	}
-
-	lodash_isnil = isNil;
-	return lodash_isnil;
-}
-
 var hasRequiredParserOptions;
 
 function requireParserOptions () {
@@ -246,7 +204,6 @@ function requireParserOptions () {
 	Object.defineProperty(ParserOptions, "__esModule", { value: true });
 	ParserOptions.ParserOptions = void 0;
 	const lodash_escaperegexp_1 = __importDefault(requireLodash_escaperegexp());
-	const lodash_isnil_1 = __importDefault(requireLodash_isnil());
 	let ParserOptions$1 = class ParserOptions {
 	    escapedDelimiter;
 	    objectMode = true;
@@ -278,7 +235,7 @@ function requireParserOptions () {
 	        }
 	        this.escapedDelimiter = (0, lodash_escaperegexp_1.default)(this.delimiter);
 	        this.escapeChar = this.escape ?? this.quote;
-	        this.supportsComments = !(0, lodash_isnil_1.default)(this.comment);
+	        this.supportsComments = this.comment != null;
 	        this.NEXT_TOKEN_REGEXP = new RegExp(`([^\\s]|\\r\\n|\\n|\\r|${this.escapedDelimiter})`);
 	        if (this.maxRows > 0) {
 	            this.limitRows = true;
@@ -296,170 +253,6 @@ var transforms = {};
 
 var RowTransformerValidator = {};
 
-/**
- * Lodash (Custom Build) <https://lodash.com/>
- * Build: `lodash modularize exports="npm" -o ./`
- * Copyright JS Foundation and other contributors <https://js.foundation/>
- * Released under MIT license <https://lodash.com/license>
- * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
- * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
- */
-
-var lodash_isfunction;
-var hasRequiredLodash_isfunction;
-
-function requireLodash_isfunction () {
-	if (hasRequiredLodash_isfunction) return lodash_isfunction;
-	hasRequiredLodash_isfunction = 1;
-	/** `Object#toString` result references. */
-	var asyncTag = '[object AsyncFunction]',
-	    funcTag = '[object Function]',
-	    genTag = '[object GeneratorFunction]',
-	    nullTag = '[object Null]',
-	    proxyTag = '[object Proxy]',
-	    undefinedTag = '[object Undefined]';
-
-	/** Detect free variable `global` from Node.js. */
-	var freeGlobal = typeof commonjsGlobal == 'object' && commonjsGlobal && commonjsGlobal.Object === Object && commonjsGlobal;
-
-	/** Detect free variable `self`. */
-	var freeSelf = typeof self == 'object' && self && self.Object === Object && self;
-
-	/** Used as a reference to the global object. */
-	var root = freeGlobal || freeSelf || Function('return this')();
-
-	/** Used for built-in method references. */
-	var objectProto = Object.prototype;
-
-	/** Used to check objects for own properties. */
-	var hasOwnProperty = objectProto.hasOwnProperty;
-
-	/**
-	 * Used to resolve the
-	 * [`toStringTag`](http://ecma-international.org/ecma-262/7.0/#sec-object.prototype.tostring)
-	 * of values.
-	 */
-	var nativeObjectToString = objectProto.toString;
-
-	/** Built-in value references. */
-	var Symbol = root.Symbol,
-	    symToStringTag = Symbol ? Symbol.toStringTag : undefined;
-
-	/**
-	 * The base implementation of `getTag` without fallbacks for buggy environments.
-	 *
-	 * @private
-	 * @param {*} value The value to query.
-	 * @returns {string} Returns the `toStringTag`.
-	 */
-	function baseGetTag(value) {
-	  if (value == null) {
-	    return value === undefined ? undefinedTag : nullTag;
-	  }
-	  return (symToStringTag && symToStringTag in Object(value))
-	    ? getRawTag(value)
-	    : objectToString(value);
-	}
-
-	/**
-	 * A specialized version of `baseGetTag` which ignores `Symbol.toStringTag` values.
-	 *
-	 * @private
-	 * @param {*} value The value to query.
-	 * @returns {string} Returns the raw `toStringTag`.
-	 */
-	function getRawTag(value) {
-	  var isOwn = hasOwnProperty.call(value, symToStringTag),
-	      tag = value[symToStringTag];
-
-	  try {
-	    value[symToStringTag] = undefined;
-	    var unmasked = true;
-	  } catch (e) {}
-
-	  var result = nativeObjectToString.call(value);
-	  if (unmasked) {
-	    if (isOwn) {
-	      value[symToStringTag] = tag;
-	    } else {
-	      delete value[symToStringTag];
-	    }
-	  }
-	  return result;
-	}
-
-	/**
-	 * Converts `value` to a string using `Object.prototype.toString`.
-	 *
-	 * @private
-	 * @param {*} value The value to convert.
-	 * @returns {string} Returns the converted string.
-	 */
-	function objectToString(value) {
-	  return nativeObjectToString.call(value);
-	}
-
-	/**
-	 * Checks if `value` is classified as a `Function` object.
-	 *
-	 * @static
-	 * @memberOf _
-	 * @since 0.1.0
-	 * @category Lang
-	 * @param {*} value The value to check.
-	 * @returns {boolean} Returns `true` if `value` is a function, else `false`.
-	 * @example
-	 *
-	 * _.isFunction(_);
-	 * // => true
-	 *
-	 * _.isFunction(/abc/);
-	 * // => false
-	 */
-	function isFunction(value) {
-	  if (!isObject(value)) {
-	    return false;
-	  }
-	  // The use of `Object#toString` avoids issues with the `typeof` operator
-	  // in Safari 9 which returns 'object' for typed arrays and other constructors.
-	  var tag = baseGetTag(value);
-	  return tag == funcTag || tag == genTag || tag == asyncTag || tag == proxyTag;
-	}
-
-	/**
-	 * Checks if `value` is the
-	 * [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types)
-	 * of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
-	 *
-	 * @static
-	 * @memberOf _
-	 * @since 0.1.0
-	 * @category Lang
-	 * @param {*} value The value to check.
-	 * @returns {boolean} Returns `true` if `value` is an object, else `false`.
-	 * @example
-	 *
-	 * _.isObject({});
-	 * // => true
-	 *
-	 * _.isObject([1, 2, 3]);
-	 * // => true
-	 *
-	 * _.isObject(_.noop);
-	 * // => true
-	 *
-	 * _.isObject(null);
-	 * // => false
-	 */
-	function isObject(value) {
-	  var type = typeof value;
-	  return value != null && (type == 'object' || type == 'function');
-	}
-
-	lodash_isfunction = isFunction;
-	return lodash_isfunction;
-}
-
 var types = {};
 
 var hasRequiredTypes;
@@ -486,15 +279,10 @@ var hasRequiredRowTransformerValidator;
 function requireRowTransformerValidator () {
 	if (hasRequiredRowTransformerValidator) return RowTransformerValidator;
 	hasRequiredRowTransformerValidator = 1;
-	var __importDefault = (RowTransformerValidator && RowTransformerValidator.__importDefault) || function (mod) {
-	    return (mod && mod.__esModule) ? mod : { "default": mod };
-	};
 	Object.defineProperty(RowTransformerValidator, "__esModule", { value: true });
 	RowTransformerValidator.RowTransformerValidator = void 0;
-	const lodash_isfunction_1 = __importDefault(requireLodash_isfunction());
 	const types_1 = requireTypes();
 	let RowTransformerValidator$1 = class RowTransformerValidator {
-	    // eslint-disable-next-line @typescript-eslint/no-shadow
 	    static createTransform(transformFunction) {
 	        if ((0, types_1.isSyncTransform)(transformFunction)) {
 	            return (row, cb) => {
@@ -531,13 +319,13 @@ function requireRowTransformerValidator () {
 	    _rowTransform = null;
 	    _rowValidator = null;
 	    set rowTransform(transformFunction) {
-	        if (!(0, lodash_isfunction_1.default)(transformFunction)) {
+	        if (typeof transformFunction !== 'function') {
 	            throw new TypeError('The transform should be a function');
 	        }
 	        this._rowTransform = RowTransformerValidator.createTransform(transformFunction);
 	    }
 	    set rowValidator(validateFunction) {
-	        if (!(0, lodash_isfunction_1.default)(validateFunction)) {
+	        if (typeof validateFunction !== 'function') {
 	            throw new TypeError('The validate should be a function');
 	        }
 	        this._rowValidator = RowTransformerValidator.createValidator(validateFunction);
@@ -581,45 +369,6 @@ function requireRowTransformerValidator () {
 
 var HeaderTransformer = {};
 
-/**
- * lodash 3.0.1 (Custom Build) <https://lodash.com/>
- * Build: `lodash modern modularize exports="npm" -o ./`
- * Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/>
- * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
- * Copyright 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
- * Available under MIT license <https://lodash.com/license>
- */
-
-var lodash_isundefined;
-var hasRequiredLodash_isundefined;
-
-function requireLodash_isundefined () {
-	if (hasRequiredLodash_isundefined) return lodash_isundefined;
-	hasRequiredLodash_isundefined = 1;
-	/**
-	 * Checks if `value` is `undefined`.
-	 *
-	 * @static
-	 * @memberOf _
-	 * @category Lang
-	 * @param {*} value The value to check.
-	 * @returns {boolean} Returns `true` if `value` is `undefined`, else `false`.
-	 * @example
-	 *
-	 * _.isUndefined(void 0);
-	 * // => true
-	 *
-	 * _.isUndefined(null);
-	 * // => false
-	 */
-	function isUndefined(value) {
-	  return value === undefined;
-	}
-
-	lodash_isundefined = isUndefined;
-	return lodash_isundefined;
-}
-
 /**
  * lodash (Custom Build) <https://lodash.com/>
  * Build: `lodash modularize exports="npm" -o ./`
@@ -3885,8 +3634,6 @@ function requireHeaderTransformer () {
 	};
 	Object.defineProperty(HeaderTransformer, "__esModule", { value: true });
 	HeaderTransformer.HeaderTransformer = void 0;
-	const lodash_isundefined_1 = __importDefault(requireLodash_isundefined());
-	const lodash_isfunction_1 = __importDefault(requireLodash_isfunction());
 	const lodash_uniq_1 = __importDefault(requireLodash_uniq());
 	const lodash_groupby_1 = __importDefault(requireLodash_groupby());
 	let HeaderTransformer$1 = class HeaderTransformer {
@@ -3905,7 +3652,7 @@ function requireHeaderTransformer () {
 	        else if (Array.isArray(parserOptions.headers)) {
 	            this.setHeaders(parserOptions.headers);
 	        }
-	        else if ((0, lodash_isfunction_1.default)(parserOptions.headers)) {
+	        else if (typeof parserOptions.headers === 'function') {
 	            this.headersTransform = parserOptions.headers;
 	        }
 	    }
@@ -3968,10 +3715,9 @@ function requireHeaderTransformer () {
 	        const { headers, headersLength } = this;
 	        for (let i = 0; i < headersLength; i += 1) {
 	            const header = headers[i];
-	            if (!(0, lodash_isundefined_1.default)(header)) {
+	            if (header !== undefined) {
 	                const val = row[i];
-	                // eslint-disable-next-line no-param-reassign
-	                if ((0, lodash_isundefined_1.default)(val)) {
+	                if (val === undefined) {
 	                    rowMap[header] = '';
 	                }
 	                else {
@@ -4851,13 +4597,23 @@ function requireSrc () {
 		}) : function(o, v) {
 		    o["default"] = v;
 		});
-		var __importStar = (src && src.__importStar) || function (mod) {
-		    if (mod && mod.__esModule) return mod;
-		    var result = {};
-		    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-		    __setModuleDefault(result, mod);
-		    return result;
-		};
+		var __importStar = (src && src.__importStar) || (function () {
+		    var ownKeys = function(o) {
+		        ownKeys = Object.getOwnPropertyNames || function (o) {
+		            var ar = [];
+		            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+		            return ar;
+		        };
+		        return ownKeys(o);
+		    };
+		    return function (mod) {
+		        if (mod && mod.__esModule) return mod;
+		        var result = {};
+		        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+		        __setModuleDefault(result, mod);
+		        return result;
+		    };
+		})();
 		var __exportStar = (src && src.__exportStar) || function(m, exports) {
 		    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 		};

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 import cac from 'cac';
-import { S as SvgComposer, i as generateBadge, p as partitionTiers, t as tierPresets, v as version, l as loadConfig, k as resolveProviders, j as guessProviders, r as resolveAvatars, q as outputFormats, s as svgToPng, g as svgToWebp } from './shared/contribkit.DAlakhwL.mjs';
+import { S as SvgComposer, h as generateBadge, p as partitionTiers, t as tierPresets, v as version, l as loadConfig, n as resolveProviders, i as guessProviders, k as resolveAvatars, o as outputFormats, s as svgToPng, q as svgToWebp } from './shared/contribkit.DYospa65.mjs';
 import fs from 'node:fs';
 import fsp from 'node:fs/promises';
 import { resolve, dirname, relative, join } from 'node:path';

package/dist/index.d.mts

@@ -83,7 +83,7 @@ interface Sponsorship {
 }
 declare const outputFormats: readonly ["svg", "png", "webp", "json"];
 type OutputFormat = typeof outputFormats[number];
-type ProviderName = 'github' | 'patreon' | 'opencollective' | 'afdian' | 'polar' | 'liberapay' | 'githubContributors' | 'gitlabContributors' | 'crowdinContributors';
+type ProviderName = 'github' | 'patreon' | 'opencollective' | 'afdian' | 'polar' | 'liberapay' | 'githubContributors' | 'gitlabContributors' | 'crowdinContributors' | 'githubContributions';
 type GitHubAccountType = 'user' | 'organization';
 interface ProvidersConfig {
     github?: {
@@ -278,6 +278,36 @@ interface ProvidersConfig {
          */
         minTranslations?: number;
     };
+    githubContributions?: {
+        /**
+         * GitHub user login to fetch contributions for.
+         *
+         * Will read from `CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGIN` environment variable if not set.
+         */
+        login?: string;
+        /**
+         * GitHub Token that has access to read user contributions.
+         *
+         * Will read from `CONTRIBKIT_GITHUB_CONTRIBUTIONS_TOKEN` environment variable if not set.
+         *
+         * @deprecated It's not recommended set this value directly, pass from env or use `.env` file.
+         */
+        token?: string;
+        /**
+         * Cap the maximum contribution count per organization/user.
+         * Useful to prevent one dominant contributor from overshadowing others in visualizations.
+         *
+         * @example 100 // Cap all contributions at 100 PRs max
+         */
+        maxContributions?: number;
+        /**
+         * Apply logarithmic scaling to contribution counts.
+         * Useful to reduce the visual dominance of high contributors while maintaining relative differences.
+         *
+         * @default false
+         */
+        logarithmicScaling?: boolean;
+    };
 }
 interface ContribkitRenderOptions {
     /**
@@ -557,6 +587,7 @@ declare const ProvidersMap: {
     polar: Provider;
     liberapay: Provider;
     githubContributors: Provider;
+    githubContributions: Provider;
     gitlabContributors: Provider;
     crowdinContributors: Provider;
 };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { F as FALLBACK_AVATAR, G as GitHubProvider, P as ProvidersMap, S as SvgComposer, c as defaultConfig, b as defaultInlineCSS, a as defaultTiers, d as defineConfig, n as fetchGitHubSponsors, m as fetchSponsors, h as genSvgImage, i as generateBadge, j as guessProviders, l as loadConfig, o as makeQuery, q as outputFormats, p as partitionTiers, e as presets, f as resizeImage, r as resolveAvatars, k as resolveProviders, s as svgToPng, g as svgToWebp, t as tierPresets } from './shared/contribkit.DAlakhwL.mjs';
+export { F as FALLBACK_AVATAR, G as GitHubProvider, P as ProvidersMap, S as SvgComposer, d as defaultConfig, a as defaultInlineCSS, b as defaultTiers, c as defineConfig, f as fetchGitHubSponsors, e as fetchSponsors, g as genSvgImage, h as generateBadge, i as guessProviders, l as loadConfig, m as makeQuery, o as outputFormats, p as partitionTiers, j as presets, r as resizeImage, k as resolveAvatars, n as resolveProviders, s as svgToPng, q as svgToWebp, t as tierPresets } from './shared/contribkit.DYospa65.mjs';
 import 'unconfig';
 import 'node:process';
 import 'dotenv';