pkg-stats 0.6.0 → 0.7.0

package/dist/__tests__/cli-options.test.js

@@ -0,0 +1,18 @@
+import { expect, test } from 'vitest';
+import { parseCliOptions } from '../cli-options.js';
+test('parseCliOptions defaults to version sorting', () => {
+    const options = parseCliOptions(['node', 'pkg-stats', 'react', '--color', 'atlas']);
+    expect(options.sort).toBe('version');
+});
+test('parseCliOptions supports download sorting', () => {
+    const options = parseCliOptions([
+        'node',
+        'pkg-stats',
+        'react',
+        '--sort',
+        'downloads',
+        '--color',
+        'atlas',
+    ]);
+    expect(options.sort).toBe('downloads');
+});

package/dist/__tests__/stats.test.js

@@ -0,0 +1,50 @@
+import { expect, test } from 'vitest';
+import { downloadCompare, filterStats } from '../stats.js';
+const stats = [
+    {
+        version: { major: 3 },
+        versionString: '3.x',
+        downloads: 100,
+    },
+    {
+        version: { major: 2 },
+        versionString: '2.x',
+        downloads: 300,
+    },
+    {
+        version: { major: 1 },
+        versionString: '1.x',
+        downloads: 200,
+    },
+];
+test('filterStats keeps top downloads in version order by default', () => {
+    expect(filterStats(stats, {
+        totalDownloads: 600,
+        top: 2,
+    }).map((stat) => stat.versionString)).toEqual(['2.x', '1.x']);
+});
+test('downloadCompare sorts by downloads descending', () => {
+    expect([...stats].sort(downloadCompare).map((stat) => stat.versionString)).toEqual([
+        '2.x',
+        '1.x',
+        '3.x',
+    ]);
+});
+test('downloadCompare falls back to version order for ties', () => {
+    const tiedStats = [
+        {
+            version: { major: 1 },
+            versionString: '1.x',
+            downloads: 100,
+        },
+        {
+            version: { major: 2 },
+            versionString: '2.x',
+            downloads: 100,
+        },
+    ];
+    expect([...tiedStats].sort(downloadCompare).map((stat) => stat.versionString)).toEqual([
+        '2.x',
+        '1.x',
+    ]);
+});

package/dist/cli-options.js

@@ -12,6 +12,7 @@ Options:
   ${colorOption('--major')}               Group by major version
   ${colorOption('--minor')}               Group by minor version
   ${colorOption('--patch')}               Group by patch version
+  ${colorOption('--sort')} <order>        Sort results by version or downloads
   ${colorOption('-t, --top')} <number>    Show top <number> most downloaded versions
   ${colorOption('-a, --all')}             Include all versions in output, even those with minimal downloads
   ${colorOption('-c, --color')} <scheme>  ${wrapOption(`Choose color scheme from: ${COLOR_SCHEMES.sort().join(', ')}`, 50, 24)}
