react-grab 0.1.47 → 0.1.48-dev.169c87b

package/README.md

@@ -5,7 +5,7 @@
 
 Copy any UI element for your agent.
 
-React Grab points agents to the actual source behind each selection. Agents are [**2× faster**](https://benchmark.react-grab.com/) and more accurate when using React Grab.
+React Grab points agents to the actual source behind each selection. Agents are [**2× faster**](https://react-grab.com/benchmarks) and more accurate when using React Grab.
 
 [**Website →**](https://react-grab.com)
 

package/dist/{copy-content-CqFXlS9J.d.ts → copy-content-3sDfOP1b.d.ts}

@@ -6,6 +6,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import { ReactNode } from "react";
+
 //#region ../../node_modules/.pnpm/solid-js@1.9.12/node_modules/solid-js/types/reactive/observable.d.ts
 declare global {
   interface SymbolConstructor {
@@ -138,11 +140,13 @@ interface AgentContext<T = unknown> {
   sessionId?: string;
 }
 type ActivationMode = "toggle" | "hold";
-interface ActionContextHooks {
-  transformHtmlContent: (html: string, elements: Element[]) => Promise<string>;
+interface OpenFileActionHooks {
   onOpenFile: (filePath: string, lineNumber?: number) => boolean | void;
   transformOpenFileUrl: (url: string, filePath: string, lineNumber?: number) => string;
 }
+interface ActionContextHooks extends OpenFileActionHooks {
+  transformHtmlContent: (html: string, elements: Element[]) => Promise<string>;
+}
 interface ActionContext {
   element: Element;
   elements: Element[];
@@ -214,6 +218,12 @@ interface EnumPendingEdit {
 }
 type PendingEdit = NumericPendingEdit | ColorPendingEdit | EnumPendingEdit;
 type PendingEdits = PendingEdit[];
+interface DesignTokenResolver {
+  readonly hasTokens: boolean;
+  matchColor: (hex: string) => string | null;
+  matchLength: (px: number, cssProperty: string) => string | null;
+  stepLength: (px: number, direction: 1 | -1, cssProperty: string) => number | null;
+}
 interface PreviewStyles {
   apply: (cssProperties: readonly string[], cssValue: string) => void;
   restore: () => void;
@@ -222,16 +232,15 @@ interface PreviewStyles {
 interface EditPanelState {
   element: Element;
   position: Position;
-  selectionBounds: OverlayBounds;
   properties: EditableProperty[];
   preview: PreviewStyles;
   filePath?: string;
   lineNumber?: number;
   componentName?: string;
   tagName?: string;
-  htmlPreview?: string;
   initialSearchQuery?: string;
   hasSessionEdits?: boolean;
+  designTokens?: DesignTokenResolver;
 }
 interface ContextMenuAction {
   id: string;
@@ -242,34 +251,35 @@ interface ContextMenuAction {
   enabled?: boolean | ((context: ActionContext) => boolean);
   onAction: (context: ContextMenuActionContext) => void | Promise<void>;
 }
-interface ArrowNavigationItem {
+interface HierarchyItem {
   tagName: string;
   componentName?: string;
+  depth: number;
+  isLast: boolean;
 }
-interface ArrowNavigationState {
-  items: ArrowNavigationItem[];
+interface HierarchyState {
+  items: HierarchyItem[];
   activeIndex: number;
-  isVisible: boolean;
 }
 interface PluginHooks {
-  onActivate?: () => void;
-  onDeactivate?: () => void;
-  onElementHover?: (element: Element) => void;
+  onActivate?: () => void | Promise<void>;
+  onDeactivate?: () => void | Promise<void>;
+  onElementHover?: (element: Element) => void | Promise<void>;
   onElementSelect?: (element: Element) => boolean | void | Promise<boolean>;
-  onDragStart?: (startX: number, startY: number) => void;
-  onDragEnd?: (elements: Element[], bounds: DragRect) => void;
+  onDragStart?: (startX: number, startY: number) => void | Promise<void>;
+  onDragEnd?: (elements: Element[], bounds: DragRect) => void | Promise<void>;
   onBeforeCopy?: (elements: Element[]) => void | Promise<void>;
   transformCopyContent?: (content: string, elements: Element[]) => string | Promise<string>;
-  onAfterCopy?: (elements: Element[], success: boolean) => void;
-  onCopySuccess?: (elements: Element[], content: string) => void;
-  onCopyError?: (error: Error) => void;
-  onStateChange?: (state: ReactGrabState) => 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;
-  onContextMenu?: (element: Element, position: Position) => void;
+  onAfterCopy?: (elements: Element[], success: boolean) => void | Promise<void>;
+  onCopySuccess?: (elements: Element[], content: string) => void | Promise<void>;
+  onCopyError?: (error: Error) => void | Promise<void>;
+  onStateChange?: (state: ReactGrabState) => void | Promise<void>;
+  onPromptModeChange?: (isPromptMode: boolean, context: PromptModeContext) => void | Promise<void>;
+  onSelectionBox?: (visible: boolean, bounds: OverlayBounds | null, element: Element | null) => void | Promise<void>;
+  onDragBox?: (visible: boolean, bounds: OverlayBounds | null) => void | Promise<void>;
+  onGrabbedBox?: (bounds: OverlayBounds, element: Element) => void | Promise<void>;
+  onElementLabel?: (visible: boolean, variant: ElementLabelVariant, context: ElementLabelContext) => void | Promise<void>;
+  onContextMenu?: (element: Element, position: Position) => void | Promise<void>;
   onOpenFile?: (filePath: string, lineNumber?: number) => boolean | void;
   transformHtmlContent?: (html: string, elements: Element[]) => string | Promise<string>;
   transformAgentContext?: (context: AgentContext, elements: Element[]) => AgentContext | Promise<AgentContext>;
@@ -281,7 +291,7 @@ interface PluginConfig {
   options?: SettableOptions;
   actions?: ContextMenuAction[];
   hooks?: PluginHooks;
-  cleanup?: () => void;
+  cleanup?: () => undefined;
 }
 interface Plugin {
   name: string;
@@ -293,6 +303,12 @@ interface Plugin {
 }
 interface Options {
   enabled?: boolean;
+  /**
+   * Confine React Grab to a single container element instead of the whole page.
+   * Hit-testing, the toolbar viewport, and scroll re-anchoring are scoped to it.
+   * Used by the demo build to scope the showcase to its card.
+   */
+  container?: HTMLElement;
   activationMode?: ActivationMode;
   keyHoldDuration?: number;
   allowActivationInsideInput?: boolean;
@@ -324,12 +340,31 @@ interface Options {
 interface SettableOptions extends Options {
   enabled?: never;
   telemetry?: never;
+  container?: never;
 }
 interface SourceInfo {
   filePath: string;
   lineNumber: number | null;
   componentName: string | null;
 }
+interface SelectedElementPayload {
+  tagName: string;
+  id?: string;
+  className?: string;
+  textContent?: string;
+  componentName?: string;
+  filePath?: string;
+  lineNumber?: number;
+  columnNumber?: number;
+}
+interface ElementSelectedEventDetail {
+  elements: SelectedElementPayload[];
+}
+declare global {
+  interface WindowEventMap {
+    "react-grab:element-selected": CustomEvent<ElementSelectedEventDetail>;
+  }
+}
 interface ToolbarState {
   edge: "top" | "bottom" | "left" | "right";
   ratio: number;
@@ -353,6 +388,7 @@ interface ReactGrabAPI {
   getToolbarState: () => ToolbarState | null;
   setToolbarState: (state: Partial<ToolbarState>) => void;
   onToolbarStateChange: (callback: (state: ToolbarState) => void) => () => void;
+  reset: () => void;
   dispose: () => void;
   copyElement: (elements: Element | Element[]) => Promise<boolean>;
   getSource: (element: Element) => Promise<SourceInfo | null>;
@@ -398,13 +434,19 @@ interface FrozenLabelEntry {
   bounds: OverlayBounds;
   mouseX?: number;
 }
+interface FrozenLabelEntryAccessor {
+  read: () => FrozenLabelEntry | null;
+}
+interface SelectionLabelInstanceAccessor {
+  read: () => SelectionLabelInstance | null;
+}
 interface ReactGrabRendererProps {
   selectionVisible?: boolean;
   selectionBounds?: OverlayBounds;
   selectionBoundsMultiple?: OverlayBounds[];
   selectionShouldSnap?: boolean;
   selectionElementsCount?: number;
-  frozenLabelEntries?: FrozenLabelEntry[];
+  frozenLabelEntryAccessors?: FrozenLabelEntryAccessor[];
   pendingShiftPreviewEntry?: FrozenLabelEntry;
   selectionFilePath?: string;
   selectionLineNumber?: number;
@@ -412,9 +454,10 @@ interface ReactGrabRendererProps {
   selectionComponentName?: string;
   selectionLabelVisible?: boolean;
   selectionLabelStatus?: SelectionLabelStatus;
-  selectionArrowNavigationState?: ArrowNavigationState;
-  onArrowNavigationSelect?: (index: number) => void;
+  hierarchyState?: HierarchyState;
+  hierarchyMenuPosition?: DropdownAnchor | null;
   labelInstances?: SelectionLabelInstance[];
+  labelInstanceAccessors?: SelectionLabelInstanceAccessor[];
   dragVisible?: boolean;
   dragBounds?: OverlayBounds;
   grabbedBoxes?: Array<{
@@ -427,12 +470,15 @@ interface ReactGrabRendererProps {
   inputValue?: string;
   isPromptMode?: boolean;
   onShowContextMenuInstance?: (instanceId: string) => void;
+  onRetryInstance?: (instanceId: string) => void;
+  onAcknowledgeErrorInstance?: (instanceId: string) => void;
   onLabelInstanceHoverChange?: (instanceId: string, isHovered: boolean) => void;
   onInputChange?: (value: string) => void;
   onInputSubmit?: () => void;
   onToggleExpand?: () => void;
   selectionLabelShakeCount?: number;
   onConfirmDismiss?: () => void;
+  onOpenSelectionFile?: () => void;
   discardPrompt?: SelectionDiscardPrompt;
   toolbarVisible?: boolean;
   isActive?: boolean;
@@ -514,7 +560,7 @@ interface ReactGrabEntry {
   frames?: ReactGrabStackFrame[];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/bippy@0.5.41_react@19.2.6/node_modules/bippy/dist/core.d.ts
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/unsubscribe.d.ts
 type Flags = number;
 type Lanes = number;
 type TypeOfMode = number;
@@ -604,6 +650,14 @@ interface Effect {
 interface Family {
   current: unknown;
 }
+/**
+ * React 19 flight metadata for a server component owner (ReactComponentInfo).
+ * Unlike client owners it has no `tag`; the owner chain continues via `owner`.
+ */
+interface RendererRefreshUpdate {
+  staleFamilies: Set<Family>;
+  updatedFamilies: Set<Family>;
+}
 /**
  * Represents a react-internal Fiber node.
  */
@@ -654,6 +708,7 @@ interface ReactDevToolsGlobalHook {
   onCommitFiberRoot: (rendererID: number, root: FiberRoot, priority: number | void) => void;
   onCommitFiberUnmount: (rendererID: number, fiber: Fiber) => void;
   onPostCommitFiberRoot: (rendererID: number, root: FiberRoot) => void;
+  onScheduleFiberRoot?: (rendererID: number, root: FiberRoot, children: ReactNode) => void;
   renderers: Map<number, ReactRenderer>;
   supportsFiber: boolean;
   supportsFlight: boolean;
@@ -672,10 +727,7 @@ interface ReactRenderer {
   overridePropsRenamePath?: (fiber: Fiber, oldPath: Array<number | string>, newPath: Array<number | string>) => void;
   reconcilerVersion: string;
   rendererPackageName: string;
-  scheduleRefresh?: (root: FiberRoot, update: {
-    staleFamilies: Set<Family>;
-    updatedFamilies: Set<Family>;
-  }) => void;
+  scheduleRefresh?: (root: FiberRoot, update: RendererRefreshUpdate) => void;
   scheduleRoot?: (root: FiberRoot, element: React.ReactNode) => void;
   scheduleUpdate?: (fiber: Fiber) => void;
   setErrorHandler?: (newShouldErrorImpl: (fiber: Fiber) => boolean) => void;
@@ -686,28 +738,30 @@ interface ReactRenderer {
 declare global {
   var __REACT_DEVTOOLS_GLOBAL_HOOK__: ReactDevToolsGlobalHook | undefined;
 } //#endregion
-//#region src/rdt-hook.d.ts
-/**
- * Returns `true` if bippy's instrumentation is active.
- */
-declare const isInstrumentationActive: () => boolean;
-/**
- * Returns the latest fiber (since it may be double-buffered).
- */
+//#region src/unsubscribe.d.ts
 //#endregion
-//#region ../../node_modules/.pnpm/bippy@0.5.41_react@19.2.6/node_modules/bippy/dist/source.d.ts
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/source.d.ts
 //#region src/source/parse-stack.d.ts
 interface StackFrame {
   args?: unknown[];
   columnNumber?: number;
   lineNumber?: number;
+  enclosingLineNumber?: number;
+  enclosingColumnNumber?: number;
   fileName?: string;
   functionName?: string;
   source?: string;
   isServer?: boolean;
   isSymbolicated?: boolean;
+  isIgnoreListed?: boolean;
 }
 //#endregion
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/core.d.ts
+/**
+ * Returns `true` if bippy's instrumentation is active.
+ */
+declare const isInstrumentationActive: () => boolean;
+//#endregion
 //#region src/utils/copy-content.d.ts
 interface CopyContentOptions {
   componentName?: string;
@@ -717,4 +771,4 @@ interface CopyContentOptions {
 }
 declare const copyContent: (content: string, options?: CopyContentOptions) => boolean;
 //#endregion
-export { ToolbarState as A, ReactGrabAPI as C, SettableOptions as D, Rect as E, SourceInfo as O, PromptModeContext as S, ReactGrabState as T, OverlayBounds as _, ActionContext as a, PluginHooks as b, AgentContext as c, DeepPartial as d, DragRect as f, Options as g, GrabbedBox as h, isInstrumentationActive as i, Theme as k, ContextMenuAction as l, ElementLabelVariant as m, StackFrame as n, ActionContextHooks as o, ElementLabelContext as p, Fiber as r, ActivationMode as s, copyContent as t, ContextMenuActionContext as u, Plugin as v, ReactGrabRendererProps as w, Position as x, PluginConfig as y };
+export { SettableOptions as A, Position as C, ReactGrabState as D, ReactGrabRendererProps as E, Theme as M, ToolbarState as N, Rect as O, PluginHooks as S, ReactGrabAPI as T, OpenFileActionHooks as _, ActionContext as a, Plugin as b, AgentContext as c, DeepPartial as d, DragRect as f, GrabbedBox as g, ElementSelectedEventDetail as h, Fiber as i, SourceInfo as j, SelectedElementPayload as k, ContextMenuAction as l, ElementLabelVariant as m, isInstrumentationActive as n, ActionContextHooks as o, ElementLabelContext as p, StackFrame as r, ActivationMode as s, copyContent as t, ContextMenuActionContext as u, Options as v, PromptModeContext as w, PluginConfig as x, OverlayBounds as y };

package/dist/{copy-content-BoeDJ9l0.d.cts → copy-content-TZDC2S2A.d.cts}

@@ -6,6 +6,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import { ReactNode } from "react";
+
 //#region ../../node_modules/.pnpm/solid-js@1.9.12/node_modules/solid-js/types/reactive/observable.d.ts
 declare global {
   interface SymbolConstructor {
@@ -138,11 +140,13 @@ interface AgentContext<T = unknown> {
   sessionId?: string;
 }
 type ActivationMode = "toggle" | "hold";
-interface ActionContextHooks {
-  transformHtmlContent: (html: string, elements: Element[]) => Promise<string>;
+interface OpenFileActionHooks {
   onOpenFile: (filePath: string, lineNumber?: number) => boolean | void;
   transformOpenFileUrl: (url: string, filePath: string, lineNumber?: number) => string;
 }
+interface ActionContextHooks extends OpenFileActionHooks {
+  transformHtmlContent: (html: string, elements: Element[]) => Promise<string>;
+}
 interface ActionContext {
   element: Element;
   elements: Element[];
@@ -214,6 +218,12 @@ interface EnumPendingEdit {
 }
 type PendingEdit = NumericPendingEdit | ColorPendingEdit | EnumPendingEdit;
 type PendingEdits = PendingEdit[];
+interface DesignTokenResolver {
+  readonly hasTokens: boolean;
+  matchColor: (hex: string) => string | null;
+  matchLength: (px: number, cssProperty: string) => string | null;
+  stepLength: (px: number, direction: 1 | -1, cssProperty: string) => number | null;
+}
 interface PreviewStyles {
   apply: (cssProperties: readonly string[], cssValue: string) => void;
   restore: () => void;
@@ -222,16 +232,15 @@ interface PreviewStyles {
 interface EditPanelState {
   element: Element;
   position: Position;
-  selectionBounds: OverlayBounds;
   properties: EditableProperty[];
   preview: PreviewStyles;
   filePath?: string;
   lineNumber?: number;
   componentName?: string;
   tagName?: string;
-  htmlPreview?: string;
   initialSearchQuery?: string;
   hasSessionEdits?: boolean;
+  designTokens?: DesignTokenResolver;
 }
 interface ContextMenuAction {
   id: string;
@@ -242,34 +251,35 @@ interface ContextMenuAction {
   enabled?: boolean | ((context: ActionContext) => boolean);
   onAction: (context: ContextMenuActionContext) => void | Promise<void>;
 }
-interface ArrowNavigationItem {
+interface HierarchyItem {
   tagName: string;
   componentName?: string;
+  depth: number;
+  isLast: boolean;
 }
-interface ArrowNavigationState {
-  items: ArrowNavigationItem[];
+interface HierarchyState {
+  items: HierarchyItem[];
   activeIndex: number;
-  isVisible: boolean;
 }
 interface PluginHooks {
-  onActivate?: () => void;
-  onDeactivate?: () => void;
-  onElementHover?: (element: Element) => void;
+  onActivate?: () => void | Promise<void>;
+  onDeactivate?: () => void | Promise<void>;
+  onElementHover?: (element: Element) => void | Promise<void>;
   onElementSelect?: (element: Element) => boolean | void | Promise<boolean>;
-  onDragStart?: (startX: number, startY: number) => void;
-  onDragEnd?: (elements: Element[], bounds: DragRect) => void;
+  onDragStart?: (startX: number, startY: number) => void | Promise<void>;
+  onDragEnd?: (elements: Element[], bounds: DragRect) => void | Promise<void>;
   onBeforeCopy?: (elements: Element[]) => void | Promise<void>;
   transformCopyContent?: (content: string, elements: Element[]) => string | Promise<string>;
-  onAfterCopy?: (elements: Element[], success: boolean) => void;
-  onCopySuccess?: (elements: Element[], content: string) => void;
-  onCopyError?: (error: Error) => void;
-  onStateChange?: (state: ReactGrabState) => 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;
-  onContextMenu?: (element: Element, position: Position) => void;
+  onAfterCopy?: (elements: Element[], success: boolean) => void | Promise<void>;
+  onCopySuccess?: (elements: Element[], content: string) => void | Promise<void>;
+  onCopyError?: (error: Error) => void | Promise<void>;
+  onStateChange?: (state: ReactGrabState) => void | Promise<void>;
+  onPromptModeChange?: (isPromptMode: boolean, context: PromptModeContext) => void | Promise<void>;
+  onSelectionBox?: (visible: boolean, bounds: OverlayBounds | null, element: Element | null) => void | Promise<void>;
+  onDragBox?: (visible: boolean, bounds: OverlayBounds | null) => void | Promise<void>;
+  onGrabbedBox?: (bounds: OverlayBounds, element: Element) => void | Promise<void>;
+  onElementLabel?: (visible: boolean, variant: ElementLabelVariant, context: ElementLabelContext) => void | Promise<void>;
+  onContextMenu?: (element: Element, position: Position) => void | Promise<void>;
   onOpenFile?: (filePath: string, lineNumber?: number) => boolean | void;
   transformHtmlContent?: (html: string, elements: Element[]) => string | Promise<string>;
   transformAgentContext?: (context: AgentContext, elements: Element[]) => AgentContext | Promise<AgentContext>;
@@ -281,7 +291,7 @@ interface PluginConfig {
   options?: SettableOptions;
   actions?: ContextMenuAction[];
   hooks?: PluginHooks;
-  cleanup?: () => void;
+  cleanup?: () => undefined;
 }
 interface Plugin {
   name: string;
@@ -293,6 +303,12 @@ interface Plugin {
 }
 interface Options {
   enabled?: boolean;
+  /**
+   * Confine React Grab to a single container element instead of the whole page.
+   * Hit-testing, the toolbar viewport, and scroll re-anchoring are scoped to it.
+   * Used by the demo build to scope the showcase to its card.
+   */
+  container?: HTMLElement;
   activationMode?: ActivationMode;
   keyHoldDuration?: number;
   allowActivationInsideInput?: boolean;
@@ -324,12 +340,31 @@ interface Options {
 interface SettableOptions extends Options {
   enabled?: never;
   telemetry?: never;
+  container?: never;
 }
 interface SourceInfo {
   filePath: string;
   lineNumber: number | null;
   componentName: string | null;
 }
+interface SelectedElementPayload {
+  tagName: string;
+  id?: string;
+  className?: string;
+  textContent?: string;
+  componentName?: string;
+  filePath?: string;
+  lineNumber?: number;
+  columnNumber?: number;
+}
+interface ElementSelectedEventDetail {
+  elements: SelectedElementPayload[];
+}
+declare global {
+  interface WindowEventMap {
+    "react-grab:element-selected": CustomEvent<ElementSelectedEventDetail>;
+  }
+}
 interface ToolbarState {
   edge: "top" | "bottom" | "left" | "right";
   ratio: number;
@@ -353,6 +388,7 @@ interface ReactGrabAPI {
   getToolbarState: () => ToolbarState | null;
   setToolbarState: (state: Partial<ToolbarState>) => void;
   onToolbarStateChange: (callback: (state: ToolbarState) => void) => () => void;
+  reset: () => void;
   dispose: () => void;
   copyElement: (elements: Element | Element[]) => Promise<boolean>;
   getSource: (element: Element) => Promise<SourceInfo | null>;
@@ -398,13 +434,19 @@ interface FrozenLabelEntry {
   bounds: OverlayBounds;
   mouseX?: number;
 }
+interface FrozenLabelEntryAccessor {
+  read: () => FrozenLabelEntry | null;
+}
+interface SelectionLabelInstanceAccessor {
+  read: () => SelectionLabelInstance | null;
+}
 interface ReactGrabRendererProps {
   selectionVisible?: boolean;
   selectionBounds?: OverlayBounds;
   selectionBoundsMultiple?: OverlayBounds[];
   selectionShouldSnap?: boolean;
   selectionElementsCount?: number;
-  frozenLabelEntries?: FrozenLabelEntry[];
+  frozenLabelEntryAccessors?: FrozenLabelEntryAccessor[];
   pendingShiftPreviewEntry?: FrozenLabelEntry;
   selectionFilePath?: string;
   selectionLineNumber?: number;
@@ -412,9 +454,10 @@ interface ReactGrabRendererProps {
   selectionComponentName?: string;
   selectionLabelVisible?: boolean;
   selectionLabelStatus?: SelectionLabelStatus;
-  selectionArrowNavigationState?: ArrowNavigationState;
-  onArrowNavigationSelect?: (index: number) => void;
+  hierarchyState?: HierarchyState;
+  hierarchyMenuPosition?: DropdownAnchor | null;
   labelInstances?: SelectionLabelInstance[];
+  labelInstanceAccessors?: SelectionLabelInstanceAccessor[];
   dragVisible?: boolean;
   dragBounds?: OverlayBounds;
   grabbedBoxes?: Array<{
@@ -427,12 +470,15 @@ interface ReactGrabRendererProps {
   inputValue?: string;
   isPromptMode?: boolean;
   onShowContextMenuInstance?: (instanceId: string) => void;
+  onRetryInstance?: (instanceId: string) => void;
+  onAcknowledgeErrorInstance?: (instanceId: string) => void;
   onLabelInstanceHoverChange?: (instanceId: string, isHovered: boolean) => void;
   onInputChange?: (value: string) => void;
   onInputSubmit?: () => void;
   onToggleExpand?: () => void;
   selectionLabelShakeCount?: number;
   onConfirmDismiss?: () => void;
+  onOpenSelectionFile?: () => void;
   discardPrompt?: SelectionDiscardPrompt;
   toolbarVisible?: boolean;
   isActive?: boolean;
@@ -514,7 +560,7 @@ interface ReactGrabEntry {
   frames?: ReactGrabStackFrame[];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/bippy@0.5.41_react@19.2.6/node_modules/bippy/dist/core.d.ts
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/unsubscribe.d.ts
 type Flags = number;
 type Lanes = number;
 type TypeOfMode = number;
@@ -604,6 +650,14 @@ interface Effect {
 interface Family {
   current: unknown;
 }
+/**
+ * React 19 flight metadata for a server component owner (ReactComponentInfo).
+ * Unlike client owners it has no `tag`; the owner chain continues via `owner`.
+ */
+interface RendererRefreshUpdate {
+  staleFamilies: Set<Family>;
+  updatedFamilies: Set<Family>;
+}
 /**
  * Represents a react-internal Fiber node.
  */
@@ -654,6 +708,7 @@ interface ReactDevToolsGlobalHook {
   onCommitFiberRoot: (rendererID: number, root: FiberRoot, priority: number | void) => void;
   onCommitFiberUnmount: (rendererID: number, fiber: Fiber) => void;
   onPostCommitFiberRoot: (rendererID: number, root: FiberRoot) => void;
+  onScheduleFiberRoot?: (rendererID: number, root: FiberRoot, children: ReactNode) => void;
   renderers: Map<number, ReactRenderer>;
   supportsFiber: boolean;
   supportsFlight: boolean;
@@ -672,10 +727,7 @@ interface ReactRenderer {
   overridePropsRenamePath?: (fiber: Fiber, oldPath: Array<number | string>, newPath: Array<number | string>) => void;
   reconcilerVersion: string;
   rendererPackageName: string;
-  scheduleRefresh?: (root: FiberRoot, update: {
-    staleFamilies: Set<Family>;
-    updatedFamilies: Set<Family>;
-  }) => void;
+  scheduleRefresh?: (root: FiberRoot, update: RendererRefreshUpdate) => void;
   scheduleRoot?: (root: FiberRoot, element: React.ReactNode) => void;
   scheduleUpdate?: (fiber: Fiber) => void;
   setErrorHandler?: (newShouldErrorImpl: (fiber: Fiber) => boolean) => void;
@@ -686,28 +738,30 @@ interface ReactRenderer {
 declare global {
   var __REACT_DEVTOOLS_GLOBAL_HOOK__: ReactDevToolsGlobalHook | undefined;
 } //#endregion
-//#region src/rdt-hook.d.ts
-/**
- * Returns `true` if bippy's instrumentation is active.
- */
-declare const isInstrumentationActive: () => boolean;
-/**
- * Returns the latest fiber (since it may be double-buffered).
- */
+//#region src/unsubscribe.d.ts
 //#endregion
-//#region ../../node_modules/.pnpm/bippy@0.5.41_react@19.2.6/node_modules/bippy/dist/source.d.ts
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/source.d.ts
 //#region src/source/parse-stack.d.ts
 interface StackFrame {
   args?: unknown[];
   columnNumber?: number;
   lineNumber?: number;
+  enclosingLineNumber?: number;
+  enclosingColumnNumber?: number;
   fileName?: string;
   functionName?: string;
   source?: string;
   isServer?: boolean;
   isSymbolicated?: boolean;
+  isIgnoreListed?: boolean;
 }
 //#endregion
+//#region ../../node_modules/.pnpm/bippy@0.6.0_react@19.2.6/node_modules/bippy/dist/core.d.ts
+/**
+ * Returns `true` if bippy's instrumentation is active.
+ */
+declare const isInstrumentationActive: () => boolean;
+//#endregion
 //#region src/utils/copy-content.d.ts
 interface CopyContentOptions {
   componentName?: string;
@@ -717,4 +771,4 @@ interface CopyContentOptions {
 }
 declare const copyContent: (content: string, options?: CopyContentOptions) => boolean;
 //#endregion
-export { ToolbarState as A, ReactGrabAPI as C, SettableOptions as D, Rect as E, SourceInfo as O, PromptModeContext as S, ReactGrabState as T, OverlayBounds as _, ActionContext as a, PluginHooks as b, AgentContext as c, DeepPartial as d, DragRect as f, Options as g, GrabbedBox as h, isInstrumentationActive as i, Theme as k, ContextMenuAction as l, ElementLabelVariant as m, StackFrame as n, ActionContextHooks as o, ElementLabelContext as p, Fiber as r, ActivationMode as s, copyContent as t, ContextMenuActionContext as u, Plugin as v, ReactGrabRendererProps as w, Position as x, PluginConfig as y };
+export { SettableOptions as A, Position as C, ReactGrabState as D, ReactGrabRendererProps as E, Theme as M, ToolbarState as N, Rect as O, PluginHooks as S, ReactGrabAPI as T, OpenFileActionHooks as _, ActionContext as a, Plugin as b, AgentContext as c, DeepPartial as d, DragRect as f, GrabbedBox as g, ElementSelectedEventDetail as h, Fiber as i, SourceInfo as j, SelectedElementPayload as k, ContextMenuAction as l, ElementLabelVariant as m, isInstrumentationActive as n, ActionContextHooks as o, ElementLabelContext as p, StackFrame as r, ActivationMode as s, copyContent as t, ContextMenuActionContext as u, Options as v, PromptModeContext as w, PluginConfig as x, OverlayBounds as y };

package/dist/core/index.cjs

@@ -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.
  */
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../core-CvEeB6XL.cjs`),t=require(`../freeze-updates-8grKqOPM.cjs`),n=require(`../copy-content-BG5RrXFG.cjs`);exports.DEFAULT_THEME=e.a,exports.copyContent=n.t,exports.formatElementInfo=n.n,exports.generateSnippet=e.n,exports.getStack=n.o,exports.init=e.t,exports.isInstrumentationActive=t.M;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../core-CYc0YR2D.cjs`),t=require(`../freeze-updates-CGN-V7_U.cjs`),n=require(`../open-file-BgHKdekg.cjs`);exports.DEFAULT_THEME=e.a,exports.copyContent=n.n,exports.formatElementInfo=n.r,exports.generateSnippet=e.n,exports.getStack=n.s,exports.init=e.t,exports.isInstrumentationActive=t.U;

package/dist/core/index.d.cts

@@ -6,6 +6,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { C as ReactGrabAPI, D as SettableOptions, O as SourceInfo, _ as OverlayBounds, a as ActionContext, b as PluginHooks, c as AgentContext, g as Options, i as isInstrumentationActive, l as ContextMenuAction, t as copyContent, v as Plugin, w as ReactGrabRendererProps, y as PluginConfig } from "../copy-content-BoeDJ9l0.cjs";
-import { a as getStack, i as formatElementInfo, n as generateSnippet, r as DEFAULT_THEME, t as init } from "../index-Ci1cIBwN.cjs";
+import { A as SettableOptions, E as ReactGrabRendererProps, S as PluginHooks, T as ReactGrabAPI, a as ActionContext, b as Plugin, c as AgentContext, j as SourceInfo, l as ContextMenuAction, n as isInstrumentationActive, t as copyContent, v as Options, x as PluginConfig, y as OverlayBounds } from "../copy-content-TZDC2S2A.cjs";
+import { a as getStack, i as formatElementInfo, n as generateSnippet, r as DEFAULT_THEME, t as init } from "../index-DDf5jObx.cjs";
 export { ActionContext, AgentContext, ContextMenuAction, DEFAULT_THEME, Options, OverlayBounds, Plugin, PluginConfig, PluginHooks, ReactGrabAPI, ReactGrabRendererProps, SettableOptions, SourceInfo, copyContent, formatElementInfo, generateSnippet, getStack, init, isInstrumentationActive };

package/dist/core/index.d.ts

@@ -6,6 +6,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { C as ReactGrabAPI, D as SettableOptions, O as SourceInfo, _ as OverlayBounds, a as ActionContext, b as PluginHooks, c as AgentContext, g as Options, i as isInstrumentationActive, l as ContextMenuAction, t as copyContent, v as Plugin, w as ReactGrabRendererProps, y as PluginConfig } from "../copy-content-CqFXlS9J.js";
-import { a as getStack, i as formatElementInfo, n as generateSnippet, r as DEFAULT_THEME, t as init } from "../index-ssynL7Na.js";
+import { A as SettableOptions, E as ReactGrabRendererProps, S as PluginHooks, T as ReactGrabAPI, a as ActionContext, b as Plugin, c as AgentContext, j as SourceInfo, l as ContextMenuAction, n as isInstrumentationActive, t as copyContent, v as Options, x as PluginConfig, y as OverlayBounds } from "../copy-content-3sDfOP1b.js";
+import { a as getStack, i as formatElementInfo, n as generateSnippet, r as DEFAULT_THEME, t as init } from "../index-DWvC_uKW.js";
 export { ActionContext, AgentContext, ContextMenuAction, DEFAULT_THEME, Options, OverlayBounds, Plugin, PluginConfig, PluginHooks, ReactGrabAPI, ReactGrabRendererProps, SettableOptions, SourceInfo, copyContent, formatElementInfo, generateSnippet, getStack, init, isInstrumentationActive };

package/dist/core/index.js

@@ -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.
  */
-import{a as e,n as t,t as n}from"../core-CX-oJjgu.js";import{M as r}from"../freeze-updates-DiPhJRln.js";import{n as i,o as a,t as o}from"../copy-content-Drw2cQ8V.js";export{e as DEFAULT_THEME,o as copyContent,i as formatElementInfo,t as generateSnippet,a as getStack,n as init,r as isInstrumentationActive};
+import{a as e,n as t,t as n}from"../core-Dc3PSb_B.js";import{U as r}from"../freeze-updates-D9dkUnJy.js";import{n as i,r as a,s as o}from"../open-file-B5I3lUSY.js";export{e as DEFAULT_THEME,i as copyContent,a as formatElementInfo,t as generateSnippet,o as getStack,n as init,r as isInstrumentationActive};