@lytjs/devtools 6.0.0 → 6.5.0

package/dist/index.d.ts

@@ -19,7 +19,7 @@ interface DevToolsOptions {
 interface ComponentTreeNode {
     id: string;
     name: string;
-    props?: Record<string, any>;
+    props?: Record<string, unknown>;
     children?: ComponentTreeNode[];
     parent?: string;
 }
@@ -28,8 +28,8 @@ interface ComponentTreeNode {
  */
 interface StoreStateInfo {
     id: string;
-    state: Record<string, any>;
-    getters?: Record<string, any>;
+    state: Record<string, unknown>;
+    getters?: Record<string, unknown>;
 }
 /**
  * 路由信息
@@ -44,96 +44,6 @@ interface RouteInfo {
         name?: string | null;
     }>;
 }
-/**
- * 信号节点信息
- */
-interface SignalNode$1 {
-    id: string;
-    name: string;
-    type: 'signal' | 'computed' | 'effect';
-    value?: unknown;
-    previousValue?: unknown;
-    dependencies: string[];
-    dependents: string[];
-    updateCount: number;
-    lastUpdateTime: number;
-    averageUpdateTime: number;
-}
-/**
- * 快照记录
- */
-interface Snapshot$1 {
-    id: string;
-    timestamp: number;
-    label?: string;
-    signals: Record<string, SignalSnapshot$1>;
-}
-/**
- * 单个信号的快照
- */
-interface SignalSnapshot$1 {
-    value: unknown;
-    dependencies: string[];
-}
-/**
- * 时间旅行状态
- */
-interface TimeTravelState$1 {
-    snapshots: Snapshot$1[];
-    currentIndex: number;
-    canUndo: boolean;
-    canRedo: boolean;
-}
-/**
- * 性能记录
- */
-interface PerformanceRecord$1 {
-    id: string;
-    name: string;
-    type: 'signal' | 'computed' | 'effect';
-    duration: number;
-    timestamp: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * 依赖图节点
- */
-interface DependencyGraphNode$1 {
-    id: string;
-    name: string;
-    type: 'signal' | 'computed' | 'effect';
-    x?: number;
-    y?: number;
-}
-/**
- * 依赖图边
- */
-interface DependencyGraphEdge$1 {
-    source: string;
-    target: string;
-    type: 'dependency' | 'dependent';
-}
-/**
- * 依赖图
- */
-interface DependencyGraph$1 {
-    nodes: DependencyGraphNode$1[];
-    edges: DependencyGraphEdge$1[];
-}
-/**
- * 性能统计
- */
-interface PerformanceStats$1 {
-    totalRecords: number;
-    averageDuration: number;
-    maxDuration: number;
-    minDuration: number;
-    byType: Record<string, {
-        count: number;
-        average: number;
-        max: number;
-    }>;
-}
 /**
  * DevTools API
  */
@@ -155,7 +65,12 @@ interface DevToolsAPI {
 /**
  * 获取组件树
  */
-declare function getComponentTree(rootComponent?: any): ComponentTreeNode[];
+declare function getComponentTree(rootComponent?: {
+    name?: string;
+    displayName?: string;
+    props?: Record<string, unknown>;
+    children?: unknown[];
+}): ComponentTreeNode[];
 /**
  * 序列化组件树为字符串
  */
@@ -163,7 +78,7 @@ declare function serializeComponentTree(nodes: ComponentTreeNode[], indent?: num
 /**
  * 注册根组件（供开发时使用）
  */
-declare function registerRootComponent(component: any): void;
+declare function registerRootComponent(component: unknown): void;
 /**
  * 清除注册的根组件
  */
@@ -173,14 +88,20 @@ declare function unregisterRootComponent(): void;
  * @lytjs/devtools - Store 状态检查器
  */
 
+interface StoreInstance {
+    $state?: Record<string, unknown>;
+    $id?: string;
+    $subscribe?: (cb: (mutation: unknown, state: Record<string, unknown>) => void) => () => void;
+    [key: string]: unknown;
+}
 /**
  * Store 变更回调类型
  */
-type StoreChangeCallback = (storeId: string, state: Record<string, any>) => void;
+type StoreChangeCallback = (storeId: string, state: Record<string, unknown>) => void;
 /**
  * 注册 Store
  */
-declare function registerStore(id: string, store: any): void;
+declare function registerStore(id: string, store: StoreInstance): void;
 /**
  * 注销 Store
  */
@@ -196,11 +117,11 @@ declare function getStoreState(storeId: string): StoreStateInfo | null;
 /**
  * 修改 Store 状态（用于开发时调试）
  */
-declare function setStoreState(storeId: string, path: string, value: any): boolean;
+declare function setStoreState(storeId: string, path: string, value: unknown): boolean;
 /**
  * 触发 Store Action
  */
-declare function dispatchStoreAction(storeId: string, actionName: string, ...args: any[]): any;
+declare function dispatchStoreAction(storeId: string, actionName: string, ...args: unknown[]): unknown;
 /**
  * 序列化 Store 状态为字符串
  */
@@ -245,10 +166,28 @@ declare function getRegisteredStoreIds(): string[];
  * @lytjs/devtools - 路由查看器
  */
 
+interface RouterMatched {
+    path?: string;
+    name?: string | null;
+}
+interface RouterLocation {
+    path?: string;
+    name?: string | null;
+    params?: Record<string, string>;
+    query?: Record<string, string>;
+    matched?: RouterMatched[];
+}
+interface RouterInstance {
+    currentRoute?: () => RouterLocation;
+    afterEach?: (cb: (to: RouterLocation) => void) => void;
+    getRoutes?: () => RouterMatched[];
+    push?: (path: string) => Promise<void>;
+    back?: () => void;
+}
 /**
  * 注册路由器
  */
-declare function registerRouter(router: any): void;
+declare function registerRouter(router: RouterInstance): void;
 /**
  * 注销路由器
  */
@@ -379,6 +318,45 @@ interface DependencyGraph {
     nodes: DependencyGraphNode[];
     edges: DependencyGraphEdge[];
 }
+/** 可视化布局节点 */
+interface VisualLayoutNode {
+    id: string;
+    name: string;
+    type: 'signal' | 'computed' | 'effect';
+    x: number;
+    y: number;
+    level: number;
+    width: number;
+    height: number;
+    inDegree: number;
+    outDegree: number;
+}
+/** 可视化布局边 */
+interface VisualLayoutEdge {
+    source: string;
+    target: string;
+    sourceX: number;
+    sourceY: number;
+    targetX: number;
+    targetY: number;
+    type: 'dependency';
+}
+/** 可视化布局图 */
+interface VisualLayoutGraph {
+    nodes: VisualLayoutNode[];
+    edges: VisualLayoutEdge[];
+    width: number;
+    height: number;
+}
+/** 布局选项 */
+interface LayoutOptions {
+    nodeWidth: number;
+    nodeHeight: number;
+    horizontalSpacing: number;
+    verticalSpacing: number;
+    centerX: number;
+    centerY: number;
+}
 /**
  * 注册一个信号
  */
@@ -465,6 +443,80 @@ declare function serializeDependencyGraph(): string;
  * 序列化性能统计
  */
 declare function serializePerformanceStats(): string;
+/**
+ * 获取可视化布局图
+ */
+declare function getVisualLayoutGraph(options?: Partial<LayoutOptions>): VisualLayoutGraph;
+/**
+ * 获取以指定节点为中心的子图
+ */
+declare function getSubgraph(centerId: string, depth?: number): VisualLayoutGraph;
+/**
+ * 搜索信号节点
+ */
+declare function searchSignals(query: string): SignalNode[];
+/**
+ * 过滤信号节点
+ */
+declare function filterSignals(options: {
+    types?: Array<'signal' | 'computed' | 'effect'>;
+    minUpdateCount?: number;
+    hasDependencies?: boolean;
+    hasDependents?: boolean;
+}): SignalNode[];
+/** 快照差异 */
+interface SnapshotDiff {
+    added: Array<{
+        id: string;
+        value: unknown;
+    }>;
+    removed: Array<{
+        id: string;
+        value: unknown;
+    }>;
+    changed: Array<{
+        id: string;
+        oldValue: unknown;
+        newValue: unknown;
+    }>;
+}
+/**
+ * 比较两个快照的差异
+ */
+declare function compareSnapshots(snapshot1: Snapshot, snapshot2: Snapshot): SnapshotDiff;
+/**
+ * 序列化快照差异
+ */
+declare function serializeSnapshotDiff(diff: SnapshotDiff): string;
+/**
+ * 获取相邻快照的差异
+ */
+declare function getDiffBetweenSnapshots(index1: number, index2: number): SnapshotDiff | null;
+/**
+ * 时间旅行导航
+ */
+interface TimeTravelNavigator {
+    currentIndex: number;
+    total: number;
+    canGoBack: boolean;
+    canGoForward: boolean;
+    currentSnapshot: Snapshot | null;
+    previousSnapshot: Snapshot | null;
+    nextSnapshot: Snapshot | null;
+    diff: SnapshotDiff | null;
+}
+/**
+ * 获取时间旅行导航状态
+ */
+declare function getTimeTravelNavigator(index?: number): TimeTravelNavigator;
+/**
+ * 恢复到上一个快照
+ */
+declare function timeTravelBack(): Snapshot | null;
+/**
+ * 前进到下一个快照
+ */
+declare function timeTravelForward(): Snapshot | null;
 
 /**
  * @lytjs/devtools - 性能监控系统
@@ -618,6 +670,59 @@ declare function serializePerformanceReport(): string;
  * 创建计时器
  */
 declare function startTimer(name: string, type?: MetricType): () => void;
+/** 时序事件 */
+interface TimelineEvent {
+    id: string;
+    name: string;
+    category: 'render' | 'effect' | 'custom';
+    startTime: number;
+    duration: number;
+    depth: number;
+    metadata?: Record<string, unknown>;
+}
+/** 火焰图节点 */
+interface FlameGraphNode {
+    name: string;
+    value: number;
+    children?: FlameGraphNode[];
+    category?: 'render' | 'effect' | 'custom';
+}
+/**
+ * 开始时序事件
+ */
+declare function beginTimelineEvent(name: string, category?: TimelineEvent['category'], metadata?: Record<string, unknown>): string;
+/**
+ * 结束指定时序事件
+ */
+declare function endTimelineEvent(id: string): TimelineEvent | null;
+/**
+ * 获取所有时序事件
+ */
+declare function getTimelineEvents(): TimelineEvent[];
+/**
+ * 获取指定时间范围内的时序事件
+ */
+declare function getTimelineEventsInRange(startTime: number, endTime: number): TimelineEvent[];
+/**
+ * 获取慢操作
+ */
+declare function getSlowOperations(limit?: number, threshold?: number): TimelineEvent[];
+/**
+ * 获取火焰图数据
+ */
+declare function getFlameGraphData(): FlameGraphNode;
+/**
+ * 清除时序事件
+ */
+declare function clearTimelineEvents(): void;
+/**
+ * 导出时序事件为 JSON
+ */
+declare function exportTimelineAsJSON(): string;
+/**
+ * 序列化为可读文本
+ */
+declare function serializeTimelineEvents(): string;
 
 /**
  * @lytjs/devtools - 大规模性能压测基准测试
@@ -740,4 +845,26 @@ declare function getDevTools(): DevToolsAPI | null;
  */
 declare function uninstallDevTools(): void;
 
-export { type Alert, type AlertLevel, type AlertRule, type BenchmarkConfig, type BenchmarkResult, type ComponentTreeNode, type DependencyGraph$1 as DependencyGraph, type PerformanceStats$1 as DevPerformanceStats, type DevToolsAPI, type DevToolsOptions, LARGE_SCALE_SCENARIOS, type LargeScaleScenario, type MemoryUsage, type MetricType, type MonitorOptions, type PerformanceMetric, type PerformanceRecord$1 as PerformanceRecord, type RouteInfo, type SignalNode$1 as SignalNode, type Snapshot$1 as Snapshot, type StoreStateInfo, type TimeTravelState$1 as TimeTravelState, acknowledgeAlert, acknowledgeAllAlerts, addObserver, clearAlerts, clearBenchmarkResults, clearMetrics, clearPerformanceRecords, clearRouteHistory, clearSignalRegistry, clearSnapshots, clearStoreRegistry, compareBenchmarkResults, createLargeScaleBenchmark, createRegressionDetector, createSnapshot, installDevTools as default, dispatchStoreAction, getAlertRules, getAlerts, getBenchmarkResults, getComponentTree, getCurrentRoute, getDependencyGraph, getDevTools, getLatestBenchmarkResult, getMemoryUsage, getMetrics, getPerformanceRecords, getPerformanceReport, getPerformanceStats, getRegisteredStoreIds, getRouteHistory, getRoutes, getSignalNode, getSignalNodes, getSnapshots, getStats, getStoreState, getStoreStates, getTimeTravelState, goBack, initPerformanceMonitor, installDevTools, isRouterRegistered, navigateTo, navigateToName, onStoreChange, recordDependency, recordMetric, recordSignalUpdate, registerAlertRule, registerRootComponent, registerRouter, registerSignal, registerStore, removeObserver, resetPerformanceMonitor, restoreSnapshot, runAsyncBenchmark, runBenchmark, serializeAllBenchmarkResults, serializeBenchmarkResult, serializeComponentTree, serializeDependencyGraph, serializeMemoryUsage, serializePerformanceReport, serializePerformanceStats, serializeRouteInfo, serializeSignalNode, serializeStoreStates, setAlertRuleEnabled, setStoreState, startTimer, subscribeStore, uninstallDevTools, unregisterAlertRule, unregisterRootComponent, unregisterRouter, unregisterSignal, unregisterStore, unsubscribeStore, unwatchRouteChanges, watchRouteChanges };
+/**
+ * @lytjs/devtools - VDOM 节点树检查器
+ *
+ * 提供虚拟 DOM 树的可视化和检查功能
+ */
+
+interface VDOMNodeInfo {
+    id: string;
+    type: string;
+    tagName?: string;
+    text?: string;
+    props?: Record<string, unknown>;
+    children: VDOMNodeInfo[];
+    parentId?: string;
+    depth: number;
+    componentId?: string;
+    isComponent: boolean;
+    key?: string | number;
+    ref?: string;
+    domElement?: HTMLElement | null;
+}
+
+export { type Alert, type AlertLevel, type AlertRule, type BenchmarkConfig, type BenchmarkResult, type ComponentTreeNode, type DependencyGraph, type DevToolsAPI, type DevToolsOptions, type FlameGraphNode, LARGE_SCALE_SCENARIOS, type LargeScaleScenario, type MemoryUsage, type MetricType, type MonitorOptions, type PerformanceMetric, type PerformanceRecord, type PerformanceStats, type RouteInfo, type SignalNode, type Snapshot, type SnapshotDiff, type StoreStateInfo, type TimeTravelNavigator, type TimeTravelState, type TimelineEvent, type VDOMNodeInfo, type VisualLayoutEdge, type VisualLayoutGraph, type VisualLayoutNode, acknowledgeAlert, acknowledgeAllAlerts, addObserver, beginTimelineEvent, clearAlerts, clearBenchmarkResults, clearMetrics, clearPerformanceRecords, clearRouteHistory, clearSignalRegistry, clearSnapshots, clearStoreRegistry, clearTimelineEvents, compareBenchmarkResults, compareSnapshots, createLargeScaleBenchmark, createRegressionDetector, createSnapshot, installDevTools as default, dispatchStoreAction, endTimelineEvent, exportTimelineAsJSON, filterSignals, getAlertRules, getAlerts, getBenchmarkResults, getComponentTree, getCurrentRoute, getDependencyGraph, getDevTools, getDiffBetweenSnapshots, getFlameGraphData, getLatestBenchmarkResult, getMemoryUsage, getMetrics, getPerformanceRecords, getPerformanceReport, getPerformanceStats, getRegisteredStoreIds, getRouteHistory, getRoutes, getSignalNode, getSignalNodes, getSlowOperations, getSnapshots, getStats, getStoreState, getStoreStates, getSubgraph, getTimeTravelNavigator, getTimeTravelState, getTimelineEvents, getTimelineEventsInRange, getVisualLayoutGraph, goBack, initPerformanceMonitor, installDevTools, isRouterRegistered, navigateTo, navigateToName, onStoreChange, recordDependency, recordMetric, recordSignalUpdate, registerAlertRule, registerRootComponent, registerRouter, registerSignal, registerStore, removeObserver, resetPerformanceMonitor, restoreSnapshot, runAsyncBenchmark, runBenchmark, searchSignals, serializeAllBenchmarkResults, serializeBenchmarkResult, serializeComponentTree, serializeDependencyGraph, serializeMemoryUsage, serializePerformanceReport, serializePerformanceStats, serializeRouteInfo, serializeSignalNode, serializeSnapshotDiff, serializeStoreStates, serializeTimelineEvents, setAlertRuleEnabled, setStoreState, startTimer, subscribeStore, timeTravelBack, timeTravelForward, uninstallDevTools, unregisterAlertRule, unregisterRootComponent, unregisterRouter, unregisterSignal, unregisterStore, unsubscribeStore, unwatchRouteChanges, watchRouteChanges };