@react-devtools-plus/core 0.2.0

package/dist/types-BU_SaMGj.d.cts

@@ -0,0 +1,182 @@
+/**
+ * Core types for React DevTools
+ * React DevTools 核心类型定义
+ */
+/**
+ * Component tree node information
+ * 组件树节点信息
+ */
+interface ComponentNode {
+    id: string;
+    name: string;
+    type: 'function' | 'class' | 'memo' | 'forward-ref' | 'context' | 'provider' | 'consumer';
+    props: Record<string, any>;
+    state?: Record<string, any>;
+    hooks?: HookInfo[];
+    children: string[];
+    parent?: string;
+    source?: SourceLocation;
+}
+/**
+ * Hook information
+ * Hook 信息
+ */
+interface HookInfo {
+    index: number;
+    name: string;
+    value: any;
+    subHooks?: HookInfo[];
+}
+/**
+ * Source code location
+ * 源码位置
+ */
+interface SourceLocation {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+/**
+ * Performance metrics
+ * 性能指标
+ */
+interface PerformanceMetrics {
+    componentId: string;
+    renderTime: number;
+    updateCount: number;
+    timestamp: number;
+}
+/**
+ * DevTools state
+ * DevTools 状态
+ */
+interface DevToolsState {
+    connected: boolean;
+    selectedComponent?: string;
+    expandedComponents: Set<string>;
+    highlightedComponent?: string;
+}
+/**
+ * Event types
+ * 事件类型
+ */
+type DevToolsEvent = {
+    type: 'component-selected';
+    componentId: string;
+} | {
+    type: 'component-updated';
+    componentId: string;
+} | {
+    type: 'component-mounted';
+    componentId: string;
+} | {
+    type: 'component-unmounted';
+    componentId: string;
+} | {
+    type: 'connection-changed';
+    connected: boolean;
+} | {
+    type: 'highlight-changed';
+    componentId?: string;
+};
+/**
+ * RPC function definitions
+ * RPC 函数定义
+ */
+interface ClientFunctions {
+    getComponentTree: () => Promise<ComponentNode[]>;
+    getComponentDetails: (componentId: string) => Promise<ComponentNode | null>;
+    updateComponentProps: (componentId: string, props: Record<string, any>) => Promise<void>;
+    updateComponentState: (componentId: string, state: Record<string, any>) => Promise<void>;
+    openInEditor: (source: SourceLocation) => Promise<void>;
+    startProfiling: () => Promise<void>;
+    stopProfiling: () => Promise<PerformanceMetrics[]>;
+    selectComponent: (componentId: string) => Promise<void>;
+    highlightComponent: (componentId?: string) => Promise<void>;
+}
+interface ServerFunctions {
+    onComponentTreeChanged: () => void;
+    onComponentSelected: (componentId: string) => void;
+    onPerformanceData: (metrics: PerformanceMetrics) => void;
+}
+/**
+ * Plugin types
+ * 插件类型
+ */
+interface DevToolsPlugin {
+    /**
+     * Plugin unique identifier
+     * 插件唯一标识符
+     */
+    id: string;
+    /**
+     * Plugin name
+     * 插件名称
+     */
+    name: string;
+    /**
+     * Plugin description
+     * 插件描述
+     */
+    description?: string;
+    /**
+     * Plugin initialization
+     * 插件初始化
+     */
+    setup?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * Plugin cleanup
+     * 插件清理
+     */
+    teardown?: () => void | Promise<void>;
+    /**
+     * Custom RPC functions
+     * 自定义 RPC 函数
+     */
+    rpc?: Record<string, (...args: any[]) => any>;
+    /**
+     * Event handlers
+     * 事件处理器
+     */
+    on?: Partial<Record<DevToolsEvent['type'], (event: DevToolsEvent) => void>>;
+}
+/**
+ * Plugin context
+ * 插件上下文
+ */
+interface PluginContext {
+    /**
+     * Get component tree
+     * 获取组件树
+     */
+    getComponentTree: () => Promise<ComponentNode[]>;
+    /**
+     * Get component details
+     * 获取组件详情
+     */
+    getComponentDetails: (componentId: string) => Promise<ComponentNode | null>;
+    /**
+     * Emit event
+     * 发送事件
+     */
+    emit: (event: DevToolsEvent) => void;
+    /**
+     * Subscribe to events
+     * 订阅事件
+     */
+    on: <T extends DevToolsEvent['type']>(type: T, handler: (event: Extract<DevToolsEvent, {
+        type: T;
+    }>) => void) => () => void;
+    /**
+     * Register custom RPC function
+     * 注册自定义 RPC 函数
+     */
+    registerRPC: <T extends (...args: any[]) => any>(name: string, fn: T) => void;
+    /**
+     * Call RPC function
+     * 调用 RPC 函数
+     */
+    callRPC: <T = any>(name: string, ...args: any[]) => Promise<T>;
+}
+
+export type { ComponentNode as C, DevToolsEvent as D, HookInfo as H, PluginContext as P, SourceLocation as S, DevToolsPlugin as a, PerformanceMetrics as b, DevToolsState as c, ClientFunctions as d, ServerFunctions as e };

package/dist/types-BU_SaMGj.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Core types for React DevTools
+ * React DevTools 核心类型定义
+ */
+/**
+ * Component tree node information
+ * 组件树节点信息
+ */
+interface ComponentNode {
+    id: string;
+    name: string;
+    type: 'function' | 'class' | 'memo' | 'forward-ref' | 'context' | 'provider' | 'consumer';
+    props: Record<string, any>;
+    state?: Record<string, any>;
+    hooks?: HookInfo[];
+    children: string[];
+    parent?: string;
+    source?: SourceLocation;
+}
+/**
+ * Hook information
+ * Hook 信息
+ */
+interface HookInfo {
+    index: number;
+    name: string;
+    value: any;
+    subHooks?: HookInfo[];
+}
+/**
+ * Source code location
+ * 源码位置
+ */
+interface SourceLocation {
+    fileName: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+/**
+ * Performance metrics
+ * 性能指标
+ */
+interface PerformanceMetrics {
+    componentId: string;
+    renderTime: number;
+    updateCount: number;
+    timestamp: number;
+}
+/**
+ * DevTools state
+ * DevTools 状态
+ */
+interface DevToolsState {
+    connected: boolean;
+    selectedComponent?: string;
+    expandedComponents: Set<string>;
+    highlightedComponent?: string;
+}
+/**
+ * Event types
+ * 事件类型
+ */
+type DevToolsEvent = {
+    type: 'component-selected';
+    componentId: string;
+} | {
+    type: 'component-updated';
+    componentId: string;
+} | {
+    type: 'component-mounted';
+    componentId: string;
+} | {
+    type: 'component-unmounted';
+    componentId: string;
+} | {
+    type: 'connection-changed';
+    connected: boolean;
+} | {
+    type: 'highlight-changed';
+    componentId?: string;
+};
+/**
+ * RPC function definitions
+ * RPC 函数定义
+ */
+interface ClientFunctions {
+    getComponentTree: () => Promise<ComponentNode[]>;
+    getComponentDetails: (componentId: string) => Promise<ComponentNode | null>;
+    updateComponentProps: (componentId: string, props: Record<string, any>) => Promise<void>;
+    updateComponentState: (componentId: string, state: Record<string, any>) => Promise<void>;
+    openInEditor: (source: SourceLocation) => Promise<void>;
+    startProfiling: () => Promise<void>;
+    stopProfiling: () => Promise<PerformanceMetrics[]>;
+    selectComponent: (componentId: string) => Promise<void>;
+    highlightComponent: (componentId?: string) => Promise<void>;
+}
+interface ServerFunctions {
+    onComponentTreeChanged: () => void;
+    onComponentSelected: (componentId: string) => void;
+    onPerformanceData: (metrics: PerformanceMetrics) => void;
+}
+/**
+ * Plugin types
+ * 插件类型
+ */
+interface DevToolsPlugin {
+    /**
+     * Plugin unique identifier
+     * 插件唯一标识符
+     */
+    id: string;
+    /**
+     * Plugin name
+     * 插件名称
+     */
+    name: string;
+    /**
+     * Plugin description
+     * 插件描述
+     */
+    description?: string;
+    /**
+     * Plugin initialization
+     * 插件初始化
+     */
+    setup?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * Plugin cleanup
+     * 插件清理
+     */
+    teardown?: () => void | Promise<void>;
+    /**
+     * Custom RPC functions
+     * 自定义 RPC 函数
+     */
+    rpc?: Record<string, (...args: any[]) => any>;
+    /**
+     * Event handlers
+     * 事件处理器
+     */
+    on?: Partial<Record<DevToolsEvent['type'], (event: DevToolsEvent) => void>>;
+}
+/**
+ * Plugin context
+ * 插件上下文
+ */
+interface PluginContext {
+    /**
+     * Get component tree
+     * 获取组件树
+     */
+    getComponentTree: () => Promise<ComponentNode[]>;
+    /**
+     * Get component details
+     * 获取组件详情
+     */
+    getComponentDetails: (componentId: string) => Promise<ComponentNode | null>;
+    /**
+     * Emit event
+     * 发送事件
+     */
+    emit: (event: DevToolsEvent) => void;
+    /**
+     * Subscribe to events
+     * 订阅事件
+     */
+    on: <T extends DevToolsEvent['type']>(type: T, handler: (event: Extract<DevToolsEvent, {
+        type: T;
+    }>) => void) => () => void;
+    /**
+     * Register custom RPC function
+     * 注册自定义 RPC 函数
+     */
+    registerRPC: <T extends (...args: any[]) => any>(name: string, fn: T) => void;
+    /**
+     * Call RPC function
+     * 调用 RPC 函数
+     */
+    callRPC: <T = any>(name: string, ...args: any[]) => Promise<T>;
+}
+
+export type { ComponentNode as C, DevToolsEvent as D, HookInfo as H, PluginContext as P, SourceLocation as S, DevToolsPlugin as a, PerformanceMetrics as b, DevToolsState as c, ClientFunctions as d, ServerFunctions as e };

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@react-devtools-plus/core",
+  "type": "module",
+  "version": "0.2.0",
+  "description": "Core functionality for React DevTools including RPC, client management, and plugin system",
+  "author": "wzc520pyfm",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./rpc": {
+      "types": "./dist/rpc.d.ts",
+      "import": "./dist/rpc.js",
+      "require": "./dist/rpc.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "require": "./dist/plugin.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "birpc": "^0.2.19",
+    "@react-devtools-plus/shared": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.10"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepare:type": "tsup --dts-only",
+    "stub": "tsup --watch --dts-only",
+    "typecheck": "tsc --noEmit"
+  }
+}