@blakron/core 0.2.4 → 0.3.3

package/README.md

@@ -30,6 +30,7 @@ Blakron 是基于 Egret 游戏引擎 API 的现代化重写。保持与 Egret
 **其他**
 
 - 7 种屏幕适配模式（showAll / noScale / exactFit / noBorder 等）
+- Resource 资源管理器 — async/await 加载、按组批量加载、5 种内置解析器（Image/Json/Text/Sound/Sheet）
 - HttpRequest / ImageLoader 网络加载
 - Sound（Web Audio + HTML Audio 降级）/ Video 媒体播放
 - ByteArray / Timer / Logger / FontManager / LocalStorage
@@ -98,7 +99,8 @@ pnpm run dev          # watch 模式
 
 ## 文档
 
-详细的架构设计、渲染管线说明、API 对比和 Breaking Changes 见 [架构文档](docs/architecture.md)。
+- [架构文档](docs/architecture.md) — 渲染管线、API 对比和 Breaking Changes
+- [资源管理器](docs/resource.md) — Resource 模块 API 参考、配置格式、自定义解析器
 
 ## 测试页面
 

package/dist/blakron/benchmark/BenchmarkRunner.d.ts

@@ -0,0 +1,60 @@
+import type { MetricsCollector } from './MetricsCollector.js';
+export type Phase = 'idle' | 'warmup' | 'measuring' | 'paused';
+export interface SceneDescriptor {
+    id: string;
+    label?: string;
+    defaultCount?: number;
+    minCount?: number;
+    maxCount?: number;
+    build(container: unknown, count: number): () => void;
+}
+/**
+ * 纯状态机，管理 warmup/measuring/paused 状态。
+ * 不依赖 Blakron 引擎，通过外部注入的回调与引擎交互。
+ */
+export declare class BenchmarkRunner {
+    private readonly collector;
+    private readonly onPhaseChange;
+    private readonly getSceneDescriptor;
+    private readonly container;
+    private phase;
+    private warmupFrames;
+    private readonly warmupTarget;
+    private currentSceneId;
+    private currentCount;
+    private cleanup;
+    constructor(collector: MetricsCollector, onPhaseChange: (phase: Phase) => void, getSceneDescriptor: (id: string) => SceneDescriptor | undefined, container: unknown);
+    /**
+     * 切换场景：销毁旧场景，重建新场景，重置 warmup
+     */
+    switchScene(sceneId: string, count: number): void;
+    /**
+     * 重建当前场景（对象数量变更）
+     */
+    rebuildScene(count: number): void;
+    /**
+     * 暂停（仅在 measuring 状态有效）
+     */
+    pause(): void;
+    /**
+     * 继续（仅在 paused 状态有效）
+     */
+    resume(): void;
+    /**
+     * 重置测量：清空统计，重新进入 warmup
+     */
+    resetMeasurement(): void;
+    /**
+     * 每帧回调（由外部 ENTER_FRAME 事件调用）
+     */
+    onFrame(perf: {
+        fps: number;
+        drawCalls: number;
+        renderTimeMs: number;
+    }): void;
+    /**
+     * 获取当前阶段
+     */
+    getPhase(): Phase;
+}
+//# sourceMappingURL=BenchmarkRunner.d.ts.map

package/dist/blakron/benchmark/BenchmarkRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BenchmarkRunner.d.ts","sourceRoot":"","sources":["../../../src/blakron/benchmark/BenchmarkRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACrD;AAED;;;GAGG;AACH,qBAAa,eAAe;IAS1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAX3B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAM;IACnC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAA2B;gBAGxB,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACrC,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,EAC/D,SAAS,EAAE,OAAO;IAGpC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAyBjD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAOxB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAyB7E;;OAEG;IACH,QAAQ,IAAI,KAAK;CAGjB"}

package/dist/blakron/benchmark/BenchmarkRunner.js

