@threejs-doctor/core 0.1.0

package/dist/pixel-diff.js

@@ -0,0 +1,26 @@
+export function pixelChangedRatio(a, b, channelThreshold = 8) {
+    const len = Math.min(a.length, b.length);
+    if (len < 4)
+        return a.length === b.length ? 0 : 1;
+    const pixels = Math.floor(len / 4);
+    let changed = 0;
+    for (let i = 0; i < pixels; i++) {
+        const o = i * 4;
+        const dr = Math.abs(Number(a[o]) - Number(b[o]));
+        const dg = Math.abs(Number(a[o + 1]) - Number(b[o + 1]));
+        const db = Math.abs(Number(a[o + 2]) - Number(b[o + 2]));
+        const da = Math.abs(Number(a[o + 3]) - Number(b[o + 3]));
+        if (Math.max(dr, dg, db, da) > channelThreshold)
+            changed += 1;
+    }
+    if (a.length !== b.length)
+        return 1;
+    return changed / pixels;
+}
+export function classifyVisualSafety(opts) {
+    const maxChangedRatio = opts.maxChangedRatio ?? 0.005;
+    const floor = Math.max(maxChangedRatio, opts.controlChangedRatio);
+    const visualDelta = opts.candidateChangedRatio > floor;
+    return { safe: !visualDelta, visualDelta };
+}
+//# sourceMappingURL=pixel-diff.js.map

package/dist/pixel-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-diff.js","sourceRoot":"","sources":["../src/pixel-diff.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAC/B,CAAoB,EACpB,CAAoB,EACpB,gBAAgB,GAAG,CAAC;IAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;IAClC,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,gBAAgB;YAAE,OAAO,IAAI,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAA;IACnC,OAAO,OAAO,GAAG,MAAM,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAIpC;IACC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,KAAK,CAAA;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAA;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAA;IACtD,OAAO,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,CAAA;AAC5C,CAAC"}

package/dist/quality-caps.d.ts

@@ -0,0 +1,66 @@
+import type { QualityKnobSet, QualityTier } from './quality-types.js';
+export declare const TIER_ORDER: readonly QualityTier[];
+export declare const HYSTERESIS: {
+    readonly emergencyP95Ms: 50;
+    readonly dropP95Ms: 33.4;
+    readonly climbP95Ms: 22;
+    readonly dropWindows: 2;
+    readonly climbWindows: 3;
+    readonly cooldownWindows: 2;
+    readonly windowFrames: 90;
+    readonly ttfiBudgetMs: 3000;
+    readonly targetFps: 30;
+};
+export interface GenericTierCaps {
+    pixelRatio: number;
+    drawingBufferPixels?: number;
+    shadowCasters?: number;
+    postfxOff: boolean;
+    toneMapping?: 0 | 1;
+    anisotropy?: number;
+}
+export declare const GENERIC_CAPS: Record<QualityTier, GenericTierCaps>;
+/** Extra generic caps applied once when potato still misses 30 FPS. */
+export declare const POTATO_FLOOR_CAPS: {
+    readonly pixelRatio: 0.5;
+    readonly drawingBufferPixels: 600000;
+    readonly shadowCasters: 0;
+    readonly postfxOff: true;
+};
+/**
+ * One more generic-cap nudge when the potato floor still misses 30 FPS
+ * but avgFps is already in the high 20s. Do not apply meshLod/rtScale here.
+ */
+export declare const POTATO_NEAR_MISS_CAPS: {
+    readonly pixelRatio: 0.4;
+    readonly drawingBufferPixels: 500000;
+    readonly shadowCasters: 0;
+    readonly postfxOff: true;
+};
+/** Inclusive lower bound for the high-20s near-miss floor nudge. */
+export declare const POTATO_NEAR_MISS_MIN_AVG_FPS = 24;
+/**
+ * Extra generic caps when the potato floor still misses and avgFps stays
+ * below 10. Do not apply meshLod/rtScale here.
+ */
+export declare const POTATO_HOPELESS_CAPS: {
+    readonly pixelRatio: 0.35;
+    readonly drawingBufferPixels: 400000;
+    readonly shadowCasters: 0;
+    readonly postfxOff: true;
+};
+/** Exclusive upper bound: hopeless floor only when avgFps is below this. */
+export declare const POTATO_HOPELESS_MAX_AVG_FPS = 10;
+/**
+ * After the second-stage potato floor, if avgFps is still below this,
+ * pause spectrum and no-op every cascade update. Prefer pause over destroy.
+ */
+export declare const POTATO_OCEAN_FREEZE_MAX_AVG_FPS = 5;
+/** fftSize that no-ops `cascade.update` on every cascade (pause, do not dispose). */
+export declare const POTATO_OCEAN_FREEZE_FFT_SIZE: readonly [0, 0, 0];
+/** Lowest pelagic `effectQuality` when the handle exposes that knob. */
+export declare const POTATO_OCEAN_FREEZE_EFFECT_QUALITY = 0;
+/** `spectrumEveryNFrames` value that pauses updateSpectrum/runPass entirely. */
+export declare const SPECTRUM_PAUSE_EVERY_N = 0;
+export declare const ADAPTER_KNOBS: Record<QualityTier, QualityKnobSet>;
+//# sourceMappingURL=quality-caps.d.ts.map

