@jolly-pixel/ui 1.0.1

package/dist/stats/Stats.js

@@ -0,0 +1,354 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+// Import Third-party Dependencies
+import { LitElement, html } from "lit";
+import { customElement, property, query } from "lit/decorators.js";
+// Import Internal Dependencies
+import { statsStyles } from "./Stats.styles.js";
+import { resolveMetricRange } from "./MetricDefinition.js";
+import { LocalStorageAdapter } from "../storage/LocalStorageAdapter.js";
+import { resolveThemeColor } from "../theme/resolveThemeToken.js";
+// CONSTANTS
+const kSelectionSuffix = ":metric";
+const kGraphTop = 18;
+const kGraphPadding = 2;
+let StatsElement = class StatsElement extends LitElement {
+    static styles = statsStyles;
+    #colors = {
+        accent: "#4488ff",
+        accentBed: "#111827",
+        fps: "#00ffff",
+        fpsBed: "#001122",
+        mb: "#ff0088",
+        mbBed: "#220011",
+        ms: "#00ff66",
+        msBed: "#00220d",
+        success: "#2f8f5b",
+        warning: "#ff9d00",
+        worst: "#ff9d00",
+        worstBed: "#221100"
+    };
+    #selectedId = null;
+    #snapshot = {};
+    #unsubscribe = null;
+    #resize = null;
+    #themeObserver = null;
+    #colorScheme = null;
+    constructor() {
+        super();
+        this.recorder = null;
+        this.storageKey = "jolly-stats";
+        this.storage = new LocalStorageAdapter();
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (!this.hasAttribute("role")) {
+            this.setAttribute("role", "button");
+        }
+        if (!this.hasAttribute("tabindex")) {
+            this.setAttribute("tabindex", "0");
+        }
+        this.addEventListener("keydown", this.#onKeyDown);
+        this.#connectRecorder();
+        this.#observeTheme();
+    }
+    disconnectedCallback() {
+        this.#unsubscribe?.();
+        this.#unsubscribe = null;
+        this.#resize?.disconnect();
+        this.#resize = null;
+        this.#themeObserver?.disconnect();
+        this.#themeObserver = null;
+        this.#colorScheme?.removeEventListener("change", this.#refreshTheme);
+        this.#colorScheme = null;
+        this.removeEventListener("keydown", this.#onKeyDown);
+        super.disconnectedCallback();
+    }
+    firstUpdated() {
+        if (typeof ResizeObserver !== "undefined") {
+            this.#resize = new ResizeObserver(() => this.#draw());
+            this.#resize.observe(this._canvas);
+        }
+        this.#refreshTheme();
+    }
+    updated(changed) {
+        if (changed.has("recorder")) {
+            this.#connectRecorder();
+        }
+        if (changed.has("storage") ||
+            changed.has("storageKey")) {
+            this.#restoreSelection();
+        }
+        this.#syncAccessibleName();
+        this.#draw();
+    }
+    render() {
+        return html `
+      <canvas
+        aria-hidden="true"
+        @click=${this.#next}
+        @contextmenu=${this.#onContextMenu}
+      ></canvas>
+    `;
+    }
+    #connectRecorder() {
+        this.#unsubscribe?.();
+        this.#unsubscribe = null;
+        this.#snapshot = this.recorder?.snapshot() ?? {};
+        this.#restoreSelection();
+        if (this.recorder !== null) {
+            this.#unsubscribe = this.recorder.subscribe((snapshot) => {
+                this.#snapshot = snapshot;
+                this.#ensureSelection();
+                this.requestUpdate();
+            });
+        }
+    }
+    #restoreSelection() {
+        const stored = this.storage.get(`${this.storageKey}${kSelectionSuffix}`);
+        const definitions = this.recorder?.definitions ?? [];
+        this.#selectedId = definitions.some(({ id }) => id === stored) ? stored : (definitions[0]?.id ?? null);
+    }
+    #ensureSelection() {
+        const definitions = this.recorder?.definitions ?? [];
+        if (!definitions.some(({ id }) => id === this.#selectedId)) {
+            this.#selectedId = definitions[0]?.id ?? null;
+        }
+    }
+    #next = () => {
+        this.#cycle(1);
+    };
+    #previous = () => {
+        this.#cycle(-1);
+    };
+    #onContextMenu = (event) => {
+        event.preventDefault();
+        this.#previous();
+    };
+    #cycle(delta) {
+        const definitions = this.recorder?.definitions ?? [];
+        if (definitions.length === 0) {
+            return;
+        }
+        const selected = definitions.findIndex(({ id }) => id === this.#selectedId);
+        const index = selected < 0 ? 0 : selected;
+        const next = (index + delta + definitions.length) % definitions.length;
+        this.#selectedId = definitions[next].id;
+        this.storage.set(`${this.storageKey}${kSelectionSuffix}`, this.#selectedId);
+        this.requestUpdate();
+    }
+    #onKeyDown = (event) => {
+        if (event.key === "Enter" ||
+            event.key === " " ||
+            event.key === "ArrowRight" ||
+            event.key === "ArrowDown") {
+            event.preventDefault();
+            this.#next();
+        }
+        else if (event.key === "ArrowLeft" ||
+            event.key === "ArrowUp") {
+            event.preventDefault();
+            this.#previous();
+        }
+    };
+    #selectedDefinition() {
+        return this.recorder?.definitions.find(({ id }) => id === this.#selectedId) ?? null;
+    }
+    #syncAccessibleName() {
+        const definition = this.#selectedDefinition();
+        if (definition === null) {
+            this.setAttribute("aria-label", "Performance statistics unavailable");
+            return;
+        }
+        const value = this.#format(definition, this.#snapshot[definition.id] ?? 0);
+        this.setAttribute("aria-label", `${definition.label}: ${value}. Activate to show the next metric.`);
+    }
+    #observeTheme() {
+        this.#themeObserver?.disconnect();
+        const target = this.closest("jolly-scope") ?? this;
+        if (typeof MutationObserver !== "undefined") {
+            this.#themeObserver = new MutationObserver(this.#refreshTheme);
+            this.#themeObserver.observe(target, {
+                attributes: true,
+                attributeFilter: ["theme"]
+            });
+        }
+        const view = this.ownerDocument.defaultView;
+        this.#colorScheme = view?.matchMedia?.("(prefers-color-scheme: dark)") ?? null;
+        this.#colorScheme?.addEventListener("change", this.#refreshTheme);
+        this.#refreshTheme();
+    }
+    #refreshTheme = () => {
+        this.#colors = {
+            accent: resolveThemeColor(this, "--jolly-accent-text", "#4488ff"),
+            accentBed: resolveThemeColor(this, "--jolly-surface-sunken", "#111827"),
+            fps: resolveThemeColor(this, "--jolly-stats-fps", "#00ffff"),
+            fpsBed: resolveThemeColor(this, "--jolly-stats-fps-bed", "#001122"),
+            mb: resolveThemeColor(this, "--jolly-stats-mb", "#ff0088"),
+            mbBed: resolveThemeColor(this, "--jolly-stats-mb-bed", "#220011"),
+            ms: resolveThemeColor(this, "--jolly-stats-ms", "#00ff66"),
+            msBed: resolveThemeColor(this, "--jolly-stats-ms-bed", "#00220d"),
+            success: resolveThemeColor(this, "--jolly-success", "#2f8f5b"),
+            warning: resolveThemeColor(this, "--jolly-warning", "#ff9d00"),
+            worst: resolveThemeColor(this, "--jolly-stats-worst", "#ff9d00"),
+            worstBed: resolveThemeColor(this, "--jolly-stats-worst-bed", "#221100")
+        };
+        this.#draw();
+    };
+    #draw() {
+        const canvas = this._canvas;
+        if (canvas === undefined || canvas === null) {
+            return;
+        }
+        const rect = canvas.getBoundingClientRect();
+        const ratio = this.ownerDocument.defaultView?.devicePixelRatio || 1;
+        const width = Math.max(1, Math.round(rect.width * ratio));
+        const height = Math.max(1, Math.round(rect.height * ratio));
+        if (canvas.width !== width) {
+            canvas.width = width;
+        }
+        if (canvas.height !== height) {
+            canvas.height = height;
+        }
+        const context = canvas.getContext("2d");
+        if (context === null) {
+            return;
+        }
+        context.clearRect(0, 0, width, height);
+        const definition = this.#selectedDefinition();
+        if (definition === null ||
+            this.recorder === null) {
+            return;
+        }
+        context.save();
+        context.scale(ratio, ratio);
+        const palette = this.#palette(definition);
+        context.fillStyle = palette.bed;
+        context.fillRect(0, 0, rect.width, rect.height);
+        this.#drawReadout(context, definition, rect.width);
+        this.#drawGraph(context, definition, palette, rect.width, rect.height);
+        context.restore();
+    }
+    #drawReadout(context, definition, width) {
+        const value = this.#snapshot[definition.id] ?? 0;
+        const valueText = this.#format(definition, value);
+        context.font = "bold 11px Helvetica, Arial, sans-serif";
+        context.textBaseline = "top";
+        context.fillStyle = this.#palette(definition).ink;
+        context.textAlign = "right";
+        context.fillText(valueText, width - kGraphPadding, kGraphPadding);
+        const labelWidth = width -
+            context.measureText(valueText).width -
+            (kGraphPadding * 3);
+        context.textAlign = "left";
+        context.fillText(fitText(context, definition.label, labelWidth), kGraphPadding, kGraphPadding);
+    }
+    #drawGraph(context, definition, palette, width, height) {
+        const history = this.recorder?.history(definition.id) ?? [];
+        if (history.length === 0) {
+            return;
+        }
+        const bounds = resolveMetricRange(definition, history);
+        const range = bounds.max - bounds.min || 1;
+        const graphHeight = height - kGraphTop - kGraphPadding;
+        const ratio = context.getTransform().a || 1;
+        const graphLeftPixels = Math.round(kGraphPadding * ratio);
+        const graphWidthPixels = Math.max(1, Math.round((width - (kGraphPadding * 2)) * ratio));
+        const graphLeft = graphLeftPixels / ratio;
+        const graphWidth = graphWidthPixels / ratio;
+        context.fillStyle = palette.ink;
+        context.fillRect(graphLeft, kGraphTop, graphWidth, graphHeight);
+        context.fillStyle = palette.bed;
+        history.forEach((sample, index) => {
+            const normalized = Math.min(1, Math.max(0, (sample - bounds.min) / range));
+            const barHeight = Math.max(1, normalized * graphHeight);
+            const coverHeight = graphHeight - barHeight;
+            const barLeftPixels = graphLeftPixels + Math.floor((index * graphWidthPixels) / history.length);
+            const barRightPixels = graphLeftPixels + Math.floor(((index + 1) * graphWidthPixels) / history.length);
+            context.fillRect(barLeftPixels / ratio, kGraphTop, (barRightPixels - barLeftPixels) / ratio, coverHeight);
+        });
+    }
+    #palette(definition) {
+        if (definition.id === "fps") {
+            return {
+                ink: this.#colors.fps,
+                bed: this.#colors.fpsBed
+            };
+        }
+        if (definition.id === "ms") {
+            return {
+                ink: this.#colors.ms,
+                bed: this.#colors.msBed
+            };
+        }
+        if (definition.id === "worstMs") {
+            return {
+                ink: this.#colors.worst,
+                bed: this.#colors.worstBed
+            };
+        }
+        if (definition.id === "mb") {
+            return {
+                ink: this.#colors.mb,
+                bed: this.#colors.mbBed
+            };
+        }
+        let ink = this.#colors.accent;
+        if (definition.better === "higher") {
+            ink = this.#colors.success;
+        }
+        else if (definition.better === "lower") {
+            ink = this.#colors.warning;
+        }
+        return {
+            ink,
+            bed: this.#colors.accentBed
+        };
+    }
+    #format(definition, value) {
+        return definition.format?.(value) ?? String(Math.round(value));
+    }
+};
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], StatsElement.prototype, "recorder", void 0);
+__decorate([
+    property({
+        type: String,
+        attribute: "storage-key"
+    }),
+    __metadata("design:type", String)
+], StatsElement.prototype, "storageKey", void 0);
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], StatsElement.prototype, "storage", void 0);
+__decorate([
+    query("canvas"),
+    __metadata("design:type", HTMLCanvasElement)
+], StatsElement.prototype, "_canvas", void 0);
+StatsElement = __decorate([
+    customElement("jolly-stats"),
+    __metadata("design:paramtypes", [])
+], StatsElement);
+export { StatsElement };
+function fitText(context, value, maxWidth) {
+    if (context.measureText(value).width <= maxWidth) {
+        return value;
+    }
+    let shortened = value;
+    while (shortened.length > 1 &&
+        context.measureText(`${shortened}…`).width > maxWidth) {
+        shortened = shortened.slice(0, -1);
+    }
+    return `${shortened}…`;
+}
+//# sourceMappingURL=Stats.js.map

