Skip to content

feat: add npm column type (41st) - #35

Merged
aaronjmars merged 1 commit into
mainfrom
feat/npm-column
May 12, 2026
Merged

aaronjmars merged 1 commit into
mainfrom
feat/npm-column

Conversation

@aaronjmars

Copy link
Copy Markdown
Collaborator

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, and devto for developer content; an npm column closes the gap on package-registry discovery. Natural fit alongside devto (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). Icon Package from lucide-react. Accent #CB3837 (npm registry red). Category news. 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) and 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.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

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.
@aaronjmars
aaronjmars merged commit 15c9c58 into main May 12, 2026
1 check passed
@aaronjmars
aaronjmars deleted the feat/npm-column branch May 12, 2026 12:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant