@rose42/t3-feedback 0.1.1 → 0.1.2

package/dist/client/mount.js

@@ -1,7 +1,7 @@
 import { captureFrameBurst, captureScreenshot, createSourceResolver, initFeedbackCapture, } from "@rose42/feedback-capture";
 import { T3_FEEDBACK_CLOSE_EVENT, T3_FEEDBACK_OPEN_EVENT } from "../controls.js";
 import { splitThreadTitleReportType } from "../bridge/format.js";
-import { formatShortcutLabel, resolveActivePlugins, resolveFabConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, } from "../types.js";
+import { formatShortcutLabel, resolveActivePlugins, resolveFabConfig, resolveOpenInEditorEndpointForApi, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, } from "../types.js";
 import { openInT3Seamless, shouldBypassSeamlessOpen } from "./openInT3.js";
 import { ACTIVE_THREAD_POLL_MS, clearActiveThreads, listActiveThreads, removeActiveThread, removeActiveThreads, upsertActiveThread, } from "./activeThreads.js";
 import { abortScreenshotRegions } from "./cropScreenshot.js";
@@ -14,6 +14,7 @@ import { createActionRegistry, createAfterPickRegistry, createBusyRegistry, crea
 import { createCommentPanelPlugin, createReportTypePanelPlugin } from "./ui/commentPanelPlugin.js";
 import { createCollectOnlyBuiltinPlugins, resolveAllPanelUiContributions, } from "./ui/defaultPlugins.js";
 import { createElementTargetPanelPlugin } from "./ui/elementTargetPanelPlugin.js";
+import { prefixSourceEnrichment } from "./ui/sourcePathPrefix.js";
 import { asPluginsWithUi } from "./ui/resolveContributions.js";
 import { createScreenshotPanelPlugin } from "./ui/screenshotPanelPlugin.js";
 import { mountSlotContributions } from "./ui/slots.js";
@@ -275,6 +276,9 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
   display: flex; align-items: center; justify-content: center;
   padding: 16px;
 }
+/* Author display:flex beats UA [hidden]; pick/capture set hidden while the overlay is down. */
+#${rootId} .t3f-backdrop[hidden],
+#${rootId} .t3f-backdrop.t3f-away { display: none !important; }
 #${rootId} .t3f-panel {
   position: relative;
   z-index: 1;
@@ -367,6 +371,8 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
 #${rootId} .t3f-section {
   display: grid; gap: 8px; min-width: 0; max-width: 100%;
 }
+/* Author display:grid beats UA [hidden] — sections start closed and clear must hide them. */
+#${rootId} .t3f-section[hidden] { display: none !important; }
 #${rootId} .t3f-section-head {
   display: flex; align-items: center; justify-content: space-between; gap: 8px;
   min-width: 0;
@@ -457,6 +463,7 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
   display: flex; flex-wrap: nowrap; align-items: center; gap: 10px;
   min-width: 0;
 }
+#${rootId} .t3f-clipboard-offer[hidden] { display: none !important; }
 #${rootId} .t3f-clipboard-preview-btn {
   flex: 0 0 auto;
   padding: 0; margin: 0; border: none; background: transparent;
@@ -487,6 +494,7 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
 #${rootId} .t3f-preview-wrap {
   display: grid; gap: 8px; min-width: 0;
 }
+#${rootId} .t3f-preview-wrap[hidden] { display: none !important; }
 #${rootId} .t3f-gallery {
   display: flex; flex-wrap: nowrap; gap: 8px; min-width: 0;
 }
@@ -523,12 +531,21 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
 }
 #${rootId} .t3f-thumb-tools {
   position: absolute; top: 2px; right: 2px; display: flex; gap: 2px;
-  opacity: 0; pointer-events: none;
+  opacity: 0;
   transition: opacity 0.12s ease;
 }
 #${rootId} .t3f-thumb:hover .t3f-thumb-tools,
 #${rootId} .t3f-thumb:focus-within .t3f-thumb-tools {
-  opacity: 1; pointer-events: auto;
+  opacity: 1;
+}
+/* Keep tools clickable while the pointer moves onto them (avoid pointer-events:none traps). */
+#${rootId} .t3f-thumb-tools {
+  pointer-events: none;
+}
+#${rootId} .t3f-thumb:hover .t3f-thumb-tools,
+#${rootId} .t3f-thumb:focus-within .t3f-thumb-tools,
+#${rootId} .t3f-thumb-tools:focus-within {
+  pointer-events: auto;
 }
 @media (hover: none) {
   #${rootId} .t3f-thumb-tools {
@@ -786,6 +803,8 @@ ${mobileOnly}#${rootId} .t3f-backdrop {
   min-width: 0;
   transition: background-color 0.12s ease, border-color 0.12s ease, color 0.12s ease;
 }
