@triforge/render-budget-core 0.1.0

package/dist/core/BudgetPlanner.d.ts

@@ -0,0 +1,3 @@
+import type { HardwareProfile, NetworkProfile, RenderBudgetOverride, RenderBudgetPlan } from './types.js';
+export declare function planBudget(hardware: HardwareProfile, network: NetworkProfile, override?: RenderBudgetOverride | null): RenderBudgetPlan;
+//# sourceMappingURL=BudgetPlanner.d.ts.map

package/dist/core/BudgetPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetPlanner.d.ts","sourceRoot":"","sources":["../../src/core/BudgetPlanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAGjB,MAAM,YAAY,CAAA;AAgDnB,wBAAgB,UAAU,CACxB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACrC,gBAAgB,CA0ClB"}

package/dist/core/BudgetPlanner.js

@@ -0,0 +1,87 @@
+const TIER_ORDER = ['potato', 'low', 'mid', 'high'];
+function tierRank(tier) {
+    return TIER_ORDER.indexOf(tier);
+}
+function moreConservative(a, b) {
+    return tierRank(a) <= tierRank(b) ? a : b;
+}
+/** High tier is the only variant that requests AVIF — gate it on real decode support, not device class alone. */
+function hardwareTextureTier(hw) {
+    if (hw.maxTextureSize >= 8192 && hw.supportsAVIF)
+        return 'high';
+    if (hw.maxTextureSize >= 4096)
+        return 'mid';
+    if (hw.maxTextureSize >= 2048)
+        return 'low';
+    return 'potato';
+}
+function networkTextureTier(net) {
+    if (net.downlinkMbps !== null) {
+        if (net.downlinkMbps >= 5)
+            return 'high';
+        if (net.downlinkMbps >= 1.5)
+            return 'mid';
+        return 'low';
+    }
+    switch (net.effectiveType) {
+        case '4g':
+            return 'high';
+        case '3g':
+            return 'mid';
+        case '2g':
+        case 'slow-2g':
+            return 'low';
+        default:
+            // Unknown network signal (e.g. effectiveType missing) — don't punish an
+            // otherwise-capable device, but don't assume the best case either.
+            return 'mid';
+    }
+}
+/** Shader complexity depends only on GPU capability proxies — network has no bearing on compile safety. */
+function shaderComplexityTier(hw) {
+    if (hw.maxTextureSize >= 4096 && hw.maxContexts >= 8)
+        return 'full';
+    if (hw.maxTextureSize >= 2048 && hw.maxContexts >= 4)
+        return 'reduced';
+    return 'baked-only';
+}
+export function planBudget(hardware, network, override) {
+    // 1. Explicit manual override wins outright, skips all detection.
+    if (override) {
+        const hwTier = hardwareTextureTier(hardware);
+        return {
+            textureTier: override.textureTier ?? hwTier,
+            textureFormat: (override.textureTier ?? hwTier) === 'high' && hardware.supportsAVIF ? 'avif' : 'jpg',
+            shaderComplexity: override.shaderComplexity ?? shaderComplexityTier(hardware),
+            maxConcurrentContexts: override.maxConcurrentContexts ?? hardware.maxContexts,
+            source: 'manual-override',
+        };
+    }
+    const hwTextureTier = hardwareTextureTier(hardware);
+    const shaderComplexity = shaderComplexityTier(hardware);
+    const maxConcurrentContexts = hardware.maxContexts;
+    // 2. saveData is an explicit user/OS data-cost signal — forces the most conservative
+    // texture tier regardless of measured hardware/network. Shader complexity and context
+    // budget are unaffected: they're about what the device can safely render, not bandwidth.
+    if (network.saveData) {
+        return {
+            textureTier: 'potato',
+            textureFormat: 'jpg',
+            shaderComplexity,
+            maxConcurrentContexts,
+            source: 'save-data',
+        };
+    }
+    // 3. Neither hardware nor network categorically outranks the other for texture
+    // selection — whichever is more conservative wins.
+    const netTextureTier = networkTextureTier(network);
+    const textureTier = moreConservative(hwTextureTier, netTextureTier);
+    return {
+        textureTier,
+        textureFormat: textureTier === 'high' && hardware.supportsAVIF ? 'avif' : 'jpg',
+        shaderComplexity,
+        maxConcurrentContexts,
+        source: 'auto',
+    };
+}
+//# sourceMappingURL=BudgetPlanner.js.map

