bee-ladybug 0.5.4 → 0.6.1

package/src/core/UIOverlay.js

@@ -542,11 +542,12 @@ export class UIOverlay {
                   <button class="bl-btn" data-act="slow" type="button">F3 SLOW</button>
                   <button class="bl-btn" data-act="freeze" type="button">F4 STOP</button>
                   <button class="bl-btn" data-act="live" type="button">1x LIVE</button>
+                  <button class="bl-btn" data-act="export" type="button">F8 EXPORT</button>
                   <span class="bl-hotkeys" data-el="hotkeys"></span>
                   <button class="bl-btn" data-act="ask" type="button">ASK AI</button>
                   <span class="bl-providers" data-el="providers"></span>
                   <span class="bl-adapters" data-el="adapters"></span>
-                  <span class="bl-hint">F2 overlay</span>
+                  <span class="bl-hint">F2 overlay · F8 export</span>
                 </div>
               </div>
             </div>
@@ -581,6 +582,7 @@ export class UIOverlay {
             if (act === 'slow') this.core.applySlowMo();
             else if (act === 'freeze') this.core.toggleFreeze();
             else if (act === 'live') this.core.restoreRealtime();
+            else if (act === 'export') this.core.exportReport('html');
             else if (act === 'ask') this.core.ask();
             else if (act === 'assist') this.core.setActiveAssistant(btn.getAttribute('data-name'));
             else if (act === 'adapter') this.core.toggleAdapter(btn.getAttribute('data-name'));

package/src/index.d.ts

@@ -67,6 +67,7 @@ export interface CoreOptions {
     toggleKey?: string;
     slowKey?: string;
     freezeKey?: string;
+    exportKey?: string;
     slowScale?: number;
     maxLogs?: number;
     historySize?: number;
@@ -108,12 +109,86 @@ export interface AssistantProvider {
     complete(input: { question: string; snapshot: AssistantSnapshot }): unknown;
 }
 
+export type ReportFormat = 'html' | 'json' | 'csv';
+export type ReportSeverity = 'error' | 'warn' | 'ok';
+
+export interface ReportItem {
+    severity: ReportSeverity;
+    selector: string;
+    rule: string;
+    value: string;
+    source: string;
+}
+
+export interface ReportSection {
+    name: string;
+    items: ReportItem[];
+}
+
+export interface ReportSeries {
+    name: string;
+    min: number;
+    max: number;
+    avg: number;
+    last: number;
+    samples: number[];
+}
+
+export interface ReportDocument {
+    version: string;
+    generatedAt: string;
+    fileStamp: string;
+    url: string;
+    viewport: { width: number; height: number } | null;
+    clock: {
+        wallTime: number;
+        simTime: number;
+        frame: number;
+        frozen: boolean;
+        timeScale: number;
+        coreFps: number;
+    };
+    summary: { error: number; warn: number; ok: number };
+    logs: Array<{
+        type: string;
+        level: LogLevel | null;
+        source: string;
+        message: string;
+        wallTime: number;
+        simTime: number;
+        frame: number;
+    }>;
+    series: ReportSeries[];
+    latest: BeePacket[];
+    adapters: ReportSection[];
+}
+
+export interface ReportSnapshotItem {
+    severity?: string;
+    selector?: string;
+    rule?: string;
+    value?: unknown;
+    source?: string;
+}
+
+export interface ReportSnapshot {
+    name?: string;
+    items?: ReportSnapshotItem[];
+}
+
+export interface AdapterSnapshotResult {
+    name: string;
+    result?: unknown;
+    error?: string;
+}
+
 export interface AdapterHooks {
     enable(): void;
     disable(): void;
     label?: string;
     hotkey?: string;
     enabled?: boolean;
+    snapshot?(): ReportSnapshot | null | undefined;
 }
 
 export interface AdapterInfo {
@@ -125,11 +200,16 @@ export interface AdapterInfo {
 
 export function formatSimTime(ms: number): string;
 
+export function exportReport(core: BeeLadybugCore, options: { format: 'json' }): ReportDocument;
+export function exportReport(core: BeeLadybugCore, options?: { format?: 'html' | 'csv' }): string;
+export function isReportNoise(node: object | null | undefined): boolean;
+
 export class BeeLadybugCore {
     readonly version: string;
     toggleKey: string;
     slowKey: string;
     freezeKey: string;
+    exportKey: string;
     slowScale: number;
     maxLogs: number;
     historySize: number;
@@ -158,6 +238,8 @@ export class BeeLadybugCore {
     setTimeScale(scale: number): this;
     applySlowMo(): this;
     restoreRealtime(): this;
+    exportReport(format: 'json'): ReportDocument;
+    exportReport(format?: 'html' | 'csv'): string;
     getState(): CoreState;
     getLogs(): BeePacket[];
     getHistory(name: string): MetricHistory;
@@ -175,6 +257,7 @@ export class BeeLadybugCore {
     registerAdapter(name: string, hooks: AdapterHooks): this;
     unregisterAdapter(name: string): this;
     getAdapters(): AdapterInfo[];
+    collectSnapshots(): AdapterSnapshotResult[];
     toggleAdapter(name: string): this;
     setAdapterEnabled(name: string, enabled: boolean): this;
     publishDetail(items: DetailItem[]): this;
@@ -254,6 +337,7 @@ export class CanvasAdapter {
     setCanvas(canvas: HTMLCanvasElement | null): this;
     setEntities(entities: CanvasEntity[]): this;
     pump(ctx?: CanvasRenderingContext2D): this;
+    snapshot(): ReportSnapshot | null;
 }
 
 export interface WebDOMAdapterOptions {
@@ -285,6 +369,7 @@ export class WebDOMAdapter {
     detach(): this;
     setRoot(root: ParentNode | null): this;
     pump(): this;
+    snapshot(): ReportSnapshot | null;
 }
 
 export interface CSSAdapterOptions {
@@ -315,6 +400,7 @@ export class CSSAdapter {
     attach(): this;
     detach(): this;
     scan(): this;
+    snapshot(): ReportSnapshot | null;
 }
 
 export interface AntAdapterOptions {
@@ -335,6 +421,7 @@ export class AntAdapter {
     constructor(core: BeeLadybugCore, options?: AntAdapterOptions);
     attach(): this;
     detach(): this;
+    snapshot(): ReportSnapshot | null;
 }
 
 export interface SpiderAdapterOptions {
@@ -353,6 +440,7 @@ export class SpiderAdapter {
     constructor(core: BeeLadybugCore, options?: SpiderAdapterOptions);
     attach(): this;
     detach(): this;
+    snapshot(): ReportSnapshot | null;
 }
 
 export type PythonBridgeStatus = 'idle' | 'connecting' | 'open' | 'closed';
@@ -378,4 +466,5 @@ export class PythonBridge {
     connect(url?: string): this;
     disconnect(): this;
     ingest(raw: unknown): this;
+    snapshot(): ReportSnapshot;
 }

package/src/index.js

@@ -1,4 +1,5 @@
 export { BeeLadybugCore, BEE_LADYBUG_VERSION, CORE_DEFAULTS, WELL_KNOWN_TYPES, formatSimTime } from './core/BeeLadybugCore.js';
+export { exportReport, isReportNoise } from './core/ReportExporter.js';
 export { UIOverlay } from './core/UIOverlay.js';
 export { CanvasAdapter, CANVAS_ADAPTER_DEFAULTS } from './adapters/CanvasAdapter.js';
 export { WebDOMAdapter, WEB_DOM_ADAPTER_DEFAULTS } from './adapters/WebDOMAdapter.js';