@@ -0,0 +1,112 @@
+/**
+ * 纯状态机，管理 warmup/measuring/paused 状态。
+ * 不依赖 Blakron 引擎，通过外部注入的回调与引擎交互。
+ */
+export class BenchmarkRunner {
+    collector;
+    onPhaseChange;
+    getSceneDescriptor;
+    container;
+    phase = 'idle';
+    warmupFrames = 0;
+    warmupTarget = 60;
+    currentSceneId;
+    currentCount = 0;
+    cleanup;
+    constructor(collector, onPhaseChange, getSceneDescriptor, container) {
+        this.collector = collector;
+        this.onPhaseChange = onPhaseChange;
+        this.getSceneDescriptor = getSceneDescriptor;
+        this.container = container;
+    }
+    /**
+     * 切换场景：销毁旧场景，重建新场景，重置 warmup
+     */
+    switchScene(sceneId, count) {
+        // 1. 销毁旧场景
+        if (this.cleanup) {
+            this.cleanup();
+            this.cleanup = undefined;
+        }
+        // 2. 找到场景描述符，构建新场景
+        const descriptor = this.getSceneDescriptor(sceneId);
+        if (descriptor) {
+            this.cleanup = descriptor.build(this.container, count);
+        }
+        this.currentSceneId = sceneId;
+        this.currentCount = count;
+        // 3. 重置 warmup 状态
+        this.warmupFrames = 0;
+        this.phase = 'warmup';
+        this.onPhaseChange(this.phase);
+        // 4. 清空统计
+        this.collector.reset();
+    }
+    /**
+     * 重建当前场景（对象数量变更）
+     */
+    rebuildScene(count) {
+        if (this.currentSceneId !== undefined) {
+            this.switchScene(this.currentSceneId, count);
+        }
+    }
+    /**
+     * 暂停（仅在 measuring 状态有效）
+     */
+    pause() {
+        if (this.phase === 'measuring') {
+            this.phase = 'paused';
+            this.onPhaseChange(this.phase);
+        }
+    }
+    /**
+     * 继续（仅在 paused 状态有效）
+     */
+    resume() {
+        if (this.phase === 'paused') {
+            this.phase = 'measuring';
+            this.onPhaseChange(this.phase);
+        }
+    }
+    /**
+     * 重置测量：清空统计，重新进入 warmup
+     */
+    resetMeasurement() {
+        this.collector.reset();
+        this.warmupFrames = 0;
+        this.phase = 'warmup';
+        this.onPhaseChange(this.phase);
+    }
+    /**
+     * 每帧回调（由外部 ENTER_FRAME 事件调用）
+     */
+    onFrame(perf) {
+        if (this.phase === 'idle' || this.phase === 'paused') {
+            return;
+        }
+        if (this.phase === 'warmup') {
+            this.warmupFrames++;
+            if (this.warmupFrames >= this.warmupTarget) {
+                this.phase = 'measuring';
+                this.onPhaseChange(this.phase);
+            }
+            return;
+        }
+        // measuring 状态
+        if (this.phase === 'measuring') {
+            this.collector.record({
+                fps: perf.fps,
+                drawCalls: perf.drawCalls,
+                renderTimeMs: perf.renderTimeMs,
+                objectCount: this.currentCount,
+            });
+        }
+    }
+    /**
+     * 获取当前阶段
+     */
+    getPhase() {
+        return this.phase;
+    }
+}
+//# sourceMappingURL=BenchmarkRunner.js.map

package/dist/blakron/benchmark/BenchmarkRunner.js.map

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

package/dist/blakron/benchmark/MetricsCollector.d.ts

@@ -0,0 +1,34 @@
+import type { FrameData, Stats } from './types.js';
+/**
+ * 计算排序数组的百分位数
+ * @param sortedArr 已排序的数组
+ * @param p 百分位（0-1）
+ */
+export declare function percentile(sortedArr: number[], p: number): number;
+/**
+ * 使用 ring buffer 维护 300 帧滑动窗口的指标采集器
+ */
+export declare class MetricsCollector {
+    private readonly windowSize;
+    private readonly buffer;
+    private writeIdx;
+    private frameCount;
+    constructor(windowSize?: number);
+    /**
+     * 写入一帧数据到 ring buffer
+     */
+    record(frame: FrameData): void;
+    /**
+     * 清空所有历史数据，重置写指针和帧计数
+     */
+    reset(): void;
+    /**
+     * 连续 10 帧 renderTimeMs > 33.3ms 时返回 true
+     */
+    isLowFps(): boolean;
+    /**
+     * 计算并返回统计结果
+     */
+    getStats(): Stats;
+}
+//# sourceMappingURL=MetricsCollector.d.ts.map