+/* Author display:inline-flex beats UA [hidden] — send XOR (solo vs New/Continue). */
+#${rootId} button.t3f-btn[hidden] { display: none !important; }
 #${rootId} button.t3f-btn:hover:not(:disabled) {
   background: #334155; border-color: #38bdf8;
 }
@@ -941,10 +960,16 @@ export function mountT3Feedback(options = {}) {
         return noopHandle();
     const rootId = options.rootId ?? "t3-feedback-root";
     const shortcut = resolveShortcut(options.shortcut, options.shortcutKey);
-    const pickConfig = resolvePickConfig(options.pick);
+    const endpoint = options.endpoint ?? "/__t3-feedback";
+    const pickConfig = (() => {
+        const resolved = resolvePickConfig(options.pick);
+        return {
+            ...resolved,
+            openInEditor: resolveOpenInEditorEndpointForApi(resolved.openInEditor, endpoint),
+        };
+    })();
     const screenshotConfig = resolveScreenshotConfig(options.screenshot, pickConfig.cropPaddingPx);
     const recordConfig = resolveRecordConfig(options.record);
-    const endpoint = options.endpoint ?? "/__t3-feedback";
     const activePluginSet = resolveActivePlugins(options.activePlugins, options.includeConsoleLogs);
     const pageContextActive = activePluginSet.has("pageContext");
     const consoleLogsActive = activePluginSet.has("consoleLogs");
@@ -1030,13 +1055,20 @@ export function mountT3Feedback(options = {}) {
         }
         return hostRef.current;
     };
