sitelens 0.1.0 → 0.1.1

package/README.md

@@ -6,7 +6,7 @@ A website audit anyone can understand. One command checks performance, SEO, acce
 npx sitelens
 ```
 
-On its own, sitelens asks for the report language, the website address and the audit mode; pick with the arrow keys. To skip the questions, give the address and options straight away:
+On its own, sitelens asks for the report language, the website address and the audit mode; pick with the arrow keys. When the report is ready, sitelens prints its full path and opens it when you press Enter. To skip the questions, give the address and options straight away:
 
 ```sh
 npx sitelens https://yourwebsite.com --lang en --out report.pdf

package/dist/cli.js

@@ -607,7 +607,7 @@ var require_boolbase = __commonJS({
 import { spawn, spawnSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname, join as join2, relative, resolve } from "node:path";
+import { dirname, join as join2, resolve } from "node:path";
 
 // ../collect-node/src/browser.ts
 import { existsSync } from "node:fs";
@@ -2364,10 +2364,10 @@ function compareDocumentPosition(nodeA, nodeB) {
 function uniqueSort(nodes) {
   nodes = nodes.filter((node, i, arr) => !arr.includes(node, i + 1));
   nodes.sort((a, b) => {
-    const relative2 = compareDocumentPosition(a, b);
-    if (relative2 & DocumentPosition.PRECEDING) {
+    const relative = compareDocumentPosition(a, b);
+    if (relative & DocumentPosition.PRECEDING) {
       return -1;
-    } else if (relative2 & DocumentPosition.FOLLOWING) {
+    } else if (relative & DocumentPosition.FOLLOWING) {
       return 1;
     }
     return 0;
@@ -7200,16 +7200,16 @@ var thresholds = {
   cls: { good: 0.1, poor: 0.25 },
   // Lab data has no INP; Total Blocking Time stands in for it with Lighthouse's own bands
   tbt: { good: 200, poor: 600 },
-  // TODO(verify): web.dev calls TTFB above 0.8 s "needs improvement"; confirm before 1.0
+  // web.dev calls TTFB above 0.8 s "needs improvement"
   ttfb: { poor: 800 },
-  // TODO(verify): page weight bands are a first guess
+  // No standard exists for page weight; these bands are the owner's call (25.10.2026)
   pageWeight: { minor: 3e6, important: 5e6 },
   // Savings worth reporting, in bytes and milliseconds
   imageSavings: 1e5,
   renderBlockingMs: 300,
   title: { min: 30, max: 60 },
   description: { max: 160 },
-  // TODO(verify): days before certificate expiry worth a warning
+  // ACME clients such as certbot renew 30 days before expiry, so under 14 days usually means renewal failed
   certificateWarningDays: 14,
   hstsMinMaxAge: 15552e3,
   thinTextLength: 300
@@ -12033,6 +12033,7 @@ Przyk\u0142ad:
   warnings: (count) => `${count} ${plural(count, ["element nie da\u0142 si\u0119 sprawdzi\u0107", "elementy nie da\u0142y si\u0119 sprawdzi\u0107", "element\xF3w nie da\u0142o si\u0119 sprawdzi\u0107"], "pl")}; szczeg\xF3\u0142y w za\u0142\u0105czniku raportu.`,
   failUnder: (score, limit) => `Wynik ${score} jest ni\u017Cszy ni\u017C wymagane ${limit} (--fail-under).`,
   optionLater: (flag) => `Opcja ${flag} b\u0119dzie dost\u0119pna w kolejnej wersji. Audyt dzia\u0142a bez niej.`,
+  openKey: "Naci\u015Bnij Enter, \u017Ceby otworzy\u0107 raport (Esc ko\u0144czy).",
   wizard: {
     language: "J\u0119zyk raportu",
     address: "Adres strony",
@@ -12044,9 +12045,6 @@ Przyk\u0142ad:
       standard: { label: "Standardowy", hint: (pages) => `do ${pages} podstron` },
       thorough: { label: "Dok\u0142adny", hint: (pages) => `do ${pages} podstron, trwa d\u0142u\u017Cej` }
     },
-    open: "Otworzy\u0107 raport?",
-    yes: "Tak",
-    no: "Nie",
     openFailed: (path) => `Nie uda\u0142o si\u0119 otworzy\u0107 raportu. Plik jest tutaj: ${path}`
   },
   errors: {
@@ -12107,6 +12105,7 @@ Example:
   warnings: (count) => `${count} ${count === 1 ? "item" : "items"} could not be checked; details are in the report appendix.`,
   failUnder: (score, limit) => `Score ${score} is below the required ${limit} (--fail-under).`,
   optionLater: (flag) => `The ${flag} option arrives in a later version. The audit works without it.`,
+  openKey: "Press Enter to open the report (Esc to quit).",
   wizard: {
     language: "Report language",
     address: "Website address",
@@ -12118,9 +12117,6 @@ Example:
       standard: { label: "Standard", hint: (pages) => `up to ${pages} pages` },
       thorough: { label: "Thorough", hint: (pages) => `up to ${pages} pages, takes longer` }
     },
-    open: "Open the report?",
-    yes: "Yes",
-    no: "No",
     openFailed: (path) => `Could not open the report. The file is here: ${path}`
   },
   errors: {
@@ -12225,9 +12221,19 @@ import { createInterface } from "node:readline/promises";
 import { stripVTControlCharacters } from "node:util";
 
 // src/ui.ts
+import { pathToFileURL } from "node:url";
 import { styleText } from "node:util";
 var paint = (style, text3, stream = process.stdout) => styleText(style, text3, { stream });
 var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function linksWork(stream) {
+  const env = process.env;
+  if (!stream.isTTY || env.CI) return false;
+  if (env.WT_SESSION || Number(env.VTE_VERSION) >= 5e3) return true;
+  return ["vscode", "iTerm.app", "WezTerm", "ghostty"].includes(env.TERM_PROGRAM ?? "");
+}
+function fileLink(path, stream = process.stdout) {
+  return linksWork(stream) ? `\x1B]8;;${pathToFileURL(path).href}\x1B\\${path}\x1B]8;;\x1B\\` : path;
+}
 function scoreStyle(score) {
   return score >= 90 ? "green" : score >= 50 ? "yellow" : "red";
 }
@@ -12343,6 +12349,23 @@ function select2(message, choices, { initial = 0, done = (choice) => `${message}
     draw();
   });
 }
+function pressEnter(message, { io = terminal } = {}) {
+  const { input, output } = io;
+  return new Promise((resolve2) => {
+    const onKey = (_text, key = {}) => {
+      input.off("keypress", onKey);
+      input.setRawMode(false);
+      input.pause();
+      output.write("\n");
+      resolve2(key.name === "return" || key.name === "enter");
+    };
+    output.write(`${paint("cyan", "\u203A", output)} ${message} `);
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    input.on("keypress", onKey);
+  });
+}
 async function ask(message, check, { hint = "", io = terminal } = {}) {
   const { input, output } = io;
   const rl = createInterface({ input, output, terminal: true });
@@ -12371,7 +12394,7 @@ async function ask(message, check, { hint = "", io = terminal } = {}) {
 }
 
 // src/cli.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.1.1" : "0.0.0-dev";
 var NODE_NEEDED = "22.19.0";
 var MODES = [
   { mode: "quick", pages: 1 },
@@ -12470,19 +12493,7 @@ function openReport(path, m) {
 }
 async function offerToOpen(path, m) {
   console.log("");
-  try {
-    const open = await select2(
-      m.wizard.open,
-      [
-        { label: m.wizard.yes, value: true },
-        { label: m.wizard.no, value: false }
-      ],
-      { done: (choice) => `${m.wizard.open} ${choice.label}` }
-    );
-    if (open) openReport(path, m);
-  } catch (error) {
-    if (!(error instanceof PromptCancelled)) throw error;
-  }
+  if (await pressEnter(m.openKey)) openReport(path, m);
 }
 async function audit(options, outPath, m) {
   const browserInfo = findBrowser();
@@ -12541,11 +12552,12 @@ async function audit(options, outPath, m) {
     }
     progress.stop();
     printScores(scores.categories, scores.overall, m);
-    const shown = relative(process.cwd(), outPath).startsWith("..") ? outPath : relative(process.cwd(), outPath);
-    console.log(`${paint("green", "\u2713")} ${paint("dim", `${m.saved}:`)} ${paint("cyan", shown)}`);
+    console.log(`${paint("green", "\u2713")} ${m.saved}:
+  ${paint("cyan", fileLink(outPath))}`);
     if (options.json)
       console.log(
-        `${paint("green", "\u2713")} ${paint("dim", `${m.savedJson}:`)} ${paint("cyan", shown.replace(/\.pdf$/i, "") + ".json")}`
+        `${paint("green", "\u2713")} ${m.savedJson}:
+  ${paint("cyan", fileLink(outPath.replace(/\.pdf$/i, "") + ".json"))}`
       );
     if (warnings.length) console.log(paint("dim", m.warnings(warnings.length)));
     if (options.failUnder !== void 0 && scores.overall !== null && scores.overall < options.failUnder) {
@@ -12611,7 +12623,8 @@ async function main(argv) {
     console.error(m.errors.unexpected(error instanceof Error ? error.message : String(error)));
     return 4 /* Environment */;
   }
-  if (interactive && exit === 0 /* Ok */) await offerToOpen(outPath, m);
+  if ((exit === 0 /* Ok */ || exit === 1 /* BelowThreshold */) && canPrompt() && !process.env.CI)
+    await offerToOpen(outPath, m);
   return exit;
 }
 process.exitCode = await main(process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sitelens",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Website audit with a plain-language PDF report: performance, SEO, accessibility and security.",
   "keywords": [
     "website audit",