package/dist/quality-caps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-caps.d.ts","sourceRoot":"","sources":["../src/quality-caps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErE,eAAO,MAAM,UAAU,EAAE,SAAS,WAAW,EAAqC,CAAA;AAElF,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAA;AAEV,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CA2B7D,CAAA;AAED,uEAAuE;AACvE,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAA;AAEV,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAA;AAEV,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAA;AAEhD,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,oBAAqB,CAAA;AAE9D,wEAAwE;AACxE,eAAO,MAAM,kCAAkC,IAAI,CAAA;AAEnD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,CA2B7D,CAAA"}

package/dist/quality-caps.js

@@ -0,0 +1,111 @@
+export const TIER_ORDER = ['potato', 'low', 'mid', 'high'];
+export const HYSTERESIS = {
+    emergencyP95Ms: 50,
+    dropP95Ms: 33.4,
+    climbP95Ms: 22,
+    dropWindows: 2,
+    climbWindows: 3,
+    cooldownWindows: 2,
+    windowFrames: 90,
+    ttfiBudgetMs: 3000,
+    targetFps: 30,
+};
+export const GENERIC_CAPS = {
+    potato: {
+        pixelRatio: 1.0,
+        drawingBufferPixels: 1.2e6,
+        shadowCasters: 0,
+        postfxOff: true,
+        toneMapping: 0,
+        anisotropy: 1,
+    },
+    low: {
+        pixelRatio: 1.25,
+        drawingBufferPixels: 2.0e6,
+        shadowCasters: 1,
+        postfxOff: true,
+        toneMapping: 1,
+        anisotropy: 1,
+    },
+    mid: {
+        pixelRatio: 1.5,
+        drawingBufferPixels: 2.7e6,
+        postfxOff: false,
+        anisotropy: 4,
+    },
+    high: {
+        pixelRatio: 2,
+        postfxOff: false,
+    },
+};
+/** Extra generic caps applied once when potato still misses 30 FPS. */
+export const POTATO_FLOOR_CAPS = {
+    pixelRatio: 0.5,
+    drawingBufferPixels: 6e5,
+    shadowCasters: 0,
+    postfxOff: true,
+};
+/**
+ * One more generic-cap nudge when the potato floor still misses 30 FPS
+ * but avgFps is already in the high 20s. Do not apply meshLod/rtScale here.
+ */
+export const POTATO_NEAR_MISS_CAPS = {
+    pixelRatio: 0.4,
+    drawingBufferPixels: 5e5,
+    shadowCasters: 0,
+    postfxOff: true,
+};
+/** Inclusive lower bound for the high-20s near-miss floor nudge. */
+export const POTATO_NEAR_MISS_MIN_AVG_FPS = 24;
+/**
+ * Extra generic caps when the potato floor still misses and avgFps stays
+ * below 10. Do not apply meshLod/rtScale here.
+ */
+export const POTATO_HOPELESS_CAPS = {
+    pixelRatio: 0.35,
+    drawingBufferPixels: 4e5,
+    shadowCasters: 0,
+    postfxOff: true,
+};
+/** Exclusive upper bound: hopeless floor only when avgFps is below this. */
+export const POTATO_HOPELESS_MAX_AVG_FPS = 10;
+/**
+ * After the second-stage potato floor, if avgFps is still below this,
+ * pause spectrum and no-op every cascade update. Prefer pause over destroy.
+ */
+export const POTATO_OCEAN_FREEZE_MAX_AVG_FPS = 5;
+/** fftSize that no-ops `cascade.update` on every cascade (pause, do not dispose). */
+export const POTATO_OCEAN_FREEZE_FFT_SIZE = [0, 0, 0];
+/** Lowest pelagic `effectQuality` when the handle exposes that knob. */
+export const POTATO_OCEAN_FREEZE_EFFECT_QUALITY = 0;
+/** `spectrumEveryNFrames` value that pauses updateSpectrum/runPass entirely. */
+export const SPECTRUM_PAUSE_EVERY_N = 0;
+export const ADAPTER_KNOBS = {
+    potato: {
+        fftSize: [64, 0, 0],
+        spectrumEveryNFrames: 8,
+        deferredHdr: true,
+    },
+    low: {
+        fftSize: [128, 128, 128],
+        spectrumEveryNFrames: 1,
+        rtScale: 0.5,
+        meshLod: 1,
+        deferredHdr: true,
+    },
+    mid: {
+        fftSize: [128, 256, 128],
+        spectrumEveryNFrames: 1,
+        rtScale: 0.7,
+        meshLod: 2,
+        deferredHdr: false,
+    },
+    high: {
+        fftSize: [128, 256, 128],
+        spectrumEveryNFrames: 1,
+        rtScale: 1.0,
+        meshLod: 2,
+        deferredHdr: false,
+    },
+};
+//# sourceMappingURL=quality-caps.js.map

