Repository navigation
feat: add npm column type (41st) - #35
Merged
Merged
Conversation
41st column type. News & web cluster 7 → 8. Fills the package-registry
discovery gap — minitor's audience is predominantly TypeScript/JS
developers (aeon, minitor, and most active forks are all TS repos),
and npm is the canonical discovery surface for that audience.
- lib/columns/plugins/npm/plugin.ts: schema with two fields (query
required, mode oneof popularity/quality/maintenance/combined). Icon
Package from lucide-react. Accent #CB3837 (npm registry red).
Category news (alongside lobsters/stack-overflow/devto, the other
developer-content surfaces). Capabilities: paginated.
- lib/columns/plugins/npm/server.ts: ServerFetcher → fetchNpmPage with
PAGE_SIZE cursor-pagination.
- lib/columns/plugins/npm/client.tsx: ConfigForm (query input + sort
select with help text); ItemRenderer (npm pill, version, deprecated
badge with AlertTriangle warning, mono-titled package name, keyword
pills, weekly-downloads with Download icon + /wk suffix, overall
score + Q/P/M score-detail pills).
- lib/integrations/npm.ts: keyless npm REST APIs (registry.npmjs.org
/-/v1/search for discovery, api.npmjs.org/downloads/point/last-week
for the /wk badge). Three integration quirks: (1) weights for the
four sort modes are heavy-weighted 0.8 on the chosen axis with 0.1
split across the other two — preserves cross-axis signal without
zombie-package risk; (2) downloads endpoint rejects %2F-encoded
scoped names, so /downloads/point/last-week/{name} is built with
the raw / preserved; (3) downloads fetched in parallel per page,
failures degrade silently to 0 so a single dead row doesn't kill
the column.
- Three registry edits (manifest.ts, registry.ts, server-registry.ts).
- README: column count 40 → 41, News & web cluster row 7 → 8, hero
paragraph picks up 'npm packages', keyless-columns list adds npm.
Built autonomously by Aeon from May-10 repo-actions idea #5.
Merged
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
41st minitor column type. Surfaces trending and high-signal npm packages — ranked by popularity, quality, maintenance, or a combined blend; scoped via search query. Keyless. The package row shows version, weekly downloads, deprecated badge when applicable, keyword pills, and Q/P/M score detail from npm's own ranking model.
Why
minitor's audience is predominantly TypeScript/JavaScript developers — aeon, minitor itself, and most active forks are all TS repos — and npm is the canonical discovery surface for that audience. The News & web cluster already has
lobsters,stack-overflow, anddevtofor developer content; annpmcolumn closes the gap on package-registry discovery. Natural fit alongsidedevto(also developer-content-focused, landed May-10). Sourced from May-10 repo-actions idea #5.Changes
lib/columns/plugins/npm/plugin.ts: schema with two fields (query required, mode oneof popularity / quality / maintenance / combined). IconPackagefrom lucide-react. Accent#CB3837(npm registry red). Categorynews. Capabilities: paginated.lib/columns/plugins/npm/server.ts:ServerFetcher→fetchNpmPagewith PAGE_SIZE cursor-pagination.lib/columns/plugins/npm/client.tsx: ConfigForm (query input + sort select with help text) and ItemRenderer (npm pill, version, deprecated badge withAlertTrianglewarning, mono-titled package name, keyword pills, weekly-downloads withDownloadicon +/wksuffix, overall score + Q/P/M score-detail pills).lib/integrations/npm.ts: keyless npm REST APIs (registry.npmjs.org/-/v1/searchfor discovery,api.npmjs.org/downloads/point/last-weekfor the/wkbadge). Three integration quirks: (1) weights for the four sort modes are heavy-weighted0.8on the chosen axis with0.1split across the other two — preserves cross-axis signal without zombie-package risk; (2) downloads endpoint rejects%2F-encoded scoped names, so/downloads/point/last-week/{name}is built with the raw/preserved; (3) downloads fetched in parallel per page, failures degrade silently to0so a single dead row doesn't kill the column.manifest.ts,registry.ts,server-registry.ts).README.md: column count 40 → 41, News & web cluster row 7 → 8, hero paragraph picks up "npm packages", keyless-columns list adds npm.Built autonomously by Aeon