@blakron/core 0.2.4

package/README.md

@@ -0,0 +1,123 @@
+# @blakron/core
+
+Blakron 是基于 Egret 游戏引擎 API 的现代化重写。保持与 Egret 一致的显示对象模型和事件体系，同时在渲染架构、类型安全和工程规范上全面升级。
+
+## 特性
+
+**渲染引擎**
+
+- WebGL 优先 + Canvas 2D 自动降级
+- InstructionSet 指令驱动渲染，借鉴 Pixi.js 8 两阶段架构（Build → Execute）
+- 多纹理批处理（8 张/批），减少 draw call
+- RenderGroup 分层，静态子树零遍历开销
+- 滤镜：Blur（双 pass ping-pong）、Glow、DropShadow、ColorMatrix、自定义着色器
+- 遮罩：scissor / stencil / 离屏合成三种策略自动选择
+- WebGL Context Lost 恢复
+
+**显示对象**
+
+- 完整的场景图：DisplayObject → Container → Sprite → Stage
+- Bitmap（含 scale9Grid 九宫格）、Shape、Mesh、TextField、BitmapText、Video
+- Graphics 矢量绘图（rect、circle、ellipse、arc、bezier、渐变填充、虚线等）
+- 离屏缓存（cacheAsBitmap）、tint 着色、skew 斜切、zIndex 排序
+
+**事件系统**
+
+- 与 Egret 一致的事件类：Event、TouchEvent、TimerEvent、ProgressEvent 等
+- 捕获/冒泡两阶段分发、事件池、`once()` 一级支持
+- 触摸/鼠标统一处理，支持多触点
+
+**其他**
+
+- 7 种屏幕适配模式（showAll / noScale / exactFit / noBorder 等）
+- HttpRequest / ImageLoader 网络加载
+- Sound（Web Audio + HTML Audio 降级）/ Video 媒体播放
+- ByteArray / Timer / Logger / FontManager / LocalStorage
+- 全量 `strict: true` TypeScript，零 `any`
+
+**与 Egret 对比**
+
+| 维度     | Egret             | Blakron             |
+| -------- | ----------------- | ------------------- |
+| 代码量   | 42,340 行         | ~13,000 行          |
+| 模块系统 | `namespace egret` | ES Module           |
+| 类型安全 | 大量 `any`        | `strict: true`      |
+| 编译目标 | ES5               | ES2022              |
+| 渲染架构 | RenderNode 树     | 扁平 InstructionSet |
+| 批处理   | 同纹理            | 多纹理（8 张/批）   |
+
+**设计参考**
+
+渲染管线借鉴了 Pixi.js 8 的若干设计，同时保持 Egret 的 API 和显示对象模型不变：
+
+| 维度                                   | 来源      | 说明                                                            |
+| -------------------------------------- | --------- | --------------------------------------------------------------- |
+| InstructionSet + RenderPipe 两阶段渲染 | Pixi.js 8 | Build 生成扁平指令数组，Execute 按 `renderPipeId` 分发到各 Pipe |
+| RenderGroup 分层                       | Pixi.js 8 | `isRenderGroup` 让子树拥有独立指令集，结构变化不触发父级重建    |
+| 多纹理批处理                           | Pixi.js   | 顶点携带 `aTextureId`，一次 draw call 绑定 8 张纹理             |
+| tint 着色                              | Pixi.js   | `displayObject.tint` 通过顶点颜色预乘传入 shader                |
+| 脏标记分离                             | Pixi.js 8 | `structureDirty`（全量重建）与 `renderDirty`（局部刷新）分离    |
+| 显示对象 / 事件 / API                  | Egret     | 完整保留，迁移成本最小化                                        |
+| 滤镜 shader                            | Egret     | 沿用原有 GLSL，blur 改为 ping-pong 双 pass                      |
+| WebGL 状态管理                         | Egret     | 沿用 DrawCmdManager 批处理命令队列                              |
+| 遮罩策略                               | Egret     | scissor / stencil / 离屏合成三选一                              |
+
+## 快速开始
+
+```typescript
+import { createPlayer, Sprite, Shape } from '@blakron/core';
+
+const app = createPlayer({
+	canvas: document.getElementById('game-canvas') as HTMLCanvasElement,
+	frameRate: 60,
+	scaleMode: 'showAll',
+	contentWidth: 640,
+	contentHeight: 1136,
+});
+
+const root = new Sprite();
+app.start(root);
+
+const rect = new Shape();
+rect.graphics.beginFill(0xff0000);
+rect.graphics.drawRect(0, 0, 100, 100);
+rect.graphics.endFill();
+rect.x = 100;
+rect.y = 100;
+root.addChild(rect);
+```
+
+## 开发
+
+```bash
+pnpm install
+pnpm run build        # 编译
+pnpm run test         # 运行测试（225 用例）
+pnpm run dev          # watch 模式
+```
+
+## 文档
+
+详细的架构设计、渲染管线说明、API 对比和 Breaking Changes 见 [架构文档](docs/architecture.md)。
+
+## 测试页面
+
+`examples/` 目录包含交互式测试页面，需要通过 HTTP dev server 访问（ES Module 不支持 `file://` 协议）：
+
+```bash
+pnpm benchmark
+```
+
+| 页面            | 说明                                                                          |
+| --------------- | ----------------------------------------------------------------------------- |
+| **Visual Test** | 渲染验证：Shape、Graphics、滤镜、Mask、RenderGroup、动画等 18 个用例          |
+| **Bitmap Test** | Bitmap 渲染：缩放、旋转、SpriteSheet、scale9Grid、批处理                      |
+| **Mesh Test**   | Mesh 顶点变形：Quad / Fan / Grid 预设，Wave / Ripple / Twist 动画             |
+| **Sound Test**  | Sound / SoundChannel：加载、播放、音量、循环、错误处理                        |
+| **Video Test**  | Video 播放：加载、播放/暂停、seek、音量、尺寸调整                             |
+| **Net Test**    | HttpRequest / ImageLoader：GET / POST、responseType、timeout、abort           |
+| **Benchmark**   | WebGL 性能基准：5 种场景压力测试，含 FPS / Draw Calls / Batch Efficiency 指标 |
+
+## 许可证
+
+MIT

package/dist/heron/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 状态。
+ * 不依赖 Heron 引擎，通过外部注入的回调与引擎交互。
+ */
+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/heron/benchmark/BenchmarkRunner.d.ts.map

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

@@ -0,0 +1,112 @@
+/**
+ * 纯状态机，管理 warmup/measuring/paused 状态。
+ * 不依赖 Heron 引擎，通过外部注入的回调与引擎交互。
+ */
+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/heron/benchmark/BenchmarkRunner.js.map

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

package/dist/heron/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/heron/benchmark/MetricsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../../../src/heron/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/heron/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/heron/benchmark/MetricsCollector.js.map

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

package/dist/heron/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/heron/benchmark/PerfPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfPanel.d.ts","sourceRoot":"","sources":["../../../src/heron/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/heron/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/heron/benchmark/PerfPanel.js.map

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

package/dist/heron/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/heron/benchmark/ReportExporter.d.ts.map

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