qapture2 0.7.5 → 0.7.7

package/dist/{chunk-COQKFGKZ.cjs → chunk-WU7QMHPK.cjs}

@@ -58,10 +58,10 @@ function openDB(dbName) {
   dbCache.set(dbName, promise);
   return promise;
 }
-function run(dbName, store, mode, fn) {
+function run(dbName, store, mode2, fn) {
   return openDB(dbName).then(
     (db) => new Promise((resolve, reject) => {
-      const tx = db.transaction(store, mode);
+      const tx = db.transaction(store, mode2);
       const s = tx.objectStore(store);
       let result;
       const req = fn(s);
@@ -1762,10 +1762,10 @@ var STR = {
     copied: "Copied",
     copy_failed: "Copy failed",
     copy_prompt: "Copy as agent prompt",
-    severity_label: "Severity",
+    severity_label: "What is this?",
     sev_bug: "Bug",
-    sev_question: "Question",
-    sev_polish: "Polish",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "Open",
     status_verified: "Verified",
     context_attached: "{n} runtime events attached",
@@ -1781,10 +1781,10 @@ var STR = {
     no_evidence: "ticked, no capture",
     expected_label: "Expected",
     exact_label: "Pixel-exact shots",
-    exact_hint: "Screenshots become a real photo of the tab instead of a redraw. Asks once to share this tab; nothing leaves your device.",
+    exact_hint: "Screenshots become a real photo instead of a redraw. Asks once to share this tab (or, in Safari and Firefox, this window); nothing leaves your device.",
     redraw_notice: "This is a redraw of the page, not a real photo.",
     redraw_action: "Use real screenshots",
-    redraw_no_engine: "This browser cannot photograph a tab, so charts and canvases may come out wrong. Open the app in Chrome, Edge or Brave for true screenshots.",
+    redraw_no_engine: "This browser cannot photograph the screen at all, so charts and canvases may come out wrong. Open the app on a desktop browser for true screenshots.",
     fab_title: "Qapture \u2014 click to open, drag to move it out of the way",
     exact_on: "Pixel-exact screenshots on",
     exact_off: "Back to redrawn screenshots",
@@ -1960,10 +1960,10 @@ var STR = {
     copied: "\u062A\u0645 \u0627\u0644\u0646\u0633\u062E",
     copy_failed: "\u0641\u0634\u0644 \u0627\u0644\u0646\u0633\u062E",
     copy_prompt: "\u0646\u0633\u062E \u0643\u0645\u0648\u062C\u0651\u0647 \u0644\u0644\u0648\u0643\u064A\u0644",
-    severity_label: "\u0627\u0644\u0623\u0647\u0645\u064A\u0629",
-    sev_bug: "\u062E\u0644\u0644",
-    sev_question: "\u0633\u0624\u0627\u0644",
-    sev_polish: "\u062A\u062D\u0633\u064A\u0646",
+    severity_label: "\u0645\u0627 \u0647\u0630\u0627\u061F",
+    sev_bug: "Bug",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "\u0645\u0641\u062A\u0648\u062D",
     status_verified: "\u062A\u0645 \u0627\u0644\u062A\u062D\u0642\u0642",
     context_attached: "{n} \u0645\u0646 \u0623\u062D\u062F\u0627\u062B \u0627\u0644\u062A\u0634\u063A\u064A\u0644 \u0645\u0631\u0641\u0642\u0629",
@@ -1979,10 +1979,10 @@ var STR = {
     no_evidence: "\u0645\u064F\u0639\u0644\u0651\u0645 \u0628\u062F\u0648\u0646 \u0627\u0644\u062A\u0642\u0627\u0637",
     expected_label: "\u0627\u0644\u0645\u062A\u0648\u0642\u0639",
     exact_label: "\u0644\u0642\u0637\u0627\u062A \u0645\u0637\u0627\u0628\u0642\u0629 \u062A\u0645\u0627\u0645\u064B\u0627",
-    exact_hint: "\u062A\u0635\u0628\u062D \u0627\u0644\u0644\u0642\u0637\u0629 \u0635\u0648\u0631\u0629 \u062D\u0642\u064A\u0642\u064A\u0629 \u0644\u0644\u062A\u0628\u0648\u064A\u0628 \u0628\u062F\u0644 \u0625\u0639\u0627\u062F\u0629 \u0631\u0633\u0645\u0647. \u064A\u064F\u0637\u0644\u0628 \u0627\u0644\u0625\u0630\u0646 \u0645\u0631\u0629 \u0648\u0627\u062D\u062F\u0629\u060C \u0648\u0644\u0627 \u0634\u064A\u0621 \u064A\u063A\u0627\u062F\u0631 \u062C\u0647\u0627\u0632\u0643.",
+    exact_hint: "\u062A\u0635\u0628\u062D \u0627\u0644\u0644\u0642\u0637\u0629 \u0635\u0648\u0631\u0629 \u062D\u0642\u064A\u0642\u064A\u0629 \u0628\u062F\u0644 \u0625\u0639\u0627\u062F\u0629 \u0627\u0644\u0631\u0633\u0645. \u064A\u064F\u0637\u0644\u0628 \u0627\u0644\u0625\u0630\u0646 \u0645\u0631\u0629 \u0648\u0627\u062D\u062F\u0629 \u0644\u0645\u0634\u0627\u0631\u0643\u0629 \u0627\u0644\u062A\u0628\u0648\u064A\u0628 (\u0623\u0648 \u0627\u0644\u0646\u0627\u0641\u0630\u0629 \u0641\u064A Safari \u0648Firefox)\u060C \u0648\u0644\u0627 \u0634\u064A\u0621 \u064A\u063A\u0627\u062F\u0631 \u062C\u0647\u0627\u0632\u0643.",
     redraw_notice: "\u0647\u0630\u0647 \u0625\u0639\u0627\u062F\u0629 \u0631\u0633\u0645 \u0644\u0644\u0635\u0641\u062D\u0629\u060C \u0648\u0644\u064A\u0633\u062A \u0635\u0648\u0631\u0629 \u062D\u0642\u064A\u0642\u064A\u0629.",
     redraw_action: "\u0627\u0633\u062A\u062E\u062F\u0645 \u0644\u0642\u0637\u0627\u062A \u062D\u0642\u064A\u0642\u064A\u0629",
-    redraw_no_engine: "\u0644\u0627 \u064A\u0633\u062A\u0637\u064A\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u062A\u0635\u0641\u062D \u062A\u0635\u0648\u064A\u0631 \u0627\u0644\u062A\u0628\u0648\u064A\u0628\u060C \u0644\u0630\u0627 \u0642\u062F \u062A\u0638\u0647\u0631 \u0627\u0644\u0645\u062E\u0637\u0637\u0627\u062A \u0648\u0627\u0644\u0644\u0648\u062D\u0627\u062A \u0628\u0634\u0643\u0644 \u062E\u0627\u0637\u0626. \u0627\u0641\u062A\u062D \u0627\u0644\u062A\u0637\u0628\u064A\u0642 \u0641\u064A Chrome \u0623\u0648 Edge \u0623\u0648 Brave \u0644\u0644\u062D\u0635\u0648\u0644 \u0639\u0644\u0649 \u0644\u0642\u0637\u0627\u062A \u062D\u0642\u064A\u0642\u064A\u0629.",
+    redraw_no_engine: "\u0644\u0627 \u064A\u0633\u062A\u0637\u064A\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u062A\u0635\u0641\u062D \u062A\u0635\u0648\u064A\u0631 \u0627\u0644\u0634\u0627\u0634\u0629 \u0625\u0637\u0644\u0627\u0642\u064B\u0627\u060C \u0644\u0630\u0627 \u0642\u062F \u062A\u0638\u0647\u0631 \u0627\u0644\u0645\u062E\u0637\u0637\u0627\u062A \u0648\u0627\u0644\u0644\u0648\u062D\u0627\u062A \u0628\u0634\u0643\u0644 \u062E\u0627\u0637\u0626. \u0627\u0641\u062A\u062D \u0627\u0644\u062A\u0637\u0628\u064A\u0642 \u0639\u0644\u0649 \u0645\u062A\u0635\u0641\u062D \u0633\u0637\u062D \u0645\u0643\u062A\u0628 \u0644\u0644\u062D\u0635\u0648\u0644 \u0639\u0644\u0649 \u0644\u0642\u0637\u0627\u062A \u062D\u0642\u064A\u0642\u064A\u0629.",
     fab_title: "Qapture \u2014 \u0627\u0636\u063A\u0637 \u0644\u0644\u0641\u062A\u062D\u060C \u0648\u0627\u0633\u062D\u0628 \u0644\u062A\u062D\u0631\u064A\u0643\u0647 \u0645\u0646 \u0645\u0643\u0627\u0646\u0647",
     exact_on: "\u062A\u0645 \u062A\u0641\u0639\u064A\u0644 \u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629",
     exact_off: "\u0627\u0644\u0639\u0648\u062F\u0629 \u0625\u0644\u0649 \u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0627\u0644\u0645\u064F\u0639\u0627\u062F \u0631\u0633\u0645\u0647\u0627",
@@ -2182,8 +2182,168 @@ function computeCoverage(journey, guideChecked, skipped) {
   };
 }
 
+// src/lib/frameCalibration.ts
+var MARKER_SIZE = 28;
+var MARKERS = [
+  { key: "tl", color: [255, 0, 0] },
+  { key: "tr", color: [0, 255, 0] },
+  { key: "bl", color: [0, 0, 255] },
+  { key: "br", color: [255, 0, 255] }
+];
+function markerCentres(vw, vh) {
+  const h = MARKER_SIZE / 2;
+  return {
+    tl: { x: h, y: h },
+    tr: { x: vw - h, y: h },
+    bl: { x: h, y: vh - h },
+    br: { x: vw - h, y: vh - h }
+  };
+}
+function dist2(r, g, b, c) {
+  const dr = r - c[0];
+  const dg = g - c[1];
+  const db = b - c[2];
+  return dr * dr + dg * dg + db * db;
+}
+var COLOR_TOLERANCE_2 = 90 * 90;
+var CLUSTER_CELL = 8;
+var MAX_CANDIDATES = 4;
+function findMarkerCandidates(data, width, height) {
+  const cols = Math.ceil(width / CLUSTER_CELL);
+  const rows = Math.ceil(height / CLUSTER_CELL);
+  const cells = {};
+  for (const m of MARKERS) cells[m.key] = new Int32Array(cols * rows);
+  for (let y = 0; y < height; y++) {
+    const row = y * width * 4;
+    const cy = y / CLUSTER_CELL | 0;
+    for (let x = 0; x < width; x++) {
+      const i = row + x * 4;
+      if (data[i + 3] < 128) continue;
+      const r = data[i];
+      const g = data[i + 1];
+      const b = data[i + 2];
+      if (Math.max(r, g, b) - Math.min(r, g, b) < 60) continue;
+      for (const m of MARKERS) {
+        if (dist2(r, g, b, m.color) <= COLOR_TOLERANCE_2) {
+          cells[m.key][cy * cols + (x / CLUSTER_CELL | 0)]++;
+          break;
+        }
+      }
+    }
+  }
+  const out = {};
+  for (const m of MARKERS) {
+    const grid = cells[m.key];
+    const seen = new Uint8Array(cols * rows);
+    const blobs = [];
+    for (let start = 0; start < grid.length; start++) {
+      if (!grid[start] || seen[start]) continue;
+      const queue = [start];
+      seen[start] = 1;
+      let sumX = 0;
+      let sumY = 0;
+      let total = 0;
+      while (queue.length) {
+        const idx = queue.pop();
+        const n = grid[idx];
+        const cx = idx % cols;
+        const cy = idx / cols | 0;
+        sumX += (cx * CLUSTER_CELL + CLUSTER_CELL / 2) * n;
+        sumY += (cy * CLUSTER_CELL + CLUSTER_CELL / 2) * n;
+        total += n;
+        for (let dy = -1; dy <= 1; dy++) {
+          for (let dx = -1; dx <= 1; dx++) {
+            const nx = cx + dx;
+            const ny = cy + dy;
+            if (nx < 0 || ny < 0 || nx >= cols || ny >= rows) continue;
+            const nIdx = ny * cols + nx;
+            if (seen[nIdx] || !grid[nIdx]) continue;
+            seen[nIdx] = 1;
+            queue.push(nIdx);
+          }
+        }
+      }
+      if (total < 16) continue;
+      blobs.push({ x: sumX / total, y: sumY / total, count: total });
+    }
+    blobs.sort((a, b) => b.count - a.count);
+    out[m.key] = blobs.slice(0, MAX_CANDIDATES);
+  }
+  return out;
+}
+var VERIFY_TOLERANCE = 0.02;
+var SQUARENESS_TOLERANCE = 0.05;
+function deriveMapping(candidates, vw, vh, frameW, frameH) {
+  const tls = candidates.tl ?? [];
+  const brs = candidates.br ?? [];
+  for (const tl of tls) {
+    for (const br of brs) {
+      const m = solveFrom(tl, br, candidates, vw, vh, frameW, frameH);
+      if (m) return m;
+    }
+  }
+  return null;
+}
+function solveFrom(tl, br, candidates, vw, vh, frameW, frameH) {
+  if (!(vw > MARKER_SIZE) || !(vh > MARKER_SIZE)) return null;
+  const centres = markerCentres(vw, vh);
+  const spanCssX = centres.br.x - centres.tl.x;
+  const spanCssY = centres.br.y - centres.tl.y;
+  if (spanCssX <= 0 || spanCssY <= 0) return null;
+  const scaleX = (br.x - tl.x) / spanCssX;
+  const scaleY = (br.y - tl.y) / spanCssY;
+  if (!(scaleX > 0.05) || !(scaleY > 0.05)) return null;
+  if (!Number.isFinite(scaleX) || !Number.isFinite(scaleY)) return null;
+  if (Math.abs(scaleX - scaleY) / Math.max(scaleX, scaleY) > SQUARENESS_TOLERANCE) return null;
+  const originX = tl.x - centres.tl.x * scaleX;
+  const originY = tl.y - centres.tl.y * scaleY;
+  const mapping2 = { scaleX, scaleY, originX, originY };
+  const farX = originX + vw * scaleX;
+  const farY = originY + vh * scaleY;
+  const slack = Math.max(4, frameW * 0.01);
+  if (originX < -slack || originY < -slack || farX > frameW + slack || farY > frameH + slack) {
+    return null;
+  }
+  const tolerance = Math.max(6, Math.max(frameW, frameH) * VERIFY_TOLERANCE);
+  let verified = 0;
+  for (const key of ["tr", "bl"]) {
+    const hits = candidates[key] ?? [];
+    if (!hits.length) continue;
+    const want = centres[key];
+    const px = originX + want.x * scaleX;
+    const py = originY + want.y * scaleY;
+    if (!hits.some((h) => Math.hypot(px - h.x, py - h.y) <= tolerance)) return null;
+    verified++;
+  }
+  if (verified === 0) return null;
+  return mapping2;
+}
+function mapRectToFrame(rect, m, frameW, frameH) {
+  const x0 = m.originX + rect.left * m.scaleX;
+  const y0 = m.originY + rect.top * m.scaleY;
+  const sx = Math.max(0, Math.min(frameW, Math.round(x0)));
+  const sy = Math.max(0, Math.min(frameH, Math.round(y0)));
+  const sw = Math.min(frameW - sx, Math.round(rect.width * m.scaleX));
+  const sh = Math.min(frameH - sy, Math.round(rect.height * m.scaleY));
+  if (sw < 1 || sh < 1) return null;
+  return { sx, sy, sw, sh };
+}
+function environmentSignature() {
+  if (typeof window === "undefined") return "";
+  return [
+    window.innerWidth,
+    window.innerHeight,
+    window.outerWidth,
+    window.outerHeight,
+    window.screenX,
+    window.screenY,
+    Math.round((window.devicePixelRatio || 1) * 100)
+  ].join("x");
+}
+
 // src/lib/screenCapture.ts
 var ASPECT_TOLERANCE = 0.08;
+var CALIBRATION_SETTLE_MS = 220;
 var FRESH_FRAME_TIMEOUT_MS = 500;
 var VIDEO_READY_TIMEOUT_MS = 4e3;
 var stream = null;
@@ -2191,22 +2351,14 @@ var track = null;
 var video = null;
 var grabber = null;
 var declined = false;
-function supportsPreferCurrentTab() {
-  const nav = navigator;
-  const brands = nav.userAgentData?.brands;
-  if (Array.isArray(brands) && brands.length) {
-    return brands.some((b) => /chromium/i.test(b.brand));
-  }
-  const ua = navigator.userAgent || "";
-  if (/CriOS|FxiOS|EdgiOS|Firefox/i.test(ua)) return false;
-  return /Chrome|Chromium|Edg\//i.test(ua);
-}
 function isExactCaptureSupported() {
   if (typeof navigator === "undefined" || typeof document === "undefined") return false;
   const md = navigator.mediaDevices;
-  if (!md || typeof md.getDisplayMedia !== "function") return false;
-  return supportsPreferCurrentTab();
+  return !!md && typeof md.getDisplayMedia === "function";
 }
+var mode = "tab";
+var mapping = null;
+var mappingSignature = "";
 function getExactCaptureStatus() {
   if (!isExactCaptureSupported()) return "unsupported";
   if (track && track.readyState === "live") return "live";
@@ -2234,6 +2386,9 @@ function teardown() {
   stream = null;
   track = null;
   grabber = null;
+  mode = "tab";
+  mapping = null;
+  mappingSignature = "";
 }
 function stopExactCapture() {
   teardown();
@@ -2288,6 +2443,78 @@ function validateFrameMapping(frameW, frameH) {
   const viewAspect = vw / vh;
   return Math.abs(frameAspect - viewAspect) / viewAspect <= ASPECT_TOLERANCE;
 }
+async function grabFrameCanvas() {
+  if (!video) return null;
+  await nextPresentedFrame(video);
+  let source = video;
+  let w = video.videoWidth;
+  let h = video.videoHeight;
+  let bitmap = null;
+  if (grabber) {
+    try {
+      bitmap = await grabber.grabFrame();
+      source = bitmap;
+      w = bitmap.width;
+      h = bitmap.height;
+    } catch {
+    }
+  }
+  if (!w || !h) {
+    bitmap?.close?.();
+    return null;
+  }
+  const c = document.createElement("canvas");
+  c.width = w;
+  c.height = h;
+  const ctx = c.getContext("2d", { willReadFrequently: true });
+  if (!ctx) {
+    bitmap?.close?.();
+    return null;
+  }
+  ctx.drawImage(source, 0, 0);
+  bitmap?.close?.();
+  return c;
+}
+async function calibrate() {
+  if (!video) return false;
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  if (vw <= MARKER_SIZE || vh <= MARKER_SIZE) return false;
+  const card = document.createElement("div");
+  card.setAttribute("data-qa-calibration", "true");
+  card.style.cssText = "position:fixed;inset:0;z-index:2147483647;background:#0a0a0a;pointer-events:none;contain:strict;";
+  const centres = markerCentres(vw, vh);
+  for (const m of MARKERS) {
+    const dot = document.createElement("div");
+    const c = centres[m.key];
+    dot.style.cssText = `position:absolute;width:${MARKER_SIZE}px;height:${MARKER_SIZE}px;left:${c.x - MARKER_SIZE / 2}px;top:${c.y - MARKER_SIZE / 2}px;background:rgb(${m.color[0]},${m.color[1]},${m.color[2]});`;
+    card.appendChild(dot);
+  }
+  document.body.appendChild(card);
+  try {
+    await new Promise((r) => setTimeout(r, CALIBRATION_SETTLE_MS));
+    const frame = await grabFrameCanvas();
+    if (!frame) return false;
+    const ctx = frame.getContext("2d", { willReadFrequently: true });
+    if (!ctx) return false;
+    const { data } = ctx.getImageData(0, 0, frame.width, frame.height);
+    const found = deriveMapping(
+      findMarkerCandidates(data, frame.width, frame.height),
+      vw,
+      vh,
+      frame.width,
+      frame.height
+    );
+    if (!found) return false;
+    mapping = found;
+    mappingSignature = environmentSignature();
+    return true;
+  } catch {
+    return false;
+  } finally {
+    card.remove();
+  }
+}
 async function startExactCapture() {
   if (!isExactCaptureSupported()) return false;
   if (track && track.readyState === "live" && video) return true;
@@ -2317,11 +2544,7 @@ async function startExactCapture() {
       return false;
     }
     const settings = t.getSettings();
-    if (settings.displaySurface && settings.displaySurface !== "browser") {
-      for (const x of s.getTracks()) x.stop();
-      declined = true;
-      return false;
-    }
+    const sharedTab = !settings.displaySurface || settings.displaySurface === "browser";
     const el = document.createElement("video");
     el.setAttribute("data-qa-overlay", "true");
     el.muted = true;
@@ -2334,17 +2557,31 @@ async function startExactCapture() {
     } catch {
     }
     const ready = await waitFor(() => el.videoWidth > 0 && el.videoHeight > 0, VIDEO_READY_TIMEOUT_MS);
-    if (!ready || !validateFrameMapping(el.videoWidth, el.videoHeight)) {
+    const giveUp = () => {
       el.remove();
       for (const x of s.getTracks()) x.stop();
       declined = true;
       return false;
-    }
+    };
+    if (!ready) return giveUp();
+    const isDirect = sharedTab && validateFrameMapping(el.videoWidth, el.videoHeight);
     stream = s;
     track = t;
     video = el;
     const IC = window.ImageCapture;
     grabber = IC ? new IC(t) : null;
+    if (isDirect) {
+      mode = "tab";
+      mapping = null;
+      mappingSignature = "";
+    } else {
+      mode = "surface";
+      if (!await calibrate()) {
+        teardown();
+        declined = true;
+        return false;
+      }
+    }
     t.addEventListener("ended", () => {
       teardown();
     });
@@ -2357,6 +2594,11 @@ async function startExactCapture() {
 }
 async function grabExactRegion(rect) {
   if (!track || track.readyState !== "live" || !video) return null;
+  if (mode === "surface") {
+    if (!mapping || environmentSignature() !== mappingSignature) {
+      if (!await calibrate()) return null;
+    }
+  }
   await nextPresentedFrame(video);
   let source;
   let frameW;
@@ -2379,13 +2621,24 @@ async function grabExactRegion(rect) {
     frameH = video.videoHeight;
   }
   try {
-    if (!validateFrameMapping(frameW, frameH)) return null;
-    const scaleX = frameW / window.innerWidth;
-    const scaleY = frameH / window.innerHeight;
-    const sx = Math.max(0, Math.min(frameW, Math.round(rect.left * scaleX)));
-    const sy = Math.max(0, Math.min(frameH, Math.round(rect.top * scaleY)));
-    const sw = Math.max(1, Math.min(frameW - sx, Math.round(rect.width * scaleX)));
-    const sh = Math.max(1, Math.min(frameH - sy, Math.round(rect.height * scaleY)));
+    let sx;
+    let sy;
+    let sw;
+    let sh;
+    if (mode === "surface") {
+      if (!mapping) return null;
+      const mapped = mapRectToFrame(rect, mapping, frameW, frameH);
+      if (!mapped) return null;
+      ({ sx, sy, sw, sh } = mapped);
+    } else {
+      if (!validateFrameMapping(frameW, frameH)) return null;
+      const scaleX = frameW / window.innerWidth;
+      const scaleY = frameH / window.innerHeight;
+      sx = Math.max(0, Math.min(frameW, Math.round(rect.left * scaleX)));
+      sy = Math.max(0, Math.min(frameH, Math.round(rect.top * scaleY)));
+      sw = Math.max(1, Math.min(frameW - sx, Math.round(rect.width * scaleX)));
+      sh = Math.max(1, Math.min(frameH - sy, Math.round(rect.height * scaleY)));
+    }
     const canvas = document.createElement("canvas");
     canvas.width = sw;
     canvas.height = sh;
@@ -3031,15 +3284,15 @@ function fmtPct(n, d) {
 }
 function summariseSession(notes, stamp) {
   if (!notes.length) return "No points captured.";
-  let bugs = 0, questions = 0, polish = 0, verified = 0, awaiting = 0;
+  let bugs = 0, enhancements = 0, designs = 0, verified = 0, awaiting = 0;
   const pages = /* @__PURE__ */ new Set();
   let earliest = Number.POSITIVE_INFINITY;
   let latest = 0;
   for (const n of notes) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") bugs++;
-    else if (sev === "question") questions++;
-    else polish++;
+    else if (sev === "enhance") enhancements++;
+    else designs++;
     const status = n.status ?? "open";
     if (status === "verified") verified++;
     else if (status === "fixed") awaiting++;
@@ -3054,8 +3307,8 @@ function summariseSession(notes, stamp) {
     `${notes.length} point${notes.length === 1 ? "" : "s"}`,
     `${bugs} bug${bugs === 1 ? "" : "s"}`
   ];
-  if (questions) parts.push(`${questions} question${questions === 1 ? "" : "s"}`);
-  if (polish) parts.push(`${polish} polish`);
+  if (enhancements) parts.push(`${enhancements} enhancement${enhancements === 1 ? "" : "s"}`);
+  if (designs) parts.push(`${designs} design`);
   if (verified) parts.push(`${verified} verified`);
   if (awaiting) parts.push(`${awaiting} awaiting re-test`);
   parts.push(`${pages.size} page${pages.size === 1 ? "" : "s"}`);
@@ -3086,6 +3339,37 @@ Exported: ${stamp}
 Points: ${noteCount}
 
 **Session:** ${summariseSession(notes, stamp)}`
+  );
+  sections.push(
+    `## What the tags mean
+
+Every point below is tagged **Bug**, **Design** or **Enhance**. These are not priorities \u2014 they are three different kinds of work. Read the tag before you decide what to do.
+
+### Bug \u2014 something is broken
+
+Find the **root cause**, not the symptom. Do not patch over it.
+
+State the cause in one plain sentence before you change anything \u2014 e.g. "the date was wrong because the server sends UTC and the list formats in local time". **If you cannot write that sentence, you have not found the cause yet.** Keep looking. The real cause is often something small and silly; that is normal, and it is still the cause.
+
+**The cause is not always in the code.** If the code does exactly what it was asked to do and the result is still wrong, then nothing is broken \u2014 what was *asked for* and what was *meant* did not match. That mismatch is the bug. Realign to what the owner meant and fix it there. If the note already says what they meant ("this isn't what I wanted, I wanted X"), they have told you \u2014 just do X. Do not stop to ask a question they have already answered.
+
+### Design \u2014 it works, but it looks or feels wrong
+
+The functionality is fine and is not in question. Do not go hunting for a fault; there isn't one. Think properly about the interface and the experience \u2014 layout, spacing, hierarchy, wording, states, what the person is actually trying to do \u2014 and change how it looks and feels.
+
+### Enhance \u2014 a new idea, thought of while using the app
+
+The tester wants something added or changed: a new section, a new feature, a different way of doing it.
+
+**Plan it before you build it.** Read the surrounding code, work out what it touches and what it might break, and choose an approach that fits how the app is already built. Then build it. You do not need to stop and ask for approval \u2014 plan well, then go.
+
+Push back only when you have a real reason: it would break something, or it conflicts with an invariant below. Then say so plainly and propose the alternative you would build instead.
+
+### When the tag and the words disagree
+
+The tag sets your starting posture; **the words win.** A point tagged Design that says "this crashes" is a bug \u2014 treat it as one, and mention that you changed lane. People pick the wrong chip all the time; that is not a reason to do the wrong work.
+
+And if a point is phrased as a question rather than a report, **answer it \u2014 do not change code on a maybe.**`
   );
   const stack = typeof p.stack === "string" && p.stack.trim() ? p.stack.trim() : "(not provided)";
   const runArr = toStrings(p.runCommands);
@@ -3681,12 +3965,12 @@ function campaignJsonText(allNotes) {
 function reportMarkdownText(allNotes) {
   if (!campaign) return "";
   const ordered = orderedKnownNotes(allNotes);
-  const counts = { bug: 0, question: 0, polish: 0, verified: 0 };
+  const counts = { bug: 0, design: 0, enhance: 0, verified: 0 };
   for (const n of ordered) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") counts.bug++;
-    else if (sev === "question") counts.question++;
-    else counts.polish++;
+    else if (sev === "enhance") counts.enhance++;
+    else counts.design++;
     if (n.status === "verified") counts.verified++;
   }
   const header = [
@@ -3695,7 +3979,7 @@ function reportMarkdownText(allNotes) {
     campaign.tester ? `Tester: ${campaign.tester}  ` : "",
     `Started: ${campaign.startedAt}  `,
     `Updated: ${(/* @__PURE__ */ new Date()).toISOString()}  `,
-    `Points: ${ordered.length} (${counts.bug} bug, ${counts.question} question, ${counts.polish} polish \xB7 ${counts.verified} verified)`,
+    `Points: ${ordered.length} (${counts.bug} bug, ${counts.design} design, ${counts.enhance} enhance \xB7 ${counts.verified} verified)`,
     "",
     getFsSyncEngine() === "download" ? "Saved by Qapture as the campaign was tested. Screenshots are in" : "Written live by Qapture as each point was saved. Screenshots are in",
     "`screenshots/`, one Markdown file per point in `notes/`.",
@@ -4047,6 +4331,12 @@ function QaProvider({
         for (const id of pendingIds) void idb.delete(id);
         storage.setJSON(PENDING_DELETE_KEY, []);
       }
+      live = live.map((n) => {
+        const legacy = n.severity;
+        if (legacy === "question") return { ...n, severity: "enhance" };
+        if (legacy === "polish") return { ...n, severity: "design" };
+        return n;
+      });
       const sorted = live.slice().sort(
         (a, b) => a.timestamp < b.timestamp ? 1 : -1
       );
@@ -4645,8 +4935,8 @@ function QaProvider({
     const counts = {
       all: notes.length,
       bug: 0,
-      question: 0,
-      polish: 0,
+      design: 0,
+      enhance: 0,
       open: 0,
       fixed: 0,
       verified: 0,
@@ -4655,8 +4945,8 @@ function QaProvider({
     for (const n of notes) {
       const sev = n.severity ?? "bug";
       if (sev === "bug") counts.bug++;
-      else if (sev === "question") counts.question++;
-      else counts.polish++;
+      else if (sev === "enhance") counts.enhance++;
+      else counts.design++;
       const status = n.status ?? "open";
       if (status === "verified") counts.verified++;
       else if (status === "fixed") counts.fixed++;
@@ -5045,7 +5335,11 @@ function QaProvider({
     pendingShare,
     sharePending,
     retestNote,
-    showWelcome,
+    // The greeting explains how to capture. Once a note exists, the tester has
+    // either done it or found their own way, so the line has nothing left to
+    // say — take it away rather than making them dismiss it. (The stored flag
+    // still governs a first visit; this only hides it early.)
+    showWelcome: showWelcome && notes.length === 0,
     dismissWelcome,
     // v0.6
     panelSide,
@@ -5498,8 +5792,8 @@ function QaFab() {
 }
 var SEVERITIES = [
   { value: "bug", labelKey: "sev_bug", icon: "Bug" },
-  { value: "question", labelKey: "sev_question" },
-  { value: "polish", labelKey: "sev_polish" }
+  { value: "enhance", labelKey: "sev_enhance" },
+  { value: "design", labelKey: "sev_design" }
 ];
 function SeverityChipRow({
   value,
@@ -6244,13 +6538,13 @@ function KindBadge({
 }
 var SEVERITY_CLASS = {
   bug: "qa-bg-danger-tint qa-text-danger",
-  question: "qa-bg-warn-tint qa-text-warn",
-  polish: "qa-bg-accent-tint qa-text-accent"
+  enhance: "qa-bg-warn-tint qa-text-warn",
+  design: "qa-bg-accent-tint qa-text-accent"
 };
 var SEVERITY_LABEL_KEY = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  enhance: "sev_enhance",
+  design: "sev_design"
 };
 function SeverityChip({ severity, t }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(
@@ -6355,7 +6649,7 @@ function NoteItem({
       notify(t("copy_failed"), { tone: "error" });
     }
   };
-  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "question" ? "var(--qa-warn)" : "var(--qa-accent)";
+  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "enhance" ? "var(--qa-warn)" : "var(--qa-accent)";
   if (dense && !open && !editing) {
     return /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsxs(
       "button",
@@ -6898,22 +7192,22 @@ function NoteFilterBar() {
       onClick: sev("bug")
     },
     {
-      key: "question",
-      label: t("sev_question"),
-      count: noteCounts.question,
-      active: filter.severity === "question",
-      icon: "AlertTriangle",
+      key: "enhance",
+      label: t("sev_enhance"),
+      count: noteCounts.enhance,
+      active: filter.severity === "enhance",
+      icon: "Plus",
       tone: "warn",
-      onClick: sev("question")
+      onClick: sev("enhance")
     },
     {
-      key: "polish",
-      label: t("sev_polish"),
-      count: noteCounts.polish,
-      active: filter.severity === "polish",
+      key: "design",
+      label: t("sev_design"),
+      count: noteCounts.design,
+      active: filter.severity === "design",
       icon: "Pencil",
       tone: "accent",
-      onClick: sev("polish")
+      onClick: sev("design")
     },
     {
       key: "open",
@@ -7352,46 +7646,25 @@ function SettingsSheet({ onClose }) {
   );
 }
 function WelcomeCard() {
-  const { t, brand, dismissWelcome } = useQa();
+  const { t, dismissWelcome } = useQa();
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      className: "qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-p-3 qa-space-y-2",
+      className: "qa-flex qa-items-center qa-gap-2 qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-px-3 qa-py-2",
       role: "note",
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "qa-m-0 qa-flex qa-items-center qa-gap-1.5 qa-text-sm qa-font-semibold qa-text-hi", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "span",
-            {
-              "aria-hidden": "true",
-              className: "qa-shrink-0",
-              style: { width: 6, height: 6, background: "var(--qa-accent)" }
-            }
-          ),
-          t("welcome_title", { brand: brand.label })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsxs("ul", { className: "qa-m-0 qa-space-y-1 qa-text-xs qa-text-mid", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Crosshair", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_capture") })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Pencil", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_say") })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "CheckCircle2", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_safe") })
-          ] })
-        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Crosshair", size: 13, className: "qa-shrink-0 qa-text-accent" }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "qa-flex-1 qa-text-xs qa-text-mid", children: t("welcome_capture") }),
         /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             type: "button",
             onClick: dismissWelcome,
-            className: "qa-tap qa-w-full qa-rounded-lg qa-bg-accent qa-px-3 qa-py-1.5 qa-text-xs qa-font-semibold",
-            style: { border: "none", cursor: "pointer" },
-            children: t("welcome_got_it")
+            "aria-label": t("welcome_got_it"),
+            title: t("welcome_got_it"),
+            className: "qa-tap-icon qa-shrink-0 qa-rounded-full qa-text-mid qa-focus-ring",
+            style: { background: "transparent", border: "none", cursor: "pointer", padding: 2 },
+            children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "X", size: 13 })
           }
         )
       ]
@@ -8858,16 +9131,16 @@ function unlockPageScroll() {
 var DRAG_THRESHOLD2 = 6;
 var TOUCH_DRAG_THRESHOLD = 12;
 var MIN_REGION_SIZE = 8;
-var SEVERITIES2 = ["bug", "question", "polish"];
+var SEVERITIES2 = ["bug", "design", "enhance"];
 var SEVERITY_ICON = {
   bug: "Bug",
-  question: "AlertTriangle",
-  polish: "Pencil"
+  design: "Pencil",
+  enhance: "Plus"
 };
 var SEVERITY_LABEL_KEY2 = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  design: "sev_design",
+  enhance: "sev_enhance"
 };
 function clampRegionRect(rect) {
   const vw = typeof window !== "undefined" ? window.innerWidth : rect.left + rect.width;
@@ -9821,7 +10094,7 @@ function CaptureMode() {
                   /* @__PURE__ */ jsxRuntime.jsx("span", { className: "qa-text-11 qa-text-mid qa-me-1", children: t("severity_label") }),
                   SEVERITIES2.map((sev) => {
                     const active = severity === sev;
-                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "question" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
+                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "enhance" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
                     return /* @__PURE__ */ jsxRuntime.jsxs(
                       "button",
                       {
@@ -10101,5 +10374,5 @@ function Qapture({ config }) {
 exports.Qapture = Qapture;
 exports.deleteQaDatabase = deleteQaDatabase;
 exports.initQaStudio = initQaStudio;
-//# sourceMappingURL=chunk-COQKFGKZ.cjs.map
-//# sourceMappingURL=chunk-COQKFGKZ.cjs.map
+//# sourceMappingURL=chunk-WU7QMHPK.cjs.map
+//# sourceMappingURL=chunk-WU7QMHPK.cjs.map