@threejs-doctor/core 0.1.0

package/LICENSE

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

package/dist/ab-compare.d.ts

@@ -0,0 +1,25 @@
+import type { MetricsSample } from './types.js';
+export type AbDirection = 'lower-better' | 'higher-better';
+export type AbClaim = 'win' | 'loss' | 'inside-noise';
+export interface NoiseBand {
+    abs: number;
+    rel: number;
+}
+export declare function claimAbDelta(before: number, after: number, band: NoiseBand, direction: AbDirection): AbClaim;
+export interface AbCompareInput {
+    a: MetricsSample[];
+    b: MetricsSample[];
+    /** Optional A-vs-A (or other) control rounds used for the noise band instead of `a`. */
+    control?: MetricsSample[];
+}
+export interface AbCompareResult {
+    before: MetricsSample;
+    after: MetricsSample;
+    deltas: Partial<Record<keyof MetricsSample, number>>;
+    noiseBand: Partial<Record<keyof MetricsSample, NoiseBand>>;
+    claimed: Partial<Record<keyof MetricsSample, AbClaim>>;
+    invalid?: boolean;
+    invalidReason?: string;
+}
+export declare function compareAbSamples(input: AbCompareInput): AbCompareResult;
+//# sourceMappingURL=ab-compare.d.ts.map

package/dist/ab-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-compare.d.ts","sourceRoot":"","sources":["../src/ab-compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,eAAe,CAAA;AAC1D,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,cAAc,CAAA;AAErD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAiBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,WAAW,GACrB,OAAO,CAMT;AAwCD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,aAAa,EAAE,CAAA;IAClB,CAAC,EAAE,aAAa,EAAE,CAAA;IAClB,wFAAwF;IACxF,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,aAAa,CAAA;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;IACpD,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,aAAa,EAAE,SAAS,CAAC,CAAC,CAAA;IAC1D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAiCvE"}

package/dist/ab-compare.js

@@ -0,0 +1,95 @@
+import { median } from './stats-math.js';
+const LOWER_BETTER = [
+    'p95FrameTimeMs',
+    'drawCalls',
+    'triangles',
+    'textureCount',
+    'estimatedVramBytes',
+    'geometryCount',
+    'lightCount',
+    'shadowCastingLightCount',
+    'gpuFrameTimeMs',
+    'drawingBufferPixels',
+];
+const HIGHER_BETTER = ['avgFps'];
+export function claimAbDelta(before, after, band, direction) {
+    const threshold = Math.max(band.abs, Math.abs(before) * band.rel);
+    const delta = after - before;
+    if (Math.abs(delta) <= threshold)
+        return 'inside-noise';
+    if (direction === 'lower-better')
+        return delta < 0 ? 'win' : 'loss';
+    return delta > 0 ? 'win' : 'loss';
+}
+function medianAbsDeviation(values) {
+    const mid = median(values);
+    return median(values.map((value) => Math.abs(value - mid)));
+}
+function noiseFromControl(values) {
+    const mid = median(values);
+    const halfRange = (Math.max(...values) - Math.min(...values)) / 2;
+    const mad = medianAbsDeviation(values);
+    const abs = Math.max(halfRange, mad * 1.4826, 0);
+    const rel = Math.abs(mid) > 0 ? abs / Math.abs(mid) : 0;
+    return { abs, rel };
+}
+function numericSeries(samples, key) {
+    const values = [];
+    for (const sample of samples) {
+        const value = sample[key];
+        if (typeof value !== 'number' || !Number.isFinite(value))
+            return undefined;
+        values.push(value);
+    }
+    return values.length > 0 ? values : undefined;
+}
+function averageSample(samples) {
+    const keys = Object.keys(samples[0]);
+    const out = { ...samples[0] };
+    for (const key of keys) {
+        const series = numericSeries(samples, key);
+        if (!series) {
+            delete out[key];
+            continue;
+        }
+        ;
+        out[key] = median(series);
+    }
+    return out;
+}
+export function compareAbSamples(input) {
+    const before = averageSample(input.a);
+    const after = averageSample(input.b);
+    const deltas = {};
+    const noiseBand = {};
+    const claimed = {};
+    const keys = new Set([
+        ...Object.keys(before),
+        ...Object.keys(after),
+    ]);
+    for (const key of keys) {
+        const aSeries = numericSeries(input.a, key);
+        const bSeries = numericSeries(input.b, key);
+        const bVal = after[key];
+        const aVal = before[key];
+        const bandSeries = input.control ? numericSeries(input.control, key) : aSeries;
+        if (typeof aVal !== 'number' || typeof bVal !== 'number' || !aSeries || !bSeries || !bandSeries)
+            continue;
+        deltas[key] = bVal - aVal;
+        const band = noiseFromControl(bandSeries);
+        noiseBand[key] = band;
+        const direction = HIGHER_BETTER.includes(key) ? 'higher-better' : 'lower-better';
+        if (!LOWER_BETTER.includes(key) && !HIGHER_BETTER.includes(key))
+            continue;
+        claimed[key] = claimAbDelta(aVal, bVal, band, direction);
+    }
+    const result = { before, after, deltas, noiseBand, claimed };
+    const invalidSample = input.a.find((s) => s.invalid) ?? input.b.find((s) => s.invalid);
+    if (invalidSample) {
+        result.invalid = true;
+        if (invalidSample.invalidReason)
+            result.invalidReason = invalidSample.invalidReason;
+    }
+    return result;
+}
+//# sourceMappingURL=ab-compare.js.map