package/dist/stats/Stats.js.map

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

package/dist/stats/Stats.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const statsStyles: import("lit").CSSResult;
+//# sourceMappingURL=Stats.styles.d.ts.map

package/dist/stats/Stats.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stats.styles.d.ts","sourceRoot":"","sources":["../../src/stats/Stats.styles.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,yBAsDvB,CAAC"}

package/dist/stats/Stats.styles.js

@@ -0,0 +1,60 @@
+// Import Third-party Dependencies
+import { css } from "lit";
+// Import Internal Dependencies
+import { focusRing } from "../theme/styles/mixins.js";
+export const statsStyles = css `
+  :host {
+    display: block;
+    width: 112px;
+    height: 56px;
+    border-radius: var(--jolly-radius-sm, 2px);
+    cursor: pointer;
+    user-select: none;
+
+    --jolly-stats-fps: light-dark(#007c91, #00ffff);
+    --jolly-stats-fps-bed: light-dark(#d8f7fb, #001122);
+    --jolly-stats-ms: light-dark(#16733a, #00ff66);
+    --jolly-stats-ms-bed: light-dark(#def6e6, #00220d);
+    --jolly-stats-worst: light-dark(#a65300, #ff9d00);
+    --jolly-stats-worst-bed: light-dark(#fff0d6, #221100);
+    --jolly-stats-mb: light-dark(#a6005a, #ff0088);
+    --jolly-stats-mb-bed: light-dark(#ffe0ef, #220011);
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+
+  canvas {
+    display: block;
+    width: 100%;
+    height: 100%;
+    box-sizing: border-box;
+    border-radius: inherit;
+    background: transparent;
+  }
+
+  :host(:hover) {
+    filter: brightness(1.08);
+  }
+
+  :host(:focus-visible) {
+    ${focusRing}
+    outline-offset: 1px;
+  }
+
+  :host(:active) {
+    filter: brightness(0.94);
+  }
+
+  @media (forced-colors: active) {
+    canvas {
+      border: 1px solid ButtonBorder;
+    }
+
+    :host(:focus-visible) {
+      outline-color: Highlight;
+    }
+  }
+`;
+//# sourceMappingURL=Stats.styles.js.map

