@goflowstate/widget-sdk 0.3.4 → 0.3.5

package/README.md

@@ -161,8 +161,11 @@ before the first state arrives.
 A flow that calls `CanvasWidget.initSession()` carries the feedback icon with no code of its own.
 While the ring has feedback switched on, the session state says so and the SDK puts a round
 button in the corner of the page. A tap opens a sheet with one field at once and takes a
-screenshot of the page behind it; the sheet shows "Taking a screenshot" until the picture is
-attached, and neither the icon nor the sheet is in it. The note is sent through the flow's session to `POST /api/w/:slug/feedback`.
+screenshot of the page behind it, and neither the icon nor the sheet is in it. The sheet says each
+step: corner marks frame the page and the slot reads "Taking a screenshot" (up to 15 seconds),
+then "Screenshot attached" with the picture and a check, or "No screenshot" with "Take
+screenshot" when it could not be taken or was removed. The button reads "Sending" while the note
+goes out, and the sheet ends on "Feedback sent" before it closes. The note is sent through the flow's session to `POST /api/w/:slug/feedback`.
 
 The icon and the sheet take the look of the page they sit on: its fonts, ground, ink, the fill
 and shape of its main button, and its corner radius. To pin a role, set a custom property on

package/dist/canvas-widget-sdk.js

@@ -1,4 +1,4 @@
-// @goflowstate/widget-sdk v0.3.4
+// @goflowstate/widget-sdk v0.3.5
 // https://github.com/goflowstate/goflowstate-sdk
 
 "use strict";
