@solhun/feedback-kit-web 0.7.0 → 0.9.0

package/dist/index.cjs

@@ -30,52 +30,56 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  COMMENT_MAX_CHARS: () => import_feedback_kit_core6.COMMENT_MAX_CHARS,
-  COMMENT_REQUIRED_MESSAGE: () => import_feedback_kit_core6.COMMENT_REQUIRED_MESSAGE,
-  COMMENT_TOO_LONG_MESSAGE: () => import_feedback_kit_core6.COMMENT_TOO_LONG_MESSAGE,
+  COMMENT_MAX_CHARS: () => import_feedback_kit_core7.COMMENT_MAX_CHARS,
+  COMMENT_REQUIRED_MESSAGE: () => import_feedback_kit_core7.COMMENT_REQUIRED_MESSAGE,
+  COMMENT_TOO_LONG_MESSAGE: () => import_feedback_kit_core7.COMMENT_TOO_LONG_MESSAGE,
   ELEMENT_TEXT_MAX_CHARS: () => ELEMENT_TEXT_MAX_CHARS,
   ElementPickingController: () => ElementPickingController,
-  FLOATING_BUTTON_ID: () => import_feedback_kit_core6.FLOATING_BUTTON_ID,
+  FLOATING_BUTTON_ID: () => import_feedback_kit_core7.FLOATING_BUTTON_ID,
   FeedbackKit: () => FeedbackKit,
-  HintProvider: () => import_feedback_kit_core7.HintProvider,
+  HintProvider: () => import_feedback_kit_core8.HintProvider,
   MARKER_KEY_PREFIX: () => MARKER_KEY_PREFIX,
   MAX_MARKERS_PER_PATH: () => MAX_MARKERS_PER_PATH,
-  MODAL_ACTION_HINT_TOGGLE: () => import_feedback_kit_core6.MODAL_ACTION_HINT_TOGGLE,
-  MODAL_ACTION_PICK: () => import_feedback_kit_core6.MODAL_ACTION_PICK,
+  MODAL_ACTION_HINT_TOGGLE: () => import_feedback_kit_core7.MODAL_ACTION_HINT_TOGGLE,
+  MODAL_ACTION_PICK: () => import_feedback_kit_core7.MODAL_ACTION_PICK,
   MarkerStore: () => MarkerStore,
   OWN_UI_ATTR: () => OWN_UI_ATTR,
   PICKING_MODE_KEY: () => PICKING_MODE_KEY,
-  ReportModalController: () => import_feedback_kit_core6.ReportModalController,
-  SCREENSHOT_FAILED_MESSAGE: () => import_feedback_kit_core6.SCREENSHOT_FAILED_MESSAGE,
+  ReportModalController: () => import_feedback_kit_core7.ReportModalController,
+  SCREENSHOT_FAILED_MESSAGE: () => import_feedback_kit_core7.SCREENSHOT_FAILED_MESSAGE,
   SELECTOR_MAX_DEPTH: () => SELECTOR_MAX_DEPTH,
-  SOURCE_ATTR: () => import_feedback_kit_core5.SOURCE_ATTR,
-  SUBMIT_DONE_MESSAGE: () => import_feedback_kit_core6.SUBMIT_DONE_MESSAGE,
-  SUBMIT_PENDING_MESSAGE: () => import_feedback_kit_core6.SUBMIT_PENDING_MESSAGE,
-  WidgetController: () => import_feedback_kit_core6.WidgetController,
+  SOURCE_ATTR: () => import_feedback_kit_core6.SOURCE_ATTR,
+  SUBMIT_DONE_MESSAGE: () => import_feedback_kit_core7.SUBMIT_DONE_MESSAGE,
+  SUBMIT_PENDING_MESSAGE: () => import_feedback_kit_core7.SUBMIT_PENDING_MESSAGE,
+  WidgetController: () => import_feedback_kit_core7.WidgetController,
   captureWebScreenshot: () => captureWebScreenshot,
+  createRouteWatcher: () => createRouteWatcher,
   createWebStorage: () => createWebStorage,
   createWebWidget: () => createWebWidget,
   cssSelectorPath: () => cssSelectorPath,
-  denormalizePin: () => import_feedback_kit_core6.denormalizePin,
+  denormalizePin: () => import_feedback_kit_core7.denormalizePin,
   describeElement: () => describeElement,
   isOwnUi: () => isOwnUi2,
-  normalizePin: () => import_feedback_kit_core6.normalizePin,
-  parseSourceAttr: () => import_feedback_kit_core5.parseSourceAttr,
-  rankHints: () => import_feedback_kit_core7.rankHints,
+  normalizePin: () => import_feedback_kit_core7.normalizePin,
+  parseSourceAttr: () => import_feedback_kit_core6.parseSourceAttr,
+  rankHints: () => import_feedback_kit_core8.rankHints,
   reactComponentPath: () => reactComponentPath,
   reactComponentSummary: () => reactComponentSummary,
   reencodeWebScreenshot: () => reencodeWebScreenshot,
