@lytjs/devtools 4.0.5 → 4.1.0

package/dist/types/component-profiler.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Lyt.js DevTools - 组件性能分析器
+ *
+ * 对单个组件进行详细的性能分析，追踪：
+ * - 渲染次数
+ * - 平均渲染时间
+ * - 最大渲染时间
+ * - 总渲染时间
+ * - 慢渲染自动检测（>16ms）
+ *
+ * 纯原生零依赖实现。
+ */
+/** 单次渲染记录 */
+export interface RenderRecord {
+    /** 渲染耗时 (ms) */
+    duration: number;
+    /** 渲染时间戳 */
+    timestamp: number;
+    /** 是否为慢渲染 (>16ms) */
+    isSlow: boolean;
+}
+/** 组件分析结果 */
+export interface ProfileResult {
+    /** 组件名称 */
+    componentName: string;
+    /** 渲染次数 */
+    renderCount: number;
+    /** 平均渲染时间 (ms) */
+    avgRenderTime: number;
+    /** 最大渲染时间 (ms) */
+    maxRenderTime: number;
+    /** 最小渲染时间 (ms) */
+    minRenderTime: number;
+    /** 总渲染时间 (ms) */
+    totalRenderTime: number;
+    /** 慢渲染次数 */
+    slowRenderCount: number;
+    /** 慢渲染阈值 (ms) */
+    slowThreshold: number;
+    /** 所有渲染记录 */
+    records: RenderRecord[];
+    /** 分析持续时间 (ms) */
+    profileDuration: number;
+}
+/**
+ * 组件性能分析器
+ *
+ * 对指定组件进行性能分析，自动检测慢渲染。
+ * 支持同时分析多个组件。
+ */
+export declare class ComponentProfiler {
+    /** 活跃的分析会话映射（组件名 -> 会话） */
+    private activeProfiles;
+    /** 慢渲染阈值 (ms) */
+    private slowThreshold;
+    constructor(slowThreshold?: number);
+    /**
+     * 开始分析指定组件
+     *
+     * @param componentName - 组件名称
+     * @returns 是否成功开始（如果已经在分析中则返回 false）
+     */
+    startProfile(componentName: string): boolean;
+    /**
+     * 停止分析指定组件并返回结果
+     *
+     * @param componentName - 组件名称
+     * @returns 分析结果，如果组件未被分析则返回 null
+     */
+    stopProfile(componentName: string): ProfileResult | null;
+    /**
+     * 停止所有分析并返回所有结果
+     *
+     * @returns 所有分析结果数组
+     */
+    stopAllProfiles(): ProfileResult[];
+    /**
+     * 记录一次组件渲染
+     *
+     * 如果组件正在被分析中，则记录此次渲染。
+     *
+     * @param componentName - 组件名称
+     * @param duration - 渲染耗时 (ms)
+     */
+    recordRender(componentName: string, duration: number): void;
+    /**
+     * 获取指定组件的当前分析快照（不停止分析）
+     *
+     * @param componentName - 组件名称
+     * @returns 当前分析快照，如果组件未被分析则返回 null
+     */
+    getSnapshot(componentName: string): ProfileResult | null;
+    /**
+     * 检查指定组件是否正在被分析
+     *
+     * @param componentName - 组件名称
+     * @returns 是否正在分析中
+     */
+    isProfiling(componentName: string): boolean;
+    /**
+     * 获取所有正在分析的组件名称
+     *
+     * @returns 组件名称数组
+     */
+    getActiveProfileNames(): string[];
+    /**
+     * 获取正在分析的组件数量
+     *
+     * @returns 组件数量
+     */
+    getActiveProfileCount(): number;
+    /**
+     * 获取指定组件的慢渲染列表（仅当前活跃分析中的）
+     *
+     * @param componentName - 组件名称
+     * @returns 慢渲染记录数组
+     */
+    getSlowRenders(componentName: string): RenderRecord[];
+    /**
+     * 设置慢渲染阈值
+     *
+     * @param threshold - 新的阈值 (ms)
+     */
+    setSlowThreshold(threshold: number): void;
+    /**
+     * 获取当前慢渲染阈值
+     *
+     * @returns 阈值 (ms)
+     */
+    getSlowThreshold(): number;
+    /**
+     * 清除所有分析数据
+     */
+    clear(): void;
+    /**
+     * 销毁分析器
+     */
+    destroy(): void;
+    /**
+     * 从分析会话构建结果对象
+     */
+    private buildResult;
+}
+//# sourceMappingURL=component-profiler.d.ts.map

