feedbackkit-web 1.0.37 → 1.0.38

package/dist/types/fixes.d.ts

@@ -0,0 +1,66 @@
+import type { FeedbackKitConfiguration, FeedbackReport, FeedbackUser, FixUpdate } from "./types";
+/**
+ * The reporter's half of the closed loop — web counterpart of the Swift
+ * SDK's `FixUpdatesClient` / `FeedbackReporterIdentity`. Talks to the
+ * `reporter-updates` Edge Function (supabase/functions/reporter-updates);
+ * keep the wire format in sync with it and with
+ * Sources/FeedbackKit/Networking/FixUpdatesClient.swift.
+ */
+/**
+ * Mirrors `compare_builds` (0014_closed_loop.sql) and every other copy:
+ * dotted numeric builds compare numerically; anything else is only equal (0)
+ * or incomparable (null).
+ */
+export declare function compareBuilds(a: string | null | undefined, b: string | null | undefined): -1 | 0 | 1 | null;
+/**
+ * The anonymous, random id attached to reports from this browser — what lets
+ * a fix get back to the person who reported the bug. Kept in localStorage
+ * (per origin); where storage is unavailable (private mode, blocked site
+ * data) it lasts for the page's lifetime instead, which just means that
+ * browser won't be asked to verify fixes later.
+ */
+export declare function reporterId(): string;
+export declare function setUser(user: FeedbackUser | null): void;
+export declare function getUser(): FeedbackUser | null;
+/** `…/functions/v1/ingest-feedback` → `…/functions/v1/reporter-updates`, unless overridden. */
+export declare function reporterUpdatesEndpoint(configuration: FeedbackKitConfiguration): string;
+interface WireUpdate {
+    feedback_id: string;
+    text?: string;
+    created_at?: string;
+    screen_name?: string | null;
+    fix_stage?: string | null;
+    fixed_in_build?: string | null;
+    fix_summary?: string | null;
+    needs_verification?: boolean;
+    open_question?: {
+        id: string;
+        body: string;
+        created_at: string;
+    } | null;
+    screenshot_url?: string | null;
+    messages?: {
+        id: string;
+        kind: string;
+        body: string;
+        author: string;
+        created_at: string;
+    }[];
+}
+export declare function decodeUpdate(w: WireUpdate): FixUpdate;
+export declare function fetchFixUpdates(configuration: FeedbackKitConfiguration): Promise<FixUpdate[]>;
+export type FixAction = {
+    type: "verify";
+}
+/** Still broken — optionally with a fresh report (text + annotated screenshot). */
+ | {
+    type: "reopen";
+    report?: FeedbackReport | null;
+    text?: string;
+} | {
+    type: "reply";
+    text: string;
+};
+export declare function encodeFixAction(configuration: FeedbackKitConfiguration, feedbackId: string, action: FixAction): Promise<Record<string, unknown>>;
+export declare function sendFixAction(configuration: FeedbackKitConfiguration, feedbackId: string, action: FixAction): Promise<void>;
+export {};

package/dist/types/global.d.ts

