terminfo.dev 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminfo.dev",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Test your terminal's feature support and contribute to terminfo.dev",
   "keywords": [
     "ansi",

package/src/index.ts

@@ -13,11 +13,42 @@
  * ```
  */
 
+import { readFileSync } from "node:fs"
+import { dirname, join } from "node:path"
+import { fileURLToPath } from "node:url"
 import { detectTerminal } from "./detect.ts"
 import { ALL_PROBES } from "./probes/index.ts"
 import { withRawMode } from "./tty.ts"
 import { submitResults } from "./submit.ts"
 
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+/** Load feature slugs from features.json for OSC 8 hyperlinks */
+function loadFeatureSlugs(): Record<string, string> {
+  // Try repo-local path first, then npm-installed path
+  const candidates = [
+    join(__dirname, "..", "..", "features.json"),       // repo: cli/src/ -> features.json
+    join(__dirname, "..", "..", "..", "features.json"),  // npm: node_modules/terminfo.dev/src/ -> features.json
+  ]
+  for (const path of candidates) {
+    try {
+      const raw = JSON.parse(readFileSync(path, "utf-8"))
+      delete raw.$comment
+      const slugs: Record<string, string> = {}
+      for (const [id, entry] of Object.entries(raw) as [string, any][]) {
+        slugs[id] = entry.slug ?? id.replaceAll(".", "-")
+      }
+      return slugs
+    } catch {}
+  }
+  return {} // fallback: featureSlug() will use id.replaceAll(".", "-")
+}
+
+/** OSC 8 hyperlink — clickable link in supporting terminals */
+function link(url: string, text: string): string {
+  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`
+}
+
 interface ResultEntry {
   terminal: string
   terminalVersion: string
@@ -39,11 +70,16 @@ async function main() {
   const terminal = detectTerminal()
 
   if (!jsonMode) {
-    console.log(`\x1b[1mterminfo\x1b[0m — terminal feature testing for terminfo.dev\n`)
-    console.log(
-      `Detected: \x1b[1m${terminal.name}\x1b[0m${terminal.version ? ` ${terminal.version}` : ""} on ${terminal.os}${terminal.osVersion ? ` ${terminal.osVersion}` : ""}`,
-    )
-    console.log(`Running ${ALL_PROBES.length} probes...\n`)
+    console.log(`\x1b[1mterminfo.dev\x1b[0m — can your terminal do that?\n`)
+    console.log(`  Terminal:  \x1b[1m${terminal.name}\x1b[0m${terminal.version ? ` ${terminal.version}` : ""}`)
+    console.log(`  Platform:  ${terminal.os}${terminal.osVersion ? ` ${terminal.osVersion}` : ""}`)
+    console.log(`  Probes:    ${ALL_PROBES.length} features across ${new Set(ALL_PROBES.map(p => p.id.split(".")[0])).size} categories`)
+    console.log(`  Website:   https://terminfo.dev`)
+    console.log(``)
+    console.log(`\x1b[2mResults are compared against ${ALL_PROBES.length} terminal features from the`)
+    console.log(`ECMA-48, VT100/VT510, xterm, and Kitty specifications.`)
+    console.log(`Run with --submit to contribute your results to the database.\x1b[0m\n`)
+    console.log(`Running probes...`)
   }
 
   const results: Record<string, boolean> = {}
@@ -101,7 +137,8 @@ async function main() {
   // Display results
   console.log(`\n\x1b[1mResults: ${passed}/${total} (${pct}%)\x1b[0m\n`)
 
-  // Show categories
+  // Show categories with OSC 8 hyperlinks
+  const slugs = loadFeatureSlugs()
   const categories = new Map<string, Array<{ id: string; name: string; pass: boolean; note?: string }>>()
   for (const probe of ALL_PROBES) {
     const cat = probe.id.split(".")[0]!
@@ -117,11 +154,15 @@ async function main() {
   for (const [cat, probes] of categories) {
     const catPassed = probes.filter((p) => p.pass).length
     const color = catPassed === probes.length ? "\x1b[32m" : catPassed > 0 ? "\x1b[33m" : "\x1b[31m"
-    console.log(`${color}${cat}\x1b[0m (${catPassed}/${probes.length})`)
+    const catLink = link(`https://terminfo.dev/${cat}`, cat)
+    console.log(`${color}${catLink}\x1b[0m (${catPassed}/${probes.length})`)
     for (const p of probes) {
       const icon = p.pass ? "\x1b[32m✓\x1b[0m" : "\x1b[31m✗\x1b[0m"
       const note = p.note ? ` \x1b[2m— ${p.note}\x1b[0m` : ""
-      console.log(`  ${icon} ${p.name}${note}`)
+      const slug = slugs[p.id] ?? p.id.replaceAll(".", "-")
+      const cat = p.id.split(".")[0]!
+      const featureLink = link(`https://terminfo.dev/${cat}/${slug}`, p.name)
+      console.log(`  ${icon} ${featureLink}${note}`)
     }
   }