@zkmake/three-meter 0.4.0 → 0.5.0

package/dist/{performance-monitor-Br7x3cPt.d.ts → performance-monitor-CBN05_BC.d.ts}

@@ -36,6 +36,20 @@ type Sample = {
   render: RenderCounts;
   resources: ResourceCounts;
 };
+/**
+ * Stutter over the last `frameStatsSize` frame intervals (default 1000, about
+ * 16 s at 60 Hz). Stalls over a second are left out.
+ */
+type FrameStats = {
+  /** Intervals in the window. */
+  frames: number;
+  /** Frames over twice the window's median interval. */
+  hitches: number;
+  /** 1% low: mean FPS across the slowest 1% of frames. */
+  lowFps: number;
+  /** 99th percentile frame interval in ms. */
+  p99Ms: number;
+};
 /** `webgl` is WebGL 1, which three dropped in r163. */
 type RenderBackend = "webgpu" | "webgl2" | "webgl";
 /** What the monitor is running on, for bug reports. `null` where it can't be read. */
@@ -90,6 +104,8 @@ type PerformanceMonitorOptions = {
   gpuQueryPoolSize?: number;
   /** Ring-buffer length backing the graphs. Default 120. */
   historySize?: number;
+  /** Frame intervals behind {@link FrameStats}. Default 1000. */
+  frameStatsSize?: number;
 };
 //#endregion
 //#region src/core/performance-monitor.d.ts
