react-grab 0.1.23 → 0.1.24

package/dist/primitives.d.cts

@@ -0,0 +1,62 @@
+import { Fiber } from 'bippy';
+
+interface ReactGrabElementContext {
+    element: Element;
+    htmlPreview: string;
+    stackContext: string;
+    componentName: string | null;
+    fiber: Fiber | null;
+    selector: string | null;
+    styles: string;
+}
+/**
+ * Gathers comprehensive context for a DOM element, including its React fiber,
+ * component name, source stack, HTML preview, CSS selector, and computed styles.
+ *
+ * @example
+ * const context = await getElementContext(document.querySelector('.my-button')!);
+ * console.log(context.componentName); // "SubmitButton"
+ * console.log(context.selector);      // "button.my-button"
+ * console.log(context.stackContext);  // "SubmitButton > Form > App"
+ */
+declare const getElementContext: (element: Element) => Promise<ReactGrabElementContext>;
+/**
+ * Freezes the page by halting React updates, pausing CSS/JS animations,
+ * and preserving pseudo-states (e.g. :hover, :focus) on the given elements.
+ *
+ * @example
+ * freeze(); // freezes the entire page
+ * freeze([document.querySelector('.modal')!]); // freezes only the modal subtree
+ */
+declare const freeze: (elements?: Element[]) => void;
+/**
+ * Restores normal page behavior by re-enabling React updates, resuming
+ * animations, and releasing preserved pseudo-states.
+ *
+ * @example
+ * freeze();
+ * // ... capture a snapshot ...
+ * unfreeze(); // page resumes normal behavior
+ */
+declare const unfreeze: () => void;
+/**
+ * Returns whether the page is currently in a frozen state.
+ *
+ * @example
+ * if (isFreezeActive()) {
+ *   console.log('Page is frozen, skipping update');
+ * }
+ */
+declare const isFreezeActive: () => boolean;
+/**
+ * Opens the source file at the given path in the user's editor.
+ * Tries the dev-server endpoint first (Vite / Next.js), then falls back
+ * to a protocol URL (e.g. vscode://file/…).
+ *
+ * @example
+ * openFile("/src/components/Button.tsx");
+ * openFile("/src/components/Button.tsx", 42);
+ */
+declare const openFile: (filePath: string, lineNumber?: number) => Promise<void>;
+
+export { type ReactGrabElementContext, freeze, getElementContext, isFreezeActive, openFile, unfreeze };

package/dist/primitives.d.ts

@@ -0,0 +1,62 @@
+import { Fiber } from 'bippy';
+
+interface ReactGrabElementContext {
+    element: Element;
+    htmlPreview: string;
+    stackContext: string;
+    componentName: string | null;
+    fiber: Fiber | null;
+    selector: string | null;
+    styles: string;
+}
+/**
+ * Gathers comprehensive context for a DOM element, including its React fiber,
+ * component name, source stack, HTML preview, CSS selector, and computed styles.
+ *
+ * @example
+ * const context = await getElementContext(document.querySelector('.my-button')!);
+ * console.log(context.componentName); // "SubmitButton"
+ * console.log(context.selector);      // "button.my-button"
+ * console.log(context.stackContext);  // "SubmitButton > Form > App"
+ */
+declare const getElementContext: (element: Element) => Promise<ReactGrabElementContext>;
+/**
+ * Freezes the page by halting React updates, pausing CSS/JS animations,
+ * and preserving pseudo-states (e.g. :hover, :focus) on the given elements.
+ *
+ * @example
+ * freeze(); // freezes the entire page
+ * freeze([document.querySelector('.modal')!]); // freezes only the modal subtree
+ */
+declare const freeze: (elements?: Element[]) => void;
+/**
+ * Restores normal page behavior by re-enabling React updates, resuming
+ * animations, and releasing preserved pseudo-states.
+ *
+ * @example
+ * freeze();
+ * // ... capture a snapshot ...
+ * unfreeze(); // page resumes normal behavior
+ */
+declare const unfreeze: () => void;
+/**
+ * Returns whether the page is currently in a frozen state.
+ *
+ * @example
+ * if (isFreezeActive()) {
+ *   console.log('Page is frozen, skipping update');
+ * }
+ */
+declare const isFreezeActive: () => boolean;
+/**
+ * Opens the source file at the given path in the user's editor.
+ * Tries the dev-server endpoint first (Vite / Next.js), then falls back
+ * to a protocol URL (e.g. vscode://file/…).
+ *
+ * @example
+ * openFile("/src/components/Button.tsx");
+ * openFile("/src/components/Button.tsx", 42);
+ */
+declare const openFile: (filePath: string, lineNumber?: number) => Promise<void>;
+
+export { type ReactGrabElementContext, freeze, getElementContext, isFreezeActive, openFile, unfreeze };

