pkg-stats 0.5.0 → 0.6.0

package/dist/__tests__/output.test.js

@@ -1,7 +1,7 @@
 import { expect, test } from 'vitest';
 import { formatBar } from '../output.js';
 test('renderChart basic tests', () => {
-    expect(formatBar(0.0, { length: 10 })).toMatchInlineSnapshot(`"▏         "`);
-    expect(formatBar(0.5, { length: 10 })).toMatchInlineSnapshot(`"█████     "`);
-    expect(formatBar(1.0, { length: 10 })).toMatchInlineSnapshot(`"██████████"`);
+    expect(formatBar(0.0, { width: 10 })).toMatchInlineSnapshot(`"▏         "`);
+    expect(formatBar(0.5, { width: 10 })).toMatchInlineSnapshot(`"█████     "`);
+    expect(formatBar(1.0, { width: 10 })).toMatchInlineSnapshot(`"██████████"`);
 });

package/dist/cli-options.js

@@ -14,7 +14,6 @@ Options:
   ${colorOption('--patch')}               Group by patch version
   ${colorOption('-t, --top')} <number>    Show top <number> most downloaded versions
   ${colorOption('-a, --all')}             Include all versions in output, even those with minimal downloads
-  ${colorOption('-x, --extended')}        Show extended stats
   ${colorOption('-c, --color')} <scheme>  ${wrapOption(`Choose color scheme from: ${COLOR_SCHEMES.sort().join(', ')}`, 50, 24)}
 
 Examples:
@@ -78,10 +77,6 @@ export function parseCliOptions(argv) {
                 type: 'boolean',
                 shortFlag: 'a',
             },
