qapture2 0.9.1 → 0.10.1

package/dist/{chunk-J77SGE5E.cjs → chunk-PEPHZGI2.cjs}

@@ -173,6 +173,7 @@ function deleteQaDatabase(namespace) {
 // src/config/schema.ts
 var DEFAULTS = {
   namespace: "qapture",
+  shotPort: 7017,
   brandLabel: "Qapture",
   loginField: { en: "Username", ar: "\u0627\u0633\u0645 \u0627\u0644\u0645\u0633\u062A\u062E\u062F\u0645" },
   rtl: false,
@@ -343,6 +344,7 @@ function validateConfig(input) {
     return {
       config: {
         namespace: DEFAULTS.namespace,
+        shotPort: DEFAULTS.shotPort,
         brand: { label: DEFAULTS.brandLabel },
         loginField: { ...DEFAULTS.loginField },
         credentials: [],
@@ -365,6 +367,7 @@ function validateConfig(input) {
     return {
       config: {
         namespace: DEFAULTS.namespace,
+        shotPort: DEFAULTS.shotPort,
         brand: { label: DEFAULTS.brandLabel },
         loginField: { ...DEFAULTS.loginField },
         credentials: [],
@@ -384,6 +387,8 @@ function validateConfig(input) {
   }
   const raw = input;
   const namespace = isNonEmptyString(raw["namespace"]) ? raw["namespace"].trim() : DEFAULTS.namespace;
+  const rawPort = Number(raw["shotPort"]);
+  const shotPort = Number.isInteger(rawPort) && rawPort > 0 && rawPort < 65536 ? rawPort : DEFAULTS.shotPort;
   if (raw["theme"] !== void 0) {
     warnings.push(
       'theme: custom themes were removed in Qapture 0.3.0 \u2014 the widget now ships one fixed, self-contained design. The "theme" key is ignored; remove it from your qa.config to silence this warning.'
@@ -433,6 +438,7 @@ function validateConfig(input) {
   return {
     config: {
       namespace,
+      shotPort,
       brand: { label: brandLabel },
       loginField,
       credentials,
@@ -1938,6 +1944,10 @@ var STR = {
     exact_declined: "Staying on redrawn screenshots",
     exact_turn_on: "Turn on",
     exact_unsupported: "Needs a desktop browser \u2014 phones cannot photograph the screen",
+    exact_native_hint: "Screenshots are real photographs, taken by the qapture helper on this machine with the same engine as Cmd+Shift+4. It never asks permission and leaves nothing recording, so it costs no battery. Nothing leaves your device.",
+    exact_native_on: "Real screenshots on \u2014 local helper",
+    exact_helper_offer: "To stop being asked every time: run this next to your dev server and leave it going. macOS asks once for Screen Recording, then never again.",
+    exact_helper_safari: "Safari cannot reach the local helper on an https site \u2014 it blocks loopback as mixed content, and no setting changes that. Open this site in Chrome for screenshots that never ask, or turn the option above off to stay on redrawn shots.",
     sync_title: "Save to a folder",
     sync_hint: "Every note is written to your disk the moment you save it \u2014 nothing is lost if this browser dies.",
     sync_choose: "Choose folder",
@@ -2175,6 +2185,10 @@ var STR = {
     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",
     exact_declined: "\u0633\u0646\u0628\u0642\u0649 \u0639\u0644\u0649 \u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0627\u0644\u0645\u064F\u0639\u0627\u062F \u0631\u0633\u0645\u0647\u0627",
     exact_turn_on: "\u062A\u0641\u0639\u064A\u0644",
+    exact_native_hint: "\u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0635\u0648\u0631 \u062D\u0642\u064A\u0642\u064A\u0629 \u064A\u0644\u062A\u0642\u0637\u0647\u0627 \u0645\u0633\u0627\u0639\u062F qapture \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u062C\u0647\u0627\u0632 \u0628\u0627\u0644\u0645\u062D\u0631\u0643 \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064A \u064A\u0633\u062A\u062E\u062F\u0645\u0647 Cmd+Shift+4. \u0644\u0627 \u064A\u0637\u0644\u0628 \u0625\u0630\u0646\u064B\u0627 \u0648\u0644\u0627 \u064A\u062A\u0631\u0643 \u0623\u064A \u062A\u0633\u062C\u064A\u0644 \u064A\u0639\u0645\u0644\u060C \u0641\u0644\u0627 \u064A\u0633\u062A\u0647\u0644\u0643 \u0627\u0644\u0628\u0637\u0627\u0631\u064A\u0629. \u0648\u0644\u0627 \u0634\u064A\u0621 \u064A\u063A\u0627\u062F\u0631 \u062C\u0647\u0627\u0632\u0643.",
+    exact_native_on: "\u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0627\u0644\u062D\u0642\u064A\u0642\u064A\u0629 \u0645\u0641\u0639\u0651\u0644\u0629 \u2014 \u0627\u0644\u0645\u0633\u0627\u0639\u062F \u0627\u0644\u0645\u062D\u0644\u064A",
+    exact_helper_offer: "\u0644\u0625\u064A\u0642\u0627\u0641 \u0627\u0644\u0633\u0624\u0627\u0644 \u0641\u064A \u0643\u0644 \u0645\u0631\u0629: \u0634\u063A\u0651\u0644 \u0647\u0630\u0627 \u0627\u0644\u0623\u0645\u0631 \u0628\u062C\u0627\u0646\u0628 \u062E\u0627\u062F\u0645 \u0627\u0644\u062A\u0637\u0648\u064A\u0631 \u0648\u0627\u062A\u0631\u0643\u0647 \u064A\u0639\u0645\u0644. \u064A\u0637\u0644\u0628 \u0645\u0627\u0643 \u0625\u0630\u0646 \u062A\u0633\u062C\u064A\u0644 \u0627\u0644\u0634\u0627\u0634\u0629 \u0645\u0631\u0629 \u0648\u0627\u062D\u062F\u0629 \u0641\u0642\u0637.",
+    exact_helper_safari: "\u0644\u0627 \u064A\u0633\u062A\u0637\u064A\u0639 Safari \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u0649 \u0627\u0644\u0645\u0633\u0627\u0639\u062F \u0627\u0644\u0645\u062D\u0644\u064A \u0639\u0644\u0649 \u0645\u0648\u0642\u0639 https \u2014 \u0641\u0647\u0648 \u064A\u062D\u062C\u0628 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0627\u0644\u0645\u062D\u0644\u064A \u0643\u0645\u062D\u062A\u0648\u0649 \u0645\u062E\u062A\u0644\u0637\u060C \u0648\u0644\u0627 \u064A\u063A\u064A\u0651\u0631 \u0630\u0644\u0643 \u0623\u064A \u0625\u0639\u062F\u0627\u062F. \u0627\u0641\u062A\u062D \u0627\u0644\u0645\u0648\u0642\u0639 \u0641\u064A Chrome \u0644\u0644\u062D\u0635\u0648\u0644 \u0639\u0644\u0649 \u0644\u0642\u0637\u0627\u062A \u0628\u0644\u0627 \u0633\u0624\u0627\u0644\u060C \u0623\u0648 \u0623\u0637\u0641\u0626 \u0627\u0644\u062E\u064A\u0627\u0631 \u0623\u0639\u0644\u0627\u0647 \u0644\u0644\u0628\u0642\u0627\u0621 \u0639\u0644\u0649 \u0627\u0644\u0644\u0642\u0637\u0627\u062A \u0627\u0644\u0645\u064F\u0639\u0627\u062F \u0631\u0633\u0645\u0647\u0627.",
     exact_unsupported: "\u064A\u062A\u0637\u0644\u0628 \u0645\u062A\u0635\u0641\u062D \u0633\u0637\u062D \u0645\u0643\u062A\u0628 \u2014 \u0627\u0644\u0647\u0648\u0627\u062A\u0641 \u0644\u0627 \u062A\u0633\u062A\u0637\u064A\u0639 \u062A\u0635\u0648\u064A\u0631 \u0627\u0644\u0634\u0627\u0634\u0629",
     sync_title: "\u0627\u0644\u062D\u0641\u0638 \u0641\u064A \u0645\u062C\u0644\u062F",
     sync_hint: "\u062A\u064F\u0643\u062A\u0628 \u0643\u0644 \u0645\u0644\u0627\u062D\u0638\u0629 \u0639\u0644\u0649 \u0627\u0644\u0642\u0631\u0635 \u0644\u062D\u0638\u0629 \u062D\u0641\u0638\u0647\u0627 \u2014 \u0644\u0627 \u0634\u064A\u0621 \u064A\u0636\u064A\u0639 \u0625\u0630\u0627 \u062A\u0639\u0637\u0651\u0644 \u0627\u0644\u0645\u062A\u0635\u0641\u062D.",
@@ -2511,13 +2525,156 @@ function mapRectToFrame(rect, m, frameW, frameH) {
   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/nativeShot.ts
+var DEFAULT_SHOT_PORT = 7017;
+var PROBE_TIMEOUT_MS = 700;
+var SHOT_TIMEOUT_MS = 9e3;
+var ABSENT_RECHECK_MS = 3e4;
+var configuredPort = DEFAULT_SHOT_PORT;
+function helperReachableHere() {
+  if (typeof window === "undefined") return false;
+  if (window.location.protocol !== "https:") return true;
+  const ua = navigator.userAgent;
+  const isSafari = /Safari/.test(ua) && !/Chrome|Chromium|Edg|OPR/.test(ua);
+  return !isSafari;
+}
+function setShotPort(port) {
+  if (!Number.isInteger(port) || port <= 0 || port >= 65536) return;
+  if (port === configuredPort) return;
+  configuredPort = port;
+  resetNativeShotProbe();
+}
+var cachedBase = null;
+var lastProbeAt = 0;
+var lastProbeResult = false;
+function baseUrl(port) {
+  return `http://127.0.0.1:${port}`;
+}
+async function fetchWithTimeout(url, init, ms) {
+  if (typeof fetch !== "function") return null;
+  const ac = typeof AbortController === "function" ? new AbortController() : null;
+  const timer = setTimeout(() => ac?.abort(), ms);
+  try {
+    return await fetch(url, { ...init, signal: ac?.signal, cache: "no-store" });
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function isNativeShotAvailable(port = configuredPort) {
+  if (typeof window === "undefined") return false;
+  if (!helperReachableHere()) return false;
+  const now2 = Date.now();
+  if (lastProbeResult && cachedBase) return true;
+  if (!lastProbeResult && now2 - lastProbeAt < ABSENT_RECHECK_MS) return false;
+  lastProbeAt = now2;
+  const res = await fetchWithTimeout(`${baseUrl(port)}/qapture/health`, { method: "GET" }, PROBE_TIMEOUT_MS);
+  lastProbeResult = !!res && res.ok;
+  cachedBase = lastProbeResult ? baseUrl(port) : null;
+  return lastProbeResult;
+}
+function helperStartCommand(port = configuredPort) {
+  const flags = [];
+  if (port !== DEFAULT_SHOT_PORT) flags.push(`--port ${port}`);
+  if (typeof window !== "undefined") {
+    const origin = window.location.origin;
+    const local = /^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(:|$)/.test(origin);
+    if (!local) flags.push(`--allow ${origin}`);
+  }
+  return `npx qapture2 shots${flags.length ? " " + flags.join(" ") : ""}`;
+}
+function resetNativeShotProbe() {
+  cachedBase = null;
+  lastProbeAt = 0;
+  lastProbeResult = false;
+}
+async function shootBrowserWindow(port = configuredPort) {
+  if (typeof window === "undefined") return null;
+  const base = cachedBase ?? baseUrl(port);
+  const body = JSON.stringify({
+    x: window.screenX,
+    y: window.screenY,
+    w: window.outerWidth,
+    h: window.outerHeight
+  });
+  const res = await fetchWithTimeout(
+    `${base}/qapture/shot`,
+    { method: "POST", headers: { "content-type": "application/json" }, body },
+    SHOT_TIMEOUT_MS
+  );
+  if (!res || !res.ok) return null;
+  let payload;
+  try {
+    payload = await res.json();
+  } catch {
+    return null;
+  }
+  if (!payload.png) return null;
+  return decodeToCanvas(payload.png);
+}
+function decodeToCanvas(dataUrl) {
+  return new Promise((resolve) => {
+    const img = new Image();
+    img.onload = () => {
+      const c = document.createElement("canvas");
+      c.width = img.naturalWidth;
+      c.height = img.naturalHeight;
+      const ctx = c.getContext("2d", { willReadFrequently: true });
+      if (!ctx) {
+        resolve(null);
+        return;
+      }
+      ctx.drawImage(img, 0, 0);
+      resolve(c);
+    };
+    img.onerror = () => resolve(null);
+    img.src = dataUrl;
+  });
+}
+var cachedMapping = null;
+var cachedFor = "";
+function getCachedMapping() {
+  if (!cachedMapping) return null;
+  return environmentSignature() === cachedFor ? cachedMapping : null;
+}
+function cacheMapping(m) {
+  cachedMapping = m;
+  cachedFor = m ? environmentSignature() : "";
+}
 
 // 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 nativeReady = false;
+function isHelperReachableHere() {
+  return helperReachableHere();
+}
+function getHelperCommand() {
+  return helperStartCommand();
+}
+async function refreshNativeAvailability(port) {
+  if (typeof port === "number") setShotPort(port);
+  nativeReady = await isNativeShotAvailable();
+  return nativeReady;
+}
 function isExactCaptureSupported() {
+  if (nativeReady) return true;
   if (typeof navigator === "undefined" || typeof document === "undefined") return false;
   const md = navigator.mediaDevices;
   return !!md && typeof md.getDisplayMedia === "function";
@@ -2525,13 +2682,15 @@ function isExactCaptureSupported() {
 var armed = false;
 var declined = false;
 var frozen = null;
-var lastMode = null;
 function armExactCapture() {
   if (!isExactCaptureSupported()) return false;
   armed = true;
   declined = false;
   return true;
 }
+function exactCaptureIsFree() {
+  return nativeReady;
+}
 function disarmExactCapture() {
   armed = false;
   releaseFrozenFrame();
@@ -2540,6 +2699,7 @@ function resetExactCaptureDecline() {
   declined = false;
 }
 function getExactCaptureStatus() {
+  if (nativeReady) return "native";
   if (!isExactCaptureSupported()) return "unsupported";
   if (armed) return "live";
   if (declined) return "declined";
@@ -2564,7 +2724,7 @@ function stillIsCurrent() {
   return true;
 }
 async function freezeOrReuse() {
-  if (stillIsCurrent()) return frozen;
+  if (!nativeReady && stillIsCurrent()) return frozen;
   return freezeViewport();
 }
 function releaseFrozenFrame() {
@@ -2664,7 +2824,7 @@ async function grabFrameCanvas(video, grabber) {
   bitmap?.close?.();
   return c;
 }
-async function calibrate(video, grabber) {
+async function calibrate(grabFrame) {
   const vw = window.innerWidth;
   const vh = window.innerHeight;
   if (vw <= MARKER_SIZE || vh <= MARKER_SIZE) return null;
@@ -2681,7 +2841,7 @@ async function calibrate(video, grabber) {
   document.body.appendChild(card);
   try {
     await new Promise((r) => setTimeout(r, CALIBRATION_SETTLE_MS));
-    const frame = await grabFrameCanvas(video, grabber);
+    const frame = await grabFrame();
     if (!frame) return null;
     const ctx = frame.getContext("2d", { willReadFrequently: true });
     if (!ctx) return null;
@@ -2703,8 +2863,69 @@ async function calibrate(video, grabber) {
   }
 }
 async function freezeViewport() {
-  if (!isExactCaptureSupported()) return null;
   releaseFrozenFrame();
+  const native = await freezeViaNativeHelper();
+  if (native) return native;
+  if (!isExactCaptureSupported()) return null;
+  return freezeViaDisplayMedia();
+}
+function adoptFrame(raw, mapping, mode, vw, vh) {
+  let page;
+  if (mapping) {
+    const box = mapRectToFrame(
+      { left: 0, top: 0, width: vw, height: vh },
+      mapping,
+      raw.width,
+      raw.height
+    );
+    if (!box) return null;
+    page = document.createElement("canvas");
+    page.width = box.sw;
+    page.height = box.sh;
+    const ctx = page.getContext("2d");
+    if (!ctx) return null;
+    ctx.drawImage(raw, box.sx, box.sy, box.sw, box.sh, 0, 0, box.sw, box.sh);
+    raw.width = 0;
+    raw.height = 0;
+  } else {
+    page = raw;
+  }
+  frozen = {
+    canvas: page,
+    mode,
+    viewportWidth: vw,
+    viewportHeight: vh,
+    takenAt: Date.now()
+  };
+  frozenAtScrollX = window.scrollX;
+  frozenAtScrollY = window.scrollY;
+  frozenAtPath = window.location.pathname + window.location.search;
+  return frozen;
+}
+async function freezeViaNativeHelper() {
+  if (typeof window === "undefined") return null;
+  nativeReady = await isNativeShotAvailable();
+  if (!nativeReady) return null;
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  let mapping = getCachedMapping();
+  if (!mapping) {
+    mapping = await calibrate(() => shootBrowserWindow());
+    if (!mapping) {
+      cacheMapping(null);
+      return null;
+    }
+    cacheMapping(mapping);
+  }
+  const raw = await withOverlayHidden(() => shootBrowserWindow());
+  if (!raw) return null;
+  const adopted = adoptFrame(raw, mapping, "native", vw, vh);
+  if (!adopted) {
+    cacheMapping(null);
+  }
+  return adopted;
+}
+async function freezeViaDisplayMedia() {
   let stream = null;
   let el = null;
   const release = () => {
@@ -2777,45 +2998,14 @@ async function freezeViewport() {
     const vw = window.innerWidth;
     const vh = window.innerHeight;
     const mode = sharedTab && looksLikeViewport(video.videoWidth, video.videoHeight) ? "tab" : "surface";
-    const mapping = mode === "surface" ? await calibrate(video, grabber) : null;
+    const mapping = mode === "surface" ? await calibrate(() => grabFrameCanvas(video, grabber)) : null;
     if (mode === "surface" && !mapping) {
       declined = true;
       return null;
     }
     const raw = await withOverlayHidden(() => grabFrameCanvas(video, grabber));
     if (!raw) return null;
-    let page;
-    if (mode === "surface" && mapping) {
-      const box = mapRectToFrame(
-        { left: 0, top: 0, width: vw, height: vh },
-        mapping,
-        raw.width,
-        raw.height
-      );
-      if (!box) return null;
-      page = document.createElement("canvas");
-      page.width = box.sw;
-      page.height = box.sh;
-      const ctx = page.getContext("2d");
-      if (!ctx) return null;
-      ctx.drawImage(raw, box.sx, box.sy, box.sw, box.sh, 0, 0, box.sw, box.sh);
-      raw.width = 0;
-      raw.height = 0;
-    } else {
-      page = raw;
-    }
-    frozen = {
-      canvas: page,
-      mode,
-      viewportWidth: vw,
-      viewportHeight: vh,
-      takenAt: Date.now()
-    };
-    frozenAtScrollX = window.scrollX;
-    frozenAtScrollY = window.scrollY;
-    frozenAtPath = window.location.pathname + window.location.search;
-    lastMode = mode;
-    return frozen;
+    return adoptFrame(raw, mode === "surface" ? mapping : null, mode, vw, vh);
   } catch {
     declined = true;
     return null;
@@ -3636,11 +3826,24 @@ function reproSpec(note, index) {
 }
 
 // src/lib/exportZip.ts
-function safeName(name, stamp) {
-  const fallback = `qa-notes-${stamp.slice(0, 10)}`;
+function autoName(project, stamp) {
+  const date = stamp.slice(0, 10);
+  const time = stamp.slice(11, 16).replace(":", "");
+  const slug = (project ?? "").trim().replace(/[\\/:*?"<>|]+/g, "-").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+  const when = time ? `${date}-${time}` : date;
+  return slug ? `${slug}-qa-${when}` : `qa-notes-${when}`;
+}
+function exportProjectName(config) {
+  const name = config?.preamble?.projectName;
+  return typeof name === "string" && name.trim() ? name.trim() : void 0;
+}
+function safeName(name, stamp, project) {
   let base = (name ?? "").trim().replace(/\.zip$/i, "");
   base = base.replace(/[\\/:*?"<>|]+/g, "-").replace(/\s+/g, " ").slice(0, 80).trim();
-  return `${base || fallback}.zip`;
+  return `${base || autoName(project, stamp)}.zip`;
+}
+function suggestedExportName(project, stamp) {
+  return autoName(project, stamp);
 }
 function toStrings(val) {
   if (val == null) return [];
@@ -4018,14 +4221,14 @@ async function buildAndDownloadZip(notes, stamp, filename, config, guideChecked,
   const url = URL.createObjectURL(blob);
   const a = document.createElement("a");
   a.href = url;
-  a.download = safeName(filename, stamp);
+  a.download = safeName(filename, stamp, exportProjectName(config));
   document.body.appendChild(a);
   a.click();
   a.remove();
   setTimeout(() => URL.revokeObjectURL(url), 2e3);
 }
-function exportFileName(filename, stamp) {
-  return safeName(filename, stamp);
+function exportFileName(filename, stamp, project) {
+  return safeName(filename, stamp, project);
 }
 
 // src/lib/shareZip.ts
@@ -4723,7 +4926,23 @@ function QaProvider({
     if (exactShotsWanted(storage)) armExactCapture();
     return getExactCaptureStatus();
   });
-  const exactSupported = isExactCaptureSupported();
+  const [exactSupported, setExactSupported] = React.useState(() => isExactCaptureSupported());
+  React.useEffect(() => {
+    let alive = true;
+    const look = () => {
+      void refreshNativeAvailability(config.shotPort).then(() => {
+        if (!alive) return;
+        setExactSupported(isExactCaptureSupported());
+        setExactStatus(getExactCaptureStatus());
+      });
+    };
+    look();
+    window.addEventListener("focus", look);
+    return () => {
+      alive = false;
+      window.removeEventListener("focus", look);
+    };
+  }, [config.shotPort]);
   const [frozenAt, setFrozenAt] = React.useState(null);
   const [syncState, setSyncState] = React.useState(() => getFsSyncState());
   const [syncTick, setSyncTick] = React.useState(0);
@@ -5249,7 +5468,7 @@ function QaProvider({
     setCapturePrefill(prefill ?? "");
     setCaptureActive(true);
     if (!stillIsCurrent()) setFrozenAt(null);
-    if (exactShotsWanted(storage) && isExactCaptureSupported()) {
+    if (exactCaptureIsFree() || exactShotsWanted(storage) && isExactCaptureSupported()) {
       resetExactCaptureDecline();
       void freezeOrReuse().then((frame) => {
         setFrozenAt(frame?.takenAt ?? null);
@@ -5567,7 +5786,7 @@ function QaProvider({
   const shareExport = React.useCallback(async (filename) => {
     if (!notes.length) return { status: "unsupported" };
     const stamp = nowIso();
-    const name = exportFileName(filename, stamp);
+    const name = exportFileName(filename, stamp, exportProjectName(config));
     setIsExporting(true);
     try {
       const blob = await buildZipBlob(notes, stamp, config, guideChecked, guideSkipped);
@@ -5878,7 +6097,13 @@ function QaProvider({
     gradeStep,
     evidenceByStep,
     // v0.4 — screenshots
-    exactShots: { supported: exactSupported, status: exactStatus, frozenAt },
+    exactShots: {
+      supported: exactSupported,
+      status: exactStatus,
+      frozenAt,
+      helperReachable: isHelperReachableHere(),
+      helperCommand: getHelperCommand()
+    },
     enableExactShots,
     photographNow,
     disableExactShots,
@@ -5941,6 +6166,7 @@ function QaProvider({
     setSimpleMode,
     compactCapture,
     developerMode,
+    projectName: exportProjectName(config),
     setDeveloperMode,
     setCompactCapture,
     exportZip: exportZipFn
@@ -8214,7 +8440,7 @@ function upgradeHint(latest) {
 }
 
 // src/version.ts
-var QA_VERSION = "0.9.1" ;
+var QA_VERSION = "0.10.1" ;
 function Section({
   icon,
   title,
@@ -8452,8 +8678,11 @@ function SettingsSheet({ onClose }) {
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "qa-h-px qa-bg-3 qa-mt-3 qa-mb-4" }),
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "qa-h-px qa-bg-3 qa-mt-3 qa-mb-4" }),
           /* @__PURE__ */ jsxRuntime.jsxs(Section, { icon: "Camera", title: t("exact_label"), children: [
-            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-text-10 qa-text-lo qa-leading-relaxed", children: t("exact_hint") }),
-            !exactShots.supported ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-text-10 qa-text-mid", children: t("exact_unsupported") }) : exactShots.status === "live" ? /* @__PURE__ */ jsxRuntime.jsxs(
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-text-10 qa-text-lo qa-leading-relaxed", children: exactShots.status === "native" ? t("exact_native_hint") : t("exact_hint") }),
+            exactShots.status === "native" ? /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "qa-m-0 qa-inline-flex qa-items-center qa-gap-1.5 qa-text-xs qa-font-semibold qa-text-success", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "CheckCircle2", size: 13 }),
+              t("exact_native_on")
+            ] }) : !exactShots.supported ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-text-10 qa-text-mid", children: t("exact_unsupported") }) : exactShots.status === "live" ? /* @__PURE__ */ jsxRuntime.jsxs(
               "button",
               {
                 type: "button",
@@ -8478,7 +8707,18 @@ function SettingsSheet({ onClose }) {
                   t("exact_turn_on")
                 ]
               }
-            )
+            ),
+            exactShots.status !== "native" && (exactShots.helperReachable ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "qa-mt-2", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-mb-1 qa-text-10 qa-text-lo qa-leading-relaxed", children: t("exact_helper_offer") }),
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "code",
+                {
+                  className: "qa-block qa-rounded-lg qa-bg-2 qa-border qa-border-subtle qa-px-2 qa-py-1.5 qa-text-10 qa-text-hi",
+                  style: { userSelect: "all", wordBreak: "break-all" },
+                  children: exactShots.helperCommand
+                }
+              )
+            ] }) : /* @__PURE__ */ jsxRuntime.jsx("p", { className: "qa-m-0 qa-mt-2 qa-text-10 qa-text-mid qa-leading-relaxed", children: t("exact_helper_safari") }))
           ] }),
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "qa-h-px qa-bg-3 qa-mt-3 qa-mb-4" }),
           /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "qa-flex qa-items-start qa-gap-2 qa-text-xs qa-text-hi", style: { cursor: "pointer" }, children: [
@@ -8827,8 +9067,8 @@ var TABS = ALL_TABS.filter((tab) => tab.key !== "guide" || GUIDE_TAB_ENABLED);
 function visibleTab(tab) {
   return tab === "guide" && !GUIDE_TAB_ENABLED ? "notes" : tab;
 }
-function todayName() {
-  return `qa-notes-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
+function suggestName(project) {
+  return suggestedExportName(project, (/* @__PURE__ */ new Date()).toISOString());
 }
 function panelReducer(state2, action) {
   switch (action.type) {
@@ -8890,7 +9130,8 @@ function QaPanel() {
     panelSide,
     setPanelSide,
     panelCollapsed,
-    setPanelCollapsed
+    setPanelCollapsed,
+    projectName
   } = useQa();
   const activeTab = visibleTab(storedTab);
   const [confirmClear, setConfirmClear] = React.useState(false);
@@ -9009,7 +9250,7 @@ function QaPanel() {
   const appliedKeyboardLift = keyboardLiftActive ? keyboardLift : 0;
   if (phase === "hidden") return null;
   const openNaming = () => {
-    setFilename(todayName());
+    setFilename(suggestName(projectName));
     setNaming(true);
   };
   const doExport = () => {
@@ -11062,7 +11303,7 @@ function CaptureMode() {
               }
             ),
             developerMode && /* @__PURE__ */ jsxRuntime.jsx(LocationReveal, { target: selection }),
-            developerMode && /* @__PURE__ */ jsxRuntime.jsxs(
+            /* @__PURE__ */ jsxRuntime.jsxs(
               "div",
               {
                 role: "group",
@@ -11162,7 +11403,8 @@ function CaptureMode() {
             ] }),
             /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "qa-text-center qa-text-10 qa-text-slate-400", children: [
               t("save_hint"),
-              developerMode ? ` \xB7 ${t("severity_keys")}` : ""
+              " \xB7 ",
+              t("severity_keys")
             ] })
           ] })
         ]
@@ -11370,5 +11612,5 @@ function Qapture({ config }) {
 exports.Qapture = Qapture;
 exports.deleteQaDatabase = deleteQaDatabase;
 exports.initQaStudio = initQaStudio;
-//# sourceMappingURL=chunk-J77SGE5E.cjs.map
-//# sourceMappingURL=chunk-J77SGE5E.cjs.map
+//# sourceMappingURL=chunk-PEPHZGI2.cjs.map
+//# sourceMappingURL=chunk-PEPHZGI2.cjs.map

package/dist/index.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkJ77SGE5E_cjs = require('./chunk-J77SGE5E.cjs');
+var chunkPEPHZGI2_cjs = require('./chunk-PEPHZGI2.cjs');
 
 
 
 Object.defineProperty(exports, "QaStudio", {
   enumerable: true,
-  get: function () { return chunkJ77SGE5E_cjs.Qapture; }
+  get: function () { return chunkPEPHZGI2_cjs.Qapture; }
 });
 Object.defineProperty(exports, "Qapture", {
   enumerable: true,
-  get: function () { return chunkJ77SGE5E_cjs.Qapture; }
+  get: function () { return chunkPEPHZGI2_cjs.Qapture; }
 });
 Object.defineProperty(exports, "deleteQaDatabase", {
   enumerable: true,
-  get: function () { return chunkJ77SGE5E_cjs.deleteQaDatabase; }
+  get: function () { return chunkPEPHZGI2_cjs.deleteQaDatabase; }
 });
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkJ77SGE5E_cjs.initQaStudio; }
+  get: function () { return chunkPEPHZGI2_cjs.initQaStudio; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -88,6 +88,11 @@ type QaPreamble = {
 type QaConfig = {
     /** Storage + DB namespace. Defaults to 'qapture'. */
     namespace?: string;
+    /**
+     * Where `npx qapture2 shots` is listening, when you started it on a port
+     * other than the default 7017. Only needed if 7017 was already taken.
+     */
+    shotPort?: number;
     /**
      * Override any subset of the colour palette.
      *
@@ -175,6 +180,7 @@ type QaConfig = {
 };
 type ResolvedConfig = {
     namespace: string;
+    shotPort: number;
     brand: {
         label: string;
     };

package/dist/index.d.ts

@@ -88,6 +88,11 @@ type QaPreamble = {
 type QaConfig = {
     /** Storage + DB namespace. Defaults to 'qapture'. */
     namespace?: string;
+    /**
+     * Where `npx qapture2 shots` is listening, when you started it on a port
+     * other than the default 7017. Only needed if 7017 was already taken.
+     */
+    shotPort?: number;
     /**
      * Override any subset of the colour palette.
      *
@@ -175,6 +180,7 @@ type QaConfig = {
 };
 type ResolvedConfig = {
     namespace: string;
+    shotPort: number;
     brand: {
         label: string;
     };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Qapture as QaStudio, Qapture, deleteQaDatabase, initQaStudio } from './chunk-HEHVZCSV.js';
+export { Qapture as QaStudio, Qapture, deleteQaDatabase, initQaStudio } from './chunk-F66JBHJG.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map