package/dist/primitives.js

@@ -0,0 +1,9 @@
+import {va,xa,ua,ma,Oa,Pa,za,Ba,Ca,Ma,Da,Na,ya}from'./chunk-UERZTOK6.js';/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var H=async e=>{let t=await va(e),g=xa(e),z=ua(e),F=ma(e),v=Oa(e),C=Pa(e);return {element:e,htmlPreview:g,stackContext:t,componentName:z,fiber:F,selector:v,styles:C}},r=new Set,n=false,R=e=>{n=true,za(),r.add(Ba(e??[document.body])),Ca(),Ma();},D=()=>{n=false;for(let e of Array.from(r))e();r.clear(),Ba([]),Da(),Na();},I=()=>n,L=async(e,t)=>{await ya(e,t);};export{R as freeze,H as getElementContext,I as isFreezeActive,L as openFile,D as unfreeze};

package/dist/react.cjs

@@ -2152,7 +2152,7 @@ var VERSION, VIEWPORT_MARGIN_PX, OFFSCREEN_POSITION, SELECTION_LERP_FACTOR, FEED
 var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
-    VERSION = "0.1.23";
+    VERSION = "0.1.24";
     VIEWPORT_MARGIN_PX = 8;
     OFFSCREEN_POSITION = -1e3;
     SELECTION_LERP_FACTOR = 0.95;
@@ -15456,7 +15456,7 @@ var init_log_intro = __esm({
     init_is_extension_context();
     logIntro = () => {
       try {
-        const version = "0.1.23";
+        const version = "0.1.24";
         const logoDataUri = `data:image/svg+xml;base64,${btoa(LOGO_SVG)}`;
         console.log(
           `%cReact Grab${version ? ` v${version}` : ""}%c

package/dist/react.js

@@ -2140,7 +2140,7 @@ var VERSION, VIEWPORT_MARGIN_PX, OFFSCREEN_POSITION, SELECTION_LERP_FACTOR, FEED
 var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
-    VERSION = "0.1.23";
+    VERSION = "0.1.24";
     VIEWPORT_MARGIN_PX = 8;
     OFFSCREEN_POSITION = -1e3;
     SELECTION_LERP_FACTOR = 0.95;
@@ -15444,7 +15444,7 @@ var init_log_intro = __esm({
     init_is_extension_context();
     logIntro = () => {
       try {
-        const version = "0.1.23";
+        const version = "0.1.24";
         const logoDataUri = `data:image/svg+xml;base64,${btoa(LOGO_SVG)}`;
         console.log(
           `%cReact Grab${version ? ` v${version}` : ""}%c

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-grab",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Select context for coding agents directly from your website",
   "keywords": [
     "agent",
@@ -69,6 +69,16 @@
         "default": "./dist/react.cjs"
       }
     },
+    "./primitives": {
+      "import": {
+        "types": "./dist/primitives.d.ts",
+        "default": "./dist/primitives.js"
+      },
+      "require": {
+        "types": "./dist/primitives.d.cts",
+        "default": "./dist/primitives.cjs"
+      }
+    },
     "./src/*": "./src/*",
     "./styles.css": "./dist/styles.css",
     "./dist/styles.css": "./dist/styles.css",
@@ -84,7 +94,7 @@
     "@medv/finder": "^4.0.2",
     "bippy": "^0.5.30",
     "solid-js": "^1.9.10",
-    "@react-grab/cli": "0.1.23"
+    "@react-grab/cli": "0.1.24"
   },
   "devDependencies": {
     "@babel/core": "^7.28.5",