gotcha-feedback 1.0.19 → 1.1.1

package/README.md

@@ -41,12 +41,15 @@ function FeatureCard() {
 - **Feedback Mode** - Star rating + text input
 - **Vote Mode** - Thumbs up/down with customizable labels
 - **Poll Mode** - Custom options (single or multi-select)
+- **NPS Mode** - 0-10 Net Promoter Score with optional follow-up
+- **Score Component** - Embeddable `<GotchaScore />` to display aggregate ratings inline
+- **Bug Flagging** - Let users flag feedback as issues/bugs with a single toggle
 - **User Segmentation** - Analyze feedback by custom user attributes
 - **Edit Support** - Users can update their previous submissions
 - **Customizable** - Themes, sizes, positions
 - **Accessible** - Full keyboard navigation and screen reader support
 - **Animated** - Smooth enter/exit animations with CSS transitions
-- **Lightweight** - ~15KB minified
+- **Lightweight** - ~11KB gzipped
 
 ## Props
 
@@ -65,7 +68,7 @@ function FeatureCard() {
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `elementId` | `string` | Required | Unique identifier for this element |
-| `mode` | `'feedback' \| 'vote' \| 'poll'` | `'feedback'` | Feedback mode |
+| `mode` | `'feedback' \| 'vote' \| 'poll' \| 'nps'` | `'feedback'` | Feedback mode |
 | `position` | `'top-right' \| 'top-left' \| 'bottom-right' \| 'bottom-left' \| 'inline'` | `'top-right'` | Button position |
 | `size` | `'sm' \| 'md' \| 'lg'` | `'md'` | Button size |
 | `theme` | `'light' \| 'dark' \| 'auto'` | `'light'` | Color theme |
@@ -76,6 +79,13 @@ function FeatureCard() {
 | `voteLabels` | `{ up: string, down: string }` | `{ up: 'Like', down: 'Dislike' }` | Custom vote button labels |
 | `options` | `string[]` | - | Poll options (2-6 items, required for poll mode) |
 | `allowMultiple` | `boolean` | `false` | Allow selecting multiple poll options |
+| `npsQuestion` | `string` | `'How likely are you to recommend us?'` | Custom NPS question |
+| `npsFollowUp` | `boolean` | `true` | Show follow-up textarea after NPS score |
+| `npsFollowUpPlaceholder` | `string` | - | Placeholder for NPS follow-up textarea |
+| `npsLowLabel` | `string` | `'Not likely'` | Label for low end of NPS scale |
+| `npsHighLabel` | `string` | `'Very likely'` | Label for high end of NPS scale |
+| `enableBugFlag` | `boolean` | `false` | Show "Report an issue" toggle in feedback form |
+| `bugFlagLabel` | `string` | `'Report an issue'` | Custom label for the bug flag toggle |
 | `user` | `object` | - | User metadata for segmentation |
 | `onSubmit` | `function` | - | Callback after submission |
 | `onOpen` | `function` | - | Callback when modal opens |
@@ -136,6 +146,40 @@ function FeatureCard() {
 />
 ```
 
+### NPS Mode
+
+```tsx
+<Gotcha
+  elementId="nps-survey"
+  mode="nps"
+  npsQuestion="How likely are you to recommend us?"
+  npsLowLabel="Not likely"
+  npsHighLabel="Very likely"
+/>
+```
+
+### Bug Flagging
+
+Add a "Report an issue" toggle to any feedback form. When toggled on, the submission is automatically flagged as a bug and creates a ticket in your dashboard.
+
+```tsx
+<Gotcha
+  elementId="checkout"
+  mode="feedback"
+  enableBugFlag
+/>
+```
+
+```tsx
+// Custom label for non-technical users
+<Gotcha
+  elementId="portal"
+  mode="feedback"
+  enableBugFlag
+  bugFlagLabel="Something isn't working"
+/>
+```
+
 ### Feedback Field Options
 
 By default, feedback mode shows both a star rating and a text input. Use `showText` and `showRating` to control which fields appear.
@@ -310,12 +354,41 @@ When you provide a `user.id`, users can update their previous feedback instead o
 
 The modal will show "Update" instead of "Submit" when editing, and previous values will be pre-filled.
 
+## GotchaScore Component
+
+Display aggregate feedback scores inline — star ratings, vote percentages, or raw numbers.
+
+```tsx
+import { GotchaScore } from 'gotcha-feedback';
+
+// Star rating display
+<GotchaScore elementId="feature-card" variant="stars" />
+
+// Compact pill (star + number)
+<GotchaScore elementId="feature-card" variant="compact" />
+
+// Vote percentage bar
+<GotchaScore elementId="pricing" variant="votes" />
+
+// Plain number
+<GotchaScore elementId="feature-card" variant="number" />
+```
+
+### GotchaScore Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `elementId` | `string` | Required | Element to show score for |
+| `variant` | `'stars' \| 'number' \| 'compact' \| 'votes'` | `'stars'` | Display variant |
+| `theme` | `'light' \| 'dark' \| 'auto'` | `'auto'` | Color theme |
+| `refreshInterval` | `number` | - | Auto-refresh interval in ms |
+
 ## TypeScript
 
 The package includes full TypeScript definitions:
 
 ```tsx
-import type { GotchaProps, GotchaProviderProps } from 'gotcha-feedback';
+import type { GotchaProps, GotchaProviderProps, ScoreData } from 'gotcha-feedback';
 ```
 
 ## Requirements

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1 from 'react';
 
-type ResponseMode = 'feedback' | 'vote' | 'poll';
+type ResponseMode = 'feedback' | 'vote' | 'poll' | 'nps';
 type VoteType = 'up' | 'down';
 interface GotchaUser {
     id?: string;
@@ -16,6 +16,23 @@ interface GotchaStyles {
     modal?: React.CSSProperties;
     input?: React.CSSProperties;
     submitButton?: React.CSSProperties;
+    title?: React.CSSProperties;
+    closeButton?: React.CSSProperties;
+    starRating?: React.CSSProperties;
+    star?: React.CSSProperties;
+    voteButton?: React.CSSProperties;
+    voteButtonSelected?: React.CSSProperties;
+    pollOption?: React.CSSProperties;
+    pollOptionSelected?: React.CSSProperties;
+    npsButton?: React.CSSProperties;
+    npsButtonSelected?: React.CSSProperties;
+    npsLabels?: React.CSSProperties;
+    successMessage?: React.CSSProperties;
+    successIcon?: React.CSSProperties;
+    errorMessage?: React.CSSProperties;
+    bugFlag?: React.CSSProperties;
+    backdrop?: React.CSSProperties;
+    spinner?: React.CSSProperties;
 }
 interface SubmitResponsePayload {
     elementId: string;
@@ -26,6 +43,7 @@ interface SubmitResponsePayload {
     vote?: VoteType;
     pollOptions?: string[];
     pollSelected?: string[];
+    isBug?: boolean;
     user?: GotchaUser;
     context?: {
         url?: string;
@@ -57,7 +75,133 @@ interface GotchaError {
     message: string;
     status: number;
 }
-type ErrorCode = 'INVALID_API_KEY' | 'ORIGIN_NOT_ALLOWED' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'INVALID_REQUEST' | 'USER_NOT_FOUND' | 'INTERNAL_ERROR';
+type ErrorCode = 'INVALID_API_KEY' | 'ORIGIN_NOT_ALLOWED' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'INVALID_REQUEST' | 'USER_NOT_FOUND' | 'INTERNAL_ERROR' | 'PARSE_ERROR';
+interface ScoreData {
+    elementId: string;
+    averageRating: number | null;
+    totalResponses: number;
+    ratingCount: number;
+    voteCount: {
+        up: number;
+        down: number;
+    };
+    positiveRate: number | null;
+    npsScore: number | null;
+}
+
+interface GotchaThemeColors {
+    primary: string;
+    primaryHover: string;
+    primaryText: string;
+    background: string;
+    backgroundGradient: string;
+    surface: string;
+    surfaceHover: string;
+    text: string;
+    textSecondary: string;
+    textDisabled: string;
+    border: string;
+    borderFocus: string;
+    success: string;
+    successSurface: string;
+    error: string;
+    errorSurface: string;
+    errorBorder: string;
+    warning: string;
+    warningActive: string;
+    warningSurface: string;
+    warningBorder: string;
+    starFilled: string;
+    starEmpty: string;
+    voteUp: string;
+    voteUpSurface: string;
+    voteUpBorder: string;
+    voteDown: string;
+    voteDownSurface: string;
+    voteDownBorder: string;
+    npsColors: string[];
+    buttonBackground: string;
+    buttonBackgroundHover: string;
+    buttonBackgroundDisabled: string;
+    buttonColor: string;
+    buttonColorDisabled: string;
+    buttonBorder: string;
+    buttonShadow: string;
+    backdropColor: string;
+    closeButton: string;
+    closeButtonHover: string;
+    closeButtonBg: string;
+    glassBackground: string;
+    glassBorder: string;
+    glassColor: string;
+    glassShadow: string;
+    glassHoverShadow: string;
+    inputBackground: string;
+    inputBackgroundFocus: string;
+    inputBorder: string;
+    inputBorderFocus: string;
+    inputFocusRing: string;
+    pollBorder: string;
+    pollSelectedBorder: string;
+    pollBackground: string;
+    pollSelectedBackground: string;
+    pollColor: string;
+    pollSelectedColor: string;
+    pollCheckBorder: string;
+    pollCheckSelectedBorder: string;
+    pollCheckSelectedBg: string;
+}
+interface GotchaThemeTypography {
+    fontFamily: string;
+    fontSize: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+    };
+    fontWeight: {
+        normal: number;
+        medium: number;
+        semibold: number;
+        bold: number;
+    };
+}
+interface GotchaThemeBorders {
+    radius: {
+        sm: number;
+        md: number;
+        lg: number;
+        full: string;
+    };
+    width: number;
+}
+interface GotchaThemeShadows {
+    sm: string;
+    md: string;
+    lg: string;
+    modal: string;
+    button: string;
+}
+interface GotchaThemeAnimation {
+    duration: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    easing: {
+        default: string;
+        spring: string;
+    };
+}
+interface GotchaThemeConfig {
+    colors?: Partial<GotchaThemeColors>;
+    typography?: Partial<GotchaThemeTypography>;
+    borders?: Partial<GotchaThemeBorders>;
+    shadows?: Partial<GotchaThemeShadows>;
+    animation?: Partial<GotchaThemeAnimation>;
+}
+/** Create a custom theme by merging partial overrides onto a preset */
+declare function createTheme(base: 'light' | 'dark', overrides: GotchaThemeConfig): GotchaThemeConfig;
 
 interface GotchaProviderProps {
     /** Your Gotcha API key */
@@ -72,8 +216,10 @@ interface GotchaProviderProps {
     disabled?: boolean;
     /** Default user metadata applied to all submissions */
     defaultUser?: GotchaUser;
+    /** Theme configuration overrides applied to all instances */
+    themeConfig?: GotchaThemeConfig;
 }
-declare function GotchaProvider({ apiKey, children, baseUrl, debug, disabled, defaultUser, }: GotchaProviderProps): react_jsx_runtime.JSX.Element;
+declare function GotchaProvider({ apiKey, children, baseUrl, debug, disabled, defaultUser, themeConfig, }: GotchaProviderProps): react_jsx_runtime.JSX.Element;
 
 interface GotchaProps {
     /** Unique identifier for this element */
@@ -95,8 +241,16 @@ interface GotchaProps {
     options?: string[];
     /** Allow selecting multiple options */
     allowMultiple?: boolean;
-    /** Show results after voting */
-    showResults?: boolean;
+    /** Custom NPS question (default: "How likely are you to recommend us?") */
+    npsQuestion?: string;
+    /** Show follow-up textarea after score selection (default: true) */
+    npsFollowUp?: boolean;
+    /** Placeholder for NPS follow-up textarea */
+    npsFollowUpPlaceholder?: string;
+    /** Label for low end of NPS scale (default: "Not likely") */
+    npsLowLabel?: string;
+    /** Label for high end of NPS scale (default: "Very likely") */
+    npsHighLabel?: string;
     /** Button position relative to parent */
     position?: Position;
     /** Button size */
@@ -119,6 +273,14 @@ interface GotchaProps {
     submitText?: string;
     /** Post-submission message */
     thankYouMessage?: string;
+    /** Show "Report an issue" toggle in feedback form (default: false) */
+    enableBugFlag?: boolean;
+    /** Custom label for the bug flag toggle (default: "Report an issue") */
+    bugFlagLabel?: string;
+    /** When true and user has already responded, show submitted state and allow review/edit instead of new submission */
+    onePerUser?: boolean;
+    /** Enable entrance animations on the button and modal (default: true) */
+    animated?: boolean;
     /** Called after successful submission */
     onSubmit?: (response: GotchaResponse) => void;
     /** Called when modal opens */
@@ -128,7 +290,19 @@ interface GotchaProps {
     /** Called on error */
     onError?: (error: GotchaError) => void;
 }
-declare function Gotcha({ elementId, user, mode, showText, showRating, voteLabels, options, allowMultiple, showResults, position, size, theme, customStyles, visible, showOnHover, touchBehavior, promptText, placeholder, submitText, thankYouMessage, onSubmit, onOpen, onClose, onError, }: GotchaProps): react_jsx_runtime.JSX.Element | null;
+declare function Gotcha({ elementId, user, mode, showText, showRating, voteLabels, options, allowMultiple, npsQuestion, npsFollowUp, npsFollowUpPlaceholder, npsLowLabel, npsHighLabel, enableBugFlag, bugFlagLabel, onePerUser, animated, position, size, theme, customStyles, visible, showOnHover, touchBehavior, promptText, placeholder, submitText, thankYouMessage, onSubmit, onOpen, onClose, onError, }: GotchaProps): react_jsx_runtime.JSX.Element | null;
+
+type ScoreVariant = 'stars' | 'number' | 'compact' | 'votes';
+interface GotchaScoreProps {
+    elementId: string;
+    variant?: ScoreVariant;
+    showCount?: boolean;
+    size?: Size;
+    theme?: Theme;
+    refreshInterval?: number;
+    style?: React$1.CSSProperties;
+}
+declare function GotchaScore({ elementId, variant, showCount, size, theme, refreshInterval, style, }: GotchaScoreProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Hook to access Gotcha context
@@ -146,6 +320,11 @@ declare function useGotcha(): {
             vote?: VoteType;
             pollSelected?: string[];
         }, userId?: string): Promise<GotchaResponse>;
+        getScore(elementId: string): Promise<ScoreData>;
+        flagAsBug(responseId: string): Promise<{
+            ticketId: string;
+            status: string;
+        }>;
         getBaseUrl(): string;
     };
     /** Whether Gotcha is globally disabled */
@@ -158,4 +337,4 @@ declare function useGotcha(): {
     submitFeedback: (payload: Omit<SubmitResponsePayload, "context">) => Promise<GotchaResponse>;
 };
 
-export { Gotcha, type GotchaError, type GotchaProps, GotchaProvider, type GotchaProviderProps, type GotchaResponse, type GotchaStyles, type GotchaUser, type Position, type ResponseMode, type Size, type Theme, type TouchBehavior, type VoteType, useGotcha };
+export { Gotcha, type GotchaError, type GotchaProps, GotchaProvider, type GotchaProviderProps, type GotchaResponse, GotchaScore, type GotchaScoreProps, type GotchaStyles, type GotchaThemeConfig, type GotchaUser, type Position, type ResponseMode, type ScoreData, type Size, type Theme, type TouchBehavior, type VoteType, createTheme, useGotcha };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1 from 'react';
 
-type ResponseMode = 'feedback' | 'vote' | 'poll';
+type ResponseMode = 'feedback' | 'vote' | 'poll' | 'nps';
 type VoteType = 'up' | 'down';
 interface GotchaUser {
     id?: string;
@@ -16,6 +16,23 @@ interface GotchaStyles {
     modal?: React.CSSProperties;
     input?: React.CSSProperties;
     submitButton?: React.CSSProperties;
+    title?: React.CSSProperties;
+    closeButton?: React.CSSProperties;
+    starRating?: React.CSSProperties;
+    star?: React.CSSProperties;
+    voteButton?: React.CSSProperties;
+    voteButtonSelected?: React.CSSProperties;
+    pollOption?: React.CSSProperties;
+    pollOptionSelected?: React.CSSProperties;
+    npsButton?: React.CSSProperties;
+    npsButtonSelected?: React.CSSProperties;
+    npsLabels?: React.CSSProperties;
+    successMessage?: React.CSSProperties;
+    successIcon?: React.CSSProperties;
+    errorMessage?: React.CSSProperties;
+    bugFlag?: React.CSSProperties;
+    backdrop?: React.CSSProperties;
+    spinner?: React.CSSProperties;
 }
 interface SubmitResponsePayload {
     elementId: string;
@@ -26,6 +43,7 @@ interface SubmitResponsePayload {
     vote?: VoteType;
     pollOptions?: string[];
     pollSelected?: string[];
+    isBug?: boolean;
     user?: GotchaUser;
     context?: {
         url?: string;
@@ -57,7 +75,133 @@ interface GotchaError {
     message: string;
     status: number;
 }
-type ErrorCode = 'INVALID_API_KEY' | 'ORIGIN_NOT_ALLOWED' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'INVALID_REQUEST' | 'USER_NOT_FOUND' | 'INTERNAL_ERROR';
+type ErrorCode = 'INVALID_API_KEY' | 'ORIGIN_NOT_ALLOWED' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'INVALID_REQUEST' | 'USER_NOT_FOUND' | 'INTERNAL_ERROR' | 'PARSE_ERROR';
+interface ScoreData {
+    elementId: string;
+    averageRating: number | null;
+    totalResponses: number;
+    ratingCount: number;
+    voteCount: {
+        up: number;
+        down: number;
+    };
+    positiveRate: number | null;
+    npsScore: number | null;
+}
+
+interface GotchaThemeColors {
+    primary: string;
+    primaryHover: string;
+    primaryText: string;
+    background: string;
+    backgroundGradient: string;
+    surface: string;
+    surfaceHover: string;
+    text: string;
+    textSecondary: string;
+    textDisabled: string;
+    border: string;
+    borderFocus: string;
+    success: string;
+    successSurface: string;
+    error: string;
+    errorSurface: string;
+    errorBorder: string;
+    warning: string;
+    warningActive: string;
+    warningSurface: string;
+    warningBorder: string;
+    starFilled: string;
+    starEmpty: string;
+    voteUp: string;
+    voteUpSurface: string;
+    voteUpBorder: string;
+    voteDown: string;
+    voteDownSurface: string;
+    voteDownBorder: string;
+    npsColors: string[];
+    buttonBackground: string;
+    buttonBackgroundHover: string;
+    buttonBackgroundDisabled: string;
+    buttonColor: string;
+    buttonColorDisabled: string;
+    buttonBorder: string;
+    buttonShadow: string;
+    backdropColor: string;
+    closeButton: string;
+    closeButtonHover: string;
+    closeButtonBg: string;
+    glassBackground: string;
+    glassBorder: string;
+    glassColor: string;
+    glassShadow: string;
+    glassHoverShadow: string;
+    inputBackground: string;
+    inputBackgroundFocus: string;
+    inputBorder: string;
+    inputBorderFocus: string;
+    inputFocusRing: string;
+    pollBorder: string;
+    pollSelectedBorder: string;
+    pollBackground: string;
+    pollSelectedBackground: string;
+    pollColor: string;
+    pollSelectedColor: string;
+    pollCheckBorder: string;
+    pollCheckSelectedBorder: string;
+    pollCheckSelectedBg: string;
+}
+interface GotchaThemeTypography {
+    fontFamily: string;
+    fontSize: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+    };
+    fontWeight: {
+        normal: number;
+        medium: number;
+        semibold: number;
+        bold: number;
+    };
+}
+interface GotchaThemeBorders {
+    radius: {
+        sm: number;
+        md: number;
+        lg: number;
+        full: string;
+    };
+    width: number;
+}
+interface GotchaThemeShadows {
+    sm: string;
+    md: string;
+    lg: string;
+    modal: string;
+    button: string;
+}
+interface GotchaThemeAnimation {
+    duration: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    easing: {
+        default: string;
+        spring: string;
+    };
+}
+interface GotchaThemeConfig {
+    colors?: Partial<GotchaThemeColors>;
+    typography?: Partial<GotchaThemeTypography>;
+    borders?: Partial<GotchaThemeBorders>;
+    shadows?: Partial<GotchaThemeShadows>;
+    animation?: Partial<GotchaThemeAnimation>;
+}
+/** Create a custom theme by merging partial overrides onto a preset */
+declare function createTheme(base: 'light' | 'dark', overrides: GotchaThemeConfig): GotchaThemeConfig;
 
 interface GotchaProviderProps {
     /** Your Gotcha API key */
@@ -72,8 +216,10 @@ interface GotchaProviderProps {
     disabled?: boolean;
     /** Default user metadata applied to all submissions */
     defaultUser?: GotchaUser;
+    /** Theme configuration overrides applied to all instances */
+    themeConfig?: GotchaThemeConfig;
 }
-declare function GotchaProvider({ apiKey, children, baseUrl, debug, disabled, defaultUser, }: GotchaProviderProps): react_jsx_runtime.JSX.Element;
+declare function GotchaProvider({ apiKey, children, baseUrl, debug, disabled, defaultUser, themeConfig, }: GotchaProviderProps): react_jsx_runtime.JSX.Element;
 
 interface GotchaProps {
     /** Unique identifier for this element */
@@ -95,8 +241,16 @@ interface GotchaProps {
     options?: string[];
     /** Allow selecting multiple options */
     allowMultiple?: boolean;
-    /** Show results after voting */
-    showResults?: boolean;
+    /** Custom NPS question (default: "How likely are you to recommend us?") */
+    npsQuestion?: string;
+    /** Show follow-up textarea after score selection (default: true) */
+    npsFollowUp?: boolean;
+    /** Placeholder for NPS follow-up textarea */
+    npsFollowUpPlaceholder?: string;
+    /** Label for low end of NPS scale (default: "Not likely") */
+    npsLowLabel?: string;
+    /** Label for high end of NPS scale (default: "Very likely") */
+    npsHighLabel?: string;
     /** Button position relative to parent */
     position?: Position;
     /** Button size */
@@ -119,6 +273,14 @@ interface GotchaProps {
     submitText?: string;
     /** Post-submission message */
     thankYouMessage?: string;
+    /** Show "Report an issue" toggle in feedback form (default: false) */
+    enableBugFlag?: boolean;
+    /** Custom label for the bug flag toggle (default: "Report an issue") */
+    bugFlagLabel?: string;
+    /** When true and user has already responded, show submitted state and allow review/edit instead of new submission */
+    onePerUser?: boolean;
+    /** Enable entrance animations on the button and modal (default: true) */
+    animated?: boolean;
     /** Called after successful submission */
     onSubmit?: (response: GotchaResponse) => void;
     /** Called when modal opens */
@@ -128,7 +290,19 @@ interface GotchaProps {
     /** Called on error */
     onError?: (error: GotchaError) => void;
 }
-declare function Gotcha({ elementId, user, mode, showText, showRating, voteLabels, options, allowMultiple, showResults, position, size, theme, customStyles, visible, showOnHover, touchBehavior, promptText, placeholder, submitText, thankYouMessage, onSubmit, onOpen, onClose, onError, }: GotchaProps): react_jsx_runtime.JSX.Element | null;
+declare function Gotcha({ elementId, user, mode, showText, showRating, voteLabels, options, allowMultiple, npsQuestion, npsFollowUp, npsFollowUpPlaceholder, npsLowLabel, npsHighLabel, enableBugFlag, bugFlagLabel, onePerUser, animated, position, size, theme, customStyles, visible, showOnHover, touchBehavior, promptText, placeholder, submitText, thankYouMessage, onSubmit, onOpen, onClose, onError, }: GotchaProps): react_jsx_runtime.JSX.Element | null;
+
+type ScoreVariant = 'stars' | 'number' | 'compact' | 'votes';
+interface GotchaScoreProps {
+    elementId: string;
+    variant?: ScoreVariant;
+    showCount?: boolean;
+    size?: Size;
+    theme?: Theme;
+    refreshInterval?: number;
+    style?: React$1.CSSProperties;
+}
+declare function GotchaScore({ elementId, variant, showCount, size, theme, refreshInterval, style, }: GotchaScoreProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Hook to access Gotcha context
@@ -146,6 +320,11 @@ declare function useGotcha(): {
             vote?: VoteType;
             pollSelected?: string[];
         }, userId?: string): Promise<GotchaResponse>;
+        getScore(elementId: string): Promise<ScoreData>;
+        flagAsBug(responseId: string): Promise<{
+            ticketId: string;
+            status: string;
+        }>;
         getBaseUrl(): string;
     };
     /** Whether Gotcha is globally disabled */
@@ -158,4 +337,4 @@ declare function useGotcha(): {
     submitFeedback: (payload: Omit<SubmitResponsePayload, "context">) => Promise<GotchaResponse>;
 };
 
-export { Gotcha, type GotchaError, type GotchaProps, GotchaProvider, type GotchaProviderProps, type GotchaResponse, type GotchaStyles, type GotchaUser, type Position, type ResponseMode, type Size, type Theme, type TouchBehavior, type VoteType, useGotcha };
+export { Gotcha, type GotchaError, type GotchaProps, GotchaProvider, type GotchaProviderProps, type GotchaResponse, GotchaScore, type GotchaScoreProps, type GotchaStyles, type GotchaThemeConfig, type GotchaUser, type Position, type ResponseMode, type ScoreData, type Size, type Theme, type TouchBehavior, type VoteType, createTheme, useGotcha };