feat: annotations

Author: jdx

README.md

@@ -68,3 +68,14 @@ cli.action.stop('custom message') // shows 'starting a process... custom message
 This degrades gracefully when not connected to a TTY. It queues up any writes to stdout/stderr so they are displayed above the spinner.
 
 ![action demo](assets/action.gif)
+
+# annotation
+
+Shows an iterm annotation
+
+```typescript
+// start the spinner
+cli.annotation('sometest', 'annotated with this text')
+```
+
+![annotation demo](assets/annotation.png)

assets/annotation.png

@@ -0,0 +1,3 @@
+import ux from '../src'
+
+ux.annotation('sometext', 'annotated with this text')

examples/annotation.ts

@@ -56,7 +56,17 @@ export const cli = {
     } else {
       this.log(uri)
     }
-  }
+  },
+
+  annotation(text: string, annotation: string) {
+    const supports = require('supports-hyperlinks')
+    if (supports.stdout) {
+      //\u001b]8;;https://google.com\u0007sometext\u001b]8;;\u0007
+      this.log(`\u001b]1337;AddAnnotation=${text.length}|${annotation}\u0007${text}`)
+    } else {
+      this.log(text)
+    }
+  },
 }
 export default cli
 

src/index.ts

@@ -4,8 +4,6 @@
     "forceConsistentCasingInFileNames": true,
     "importHelpers": true,
     "module": "commonjs",
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
     "outDir": "./lib",
     "pretty": true,
     "rootDirs": [