react-grab 0.0.97 → 0.1.0-beta.0

package/dist/core/index.cjs

@@ -1 +1 @@
-'use strict';var chunkQVFHXAET_cjs=require('../chunk-QVFHXAET.cjs');Object.defineProperty(exports,"DEFAULT_THEME",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.f}});Object.defineProperty(exports,"copyContent",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.d}});Object.defineProperty(exports,"formatElementInfo",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.c}});Object.defineProperty(exports,"generateSnippet",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.e}});Object.defineProperty(exports,"getStack",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.b}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.g}});Object.defineProperty(exports,"isInstrumentationActive",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.a}});
+'use strict';var chunkDIAOCH5J_cjs=require('../chunk-DIAOCH5J.cjs');Object.defineProperty(exports,"DEFAULT_THEME",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.j}});Object.defineProperty(exports,"copyContent",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.e}});Object.defineProperty(exports,"formatElementInfo",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.d}});Object.defineProperty(exports,"generateSnippet",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.f}});Object.defineProperty(exports,"getStack",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.c}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.k}});Object.defineProperty(exports,"isInstrumentationActive",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.b}});

package/dist/core/index.d.cts

@@ -1,3 +1,3 @@
-export { o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, D as DEFAULT_THEME, O as Options, d as OverlayBounds, R as ReactGrabAPI, q as ReactGrabRendererProps, U as UpdatableOptions, r as copyContent, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from '../index-RhgdSH9U.cjs';
+export { s as ActionContext, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, r as ContextMenuAction, D as DEFAULT_THEME, O as Options, d as OverlayBounds, t as Plugin, u as PluginConfig, v as PluginHooks, R as ReactGrabAPI, w as ReactGrabRendererProps, p as SettableOptions, S as SourceInfo, x as copyContent, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from '../index-BdKhAk4Q.cjs';
 export { isInstrumentationActive } from 'bippy';
 import 'bippy/source';

package/dist/core/index.d.ts

@@ -1,3 +1,3 @@
-export { o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, D as DEFAULT_THEME, O as Options, d as OverlayBounds, R as ReactGrabAPI, q as ReactGrabRendererProps, U as UpdatableOptions, r as copyContent, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from '../index-RhgdSH9U.js';
+export { s as ActionContext, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, r as ContextMenuAction, D as DEFAULT_THEME, O as Options, d as OverlayBounds, t as Plugin, u as PluginConfig, v as PluginHooks, R as ReactGrabAPI, w as ReactGrabRendererProps, p as SettableOptions, S as SourceInfo, x as copyContent, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from '../index-BdKhAk4Q.js';
 export { isInstrumentationActive } from 'bippy';
 import 'bippy/source';

package/dist/core/index.js

@@ -1 +1 @@
-export{f as DEFAULT_THEME,d as copyContent,c as formatElementInfo,e as generateSnippet,b as getStack,g as init,a as isInstrumentationActive}from'../chunk-K6AYIDZE.js';
+export{j as DEFAULT_THEME,e as copyContent,d as formatElementInfo,f as generateSnippet,c as getStack,k as init,b as isInstrumentationActive}from'../chunk-VXZ5VMRT.js';

package/dist/{index-RhgdSH9U.d.cts → index-BdKhAk4Q.d.cts}

@@ -2,7 +2,7 @@ import { StackFrame } from 'bippy/source';
 import 'bippy';
 
 type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+    [P in keyof T]?: T[P] extends object ? T[P] extends (...args: unknown[]) => unknown ? T[P] : DeepPartial<T[P]> : T[P];
 };
 interface Theme {
     /**
@@ -80,12 +80,25 @@ interface ReactGrabState {
     isActive: boolean;
     isDragging: boolean;
     isCopying: boolean;
-    isInputMode: boolean;
+    isPromptMode: boolean;
+    isCrosshairVisible: boolean;
+    isSelectionBoxVisible: boolean;
+    isDragBoxVisible: boolean;
     targetElement: Element | null;
     dragBounds: DragRect | null;
+    /**
+     * Currently visible grabbed boxes (success flash effects).
+     * These are temporary visual indicators shown after elements are grabbed/copied.
+     */
+    grabbedBoxes: Array<{
+        id: string;
+        bounds: OverlayBounds;
+        createdAt: number;
+    }>;
+    selectionFilePath: string | null;
 }
 type ElementLabelVariant = "hover" | "processing" | "success";
-interface InputModeContext {
+interface PromptModeContext {
     x: number;
     y: number;
     targetElement: Element | null;
@@ -98,14 +111,13 @@ interface ElementLabelContext {
     x: number;
     y: number;
     content: string;
+    element?: Element;
+    tagName?: string;
+    componentName?: string;
+    filePath?: string;
+    lineNumber?: number;
 }
-interface ActivationKey {
-    key?: string;
-    metaKey?: boolean;
-    ctrlKey?: boolean;
-    shiftKey?: boolean;
-    altKey?: boolean;
-}
+type ActivationKey = string | ((event: KeyboardEvent) => boolean);
 interface AgentContext<T = unknown> {
     content: string[];
     prompt: string;
@@ -117,6 +129,7 @@ interface AgentSession {
     context: AgentContext;
     lastStatus: string;
     isStreaming: boolean;
+    isFading?: boolean;
     createdAt: number;
     lastUpdatedAt: number;
     position: {
@@ -164,16 +177,24 @@ interface AgentOptions<T = any> {
     onDismiss?: (session: AgentSession, elements: Element[]) => void;
 }
 type ActivationMode = "toggle" | "hold";
-interface Options {
-    enabled?: boolean;
-    activationMode?: ActivationMode;
-    keyHoldDuration?: number;
-    allowActivationInsideInput?: boolean;
-    maxContextLines?: number;
-    theme?: Theme;
-    activationShortcut?: (event: KeyboardEvent) => boolean;
-    activationKey?: ActivationKey;
-    getContent?: (elements: Element[]) => Promise<string> | string;
+interface ActionContext {
+    element: Element;
+    elements: Element[];
+    filePath?: string;
+    lineNumber?: number;
+    componentName?: string;
+    tagName?: string;
+    enterPromptMode?: (agent?: AgentOptions) => void;
+}
+interface ContextMenuAction {
+    id: string;
+    label: string;
+    shortcut?: string;
+    enabled?: boolean | ((context: ActionContext) => boolean);
+    onAction: (context: ActionContext) => void;
+    agent?: AgentOptions;
+}
+interface PluginHooks {
     onActivate?: () => void;
     onDeactivate?: () => void;
     onElementHover?: (element: Element) => void;
@@ -185,16 +206,48 @@ interface Options {
     onCopySuccess?: (elements: Element[], content: string) => void;
     onCopyError?: (error: Error) => void;
     onStateChange?: (state: ReactGrabState) => void;
-    onInputModeChange?: (isInputMode: boolean, context: InputModeContext) => void;
+    onPromptModeChange?: (isPromptMode: boolean, context: PromptModeContext) => void;
     onSelectionBox?: (visible: boolean, bounds: OverlayBounds | null, element: Element | null) => void;
     onDragBox?: (visible: boolean, bounds: OverlayBounds | null) => void;
     onGrabbedBox?: (bounds: OverlayBounds, element: Element) => void;
     onElementLabel?: (visible: boolean, variant: ElementLabelVariant, context: ElementLabelContext) => void;
     onCrosshair?: (visible: boolean, context: CrosshairContext) => void;
-    onOpenFile?: (filePath: string, lineNumber?: number) => void;
-    agent?: AgentOptions;
+    onContextMenu?: (element: Element, position: {
+        x: number;
+        y: number;
+    }) => void;
+    onOpenFile?: (filePath: string, lineNumber?: number) => boolean | void;
+}
+interface PluginConfig {
+    theme?: DeepPartial<Theme>;
+    options?: SettableOptions;
+    actions?: ContextMenuAction[];
+    hooks?: PluginHooks;
+    cleanup?: () => void;
+}
+interface Plugin {
+    name: string;
+    theme?: DeepPartial<Theme>;
+    options?: SettableOptions;
+    actions?: ContextMenuAction[];
+    hooks?: PluginHooks;
+    setup?: (api: ReactGrabAPI) => PluginConfig | void;
+}
+interface Options {
+    enabled?: boolean;
+    activationMode?: ActivationMode;
+    keyHoldDuration?: number;
+    allowActivationInsideInput?: boolean;
+    maxContextLines?: number;
+    activationKey?: ActivationKey;
+    getContent?: (elements: Element[]) => Promise<string> | string;
+}
+type SettableOptions = Omit<Options, "enabled">;
+interface SourceInfo {
+    filePath: string;
+    lineNumber: number | null;
+    componentName: string | null;
 }
-type UpdatableOptions = Pick<Options, "onActivate" | "onDeactivate" | "onElementHover" | "onElementSelect" | "onDragStart" | "onDragEnd" | "onBeforeCopy" | "onAfterCopy" | "onCopySuccess" | "onCopyError" | "onStateChange" | "onInputModeChange" | "onSelectionBox" | "onDragBox" | "onGrabbedBox" | "onElementLabel" | "onCrosshair" | "onOpenFile">;
 interface ReactGrabAPI {
     activate: () => void;
     deactivate: () => void;
@@ -202,11 +255,12 @@ interface ReactGrabAPI {
     isActive: () => boolean;
     dispose: () => void;
     copyElement: (elements: Element | Element[]) => Promise<boolean>;
+    getSource: (element: Element) => Promise<SourceInfo | null>;
     getState: () => ReactGrabState;
-    updateTheme: (theme: DeepPartial<Theme>) => void;
-    getTheme: () => Required<Theme>;
-    setAgent: (options: AgentOptions) => void;
-    updateOptions: (options: UpdatableOptions) => void;
+    setOptions: (options: SettableOptions) => void;
+    registerPlugin: (plugin: Plugin) => void;
+    unregisterPlugin: (name: string) => void;
+    getPlugins: () => string[];
 }
 interface OverlayBounds {
     borderRadius: string;
@@ -216,16 +270,20 @@ interface OverlayBounds {
     x: number;
     y: number;
 }
-type SelectionLabelStatus = "idle" | "copying" | "copied" | "fading";
+type SelectionLabelStatus = "idle" | "copying" | "copied" | "fading" | "error";
 interface SelectionLabelInstance {
     id: string;
     bounds: OverlayBounds;
+    boundsMultiple?: OverlayBounds[];
     tagName: string;
     componentName?: string;
     status: SelectionLabelStatus;
     createdAt: number;
     element?: Element;
+    elements?: Element[];
     mouseX?: number;
+    mouseXOffsetFromCenter?: number;
+    errorMessage?: string;
 }
 interface ReactGrabRendererProps {
     selectionVisible?: boolean;
@@ -251,7 +309,7 @@ interface ReactGrabRendererProps {
     mouseY?: number;
     crosshairVisible?: boolean;
     inputValue?: string;
-    isInputMode?: boolean;
+    isPromptMode?: boolean;
     replyToPrompt?: string;
     hasAgent?: boolean;
     isAgentConnected?: boolean;
@@ -266,6 +324,8 @@ interface ReactGrabRendererProps {
     onFollowUpSubmitSession?: (sessionId: string, prompt: string) => void;
     onAcknowledgeSessionError?: (sessionId: string) => void;
     onRetrySession?: (sessionId: string) => void;
+    onShowContextMenuSession?: (sessionId: string) => void;
+    onShowContextMenuInstance?: (instanceId: string) => void;
     onInputChange?: (value: string) => void;
     onInputSubmit?: () => void;
     onInputCancel?: () => void;
@@ -278,6 +338,21 @@ interface ReactGrabRendererProps {
     toolbarVisible?: boolean;
     isActive?: boolean;
     onToggleActive?: () => void;
+    contextMenuPosition?: {
+        x: number;
+        y: number;
+    } | null;
+    contextMenuBounds?: OverlayBounds | null;
+    contextMenuTagName?: string;
+    contextMenuComponentName?: string;
+    contextMenuHasFilePath?: boolean;
+    actions?: ContextMenuAction[];
+    actionContext?: ActionContext;
+    onContextMenuCopy?: () => void;
+    onContextMenuCopyScreenshot?: () => void;
+    onContextMenuOpen?: () => void;
+    onContextMenuDismiss?: () => void;
+    onContextMenuHide?: () => void;
 }
 interface GrabbedBox {
     id: string;
@@ -319,4 +394,4 @@ declare const copyContent: (content: string, options?: CopyContentOptions) => bo
 
 declare const init: (rawOptions?: Options) => ReactGrabAPI;
 
-export { type AgentContext as A, type CrosshairContext as C, DEFAULT_THEME as D, type ElementLabelVariant as E, type GrabbedBox as G, type InputModeContext as I, type Options as O, type ReactGrabAPI as R, type Theme as T, type UpdatableOptions as U, getElementContext as a, generateSnippet as b, type ReactGrabState as c, type OverlayBounds as d, type DragRect as e, type Rect as f, getStack as g, type DeepPartial as h, init as i, type ElementLabelContext as j, type AgentSession as k, type AgentProvider as l, type AgentSessionStorage as m, type AgentOptions as n, type AgentCompleteResult as o, type ActivationMode as p, type ReactGrabRendererProps as q, copyContent as r };
+export { type AgentContext as A, type CrosshairContext as C, DEFAULT_THEME as D, type ElementLabelVariant as E, type GrabbedBox as G, type Options as O, type PromptModeContext as P, type ReactGrabAPI as R, type SourceInfo as S, type Theme as T, getElementContext as a, generateSnippet as b, type ReactGrabState as c, type OverlayBounds as d, type DragRect as e, type Rect as f, getStack as g, type DeepPartial as h, init as i, type ElementLabelContext as j, type AgentSession as k, type AgentProvider as l, type AgentSessionStorage as m, type AgentOptions as n, type AgentCompleteResult as o, type SettableOptions as p, type ActivationMode as q, type ContextMenuAction as r, type ActionContext as s, type Plugin as t, type PluginConfig as u, type PluginHooks as v, type ReactGrabRendererProps as w, copyContent as x };

package/dist/{index-RhgdSH9U.d.ts → index-BdKhAk4Q.d.ts}

@@ -2,7 +2,7 @@ import { StackFrame } from 'bippy/source';
 import 'bippy';
 
 type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+    [P in keyof T]?: T[P] extends object ? T[P] extends (...args: unknown[]) => unknown ? T[P] : DeepPartial<T[P]> : T[P];
 };
 interface Theme {
     /**
@@ -80,12 +80,25 @@ interface ReactGrabState {
     isActive: boolean;
     isDragging: boolean;
     isCopying: boolean;
-    isInputMode: boolean;
+    isPromptMode: boolean;
+    isCrosshairVisible: boolean;
+    isSelectionBoxVisible: boolean;
+    isDragBoxVisible: boolean;
     targetElement: Element | null;
     dragBounds: DragRect | null;
+    /**
+     * Currently visible grabbed boxes (success flash effects).
+     * These are temporary visual indicators shown after elements are grabbed/copied.
+     */
+    grabbedBoxes: Array<{
+        id: string;
+        bounds: OverlayBounds;
+        createdAt: number;
+    }>;
+    selectionFilePath: string | null;
 }
 type ElementLabelVariant = "hover" | "processing" | "success";
-interface InputModeContext {
+interface PromptModeContext {
     x: number;
     y: number;
     targetElement: Element | null;
@@ -98,14 +111,13 @@ interface ElementLabelContext {
     x: number;
     y: number;
     content: string;
+    element?: Element;
+    tagName?: string;
+    componentName?: string;
+    filePath?: string;
+    lineNumber?: number;
 }
-interface ActivationKey {
-    key?: string;
-    metaKey?: boolean;
-    ctrlKey?: boolean;
-    shiftKey?: boolean;
-    altKey?: boolean;
-}
+type ActivationKey = string | ((event: KeyboardEvent) => boolean);
 interface AgentContext<T = unknown> {
     content: string[];
     prompt: string;
@@ -117,6 +129,7 @@ interface AgentSession {
     context: AgentContext;
     lastStatus: string;
     isStreaming: boolean;
+    isFading?: boolean;
     createdAt: number;
     lastUpdatedAt: number;
     position: {
@@ -164,16 +177,24 @@ interface AgentOptions<T = any> {
     onDismiss?: (session: AgentSession, elements: Element[]) => void;
 }
 type ActivationMode = "toggle" | "hold";
-interface Options {
-    enabled?: boolean;
-    activationMode?: ActivationMode;
-    keyHoldDuration?: number;
-    allowActivationInsideInput?: boolean;
-    maxContextLines?: number;
-    theme?: Theme;
-    activationShortcut?: (event: KeyboardEvent) => boolean;
-    activationKey?: ActivationKey;
-    getContent?: (elements: Element[]) => Promise<string> | string;
+interface ActionContext {
+    element: Element;
+    elements: Element[];
+    filePath?: string;
+    lineNumber?: number;
+    componentName?: string;
+    tagName?: string;
+    enterPromptMode?: (agent?: AgentOptions) => void;
+}
+interface ContextMenuAction {
+    id: string;
+    label: string;
+    shortcut?: string;
+    enabled?: boolean | ((context: ActionContext) => boolean);
+    onAction: (context: ActionContext) => void;
+    agent?: AgentOptions;
+}
+interface PluginHooks {
     onActivate?: () => void;
     onDeactivate?: () => void;
     onElementHover?: (element: Element) => void;
@@ -185,16 +206,48 @@ interface Options {
     onCopySuccess?: (elements: Element[], content: string) => void;
     onCopyError?: (error: Error) => void;
     onStateChange?: (state: ReactGrabState) => void;
-    onInputModeChange?: (isInputMode: boolean, context: InputModeContext) => void;
+    onPromptModeChange?: (isPromptMode: boolean, context: PromptModeContext) => void;
     onSelectionBox?: (visible: boolean, bounds: OverlayBounds | null, element: Element | null) => void;
     onDragBox?: (visible: boolean, bounds: OverlayBounds | null) => void;
     onGrabbedBox?: (bounds: OverlayBounds, element: Element) => void;
     onElementLabel?: (visible: boolean, variant: ElementLabelVariant, context: ElementLabelContext) => void;
     onCrosshair?: (visible: boolean, context: CrosshairContext) => void;
-    onOpenFile?: (filePath: string, lineNumber?: number) => void;
-    agent?: AgentOptions;
+    onContextMenu?: (element: Element, position: {
+        x: number;
+        y: number;
+    }) => void;
+    onOpenFile?: (filePath: string, lineNumber?: number) => boolean | void;
+}
+interface PluginConfig {
+    theme?: DeepPartial<Theme>;
+    options?: SettableOptions;
+    actions?: ContextMenuAction[];
+    hooks?: PluginHooks;
+    cleanup?: () => void;
+}
+interface Plugin {
+    name: string;
+    theme?: DeepPartial<Theme>;
+    options?: SettableOptions;
+    actions?: ContextMenuAction[];
+    hooks?: PluginHooks;
+    setup?: (api: ReactGrabAPI) => PluginConfig | void;
+}
+interface Options {
+    enabled?: boolean;
+    activationMode?: ActivationMode;
+    keyHoldDuration?: number;
+    allowActivationInsideInput?: boolean;
+    maxContextLines?: number;
+    activationKey?: ActivationKey;
+    getContent?: (elements: Element[]) => Promise<string> | string;
+}
+type SettableOptions = Omit<Options, "enabled">;
+interface SourceInfo {
+    filePath: string;
+    lineNumber: number | null;
+    componentName: string | null;
 }
-type UpdatableOptions = Pick<Options, "onActivate" | "onDeactivate" | "onElementHover" | "onElementSelect" | "onDragStart" | "onDragEnd" | "onBeforeCopy" | "onAfterCopy" | "onCopySuccess" | "onCopyError" | "onStateChange" | "onInputModeChange" | "onSelectionBox" | "onDragBox" | "onGrabbedBox" | "onElementLabel" | "onCrosshair" | "onOpenFile">;
 interface ReactGrabAPI {
     activate: () => void;
     deactivate: () => void;
@@ -202,11 +255,12 @@ interface ReactGrabAPI {
     isActive: () => boolean;
     dispose: () => void;
     copyElement: (elements: Element | Element[]) => Promise<boolean>;
+    getSource: (element: Element) => Promise<SourceInfo | null>;
     getState: () => ReactGrabState;
-    updateTheme: (theme: DeepPartial<Theme>) => void;
-    getTheme: () => Required<Theme>;
-    setAgent: (options: AgentOptions) => void;
-    updateOptions: (options: UpdatableOptions) => void;
+    setOptions: (options: SettableOptions) => void;
+    registerPlugin: (plugin: Plugin) => void;
+    unregisterPlugin: (name: string) => void;
+    getPlugins: () => string[];
 }
 interface OverlayBounds {
     borderRadius: string;
@@ -216,16 +270,20 @@ interface OverlayBounds {
     x: number;
     y: number;
 }
-type SelectionLabelStatus = "idle" | "copying" | "copied" | "fading";
+type SelectionLabelStatus = "idle" | "copying" | "copied" | "fading" | "error";
 interface SelectionLabelInstance {
     id: string;
     bounds: OverlayBounds;
+    boundsMultiple?: OverlayBounds[];
     tagName: string;
     componentName?: string;
     status: SelectionLabelStatus;
     createdAt: number;
     element?: Element;
+    elements?: Element[];
     mouseX?: number;
+    mouseXOffsetFromCenter?: number;
+    errorMessage?: string;
 }
 interface ReactGrabRendererProps {
     selectionVisible?: boolean;
@@ -251,7 +309,7 @@ interface ReactGrabRendererProps {
     mouseY?: number;
     crosshairVisible?: boolean;
     inputValue?: string;
-    isInputMode?: boolean;
+    isPromptMode?: boolean;
     replyToPrompt?: string;
     hasAgent?: boolean;
     isAgentConnected?: boolean;
@@ -266,6 +324,8 @@ interface ReactGrabRendererProps {
     onFollowUpSubmitSession?: (sessionId: string, prompt: string) => void;
     onAcknowledgeSessionError?: (sessionId: string) => void;
     onRetrySession?: (sessionId: string) => void;
+    onShowContextMenuSession?: (sessionId: string) => void;
+    onShowContextMenuInstance?: (instanceId: string) => void;
     onInputChange?: (value: string) => void;
     onInputSubmit?: () => void;
     onInputCancel?: () => void;
@@ -278,6 +338,21 @@ interface ReactGrabRendererProps {
     toolbarVisible?: boolean;
     isActive?: boolean;
     onToggleActive?: () => void;
+    contextMenuPosition?: {
+        x: number;
+        y: number;
+    } | null;
+    contextMenuBounds?: OverlayBounds | null;
+    contextMenuTagName?: string;
+    contextMenuComponentName?: string;
+    contextMenuHasFilePath?: boolean;
+    actions?: ContextMenuAction[];
+    actionContext?: ActionContext;
+    onContextMenuCopy?: () => void;
+    onContextMenuCopyScreenshot?: () => void;
+    onContextMenuOpen?: () => void;
+    onContextMenuDismiss?: () => void;
+    onContextMenuHide?: () => void;
 }
 interface GrabbedBox {
     id: string;
@@ -319,4 +394,4 @@ declare const copyContent: (content: string, options?: CopyContentOptions) => bo
 
 declare const init: (rawOptions?: Options) => ReactGrabAPI;
 
-export { type AgentContext as A, type CrosshairContext as C, DEFAULT_THEME as D, type ElementLabelVariant as E, type GrabbedBox as G, type InputModeContext as I, type Options as O, type ReactGrabAPI as R, type Theme as T, type UpdatableOptions as U, getElementContext as a, generateSnippet as b, type ReactGrabState as c, type OverlayBounds as d, type DragRect as e, type Rect as f, getStack as g, type DeepPartial as h, init as i, type ElementLabelContext as j, type AgentSession as k, type AgentProvider as l, type AgentSessionStorage as m, type AgentOptions as n, type AgentCompleteResult as o, type ActivationMode as p, type ReactGrabRendererProps as q, copyContent as r };
+export { type AgentContext as A, type CrosshairContext as C, DEFAULT_THEME as D, type ElementLabelVariant as E, type GrabbedBox as G, type Options as O, type PromptModeContext as P, type ReactGrabAPI as R, type SourceInfo as S, type Theme as T, getElementContext as a, generateSnippet as b, type ReactGrabState as c, type OverlayBounds as d, type DragRect as e, type Rect as f, getStack as g, type DeepPartial as h, init as i, type ElementLabelContext as j, type AgentSession as k, type AgentProvider as l, type AgentSessionStorage as m, type AgentOptions as n, type AgentCompleteResult as o, type SettableOptions as p, type ActivationMode as q, type ContextMenuAction as r, type ActionContext as s, type Plugin as t, type PluginConfig as u, type PluginHooks as v, type ReactGrabRendererProps as w, copyContent as x };

package/dist/index.cjs

@@ -1,4 +1,4 @@
-'use strict';var chunkQVFHXAET_cjs=require('./chunk-QVFHXAET.cjs');/**
+'use strict';var chunkDIAOCH5J_cjs=require('./chunk-DIAOCH5J.cjs');/**
  * @license MIT
  *
  * Copyright (c) 2025 Aiden Bai
@@ -6,4 +6,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-var e=null,A=()=>typeof window>"u"?e:window.__REACT_GRAB__??e??null,d=t=>{e=t,typeof window<"u"&&(t?window.__REACT_GRAB__=t:delete window.__REACT_GRAB__);};typeof window<"u"&&(window.__REACT_GRAB__?e=window.__REACT_GRAB__:(e=chunkQVFHXAET_cjs.g(),window.__REACT_GRAB__=e),window.dispatchEvent(new CustomEvent("react-grab:init",{detail:e})));Object.defineProperty(exports,"DEFAULT_THEME",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.f}});Object.defineProperty(exports,"formatElementInfo",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.c}});Object.defineProperty(exports,"generateSnippet",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.e}});Object.defineProperty(exports,"getStack",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.b}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.g}});Object.defineProperty(exports,"isInstrumentationActive",{enumerable:true,get:function(){return chunkQVFHXAET_cjs.a}});exports.getGlobalApi=A;exports.setGlobalApi=d;
+var e=null,c=()=>typeof window>"u"?e:window.__REACT_GRAB__??e??null,f=t=>{e=t,typeof window<"u"&&(t?window.__REACT_GRAB__=t:delete window.__REACT_GRAB__);};typeof window<"u"&&(window.__REACT_GRAB__?e=window.__REACT_GRAB__:(e=chunkDIAOCH5J_cjs.k(),window.__REACT_GRAB__=e),window.dispatchEvent(new CustomEvent("react-grab:init",{detail:e})));Object.defineProperty(exports,"DEFAULT_THEME",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.j}});Object.defineProperty(exports,"captureElementScreenshot",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.h}});Object.defineProperty(exports,"combineBounds",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.g}});Object.defineProperty(exports,"copyImageToClipboard",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.i}});Object.defineProperty(exports,"formatElementInfo",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.d}});Object.defineProperty(exports,"generateSnippet",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.f}});Object.defineProperty(exports,"getStack",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.c}});Object.defineProperty(exports,"init",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.k}});Object.defineProperty(exports,"isInstrumentationActive",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.b}});Object.defineProperty(exports,"isScreenshotSupported",{enumerable:true,get:function(){return chunkDIAOCH5J_cjs.a}});exports.getGlobalApi=c;exports.setGlobalApi=f;

package/dist/index.d.cts

@@ -1,8 +1,20 @@
-import { R as ReactGrabAPI } from './index-RhgdSH9U.cjs';
-export { p as ActivationMode, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, C as CrosshairContext, D as DEFAULT_THEME, h as DeepPartial, e as DragRect, j as ElementLabelContext, E as ElementLabelVariant, G as GrabbedBox, I as InputModeContext, O as Options, d as OverlayBounds, c as ReactGrabState, f as Rect, T as Theme, U as UpdatableOptions, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from './index-RhgdSH9U.cjs';
+import { R as ReactGrabAPI } from './index-BdKhAk4Q.cjs';
+export { s as ActionContext, q as ActivationMode, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, r as ContextMenuAction, C as CrosshairContext, D as DEFAULT_THEME, h as DeepPartial, e as DragRect, j as ElementLabelContext, E as ElementLabelVariant, G as GrabbedBox, O as Options, d as OverlayBounds, t as Plugin, u as PluginConfig, v as PluginHooks, P as PromptModeContext, c as ReactGrabState, f as Rect, p as SettableOptions, S as SourceInfo, T as Theme, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from './index-BdKhAk4Q.cjs';
 export { isInstrumentationActive } from 'bippy';
 import 'bippy/source';
 
+interface ElementBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare const combineBounds: (boundsList: ElementBounds[]) => ElementBounds;
+declare const captureElementScreenshot: (bounds: ElementBounds) => Promise<Blob>;
+declare const copyImageToClipboard: (blob: Blob) => Promise<boolean>;
+
+declare const isScreenshotSupported: () => boolean;
+
 declare global {
     interface Window {
         __REACT_GRAB__?: ReactGrabAPI;
@@ -11,4 +23,4 @@ declare global {
 declare const getGlobalApi: () => ReactGrabAPI | null;
 declare const setGlobalApi: (api: ReactGrabAPI | null) => void;
 
-export { ReactGrabAPI, getGlobalApi, setGlobalApi };
+export { type ElementBounds, ReactGrabAPI, captureElementScreenshot, combineBounds, copyImageToClipboard, getGlobalApi, isScreenshotSupported, setGlobalApi };

package/dist/index.d.ts

@@ -1,8 +1,20 @@
-import { R as ReactGrabAPI } from './index-RhgdSH9U.js';
-export { p as ActivationMode, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, C as CrosshairContext, D as DEFAULT_THEME, h as DeepPartial, e as DragRect, j as ElementLabelContext, E as ElementLabelVariant, G as GrabbedBox, I as InputModeContext, O as Options, d as OverlayBounds, c as ReactGrabState, f as Rect, T as Theme, U as UpdatableOptions, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from './index-RhgdSH9U.js';
+import { R as ReactGrabAPI } from './index-BdKhAk4Q.js';
+export { s as ActionContext, q as ActivationMode, o as AgentCompleteResult, A as AgentContext, n as AgentOptions, l as AgentProvider, k as AgentSession, m as AgentSessionStorage, r as ContextMenuAction, C as CrosshairContext, D as DEFAULT_THEME, h as DeepPartial, e as DragRect, j as ElementLabelContext, E as ElementLabelVariant, G as GrabbedBox, O as Options, d as OverlayBounds, t as Plugin, u as PluginConfig, v as PluginHooks, P as PromptModeContext, c as ReactGrabState, f as Rect, p as SettableOptions, S as SourceInfo, T as Theme, a as formatElementInfo, b as generateSnippet, g as getStack, i as init } from './index-BdKhAk4Q.js';
 export { isInstrumentationActive } from 'bippy';
 import 'bippy/source';
 
+interface ElementBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare const combineBounds: (boundsList: ElementBounds[]) => ElementBounds;
+declare const captureElementScreenshot: (bounds: ElementBounds) => Promise<Blob>;
+declare const copyImageToClipboard: (blob: Blob) => Promise<boolean>;
+
+declare const isScreenshotSupported: () => boolean;
+
 declare global {
     interface Window {
         __REACT_GRAB__?: ReactGrabAPI;
@@ -11,4 +23,4 @@ declare global {
 declare const getGlobalApi: () => ReactGrabAPI | null;
 declare const setGlobalApi: (api: ReactGrabAPI | null) => void;
 
-export { ReactGrabAPI, getGlobalApi, setGlobalApi };
+export { type ElementBounds, ReactGrabAPI, captureElementScreenshot, combineBounds, copyImageToClipboard, getGlobalApi, isScreenshotSupported, setGlobalApi };