package/dist/stats/Stats.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stats.styles.js","sourceRoot":"","sources":["../../src/stats/Stats.styles.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,+BAA+B;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqCxB,SAAS;;;;;;;;;;;;;;;;;CAiBd,CAAC"}

package/dist/stats/StatsRecorder.d.ts

@@ -0,0 +1,29 @@
+import { type StatsPerformance } from "./builtins.ts";
+import type { MetricDefinition } from "./MetricDefinition.ts";
+export interface StatsRecorderOptions {
+    /** Maximum snapshots retained for each metric. */
+    historySize?: number;
+    /** Refresh window duration in milliseconds. */
+    refreshInterval?: number;
+    /** Injectable timing and memory source for headless use and tests. */
+    performance?: StatsPerformance;
+}
+export type StatsSnapshot = Record<string, number>;
+export type StatsListener = (snapshot: StatsSnapshot) => void;
+/** DOM-free timing and metric aggregation shared by every stats display. */
+export declare class StatsRecorder {
+    #private;
+    constructor(options?: StatsRecorderOptions);
+    /** Registered metrics in cycle order. */
+    get definitions(): readonly MetricDefinition[];
+    begin(): void;
+    end(): void;
+    /** Pushes a finite metric value computed by the caller. */
+    track(id: string, value: number): void;
+    addMetric(definition: MetricDefinition): void;
+    snapshot(): StatsSnapshot;
+    /** Returns a defensive copy ordered from oldest to newest. */
+    history(id: string): number[];
+    subscribe(listener: StatsListener): () => void;
+}
+//# sourceMappingURL=StatsRecorder.d.ts.map

