github-search-cli 0.6.1 → 0.8.0

package/README.md

@@ -1,188 +1,145 @@
-# search-cli
-
-> The terminal home for GitHub discovery — search, trending, bookmarks, and deep-dive repo exploration, all without touching a browser.
-
-```bash
-npx github-search-cli    # TUI browser
-search-cli "language:Rust stars:>1000" --json   # CLI mode
-search-cli --version
-```
-
----
-
-## Features
-
-| Category | Features |
-|----------|----------|
-| **Search** | Free-text + qualifiers (`language:`, `stars:`, `topic:`, etc.), sort by stars/updated/forks, auto-complete on Tab |
-| **Trending** | Browse GitHub trending by day/week/month/year, language filter |
-| **Memory** | Persistent search history (`Ctrl+R`), bookmarks (`b`/`B`), saved searches (`Ctrl+S`/`Ctrl+O`), session restore |
-| **Deep-dive** | Per-repo detail: languages bar, top contributors, README preview (`d`) |
-| **Compare** | Select 2+ repos and compare side-by-side (`c`/`C`) |
-| **Explore** | Browse popular GitHub topics (`E`) |
-| **Export** | JSON, CSV, Markdown, plain text (`Ctrl+E`) |
-| **Shell** | Pipe-friendly `--json`/`--csv`/`--markdown`, `--format urls`, `--pipe open/clone`, `--watch`, shell completions |
-| **Delight** | 3 themes (Tokyo Night, Dracula, Monokai), animated status bar, notification center, clipboard share, startup tips |
-
----
-
-## Quick start
-
-```bash
-# Requires Bun (https://bun.sh)
-npm install -g github-search-cli
-# or: bun install -g github-search-cli
-
-# Launch the interactive TUI browser
-search-cli
-
-# Non-interactive search (pipe to jq, csvkit, etc.)
-search-cli "language:Rust stars:>10000" --json | jq '.[].fullName'
-search-cli "language:Zig" --count
-search-cli --trending --json --since weekly
-```
-
----
-
-## TUI keyboard shortcuts
-
-### Main view
-
-| Key | Action |
-|-----|--------|
-| `/` | Focus search input |
-| `Enter` | Execute search / open repo |
-| `↑`/`↓` / `j`/`k` | Navigate results |
-| `t` | Toggle search / trending |
-| `s` | Cycle sort |
-| `l` | Cycle limit |
-| `r` | Refresh |
-| `g` | Toggle activity graph |
-| `d` | Toggle repo deep-dive |
-| `o` | Open repo in browser |
-| `b` / `B` | Toggle bookmark / open bookmarks |
-| `c` / `C` | Toggle compare list / show comparison |
-| `E` | Open topic explorer |
-| `Tab` | Auto-complete qualifier |
-| `?` / `Ctrl+H` | Help overlay |
-| `q` | Quit |
-
-### Overlays
-
-| Key | Action |
-|-----|--------|
-| `Ctrl+R` | Search history |
-| `Ctrl+S` | Save current search |
-| `Ctrl+O` | Saved searches panel |
-| `Ctrl+E` | Export results |
-| `Ctrl+N` | Notifications |
-| `Ctrl+P` | Share repo (copy to clipboard) |
-| `PageDown` / `Ctrl+F` | Next page |
-| `Esc` | Close overlay |
-
-### Trending mode
-
-| Key | Action |
-|-----|--------|
-| `1`–`5` | Switch tab (Today → Week → Month → Year → All) |
-| `←`/`→` / `h`/`l` | Navigate tabs |
-
----
-
-## Search syntax
-
-```
-language:Rust stars:>1000 topic:cli
-"machine learning" language:Python stars:>5000
-topic:cli -language:JavaScript
-org:rust-lang language:Rust
-```
-
-Supported qualifiers: `language:`, `stars:`, `fork:`, `archived:`, `topic:`, `user:`, `org:`, `repo:`, `updated:`, `pushed:`, `visibility:`, `license:`, `created:`, `size:`, `in:`. Prefix with `-` to exclude.
-
----
-
-## CLI modes (non-interactive)
-
-```bash
-search-cli "query" --json              # JSON array
-search-cli "query" --csv               # CSV
-search-cli "query" --markdown          # Markdown table
-search-cli "query" --count             # Just the number
-search-cli "query" --format urls       # One URL per line
-search-cli "query" --pipe open         # Open each in browser
-search-cli "query" --pipe clone        # Print clone commands
-search-cli --trending --json           # Trending as JSON
-search-cli --watch "query"             # Poll every 300s
-```
-
-### Shell completions
-
-```bash
-source <(search-cli --completion bash)   # Bash
-source <(search-cli --completion zsh)    # Zsh
-search-cli --completion fish | source    # Fish
-```
-
-### `gh` extension
-
-```bash
-gh extension install ./gh-search-cli
-gh search-cli "language:Rust"
-```
-
----
-
-## Configuration
-
-`~/.config/search-cli/config.json` (created automatically):
-
-```json
-{
-  "defaultSort": "stars",
-  "defaultLimit": 50,
-  "theme": "tokyo-night",
-  "githubToken": "ghp_..."
-}
-```
-
-Or run `search-cli init` for the interactive setup wizard.
-
-Environment variables: `GITHUB_TOKEN`, `SEARCH_CLI_CONFIG`, `XDG_CONFIG_HOME`, `XDG_STATE_HOME`.
-
----
-
-## Design
-
-```
-CLI → QueryBuilder → Provider → Normalizer → Ranking → TUI / stdout
-```
-
-| Layer | File | Job |
-|-------|------|-----|
-| Entry | `src/cli.ts` | Arg parsing, routes to TUI or stdout |
-| TUI | `src/tui.ts` | Interactive browser (OpenTUI) |
-| Query | `src/query.ts` | Parse keywords/qualifiers |
-| Provider | `src/provider.ts` | GitHub REST API with caching + token rotation |
-| Types | `src/types.ts` | Shared interfaces |
-
-The `SearchProvider` interface is the extension point for alternative backends (GitLab, local index, AI retriever).
-
----
-
-## Install from source
-
-```bash
-git clone https://github.com/codersdfs/search-cli.git
-cd search-cli
-bun install
-bun start              # Launch TUI
-bun test               # 104 tests
-bun run build          # Compile binary → dist/
-```
-
----
-
-## License
-
-MIT
+# ghfind
+
+> Search GitHub repos from your terminal. No browser needed.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/codersdfs/search-cli/main/demo.svg" alt="ghfind demo" width="100%">
+</p>
+
+---
+
+## Install
+
+```bash
+npm install -g github-search-cli
+```
+
+## Use
+
+```bash
+# TUI
+ghfind
+
+# pipe
+ghfind "language:Rust stars:>1000" --json | jq '.[].fullName'
+ghfind "language:Zig" --count
+ghfind --trending --json --since weekly
+```
+
+### Non-interactive
+
+```bash
+ghfind "query" --json        # JSON
+ghfind "query" --csv         # CSV
+ghfind "query" --markdown    # Markdown
+ghfind "query" --count       # count only
+ghfind "query" --format urls # one URL per line
+ghfind "query" --pipe open   # open in browser
+ghfind "query" --pipe clone  # clone commands
+ghfind --trending --json     # trending as JSON
+ghfind --watch "query"       # poll every 300s
+```
+
+### Completions
+
+```bash
+source <(ghfind --completion bash)
+source <(ghfind --completion zsh)
+ghfind --completion fish | source
+```
+
+---
+
+## Features
+
+<table>
+<tr><td><b>Search</b></td><td>Free-text + qualifiers (<code>language:</code>, <code>stars:</code>, <code>topic:</code>), sort by stars/updated/forks</td></tr>
+<tr><td><b>Trending</b></td><td>Today, week, month, year — filter by language</td></tr>
+<tr><td><b>Bookmarks</b></td><td><code>b</code> / <code>B</code> — save repos, tag them</td></tr>
+<tr><td><b>Deep-dive</b></td><td><code>d</code> — languages, contributors, README, activity chart</td></tr>
+<tr><td><b>Compare</b></td><td><code>c</code> / <code>C</code> — side-by-side, select 2+ repos</td></tr>
+<tr><td><b>Explore</b></td><td><code>E</code> — browse popular topics</td></tr>
+<tr><td><b>History</b></td><td><code>Ctrl+R</code> — recall past searches</td></tr>
+<tr><td><b>Export</b></td><td><code>Ctrl+E</code> — JSON, CSV, Markdown to file</td></tr>
+<tr><td><b>Share</b></td><td><code>Ctrl+P</code> — copy to clipboard (markdown, plain, gh-cli)</td></tr>
+<tr><td><b>Watch</b></td><td><code>--watch</code> — poll for new results</td></tr>
+</table>
+
+<details>
+<summary>Keybindings</summary>
+
+| Key | Action |
+|-----|--------|
+| `/` | Focus search |
+| `Enter` | Search / open repo |
+| `↑`/`↓` / `j`/`k` | Navigate |
+| `t` | Toggle search / trending |
+| `s` | Cycle sort |
+| `l` | Cycle limit |
+| `r` | Refresh |
+| `d` | Deep-dive |
+| `o` | Open in browser |
+| `b` / `B` | Bookmark / bookmarks panel |
+| `c` / `C` | Compare select / view |
+| `E` | Topic explorer |
+| `Tab` | Auto-complete qualifier |
+| `?` / `Ctrl+H` | Help |
+| `Ctrl+R` | History |
+| `Ctrl+S` / `Ctrl+O` | Save / open searches |
+| `Ctrl+E` | Export |
+| `Ctrl+N` | Notifications |
+| `Ctrl+P` | Share |
+| `Esc` | Close overlay |
+| `q` | Quit |
+
+Trending tabs: `1`–`5` (Today → All) or `←`/`→` / `h`/`l`
+</details>
+
+---
+
+## Search syntax
+
+```
+language:Rust stars:>1000 topic:cli
+"machine learning" language:Python stars:>5000
+topic:cli -language:JavaScript
+org:rust-lang language:Rust
+```
+
+Prefix with `-` to exclude. Supported: `language`, `stars`, `fork`, `archived`, `topic`, `user`, `org`, `repo`, `updated`, `pushed`, `visibility`, `license`, `created`, `size`, `in`.
+
+---
+
+## Config
+
+`~/.config/ghfind/config.json` (auto-created, or run `ghfind init`):
+
+```json
+{
+  "defaultSort": "stars",
+  "defaultLimit": 50,
+  "theme": "tokyo-night",
+  "githubToken": "ghp_..."
+}
+```
+
+Env: `GITHUB_TOKEN`, `GHFIND_CONFIG`, `XDG_CONFIG_HOME`, `XDG_STATE_HOME`
+
+---
+
+## From source
+
+```bash
+git clone https://github.com/codersdfs/search-cli.git
+cd ghfind
+npm install
+npm start    # TUI
+npm test     # 100+ tests
+npm run build
+```
+
+---
+
+## License
+
+MIT