package/dist/ab-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-compare.js","sourceRoot":"","sources":["../src/ab-compare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAUxC,MAAM,YAAY,GAA+B;IAC/C,gBAAgB;IAChB,WAAW;IACX,WAAW;IACX,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,YAAY;IACZ,yBAAyB;IACzB,gBAAgB;IAChB,qBAAqB;CACtB,CAAA;AAED,MAAM,aAAa,GAA+B,CAAC,QAAQ,CAAC,CAAA;AAE5D,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,KAAa,EACb,IAAe,EACf,SAAsB;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;IACjE,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS;QAAE,OAAO,cAAc,CAAA;IACvD,IAAI,SAAS,KAAK,cAAc;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;IACnE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAgB;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAgB;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1B,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;IACjE,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB,EAAE,GAAwB;IACvE,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QAC1E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,CAA+B,CAAA;IACnE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAE,EAAE,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAQ,GAA+B,CAAC,GAAG,CAAC,CAAA;YAC5C,SAAQ;QACV,CAAC;QACD,CAAC;QAAC,GAA+B,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAmBD,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpC,MAAM,MAAM,GAAiD,EAAE,CAAA;IAC/D,MAAM,SAAS,GAAoD,EAAE,CAAA;IACrE,MAAM,OAAO,GAAkD,EAAE,CAAA;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC;QACnB,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACtB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;KACtB,CAA6B,CAAA;IAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC3C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACxB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;QAC9E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;YAAE,SAAQ;QACzG,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;QACzB,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;QACzC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACrB,MAAM,SAAS,GAAgB,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAA;QAC7F,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAQ;QACzE,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC1D,CAAC;IAED,MAAM,MAAM,GAAoB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IAC7E,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACtF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;QACrB,IAAI,aAAa,CAAC,aAAa;YAAE,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC,aAAa,CAAA;IACrF,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/device-probe.d.ts

@@ -0,0 +1,24 @@
+import type { DeviceCapabilities } from './types.js';
+export interface DeviceProbeInput {
+    devicePixelRatio: number;
+    hardwareConcurrency: number;
+    maxTextureSize: number;
+    webgl: boolean;
+    webgpu: boolean;
+    deviceMemory?: number;
+    maxTouchPoints?: number;
+    coarsePointer?: boolean;
+    prefersReducedData?: boolean;
+    colorBufferFloat?: boolean;
+    floatLinear?: boolean;
+    maxRenderbufferSize?: number;
+}
+export declare function probeDevice(partial?: Partial<DeviceProbeInput>): DeviceCapabilities;
+export interface WebglQualitySource {
+    getExtension(name: string): unknown;
+    getParameter?(pname: number): unknown;
+    MAX_TEXTURE_SIZE?: number;
+    MAX_RENDERBUFFER_SIZE?: number;
+}
+export declare function readWebglQualitySignals(gl: WebglQualitySource | undefined): Partial<Pick<DeviceProbeInput, 'colorBufferFloat' | 'floatLinear' | 'maxTextureSize' | 'maxRenderbufferSize'>>;
+//# sourceMappingURL=device-probe.d.ts.map

package/dist/device-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-probe.d.ts","sourceRoot":"","sources":["../src/device-probe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAiCD,wBAAgB,WAAW,CAAC,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,kBAAkB,CAkBvF;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAkBD,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,kBAAkB,GAAG,SAAS,GACjC,OAAO,CACR,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,GAAG,qBAAqB,CAAC,CACtG,CAiBA"}