package/dist/quality-caps.js.map

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

package/dist/quality-types.d.ts

@@ -0,0 +1,31 @@
+export type QualityTier = 'potato' | 'low' | 'mid' | 'high';
+export type QualityMode = 'advise' | 'safe-auto' | 'takeover';
+export type LadderPhase = 'boot' | 'runtime';
+export type AdapterCapability = 'fftSize' | 'rtScale' | 'meshLod' | 'deferredHdr' | 'simPassCount';
+export interface QualityKnobSet {
+    fftSize?: number[];
+    spectrumEveryNFrames?: number;
+    rtScale?: number;
+    meshLod?: 0 | 1 | 2;
+    deferredHdr?: boolean;
+    effectQuality?: number;
+}
+export interface AdapterExtras {
+    simPassCount?: number;
+    bytesLoaded?: number;
+    compileMs?: number;
+}
+export interface KnobHandle {
+    rollback(): void;
+}
+export interface QualityAdapter {
+    readonly id: string;
+    capabilities(): AdapterCapability[];
+    snapshot(): QualityKnobSet;
+    apply(tier: QualityTier, knobs: QualityKnobSet): KnobHandle;
+    readExtras?(): AdapterExtras;
+    takeExclusiveControl?(): {
+        release(): void;
+    };
+}
+//# sourceMappingURL=quality-types.d.ts.map

package/dist/quality-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-types.d.ts","sourceRoot":"","sources":["../src/quality-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAC3D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAA;AAC7D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;AAE5C,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,SAAS,GACT,aAAa,GACb,cAAc,CAAA;AAElB,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,YAAY,IAAI,iBAAiB,EAAE,CAAA;IACnC,QAAQ,IAAI,cAAc,CAAA;IAC1B,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,GAAG,UAAU,CAAA;IAC3D,UAAU,CAAC,IAAI,aAAa,CAAA;IAC5B,oBAAoB,CAAC,IAAI;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAA;CAC7C"}