package/bin/ghfind.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * ghfind — npm bin entry point.
+ * Requires Node.js >= 20.
+ */
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+try {
+  await import("../src/cli.ts");
+} catch (err) {
+  console.error("Failed to start ghfind. Node.js >= 20 required.");
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+}

package/completions/{search-cli.bash → ghfind.bash}

@@ -1,7 +1,7 @@
-# search-cli bash completion
-# Source: source <(search-cli --completion bash)
+# ghfind bash completion
+# Source: source <(ghfind --completion bash)
 
-_search_cli() {
+_ghfind() {
   local cur prev opts
   COMPREPLY=()
   cur="${COMP_WORDS[COMP_CWORD]}"
@@ -40,4 +40,4 @@ _search_cli() {
   COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
   return 0
 }
-complete -F _search_cli search-cli
+complete -F _ghfind ghfind

package/completions/ghfind.fish

@@ -0,0 +1,19 @@
+# ghfind fish completion
+# Source: source (ghfind --completion fish | psub)
+
+complete -c ghfind -l json -d "JSON output"
+complete -c ghfind -l csv -d "CSV output"
+complete -c ghfind -l markdown -d "Markdown table output"
+complete -c ghfind -l count -d "Only result count"
+complete -c ghfind -l limit -d "Max results" -r
+complete -c ghfind -l sort -d "Sort strategy" -r -f -a "best-match stars updated forks"
+complete -c ghfind -l token -d "GitHub token" -r
+complete -c ghfind -l trending -d "Trending mode"
+complete -c ghfind -l since -d "Trending period" -r -f -a "daily weekly monthly"
+complete -c ghfind -l pipe -d "Pipe target" -r -f -a "clone open"
+complete -c ghfind -l format -d "Output format" -r -f -a "urls names ssh-urls clone-commands ids"
+complete -c ghfind -l watch -d "Watch mode"
+complete -c ghfind -l interval -d "Watch interval seconds" -r
+complete -c ghfind -l version -d "Print version"
+complete -c ghfind -l help -d "Print help"
+complete -c ghfind -l completion -d "Shell" -r -f -a "bash zsh fish"

package/completions/{search-cli.zsh → ghfind.zsh}

@@ -1,27 +1,27 @@
-# search-cli zsh completion
-# Source: source <(search-cli --completion zsh)
-
-_search_cli() {
-  local -a opts
-  opts=(
-    '--json[JSON output]'
-    '--csv[CSV output]'
-    '--markdown[Markdown table output]'
-    '--count[Only result count]'
-    '--limit[Max results]:limit:'
-    '--sort[Sort strategy]:(best-match stars updated forks)'
-    '--token[GitHub token]:token:'
-    '--trending[Trending mode]'
-    '--since[Trending period]:(daily weekly monthly)'
-    '--pipe[Pipe target]:(clone open)'
-    '--format[Output format]:(urls names ssh-urls clone-commands ids)'
-    '--watch[Watch mode]'
-    '--interval[Watch interval seconds]:seconds:'
-    '--version[Print version]'
-    '--help[Print help]'
-    '--completion[Shell]:(bash zsh fish)'
-  )
-  _arguments "${opts[@]}" '*:query:'
-}
-
-compdef _search_cli search-cli
+# ghfind zsh completion
+# Source: source <(ghfind --completion zsh)
+
+_ghfind() {
+  local -a opts
+  opts=(
+    '--json[JSON output]'
+    '--csv[CSV output]'
+    '--markdown[Markdown table output]'
+    '--count[Only result count]'
+    '--limit[Max results]:limit:'
+    '--sort[Sort strategy]:(best-match stars updated forks)'
+    '--token[GitHub token]:token:'
+    '--trending[Trending mode]'
+    '--since[Trending period]:(daily weekly monthly)'
+    '--pipe[Pipe target]:(clone open)'
+    '--format[Output format]:(urls names ssh-urls clone-commands ids)'
+    '--watch[Watch mode]'
+    '--interval[Watch interval seconds]:seconds:'
+    '--version[Print version]'
+    '--help[Print help]'
+    '--completion[Shell]:(bash zsh fish)'
+  )
+  _arguments "${opts[@]}" '*:query:'
+}
+
+compdef _ghfind ghfind

package/demo.svg

@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 803" width="900" height="803">
+  <defs>
+    <style>
+      @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&amp;display=swap');
+    </style>
+    <filter id="shadow" x="-5%" y="-5%" width="115%" height="115%">
+      <feDropShadow dx="0" dy="4" stdDeviation="8" flood-color="#000" flood-opacity="0.4"/>
+    </filter>
+  </defs>
+
+  <rect width="100%" height="100%" fill="#0d0d1a"/>
+
+  <!-- Window -->
+  <rect x="12" y="10" width="876" height="783" fill="#1e1e2e" rx="8" filter="url(#shadow)"/>
+  <rect x="12" y="10" width="876" height="36" fill="#181825" rx="8"/>
+  <rect x="12" y="46" width="876" height="2" fill="#313244"/>
+
+  <!-- Traffic lights -->
+  <circle cx="24" cy="28" r="5" fill="#f38ba8"/>
+  <circle cx="42" cy="28" r="5" fill="#f9e2af"/>
+  <circle cx="60" cy="28" r="5" fill="#a6e3a1"/>
+  <text x="450" y="34" fill="#6c7086" font-family="'JetBrains Mono','Fira Code',monospace" font-size="13" text-anchor="middle">search-cli — terminal GitHub browser</text>
+
+  <g font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">
+    <text x="14" y="62" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">search-cli — GitHub repo browser   [t]rending  [/]search  [g]raph  [r]efresh  [q]uit</text>
+<rect x="14" y="69" width="860" height="54.5" fill="#1e1e2e" stroke="#89b4fa" stroke-width="1" rx="3"/>
+<text x="22" y="88" fill="#89b4fa" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">&gt; language:TypeScript stars:&gt;1000</text>
+<text x="14" y="150.2" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">sort: stars   limit: 50   (s=cycle sort  l=cycle limit)</text>
+<rect x="14" y="159.3" width="432" height="378" fill="#1e1e2e" stroke="#45475a" stroke-width="1" rx="3"/>
+<text x="22" y="177.5" fill="#89b4fa" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14"> Results </text>
+<rect x="18" y="178.20000000000002" width="424" height="20" fill="#2d5bcf" rx="3"/>
+<text x="24" y="198.5" fill="#ffffff" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">shadcn/ui  ★ 78.5k</text>
+<text x="24" y="221.6" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">vercel/next.js  ★ 129k</text>
+<text x="24" y="244.7" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">tailwindlabs/tailwindcss  ★ 84.2k</text>
+<text x="24" y="267.8" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">tauri-apps/tauri  ★ 84.1k</text>
+<text x="24" y="290.9" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">oven-sh/bun  ★ 74.5k</text>
+<text x="24" y="314" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">n8n-io/n8n  ★ 54.4k</text>
+<text x="24" y="337.1" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">astral-sh/ruff  ★ 36.1k</text>
+<text x="24" y="360.20000000000005" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">missive/emoji-mart  ★ 8.8k</text>
+<text x="24" y="383.3" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">sharkdp/bat  ★ 50.3k</text>
+<text x="24" y="406.4" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">BurntSushi/ripgrep  ★ 48.8k</text>
+<text x="24" y="429.5" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">jdx/mise  ★ 14.3k</text>
+<text x="24" y="452.6" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">nektos/act  ★ 56.1k</text>
+<text x="24" y="475.70000000000005" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">astral-sh/uv  ★ 40.2k</text>
+<text x="24" y="498.8" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">zed-industries/zed  ★ 52k</text>
+<rect x="450" y="159.3" width="432" height="378" fill="#1e1e2e" stroke="#45475a" stroke-width="1" rx="3"/>
+<text x="456" y="177.5" fill="#a6e3a1" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14"> Details </text>
+<text x="458" y="198.5" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Name     shadcn/ui</text>
+<text x="458" y="221.6" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Stars    78,500</text>
+<text x="458" y="244.7" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Forks    4,200</text>
+<text x="458" y="267.8" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Lang     TypeScript</text>
+<text x="458" y="290.9" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Updated  2026-07-12</text>
+<text x="458" y="314" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Topics   react, ui, components, shadcn</text>
+<text x="458" y="360.20000000000005" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Beautifully designed components built with Radix UI and</text>
+<text x="458" y="383.3" fill="#cdd6f4" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">Tailwind CSS.</text>
+<text x="458" y="429.5" fill="#89b4fa" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">https://github.com/shadcn/ui</text>
+<rect x="14" y="489" width="860" height="25" fill="#181825" rx="3"/>
+<rect x="14" y="489" width="860" height="2" fill="#45475a"/>
+<text x="18" y="521.9" fill="#6c7086" font-family="'JetBrains Mono','Fira Code','Cascadia Code',monospace" font-size="14">15,842 results  (↑↓ nav  Enter open  o browser  Ctrl+R history)</text>
+<rect x="338.79999999999995" y="70" width="5.76" height="16" fill="#89b4fa" opacity="0.8">
+  <animate attributeName="opacity" values="0.8;0.1;0.8" dur="1s" repeatCount="indefinite"/>
+</rect>
+
+  </g>
+</svg>

package/package.json

@@ -1,33 +1,42 @@
 {
   "name": "github-search-cli",
-  "version": "0.6.1",
-  "description": "Terminal-native GitHub browser — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
+  "version": "0.8.0",
+  "description": "Terminal-native GitHub search — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
   "type": "module",
   "bin": {
-    "search-cli": "bin/search-cli.js"
+    "ghfind": "bin/ghfind.js"
   },
   "files": [
     "bin/",
     "src/",
     "completions/",
+    "demo.svg",
     "LICENSE",
     "README.md"
   ],
   "scripts": {
     "start": "bun run src/cli.ts",
-    "build": "bun run scripts/build.ts",
-    "prepublishOnly": "bun run build",
-    "test": "bun test",
-    "dev": "bun run --watch src/tui.ts"
+    "build": "tsup src/cli.ts --format esm --target node20 --out-dir dist --external @opentui/core",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "dev": "bun run --watch src/tui.ts",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
   },
   "dependencies": {
     "@opentui/core": "^0.4.3"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "@types/node": "^20.0.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
   },
   "engines": {
-    "bun": ">=1.0"
+    "node": ">=20.0.0"
   },
   "repository": {
     "type": "git",