Site: honest offline copy, privacy engines, copy a11y

Author: jatinkrmalik

web/content/features/clipboard-preservation.md

@@ -117,7 +117,7 @@ Many voice-to-text apps on macOS handle clipboard carelessly. VocaMac is one of
 | Feature | VocaMac | Typical App |
 |---------|---------|-------------|
 | **Preserves clipboard** | Yes | No |
-| **Works offline** | Yes | No |
+| **On-device transcription after model download** | Yes | No |
 | **Adjustable silence detection** | Yes | Rare |
 | **Menu bar integration** | Yes | No |
 | **Open source** | Yes | No |

web/layouts/features/single.html

@@ -30,9 +30,9 @@ <h1 id="page-title">{{ .Title }}</h1>
         </div>
     </div>
 </section>
-<section class="section" aria-labelledby="feature-content-title">
+<section class="section">
     <div class="shell doc-layout">
-        <article class="prose" id="feature-content-title">
+        <article class="prose">
             {{ .Content }}
             <div class="feature-cta">
                 <p>Ready to try {{ .Title }}?</p>

web/layouts/index.html

@@ -201,8 +201,8 @@ <h2 class="section-title" id="privacy-title">Your voice has a path.<br>We show y
             <li class="route-step">
                 <div class="route-node">
                     <span class="route-icon">{{ partial "icon.html" "chip" }}</span>
-                    <span class="route-name">{{ $p.engine.name }} / {{ $p.engine.runtime }}</span>
-                    <span class="route-sub">Runs on your Mac</span>
+                    <span class="route-name">Selected on-device engine</span>
+                    <span class="route-sub">WhisperKit/CoreML, Parakeet, Apple Speech, ONNX</span>
                 </div>
                 <svg class="route-link" width="56" height="24" viewBox="0 0 56 24" aria-hidden="true"><path class="route-track" d="M2 12h48"/><path class="route-pulse" d="M2 12h48"/><path class="route-head" d="M46 7.5 50.5 12 46 16.5"/></svg>
             </li>

web/static/script.js

@@ -61,8 +61,24 @@
   /* ---------- Copy buttons ---------- */
 
   var canCopy = !!(navigator.clipboard && navigator.clipboard.writeText);
+  var copyBlocks = document.querySelectorAll("[data-copy]");
+  var copyStatus = null;
+
+  if (canCopy && copyBlocks.length) {
+    copyStatus = document.createElement("div");
+    copyStatus.className = "sr-only";
+    copyStatus.setAttribute("aria-live", "polite");
+    copyStatus.setAttribute("aria-atomic", "true");
+    document.body.appendChild(copyStatus);
+  }
+
+  var announceCopy = function (message) {
+    if (!copyStatus) { return; }
+    copyStatus.textContent = "";
+    copyStatus.textContent = message;
+  };
 
-  document.querySelectorAll("[data-copy]").forEach(function (block) {
+  copyBlocks.forEach(function (block) {
     var source = block.querySelector("code");
     if (!source || !canCopy) { return; }
 
@@ -84,16 +100,19 @@
       var restore = function () {
         button.textContent = "Copy";
         button.classList.remove("is-copied");
+        announceCopy("");
       };
 
       navigator.clipboard.writeText(text).then(
         function () {
           button.textContent = "Copied";
           button.classList.add("is-copied");
+          announceCopy("Copied");
           setTimeout(restore, 2000);
         },
         function () {
           button.textContent = "Press ⌘C";
+          announceCopy("Press ⌘C");
           setTimeout(restore, 2000);
         }
       );

web/tests/site.test.mjs

@@ -164,6 +164,34 @@ test("every rendered page has one heading and image alternatives", async () => {
   }
 });
 
+test("keeps the site-audit copy and a11y fixes", async () => {
+  assert.match(index, /Selected on-device engine/);
+  assert.match(index, /WhisperKit\/CoreML, Parakeet, Apple Speech, ONNX/);
+  assert.doesNotMatch(
+    index,
+    /<span class="route-name">WhisperKit \/ CoreML<\/span>/,
+  );
+
+  const clipboard = await readFile(
+    join(outputRoot, "features/clipboard-preservation/index.html"),
+    "utf8",
+  );
+  assert.match(clipboard, /On-device transcription after model download/);
+  assert.doesNotMatch(clipboard, /Works offline/);
+
+  for (const page of pages) {
+    const rel = relative(outputRoot, page);
+    if (!rel.startsWith("features/") || rel === "features/index.html") continue;
+    const html = await readFile(page, "utf8");
+    assert.doesNotMatch(html, /aria-labelledby="feature-content-title"/);
+    assert.doesNotMatch(html, /id="feature-content-title"/);
+  }
+
+  assert.match(script, /aria-live", "polite"/);
+  assert.match(script, /announceCopy\("Copied"\)/);
+  assert.match(script, /announceCopy\("Press ⌘C"\)/);
+});
+
 test("all rendered local references resolve", async () => {
   const references = new Set();
   for (const page of pages) {