package/dist/quality-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quality-types.js.map

package/dist/quality-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-types.js","sourceRoot":"","sources":["../src/quality-types.ts"],"names":[],"mappings":""}

package/dist/scene-snapshot.d.ts

@@ -0,0 +1,29 @@
+import type { SceneSnapshot } from './types.js';
+export interface SnapshotTextureInput {
+    uuid: string;
+    width: number;
+    height: number;
+    bytesPerPixel: number;
+}
+export interface SnapshotInput {
+    objectCount: number;
+    meshCount: number;
+    geometries: ReadonlyArray<{
+        uuid: string;
+    }>;
+    materials: ReadonlyArray<{
+        uuid: string;
+    }>;
+    textures: ReadonlyArray<SnapshotTextureInput>;
+    lights: ReadonlyArray<{
+        castShadow: boolean;
+    }>;
+    drawCalls: number;
+    triangles: number;
+    continuousFrameloop: boolean;
+    matrixAutoUpdateCount: number;
+    rendererPixelRatio?: number | undefined;
+    antialias?: boolean | undefined;
+}
+export declare function snapshotScene(input: SnapshotInput): SceneSnapshot;
+//# sourceMappingURL=scene-snapshot.d.ts.map

package/dist/scene-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-snapshot.d.ts","sourceRoot":"","sources":["../src/scene-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3C,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1C,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC7C,MAAM,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAChC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CA2BjE"}

package/dist/scene-snapshot.js

@@ -0,0 +1,29 @@
+export function snapshotScene(input) {
+    const geometryIds = new Set(input.geometries.map((g) => g.uuid));
+    const materialIds = new Set(input.materials.map((m) => m.uuid));
+    const textureIds = new Set(input.textures.map((t) => t.uuid));
+    let estimatedVramBytes = 0;
+    let maxTextureDimension = 0;
+    for (const tex of input.textures) {
+        estimatedVramBytes += tex.width * tex.height * tex.bytesPerPixel;
+        maxTextureDimension = Math.max(maxTextureDimension, tex.width, tex.height);
+    }
+    return {
+        objectCount: input.objectCount,
+        meshCount: input.meshCount,
+        geometryCount: geometryIds.size,
+        materialCount: materialIds.size,
+        textureCount: textureIds.size,
+        estimatedVramBytes,
+        lightCount: input.lights.length,
+        shadowCastingLightCount: input.lights.filter((l) => l.castShadow).length,
+        drawCalls: input.drawCalls,
+        triangles: input.triangles,
+        maxTextureDimension,
+        continuousFrameloop: input.continuousFrameloop,
+        matrixAutoUpdateCount: input.matrixAutoUpdateCount,
+        rendererPixelRatio: input.rendererPixelRatio,
+        antialias: input.antialias,
+    };
+}
+//# sourceMappingURL=scene-snapshot.js.map

package/dist/scene-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-snapshot.js","sourceRoot":"","sources":["../src/scene-snapshot.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7D,IAAI,kBAAkB,GAAG,CAAC,CAAA;IAC1B,IAAI,mBAAmB,GAAG,CAAC,CAAA;IAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,kBAAkB,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa,CAAA;QAChE,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,WAAW,CAAC,IAAI;QAC/B,aAAa,EAAE,WAAW,CAAC,IAAI;QAC/B,YAAY,EAAE,UAAU,CAAC,IAAI;QAC7B,kBAAkB;QAClB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,uBAAuB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM;QACxE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,mBAAmB;QACnB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;QAClD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAA;AACH,CAAC"}

package/dist/start-tier.d.ts

