Remove Audio SFX Copy JSON fallback path - PR_26145_020-audio-sfx-remove-copy-json-fallback

Author: ToolboxAid

docs/dev/reports/playwright_audio_sfx_remove_copy_json_fallback.md

@@ -0,0 +1,36 @@
+# PR_26145_020 Audio / SFX Remove Copy JSON Fallback
+
+Date: 2026-05-25
+
+## Targeted validation
+
+- `node --check tools/audio-sfx-playground-v2/js/AudioSfxPlaygroundV2App.js` passed.
+- JSON parse validation passed for `tools/schemas/tools/audio-sfx-playground-v2.schema.json`.
+- HTML external asset guard passed for `tools/audio-sfx-playground-v2/index.html`.
+- Static grep verified no `execCommand`, hidden `textarea`, fallback, or legacy browser copy path remains in `AudioSfxPlaygroundV2App.js`.
+
+## npm run test:workspace-v2
+
+Blocked by local Playwright browser installation:
+
+```text
+browserType.launch: Executable doesn't exist at C:\Users\DavidQ\AppData\Local\ms-playwright\chromium-1217\chrome-win64\chrome.exe
+```
+
+The one-failure run confirmed the missing bundled Chromium cache before Workspace V2 tests could execute.
+
+## Focused Playwright validation
+
+Ran a focused Playwright script with installed Microsoft Edge.
+
+Validated:
+
+- Copy JSON succeeds through `navigator.clipboard.writeText`.
+- Copied JSON parses and contains the current exported toolState payload.
+- Copy JSON failure shows a visible Status error with the recovery action to allow clipboard access or use Export JSON.
+- Copy JSON failure does not silently copy through a fallback path.
+- Copy JSON does not mark Workspace dirty.
+- Valid Import JSON still marks Workspace dirty.
+- No console errors during launch, successful copy, failed copy, or import validation.
+
+Result: focused impacted validation passed.

tools/audio-sfx-playground-v2/js/AudioSfxPlaygroundV2App.js

@@ -470,35 +470,14 @@ export class AudioSfxPlaygroundV2App {
   }
 
   async writeClipboardText(text) {
-    if (typeof this.window.navigator?.clipboard?.writeText === "function") {
-      try {
-        await this.window.navigator.clipboard.writeText(text);
-        return;
-      } catch {
-        // Fall back to the legacy copy command below when browser permission blocks the async Clipboard API.
-      }
-    }
-
-    const documentRef = this.window.document;
-    if (!documentRef?.body || typeof documentRef.execCommand !== "function") {
-      throw new Error("Clipboard API is unavailable.");
+    if (typeof this.window.navigator?.clipboard?.writeText !== "function") {
+      throw new Error("Clipboard API is unavailable. Use Export JSON instead.");
     }
 
-    const textArea = documentRef.createElement("textarea");
-    textArea.value = text;
-    textArea.setAttribute("readonly", "");
-    textArea.style.position = "fixed";
-    textArea.style.left = "-9999px";
-    textArea.style.top = "0";
     try {
-      documentRef.body.append(textArea);
-      textArea.focus();
-      textArea.select();
-      if (!documentRef.execCommand("copy")) {
-        throw new Error("Browser copy command returned false.");
-      }
-    } finally {
-      textArea.remove();
+      await this.window.navigator.clipboard.writeText(text);
+    } catch (error) {
+      throw new Error(`Clipboard API copy was blocked. Allow clipboard access or use Export JSON instead. ${error.message}`);
     }
   }