package/dist/types/component-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-profiler.d.ts","sourceRoot":"","sources":["../../src/component-profiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAA;CACxB;AAqBD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,2BAA2B;IAC3B,OAAO,CAAC,cAAc,CAAwC;IAE9D,iBAAiB;IACjB,OAAO,CAAC,aAAa,CAAQ;gBAEjB,aAAa,GAAE,MAA+B;IAQ1D;;;;;OAKG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAe5C;;;;;OAKG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAWxD;;;;OAIG;IACH,eAAe,IAAI,aAAa,EAAE;IAelC;;;;;;;OAOG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa3D;;;;;OAKG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAaxD;;;;;OAKG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;OAIG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;;;OAIG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;;;;OAKG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,EAAE;IAUrD;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAYzC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,WAAW;CAuBpB"}

package/dist/types/component-tree.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Lyt.js DevTools — 组件树检查器
+ *
+ * 遍历应用组件树，生成可视化的树形结构，支持组件选择、搜索过滤和高亮。
+ *
+ * 核心功能：
+ * - ComponentTreeInspector 类
+ * - 遍历应用组件树，生成树形结构
+ * - 显示每个组件的名称、状态数量、是否有更新、渲染耗时
+ * - 点击组件节点显示详情
+ * - 高亮选中组件（给对应 DOM 元素加边框）
+ * - 组件搜索/过滤功能
+ *
+ * 纯原生零依赖实现。
+ */
+import type { DevToolsPanel } from './panel';
+/** 组件选中回调 */
+type ComponentSelectCallback = (componentId: string | null) => void;
+/**
+ * 组件树检查器
+ *
+ * 负责渲染和管理组件树视图，包括搜索、过滤、选择等功能。
+ */
+export declare class ComponentTreeInspector {
+    /** 面板引用 */
+    private panel;
+    /** 组件选中回调 */
+    private onSelect;
+    /** 搜索关键词 */
+    private searchKeyword;
+    /** 展开的节点 ID 集合 */
+    private expandedNodes;
+    /** 当前内容容器 */
+    private container;
+    /** 更新定时器 */
+    private updateTimer;
+    constructor(panel: DevToolsPanel, onSelect?: ComponentSelectCallback);
+    /**
+     * 渲染组件树到指定容器
+     */
+    render(container: HTMLElement): void;
+    /**
+     * 渲染完整组件树
+     */
+    private renderTree;
+    /**
+     * 构建组件树形数据结构
+     */
+    private buildTree;
+    /**
+     * 渲染单个树节点
+     */
+    private renderTreeNode;
+    /**
+     * 全局更新事件处理
+     * 使用防抖避免频繁更新
+     */
+    private onUpdate;
+    /**
+     * 强制刷新组件树
+     */
+    refresh(): void;
+    /**
+     * 销毁检查器
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=component-tree.d.ts.map

package/dist/types/component-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-tree.d.ts","sourceRoot":"","sources":["../../src/component-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAkB7C,aAAa;AACb,KAAK,uBAAuB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAMpE;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,WAAW;IACX,OAAO,CAAC,KAAK,CAAgB;IAC7B,aAAa;IACb,OAAO,CAAC,QAAQ,CAA0B;IAC1C,YAAY;IACZ,OAAO,CAAC,aAAa,CAAc;IACnC,kBAAkB;IAClB,OAAO,CAAC,aAAa,CAAqB;IAC1C,aAAa;IACb,OAAO,CAAC,SAAS,CAA4B;IAC7C,YAAY;IACZ,OAAO,CAAC,WAAW,CAA8C;gBAErD,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,uBAAuB;IAoBpE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,UAAU;IA6ClB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuCjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyLtB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAOd;IAEF;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,IAAI,IAAI;CAShB"}

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

@@ -0,0 +1,129 @@
+/**
+ * Lyt.js DevTools — 事件面板
+ *
+ * 独立的事件检查器，捕获和展示组件事件（emit 调用）。
+ * 支持过滤、暂停/恢复、环形缓冲区、导出 JSON 等功能。
+ *
+ * 纯原生零依赖实现。
+ */
+/** 捕获的事件 */
+export interface CapturedEvent {
+    /** 事件名称 */
+    name: string;
+    /** 事件载荷 */
+    payload: any;
+    /** 来源组件 */
+    sourceComponent?: string;
+    /** 捕获时间戳 */
+    timestamp: number;
+    /** 事件序号 */
+    index: number;
+}
+/** 事件面板配置 */
+export interface EventPanelConfig {
+    /** 最大缓冲区大小（环形缓冲区），默认 200 */
+    maxBuffer?: number;
+    /** 是否自动滚动到最新事件，默认 true */
+    autoScroll?: boolean;
+    /** 面板标题，默认 "事件面板" */
+    title?: string;
+}
+/**
+ * 事件面板
+ *
+ * 捕获和展示组件事件，支持过滤、暂停/恢复、环形缓冲区和导出。
+ */
+export declare class EventPanel {
+    /** 事件缓冲区 */
+    private buffer;
+    /** 最大缓冲区大小 */
+    private maxBuffer;
+    /** 是否自动滚动 */
+    private autoScroll;
+    /** 面板标题 */
+    private title;
+    /** 是否暂停 */
+    private _paused;
+    /** 过滤模式 */
+    private filterPattern;
+    /** 事件计数器（单调递增） */
+    private counter;
+    /** 环形缓冲区写入位置 */
+    private writeIndex;
+    /** 缓冲区是否已满 */
+    private bufferFull;
+    /** DOM 根元素 */
+    private element;
+    constructor(config?: EventPanelConfig);
+    /**
+     * 捕获一个事件
+     *
+     * @param name - 事件名称
+     * @param payload - 事件载荷
+     * @param sourceComponent - 来源组件名称（可选）
+     */
+    captureEvent(name: string, payload: any, sourceComponent?: string): void;
+    /**
+     * 获取所有事件（经过过滤）
+     *
+     * @returns 过滤后的事件数组
+     */
+    getEvents(): CapturedEvent[];
+    /**
+     * 获取所有事件（不经过过滤）
+     *
+     * @returns 全部事件数组
+     */
+    getAllEvents(): CapturedEvent[];
+    /**
+     * 清除所有事件
+     */
+    clear(): void;
+    /**
+     * 设置过滤模式
+     *
+     * @param pattern - 过滤字符串
+     */
+    setFilter(pattern: string): void;
+    /**
+     * 获取当前过滤模式
+     */
+    getFilter(): string;
+    /**
+     * 暂停事件捕获
+     */
+    pause(): void;
+    /**
+     * 恢复事件捕获
+     */
+    resume(): void;
+    /**
+     * 是否暂停中
+     */
+    isPaused(): boolean;
+    /**
+     * 导出事件为 JSON 字符串
+     *
+     * @returns JSON 字符串
+     */
+    exportJSON(): string;
+    /**
+     * 获取缓冲区中的事件总数
+     */
+    getCount(): number;
+    /**
+     * 获取最大缓冲区大小
+     */
+    getMaxBuffer(): number;
+    /**
+     * 渲染面板 DOM 元素
+     *
+     * @returns 面板 DOM 元素
+     */
+    render(): HTMLElement;
+    /**
+     * 销毁面板
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=event-panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-panel.d.ts","sourceRoot":"","sources":["../../src/event-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,OAAO,EAAE,GAAG,CAAC;IACb,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,YAAY;IACZ,OAAO,CAAC,MAAM,CAAuB;IACrC,cAAc;IACd,OAAO,CAAC,SAAS,CAAS;IAC1B,aAAa;IACb,OAAO,CAAC,UAAU,CAAU;IAC5B,WAAW;IACX,OAAO,CAAC,KAAK,CAAS;IACtB,WAAW;IACX,OAAO,CAAC,OAAO,CAAkB;IACjC,WAAW;IACX,OAAO,CAAC,aAAa,CAAc;IACnC,kBAAkB;IAClB,OAAO,CAAC,OAAO,CAAa;IAC5B,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAa;IAC/B,cAAc;IACd,OAAO,CAAC,UAAU,CAAkB;IACpC,cAAc;IACd,OAAO,CAAC,OAAO,CAA4B;gBAE/B,MAAM,CAAC,EAAE,gBAAgB;IAUrC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBxE;;;;OAIG;IACH,SAAS,IAAI,aAAa,EAAE;IAiB5B;;;;OAIG;IACH,YAAY,IAAI,aAAa,EAAE;IAM/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAKpB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,YAAY,IAAI,MAAM;IAQtB;;;;OAIG;IACH,MAAM,IAAI,WAAW;IAkIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

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

@@ -0,0 +1,80 @@
+/**
+ * Lyt.js DevTools — 事件追踪器
+ *
+ * 拦截和记录所有组件事件，提供事件列表实时显示、过滤和回放功能。
+ *
+ * 核心功能：
+ * - EventTracker 类
+ * - 拦截和记录所有组件事件（事件名称、触发时间、事件参数、来源组件）
+ * - 事件列表实时显示
+ * - 事件过滤（按名称/组件）
+ * - 事件回放功能（点击事件条目显示详情）
+ *
+ * 纯原生零依赖实现。
+ */
+import type { DevToolsPanel } from './panel';
+/**
+ * 事件追踪器
+ *
+ * 负责显示和过滤组件事件记录，支持事件详情查看。
+ */
+export declare class EventTracker {
+    /** 面板引用 */
+    private panel;
+    /** 当前内容容器 */
+    private container;
+    /** 事件名称过滤关键词 */
+    private nameFilter;
+    /** 组件名称过滤关键词 */
+    private componentFilter;
+    /** 是否暂停记录 */
+    private paused;
+    /** 当前选中的事件 ID（用于显示详情） */
+    private selectedEventId;
+    /** 更新定时器 */
+    private updateTimer;
+    /** 自动滚动定时器 */
+    private autoScrollTimer;
+    constructor(panel: DevToolsPanel);
+    /**
+     * 渲染事件追踪器到指定容器
+     */
+    render(container: HTMLElement): void;
+    /**
+     * 渲染事件列表
+     */
+    private renderEvents;
+    /**
+     * 渲染事件详情
+     */
+    private renderEventDetail;
+    /**
+     * HTML 转义
+     */
+    private escapeHtml;
+    /**
+     * 清空事件记录
+     */
+    private clearEvents;
+    /**
+     * 设置暂停状态
+     */
+    setPaused(paused: boolean): void;
+    /**
+     * 获取暂停状态
+     */
+    isPaused(): boolean;
+    /**
+     * 全局更新事件处理
+     */
+    private onUpdate;
+    /**
+     * 强制刷新
+     */
+    refresh(): void;
+    /**
+     * 销毁追踪器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=event-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-tracker.d.ts","sourceRoot":"","sources":["../../src/event-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAuD7C;;;;GAIG;AACH,qBAAa,YAAY;IACvB,WAAW;IACX,OAAO,CAAC,KAAK,CAAgB;IAC7B,aAAa;IACb,OAAO,CAAC,SAAS,CAA4B;IAC7C,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAc;IAChC,gBAAgB;IAChB,OAAO,CAAC,eAAe,CAAc;IACrC,aAAa;IACb,OAAO,CAAC,MAAM,CAAkB;IAChC,yBAAyB;IACzB,OAAO,CAAC,eAAe,CAAuB;IAC9C,YAAY;IACZ,OAAO,CAAC,WAAW,CAA8C;IACjE,cAAc;IACd,OAAO,CAAC,eAAe,CAA+C;gBAE1D,KAAK,EAAE,aAAa;IAahC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,YAAY;IA0OpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0FzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAQnB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAQd;IAEF;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,IAAI,IAAI;CAYhB"}

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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"}