@domscribe/react 0.1.0

package/errors/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * React adapter-specific error classes
+ * @module @domscribe/react/errors
+ */
+import { DomscribeError } from '@domscribe/core';
+/**
+ * Error thrown when accessing React Fiber fails
+ */
+export declare class FiberAccessError extends DomscribeError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when component resolution fails
+ */
+export declare class ComponentResolutionError extends DomscribeError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when component name resolution fails
+ */
+export declare class NameResolutionError extends DomscribeError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when props extraction fails
+ */
+export declare class PropsExtractionError extends DomscribeError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when state extraction fails
+ */
+export declare class StateExtractionError extends DomscribeError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=index.d.ts.map

package/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/domscribe-react/src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAS3C;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;gBAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAS3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAS3C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAS3C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAS3C"}

package/errors/index.js

@@ -0,0 +1,75 @@
+/**
+ * React adapter-specific error classes
+ * @module @domscribe/react/errors
+ */
+import { DomscribeError, DomscribeErrorCode } from '@domscribe/core';
+/**
+ * Error thrown when accessing React Fiber fails
+ */
+export class FiberAccessError extends DomscribeError {
+    constructor(message, cause) {
+        super({
+            code: DomscribeErrorCode.DS_INTERNAL_ERROR,
+            title: `Fiber access failed: ${message}`,
+            detail: cause?.message,
+            status: 500,
+        });
+        this.name = 'FiberAccessError';
+    }
+}
+/**
+ * Error thrown when component resolution fails
+ */
+export class ComponentResolutionError extends DomscribeError {
+    constructor(message, cause) {
+        super({
+            code: DomscribeErrorCode.DS_INTERNAL_ERROR,
+            title: `Component resolution failed: ${message}`,
+            detail: cause?.message,
+            status: 500,
+        });
+        this.name = 'ComponentResolutionError';
+    }
+}
+/**
+ * Error thrown when component name resolution fails
+ */
+export class NameResolutionError extends DomscribeError {
+    constructor(message, cause) {
+        super({
+            code: DomscribeErrorCode.DS_INTERNAL_ERROR,
+            title: `Component name resolution failed: ${message}`,
+            detail: cause?.message,
+            status: 500,
+        });
+        this.name = 'NameResolutionError';
+    }
+}
+/**
+ * Error thrown when props extraction fails
+ */
+export class PropsExtractionError extends DomscribeError {
+    constructor(message, cause) {
+        super({
+            code: DomscribeErrorCode.DS_INTERNAL_ERROR,
+            title: `Props extraction failed: ${message}`,
+            detail: cause?.message,
+            status: 500,
+        });
+        this.name = 'PropsExtractionError';
+    }
+}
+/**
+ * Error thrown when state extraction fails
+ */
+export class StateExtractionError extends DomscribeError {
+    constructor(message, cause) {
+        super({
+            code: DomscribeErrorCode.DS_INTERNAL_ERROR,
+            title: `State extraction failed: ${message}`,
+            detail: cause?.message,
+            status: 500,
+        });
+        this.name = 'StateExtractionError';
+    }
+}

package/fiber/fiber-walker.d.ts

@@ -0,0 +1,58 @@
+/**
+ * FiberWalker - Navigate the React Fiber tree safely
+ *
+ * Provides utilities for traversing the React Fiber tree structure,
+ * finding specific nodes, and analyzing relationships between fibers.
+ *
+ * @module @domscribe/react/fiber/fiber-walker
+ */
+import type { ExtendedReactFiber, FiberWalkOptions } from './types.js';
+/**
+ * FiberWalker class for navigating the React Fiber tree
+ */
+export declare class FiberWalker {
+    private readonly maxDepth;
+    constructor(options?: {
+        maxDepth?: number;
+    });
+    /**
+     * Find nearest component fiber (walking up the tree)
+     *
+     * @param fiber - Starting fiber node
+     * @returns Nearest component fiber or null
+     */
+    findNearestComponentFiber(fiber: ExtendedReactFiber): ExtendedReactFiber | null;
+    /**
+     * Get all child fibers
+     *
+     * @param fiber - Parent fiber node
+     * @param options - Walk options
+     * @returns Array of child fibers
+     */
+    getChildren(fiber: ExtendedReactFiber, options?: FiberWalkOptions): ExtendedReactFiber[];
+    /**
+     * Walk up the Fiber tree from a starting fiber
+     */
+    private walkUp;
+    /**
+     * Check if a fiber should be included based on options
+     */
+    private shouldIncludeFiber;
+    /**
+     * Check if a fiber is a component (not host/text)
+     */
+    private isComponentFiber;
+    /**
+     * Check if a fiber is a host component (DOM element)
+     */
+    private isHostComponent;
+    /**
+     * Check if a fiber is a text node
+     */
+    private isTextNode;
+    /**
+     * Check if a fiber is a system component
+     */
+    private isSystemComponent;
+}
+//# sourceMappingURL=fiber-walker.d.ts.map