@@ -48,6 +49,7 @@ function wrapOption(text, maxLength, indent) {
 export function showHelp() {
     console.log(redent(HELP, 2));
 }
+const SORT_ORDERS = ['version', 'downloads'];
 export function parseCliOptions(argv) {
     const cli = meow(HELP, {
         argv: argv.slice(2),
@@ -69,6 +71,10 @@ export function parseCliOptions(argv) {
             patch: {
                 type: 'boolean',
             },
+            sort: {
+                type: 'string',
+                choices: [...SORT_ORDERS],
+            },
             top: {
                 shortFlag: 't',
                 type: 'number',
@@ -100,10 +106,17 @@ export function parseCliOptions(argv) {
                     ? 'patch'
                     : undefined,
         top: cli.flags.top,
+        sort: coalesceSortOrder(cli.flags.sort) ?? 'version',
         all: cli.flags.all ?? false,
         color: coalesceColor(cli.flags.color ?? process.env.PKG_STATS_COLOR_SCHEME) ?? getColorOfDay(),
     };
 }
+function coalesceSortOrder(sort) {
+    if (sort && SORT_ORDERS.includes(sort)) {
+        return sort;
+    }
+    return undefined;
+}
 function coalesceColor(color) {
     if (color && COLOR_SCHEMES.includes(color)) {
         return color;

package/dist/mode/package-stats.js

@@ -3,7 +3,7 @@ import { getPrimaryColor } from '../colors.js';
 import { formatPercentage } from '../format.js';
 import { fetchNpmLastWeekDownloads } from '../npm-api.js';
 import { printChart } from '../output.js';
-import { filterStats, groupStats } from '../stats.js';
+import { downloadCompare, filterStats, groupStats } from '../stats.js';
 import { parseVersion, versionCompare } from '../version.js';
 export async function printPackageStats(packageName, options) {
     let data;
@@ -29,11 +29,14 @@ export async function printPackageStats(packageName, options) {
         .sort(versionCompare);
     const { type, stats } = groupStats(npmStats, options.group);
     const totalDownloads = Object.values(stats).reduce((sum, version) => sum + version.downloads, 0);
-    const statsToDisplay = filterStats(stats, {
+    const filteredStats = filterStats(stats, {
         totalDownloads,
         all: options.all,
         top: options.top,
     });
+    const statsToDisplay = options.sort === 'downloads'
+        ? [...filteredStats].sort(downloadCompare)
+        : filteredStats;
     const downloadToDisplay = statsToDisplay.reduce((sum, version) => sum + version.downloads, 0);
     if (totalDownloads - downloadToDisplay > 0) {
         statsToDisplay.push({

package/dist/stats.js

@@ -81,7 +81,11 @@ export function filterStats(stats, options) {
     return filtered;
 }
 function pickTopStats(stats, top) {
-    const sortedStats = stats.sort((a, b) => b.downloads - a.downloads);
+    const sortedStats = [...stats].sort((a, b) => b.downloads - a.downloads);
     const topStats = sortedStats.slice(0, top);
     return topStats.sort((a, b) => versionCompare(a.version, b.version));
 }
+export function downloadCompare(a, b) {
+    const downloadDifference = b.downloads - a.downloads;
+    return downloadDifference === 0 ? versionCompare(a.version, b.version) : downloadDifference;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pkg-stats",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Beautiful NPM package download stats",
   "license": "MIT",
   "repository": {
@@ -24,6 +24,9 @@
   "bin": {
     "pkg-stats": "./bin.js"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "tsc",
     "test": "vitest",
@@ -33,22 +36,22 @@
     "validate": "pnpm lint && pnpm typecheck && pnpm test -- --no-watch"
   },
   "dependencies": {
-    "chalk": "^5.4.1",
-    "meow": "^13.2.0",
+    "chalk": "^5.6.2",
+    "meow": "^14.1.0",
     "redent": "^4.0.0",
-    "tinygradient": "^1.1.5"
+    "tinygradient": "^2.0.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.18.0",
-    "@release-it/conventional-changelog": "^10.0.0",
-    "@types/node": "^22.10.5",
-    "eslint": "^9.18.0",
+    "@eslint/js": "^9.39.4",
+    "@release-it/conventional-changelog": "^11.0.1",
+    "@types/node": "^22.19.20",
+    "eslint": "^9.39.4",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "globals": "^15.14.0",
-    "release-it": "^18.1.1",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.19.1",
-    "vitest": "^2.1.8"
+    "globals": "^15.15.0",
+    "release-it": "^20.2.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.61.0",
+    "vitest": "^2.1.9"
   },
-  "packageManager": "pnpm@9.15.3+sha512.1f79bc245a66eb0b07c5d4d83131240774642caaa86ef7d0434ab47c0d16f66b04e21e0c086eb61e62c77efc4d7f7ec071afad3796af64892fae66509173893a"
+  "packageManager": "pnpm@11.5.3+sha512.7ac1c919341c213a34dc0d02afb7143c5c26ac26ee8c4782deea821b8ac64d2134a081fd8941dae6e29bbb48f58dfc2b7fbceeccc07cb2f09d219d342a4969ed"
 }