@@ -81,7 +81,9 @@ var CanvasWidgetSDK = (() => {
   var FEEDBACK_HOST_ATTR = "data-fs-feedback-host";
   var SCREENSHOT_MAX_BYTES = 15e4;
   var SCREENSHOT_MAX_SIDE = 1280;
-  var CAPTURE_TIMEOUT_MS = 4e3;
+  var CAPTURE_TIMEOUT_MS = 15e3;
+  var SEND_WAIT_MS = 4e3;
+  var SENT_HOLD_MS = 1600;
   function parseColor(raw) {
     const value = (raw ?? "").trim().toLowerCase();
     if (!value || value === "transparent") return null;
@@ -511,11 +513,41 @@ h2 {
   margin: 2px 0 0; font-family: var(--font-display); font-weight: var(--display-weight);
   font-size: 22px; line-height: 1.15; letter-spacing: var(--display-tracking); text-wrap: balance;
 }
-.shot { display: flex; gap: 12px; align-items: center; font-size: 13px; color: var(--ink-dim); }
-.shot img { width: 50px; max-height: 108px; object-fit: cover; object-position: top; border-radius: 8px; border: 1px solid var(--line); }
-.ghost { display: none; width: 50px; height: 108px; border-radius: 8px; border: 1px solid var(--line); background: var(--fill); }
-.shot[data-pending] .ghost { display: block; }
-.shot[data-pending] img { display: none; }
+.form { display: contents; }
+.shot { display: flex; gap: 14px; align-items: center; font-size: 14px; }
+.thumb {
+  position: relative; flex: none; width: 60px; aspect-ratio: var(--shot-ratio, 0.46); max-height: 124px;
+  border-radius: 9px; border: 1px solid var(--line); background: var(--fill);
+}
+.thumb img { display: none; width: 100%; height: 100%; object-fit: cover; object-position: top; border-radius: 8px; }
+.scan, .empty, .badge { display: none; }
+.shot[data-shot="taking"] .thumb { overflow: hidden; }
+.shot[data-shot="taking"] .scan {
+  display: block; position: absolute; left: 0; right: 0; top: 0; height: 34%;
+  background: linear-gradient(to bottom, transparent, var(--line)); border-bottom: 2px solid var(--ink);
+}
+.shot[data-shot="attached"] .thumb { background: var(--surface); }
+.shot[data-shot="attached"] img { display: block; }
+.shot[data-shot="attached"] .badge {
+  display: grid; place-items: center; position: absolute; right: -8px; top: -8px; width: 22px; height: 22px;
+  border-radius: 50%; background: #1f7a4d; color: #fff; border: 2px solid var(--surface);
+}
+.badge svg { width: 12px; height: 12px; }
+.shot[data-shot="none"] .thumb { border-style: dashed; background: none; }
+.shot[data-shot="none"] .empty { display: grid; place-items: center; position: absolute; inset: 0; color: var(--ink-dim); }
+.empty svg { width: 22px; height: 22px; }
+.shot-text { display: flex; flex-direction: column; align-items: flex-start; gap: 3px; min-width: 0; }
+.shot-label { font-weight: 600; color: var(--ink); }
+.shot[data-shot="none"] .shot-label { color: var(--ink-dim); font-weight: inherit; }
+.finder {
+  position: fixed; z-index: 2147483002; pointer-events: none;
+  top: calc(10px + env(safe-area-inset-top, 0px)); left: 10px; right: 10px; bottom: var(--finder-bottom, 55%);
+}
+.finder i { position: absolute; width: 22px; height: 22px; border: 3px solid #fff; filter: drop-shadow(0 0 1px rgba(0, 0, 0, 0.5)); }
+.finder i:nth-child(1) { left: 0; top: 0; border-right: 0; border-bottom: 0; border-top-left-radius: 9px; }
+.finder i:nth-child(2) { right: 0; top: 0; border-left: 0; border-bottom: 0; border-top-right-radius: 9px; }
+.finder i:nth-child(3) { left: 0; bottom: 0; border-right: 0; border-top: 0; border-bottom-left-radius: 9px; }
+.finder i:nth-child(4) { right: 0; bottom: 0; border-left: 0; border-top: 0; border-bottom-right-radius: 9px; }
 .link { background: none; border: 0; padding: 0; font: inherit; color: var(--ink); text-decoration: underline; text-underline-offset: 3px; cursor: pointer; }
 textarea {
   width: 100%; min-height: 84px; resize: none; font: inherit; font-size: 16px; color: var(--ink);
@@ -528,7 +560,19 @@ textarea::placeholder { color: var(--ink-dim); }
   cursor: pointer; border: 0; padding: 15px 14px;
   background: var(--cta); color: var(--cta-ink); border-radius: var(--button-radius);
 }
+.send { display: flex; align-items: center; justify-content: center; gap: 9px; }
 .send[disabled] { opacity: 0.5; cursor: default; }
+.sheet[data-busy] .send { opacity: 1; }
+.dots { display: inline-flex; gap: 4px; }
+.dots i { width: 5px; height: 5px; border-radius: 50%; background: currentColor; opacity: 0.4; }
+.done { display: flex; flex-direction: column; align-items: center; gap: 12px; padding: 14px 0 10px; }
+.ring { display: grid; place-items: center; width: 52px; height: 52px; border-radius: 50%; background: #1f7a4d; color: #fff; }
+.ring svg { width: 26px; height: 26px; }
+.done-title {
+  margin: 0; font-family: var(--font-display); font-weight: var(--display-weight);
+  font-size: 22px; line-height: 1.15; letter-spacing: var(--display-tracking);
+}
+.said { position: absolute; width: 1px; height: 1px; margin: -1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
 .status { margin: 0; font-size: 13px; color: var(--ink-dim); min-height: 1.4em; }
 [hidden] { display: none !important; }
 @media (prefers-reduced-motion: no-preference) {
@@ -538,13 +582,31 @@ textarea::placeholder { color: var(--ink-dim); }
   }
   .bug svg { transition: transform 0.1s ease-out, width 0.22s ease, height 0.22s ease; }
   .sheet { animation: rise 0.22s ease-out; }
-  .shot[data-pending] .ghost { animation: wait 1.1s ease-in-out infinite alternate; }
-  @keyframes wait { from { opacity: 0.45; } to { opacity: 1; } }
+  .shot[data-shot="taking"] .scan { animation: fsf-scan 1.3s cubic-bezier(0.45, 0, 0.55, 1) infinite; }
+  @keyframes fsf-scan { from { transform: translateY(-100%); } to { transform: translateY(300%); } }
+  .finder i { animation: fsf-frame 0.9s ease-in-out infinite alternate; }
+  @keyframes fsf-frame { from { opacity: 0.55; } to { opacity: 1; } }
+  .shot[data-shot="attached"] img { animation: fsf-land 0.28s cubic-bezier(0.2, 0.8, 0.2, 1); }
+  @keyframes fsf-land { from { transform: scale(1.14); opacity: 0; } to { transform: none; opacity: 1; } }
+  .shot[data-shot="attached"] .badge { animation: fsf-pop 0.24s cubic-bezier(0.2, 0.8, 0.2, 1) 0.14s backwards; }
+  .ring { animation: fsf-pop 0.26s cubic-bezier(0.2, 0.8, 0.2, 1); }
+  @keyframes fsf-pop { from { transform: scale(0.4); opacity: 0; } to { transform: none; opacity: 1; } }
+  .dots i { animation: fsf-dot 1s ease-in-out infinite; }
+  .dots i:nth-child(2) { animation-delay: 0.15s; }
+  .dots i:nth-child(3) { animation-delay: 0.3s; }
+  @keyframes fsf-dot { 30% { opacity: 1; transform: translateY(-2px); } 60% { opacity: 0.4; transform: none; } }
   @keyframes rise { from { transform: translateY(24px); opacity: 0; } to { transform: none; opacity: 1; } }
 }
 `;
   var mounted = null;
   var feedbackOptedOut = (doc = document) => doc.documentElement.getAttribute("data-fs-feedback") === "off";
+  var CHECK_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 12.5l4.5 4.5L19 7.5"/></svg>';
+  var CAMERA_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3.5" y="6.5" width="17" height="12.5" rx="3"/><circle cx="12" cy="12.8" r="3.2"/><path d="M9 6.5l1-2h4l1 2"/></svg>';
+  var SHOT_LABEL = {
+    taking: "Taking a screenshot",
+    attached: "Screenshot attached",
+    none: "No screenshot"
+  };
   var SCROLL_OPTIONS = { capture: true, passive: true };
   function mountFlowFeedback(options) {
     if (typeof document === "undefined" || !document.body) return null;
@@ -557,14 +619,22 @@ textarea::placeholder { color: var(--ink-dim); }
 <button type="button" class="bug" data-state="float" aria-label="Send feedback on this page">${BUG_ICON}</button>
 <div class="probe" aria-hidden="true"></div>
 <div class="scrim" hidden></div>
-<div class="sheet" role="dialog" aria-modal="true" aria-labelledby="fsf-title" hidden>
+<div class="finder" aria-hidden="true" hidden><i></i><i></i><i></i><i></i></div>
+<div class="sheet" role="dialog" aria-modal="true" aria-labelledby="fsf-title" data-view="form" hidden>
   <div class="grab" aria-hidden="true"></div>
-  <h2 id="fsf-title">Feedback on this page</h2>
-  <div class="shot" hidden><span class="ghost" aria-hidden="true"></span><img alt="Screenshot of this page" /><span><span class="shot-label">Screenshot attached</span><br /><button type="button" class="link remove">Remove screenshot</button></span></div>
-  <textarea aria-labelledby="fsf-title" placeholder="What should change?" maxlength="2000"></textarea>
-  <p class="status" role="status" aria-live="polite"></p>
-  <button type="button" class="send" disabled>Send feedback</button>
-  <button type="button" class="link tuck">Tuck the button to the side</button>
+  <div class="form">
+    <h2 id="fsf-title">Feedback on this page</h2>
+    <div class="shot" data-shot="none">
+      <span class="thumb"><span class="scan" aria-hidden="true"></span><img alt="Screenshot of this page" /><span class="empty" aria-hidden="true">${CAMERA_ICON}</span><span class="badge" aria-hidden="true">${CHECK_ICON}</span></span>
+      <span class="shot-text"><span class="shot-label" role="status" aria-live="polite">No screenshot</span><button type="button" class="link remove" hidden>Remove</button><button type="button" class="link retake" hidden>Take screenshot</button></span>
+    </div>
+    <textarea aria-labelledby="fsf-title" placeholder="What should change?" maxlength="2000"></textarea>
+    <p class="status" role="status" aria-live="polite"></p>
+    <button type="button" class="send" disabled><span class="send-label">Send feedback</span><span class="dots" aria-hidden="true" hidden><i></i><i></i><i></i></span></button>
+    <button type="button" class="link tuck">Tuck the button to the side</button>
+  </div>
+  <div class="done" hidden><span class="ring">${CHECK_ICON}</span><p class="done-title" aria-hidden="true">Feedback sent</p></div>
+  <p class="said" role="status" aria-live="polite"></p>
 </div>`;
     const q = (selector) => root.querySelector(selector);
     const bug = q(".bug");
@@ -574,6 +644,13 @@ textarea::placeholder { color: var(--ink-dim); }
     const img = q(".shot img");
     const shotLabel = q(".shot-label");
     const remove = q(".remove");
+    const retake = q(".retake");
+    const finder = q(".finder");
+    const form = q(".form");
+    const done = q(".done");
+    const said = q(".said");
+    const sendLabel = q(".send-label");
+    const dots = q(".dots");
     const text = q("textarea");
     const status = q(".status");
     const send = q(".send");
@@ -799,14 +876,54 @@ textarea::placeholder { color: var(--ink-dim); }
     };
     let round = 0;
     let pending = null;
-    const setShot = (url) => {
-      screenshot = url;
-      shot.hidden = url === null;
-      shot.removeAttribute("data-pending");
-      shotLabel.textContent = "Screenshot attached";
-      if (url) img.src = url;
+    const setShot = (state, url = null) => {
+      screenshot = state === "attached" ? url : null;
+      shot.dataset.shot = state;
+      shotLabel.textContent = SHOT_LABEL[state];
+      remove.hidden = state !== "attached" || busy;
+      retake.hidden = state !== "none" || busy;
+      finder.hidden = state !== "taking";
+      if (screenshot) img.src = screenshot;
       else img.removeAttribute("src");
     };
+    const setBusy = (next) => {
+      busy = next;
+      if (busy) sheet.setAttribute("data-busy", "");
+      else sheet.removeAttribute("data-busy");
+      text.readOnly = busy;
+      sendLabel.textContent = busy ? "Sending" : "Send feedback";
+      dots.hidden = !busy;
+      const state = shot.dataset.shot;
+      remove.hidden = state !== "attached" || busy;
+      retake.hidden = state !== "none" || busy;
+      sync();
+    };
+    const setView = (view) => {
+      sheet.dataset.view = view;
+      form.hidden = view !== "form";
+      done.hidden = view !== "sent";
+      said.textContent = view === "sent" ? "Feedback sent" : "";
+    };
+    const take = () => {
+      const mine = round += 1;
+      setShot("taking");
+      host.style.setProperty("--finder-bottom", `${sheet.offsetHeight + 10}px`);
+      host.style.setProperty(
+        "--shot-ratio",
+        String(Math.max(0.3, Math.min(1, window.innerWidth / Math.max(1, window.innerHeight))))
+      );
+      const capture = options.capture ?? (() => captureViewport(theme.ground));
+      const work = withTimeout(Promise.resolve().then(capture), CAPTURE_TIMEOUT_MS).then((url) => {
+        if (mine !== round) return;
+        pending = null;
+        setShot(url ? "attached" : "none", url);
+        const active = root.activeElement;
+        if (!busy && (!active || active === bug || active === retake || active === remove))
+          text.focus();
+      });
+      pending = work;
+      return work;
+    };
     const close = () => {
       if (closeTimer) clearTimeout(closeTimer);
       closeTimer = null;
@@ -815,10 +932,11 @@ textarea::placeholder { color: var(--ink-dim); }
       sheet.hidden = true;
       scrim.hidden = true;
       bug.hidden = false;
-      setShot(null);
+      setBusy(false);
+      setShot("none");
+      setView("form");
       text.value = "";
       status.textContent = "";
-      busy = false;
       sync();
       schedulePlace();
     };
@@ -826,34 +944,34 @@ textarea::placeholder { color: var(--ink-dim); }
       if (!sheet.hidden) return pending ?? Promise.resolve();
       if (busy) return Promise.resolve();
       paint();
-      const mine = round += 1;
       bug.hidden = true;
-      setShot(null);
-      shot.hidden = false;
-      shot.setAttribute("data-pending", "");
-      shotLabel.textContent = "Taking a screenshot";
+      setView("form");
       tuck.hidden = spot.state !== "float";
       scrim.hidden = false;
       sheet.hidden = false;
       sync();
-      const capture = options.capture ?? (() => captureViewport(theme.ground));
-      pending = withTimeout(Promise.resolve().then(capture), CAPTURE_TIMEOUT_MS).then((url) => {
-        if (mine !== round) return;
-        pending = null;
-        setShot(url);
-        if (!root.activeElement || root.activeElement === bug) text.focus();
-      });
-      return pending;
+      return take();
     };
     const submit = async () => {
       const message = text.value.trim();
       if (!message || busy) return;
-      busy = true;
-      sync();
+      setBusy(true);
       status.textContent = "";
-      const mine = round;
-      if (pending) await pending;
-      if (mine !== round) return;
+      let mine = round;
+      if (pending) {
+        let timer;
+        await Promise.race([
+          pending,
+          new Promise((resolve) => timer = setTimeout(resolve, SEND_WAIT_MS))
+        ]);
+        clearTimeout(timer);
+        if (mine !== round) return;
+        if (pending) {
+          mine = round += 1;
+          pending = null;
+          setShot("none");
+        }
+      }
       try {
         await options.submit({
           message,
@@ -862,15 +980,16 @@ textarea::placeholder { color: var(--ink-dim); }
           pagePath: window.location.pathname.slice(-200),
           viewport: { width: window.innerWidth, height: window.innerHeight }
         });
-        status.textContent = "Sent.";
+        if (mine !== round) return;
+        setView("sent");
         closeTimer = setTimeout(() => {
           close();
           bug.focus();
-        }, 1200);
+        }, SENT_HOLD_MS);
       } catch {
-        busy = false;
+        if (mine !== round) return;
+        setBusy(false);
         status.textContent = "That did not send. Try again.";
-        sync();
       }
     };
     bug.addEventListener("click", () => {
@@ -904,7 +1023,15 @@ textarea::placeholder { color: var(--ink-dim); }
     remove.addEventListener("click", () => {
       round += 1;
       pending = null;
-      setShot(null);
+      setShot("none");
+      retake.focus();
+    });
+    retake.addEventListener("click", () => void take());
+    sheet.addEventListener("click", () => {
+      if (sheet.dataset.view === "sent") {
+        close();
+        bug.focus();
+      }
     });
     text.addEventListener("input", sync);
     send.addEventListener("click", () => void submit());