@rose42/feedback-capture 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rose42
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# feedback-capture
+
+**Browser feedback capture as a typed plugin envelope** — screenshot, URL, comment, console logs, element pick with source enrichment — for DX tools (Vite / [T3 Code](https://github.com/pingdotgg/t3code)) and production feedback flows.
+
+UI-free: own the panel in React/Vue/Angular/vanilla; this package registers collectors and builds the envelope.
+
+Until the first npm release, install from this repo via the [local link workflow](./docs/local-link.md). After publish:
+
+```bash
+pnpm add @rose42/feedback-capture
+```
+
+## What you get
+
+Compose collectors as plugins. Each plugin owns one key on a typed `FeedbackEnvelope`. Init runs `setup`, `build()` snapshots everything, `dispose()` tears down.
+
+- **Screenshots & frame bursts** tab capture, clipboard image read, paste handler, multi-image gallery helpers, smart change detection
+- **Element pick** CSS selector + bbox; optional silent crop around the target
+- **Source enrichment** best-effort file/line via React, Next.js, _untested: Vue, Svelte, Qwik, or LocatorJS_
+- **Page context** URL and viewport
+- **App version** optional metadata via `createVersionPlugin`
+- **Console buffer** ring buffer of logs from setup until send
+- **Pluggable transport** `createHttpTransport`, or your own `send(envelope)`
+
+Host UI (FAB, panels, report-type gating, labels) lives in consumers such as [`@rose42/t3-feedback`](https://gitlab.com/rose42/t3-feedback).
+
+## Quick start
+
+```ts
+import {
+  captureScreenshot,
+  createCommentPlugin,
+  createConsoleLogsPlugin,
+  createElementTargetPlugin,
+  createHttpTransport,
+  createPageContextPlugin,
+  createScreenshotPlugin,
+  initFeedbackCapture,
+} from "@rose42/feedback-capture";
+
+const element = createElementTargetPlugin();
+const feedback = initFeedbackCapture({
+  plugins: [
+    createPageContextPlugin(),
+    element,
+    createConsoleLogsPlugin({ maxEntries: 200 }),
+  ] as const,
+});
+
+await element.pick();
+
+const shot = await captureScreenshot();
+const envelope = await feedback.build([
+  createCommentPlugin({ getComment: () => "Button looks off on mobile" }),
+  ...(shot !== undefined ? [createScreenshotPlugin({ getDataUrl: () => shot })] : []),
+]);
+
+const transport = createHttpTransport({ url: "/api/feedback" });
+await transport.send(envelope);
+feedback.dispose();
+```
+
+For a T3 Code / Vite overlay, use [`@rose42/t3-feedback`](https://gitlab.com/rose42/t3-feedback) (or link the sibling package while developing).
+
+## Documentation
+
+| Doc                                         | Contents                                        |
+| ------------------------------------------- | ----------------------------------------------- |
+| [API reference](./docs/api.md)              | Exports, plugins, source adapters, init → build |
+| [Local link workflow](./docs/local-link.md) | Develop against a consumer before npm publish   |
+| [Release](./docs/release.md)                | Tag-driven GitLab → npm publish                 |
+| [Dev Container](./docs/devcontainer.md)     | One-click Node / pnpm / T3 Code setup           |
+
+## Status
+
+Early. The API is usable and covered by tests; treat `0.x` as subject to change. First public npm release is still ahead — until then, use the [local link workflow](./docs/local-link.md).
+
+## Develop
+
+```bash
+git clone https://gitlab.com/rose42/feedback-capture.git
+cursor feedback-capture
+```
+
+### Devcontainer
+
+One-click Dev Container (Node, pnpm, T3 via `T3CODE_PORT`, default **3774** — [change in `.devcontainer/devcontainer.json`](./.devcontainer/devcontainer.json)). See [docs/devcontainer.md](./docs/devcontainer.md).
+
+### Scripts
+
+```bash
+pnpm typecheck
+pnpm lint
+pnpm format:check
+pnpm test
+pnpm build
+```
+
+Watch `dist/` while iterating against a consumer:
+
+```bash
+pnpm dev
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/clipboard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Best-effort read of the first image on the system clipboard as a data URL.
+ * Returns undefined when the Clipboard API is unavailable, permission is denied,
+ * or the clipboard has no image.
+ */
+export declare function readClipboardImageDataUrl(): Promise<string | undefined>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7E"}

package/dist/clipboard.js

@@ -0,0 +1,33 @@
+function blobToDataUrl(blob) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result));
+        reader.onerror = () => reject(reader.error ?? new Error("Failed to read clipboard image"));
+        reader.readAsDataURL(blob);
+    });
+}
+/**
+ * Best-effort read of the first image on the system clipboard as a data URL.
+ * Returns undefined when the Clipboard API is unavailable, permission is denied,
+ * or the clipboard has no image.
+ */
+export async function readClipboardImageDataUrl() {
+    try {
+        if (typeof navigator === "undefined" || !navigator.clipboard?.read) {
+            return undefined;
+        }
+        const items = await navigator.clipboard.read();
+        for (const item of items) {
+            const type = item.types.find((t) => t.startsWith("image/"));
+            if (!type)
+                continue;
+            const blob = await item.getType(type);
+            return await blobToDataUrl(blob);
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA,SAAS,aAAa,CAAC,IAAU;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,IAAI,CAAC;QACH,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;YACnE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+import { collectPageContext, type FeedbackCapturePlugin, type PageContext } from "./plugins/index.js";
+import type { FeedbackEnvelope } from "./types.js";
+export type { PageContext };
+export type BuildFeedbackEnvelopeInput<Ps extends readonly FeedbackCapturePlugin[] = readonly FeedbackCapturePlugin[]> = {
+    plugins: Ps;
+};
+/** Assemble a FeedbackEnvelope by collecting all registered plugins. */
+export declare function buildFeedbackEnvelope<const Ps extends readonly FeedbackCapturePlugin[]>(input: BuildFeedbackEnvelopeInput<Ps>): Promise<FeedbackEnvelope<Ps>>;
+export { collectPageContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,MAAM,MAAM,0BAA0B,CACpC,EAAE,SAAS,SAAS,qBAAqB,EAAE,GAAG,SAAS,qBAAqB,EAAE,IAC5E;IACF,OAAO,EAAE,EAAE,CAAC;CACb,CAAC;AAEF,wEAAwE;AACxE,wBAAsB,qBAAqB,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,qBAAqB,EAAE,EAC3F,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAE/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/context.js

@@ -0,0 +1,7 @@
+import { collectPageContext, collectPluginExtras, } from "./plugins/index.js";
+/** Assemble a FeedbackEnvelope by collecting all registered plugins. */
+export async function buildFeedbackEnvelope(input) {
+    return collectPluginExtras(input.plugins);
+}
+export { collectPageContext };
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAW5B,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAqC;IAErC,OAAO,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/crop.d.ts

@@ -0,0 +1,61 @@
+/** Axis-aligned crop in natural image pixels. */
+export type CropRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type ElementBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type ViewportMetrics = {
+    width: number;
+    height: number;
+    devicePixelRatio: number;
+};
+export type ImageNaturalSize = {
+    width: number;
+    height: number;
+};
+export type ElementBoxToCropRectOptions = {
+    /** Extra CSS pixels expanded around the box before scaling (default: 12). */
+    paddingPx?: number;
+    /** Minimum crop edge in natural pixels (default: 8). */
+    minSize?: number;
+};
+/**
+ * Map a CSS-viewport element box to a crop rect in screenshot natural pixels.
+ * Uses `devicePixelRatio` scaling (best-effort for preferCurrentTab captures).
+ */
+export declare function elementBoxToCropRect(box: ElementBox, viewport: ViewportMetrics, image: ImageNaturalSize, options?: ElementBoxToCropRectOptions): CropRect | null;
+/** Crop a PNG/JPEG data URL to `rect` (natural pixels); returns a PNG data URL. */
+export declare function cropDataUrl(dataUrl: string, rect: CropRect): Promise<string>;
+/** Where an object-fit:contain image sits inside its element box. */
+export type ContainedImageLayout = {
+    offsetX: number;
+    offsetY: number;
+    displayWidth: number;
+    displayHeight: number;
+    naturalWidth: number;
+    naturalHeight: number;
+    scale: number;
+};
+/** Layout of a natural-size image inside a contain-fitted display box. */
+export declare function containedImageLayout(naturalWidth: number, naturalHeight: number, boxWidth: number, boxHeight: number): ContainedImageLayout;
+/** Map a point in the element’s client box to natural image pixels (clamped). */
+export declare function clientPointToNatural(layout: ContainedImageLayout, localX: number, localY: number): {
+    x: number;
+    y: number;
+};
+/** Normalize a drag from two natural-space points into a CropRect (or null if tiny). */
+export declare function rectFromPoints(a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}, naturalWidth: number, naturalHeight: number, minSize?: number): CropRect | null;
+//# sourceMappingURL=crop.d.ts.map

package/dist/crop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crop.d.ts","sourceRoot":"","sources":["../src/crop.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,2BAAgC,GACxC,QAAQ,GAAG,IAAI,CAuCjB;AAWD,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlF;AAED,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAwBtB;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAO1B;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAC5B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,SAA2B,GACjC,QAAQ,GAAG,IAAI,CAajB"}

package/dist/crop.js

@@ -0,0 +1,112 @@
+/**
+ * Map a CSS-viewport element box to a crop rect in screenshot natural pixels.
+ * Uses `devicePixelRatio` scaling (best-effort for preferCurrentTab captures).
+ */
+export function elementBoxToCropRect(box, viewport, image, options = {}) {
+    if (box.width <= 0 || box.height <= 0 || image.width <= 0 || image.height <= 0) {
+        return null;
+    }
+    const padding = options.paddingPx ?? 12;
+    const minSize = options.minSize ?? 8;
+    const dpr = Number.isFinite(viewport.devicePixelRatio) && viewport.devicePixelRatio > 0
+        ? viewport.devicePixelRatio
+        : 1;
+    // Prefer mapping through expected CSS→device size when the frame matches the
+    // viewport closely; otherwise fall back to uniform scale from image size.
+    const expectedW = Math.max(1, viewport.width * dpr);
+    const expectedH = Math.max(1, viewport.height * dpr);
+    const scaleX = Math.abs(image.width - expectedW) / expectedW < 0.08
+        ? dpr
+        : image.width / Math.max(1, viewport.width);
+    const scaleY = Math.abs(image.height - expectedH) / expectedH < 0.08
+        ? dpr
+        : image.height / Math.max(1, viewport.height);
+    const left = (box.x - padding) * scaleX;
+    const top = (box.y - padding) * scaleY;
+    const right = (box.x + box.width + padding) * scaleX;
+    const bottom = (box.y + box.height + padding) * scaleY;
+    const x = Math.max(0, Math.floor(left));
+    const y = Math.max(0, Math.floor(top));
+    const maxRight = Math.min(image.width, Math.ceil(right));
+    const maxBottom = Math.min(image.height, Math.ceil(bottom));
+    const width = maxRight - x;
+    const height = maxBottom - y;
+    if (width < minSize || height < minSize)
+        return null;
+    return { x, y, width, height };
+}
+function loadImage(dataUrl) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.onload = () => resolve(img);
+        img.onerror = () => reject(new Error("Failed to load image for crop"));
+        img.src = dataUrl;
+    });
+}
+/** Crop a PNG/JPEG data URL to `rect` (natural pixels); returns a PNG data URL. */
+export async function cropDataUrl(dataUrl, rect) {
+    const img = await loadImage(dataUrl);
+    const width = Math.max(1, Math.min(rect.width, img.naturalWidth - rect.x));
+    const height = Math.max(1, Math.min(rect.height, img.naturalHeight - rect.y));
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext("2d");
+    if (!ctx)
+        throw new Error("Canvas 2D unavailable");
+    ctx.drawImage(img, rect.x, rect.y, width, height, 0, 0, width, height);
+    return canvas.toDataURL("image/png");
+}
+const DEFAULT_MIN_SELECTION_PX = 8;
+/** Layout of a natural-size image inside a contain-fitted display box. */
+export function containedImageLayout(naturalWidth, naturalHeight, boxWidth, boxHeight) {
+    if (naturalWidth <= 0 || naturalHeight <= 0 || boxWidth <= 0 || boxHeight <= 0) {
+        return {
+            offsetX: 0,
+            offsetY: 0,
+            displayWidth: 0,
+            displayHeight: 0,
+            naturalWidth,
+            naturalHeight,
+            scale: 1,
+        };
+    }
+    const scale = Math.min(boxWidth / naturalWidth, boxHeight / naturalHeight);
+    const displayWidth = naturalWidth * scale;
+    const displayHeight = naturalHeight * scale;
+    return {
+        offsetX: (boxWidth - displayWidth) / 2,
+        offsetY: (boxHeight - displayHeight) / 2,
+        displayWidth,
+        displayHeight,
+        naturalWidth,
+        naturalHeight,
+        scale,
+    };
+}
+/** Map a point in the element’s client box to natural image pixels (clamped). */
+export function clientPointToNatural(layout, localX, localY) {
+    const x = (localX - layout.offsetX) / layout.scale;
+    const y = (localY - layout.offsetY) / layout.scale;
+    return {
+        x: Math.min(Math.max(0, x), layout.naturalWidth),
+        y: Math.min(Math.max(0, y), layout.naturalHeight),
+    };
+}
+/** Normalize a drag from two natural-space points into a CropRect (or null if tiny). */
+export function rectFromPoints(a, b, naturalWidth, naturalHeight, minSize = DEFAULT_MIN_SELECTION_PX) {
+    const x1 = Math.min(a.x, b.x);
+    const y1 = Math.min(a.y, b.y);
+    const x2 = Math.max(a.x, b.x);
+    const y2 = Math.max(a.y, b.y);
+    const x = Math.max(0, Math.floor(x1));
+    const y = Math.max(0, Math.floor(y1));
+    const right = Math.min(naturalWidth, Math.ceil(x2));
+    const bottom = Math.min(naturalHeight, Math.ceil(y2));
+    const width = right - x;
+    const height = bottom - y;
+    if (width < minSize || height < minSize)
+        return null;
+    return { x, y, width, height };
+}
+//# sourceMappingURL=crop.js.map

package/dist/crop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crop.js","sourceRoot":"","sources":["../src/crop.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { FeedbackEnvelope, FeedbackTransport, FeedbackViewport, PluginCollectData, PluginResult, } from "./types.js";
+export { buildFeedbackEnvelope, collectPageContext, type BuildFeedbackEnvelopeInput, type PageContext, } from "./context.js";
+export { initFeedbackCapture, type FeedbackCaptureSession } from "./session.js";
+export { createHttpTransport, type HttpTransportOptions } from "./transport.js";
+export { readClipboardImageDataUrl } from "./clipboard.js";
+export type { ContainedImageLayout, CropRect, ElementBox, ElementBoxToCropRectOptions, ImageNaturalSize, ViewportMetrics, } from "./crop.js";
+export { clientPointToNatural, containedImageLayout, cropDataUrl, elementBoxToCropRect, rectFromPoints, } from "./crop.js";
+export type { AppVersionInfo, BurstFrame, CaptureFrameBurstOptions, CaptureScreenshotOptions, CommentPluginOptions, ComponentSourceLocation, ConsoleLogEntry, ConsoleLogLevel, ConsoleLogsPluginOptions, ElementBoundingBox, ElementSourceEnrichment, ElementStylesMode, ElementTarget, ElementTargetPlugin, ElementTargetPluginOptions, FeedbackCapturePlugin, PickElementOptions, ResolveElementSource, SampledFrame, ScreenshotPluginOptions, SelectChangedFramesOptions, VersionPluginOptions, } from "./plugins/index.js";
+export { attachImagePasteHandler, buildCssSelector, captureFrameBurst, captureScreenshot, clampMaxImages, collectComputedStyles, collectElementTarget, collectElementTargetAsync, collectPluginExtras, createCommentPlugin, createConsoleLogsPlugin, createElementTargetPlugin, createPageContextPlugin, createScreenshotPlugin, createVersionPlugin, installCapturePlugins, pickElement, resolveInteractiveTarget, selectChangedFrames, COMPUTED_EXTRA_STYLE_PROPS, DEFAULT_BURST_DIFF_THRESHOLD, DEFAULT_BURST_MAX_CANDIDATES, DEFAULT_BURST_MAX_DURATION_MS, DEFAULT_BURST_MIN_SPACING_MS, DEFAULT_BURST_SAMPLE_FPS, DEFAULT_BURST_THUMB_WIDTH, DEFAULT_MAX_IMAGES, LAYOUT_STYLE_PROPS, } from "./plugins/index.js";
+export type { CreateSourceResolverOptions, LocatorSourceResolverOptions, NextSourceResolverOptions, QwikSourceResolverOptions, ReactSourceResolverOptions, SourceFrameworkChoice, SourceFrameworkId, SvelteSourceResolverOptions, VueSourceResolverOptions, } from "./source/adapters/index.js";
+export { composeSourceResolvers, createFiberStackSourceResolver, createLocatorSourceResolver, createNextSourceResolver, createQwikSourceResolver, createReactSourceResolver, createSourceResolver, createSvelteSourceResolver, createVueSourceResolver, defaultFrameworkOrder, detectFrameworkOnElement, detectFrameworkOrder, findCompositeFiber, flightPagePathMatchesUrl, flightPagePathToAppFile, isSourceFrameworkChoice, normalizeNextSourcePath, pageLooksLikeNext, parseLocatorValue, parseNextFlightPagePaths, parseQwikInspectorValue, pickNextFlightPagePath, } from "./source/adapters/index.js";
+export { clearSourceMapCaches, isAppFrame, isAppSourcePath, normalizeSourcePath, parseStackFrames, resolveOriginalPosition, } from "./source/sourceMap.js";
+export { classNameOf, locateJsxInSource } from "./source/locateJsx.js";
+export type { RankedSourceEnrichment } from "./source/rankSourceHierarchy.js";
+export { isUiPrimitiveSource, rankSourceHierarchy, sameSourceLocation, } from "./source/rankSourceHierarchy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,0BAA0B,EAC/B,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,YAAY,EACV,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,cAAc,EACd,UAAU,EACV,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { buildFeedbackEnvelope, collectPageContext, } from "./context.js";
+export { initFeedbackCapture } from "./session.js";
+export { createHttpTransport } from "./transport.js";
+export { readClipboardImageDataUrl } from "./clipboard.js";
+export { clientPointToNatural, containedImageLayout, cropDataUrl, elementBoxToCropRect, rectFromPoints, } from "./crop.js";
+export { attachImagePasteHandler, buildCssSelector, captureFrameBurst, captureScreenshot, clampMaxImages, collectComputedStyles, collectElementTarget, collectElementTargetAsync, collectPluginExtras, createCommentPlugin, createConsoleLogsPlugin, createElementTargetPlugin, createPageContextPlugin, createScreenshotPlugin, createVersionPlugin, installCapturePlugins, pickElement, resolveInteractiveTarget, selectChangedFrames, COMPUTED_EXTRA_STYLE_PROPS, DEFAULT_BURST_DIFF_THRESHOLD, DEFAULT_BURST_MAX_CANDIDATES, DEFAULT_BURST_MAX_DURATION_MS, DEFAULT_BURST_MIN_SPACING_MS, DEFAULT_BURST_SAMPLE_FPS, DEFAULT_BURST_THUMB_WIDTH, DEFAULT_MAX_IMAGES, LAYOUT_STYLE_PROPS, } from "./plugins/index.js";
+export { composeSourceResolvers, createFiberStackSourceResolver, createLocatorSourceResolver, createNextSourceResolver, createQwikSourceResolver, createReactSourceResolver, createSourceResolver, createSvelteSourceResolver, createVueSourceResolver, defaultFrameworkOrder, detectFrameworkOnElement, detectFrameworkOrder, findCompositeFiber, flightPagePathMatchesUrl, flightPagePathToAppFile, isSourceFrameworkChoice, normalizeNextSourcePath, pageLooksLikeNext, parseLocatorValue, parseNextFlightPagePaths, parseQwikInspectorValue, pickNextFlightPagePath, } from "./source/adapters/index.js";
+export { clearSourceMapCaches, isAppFrame, isAppSourcePath, normalizeSourcePath, parseStackFrames, resolveOriginalPosition, } from "./source/sourceMap.js";
+export { classNameOf, locateJsxInSource } from "./source/locateJsx.js";
+export { isUiPrimitiveSource, rankSourceHierarchy, sameSourceLocation, } from "./source/rankSourceHierarchy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAGnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAA+B,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAA6B,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAU3D,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,cAAc,GACf,MAAM,WAAW,CAAC;AA2BnB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC"}

package/dist/plugins/comment.d.ts

@@ -0,0 +1,11 @@
+import type { FeedbackCapturePlugin } from "./core.js";
+export type CommentPluginOptions = {
+    /** Read the current comment at collect time. */
+    getComment: () => string;
+};
+/**
+ * Built-in plugin that contributes the user comment as `envelope.comment`.
+ * Empty/whitespace-only comments return `undefined` (key omitted).
+ */
+export declare function createCommentPlugin(options: CommentPluginOptions): FeedbackCapturePlugin<"comment", string>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/plugins/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../src/plugins/comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,gDAAgD;IAChD,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQ1C"}

package/dist/plugins/comment.js

@@ -0,0 +1,14 @@
+/**
+ * Built-in plugin that contributes the user comment as `envelope.comment`.
+ * Empty/whitespace-only comments return `undefined` (key omitted).
+ */
+export function createCommentPlugin(options) {
+    return {
+        id: "comment",
+        collect() {
+            const comment = options.getComment().trim();
+            return comment.length > 0 ? comment : undefined;
+        },
+    };
+}
+//# sourceMappingURL=comment.js.map

package/dist/plugins/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/plugins/comment.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,OAAO;QACL,EAAE,EAAE,SAAS;QACb,OAAO;YACL,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/consoleLogs.d.ts

@@ -0,0 +1,14 @@
+import type { FeedbackCapturePlugin } from "./core.js";
+export type ConsoleLogLevel = "log" | "info" | "warn" | "error" | "debug";
+export type ConsoleLogsPluginOptions = {
+    maxEntries?: number;
+    levels?: ConsoleLogLevel[];
+};
+export type ConsoleLogEntry = {
+    level: ConsoleLogLevel;
+    args: unknown[];
+    timestamp: string;
+};
+/** Built-in plugin that buffers console output for inclusion in `envelope.consoleLogs`. */
+export declare function createConsoleLogsPlugin(options?: ConsoleLogsPluginOptions): FeedbackCapturePlugin<"consoleLogs", ConsoleLogEntry[]>;
+//# sourceMappingURL=consoleLogs.d.ts.map

package/dist/plugins/consoleLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogs.d.ts","sourceRoot":"","sources":["../../src/plugins/consoleLogs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1E,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AA+CF,2FAA2F;AAC3F,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,qBAAqB,CAAC,aAAa,EAAE,eAAe,EAAE,CAAC,CAgDzD"}

package/dist/plugins/consoleLogs.js

@@ -0,0 +1,98 @@
+const DEFAULT_LEVELS = ["log", "info", "warn", "error", "debug"];
+function serializeArg(value, seen) {
+    if (value === null || value === undefined)
+        return value;
+    const t = typeof value;
+    if (t === "string" || t === "number" || t === "boolean" || t === "bigint") {
+        return t === "bigint" ? value.toString() : value;
+    }
+    if (t === "symbol")
+        return value.toString();
+    if (t === "function") {
+        return `[Function ${value.name || "anonymous"}]`;
+    }
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+        };
+    }
+    if (typeof Node !== "undefined" && value instanceof Node) {
+        if (value instanceof Element) {
+            return `[${value.tagName.toLowerCase()}]`;
+        }
+        return `[${value.nodeName}]`;
+    }
+    if (t === "object") {
+        const obj = value;
+        if (seen.has(obj))
+            return "[Circular]";
+        seen.add(obj);
+        if (Array.isArray(value)) {
+            return value.map((item) => serializeArg(item, seen));
+        }
+        try {
+            const out = {};
+            for (const [k, v] of Object.entries(value)) {
+                out[k] = serializeArg(v, seen);
+            }
+            return out;
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+/** Built-in plugin that buffers console output for inclusion in `envelope.consoleLogs`. */
+export function createConsoleLogsPlugin(options = {}) {
+    const maxEntries = options.maxEntries ?? 200;
+    const levels = options.levels ?? DEFAULT_LEVELS;
+    const entries = [];
+    const originals = new Map();
+    let installed = false;
+    const push = (level, args) => {
+        const seen = new WeakSet();
+        entries.push({
+            level,
+            args: args.map((arg) => serializeArg(arg, seen)),
+            timestamp: new Date().toISOString(),
+        });
+        while (entries.length > maxEntries) {
+            entries.shift();
+        }
+    };
+    return {
+        id: "consoleLogs",
+        setup() {
+            if (installed || typeof console === "undefined")
+                return;
+            installed = true;
+            for (const level of levels) {
+                const original = console[level].bind(console);
+                originals.set(level, original);
+                console[level] = (...args) => {
+                    push(level, args);
+                    original(...args);
+                };
+            }
+        },
+        collect() {
+            return entries.slice();
+        },
+        dispose() {
+            if (!installed)
+                return;
+            for (const level of levels) {
+                const original = originals.get(level);
+                if (original) {
+                    console[level] = original;
+                }
+            }
+            originals.clear();
+            installed = false;
+        },
+    };
+}
+//# sourceMappingURL=consoleLogs.js.map

package/dist/plugins/consoleLogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogs.js","sourceRoot":"","sources":["../../src/plugins/consoleLogs.ts"],"names":[],"mappings":"AAeA,MAAM,cAAc,GAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEpF,SAAS,YAAY,CAAC,KAAc,EAAE,IAAqB;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;QACrB,OAAO,aAAc,KAA2B,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACzD,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;YAC7B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,KAAe,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBACtE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,UAAoC,EAAE;IAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiD,CAAC;IAC3E,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,IAAI,GAAG,CAAC,KAAsB,EAAE,IAAe,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC;YACX,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,KAAK;YACH,IAAI,SAAS,IAAI,OAAO,OAAO,KAAK,WAAW;gBAAE,OAAO;YACxD,SAAS,GAAG,IAAI,CAAC;YACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAiC,CAAC;gBAC9E,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;oBACtC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;oBAClB,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;gBACpB,CAAC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;YACL,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QACD,OAAO;YACL,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,GAAG,QAA8B,CAAC;gBAClD,CAAC;YACH,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/core.d.ts

@@ -0,0 +1,24 @@
+export type FeedbackCapturePlugin<Id extends string = string, Data = unknown> = {
+    /** Key under the feedback envelope. */
+    id: Id;
+    /**
+     * Optional early install (e.g. patch console).
+     * May return a disposer; otherwise use `dispose`.
+     */
+    setup?: () => void | (() => void);
+    /** Snapshot at send time. Return `undefined` to omit this plugin’s key. */
+    collect: () => Data | undefined | Promise<Data | undefined>;
+    /** Cleanup (also called on unmount). */
+    dispose?: () => void;
+};
+/**
+ * Run each plugin's `setup`, returning a single dispose that runs all
+ * setup-returned disposers and `dispose` hooks (idempotent).
+ */
+export declare function installCapturePlugins(plugins: readonly FeedbackCapturePlugin[]): () => void;
+/**
+ * Await all `collect()` calls and merge into an envelope keyed by plugin id.
+ * Skips `undefined`. On collect throw, stores `{ ok: false, error }` under that id.
+ */
+export declare function collectPluginExtras<const Ps extends readonly FeedbackCapturePlugin[]>(plugins: Ps): Promise<import("../types.js").FeedbackEnvelope<Ps>>;
+//# sourceMappingURL=core.d.ts.map

package/dist/plugins/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/plugins/core.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,GAAG,OAAO,IAAI;IAC9E,uCAAuC;IACvC,EAAE,EAAE,EAAE,CAAC;IACP;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAClC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAC5D,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,MAAM,IAAI,CAiC3F;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,qBAAqB,EAAE,EACzF,OAAO,EAAE,EAAE,GACV,OAAO,CAAC,OAAO,aAAa,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAkBrD"}