package/dist/stats/StatsRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatsRecorder.d.ts","sourceRoot":"","sources":["../../src/stats/StatsRecorder.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,aAAa,KACpB,IAAI,CAAC;AAWV,4EAA4E;AAC5E,qBAAa,aAAa;;gBAYtB,OAAO,GAAE,oBAAyB;IAuBpC,yCAAyC;IACzC,IAAI,WAAW,IAAI,SAAS,gBAAgB,EAAE,CAM7C;IAED,KAAK,IAAI,IAAI;IAIb,GAAG,IAAI,IAAI;IA2BX,2DAA2D;IAC3D,KAAK,CACH,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,IAAI;IAWP,SAAS,CACP,UAAU,EAAE,gBAAgB,GAC3B,IAAI;IAkBP,QAAQ,IAAI,aAAa;IASzB,8DAA8D;IAC9D,OAAO,CACL,EAAE,EAAE,MAAM,GACT,MAAM,EAAE;IAeX,SAAS,CACP,QAAQ,EAAE,aAAa,GACtB,MAAM,IAAI;CA8Cd"}

package/dist/stats/StatsRecorder.js

@@ -0,0 +1,151 @@
+// Import Internal Dependencies
+import { FPS_METRIC, MS_METRIC, WORST_MS_METRIC, memoryMetric } from "./builtins.js";
+// CONSTANTS
+const kDefaultHistorySize = 60;
+const kDefaultRefreshInterval = 250;
+/** DOM-free timing and metric aggregation shared by every stats display. */
+export class StatsRecorder {
+    #historySize;
+    #refreshInterval;
+    #performance;
+    #metrics = new Map();
+    #listeners = new Set();
+    #beginTime = null;
+    #windowStart;
+    #frames = 0;
+    constructor(options = {}) {
+        this.#historySize = positiveInteger(options.historySize, kDefaultHistorySize);
+        this.#refreshInterval = positiveNumber(options.refreshInterval, kDefaultRefreshInterval);
+        this.#performance = options.performance ?? globalThis.performance;
+        this.#windowStart = this.#performance.now();
+        this.addMetric(FPS_METRIC);
+        this.addMetric(MS_METRIC);
+        this.addMetric(WORST_MS_METRIC);
+        const memory = memoryMetric(this.#performance);
+        if (memory !== null) {
+            this.addMetric(memory);
+        }
+    }
+    /** Registered metrics in cycle order. */
+    get definitions() {
+        return [...this.#metrics.values()].map(({ definition }) => {
+            return { ...definition };
+        });
+    }
+    begin() {
+        this.#beginTime = this.#performance.now();
+    }
+    end() {
+        if (this.#beginTime === null) {
+            return;
+        }
+        const now = this.#performance.now();
+        const duration = Math.max(0, now - this.#beginTime);
+        this.#beginTime = null;
+        this.#frames++;
+        this.#push("ms", duration);
+        this.#push("worstMs", duration);
+        const elapsed = now - this.#windowStart;
+        if (elapsed < this.#refreshInterval) {
+            return;
+        }
+        this.#push("fps", (this.#frames * 1000) / elapsed);
+        this.#flush(now);
+    }
+    /** Pushes a finite metric value computed by the caller. */
+    track(id, value) {
+        if (!this.#metrics.has(id)) {
+            throw new Error(`Unknown stats metric: ${id}`);
+        }
+        if (!Number.isFinite(value)) {
+            return;
+        }
+        this.#push(id, value);
+    }
+    addMetric(definition) {
+        if (definition.id === "") {
+            throw new Error("Stats metric id cannot be empty");
+        }
+        if (this.#metrics.has(definition.id)) {
+            throw new Error(`Stats metric already exists: ${definition.id}`);
+        }
+        this.#metrics.set(definition.id, {
+            definition: { ...definition },
+            pending: [],
+            current: 0,
+            history: new Array(this.#historySize),
+            historyCount: 0,
+            historyIndex: 0
+        });
+    }
+    snapshot() {
+        const snapshot = {};
+        for (const [id, state] of this.#metrics) {
+            snapshot[id] = state.current;
+        }
+        return snapshot;
+    }
+    /** Returns a defensive copy ordered from oldest to newest. */
+    history(id) {
+        const state = this.#metrics.get(id);
+        if (state === undefined || state.historyCount === 0) {
+            return [];
+        }
+        if (state.historyCount < this.#historySize) {
+            return state.history.slice(0, state.historyCount);
+        }
+        return [
+            ...state.history.slice(state.historyIndex),
+            ...state.history.slice(0, state.historyIndex)
+        ];
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    #flush(now) {
+        for (const state of this.#metrics.values()) {
+            const sample = state.definition.sample?.();
+            if (sample !== undefined && Number.isFinite(sample)) {
+                state.pending.push(sample);
+            }
+            if (state.pending.length === 0) {
+                continue;
+            }
+            state.current = aggregate(state.pending, state.definition.aggregate ?? "last");
+            state.pending = [];
+            state.history[state.historyIndex] = state.current;
+            state.historyIndex = (state.historyIndex + 1) % this.#historySize;
+            state.historyCount = Math.min(this.#historySize, state.historyCount + 1);
+        }
+        this.#windowStart = now;
+        this.#frames = 0;
+        const snapshot = this.snapshot();
+        for (const listener of this.#listeners) {
+            listener(snapshot);
+        }
+    }
+    #push(id, value) {
+        this.#metrics.get(id)?.pending.push(value);
+    }
+}
+function aggregate(values, mode) {
+    if (mode === "average") {
+        return values.reduce((sum, value) => sum + value, 0) / values.length;
+    }
+    if (mode === "max") {
+        return Math.max(...values);
+    }
+    return values[values.length - 1];
+}
+function positiveInteger(value, fallback) {
+    return value === undefined || !Number.isInteger(value) || value <= 0
+        ? fallback
+        : value;
+}
+function positiveNumber(value, fallback) {
+    return value === undefined || !Number.isFinite(value) || value <= 0
+        ? fallback
+        : value;
+}
+//# sourceMappingURL=StatsRecorder.js.map

package/dist/stats/StatsRecorder.js.map

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

package/dist/stats/builtins.d.ts

@@ -0,0 +1,14 @@
+import type { MetricDefinition } from "./MetricDefinition.ts";
+export interface PerformanceMemory {
+    usedJSHeapSize: number;
+    jsHeapSizeLimit?: number;
+}
+export interface StatsPerformance {
+    now(): number;
+    memory?: PerformanceMemory;
+}
+export declare const FPS_METRIC: MetricDefinition;
+export declare const MS_METRIC: MetricDefinition;
+export declare const WORST_MS_METRIC: MetricDefinition;
+export declare function memoryMetric(performanceSource: StatsPerformance): MetricDefinition | null;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/stats/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/stats/builtins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,eAAO,MAAM,UAAU,EAAE,gBAQxB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,gBAQvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAQ7B,CAAC;AAEF,wBAAgB,YAAY,CAC1B,iBAAiB,EAAE,gBAAgB,GAClC,gBAAgB,GAAG,IAAI,CAsBzB"}