@@ -117,6 +133,8 @@ declare class PerformanceMonitor {
   private readonly fpsHistory;
   private readonly cpuHistory;
   private readonly gpuHistory;
+  private readonly frameIntervals;
+  private frameStats;
   private cpuStart;
   private lastBeginAt;
   private frameFps;
@@ -128,6 +146,8 @@ declare class PerformanceMonitor {
   end(): void;
   getSample(): Sample;
   getHistory(metric: TimingMetric): readonly number[];
+  /** 1% low, p99 frame time and hitches. Computed on read, cached until the next frame. */
+  getFrameStats(): FrameStats;
   /**
    * three revision, backend and GPU name. Cached once the backend is known;
    * before `WebGPURenderer.init()` settles it, `backend` is `null` and the
@@ -138,5 +158,5 @@ declare class PerformanceMonitor {
   private buildEmptySample;
 }
 //#endregion
-export { PerformanceMonitorOptions as a, ResourceCounts as c, PerfRenderer as i, Sample as l, Environment as n, RenderBackend as o, GpuTiming as r, RenderCounts as s, PerformanceMonitor as t, TimingMetric as u };
-//# sourceMappingURL=performance-monitor-Br7x3cPt.d.ts.map
+export { PerfRenderer as a, RenderCounts as c, TimingMetric as d, GpuTiming as i, ResourceCounts as l, Environment as n, PerformanceMonitorOptions as o, FrameStats as r, RenderBackend as s, PerformanceMonitor as t, Sample as u };
+//# sourceMappingURL=performance-monitor-CBN05_BC.d.ts.map

package/dist/{performance-monitor-C8dhWJWR.js → performance-monitor-yxsxs57v.js}

@@ -89,6 +89,31 @@ const readEnvironment = (renderer) => {
 		three
 	};
 };
+const EMPTY = Object.freeze({
+	frames: 0,
+	hitches: 0,
+	lowFps: 0,
+	p99Ms: 0
+});
+const computeFrameStats = (intervals) => {
+	const frames = intervals.length;
+	if (frames === 0) return EMPTY;
+	const sorted = [...intervals].sort((a, b) => a - b);
+	const p99Ms = sorted[Math.ceil(frames * .99) - 1];
+	const slowest = Math.max(1, Math.ceil(frames * .01));
+	let slowSum = 0;
+	for (let index = frames - slowest; index < frames; index += 1) slowSum += sorted[index];
+	const middle = frames >> 1;
+	const threshold = (frames % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle]) * 2;
+	let hitches = 0;
+	for (const interval of intervals) if (interval > threshold) hitches += 1;
+	return Object.freeze({
+		frames,
+		hitches,
+		lowFps: 1e3 / (slowSum / slowest),
+		p99Ms
+	});
+};
 //#endregion
 //#region src/core/gpu-timer.ts
 var GpuTimer = class GpuTimer {
@@ -221,6 +246,7 @@ const DEFAULT_GPU_POOL_SIZE = 5;
 /** One monitor per renderer: a second would stack the `render` patch and double-count passes. */
 const ATTACHED = /* @__PURE__ */ new WeakSet();
 const DEFAULT_HISTORY_SIZE = 120;
+const DEFAULT_FRAME_STATS_SIZE = 1e3;
 const FPS_SMOOTHING = .1;
 /**
 * A frame interval past this is a stall (hidden tab, breakpoint, laptop lid),
@@ -254,6 +280,8 @@ var PerformanceMonitor = class {
 	fpsHistory;
 	cpuHistory;
 	gpuHistory;
+	frameIntervals;
+	frameStats = null;
 	cpuStart = 0;
 	lastBeginAt = null;
 	frameFps = 0;
@@ -261,7 +289,7 @@ var PerformanceMonitor = class {
 	sample;
 	environment = null;
 	constructor(options) {
-		const { renderer, trackGPU = true, gpuQueryPoolSize = DEFAULT_GPU_POOL_SIZE, historySize = DEFAULT_HISTORY_SIZE } = options;
+		const { renderer, trackGPU = true, gpuQueryPoolSize = DEFAULT_GPU_POOL_SIZE, historySize = DEFAULT_HISTORY_SIZE, frameStatsSize = DEFAULT_FRAME_STATS_SIZE } = options;
 		if (ATTACHED.has(renderer)) throw new Error("three-meter: a PerformanceMonitor is already attached to this renderer. dispose() it first.");
 		ATTACHED.add(renderer);
 		this.renderer = renderer;
@@ -279,13 +307,18 @@ var PerformanceMonitor = class {
 		this.fpsHistory = new RingBuffer(historySize);
 		this.cpuHistory = new RingBuffer(historySize);
 		this.gpuHistory = new RingBuffer(historySize);
+		this.frameIntervals = new RingBuffer(frameStatsSize);
 		this.sample = this.buildEmptySample();
 	}
 	begin() {
 		const now = performance.now();
 		if (this.lastBeginAt !== null) {
 			const frameMs = now - this.lastBeginAt;
-			if (frameMs > 0 && frameMs <= STALL_MS) this.frameFps = 1e3 / frameMs;
+			if (frameMs > 0 && frameMs <= STALL_MS) {
+				this.frameFps = 1e3 / frameMs;
+				this.frameIntervals.push(frameMs);
+				this.frameStats = null;
+			}
 		}
 		this.lastBeginAt = now;
 		this.cpuStart = now;
@@ -336,6 +369,11 @@ var PerformanceMonitor = class {
 			case "gpu": return this.gpuHistory.toArray();
 		}
 	}
+	/** 1% low, p99 frame time and hitches. Computed on read, cached until the next frame. */
+	getFrameStats() {
+		this.frameStats ??= computeFrameStats(this.frameIntervals.toArray());
+		return this.frameStats;
+	}
 	/**
 	* three revision, backend and GPU name. Cached once the backend is known;
 	* before `WebGPURenderer.init()` settles it, `backend` is `null` and the
@@ -355,6 +393,8 @@ var PerformanceMonitor = class {
 		this.fpsHistory.clear();
 		this.cpuHistory.clear();
 		this.gpuHistory.clear();
+		this.frameIntervals.clear();
+		this.frameStats = null;
 	}
 	buildEmptySample() {
 		return Object.freeze({
@@ -382,4 +422,4 @@ var PerformanceMonitor = class {
 //#endregion
 export { RingBuffer as n, PerformanceMonitor as t };
 
-//# sourceMappingURL=performance-monitor-C8dhWJWR.js.map
+//# sourceMappingURL=performance-monitor-yxsxs57v.js.map

package/dist/performance-monitor-yxsxs57v.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor-yxsxs57v.js","names":[],"sources":["../src/core/environment.ts","../src/core/frame-stats.ts","../src/core/gpu-timer.ts","../src/core/ring-buffer.ts","../src/core/performance-monitor.ts"],"sourcesContent":["/**\n * What the monitor is running on: three revision, rendering backend, GPU.\n * Read from the renderer and the page, never from an import of three.\n *\n * `WebGPURenderer` settles its backend in `init()`, so until then the backend\n * reads `null`; callers poll and the monitor caches once it is known.\n */\nimport type { Environment, PerfRenderer, RenderBackend } from \"./types.ts\";\n\ntype BackendShape = {\n  device?: { adapterInfo?: AdapterInfoShape } | null;\n  gl?: unknown;\n  isWebGLBackend?: boolean;\n  isWebGPUBackend?: boolean;\n  parameters?: { forceWebGL?: boolean };\n};\n\ntype AdapterInfoShape = {\n  architecture?: string;\n  description?: string;\n  device?: string;\n  vendor?: string;\n};\n\ntype DebugRendererInfoExt = { readonly UNMASKED_RENDERER_WEBGL: number };\n\n/** three sets `window.__THREE__` to its revision on import (and warns on a second copy). */\nconst readThreeRevision = (): string | null => {\n  const revision = (globalThis as { __THREE__?: unknown }).__THREE__;\n\n  return typeof revision === \"string\" && revision !== \"\" ? revision : null;\n};\n\n/**\n * Trim a WebGL renderer string to the part a person recognises. Chrome wraps\n * it in ANGLE, e.g. `ANGLE (NVIDIA, NVIDIA GeForce RTX 4070 (0x00002786)\n * Direct3D11 vs_5_0 ps_5_0, D3D11)` or `ANGLE (Apple, ANGLE Metal Renderer:\n * Apple M3 Pro, Unspecified Version)`.\n */\nconst cleanGpuName = (raw: string): string => {\n  let name = raw.trim();\n  const angle = /^ANGLE \\((.*)\\)$/.exec(name);\n\n  if (angle) {\n    const parts = angle[1]!.split(\", \");\n    name = parts[1] ?? parts[0]!;\n  }\n\n  return name\n    .replace(/^ANGLE [\\w ]+ Renderer: /, \"\")\n    .replace(/ \\(0x[0-9a-f]+\\)/i, \"\")\n    .replace(/ (Direct3D\\d*|OpenGL|Vulkan|Metal)\\b.*$/, \"\")\n    .trim();\n};\n\nconst webglGpuName = (gl: WebGLRenderingContext | WebGL2RenderingContext): string | null => {\n  // Firefox deprecates the extension but already returns the unmasked name from RENDERER.\n  const ext = gl.getExtension(\"WEBGL_debug_renderer_info\") as DebugRendererInfoExt | null;\n  const raw = gl.getParameter(ext ? ext.UNMASKED_RENDERER_WEBGL : gl.RENDERER) as unknown;\n\n  return typeof raw === \"string\" && raw !== \"\" && raw !== \"WebKit WebGL\" ? cleanGpuName(raw) : null;\n};\n\n/** WebGPU reports vendors lowercase (`apple`, `nvidia`). */\nconst VENDOR_NAMES: Record<string, string> = {\n  amd: \"AMD\",\n  apple: \"Apple\",\n  arm: \"Arm\",\n  intel: \"Intel\",\n  nvidia: \"NVIDIA\",\n  qualcomm: \"Qualcomm\",\n};\n\n/**\n * `GPUDevice.adapterInfo`. Chrome leaves `description` empty to limit\n * fingerprinting, so this is usually vendor + architecture: `Apple metal-3`.\n */\nconst webgpuGpuName = (info: AdapterInfoShape | undefined): string | null => {\n  if (!info) {\n    return null;\n  }\n\n  if (info.description) {\n    return info.description;\n  }\n\n  const vendor = info.vendor ? (VENDOR_NAMES[info.vendor] ?? info.vendor) : \"\";\n  const name = [vendor, info.architecture].filter(Boolean).join(\" \");\n\n  return name === \"\" ? null : name;\n};\n\nconst isWebglContext = (value: unknown): value is WebGLRenderingContext | WebGL2RenderingContext =>\n  (typeof WebGL2RenderingContext !== \"undefined\" && value instanceof WebGL2RenderingContext) ||\n  (typeof WebGLRenderingContext !== \"undefined\" && value instanceof WebGLRenderingContext);\n\nconst webglBackend = (gl: WebGLRenderingContext | WebGL2RenderingContext): RenderBackend =>\n  typeof WebGL2RenderingContext !== \"undefined\" && gl instanceof WebGL2RenderingContext\n    ? \"webgl2\"\n    : \"webgl\";\n\nconst readEnvironment = (renderer: PerfRenderer): Environment => {\n  const three = readThreeRevision();\n  const backend = renderer.backend as BackendShape | undefined;\n\n  // WebGPURenderer. Read the backend's own fields: `getContext()` before\n  // `init()` is what the GPU timer learned not to touch.\n  if (backend) {\n    if (backend.isWebGPUBackend) {\n      const device = backend.device;\n\n      return device\n        ? { backend: \"webgpu\", fallback: false, gpu: webgpuGpuName(device.adapterInfo), three }\n        : { backend: null, fallback: false, gpu: null, three };\n    }\n\n    if (backend.isWebGLBackend && isWebglContext(backend.gl)) {\n      return {\n        backend: webglBackend(backend.gl),\n        fallback: backend.parameters?.forceWebGL !== true,\n        gpu: webglGpuName(backend.gl),\n        three,\n      };\n    }\n\n    return { backend: null, fallback: false, gpu: null, three };\n  }\n\n  // WebGLRenderer.\n  const context = renderer.getContext?.();\n\n  return isWebglContext(context)\n    ? { backend: webglBackend(context), fallback: false, gpu: webglGpuName(context), three }\n    : { backend: null, fallback: false, gpu: null, three };\n};\n\nexport { cleanGpuName, readEnvironment };\n","/**\n * Stutter statistics over a window of frame intervals. Average FPS hides a\n * hitch every few seconds; these don't. Stalls (hidden tab, breakpoint) never\n * reach the window, so they don't count as hitches.\n */\nimport type { FrameStats } from \"./types.ts\";\n\n/** A frame over this multiple of the window's median interval is a hitch. */\nconst HITCH_FACTOR = 2;\n\nconst EMPTY: FrameStats = Object.freeze({ frames: 0, hitches: 0, lowFps: 0, p99Ms: 0 });\n\nconst computeFrameStats = (intervals: readonly number[]): FrameStats => {\n  const frames = intervals.length;\n\n  if (frames === 0) {\n    return EMPTY;\n  }\n\n  const sorted = [...intervals].sort((a, b) => a - b);\n  // Nearest rank: the smallest interval at or above 99% of frames.\n  const p99Ms = sorted[Math.ceil(frames * 0.99) - 1]!;\n\n  // 1% low: the mean rate across the slowest 1% of frames (at least one frame).\n  const slowest = Math.max(1, Math.ceil(frames * 0.01));\n  let slowSum = 0;\n\n  for (let index = frames - slowest; index < frames; index += 1) {\n    slowSum += sorted[index]!;\n  }\n\n  const middle = frames >> 1;\n  const median = frames % 2 === 0 ? (sorted[middle - 1]! + sorted[middle]!) / 2 : sorted[middle]!;\n  const threshold = median * HITCH_FACTOR;\n  let hitches = 0;\n\n  for (const interval of intervals) {\n    if (interval > threshold) {\n      hitches += 1;\n    }\n  }\n\n  return Object.freeze({ frames, hitches, lowFps: 1000 / (slowSum / slowest), p99Ms });\n};\n\nexport { computeFrameStats, HITCH_FACTOR };\n","/**\n * Real GPU frame timing.\n *\n * WebGPU: Three's `trackTimestamp` + `resolveTimestampsAsync` (ms, a frame or\n * two late). Never calls `getExtension`: that is what remounted the canvas.\n *\n * WebGL2 fallback (Safari without WebGPU, or a forced GL backend):\n * `EXT_disjoint_timer_query_webgl2`, same pool-of-queries pattern as the\n * platform-typing monitor.\n */\nimport type { PerfRenderer } from \"./types.ts\";\n\ntype DisjointTimerQueryExt = {\n  readonly GPU_DISJOINT_EXT: number;\n  readonly TIME_ELAPSED_EXT: number;\n};\n\nclass GpuTimer {\n  private lastMs = 0;\n  private readonly webgpu: PerfRenderer | null;\n  private webgpuInFlight = false;\n  private readonly gl: WebGL2RenderingContext | null;\n  private readonly ext: DisjointTimerQueryExt | null;\n  private readonly free: WebGLQuery[] = [];\n  private readonly pending: WebGLQuery[] = [];\n  private active: WebGLQuery | null = null;\n\n  private constructor(\n    webgpu: PerfRenderer | null,\n    gl: WebGL2RenderingContext | null,\n    ext: DisjointTimerQueryExt | null,\n    poolSize: number,\n  ) {\n    this.webgpu = webgpu;\n    this.gl = gl;\n    this.ext = ext;\n\n    if (!gl) {\n      return;\n    }\n\n    for (let index = 0; index < poolSize; index += 1) {\n      const query = gl.createQuery();\n\n      if (query) {\n        this.free.push(query);\n      }\n    }\n  }\n\n  static create(renderer: PerfRenderer, poolSize: number): GpuTimer | null {\n    const backend = renderer.backend as { trackTimestamp?: boolean } | undefined;\n\n    if (backend?.trackTimestamp && renderer.resolveTimestampsAsync) {\n      return new GpuTimer(renderer, null, null, poolSize);\n    }\n\n    const context = renderer.getContext?.();\n\n    if (!(context instanceof WebGL2RenderingContext)) {\n      return null;\n    }\n\n    const ext = context.getExtension(\n      \"EXT_disjoint_timer_query_webgl2\",\n    ) as DisjointTimerQueryExt | null;\n\n    return ext ? new GpuTimer(null, context, ext, poolSize) : null;\n  }\n\n  begin() {\n    if (this.webgpu || !this.gl || !this.ext) {\n      return;\n    }\n\n    const query = this.free.pop();\n\n    if (!query) {\n      this.active = null;\n\n      return;\n    }\n\n    this.active = query;\n    this.gl.beginQuery(this.ext.TIME_ELAPSED_EXT, query);\n  }\n\n  end() {\n    if (this.webgpu || !this.gl || !this.ext || !this.active) {\n      return;\n    }\n\n    this.gl.endQuery(this.ext.TIME_ELAPSED_EXT);\n    this.pending.push(this.active);\n    this.active = null;\n  }\n\n  poll() {\n    if (this.webgpu) {\n      this.pollWebgpu();\n\n      return;\n    }\n\n    this.pollWebgl();\n  }\n\n  getMs() {\n    return this.lastMs;\n  }\n\n  dispose() {\n    if (this.gl && this.ext && this.active) {\n      this.gl.endQuery(this.ext.TIME_ELAPSED_EXT);\n      this.active = null;\n    }\n\n    if (this.gl) {\n      for (const query of this.free) {\n        this.gl.deleteQuery(query);\n      }\n\n      for (const query of this.pending) {\n        this.gl.deleteQuery(query);\n      }\n    }\n\n    this.free.length = 0;\n    this.pending.length = 0;\n  }\n\n  private pollWebgpu() {\n    const resolve = this.webgpu?.resolveTimestampsAsync;\n\n    if (!resolve || this.webgpuInFlight) {\n      return;\n    }\n\n    this.webgpuInFlight = true;\n\n    void resolve\n      .call(this.webgpu, \"render\")\n      .then((ms) => {\n        if (typeof ms === \"number\" && Number.isFinite(ms)) {\n          this.lastMs = ms;\n        }\n\n        this.webgpuInFlight = false;\n      })\n      .catch(() => {\n        this.webgpuInFlight = false;\n      });\n  }\n\n  private pollWebgl() {\n    if (!this.gl || !this.ext) {\n      return;\n    }\n\n    const disjoint = this.gl.getParameter(this.ext.GPU_DISJOINT_EXT) as boolean;\n\n    if (disjoint) {\n      while (this.pending.length > 0) {\n        this.free.push(this.pending.shift()!);\n      }\n\n      return;\n    }\n\n    while (this.pending.length > 0) {\n      const query = this.pending[0]!;\n      const ready = this.gl.getQueryParameter(query, this.gl.QUERY_RESULT_AVAILABLE) as boolean;\n\n      if (!ready) {\n        break;\n      }\n\n      this.pending.shift();\n      const ns = this.gl.getQueryParameter(query, this.gl.QUERY_RESULT) as number;\n      this.lastMs = ns / 1e6;\n      this.free.push(query);\n    }\n  }\n}\n\nexport { GpuTimer };\n","/**\n * Fixed-capacity numeric ring buffer. Backs the per-frame timing history the\n * view reads to draw sparklines. Push is O(1); `toArray()` returns values in\n * chronological (oldest → newest) order.\n */\nclass RingBuffer {\n  private readonly data: Float32Array;\n  private readonly capacity: number;\n  private head = 0;\n  private count = 0;\n\n  constructor(capacity: number) {\n    this.capacity = capacity;\n    this.data = new Float32Array(capacity);\n  }\n\n  push(value: number) {\n    this.data[this.head] = value;\n    this.head = (this.head + 1) % this.capacity;\n\n    if (this.count < this.capacity) {\n      this.count += 1;\n    }\n  }\n\n  /** Values oldest → newest. Length grows up to capacity as samples accumulate. */\n  toArray(): number[] {\n    const out = Array.from<number>({ length: this.count });\n    const start = (this.head - this.count + this.capacity) % this.capacity;\n\n    for (let index = 0; index < this.count; index += 1) {\n      out[index] = this.data[(start + index) % this.capacity]!;\n    }\n\n    return out;\n  }\n\n  clear() {\n    this.head = 0;\n    this.count = 0;\n  }\n}\n\nexport { RingBuffer };\n","import { readEnvironment } from \"./environment.ts\";\nimport { computeFrameStats } from \"./frame-stats.ts\";\nimport { GpuTimer } from \"./gpu-timer.ts\";\nimport { RingBuffer } from \"./ring-buffer.ts\";\nimport type {\n  Environment,\n  FrameStats,\n  PerfRenderer,\n  PerformanceMonitorOptions,\n  Sample,\n  TimingMetric,\n} from \"./types.ts\";\n\nconst DEFAULT_GPU_POOL_SIZE = 5;\n/** One monitor per renderer: a second would stack the `render` patch and double-count passes. */\nconst ATTACHED = new WeakSet<PerfRenderer>();\nconst DEFAULT_HISTORY_SIZE = 120;\nconst DEFAULT_FRAME_STATS_SIZE = 1000;\nconst FPS_SMOOTHING = 0.1;\n/**\n * A frame interval past this is a stall (hidden tab, breakpoint, laptop lid),\n * not a slow frame. It is left out of FPS so one gap doesn't flatten the\n * graph's scale for the whole history window.\n */\nconst STALL_MS = 1000;\n\nconst frameCalls = (info: PerfRenderer[\"info\"]) => info.render.drawCalls ?? info.render.calls;\n\nconst programCount = (info: PerfRenderer[\"info\"]) =>\n  info.memory.programs ?? info.programs?.length ?? 0;\n\n/**\n * Collector of three.js frame metrics. Bracket each frame with {@link begin}/\n * {@link end}, or let {@link wrapAnimationLoop} or the R3F `PerfSampler` do it.\n * Works on WebGPURenderer (drawCalls, memory.programs, timestamp queries) and\n * on a WebGL renderer (calls, programs[], timer-query ext).\n *\n * While attached, `renderer.info.autoReset` is off and `info` is reset in\n * {@link begin}; host code that reads `renderer.info` mid-frame sees this\n * frame's counts only. {@link dispose} restores both.\n *\n * CPU time runs from {@link begin} to the return of the frame's last\n * `render()` call, which the `render` patch stamps. So it holds even when\n * {@link end} is only reached on the next tick, as in the R3F sampler: it is\n * the JS work of the frame, not the interval to the next one.\n */\nclass PerformanceMonitor {\n  private readonly renderer: PerfRenderer;\n  private readonly gpuTimer: GpuTimer | null;\n  private readonly originalRender: PerfRenderer[\"render\"];\n  private renderPasses = 0;\n  private lastRenderEndAt: number | null = null;\n  private readonly fpsHistory: RingBuffer;\n  private readonly cpuHistory: RingBuffer;\n  private readonly gpuHistory: RingBuffer;\n  private readonly frameIntervals: RingBuffer;\n  private frameStats: FrameStats | null = null;\n  private cpuStart = 0;\n  private lastBeginAt: number | null = null;\n  private frameFps = 0;\n  private smoothedFps = 0;\n  private sample: Sample;\n  private environment: Environment | null = null;\n\n  constructor(options: PerformanceMonitorOptions) {\n    const {\n      renderer,\n      trackGPU = true,\n      gpuQueryPoolSize = DEFAULT_GPU_POOL_SIZE,\n      historySize = DEFAULT_HISTORY_SIZE,\n      frameStatsSize = DEFAULT_FRAME_STATS_SIZE,\n    } = options;\n\n    if (ATTACHED.has(renderer)) {\n      throw new Error(\n        \"three-meter: a PerformanceMonitor is already attached to this renderer. dispose() it first.\",\n      );\n    }\n\n    ATTACHED.add(renderer);\n    this.renderer = renderer;\n    renderer.info.autoReset = false;\n    this.originalRender = renderer.render;\n\n    renderer.render = (...args: never[]) => {\n      this.renderPasses += 1;\n\n      try {\n        return this.originalRender.apply(renderer, args);\n      } finally {\n        this.lastRenderEndAt = performance.now();\n      }\n    };\n\n    this.gpuTimer = trackGPU ? GpuTimer.create(renderer, gpuQueryPoolSize) : null;\n    this.fpsHistory = new RingBuffer(historySize);\n    this.cpuHistory = new RingBuffer(historySize);\n    this.gpuHistory = new RingBuffer(historySize);\n    this.frameIntervals = new RingBuffer(frameStatsSize);\n    this.sample = this.buildEmptySample();\n  }\n\n  begin() {\n    const now = performance.now();\n\n    if (this.lastBeginAt !== null) {\n      const frameMs = now - this.lastBeginAt;\n\n      // A stall keeps the previous reading rather than logging a near-zero frame.\n      if (frameMs > 0 && frameMs <= STALL_MS) {\n        this.frameFps = 1000 / frameMs;\n        this.frameIntervals.push(frameMs);\n        this.frameStats = null;\n      }\n    }\n\n    this.lastBeginAt = now;\n    this.cpuStart = now;\n    this.lastRenderEndAt = null;\n    this.renderPasses = 0;\n    this.renderer.info.reset();\n    this.gpuTimer?.begin();\n  }\n\n  end() {\n    const now = performance.now();\n    // Without a render this frame there is nothing better than \"until end()\".\n    const cpu = (this.lastRenderEndAt ?? now) - this.cpuStart;\n\n    this.gpuTimer?.end();\n    this.gpuTimer?.poll();\n\n    const gpuMs = this.gpuTimer?.getMs() ?? 0;\n\n    this.smoothedFps =\n      this.smoothedFps === 0\n        ? this.frameFps\n        : this.smoothedFps + (this.frameFps - this.smoothedFps) * FPS_SMOOTHING;\n\n    this.fpsHistory.push(this.frameFps);\n    this.cpuHistory.push(cpu);\n    this.gpuHistory.push(gpuMs);\n\n    const info = this.renderer.info;\n\n    this.sample = Object.freeze({\n      cpu,\n      fps: this.smoothedFps,\n      gpu: { available: this.gpuTimer !== null, ms: gpuMs },\n      render: {\n        calls: frameCalls(info),\n        lines: info.render.lines,\n        passes: this.renderPasses,\n        points: info.render.points,\n        triangles: info.render.triangles,\n      },\n      resources: {\n        geometries: info.memory.geometries,\n        programs: programCount(info),\n        textures: info.memory.textures,\n      },\n    });\n  }\n\n  getSample(): Sample {\n    return this.sample;\n  }\n\n  getHistory(metric: TimingMetric): readonly number[] {\n    switch (metric) {\n      case \"fps\":\n        return this.fpsHistory.toArray();\n      case \"cpu\":\n        return this.cpuHistory.toArray();\n      case \"gpu\":\n        return this.gpuHistory.toArray();\n    }\n  }\n\n  /** 1% low, p99 frame time and hitches. Computed on read, cached until the next frame. */\n  getFrameStats(): FrameStats {\n    this.frameStats ??= computeFrameStats(this.frameIntervals.toArray());\n\n    return this.frameStats;\n  }\n\n  /**\n   * three revision, backend and GPU name. Cached once the backend is known;\n   * before `WebGPURenderer.init()` settles it, `backend` is `null` and the\n   * next call reads again.\n   */\n  getEnvironment(): Environment {\n    if (this.environment) {\n      return this.environment;\n    }\n\n    const environment = Object.freeze(readEnvironment(this.renderer));\n\n    if (environment.backend !== null) {\n      this.environment = environment;\n    }\n\n    return environment;\n  }\n\n  dispose() {\n    ATTACHED.delete(this.renderer);\n    this.renderer.info.autoReset = true;\n    this.renderer.render = this.originalRender;\n    this.gpuTimer?.dispose();\n    this.fpsHistory.clear();\n    this.cpuHistory.clear();\n    this.gpuHistory.clear();\n    this.frameIntervals.clear();\n    this.frameStats = null;\n  }\n\n  private buildEmptySample(): Sample {\n    return Object.freeze({\n      cpu: 0,\n      fps: 0,\n      gpu: { available: this.gpuTimer !== null, ms: 0 },\n      render: { calls: 0, lines: 0, passes: 0, points: 0, triangles: 0 },\n      resources: { geometries: 0, programs: 0, textures: 0 },\n    });\n  }\n}\n\nexport { PerformanceMonitor };\n"],"mappings":"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"}

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { a as PerformanceMonitorOptions, t as PerformanceMonitor } from "./performance-monitor-Br7x3cPt.js";
-import { t as MountPerfHudOptions } from "./mount-perf-hud-v6kLGJUX.js";
+import { o as PerformanceMonitorOptions, t as PerformanceMonitor } from "./performance-monitor-CBN05_BC.js";
+import { t as MountPerfHudOptions } from "./mount-perf-hud-CmINOH3T.js";
 //#region src/react/monitor-store.d.ts
 type MonitorListener = (monitor: PerformanceMonitor | null) => void;
 type PerfMonitorStore = {
@@ -38,7 +38,7 @@ type PerfSamplerProps = Omit<PerformanceMonitorOptions, "renderer"> & {
  * GPU queries then span the render that just ran. The monitor is created in
  * an effect so StrictMode's double mount attaches and detaches cleanly.
  */
-declare function PerfSampler({ gpuQueryPoolSize, historySize, store, trackGPU }: PerfSamplerProps): null;
+declare function PerfSampler({ frameStatsSize, gpuQueryPoolSize, historySize, store, trackGPU }: PerfSamplerProps): null;
 //#endregion
 export { PerfHud, type PerfHudProps, type PerfMonitorStore, PerfSampler, type PerfSamplerProps, createPerfMonitorStore, defaultPerfMonitorStore };
 //# sourceMappingURL=react.d.ts.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { t as PerformanceMonitor } from "./performance-monitor-C8dhWJWR.js";
-import { t as mountPerfHud } from "./mount-perf-hud-Rf98QNxM.js";
+import { t as PerformanceMonitor } from "./performance-monitor-yxsxs57v.js";
+import { t as mountPerfHud } from "./mount-perf-hud-BLs1jkwM.js";
 import { useEffect, useRef } from "react";
 import { useFrame, useThree } from "@react-three/fiber";
 //#region src/react/monitor-store.ts
@@ -98,13 +98,14 @@ function PerfHud({ defaultPlacement, injectStyles, label, mode, parent, refreshH
 * GPU queries then span the render that just ran. The monitor is created in
 * an effect so StrictMode's double mount attaches and detaches cleanly.
 */
-function PerfSampler({ gpuQueryPoolSize, historySize, store, trackGPU }) {
+function PerfSampler({ frameStatsSize, gpuQueryPoolSize, historySize, store, trackGPU }) {
 	const renderer = useThree((state) => state.gl);
 	const monitorRef = useRef(null);
 	const startedRef = useRef(false);
 	const target = store ?? defaultPerfMonitorStore;
 	useEffect(() => {
 		const monitor = new PerformanceMonitor({
+			frameStatsSize,
 			gpuQueryPoolSize,
 			historySize,
 			renderer,
@@ -119,6 +120,7 @@ function PerfSampler({ gpuQueryPoolSize, historySize, store, trackGPU }) {
 			monitor.dispose();
 		};
 	}, [
+		frameStatsSize,
 		gpuQueryPoolSize,
 		historySize,
 		renderer,

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../src/react/monitor-store.ts","../src/react/perf-hud.tsx","../src/react/perf-sampler.tsx"],"sourcesContent":["/**\n * Hands the in-canvas monitor to the DOM-side HUD. A React context can't do\n * it: R3F's `<Canvas>` is its own reconciler root, so a provider outside it\n * isn't visible inside without a bridge. A tiny external store crosses that\n * boundary for free. One default store; pass your own to both components to\n * run two canvases on one page.\n */\nimport type { PerformanceMonitor } from \"../core/performance-monitor.ts\";\n\ntype MonitorListener = (monitor: PerformanceMonitor | null) => void;\n\ntype PerfMonitorStore = {\n  get: () => PerformanceMonitor | null;\n  set: (monitor: PerformanceMonitor | null) => void;\n  subscribe: (listener: MonitorListener) => () => void;\n};\n\nconst createPerfMonitorStore = (): PerfMonitorStore => {\n  let current: PerformanceMonitor | null = null;\n  const listeners = new Set<MonitorListener>();\n\n  return {\n    get: () => current,\n    set: (monitor) => {\n      current = monitor;\n\n      for (const listener of listeners) {\n        listener(monitor);\n      }\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n};\n\nconst defaultPerfMonitorStore = createPerfMonitorStore();\n\nexport { createPerfMonitorStore, defaultPerfMonitorStore };\nexport type { PerfMonitorStore };\n","import { useEffect, useRef } from \"react\";\n\nimport {\n  mountPerfHud,\n  type MountPerfHudOptions,\n  type PerfHudHandle,\n} from \"../ui/mount-perf-hud.ts\";\nimport { defaultPerfMonitorStore, type PerfMonitorStore } from \"./monitor-store.ts\";\n\ntype PerfHudProps = Omit<MountPerfHudOptions, \"settings\"> & {\n  /** Must match the `PerfSampler`'s. Default: the shared store. */\n  store?: PerfMonitorStore;\n};\n\n/**\n * DOM overlay. Render it *outside* `<Canvas>`, or Fiber would treat its markup\n * as three objects. Mounts the dockable HUD whenever a `PerfSampler` has\n * published a monitor and tears it down when that sampler unmounts.\n *\n * `theme`, `mode` and `label` apply live through the handle. `defaultPlacement`\n * is compared by value, so an inline `{{ edge: \"right\" }}` literal is fine.\n * The remaining props (`storageKey`, `parent`, `refreshHz`, `injectStyles`,\n * `store`) remount the HUD when they change.\n */\nfunction PerfHud({\n  defaultPlacement,\n  injectStyles,\n  label,\n  mode,\n  parent,\n  refreshHz,\n  storageKey,\n  store,\n  theme,\n}: PerfHudProps) {\n  const source = store ?? defaultPerfMonitorStore;\n  const handleRef = useRef<PerfHudHandle | null>(null);\n  // The mount effect reads these through refs so changing them never remounts;\n  // the live effects below keep the refs current and push changes to the handle.\n  const themeRef = useRef(theme);\n  const modeRef = useRef(mode);\n  const labelRef = useRef(label);\n  // Primitives, so an inline `{{ edge: \"right\" }}` literal doesn't remount each render.\n  const placementEdge = defaultPlacement?.edge;\n  const placementAlign = defaultPlacement?.align;\n\n  useEffect(() => {\n    const attach = (monitor: ReturnType<PerfMonitorStore[\"get\"]>) => {\n      handleRef.current?.dispose();\n      handleRef.current = null;\n\n      if (!monitor) {\n        return;\n      }\n\n      handleRef.current = mountPerfHud(monitor, {\n        defaultPlacement: placementEdge\n          ? { align: placementAlign, edge: placementEdge }\n          : undefined,\n        injectStyles,\n        label: labelRef.current,\n        mode: modeRef.current,\n        parent,\n        refreshHz,\n        storageKey,\n        theme: themeRef.current,\n      });\n    };\n\n    const unsubscribe = source.subscribe(attach);\n    attach(source.get());\n\n    return () => {\n      unsubscribe();\n      handleRef.current?.dispose();\n      handleRef.current = null;\n    };\n  }, [injectStyles, parent, placementAlign, placementEdge, refreshHz, source, storageKey]);\n\n  useEffect(() => {\n    themeRef.current = theme;\n    handleRef.current?.setTheme(theme ?? \"system\");\n  }, [theme]);\n\n  useEffect(() => {\n    modeRef.current = mode;\n    handleRef.current?.setMode(mode ?? \"compact\");\n  }, [mode]);\n\n  useEffect(() => {\n    labelRef.current = label;\n    handleRef.current?.element.setAttribute(\"aria-label\", label ?? \"Performance\");\n  }, [label]);\n\n  return null;\n}\n\nexport { PerfHud };\nexport type { PerfHudProps };\n","import { useFrame, useThree } from \"@react-three/fiber\";\nimport { useEffect, useRef } from \"react\";\n\nimport { PerformanceMonitor } from \"../core/performance-monitor.ts\";\nimport type { PerformanceMonitorOptions, PerfRenderer } from \"../core/types.ts\";\nimport { defaultPerfMonitorStore, type PerfMonitorStore } from \"./monitor-store.ts\";\n\ntype PerfSamplerProps = Omit<PerformanceMonitorOptions, \"renderer\"> & {\n  /** Where the monitor is published for `PerfHud`. Default: the shared store. */\n  store?: PerfMonitorStore;\n};\n\n/**\n * In-canvas collector. Renders nothing. Fiber runs every `useFrame` before\n * `gl.render`, so the previous frame is closed here and the next one opens, and\n * GPU queries then span the render that just ran. The monitor is created in\n * an effect so StrictMode's double mount attaches and detaches cleanly.\n */\nfunction PerfSampler({ gpuQueryPoolSize, historySize, store, trackGPU }: PerfSamplerProps) {\n  const renderer = useThree((state) => state.gl);\n  const monitorRef = useRef<PerformanceMonitor | null>(null);\n  const startedRef = useRef(false);\n  const target = store ?? defaultPerfMonitorStore;\n\n  useEffect(() => {\n    const monitor = new PerformanceMonitor({\n      gpuQueryPoolSize,\n      historySize,\n      renderer: renderer as unknown as PerfRenderer,\n      trackGPU,\n    });\n    monitorRef.current = monitor;\n    startedRef.current = false;\n    target.set(monitor);\n\n    return () => {\n      target.set(null);\n      monitorRef.current = null;\n      monitor.dispose();\n    };\n  }, [gpuQueryPoolSize, historySize, renderer, target, trackGPU]);\n\n  useFrame(() => {\n    const monitor = monitorRef.current;\n\n    if (!monitor) {\n      return;\n    }\n\n    if (startedRef.current) {\n      monitor.end();\n    }\n\n    startedRef.current = true;\n    monitor.begin();\n  });\n\n  return null;\n}\n\nexport { PerfSampler };\nexport type { PerfSamplerProps };\n"],"mappings":";;;;;AAiBA,MAAM,+BAAiD;CACrD,IAAI,UAAqC;CACzC,MAAM,4BAAY,IAAI,IAAqB;CAE3C,OAAO;EACL,WAAW;EACX,MAAM,YAAY;GAChB,UAAU;GAEV,KAAK,MAAM,YAAY,WACrB,SAAS,OAAO;EAEpB;EACA,YAAY,aAAa;GACvB,UAAU,IAAI,QAAQ;GAEtB,aAAa;IACX,UAAU,OAAO,QAAQ;GAC3B;EACF;CACF;AACF;AAEA,MAAM,0BAA0B,uBAAuB;;;;;;;;;;;;;AChBvD,SAAS,QAAQ,EACf,kBACA,cACA,OACA,MACA,QACA,WACA,YACA,OACA,SACe;CACf,MAAM,SAAS,SAAS;CACxB,MAAM,YAAY,OAA6B,IAAI;CAGnD,MAAM,WAAW,OAAO,KAAK;CAC7B,MAAM,UAAU,OAAO,IAAI;CAC3B,MAAM,WAAW,OAAO,KAAK;CAE7B,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,iBAAiB,kBAAkB;CAEzC,gBAAgB;EACd,MAAM,UAAU,YAAiD;GAC/D,UAAU,SAAS,QAAQ;GAC3B,UAAU,UAAU;GAEpB,IAAI,CAAC,SACH;GAGF,UAAU,UAAU,aAAa,SAAS;IACxC,kBAAkB,gBACd;KAAE,OAAO;KAAgB,MAAM;IAAc,IAC7C,KAAA;IACJ;IACA,OAAO,SAAS;IAChB,MAAM,QAAQ;IACd;IACA;IACA;IACA,OAAO,SAAS;GAClB,CAAC;EACH;EAEA,MAAM,cAAc,OAAO,UAAU,MAAM;EAC3C,OAAO,OAAO,IAAI,CAAC;EAEnB,aAAa;GACX,YAAY;GACZ,UAAU,SAAS,QAAQ;GAC3B,UAAU,UAAU;EACtB;CACF,GAAG;EAAC;EAAc;EAAQ;EAAgB;EAAe;EAAW;EAAQ;CAAU,CAAC;CAEvF,gBAAgB;EACd,SAAS,UAAU;EACnB,UAAU,SAAS,SAAS,SAAS,QAAQ;CAC/C,GAAG,CAAC,KAAK,CAAC;CAEV,gBAAgB;EACd,QAAQ,UAAU;EAClB,UAAU,SAAS,QAAQ,QAAQ,SAAS;CAC9C,GAAG,CAAC,IAAI,CAAC;CAET,gBAAgB;EACd,SAAS,UAAU;EACnB,UAAU,SAAS,QAAQ,aAAa,cAAc,SAAS,aAAa;CAC9E,GAAG,CAAC,KAAK,CAAC;CAEV,OAAO;AACT;;;;;;;;;AC7EA,SAAS,YAAY,EAAE,kBAAkB,aAAa,OAAO,YAA8B;CACzF,MAAM,WAAW,UAAU,UAAU,MAAM,EAAE;CAC7C,MAAM,aAAa,OAAkC,IAAI;CACzD,MAAM,aAAa,OAAO,KAAK;CAC/B,MAAM,SAAS,SAAS;CAExB,gBAAgB;EACd,MAAM,UAAU,IAAI,mBAAmB;GACrC;GACA;GACU;GACV;EACF,CAAC;EACD,WAAW,UAAU;EACrB,WAAW,UAAU;EACrB,OAAO,IAAI,OAAO;EAElB,aAAa;GACX,OAAO,IAAI,IAAI;GACf,WAAW,UAAU;GACrB,QAAQ,QAAQ;EAClB;CACF,GAAG;EAAC;EAAkB;EAAa;EAAU;EAAQ;CAAQ,CAAC;CAE9D,eAAe;EACb,MAAM,UAAU,WAAW;EAE3B,IAAI,CAAC,SACH;EAGF,IAAI,WAAW,SACb,QAAQ,IAAI;EAGd,WAAW,UAAU;EACrB,QAAQ,MAAM;CAChB,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"react.js","names":[],"sources":["../src/react/monitor-store.ts","../src/react/perf-hud.tsx","../src/react/perf-sampler.tsx"],"sourcesContent":["/**\n * Hands the in-canvas monitor to the DOM-side HUD. A React context can't do\n * it: R3F's `<Canvas>` is its own reconciler root, so a provider outside it\n * isn't visible inside without a bridge. A tiny external store crosses that\n * boundary for free. One default store; pass your own to both components to\n * run two canvases on one page.\n */\nimport type { PerformanceMonitor } from \"../core/performance-monitor.ts\";\n\ntype MonitorListener = (monitor: PerformanceMonitor | null) => void;\n\ntype PerfMonitorStore = {\n  get: () => PerformanceMonitor | null;\n  set: (monitor: PerformanceMonitor | null) => void;\n  subscribe: (listener: MonitorListener) => () => void;\n};\n\nconst createPerfMonitorStore = (): PerfMonitorStore => {\n  let current: PerformanceMonitor | null = null;\n  const listeners = new Set<MonitorListener>();\n\n  return {\n    get: () => current,\n    set: (monitor) => {\n      current = monitor;\n\n      for (const listener of listeners) {\n        listener(monitor);\n      }\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n};\n\nconst defaultPerfMonitorStore = createPerfMonitorStore();\n\nexport { createPerfMonitorStore, defaultPerfMonitorStore };\nexport type { PerfMonitorStore };\n","import { useEffect, useRef } from \"react\";\n\nimport {\n  mountPerfHud,\n  type MountPerfHudOptions,\n  type PerfHudHandle,\n} from \"../ui/mount-perf-hud.ts\";\nimport { defaultPerfMonitorStore, type PerfMonitorStore } from \"./monitor-store.ts\";\n\ntype PerfHudProps = Omit<MountPerfHudOptions, \"settings\"> & {\n  /** Must match the `PerfSampler`'s. Default: the shared store. */\n  store?: PerfMonitorStore;\n};\n\n/**\n * DOM overlay. Render it *outside* `<Canvas>`, or Fiber would treat its markup\n * as three objects. Mounts the dockable HUD whenever a `PerfSampler` has\n * published a monitor and tears it down when that sampler unmounts.\n *\n * `theme`, `mode` and `label` apply live through the handle. `defaultPlacement`\n * is compared by value, so an inline `{{ edge: \"right\" }}` literal is fine.\n * The remaining props (`storageKey`, `parent`, `refreshHz`, `injectStyles`,\n * `store`) remount the HUD when they change.\n */\nfunction PerfHud({\n  defaultPlacement,\n  injectStyles,\n  label,\n  mode,\n  parent,\n  refreshHz,\n  storageKey,\n  store,\n  theme,\n}: PerfHudProps) {\n  const source = store ?? defaultPerfMonitorStore;\n  const handleRef = useRef<PerfHudHandle | null>(null);\n  // The mount effect reads these through refs so changing them never remounts;\n  // the live effects below keep the refs current and push changes to the handle.\n  const themeRef = useRef(theme);\n  const modeRef = useRef(mode);\n  const labelRef = useRef(label);\n  // Primitives, so an inline `{{ edge: \"right\" }}` literal doesn't remount each render.\n  const placementEdge = defaultPlacement?.edge;\n  const placementAlign = defaultPlacement?.align;\n\n  useEffect(() => {\n    const attach = (monitor: ReturnType<PerfMonitorStore[\"get\"]>) => {\n      handleRef.current?.dispose();\n      handleRef.current = null;\n\n      if (!monitor) {\n        return;\n      }\n\n      handleRef.current = mountPerfHud(monitor, {\n        defaultPlacement: placementEdge\n          ? { align: placementAlign, edge: placementEdge }\n          : undefined,\n        injectStyles,\n        label: labelRef.current,\n        mode: modeRef.current,\n        parent,\n        refreshHz,\n        storageKey,\n        theme: themeRef.current,\n      });\n    };\n\n    const unsubscribe = source.subscribe(attach);\n    attach(source.get());\n\n    return () => {\n      unsubscribe();\n      handleRef.current?.dispose();\n      handleRef.current = null;\n    };\n  }, [injectStyles, parent, placementAlign, placementEdge, refreshHz, source, storageKey]);\n\n  useEffect(() => {\n    themeRef.current = theme;\n    handleRef.current?.setTheme(theme ?? \"system\");\n  }, [theme]);\n\n  useEffect(() => {\n    modeRef.current = mode;\n    handleRef.current?.setMode(mode ?? \"compact\");\n  }, [mode]);\n\n  useEffect(() => {\n    labelRef.current = label;\n    handleRef.current?.element.setAttribute(\"aria-label\", label ?? \"Performance\");\n  }, [label]);\n\n  return null;\n}\n\nexport { PerfHud };\nexport type { PerfHudProps };\n","import { useFrame, useThree } from \"@react-three/fiber\";\nimport { useEffect, useRef } from \"react\";\n\nimport { PerformanceMonitor } from \"../core/performance-monitor.ts\";\nimport type { PerformanceMonitorOptions, PerfRenderer } from \"../core/types.ts\";\nimport { defaultPerfMonitorStore, type PerfMonitorStore } from \"./monitor-store.ts\";\n\ntype PerfSamplerProps = Omit<PerformanceMonitorOptions, \"renderer\"> & {\n  /** Where the monitor is published for `PerfHud`. Default: the shared store. */\n  store?: PerfMonitorStore;\n};\n\n/**\n * In-canvas collector. Renders nothing. Fiber runs every `useFrame` before\n * `gl.render`, so the previous frame is closed here and the next one opens, and\n * GPU queries then span the render that just ran. The monitor is created in\n * an effect so StrictMode's double mount attaches and detaches cleanly.\n */\nfunction PerfSampler({\n  frameStatsSize,\n  gpuQueryPoolSize,\n  historySize,\n  store,\n  trackGPU,\n}: PerfSamplerProps) {\n  const renderer = useThree((state) => state.gl);\n  const monitorRef = useRef<PerformanceMonitor | null>(null);\n  const startedRef = useRef(false);\n  const target = store ?? defaultPerfMonitorStore;\n\n  useEffect(() => {\n    const monitor = new PerformanceMonitor({\n      frameStatsSize,\n      gpuQueryPoolSize,\n      historySize,\n      renderer: renderer as unknown as PerfRenderer,\n      trackGPU,\n    });\n    monitorRef.current = monitor;\n    startedRef.current = false;\n    target.set(monitor);\n\n    return () => {\n      target.set(null);\n      monitorRef.current = null;\n      monitor.dispose();\n    };\n  }, [frameStatsSize, gpuQueryPoolSize, historySize, renderer, target, trackGPU]);\n\n  useFrame(() => {\n    const monitor = monitorRef.current;\n\n    if (!monitor) {\n      return;\n    }\n\n    if (startedRef.current) {\n      monitor.end();\n    }\n\n    startedRef.current = true;\n    monitor.begin();\n  });\n\n  return null;\n}\n\nexport { PerfSampler };\nexport type { PerfSamplerProps };\n"],"mappings":";;;;;AAiBA,MAAM,+BAAiD;CACrD,IAAI,UAAqC;CACzC,MAAM,4BAAY,IAAI,IAAqB;CAE3C,OAAO;EACL,WAAW;EACX,MAAM,YAAY;GAChB,UAAU;GAEV,KAAK,MAAM,YAAY,WACrB,SAAS,OAAO;EAEpB;EACA,YAAY,aAAa;GACvB,UAAU,IAAI,QAAQ;GAEtB,aAAa;IACX,UAAU,OAAO,QAAQ;GAC3B;EACF;CACF;AACF;AAEA,MAAM,0BAA0B,uBAAuB;;;;;;;;;;;;;AChBvD,SAAS,QAAQ,EACf,kBACA,cACA,OACA,MACA,QACA,WACA,YACA,OACA,SACe;CACf,MAAM,SAAS,SAAS;CACxB,MAAM,YAAY,OAA6B,IAAI;CAGnD,MAAM,WAAW,OAAO,KAAK;CAC7B,MAAM,UAAU,OAAO,IAAI;CAC3B,MAAM,WAAW,OAAO,KAAK;CAE7B,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,iBAAiB,kBAAkB;CAEzC,gBAAgB;EACd,MAAM,UAAU,YAAiD;GAC/D,UAAU,SAAS,QAAQ;GAC3B,UAAU,UAAU;GAEpB,IAAI,CAAC,SACH;GAGF,UAAU,UAAU,aAAa,SAAS;IACxC,kBAAkB,gBACd;KAAE,OAAO;KAAgB,MAAM;IAAc,IAC7C,KAAA;IACJ;IACA,OAAO,SAAS;IAChB,MAAM,QAAQ;IACd;IACA;IACA;IACA,OAAO,SAAS;GAClB,CAAC;EACH;EAEA,MAAM,cAAc,OAAO,UAAU,MAAM;EAC3C,OAAO,OAAO,IAAI,CAAC;EAEnB,aAAa;GACX,YAAY;GACZ,UAAU,SAAS,QAAQ;GAC3B,UAAU,UAAU;EACtB;CACF,GAAG;EAAC;EAAc;EAAQ;EAAgB;EAAe;EAAW;EAAQ;CAAU,CAAC;CAEvF,gBAAgB;EACd,SAAS,UAAU;EACnB,UAAU,SAAS,SAAS,SAAS,QAAQ;CAC/C,GAAG,CAAC,KAAK,CAAC;CAEV,gBAAgB;EACd,QAAQ,UAAU;EAClB,UAAU,SAAS,QAAQ,QAAQ,SAAS;CAC9C,GAAG,CAAC,IAAI,CAAC;CAET,gBAAgB;EACd,SAAS,UAAU;EACnB,UAAU,SAAS,QAAQ,aAAa,cAAc,SAAS,aAAa;CAC9E,GAAG,CAAC,KAAK,CAAC;CAEV,OAAO;AACT;;;;;;;;;AC7EA,SAAS,YAAY,EACnB,gBACA,kBACA,aACA,OACA,YACmB;CACnB,MAAM,WAAW,UAAU,UAAU,MAAM,EAAE;CAC7C,MAAM,aAAa,OAAkC,IAAI;CACzD,MAAM,aAAa,OAAO,KAAK;CAC/B,MAAM,SAAS,SAAS;CAExB,gBAAgB;EACd,MAAM,UAAU,IAAI,mBAAmB;GACrC;GACA;GACA;GACU;GACV;EACF,CAAC;EACD,WAAW,UAAU;EACrB,WAAW,UAAU;EACrB,OAAO,IAAI,OAAO;EAElB,aAAa;GACX,OAAO,IAAI,IAAI;GACf,WAAW,UAAU;GACrB,QAAQ,QAAQ;EAClB;CACF,GAAG;EAAC;EAAgB;EAAkB;EAAa;EAAU;EAAQ;CAAQ,CAAC;CAE9E,eAAe;EACb,MAAM,UAAU,WAAW;EAE3B,IAAI,CAAC,SACH;EAGF,IAAI,WAAW,SACb,QAAQ,IAAI;EAGd,WAAW,UAAU;EACrB,QAAQ,MAAM;CAChB,CAAC;CAED,OAAO;AACT"}

package/dist/styles.css

@@ -176,6 +176,27 @@
   color: inherit;
 }
 
+.perf-monitor__button {
+  flex: none;
+  min-width: 7ch;
+  padding: 0 6px;
+  border: 1px solid var(--perf-border);
+  border-radius: 3px;
+  background: var(--perf-row);
+  color: var(--perf-fg-dim);
+  font: inherit;
+  cursor: pointer;
+}
+
+.perf-monitor__button:hover {
+  color: var(--perf-fg);
+}
+
+.perf-monitor__button:focus-visible {
+  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);
+  outline-offset: 1px;
+}
+
 .perf-monitor__checkbox {
   flex: none;
   margin: 0;

package/dist/ui.d.ts

@@ -1,11 +1,16 @@
-import { C as dockPanel, S as ScreenEdge, _ as DefaultPlacement, a as PerformanceViewMode, b as DockPanelOptions, c as HudDefaults, d as HudSettingsOptions, f as HudTheme, g as isThemeMode, h as ThemeMode, i as PerformanceView, l as HudSelection, m as THEME_MODES, n as PerfHudHandle, o as PerformanceViewOptions, p as ResolvedTheme, r as mountPerfHud, s as DEFAULT_STORAGE_KEY, t as MountPerfHudOptions, u as HudSettings, v as DockAlign, x as Placement, y as DockHandle } from "./mount-perf-hud-v6kLGJUX.js";
+import { t as PerformanceMonitor } from "./performance-monitor-CBN05_BC.js";
+import { C as dockPanel, S as ScreenEdge, _ as DefaultPlacement, a as PerformanceViewMode, b as DockPanelOptions, c as HudDefaults, d as HudSettingsOptions, f as HudTheme, g as isThemeMode, h as ThemeMode, i as PerformanceView, l as HudSelection, m as THEME_MODES, n as PerfHudHandle, o as PerformanceViewOptions, p as ResolvedTheme, r as mountPerfHud, s as DEFAULT_STORAGE_KEY, t as MountPerfHudOptions, u as HudSettings, v as DockAlign, x as Placement, y as DockHandle } from "./mount-perf-hud-CmINOH3T.js";
+//#region src/ui/report.d.ts
+/** The report for `monitor` right now, as Markdown ready to paste into an issue. */
+declare const formatReport: (monitor: PerformanceMonitor) => string;
+//#endregion
 //#region src/ui/styles.d.ts
-declare const PERF_HUD_STYLES = "\n.perf-hud,\n.perf-monitor {\n  --perf-bg: rgba(22, 24, 29, 0.85);\n  --perf-fg: #e6e8eb;\n  --perf-fg-dim: #c5c8ce;\n  --perf-muted: #8b909a;\n  --perf-row: rgba(255, 255, 255, 0.04);\n  --perf-border: rgba(255, 255, 255, 0.12);\n  --perf-accent: #60a5fa;\n  --perf-shadow: 0 8px 24px rgba(0, 0, 0, 0.32);\n\n  color-scheme: dark;\n}\n\n.perf-hud[data-theme=\"light\"],\n.perf-monitor[data-theme=\"light\"] {\n  --perf-bg: rgba(250, 250, 252, 0.88);\n  --perf-fg: #1a1c21;\n  --perf-fg-dim: #4b5058;\n  --perf-muted: #6b7079;\n  --perf-row: rgba(0, 0, 0, 0.05);\n  --perf-border: rgba(0, 0, 0, 0.12);\n  --perf-accent: #2563eb;\n  --perf-shadow: 0 8px 24px rgba(0, 0, 0, 0.16);\n\n  color-scheme: light;\n}\n\n.perf-monitor {\n  display: flex;\n  flex-direction: column;\n  gap: 10px;\n  padding: 8px;\n  font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;\n  font-size: 11px;\n  line-height: 1.4;\n  color: var(--perf-fg);\n}\n\n.perf-monitor__graphs {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n.perf-monitor__graph {\n  position: relative;\n  height: 40px;\n  background: var(--perf-row);\n  border-radius: 4px;\n  overflow: hidden;\n}\n\n.perf-monitor__canvas {\n  display: block;\n  width: 100%;\n  height: 100%;\n}\n\n.perf-monitor__graph-overlay {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0 8px;\n  pointer-events: none;\n}\n\n.perf-monitor__graph-head {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  cursor: pointer;\n}\n\n.perf-monitor__graph-overlay .perf-monitor__graph-head {\n  pointer-events: auto;\n}\n\n.perf-monitor__graph-label {\n  color: var(--perf-muted);\n  text-transform: uppercase;\n  letter-spacing: 0.06em;\n  font-size: 10px;\n}\n\n.perf-monitor__graph-value {\n  min-width: 6ch;\n  font-weight: 600;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__section {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n}\n\n.perf-monitor__row {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 2px 6px;\n  border-radius: 3px;\n  cursor: pointer;\n}\n\n.perf-monitor__row:nth-child(even) {\n  background: var(--perf-row);\n}\n\n.perf-monitor__label {\n  flex: 1;\n  color: var(--perf-muted);\n}\n\n.perf-monitor__icon {\n  flex: none;\n  width: 12px;\n  height: 12px;\n  color: var(--perf-muted);\n}\n\n.perf-monitor__options {\n  padding-bottom: 8px;\n  border-bottom: 1px solid var(--perf-border);\n}\n\n.perf-monitor__row--static {\n  cursor: default;\n}\n\n/* Light / system / dark, as a small segmented radio group. */\n.perf-monitor__segment {\n  display: inline-flex;\n  flex: none;\n  gap: 1px;\n  padding: 1px;\n  border-radius: 4px;\n  background: var(--perf-row);\n}\n\n.perf-monitor__segment-option {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 16px;\n  padding: 0;\n  border: 0;\n  border-radius: 3px;\n  background: transparent;\n  color: var(--perf-muted);\n  cursor: pointer;\n}\n\n.perf-monitor__segment-option:hover {\n  color: var(--perf-fg);\n}\n\n.perf-monitor__segment-option[aria-checked=\"true\"] {\n  color: var(--perf-fg);\n  background: var(--perf-border);\n}\n\n.perf-monitor__segment-option:focus-visible {\n  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);\n  outline-offset: 1px;\n}\n\n.perf-monitor__segment-option .perf-monitor__icon {\n  width: 11px;\n  height: 11px;\n  color: inherit;\n}\n\n.perf-monitor__checkbox {\n  flex: none;\n  margin: 0;\n  width: 12px;\n  height: 12px;\n  accent-color: var(--perf-accent);\n  cursor: pointer;\n}\n\n.perf-monitor__value {\n  min-width: 7ch;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__hud {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 2px;\n}\n\n.perf-monitor__hud-graphs {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n\n.perf-monitor__hud-graphs:empty {\n  display: none;\n}\n\n.perf-monitor__hud-graph {\n  position: relative;\n  height: 28px;\n  background: var(--perf-row);\n  border-radius: 4px;\n  overflow: hidden;\n}\n\n.perf-monitor__hud-grid {\n  display: grid;\n  grid-template-columns: auto 6ch auto 6ch;\n  align-items: baseline;\n  gap: 2px 8px;\n}\n\n.perf-monitor__hud-grid:empty {\n  display: none;\n}\n\n.perf-monitor__hud-item {\n  display: contents;\n}\n\n.perf-monitor__hud-label {\n  color: var(--perf-muted);\n  font-size: 10px;\n}\n\n.perf-monitor__hud-value {\n  font-weight: 600;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__footer {\n  display: flex;\n  align-items: flex-start;\n  gap: 6px;\n  padding: 8px 6px 0;\n  border-top: 1px solid var(--perf-border);\n  color: var(--perf-muted);\n  font-size: 10px;\n}\n\n.perf-monitor__footer-body {\n  display: flex;\n  flex: 1;\n  flex-direction: column;\n  gap: 4px;\n  min-width: 0;\n}\n\n.perf-monitor__footer-row {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  min-width: 0;\n}\n\n.perf-monitor__footer-row[hidden],\n.perf-monitor__badge[hidden] {\n  display: none;\n}\n\n.perf-monitor__footer-gpu {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--perf-fg-dim);\n}\n\n.perf-monitor__badge {\n  flex: none;\n  padding: 0 5px;\n  border: 1px solid var(--perf-border);\n  border-radius: 3px;\n  color: var(--perf-fg-dim);\n  letter-spacing: 0.04em;\n}\n\n.perf-monitor__badge.is-fallback {\n  border-color: #f59e0b;\n  color: #f59e0b;\n}\n\n.perf-monitor[data-theme=\"light\"] .perf-monitor__badge.is-fallback {\n  border-color: #d97706;\n  color: #b45309;\n}\n\n.perf-monitor__link {\n  color: inherit;\n  text-decoration: none;\n}\n\n.perf-monitor__link:hover,\n.perf-monitor__link:focus-visible {\n  color: var(--perf-accent);\n  text-decoration: underline;\n}\n\n.perf-monitor--full .perf-monitor__hud {\n  display: none;\n}\n\n.perf-monitor--compact .perf-monitor__graphs,\n.perf-monitor--compact .perf-monitor__section,\n.perf-monitor--compact:not(.perf-monitor--info) .perf-monitor__footer,\n.perf-monitor--compact .perf-monitor__footer > .perf-monitor__checkbox {\n  display: none;\n}\n\n.perf-monitor--compact .perf-monitor__footer {\n  padding: 6px 2px 2px;\n}\n\n.perf-monitor--compact {\n  padding: 4px 8px;\n}\n\n.perf-hud {\n  position: fixed;\n  z-index: 9999;\n  /* Safari resolves width:100% canvases against the viewport on a fixed\n     host with auto width. Shrink-wrap so expand stays a card, not the window. */\n  width: max-content;\n  max-width: min(20rem, calc(100vw - 48px));\n  overflow: visible;\n  background: transparent;\n  pointer-events: none;\n  user-select: none;\n  touch-action: none;\n}\n\n.perf-hud--full > .perf-monitor {\n  width: 16rem;\n  max-width: 100%;\n}\n\n.perf-hud > .perf-monitor {\n  position: relative;\n  z-index: 1;\n  max-height: 70vh;\n  overflow: auto;\n  background: var(--perf-bg);\n  border-radius: 6px;\n  box-shadow: var(--perf-shadow);\n  backdrop-filter: blur(2px);\n  pointer-events: auto;\n  transition: opacity 0.25s ease;\n}\n\n.perf-hud--dim:not(.is-awake):not(.is-dragging) > .perf-monitor {\n  opacity: 0.32;\n}\n\n.perf-hud__hotspot {\n  position: absolute;\n  z-index: 0;\n  inset: -20px;\n  pointer-events: auto;\n}\n\n.perf-hud:not([data-edge=\"right\"]) .perf-hud__hotspot {\n  right: -46px;\n}\n\n.perf-hud[data-edge=\"right\"] .perf-hud__hotspot {\n  left: -46px;\n}\n\n.perf-hud__tools {\n  position: absolute;\n  top: 0;\n  z-index: 2;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  opacity: 0;\n  pointer-events: none;\n  transition: opacity 0.15s ease;\n}\n\n.perf-hud.is-awake .perf-hud__tools,\n.perf-hud.is-dragging .perf-hud__tools {\n  opacity: 1;\n  pointer-events: auto;\n}\n\n/* Inward side: right by default, left when docked to the right edge. */\n.perf-hud:not([data-edge=\"right\"]) .perf-hud__tools {\n  left: calc(100% + 6px);\n}\n\n.perf-hud[data-edge=\"right\"] .perf-hud__tools {\n  right: calc(100% + 6px);\n}\n\n.perf-hud__disc {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  padding: 0;\n  border: 0;\n  border-radius: 999px;\n  background: var(--perf-bg);\n  box-shadow: var(--perf-shadow);\n  color: var(--perf-fg-dim);\n  cursor: pointer;\n  backdrop-filter: blur(2px);\n}\n\n.perf-hud__icon {\n  width: 12px;\n  height: 12px;\n}\n\n.perf-hud__drag {\n  cursor: grab;\n}\n\n.perf-hud.is-dragging .perf-hud__drag {\n  cursor: grabbing;\n}\n\n.perf-hud__disc:hover,\n.perf-hud__disc:focus-visible,\n.perf-hud__disc[aria-pressed=\"true\"] {\n  color: var(--perf-fg);\n  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);\n  outline-offset: 1px;\n}\n";
+declare const PERF_HUD_STYLES = "\n.perf-hud,\n.perf-monitor {\n  --perf-bg: rgba(22, 24, 29, 0.85);\n  --perf-fg: #e6e8eb;\n  --perf-fg-dim: #c5c8ce;\n  --perf-muted: #8b909a;\n  --perf-row: rgba(255, 255, 255, 0.04);\n  --perf-border: rgba(255, 255, 255, 0.12);\n  --perf-accent: #60a5fa;\n  --perf-shadow: 0 8px 24px rgba(0, 0, 0, 0.32);\n\n  color-scheme: dark;\n}\n\n.perf-hud[data-theme=\"light\"],\n.perf-monitor[data-theme=\"light\"] {\n  --perf-bg: rgba(250, 250, 252, 0.88);\n  --perf-fg: #1a1c21;\n  --perf-fg-dim: #4b5058;\n  --perf-muted: #6b7079;\n  --perf-row: rgba(0, 0, 0, 0.05);\n  --perf-border: rgba(0, 0, 0, 0.12);\n  --perf-accent: #2563eb;\n  --perf-shadow: 0 8px 24px rgba(0, 0, 0, 0.16);\n\n  color-scheme: light;\n}\n\n.perf-monitor {\n  display: flex;\n  flex-direction: column;\n  gap: 10px;\n  padding: 8px;\n  font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;\n  font-size: 11px;\n  line-height: 1.4;\n  color: var(--perf-fg);\n}\n\n.perf-monitor__graphs {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n.perf-monitor__graph {\n  position: relative;\n  height: 40px;\n  background: var(--perf-row);\n  border-radius: 4px;\n  overflow: hidden;\n}\n\n.perf-monitor__canvas {\n  display: block;\n  width: 100%;\n  height: 100%;\n}\n\n.perf-monitor__graph-overlay {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0 8px;\n  pointer-events: none;\n}\n\n.perf-monitor__graph-head {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  cursor: pointer;\n}\n\n.perf-monitor__graph-overlay .perf-monitor__graph-head {\n  pointer-events: auto;\n}\n\n.perf-monitor__graph-label {\n  color: var(--perf-muted);\n  text-transform: uppercase;\n  letter-spacing: 0.06em;\n  font-size: 10px;\n}\n\n.perf-monitor__graph-value {\n  min-width: 6ch;\n  font-weight: 600;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__section {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n}\n\n.perf-monitor__row {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 2px 6px;\n  border-radius: 3px;\n  cursor: pointer;\n}\n\n.perf-monitor__row:nth-child(even) {\n  background: var(--perf-row);\n}\n\n.perf-monitor__label {\n  flex: 1;\n  color: var(--perf-muted);\n}\n\n.perf-monitor__icon {\n  flex: none;\n  width: 12px;\n  height: 12px;\n  color: var(--perf-muted);\n}\n\n.perf-monitor__options {\n  padding-bottom: 8px;\n  border-bottom: 1px solid var(--perf-border);\n}\n\n.perf-monitor__row--static {\n  cursor: default;\n}\n\n/* Light / system / dark, as a small segmented radio group. */\n.perf-monitor__segment {\n  display: inline-flex;\n  flex: none;\n  gap: 1px;\n  padding: 1px;\n  border-radius: 4px;\n  background: var(--perf-row);\n}\n\n.perf-monitor__segment-option {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 16px;\n  padding: 0;\n  border: 0;\n  border-radius: 3px;\n  background: transparent;\n  color: var(--perf-muted);\n  cursor: pointer;\n}\n\n.perf-monitor__segment-option:hover {\n  color: var(--perf-fg);\n}\n\n.perf-monitor__segment-option[aria-checked=\"true\"] {\n  color: var(--perf-fg);\n  background: var(--perf-border);\n}\n\n.perf-monitor__segment-option:focus-visible {\n  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);\n  outline-offset: 1px;\n}\n\n.perf-monitor__segment-option .perf-monitor__icon {\n  width: 11px;\n  height: 11px;\n  color: inherit;\n}\n\n.perf-monitor__button {\n  flex: none;\n  min-width: 7ch;\n  padding: 0 6px;\n  border: 1px solid var(--perf-border);\n  border-radius: 3px;\n  background: var(--perf-row);\n  color: var(--perf-fg-dim);\n  font: inherit;\n  cursor: pointer;\n}\n\n.perf-monitor__button:hover {\n  color: var(--perf-fg);\n}\n\n.perf-monitor__button:focus-visible {\n  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);\n  outline-offset: 1px;\n}\n\n.perf-monitor__checkbox {\n  flex: none;\n  margin: 0;\n  width: 12px;\n  height: 12px;\n  accent-color: var(--perf-accent);\n  cursor: pointer;\n}\n\n.perf-monitor__value {\n  min-width: 7ch;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__hud {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 2px;\n}\n\n.perf-monitor__hud-graphs {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n\n.perf-monitor__hud-graphs:empty {\n  display: none;\n}\n\n.perf-monitor__hud-graph {\n  position: relative;\n  height: 28px;\n  background: var(--perf-row);\n  border-radius: 4px;\n  overflow: hidden;\n}\n\n.perf-monitor__hud-grid {\n  display: grid;\n  grid-template-columns: auto 6ch auto 6ch;\n  align-items: baseline;\n  gap: 2px 8px;\n}\n\n.perf-monitor__hud-grid:empty {\n  display: none;\n}\n\n.perf-monitor__hud-item {\n  display: contents;\n}\n\n.perf-monitor__hud-label {\n  color: var(--perf-muted);\n  font-size: 10px;\n}\n\n.perf-monitor__hud-value {\n  font-weight: 600;\n  font-variant-numeric: tabular-nums lining-nums;\n  text-align: right;\n}\n\n.perf-monitor__footer {\n  display: flex;\n  align-items: flex-start;\n  gap: 6px;\n  padding: 8px 6px 0;\n  border-top: 1px solid var(--perf-border);\n  color: var(--perf-muted);\n  font-size: 10px;\n}\n\n.perf-monitor__footer-body {\n  display: flex;\n  flex: 1;\n  flex-direction: column;\n  gap: 4px;\n  min-width: 0;\n}\n\n.perf-monitor__footer-row {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  min-width: 0;\n}\n\n.perf-monitor__footer-row[hidden],\n.perf-monitor__badge[hidden] {\n  display: none;\n}\n\n.perf-monitor__footer-gpu {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--perf-fg-dim);\n}\n\n.perf-monitor__badge {\n  flex: none;\n  padding: 0 5px;\n  border: 1px solid var(--perf-border);\n  border-radius: 3px;\n  color: var(--perf-fg-dim);\n  letter-spacing: 0.04em;\n}\n\n.perf-monitor__badge.is-fallback {\n  border-color: #f59e0b;\n  color: #f59e0b;\n}\n\n.perf-monitor[data-theme=\"light\"] .perf-monitor__badge.is-fallback {\n  border-color: #d97706;\n  color: #b45309;\n}\n\n.perf-monitor__link {\n  color: inherit;\n  text-decoration: none;\n}\n\n.perf-monitor__link:hover,\n.perf-monitor__link:focus-visible {\n  color: var(--perf-accent);\n  text-decoration: underline;\n}\n\n.perf-monitor--full .perf-monitor__hud {\n  display: none;\n}\n\n.perf-monitor--compact .perf-monitor__graphs,\n.perf-monitor--compact .perf-monitor__section,\n.perf-monitor--compact:not(.perf-monitor--info) .perf-monitor__footer,\n.perf-monitor--compact .perf-monitor__footer > .perf-monitor__checkbox {\n  display: none;\n}\n\n.perf-monitor--compact .perf-monitor__footer {\n  padding: 6px 2px 2px;\n}\n\n.perf-monitor--compact {\n  padding: 4px 8px;\n}\n\n.perf-hud {\n  position: fixed;\n  z-index: 9999;\n  /* Safari resolves width:100% canvases against the viewport on a fixed\n     host with auto width. Shrink-wrap so expand stays a card, not the window. */\n  width: max-content;\n  max-width: min(20rem, calc(100vw - 48px));\n  overflow: visible;\n  background: transparent;\n  pointer-events: none;\n  user-select: none;\n  touch-action: none;\n}\n\n.perf-hud--full > .perf-monitor {\n  width: 16rem;\n  max-width: 100%;\n}\n\n.perf-hud > .perf-monitor {\n  position: relative;\n  z-index: 1;\n  max-height: 70vh;\n  overflow: auto;\n  background: var(--perf-bg);\n  border-radius: 6px;\n  box-shadow: var(--perf-shadow);\n  backdrop-filter: blur(2px);\n  pointer-events: auto;\n  transition: opacity 0.25s ease;\n}\n\n.perf-hud--dim:not(.is-awake):not(.is-dragging) > .perf-monitor {\n  opacity: 0.32;\n}\n\n.perf-hud__hotspot {\n  position: absolute;\n  z-index: 0;\n  inset: -20px;\n  pointer-events: auto;\n}\n\n.perf-hud:not([data-edge=\"right\"]) .perf-hud__hotspot {\n  right: -46px;\n}\n\n.perf-hud[data-edge=\"right\"] .perf-hud__hotspot {\n  left: -46px;\n}\n\n.perf-hud__tools {\n  position: absolute;\n  top: 0;\n  z-index: 2;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  opacity: 0;\n  pointer-events: none;\n  transition: opacity 0.15s ease;\n}\n\n.perf-hud.is-awake .perf-hud__tools,\n.perf-hud.is-dragging .perf-hud__tools {\n  opacity: 1;\n  pointer-events: auto;\n}\n\n/* Inward side: right by default, left when docked to the right edge. */\n.perf-hud:not([data-edge=\"right\"]) .perf-hud__tools {\n  left: calc(100% + 6px);\n}\n\n.perf-hud[data-edge=\"right\"] .perf-hud__tools {\n  right: calc(100% + 6px);\n}\n\n.perf-hud__disc {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  padding: 0;\n  border: 0;\n  border-radius: 999px;\n  background: var(--perf-bg);\n  box-shadow: var(--perf-shadow);\n  color: var(--perf-fg-dim);\n  cursor: pointer;\n  backdrop-filter: blur(2px);\n}\n\n.perf-hud__icon {\n  width: 12px;\n  height: 12px;\n}\n\n.perf-hud__drag {\n  cursor: grab;\n}\n\n.perf-hud.is-dragging .perf-hud__drag {\n  cursor: grabbing;\n}\n\n.perf-hud__disc:hover,\n.perf-hud__disc:focus-visible,\n.perf-hud__disc[aria-pressed=\"true\"] {\n  color: var(--perf-fg);\n  outline: 1px solid color-mix(in srgb, var(--perf-accent) 60%, transparent);\n  outline-offset: 1px;\n}\n";
 /**
  * Append the stylesheet to `target`'s head, once. Call before mounting a view
  * by hand; {@link mountPerfHud} does it for you unless told not to.
  */
 declare const injectStyles: (target?: Document) => void;
 //#endregion
-export { DEFAULT_STORAGE_KEY, type DefaultPlacement, type DockAlign, type DockHandle, type DockPanelOptions, type HudDefaults, type HudSelection, HudSettings, type HudSettingsOptions, HudTheme, type MountPerfHudOptions, PERF_HUD_STYLES, type PerfHudHandle, PerformanceView, type PerformanceViewMode, type PerformanceViewOptions, type Placement, type ResolvedTheme, type ScreenEdge, THEME_MODES, type ThemeMode, dockPanel, injectStyles, isThemeMode, mountPerfHud };
+export { DEFAULT_STORAGE_KEY, type DefaultPlacement, type DockAlign, type DockHandle, type DockPanelOptions, type HudDefaults, type HudSelection, HudSettings, type HudSettingsOptions, HudTheme, type MountPerfHudOptions, PERF_HUD_STYLES, type PerfHudHandle, PerformanceView, type PerformanceViewMode, type PerformanceViewOptions, type Placement, type ResolvedTheme, type ScreenEdge, THEME_MODES, type ThemeMode, dockPanel, formatReport, injectStyles, isThemeMode, mountPerfHud };
 //# sourceMappingURL=ui.d.ts.map

package/dist/ui.js

@@ -1,2 +1,2 @@
-import { a as dockPanel, c as HudTheme, i as PerformanceView, l as THEME_MODES, n as PERF_HUD_STYLES, o as DEFAULT_STORAGE_KEY, r as injectStyles, s as HudSettings, t as mountPerfHud, u as isThemeMode } from "./mount-perf-hud-Rf98QNxM.js";
-export { DEFAULT_STORAGE_KEY, HudSettings, HudTheme, PERF_HUD_STYLES, PerformanceView, THEME_MODES, dockPanel, injectStyles, isThemeMode, mountPerfHud };
+import { a as formatReport, c as HudSettings, d as isThemeMode, i as PerformanceView, l as HudTheme, n as PERF_HUD_STYLES, o as dockPanel, r as injectStyles, s as DEFAULT_STORAGE_KEY, t as mountPerfHud, u as THEME_MODES } from "./mount-perf-hud-BLs1jkwM.js";
+export { DEFAULT_STORAGE_KEY, HudSettings, HudTheme, PERF_HUD_STYLES, PerformanceView, THEME_MODES, dockPanel, formatReport, injectStyles, isThemeMode, mountPerfHud };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkmake/three-meter",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Zero-dependency three.js frame metrics (FPS, CPU, GPU, draw calls) with a dockable HUD. Vanilla three and React Three Fiber adapters.",
   "keywords": [
     "devtools",