pi-studio 0.5.57 → 0.5.59

package/client/studio-client.js

@@ -133,6 +133,7 @@
       const reviewNotesEmptyStateEl = document.getElementById("reviewNotesEmptyState");
       const reviewNotesAddBtn = document.getElementById("reviewNotesAddBtn");
       const reviewNotesInlineAllBtn = document.getElementById("reviewNotesInlineAllBtn");
+      const reviewNotesDeleteAllBtn = document.getElementById("reviewNotesDeleteAllBtn");
       const reviewNotesCloseBtn = document.getElementById("reviewNotesCloseBtn");
       const reviewNotesDoneBtn = document.getElementById("reviewNotesDoneBtn");
 
@@ -459,16 +460,92 @@
         return "working";
       }
 
+      async function writeTextToClipboard(text) {
+        const content = String(text || "");
+
+        try {
+          await fetchStudioJson("/clipboard", {
+            method: "POST",
+            body: JSON.stringify({ text: content }),
+          });
+          return true;
+        } catch {
+          // Fall back to browser clipboard APIs. The server-side clipboard path
+          // is most reliable for local Studio, but may be unavailable over SSH
+          // or on systems without a clipboard command.
+        }
+
+        // Prefer a copy-event payload first. It runs synchronously inside the
+        // user's click gesture and avoids browser quirks where copying a hidden
+        // textarea reports success but leaves the system clipboard unchanged.
+        if (document.execCommand && typeof document.addEventListener === "function") {
+          let handled = false;
+          const handleCopy = (event) => {
+            if (!event || !event.clipboardData) return;
+            event.clipboardData.setData("text/plain", content);
+            event.preventDefault();
+            handled = true;
+          };
+          try {
+            document.addEventListener("copy", handleCopy, true);
+            const ok = document.execCommand("copy");
+            if (ok && handled) return true;
+          } catch {
+            // Fall through to the other clipboard paths.
+          } finally {
+            document.removeEventListener("copy", handleCopy, true);
+          }
+        }
+
+        if (navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+          try {
+            await navigator.clipboard.writeText(content);
+            return true;
+          } catch {
+            // Fall through to the selection-based legacy path.
+          }
+        }
+
+        const textarea = document.createElement("textarea");
+        textarea.value = content;
+        textarea.setAttribute("readonly", "");
+        textarea.style.position = "fixed";
+        textarea.style.top = "0";
+        textarea.style.left = "0";
+        textarea.style.width = "1px";
+        textarea.style.height = "1px";
+        textarea.style.opacity = "0";
+        document.body.appendChild(textarea);
+        const activeEl = document.activeElement;
+        textarea.focus();
+        textarea.select();
+        textarea.setSelectionRange(0, textarea.value.length);
+        let ok = false;
+        try {
+          ok = document.execCommand && document.execCommand("copy");
+        } catch {
+          ok = false;
+        }
+        textarea.remove();
+        if (activeEl && typeof activeEl.focus === "function") {
+          try {
+            activeEl.focus();
+          } catch {
+            // Ignore focus restore failures.
+          }
+        }
+        return Boolean(ok);
+      }
+
       async function copyVisibleWorkingToClipboard() {
         const content = buildVisibleWorkingText();
         if (!content.trim()) {
           setStatus("No visible working details to copy yet.", "warning");
           return;
         }
-        try {
-          await navigator.clipboard.writeText(content);
+        if (await writeTextToClipboard(content)) {
           setStatus("Copied visible working text.", "success");
-        } catch {
+        } else {
           setStatus("Clipboard write failed.", "warning");
         }
       }
@@ -567,6 +644,12 @@
       let lineNumbersEnabled = false;
       let lineNumbersRenderRaf = null;
       let annotationsEnabled = true;
+      const STUDIO_UI_REFRESH_STORAGE_KEY = "piStudio.uiRefresh";
+      const studioUiRefreshEnabled = readStudioUiRefreshEnabled();
+      let studioUiRefreshUi = null;
+      if (studioUiRefreshEnabled && document.body) {
+        document.body.classList.add("studio-ui-refresh");
+      }
       let scratchpadText = "";
       let scratchpadReturnFocusEl = null;
       let scratchpadPersistTimer = null;
@@ -585,6 +668,333 @@
       let suppressedEditorSelectionEnd = null;
       const previewJumpHighlightState = new WeakMap();
       const PREVIEW_ANNOTATION_PLACEHOLDER_PREFIX = "PISTUDIOANNOT";
+
+      function readStudioUiRefreshEnabled() {
+        const normalize = (value) => String(value == null ? "" : value).trim().toLowerCase();
+        const queryValue = initialQueryParams.has("uiRefresh")
+          ? initialQueryParams.get("uiRefresh")
+          : (initialQueryParams.has("studioUiRefresh") ? initialQueryParams.get("studioUiRefresh") : null);
+        const isTruthy = (value) => ["1", "true", "yes", "on", "v2", "refresh"].indexOf(normalize(value)) !== -1;
+        const isFalsey = (value) => ["0", "false", "no", "off"].indexOf(normalize(value)) !== -1;
+        if (queryValue !== null) {
+          const enabled = isTruthy(queryValue) || (!isFalsey(queryValue) && normalize(queryValue) !== "");
+          try {
+            if (enabled) window.localStorage && window.localStorage.setItem(STUDIO_UI_REFRESH_STORAGE_KEY, "1");
+            else window.localStorage && window.localStorage.removeItem(STUDIO_UI_REFRESH_STORAGE_KEY);
+          } catch {}
+          return enabled;
+        }
+        try {
+          return Boolean(window.localStorage && window.localStorage.getItem(STUDIO_UI_REFRESH_STORAGE_KEY) === "1");
+        } catch {
+          return false;
+        }
+      }
+
+      function makeStudioUiRefreshElement(tagName, className, text) {
+        const element = document.createElement(tagName);
+        if (className) element.className = className;
+        if (typeof text === "string") element.textContent = text;
+        return element;
+      }
+
+      function makeStudioUiRefreshSeparator() {
+        return makeStudioUiRefreshElement("span", "studio-refresh-sep");
+      }
+
+      function makeStudioUiRefreshIcon(kind) {
+        const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+        svg.setAttribute("viewBox", "0 0 24 24");
+        svg.setAttribute("aria-hidden", "true");
+        svg.classList.add("studio-refresh-icon");
+        const paths = kind === "focus-exit"
+          ? ["M4 4l6 6", "M10 4v6H4", "M20 20l-6-6", "M14 20v-6h6"]
+          : ["M14 4h6v6", "M20 4l-6 6", "M10 20H4v-6", "M4 20l6-6"];
+        for (const d of paths) {
+          const path = document.createElementNS("http://www.w3.org/2000/svg", "path");
+          path.setAttribute("d", d);
+          svg.appendChild(path);
+        }
+        return svg;
+      }
+
+      function setStudioUiRefreshFocusButtonIcon(buttonEl, isFocusedPane) {
+        if (!buttonEl || !studioUiRefreshEnabled) return;
+        buttonEl.replaceChildren(makeStudioUiRefreshIcon(isFocusedPane ? "focus-exit" : "focus"));
+        buttonEl.setAttribute("aria-label", isFocusedPane ? "Exit focus" : "Focus pane");
+      }
+
+      function appendStudioUiRefreshMenuSection(menuEl, heading, controls) {
+        const sectionEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-section");
+        if (heading) {
+          sectionEl.appendChild(makeStudioUiRefreshElement("div", "studio-refresh-menu-heading", heading));
+        }
+        for (const control of controls) {
+          if (!control) continue;
+          const itemEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-item");
+          itemEl.appendChild(control);
+          sectionEl.appendChild(itemEl);
+        }
+        menuEl.appendChild(sectionEl);
+      }
+
+      function getStudioUiRefreshSelectSummary(selectEl, prefix) {
+        if (!selectEl) return "";
+        const option = selectEl.options && selectEl.selectedIndex >= 0 ? selectEl.options[selectEl.selectedIndex] : null;
+        let label = option ? String(option.textContent || option.label || option.value || "") : String(selectEl.value || "");
+        if (prefix) label = label.replace(new RegExp("^" + prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\s*:?\\s*", "i"), "");
+        return label.trim();
+      }
+
+      function setStudioUiRefreshButtonText(buttonEl, text) {
+        if (!buttonEl) return;
+        buttonEl.textContent = text;
+      }
+
+      function getStudioUiRefreshAnnotationHeaderEnabled() {
+        try {
+          return Boolean(stripAnnotationHeader(sourceTextEl.value).hadHeader);
+        } catch {
+          return false;
+        }
+      }
+
+      function syncStudioUiRefreshSummaries() {
+        if (!studioUiRefreshUi) return;
+        if (studioUiRefreshUi.annotationsButton) {
+          const inlineLabel = annotationsEnabled ? "Inline on" : "Inline hidden";
+          if (isEditorOnlyMode) {
+            setStudioUiRefreshButtonText(studioUiRefreshUi.annotationsButton, "Annotations: " + inlineLabel);
+          } else {
+            const headerLabel = getStudioUiRefreshAnnotationHeaderEnabled() ? "Header on" : "Header off";
+            setStudioUiRefreshButtonText(studioUiRefreshUi.annotationsButton, "Annotations: " + inlineLabel + " · " + headerLabel);
+          }
+        }
+        if (studioUiRefreshUi.viewButton) {
+          const syntaxLabel = editorHighlightEnabled
+            ? (getStudioUiRefreshSelectSummary(highlightSelect, "Syntax highlight") || editorLanguage || "Markdown")
+            : "Off";
+          const lineLabel = lineNumbersEnabled ? "Lines on" : "Lines off";
+          setStudioUiRefreshButtonText(studioUiRefreshUi.viewButton, "View: " + syntaxLabel + " · " + lineLabel);
+        }
+        syncStudioUiRefreshReviewTrigger();
+      }
+
+      function closeStudioUiRefreshMenus() {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.menus) return;
+        for (const item of studioUiRefreshUi.menus) {
+          item.menu.hidden = true;
+          item.button.classList.remove("is-open");
+          item.button.setAttribute("aria-expanded", "false");
+        }
+      }
+
+      function toggleStudioUiRefreshMenu(name) {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.menus) return;
+        let willOpen = false;
+        for (const item of studioUiRefreshUi.menus) {
+          if (item.name === name) willOpen = item.menu.hidden;
+        }
+        for (const item of studioUiRefreshUi.menus) {
+          const isOpen = willOpen && item.name === name;
+          item.menu.hidden = !isOpen;
+          item.button.classList.toggle("is-open", isOpen);
+          item.button.setAttribute("aria-expanded", isOpen ? "true" : "false");
+        }
+      }
+
+      function syncStudioUiRefreshReviewTrigger() {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.reviewButton) return;
+        const critiqueIsStop = getAbortablePendingKind() === "critique";
+        const reviewButton = studioUiRefreshUi.reviewButton;
+        reviewButton.textContent = critiqueIsStop ? "Stop critique" : "Review";
+        reviewButton.classList.toggle("request-stop-active", critiqueIsStop);
+        reviewButton.disabled = critiqueIsStop ? Boolean(critiqueBtn && critiqueBtn.disabled) : false;
+        reviewButton.title = critiqueIsStop
+          ? "Stop the running critique request. Shortcut: Esc."
+          : "Open review actions and settings.";
+        if (critiqueIsStop) {
+          closeStudioUiRefreshMenus();
+        }
+      }
+
+      function makeStudioUiRefreshMenu(buttonEl, name, menuClassName) {
+        const anchorEl = makeStudioUiRefreshElement("span", "studio-refresh-menu-anchor " + (menuClassName || ""));
+        const menuEl = makeStudioUiRefreshElement("div", "studio-refresh-menu");
+        menuEl.hidden = true;
+        buttonEl.type = "button";
+        buttonEl.classList.add("studio-refresh-chip");
+        buttonEl.setAttribute("aria-haspopup", "menu");
+        buttonEl.setAttribute("aria-expanded", "false");
+        buttonEl.addEventListener("click", (event) => {
+          event.stopPropagation();
+          if (name === "review" && getAbortablePendingKind() === "critique") {
+            requestCancelForPendingRequest("critique");
+            return;
+          }
+          toggleStudioUiRefreshMenu(name);
+        });
+        anchorEl.appendChild(buttonEl);
+        anchorEl.appendChild(menuEl);
+        return { name, anchor: anchorEl, button: buttonEl, menu: menuEl };
+      }
+
+      function setStudioUiRefreshPreference(enabled) {
+        try {
+          if (enabled) window.localStorage && window.localStorage.setItem(STUDIO_UI_REFRESH_STORAGE_KEY, "1");
+          else window.localStorage && window.localStorage.removeItem(STUDIO_UI_REFRESH_STORAGE_KEY);
+        } catch {}
+        try {
+          const url = new URL(window.location.href);
+          url.searchParams.set("uiRefresh", enabled ? "1" : "0");
+          window.location.assign(url.toString());
+        } catch {
+          window.location.reload();
+        }
+      }
+
+      function setupStudioUiRefreshToggleButton() {
+        if (!footerMetaEl || document.getElementById("studioUiRefreshToggleBtn")) return;
+        const button = makeStudioUiRefreshElement("button", "footer-compact-btn studio-ui-refresh-toggle", studioUiRefreshEnabled ? "UI: Refresh" : "UI: Classic");
+        button.id = "studioUiRefreshToggleBtn";
+        button.type = "button";
+        button.title = studioUiRefreshEnabled
+          ? "Switch Studio to the classic layout."
+          : "Switch Studio to the refreshed layout.";
+        button.addEventListener("click", () => {
+          setStudioUiRefreshPreference(!studioUiRefreshEnabled);
+        });
+        if (compactBtn && compactBtn.parentNode === footerMetaEl) {
+          compactBtn.insertAdjacentElement("afterend", button);
+        } else {
+          footerMetaEl.appendChild(button);
+        }
+      }
+
+      function setupStudioUiRefreshPrototype() {
+        if (!studioUiRefreshEnabled || studioUiRefreshUi) return;
+        const leftHeaderEl = document.getElementById("leftSectionHeader");
+        const sourceMetaEl = leftPaneEl ? leftPaneEl.querySelector(".source-meta") : null;
+        if (!leftHeaderEl || !sourceMetaEl || !copyDraftBtn) return;
+
+        let reviewMenu = null;
+        if (!isEditorOnlyMode && critiqueBtn && lensSelect) {
+          const reviewButton = makeStudioUiRefreshElement("button", "studio-refresh-tool-tab studio-refresh-review-btn", "Review");
+          reviewMenu = makeStudioUiRefreshMenu(reviewButton, "review", "studio-refresh-review-anchor");
+          appendStudioUiRefreshMenuSection(reviewMenu.menu, "Action", [critiqueBtn]);
+          appendStudioUiRefreshMenuSection(reviewMenu.menu, "Setting", [lensSelect]);
+        }
+
+        const headerTopEl = makeStudioUiRefreshElement("div", "studio-refresh-header-top");
+        const titleGroupEl = makeStudioUiRefreshElement("div", "studio-refresh-title-group");
+        if (leftFocusBtn) {
+          setStudioUiRefreshFocusButtonIcon(leftFocusBtn, false);
+          titleGroupEl.appendChild(leftFocusBtn);
+        }
+        titleGroupEl.appendChild(makeStudioUiRefreshSeparator());
+        if (isEditorOnlyMode) {
+          titleGroupEl.appendChild(makeStudioUiRefreshElement("span", "studio-refresh-static-title", "Editor (Raw)"));
+        } else if (editorViewSelect) {
+          titleGroupEl.appendChild(editorViewSelect);
+        }
+        headerTopEl.appendChild(titleGroupEl);
+        const headerToolsEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-tools");
+        if (reviewNotesBtn) headerToolsEl.appendChild(reviewNotesBtn);
+        if (outlineBtn) headerToolsEl.appendChild(outlineBtn);
+        if (scratchpadBtn) headerToolsEl.appendChild(scratchpadBtn);
+        if (reviewMenu) headerToolsEl.appendChild(reviewMenu.anchor);
+        headerTopEl.appendChild(headerToolsEl);
+
+        const headerUtilityEl = makeStudioUiRefreshElement("div", "studio-refresh-header-utility");
+        const utilityLeftEl = makeStudioUiRefreshElement("div", "studio-refresh-utility-left");
+        if (sourceBadgeEl) utilityLeftEl.appendChild(sourceBadgeEl);
+        if (sourceBadgeEl && (resourceDirBtn || resourceDirLabel || resourceDirInputWrap || syncBadgeEl)) {
+          utilityLeftEl.appendChild(makeStudioUiRefreshSeparator());
+        }
+        if (resourceDirBtn) utilityLeftEl.appendChild(resourceDirBtn);
+        if (resourceDirLabel) utilityLeftEl.appendChild(resourceDirLabel);
+        if (resourceDirInputWrap) utilityLeftEl.appendChild(resourceDirInputWrap);
+        if (syncBadgeEl) utilityLeftEl.appendChild(syncBadgeEl);
+        headerUtilityEl.appendChild(utilityLeftEl);
+        leftHeaderEl.replaceChildren(headerTopEl, headerUtilityEl);
+
+        const rightHeaderEl = document.getElementById("rightSectionHeader");
+        if (rightHeaderEl && rightViewSelect) {
+          const rightIdentityEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-identity studio-refresh-pane-identity-right");
+          const rightTitleGroupEl = makeStudioUiRefreshElement("div", "studio-refresh-title-group");
+          if (rightFocusBtn) {
+            setStudioUiRefreshFocusButtonIcon(rightFocusBtn, false);
+            rightTitleGroupEl.appendChild(rightFocusBtn);
+            rightTitleGroupEl.appendChild(makeStudioUiRefreshSeparator());
+          }
+          if (isEditorOnlyMode) {
+            rightTitleGroupEl.appendChild(makeStudioUiRefreshElement("span", "studio-refresh-static-title", "Editor (Preview)"));
+          } else {
+            rightTitleGroupEl.appendChild(rightViewSelect);
+          }
+          rightIdentityEl.appendChild(rightTitleGroupEl);
+          const rightToolsEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-tools");
+          if (exportPdfBtn) rightToolsEl.appendChild(exportPdfBtn);
+          rightHeaderEl.replaceChildren(rightIdentityEl, rightToolsEl);
+        }
+
+        const toolbarEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar");
+        const toolbarMainEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-main");
+        const actionsEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-actions");
+        const actionLineOneEl = makeStudioUiRefreshElement("div", "studio-refresh-action-line");
+        if (!isEditorOnlyMode && sendRunBtn) actionLineOneEl.appendChild(sendRunBtn);
+        if (!isEditorOnlyMode && queueSteerBtn) actionLineOneEl.appendChild(queueSteerBtn);
+        const actionLineTwoEl = makeStudioUiRefreshElement("div", "studio-refresh-action-line");
+        actionLineTwoEl.appendChild(copyDraftBtn);
+        if (!isEditorOnlyMode && sendEditorBtn) actionLineTwoEl.appendChild(sendEditorBtn);
+        if (actionLineOneEl.childNodes.length > 0) actionsEl.appendChild(actionLineOneEl);
+        actionsEl.appendChild(actionLineTwoEl);
+
+        const stateEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-state");
+        const annotationsButton = makeStudioUiRefreshElement("button", "", "Annotations");
+        const annotationsMenu = makeStudioUiRefreshMenu(annotationsButton, "annotations", "studio-refresh-annotations-anchor");
+        appendStudioUiRefreshMenuSection(annotationsMenu.menu, "Display", isEditorOnlyMode ? [annotationModeSelect] : [annotationModeSelect, insertHeaderBtn]);
+        appendStudioUiRefreshMenuSection(annotationsMenu.menu, "Actions", [stripAnnotationsBtn, saveAnnotatedBtn]);
+        const viewButton = makeStudioUiRefreshElement("button", "", "View");
+        const viewMenu = makeStudioUiRefreshMenu(viewButton, "view", "studio-refresh-view-anchor");
+        appendStudioUiRefreshMenuSection(viewMenu.menu, "Display", [highlightSelect, lineNumbersSelect]);
+        stateEl.appendChild(annotationsMenu.anchor);
+        stateEl.appendChild(viewMenu.anchor);
+
+        toolbarMainEl.appendChild(actionsEl);
+        toolbarMainEl.appendChild(stateEl);
+        toolbarEl.appendChild(toolbarMainEl);
+        sourceMetaEl.replaceChildren(toolbarEl);
+
+        studioUiRefreshUi = {
+          annotationsButton,
+          viewButton,
+          reviewButton: reviewMenu ? reviewMenu.button : null,
+          menus: [annotationsMenu, viewMenu].concat(reviewMenu ? [reviewMenu] : []),
+        };
+
+        document.addEventListener("click", (event) => {
+          const target = event.target;
+          if (target instanceof Element && target.closest(".studio-refresh-menu-anchor")) return;
+          closeStudioUiRefreshMenus();
+        });
+        document.addEventListener("keydown", (event) => {
+          if (event.key === "Escape") closeStudioUiRefreshMenus();
+        });
+        toolbarEl.addEventListener("change", () => {
+          window.setTimeout(syncStudioUiRefreshSummaries, 0);
+        });
+        toolbarEl.addEventListener("click", (event) => {
+          const target = event.target;
+          if (target instanceof Element && target.closest(".studio-refresh-menu")) {
+            window.setTimeout(syncStudioUiRefreshSummaries, 0);
+          }
+        });
+        syncStudioUiRefreshSummaries();
+      }
+
+      setupStudioUiRefreshToggleButton();
+      setupStudioUiRefreshPrototype();
       const annotationHelpers = globalThis.PiStudioAnnotationHelpers;
       if (!annotationHelpers || typeof annotationHelpers.collectInlineAnnotationMarkers !== "function") {
         throw new Error("Studio annotation helpers failed to load.");
@@ -1224,7 +1634,7 @@
 
       function updateSourceBadge() {
         const label = sourceState && sourceState.label ? sourceState.label : "blank";
-        sourceBadgeEl.textContent = "Editor origin: " + label;
+        sourceBadgeEl.textContent = (studioUiRefreshEnabled ? "Origin: " : "Editor origin: ") + label;
         const descriptor = getCurrentStudioDocumentDescriptor();
         if (sourceBadgeEl) {
           sourceBadgeEl.title = descriptor.fileBacked
@@ -1285,6 +1695,9 @@
           btn.classList.toggle("is-active", isFocusedPane);
           btn.setAttribute("aria-pressed", isFocusedPane ? "true" : "false");
           btn.textContent = isFocusedPane ? "Exit focus" : "Focus pane";
+          if (studioUiRefreshEnabled) {
+            setStudioUiRefreshFocusButtonIcon(btn, isFocusedPane);
+          }
           btn.title = isFocusedPane
             ? "Return to the two-pane layout. Shortcut: F10 or Cmd/Ctrl+Esc."
             : "Show only the " + paneName + " pane. Shortcut: F10 or Cmd/Ctrl+Esc.";
@@ -2837,6 +3250,107 @@
         }
       }
 
+      function normalizeCopyableBlockText(text) {
+        return String(text || "").replace(/\r\n/g, "\n").replace(/\u200b/g, "");
+      }
+
+      function getCopyablePreviewBlockText(blockEl) {
+        if (!blockEl || typeof blockEl.querySelectorAll !== "function") return "";
+        if (blockEl.classList && blockEl.classList.contains("preview-code-lines")) {
+          return normalizeCopyableBlockText(
+            Array.from(blockEl.querySelectorAll(".preview-code-line-content"))
+              .map((lineEl) => lineEl && typeof lineEl.textContent === "string" ? lineEl.textContent : "")
+              .join("\n"),
+          );
+        }
+
+        const codeEl = typeof blockEl.querySelector === "function"
+          ? blockEl.querySelector("pre code, code")
+          : null;
+        if (codeEl && typeof codeEl.textContent === "string") {
+          return normalizeCopyableBlockText(codeEl.textContent);
+        }
+
+        const clone = typeof blockEl.cloneNode === "function" ? blockEl.cloneNode(true) : null;
+        if (clone && typeof clone.querySelectorAll === "function") {
+          Array.from(clone.querySelectorAll(".studio-copy-block-btn")).forEach((buttonEl) => {
+            if (buttonEl && buttonEl.parentNode) buttonEl.parentNode.removeChild(buttonEl);
+          });
+          return normalizeCopyableBlockText(clone.textContent || "");
+        }
+
+        return normalizeCopyableBlockText(blockEl.textContent || "");
+      }
+
+      async function handleCopyPreviewBlockButtonClick(event) {
+        const target = event && event.target;
+        const copyBtn = target instanceof Element ? target.closest(".studio-copy-block-btn") : null;
+        if (!copyBtn) return;
+        event.preventDefault();
+        event.stopPropagation();
+        if (typeof event.stopImmediatePropagation === "function") {
+          event.stopImmediatePropagation();
+        }
+
+        const blockEl = copyBtn.closest(".studio-copyable-block");
+        if (!blockEl) {
+          setStatus("Could not find the block to copy.", "warning");
+          return;
+        }
+
+        const text = getCopyablePreviewBlockText(blockEl);
+        if (!text.trim()) {
+          setStatus("Nothing to copy from this block.", "warning");
+          return;
+        }
+
+        if (copyBtn.dataset && copyBtn.dataset.studioCopyBusy === "1") return;
+        if (copyBtn.dataset) copyBtn.dataset.studioCopyBusy = "1";
+        const ok = await writeTextToClipboard(text);
+        if (ok) {
+          setStatus("Copied block to clipboard.", "success");
+        } else {
+          setStatus("Clipboard write failed.", "warning");
+        }
+        if (copyBtn.dataset) {
+          window.setTimeout(() => {
+            if (copyBtn.dataset) copyBtn.dataset.studioCopyBusy = "0";
+          }, 150);
+        }
+      }
+
+      function decorateCopyablePreviewBlocks(targetEl) {
+        if (!targetEl || typeof targetEl.querySelectorAll !== "function") return;
+        const blocks = Array.from(targetEl.querySelectorAll("div.sourceCode, pre, .preview-code-lines"));
+        blocks.forEach((blockEl) => {
+          if (!blockEl || !(blockEl instanceof Element)) return;
+          if (blockEl.dataset && blockEl.dataset.studioCopyDecorated === "1") return;
+          if (blockEl.matches && blockEl.matches("pre") && blockEl.closest("div.sourceCode")) return;
+          if (blockEl.closest && blockEl.closest("button, .studio-copy-block-btn")) return;
+
+          const initialText = getCopyablePreviewBlockText(blockEl);
+          if (!initialText.trim()) return;
+
+          blockEl.classList.add("studio-copyable-block");
+          if (blockEl.dataset) blockEl.dataset.studioCopyDecorated = "1";
+
+          const copyBtn = document.createElement("button");
+          copyBtn.type = "button";
+          copyBtn.className = "studio-copy-block-btn";
+          copyBtn.textContent = "Copy";
+          copyBtn.title = "Copy this block to the clipboard.";
+          copyBtn.setAttribute("aria-label", "Copy this block to the clipboard");
+          copyBtn.addEventListener("pointerdown", (event) => {
+            event.stopPropagation();
+          });
+          copyBtn.addEventListener("mousedown", (event) => {
+            event.stopPropagation();
+          });
+
+          blockEl.appendChild(copyBtn);
+        });
+      }
+
       async function applyRenderedMarkdown(targetEl, markdown, pane, nonce) {
         const previewPrepared = annotationsEnabled
           ? prepareMarkdownForPandocPreview(markdown)
@@ -2879,6 +3393,7 @@
           if (shouldDecoratePreviewComments) {
             decorateRenderedEditorPreviewComments(targetEl, sourceTextEl.value || "");
           }
+          decorateCopyablePreviewBlocks(targetEl);
 
           // Warn if relative images are present but unlikely to resolve (non-file-backed content)
           if (!sourceState.path && !(resourceDirInput && resourceDirInput.value.trim())) {
@@ -3670,6 +4185,7 @@
         if (lineNumbersSelect) {
           lineNumbersSelect.value = lineNumbersEnabled ? "on" : "off";
         }
+        syncStudioUiRefreshSummaries();
         updateLineNumberGutterVisibility();
         scheduleEditorLineNumberRender();
         if (editorHighlightEnabled && editorView === "markdown") {
@@ -4281,6 +4797,7 @@
         targetEl.innerHTML = buildCodePreviewHtmlWithCommentBlocks(text, editorLanguage || "");
         ensurePreviewSelectionActions(targetEl);
         updatePreviewCommentBlocksForElement(targetEl);
+        decorateCopyablePreviewBlocks(targetEl);
         if (pane === "response") {
           applyPendingResponseScrollReset();
           scheduleResponsePaneRepaintNudge();
@@ -4357,6 +4874,7 @@
         if (stripAnnotationsBtn) {
           stripAnnotationsBtn.disabled = uiBusy || !hasAnnotationMarkers(sourceTextEl.value);
         }
+        syncStudioUiRefreshSummaries();
       }
 
       function scheduleEditorMetaUpdate() {
@@ -8066,6 +8584,12 @@
             ? "Inline annotations derived from all non-empty comments are currently on. Click to remove them."
             : "Inline annotations derived from all non-empty comments are currently off. Click to add them.";
         }
+        if (reviewNotesDeleteAllBtn) {
+          reviewNotesDeleteAllBtn.disabled = uiBusy || !hasNotes;
+          reviewNotesDeleteAllBtn.title = hasNotes
+            ? "Delete all local comments for this document or draft. Existing inline [an: ...] annotations in the editor text are left unchanged."
+            : "No local comments to delete.";
+        }
         if (reviewNotesDoneBtn) {
           reviewNotesDoneBtn.disabled = !isOpen;
         }
@@ -8417,6 +8941,21 @@
         setStatus("Deleted local comment.", "success");
       }
 
+      function deleteAllReviewNotes() {
+        if (!reviewNotes.length) {
+          setStatus("No local comments to delete.", "warning");
+          return;
+        }
+        const count = reviewNotes.length;
+        const confirmed = window.confirm(
+          "Delete all " + count + " local comment" + (count === 1 ? "" : "s") + " for this document?\n\n"
+            + "Existing inline [an: ...] annotations in the editor text will not be removed.",
+        );
+        if (!confirmed) return;
+        setReviewNotes([]);
+        setStatus("Deleted all local comments.", "success");
+      }
+
       function convertReviewNoteToAnnotation(noteId) {
         if (uiBusy) {
           setStatus("Wait until the current Studio action finishes before toggling inline annotation state.", "warning");
@@ -8669,11 +9208,13 @@
         if (!highlightSelect) return;
         if (!editorHighlightEnabled) {
           highlightSelect.value = "off";
+          syncStudioUiRefreshSummaries();
           return;
         }
         highlightSelect.value = (editorLanguage && SUPPORTED_LANGUAGES.indexOf(editorLanguage) !== -1)
           ? editorLanguage
           : "markdown";
+        syncStudioUiRefreshSummaries();
       }
 
       function setEditorHighlightEnabled(enabled) {
@@ -8776,6 +9317,7 @@
             critiqueBtn.disabled = true;
             critiqueBtn.title = "Critique is unavailable in editor-only mode.";
           }
+          syncStudioUiRefreshReviewTrigger();
           return;
         }
 
@@ -8813,6 +9355,7 @@
                 ? "Critique text as-is (includes [an: ...] markers)."
                 : "Critique text with [an: ...] markers stripped."));
         }
