@kurot/core 1.0.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kelvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# @kurot/core
+
+A modern rewrite of the Egret game engine. Maintains Egret-compatible display object and event APIs while upgrading the rendering architecture, type safety, and tooling.
+
+> **Stable (1.0.12).** Targets ES2022 and evergreen browsers (Chrome / Edge / Firefox / Safari). No IE / old-Android / pre-2022 Safari support shims.
+
+## Features
+
+**Rendering Engine**
+
+- WebGL-first with automatic Canvas 2D fallback when WebGL initialization fails
+- WebGL-only InstructionSet pipeline (Build → Execute two-phase, inspired by Pixi.js 8)
+- Multi-texture batching (up to 8 textures per draw call)
+- RenderGroup layers — localize instruction rebuilds to the affected subtree
+- Filters: Blur (ping-pong dual-pass), Glow, DropShadow, ColorMatrix, custom shaders
+- Masks: automatic selection between scissor / stencil / offscreen compositing
+- PixiJS-style `cacheAsTexture()` plus Egret-compatible `cacheAsBitmap`
+- WebGL Context Lost recovery
+
+**Display Objects**
+
+- Full scene graph: DisplayObject → Container → Sprite → Stage
+- Bitmap (with scale9Grid), Shape, Mesh, TextField, BitmapText, Video
+- Graphics vector drawing (rect, circle, ellipse, arc, bezier, gradients, dashed lines)
+- cacheAsBitmap / cacheAsTexture, tint, skew, zIndex sorting
+
+**Event System**
+
+- Egret-compatible event classes: Event, TouchEvent, TimerEvent, ProgressEvent, etc.
+- Capture / bubble two-phase dispatch, object pooling, `once()` built-in
+- Unified touch + mouse handling, multi-touch support
+
+**Other**
+
+- 7 screen scale modes (showAll / noScale / exactFit / noBorder, etc.)
+- Resource manager — async/await loading, group-based batching, 5 built-in parsers (Image / Json / Text / Sound / Sheet)
+- HttpRequest / ImageLoader networking
+- Sound (Web Audio + HTML Audio fallback) / Video playback
+- ByteArray / Timer / Logger / FontManager / LocalStorage
+- Full `strict: true` TypeScript across runtime APIs
+
+### Rendering Backends
+
+`Player` tries `webgl2` and then `webgl` directly on the supplied canvas. If both context types fail to initialize, it falls back to the Canvas 2D renderer. No temporary canvas is created solely to probe WebGL support.
+
+```typescript
+const app = createPlayer({ canvas });
+console.log(app.player.isWebGL ? 'WebGL' : 'Canvas 2D');
+```
+
+The flat InstructionSet pipeline and multi-texture batching apply to the WebGL backend. The full-scene Canvas fallback uses direct display-tree traversal. Canvas support is still part of the normal WebGL path: text, Graphics, RenderTexture, and pixel hit testing may be rasterized through Canvas before being uploaded or composited by WebGL.
+
+**Migrating from Egret (1.0.0 breaking changes)**
+
+- `.hashCode` and the `HashObject` base class were removed. Use `WeakMap`-keyed lookups or `===` for object identity instead of comparing integer hash codes. Internal consumers were migrated to `WeakMap` in 0.6.3.
+- `Resource.instance` (singleton getter) was removed — import the shared `resource` instance directly: `import { resource } from '@kurot/core'`.
+- The multi-Player listener registration API on `DisplayObject` / `DisplayObjectContainer` (`addStructureChangeListener` / `addRenderableDirtyListener` / `addContainerStructureChangeListener`) was removed — the engine is single-Player by design.
+- `WebGLRenderContext.getInstance()` / `resetInstance()` were removed — `Player` constructs the context directly.
+- Internal fields were renamed with a `$` prefix (e.g. `$x`, `$y`, `$renderDirty`) to separate engine state from public API.
+- Vendor-prefixed fallbacks (`experimental-webgl`, `webkitAudioContext`, `webkit/moz fullscreen`) and the hand-rolled base64 implementation were removed in favour of native APIs.
+
+**vs. Egret**
+
+| Aspect      | Egret             | Kurot                 |
+| ----------- | ----------------- | ----------------------- |
+| Code size   | 42,340 lines      | ~18,500 lines           |
+| Modules     | `namespace egret` | ES Module               |
+| Type safety | pervasive `any`   | `strict: true`          |
+| Target      | ES5               | ES2022                  |
+| Pipeline    | RenderNode tree   | Flat InstructionSet     |
+| Batching    | same-texture      | multi-texture (8/batch) |
+
+**Design Credits**
+
+The rendering pipeline borrows concepts from Pixi.js 8 while keeping the Egret display object model and API intact:
+
+| Aspect                                | Source    | Notes                                                           |
+| ------------------------------------- | --------- | --------------------------------------------------------------- |
+| InstructionSet + RenderPipe two-phase | Pixi.js 8 | Build → flat instructions, Execute → dispatch by `renderPipeId` |
+| RenderGroup layers                    | Pixi.js 8 | `isRenderGroup` isolates subtree instruction sets               |
+| Multi-texture batching                | Pixi.js   | `aTextureId` per vertex, up to 8 textures per draw call         |
+| Tint                                  | Pixi.js   | `displayObject.tint` passed as premultiplied vertex color       |
+| Dirty flag separation                 | Pixi.js 8 | `structureDirty` (rebuild) vs `renderDirty` (patch)             |
+| Display objects / events / API        | Egret     | Fully preserved for minimal migration cost                      |
+| Filter shaders                        | Egret     | Original GLSL, blur upgraded to ping-pong dual-pass             |
+| WebGL state management                | Egret     | DrawCmdManager batching command queue                           |
+| Mask strategies                       | Egret     | scissor / stencil / offscreen compositing                       |
+
+## Quick Start
+
+```typescript
+import { createPlayer, Sprite, Shape } from '@kurot/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);
+
+// stop() is resumable; destroy() performs final lifecycle cleanup.
+// app.destroy();
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm run build        # compile
+pnpm run test         # run tests (634 cases)
+pnpm run dev          # watch mode
+```
+
+## Documentation
+
+- [CHANGELOG.md](./CHANGELOG.md) — versioned release notes, including the full list of 1.0.0 breaking changes
+- [Architecture](./docs/architecture.md) — engine structure and rendering pipeline
+- [Resource system](./docs/resource.md) — resource configuration, loading, and lifecycle
+- [PixiJS alignment](./docs/pixi-alignment.md) — rendering concepts adopted from PixiJS and intentional differences
+- [Live demo](https://irwinmc.github.io/kurot-demo/) — interactive rendering examples
+
+## Test Pages
+
+Interactive test pages in `examples/` require an HTTP dev server (ES Modules don't work over `file://`):
+
+```bash
+pnpm benchmark
+```
+
+| Page            | Description                                                          |
+| --------------- | -------------------------------------------------------------------- |
+| **Visual Test** | 19 cases: Shape, Graphics, Filters, Mask, RenderGroup, Animation     |
+| **Bitmap Test** | Bitmap rendering: scale, rotation, SpriteSheet, scale9Grid, batching |
+| **Mesh Test**   | Mesh deformation: Quad / Fan / Grid presets, Wave / Ripple / Twist   |
+| **Sound Test**  | Sound / SoundChannel: load, play, volume, loop, error handling       |
+| **Video Test**  | Video: load, play/pause, seek, volume, resize                        |
+| **Net Test**    | HttpRequest / ImageLoader: GET / POST, responseType, timeout, abort  |
+| **Benchmark**   | WebGL perf: 5 stress scenes with FPS / Draw Calls / Batch Efficiency |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './kurot/events/index.js';
+export * from './kurot/geom/index.js';
+export * from './kurot/utils/index.js';
+export * from './kurot/display/index.js';
+export * from './kurot/net/index.js';
+export * from './kurot/filters/index.js';
+export * from './kurot/media/index.js';
+export * from './kurot/player/index.js';
+export * from './kurot/text/index.js';
+export * from './kurot/system/index.js';
+export * as localStorage from './kurot/localStorage/localStorage.js';
+export { ExternalInterface } from './kurot/external/ExternalInterface.js';
+export * from './kurot/resource/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './kurot/events/index.js';
+export * from './kurot/geom/index.js';
+export * from './kurot/utils/index.js';
+export * from './kurot/display/index.js';
+export * from './kurot/net/index.js';
+export * from './kurot/filters/index.js';
+export * from './kurot/media/index.js';
+export * from './kurot/player/index.js';
+export * from './kurot/text/index.js';
+export * from './kurot/system/index.js';
+export * as localStorage from './kurot/localStorage/localStorage.js';
+export { ExternalInterface } from './kurot/external/ExternalInterface.js';
+export * from './kurot/resource/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,cAAc,2BAA2B,CAAC"}

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

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

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

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

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

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

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

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

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