-  resolveConfig: () => import_feedback_kit_core4.resolveConfig,
-  shouldShowWidget: () => import_feedback_kit_core4.shouldShowWidget,
-  sourceFromElement: () => import_feedback_kit_core5.sourceFromElement,
+  resolveConfig: () => import_feedback_kit_core5.resolveConfig,
+  shouldShowWidget: () => import_feedback_kit_core5.shouldShowWidget,
+  sourceFromElement: () => import_feedback_kit_core6.sourceFromElement,
   visibleText: () => visibleText,
-  webContextProviders: () => webContextProviders
+  webContextProviders: () => webContextProviders,
+  webDiagnosticsOptions: () => webDiagnosticsOptions,
+  webRouteStorage: () => webRouteStorage,
+  webRouteWatcher: () => webRouteWatcher
 });
 module.exports = __toCommonJS(index_exports);
-var import_feedback_kit_core4 = require("@solhun/feedback-kit-core");
 var import_feedback_kit_core5 = require("@solhun/feedback-kit-core");
 var import_feedback_kit_core6 = require("@solhun/feedback-kit-core");
 var import_feedback_kit_core7 = require("@solhun/feedback-kit-core");
+var import_feedback_kit_core8 = require("@solhun/feedback-kit-core");
 
 // src/react-tree.ts
 var FRAMEWORK_INTERNALS = /* @__PURE__ */ new Set([
@@ -162,6 +166,7 @@ function reactComponentSummary(node) {
 // src/element-info.ts
 var ELEMENT_TEXT_MAX_CHARS = 200;
 var SELECTOR_MAX_DEPTH = 8;
+var PICK_TARGET_SNAP_PX = 24;
 var KEPT_ATTRS = [
   "id",
   "class",
@@ -234,6 +239,55 @@ function visibleText(el) {
   if (collapsed === "") return null;
   return collapsed.length > ELEMENT_TEXT_MAX_CHARS ? collapsed.slice(0, ELEMENT_TEXT_MAX_CHARS) : collapsed;
 }
+function elementRect(element) {
+  try {
+    const rect = element.getBoundingClientRect();
+    const left = rect.left;
+    const top = rect.top;
+    const width = rect.width;
+    const height = rect.height;
+    if (![left, top, width, height].every(Number.isFinite) || width <= 0 || height <= 0) {
+      return null;
+    }
+    return {
+      element,
+      left,
+      top,
+      right: left + width,
+      bottom: top + height,
+      width,
+      height
+    };
+  } catch {
+    return null;
+  }
+}
+function distanceFromPoint(rect, point) {
+  const dx = Math.max(rect.left - point.x, 0, point.x - rect.right);
+  const dy = Math.max(rect.top - point.y, 0, point.y - rect.bottom);
+  return Math.hypot(dx, dy);
+}
+function resolvePickTarget(target, point) {
+  if (!target || typeof target.tagName !== "string") return null;
+  if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) return target;
+  let current = target;
+  while (true) {
+    const currentRect = elementRect(current);
+    const children = Array.from(current.children).map(elementRect).filter((rect) => rect !== null).map((rect) => ({ rect, distance: distanceFromPoint(rect, point) }));
+    if (children.length === 0) return current;
+    const containing = children.filter(({ distance }) => distance === 0).sort((a, b) => a.rect.width * a.rect.height - b.rect.width * b.rect.height);
+    if (containing[0]) {
+      current = containing[0].rect.element;
+      continue;
+    }
+    const nearest = children.sort((a, b) => a.distance - b.distance)[0];
+    const isMorePrecise = currentRect ? nearest.rect.width * nearest.rect.height < currentRect.width * currentRect.height : true;
+    if (nearest.distance <= PICK_TARGET_SNAP_PX && isMorePrecise) {
+      return nearest.rect.element;
+    }
+    return current;
+  }
+}
 function describeElement(el) {
   if (!el || typeof el.tagName !== "string") return null;
   const attributes = {};
@@ -354,6 +408,84 @@ var MarkerStore = class {
 
 // src/picking.ts
 var import_feedback_kit_core = require("@solhun/feedback-kit-core");
+
+// src/route-watcher.ts
+function defaultTarget() {
+  const g = globalThis;
+  return g.location ? g : null;
+}
+function createRouteWatcher(target = defaultTarget()) {
+  const listeners = /* @__PURE__ */ new Set();
+  let detach = null;
+  const currentPath = () => {
+    const p = target?.location?.pathname;
+    return typeof p === "string" && p.length > 0 ? p : "/";
+  };
+  const emit = () => {
+    const path = currentPath();
+    for (const listener of [...listeners]) {
+      try {
+        listener(path);
+      } catch {
+      }
+    }
+  };
+  const attach = () => {
+    if (detach !== null || !target) return;
+    const onPop = () => emit();
+    target.addEventListener?.("popstate", onPop);
+    const history = target.history;
+    const originalPush = typeof history?.pushState === "function" ? history.pushState : null;
+    const originalReplace = typeof history?.replaceState === "function" ? history.replaceState : null;
+    if (history && originalPush) {
+      history.pushState = function patched(...args) {
+        const out = originalPush.apply(this, args);
+        emit();
+        return out;
+      };
+    }
+    if (history && originalReplace) {
+      history.replaceState = function patched(...args) {
+        const out = originalReplace.apply(this, args);
+        emit();
+        return out;
+      };
+    }
+    detach = () => {
+      target.removeEventListener?.("popstate", onPop);
+      if (history && originalPush) history.pushState = originalPush;
+      if (history && originalReplace) history.replaceState = originalReplace;
+    };
+  };
+  return (onPath) => {
+    listeners.add(onPath);
+    if (listeners.size === 1) attach();
+    try {
+      onPath(currentPath());
+    } catch {
+    }
+    return () => {
+      listeners.delete(onPath);
+      if (listeners.size === 0 && detach) {
+        detach();
+        detach = null;
+      }
+    };
+  };
+}
+var webRouteWatcher = createRouteWatcher();
+function webRouteStorage() {
+  try {
+    const s = globalThis.sessionStorage;
+    if (!s || typeof s.getItem !== "function" || typeof s.setItem !== "function") return null;
+    s.getItem("feedback-kit:probe");
+    return s;
+  } catch {
+    return null;
+  }
+}
+
+// src/picking.ts
 var OWN_UI_ATTR = "data-feedback-kit";
 function defaultDocument() {
   return globalThis.document ?? null;
@@ -382,10 +514,13 @@ var ElementPickingController = class {
      */
     this.paused = false;
     this.attached = false;
+    /** 같은 요소 위 mousemove 마다 React 경로·선택자를 다시 만들지 않기 위한 캐시. */
+    this.hoveredTarget = null;
     this.hovered = null;
     this.popup = null;
     this.markers = [];
-    this.pathWatch = null;
+    /** 경로 감시 해제. 감시 중이 아니면 null. */
+    this.unwatchRoutes = null;
     this.saving = false;
     /** 늦게 끝난 캡처가 다음 주석의 그림을 덮지 못하게 하는 세대 번호. */
     this.shotGeneration = 0;
@@ -398,6 +533,7 @@ var ElementPickingController = class {
     this.userToggledHints = false;
     this.onClick = (event) => this.handleClick(event);
     this.onMouseOver = (event) => this.handleMouseOver(event);
+    this.onMouseMove = (event) => this.handleMouseOver(event);
     this.queue = opts.queue;
     this.createReport = opts.createReport;
     this.store = opts.store ?? new MarkerStore();
@@ -409,6 +545,7 @@ var ElementPickingController = class {
     this.reencode = opts.reencode ?? null;
     this.screenshotLimitBytes = opts.screenshotLimitBytes;
     this.rankHintsFor = opts.rankHintsFor ?? null;
+    this.watchRoutes = opts.watchRoutes === void 0 ? webRouteWatcher : opts.watchRoutes;
     this.lastPathname = this.getPathname();
     this.markers = this.store.list(this.lastPathname);
     this.unsubscribeQueue = this.queue.subscribe?.(() => {
@@ -457,6 +594,7 @@ var ElementPickingController = class {
     this.store.setPickingActive(false);
     this.detach();
     this.stopPathWatch();
+    this.hoveredTarget = null;
     this.hovered = null;
     this.popup = null;
     this.emit();
@@ -472,6 +610,7 @@ var ElementPickingController = class {
     if (!this.active || this.paused) return;
     this.paused = true;
     this.detach();
+    this.hoveredTarget = null;
     this.hovered = null;
     this.emit();
   }
@@ -499,6 +638,22 @@ var ElementPickingController = class {
     this.start();
     return true;
   }
+  /**
+   * 이 화면에 쌓인 마커 표시를 지운다.
+   *
+   * 지워지는 건 **화면 표시뿐**이다. 제보는 이미 큐를 거쳐 수집처로 갔으므로 없어지지 않는다.
+   * 마커는 `localStorage` 에 남아 새로고침에도 살아남는데(그게 원래 목적이다) 정작 치울
+   * 수단이 없어서, 한 번 보낸 [완료] 배지가 그 화면을 볼 때마다 계속 따라다녔다.
+   *
+   * 화면에 보이는 목록의 기준은 `lastPathname` 이다(`reconcileMarkerOutcomes` 와 같다).
+   * 이동 직후 아직 `syncPath` 가 안 돈 순간에도 "지금 눈에 보이는 것"이 지워져야 한다.
+   */
+  clearMarkers() {
+    if (this.markers.length === 0) return;
+    this.store.clear(this.lastPathname);
+    this.markers = [];
+    this.emit();
+  }
   /** 경로가 바뀌었을 때 그 경로의 마커로 갈아 끼운다. */
   syncPath() {
     if (this.paused) this.resume();
@@ -506,6 +661,7 @@ var ElementPickingController = class {
     this.markers = this.store.list(this.lastPathname);
     this.reconcileMarkerOutcomes();
     this.popup = null;
+    this.hoveredTarget = null;
     this.hovered = null;
     this.emit();
     return this.markers;
@@ -521,17 +677,26 @@ var ElementPickingController = class {
     if (this.attached || !this.doc) return;
     this.doc.addEventListener("click", this.onClick, true);
     this.doc.addEventListener("mouseover", this.onMouseOver, true);
+    this.doc.addEventListener("mousemove", this.onMouseMove, true);
     this.attached = true;
   }
   detach() {
     if (!this.attached || !this.doc) return;
     this.doc.removeEventListener("click", this.onClick, true);
     this.doc.removeEventListener("mouseover", this.onMouseOver, true);
+    this.doc.removeEventListener("mousemove", this.onMouseMove, true);
     this.attached = false;
   }
   handleMouseOver(event) {
     if (!this.active || this.paused || isOwnUi(event.target)) return;
-    this.hovered = describeElement(event.target);
+    const mouse = event;
+    const target = resolvePickTarget(event.target, {
+      x: mouse.clientX ?? 0,
+      y: mouse.clientY ?? 0
+    });
+    if (target === this.hoveredTarget) return;
+    this.hoveredTarget = target;
+    this.hovered = describeElement(target);
     this.emit();
   }
   handleClick(event) {
@@ -552,11 +717,12 @@ var ElementPickingController = class {
   /** 클릭 지점 기준으로 주석 팝업을 연다. 좌표는 해상도 무관한 상대값으로 접어 둔다. */
   openAnnotation(element, clientPoint) {
     const point = (0, import_feedback_kit_core.normalizePin)(clientPoint, this.getViewport());
+    const target = resolvePickTarget(element, clientPoint);
     if (this.onPick) {
-      this.onPick(describeElement(element), point);
+      this.onPick(describeElement(target), point);
       return;
     }
-    const info = describeElement(element);
+    const info = describeElement(target);
     this.userToggledHints = false;
     const hints = this.rankHintsFor ? this.rankHintsFor(info) : [];
     this.popup = {
@@ -771,17 +937,17 @@ ${hint.draft}`;
     return outcome;
   }
   startPathWatch() {
-    if (this.pathWatch !== null || typeof setInterval !== "function") return;
+    if (this.unwatchRoutes !== null || !this.watchRoutes) return;
     this.lastPathname = this.getPathname();
-    this.pathWatch = setInterval(() => {
+    this.unwatchRoutes = this.watchRoutes(() => {
       const pathname = this.getPathname();
       if (pathname !== this.lastPathname) this.syncPath();
-    }, 200);
+    });
   }
   stopPathWatch() {
-    if (this.pathWatch === null) return;
-    clearInterval(this.pathWatch);
-    this.pathWatch = null;
+    if (this.unwatchRoutes === null) return;
+    this.unwatchRoutes();
+    this.unwatchRoutes = null;
   }
   /** 전역 pending 수가 아니라 마커와 같은 clientSubmissionId의 확정 성공만 완료로 바꾼다. */
   reconcileMarkerOutcomes() {
@@ -1044,11 +1210,57 @@ function createWebWidget(opts) {
 }
 
 // src/feedback-kit.tsx
-var import_feedback_kit_core3 = require("@solhun/feedback-kit-core");
+var import_feedback_kit_core4 = require("@solhun/feedback-kit-core");
 var import_react = require("react");
 
 // src/version.ts
-var VERSION = true ? "0.7.0" : "dev";
+var VERSION = true ? "0.9.0" : "dev";
+
+// src/dev-clipboard.ts
+var import_feedback_kit_core3 = require("@solhun/feedback-kit-core");
+function sourceLine(item) {
+  const mapping = (0, import_feedback_kit_core3.sourceFromElement)(item.element ?? void 0);
+  if (!mapping.sourceFile) return null;
+  return mapping.sourceLine === null ? `\uC18C\uC2A4: ${mapping.sourceFile}` : `\uC18C\uC2A4: ${mapping.sourceFile}:${mapping.sourceLine}`;
+}
+function elementLine(element) {
+  if (!element) return null;
+  const selector = element.selector ?? element.tag;
+  const text = element.text?.trim();
+  return text ? `\uC694\uC18C: ${selector} "${text}"` : `\uC694\uC18C: ${selector}`;
+}
+function componentLine(element) {
+  const summary = element?.attributes?.["react-components"];
+  return summary ? `\uCEF4\uD3EC\uB10C\uD2B8: ${summary}` : null;
+}
+function renderDevClipItem(item) {
+  const lines = [`[\uD53C\uB4DC\uBC31] ${item.comment.trim()}`];
+  const screen = item.screen?.trim();
+  if (screen) lines.push(`\uD654\uBA74: ${screen}`);
+  const element = elementLine(item.element);
+  if (element) lines.push(element);
+  const component = componentLine(item.element);
+  if (component) lines.push(component);
+  const source = sourceLine(item);
+  if (source) lines.push(source);
+  if (item.priority && item.priority !== "unset") lines.push(`\uC6B0\uC120\uC21C\uC704: ${item.priority}`);
+  return lines.join("\n");
+}
+function renderDevClipList(items) {
+  if (items.length === 0) return "";
+  if (items.length === 1) return renderDevClipItem(items[0]);
+  return items.map((item, index) => `${index + 1}. ${renderDevClipItem(item).split("\n").join("\n   ")}`).join("\n\n");
+}
+async function writeToClipboard(text) {
+  const clipboard = globalThis.navigator?.clipboard;
+  if (!clipboard?.writeText) return false;
+  try {
+    await clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/feedback-kit.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -1314,8 +1526,13 @@ function PickToggle({
 }
 function PickBar({
   paused,
+  markerCount,
   onToggle,
-  onTogglePause
+  onTogglePause,
+  onClearMarkers,
+  onReportWholeScreen,
+  devClipCount,
+  onCopyAll
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
     "div",
@@ -1323,10 +1540,20 @@ function PickBar({
       style: {
         position: "fixed",
         top: 16,
-        left: "50%",
-        transform: "translateX(-50%)",
+        // `left:50% + translateX(-50%)` 로 가운데를 잡으면 **쓸 수 있는 폭이 화면의 절반**이
+        // 된다(transform 은 레이아웃 계산에 안 들어간다). 버튼이 셋이 되면서 그 절반에
+        // 안 맞아 좁은 화면에서 버튼이 한 줄에 하나씩 세로로 쌓였다(390px 에서 3줄).
+        // 양끝을 물리고 auto 마진으로 가운데를 잡으면 화면 전체 폭을 쓴다 — 같은 화면이 2줄.
+        left: 0,
+        right: 0,
+        marginInline: "auto",
+        width: "fit-content",
+        maxWidth: "calc(100% - 32px)",
         display: "flex",
         alignItems: "stretch",
+        justifyContent: "center",
+        // 셋이 한 줄에 안 들어가는 폭에서는 줄을 바꾼다 — 안 그러면 화면 밖으로 나간다.
+        flexWrap: "wrap",
         gap: 8,
         // 오버레이 자체는 클릭을 통과시킨다(pointerEvents:none) — 이 막대만 되살린다.
         pointerEvents: "auto",
@@ -1359,7 +1586,72 @@ function PickBar({
               paused ? "\uC9C0\uBAA9 \uC7AC\uAC1C" : "\uC7A0\uC2DC \uBA48\uCDA4"
             ]
           }
-        )
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "button",
+          {
+            type: "button",
+            "data-fk-pick-whole": "",
+            title: "\uAC00\uB9AC\uD0A8 \uC694\uC18C \uC5C6\uC774 \uC774 \uD654\uBA74 \uC804\uCCB4\uC5D0 \uB300\uD574 \uC81C\uBCF4\uD569\uB2C8\uB2E4.",
+            onClick: onReportWholeScreen,
+            style: {
+              ...baseButton,
+              display: "inline-flex",
+              alignItems: "center",
+              gap: 6,
+              whiteSpace: "nowrap"
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", children: "\u25A3" }),
+              "\uD654\uBA74 \uC804\uCCB4\uB85C \uBCF4\uB0B4\uAE30"
+            ]
+          }
+        ),
+        devClipCount > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "button",
+          {
+            type: "button",
+            "data-fk-copy-all": devClipCount,
+            title: "\uC774\uBC88 \uC138\uC158\uC5D0 \uCC0D\uC740 \uAC83\uC744 \uBC88\uD638 \uB9E4\uAE34 \uBAA9\uB85D \uD558\uB098\uB85C \uBCF5\uC0AC\uD569\uB2C8\uB2E4.",
+            onClick: onCopyAll,
+            style: {
+              ...baseButton,
+              display: "inline-flex",
+              alignItems: "center",
+              gap: 6,
+              whiteSpace: "nowrap",
+              fontWeight: 600
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", children: "\u29C9" }),
+              "\uC804\uBD80 \uBCF5\uC0AC ",
+              devClipCount
+            ]
+          }
+        ) : null,
+        markerCount > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "button",
+          {
+            type: "button",
+            "data-fk-pick-clear": markerCount,
+            title: "\uD654\uBA74\uC758 \uD45C\uC2DC\uB9CC \uC9C0\uC6C1\uB2C8\uB2E4. \uBCF4\uB0B8 \uC81C\uBCF4\uB294 \uADF8\uB300\uB85C \uB0A8\uC2B5\uB2C8\uB2E4.",
+            "aria-label": `\uC774 \uD654\uBA74\uC758 \uC8FC\uC11D \uD45C\uC2DC ${markerCount}\uAC1C \uC9C0\uC6B0\uAE30 (\uBCF4\uB0B8 \uC81C\uBCF4\uB294 \uADF8\uB300\uB85C \uB0A8\uC2B5\uB2C8\uB2E4)`,
+            onClick: onClearMarkers,
+            style: {
+              ...baseButton,
+              display: "inline-flex",
+              alignItems: "center",
+              gap: 6,
+              whiteSpace: "nowrap",
+              color: TOKENS.muted
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", children: "\u2715" }),
+              "\uD45C\uC2DC \uC9C0\uC6B0\uAE30 ",
+              markerCount
+            ]
+          }
+        ) : null
       ]
     }
   );
@@ -1391,7 +1683,7 @@ function HintChips({
       "button",
       {
         type: "button",
-        "data-fk-focus-id": import_feedback_kit_core3.MODAL_ACTION_HINT_TOGGLE,
+        "data-fk-focus-id": import_feedback_kit_core4.MODAL_ACTION_HINT_TOGGLE,
         "aria-expanded": hintsExpanded,
         disabled,
         onClick: onToggle,
@@ -1465,6 +1757,10 @@ function FeedbackKit(props) {
   const [widgetState, setWidgetState] = (0, import_react.useState)(null);
   const [pickingState, setPickingState] = (0, import_react.useState)(INITIAL_PICKING_STATE);
   const [announcement, setAnnouncement] = (0, import_react.useState)(null);
+  const [devMode] = (0, import_react.useState)(() => props.devMode === true);
+  const devClipsRef = (0, import_react.useRef)([]);
+  const [devClipCount, setDevClipCount] = (0, import_react.useState)(0);
+  const [devFallbackText, setDevFallbackText] = (0, import_react.useState)(null);
   const {
     queue,
     createReport,
@@ -1525,7 +1821,7 @@ function FeedbackKit(props) {
     }
     if (modal2.closeConfirmVisible && !previousConfirmVisibleRef.current) confirmRef.current?.focus();
     const wasModal = previousScreenRef.current === "modal";
-    if (wasModal && screen2 === "button" && modal2.restoreFocusTo === import_feedback_kit_core3.FLOATING_BUTTON_ID) {
+    if (wasModal && screen2 === "button" && modal2.restoreFocusTo === import_feedback_kit_core4.FLOATING_BUTTON_ID) {
       void nextPaint().then(() => floatingButtonRef.current?.focus());
     }
     previousScreenRef.current = screen2;
@@ -1589,6 +1885,39 @@ function FeedbackKit(props) {
       if (root) root.style.visibility = previousVisibility;
     }
   }
+  function currentClip() {
+    const state = pickingState.popup;
+    if (!state) return null;
+    return {
+      comment: state.comment,
+      element: state.element ?? null,
+      screen: typeof location === "undefined" ? null : location.pathname
+    };
+  }
+  async function putOnClipboard(text) {
+    const ok = await writeToClipboard(text);
+    setDevFallbackText(ok ? null : text);
+  }
+  async function copyOne() {
+    const clip = currentClip();
+    if (!clip || clip.comment.trim() === "") return;
+    devClipsRef.current = [...devClipsRef.current, clip];
+    setDevClipCount(devClipsRef.current.length);
+    activeKit.picking.cancelAnnotation();
+    await putOnClipboard(renderDevClipItem(clip));
+  }
+  async function copyAll() {
+    if (devClipsRef.current.length === 0) return;
+    await putOnClipboard(renderDevClipList(devClipsRef.current));
+  }
+  async function pressFloatingButton() {
+    if (props.defaultMode !== "report" && !pickingActive) {
+      setAnnouncement(null);
+      activeKit.widget.startPicking();
+      return;
+    }
+    await openReport();
+  }
   async function openReport() {
     setAnnouncement(null);
     await withOwnUiHidden(() => activeKit.widget.openReport());
@@ -1655,10 +1984,10 @@ function FeedbackKit(props) {
           "button",
           {
             ref: floatingButtonRef,
-            id: import_feedback_kit_core3.FLOATING_BUTTON_ID,
+            id: import_feedback_kit_core4.FLOATING_BUTTON_ID,
             type: "button",
             "aria-label": "\uD53C\uB4DC\uBC31 \uBCF4\uB0B4\uAE30",
-            onClick: () => void openReport(),
+            onClick: () => void pressFloatingButton(),
             style: {
               ...primaryButton,
               position: "fixed",
@@ -1673,6 +2002,66 @@ function FeedbackKit(props) {
             children: "\uD53C\uB4DC\uBC31"
           }
         ) : null,
+        floating && devMode ? (
+          // 켠 줄 모르고 제보하면 "보냈다"고 믿는데 수집처엔 아무것도 안 남는다.
+          // 조용한 유실이라 이 표시가 유일한 방어다. 버튼 **밖**에 두는 이유는 버튼의
+          // 접근성 이름을 오염시키지 않기 위해서다.
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            "span",
+            {
+              "data-fk-dev-badge": "",
+              "aria-label": "\uAC1C\uBC1C\uC6A9 \uBAA8\uB4DC\uAC00 \uCF1C\uC838 \uC788\uC2B5\uB2C8\uB2E4 \u2014 \uC81C\uBCF4\uAC00 \uC218\uC9D1\uCC98\uB85C \uAC00\uC9C0 \uC54A\uACE0 \uD074\uB9BD\uBCF4\uB4DC\uB85C \uBCF5\uC0AC\uB429\uB2C8\uB2E4",
+              style: {
+                position: "fixed",
+                right: 24,
+                bottom: 62,
+                zIndex: 2147483601,
+                padding: "2px 8px",
+                borderRadius: 6,
+                background: TOKENS.warning,
+                color: "#1f2933",
+                fontSize: 11,
+                fontWeight: 700,
+                pointerEvents: "none"
+              },
+              children: "\uAC1C\uBC1C\uC6A9 \u2014 \uD074\uB9BD\uBCF4\uB4DC\uB85C \uBCF5\uC0AC"
+            }
+          )
+        ) : null,
+        devFallbackText !== null ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "div",
+          {
+            role: "dialog",
+            "aria-label": "\uD074\uB9BD\uBCF4\uB4DC\uC5D0 \uBABB \uC368\uC11C \uB300\uC2E0 \uBCF4\uC5EC\uC90D\uB2C8\uB2E4",
+            "data-fk-dev-fallback": "",
+            style: {
+              position: "fixed",
+              right: 24,
+              bottom: 92,
+              zIndex: 2147483602,
+              width: "min(420px, calc(100vw - 48px))",
+              border: `1px solid ${TOKENS.line}`,
+              borderRadius: 12,
+              background: TOKENS.surface,
+              padding: 12,
+              boxShadow: TOKENS.shadow,
+              pointerEvents: "auto"
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { marginBottom: 6, color: TOKENS.muted, fontSize: 12 }, children: "\uD074\uB9BD\uBCF4\uB4DC\uC5D0 \uC4F0\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC544\uB798\uC5D0\uC11C \uC9C1\uC811 \uBCF5\uC0AC\uD558\uC138\uC694." }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                "textarea",
+                {
+                  readOnly: true,
+                  value: devFallbackText,
+                  onFocus: (event) => event.currentTarget.select(),
+                  style: { ...inputStyle, height: 140, fontFamily: "ui-monospace, monospace", fontSize: 12 }
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { display: "flex", justifyContent: "flex-end", marginTop: 8 }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: () => setDevFallbackText(null), style: baseButton, children: "\uB2EB\uAE30" }) })
+            ]
+          }
+        ) : null,
         announcement && !modal.open ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
           "div",
           {
@@ -1770,7 +2159,7 @@ function FeedbackKit(props) {
                         active: pickingActive,
                         paused: pickingState.paused,
                         disabled: draftLocked,
-                        focusId: import_feedback_kit_core3.MODAL_ACTION_PICK,
+                        focusId: import_feedback_kit_core4.MODAL_ACTION_PICK,
                         onToggle: togglePicking
                       }
                     ),
@@ -1804,7 +2193,7 @@ function FeedbackKit(props) {
                           "button",
                           {
                             type: "button",
-                            "data-fk-focus-id": import_feedback_kit_core3.MODAL_ACTION_REMOVE_SCREENSHOT,
+                            "data-fk-focus-id": import_feedback_kit_core4.MODAL_ACTION_REMOVE_SCREENSHOT,
                             disabled: draftLocked,
                             onClick: () => kit.widget.modal.removeScreenshot(),
                             style: baseButton,
@@ -1864,7 +2253,7 @@ function FeedbackKit(props) {
                       "textarea",
                       {
                         id: "feedback-kit-comment",
-                        "data-fk-focus-id": import_feedback_kit_core3.MODAL_FIELD_COMMENT,
+                        "data-fk-focus-id": import_feedback_kit_core4.MODAL_FIELD_COMMENT,
                         value: modal.comment,
                         disabled: draftLocked,
                         "aria-required": "true",
@@ -1885,7 +2274,7 @@ function FeedbackKit(props) {
                       "select",
                       {
                         id: "feedback-kit-priority",
-                        "data-fk-focus-id": import_feedback_kit_core3.MODAL_FIELD_PRIORITY,
+                        "data-fk-focus-id": import_feedback_kit_core4.MODAL_FIELD_PRIORITY,
                         value: modal.priority,
                         disabled: draftLocked,
                         onChange: (event) => kit.widget.modal.setPriority(event.currentTarget.value),
@@ -1917,7 +2306,7 @@ function FeedbackKit(props) {
                             "button",
                             {
                               type: "button",
-                              "data-fk-focus-id": import_feedback_kit_core3.MODAL_ACTION_RETRY,
+                              "data-fk-focus-id": import_feedback_kit_core4.MODAL_ACTION_RETRY,
                               onClick: () => void kit.widget.retryReport(),
                               style: { ...baseButton, marginLeft: 10 },
                               children: "\uB2E4\uC2DC \uBCF4\uB0B4\uAE30"
@@ -1931,7 +2320,7 @@ function FeedbackKit(props) {
                         "button",
                         {
                           type: "button",
-                          "data-fk-focus-id": import_feedback_kit_core3.MODAL_ACTION_CANCEL,
+                          "data-fk-focus-id": import_feedback_kit_core4.MODAL_ACTION_CANCEL,
                           onClick: closeReport,
                           style: baseButton,
                           children: "\uCDE8\uC18C"
@@ -1941,7 +2330,7 @@ function FeedbackKit(props) {
                         "button",
                         {
                           type: "submit",
-                          "data-fk-focus-id": import_feedback_kit_core3.MODAL_ACTION_SEND,
+                          "data-fk-focus-id": import_feedback_kit_core4.MODAL_ACTION_SEND,
                           disabled: !modal.canSubmit,
                           style: {
                             ...primaryButton,
@@ -2024,8 +2413,13 @@ function FeedbackKit(props) {
                 PickBar,
                 {
                   paused: pickingState.paused,
+                  markerCount: pickingState.markers.length,
                   onToggle: togglePicking,
-                  onTogglePause: () => activeKit.picking.togglePause()
+                  onTogglePause: () => activeKit.picking.togglePause(),
+                  onClearMarkers: () => activeKit.picking.clearMarkers(),
+                  onReportWholeScreen: () => void openReport(),
+                  devClipCount: devMode ? devClipCount : 0,
+                  onCopyAll: () => void copyAll()
                 }
               ),
               pickingState.markers.map((marker, index) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
@@ -2062,6 +2456,10 @@ function FeedbackKit(props) {
                   "aria-label": "\uC694\uC18C \uC8FC\uC11D",
                   onSubmit: (event) => {
                     event.preventDefault();
+                    if (devMode) {
+                      void copyOne();
+                      return;
+                    }
                     void kit.picking.saveAnnotation();
                   },
                   onPaste: (event) => {
@@ -2151,7 +2549,7 @@ function FeedbackKit(props) {
                         style: { ...inputStyle, resize: "vertical", minHeight: 58 }
                       }
                     ),
-                    popup.comment.length > import_feedback_kit_core3.COMMENT_MAX_CHARS ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { role: "alert", style: { marginTop: 4, color: TOKENS.danger }, children: "4,000\uC790 \uC774\uD558\uB85C \uC785\uB825\uD574\uC8FC\uC138\uC694" }) : null,
+                    popup.comment.length > import_feedback_kit_core4.COMMENT_MAX_CHARS ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { role: "alert", style: { marginTop: 4, color: TOKENS.danger }, children: "4,000\uC790 \uC774\uD558\uB85C \uC785\uB825\uD574\uC8FC\uC138\uC694" }) : null,
                     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                       "div",
                       {
@@ -2215,7 +2613,7 @@ function FeedbackKit(props) {
                             opacity: popup.canSave && !popup.saving ? 1 : 0.5,
                             cursor: popup.canSave && !popup.saving ? "pointer" : "not-allowed"
                           },
-                          children: popup.saving ? "\uBCF4\uB0B4\uB294 \uC911\u2026" : "\uBCF4\uB0B4\uAE30"
+                          children: popup.saving ? "\uBCF4\uB0B4\uB294 \uC911\u2026" : devMode ? "\uBCF5\uC0AC" : "\uBCF4\uB0B4\uAE30"
                         }
                       )
                     ] })
@@ -2251,6 +2649,13 @@ function webContextProviders() {
     }
   };
 }
+function webDiagnosticsOptions(opts = {}) {
+  return {
+    watchRoutes: webRouteWatcher,
+    routeStorage: webRouteStorage(),
+    ...opts
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMENT_MAX_CHARS,
@@ -2276,6 +2681,7 @@ function webContextProviders() {
   SUBMIT_PENDING_MESSAGE,
   WidgetController,
   captureWebScreenshot,
+  createRouteWatcher,
   createWebStorage,
   createWebWidget,
   cssSelectorPath,
@@ -2292,6 +2698,9 @@ function webContextProviders() {
   shouldShowWidget,
   sourceFromElement,
   visibleText,
-  webContextProviders
+  webContextProviders,
+  webDiagnosticsOptions,
+  webRouteStorage,
+  webRouteWatcher
 });
 //# sourceMappingURL=index.cjs.map