package/dist/core/BudgetPlanner.js.map

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

package/dist/core/DeviceProfiler.d.ts

@@ -0,0 +1,7 @@
+import type { HardwareProbeEnv, HardwareProfile, NetworkProbeEnv, NetworkProfile } from './types.js';
+export declare function profileHardware(env: HardwareProbeEnv): Promise<HardwareProfile>;
+export declare function profileNetwork(env: NetworkProbeEnv): Promise<NetworkProfile>;
+/** Default environment for real browsers — the only place this package touches actual globals. */
+export declare function createBrowserHardwareEnv(): HardwareProbeEnv;
+export declare function createBrowserNetworkEnv(probeAssetUrl: string): NetworkProbeEnv;
+//# sourceMappingURL=DeviceProfiler.d.ts.map

package/dist/core/DeviceProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceProfiler.d.ts","sourceRoot":"","sources":["../../src/core/DeviceProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA2DpG,wBAAsB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAOrF;AAWD,wBAAsB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAiBlF;AAED,kGAAkG;AAClG,wBAAgB,wBAAwB,IAAI,gBAAgB,CAiC3D;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAkB9E"}

package/dist/core/DeviceProfiler.js

@@ -0,0 +1,150 @@
+const FALLBACK_MAX_CONTEXTS = 8;
+const FALLBACK_MAX_TEXTURE_SIZE = 2048;
+/**
+ * Hard safety cap on simultaneous probe contexts. Real mobile ceilings are commonly
+ * 8-16; this only needs to be high enough to find that ceiling, never high enough to
+ * itself become the kind of context-exhaustion bug this package exists to prevent.
+ */
+const MAX_CONTEXT_PROBE_ATTEMPTS = 20;
+/**
+ * Probes the real number of simultaneous WebGL contexts this browser tolerates by
+ * creating scratch contexts until creation fails or the safety cap is hit, then
+ * releasing all of them. Must run before any other WebGL consumer (renderers,
+ * carousels, etc.) mounts — probing after the fact would compete with real contexts
+ * and could itself trigger the context loss this package exists to prevent.
+ *
+ * Reads MAX_TEXTURE_SIZE from the first context created in this same pass, rather
+ * than creating a separate context afterward: real WEBGL_lose_context releases are
+ * asynchronous, so a context "lost" here isn't guaranteed to free its slot in time
+ * for a second, later creation — that would make the texture-size read spuriously
+ * fail right after a context-count probe that used the whole budget.
+ */
+function probeContextsAndTextureSize(env) {
+    const held = [];
+    let maxTextureSize = FALLBACK_MAX_TEXTURE_SIZE;
+    try {
+        for (let i = 0; i < MAX_CONTEXT_PROBE_ATTEMPTS; i++) {
+            const gl = env.createWebGLContext();
+            if (!gl)
+                break;
+            held.push(gl);
+            if (held.length === 1) {
+                try {
+                    const size = gl.getParameter(gl.MAX_TEXTURE_SIZE);
+                    if (typeof size === 'number' && Number.isFinite(size) && size > 0)
+                        maxTextureSize = size;
+                }
+                catch {
+                    // keep the fallback
+                }
+            }
+        }
+        return {
+            maxContexts: held.length > 0 ? held.length : FALLBACK_MAX_CONTEXTS,
+            maxTextureSize,
+        };
+    }
+    finally {
+        if (env.loseContext) {
+            for (const gl of held) {
+                try {
+                    env.loseContext(gl);
+                }
+                catch {
+                    // best-effort cleanup only — a failure to release a scratch context
+                    // must never surface as a profiling failure
+                }
+            }
+        }
+    }
+}
+export async function profileHardware(env) {
+    const { maxContexts, maxTextureSize } = probeContextsAndTextureSize(env);
+    const [supportsAVIF, supportsWebP] = await Promise.all([
+        env.probeImageDecode('avif').catch(() => false),
+        env.probeImageDecode('webp').catch(() => false),
+    ]);
+    return { maxContexts, maxTextureSize, supportsAVIF, supportsWebP };
+}
+const PROBE_DOWNLOAD_THRESHOLD_MBPS = { fast: 5, medium: 1.5 };
+function classifyDownlink(mbps) {
+    if (mbps === null)
+        return 'unknown';
+    if (mbps >= PROBE_DOWNLOAD_THRESHOLD_MBPS.fast)
+        return '4g';
+    if (mbps >= PROBE_DOWNLOAD_THRESHOLD_MBPS.medium)
+        return '3g';
+    return '2g';
+}
+export async function profileNetwork(env) {
+    const conn = env.connection;
+    if (conn && typeof conn.effectiveType === 'string') {
+        return {
+            effectiveType: conn.effectiveType,
+            downlinkMbps: typeof conn.downlink === 'number' ? conn.downlink : null,
+            saveData: conn.saveData === true,
+        };
+    }
+    // No Network Information API (e.g. Safari/iOS) — fall back to a timed probe download.
+    const downlinkMbps = await env.probeDownloadMbps().catch(() => null);
+    return {
+        effectiveType: classifyDownlink(downlinkMbps),
+        downlinkMbps,
+        saveData: false,
+    };
+}
+/** Default environment for real browsers — the only place this package touches actual globals. */
+export function createBrowserHardwareEnv() {
+    return {
+        createWebGLContext() {
+            try {
+                const canvas = document.createElement('canvas');
+                return (canvas.getContext('webgl2') ??
+                    canvas.getContext('webgl') ??
+                    null);
+            }
+            catch {
+                return null;
+            }
+        },
+        loseContext(gl) {
+            const ext = gl.getExtension('WEBGL_lose_context');
+            ext?.loseContext();
+        },
+        async probeImageDecode(format) {
+            // 1x1 sample images, smallest valid encode of each format.
+            const samples = {
+                avif: 'data:image/avif;base64,AAAAHGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZgAAAOptZXRhAAAAAAAAACFoZGxyAAAAAAAAAABwaWN0AAAAAAAAAAAAAAAAAAAAAA5waXRtAAAAAAABAAAAImlsb2MAAAAARAAAAgABAAEAAAEAAAAeAAABAAABAAAAKGlpbmYAAAAAAAEAAAAaaW5mZQIAAAAAAQAAYXYwMUltYWdlAAAAAGppcHJwAAAAWGlwY28AAAAUaXNwZQAAAAAAAAABAAAAAQAAAAxhdjFDgQAMAAAAABNjb2xybmNseAACAAIABoAAAAAXaXBtYQAAAAAAAAABAAEEAQIDhAAAACBtZGF0EgAKCBgABogQEDQgMgkQAAAAB8dSLfI=',
+                webp: 'data:image/webp;base64,UklGRhoAAABXRUJQVlA4TA0AAAAvAAAAEAcQERGIiP4HAA==',
+            };
+            return new Promise((resolve) => {
+                const img = new Image();
+                img.onload = () => resolve(img.width > 0 && img.height > 0);
+                img.onerror = () => resolve(false);
+                img.src = samples[format];
+            });
+        },
+    };
+}
+export function createBrowserNetworkEnv(probeAssetUrl) {
+    const nav = typeof navigator !== 'undefined' ? navigator : undefined;
+    return {
+        connection: nav?.connection,
+        async probeDownloadMbps() {
+            try {
+                const start = performance.now();
+                const res = await fetch(probeAssetUrl, { cache: 'no-store' });
+                const blob = await res.blob();
+                const seconds = (performance.now() - start) / 1000;
+                if (seconds <= 0)
+                    return null;
+                const bits = blob.size * 8;
+                return bits / seconds / 1000000;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=DeviceProfiler.js.map

package/dist/core/DeviceProfiler.js.map

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

package/dist/core/RenderBudgetSystem.d.ts

@@ -0,0 +1,24 @@
+import type { BudgetStorage, HardwareProbeEnv, NetworkProbeEnv, RenderBudgetOverride, RenderBudgetPlan } from './types.js';
+export interface RenderBudgetSystemConfig {
+    /** Let end users persist an explicit quality choice (e.g. a settings panel). Default true. */
+    allowUserOverride?: boolean;
+    /**
+     * Let a `?forceQuality=` query param force a tier for testing. Default false (opt-in per
+     * consumer, e.g. `!isProd`). Can only force a WORSE tier than auto-detected — never better —
+     * so a real visitor can't report an unreproducible performance bug by forcing a higher tier
+     * than their device actually supports.
+     */
+    allowDevOverride?: boolean;
+    /** Small fixed-size asset used to time-probe download speed where navigator.connection is unavailable. */
+    probeAssetUrl?: string;
+    storage?: BudgetStorage;
+    hardwareEnv?: HardwareProbeEnv;
+    networkEnv?: NetworkProbeEnv;
+    /** Override how the dev query param is read — for tests; defaults to location.search. */
+    readDevOverrideParam?: () => string | null;
+}
+export declare function getUserOverride(storage: BudgetStorage): RenderBudgetOverride | null;
+export declare function setUserOverride(storage: BudgetStorage, override: RenderBudgetOverride): void;
+export declare function clearUserOverride(storage: BudgetStorage): void;
+export declare function init(config?: RenderBudgetSystemConfig): Promise<RenderBudgetPlan>;
+//# sourceMappingURL=RenderBudgetSystem.d.ts.map

package/dist/core/RenderBudgetSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderBudgetSystem.d.ts","sourceRoot":"","sources":["../../src/core/RenderBudgetSystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,YAAY,CAAA;AAYnB,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAC3C;AAgCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,GAAG,IAAI,CAQnF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAE5F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE9D;AAMD,wBAAsB,IAAI,CAAC,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+C3F"}

package/dist/core/RenderBudgetSystem.js

@@ -0,0 +1,105 @@
+import { createBrowserHardwareEnv, createBrowserNetworkEnv, profileHardware, profileNetwork } from './DeviceProfiler.js';
+import { planBudget } from './BudgetPlanner.js';
+/** Bump when profileHardware()'s probing logic changes in a way that invalidates old cached profiles. */
+const HARDWARE_CACHE_VERSION = 1;
+const HARDWARE_CACHE_KEY = 'triforge-render-budget:hardware';
+const USER_OVERRIDE_KEY = 'triforge-render-budget:user-override';
+const TIER_ORDER = ['potato', 'low', 'mid', 'high'];
+function tierRank(tier) {
+    return TIER_ORDER.indexOf(tier);
+}
+function defaultStorage() {
+    if (typeof localStorage === 'undefined') {
+        // No persistent storage available (e.g. a non-browser test host without one injected) —
+        // degrade to a no-op so callers still get a working (just non-persistent) system.
+        return { getItem: () => null, setItem: () => { } };
+    }
+    return localStorage;
+}
+function defaultReadDevOverrideParam() {
+    if (typeof location === 'undefined')
+        return null;
+    return new URLSearchParams(location.search).get('forceQuality');
+}
+function readCachedHardware(storage) {
+    const raw = storage.getItem(HARDWARE_CACHE_KEY);
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== HARDWARE_CACHE_VERSION)
+            return null;
+        return parsed.profile;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCachedHardware(storage, profile) {
+    storage.setItem(HARDWARE_CACHE_KEY, JSON.stringify({ version: HARDWARE_CACHE_VERSION, profile }));
+}
+export function getUserOverride(storage) {
+    const raw = storage.getItem(USER_OVERRIDE_KEY);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function setUserOverride(storage, override) {
+    storage.setItem(USER_OVERRIDE_KEY, JSON.stringify(override));
+}
+export function clearUserOverride(storage) {
+    storage.setItem(USER_OVERRIDE_KEY, '');
+}
+function isValidTextureTier(value) {
+    return value === 'high' || value === 'mid' || value === 'low' || value === 'potato';
+}
+export async function init(config = {}) {
+    const allowUserOverride = config.allowUserOverride ?? true;
+    const allowDevOverride = config.allowDevOverride ?? false;
+    const storage = config.storage ?? defaultStorage();
+    const hardwareEnv = config.hardwareEnv ?? createBrowserHardwareEnv();
+    const networkEnv = config.networkEnv ?? createBrowserNetworkEnv(config.probeAssetUrl ?? '');
+    const readDevOverrideParam = config.readDevOverrideParam ?? defaultReadDevOverrideParam;
+    // Step 1 (cheap, synchronous): user override wins outright, skips all detection.
+    if (allowUserOverride) {
+        const userOverride = getUserOverride(storage);
+        if (userOverride) {
+            // Still need a hardware profile to fill in fields the override doesn't specify
+            // (e.g. a user who only picked a texture tier still needs a real shaderComplexity).
+            const hardware = readCachedHardware(storage) ?? (await profileHardware(hardwareEnv));
+            writeCachedHardware(storage, hardware);
+            const network = await profileNetwork(networkEnv);
+            return planBudget(hardware, network, userOverride);
+        }
+    }
+    // Step 2 & 3: hardware (cached) and network (never cached — changes visit to visit)
+    // probe concurrently; neither depends on the other's result.
+    const cachedHardware = readCachedHardware(storage);
+    const [hardware, network] = await Promise.all([
+        cachedHardware ? Promise.resolve(cachedHardware) : profileHardware(hardwareEnv),
+        profileNetwork(networkEnv),
+    ]);
+    if (!cachedHardware)
+        writeCachedHardware(storage, hardware);
+    // Step 4: saveData / min(hardware,network) precedence, via planBudget.
+    const autoPlan = planBudget(hardware, network, null);
+    // Dev override: only allowed to make the tier WORSE than what auto-detection found.
+    if (allowDevOverride) {
+        const forced = readDevOverrideParam();
+        if (isValidTextureTier(forced) && tierRank(forced) < tierRank(autoPlan.textureTier)) {
+            return {
+                ...autoPlan,
+                textureTier: forced,
+                textureFormat: forced === 'high' && hardware.supportsAVIF ? 'avif' : 'jpg',
+                source: 'manual-override',
+            };
+        }
+    }
+    return autoPlan;
+}
+//# sourceMappingURL=RenderBudgetSystem.js.map

package/dist/core/RenderBudgetSystem.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,61 @@
+export type TextureVariantTier = 'high' | 'mid' | 'low' | 'potato';
+export type ShaderComplexityTier = 'full' | 'reduced' | 'baked-only';
+export interface HardwareProfile {
+    /** Highest number of simultaneous WebGL contexts the browser tolerated before losing one. */
+    maxContexts: number;
+    /** gl.getParameter(gl.MAX_TEXTURE_SIZE) from a real context, or a conservative fallback. */
+    maxTextureSize: number;
+    /** Whether the browser can actually decode an AVIF image (probed, not sniffed from UA). */
+    supportsAVIF: boolean;
+    /** Whether the browser can actually decode a WebP image. */
+    supportsWebP: boolean;
+}
+export interface NetworkProfile {
+    /** 'slow-2g' | '2g' | '3g' | '4g' | 'unknown' — from navigator.connection.effectiveType, or derived from the probe download. */
+    effectiveType: string;
+    /** Estimated downlink in Mbps, if known. */
+    downlinkMbps: number | null;
+    /** OS/browser-level explicit data-saver signal (navigator.connection.saveData). */
+    saveData: boolean;
+}
+export interface RenderBudgetPlan {
+    /** Which texture asset variant to request. Combines resolution + format (see textureFormat). */
+    textureTier: TextureVariantTier;
+    /** Format to prefer for the resolved textureTier. */
+    textureFormat: 'avif' | 'jpg';
+    /** How complex a shader graph is safe to compile — governs procedural-vs-baked material choices. */
+    shaderComplexity: ShaderComplexityTier;
+    /** Max simultaneous WebGL contexts a consumer (e.g. a context-pool) should allow. */
+    maxConcurrentContexts: number;
+    /** Source of the final decision, for debugging/telemetry. */
+    source: 'manual-override' | 'save-data' | 'auto';
+}
+export interface RenderBudgetOverride {
+    textureTier?: TextureVariantTier;
+    shaderComplexity?: ShaderComplexityTier;
+    maxConcurrentContexts?: number;
+}
+/** Injectable seam: anything that can decide "hardware-tier-worthy" without touching real globals in tests. */
+export interface HardwareProbeEnv {
+    /** Create a WebGL context on a scratch canvas; return null if creation fails. */
+    createWebGLContext(): WebGLRenderingContext | WebGL2RenderingContext | null;
+    /** Release/lose a previously created context, if the environment can simulate that (tests only). */
+    loseContext?(gl: WebGLRenderingContext | WebGL2RenderingContext): void;
+    /** Attempt to decode a tiny sample image of the given format; resolve true/false, never throw. */
+    probeImageDecode(format: 'avif' | 'webp'): Promise<boolean>;
+}
+export interface NetworkProbeEnv {
+    /** Mirrors navigator.connection — undefined where the Network Information API isn't available (e.g. Safari). */
+    connection?: {
+        effectiveType?: string;
+        downlink?: number;
+        saveData?: boolean;
+    };
+    /** Fallback timed download of a small fixed-size asset; resolves measured Mbps, or null if it fails. */
+    probeDownloadMbps(): Promise<number | null>;
+}
+export interface BudgetStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;AAClE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAA;AAEpE,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,cAAc,EAAE,MAAM,CAAA;IACtB,2FAA2F;IAC3F,YAAY,EAAE,OAAO,CAAA;IACrB,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,gIAAgI;IAChI,aAAa,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,WAAW,EAAE,kBAAkB,CAAA;IAC/B,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,KAAK,CAAA;IAC7B,oGAAoG;IACpG,gBAAgB,EAAE,oBAAoB,CAAA;IACtC,qFAAqF;IACrF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,iBAAiB,GAAG,WAAW,GAAG,MAAM,CAAA;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,+GAA+G;AAC/G,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,kBAAkB,IAAI,qBAAqB,GAAG,sBAAsB,GAAG,IAAI,CAAA;IAC3E,oGAAoG;IACpG,WAAW,CAAC,CAAC,EAAE,EAAE,qBAAqB,GAAG,sBAAsB,GAAG,IAAI,CAAA;IACtE,kGAAkG;IAClG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,gHAAgH;IAChH,UAAU,CAAC,EAAE;QACX,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,wGAAwG;IACxG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C"}

package/dist/core/types.js

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

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { HardwareProfile, NetworkProfile, RenderBudgetPlan, RenderBudgetOverride, TextureVariantTier, ShaderComplexityTier, HardwareProbeEnv, NetworkProbeEnv, BudgetStorage, } from './core/types.js';
+export { profileHardware, profileNetwork, createBrowserHardwareEnv, createBrowserNetworkEnv, } from './core/DeviceProfiler.js';
+export { planBudget } from './core/BudgetPlanner.js';
+export { init as initRenderBudget, getUserOverride, setUserOverride, clearUserOverride, } from './core/RenderBudgetSystem.js';
+export type { RenderBudgetSystemConfig } from './core/RenderBudgetSystem.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,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,OAAO,EACL,IAAI,IAAI,gBAAgB,EACxB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { profileHardware, profileNetwork, createBrowserHardwareEnv, createBrowserNetworkEnv, } from './core/DeviceProfiler.js';
+export { planBudget } from './core/BudgetPlanner.js';
+export { init as initRenderBudget, getUserOverride, setUserOverride, clearUserOverride, } from './core/RenderBudgetSystem.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":"AAYA,OAAO,EACL,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,OAAO,EACL,IAAI,IAAI,gBAAgB,EACxB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAA"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@triforge/render-budget-core",
+  "version": "0.1.0",
+  "description": "Engine-agnostic device/network profiling and render-quality budget planning — texture tier, shader complexity, context-count policy from real runtime probes, not heuristics",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node test/run-tests.js",
+    "bench": "node bench/run-bench.js"
+  },
+  "keywords": [
+    "render-budget",
+    "device-profiler",
+    "webgl",
+    "texture-variants",
+    "three.js"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "author": "Aftab Ibrahim Kazi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AftabIbrahimKazi/triforge.git",
+    "directory": "render-budget-core"
+  },
+  "homepage": "https://github.com/AftabIbrahimKazi/triforge#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  }
+}