+        syncStudioUiRefreshReviewTrigger();
       }
 
       function updateAnnotationModeUi() {
@@ -8823,6 +9366,7 @@
             : "Inline annotations Hide: keep markers in the editor, hide them in preview, and strip before Run/Critique.";
         }
 
+        syncStudioUiRefreshSummaries();
         syncRunAndCritiqueButtons();
       }
 
@@ -9708,10 +10252,12 @@
         if (hasHeader) {
           insertHeaderBtn.textContent = "Annotation header: On";
           insertHeaderBtn.title = "Remove annotated-reply protocol header while keeping body text.";
+          syncStudioUiRefreshSummaries();
           return;
         }
         insertHeaderBtn.textContent = "Annotation header: Off";
         insertHeaderBtn.title = "Insert annotated-reply protocol header (source metadata, [an: ...] syntax hint, precedence note, and end marker).";
+        syncStudioUiRefreshSummaries();
       }
 
       function toggleAnnotatedReplyHeader() {
@@ -10078,7 +10624,7 @@
         }
 
         try {
-          await navigator.clipboard.writeText(content);
+          await writeTextToClipboard(content);
           setStatus("Copied response text.", "success");
         } catch (error) {
           setStatus("Clipboard write failed.", "warning");
@@ -10302,7 +10848,7 @@
         }
 
         try {
-          await navigator.clipboard.writeText(content);
+          await writeTextToClipboard(content);
           setStatus("Copied editor text.", "success");
         } catch (error) {
           setStatus("Clipboard write failed.", "warning");
@@ -10386,6 +10932,12 @@
         });
       }
 