-            extended: {
-                type: 'boolean',
-                shortFlag: 'x',
-            },
             color: {
                 shortFlag: 'c',
                 type: 'string',
@@ -106,8 +101,7 @@ export function parseCliOptions(argv) {
                     : undefined,
         top: cli.flags.top,
         all: cli.flags.all ?? false,
-        extended: cli.flags.extended ?? false,
-        color: coalesceColor(cli.flags.color) ?? getColorOfDay(),
+        color: coalesceColor(cli.flags.color ?? process.env.PKG_STATS_COLOR_SCHEME) ?? getColorOfDay(),
     };
 }
 function coalesceColor(color) {

package/dist/mode/compare-packages.js

@@ -16,7 +16,7 @@ export async function comparePackages(packageNames, options) {
     const items = packagesToDisplay.map((item) => ({
         label: item.packageName,
         value: item.downloads,
-        extended: options.extended ? formatPercentage(item.downloads / maxDownloads) : undefined,
+        extra: formatPercentage(item.downloads / maxDownloads),
     }));
     printChart(items, {
         colorScheme: options.color,

package/dist/mode/package-stats.js

@@ -48,7 +48,7 @@ export async function printPackageStats(packageName, options) {
     const items = statsToDisplay.map((item) => ({
         label: item.versionString,
         value: item.downloads,
-        extended: options.extended ? formatPercentage(item.downloads / totalDownloads) : undefined,
+        extra: formatPercentage(item.downloads / totalDownloads),
     }));
     printChart(items, {
         colorScheme: options.color,

package/dist/output.js

@@ -5,24 +5,29 @@ export function printChart(items, options) {
     const maxLabelLength = Math.max(...items.map((item) => item.label.length));
     const maxValue = Math.max(...items.map((item) => item.value));
     const maxValueLength = formatDownloads(maxValue, maxValue).length;
-    const maxExtendedLength = Math.max(...items.map((item) => item.extended?.length ?? 0));
+    const maxExtraLength = Math.max(...items.map((item) => item.extra?.length ?? 0));
     const colors = getColors(items.length, options.colorScheme);
     const indent = options.indent ?? 0;
+    const chartWidth = getTerminalWidth() - indent - maxLabelLength - maxValueLength - maxExtraLength - 5;
     items.forEach((item, i) => {
         const color = chalk.hex(colors[i]);
         const label = ' '.repeat(indent) + item.label.padStart(maxLabelLength);
-        const bar = formatBar(item.value / maxValue);
+        const bar = formatBar(item.value / maxValue, { width: clamp(chartWidth, 30, 60) });
         const value = formatDownloads(item.value, maxValue).padStart(maxValueLength);
-        const extended = item.extended
-            ? chalk.dim(` ${item.extended}`.padStart(maxExtendedLength + 1))
-            : '';
-        console.log(`${label} ${color(bar)} ${color(value)}${extended}`);
+        const extra = item.extra ? chalk.dim(` ${item.extra}`.padStart(maxExtraLength + 1)) : '';
+        console.log(`${label} ${color(bar)} ${color(value)}${extra}`);
     });
 }
-export function formatBar(value, { length = 50 } = {}) {
-    const filledChars = Math.round(value * length);
+export function formatBar(value, { width = 50 } = {}) {
+    const filledChars = Math.round(value * width);
     if (filledChars === 0) {
-        return '▏' + ' '.repeat(length - 1);
+        return '▏' + ' '.repeat(width - 1);
     }
-    return '█'.repeat(filledChars) + ' '.repeat(length - filledChars);
+    return '█'.repeat(filledChars) + ' '.repeat(width - filledChars);
+}
+export function getTerminalWidth() {
+    return process.stdout.columns;
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pkg-stats",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Beautiful NPM package download stats",
   "license": "MIT",
   "repository": {

package/dist/__tests__/output.js

@@ -1,8 +0,0 @@
-import { expect, test } from 'vitest';
-import { formatBar } from '../output.js';
-
-test('renderChart basic tests', () => {
-    expect(formatBar(0.0, { length: 10 })).toMatchInlineSnapshot(`"▏         "`);
-    expect(formatBar(0.5, { length: 10 })).toMatchInlineSnapshot(`"█████     "`);
-    expect(formatBar(1.0, { length: 10 })).toMatchInlineSnapshot(`"██████████"`);
-});

package/dist/chart.js

@@ -1,7 +0,0 @@
-export function renderChart(value, { length = 50 } = {}) {
-    const filledChars = Math.round(value * length);
-    if (filledChars === 0) {
-        return '▏' + ' '.repeat(length - 1);
-    }
-    return '█'.repeat(filledChars) + ' '.repeat(length - filledChars);
-}

package/dist/mode/package-details.js

@@ -1,57 +0,0 @@
-import chalk from 'chalk';
-import { renderChart } from '../chart.js';
-import { getColors } from '../colors.js';
-import { formatDownloads } from '../format.js';
-import { fetchNpmLastWeekDownloads } from '../npm-api.js';
-import { filterStats, groupStats } from '../stats.js';
-import { parseVersion, versionCompare } from '../version.js';
-export async function packageDetails(packageName, options) {
-    let data;
-    try {
-        data = await fetchNpmLastWeekDownloads(packageName);
-    }
-    catch (error) {
-        console.error(`Failed to fetch data for package "${packageName}"`, error);
-        return;
-    }
-    if (!Object.keys(data.downloads).length) {
-        console.error(`No data found for package "${packageName}".\n`);
-        process.exit(1);
-    }
-    const npmStats = Object.keys(data.downloads)
-        .map((versionString) => {
-        const version = parseVersion(versionString);
-        return {
-            ...version,
-            downloads: data.downloads[versionString],
-        };
-    })
-        .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, {
-        totalDownloads,
-        all: options.all,
-        top: options.top,
-    });
-    const colors = getColors(statsToDisplay.length, options.color);
-    const primaryColor = chalk.hex(colors[0]);
-    console.log(chalk.bold(`\nNPM weekly downloads for ${primaryColor(packageName)}\n`));
-    console.log(`Total: ${primaryColor(totalDownloads.toLocaleString())} last week\n`);
-    console.log(options.top ? `Top ${options.top} ${type} versions:\n` : `By ${type} version:\n`);
-    const maxDownloads = Math.max(...stats.map((v) => v.downloads));
-    const displayData = statsToDisplay.map((item) => {
-        const versionParts = item.versionString.split('.');
-        return {
-            version: versionParts.length < 3 ? `${item.versionString}.x` : item.versionString,
-            chart: renderChart(item.downloads / maxDownloads),
-            downloads: formatDownloads(item.downloads, maxDownloads),
-        };
-    });
-    const maxVersionLength = Math.max(...displayData.map((item) => item.version.length));
-    const maxDownloadsLength = Math.max(...displayData.map((item) => item.downloads.length));
-    displayData.forEach((item, i) => {
-        const color = chalk.hex(colors[i]);
-        console.log(`${item.version.padStart(2 + maxVersionLength)} ${color(item.chart)} ${color(item.downloads.padStart(maxDownloadsLength))}`);
-    });
-}

package/dist/mode/package-info.js

@@ -1,64 +0,0 @@
-import chalk from 'chalk';
-import { renderChart } from '../chart.js';
-import { getColors } from '../colors.js';
-import { formatDownloads } from '../format.js';
-import { fetchNpmLastWeekDownloads } from '../npm-api.js';
-import { filterStats, groupStats } from '../stats.js';
-import { parseVersion, versionCompare } from '../version.js';
-export async function fetchPackageInfo(packageName, options) {
-    const data = await fetchNpmLastWeekDownloads(packageName);
-    if (!Object.keys(data.downloads).length) {
-        throw new Error(`No data found for package "${packageName}".`);
-    }
-    const npmStats = Object.keys(data.downloads)
-        .map((versionString) => {
-        const version = parseVersion(versionString);
-        return {
-            ...version,
-            downloads: data.downloads[versionString],
-        };
-    })
-        .sort(versionCompare);
-    const { type, stats } = groupStats(npmStats, options.group);
-    const totalDownloads = Object.values(stats).reduce((sum, version) => sum + version.downloads, 0);
-    return {
-        name: packageName,
-        totalDownloads,
-        groupingType: type,
-        stats: stats.map((stat) => ({
-            version: stat.versionString,
-            downloads: stat.downloads,
-        })),
-    };
-}
-export function printPackageInfo({ name, stats, totalDownloads, groupingType }, options) {
-    const statsToDisplay = filterStats(stats, {
-        totalDownloads,
-        all: options.all,
-        top: options.top,
-    });
-    const colors = getColors(statsToDisplay.length, options.color);
-    const primaryColor = chalk.hex(colors[0]);
-    console.log(chalk.bold(`\nNPM weekly downloads for ${primaryColor(name)}\n`));
-    console.log(`Total: ${primaryColor(totalDownloads.toLocaleString())} last week\n`);
-    console.log(options.top
-        ? `Top ${options.top} ${groupingType} versions:\n`
-        : `By ${groupingType} version:\n`);
-    const maxDownloads = Math.max(...stats.map((v) => v.downloads));
-    const displayData = statsToDisplay.map((item) => {
-        const versionParts = item.version.split('.');
-        return {
-            version: versionParts.length < 3 ? `${item.version}.x` : item.version,
-            chart: renderChart(item.downloads / maxDownloads),
-            downloads: formatDownloads(item.downloads, maxDownloads),
-        };
-    });
-    const maxVersionLength = Math.max(...displayData.map((item) => item.version.length));
-    const maxDownloadsLength = Math.max(...displayData.map((item) => item.downloads.length));
-    displayData.forEach((item, i) => {
-        const color = chalk.hex(colors[i]);
-        console.log(`${item.version.padStart(2 + maxVersionLength)} ${color(item.chart)} ${color(item.downloads.padStart(maxDownloadsLength))}`);
-    });
-    console.log(chalk.bold(`\nNPM weekly downloads for ${chalk.green(name)}\n`));
-    console.log(`Total: ${chalk.green(totalDownloads.toLocaleString())} last week\n`);
-}

package/dist/mode/single-package.js

@@ -1,58 +0,0 @@
-import chalk from 'chalk';
-import { renderChart } from '../chart.js';
-import { getColors } from '../colors.js';
-import { formatDownloads } from '../format.js';
-import { fetchNpmLastWeekDownloads } from '../npm-api.js';
-import { filterStats, groupStats } from '../stats.js';
-import { parseVersion, versionCompare } from '../version.js';
-export async function singlePackage(packageName, options) {
-    let data;
-    try {
-        data = await fetchNpmLastWeekDownloads(packageName);
-    }
-    catch (error) {
-        console.error(`Failed to fetch data for package "${packageName}"`, error);
-        return;
-    }
-    if (!Object.keys(data.downloads).length) {
-        console.error(`No data found for package "${packageName}".\n`);
-        process.exit(1);
-    }
-    const npmStats = Object.keys(data.downloads)
-        .map((versionString) => {
-        const version = parseVersion(versionString);
-        return {
-            ...version,
-            downloads: data.downloads[versionString],
-        };
-    })
-        .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, {
-        totalDownloads,
-        all: options.all,
-        top: options.top,
-    });
-    const colors = getColors(statsToDisplay.length, options.color);
-    const primaryColor = chalk.hex(colors[0]);
-    console.log(chalk.bold(`\nNPM weekly downloads for ${primaryColor(packageName)}\n`));
-    console.log(`Total: ${primaryColor(totalDownloads.toLocaleString())} last week\n`);
-    console.log(options.top ? `Top ${options.top} ${type} versions:\n` : `By ${type} version:\n`);
-    const maxDownloads = Math.max(...stats.map((v) => v.downloads));
-    const displayData = statsToDisplay.map((item) => {
-        const versionParts = item.versionString.split('.');
-        return {
-            version: versionParts.length < 3 ? `${item.versionString}.x` : item.versionString,
-            chart: renderChart(item.downloads / maxDownloads),
-            downloads: formatDownloads(item.downloads, maxDownloads),
-        };
-    });
-    const maxVersionLength = Math.max(...displayData.map((item) => item.version.length));
-    const maxDownloadsLength = Math.max(...displayData.map((item) => item.downloads.length));
-    displayData.forEach((item, i) => {
-        const color = chalk.hex(colors[i]);
-        console.log(`${item.version.padStart(2 + maxVersionLength)} ${color(item.chart)} ${color(item.downloads.padStart(maxDownloadsLength))}`);
-    });
-    console.log('');
-}

package/dist/render.js

@@ -1,23 +0,0 @@
-import { style } from './style.js';
-export function renderChart(value) {
-    const filledValues = Math.round(value * style.chart.width * style.chart.pattern.length);
-    if (filledValues === 0) {
-        return '▏' + (style.rightLabel === 'align-right' ? ' '.repeat(style.chart.width - 1) : '');
-    }
-    const fullBlocks = Math.floor(filledValues / style.chart.pattern.length);
-    const partialBlock = filledValues % style.chart.pattern.length;
-    const hasPartialBlock = partialBlock > 0;
-    return (style.chart.pattern.at(-1).repeat(fullBlocks) +
-        (hasPartialBlock ? style.chart.pattern.at(partialBlock) : '') +
-        (style.rightLabel === 'align-right'
-            ? ' '.repeat(style.chart.width - fullBlocks - (hasPartialBlock ? 1 : 0))
-            : ''));
-}
-// export type RenderChartLineOptions = {
-//   value: number;
-//   leftLabel: string;
-//   rightLabel: string;
-// };
-// export function renderChartLine({ value, leftLabel, rightLabel }: RenderChartLineOptions) {
-//   return `${leftLabel}${renderChart(value)}${rightLabel}`;
-// }

package/dist/style.js

@@ -1,16 +0,0 @@
-export const style = {
-    chart: {
-        width: 50,
-        //pattern: ['⏹'],
-        //pattern: ['⏺'],
-        //pattern: ['█'],
-        //pattern: [' ', '▎', '▌', '▊', '█'],
-        //pattern: [' ', '▩'],
-        //pattern: [' ', '▰'],
-        //pattern: [' ', '∎'],
-        pattern: [' ', '█'],
-        //pattern: [' ', '▓'],
-        zeroPattern: '▏',
-    },
-    rightLabel: 'align-right',
-};

package/dist/types.js

@@ -1 +0,0 @@
-export {};