package/dist/device-probe.js

@@ -0,0 +1,80 @@
+const GL_MAX_TEXTURE_SIZE = 0x0d33;
+const GL_MAX_RENDERBUFFER_SIZE = 0x84e8;
+function classifyTier(input) {
+    const score = (input.hardwareConcurrency >= 12 ? 2 : input.hardwareConcurrency >= 8 ? 1 : 0) +
+        (input.maxTextureSize >= 8192 ? 2 : input.maxTextureSize >= 4096 ? 1 : 0) +
+        (input.devicePixelRatio <= 1.5 ? 1 : 0) +
+        (input.webgpu ? 1 : 0);
+    if (score >= 5)
+        return 'high';
+    if (score >= 3)
+        return 'mid';
+    return 'low';
+}
+function assignOptional(caps, partial) {
+    if (partial.deviceMemory !== undefined)
+        caps.deviceMemory = partial.deviceMemory;
+    if (partial.maxTouchPoints !== undefined)
+        caps.maxTouchPoints = partial.maxTouchPoints;
+    if (partial.coarsePointer !== undefined)
+        caps.coarsePointer = partial.coarsePointer;
+    if (partial.prefersReducedData !== undefined) {
+        caps.prefersReducedData = partial.prefersReducedData;
+    }
+    if (partial.colorBufferFloat !== undefined)
+        caps.colorBufferFloat = partial.colorBufferFloat;
+    if (partial.floatLinear !== undefined)
+        caps.floatLinear = partial.floatLinear;
+    if (partial.maxRenderbufferSize !== undefined) {
+        caps.maxRenderbufferSize = partial.maxRenderbufferSize;
+    }
+}
+export function probeDevice(partial = {}) {
+    const input = {
+        devicePixelRatio: partial.devicePixelRatio ?? 1,
+        hardwareConcurrency: partial.hardwareConcurrency ?? 4,
+        maxTextureSize: partial.maxTextureSize ?? 2048,
+        webgl: partial.webgl ?? false,
+        webgpu: partial.webgpu ?? false,
+    };
+    const caps = {
+        tier: classifyTier(input),
+        maxTextureSize: input.maxTextureSize,
+        webgl: input.webgl,
+        webgpu: input.webgpu,
+        devicePixelRatio: input.devicePixelRatio,
+        hardwareConcurrency: input.hardwareConcurrency,
+    };
+    assignOptional(caps, partial);
+    return caps;
+}
+function readPositiveParam(gl, constant, fallbackPname) {
+    if (typeof gl.getParameter !== 'function')
+        return undefined;
+    const pname = typeof constant === 'number' ? constant : fallbackPname;
+    try {
+        const value = gl.getParameter(pname);
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0)
+            return value;
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+export function readWebglQualitySignals(gl) {
+    if (!gl)
+        return {};
+    const signals = {
+        colorBufferFloat: Boolean(gl.getExtension('EXT_color_buffer_float')),
+        floatLinear: Boolean(gl.getExtension('OES_texture_float_linear')),
+    };
+    const maxTextureSize = readPositiveParam(gl, gl.MAX_TEXTURE_SIZE, GL_MAX_TEXTURE_SIZE);
+    if (maxTextureSize !== undefined)
+        signals.maxTextureSize = maxTextureSize;
+    const maxRenderbufferSize = readPositiveParam(gl, gl.MAX_RENDERBUFFER_SIZE, GL_MAX_RENDERBUFFER_SIZE);
+    if (maxRenderbufferSize !== undefined)
+        signals.maxRenderbufferSize = maxRenderbufferSize;
+    return signals;
+}
+//# sourceMappingURL=device-probe.js.map

package/dist/device-probe.js.map

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

package/dist/hysteresis.d.ts

@@ -0,0 +1,26 @@
+import type { LadderPhase, QualityTier } from './quality-types.js';
+export { HYSTERESIS, TIER_ORDER } from './quality-caps.js';
+export interface HysteresisState {
+    tier: QualityTier;
+    maxTier: QualityTier;
+    phase: LadderPhase;
+    consecutiveSlow: number;
+    consecutiveFast: number;
+    cooldownRemaining: number;
+}
+export type LadderDecisionReason = 'neutral' | 'emergency' | 'below-target' | 'headroom' | 'cooldown' | 'boot-no-climb' | 'floor' | 'ceiling';
+export interface LadderDecision {
+    action: 'hold' | 'drop' | 'climb';
+    reason: LadderDecisionReason;
+    next: HysteresisState;
+}
+export declare function createHysteresisState(init: {
+    tier: QualityTier;
+    maxTier: QualityTier;
+    phase: LadderPhase;
+}): HysteresisState;
+export declare function stepTier(tier: QualityTier, delta: -1 | 1): QualityTier;
+export declare function evaluateWindow(state: HysteresisState, p95FrameTimeMs: number, opts?: {
+    applyFailed?: boolean;
+}): LadderDecision;
+//# sourceMappingURL=hysteresis.d.ts.map

package/dist/hysteresis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hysteresis.d.ts","sourceRoot":"","sources":["../src/hysteresis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAElE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,WAAW,GACX,cAAc,GACd,UAAU,GACV,UAAU,GACV,eAAe,GACf,OAAO,GACP,SAAS,CAAA;AAEb,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACjC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,IAAI,EAAE,eAAe,CAAA;CACtB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;CACnB,GAAG,eAAe,CASlB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,WAAW,CAItE;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,cAAc,CAiHhB"}

package/dist/hysteresis.js

@@ -0,0 +1,134 @@
+import { HYSTERESIS, TIER_ORDER } from './quality-caps.js';
+export { HYSTERESIS, TIER_ORDER } from './quality-caps.js';
+export function createHysteresisState(init) {
+    return {
+        tier: init.tier,
+        maxTier: init.maxTier,
+        phase: init.phase,
+        consecutiveSlow: 0,
+        consecutiveFast: 0,
+        cooldownRemaining: 0,
+    };
+}
+export function stepTier(tier, delta) {
+    const i = TIER_ORDER.indexOf(tier);
+    const next = Math.max(0, Math.min(TIER_ORDER.length - 1, i + delta));
+    return TIER_ORDER[next];
+}
+function rank(tier) {
+    return TIER_ORDER.indexOf(tier);
+}
+export function evaluateWindow(state, p95FrameTimeMs, opts = {}) {
+    let cooldownRemaining = state.cooldownRemaining;
+    if (opts.applyFailed)
+        cooldownRemaining = HYSTERESIS.cooldownWindows;
+    const atFloor = rank(state.tier) <= 0;
+    const atCeiling = rank(state.tier) >= rank(state.maxTier);
+    const dropTo = (reason) => {
+        if (atFloor) {
+            return {
+                action: 'hold',
+                reason: 'floor',
+                next: {
+                    ...state,
+                    consecutiveSlow: 0,
+                    consecutiveFast: 0,
+                    cooldownRemaining: HYSTERESIS.cooldownWindows,
+                },
+            };
+        }
+        return {
+            action: 'drop',
+            reason,
+            next: {
+                ...state,
+                tier: stepTier(state.tier, -1),
+                consecutiveSlow: 0,
+                consecutiveFast: 0,
+                cooldownRemaining: HYSTERESIS.cooldownWindows,
+            },
+        };
+    };
+    if (p95FrameTimeMs >= HYSTERESIS.emergencyP95Ms)
+        return dropTo('emergency');
+    // Failed apply + still below 30 FPS is drop-triggering (do not wait for 2 slow windows).
+    if (opts.applyFailed && p95FrameTimeMs > HYSTERESIS.dropP95Ms)
+        return dropTo('below-target');
+    let consecutiveSlow = state.consecutiveSlow;
+    let consecutiveFast = state.consecutiveFast;
+    if (p95FrameTimeMs > HYSTERESIS.dropP95Ms) {
+        consecutiveSlow += 1;
+        consecutiveFast = 0;
+    }
+    else if (p95FrameTimeMs <= HYSTERESIS.climbP95Ms) {
+        // Cooldown windows do not count toward climb; need 3 fresh fast windows after.
+        consecutiveFast = cooldownRemaining > 0 ? 0 : consecutiveFast + 1;
+        consecutiveSlow = 0;
+    }
+    else {
+        consecutiveSlow = 0;
+        consecutiveFast = 0;
+    }
+    if (consecutiveSlow >= HYSTERESIS.dropWindows)
+        return dropTo('below-target');
+    if (p95FrameTimeMs <= HYSTERESIS.climbP95Ms && consecutiveFast >= HYSTERESIS.climbWindows) {
+        if (state.phase !== 'runtime') {
+            return {
+                action: 'hold',
+                reason: 'boot-no-climb',
+                next: {
+                    ...state,
+                    consecutiveSlow,
+                    consecutiveFast,
+                    cooldownRemaining: Math.max(0, cooldownRemaining - 1),
+                },
+            };
+        }
+        if (cooldownRemaining > 0) {
+            return {
+                action: 'hold',
+                reason: 'cooldown',
+                next: {
+                    ...state,
+                    consecutiveSlow,
+                    consecutiveFast,
+                    cooldownRemaining: cooldownRemaining - 1,
+                },
+            };
+        }
+        if (atCeiling) {
+            return {
+                action: 'hold',
+                reason: 'ceiling',
+                next: {
+                    ...state,
+                    consecutiveSlow,
+                    consecutiveFast: 0,
+                    cooldownRemaining: 0,
+                },
+            };
+        }
+        return {
+            action: 'climb',
+            reason: 'headroom',
+            next: {
+                ...state,
+                tier: stepTier(state.tier, 1),
+                consecutiveSlow: 0,
+                consecutiveFast: 0,
+                cooldownRemaining: 0,
+            },
+        };
+    }
+    return {
+        action: 'hold',
+        reason: 'neutral',
+        next: {
+            ...state,
+            consecutiveSlow,
+            consecutiveFast,
+            cooldownRemaining: Math.max(0, cooldownRemaining - 1),
+        },
+    };
+}
+//# sourceMappingURL=hysteresis.js.map

package/dist/hysteresis.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export declare const PACKAGE_NAME: "@threejs-doctor/core";
+export * from './types.js';
+export * from './device-probe.js';
+export * from './scene-snapshot.js';
+export * from './metrics-collector.js';
+export * from './quality-types.js';
+export * from './quality-caps.js';
+export * from './hysteresis.js';
+export * from './start-tier.js';
+export * from './ab-compare.js';
+export * from './pixel-diff.js';
+export * from './measure-validity.js';
+export * from './stats-math.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EAAG,sBAA+B,CAAA;AAC3D,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export const PACKAGE_NAME = '@threejs-doctor/core';
+export * from './types.js';
+export * from './device-probe.js';
+export * from './scene-snapshot.js';
+export * from './metrics-collector.js';
+export * from './quality-types.js';
+export * from './quality-caps.js';
+export * from './hysteresis.js';
+export * from './start-tier.js';
+export * from './ab-compare.js';
+export * from './pixel-diff.js';
+export * from './measure-validity.js';
+export * from './stats-math.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,sBAA+B,CAAA;AAC3D,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/measure-validity.d.ts

@@ -0,0 +1,13 @@
+export interface MeasureValidityInput {
+    visibilityState?: string;
+    frameTimesMs: number[];
+    /** Gaps at or above this many ms count as throttled rAF. Default 250. */
+    throttleMs?: number;
+}
+export interface MeasureValidity {
+    invalid: boolean;
+    reason?: string;
+}
+/** Hidden tabs and background-throttled rAF must not produce a trusted score. */
+export declare function classifyMeasureValidity(input: MeasureValidityInput): MeasureValidity;
+//# sourceMappingURL=measure-validity.d.ts.map

package/dist/measure-validity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-validity.d.ts","sourceRoot":"","sources":["../src/measure-validity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAUpF"}

package/dist/measure-validity.js

@@ -0,0 +1,13 @@
+/** Hidden tabs and background-throttled rAF must not produce a trusted score. */
+export function classifyMeasureValidity(input) {
+    if (input.visibilityState === 'hidden') {
+        return { invalid: true, reason: 'hidden' };
+    }
+    const throttleMs = input.throttleMs ?? 250;
+    const throttled = input.frameTimesMs.filter((ms) => ms >= throttleMs);
+    if (throttled.some((ms) => ms >= 1000) || throttled.length >= 2) {
+        return { invalid: true, reason: 'throttled-raf' };
+    }
+    return { invalid: false };
+}
+//# sourceMappingURL=measure-validity.js.map

package/dist/measure-validity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-validity.js","sourceRoot":"","sources":["../src/measure-validity.ts"],"names":[],"mappings":"AAYA,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,IAAI,KAAK,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC5C,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAA;IAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,UAAU,CAAC,CAAA;IACrE,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;IACnD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC3B,CAAC"}

package/dist/metrics-collector.d.ts

@@ -0,0 +1,23 @@
+import type { MetricsSample, RendererInfoLike } from './types.js';
+export interface SceneStatsLike {
+    textureCount: number;
+    estimatedVramBytes?: number | undefined;
+    geometryCount: number;
+    lightCount: number;
+    shadowCastingLightCount: number;
+}
+export interface MetricsCollectorOptions {
+    getRendererInfo: () => RendererInfoLike;
+    getSceneStats: () => SceneStatsLike;
+}
+export declare class MetricsCollector {
+    private readonly opts;
+    private frameTimesMs;
+    private openStart;
+    constructor(opts: MetricsCollectorOptions);
+    beginFrame(nowMs: number): void;
+    endFrame(nowMs: number): void;
+    sample(): MetricsSample;
+    frameTimes(): readonly number[];
+}
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/metrics-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.d.ts","sourceRoot":"","sources":["../src/metrics-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,gBAAgB,CAAA;IACvC,aAAa,EAAE,MAAM,cAAc,CAAA;CACpC;AAQD,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAsB;gBAEV,IAAI,EAAE,uBAAuB;IAE1D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,MAAM,IAAI,aAAa;IAsBvB,UAAU,IAAI,SAAS,MAAM,EAAE;CAGhC"}

package/dist/metrics-collector.js

@@ -0,0 +1,47 @@
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1);
+    return sorted[Math.max(0, idx)];
+}
+export class MetricsCollector {
+    opts;
+    frameTimesMs = [];
+    openStart = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    beginFrame(nowMs) {
+        this.openStart = nowMs;
+    }
+    endFrame(nowMs) {
+        if (this.openStart === null)
+            return;
+        this.frameTimesMs.push(Math.max(0, nowMs - this.openStart));
+        this.openStart = null;
+    }
+    sample() {
+        const times = [...this.frameTimesMs].sort((a, b) => a - b);
+        const avgFrame = times.length === 0 ? 0 : times.reduce((a, b) => a + b, 0) / times.length;
+        const info = this.opts.getRendererInfo();
+        const scene = this.opts.getSceneStats();
+        const sample = {
+            avgFps: avgFrame <= 0 ? 0 : 1000 / avgFrame,
+            p95FrameTimeMs: percentile(times, 95),
+            drawCalls: info.render.calls,
+            triangles: info.render.triangles,
+            textureCount: scene.textureCount,
+            geometryCount: scene.geometryCount,
+            lightCount: scene.lightCount,
+            shadowCastingLightCount: scene.shadowCastingLightCount,
+        };
+        if (scene.estimatedVramBytes !== undefined) {
+            sample.estimatedVramBytes = scene.estimatedVramBytes;
+        }
+        return sample;
+    }
+    frameTimes() {
+        return this.frameTimesMs;
+    }
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/metrics-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-collector.js","sourceRoot":"","sources":["../src/metrics-collector.ts"],"names":[],"mappings":"AAeA,SAAS,UAAU,CAAC,MAAgB,EAAE,CAAS;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACjF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAE,CAAA;AAClC,CAAC;AAED,MAAM,OAAO,gBAAgB;IAIE;IAHrB,YAAY,GAAa,EAAE,CAAA;IAC3B,SAAS,GAAkB,IAAI,CAAA;IAEvC,YAA6B,IAA6B;QAA7B,SAAI,GAAJ,IAAI,CAAyB;IAAG,CAAC;IAE9D,UAAU,CAAC,KAAa;QACtB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACxB,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,OAAM;QACnC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;QAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;IACvB,CAAC;IAED,MAAM;QACJ,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAC1D,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAA;QACvC,MAAM,MAAM,GAAkB;YAC5B,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ;YAC3C,cAAc,EAAE,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;YACrC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YAC5B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;SACvD,CAAA;QACD,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAA;QACtD,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;CACF"}

package/dist/pixel-diff.d.ts

@@ -0,0 +1,10 @@
+export declare function pixelChangedRatio(a: ArrayLike<number>, b: ArrayLike<number>, channelThreshold?: number): number;
+export declare function classifyVisualSafety(opts: {
+    controlChangedRatio: number;
+    candidateChangedRatio: number;
+    maxChangedRatio?: number;
+}): {
+    safe: boolean;
+    visualDelta: boolean;
+};
+//# sourceMappingURL=pixel-diff.d.ts.map

package/dist/pixel-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-diff.d.ts","sourceRoot":"","sources":["../src/pixel-diff.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,gBAAgB,SAAI,GACnB,MAAM,CAeR;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAK1C"}