@@ -0,0 +1,18 @@
+import type { DeviceCapabilities } from './types.js';
+import type { DeviceProbeInput } from './device-probe.js';
+import type { QualityTier } from './quality-types.js';
+export interface StartTierResult {
+    startTier: QualityTier;
+    maxTier: QualityTier;
+    mobile: boolean;
+    noFloatRt: boolean;
+}
+export declare function isMobileSignal(input: {
+    maxTouchPoints?: number;
+    coarsePointer?: boolean;
+    deviceMemory?: number;
+    devicePixelRatio: number;
+    hardwareConcurrency: number;
+}): boolean;
+export declare function resolveStartTier(caps: DeviceCapabilities, opts?: Partial<DeviceProbeInput>): StartTierResult;
+//# sourceMappingURL=start-tier.d.ts.map

package/dist/start-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-tier.d.ts","sourceRoot":"","sources":["../src/start-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,WAAW,CAAA;IACtB,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,GAAG,OAAO,CAYV;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,EACxB,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACnC,eAAe,CA8CjB"}

package/dist/start-tier.js

@@ -0,0 +1,58 @@
+export function isMobileSignal(input) {
+    if ((input.maxTouchPoints ?? 0) >= 1)
+        return true;
+    if (input.coarsePointer === true)
+        return true;
+    if (input.deviceMemory !== undefined &&
+        input.deviceMemory <= 8 &&
+        input.devicePixelRatio >= 2 &&
+        input.hardwareConcurrency <= 8) {
+        return true;
+    }
+    return false;
+}
+export function resolveStartTier(caps, opts = {}) {
+    const deviceMemory = opts.deviceMemory ?? caps.deviceMemory;
+    const maxTouchPoints = opts.maxTouchPoints ?? caps.maxTouchPoints;
+    const coarsePointer = opts.coarsePointer ?? caps.coarsePointer;
+    const colorBufferFloat = opts.colorBufferFloat ?? caps.colorBufferFloat;
+    const floatLinear = opts.floatLinear ?? caps.floatLinear;
+    const devicePixelRatio = opts.devicePixelRatio ?? caps.devicePixelRatio;
+    const hardwareConcurrency = opts.hardwareConcurrency ?? caps.hardwareConcurrency;
+    const webgl = opts.webgl ?? caps.webgl;
+    if (!webgl) {
+        throw new Error('webgl required for quality ladder');
+    }
+    const mobileInput = {
+        devicePixelRatio,
+        hardwareConcurrency,
+    };
+    if (maxTouchPoints !== undefined)
+        mobileInput.maxTouchPoints = maxTouchPoints;
+    if (coarsePointer !== undefined)
+        mobileInput.coarsePointer = coarsePointer;
+    if (deviceMemory !== undefined)
+        mobileInput.deviceMemory = deviceMemory;
+    const mobile = isMobileSignal(mobileInput);
+    if (colorBufferFloat === false) {
+        return { startTier: 'potato', maxTier: 'potato', mobile, noFloatRt: true };
+    }
+    if (mobile) {
+        const potatoClass = deviceMemory === undefined ||
+            deviceMemory <= 4 ||
+            hardwareConcurrency <= 4 ||
+            floatLinear === false;
+        if (potatoClass) {
+            return { startTier: 'potato', maxTier: 'mid', mobile: true, noFloatRt: false };
+        }
+        return { startTier: 'low', maxTier: 'mid', mobile: true, noFloatRt: false };
+    }
+    if (caps.tier === 'low') {
+        return { startTier: 'low', maxTier: 'high', mobile: false, noFloatRt: false };
+    }
+    if (caps.tier === 'mid') {
+        return { startTier: 'mid', maxTier: 'high', mobile: false, noFloatRt: false };
+    }
+    return { startTier: 'high', maxTier: 'high', mobile: false, noFloatRt: false };
+}
+//# sourceMappingURL=start-tier.js.map

package/dist/start-tier.js.map

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

package/dist/stats-math.d.ts

@@ -0,0 +1,3 @@
+/** Median of a non-empty numeric series. Empty input is 0 (callers must not invent). */
+export declare function median(values: readonly number[]): number;
+//# sourceMappingURL=stats-math.d.ts.map

package/dist/stats-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-math.d.ts","sourceRoot":"","sources":["../src/stats-math.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMxD"}

package/dist/stats-math.js