package/fiber/fiber-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiber-walker.d.ts","sourceRoot":"","sources":["../../../../packages/domscribe-react/src/fiber/fiber-walker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGvE;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3C;;;;;OAKG;IACH,yBAAyB,CACvB,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,GAAG,IAAI;IAI5B;;;;;;OAMG;IACH,WAAW,CACT,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,kBAAkB,EAAE;IAgBvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAmBd;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAc1B"}

package/fiber/fiber-walker.js

@@ -0,0 +1,118 @@
+/**
+ * FiberWalker - Navigate the React Fiber tree safely
+ *
+ * Provides utilities for traversing the React Fiber tree structure,
+ * finding specific nodes, and analyzing relationships between fibers.
+ *
+ * @module @domscribe/react/fiber/fiber-walker
+ */
+import { DEFAULT_OPTIONS, REACT_FIBER_TAGS } from '../utils/constants.js';
+/**
+ * FiberWalker class for navigating the React Fiber tree
+ */
+export class FiberWalker {
+    maxDepth;
+    constructor(options) {
+        this.maxDepth = options?.maxDepth ?? DEFAULT_OPTIONS.MAX_TREE_DEPTH;
+    }
+    /**
+     * Find nearest component fiber (walking up the tree)
+     *
+     * @param fiber - Starting fiber node
+     * @returns Nearest component fiber or null
+     */
+    findNearestComponentFiber(fiber) {
+        return this.walkUp(fiber, (f) => this.isComponentFiber(f));
+    }
+    /**
+     * Get all child fibers
+     *
+     * @param fiber - Parent fiber node
+     * @param options - Walk options
+     * @returns Array of child fibers
+     */
+    getChildren(fiber, options) {
+        const children = [];
+        let child = fiber.child;
+        while (child) {
+            if (this.shouldIncludeFiber(child, options)) {
+                children.push(child);
+            }
+            child = child.sibling;
+        }
+        return children;
+    }
+    // Private helpers
+    /**
+     * Walk up the Fiber tree from a starting fiber
+     */
+    walkUp(fiber, predicate) {
+        let current = fiber;
+        let depth = 0;
+        while (current && depth < this.maxDepth) {
+            if (predicate(current)) {
+                return current;
+            }
+            current = current.return;
+            depth++;
+        }
+        return null;
+    }
+    /**
+     * Check if a fiber should be included based on options
+     */
+    shouldIncludeFiber(fiber, options) {
+        // Apply custom filter if provided
+        if (options?.filter && !options.filter(fiber)) {
+            return false;
+        }
+        // Check fiber type inclusions
+        if (!options?.includeHost && this.isHostComponent(fiber)) {
+            return false;
+        }
+        if (!options?.includeText && this.isTextNode(fiber)) {
+            return false;
+        }
+        if (!options?.includeSystem && this.isSystemComponent(fiber)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if a fiber is a component (not host/text)
+     */
+    isComponentFiber(fiber) {
+        return (fiber.tag === REACT_FIBER_TAGS.FunctionComponent ||
+            fiber.tag === REACT_FIBER_TAGS.ClassComponent ||
+            fiber.tag === REACT_FIBER_TAGS.ForwardRef ||
+            fiber.tag === REACT_FIBER_TAGS.MemoComponent ||
+            fiber.tag === REACT_FIBER_TAGS.SimpleMemoComponent);
+    }
+    /**
+     * Check if a fiber is a host component (DOM element)
+     */
+    isHostComponent(fiber) {
+        return fiber.tag === REACT_FIBER_TAGS.HostComponent;
+    }
+    /**
+     * Check if a fiber is a text node
+     */
+    isTextNode(fiber) {
+        return fiber.tag === REACT_FIBER_TAGS.HostText;
+    }
+    /**
+     * Check if a fiber is a system component
+     */
+    isSystemComponent(fiber) {
+        return (fiber.tag === REACT_FIBER_TAGS.Mode ||
+            fiber.tag === REACT_FIBER_TAGS.ContextConsumer ||
+            fiber.tag === REACT_FIBER_TAGS.ContextProvider ||
+            fiber.tag === REACT_FIBER_TAGS.Profiler ||
+            fiber.tag === REACT_FIBER_TAGS.SuspenseComponent ||
+            fiber.tag === REACT_FIBER_TAGS.SuspenseListComponent ||
+            fiber.tag === REACT_FIBER_TAGS.OffscreenComponent ||
+            fiber.tag === REACT_FIBER_TAGS.LegacyHiddenComponent ||
+            fiber.tag === REACT_FIBER_TAGS.CacheComponent ||
+            fiber.tag === REACT_FIBER_TAGS.TracingMarkerComponent);
+    }
+}

package/fiber/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * React Fiber type definitions
+ * @module @domscribe/react/fiber/types
+ */
+/**
+ * Component category classification
+ */
+export declare enum ComponentCategory {
+    /** User-defined function component */
+    USER_FUNCTION = "user-function",
+    /** User-defined class component */
+    USER_CLASS = "user-class",
+    /** Higher Order Component wrapper */
+    HOC = "hoc",
+    /** React.memo wrapper */
+    MEMO = "memo",
+    /** React.forwardRef wrapper */
+    FORWARD_REF = "forward-ref",
+    /** React.lazy wrapper */
+    LAZY = "lazy",
+    /** React internal component (Suspense, Profiler, etc.) */
+    SYSTEM = "system",
+    /** Host component (DOM element like div, span) */
+    HOST = "host",
+    /** Text node */
+    TEXT = "text",
+    /** Fragment */
+    FRAGMENT = "fragment",
+    /** Unknown or unclassified */
+    UNKNOWN = "unknown"
+}
+/**
+ * Extended React Fiber node with comprehensive type information
+ *
+ * Based on React's internal Fiber structure but enhanced for our needs.
+ * This extends the basic ReactFiber from @domscribe/runtime/devtools/types.
+ */
+export interface ExtendedReactFiber {
+    /**
+     * Fiber tag (identifies the type of fiber)
+     */
+    tag: number;
+    /**
+     * The resolved type of this element
+     */
+    type?: unknown;
+    /**
+     * Component key for reconciliation
+     */
+    key?: string | null;
+    /**
+     * Current props
+     */
+    memoizedProps?: Record<string, unknown>;
+    /**
+     * Pending props (for updates)
+     */
+    pendingProps?: Record<string, unknown>;
+    /**
+     * Current state (or hook chain for function components)
+     */
+    memoizedState?: unknown;
+    /**
+     * Dependencies for memoization
+     */
+    dependencies?: unknown;
+    /**
+     * The actual DOM node or component instance
+     */
+    stateNode?: unknown;
+    /**
+     * Parent fiber
+     */
+    return?: ExtendedReactFiber;
+    /**
+     * First child fiber
+     */
+    child?: ExtendedReactFiber;
+    /**
+     * Next sibling fiber
+     */
+    sibling?: ExtendedReactFiber;
+    /**
+     * Index within parent's children
+     */
+    index?: number;
+    /**
+     * Ref object or callback
+     */
+    ref?: unknown;
+    /**
+     * Effect flags (side effects to perform)
+     */
+    flags?: number;
+    /**
+     * Subtree flags (effects in subtree)
+     */
+    subtreeFlags?: number;
+    /**
+     * Alternate fiber (work in progress vs current)
+     */
+    alternate?: ExtendedReactFiber;
+    /**
+     * Element type (for debugging)
+     */
+    elementType?: unknown;
+    /**
+     * Owner fiber (component that created this element)
+     */
+    _debugOwner?: ExtendedReactFiber;
+    /**
+     * Debug source location
+     */
+    _debugSource?: {
+        fileName?: string;
+        lineNumber?: number;
+        columnNumber?: number;
+    };
+    /**
+     * Component name (for debugging)
+     */
+    _debugHookTypes?: string[];
+    /**
+     * React DevTools extension data
+     */
+    _debugID?: number;
+}
+/**
+ * Options for Fiber tree walking
+ */
+export interface FiberWalkOptions {
+    /**
+     * Maximum depth to traverse
+     * @default 50
+     */
+    maxDepth?: number;
+    /**
+     * Include host components (DOM elements)
+     * @default false
+     */
+    includeHost?: boolean;
+    /**
+     * Include text nodes
+     * @default false
+     */
+    includeText?: boolean;
+    /**
+     * Include React system components (Suspense, Profiler, etc.)
+     * @default false
+     */
+    includeSystem?: boolean;
+    /**
+     * Walk direction: 'up' (ancestors), 'down' (descendants), or 'siblings'
+     * @default 'up'
+     */
+    direction?: 'up' | 'down' | 'siblings';
+    /**
+     * Predicate function to filter fibers
+     */
+    filter?: (fiber: ExtendedReactFiber) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/fiber/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/domscribe-react/src/fiber/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,sCAAsC;IACtC,aAAa,kBAAkB;IAE/B,mCAAmC;IACnC,UAAU,eAAe;IAEzB,qCAAqC;IACrC,GAAG,QAAQ;IAEX,yBAAyB;IACzB,IAAI,SAAS;IAEb,+BAA+B;IAC/B,WAAW,gBAAgB;IAE3B,yBAAyB;IACzB,IAAI,SAAS;IAEb,0DAA0D;IAC1D,MAAM,WAAW;IAEjB,kDAAkD;IAClD,IAAI,SAAS;IAEb,gBAAgB;IAChB,IAAI,SAAS;IAEb,eAAe;IACf,QAAQ,aAAa;IAErB,8BAA8B;IAC9B,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAEjC;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;CACjD"}

package/fiber/types.js

@@ -0,0 +1,32 @@
+/**
+ * React Fiber type definitions
+ * @module @domscribe/react/fiber/types
+ */
+/**
+ * Component category classification
+ */
+export var ComponentCategory;
+(function (ComponentCategory) {
+    /** User-defined function component */
+    ComponentCategory["USER_FUNCTION"] = "user-function";
+    /** User-defined class component */
+    ComponentCategory["USER_CLASS"] = "user-class";
+    /** Higher Order Component wrapper */
+    ComponentCategory["HOC"] = "hoc";
+    /** React.memo wrapper */
+    ComponentCategory["MEMO"] = "memo";
+    /** React.forwardRef wrapper */
+    ComponentCategory["FORWARD_REF"] = "forward-ref";
+    /** React.lazy wrapper */
+    ComponentCategory["LAZY"] = "lazy";
+    /** React internal component (Suspense, Profiler, etc.) */
+    ComponentCategory["SYSTEM"] = "system";
+    /** Host component (DOM element like div, span) */
+    ComponentCategory["HOST"] = "host";
+    /** Text node */
+    ComponentCategory["TEXT"] = "text";
+    /** Fragment */
+    ComponentCategory["FRAGMENT"] = "fragment";
+    /** Unknown or unclassified */
+    ComponentCategory["UNKNOWN"] = "unknown";
+})(ComponentCategory || (ComponentCategory = {}));

package/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @domscribe/react - React framework adapter for Domscribe
+ *
+ * Provides runtime context capture for React applications, including:
+ * - Props and state extraction
+ * - Component name resolution
+ * - Fiber tree traversal
+ *
+ * @module @domscribe/react
+ */
+export { ReactAdapter, createReactAdapter } from './adapter/react-adapter.js';
+export type { ReactAdapterOptions, ReactFrameworkAdapter, } from './adapter/types.js';
+export { CaptureStrategy } from './adapter/types.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/domscribe-react/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAK9E,YAAY,EACV,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/index.js

@@ -0,0 +1,15 @@
+/**
+ * @domscribe/react - React framework adapter for Domscribe
+ *
+ * Provides runtime context capture for React applications, including:
+ * - Props and state extraction
+ * - Component name resolution
+ * - Fiber tree traversal
+ *
+ * @module @domscribe/react
+ */
+// ============================================================================
+// Adapter
+// ============================================================================
+export { ReactAdapter, createReactAdapter } from './adapter/react-adapter.js';
+export { CaptureStrategy } from './adapter/types.js';

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@domscribe/react",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "@domscribe/core": "0.1.0",
+    "@domscribe/runtime": "0.1.0",
+    "@domscribe/transform": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/webpack": "^5.28.5",
+    "happy-dom": "^12.0.0",
+    "react": "^18.2.0",
+    "webpack": "^5.102.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
+    "webpack": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./vite": {
+      "types": "./vite/index.d.ts",
+      "import": "./vite/index.js",
+      "default": "./vite/index.js"
+    },
+    "./webpack": {
+      "types": "./webpack/index.d.ts",
+      "import": "./webpack/index.js",
+      "default": "./webpack/index.js"
+    },
+    "./auto-init": {
+      "types": "./auto-init.d.ts",
+      "import": "./auto-init.js",
+      "default": "./auto-init.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./index.d.ts",
+  "module": "./index.js"
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.9.3"}

package/utils/constants.d.ts

@@ -0,0 +1,94 @@
+/**
+ * React constants and magic numbers
+ * @module @domscribe/react/utils/constants
+ */
+/**
+ * React Fiber tags
+ *
+ * These are internal constants used by React to identify different types of Fiber nodes.
+ * Based on React's ReactWorkTags.js (values may vary slightly across React versions)
+ *
+ * @see https://github.com/facebook/react/blob/main/packages/react-reconciler/src/ReactWorkTags.js
+ */
+export declare const REACT_FIBER_TAGS: {
+    readonly FunctionComponent: 0;
+    readonly ClassComponent: 1;
+    readonly IndeterminateComponent: 2;
+    readonly HostRoot: 3;
+    readonly HostPortal: 4;
+    readonly HostComponent: 5;
+    readonly HostText: 6;
+    readonly Fragment: 7;
+    readonly Mode: 8;
+    readonly ContextConsumer: 9;
+    readonly ContextProvider: 10;
+    readonly ForwardRef: 11;
+    readonly Profiler: 12;
+    readonly SuspenseComponent: 13;
+    readonly MemoComponent: 14;
+    readonly SimpleMemoComponent: 15;
+    readonly LazyComponent: 16;
+    readonly IncompleteClassComponent: 17;
+    readonly DehydratedFragment: 18;
+    readonly SuspenseListComponent: 19;
+    readonly ScopeComponent: 21;
+    readonly OffscreenComponent: 22;
+    readonly LegacyHiddenComponent: 23;
+    readonly CacheComponent: 24;
+    readonly TracingMarkerComponent: 25;
+};
+/**
+ * React internal props to exclude from capture
+ *
+ * These props are internal to React and should not be included in captured props
+ */
+export declare const REACT_INTERNAL_PROPS: Set<string>;
+/**
+ * Common HOC (Higher Order Component) patterns
+ *
+ * Used to detect and unwrap HOC wrappers to find the underlying component
+ */
+export declare const COMMON_HOC_PATTERNS: string[];
+/**
+ * Default options for various operations
+ */
+export declare const DEFAULT_OPTIONS: {
+    /**
+     * Default maximum tree depth
+     */
+    readonly MAX_TREE_DEPTH: 50;
+    /**
+     * Default maximum hooks to parse
+     */
+    readonly MAX_HOOKS: 100;
+    /**
+     * Default maximum wrapper depth
+     */
+    readonly MAX_WRAPPER_DEPTH: 3;
+    /**
+     * Default capture strategy
+     */
+    readonly CAPTURE_STRATEGY: "best-effort";
+    /**
+     * Default fallback component name
+     */
+    readonly FALLBACK_COMPONENT_NAME: "Anonymous";
+    /**
+     * Default hook name prefix
+     */
+    readonly HOOK_NAME_PREFIX: "hook_";
+};
+/**
+ * React element keys (different across React versions)
+ */
+export declare const REACT_ELEMENT_KEYS: {
+    readonly FIBER_16: "__reactInternalInstance";
+    readonly FIBER_17_18: "__reactFiber";
+    readonly PROPS_16: "__reactEventHandlers";
+    readonly PROPS_17_18: "__reactProps";
+};
+/**
+ * DevTools global hook key
+ */
+export declare const DEVTOOLS_HOOK_KEY = "__REACT_DEVTOOLS_GLOBAL_HOOK__";
+//# sourceMappingURL=constants.d.ts.map