@lytjs/devtools 4.0.5 → 4.1.0

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

@@ -0,0 +1,147 @@
+/**
+ * Lyt.js DevTools - 组件渲染追踪器
+ *
+ * 追踪组件渲染耗时，提供慢渲染检测、渲染统计和渲染时间线。
+ * 使用环形缓冲区限制内存占用。
+ *
+ * 纯原生零依赖实现。
+ */
+/** 渲染记录 */
+export interface RenderRecord {
+    /** 组件名称 */
+    componentName: string;
+    /** 渲染耗时 (ms) */
+    duration: number;
+    /** 渲染时间戳 */
+    timestamp: number;
+    /** 记录序号 */
+    index: number;
+}
+/** 慢渲染条目 */
+export interface SlowRenderEntry {
+    /** 组件名称 */
+    componentName: string;
+    /** 渲染耗时 (ms) */
+    duration: number;
+    /** 渲染时间戳 */
+    timestamp: number;
+    /** 超出阈值的量 (ms) */
+    overThreshold: number;
+}
+/** 渲染统计（按组件分组） */
+export interface RenderComponentStats {
+    /** 组件名称 */
+    componentName: string;
+    /** 渲染次数 */
+    renderCount: number;
+    /** 平均渲染耗时 (ms) */
+    avgDuration: number;
+    /** 最大渲染耗时 (ms) */
+    maxDuration: number;
+    /** 最小渲染耗时 (ms) */
+    minDuration: number;
+    /** 总渲染耗时 (ms) */
+    totalDuration: number;
+    /** 慢渲染次数 */
+    slowCount: number;
+}
+/** 整体渲染统计 */
+export interface RenderStats {
+    /** 总渲染次数 */
+    totalRenders: number;
+    /** 总渲染耗时 (ms) */
+    totalDuration: number;
+    /** 平均渲染耗时 (ms) */
+    avgDuration: number;
+    /** 最大渲染耗时 (ms) */
+    maxDuration: number;
+    /** 最小渲染耗时 (ms) */
+    minDuration: number;
+    /** 慢渲染次数 */
+    slowRenderCount: number;
+    /** 慢渲染占比 (0-1) */
+    slowRenderRatio: number;
+    /** 按组件分组的统计 */
+    byComponent: RenderComponentStats[];
+}
+/** 渲染时间线条目 */
+export interface RenderTimelineEntry {
+    /** 组件名称 */
+    componentName: string;
+    /** 渲染耗时 (ms) */
+    duration: number;
+    /** 渲染时间戳 */
+    timestamp: number;
+    /** 是否为慢渲染 */
+    isSlow: boolean;
+    /** 与前一次渲染的间隔 (ms)，第一条为 -1 */
+    gap: number;
+}
+/** 渲染追踪器配置 */
+export interface RenderTrackerConfig {
+    /** 环形缓冲区容量，默认 200 */
+    bufferSize?: number;
+    /** 慢渲染阈值 (ms)，默认 16 */
+    slowThreshold?: number;
+}
+/**
+ * 组件渲染追踪器
+ *
+ * 追踪组件渲染耗时，提供慢渲染检测、渲染统计和渲染时间线。
+ */
+export declare class RenderTracker {
+    /** 渲染记录缓冲区 */
+    private records;
+    /** 记录计数器（单调递增） */
+    private counter;
+    /** 配置 */
+    private readonly config;
+    constructor(config?: RenderTrackerConfig);
+    /**
+     * 记录一次渲染
+     *
+     * @param componentName - 组件名称
+     * @param duration - 渲染耗时 (ms)
+     */
+    trackRender(componentName: string, duration: number): void;
+    /**
+     * 获取慢渲染组件列表
+     *
+     * @param threshold - 慢渲染阈值 (ms)，默认使用配置值
+     * @returns 慢渲染条目数组，按耗时降序排列
+     */
+    getSlowRenderers(threshold?: number): SlowRenderEntry[];
+    /**
+     * 获取渲染统计
+     *
+     * @returns 渲染统计信息
+     */
+    getRenderStats(): RenderStats;
+    /**
+     * 获取渲染时间线
+     *
+     * @returns 渲染时间线条目数组
+     */
+    getRenderTimeline(): RenderTimelineEntry[];
+    /**
+     * 获取所有渲染记录
+     *
+     * @returns 渲染记录数组
+     */
+    getRecords(): RenderRecord[];
+    /**
+     * 获取记录数量
+     *
+     * @returns 记录数量
+     */
+    getRecordCount(): number;
+    /**
+     * 清除所有记录
+     */
+    clear(): void;
+    /**
+     * 销毁追踪器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=render-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render-tracker.d.ts","sourceRoot":"","sources":["../../src/render-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kBAAkB;AAClB,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,cAAc;IACd,OAAO,CAAC,OAAO,CAA2B;IAC1C,kBAAkB;IAClB,OAAO,CAAC,OAAO,CAAa;IAC5B,SAAS;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,MAAM,CAAC,EAAE,mBAAmB;IAYxC;;;;;OAKG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS1D;;;;;OAKG;IACH,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAevD;;;;OAIG;IACH,cAAc,IAAI,WAAW;IAkF7B;;;;OAIG;IACH,iBAAiB,IAAI,mBAAmB,EAAE;IAiB1C;;;;OAIG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/types/route-panel.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Lyt.js DevTools 路由面板
+ * 显示当前路由信息和导航历史
+ */
+/** 路由历史记录条目 */
+export interface RouteHistoryEntry {
+    /** 路由路径 */
+    path: string;
+    /** 路由参数 */
+    params?: Record<string, string>;
+    /** 查询参数 */
+    query?: Record<string, string>;
+    /** 导航时间戳 */
+    timestamp: number;
+}
+/** 路由面板配置 */
+export interface RoutePanelConfig {
+    /** 最大历史记录条数 */
+    maxHistory?: number;
+}
+/**
+ * 路由面板
+ *
+ * 显示当前路由信息和导航历史列表，
+ * 帮助开发者调试路由相关的问题。
+ */
+export declare class RoutePanel {
+    private container;
+    private history;
+    private maxHistory;
+    private currentPath;
+    private currentParams;
+    private currentQuery;
+    constructor(container: HTMLElement, config?: RoutePanelConfig);
+    /**
+     * 更新当前路由信息
+     *
+     * @param path - 路由路径
+     * @param params - 路由参数
+     * @param query - 查询参数
+     */
+    updateRoute(path: string, params?: Record<string, string>, query?: Record<string, string>): void;
+    /**
+     * 获取路由历史记录
+     *
+     * @returns 历史记录数组（最新在前）
+     */
+    getHistory(): RouteHistoryEntry[];
+    /**
+     * 获取当前路由路径
+     *
+     * @returns 当前路径
+     */
+    getCurrentPath(): string;
+    /**
+     * 清除历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 渲染路由面板 UI
+     */
+    private render;
+    /**
+     * 销毁面板，清理 DOM
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=route-panel.d.ts.map

package/dist/types/route-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-panel.d.ts","sourceRoot":"","sources":["../../src/route-panel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAe;AACf,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,YAAY;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,YAAY,CAA6B;gBAErC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAM7D;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAsBhG;;;;OAIG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAIjC;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,OAAO,CAAC,MAAM;IA4Gd;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/types/router-panel-enhanced.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Lyt.js DevTools — 路由面板（增强版）
+ *
+ * 独立的路由检查器，展示当前路由信息、导航历史和路由匹配信息。
+ * 支持历史记录查看、详情展示等功能。
+ *
+ * 纯原生零依赖实现。
+ */
+/** 路由位置信息 */
+export interface RouteLocation {
+    /** 路由路径 */
+    path: string;
+    /** 路由参数 */
+    params?: Record<string, string>;
+    /** 查询参数 */
+    query?: Record<string, string>;
+    /** 哈希 */
+    hash?: string;
+    /** 路由名称 */
+    name?: string;
+    /** 是否完全匹配 */
+    matched?: boolean;
+}
+/** 路由导航记录 */
+export interface RouteNavigation {
+    /** 导航序号 */
+    index: number;
+    /** 目标路由 */
+    to: RouteLocation;
+    /** 来源路由 */
+    from: RouteLocation;
+    /** 导航时间戳 */
+    timestamp: number;
+    /** 导航类型 */
+    type: 'push' | 'replace' | 'pop';
+}
+/** 路由面板配置 */
+export interface RouterPanelConfig {
+    /** 最大历史记录条数，默认 50 */
+    maxHistory?: number;
+    /** 面板标题，默认 "路由面板" */
+    title?: string;
+}
+/**
+ * 路由面板
+ *
+ * 展示当前路由信息、导航历史和路由匹配信息。
+ */
+export declare class RouterPanel {
+    /** 当前路由 */
+    private currentRoute;
+    /** 导航历史 */
+    private history;
+    /** 最大历史记录条数 */
+    private maxHistory;
+    /** 面板标题 */
+    private title;
+    /** 导航计数器 */
+    private navCounter;
+    /** DOM 根元素 */
+    private element;
+    /** 选中的历史条目索引 */
+    private selectedHistoryIndex;
+    constructor(config?: RouterPanelConfig);
+    /**
+     * 路由变化回调
+     *
+     * @param to - 目标路由
+     * @param from - 来源路由
+     * @param type - 导航类型
+     */
+    onRouteChange(to: RouteLocation, from: RouteLocation, type?: 'push' | 'replace' | 'pop'): void;
+    /**
+     * 获取当前路由
+     *
+     * @returns 当前路由信息，如果没有则为 null
+     */
+    getCurrentRoute(): RouteLocation | null;
+    /**
+     * 获取导航历史
+     *
+     * @returns 导航历史数组
+     */
+    getHistory(): RouteNavigation[];
+    /**
+     * 清除导航历史
+     */
+    clearHistory(): void;
+    /**
+     * 获取历史记录条数
+     */
+    getHistoryCount(): number;
+    /**
+     * 获取最大历史记录条数
+     */
+    getMaxHistory(): number;
+    /**
+     * 选中某条历史记录
+     *
+     * @param index - 历史记录在 getHistory() 返回数组中的索引
+     */
+    selectHistoryEntry(index: number): void;
+    /**
+     * 获取选中的历史记录
+     */
+    getSelectedHistoryEntry(): RouteNavigation | null;
+    /**
+     * 渲染面板 DOM 元素
+     *
+     * @returns 面板 DOM 元素
+     */
+    render(): HTMLElement;
+    /**
+     * 销毁面板
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=router-panel-enhanced.d.ts.map

package/dist/types/router-panel-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-panel-enhanced.d.ts","sourceRoot":"","sources":["../../src/router-panel-enhanced.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,EAAE,EAAE,aAAa,CAAC;IAClB,WAAW;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;CAClC;AAED,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,WAAW;IACX,OAAO,CAAC,YAAY,CAA8B;IAClD,WAAW;IACX,OAAO,CAAC,OAAO,CAAyB;IACxC,eAAe;IACf,OAAO,CAAC,UAAU,CAAS;IAC3B,WAAW;IACX,OAAO,CAAC,KAAK,CAAS;IACtB,YAAY;IACZ,OAAO,CAAC,UAAU,CAAa;IAC/B,cAAc;IACd,OAAO,CAAC,OAAO,CAA4B;IAC3C,gBAAgB;IAChB,OAAO,CAAC,oBAAoB,CAAc;gBAE9B,MAAM,CAAC,EAAE,iBAAiB;IAStC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI;IAoB9F;;;;OAIG;IACH,eAAe,IAAI,aAAa,GAAG,IAAI;IAIvC;;;;OAIG;IACH,UAAU,IAAI,eAAe,EAAE;IAQ/B;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,uBAAuB,IAAI,eAAe,GAAG,IAAI;IAgBjD;;;;OAIG;IACH,MAAM,IAAI,WAAW;IA8JrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/dist/types/state-inspector.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Lyt.js DevTools — 状态检查器
+ *
+ * 显示和编辑当前选中组件的完整状态，包括 props、state、computed。
+ * 支持嵌套对象展开/折叠、实时更新高亮、双击编辑和变化历史记录。
+ *
+ * 核心功能：
+ * - StateInspector 类
+ * - 显示当前选中组件的完整状态（props/state/computed）
+ * - 状态值可展开/折叠（支持嵌套对象）
+ * - 状态变化实时更新（高亮变化的属性）
+ * - 手动编辑状态值（双击编辑）
+ * - 状态变化历史记录
+ *
+ * 纯原生零依赖实现。
+ */
+import type { DevToolsPanel } from './panel';
+/**
+ * 状态检查器
+ *
+ * 负责显示和编辑组件的 props、state、computed 状态。
+ */
+export declare class StateInspector {
+    /** 面板引用 */
+    private panel;
+    /** 当前内容容器 */
+    private container;
+    /** 展开的路径集合 */
+    private expandedPaths;
+    /** 最近变化的属性路径（用于高亮） */
+    private changedPaths;
+    /** 高亮清除定时器 */
+    private highlightTimer;
+    /** 当前显示历史记录模式 */
+    private showHistory;
+    /** 更新定时器 */
+    private updateTimer;
+    constructor(panel: DevToolsPanel);
+    /**
+     * 渲染状态检查器到指定容器
+     */
+    render(container: HTMLElement): void;
+    /**
+     * 渲染状态内容
+     */
+    private renderState;
+    /**
+     * 渲染状态分类区块
+     */
+    private renderCategory;
+    /**
+     * 渲染单个属性
+     */
+    private renderProperty;
+    /**
+     * 开始编辑状态值
+     */
+    private startEdit;
+    /**
+     * 渲染状态变化历史
+     */
+    private renderHistory;
+    /**
+     * 全局更新事件处理
+     */
+    private onUpdate;
+    /**
+     * 标记属性变化（用于高亮）
+     */
+    markChanged(path: string): void;
+    /**
+     * 强制刷新
+     */
+    refresh(): void;
+    /**
+     * 销毁检查器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=state-inspector.d.ts.map

package/dist/types/state-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-inspector.d.ts","sourceRoot":"","sources":["../../src/state-inspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA8F7C;;;;GAIG;AACH,qBAAa,cAAc;IACzB,WAAW;IACX,OAAO,CAAC,KAAK,CAAgB;IAC7B,aAAa;IACb,OAAO,CAAC,SAAS,CAA4B;IAC7C,cAAc;IACd,OAAO,CAAC,aAAa,CAAoC;IACzD,sBAAsB;IACtB,OAAO,CAAC,YAAY,CAA6B;IACjD,cAAc;IACd,OAAO,CAAC,cAAc,CAA8C;IACpE,iBAAiB;IACjB,OAAO,CAAC,WAAW,CAAkB;IACrC,YAAY;IACZ,OAAO,CAAC,WAAW,CAA8C;gBAErD,KAAK,EAAE,aAAa;IAahC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0EnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkEtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0JtB;;OAEG;IACH,OAAO,CAAC,SAAS;IA+FjB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0DrB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAOd;IAEF;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa/B;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB"}

package/dist/types/time-travel.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Lyt.js DevTools — 时间旅行调试
+ *
+ * 提供状态快照系统和时间轴控件，支持回到任意历史时间点查看和恢复状态。
+ *
+ * 核心功能：
+ * - TimeTravelDebugger 类
+ * - 状态快照系统（每次状态变化时保存快照）
+ * - 快照包含完整的组件状态树
+ * - 最多保存 100 个快照（内存限制）
+ * - 时间轴控件（滑块拖拽、播放/暂停、步进按钮）
+ * - 回到历史时间点时恢复状态并重新渲染
+ * - 快照列表显示
+ *
+ * 纯原生零依赖实现。
+ */
+import { type StateChangeRecord } from './hooks';
+import type { DevToolsPanel } from './panel';
+/** 状态快照 */
+export interface StateSnapshot {
+    /** 快照唯一 ID */
+    id: number;
+    /** 快照时间戳 */
+    timestamp: number;
+    /** 快照描述 */
+    description: string;
+    /** 所有组件的状态快照 */
+    components: Map<string, ComponentSnapshot>;
+    /** 触发此快照的状态变化记录（可选） */
+    trigger?: StateChangeRecord;
+}
+/** 单个组件的状态快照 */
+interface ComponentSnapshot {
+    /** 组件 ID */
+    id: string;
+    /** 组件名称 */
+    name: string;
+    /** 组件 state 深拷贝 */
+    state: Record<string, any>;
+    /** 组件 props 深拷贝 */
+    props: Record<string, any>;
+    /** 组件 computed 深拷贝 */
+    computed: Record<string, any>;
+    /** 是否已挂载 */
+    isMounted: boolean;
+}
+/** 播放状态 */
+type PlayState = 'stopped' | 'playing' | 'paused';
+/**
+ * 时间旅行调试器
+ *
+ * 通过状态快照系统记录应用状态变化历史，
+ * 提供时间轴控件让开发者回到任意时间点查看状态。
+ */
+export declare class TimeTravelDebugger {
+    /** 面板引用 */
+    private panel;
+    /** 当前内容容器 */
+    private container;
+    /** 快照列表 */
+    private snapshots;
+    /** 快照 ID 计数器 */
+    private snapshotCounter;
+    /** 最大快照数量 */
+    private maxSnapshots;
+    /** 当前查看的快照索引（-1 表示当前实时状态） */
+    private currentIndex;
+    /** 播放状态 */
+    private playState;
+    /** 播放速度（毫秒/步） */
+    private playSpeed;
+    /** 播放定时器 */
+    private playTimer;
+    /** 是否启用自动快照 */
+    private autoSnapshot;
+    /** 更新定时器 */
+    private updateTimer;
+    constructor(panel: DevToolsPanel);
+    /**
+     * 创建状态快照
+     *
+     * @param description - 快照描述
+     * @param trigger - 触发此快照的状态变化记录
+     */
+    takeSnapshot(description?: string, trigger?: StateChangeRecord): StateSnapshot;
+    /**
+     * 获取所有快照
+     */
+    getSnapshots(): StateSnapshot[];
+    /**
+     * 获取指定索引的快照
+     */
+    getSnapshot(index: number): StateSnapshot | null;
+    /**
+     * 获取当前快照索引
+     */
+    getCurrentIndex(): number;
+    /**
+     * 清空所有快照
+     */
+    clearSnapshots(): void;
+    /**
+     * 设置自动快照开关
+     */
+    setAutoSnapshot(enabled: boolean): void;
+    /**
+     * 跳转到指定快照
+     *
+     * @param index - 快照索引
+     */
+    travelTo(index: number): void;
+    /**
+     * 跳转到上一个快照
+     */
+    stepBack(): void;
+    /**
+     * 跳转到下一个快照
+     */
+    stepForward(): void;
+    /**
+     * 跳转到最新状态（实时）
+     */
+    goToLatest(): void;
+    /**
+     * 恢复指定快照的状态到实际组件
+     *
+     * 注意：这是一个破坏性操作，会修改组件的实际状态。
+     */
+    restoreSnapshot(index: number): boolean;
+    /**
+     * 开始自动回放
+     */
+    startPlayback(): void;
+    /**
+     * 暂停回放
+     */
+    pausePlayback(): void;
+    /**
+     * 停止回放
+     */
+    stopPlayback(): void;
+    /**
+     * 设置播放速度
+     */
+    setPlaySpeed(speed: number): void;
+    /**
+     * 获取播放状态
+     */
+    getPlayState(): PlayState;
+    /**
+     * 渲染时间旅行调试器到指定容器
+     */
+    render(container: HTMLElement): void;
+    /**
+     * 渲染时间旅行内容
+     */
+    private renderTimeTravel;
+    /**
+     * 渲染播放控制栏
+     */
+    private renderPlaybackControls;
+    /**
+     * 渲染快照列表
+     */
+    private renderSnapshotList;
+    /**
+     * 创建按钮样式
+     */
+    private createButtonStyle;
+    /**
+     * 创建小按钮样式
+     */
+    private createSmallButtonStyle;
+    /**
+     * 全局更新事件处理
+     * 自动创建快照
+     */
+    private onUpdate;
+    /**
+     * 强制刷新
+     */
+    refresh(): void;
+    /**
+     * 销毁调试器
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=time-travel.d.ts.map

package/dist/types/time-travel.d.ts.map

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