+      if (reviewNotesDeleteAllBtn) {
+        reviewNotesDeleteAllBtn.addEventListener("click", () => {
+          deleteAllReviewNotes();
+        });
+      }
+
       if (reviewNoteGutterContentEl) {
         reviewNoteGutterContentEl.addEventListener("click", (event) => {
           const target = event.target;
@@ -10397,6 +10949,20 @@
         });
       }
 
+      document.addEventListener("click", (event) => {
+        const target = event.target;
+        const copyBtn = target instanceof Element ? target.closest(".studio-copy-block-btn") : null;
+        if (!copyBtn) return;
+        void handleCopyPreviewBlockButtonClick(event);
+      }, true);
+
+      document.addEventListener("pointerup", (event) => {
+        const target = event.target;
+        const copyBtn = target instanceof Element ? target.closest(".studio-copy-block-btn") : null;
+        if (!copyBtn) return;
+        void handleCopyPreviewBlockButtonClick(event);
+      }, true);
+
       function handlePreviewCommentActionMouseDown(event) {
         const target = event.target;
         const actionBtn = target instanceof Element ? target.closest(".preview-comment-add, .preview-comment-jump, .preview-comment-summary") : null;
@@ -10483,7 +11049,7 @@
           }
 
           try {
-            await navigator.clipboard.writeText(String(scratchpadText || ""));
+            await writeTextToClipboard(String(scratchpadText || ""));
             setStatus("Copied scratchpad text.", "success");
           } catch (error) {
             setStatus("Clipboard write failed.", "warning");