@lytjs/devtools 4.0.5 → 4.2.0

package/dist/types/hooks.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Lyt.js DevTools — 应用连接钩子
+ *
+ * 负责将 DevTools 连接到 Lyt.js 应用实例，拦截组件生命周期、
+ * 状态变化和事件发射，并将数据推送到 DevTools 面板。
+ *
+ * 核心功能：
+ * - connectToApp(app) 连接到 Lyt 应用实例
+ * - 拦截组件创建/更新/卸载生命周期
+ * - 拦截状态变化
+ * - 拦截事件发射
+ * - 将数据推送到 DevTools 面板
+ *
+ * 纯原生零依赖实现。
+ */
+/** 组件信息（DevTools 内部使用） */
+export interface ComponentInfo {
+    /** 唯一标识 */
+    id: string;
+    /** 组件名称 */
+    name: string;
+    /** 父组件 ID */
+    parentId: string | null;
+    /** 子组件 ID 列表 */
+    childIds: string[];
+    /** 组件 props */
+    props: Record<string, any>;
+    /** 组件 state */
+    state: Record<string, any>;
+    /** 计算属性缓存 */
+    computed: Record<string, any>;
+    /** 是否已挂载 */
+    isMounted: boolean;
+    /** 是否已卸载 */
+    isUnmounted: boolean;
+    /** 对应的 DOM 元素 */
+    el: Element | null;
+    /** 渲染耗时（毫秒） */
+    renderTime: number;
+    /** 最后更新时间 */
+    lastUpdateTime: number;
+    /** 组件实例引用 */
+    instance: any;
+}
+/** 事件记录 */
+export interface EventRecord {
+    /** 事件唯一 ID */
+    id: string;
+    /** 事件名称 */
+    name: string;
+    /** 触发时间戳 */
+    timestamp: number;
+    /** 事件参数 */
+    args: any[];
+    /** 来源组件 ID */
+    componentId: string;
+    /** 来源组件名称 */
+    componentName: string;
+}
+/** 状态变化记录 */
+export interface StateChangeRecord {
+    /** 组件 ID */
+    componentId: string;
+    /** 组件名称 */
+    componentName: string;
+    /** 属性路径 */
+    path: string;
+    /** 旧值 */
+    oldValue: any;
+    /** 新值 */
+    newValue: any;
+    /** 变化时间戳 */
+    timestamp: number;
+}
+/** DevTools 钩子回调接口 */
+export interface DevToolsCallbacks {
+    /** 组件创建回调 */
+    onComponentCreated?: (info: ComponentInfo) => void;
+    /** 组件更新回调 */
+    onComponentUpdated?: (info: ComponentInfo) => void;
+    /** 组件卸载回调 */
+    onComponentUnmounted?: (componentId: string) => void;
+    /** 状态变化回调 */
+    onStateChanged?: (record: StateChangeRecord) => void;
+    /** 事件触发回调 */
+    onEventEmitted?: (record: EventRecord) => void;
+}
+/** Lyt 应用实例接口（最小化） */
+export interface LytApp {
+    /** 根组件实例 */
+    _instance: any;
+    /** 挂载方法 */
+    mount: (container: string | Element) => any;
+    /** 卸载方法 */
+    unmount: () => void;
+    /** 全局属性 */
+    globalProperties?: Record<string, any>;
+}
+/**
+ * 连接到 Lyt.js 应用实例
+ *
+ * 通过拦截应用实例上的方法来监听组件生命周期、状态变化和事件。
+ *
+ * @param app - Lyt.js 应用实例
+ * @param cb - DevTools 回调函数集合
+ */
+export declare function connectToApp(app: LytApp, cb?: DevToolsCallbacks): void;
+/**
+ * 获取所有组件信息
+ */
+export declare function getAllComponents(): ComponentInfo[];
+/**
+ * 获取根组件信息
+ */
+export declare function getRootComponent(): ComponentInfo | null;
+/**
+ * 根据 ID 获取组件信息
+ */
+export declare function getComponentById(id: string): ComponentInfo | null;
+/**
+ * 获取组件的子组件列表
+ */
+export declare function getChildComponents(parentId: string): ComponentInfo[];
+/**
+ * 获取所有事件记录
+ */
+export declare function getEventRecords(): EventRecord[];
+/**
+ * 获取所有状态变化记录
+ */
+export declare function getStateChangeRecords(): StateChangeRecord[];
+/**
+ * 获取指定组件的状态变化记录
+ */
+export declare function getComponentStateChanges(componentId: string): StateChangeRecord[];
+/**
+ * 获取指定组件的事件记录
+ */
+export declare function getComponentEvents(componentId: string): EventRecord[];
+/**
+ * 选中组件
+ */
+export declare function selectComponent(id: string | null): void;
+/**
+ * 获取当前选中的组件
+ */
+export declare function getSelectedComponent(): ComponentInfo | null;
+/**
+ * 获取当前选中的组件 ID
+ */
+export declare function getSelectedComponentId(): string | null;
+/**
+ * 手动修改组件状态
+ */
+export declare function setComponentState(componentId: string, path: string, value: any): boolean;
+/**
+ * 刷新组件树信息
+ * 重新遍历应用实例，更新所有组件信息
+ */
+export declare function refreshComponentTree(app: LytApp): void;
+/**
+ * 清除所有记录
+ */
+export declare function clearRecords(): void;
+/**
+ * 断开连接
+ */
+export declare function disconnect(): void;
+/**
+ * 检查是否已连接
+ */
+export declare function isAppConnected(): boolean;
+/**
+ * 获取组件数量
+ */
+export declare function getComponentCount(): number;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Lyt.js DevTools — 主入口
+ *
+ * DevTools 类是开发者工具的主入口，负责：
+ * - 连接到 Lyt.js 应用实例
+ * - 初始化所有子模块（组件树、状态检查器、事件追踪、时间旅行）
+ * - 创建 DevTools 面板 DOM（浮动面板，可拖拽）
+ * - 提供 show() / hide() 切换面板显示
+ *
+ * 使用方式：
+ * ```ts
+ * import { createDevTools } from '@lytjs/devtools'
+ * import { createApp } from '@lytjs/core'
+ *
+ * const app = createApp({ ... })
+ * app.use(createDevTools())
+ * app.mount('#app')
+ * ```
+ *
+ * 纯原生零依赖实现。
+ */
+import { DevToolsPanel } from './panel';
+import { ComponentTreeInspector } from './component-tree';
+import { StateInspector } from './state-inspector';
+import { EventTracker } from './event-tracker';
+import { TimeTravelDebugger } from './time-travel';
+import { type LytApp } from './hooks';
+/** DevTools 配置 */
+export interface DevToolsConfig {
+    /** 面板初始宽度 */
+    width?: number;
+    /** 面板初始高度 */
+    height?: number;
+    /** 面板初始 X 位置 */
+    x?: number;
+    /** 面板初始 Y 位置 */
+    y?: number;
+    /** 是否在启动时自动显示面板 */
+    autoShow?: boolean;
+    /** 面板标题 */
+    title?: string;
+}
+/** Lyt 应用 API 接口（插件系统使用） */
+interface AppAPI {
+    use: (plugin: any, ...options: any[]) => AppAPI;
+    provide: <T = any>(key: string | symbol, value: T) => void;
+    inject: <T = any>(key: string | symbol, defaultValue?: T) => T | undefined;
+    config: Record<string, any>;
+    globalProperties: Record<string, any>;
+}
+/**
+ * Lyt.js 开发者工具
+ *
+ * 提供浏览器端的调试能力，包括组件树检查、状态检查、事件追踪和时间旅行调试。
+ */
+export declare class DevTools {
+    /** 调试面板 */
+    private panel;
+    /** 组件树检查器 */
+    private componentTree;
+    /** 状态检查器 */
+    private stateInspector;
+    /** 事件追踪器 */
+    private eventTracker;
+    /** 时间旅行调试器 */
+    private timeTravel;
+    /** 是否已安装 */
+    private _installed;
+    /** 应用实例引用 */
+    private app;
+    /** 配置 */
+    private config;
+    constructor(config?: DevToolsConfig);
+    /**
+     * 安装到 Lyt.js 应用
+     *
+     * @param app - Lyt.js 应用实例
+     */
+    install(app: LytApp): void;
+    /**
+     * 显示面板
+     */
+    show(): void;
+    /**
+     * 隐藏面板
+     */
+    hide(): void;
+    /**
+     * 切换面板显示状态
+     */
+    toggle(): void;
+    /**
+     * 面板是否可见
+     */
+    isVisible(): boolean;
+    /**
+     * 渲染路由标签页内容
+     * 当前为占位实现，后续可集成 @lytjs/router
+     */
+    private renderRouterTab;
+    /**
+     * 刷新组件树
+     */
+    refreshTree(): void;
+    /**
+     * 清除所有记录（事件和状态变化）
+     */
+    clearAllRecords(): void;
+    /**
+     * 获取面板实例（高级用法）
+     */
+    getPanel(): DevToolsPanel;
+    /**
+     * 获取组件树检查器实例
+     */
+    getComponentTree(): ComponentTreeInspector;
+    /**
+     * 获取状态检查器实例
+     */
+    getStateInspector(): StateInspector;
+    /**
+     * 获取事件追踪器实例
+     */
+    getEventTracker(): EventTracker;
+    /**
+     * 获取时间旅行调试器实例
+     */
+    getTimeTravel(): TimeTravelDebugger;
+    /**
+     * 销毁 DevTools
+     * 清理所有子模块和 DOM 元素
+     */
+    destroy(): void;
+}
+/**
+ * 创建 DevTools 插件
+ *
+ * 返回一个符合 Lyt.js 插件接口的对象，可通过 app.use() 安装。
+ *
+ * @param config - DevTools 配置（可选）
+ * @returns DevTools 插件对象
+ *
+ * @example
+ * ```ts
+ * import { createDevTools } from '@lytjs/devtools'
+ * import { createApp } from '@lytjs/core'
+ *
+ * const app = createApp({ ... })
+ * app.use(createDevTools({ width: 480, height: 640 }))
+ * app.mount('#app')
+ * ```
+ */
+export declare function createDevTools(config?: DevToolsConfig): {
+    install: (app: AppAPI) => void;
+};
+export { DevToolsPanel } from './panel';
+export { ComponentTreeInspector } from './component-tree';
+export { StateInspector } from './state-inspector';
+export { EventTracker } from './event-tracker';
+export { TimeTravelDebugger } from './time-travel';
+export { RoutePanel } from './route-panel';
+export { PerfPanel } from './perf-panel';
+export { PerformanceCollector } from './perf-collector';
+export { ComponentProfiler } from './component-profiler';
+export { EventPanel } from './event-panel';
+export { RouterPanel } from './router-panel-enhanced';
+export { VirtualComponentTree } from './virtual-tree';
+export { MemoryTracker } from './memory-tracker';
+export { RenderTracker } from './render-tracker';
+export { BatchAnalyzer } from './batch-analyzer';
+export { connectToApp, disconnect, getAllComponents, getRootComponent, getComponentById, getChildComponents, getEventRecords, getStateChangeRecords, getComponentStateChanges, getComponentEvents, selectComponent, getSelectedComponent, getSelectedComponentId, setComponentState, refreshComponentTree, clearRecords, isAppConnected, getComponentCount, } from './hooks';
+export type { TabType } from './panel';
+export type { ComponentInfo, EventRecord, StateChangeRecord, DevToolsCallbacks, LytApp, } from './hooks';
+export type { StateSnapshot, } from './time-travel';
+export type { RouteHistoryEntry, RoutePanelConfig, } from './route-panel';
+export type { PerfEntry, EnhancedPerfPanelConfig, } from './perf-panel';
+export type { Metric, FCPMetric, INPMetric, RenderMetric, UpdateFrequencyMetric, MemoryMetric, CustomMarkMetric, FPSMetric, PerformanceReport, } from './perf-collector';
+export type { RenderRecord, ProfileResult, } from './component-profiler';
+export type { CapturedEvent, EventPanelConfig, } from './event-panel';
+export type { RouteLocation, RouteNavigation, RouterPanelConfig, } from './router-panel-enhanced';
+export type { ComponentTreeNode, VirtualTreeOptions, } from './virtual-tree';
+export type { MemorySnapshot, MemoryTrendPoint, MemoryLeakResult, MemoryReport, MemoryTrackerConfig, } from './memory-tracker';
+export type { RenderRecord as RenderTrackerRecord, SlowRenderEntry, RenderComponentStats, RenderStats as RenderTrackerStats, RenderTimelineEntry, RenderTrackerConfig, } from './render-tracker';
+export type { BatchRecord, BatchNameStats, BatchStats, AnomalousBatch, BatchAnalyzerConfig, } from './batch-analyzer';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAOL,KAAK,MAAM,EAGZ,MAAM,SAAS,CAAC;AAMjB,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,UAAU,MAAM;IACd,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3D,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAMD;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,WAAW;IACX,OAAO,CAAC,KAAK,CAAgB;IAC7B,aAAa;IACb,OAAO,CAAC,aAAa,CAAyB;IAC9C,YAAY;IACZ,OAAO,CAAC,cAAc,CAAiB;IACvC,YAAY;IACZ,OAAO,CAAC,YAAY,CAAe;IACnC,cAAc;IACd,OAAO,CAAC,UAAU,CAAqB;IACvC,YAAY;IACZ,OAAO,CAAC,UAAU,CAAkB;IACpC,aAAa;IACb,OAAO,CAAC,GAAG,CAAuB;IAClC,SAAS;IACT,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,CAAC,EAAE,cAAc;IA6DnC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgD1B;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,SAAS,IAAI,OAAO;IAQpB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,gBAAgB,IAAI,sBAAsB;IAI1C;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,aAAa,IAAI,kBAAkB;IAQnC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAYhB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG;IACvD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CA6BA;AASD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,GACP,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,SAAS,EACT,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,YAAY,IAAI,mBAAmB,EACnC,eAAe,EACf,oBAAoB,EACpB,WAAW,IAAI,kBAAkB,EACjC,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/types/memory-tracker.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Lyt.js DevTools - 内存使用追踪器
+ *
+ * 追踪内存使用情况，提供内存趋势分析、泄漏检测和内存报告生成。
+ * 使用环形缓冲区限制内存占用。
+ *
+ * 纯原生零依赖实现。
+ */
+/** 内存快照 */
+export interface MemorySnapshot {
+    /** 快照时间戳 */
+    timestamp: number;
+    /** 已使用堆大小 (bytes) */
+    usedJSHeapSize: number;
+    /** 总堆大小 (bytes) */
+    totalJSHeapSize: number;
+    /** 堆大小上限 (bytes) */
+    jsHeapSizeLimit: number;
+    /** 快照序号 */
+    index: number;
+}
+/** 内存趋势数据点 */
+export interface MemoryTrendPoint {
+    /** 时间戳 */
+    timestamp: number;
+    /** 已使用堆大小 (bytes) */
+    usedJSHeapSize: number;
+    /** 与前一个快照的变化量 (bytes) */
+    delta: number;
+    /** 使用率百分比 (0-100) */
+    usagePercent: number;
+}
+/** 内存泄漏检测结果 */
+export interface MemoryLeakResult {
+    /** 是否存在可能的内存泄漏 */
+    hasLeak: boolean;
+    /** 泄漏严重程度: 'none' | 'low' | 'medium' | 'high' */
+    severity: 'none' | 'low' | 'medium' | 'high';
+    /** 泄漏描述 */
+    description: string;
+    /** 分析的快照数量 */
+    snapshotCount: number;
+    /** 增长速率 (bytes/s) */
+    growthRate: number;
+    /** 线性回归 R^2 值（越接近 1 越可能是线性增长） */
+    rSquared: number;
+}
+/** 内存报告 */
+export interface MemoryReport {
+    /** 报告生成时间 */
+    generatedAt: number;
+    /** 当前快照 */
+    current: MemorySnapshot | null;
+    /** 峰值使用量 (bytes) */
+    peakUsage: number;
+    /** 峰值使用量时间戳 */
+    peakTimestamp: number;
+    /** 平均使用量 (bytes) */
+    averageUsage: number;
+    /** 最低使用量 (bytes) */
+    minUsage: number;
+    /** 总增长量 (bytes)，第一个快照到最后一个快照 */
+    totalGrowth: number;
+    /** 趋势数据 */
+    trend: MemoryTrendPoint[];
+    /** 泄漏检测结果 */
+    leakDetection: MemoryLeakResult;
+    /** 快照总数 */
+    snapshotCount: number;
+}
+/** 内存追踪器配置 */
+export interface MemoryTrackerConfig {
+    /** 环形缓冲区容量，默认 100 */
+    bufferSize?: number;
+    /** 泄漏检测的增长速率阈值 (bytes/s)，默认 1024 */
+    leakGrowthThreshold?: number;
+    /** 泄漏检测的 R^2 阈值，默认 0.7 */
+    leakRSquaredThreshold?: number;
+    /** 泄漏检测所需最少快照数，默认 5 */
+    leakMinSnapshots?: number;
+}
+/**
+ * 内存使用追踪器
+ *
+ * 追踪内存使用情况，提供趋势分析、泄漏检测和报告生成。
+ */
+export declare class MemoryTracker {
+    /** 内存快照缓冲区 */
+    private snapshots;
+    /** 快照计数器（单调递增） */
+    private counter;
+    /** 配置 */
+    private readonly config;
+    constructor(config?: MemoryTrackerConfig);
+    /**
+     * 记录内存快照
+     *
+     * 如果浏览器支持 performance.memory，则自动采集；
+     * 否则使用传入的值或返回 null。
+     *
+     * @param usedJSHeapSize - 已使用堆大小 (bytes)，可选
+     * @param totalJSHeapSize - 总堆大小 (bytes)，可选
+     * @param jsHeapSizeLimit - 堆大小上限 (bytes)，可选
+     * @returns 记录的快照，如果无法获取内存信息则返回 null
+     */
+    trackMemoryUsage(usedJSHeapSize?: number, totalJSHeapSize?: number, jsHeapSizeLimit?: number, timestamp?: number): MemorySnapshot | null;
+    /**
+     * 获取内存趋势数据
+     *
+     * @returns 趋势数据点数组
+     */
+    getMemoryTrend(): MemoryTrendPoint[];
+    /**
+     * 检测可能的内存泄漏
+     *
+     * 使用线性回归分析内存增长趋势，结合增长速率判断是否存在泄漏。
+     *
+     * @returns 泄漏检测结果
+     */
+    detectMemoryLeak(): MemoryLeakResult;
+    /**
+     * 生成内存报告
+     *
+     * @returns 内存报告
+     */
+    getMemoryReport(): MemoryReport;
+    /**
+     * 获取所有快照
+     *
+     * @returns 快照数组
+     */
+    getSnapshots(): MemorySnapshot[];
+    /**
+     * 获取快照数量
+     *
+     * @returns 快照数量
+     */
+    getSnapshotCount(): number;
+    /**
+     * 清除所有快照
+     */
+    clear(): void;
+    /**
+     * 销毁追踪器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=memory-tracker.d.ts.map

package/dist/types/memory-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tracker.d.ts","sourceRoot":"","sources":["../../src/memory-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,cAAc;AACd,MAAM,WAAW,gBAAgB;IAC/B,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,aAAa;IACb,aAAa,EAAE,gBAAgB,CAAC;IAChC,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,cAAc;IACd,OAAO,CAAC,SAAS,CAA6B;IAC9C,kBAAkB;IAClB,OAAO,CAAC,OAAO,CAAa;IAC5B,SAAS;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,MAAM,CAAC,EAAE,mBAAmB;IAcxC;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,cAAc,CAAC,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,EACxB,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI;IA2BxB;;;;OAIG;IACH,cAAc,IAAI,gBAAgB,EAAE;IAqBpC;;;;;;OAMG;IACH,gBAAgB,IAAI,gBAAgB;IAmFpC;;;;OAIG;IACH,eAAe,IAAI,YAAY;IAmD/B;;;;OAIG;IACH,YAAY,IAAI,cAAc,EAAE;IAIhC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}