package/dist/blakron/benchmark/MetricsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../../../src/blakron/benchmark/MetricsCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,GAAE,MAAY;IAKpC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQ9B;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,QAAQ,IAAI,OAAO;IAcnB;;OAEG;IACH,QAAQ,IAAI,KAAK;CAiEjB"}

package/dist/blakron/benchmark/MetricsCollector.js

@@ -0,0 +1,123 @@
+/**
+ * 计算排序数组的百分位数
+ * @param sortedArr 已排序的数组
+ * @param p 百分位（0-1）
+ */
+export function percentile(sortedArr, p) {
+    if (sortedArr.length === 0)
+        return 0;
+    const idx = Math.ceil(p * sortedArr.length) - 1;
+    const clamped = Math.max(0, Math.min(idx, sortedArr.length - 1));
+    return sortedArr[clamped];
+}
+/**
+ * 使用 ring buffer 维护 300 帧滑动窗口的指标采集器
+ */
+export class MetricsCollector {
+    windowSize;
+    buffer;
+    writeIdx = 0;
+    frameCount = 0;
+    constructor(windowSize = 300) {
+        this.windowSize = windowSize;
+        this.buffer = new Array(windowSize);
+    }
+    /**
+     * 写入一帧数据到 ring buffer
+     */
+    record(frame) {
+        this.buffer[this.writeIdx] = frame;
+        this.writeIdx = (this.writeIdx + 1) % this.windowSize;
+        if (this.frameCount < this.windowSize) {
+            this.frameCount++;
+        }
+    }
+    /**
+     * 清空所有历史数据，重置写指针和帧计数
+     */
+    reset() {
+        this.writeIdx = 0;
+        this.frameCount = 0;
+        // 清空 buffer 引用
+        for (let i = 0; i < this.windowSize; i++) {
+            this.buffer[i] = undefined;
+        }
+    }
+    /**
+     * 连续 10 帧 renderTimeMs > 33.3ms 时返回 true
+     */
+    isLowFps() {
+        if (this.frameCount < 10)
+            return false;
+        // 从最近写入的帧往回检查 10 帧
+        for (let i = 0; i < 10; i++) {
+            const idx = (this.writeIdx - 1 - i + this.windowSize) % this.windowSize;
+            const frame = this.buffer[idx];
+            if (!frame || frame.renderTimeMs <= 33.3) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 计算并返回统计结果
+     */
+    getStats() {
+        if (this.frameCount === 0) {
+            return {
+                frameCount: 0,
+                fps: { current: 0, avg: 0, p50: 0, p95: 0, max: 0 },
+                render: { current: 0, avg: 0, p50: 0, p95: 0, max: 0 },
+                drawCalls: { current: 0, avg: 0 },
+                batchEfficiency: 0,
+                isLowFps: false,
+            };
+        }
+        // 收集有效帧数据
+        const fpsValues = [];
+        const renderValues = [];
+        const drawCallValues = [];
+        for (let i = 0; i < this.frameCount; i++) {
+            const idx = (this.writeIdx - this.frameCount + i + this.windowSize * 2) % this.windowSize;
+            const frame = this.buffer[idx];
+            if (frame) {
+                fpsValues.push(frame.fps);
+                renderValues.push(frame.renderTimeMs);
+                drawCallValues.push(frame.drawCalls);
+            }
+        }
+        // 最新帧（writeIdx - 1）
+        const latestIdx = (this.writeIdx - 1 + this.windowSize) % this.windowSize;
+        const latestFrame = this.buffer[latestIdx];
+        const sortedFps = [...fpsValues].sort((a, b) => a - b);
+        const sortedRender = [...renderValues].sort((a, b) => a - b);
+        const avgFps = fpsValues.reduce((s, v) => s + v, 0) / fpsValues.length;
+        const avgRender = renderValues.reduce((s, v) => s + v, 0) / renderValues.length;
+        const avgDrawCalls = drawCallValues.reduce((s, v) => s + v, 0) / drawCallValues.length;
+        const batchEfficiency = latestFrame && latestFrame.drawCalls > 0 ? latestFrame.objectCount / latestFrame.drawCalls : 0;
+        return {
+            frameCount: this.frameCount,
+            fps: {
+                current: latestFrame?.fps ?? 0,
+                avg: avgFps,
+                p50: percentile(sortedFps, 0.5),
+                p95: percentile(sortedFps, 0.95),
+                max: sortedFps[sortedFps.length - 1] ?? 0,
+            },
+            render: {
+                current: latestFrame?.renderTimeMs ?? 0,
+                avg: avgRender,
+                p50: percentile(sortedRender, 0.5),
+                p95: percentile(sortedRender, 0.95),
+                max: sortedRender[sortedRender.length - 1] ?? 0,
+            },
+            drawCalls: {
+                current: latestFrame?.drawCalls ?? 0,
+                avg: avgDrawCalls,
+            },
+            batchEfficiency,
+            isLowFps: this.isLowFps(),
+        };
+    }
+}
+//# sourceMappingURL=MetricsCollector.js.map

package/dist/blakron/benchmark/MetricsCollector.js.map

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

package/dist/blakron/benchmark/PerfPanel.d.ts

@@ -0,0 +1,24 @@
+import type { Stats } from './types.js';
+import type { Phase } from './BenchmarkRunner.js';
+export type FpsColorClass = 'good' | 'warn' | 'bad';
+export declare function fpsColorClass(fps: number): FpsColorClass;
+export interface PerfPanelElements {
+    fps: HTMLElement;
+    drawCalls: HTMLElement;
+    renderCurrent: HTMLElement;
+    renderAvg: HTMLElement;
+    renderP95: HTMLElement;
+    batchEfficiency: HTMLElement;
+    frameCount: HTMLElement;
+    status: HTMLElement;
+    graphCanvas: HTMLCanvasElement;
+}
+export declare class PerfPanel {
+    private readonly els;
+    private fpsHistory;
+    private historyWriteIdx;
+    constructor(els: PerfPanelElements);
+    update(stats: Stats, phase: Phase): void;
+    _drawGraph(fpsHistory: number[], writeIdx: number): void;
+}
+//# sourceMappingURL=PerfPanel.d.ts.map

package/dist/blakron/benchmark/PerfPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfPanel.d.ts","sourceRoot":"","sources":["../../../src/blakron/benchmark/PerfPanel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIxD;AAED,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,WAAW,CAAC;IACvB,aAAa,EAAE,WAAW,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,WAAW,CAAC;IAC7B,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;CAC/B;AAED,qBAAa,SAAS;IAIT,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,eAAe,CAAK;gBAEC,GAAG,EAAE,iBAAiB;IAEnD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAqDxC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAqExD"}

package/dist/blakron/benchmark/PerfPanel.js

@@ -0,0 +1,131 @@
+export function fpsColorClass(fps) {
+    if (fps >= 55)
+        return 'good';
+    if (fps >= 30)
+        return 'warn';
+    return 'bad';
+}
+export class PerfPanel {
+    els;
+    fpsHistory = new Array(200).fill(0);
+    historyWriteIdx = 0;
+    constructor(els) {
+        this.els = els;
+    }
+    update(stats, phase) {
+        if (phase === 'warmup') {
+            this.els.status.textContent = '预热中…';
+            const dimmed = 'dimmed';
+            const valueEls = [
+                this.els.fps,
+                this.els.drawCalls,
+                this.els.renderCurrent,
+                this.els.renderAvg,
+                this.els.renderP95,
+                this.els.batchEfficiency,
+                this.els.frameCount,
+            ];
+            for (const el of valueEls) {
+                el.textContent = '--';
+                el.className = dimmed;
+            }
+        }
+        else if (phase === 'measuring') {
+            this.els.status.textContent = '测量中';
+            // Clear dimmed class
+            const valueEls = [
+                this.els.fps,
+                this.els.drawCalls,
+                this.els.renderCurrent,
+                this.els.renderAvg,
+                this.els.renderP95,
+                this.els.batchEfficiency,
+                this.els.frameCount,
+            ];
+            for (const el of valueEls) {
+                el.className = '';
+            }
+            this.els.fps.textContent = stats.fps.current.toFixed(1);
+            this.els.drawCalls.textContent = String(stats.drawCalls.current);
+            this.els.renderCurrent.textContent = stats.render.current.toFixed(2) + ' ms';
+            this.els.renderAvg.textContent = stats.render.avg.toFixed(2) + ' ms';
+            this.els.renderP95.textContent = stats.render.p95.toFixed(2) + ' ms';
+            this.els.batchEfficiency.textContent = stats.batchEfficiency.toFixed(1) + 'x';
+            this.els.frameCount.textContent = String(stats.frameCount);
+            // Update fps history ring buffer
+            this.fpsHistory[this.historyWriteIdx] = stats.fps.current;
+            this.historyWriteIdx = (this.historyWriteIdx + 1) % 200;
+        }
+        else if (phase === 'paused') {
+            this.els.status.textContent = '已暂停';
+            // Keep current values, just update status
+        }
+        this._drawGraph(this.fpsHistory, this.historyWriteIdx);
+    }
+    _drawGraph(fpsHistory, writeIdx) {
+        const canvas = this.els.graphCanvas;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return;
+        const width = canvas.width; // 200
+        const height = canvas.height; // 60
+        const maxFps = 70;
+        const refFps = 60;
+        // Clear
+        ctx.fillStyle = '#111';
+        ctx.fillRect(0, 0, width, height);
+        // Draw 60 FPS reference line
+        const refY = height - (refFps / maxFps) * height;
+        ctx.strokeStyle = '#444';
+        ctx.lineWidth = 1;
+        ctx.beginPath();
+        ctx.moveTo(0, refY);
+        ctx.lineTo(width, refY);
+        ctx.stroke();
+        // Draw FPS polyline with color segments
+        const len = fpsHistory.length; // 200
+        ctx.lineWidth = 1;
+        for (let i = 0; i < len; i++) {
+            // The oldest sample is at writeIdx, newest is at writeIdx - 1
+            const sampleIdx = (writeIdx + i) % len;
+            const fps = fpsHistory[sampleIdx];
+            const x = i;
+            const y = height - Math.min(fps / maxFps, 1) * height;
+            const colorClass = fpsColorClass(fps);
+            if (colorClass === 'good') {
+                ctx.strokeStyle = '#4caf50';
+            }
+            else if (colorClass === 'warn') {
+                ctx.strokeStyle = '#ffeb3b';
+            }
+            else {
+                ctx.strokeStyle = '#f44336';
+            }
+            if (i === 0) {
+                ctx.beginPath();
+                ctx.moveTo(x, y);
+            }
+            else {
+                // Check if color changed from previous sample
+                const prevSampleIdx = (writeIdx + i - 1) % len;
+                const prevFps = fpsHistory[prevSampleIdx];
+                const prevColorClass = fpsColorClass(prevFps);
+                if (prevColorClass !== colorClass) {
+                    // End previous segment and start new one
+                    ctx.lineTo(x, y);
+                    ctx.stroke();
+                    ctx.beginPath();
+                    ctx.moveTo(x, y);
+                }
+                else {
+                    ctx.lineTo(x, y);
+                }
+            }
+            // Stroke the last segment
+            if (i === len - 1) {
+                ctx.stroke();
+            }
+        }
+    }
+}
+//# sourceMappingURL=PerfPanel.js.map

package/dist/blakron/benchmark/PerfPanel.js.map

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

package/dist/blakron/benchmark/ReportExporter.d.ts

@@ -0,0 +1,8 @@
+import type { Stats, ReportData } from './types.js';
+export declare class ReportExporter {
+    buildReport(sceneId: string, objectCount: number, stats: Stats): ReportData;
+    exportJSON(report: ReportData): void;
+    formatMarkdown(report: ReportData): string;
+    copyMarkdown(report: ReportData, fallback?: (text: string) => void): Promise<void>;
+}
+//# sourceMappingURL=ReportExporter.d.ts.map

package/dist/blakron/benchmark/ReportExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportExporter.d.ts","sourceRoot":"","sources":["../../../src/blakron/benchmark/ReportExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,cAAc;IAE1B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU;IAsB3E,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAcpC,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IASpC,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxF"}

package/dist/blakron/benchmark/ReportExporter.js

@@ -0,0 +1,54 @@
+export class ReportExporter {
+    // 生成报告对象
+    buildReport(sceneId, objectCount, stats) {
+        return {
+            timestamp: new Date().toISOString(),
+            userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',
+            scene: sceneId,
+            objectCount,
+            fps: {
+                avg: stats.fps.avg,
+                p95: stats.fps.p95,
+                max: stats.fps.max,
+            },
+            renderTimeMs: {
+                avg: stats.render.avg,
+                p95: stats.render.p95,
+                max: stats.render.max,
+            },
+            drawCallsAvg: stats.drawCalls.avg,
+            batchEfficiencyAvg: stats.batchEfficiency,
+        };
+    }
+    // 触发 JSON 文件下载
+    exportJSON(report) {
+        const json = JSON.stringify(report, null, 2);
+        const ts = report.timestamp.replace(/[:.]/g, '-').slice(0, 19);
+        const filename = `benchmark-${report.scene}-${ts}.json`;
+        const blob = new Blob([json], { type: 'application/json' });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = filename;
+        a.click();
+        URL.revokeObjectURL(url);
+    }
+    // 格式化为 Markdown 表格
+    formatMarkdown(report) {
+        const header = '| 场景 | 对象数 | FPS avg | FPS p95 | FPS max | Render avg (ms) | Render p95 (ms) | Render max (ms) | Draw Calls avg | Batch Efficiency |';
+        const separator = '|---|---|---|---|---|---|---|---|---|---|';
+        const row = `| ${report.scene} | ${report.objectCount} | ${report.fps.avg.toFixed(1)} | ${report.fps.p95.toFixed(1)} | ${report.fps.max.toFixed(1)} | ${report.renderTimeMs.avg.toFixed(2)} | ${report.renderTimeMs.p95.toFixed(2)} | ${report.renderTimeMs.max.toFixed(2)} | ${report.drawCallsAvg.toFixed(1)} | ${report.batchEfficiencyAvg.toFixed(2)} |`;
+        return [header, separator, row].join('\n');
+    }
+    // 写入剪贴板，失败时调用 fallback
+    async copyMarkdown(report, fallback) {
+        const text = this.formatMarkdown(report);
+        try {
+            await navigator.clipboard.writeText(text);
+        }
+        catch {
+            fallback?.(text);
+        }
+    }
+}
+//# sourceMappingURL=ReportExporter.js.map

package/dist/blakron/benchmark/ReportExporter.js.map

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

package/dist/blakron/benchmark/SceneRegistry.d.ts

@@ -0,0 +1,16 @@
+import type { SceneDescriptor } from './BenchmarkRunner.js';
+/**
+ * 场景工厂接口，用于在测试中注入 mock，在 HTML 中注入真实 Blakron 对象。
+ */
+export interface SceneFactory {
+    createBitmap(texIndex?: number): unknown;
+    createShape(): unknown;
+    createSprite(): unknown;
+    addChild(parent: unknown, child: unknown): void;
+    removeChild(parent: unknown, child: unknown): void;
+    addEventListener(target: unknown, event: string, handler: () => void): void;
+    removeEventListener(target: unknown, event: string, handler: () => void): void;
+}
+export declare const scenes: SceneDescriptor[];
+export declare function getScene(id: string): SceneDescriptor | undefined;
+//# sourceMappingURL=SceneRegistry.d.ts.map

package/dist/blakron/benchmark/SceneRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneRegistry.d.ts","sourceRoot":"","sources":["../../../src/blakron/benchmark/SceneRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5E,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC/E;AAED,eAAO,MAAM,MAAM,EAAE,eAAe,EA8NnC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhE"}