@@ -0,0 +1,11 @@
+/** Median of a non-empty numeric series. Empty input is 0 (callers must not invent). */
+export function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1)
+        return sorted[mid];
+    return (sorted[mid - 1] + sorted[mid]) / 2;
+}
+//# sourceMappingURL=stats-math.js.map

package/dist/stats-math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-math.js","sourceRoot":"","sources":["../src/stats-math.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAE,CAAA;IAChD,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,CAAA;AAC9C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+export type Profile = 'marketing' | 'product' | 'game' | 'cad' | 'auto';
+export type Mode = 'diagnose' | 'optimize' | 'benchmark';
+export type DeviceTier = 'low' | 'mid' | 'high';
+export type Severity = 'info' | 'warn' | 'error';
+export type PassId = 'dpr-cap' | 'pixel-budget' | 'shadow-budget' | 'postfx-budget' | 'tone-map-lite' | 'anisotropy-cap' | 'frameloop-demand' | 'distance-cull' | 'material-downgrade';
+export declare const SAFE_PASSES: readonly PassId[];
+/** One-shot passes that are not safe by default (world-space distance-cull hides permanently). */
+export declare const AGGRESSIVE_PASSES: readonly PassId[];
+/** Marketing/product (static) scenes may demand-loop; games and CAD keep the host RAF. */
+export declare function isStaticDemandProfile(profile: Profile): boolean;
+/**
+ * Default Quality Ladder / Doctor `apply: ['safe']` set.
+ * `frameloop-demand` is omitted unless the profile is clearly marketing/product,
+ * or the host opts in via `optimize({ apply: ['frameloop-demand'] })`.
+ */
+export declare function safePassesFor(profile: Profile): PassId[];
+export interface DeviceCapabilities {
+    tier: DeviceTier;
+    maxTextureSize: number;
+    webgl: boolean;
+    webgpu: boolean;
+    devicePixelRatio: number;
+    hardwareConcurrency: number;
+    deviceMemory?: number;
+    maxTouchPoints?: number;
+    coarsePointer?: boolean;
+    prefersReducedData?: boolean;
+    colorBufferFloat?: boolean;
+    floatLinear?: boolean;
+    maxRenderbufferSize?: number;
+}
+export interface MetricsSample {
+    avgFps: number;
+    p95FrameTimeMs: number;
+    drawCalls: number;
+    /** Drawn triangles from renderer.info.render.triangles (never invented). */
+    triangles: number;
+    textureCount: number;
+    estimatedVramBytes?: number | undefined;
+    geometryCount: number;
+    lightCount: number;
+    shadowCastingLightCount: number;
+    simPassCount?: number;
+    bytesLoaded?: number;
+    compileMs?: number;
+    drawingBufferPixels?: number;
+    /** GPU elapsed ms from EXT_disjoint_timer_query_webgl2 when a result is actually available. */
+    gpuFrameTimeMs?: number | undefined;
+    /**
+     * Sampler existed but this measure produced no GPU times (tight loop without a
+     * macrotask, leftovers discarded, or QUERY_RESULT never became available).
+     * Never invent `gpuFrameTimeMs` when this is set.
+     */
+    gpuTimingSkipped?: boolean | undefined;
+    /** Live run was hidden or rAF-throttled; do not treat this sample as a score win. */
+    invalid?: boolean | undefined;
+    invalidReason?: string | undefined;
+}
+export interface SceneSnapshot {
+    objectCount: number;
+    meshCount: number;
+    geometryCount: number;
+    materialCount: number;
+    textureCount: number;
+    estimatedVramBytes: number;
+    lightCount: number;
+    shadowCastingLightCount: number;
+    drawCalls: number;
+    triangles: number;
+    maxTextureDimension: number;
+    continuousFrameloop: boolean;
+    matrixAutoUpdateCount: number;
+    /** Finite renderer DPR when known; omitted/undefined means do not flag uncapped-dpr. */
+    rendererPixelRatio?: number | undefined;
+    /** MSAA flag from GL context attributes when known. */
+    antialias?: boolean | undefined;
+    /**
+     * Scene-graph triangle attribution: indexed/non-indexed geometry × InstancedMesh.count.
+     * Used to name top contributors. Cost / score / triangles/too-many use `triangles` (drawn).
+     * Omitted when no mesh geometry could be counted.
+     */
+    geometryTriangleCount?: number | undefined;
+    /** Top contributor as `name:triangles` (first of top-N). Omitted when none counted. */
+    triangleContributorSummary?: string | undefined;
+    topContributorShare?: number | undefined;
+    frustumCulledDisabledCount?: number | undefined;
+    /**
+     * Meshes whose world bounding-sphere radius is greater than `camera.far`.
+     * InstancedMesh uses computeBoundingSphere() (instance-aware), not the prototype sphere.
+     * Omitted when camera.far or a bounding sphere cannot be read.
+     */
+    oversizedBoundCount?: number | undefined;
+    shadowTriangleCount?: number | undefined;
+    /** Casters fully outside every detectable shadow camera. Omitted when no shadow camera is testable. */
+    shadowCastersOutsideFrustum?: number | undefined;
+    zeroIntensityLightCount?: number | undefined;
+    instancedBufferBytes?: number | undefined;
+    /** InstancedMesh removed from the graph without dispose(). */
+    removedUndisposedInstancedCount?: number | undefined;
+    composerPixelRatio?: number | undefined;
+    composerWidth?: number | undefined;
+    composerHeight?: number | undefined;
+    drawingBufferWidth?: number | undefined;
+    drawingBufferHeight?: number | undefined;
+    /** Copied from a measured sample only when EXT_disjoint_timer_query_webgl2 returned a result. */
+    gpuFrameTimeMs?: number | undefined;
+}
+export interface RendererInfoLike {
+    render: {
+        calls: number;
+        triangles: number;
+        points?: number | undefined;
+    };
+    memory: {
+        geometries: number;
+        textures: number;
+    };
+    autoReset?: boolean | undefined;
+    reset?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AACvE,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AACxD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAC/C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAChD,MAAM,MAAM,MAAM,GACd,SAAS,GACT,cAAc,GACd,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,CAAA;AAExB,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAO/B,CAAA;AAEV,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAA+B,CAAA;AAE9E,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAKxD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,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;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,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;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,uFAAuF;IACvF,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,uGAAuG;IACvG,2BAA2B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5C,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,8DAA8D;IAC9D,+BAA+B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpD,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,iGAAiG;IACjG,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACzE,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB"}

package/dist/types.js

@@ -0,0 +1,26 @@
+export const SAFE_PASSES = [
+    'dpr-cap',
+    'pixel-budget',
+    'shadow-budget',
+    'postfx-budget',
+    'tone-map-lite',
+    'anisotropy-cap',
+];
+/** One-shot passes that are not safe by default (world-space distance-cull hides permanently). */
+export const AGGRESSIVE_PASSES = ['distance-cull'];
+/** Marketing/product (static) scenes may demand-loop; games and CAD keep the host RAF. */
+export function isStaticDemandProfile(profile) {
+    return profile === 'marketing' || profile === 'product';
+}
+/**
+ * Default Quality Ladder / Doctor `apply: ['safe']` set.
+ * `frameloop-demand` is omitted unless the profile is clearly marketing/product,
+ * or the host opts in via `optimize({ apply: ['frameloop-demand'] })`.
+ */
+export function safePassesFor(profile) {
+    if (isStaticDemandProfile(profile)) {
+        return [...SAFE_PASSES, 'frameloop-demand'];
+    }
+    return [...SAFE_PASSES];
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,SAAS;IACT,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;IACf,gBAAgB;CACR,CAAA;AAEV,kGAAkG;AAClG,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,eAAe,CAAU,CAAA;AAE9E,0FAA0F;AAC1F,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,SAAS,CAAA;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,WAAW,EAAE,kBAAkB,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,CAAC,GAAG,WAAW,CAAC,CAAA;AACzB,CAAC"}