@@ -18,6 +18,13 @@ declare const _default: {
     disableKeyboardShortcut(): void;
     enableLogCapture(options?: import("./logs").LogCaptureOptions | false): void;
     captureScreenshot(options?: import("./types").CaptureOptions): Promise<Blob>;
+    setUser(user: import("./types").FeedbackUser | null): void;
+    readonly reporterId: string;
+    checkForFixUpdates(): Promise<import("./types").FixUpdate[]>;
+    respondToFixUpdate(feedbackId: string, action: import("./fixes").FixAction): Promise<void>;
+    enableFixVerification(): void;
+    disableFixVerification(): void;
+    presentFixUpdatesIfNeeded(): Promise<void>;
     destroy(): void;
 } & {
     renderer: typeof renderer;

package/dist/types/index.d.ts

@@ -1,11 +1,13 @@
 import { type LogCaptureOptions } from "./logs";
-import type { CaptureOptions, FeedbackKitConfiguration, FeedbackProduct, FeedbackReport, FeedbackTheme } from "./types";
+import { type FixAction } from "./fixes";
+import type { CaptureOptions, FeedbackKitConfiguration, FeedbackProduct, FeedbackReport, FeedbackTheme, FeedbackUser, FixUpdate } from "./types";
 import { type TriggerOptions } from "./ui/widget";
 export type * from "./types";
 export type { TriggerOptions } from "./ui/widget";
 export type { LogCaptureOptions } from "./logs";
 export { FeedbackSubmissionError, DEFAULT_ENDPOINT, encodePayload, type IngestPayload } from "./submit";
 export { parseUserAgent, redactUrl } from "./environment";
+export { compareBuilds, reporterUpdatesEndpoint, type FixAction } from "./fixes";
 export { drawAnnotation, drawAnnotations, hitTest, readPoint, textBubbleRect, STROKE_WIDTH, type Point, type Size, } from "./renderer";
 export interface PresentOptions {
     /** Called with the finished report when the user taps Send. */
@@ -84,6 +86,41 @@ export declare const FeedbackKit: {
     enableLogCapture(options?: LogCaptureOptions | false): void;
     /** Captures the current viewport as a PNG, without opening any UI. */
     captureScreenshot(options?: CaptureOptions): Promise<Blob>;
+    /**
+     * Optional identity of the person using your site, attached to every
+     * report they submit. Not needed for fix verification (that uses an
+     * anonymous per-browser id, `reporterId`). Pass `null` on sign-out.
+     */
+    setUser(user: FeedbackUser | null): void;
+    /** The anonymous per-browser id attached to reports — how a fix finds its way back here. */
+    readonly reporterId: string;
+    /**
+     * This browser's reports that need the reporter's attention: shipped
+     * fixes to confirm and developer/agent questions. For a custom UI — the
+     * built-in one is `enableFixVerification`.
+     */
+    checkForFixUpdates(): Promise<FixUpdate[]>;
+    /** Answers one update directly (custom UIs): verify, reopen, or reply. */
+    respondToFixUpdate(feedbackId: string, action: FixAction): Promise<void>;
+    /**
+     * Closes the loop with the person who reported a bug: once a fix for one
+     * of their reports ships (announced with `feedbackkit release`), a small
+     * card shows their original screenshot and asks "is it fixed?". "Still
+     * broken" reopens the capture dialog so they can show what's wrong now,
+     * and the report goes straight back to the developer. Also surfaces
+     * questions the developer or their coding agent asked.
+     *
+     * Checks now and whenever the tab becomes visible (at most once a minute).
+     * With `appBuild` configured, only fixes shipped in that build or earlier
+     * are shown; without it, a fix counts as live as soon as it's released.
+     */
+    enableFixVerification(): void;
+    disableFixVerification(): void;
+    /**
+     * Checks right now (ignoring the throttle) and shows the card if there's
+     * something. Resolves once the check is done and any card is on screen.
+     */
+    presentFixUpdatesIfNeeded(): Promise<void>;
     /** Removes every trace of the SDK from the page (trigger, dialog host, listeners, log hooks). */
     destroy(): void;
 };

package/dist/types/submit.d.ts

@@ -1,4 +1,4 @@
-import type { FeedbackKitConfiguration, FeedbackProduct, FeedbackReport } from "./types";
+import type { FeedbackKitConfiguration, FeedbackProduct, FeedbackReport, FeedbackUser } from "./types";
 /** The hosted FeedbackKit dashboard's ingestion endpoint. */
 export declare const DEFAULT_ENDPOINT = "https://gpucoladcyvijefdjudf.supabase.co/functions/v1/ingest-feedback";
 export declare class FeedbackSubmissionError extends Error {
@@ -34,9 +34,19 @@ export interface IngestPayload {
         is_default: boolean;
     }[];
     logs?: FeedbackReport["logs"];
+    /** Anonymous per-browser id — see fixes.ts `reporterId`. */
+    reporter_id?: string;
+    /** `FeedbackKit.setUser(...)`, camelCase JSONB like `environment`. */
+    reporter?: FeedbackUser;
 }
 export declare function blobToBase64(blob: Blob): Promise<string>;
-export declare function encodePayload(report: FeedbackReport, projectKey: string): Promise<IngestPayload>;
-export declare function submitReport(report: FeedbackReport, configuration: FeedbackKitConfiguration): Promise<void>;
+export declare function encodePayload(report: FeedbackReport, projectKey: string, identity?: {
+    reporterId?: string;
+    user?: FeedbackUser | null;
+}): Promise<IngestPayload>;
+export declare function submitReport(report: FeedbackReport, configuration: FeedbackKitConfiguration, identity?: {
+    reporterId?: string;
+    user?: FeedbackUser | null;
+}): Promise<void>;
 /** `GET <endpoint>?project_key=…` — the products configured for the project in the dashboard. */
 export declare function fetchProducts(configuration: FeedbackKitConfiguration): Promise<FeedbackProduct[]>;

package/dist/types/types.d.ts

@@ -135,6 +135,49 @@ export interface FeedbackKitConfiguration {
      * report). Default `true`; pass options to tune, or `false` to disable.
      */
     captureLogs?: boolean | LogCaptureOptions;
+    /**
+     * Where fix updates for this browser's reports come from (the
+     * `reporter-updates` function). Defaults to the sibling of `endpoint`.
+     */
+    reporterUpdatesEndpoint?: string;
+}
+/** Optional identity of the person using your site, attached to their reports. Mirrors Swift's `FeedbackUser`. */
+export interface FeedbackUser {
+    id?: string;
+    email?: string;
+    name?: string;
+}
+/**
+ * Something that happened to a report this browser filed: a fix that
+ * shipped ("is it fixed?") and/or a question from the developer or their
+ * coding agent. Mirrors Swift's `FixUpdate`.
+ */
+export interface FixUpdate {
+    feedbackId: string;
+    /** What the reporter originally wrote. */
+    text: string;
+    createdAt: string;
+    screenName: string | null;
+    fixStage: string | null;
+    fixedInBuild: string | null;
+    /** One plain-language line on what was fixed, if the developer/agent wrote one. */
+    fixSummary: string | null;
+    /** A fix shipped (in a build this page is at least, when `appBuild` is configured) and hasn't been confirmed. */
+    needsVerification: boolean;
+    openQuestion: {
+        id: string;
+        body: string;
+        createdAt: string;
+    } | null;
+    /** Short-lived signed URL of the original annotated screenshot. */
+    screenshotUrl: string | null;
+    messages: {
+        id: string;
+        kind: string;
+        body: string;
+        author: string;
+        createdAt: string;
+    }[];
 }
 export interface CaptureOptions {
     /**

package/dist/types/ui/fixCard.d.ts

@@ -0,0 +1,32 @@
+import type { FixUpdate } from "../types";
+export type FixCardOutcome = {
+    type: "verified";
+}
+/** The widget then opens the capture flow in "still broken" mode. */
+ | {
+    type: "stillBroken";
+} | {
+    type: "replied";
+    text: string;
+} | {
+    type: "later";
+};
+/**
+ * "We fixed something you reported — is it fixed?" A small non-modal card in
+ * the page's bottom corner (above the trigger), inside the widget's Shadow
+ * DOM. Web counterpart of Swift's `FixVerificationView`; same copy on purpose.
+ */
+export declare class FixCard {
+    private readonly shadow;
+    private readonly update;
+    private readonly onOutcome;
+    private root;
+    private settled;
+    constructor(shadow: ShadowRoot, update: FixUpdate, onOutcome: (outcome: FixCardOutcome) => void);
+    show(position: "bottom-right" | "bottom-left"): void;
+    /** Close as "later" (e.g. `FeedbackKit.disableFixVerification()`). */
+    dismiss(): void;
+    /** Remove without reporting an outcome (the widget is being destroyed). */
+    remove(): void;
+    private settle;
+}

package/dist/types/ui/styles.d.ts

@@ -3,4 +3,4 @@
  * styles nor ours leak across. `:host { all: initial }` also blocks inherited
  * properties (font, color, line-height) from the page.
  */
-export declare const styles = "\n:host {\n  all: initial;\n  --fk-primary: #007aff;\n  --fk-secondary: #6b7280;\n  --fk-bg: #ffffff;\n  --fk-surface: #f5f5f7;\n  --fk-border: rgba(0, 0, 0, 0.1);\n  --fk-text: #111114;\n  --fk-muted: #6b6b73;\n  --fk-danger: #d92d20;\n  --fk-backdrop: rgba(10, 10, 14, 0.55);\n  --fk-shadow: 0 24px 64px rgba(0, 0, 0, 0.28), 0 2px 8px rgba(0, 0, 0, 0.12);\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  font-size: 14px;\n  line-height: 1.4;\n  color: var(--fk-text);\n}\n@media (prefers-color-scheme: dark) {\n  :host(:not([data-color-scheme=\"light\"])) {\n    --fk-bg: #1c1c1f;\n    --fk-surface: #26262a;\n    --fk-border: rgba(255, 255, 255, 0.12);\n    --fk-text: #f2f2f5;\n    --fk-muted: #a0a0a8;\n    --fk-backdrop: rgba(0, 0, 0, 0.65);\n  }\n}\n:host([data-color-scheme=\"dark\"]) {\n  --fk-bg: #1c1c1f;\n  --fk-surface: #26262a;\n  --fk-border: rgba(255, 255, 255, 0.12);\n  --fk-text: #f2f2f5;\n  --fk-muted: #a0a0a8;\n  --fk-backdrop: rgba(0, 0, 0, 0.65);\n}\n*, *::before, *::after { box-sizing: border-box; }\nbutton { font: inherit; color: inherit; cursor: pointer; }\nbutton:disabled { cursor: not-allowed; opacity: 0.45; }\n:focus-visible { outline: 2px solid var(--fk-primary); outline-offset: 2px; }\n\n/* ---------- floating trigger ---------- */\n.fk-trigger {\n  position: fixed;\n  z-index: 2147483000;\n  bottom: 20px;\n  right: 20px;\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n  height: 44px;\n  padding: 0 16px 0 14px;\n  border: 0;\n  border-radius: 22px;\n  background: var(--fk-primary);\n  color: #fff;\n  font-weight: 600;\n  font-size: 14px;\n  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.22);\n  transition: transform 0.15s ease, box-shadow 0.15s ease, opacity 0.15s ease;\n}\n.fk-trigger[data-position=\"bottom-left\"] { right: auto; left: 20px; }\n.fk-trigger:hover { transform: translateY(-1px); box-shadow: 0 10px 26px rgba(0, 0, 0, 0.26); }\n.fk-trigger[data-compact=\"true\"] { width: 48px; height: 48px; padding: 0; justify-content: center; border-radius: 24px; }\n.fk-trigger[data-compact=\"true\"] .fk-trigger-label { display: none; }\n.fk-trigger[aria-busy=\"true\"] { opacity: 0.6; pointer-events: none; }\n\n/* ---------- overlay ---------- */\n.fk-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 2147483001;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 24px;\n  background: var(--fk-backdrop);\n  animation: fk-fade 0.16s ease-out;\n}\n@keyframes fk-fade { from { opacity: 0; } to { opacity: 1; } }\n@keyframes fk-rise { from { opacity: 0; transform: translateY(8px) scale(0.99); } to { opacity: 1; transform: none; } }\n.fk-dialog {\n  display: grid;\n  grid-template-columns: minmax(0, 1fr) 340px;\n  width: min(1180px, 100%);\n  height: min(780px, 100%);\n  overflow: hidden;\n  border-radius: 16px;\n  background: var(--fk-bg);\n  box-shadow: var(--fk-shadow);\n  animation: fk-rise 0.2s ease-out;\n}\n.fk-stage {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  background: var(--fk-surface);\n  border-right: 1px solid var(--fk-border);\n}\n.fk-toolbar {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  flex-wrap: wrap;\n  padding: 10px 12px;\n  border-bottom: 1px solid var(--fk-border);\n}\n.fk-toolbar-sep { width: 1px; height: 22px; margin: 0 6px; background: var(--fk-border); }\n.fk-tool {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 34px;\n  height: 34px;\n  border: 0;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--fk-muted);\n}\n.fk-tool:hover:not(:disabled) { background: var(--fk-border); color: var(--fk-text); }\n.fk-tool[aria-pressed=\"true\"] { background: var(--fk-primary); color: #fff; }\n.fk-swatch {\n  width: 22px;\n  height: 22px;\n  margin: 0 2px;\n  padding: 0;\n  border-radius: 11px;\n  border: 2px solid var(--fk-bg);\n  box-shadow: 0 0 0 1px var(--fk-border);\n}\n.fk-swatch[aria-pressed=\"true\"] { box-shadow: 0 0 0 2px var(--fk-text); }\n.fk-hint { margin-left: auto; font-size: 12px; color: var(--fk-muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.fk-canvas-wrap {\n  position: relative;\n  flex: 1;\n  min-height: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 16px;\n  overflow: hidden;\n}\n.fk-canvas-box { position: relative; box-shadow: 0 4px 20px rgba(0, 0, 0, 0.18); border-radius: 6px; overflow: hidden; }\n.fk-canvas-box canvas { display: block; }\n.fk-canvas-box .fk-ink { position: absolute; inset: 0; touch-action: none; }\n.fk-stage[data-screenshot=\"off\"] .fk-canvas-box { opacity: 0.25; filter: grayscale(1); }\n.fk-stage[data-screenshot=\"off\"] .fk-toolbar button { pointer-events: none; opacity: 0.35; }\n.fk-off-note {\n  position: absolute;\n  inset: 0;\n  display: none;\n  align-items: center;\n  justify-content: center;\n  font-weight: 600;\n  color: var(--fk-muted);\n  pointer-events: none;\n}\n.fk-stage[data-screenshot=\"off\"] .fk-off-note { display: flex; }\n.fk-text-input {\n  position: absolute;\n  z-index: 2;\n  min-width: 120px;\n  padding: 6px 8px;\n  border: 2px solid var(--fk-primary);\n  border-radius: 8px;\n  background: var(--fk-bg);\n  color: var(--fk-text);\n  font: bold 14px -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  outline: none;\n}\n\n/* ---------- composer ---------- */\n.fk-composer { display: flex; flex-direction: column; min-height: 0; padding: 18px; gap: 14px; overflow-y: auto; }\n.fk-header { display: flex; align-items: center; justify-content: space-between; gap: 8px; }\n.fk-title { margin: 0; font-size: 17px; font-weight: 650; letter-spacing: -0.01em; }\n.fk-close { display: inline-flex; width: 30px; height: 30px; align-items: center; justify-content: center; border: 0; border-radius: 15px; background: var(--fk-surface); color: var(--fk-muted); }\n.fk-close:hover { color: var(--fk-text); }\n.fk-label { display: block; margin-bottom: 6px; font-size: 12px; font-weight: 600; color: var(--fk-muted); text-transform: uppercase; letter-spacing: 0.04em; }\n.fk-textarea {\n  width: 100%;\n  min-height: 140px;\n  resize: vertical;\n  padding: 10px 12px;\n  border: 1px solid var(--fk-border);\n  border-radius: 10px;\n  background: var(--fk-bg);\n  color: var(--fk-text);\n  font: inherit;\n  line-height: 1.45;\n}\n.fk-textarea:focus { outline: none; border-color: var(--fk-primary); box-shadow: 0 0 0 3px color-mix(in srgb, var(--fk-primary) 22%, transparent); }\n.fk-chips { display: flex; flex-wrap: wrap; gap: 6px; }\n.fk-chip {\n  display: inline-flex;\n  align-items: center;\n  gap: 5px;\n  height: 28px;\n  padding: 0 11px;\n  border: 1px solid var(--fk-border);\n  border-radius: 14px;\n  background: var(--fk-bg);\n  font-size: 13px;\n}\n.fk-chip[aria-pressed=\"true\"] { border-color: var(--fk-primary); background: color-mix(in srgb, var(--fk-primary) 12%, transparent); color: var(--fk-primary); font-weight: 600; }\n.fk-row { display: flex; align-items: center; justify-content: space-between; gap: 10px; }\n.fk-switch { display: inline-flex; align-items: center; gap: 8px; font-size: 13px; cursor: pointer; user-select: none; }\n.fk-switch input { position: absolute; opacity: 0; width: 0; height: 0; }\n.fk-switch-track { position: relative; width: 36px; height: 22px; border-radius: 11px; background: var(--fk-border); transition: background 0.15s; }\n.fk-switch-track::after { content: \"\"; position: absolute; top: 2px; left: 2px; width: 18px; height: 18px; border-radius: 9px; background: #fff; box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3); transition: transform 0.15s; }\n.fk-switch input:checked + .fk-switch-track { background: var(--fk-primary); }\n.fk-switch input:checked + .fk-switch-track::after { transform: translateX(14px); }\n.fk-switch input:focus-visible + .fk-switch-track { outline: 2px solid var(--fk-primary); outline-offset: 2px; }\n.fk-attach {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 32px;\n  padding: 0 12px;\n  border: 1px dashed var(--fk-secondary);\n  border-radius: 8px;\n  background: transparent;\n  color: var(--fk-secondary);\n  font-size: 13px;\n}\n.fk-file { display: inline-flex; align-items: center; gap: 6px; max-width: 100%; padding: 4px 6px 4px 10px; border-radius: 8px; background: var(--fk-surface); font-size: 12px; }\n.fk-file span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.fk-file button { display: inline-flex; border: 0; background: transparent; color: var(--fk-muted); padding: 2px; }\n.fk-meta { font-size: 12px; color: var(--fk-muted); }\n.fk-meta details summary { cursor: pointer; }\n.fk-meta pre { max-height: 140px; overflow: auto; margin: 6px 0 0; padding: 8px; border-radius: 8px; background: var(--fk-surface); font-size: 11px; white-space: pre-wrap; word-break: break-word; }\n.fk-spacer { flex: 1; }\n.fk-actions { display: flex; gap: 8px; }\n.fk-btn {\n  display: inline-flex;\n  flex: 1;\n  align-items: center;\n  justify-content: center;\n  gap: 7px;\n  height: 40px;\n  border-radius: 10px;\n  font-weight: 600;\n}\n.fk-btn-secondary { border: 1px solid var(--fk-border); background: transparent; color: var(--fk-secondary); }\n.fk-btn-primary { border: 0; background: var(--fk-primary); color: #fff; }\n.fk-btn-primary:hover:not(:disabled) { filter: brightness(1.06); }\n.fk-error { margin: 0; padding: 8px 10px; border-radius: 8px; background: color-mix(in srgb, var(--fk-danger) 12%, transparent); color: var(--fk-danger); font-size: 13px; }\n.fk-spinner { width: 16px; height: 16px; border: 2px solid rgba(255, 255, 255, 0.45); border-top-color: #fff; border-radius: 50%; animation: fk-spin 0.7s linear infinite; }\n@keyframes fk-spin { to { transform: rotate(360deg); } }\n.fk-done { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; flex: 1; text-align: center; }\n.fk-done-icon { display: inline-flex; width: 48px; height: 48px; align-items: center; justify-content: center; border-radius: 24px; background: var(--fk-primary); color: #fff; }\n.fk-done-icon svg { width: 26px; height: 26px; }\n.fk-sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }\n\n/* ---------- narrow screens: stack stage over composer ---------- */\n@media (max-width: 760px) {\n  .fk-overlay { padding: 0; }\n  .fk-dialog { grid-template-columns: 1fr; grid-template-rows: minmax(0, 1fr) auto; width: 100%; height: 100%; border-radius: 0; }\n  .fk-stage { border-right: 0; border-bottom: 1px solid var(--fk-border); }\n  .fk-hint { display: none; }\n  .fk-canvas-wrap { padding: 10px; }\n  .fk-composer { max-height: 55vh; padding: 14px; gap: 10px; }\n  .fk-textarea { min-height: 84px; }\n}\n@media (prefers-reduced-motion: reduce) {\n  .fk-overlay, .fk-dialog { animation: none; }\n}\n";
+export declare const styles = "\n:host {\n  all: initial;\n  --fk-primary: #007aff;\n  --fk-secondary: #6b7280;\n  --fk-bg: #ffffff;\n  --fk-surface: #f5f5f7;\n  --fk-border: rgba(0, 0, 0, 0.1);\n  --fk-text: #111114;\n  --fk-muted: #6b6b73;\n  --fk-danger: #d92d20;\n  --fk-backdrop: rgba(10, 10, 14, 0.55);\n  --fk-shadow: 0 24px 64px rgba(0, 0, 0, 0.28), 0 2px 8px rgba(0, 0, 0, 0.12);\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  font-size: 14px;\n  line-height: 1.4;\n  color: var(--fk-text);\n}\n@media (prefers-color-scheme: dark) {\n  :host(:not([data-color-scheme=\"light\"])) {\n    --fk-bg: #1c1c1f;\n    --fk-surface: #26262a;\n    --fk-border: rgba(255, 255, 255, 0.12);\n    --fk-text: #f2f2f5;\n    --fk-muted: #a0a0a8;\n    --fk-backdrop: rgba(0, 0, 0, 0.65);\n  }\n}\n:host([data-color-scheme=\"dark\"]) {\n  --fk-bg: #1c1c1f;\n  --fk-surface: #26262a;\n  --fk-border: rgba(255, 255, 255, 0.12);\n  --fk-text: #f2f2f5;\n  --fk-muted: #a0a0a8;\n  --fk-backdrop: rgba(0, 0, 0, 0.65);\n}\n*, *::before, *::after { box-sizing: border-box; }\nbutton { font: inherit; color: inherit; cursor: pointer; }\nbutton:disabled { cursor: not-allowed; opacity: 0.45; }\n:focus-visible { outline: 2px solid var(--fk-primary); outline-offset: 2px; }\n\n/* ---------- floating trigger ---------- */\n.fk-trigger {\n  position: fixed;\n  z-index: 2147483000;\n  bottom: 20px;\n  right: 20px;\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n  height: 44px;\n  padding: 0 16px 0 14px;\n  border: 0;\n  border-radius: 22px;\n  background: var(--fk-primary);\n  color: #fff;\n  font-weight: 600;\n  font-size: 14px;\n  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.22);\n  transition: transform 0.15s ease, box-shadow 0.15s ease, opacity 0.15s ease;\n}\n.fk-trigger[data-position=\"bottom-left\"] { right: auto; left: 20px; }\n.fk-trigger:hover { transform: translateY(-1px); box-shadow: 0 10px 26px rgba(0, 0, 0, 0.26); }\n.fk-trigger[data-compact=\"true\"] { width: 48px; height: 48px; padding: 0; justify-content: center; border-radius: 24px; }\n.fk-trigger[data-compact=\"true\"] .fk-trigger-label { display: none; }\n.fk-trigger[aria-busy=\"true\"] { opacity: 0.6; pointer-events: none; }\n\n/* ---------- overlay ---------- */\n.fk-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 2147483001;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 24px;\n  background: var(--fk-backdrop);\n  animation: fk-fade 0.16s ease-out;\n}\n@keyframes fk-fade { from { opacity: 0; } to { opacity: 1; } }\n@keyframes fk-rise { from { opacity: 0; transform: translateY(8px) scale(0.99); } to { opacity: 1; transform: none; } }\n.fk-dialog {\n  display: grid;\n  grid-template-columns: minmax(0, 1fr) 340px;\n  width: min(1180px, 100%);\n  height: min(780px, 100%);\n  overflow: hidden;\n  border-radius: 16px;\n  background: var(--fk-bg);\n  box-shadow: var(--fk-shadow);\n  animation: fk-rise 0.2s ease-out;\n}\n.fk-stage {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  min-height: 0;\n  background: var(--fk-surface);\n  border-right: 1px solid var(--fk-border);\n}\n.fk-toolbar {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  flex-wrap: wrap;\n  padding: 10px 12px;\n  border-bottom: 1px solid var(--fk-border);\n}\n.fk-toolbar-sep { width: 1px; height: 22px; margin: 0 6px; background: var(--fk-border); }\n.fk-tool {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 34px;\n  height: 34px;\n  border: 0;\n  border-radius: 8px;\n  background: transparent;\n  color: var(--fk-muted);\n}\n.fk-tool:hover:not(:disabled) { background: var(--fk-border); color: var(--fk-text); }\n.fk-tool[aria-pressed=\"true\"] { background: var(--fk-primary); color: #fff; }\n.fk-swatch {\n  width: 22px;\n  height: 22px;\n  margin: 0 2px;\n  padding: 0;\n  border-radius: 11px;\n  border: 2px solid var(--fk-bg);\n  box-shadow: 0 0 0 1px var(--fk-border);\n}\n.fk-swatch[aria-pressed=\"true\"] { box-shadow: 0 0 0 2px var(--fk-text); }\n.fk-hint { margin-left: auto; font-size: 12px; color: var(--fk-muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.fk-canvas-wrap {\n  position: relative;\n  flex: 1;\n  min-height: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 16px;\n  overflow: hidden;\n}\n.fk-canvas-box { position: relative; box-shadow: 0 4px 20px rgba(0, 0, 0, 0.18); border-radius: 6px; overflow: hidden; }\n.fk-canvas-box canvas { display: block; }\n.fk-canvas-box .fk-ink { position: absolute; inset: 0; touch-action: none; }\n.fk-stage[data-screenshot=\"off\"] .fk-canvas-box { opacity: 0.25; filter: grayscale(1); }\n.fk-stage[data-screenshot=\"off\"] .fk-toolbar button { pointer-events: none; opacity: 0.35; }\n.fk-off-note {\n  position: absolute;\n  inset: 0;\n  display: none;\n  align-items: center;\n  justify-content: center;\n  font-weight: 600;\n  color: var(--fk-muted);\n  pointer-events: none;\n}\n.fk-stage[data-screenshot=\"off\"] .fk-off-note { display: flex; }\n.fk-text-input {\n  position: absolute;\n  z-index: 2;\n  min-width: 120px;\n  padding: 6px 8px;\n  border: 2px solid var(--fk-primary);\n  border-radius: 8px;\n  background: var(--fk-bg);\n  color: var(--fk-text);\n  font: bold 14px -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;\n  outline: none;\n}\n\n/* ---------- composer ---------- */\n.fk-composer { display: flex; flex-direction: column; min-height: 0; padding: 18px; gap: 14px; overflow-y: auto; }\n.fk-header { display: flex; align-items: center; justify-content: space-between; gap: 8px; }\n.fk-title { margin: 0; font-size: 17px; font-weight: 650; letter-spacing: -0.01em; }\n.fk-close { display: inline-flex; width: 30px; height: 30px; align-items: center; justify-content: center; border: 0; border-radius: 15px; background: var(--fk-surface); color: var(--fk-muted); }\n.fk-close:hover { color: var(--fk-text); }\n.fk-label { display: block; margin-bottom: 6px; font-size: 12px; font-weight: 600; color: var(--fk-muted); text-transform: uppercase; letter-spacing: 0.04em; }\n.fk-textarea {\n  width: 100%;\n  min-height: 140px;\n  resize: vertical;\n  padding: 10px 12px;\n  border: 1px solid var(--fk-border);\n  border-radius: 10px;\n  background: var(--fk-bg);\n  color: var(--fk-text);\n  font: inherit;\n  line-height: 1.45;\n}\n.fk-textarea:focus { outline: none; border-color: var(--fk-primary); box-shadow: 0 0 0 3px color-mix(in srgb, var(--fk-primary) 22%, transparent); }\n.fk-chips { display: flex; flex-wrap: wrap; gap: 6px; }\n.fk-chip {\n  display: inline-flex;\n  align-items: center;\n  gap: 5px;\n  height: 28px;\n  padding: 0 11px;\n  border: 1px solid var(--fk-border);\n  border-radius: 14px;\n  background: var(--fk-bg);\n  font-size: 13px;\n}\n.fk-chip[aria-pressed=\"true\"] { border-color: var(--fk-primary); background: color-mix(in srgb, var(--fk-primary) 12%, transparent); color: var(--fk-primary); font-weight: 600; }\n.fk-row { display: flex; align-items: center; justify-content: space-between; gap: 10px; }\n.fk-switch { display: inline-flex; align-items: center; gap: 8px; font-size: 13px; cursor: pointer; user-select: none; }\n.fk-switch input { position: absolute; opacity: 0; width: 0; height: 0; }\n.fk-switch-track { position: relative; width: 36px; height: 22px; border-radius: 11px; background: var(--fk-border); transition: background 0.15s; }\n.fk-switch-track::after { content: \"\"; position: absolute; top: 2px; left: 2px; width: 18px; height: 18px; border-radius: 9px; background: #fff; box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3); transition: transform 0.15s; }\n.fk-switch input:checked + .fk-switch-track { background: var(--fk-primary); }\n.fk-switch input:checked + .fk-switch-track::after { transform: translateX(14px); }\n.fk-switch input:focus-visible + .fk-switch-track { outline: 2px solid var(--fk-primary); outline-offset: 2px; }\n.fk-attach {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  height: 32px;\n  padding: 0 12px;\n  border: 1px dashed var(--fk-secondary);\n  border-radius: 8px;\n  background: transparent;\n  color: var(--fk-secondary);\n  font-size: 13px;\n}\n.fk-file { display: inline-flex; align-items: center; gap: 6px; max-width: 100%; padding: 4px 6px 4px 10px; border-radius: 8px; background: var(--fk-surface); font-size: 12px; }\n.fk-file span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.fk-file button { display: inline-flex; border: 0; background: transparent; color: var(--fk-muted); padding: 2px; }\n.fk-meta { font-size: 12px; color: var(--fk-muted); }\n.fk-meta details summary { cursor: pointer; }\n.fk-meta pre { max-height: 140px; overflow: auto; margin: 6px 0 0; padding: 8px; border-radius: 8px; background: var(--fk-surface); font-size: 11px; white-space: pre-wrap; word-break: break-word; }\n.fk-spacer { flex: 1; }\n.fk-actions { display: flex; gap: 8px; }\n.fk-btn {\n  display: inline-flex;\n  flex: 1;\n  align-items: center;\n  justify-content: center;\n  gap: 7px;\n  height: 40px;\n  border-radius: 10px;\n  font-weight: 600;\n}\n.fk-btn-secondary { border: 1px solid var(--fk-border); background: transparent; color: var(--fk-secondary); }\n.fk-btn-primary { border: 0; background: var(--fk-primary); color: #fff; }\n.fk-btn-primary:hover:not(:disabled) { filter: brightness(1.06); }\n.fk-error { margin: 0; padding: 8px 10px; border-radius: 8px; background: color-mix(in srgb, var(--fk-danger) 12%, transparent); color: var(--fk-danger); font-size: 13px; }\n.fk-spinner { width: 16px; height: 16px; border: 2px solid rgba(255, 255, 255, 0.45); border-top-color: #fff; border-radius: 50%; animation: fk-spin 0.7s linear infinite; }\n@keyframes fk-spin { to { transform: rotate(360deg); } }\n.fk-done { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; flex: 1; text-align: center; }\n.fk-done-icon { display: inline-flex; width: 48px; height: 48px; align-items: center; justify-content: center; border-radius: 24px; background: var(--fk-primary); color: #fff; }\n.fk-done-icon svg { width: 26px; height: 26px; }\n.fk-sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }\n\n/* ---------- \"is it fixed?\" card (fixCard.ts) ---------- */\n.fk-fixcard {\n  position: fixed;\n  z-index: 2147483000;\n  right: 20px;\n  bottom: 76px;\n  width: min(360px, calc(100vw - 32px));\n  max-height: min(640px, calc(100vh - 96px));\n  overflow: auto;\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 16px;\n  border: 1px solid var(--fk-border);\n  border-radius: 16px;\n  background: var(--fk-bg);\n  box-shadow: var(--fk-shadow);\n  animation: fk-rise 0.2s ease-out;\n}\n.fk-fixcard[data-position=\"bottom-left\"] { right: auto; left: 20px; }\n.fk-fixcard > *, .fk-fixcard-actions > * { flex-shrink: 0; }\n.fk-fixcard p { margin: 0; }\n.fk-fixcard-header { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; }\n.fk-fixcard-shot { display: block; width: 100%; max-height: 220px; object-fit: contain; border-radius: 10px; background: var(--fk-surface); }\n.fk-fixcard-quote { font-size: 14px; }\n.fk-fixcard-summary { font-size: 13px; padding: 8px 10px; border-radius: 8px; background: var(--fk-surface); }\n.fk-fixcard-message p { font-size: 13px; }\n.fk-fixcard-question { font-weight: 600; }\n.fk-fixcard-actions { display: flex; flex-direction: column; gap: 8px; margin-top: 4px; }\n.fk-fixcard-actions .fk-btn { flex: none; width: 100%; }\n.fk-fixcard-actions .fk-textarea { min-height: 64px; }\n@keyframes fk-rise { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }\n\n/* ---------- narrow screens: stack stage over composer ---------- */\n@media (max-width: 760px) {\n  .fk-overlay { padding: 0; }\n  .fk-dialog { grid-template-columns: 1fr; grid-template-rows: minmax(0, 1fr) auto; width: 100%; height: 100%; border-radius: 0; }\n  .fk-stage { border-right: 0; border-bottom: 1px solid var(--fk-border); }\n  .fk-hint { display: none; }\n  .fk-canvas-wrap { padding: 10px; }\n  .fk-composer { max-height: 55vh; padding: 14px; gap: 10px; }\n  .fk-textarea { min-height: 84px; }\n  .fk-fixcard, .fk-fixcard[data-position] { right: 16px; left: 16px; width: auto; bottom: 16px; }\n}\n@media (prefers-reduced-motion: reduce) {\n  .fk-overlay, .fk-dialog, .fk-fixcard { animation: none; }\n}\n";

package/dist/types/ui/widget.d.ts

@@ -1,4 +1,5 @@
-import type { CaptureOptions, FeedbackKitConfiguration, FeedbackLogEntry, FeedbackProduct, FeedbackReport, FeedbackTheme } from "../types";
+import type { CaptureOptions, FeedbackKitConfiguration, FeedbackLogEntry, FeedbackProduct, FeedbackReport, FeedbackTheme, FeedbackUser, FixUpdate } from "../types";
+import { type FixCardOutcome } from "./fixCard";
 export interface WidgetDeps {
     configuration(): FeedbackKitConfiguration | null;
     theme(): FeedbackTheme | null;
@@ -7,6 +8,11 @@ export interface WidgetDeps {
     logs(): FeedbackLogEntry[];
     captureOptions(): CaptureOptions;
     currentScreen(): string | null;
+    /** Reporter identity attached to submitted reports (fixes.ts). */
+    identity(): {
+        reporterId: string;
+        user: FeedbackUser | null;
+    };
 }
 export interface OpenOptions {
     /** POST the report to the configured endpoint before resolving. */
@@ -15,6 +21,21 @@ export interface OpenOptions {
     onReport?: (report: FeedbackReport) => void | Promise<void>;
     /** Called if submitting fails. The dialog stays open so the user can retry. */
     onError?: (error: unknown) => void;
+    /**
+     * Deliver the report somewhere other than the ingestion endpoint — used by
+     * "still broken", which sends it as a reopen of the original report.
+     * Takes precedence over `submit`. Shows the thank-you state like `submit`.
+     */
+    deliver?: (report: FeedbackReport) => Promise<void>;
+    /** Dialog wording overrides (e.g. "What's still wrong?" for a reopen). */
+    copy?: DialogCopy;
+}
+export interface DialogCopy {
+    title?: string;
+    label?: string;
+    placeholder?: string;
+    thanksTitle?: string;
+    thanksBody?: string;
 }
 export interface TriggerOptions {
     position?: "bottom-right" | "bottom-left";
@@ -33,7 +54,15 @@ export declare class Widget {
     private shadow;
     private trigger;
     private pending;
+    private fixCard;
     constructor(deps: WidgetDeps);
+    get isShowingFixCard(): boolean;
+    /**
+     * The non-modal "is it fixed?" card (bottom corner). Resolves with what
+     * the reporter chose; the card removes itself.
+     */
+    showFixCard(update: FixUpdate): Promise<FixCardOutcome>;
+    hideFixCard(): void;
     /** True for the widget's own host element — used to keep it out of screenshots. */
     isOwnNode: (node: Node) => boolean;
     get isOpen(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedbackkit-web",
-  "version": "1.0.37",
+  "version": "1.0.38",
   "description": "Drop-in in-app feedback for websites: capture a screenshot, annotate it, describe the problem, and get a structured FeedbackKit report.",
   "type": "module",
   "main": "./dist/feedbackkit.js",