-    const resolveSource = createSourceResolver({
+    const resolveSourceBase = createSourceResolver({
         framework: pickConfig.sourceFramework,
         sourceEndpoint: endpoint,
         ...(options.pick && "resolveSource" in options.pick && options.pick.resolveSource
             ? { resolveSource: options.pick.resolveSource }
             : {}),
     });
+    const sourcePathPrefix = pickConfig.sourcePathPrefix;
+    const resolveSource = resolveSourceBase && sourcePathPrefix
+        ? async (el) => {
+            const hit = await resolveSourceBase(el);
+            return hit ? prefixSourceEnrichment(hit, sourcePathPrefix) : hit;
+        }
+        : resolveSourceBase;
     const commentPanel = createCommentPanelPlugin({ copy });
     const reportTypeHintCaps = {
         pageContext: pageContextActive,
@@ -2382,14 +2414,20 @@ export function mountT3FeedbackFromConfig(config, customPlugins = []) {
             maxInnerHTMLLength: config.pick.maxInnerHTMLLength,
             styles: config.pick.styles,
             sourceFramework: config.pick.sourceFramework,
+            ...(config.pick.sourcePathPrefix ? { sourcePathPrefix: config.pick.sourcePathPrefix } : {}),
             openInEditor: config.pick.openInEditor === null
                 ? false
-                : config.pick.openInEditor.urlTemplate
-                    ? {
-                        endpoint: config.pick.openInEditor.endpoint,
-                        urlTemplate: config.pick.openInEditor.urlTemplate,
-                    }
-                    : { endpoint: config.pick.openInEditor.endpoint },
+                : (() => {
+                    const rewritten = resolveOpenInEditorEndpointForApi(config.pick.openInEditor, config.endpoint);
+                    if (!rewritten)
+                        return false;
+                    return rewritten.urlTemplate
+                        ? {
+                            endpoint: rewritten.endpoint,
+                            urlTemplate: rewritten.urlTemplate,
+                        }
+                        : { endpoint: rewritten.endpoint };
+                })(),
         },
         screenshot: {
             ...(config.screenshot.shortcut === null

package/dist/client/ui/backdropAway.d.ts

@@ -0,0 +1,2 @@
+/** Hide/show the compose backdrop during pick / capture / record. */
+export declare function setBackdropAway(backdrop: HTMLElement, away: boolean): void;

package/dist/client/ui/backdropAway.js

@@ -0,0 +1,12 @@
+/** Hide/show the compose backdrop during pick / capture / record. */
+export function setBackdropAway(backdrop, away) {
+    backdrop.hidden = away;
+    backdrop.classList.toggle("t3f-away", away);
+    // Inline !important — author `display:flex` on `.t3f-backdrop` otherwise wins over UA [hidden].
+    if (away) {
+        backdrop.style.setProperty("display", "none", "important");
+    }
+    else {
+        backdrop.style.removeProperty("display");
+    }
+}

package/dist/client/ui/elementTargetChip.d.ts

@@ -29,23 +29,31 @@ export declare function formatComponentLocation(loc: {
 }): string;
 /**
  * Build the URL used to open a source location.
- * - `urlTemplate` → navigate (IDE protocol / custom)
- * - else → Vite-style GET endpoint with `?file=`
+ * - `urlTemplate` → navigate (IDE protocol / custom); uses the displayed path
+ * - else → GET endpoint with `?file=` (Vite `/__open-in-editor` or the bridge
+ *   `/open-editor`). Strips `sourcePathPrefix` only for Vite's native endpoint,
+ *   which resolves against the app cwd; the bridge expects workspace-relative paths.
  */
 export declare function buildOpenInEditorUrl(loc: {
     fileName: string;
     line: number;
     column?: number;
-}, config: T3FeedbackOpenInEditorConfig): {
+}, config: T3FeedbackOpenInEditorConfig, options?: {
+    sourcePathPrefix?: string;
+}): {
     kind: "navigate" | "fetch";
     url: string;
 };
+/** True for Vite's built-in launcher (resolves paths against the Vite project root). */
+export declare function isViteNativeOpenInEditorEndpoint(endpoint: string): boolean;
 /** Open a resolved component location in the IDE (best-effort; never throws). */
 export declare function openSourceInEditor(loc: {
     fileName: string;
     line: number;
     column?: number;
-}, config: T3FeedbackOpenInEditorConfig, fetchFn?: typeof fetch): Promise<void>;
+}, config: T3FeedbackOpenInEditorConfig, fetchFn?: typeof fetch, options?: {
+    sourcePathPrefix?: string;
+}): Promise<void>;
 /** Split a `>`-joined CSS path into segments (trim empties). */
 export declare function splitCssSelectorParts(selector: string): string[];
 /**
@@ -61,4 +69,5 @@ export declare function formatElementChip(target: ElementChipTarget): string;
 export declare function buildTargetChipHtml(target: ElementChipTarget, options?: {
     openInEditor?: T3FeedbackOpenInEditorConfig | null;
     openInEditorLabel?: string;
+    sourcePathPrefix?: string;
 }): string;

package/dist/client/ui/elementTargetChip.js

@@ -1,5 +1,6 @@
 import { rankSourceHierarchy } from "@rose42/feedback-capture";
 import { escapeHtml } from "./html.js";
+import { stripSourcePathPrefix } from "./sourcePathPrefix.js";
 function asLoc(loc) {
     return loc;
 }
@@ -57,10 +58,12 @@ export function formatComponentLocation(loc) {
 }
 /**
  * Build the URL used to open a source location.
- * - `urlTemplate` → navigate (IDE protocol / custom)
- * - else → Vite-style GET endpoint with `?file=`
+ * - `urlTemplate` → navigate (IDE protocol / custom); uses the displayed path
+ * - else → GET endpoint with `?file=` (Vite `/__open-in-editor` or the bridge
+ *   `/open-editor`). Strips `sourcePathPrefix` only for Vite's native endpoint,
+ *   which resolves against the app cwd; the bridge expects workspace-relative paths.
  */
-export function buildOpenInEditorUrl(loc, config) {
+export function buildOpenInEditorUrl(loc, config, options) {
     const column = typeof loc.column === "number" && Number.isFinite(loc.column)
         ? Math.max(1, Math.floor(loc.column))
         : 1;
@@ -72,16 +75,25 @@ export function buildOpenInEditorUrl(loc, config) {
             .replaceAll("{column}", String(column));
         return { kind: "navigate", url };
     }
-    const fileParam = `${loc.fileName}:${line}:${column}`;
+    const stripForViteNative = Boolean(options?.sourcePathPrefix) && isViteNativeOpenInEditorEndpoint(config.endpoint);
+    const fileForEditor = stripForViteNative && options?.sourcePathPrefix
+        ? stripSourcePathPrefix(loc.fileName, options.sourcePathPrefix)
+        : loc.fileName;
+    const fileParam = `${fileForEditor}:${line}:${column}`;
     const sep = config.endpoint.includes("?") ? "&" : "?";
     return {
         kind: "fetch",
         url: `${config.endpoint}${sep}file=${encodeURIComponent(fileParam)}`,
     };
 }
+/** True for Vite's built-in launcher (resolves paths against the Vite project root). */
+export function isViteNativeOpenInEditorEndpoint(endpoint) {
+    const pathOnly = endpoint.split("?")[0] ?? endpoint;
+    return pathOnly === "/__open-in-editor" || pathOnly.endsWith("/__open-in-editor");
+}
 /** Open a resolved component location in the IDE (best-effort; never throws). */
-export async function openSourceInEditor(loc, config, fetchFn = fetch) {
-    const built = buildOpenInEditorUrl(loc, config);
+export async function openSourceInEditor(loc, config, fetchFn = fetch, options) {
+    const built = buildOpenInEditorUrl(loc, config, options);
     try {
         if (built.kind === "navigate") {
             window.location.href = built.url;
@@ -136,7 +148,9 @@ function buildOpenableLocHtml(loc, options) {
                 ? { column: loc.column }
                 : {}),
         };
-        const built = buildOpenInEditorUrl(locAttrs, openConfig);
+        const built = buildOpenInEditorUrl(locAttrs, openConfig, {
+            ...(options?.sourcePathPrefix ? { sourcePathPrefix: options.sourcePathPrefix } : {}),
+        });
         if (built.kind === "navigate") {
             return `<a class="t3f-target-file" href="${escapeHtml(built.url)}" title="${openLabel}" aria-label="${openLabel}: ${text}">${text}</a>`;
         }

package/dist/client/ui/elementTargetPanelSession.js

@@ -1,4 +1,5 @@
 import { collectElementTargetAsync, createElementTargetPlugin, } from "@rose42/feedback-capture";
+import { setBackdropAway } from "./backdropAway.js";
 import { buildTargetChipHtml, formatElementChip, openSourceInEditor, selectorAtAncestorDepth, } from "./elementTargetChip.js";
 const PICK_DETAILS_STORAGE_KEY = "t3-feedback:pick-details";
 export function readPickDetailsPrefs(fallback) {
@@ -99,6 +100,7 @@ export function bindElementTargetPanelSession(options) {
         targetChip.innerHTML = buildTargetChipHtml(target, {
             openInEditor: pickConfig.openInEditor,
             openInEditorLabel: copy.openInEditorLabel,
+            ...(pickConfig.sourcePathPrefix ? { sourcePathPrefix: pickConfig.sourcePathPrefix } : {}),
         });
         targetChip.title = chip;
         targetBlock.hidden = false;
@@ -171,7 +173,7 @@ export function bindElementTargetPanelSession(options) {
             fileName,
             line,
             ...(typeof column === "number" && Number.isFinite(column) ? { column } : {}),
-        }, pickConfig.openInEditor);
+        }, pickConfig.openInEditor, fetch, pickConfig.sourcePathPrefix ? { sourcePathPrefix: pickConfig.sourcePathPrefix } : undefined);
     });
     targetChip.addEventListener("pointerover", (event) => {
         const target = elementPlugin.getTarget();
@@ -213,7 +215,7 @@ export function bindElementTargetPanelSession(options) {
     });
     const runPickFlow = async () => {
         const releasePicking = registerBusy("picking");
-        backdrop.hidden = true;
+        setBackdropAway(backdrop, true);
         setStatus(copy.pickingStatus);
         try {
             const details = readPickDetailsFromUi();
@@ -225,7 +227,7 @@ export function bindElementTargetPanelSession(options) {
             });
             if (!isOpen())
                 return;
-            backdrop.hidden = false;
+            setBackdropAway(backdrop, false);
             if (!picked) {
                 setStatus(copy.pickCancelledStatus);
                 focusComment();
@@ -243,7 +245,7 @@ export function bindElementTargetPanelSession(options) {
         finally {
             releasePicking();
             if (isOpen())
-                backdrop.hidden = false;
+                setBackdropAway(backdrop, false);
         }
     };
     form.querySelector('[data-act="clear-pick"]')?.addEventListener("click", () => {

package/dist/client/ui/screenshotPanelSession.js

@@ -2,6 +2,7 @@ import { attachImagePasteHandler, captureFrameBurst, captureScreenshot, cropData
 import { selectScreenshotRegion } from "../cropScreenshot.js";
 import { readClipboardImageDataUrl } from "../readClipboardImage.js";
 import { selectBurstFrames } from "../selectBurstFrames.js";
+import { setBackdropAway } from "./backdropAway.js";
 import { CLOSE_ICON_SVG, CROP_ICON_SVG, escapeHtml } from "./html.js";
 function loadImageNaturalSize(dataUrl) {
     return new Promise((resolve, reject) => {
@@ -252,7 +253,7 @@ export function bindScreenshotPanelSession(options) {
             return;
         }
         const releaseRecording = registerBusy("recording");
-        backdrop.hidden = true;
+        setBackdropAway(backdrop, true);
         setStatus(copy.recordingStatus);
         hideClipboardOffer();
         const overlay = document.createElement("div");
@@ -280,7 +281,7 @@ export function bindScreenshotPanelSession(options) {
             overlay.remove();
             if (!isOpen())
                 return;
-            backdrop.hidden = false;
+            setBackdropAway(backdrop, false);
             if (!frames || frames.length === 0) {
                 setStatus(copy.recordFailedStatus, "err");
                 return;
@@ -315,7 +316,7 @@ export function bindScreenshotPanelSession(options) {
             overlay.remove();
             releaseRecording();
             if (isOpen())
-                backdrop.hidden = false;
+                setBackdropAway(backdrop, false);
         }
     };
     const insertClipboardOffer = async () => {
@@ -325,34 +326,40 @@ export function bindScreenshotPanelSession(options) {
         hideClipboardOffer();
         await attachScreenshot(dataUrl, copy.pastedAttachedStatus, "direct");
     };
-    form.querySelector('[data-act="clear-shot"]')?.addEventListener("click", () => {
-        clearGallery();
-        setStatus("");
-    });
-    form.querySelectorAll('[data-act="shot"]').forEach((el) => {
-        el.addEventListener("click", () => {
+    // Delegate so clear/dismiss keep working if slot hosts remount or icons swallow hits.
+    const onFormClick = (event) => {
+        const hit = event.target?.closest?.("[data-act]");
+        if (!hit || !form.contains(hit))
+            return;
+        const act = hit.getAttribute("data-act");
+        if (act === "clear-shot") {
+            event.preventDefault();
+            clearGallery();
+            setStatus("");
+            return;
+        }
+        if (act === "clipboard-dismiss") {
+            event.preventDefault();
+            hideClipboardOffer();
+            syncGallery();
+            return;
+        }
+        if (act === "shot") {
+            event.preventDefault();
             void runShotFlow();
-        });
-    });
-    form.querySelectorAll('[data-act="record"]').forEach((el) => {
-        el.addEventListener("click", () => {
+            return;
+        }
+        if (act === "record") {
+            event.preventDefault();
             void runRecordFlow();
-        });
-    });
-    form.querySelector('[data-act="clipboard-dismiss"]')?.addEventListener("click", () => {
-        hideClipboardOffer();
-    });
-    form.querySelectorAll('[data-act="clipboard-insert"]').forEach((el) => {
-        el.addEventListener("click", () => {
-            void insertClipboardOffer();
-        });
-    });
-    galleryEl.addEventListener("click", (event) => {
-        const hit = event.target?.closest?.("button.t3f-thumb-clipboard");
-        if (!hit || !galleryEl.contains(hit))
             return;
-        void insertClipboardOffer();
-    });
+        }
+        if (act === "clipboard-insert") {
+            event.preventDefault();
+            void insertClipboardOffer();
+        }
+    };
+    form.addEventListener("click", onFormClick);
     const detachPaste = attachImagePasteHandler(form, (dataUrl) => {
         hideClipboardOffer();
         void attachScreenshot(dataUrl, copy.pastedAttachedStatus, "direct");
@@ -429,6 +436,7 @@ export function bindScreenshotPanelSession(options) {
     }
     return {
         dispose: () => {
+            form.removeEventListener("click", onFormClick);
             detachAfterPick?.();
             detachPaste();
         },

package/dist/client/ui/sourcePathPrefix.d.ts

@@ -0,0 +1,12 @@
+import type { ElementSourceEnrichment } from "@rose42/feedback-capture";
+import { normalizePickSourcePathPrefix } from "../../types.js";
+export { normalizePickSourcePathPrefix as normalizeSourcePathPrefix };
+/** Prefix an app-relative file path when it is not already under `prefix`. */
+export declare function prefixSourceFileName(fileName: string, prefix: string): string;
+/**
+ * Strip a previously applied prefix (for Vite `/__open-in-editor`, which resolves
+ * against the app cwd rather than the monorepo / workspace root).
+ */
+export declare function stripSourcePathPrefix(fileName: string, prefix: string): string;
+/** Prefix component / leaf / owners file names on a source enrichment. */
+export declare function prefixSourceEnrichment(enrichment: ElementSourceEnrichment, prefix: string): ElementSourceEnrichment;

package/dist/client/ui/sourcePathPrefix.js

@@ -0,0 +1,39 @@
+import { normalizePickSourcePathPrefix } from "../../types.js";
+export { normalizePickSourcePathPrefix as normalizeSourcePathPrefix };
+/** Prefix an app-relative file path when it is not already under `prefix`. */
+export function prefixSourceFileName(fileName, prefix) {
+    const file = fileName.replace(/\\/g, "/").trim();
+    if (!file || file.startsWith("/") || /^[a-zA-Z]:\//.test(file))
+        return fileName;
+    if (file === prefix || file.startsWith(`${prefix}/`))
+        return file;
+    return `${prefix}/${file.replace(/^\/+/, "")}`;
+}
+/**
+ * Strip a previously applied prefix (for Vite `/__open-in-editor`, which resolves
+ * against the app cwd rather than the monorepo / workspace root).
+ */
+export function stripSourcePathPrefix(fileName, prefix) {
+    const file = fileName.replace(/\\/g, "/");
+    const p = prefix.replace(/\\/g, "/").replace(/\/+$/, "");
+    if (file === p)
+        return fileName;
+    if (file.startsWith(`${p}/`))
+        return file.slice(p.length + 1);
+    return fileName;
+}
+function mapLoc(loc, prefix) {
+    return { ...loc, fileName: prefixSourceFileName(loc.fileName, prefix) };
+}
+/** Prefix component / leaf / owners file names on a source enrichment. */
+export function prefixSourceEnrichment(enrichment, prefix) {
+    const out = { ...enrichment };
+    if (enrichment.component)
+        out.component = mapLoc(enrichment.component, prefix);
+    if (enrichment.leaf)
+        out.leaf = mapLoc(enrichment.leaf, prefix);
+    if (enrichment.owners) {
+        out.owners = enrichment.owners.map((loc) => mapLoc(loc, prefix));
+    }
+    return out;
+}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { t3FeedbackPlugin, T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, default, } from "./plugin.js";
-export type { FeedbackSendResult, ThreadListItem, ThreadProbeResult, ThreadProbeState, ThreadSettleResult, ThreadsListResponse, ThreadsProbeResponse, ThreadsSettleResponse, T3BuiltinPluginId, T3FeedbackAfterPick, T3FeedbackBuiltinPluginOptions, T3FeedbackClientConfig, T3FeedbackFabConfig, T3FeedbackFabOptions, T3FeedbackFabPosition, T3FeedbackFabVisibility, T3FeedbackOpenHandoff, T3FeedbackOpenInEditorConfig, T3FeedbackOpenInEditorOptions, T3FeedbackPickConfig, T3FeedbackPickOptions, T3FeedbackPluginOptions, T3FeedbackRecordConfig, T3FeedbackRecordOptions, T3FeedbackReportTypeGlyph, T3FeedbackReportTypeGlyphCustom, T3FeedbackReportTypeGlyphMap, T3FeedbackReportTypeGlyphResolved, T3FeedbackScreenshotConfig, T3FeedbackScreenshotCrop, T3FeedbackScreenshotOptions, T3FeedbackShortcutConfig, T3FeedbackShortcutOptions, T3FeedbackThreadReuse, } from "./types.js";
-export { DEFAULT_FAB_CONFIG, DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, resolveActivePluginList, resolveActivePlugins, resolveFabConfig, resolveOpenInEditorConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "./types.js";
+export { t3FeedbackPlugin, T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, default, } from "./plugin.js";
+export type { FeedbackSendResult, ThreadListItem, ThreadProbeResult, ThreadProbeState, ThreadSettleResult, ThreadsListResponse, ThreadsProbeResponse, ThreadsSettleResponse, T3BuiltinPluginId, T3FeedbackAfterPick, T3FeedbackBuiltinPluginOptions, T3FeedbackClientConfig, T3FeedbackFabConfig, T3FeedbackFabOptions, T3FeedbackFabPosition, T3FeedbackFabVisibility, T3FeedbackModelSelection, T3FeedbackOpenHandoff, T3FeedbackOpenInEditorConfig, T3FeedbackOpenInEditorOptions, T3FeedbackPickConfig, T3FeedbackPickOptions, T3FeedbackPluginOptions, T3FeedbackRecordConfig, T3FeedbackRecordOptions, T3FeedbackReportTypeGlyph, T3FeedbackReportTypeGlyphCustom, T3FeedbackReportTypeGlyphMap, T3FeedbackReportTypeGlyphResolved, T3FeedbackScreenshotConfig, T3FeedbackScreenshotCrop, T3FeedbackScreenshotOptions, T3FeedbackShortcutConfig, T3FeedbackShortcutOptions, T3FeedbackThreadReuse, } from "./types.js";
+export { DEFAULT_FAB_CONFIG, DEFAULT_MODEL_SELECTION, DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, normalizeModelSelection, resolveActivePluginList, resolveActivePlugins, resolveFabConfig, resolveOpenInEditorConfig, resolveOpenInEditorEndpointForApi, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "./types.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { t3FeedbackPlugin, T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, default, } from "./plugin.js";
-export { DEFAULT_FAB_CONFIG, DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, resolveActivePluginList, resolveActivePlugins, resolveFabConfig, resolveOpenInEditorConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "./types.js";
+export { t3FeedbackPlugin, T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, default, } from "./plugin.js";
+export { DEFAULT_FAB_CONFIG, DEFAULT_MODEL_SELECTION, DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, normalizeModelSelection, resolveActivePluginList, resolveActivePlugins, resolveFabConfig, resolveOpenInEditorConfig, resolveOpenInEditorEndpointForApi, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "./types.js";

package/dist/plugin.d.ts

@@ -1,9 +1,14 @@
 import type { Plugin } from "vite";
 import { type T3FeedbackPluginOptions } from "./types.js";
-export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, } from "./bridge/paths.js";
+export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, } from "./bridge/paths.js";
 export { parseFeedbackPost, parseOpenHandoffRequest, parseSettlePost, parseThreadProbeIds, } from "./bridge/parse.js";
 /** Resolve a `customPlugins` entry against the Vite project root (bare ids stay bare). */
 export declare function resolveCustomPluginModuleId(entry: string, root: string): string;
+/**
+ * When Vite root sits under a workspace hint, return the relative prefix
+ * (e.g. hint=`/repo`, root=`/repo/examples/vite-react` → `examples/vite-react`).
+ */
+export declare function deriveSourcePathPrefix(viteRoot: string, workspaceRootHints: readonly string[] | undefined): string | undefined;
 /** Vite plugin that exposes POST /__t3-feedback and bridges envelopes to T3. */
 export declare function t3FeedbackPlugin(options?: T3FeedbackPluginOptions): Plugin;
 export default t3FeedbackPlugin;

package/dist/plugin.js

@@ -1,9 +1,10 @@
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { normalizePath } from "vite";
 import { handleT3FeedbackRequest } from "./bridge/http.js";
 import { T3_FEEDBACK_API_PATH } from "./bridge/paths.js";
-import { resolveActivePluginList, resolveFabConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, } from "./types.js";
-export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, } from "./bridge/paths.js";
+import { resolveActivePluginList, resolveFabConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, normalizePickSourcePathPrefix, } from "./types.js";
+export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_THREADS_PATH, } from "./bridge/paths.js";
 export { parseFeedbackPost, parseOpenHandoffRequest, parseSettlePost, parseThreadProbeIds, } from "./bridge/parse.js";
 /** Resolve a `customPlugins` entry against the Vite project root (bare ids stay bare). */
 export function resolveCustomPluginModuleId(entry, root) {
@@ -17,6 +18,25 @@ export function resolveCustomPluginModuleId(entry, root) {
     }
     return trimmed;
 }
+/**
+ * When Vite root sits under a workspace hint, return the relative prefix
+ * (e.g. hint=`/repo`, root=`/repo/examples/vite-react` → `examples/vite-react`).
+ */
+export function deriveSourcePathPrefix(viteRoot, workspaceRootHints) {
+    if (!workspaceRootHints?.length)
+        return undefined;
+    const rootResolved = path.resolve(viteRoot);
+    for (const hint of workspaceRootHints) {
+        if (typeof hint !== "string" || !hint.trim())
+            continue;
+        const hintResolved = path.resolve(hint.trim());
+        const rel = path.relative(hintResolved, rootResolved);
+        if (!rel || rel.startsWith("..") || path.isAbsolute(rel))
+            continue;
+        return normalizePickSourcePathPrefix(rel.replace(/\\/g, "/"));
+    }
+    return undefined;
+}
 function resolvePluginOptions(options) {
     if (!options)
         return undefined;
@@ -104,23 +124,70 @@ export function t3FeedbackPlugin(options = {}) {
     const customPluginEntries = (options.customPlugins ?? [])
         .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
         .filter(Boolean);
+    // Absolute dist entry. Prefer a real filesystem id (not `/@fs/...`) so Vite still
+    // runs import-analysis and rewrites bare deps like `@rose42/feedback-capture`.
+    // Combined with `link:` example installs, `tsc --watch` updates are visible without
+    // a stale optimizeDeps prebundle of this package.
+    const clientEntry = normalizePath(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "client/index.js"));
+    // `dist/client/index.js` → package root (must be fs-allowed when linked from an example).
+    const packageRoot = normalizePath(path.resolve(path.dirname(clientEntry), "../.."));
     const bridgeServerOptions = {
         basePath: T3_FEEDBACK_API_PATH,
         ...(options.origin ? { origin: options.origin } : {}),
         ...(options.openOrigin ? { openOrigin: options.openOrigin } : {}),
         ...(workspaceRootHints ? { workspaceRootHints } : {}),
         ...(threadTitlePrefix ? { threadTitlePrefix } : {}),
+        ...(options.modelSelection ? { modelSelection: options.modelSelection } : {}),
         reportTypeGlyph,
     };
     return {
         name: "t3-feedback",
         apply: "serve",
+        enforce: "pre",
+        config() {
+            return {
+                resolve: {
+                    alias: {
+                        "@rose42/t3-feedback/client": clientEntry,
+                    },
+                    // qwikVite sets `resolve.conditions: []` in DEV, which drops Vite's
+                    // default "development" export condition. `@builder.io/qwik` then
+                    // resolves to `core.prod.mjs` (qInspector hard-disabled), so
+                    // `data-qwik-inspector` is never written and element pick can't
+                    // resolve components. Restoring "development" is a no-op for other
+                    // frameworks (Vite's client default already includes it).
+                    conditions: ["development"],
+                },
+                optimizeDeps: {
+                    // Keep the linked client out of the deps cache; prebundle its runtime dep.
+                    exclude: ["@rose42/t3-feedback", "@rose42/t3-feedback/client"],
+                    include: ["@rose42/feedback-capture"],
+                },
+                server: {
+                    fs: {
+                        allow: [packageRoot],
+                    },
+                    watch: {
+                        ignored: ["!**/node_modules/@rose42/t3-feedback/**"],
+                    },
+                },
+            };
+        },
         configResolved(config) {
             viteRoot = config.root;
+            // Nested app under a monorepo / T3 workspace: prefix chip + agent paths.
+            if (!clientConfig.pick.sourcePathPrefix) {
+                const derived = deriveSourcePathPrefix(config.root, workspaceRootHints);
+                if (derived) {
+                    clientConfig.pick = { ...clientConfig.pick, sourcePathPrefix: derived };
+                }
+            }
         },
         resolveId(id) {
             if (id === VIRTUAL_CLIENT_ID)
                 return RESOLVED_VIRTUAL_CLIENT_ID;
+            if (id === "@rose42/t3-feedback/client")
+                return clientEntry;
         },
         load(id) {
             if (id !== RESOLVED_VIRTUAL_CLIENT_ID)
@@ -135,8 +202,8 @@ export function t3FeedbackPlugin(options = {}) {
                     .map((_, i) => `  ...normalizeCustomPluginExport(custom${i})`)
                     .join(",\n")}\n]`;
             const clientImports = resolvedCustoms.length === 0
-                ? `import { mountT3FeedbackFromConfig } from "@rose42/t3-feedback/client";`
-                : `import { mountT3FeedbackFromConfig, normalizeCustomPluginExport } from "@rose42/t3-feedback/client";`;
+                ? `import { mountT3FeedbackFromConfig } from ${JSON.stringify(clientEntry)};`
+                : `import { mountT3FeedbackFromConfig, normalizeCustomPluginExport } from ${JSON.stringify(clientEntry)};`;
             return `
 ${clientImports}
 ${customImports}