glitchgrab 1.26.0 → 1.28.0

package/README.md

@@ -158,6 +158,19 @@ Once `GlitchgrabProvider` is mounted, these shortcuts work globally:
 
 No configuration needed — shortcuts are active as long as the provider is in the tree.
 
+### Showing the shortcut in your own UI
+
+The report dialog shows the shortcut on its first step. To advertise it elsewhere — a support menu, a sidebar hint — read `shortcutLabel` instead of hardcoding the string. It resolves to `⌘⇧G` on Mac and `Ctrl+Shift+G` everywhere else, and stays in sync with the handler:
+
+```tsx
+function SupportHint() {
+  const { shortcutLabel } = useGlitchgrab();
+  return <p>Found a bug? Press {shortcutLabel} anywhere to report it.</p>;
+}
+```
+
+It is SSR-safe: it renders `Ctrl+Shift+G` on the server and corrects to the platform label after mount.
+
 ## How do I fetch reports by user?
 
 ### React hook (recommended)

package/dist/index.d.mts

@@ -19,7 +19,7 @@ interface GlitchgrabConfig {
      */
     ignoreErrors?: (string | RegExp)[];
 }
-type ReportType = "BUG" | "FEATURE_REQUEST" | "QUESTION" | "OTHER";
+type ReportType = "BUG" | "FEATURE_REQUEST" | "UI_IMPROVEMENT" | "PERFORMANCE" | "SECURITY" | "QUESTION" | "OTHER";
 type ReportSeverity = "low" | "medium" | "high";
 interface ReportPayload {
     token: string;
@@ -93,7 +93,7 @@ interface GlitchgrabProviderProps {
     maxBreadcrumbs?: number;
     children: ReactNode;
     fallback?: ReactNode;
-    /** Which report types to show in the dialog (default: all four) */
+    /** Which report types to show in the dialog (default: all) */
     types?: ReportType[];
     /** Show severity picker for BUG type (default: true) */
     showSeverity?: boolean;
@@ -127,6 +127,12 @@ interface UseGlitchgrabReturn {
      * Returns the polished text, or the original text on any failure (never throws).
      */
     enhanceText: (text: string, screenshot?: string | null) => Promise<string>;
+    /**
+     * OS-aware label for the shortcut that opens the report dialog —
+     * `⌘⇧G` on Mac, `Ctrl+Shift+G` elsewhere. Render this instead of
+     * hardcoding the shortcut, so the hint stays in sync with the handler.
+     */
+    shortcutLabel: string;
     /** The token being used */
     token: string;
     /** The base URL of the Glitchgrab API */
@@ -298,6 +304,24 @@ declare function addBreadcrumb(type: BreadcrumbType, message: string, data?: Rec
 declare function getBreadcrumbs(): Breadcrumb[];
 declare function clearBreadcrumbs(): void;
 
+/**
+ * The global keyboard shortcut that opens the Glitchgrab report dialog.
+ * Single source of truth — the provider's keydown handler and every label
+ * rendered anywhere (SDK dialog, host app UI) derive from this.
+ */
+/** Server-safe label. Used during SSR and as the non-Mac label. */
+declare const GLITCHGRAB_SHORTCUT = "Ctrl+Shift+G";
+/** Mac label, using the platform's modifier glyphs. */
+declare const GLITCHGRAB_SHORTCUT_MAC = "\u2318\u21E7G";
+/**
+ * OS-aware label for the report-dialog shortcut — `⌘⇧G` on Mac,
+ * `Ctrl+Shift+G` elsewhere. Returns the non-Mac label on the server, so
+ * render it client-side (or after mount) to avoid a hydration mismatch.
+ */
+declare function getShortcutLabel(): string;
+/** True when the keyboard event matches the report-dialog shortcut. */
+declare function matchesShortcut(e: KeyboardEvent): boolean;
+
 declare function sanitizeUrl(url: string): string;
 declare function captureDeviceInfo(): DeviceInfo | null;
 declare function captureContext(visitedPages: string[]): CapturedContext;
@@ -329,4 +353,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-export { type Breadcrumb, type BreadcrumbType, type CapturedContext, type DeviceInfo, type GlitchgrabConfig, GlitchgrabErrorBoundary, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabReports, getBreadcrumbs, initBreadcrumbs, sanitizeUrl, sendReport, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabReports };
+export { type Breadcrumb, type BreadcrumbType, type CapturedContext, type DeviceInfo, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, type GlitchgrabConfig, GlitchgrabErrorBoundary, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabReports, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendReport, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabReports };

package/dist/index.d.ts

@@ -19,7 +19,7 @@ interface GlitchgrabConfig {
      */
     ignoreErrors?: (string | RegExp)[];
 }
-type ReportType = "BUG" | "FEATURE_REQUEST" | "QUESTION" | "OTHER";
+type ReportType = "BUG" | "FEATURE_REQUEST" | "UI_IMPROVEMENT" | "PERFORMANCE" | "SECURITY" | "QUESTION" | "OTHER";
 type ReportSeverity = "low" | "medium" | "high";
 interface ReportPayload {
     token: string;
@@ -93,7 +93,7 @@ interface GlitchgrabProviderProps {
     maxBreadcrumbs?: number;
     children: ReactNode;
     fallback?: ReactNode;
-    /** Which report types to show in the dialog (default: all four) */
+    /** Which report types to show in the dialog (default: all) */
     types?: ReportType[];
     /** Show severity picker for BUG type (default: true) */
     showSeverity?: boolean;
@@ -127,6 +127,12 @@ interface UseGlitchgrabReturn {
      * Returns the polished text, or the original text on any failure (never throws).
      */
     enhanceText: (text: string, screenshot?: string | null) => Promise<string>;
+    /**
+     * OS-aware label for the shortcut that opens the report dialog —
+     * `⌘⇧G` on Mac, `Ctrl+Shift+G` elsewhere. Render this instead of
+     * hardcoding the shortcut, so the hint stays in sync with the handler.
+     */
+    shortcutLabel: string;
     /** The token being used */
     token: string;
     /** The base URL of the Glitchgrab API */
@@ -298,6 +304,24 @@ declare function addBreadcrumb(type: BreadcrumbType, message: string, data?: Rec
 declare function getBreadcrumbs(): Breadcrumb[];
 declare function clearBreadcrumbs(): void;
 
+/**
+ * The global keyboard shortcut that opens the Glitchgrab report dialog.
+ * Single source of truth — the provider's keydown handler and every label
+ * rendered anywhere (SDK dialog, host app UI) derive from this.
+ */
+/** Server-safe label. Used during SSR and as the non-Mac label. */
+declare const GLITCHGRAB_SHORTCUT = "Ctrl+Shift+G";
+/** Mac label, using the platform's modifier glyphs. */
+declare const GLITCHGRAB_SHORTCUT_MAC = "\u2318\u21E7G";
+/**
+ * OS-aware label for the report-dialog shortcut — `⌘⇧G` on Mac,
+ * `Ctrl+Shift+G` elsewhere. Returns the non-Mac label on the server, so
+ * render it client-side (or after mount) to avoid a hydration mismatch.
+ */
+declare function getShortcutLabel(): string;
+/** True when the keyboard event matches the report-dialog shortcut. */
+declare function matchesShortcut(e: KeyboardEvent): boolean;
+
 declare function sanitizeUrl(url: string): string;
 declare function captureDeviceInfo(): DeviceInfo | null;
 declare function captureContext(visitedPages: string[]): CapturedContext;
@@ -329,4 +353,4 @@ declare function computeSignature(params: {
 declare function shouldSkipDuplicate(signature: string, windowMs?: number, now?: number): boolean;
 declare function clearDedupCache(): void;
 
-export { type Breadcrumb, type BreadcrumbType, type CapturedContext, type DeviceInfo, type GlitchgrabConfig, GlitchgrabErrorBoundary, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabReports, getBreadcrumbs, initBreadcrumbs, sanitizeUrl, sendReport, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabReports };
+export { type Breadcrumb, type BreadcrumbType, type CapturedContext, type DeviceInfo, GLITCHGRAB_SHORTCUT, GLITCHGRAB_SHORTCUT_MAC, type GlitchgrabConfig, GlitchgrabErrorBoundary, GlitchgrabProvider, type GlitchgrabProviderProps, type GlitchgrabReport, type GlitchgrabSession, ReportButton, type ReportButtonProps, type ReportPayload, type ReportResult, type ReportSeverity, type ReportType, type UseGlitchgrabReturn, addBreadcrumb, captureContext, captureDeviceInfo, clearBreadcrumbs, clearDedupCache, computeSignature, enhanceText, fetchGlitchgrabReports, getBreadcrumbs, getShortcutLabel, initBreadcrumbs, matchesShortcut, sanitizeUrl, sendReport, shouldSkipDuplicate, useGlitchgrab, useGlitchgrabActions, useGlitchgrabReports };