@funpixel/tools 0.0.0-stage → 0.1.1

package/dist/devtools/kapture/funpixel-kapture.min.js

@@ -0,0 +1 @@
+var FunpixelKapture=function(t){"use strict";function e(t){const e=Object.create(null);try{if(!t||"object"!=typeof t)return e;for(const[n,r]of Object.entries(t)){if(!n)continue;if(!r||"object"!=typeof r)continue;const t=r;"function"==typeof t.enter&&(e[n]={enter:t.enter,after:"string"==typeof t.after?t.after:void 0,motion:!0===t.motion})}}catch{}return e}function n(t){return Object.entries(t).map(([t,e])=>({id:t,after:e.after,motion:!0===e.motion}))}let r=0,o=!1;function i(){if(o)return;o=!0;const t=()=>{try{r=performance.now()}catch{}try{requestAnimationFrame(t)}catch{}};try{requestAnimationFrame(t)}catch{o=!1}}function c(){try{let t=0;const e=document.images;for(let n=0;n<e.length;n++)e[n].complete||t++;return t}catch{return 0}}function s(){try{const t=document.fonts;return t&&"loading"===t.status?1:0}catch{return 0}}function a(t){try{const e=t??performance.now();return r>0&&e-r<500}catch{return!1}}function u(t){const e=c(),n=s(),r=a();return{ok:0===e&&0===n&&r,pendingImages:e,pendingFonts:n,rafAlive:r,errors:t}}function f(t=5e3){return new Promise(e=>{const n=Date.now();let r=0;const o=()=>{try{if(0===c()&&0===s()?r++:r=0,r>=2)return e(!0);if(Date.now()-n>t)return e(!1);requestAnimationFrame(o)}catch{e(!1)}};try{requestAnimationFrame(o)}catch{e(!1)}})}const d=new Map;let l="__boot__",w=!1;function _(t){try{let e=d.get(l);if(e||(e=[],d.set(l,e)),e.length>=8)return;e.includes(t)||e.push(t)}catch{}}function h(){if(!w){w=!0;try{window.addEventListener("error",t=>{const e=t.error;_(e?.stack?String(e.stack).split("\n")[0]:String(t.message))},!0),window.addEventListener("unhandledrejection",t=>{const e=t.reason;_("Unhandled rejection: "+(e&&e.message?e.message:String(t.reason)))},!0);const t=console.error.bind(console);console.error=(...e)=>{try{_(e.map(t=>String(t)).join(" "))}catch{}t(...e)}}catch{w=!1}}}function g(t){l=t,d.set(t,[])}function y(t){return(d.get(t)??[]).slice()}function p(){return y(l)}function m(){return e(window.__FPX_VIEWS__)}function v(t,e){const n=[],r=new Set;let o=e;for(;o&&t[o]&&!r.has(o)&&n.length<4;)r.add(o),n.unshift(o),o=t[o].after;return n}async function A(t){try{const e=m();if(!e[t])return{ok:!1,view:t,settle:u([]),error:"not declared"};g(t);for(const n of v(e,t))try{await e[n].enter()}catch(e){return{ok:!1,view:t,settle:u(y(t)),error:"enter("+n+") threw: "+String(e)}}const n=await f(),r=u(y(t));return n?{ok:!0,view:t,settle:r}:{ok:!1,view:t,settle:r,error:"settle timeout"}}catch(e){return{ok:!1,view:t,settle:u([]),error:String(e)}}}function E(){try{if(window.__FPX_KAPTURE__&&1===window.__FPX_KAPTURE__.v)return;window.__FPX_KAPTURE__={v:1,list:()=>{try{return n(m())}catch{return[]}},goto:t=>A(t),settled:()=>u(p())}}catch{}}const F="funpixel-kapture";function P(t){return{source:F,type:"KAPTURE_VIEWS",v:1,views:t}}function b(t,e){return{source:F,type:"KAPTURE_GOTO_ACK",corrId:t,ok:e.ok,settle:e.settle}}function k(t){if(!t||"object"!=typeof t)return null;const e=t;return"KAPTURE_GOTO"!==e.type||"string"!=typeof e.id||0===e.id.length||e.id.length>64||"string"!=typeof e.corrId||0===e.corrId.length||e.corrId.length>64?null:{type:"KAPTURE_GOTO",id:e.id,corrId:e.corrId}}function I(t){try{window.parent.postMessage(t,"*")}catch{}}function S(){try{if(window.__FPX_KAPTURE__)return;h(),g("__boot__"),i(),E(),function(){let t=0;const r=()=>{try{const o=n(e(window.__FPX_VIEWS__));if(o.length>0||t>=40)return void I(P(o));t++,setTimeout(r,250)}catch{}};r()}(),function(){try{window.addEventListener("message",t=>{try{if(t.source!==window.parent)return;const e=k(t.data);if(!e)return;A(e.id).then(t=>I(b(e.corrId,t)))}catch{}})}catch{}}()}catch{}}return S(),t.SOURCE=F,t.beginView=g,t.boot=S,t.currentErrors=p,t.errorsFor=y,t.gotoAck=b,t.gotoView=A,t.install=h,t.installDriver=E,t.parseGoto=k,t.pendingFonts=s,t.pendingImages=c,t.rafAlive=a,t.readViews=e,t.resolveChain=v,t.snapshot=u,t.startHeartbeat=i,t.toMeta=n,t.viewsMessage=P,t.waitForSettle=f,t}({});

package/dist/devtools/profiler/funpixel-profiler.pixi.min.js

@@ -0,0 +1 @@
+var FunpixelProfiler=function(e){"use strict";const t="🎬",i="🎨",s="💾",r="🖥️",n="✨";const a={sampleInterval:1e3,bufferSize:3e4,thresholds:{fps:{green:55,yellow:30},frameTime:{green:18,yellow:33},drawCalls:{green:200,yellow:1e3},triangles:{green:2e5,yellow:1e6},textureMemoryMB:{green:100,yellow:500},geometryMemoryMB:{green:50,yellow:200}},debug:!1};class o{buf;head=0;size=0;capacity;constructor(e){if(e<1)throw new Error("TimeWindowedRingBuffer capacity must be >= 1");this.capacity=e,this.buf=new Array(e)}push(e){this.buf[this.head]=e,this.head=(this.head+1)%this.capacity,this.size<this.capacity&&(this.size+=1)}sliceSince(e){if(0===this.size)return[];const t=[],i=(this.head-this.size+this.capacity)%this.capacity;for(let s=0;s<this.size;s++){const r=(i+s)%this.capacity,n=this.buf[r];n&&n.timestamp>=e&&t.push(n)}return t}clear(){this.head=0,this.size=0}get length(){return this.size}}function l(e,t){if(0===e.length)return 0;if(1===e.length)return e[0];const i=[...e].sort((e,t)=>e-t),s=t/100*(i.length-1),r=Math.floor(s),n=Math.ceil(s);if(r===n)return i[r];const a=s-r;return i[r]*(1-a)+i[n]*a}class g{engine;handlers=new Map;isListening=!1;boundHandleMessage;constructor(e){this.engine=e,this.boundHandleMessage=this.handleMessage.bind(this)}send(e){const t={...e,engine:this.engine,source:"funpixel-profiler"};try{window.parent.postMessage(t,"*")}catch{}}on(e,t){const i=this.handlers.get(e)||[];i.push(t),this.handlers.set(e,i),this.isListening||this.startListening()}off(e,t){const i=this.handlers.get(e)||[],s=i.indexOf(t);s>-1&&i.splice(s,1)}startListening(){this.isListening||(this.isListening=!0,window.addEventListener("message",this.boundHandleMessage))}handleMessage(e){const t=e.data;if(!t?.type)return;const i=this.normalizeMessageType(t.type);if(!i)return;const s=this.handlers.get(i);if(s){const e={type:i,config:t.config};for(const t of s)t(e)}}normalizeMessageType(e){switch(e){case"PROFILER_START":case"START_PROFILER":return"PROFILER_START";case"PROFILER_STOP":case"STOP_PROFILER":return"PROFILER_STOP";case"PROFILER_REQUEST_SNAPSHOT":case"REQUEST_PROFILER_SNAPSHOT":return"PROFILER_REQUEST_SNAPSHOT";case"PROFILER_SET_CONFIG":case"SET_PROFILER_CONFIG":return"PROFILER_SET_CONFIG";default:return null}}destroy(){this.isListening&&(window.removeEventListener("message",this.boundHandleMessage),this.isListening=!1),this.handlers.clear()}}class h{gl=null;ext=null;isWebGL2=!1;_available=!1;currentQuery=null;pendingQuery=null;lastResult=null;frameActive=!1;constructor(e){e&&(this.gl=e,this.isWebGL2="createQuery"in e,this.initExtension())}initExtension(){if(this.gl)try{this.isWebGL2&&(this.ext=this.gl.getExtension("EXT_disjoint_timer_query_webgl2")),this.ext||(this.ext=this.gl.getExtension("EXT_disjoint_timer_query")),this.ext&&(this._available=!0)}catch{this._available=!1}}get available(){return this._available}beginFrame(){if(this._available&&this.gl&&this.ext&&!this.frameActive){this.resolvePendingQuery(),this.currentQuery&&(this.pendingQuery=this.currentQuery);try{this.isWebGL2?(this.currentQuery=this.gl.createQuery(),this.currentQuery&&(this.gl.beginQuery(this.ext.TIME_ELAPSED_EXT,this.currentQuery),this.frameActive=!0)):(this.currentQuery=this.ext.createQueryEXT(),this.currentQuery&&(this.ext.beginQueryEXT(this.ext.TIME_ELAPSED_EXT,this.currentQuery),this.frameActive=!0))}catch{this._available=!1}}}endFrame(){if(this._available&&this.gl&&this.ext&&this.frameActive){try{this.isWebGL2?this.gl.endQuery(this.ext.TIME_ELAPSED_EXT):this.ext.endQueryEXT(this.ext.TIME_ELAPSED_EXT)}catch{this._available=!1}this.frameActive=!1}}getResult(){return this.resolvePendingQuery(),this.lastResult}resolvePendingQuery(){if(this.pendingQuery&&this.gl&&this.ext)try{if(this.gl.getParameter(this.ext.GPU_DISJOINT_EXT))return this.cleanupQuery(this.pendingQuery),this.pendingQuery=null,void(this.lastResult=null);let e,t;if(this.isWebGL2){const i=this.gl;e=i.getQueryParameter(this.pendingQuery,i.QUERY_RESULT_AVAILABLE),e&&(t=i.getQueryParameter(this.pendingQuery,i.QUERY_RESULT))}else e=this.ext.getQueryObjectEXT(this.pendingQuery,this.ext.QUERY_RESULT_AVAILABLE_EXT),e&&(t=this.ext.getQueryObjectEXT(this.pendingQuery,this.ext.QUERY_RESULT_EXT));e&&"number"==typeof t&&(this.lastResult=t/1e6,this.cleanupQuery(this.pendingQuery),this.pendingQuery=null)}catch{this.pendingQuery&&this.cleanupQuery(this.pendingQuery),this.pendingQuery=null,this.lastResult=null}}cleanupQuery(e){try{this.isWebGL2?this.gl.deleteQuery(e):this.ext&&this.ext.deleteQueryEXT(e)}catch{}}destroy(){this.currentQuery&&(this.frameActive&&this.endFrame(),this.cleanupQuery(this.currentQuery),this.currentQuery=null),this.pendingQuery&&(this.cleanupQuery(this.pendingQuery),this.pendingQuery=null),this._available=!1}}class c{messages;ringBuffer;gpuTimer=null;config;isRunning=!1;profilingStartTime=0;lastSampleSentTime=0;lastFrameTimestamp=0;accumulatedCpuTime=0;sampleAccumulator=[];warnings=[];warningHashes=new Set;sceneStatsCache=null;sceneStatsCacheTime=0;SCENE_STATS_CACHE_MS=200;pendingFrameEmit=!1;frameRenderStats={};stateChangeCounters={programSwitches:0,textureSwitches:0,fboSwitches:0};lastFrameStateChanges={programSwitches:0,textureSwitches:0,fboSwitches:0};originalUseProgram=null;originalBindTexture=null;originalBindFramebuffer=null;lastComputedScore=-1;loafObserver=null;loafEntries=[];constructor(e={}){this.config={...a,...e},this.ringBuffer=new o(this.config.bufferSize)}init(){this.messages=new g(this.engineType),this.setupMessageHandlers(),this.waitForEngine(),this.exposeGlobalAPI(),this.log("Profiler initialized")}waitForEngine(){const e=Date.now();let t=!1;const i=()=>{this.isEngineReady()?this.onEngineReady():(!t&&Date.now()-e>15e3&&(t=!0,this.log("Engine not detected yet — continuing to poll slowly (menu-first game?)","warn")),setTimeout(i,t?2e3:100))};setTimeout(i,100)}onEngineReady(){this.log("Engine detected");const e=this.getGLContext();e&&(this.gpuTimer=new h(e),this.gpuTimer.available&&this.log("GPU timer query available")),this.messages.send({type:"PROFILER_READY"}),this.messages.send({type:"PROFILER_ENGINE_DETECTED",engine:this.engineType}),this.start()}setupMessageHandlers(){this.messages.on("PROFILER_START",e=>{e.config&&this.updateConfig(e.config),this.start()}),this.messages.on("PROFILER_STOP",()=>{this.stop()}),this.messages.on("PROFILER_REQUEST_SNAPSHOT",()=>{const e=this.buildSnapshot();this.messages.send({type:"PROFILER_SNAPSHOT",snapshot:e})}),this.messages.on("PROFILER_SET_CONFIG",e=>{e.config&&this.updateConfig(e.config)})}start(){this.isRunning||(this.isRunning=!0,this.profilingStartTime=performance.now(),this.lastSampleSentTime=performance.now(),this.lastFrameTimestamp=0,this.accumulatedCpuTime=0,this.frameRenderStats={},this.pendingFrameEmit=!1,this.sampleAccumulator=[],this.warnings=[],this.warningHashes.clear(),this.hookRenderLoop(),this.hookStateChangeTracking(),this.startLoafObserver(),this.log("Profiling started"))}stop(){this.isRunning&&(this.isRunning=!1,this.unhookRenderLoop(),this.unhookStateChangeTracking(),this.stopLoafObserver(),this.log("Profiling stopped"))}onFrameEnd(e){if(!this.isRunning)return;let t;this.accumulatedCpuTime+=e;try{t=this.collectRenderStats()}catch{t={}}const i=this.frameRenderStats;i.drawCalls=(i.drawCalls||0)+(t.drawCalls||0),i.triangles=(i.triangles||0)+(t.triangles||0),i.points=(i.points||0)+(t.points||0),i.lines=(i.lines||0)+(t.lines||0),void 0!==t.textureCount&&(i.textureCount=t.textureCount),void 0!==t.textureBytes&&(i.textureBytes=t.textureBytes),void 0!==t.geometryCount&&(i.geometryCount=t.geometryCount),void 0!==t.geometryBytes&&(i.geometryBytes=t.geometryBytes),void 0!==t.programCount&&(i.programCount=t.programCount),this.pendingFrameEmit||(this.pendingFrameEmit=!0,queueMicrotask(()=>this.emitFrameSample()))}emitFrameSample(){if(this.pendingFrameEmit=!1,!this.isRunning)return;const e=performance.now(),t=this.lastFrameTimestamp>0?e-this.lastFrameTimestamp:16.67;this.lastFrameTimestamp=e,this.lastFrameStateChanges={...this.stateChangeCounters},this.stateChangeCounters.programSwitches=0,this.stateChangeCounters.textureSwitches=0,this.stateChangeCounters.fboSwitches=0;const i=this.buildFrameSample(t,this.accumulatedCpuTime,this.frameRenderStats);if(this.accumulatedCpuTime=0,this.frameRenderStats={},this.ringBuffer.push(i),this.sampleAccumulator.push(i),e-this.lastSampleSentTime>=this.config.sampleInterval){const t=this.aggregateStats(this.sampleAccumulator),i=this.detectWarnings(t);this.messages.send({type:"PROFILER_SAMPLE",stats:t,warnings:i});for(const e of i)this.messages.send({type:"PROFILER_WARNING",warning:e});this.sampleAccumulator=[],this.lastSampleSentTime=e}}buildFrameSample(e,t,i){const s=this.getSceneStatsCached(),r=this.gpuTimer?.getResult()??null;let n=null,a=null;return performance.memory&&(n=performance.memory.usedJSHeapSize,a=performance.memory.totalJSHeapSize),{timestamp:performance.now(),frameTime:e,fps:e>0?1e3/e:0,cpuTime:t,drawCalls:i.drawCalls||0,triangles:i.triangles||0,points:i.points||0,lines:i.lines||0,textureCount:i.textureCount||0,textureBytes:i.textureBytes||0,geometryCount:i.geometryCount||0,geometryBytes:i.geometryBytes||0,programCount:i.programCount||0,programSwitches:this.lastFrameStateChanges.programSwitches,textureSwitches:this.lastFrameStateChanges.textureSwitches,fboSwitches:this.lastFrameStateChanges.fboSwitches,totalObjects:s.totalObjects,visibleObjects:s.visibleObjects,lightsCount:s.lightsCount,camerasCount:s.camerasCount,gpuTime:r,jsHeapUsed:n,jsHeapTotal:a}}getSceneStatsCached(){const e=performance.now();if(!this.sceneStatsCache||e-this.sceneStatsCacheTime>this.SCENE_STATS_CACHE_MS){try{this.sceneStatsCache=this.collectSceneStats()}catch{this.sceneStatsCache={totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0}}this.sceneStatsCacheTime=e}return this.sceneStatsCache}aggregateStats(e){if(0===e.length)return this.emptyStats();const t=e[e.length-1],i=e.map(e=>e.fps),s=e.map(e=>e.frameTime),r=e.map(e=>e.cpuTime),n=this.computeMinMaxAvg(r),a={fps:this.computeMinMaxAvg(i),frameTime:this.computeMinMaxAvg(s),cpuTime:n,drawCalls:t.drawCalls,triangles:t.triangles,points:t.points,lines:t.lines,textureCount:t.textureCount,textureMemoryMB:t.textureBytes/1024/1024,geometryCount:t.geometryCount,geometryMemoryMB:t.geometryBytes/1024/1024,programCount:t.programCount,programSwitches:t.programSwitches,textureSwitches:t.textureSwitches,fboSwitches:t.fboSwitches,totalObjects:t.totalObjects,visibleObjects:t.visibleObjects,lightsCount:t.lightsCount,camerasCount:t.camerasCount,gpuTime:t.gpuTime,jsHeapUsedMB:null!==t.jsHeapUsed?t.jsHeapUsed/1024/1024:null,framePacing:this.computeFramePacing(e),bottleneck:this.classifyBottleneck(n.avg,t.gpuTime,this.computeMinMaxAvg(s).avg,t.drawCalls),sampleCount:e.length};return a.performanceScore=this.computePerformanceScore(a),a}computeMinMaxAvg(e){let t=1/0,i=-1/0,s=0;for(const r of e)r<t&&(t=r),r>i&&(i=r),s+=r;return{current:e[e.length-1],min:t,max:i,avg:s/e.length}}emptyStats(){return{fps:{current:0,min:0,max:0,avg:0},frameTime:{current:0,min:0,max:0,avg:0},cpuTime:{current:0,min:0,max:0,avg:0},drawCalls:0,triangles:0,points:0,lines:0,textureCount:0,textureMemoryMB:0,geometryCount:0,geometryMemoryMB:0,programCount:0,programSwitches:0,textureSwitches:0,fboSwitches:0,totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0,gpuTime:null,jsHeapUsedMB:null,framePacing:this.emptyFramePacing(),bottleneck:{type:"unknown",description:"Insufficient data",confidence:0,suggestion:""},sampleCount:0}}detectWarnings(e){const t=[],i=performance.now(),s=this.config.thresholds;return e.fps.avg>0&&e.fps.avg<s.fps.yellow&&this.addWarning(t,"fps",e.fps.avg<s.fps.yellow/2?"critical":"warning",`Average FPS is ${e.fps.avg.toFixed(1)} (below ${s.fps.yellow})`,e.fps.avg,s.fps.yellow,"Consider reducing draw calls, lowering resolution, or simplifying geometry. Use LOD (Level of Detail) for distant objects.",i),e.frameTime.avg>s.frameTime.yellow&&this.addWarning(t,"frame_time",e.frameTime.avg>2*s.frameTime.yellow?"critical":"warning",`Average frame time is ${e.frameTime.avg.toFixed(1)}ms (above ${s.frameTime.yellow}ms)`,e.frameTime.avg,s.frameTime.yellow,"Profile individual systems. Common causes: expensive shaders, too many lights with shadows, unoptimized physics, GC pauses.",i),e.drawCalls>s.drawCalls.yellow&&this.addWarning(t,"draw_calls",e.drawCalls>3*s.drawCalls.yellow?"critical":"warning",`Draw calls: ${e.drawCalls.toLocaleString()} (above ${s.drawCalls.yellow})`,e.drawCalls,s.drawCalls.yellow,"Batch similar materials, use instanced rendering (InstancedMesh/InstancedBufferGeometry), merge static geometry, use texture atlases.",i),e.triangles>s.triangles.yellow&&this.addWarning(t,"triangles",e.triangles>3*s.triangles.yellow?"critical":"warning",`Triangle count: ${e.triangles.toLocaleString()} (above ${s.triangles.yellow.toLocaleString()})`,e.triangles,s.triangles.yellow,"Use LOD, reduce polygon count on distant/small objects, enable frustum culling, consider simpler geometry for non-hero assets.",i),e.textureMemoryMB>s.textureMemoryMB.yellow&&this.addWarning(t,"texture_memory",e.textureMemoryMB>2*s.textureMemoryMB.yellow?"critical":"warning",`Texture memory: ${e.textureMemoryMB.toFixed(1)}MB (above ${s.textureMemoryMB.yellow}MB)`,e.textureMemoryMB,s.textureMemoryMB.yellow,"Use compressed textures (KTX2/Basis), reduce texture resolution, use power-of-2 sizes, share textures via atlases, dispose unused textures.",i),e.geometryMemoryMB>s.geometryMemoryMB.yellow&&this.addWarning(t,"geometry_memory",e.geometryMemoryMB>2*s.geometryMemoryMB.yellow?"critical":"warning",`Geometry memory: ${e.geometryMemoryMB.toFixed(1)}MB (above ${s.geometryMemoryMB.yellow}MB)`,e.geometryMemoryMB,s.geometryMemoryMB.yellow,"Share geometry between meshes, use BufferGeometry instead of Geometry, dispose unused geometries, use instancing for repeated shapes.",i),e.programCount>50&&this.addWarning(t,"shader_count","warning",`Shader programs: ${e.programCount} (many unique materials)`,e.programCount,50,"Reduce material variations, share materials between objects, consider using a single uber-shader with defines.",i),null!==e.gpuTime&&e.gpuTime>16&&this.addWarning(t,"gpu_time",e.gpuTime>33?"critical":"warning",`GPU time: ${e.gpuTime.toFixed(1)}ms (above 16ms budget)`,e.gpuTime,16,"Simplify shaders, reduce overdraw, lower shadow map resolution, use fewer real-time lights, consider baked lighting.",i),t}addWarning(e,t,i,s,r,n,a,o){const l=`${t}-${i}`;if(this.warningHashes.has(l))return;this.warningHashes.add(l);const g={id:`${t}-${Date.now()}`,severity:i,category:t,message:s,value:r,threshold:n,timestamp:o,suggestion:a};e.push(g),this.warnings.push(g)}computeFramePacing(e){if(e.length<2)return this.emptyFramePacing();const t=e.map(e=>e.frameTime),i=t.reduce((e,t)=>e+t,0)/t.length,s=t.reduce((e,t)=>e+(t-i)**2,0)/t.length,r=Math.sqrt(s),n=16.67*.1,a=t.filter(e=>Math.abs(e-16.67)<=n).length/t.length*100,o=2*i,l=t.filter(e=>e>o).length,g=e.length>0?(e[e.length-1].timestamp-e[0].timestamp)/1e3:1,h=g>0?l/g*60:0,c=1.5*i;let u=0,m=0;for(const e of t)e<=c?(m++,m>u&&(u=m)):m=0;const d=[0,0,0,0,0];for(const e of t)e<8?d[0]++:e<16?d[1]++:e<33?d[2]++:e<50?d[3]++:d[4]++;let p="stable";if(t.length>=120){const e=this.config.thresholds.frameTime.green,i=Math.floor(t.length/2),s=t.slice(0,i).sort((e,t)=>e-t),r=t.slice(i).sort((e,t)=>e-t),n=s[Math.floor(.99*s.length)]??0,a=r[Math.floor(.99*r.length)]??0;a>1.2*n&&a>e?p="degrading":a<.83*n&&n>e&&(p="improving")}return{frameTimeStdDev:r,consistencyPercent:a,janksPerMinute:h,longestSmoothStreak:u,histogram:d,varianceTrend:p}}emptyFramePacing(){return{frameTimeStdDev:0,consistencyPercent:0,janksPerMinute:0,longestSmoothStreak:0,histogram:[0,0,0,0,0],varianceTrend:"stable"}}classifyBottleneck(e,t,i,s){if(i<=0)return{type:"unknown",description:"Insufficient data",confidence:0,suggestion:""};if(i<=17.5&&e<12&&(null===t||t<12))return{type:"vsync-limited",description:"Running at vsync cap with headroom available",confidence:.9,suggestion:"Performance is good. Add more visual quality or increase simulation complexity."};const r=null!==t&&t>0;if(s>500&&e>10)return{type:"draw-call-bound",description:`${s} draw calls causing ${e.toFixed(1)}ms CPU overhead`,confidence:.85,suggestion:"Use InstancedMesh for repeated geometry, merge static meshes, share materials, use texture atlases."};if(r){const i=e/t;if(i>2)return{type:"cpu-bound",description:`CPU render time (${e.toFixed(1)}ms) is ${i.toFixed(1)}x GPU time (${t.toFixed(1)}ms)`,confidence:Math.min(.95,.6+.1*i),suggestion:"Reduce draw call count, simplify scene graph, optimize JavaScript logic, use web workers for heavy computation."};if(i<.5)return{type:"gpu-bound",description:`GPU time (${t.toFixed(1)}ms) is ${(1/i).toFixed(1)}x CPU time (${e.toFixed(1)}ms)`,confidence:Math.min(.95,.6+1/i*.1),suggestion:"Simplify shaders, reduce overdraw, lower shadow/texture resolution, use LOD, reduce post-processing passes."}}const n=r?Math.max(e,t):e;return i>2*n&&n>0?{type:"main-thread",description:`Frame time (${i.toFixed(1)}ms) is ${(i/n).toFixed(1)}x render time (${n.toFixed(1)}ms) — non-render work blocking`,confidence:.75,suggestion:"Profile JavaScript execution. Check for GC pauses, expensive physics, or layout thrashing between frames."}:{type:"balanced",description:"No single bottleneck detected — CPU and GPU load are balanced",confidence:.5,suggestion:"For further optimization, reduce scene complexity across the board or enable LOD."}}computePerformanceScore(e){const t=this.config.thresholds,i=e.fps.avg>=60?100:e.fps.avg>=30?50+(e.fps.avg-30)/30*50:Math.max(0,e.fps.avg/30*50),s=e.framePacing,r=Math.max(0,Math.min(100,.4*s.consistencyPercent+.3*Math.max(0,100-5*s.janksPerMinute)+.3*Math.max(0,100-10*s.frameTimeStdDev))),n=e.textureMemoryMB+e.geometryMemoryMB,a=t.textureMemoryMB.green,o=t.textureMemoryMB.yellow,l=n<=a?100:n<=o?50+50*(1-(n-a)/(o-a)):Math.max(0,50-(n-o)/o*50),g=((e.drawCalls<=t.drawCalls.green?100:e.drawCalls<=t.drawCalls.yellow?50+50*(1-(e.drawCalls-t.drawCalls.green)/(t.drawCalls.yellow-t.drawCalls.green)):Math.max(0,50-(e.drawCalls-t.drawCalls.yellow)/t.drawCalls.yellow*50))+(e.triangles<=t.triangles.green?100:e.triangles<=t.triangles.yellow?50+50*(1-(e.triangles-t.triangles.green)/(t.triangles.yellow-t.triangles.green)):Math.max(0,50-(e.triangles-t.triangles.yellow)/t.triangles.yellow*50)))/2,h=null===e.gpuTime||e.gpuTime<=8?100:e.gpuTime<=16?50+50*(1-(e.gpuTime-8)/8):Math.max(0,50-(e.gpuTime-16)/16*50);let c=Math.round(.4*i+.2*r+.15*l+.15*g+.1*h);c=Math.max(0,Math.min(100,c));const u=this.lastComputedScore<0?c:Math.round(.3*c+.7*this.lastComputedScore);this.lastComputedScore=u;const{grade:m,label:d}=function(e){return e>=90?{grade:"excellent",label:"Excellent"}:e>=70?{grade:"good",label:"Good"}:e>=50?{grade:"needs-work",label:"Needs Work"}:e>=30?{grade:"poor",label:"Poor"}:{grade:"critical",label:"Critical"}}(u);return{score:u,grade:m,gradeLabel:d,categories:{performance:Math.round(Math.max(0,Math.min(100,i))),smoothness:Math.round(Math.max(0,Math.min(100,r))),memory:Math.round(Math.max(0,Math.min(100,l))),rendering:Math.round(Math.max(0,Math.min(100,g))),gpu:Math.round(Math.max(0,Math.min(100,h)))},issues:this.generateIssues(e)}}generateIssues(e){const a=[],o=this.config.thresholds;e.fps.avg>0&&e.fps.avg<o.fps.yellow&&a.push({id:"fps-low",severity:e.fps.avg<o.fps.yellow/2?"critical":"warning",title:"Game is running slowly",description:e.fps.avg<20?"Your game is very slow. Try reducing the number of objects or simplifying visual effects.":"Your game could be smoother. Consider simplifying busy scenes.",category:"performance",icon:t}),e.drawCalls>o.drawCalls.yellow&&a.push({id:"draw-calls-high",severity:e.drawCalls>3*o.drawCalls.yellow?"critical":"warning",title:"Too many objects drawing separately",description:"Group similar objects together so the game does less work each frame. Objects with the same look can often be merged.",category:"rendering",icon:i}),e.triangles>o.triangles.yellow&&a.push({id:"triangles-high",severity:e.triangles>3*o.triangles.yellow?"critical":"warning",title:"Too much geometry detail",description:"Some models have more detail than needed. Use simpler models for background objects or things far from the camera.",category:"rendering",icon:i}),e.textureMemoryMB>o.textureMemoryMB.yellow&&a.push({id:"texture-memory-high",severity:e.textureMemoryMB>2*o.textureMemoryMB.yellow?"critical":"warning",title:"Large images using lots of memory",description:"Your textures are using a lot of GPU memory. Try compressing images, using smaller sizes, or sharing textures between objects.",category:"memory",icon:s}),e.geometryMemoryMB>o.geometryMemoryMB.yellow&&a.push({id:"geometry-memory-high",severity:e.geometryMemoryMB>2*o.geometryMemoryMB.yellow?"critical":"warning",title:"Too much 3D data in memory",description:"Your models are using lots of memory. Share shapes between similar objects and remove unused geometry.",category:"memory",icon:s}),null!==e.gpuTime&&e.gpuTime>16&&a.push({id:"gpu-time-high",severity:e.gpuTime>33?"critical":"warning",title:"GPU is working too hard",description:"Your graphics card is struggling. Simplify visual effects, reduce shadow quality, or lower the resolution.",category:"gpu",icon:r}),e.framePacing.janksPerMinute>10&&a.push({id:"jank-detected",severity:e.framePacing.janksPerMinute>30?"critical":"warning",title:"Game stutters occasionally",description:"Your game has noticeable hiccups. This can be caused by loading assets during gameplay or doing too much work at once.",category:"smoothness",icon:n});const l=this.config.thresholds.frameTime.green,g=this.getBurnRate(1e4,l),h=this.getBurnRate(6e4,l),c=this.getBurnRate(3e5,l);return g>=10&&h>=10?a.push({id:"performance-degrading",severity:"critical",title:"Game is stuttering right now",description:"Frames are missing the target budget at 10× the rate the SLO allows, both in the last 10 seconds and the last minute. Something is actively wrong — recent code changes or an expensive scene transition.",category:"smoothness",icon:n}):c>=3&&h>=3&&a.push({id:"performance-degrading",severity:"warning",title:"Performance getting worse over time",description:"Frames have been missing the target budget at 3× the rate the SLO allows, sustained over the last few minutes. Common causes: objects accumulating without cleanup, growing particle pool, forgotten event listeners.",category:"smoothness",icon:n}),a}hookStateChangeTracking(){const e=this.getGLContext();if(!e)return;const t=this.stateChangeCounters;this.originalUseProgram=e.useProgram.bind(e),e.useProgram=e=>(t.programSwitches++,this.originalUseProgram(e)),this.originalBindTexture=e.bindTexture.bind(e),e.bindTexture=(e,i)=>(t.textureSwitches++,this.originalBindTexture(e,i)),this.originalBindFramebuffer=e.bindFramebuffer.bind(e),e.bindFramebuffer=(e,i)=>(t.fboSwitches++,this.originalBindFramebuffer(e,i)),this.log("WebGL state change tracking active")}unhookStateChangeTracking(){const e=this.getGLContext();e&&(this.originalUseProgram&&(e.useProgram=this.originalUseProgram,this.originalUseProgram=null),this.originalBindTexture&&(e.bindTexture=this.originalBindTexture,this.originalBindTexture=null),this.originalBindFramebuffer&&(e.bindFramebuffer=this.originalBindFramebuffer,this.originalBindFramebuffer=null))}startLoafObserver(){try{if("undefined"==typeof PerformanceObserver)return;const e=PerformanceObserver.supportedEntryTypes;if(!e?.includes("long-animation-frame"))return;this.loafObserver=new PerformanceObserver(e=>{for(const t of e.getEntries()){const e=t;this.loafEntries.push({duration:e.duration,renderStart:e.renderStart??0,styleAndLayoutStart:e.styleAndLayoutStart??0,scripts:(e.scripts??[]).map(e=>({sourceURL:e.sourceURL||"unknown",invoker:e.invoker||"unknown",duration:e.duration})),timestamp:e.startTime}),this.loafEntries.length>50&&this.loafEntries.shift()}}),this.loafObserver.observe({type:"long-animation-frame",buffered:!1}),this.log("Long Animation Frame (LoAF) observer active")}catch{}}stopLoafObserver(){this.loafObserver&&(this.loafObserver.disconnect(),this.loafObserver=null)}getWindowedStats(e){const t=performance.now()-e,i=this.ringBuffer.sliceSince(t),s=i.length;if(0===s)return{windowMs:e,sampleCount:0,fps:{p50:0,p95:0,p99:0,min:0,max:0,avg:0},frameTime:{p50:0,p95:0,p99:0,max:0,avg:0},heap:{start:0,end:0,min:0,max:0,deltaPerMin:0}};const r=i.map(e=>e.fps),n=i.map(e=>e.frameTime),a=i.map(e=>(e.jsHeapUsed??0)/1048576),o=a[a.length-1]-a[0],g=(i[i.length-1].timestamp-i[0].timestamp)/6e4,h=(e,t)=>e+t;return{windowMs:e,sampleCount:s,fps:{p50:l(r,50),p95:l(r,95),p99:l(r,99),min:Math.min(...r),max:Math.max(...r),avg:r.reduce(h,0)/s},frameTime:{p50:l(n,50),p95:l(n,95),p99:l(n,99),max:Math.max(...n),avg:n.reduce(h,0)/s},heap:{start:a[0],end:a[a.length-1],min:Math.min(...a),max:Math.max(...a),deltaPerMin:g>0?o/g:0}}}getBurnRate(e,t,i=30){const s=performance.now()-e;return function(e,t,i=30){if(e.length<i)return 0;let s=0;for(const i of e)i.frameTime>t&&(s+=1);return s/e.length/.01}(this.ringBuffer.sliceSince(s),t,i)}buildSnapshot(){const e=this.ringBuffer.sliceSince(0),t=e.length>0?this.aggregateStats(e):this.emptyStats();this.warningHashes.clear(),this.warnings=[],this.detectWarnings(t);let i=this.getHotObjects()??void 0;if(i&&i.length>0){const e=t.triangles||1,s=t.drawCalls||1;i=i.map(t=>({...t,triangleBudgetPercent:t.triangles/e*100,drawCallBudgetPercent:t.drawCalls/s*100}))}return{engine:this.engineType,timestamp:Date.now(),profilingDuration:performance.now()-this.profilingStartTime,stats:t,recentSamples:e.slice(-30),warnings:[...this.warnings],engineInfo:this.getEngineInfo(),hotObjects:i,loafEntries:this.loafEntries.length>0?[...this.loafEntries]:void 0}}getReport(){return function(e){const{stats:t,warnings:i,engineInfo:s,hotObjects:r}=e,n=["## Performance Profile","",`**Engine:** ${s.name} ${s.version} | **Renderer:** ${s.renderer}`,`**Canvas:** ${s.canvasWidth}x${s.canvasHeight} @ ${s.pixelRatio}x DPR`,`**Profiling Duration:** ${(e.profilingDuration/1e3).toFixed(1)}s | **Samples:** ${e.recentSamples.length}`,"","### Frame Performance","| Metric | Current | Min | Max | Avg |","|--------|---------|-----|-----|-----|",`| FPS | ${t.fps.current.toFixed(1)} | ${t.fps.min.toFixed(1)} | ${t.fps.max.toFixed(1)} | ${t.fps.avg.toFixed(1)} |`,`| Frame Time (ms) | ${t.frameTime.current.toFixed(2)} | ${t.frameTime.min.toFixed(2)} | ${t.frameTime.max.toFixed(2)} | ${t.frameTime.avg.toFixed(2)} |`,`| CPU Render (ms) | ${t.cpuTime.current.toFixed(2)} | ${t.cpuTime.min.toFixed(2)} | ${t.cpuTime.max.toFixed(2)} | ${t.cpuTime.avg.toFixed(2)} |`,null!==t.gpuTime?`| GPU Time (ms) | ${t.gpuTime.toFixed(2)} | - | - | - |`:"","","### Render Pipeline","| Metric | Value |","|--------|-------|",`| Draw Calls | ${t.drawCalls.toLocaleString()} |`,`| Triangles | ${t.triangles.toLocaleString()} |`,`| Points | ${t.points.toLocaleString()} |`,`| Lines | ${t.lines.toLocaleString()} |`,`| Shader Programs | ${t.programCount} |`,"","### Memory","| Metric | Value |","|--------|-------|",`| Textures | ${t.textureCount} (${t.textureMemoryMB.toFixed(1)} MB) |`,`| Geometries | ${t.geometryCount} (${t.geometryMemoryMB.toFixed(1)} MB) |`,null!==t.jsHeapUsedMB?`| JS Heap | ${t.jsHeapUsedMB.toFixed(1)} MB |`:"","","### Scene Graph","| Metric | Value |","|--------|-------|",`| Total Objects | ${t.totalObjects.toLocaleString()} |`,`| Visible Objects | ${t.visibleObjects.toLocaleString()} |`,`| Lights | ${t.lightsCount} |`,`| Cameras | ${t.camerasCount} |`],a=t.framePacing;a&&n.push("### Frame Pacing (Smoothness)","| Metric | Value |","|--------|-------|",`| Consistency | ${a.consistencyPercent.toFixed(1)}% of frames on-target |`,`| Std Deviation | ${a.frameTimeStdDev.toFixed(2)}ms |`,`| Janks/min | ${a.janksPerMinute.toFixed(1)} |`,`| Longest Smooth Streak | ${a.longestSmoothStreak} frames |`,`| Variance Trend | ${a.varianceTrend} |`,`| Histogram (0-8/8-16/16-33/33-50/50+ms) | ${a.histogram.join(" / ")} |`,"");const o=t.bottleneck;if(o&&"unknown"!==o.type&&n.push("### Bottleneck Analysis",`- **Type:** ${o.type} (${(100*o.confidence).toFixed(0)}% confidence)`,`- **Analysis:** ${o.description}`,`- **Suggestion:** ${o.suggestion}`,""),(t.programSwitches>0||t.textureSwitches>0||t.fboSwitches>0)&&n.push("### WebGL State Changes (per frame)","| Metric | Value |","|--------|-------|",`| Program Switches | ${t.programSwitches} |`,`| Texture Binds | ${t.textureSwitches} |`,`| FBO Switches | ${t.fboSwitches} |`,""),(void 0!==s.antialias||s.shadows||s.toneMapping)&&(n.push("","### Renderer Settings"),void 0!==s.antialias&&n.push("- Antialiasing: "+(s.antialias?"ON":"OFF")),s.shadows&&n.push("- Shadows: "+(s.shadows.enabled?`ON (${s.shadows.type||"default"})`:"OFF")),s.toneMapping&&n.push(`- Tone Mapping: ${s.toneMapping}`),s.maxTextureSize&&n.push(`- Max Texture Size: ${s.maxTextureSize}`)),i.length>0){n.push("","### Performance Warnings");for(const e of i){const t="critical"===e.severity?"CRITICAL":"warning"===e.severity?"WARNING":"INFO";n.push(`- **[${t}]** ${e.message} (${e.value} > threshold ${e.threshold})`),n.push(`  Suggestion: ${e.suggestion}`)}}if(r&&r.length>0){n.push("","### Top Objects by Cost"),n.push("| Object | Type | Triangles | Tri% | Draw Calls | DC% | Tex MB |"),n.push("|--------|------|-----------|------|------------|-----|--------|");for(const e of r.slice(0,10)){const t=void 0!==e.triangleBudgetPercent?`${e.triangleBudgetPercent.toFixed(1)}%`:"-",i=void 0!==e.drawCallBudgetPercent?`${e.drawCallBudgetPercent.toFixed(1)}%`:"-";n.push(`| ${e.name} | ${e.type} | ${e.triangles.toLocaleString()} | ${t} | ${e.drawCalls} | ${i} | ${(e.textureBytes/1024/1024).toFixed(1)} |`)}}if(e.loafEntries&&e.loafEntries.length>0){n.push("","### Long Animation Frames (Browser Jank)"),n.push("| Duration | Render Start | Scripts |"),n.push("|----------|-------------|---------|");for(const t of e.loafEntries.slice(-5)){const e=t.scripts.map(e=>`${e.invoker}(${e.duration.toFixed(0)}ms)`).join(", ")||"none";n.push(`| ${t.duration.toFixed(0)}ms | ${t.renderStart.toFixed(0)}ms | ${e} |`)}}if(e.recentSamples.length>0){const t=e.recentSamples.slice(-10);n.push("",`### Recent Frame Times (last ${t.length} samples)`),n.push(`\`${t.map(e=>e.frameTime.toFixed(1)).join(" → ")} ms\``);const i=t.reduce((e,t)=>e+t.frameTime,0)/t.length,s=t.filter(e=>e.frameTime>2*i);s.length>0&&n.push(`⚠ ${s.length} frame time spike(s) detected (>2x average)`)}return n.filter(e=>""!==e).join("\n")}(this.buildSnapshot())}updateConfig(e){this.config={...this.config,...e},e.bufferSize&&e.bufferSize!==this.ringBuffer.capacity&&(this.ringBuffer=new o(e.bufferSize))}exposeGlobalAPI(){window.__funpixelProfiler={start:()=>this.start(),stop:()=>this.stop(),isRunning:()=>this.isRunning,getSnapshot:()=>this.buildSnapshot(),getReport:()=>this.getReport()}}log(e,t="log"){(this.config.debug||"log"!==t)&&console[t](`[Funpixel Profiler] ${e}`)}destroy(){this.stop(),this.gpuTimer?.destroy(),this.messages.destroy(),delete window.__funpixelProfiler}}class u extends c{engineType="pixi";app=null;gl=null;tickerCallback=null;originalDrawElements=null;originalDrawArrays=null;originalDrawElementsInstanced=null;originalDrawArraysInstanced=null;counters={drawCalls:0,triangles:0,points:0,lines:0};lastFrameCounters={drawCalls:0,triangles:0,points:0,lines:0};constructor(e){super(e),this.init()}collectRenderStats(){const e=this.lastFrameCounters;let t=0;this.app?.renderer?.texture?.managedTextures&&(t=this.app.renderer.texture.managedTextures.length);const i=262144*t;return{drawCalls:e.drawCalls,triangles:e.triangles,points:e.points,lines:e.lines,textureCount:t,textureBytes:i,geometryCount:0,geometryBytes:0,programCount:0}}collectSceneStats(){if(!this.app?.stage)return{totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0};let e=0,t=0;const i=[this.app.stage];for(;i.length>0;){const s=i.pop();if(e++,s.visible&&t++,s.children)for(let e=s.children.length-1;e>=0;e--)i.push(s.children[e])}return{totalObjects:e,visibleObjects:t,lightsCount:0,camerasCount:0}}hookRenderLoop(){this.app&&!this.tickerCallback&&(this.hookWebGLCalls(),this.tickerCallback=()=>{this.lastFrameCounters={...this.counters},this.counters.drawCalls=0,this.counters.triangles=0,this.counters.points=0,this.counters.lines=0,this.gpuTimer?.beginFrame(),this.gpuTimer?.endFrame();const e=this.app?.ticker?.deltaMS??16.67;this.onFrameEnd(e)},this.app.ticker.add(this.tickerCallback),this.log("Hooked PixiJS ticker for frame timing"))}unhookRenderLoop(){this.app&&this.tickerCallback&&(this.app.ticker.remove(this.tickerCallback),this.tickerCallback=null),this.unhookWebGLCalls(),this.log("Unhooked PixiJS ticker")}isEngineReady(){const e=this.findPixiApp();return!!(e?.stage&&e?.renderer&&e?.ticker)}getGLContext(){if(this.gl)return this.gl;if(this.app?.renderer?.gl)return this.gl=this.app.renderer.gl,this.gl;const e=this.getCanvas();return e?(this.gl=e.getContext("webgl2",{failIfMajorPerformanceCaveat:!1})||e.getContext("webgl",{failIfMajorPerformanceCaveat:!1}),this.gl):null}getCanvas(){return this.app?.canvas||this.app?.view||this.findGameCanvas()}getEngineInfo(){const e=this.app?.renderer,t=this.getCanvas(),i=this.getGLContext(),s=i instanceof WebGL2RenderingContext;return{name:"PixiJS",version:window.PIXI?.VERSION?String(window.PIXI.VERSION):"unknown",renderer:2===e?.type?"Canvas2D":s?"WebGL2":"WebGL",canvasWidth:t?.width??e?.width??0,canvasHeight:t?.height??e?.height??0,pixelRatio:e?.resolution??(window.devicePixelRatio||1),maxTextureSize:i?i.getParameter(i.MAX_TEXTURE_SIZE):void 0,antialias:i?!!i.getContextAttributes()?.antialias:void 0}}getHotObjects(){if(!this.app?.stage)return null;const e=[],t=[this.app.stage];for(;t.length>0;){const i=t.pop(),s=i.constructor?.name??"Unknown";if(("Container"!==s||i.label||i.name)&&i!==this.app.stage&&e.push({name:i.label||i.name||s,type:s,triangles:"Sprite"===s?2:"Graphics"===s?10:0,drawCalls:1,textureBytes:0,visible:i.visible,position:{x:i.position?.x??0,y:i.position?.y??0}}),i.children)for(let e=i.children.length-1;e>=0;e--)t.push(i.children[e])}return e.slice(0,20)}onEngineReady(){this.app=this.findPixiApp(),this.app&&(this.log(`PixiJS ${window.PIXI?.VERSION??""} detected`),this.log(`Stage: ${this.app.stage.children.length} top-level objects`)),super.onEngineReady()}hookWebGLCalls(){const e=this.getGLContext();if(!e)return void this.log("No WebGL context — draw call counting unavailable","warn");const t=this.counters,i=(e,i)=>{switch(t.drawCalls++,e){case 4:t.triangles+=i/3;break;case 5:case 6:t.triangles+=Math.max(0,i-2);break;case 1:t.lines+=i/2;break;case 2:t.lines+=i;break;case 3:t.lines+=Math.max(0,i-1);break;case 0:t.points+=i}};if(this.originalDrawElements=e.drawElements.bind(e),e.drawElements=(e,t,s,r)=>(i(e,t),this.originalDrawElements(e,t,s,r)),this.originalDrawArrays=e.drawArrays.bind(e),e.drawArrays=(e,t,s)=>(i(e,s),this.originalDrawArrays(e,t,s)),"drawElementsInstanced"in e){const t=e;this.originalDrawElementsInstanced=t.drawElementsInstanced.bind(t),t.drawElementsInstanced=(e,t,s,r,n)=>(i(e,t*n),this.originalDrawElementsInstanced(e,t,s,r,n))}if("drawArraysInstanced"in e){const t=e;this.originalDrawArraysInstanced=t.drawArraysInstanced.bind(t),t.drawArraysInstanced=(e,t,s,r)=>(i(e,s*r),this.originalDrawArraysInstanced(e,t,s,r))}this.log("WebGL draw call interception active")}unhookWebGLCalls(){const e=this.gl;e&&(this.originalDrawElements&&(e.drawElements=this.originalDrawElements,this.originalDrawElements=null),this.originalDrawArrays&&(e.drawArrays=this.originalDrawArrays,this.originalDrawArrays=null),this.originalDrawElementsInstanced&&"drawElementsInstanced"in e&&(e.drawElementsInstanced=this.originalDrawElementsInstanced,this.originalDrawElementsInstanced=null),this.originalDrawArraysInstanced&&"drawArraysInstanced"in e&&(e.drawArraysInstanced=this.originalDrawArraysInstanced,this.originalDrawArraysInstanced=null),this.log("WebGL draw call interception removed"))}findPixiApp(){if(window.__PIXI_APP__)return window.__PIXI_APP__;const e=window;if(e.app&&this.isPixiApp(e.app))return e.app;if(e.game&&this.isPixiApp(e.game))return e.game;if(e.pixiApp&&this.isPixiApp(e.pixiApp))return e.pixiApp;if(window.PIXI){const e=window.PIXI;if(e.app&&this.isPixiApp(e.app))return e.app}for(const t in window)try{const i=e[t];if(i&&this.isPixiApp(i))return i}catch{}return null}isPixiApp(e){if(!e||"object"!=typeof e)return!1;const t=e;return!!(t.stage&&t.renderer&&t.ticker)}findGameCanvas(){const e=document.querySelectorAll("canvas");for(const t of e){const e=t;if(e.__pixi_app||e.__PIXI_APP__||t.getAttribute("data-pixi"))return t}return e[0]||null}}function m(){new u({debug:!0})}return"loading"===document.readyState?document.addEventListener("DOMContentLoaded",m):m(),e.PixiProfiler=u,e}({});

package/dist/devtools/profiler/funpixel-profiler.threejs.min.js

@@ -0,0 +1 @@
+var FunpixelProfiler=function(e){"use strict";const t="🎬",i="🎨",s="💾",r="🖥️",n="✨";const a={sampleInterval:1e3,bufferSize:3e4,thresholds:{fps:{green:55,yellow:30},frameTime:{green:18,yellow:33},drawCalls:{green:200,yellow:1e3},triangles:{green:2e5,yellow:1e6},textureMemoryMB:{green:100,yellow:500},geometryMemoryMB:{green:50,yellow:200}},debug:!1};class o{buf;head=0;size=0;capacity;constructor(e){if(e<1)throw new Error("TimeWindowedRingBuffer capacity must be >= 1");this.capacity=e,this.buf=new Array(e)}push(e){this.buf[this.head]=e,this.head=(this.head+1)%this.capacity,this.size<this.capacity&&(this.size+=1)}sliceSince(e){if(0===this.size)return[];const t=[],i=(this.head-this.size+this.capacity)%this.capacity;for(let s=0;s<this.size;s++){const r=(i+s)%this.capacity,n=this.buf[r];n&&n.timestamp>=e&&t.push(n)}return t}clear(){this.head=0,this.size=0}get length(){return this.size}}function l(e,t){if(0===e.length)return 0;if(1===e.length)return e[0];const i=[...e].sort((e,t)=>e-t),s=t/100*(i.length-1),r=Math.floor(s),n=Math.ceil(s);if(r===n)return i[r];const a=s-r;return i[r]*(1-a)+i[n]*a}class h{engine;handlers=new Map;isListening=!1;boundHandleMessage;constructor(e){this.engine=e,this.boundHandleMessage=this.handleMessage.bind(this)}send(e){const t={...e,engine:this.engine,source:"funpixel-profiler"};try{window.parent.postMessage(t,"*")}catch{}}on(e,t){const i=this.handlers.get(e)||[];i.push(t),this.handlers.set(e,i),this.isListening||this.startListening()}off(e,t){const i=this.handlers.get(e)||[],s=i.indexOf(t);s>-1&&i.splice(s,1)}startListening(){this.isListening||(this.isListening=!0,window.addEventListener("message",this.boundHandleMessage))}handleMessage(e){const t=e.data;if(!t?.type)return;const i=this.normalizeMessageType(t.type);if(!i)return;const s=this.handlers.get(i);if(s){const e={type:i,config:t.config};for(const t of s)t(e)}}normalizeMessageType(e){switch(e){case"PROFILER_START":case"START_PROFILER":return"PROFILER_START";case"PROFILER_STOP":case"STOP_PROFILER":return"PROFILER_STOP";case"PROFILER_REQUEST_SNAPSHOT":case"REQUEST_PROFILER_SNAPSHOT":return"PROFILER_REQUEST_SNAPSHOT";case"PROFILER_SET_CONFIG":case"SET_PROFILER_CONFIG":return"PROFILER_SET_CONFIG";default:return null}}destroy(){this.isListening&&(window.removeEventListener("message",this.boundHandleMessage),this.isListening=!1),this.handlers.clear()}}class g{gl=null;ext=null;isWebGL2=!1;_available=!1;currentQuery=null;pendingQuery=null;lastResult=null;frameActive=!1;constructor(e){e&&(this.gl=e,this.isWebGL2="createQuery"in e,this.initExtension())}initExtension(){if(this.gl)try{this.isWebGL2&&(this.ext=this.gl.getExtension("EXT_disjoint_timer_query_webgl2")),this.ext||(this.ext=this.gl.getExtension("EXT_disjoint_timer_query")),this.ext&&(this._available=!0)}catch{this._available=!1}}get available(){return this._available}beginFrame(){if(this._available&&this.gl&&this.ext&&!this.frameActive){this.resolvePendingQuery(),this.currentQuery&&(this.pendingQuery=this.currentQuery);try{this.isWebGL2?(this.currentQuery=this.gl.createQuery(),this.currentQuery&&(this.gl.beginQuery(this.ext.TIME_ELAPSED_EXT,this.currentQuery),this.frameActive=!0)):(this.currentQuery=this.ext.createQueryEXT(),this.currentQuery&&(this.ext.beginQueryEXT(this.ext.TIME_ELAPSED_EXT,this.currentQuery),this.frameActive=!0))}catch{this._available=!1}}}endFrame(){if(this._available&&this.gl&&this.ext&&this.frameActive){try{this.isWebGL2?this.gl.endQuery(this.ext.TIME_ELAPSED_EXT):this.ext.endQueryEXT(this.ext.TIME_ELAPSED_EXT)}catch{this._available=!1}this.frameActive=!1}}getResult(){return this.resolvePendingQuery(),this.lastResult}resolvePendingQuery(){if(this.pendingQuery&&this.gl&&this.ext)try{if(this.gl.getParameter(this.ext.GPU_DISJOINT_EXT))return this.cleanupQuery(this.pendingQuery),this.pendingQuery=null,void(this.lastResult=null);let e,t;if(this.isWebGL2){const i=this.gl;e=i.getQueryParameter(this.pendingQuery,i.QUERY_RESULT_AVAILABLE),e&&(t=i.getQueryParameter(this.pendingQuery,i.QUERY_RESULT))}else e=this.ext.getQueryObjectEXT(this.pendingQuery,this.ext.QUERY_RESULT_AVAILABLE_EXT),e&&(t=this.ext.getQueryObjectEXT(this.pendingQuery,this.ext.QUERY_RESULT_EXT));e&&"number"==typeof t&&(this.lastResult=t/1e6,this.cleanupQuery(this.pendingQuery),this.pendingQuery=null)}catch{this.pendingQuery&&this.cleanupQuery(this.pendingQuery),this.pendingQuery=null,this.lastResult=null}}cleanupQuery(e){try{this.isWebGL2?this.gl.deleteQuery(e):this.ext&&this.ext.deleteQueryEXT(e)}catch{}}destroy(){this.currentQuery&&(this.frameActive&&this.endFrame(),this.cleanupQuery(this.currentQuery),this.currentQuery=null),this.pendingQuery&&(this.cleanupQuery(this.pendingQuery),this.pendingQuery=null),this._available=!1}}class c{messages;ringBuffer;gpuTimer=null;config;isRunning=!1;profilingStartTime=0;lastSampleSentTime=0;lastFrameTimestamp=0;accumulatedCpuTime=0;sampleAccumulator=[];warnings=[];warningHashes=new Set;sceneStatsCache=null;sceneStatsCacheTime=0;SCENE_STATS_CACHE_MS=200;pendingFrameEmit=!1;frameRenderStats={};stateChangeCounters={programSwitches:0,textureSwitches:0,fboSwitches:0};lastFrameStateChanges={programSwitches:0,textureSwitches:0,fboSwitches:0};originalUseProgram=null;originalBindTexture=null;originalBindFramebuffer=null;lastComputedScore=-1;loafObserver=null;loafEntries=[];constructor(e={}){this.config={...a,...e},this.ringBuffer=new o(this.config.bufferSize)}init(){this.messages=new h(this.engineType),this.setupMessageHandlers(),this.waitForEngine(),this.exposeGlobalAPI(),this.log("Profiler initialized")}waitForEngine(){const e=Date.now();let t=!1;const i=()=>{this.isEngineReady()?this.onEngineReady():(!t&&Date.now()-e>15e3&&(t=!0,this.log("Engine not detected yet — continuing to poll slowly (menu-first game?)","warn")),setTimeout(i,t?2e3:100))};setTimeout(i,100)}onEngineReady(){this.log("Engine detected");const e=this.getGLContext();e&&(this.gpuTimer=new g(e),this.gpuTimer.available&&this.log("GPU timer query available")),this.messages.send({type:"PROFILER_READY"}),this.messages.send({type:"PROFILER_ENGINE_DETECTED",engine:this.engineType}),this.start()}setupMessageHandlers(){this.messages.on("PROFILER_START",e=>{e.config&&this.updateConfig(e.config),this.start()}),this.messages.on("PROFILER_STOP",()=>{this.stop()}),this.messages.on("PROFILER_REQUEST_SNAPSHOT",()=>{const e=this.buildSnapshot();this.messages.send({type:"PROFILER_SNAPSHOT",snapshot:e})}),this.messages.on("PROFILER_SET_CONFIG",e=>{e.config&&this.updateConfig(e.config)})}start(){this.isRunning||(this.isRunning=!0,this.profilingStartTime=performance.now(),this.lastSampleSentTime=performance.now(),this.lastFrameTimestamp=0,this.accumulatedCpuTime=0,this.frameRenderStats={},this.pendingFrameEmit=!1,this.sampleAccumulator=[],this.warnings=[],this.warningHashes.clear(),this.hookRenderLoop(),this.hookStateChangeTracking(),this.startLoafObserver(),this.log("Profiling started"))}stop(){this.isRunning&&(this.isRunning=!1,this.unhookRenderLoop(),this.unhookStateChangeTracking(),this.stopLoafObserver(),this.log("Profiling stopped"))}onFrameEnd(e){if(!this.isRunning)return;let t;this.accumulatedCpuTime+=e;try{t=this.collectRenderStats()}catch{t={}}const i=this.frameRenderStats;i.drawCalls=(i.drawCalls||0)+(t.drawCalls||0),i.triangles=(i.triangles||0)+(t.triangles||0),i.points=(i.points||0)+(t.points||0),i.lines=(i.lines||0)+(t.lines||0),void 0!==t.textureCount&&(i.textureCount=t.textureCount),void 0!==t.textureBytes&&(i.textureBytes=t.textureBytes),void 0!==t.geometryCount&&(i.geometryCount=t.geometryCount),void 0!==t.geometryBytes&&(i.geometryBytes=t.geometryBytes),void 0!==t.programCount&&(i.programCount=t.programCount),this.pendingFrameEmit||(this.pendingFrameEmit=!0,queueMicrotask(()=>this.emitFrameSample()))}emitFrameSample(){if(this.pendingFrameEmit=!1,!this.isRunning)return;const e=performance.now(),t=this.lastFrameTimestamp>0?e-this.lastFrameTimestamp:16.67;this.lastFrameTimestamp=e,this.lastFrameStateChanges={...this.stateChangeCounters},this.stateChangeCounters.programSwitches=0,this.stateChangeCounters.textureSwitches=0,this.stateChangeCounters.fboSwitches=0;const i=this.buildFrameSample(t,this.accumulatedCpuTime,this.frameRenderStats);if(this.accumulatedCpuTime=0,this.frameRenderStats={},this.ringBuffer.push(i),this.sampleAccumulator.push(i),e-this.lastSampleSentTime>=this.config.sampleInterval){const t=this.aggregateStats(this.sampleAccumulator),i=this.detectWarnings(t);this.messages.send({type:"PROFILER_SAMPLE",stats:t,warnings:i});for(const e of i)this.messages.send({type:"PROFILER_WARNING",warning:e});this.sampleAccumulator=[],this.lastSampleSentTime=e}}buildFrameSample(e,t,i){const s=this.getSceneStatsCached(),r=this.gpuTimer?.getResult()??null;let n=null,a=null;return performance.memory&&(n=performance.memory.usedJSHeapSize,a=performance.memory.totalJSHeapSize),{timestamp:performance.now(),frameTime:e,fps:e>0?1e3/e:0,cpuTime:t,drawCalls:i.drawCalls||0,triangles:i.triangles||0,points:i.points||0,lines:i.lines||0,textureCount:i.textureCount||0,textureBytes:i.textureBytes||0,geometryCount:i.geometryCount||0,geometryBytes:i.geometryBytes||0,programCount:i.programCount||0,programSwitches:this.lastFrameStateChanges.programSwitches,textureSwitches:this.lastFrameStateChanges.textureSwitches,fboSwitches:this.lastFrameStateChanges.fboSwitches,totalObjects:s.totalObjects,visibleObjects:s.visibleObjects,lightsCount:s.lightsCount,camerasCount:s.camerasCount,gpuTime:r,jsHeapUsed:n,jsHeapTotal:a}}getSceneStatsCached(){const e=performance.now();if(!this.sceneStatsCache||e-this.sceneStatsCacheTime>this.SCENE_STATS_CACHE_MS){try{this.sceneStatsCache=this.collectSceneStats()}catch{this.sceneStatsCache={totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0}}this.sceneStatsCacheTime=e}return this.sceneStatsCache}aggregateStats(e){if(0===e.length)return this.emptyStats();const t=e[e.length-1],i=e.map(e=>e.fps),s=e.map(e=>e.frameTime),r=e.map(e=>e.cpuTime),n=this.computeMinMaxAvg(r),a={fps:this.computeMinMaxAvg(i),frameTime:this.computeMinMaxAvg(s),cpuTime:n,drawCalls:t.drawCalls,triangles:t.triangles,points:t.points,lines:t.lines,textureCount:t.textureCount,textureMemoryMB:t.textureBytes/1024/1024,geometryCount:t.geometryCount,geometryMemoryMB:t.geometryBytes/1024/1024,programCount:t.programCount,programSwitches:t.programSwitches,textureSwitches:t.textureSwitches,fboSwitches:t.fboSwitches,totalObjects:t.totalObjects,visibleObjects:t.visibleObjects,lightsCount:t.lightsCount,camerasCount:t.camerasCount,gpuTime:t.gpuTime,jsHeapUsedMB:null!==t.jsHeapUsed?t.jsHeapUsed/1024/1024:null,framePacing:this.computeFramePacing(e),bottleneck:this.classifyBottleneck(n.avg,t.gpuTime,this.computeMinMaxAvg(s).avg,t.drawCalls),sampleCount:e.length};return a.performanceScore=this.computePerformanceScore(a),a}computeMinMaxAvg(e){let t=1/0,i=-1/0,s=0;for(const r of e)r<t&&(t=r),r>i&&(i=r),s+=r;return{current:e[e.length-1],min:t,max:i,avg:s/e.length}}emptyStats(){return{fps:{current:0,min:0,max:0,avg:0},frameTime:{current:0,min:0,max:0,avg:0},cpuTime:{current:0,min:0,max:0,avg:0},drawCalls:0,triangles:0,points:0,lines:0,textureCount:0,textureMemoryMB:0,geometryCount:0,geometryMemoryMB:0,programCount:0,programSwitches:0,textureSwitches:0,fboSwitches:0,totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0,gpuTime:null,jsHeapUsedMB:null,framePacing:this.emptyFramePacing(),bottleneck:{type:"unknown",description:"Insufficient data",confidence:0,suggestion:""},sampleCount:0}}detectWarnings(e){const t=[],i=performance.now(),s=this.config.thresholds;return e.fps.avg>0&&e.fps.avg<s.fps.yellow&&this.addWarning(t,"fps",e.fps.avg<s.fps.yellow/2?"critical":"warning",`Average FPS is ${e.fps.avg.toFixed(1)} (below ${s.fps.yellow})`,e.fps.avg,s.fps.yellow,"Consider reducing draw calls, lowering resolution, or simplifying geometry. Use LOD (Level of Detail) for distant objects.",i),e.frameTime.avg>s.frameTime.yellow&&this.addWarning(t,"frame_time",e.frameTime.avg>2*s.frameTime.yellow?"critical":"warning",`Average frame time is ${e.frameTime.avg.toFixed(1)}ms (above ${s.frameTime.yellow}ms)`,e.frameTime.avg,s.frameTime.yellow,"Profile individual systems. Common causes: expensive shaders, too many lights with shadows, unoptimized physics, GC pauses.",i),e.drawCalls>s.drawCalls.yellow&&this.addWarning(t,"draw_calls",e.drawCalls>3*s.drawCalls.yellow?"critical":"warning",`Draw calls: ${e.drawCalls.toLocaleString()} (above ${s.drawCalls.yellow})`,e.drawCalls,s.drawCalls.yellow,"Batch similar materials, use instanced rendering (InstancedMesh/InstancedBufferGeometry), merge static geometry, use texture atlases.",i),e.triangles>s.triangles.yellow&&this.addWarning(t,"triangles",e.triangles>3*s.triangles.yellow?"critical":"warning",`Triangle count: ${e.triangles.toLocaleString()} (above ${s.triangles.yellow.toLocaleString()})`,e.triangles,s.triangles.yellow,"Use LOD, reduce polygon count on distant/small objects, enable frustum culling, consider simpler geometry for non-hero assets.",i),e.textureMemoryMB>s.textureMemoryMB.yellow&&this.addWarning(t,"texture_memory",e.textureMemoryMB>2*s.textureMemoryMB.yellow?"critical":"warning",`Texture memory: ${e.textureMemoryMB.toFixed(1)}MB (above ${s.textureMemoryMB.yellow}MB)`,e.textureMemoryMB,s.textureMemoryMB.yellow,"Use compressed textures (KTX2/Basis), reduce texture resolution, use power-of-2 sizes, share textures via atlases, dispose unused textures.",i),e.geometryMemoryMB>s.geometryMemoryMB.yellow&&this.addWarning(t,"geometry_memory",e.geometryMemoryMB>2*s.geometryMemoryMB.yellow?"critical":"warning",`Geometry memory: ${e.geometryMemoryMB.toFixed(1)}MB (above ${s.geometryMemoryMB.yellow}MB)`,e.geometryMemoryMB,s.geometryMemoryMB.yellow,"Share geometry between meshes, use BufferGeometry instead of Geometry, dispose unused geometries, use instancing for repeated shapes.",i),e.programCount>50&&this.addWarning(t,"shader_count","warning",`Shader programs: ${e.programCount} (many unique materials)`,e.programCount,50,"Reduce material variations, share materials between objects, consider using a single uber-shader with defines.",i),null!==e.gpuTime&&e.gpuTime>16&&this.addWarning(t,"gpu_time",e.gpuTime>33?"critical":"warning",`GPU time: ${e.gpuTime.toFixed(1)}ms (above 16ms budget)`,e.gpuTime,16,"Simplify shaders, reduce overdraw, lower shadow map resolution, use fewer real-time lights, consider baked lighting.",i),t}addWarning(e,t,i,s,r,n,a,o){const l=`${t}-${i}`;if(this.warningHashes.has(l))return;this.warningHashes.add(l);const h={id:`${t}-${Date.now()}`,severity:i,category:t,message:s,value:r,threshold:n,timestamp:o,suggestion:a};e.push(h),this.warnings.push(h)}computeFramePacing(e){if(e.length<2)return this.emptyFramePacing();const t=e.map(e=>e.frameTime),i=t.reduce((e,t)=>e+t,0)/t.length,s=t.reduce((e,t)=>e+(t-i)**2,0)/t.length,r=Math.sqrt(s),n=16.67*.1,a=t.filter(e=>Math.abs(e-16.67)<=n).length/t.length*100,o=2*i,l=t.filter(e=>e>o).length,h=e.length>0?(e[e.length-1].timestamp-e[0].timestamp)/1e3:1,g=h>0?l/h*60:0,c=1.5*i;let m=0,u=0;for(const e of t)e<=c?(u++,u>m&&(m=u)):u=0;const d=[0,0,0,0,0];for(const e of t)e<8?d[0]++:e<16?d[1]++:e<33?d[2]++:e<50?d[3]++:d[4]++;let p="stable";if(t.length>=120){const e=this.config.thresholds.frameTime.green,i=Math.floor(t.length/2),s=t.slice(0,i).sort((e,t)=>e-t),r=t.slice(i).sort((e,t)=>e-t),n=s[Math.floor(.99*s.length)]??0,a=r[Math.floor(.99*r.length)]??0;a>1.2*n&&a>e?p="degrading":a<.83*n&&n>e&&(p="improving")}return{frameTimeStdDev:r,consistencyPercent:a,janksPerMinute:g,longestSmoothStreak:m,histogram:d,varianceTrend:p}}emptyFramePacing(){return{frameTimeStdDev:0,consistencyPercent:0,janksPerMinute:0,longestSmoothStreak:0,histogram:[0,0,0,0,0],varianceTrend:"stable"}}classifyBottleneck(e,t,i,s){if(i<=0)return{type:"unknown",description:"Insufficient data",confidence:0,suggestion:""};if(i<=17.5&&e<12&&(null===t||t<12))return{type:"vsync-limited",description:"Running at vsync cap with headroom available",confidence:.9,suggestion:"Performance is good. Add more visual quality or increase simulation complexity."};const r=null!==t&&t>0;if(s>500&&e>10)return{type:"draw-call-bound",description:`${s} draw calls causing ${e.toFixed(1)}ms CPU overhead`,confidence:.85,suggestion:"Use InstancedMesh for repeated geometry, merge static meshes, share materials, use texture atlases."};if(r){const i=e/t;if(i>2)return{type:"cpu-bound",description:`CPU render time (${e.toFixed(1)}ms) is ${i.toFixed(1)}x GPU time (${t.toFixed(1)}ms)`,confidence:Math.min(.95,.6+.1*i),suggestion:"Reduce draw call count, simplify scene graph, optimize JavaScript logic, use web workers for heavy computation."};if(i<.5)return{type:"gpu-bound",description:`GPU time (${t.toFixed(1)}ms) is ${(1/i).toFixed(1)}x CPU time (${e.toFixed(1)}ms)`,confidence:Math.min(.95,.6+1/i*.1),suggestion:"Simplify shaders, reduce overdraw, lower shadow/texture resolution, use LOD, reduce post-processing passes."}}const n=r?Math.max(e,t):e;return i>2*n&&n>0?{type:"main-thread",description:`Frame time (${i.toFixed(1)}ms) is ${(i/n).toFixed(1)}x render time (${n.toFixed(1)}ms) — non-render work blocking`,confidence:.75,suggestion:"Profile JavaScript execution. Check for GC pauses, expensive physics, or layout thrashing between frames."}:{type:"balanced",description:"No single bottleneck detected — CPU and GPU load are balanced",confidence:.5,suggestion:"For further optimization, reduce scene complexity across the board or enable LOD."}}computePerformanceScore(e){const t=this.config.thresholds,i=e.fps.avg>=60?100:e.fps.avg>=30?50+(e.fps.avg-30)/30*50:Math.max(0,e.fps.avg/30*50),s=e.framePacing,r=Math.max(0,Math.min(100,.4*s.consistencyPercent+.3*Math.max(0,100-5*s.janksPerMinute)+.3*Math.max(0,100-10*s.frameTimeStdDev))),n=e.textureMemoryMB+e.geometryMemoryMB,a=t.textureMemoryMB.green,o=t.textureMemoryMB.yellow,l=n<=a?100:n<=o?50+50*(1-(n-a)/(o-a)):Math.max(0,50-(n-o)/o*50),h=((e.drawCalls<=t.drawCalls.green?100:e.drawCalls<=t.drawCalls.yellow?50+50*(1-(e.drawCalls-t.drawCalls.green)/(t.drawCalls.yellow-t.drawCalls.green)):Math.max(0,50-(e.drawCalls-t.drawCalls.yellow)/t.drawCalls.yellow*50))+(e.triangles<=t.triangles.green?100:e.triangles<=t.triangles.yellow?50+50*(1-(e.triangles-t.triangles.green)/(t.triangles.yellow-t.triangles.green)):Math.max(0,50-(e.triangles-t.triangles.yellow)/t.triangles.yellow*50)))/2,g=null===e.gpuTime||e.gpuTime<=8?100:e.gpuTime<=16?50+50*(1-(e.gpuTime-8)/8):Math.max(0,50-(e.gpuTime-16)/16*50);let c=Math.round(.4*i+.2*r+.15*l+.15*h+.1*g);c=Math.max(0,Math.min(100,c));const m=this.lastComputedScore<0?c:Math.round(.3*c+.7*this.lastComputedScore);this.lastComputedScore=m;const{grade:u,label:d}=function(e){return e>=90?{grade:"excellent",label:"Excellent"}:e>=70?{grade:"good",label:"Good"}:e>=50?{grade:"needs-work",label:"Needs Work"}:e>=30?{grade:"poor",label:"Poor"}:{grade:"critical",label:"Critical"}}(m);return{score:m,grade:u,gradeLabel:d,categories:{performance:Math.round(Math.max(0,Math.min(100,i))),smoothness:Math.round(Math.max(0,Math.min(100,r))),memory:Math.round(Math.max(0,Math.min(100,l))),rendering:Math.round(Math.max(0,Math.min(100,h))),gpu:Math.round(Math.max(0,Math.min(100,g)))},issues:this.generateIssues(e)}}generateIssues(e){const a=[],o=this.config.thresholds;e.fps.avg>0&&e.fps.avg<o.fps.yellow&&a.push({id:"fps-low",severity:e.fps.avg<o.fps.yellow/2?"critical":"warning",title:"Game is running slowly",description:e.fps.avg<20?"Your game is very slow. Try reducing the number of objects or simplifying visual effects.":"Your game could be smoother. Consider simplifying busy scenes.",category:"performance",icon:t}),e.drawCalls>o.drawCalls.yellow&&a.push({id:"draw-calls-high",severity:e.drawCalls>3*o.drawCalls.yellow?"critical":"warning",title:"Too many objects drawing separately",description:"Group similar objects together so the game does less work each frame. Objects with the same look can often be merged.",category:"rendering",icon:i}),e.triangles>o.triangles.yellow&&a.push({id:"triangles-high",severity:e.triangles>3*o.triangles.yellow?"critical":"warning",title:"Too much geometry detail",description:"Some models have more detail than needed. Use simpler models for background objects or things far from the camera.",category:"rendering",icon:i}),e.textureMemoryMB>o.textureMemoryMB.yellow&&a.push({id:"texture-memory-high",severity:e.textureMemoryMB>2*o.textureMemoryMB.yellow?"critical":"warning",title:"Large images using lots of memory",description:"Your textures are using a lot of GPU memory. Try compressing images, using smaller sizes, or sharing textures between objects.",category:"memory",icon:s}),e.geometryMemoryMB>o.geometryMemoryMB.yellow&&a.push({id:"geometry-memory-high",severity:e.geometryMemoryMB>2*o.geometryMemoryMB.yellow?"critical":"warning",title:"Too much 3D data in memory",description:"Your models are using lots of memory. Share shapes between similar objects and remove unused geometry.",category:"memory",icon:s}),null!==e.gpuTime&&e.gpuTime>16&&a.push({id:"gpu-time-high",severity:e.gpuTime>33?"critical":"warning",title:"GPU is working too hard",description:"Your graphics card is struggling. Simplify visual effects, reduce shadow quality, or lower the resolution.",category:"gpu",icon:r}),e.framePacing.janksPerMinute>10&&a.push({id:"jank-detected",severity:e.framePacing.janksPerMinute>30?"critical":"warning",title:"Game stutters occasionally",description:"Your game has noticeable hiccups. This can be caused by loading assets during gameplay or doing too much work at once.",category:"smoothness",icon:n});const l=this.config.thresholds.frameTime.green,h=this.getBurnRate(1e4,l),g=this.getBurnRate(6e4,l),c=this.getBurnRate(3e5,l);return h>=10&&g>=10?a.push({id:"performance-degrading",severity:"critical",title:"Game is stuttering right now",description:"Frames are missing the target budget at 10× the rate the SLO allows, both in the last 10 seconds and the last minute. Something is actively wrong — recent code changes or an expensive scene transition.",category:"smoothness",icon:n}):c>=3&&g>=3&&a.push({id:"performance-degrading",severity:"warning",title:"Performance getting worse over time",description:"Frames have been missing the target budget at 3× the rate the SLO allows, sustained over the last few minutes. Common causes: objects accumulating without cleanup, growing particle pool, forgotten event listeners.",category:"smoothness",icon:n}),a}hookStateChangeTracking(){const e=this.getGLContext();if(!e)return;const t=this.stateChangeCounters;this.originalUseProgram=e.useProgram.bind(e),e.useProgram=e=>(t.programSwitches++,this.originalUseProgram(e)),this.originalBindTexture=e.bindTexture.bind(e),e.bindTexture=(e,i)=>(t.textureSwitches++,this.originalBindTexture(e,i)),this.originalBindFramebuffer=e.bindFramebuffer.bind(e),e.bindFramebuffer=(e,i)=>(t.fboSwitches++,this.originalBindFramebuffer(e,i)),this.log("WebGL state change tracking active")}unhookStateChangeTracking(){const e=this.getGLContext();e&&(this.originalUseProgram&&(e.useProgram=this.originalUseProgram,this.originalUseProgram=null),this.originalBindTexture&&(e.bindTexture=this.originalBindTexture,this.originalBindTexture=null),this.originalBindFramebuffer&&(e.bindFramebuffer=this.originalBindFramebuffer,this.originalBindFramebuffer=null))}startLoafObserver(){try{if("undefined"==typeof PerformanceObserver)return;const e=PerformanceObserver.supportedEntryTypes;if(!e?.includes("long-animation-frame"))return;this.loafObserver=new PerformanceObserver(e=>{for(const t of e.getEntries()){const e=t;this.loafEntries.push({duration:e.duration,renderStart:e.renderStart??0,styleAndLayoutStart:e.styleAndLayoutStart??0,scripts:(e.scripts??[]).map(e=>({sourceURL:e.sourceURL||"unknown",invoker:e.invoker||"unknown",duration:e.duration})),timestamp:e.startTime}),this.loafEntries.length>50&&this.loafEntries.shift()}}),this.loafObserver.observe({type:"long-animation-frame",buffered:!1}),this.log("Long Animation Frame (LoAF) observer active")}catch{}}stopLoafObserver(){this.loafObserver&&(this.loafObserver.disconnect(),this.loafObserver=null)}getWindowedStats(e){const t=performance.now()-e,i=this.ringBuffer.sliceSince(t),s=i.length;if(0===s)return{windowMs:e,sampleCount:0,fps:{p50:0,p95:0,p99:0,min:0,max:0,avg:0},frameTime:{p50:0,p95:0,p99:0,max:0,avg:0},heap:{start:0,end:0,min:0,max:0,deltaPerMin:0}};const r=i.map(e=>e.fps),n=i.map(e=>e.frameTime),a=i.map(e=>(e.jsHeapUsed??0)/1048576),o=a[a.length-1]-a[0],h=(i[i.length-1].timestamp-i[0].timestamp)/6e4,g=(e,t)=>e+t;return{windowMs:e,sampleCount:s,fps:{p50:l(r,50),p95:l(r,95),p99:l(r,99),min:Math.min(...r),max:Math.max(...r),avg:r.reduce(g,0)/s},frameTime:{p50:l(n,50),p95:l(n,95),p99:l(n,99),max:Math.max(...n),avg:n.reduce(g,0)/s},heap:{start:a[0],end:a[a.length-1],min:Math.min(...a),max:Math.max(...a),deltaPerMin:h>0?o/h:0}}}getBurnRate(e,t,i=30){const s=performance.now()-e;return function(e,t,i=30){if(e.length<i)return 0;let s=0;for(const i of e)i.frameTime>t&&(s+=1);return s/e.length/.01}(this.ringBuffer.sliceSince(s),t,i)}buildSnapshot(){const e=this.ringBuffer.sliceSince(0),t=e.length>0?this.aggregateStats(e):this.emptyStats();this.warningHashes.clear(),this.warnings=[],this.detectWarnings(t);let i=this.getHotObjects()??void 0;if(i&&i.length>0){const e=t.triangles||1,s=t.drawCalls||1;i=i.map(t=>({...t,triangleBudgetPercent:t.triangles/e*100,drawCallBudgetPercent:t.drawCalls/s*100}))}return{engine:this.engineType,timestamp:Date.now(),profilingDuration:performance.now()-this.profilingStartTime,stats:t,recentSamples:e.slice(-30),warnings:[...this.warnings],engineInfo:this.getEngineInfo(),hotObjects:i,loafEntries:this.loafEntries.length>0?[...this.loafEntries]:void 0}}getReport(){return function(e){const{stats:t,warnings:i,engineInfo:s,hotObjects:r}=e,n=["## Performance Profile","",`**Engine:** ${s.name} ${s.version} | **Renderer:** ${s.renderer}`,`**Canvas:** ${s.canvasWidth}x${s.canvasHeight} @ ${s.pixelRatio}x DPR`,`**Profiling Duration:** ${(e.profilingDuration/1e3).toFixed(1)}s | **Samples:** ${e.recentSamples.length}`,"","### Frame Performance","| Metric | Current | Min | Max | Avg |","|--------|---------|-----|-----|-----|",`| FPS | ${t.fps.current.toFixed(1)} | ${t.fps.min.toFixed(1)} | ${t.fps.max.toFixed(1)} | ${t.fps.avg.toFixed(1)} |`,`| Frame Time (ms) | ${t.frameTime.current.toFixed(2)} | ${t.frameTime.min.toFixed(2)} | ${t.frameTime.max.toFixed(2)} | ${t.frameTime.avg.toFixed(2)} |`,`| CPU Render (ms) | ${t.cpuTime.current.toFixed(2)} | ${t.cpuTime.min.toFixed(2)} | ${t.cpuTime.max.toFixed(2)} | ${t.cpuTime.avg.toFixed(2)} |`,null!==t.gpuTime?`| GPU Time (ms) | ${t.gpuTime.toFixed(2)} | - | - | - |`:"","","### Render Pipeline","| Metric | Value |","|--------|-------|",`| Draw Calls | ${t.drawCalls.toLocaleString()} |`,`| Triangles | ${t.triangles.toLocaleString()} |`,`| Points | ${t.points.toLocaleString()} |`,`| Lines | ${t.lines.toLocaleString()} |`,`| Shader Programs | ${t.programCount} |`,"","### Memory","| Metric | Value |","|--------|-------|",`| Textures | ${t.textureCount} (${t.textureMemoryMB.toFixed(1)} MB) |`,`| Geometries | ${t.geometryCount} (${t.geometryMemoryMB.toFixed(1)} MB) |`,null!==t.jsHeapUsedMB?`| JS Heap | ${t.jsHeapUsedMB.toFixed(1)} MB |`:"","","### Scene Graph","| Metric | Value |","|--------|-------|",`| Total Objects | ${t.totalObjects.toLocaleString()} |`,`| Visible Objects | ${t.visibleObjects.toLocaleString()} |`,`| Lights | ${t.lightsCount} |`,`| Cameras | ${t.camerasCount} |`],a=t.framePacing;a&&n.push("### Frame Pacing (Smoothness)","| Metric | Value |","|--------|-------|",`| Consistency | ${a.consistencyPercent.toFixed(1)}% of frames on-target |`,`| Std Deviation | ${a.frameTimeStdDev.toFixed(2)}ms |`,`| Janks/min | ${a.janksPerMinute.toFixed(1)} |`,`| Longest Smooth Streak | ${a.longestSmoothStreak} frames |`,`| Variance Trend | ${a.varianceTrend} |`,`| Histogram (0-8/8-16/16-33/33-50/50+ms) | ${a.histogram.join(" / ")} |`,"");const o=t.bottleneck;if(o&&"unknown"!==o.type&&n.push("### Bottleneck Analysis",`- **Type:** ${o.type} (${(100*o.confidence).toFixed(0)}% confidence)`,`- **Analysis:** ${o.description}`,`- **Suggestion:** ${o.suggestion}`,""),(t.programSwitches>0||t.textureSwitches>0||t.fboSwitches>0)&&n.push("### WebGL State Changes (per frame)","| Metric | Value |","|--------|-------|",`| Program Switches | ${t.programSwitches} |`,`| Texture Binds | ${t.textureSwitches} |`,`| FBO Switches | ${t.fboSwitches} |`,""),(void 0!==s.antialias||s.shadows||s.toneMapping)&&(n.push("","### Renderer Settings"),void 0!==s.antialias&&n.push("- Antialiasing: "+(s.antialias?"ON":"OFF")),s.shadows&&n.push("- Shadows: "+(s.shadows.enabled?`ON (${s.shadows.type||"default"})`:"OFF")),s.toneMapping&&n.push(`- Tone Mapping: ${s.toneMapping}`),s.maxTextureSize&&n.push(`- Max Texture Size: ${s.maxTextureSize}`)),i.length>0){n.push("","### Performance Warnings");for(const e of i){const t="critical"===e.severity?"CRITICAL":"warning"===e.severity?"WARNING":"INFO";n.push(`- **[${t}]** ${e.message} (${e.value} > threshold ${e.threshold})`),n.push(`  Suggestion: ${e.suggestion}`)}}if(r&&r.length>0){n.push("","### Top Objects by Cost"),n.push("| Object | Type | Triangles | Tri% | Draw Calls | DC% | Tex MB |"),n.push("|--------|------|-----------|------|------------|-----|--------|");for(const e of r.slice(0,10)){const t=void 0!==e.triangleBudgetPercent?`${e.triangleBudgetPercent.toFixed(1)}%`:"-",i=void 0!==e.drawCallBudgetPercent?`${e.drawCallBudgetPercent.toFixed(1)}%`:"-";n.push(`| ${e.name} | ${e.type} | ${e.triangles.toLocaleString()} | ${t} | ${e.drawCalls} | ${i} | ${(e.textureBytes/1024/1024).toFixed(1)} |`)}}if(e.loafEntries&&e.loafEntries.length>0){n.push("","### Long Animation Frames (Browser Jank)"),n.push("| Duration | Render Start | Scripts |"),n.push("|----------|-------------|---------|");for(const t of e.loafEntries.slice(-5)){const e=t.scripts.map(e=>`${e.invoker}(${e.duration.toFixed(0)}ms)`).join(", ")||"none";n.push(`| ${t.duration.toFixed(0)}ms | ${t.renderStart.toFixed(0)}ms | ${e} |`)}}if(e.recentSamples.length>0){const t=e.recentSamples.slice(-10);n.push("",`### Recent Frame Times (last ${t.length} samples)`),n.push(`\`${t.map(e=>e.frameTime.toFixed(1)).join(" → ")} ms\``);const i=t.reduce((e,t)=>e+t.frameTime,0)/t.length,s=t.filter(e=>e.frameTime>2*i);s.length>0&&n.push(`⚠ ${s.length} frame time spike(s) detected (>2x average)`)}return n.filter(e=>""!==e).join("\n")}(this.buildSnapshot())}updateConfig(e){this.config={...this.config,...e},e.bufferSize&&e.bufferSize!==this.ringBuffer.capacity&&(this.ringBuffer=new o(e.bufferSize))}exposeGlobalAPI(){window.__funpixelProfiler={start:()=>this.start(),stop:()=>this.stop(),isRunning:()=>this.isRunning,getSnapshot:()=>this.buildSnapshot(),getReport:()=>this.getReport()}}log(e,t="log"){(this.config.debug||"log"!==t)&&console[t](`[Funpixel Profiler] ${e}`)}destroy(){this.stop(),this.gpuTimer?.destroy(),this.messages.destroy(),delete window.__funpixelProfiler}}const m={0:"BasicShadowMap",1:"PCFShadowMap",2:"PCFSoftShadowMap",3:"VSMShadowMap"},u={0:"NoToneMapping",1:"LinearToneMapping",2:"ReinhardToneMapping",3:"CineonToneMapping",4:"ACESFilmicToneMapping",5:"CustomToneMapping",6:"AgXToneMapping",7:"NeutralToneMapping"};class d extends c{engineType="threejs";scene=null;renderer=null;camera=null;originalRender=null;cachedTextureBytes=0;cachedGeometryBytes=0;constructor(e){super(e),this.init()}collectRenderStats(){if(!this.renderer)return{};const e=this.renderer.info,t=e.render,i=e.memory,s=e.programs,r=this.cachedTextureBytes&&isFinite(this.cachedTextureBytes)?this.cachedTextureBytes:512*i.textures*512*4,n=this.cachedGeometryBytes&&isFinite(this.cachedGeometryBytes)?this.cachedGeometryBytes:50*i.geometries*1024;return{drawCalls:t.calls,triangles:t.triangles,points:t.points,lines:t.lines,textureCount:i.textures,textureBytes:r,geometryCount:i.geometries,geometryBytes:n,programCount:s?.length??0}}collectSceneStats(){if(!this.scene)return{totalObjects:0,visibleObjects:0,lightsCount:0,camerasCount:0};let e=0,t=0,i=0,s=0,r=!1;const n=new Set,a=new Set;let o=0,l=0;const h=[this.scene];for(;h.length>0;){const g=h.pop();e++,g.visible&&t++,g.isLight&&i++,g.isCamera&&(s++,g===this.camera&&(r=!0)),g.geometry&&!n.has(g.geometry)&&(n.add(g.geometry),o+=this.computeGeometryBytes(g.geometry));const c=Array.isArray(g.material)?g.material:g.material?[g.material]:[];for(const e of c){const t=[e.map,e.normalMap,e.roughnessMap,e.metalnessMap,e.emissiveMap,e.aoMap,e.envMap];for(const e of t)e&&!a.has(e)&&(a.add(e),l+=this.computeTextureBytes(e))}for(let e=g.children.length-1;e>=0;e--)h.push(g.children[e])}return this.camera&&!r&&s++,this.cachedTextureBytes=l,this.cachedGeometryBytes=o,{totalObjects:e,visibleObjects:t,lightsCount:i,camerasCount:s}}computeGeometryBytes(e){let t=0;if(e.attributes)for(const i of Object.values(e.attributes))i.array&&"byteLength"in i.array?t+=i.array.byteLength||0:i.count&&i.itemSize&&(t+=i.count*i.itemSize*4);return e.index?.array&&"byteLength"in e.index.array?t+=e.index.array.byteLength||0:e.index?.count&&(t+=4*e.index.count),t||0}computeTextureBytes(e){const t=e.image||e.source?.data;if(t?.width&&t?.height){return t.width*t.height*4||0}return 1048576}hookRenderLoop(){if(!this.renderer||this.originalRender)return;this.originalRender=this.renderer.render.bind(this.renderer);const e=this;this.renderer.render=(t,i)=>{e.gpuTimer?.beginFrame();const s=performance.now();e.originalRender(t,i);const r=performance.now()-s;e.gpuTimer?.endFrame(),e.onFrameEnd(r)},this.log("Hooked renderer.render() for frame timing")}unhookRenderLoop(){this.renderer&&this.originalRender&&(this.renderer.render=this.originalRender,this.originalRender=null,this.log("Unhooked renderer.render()"))}isEngineReady(){return!(!window.__THREEJS_RENDERER__||!window.__THREEJS_SCENE__||!window.__THREEJS_CAMERA__&&!this.findCamera(window.__THREEJS_SCENE__))}getGLContext(){if(!this.renderer)return null;if(this.renderer.getContext)try{return this.renderer.getContext()}catch{}const e=this.renderer.domElement;return e.getContext("webgl2",{failIfMajorPerformanceCaveat:!1})||e.getContext("webgl",{failIfMajorPerformanceCaveat:!1})}getCanvas(){return this.renderer?.domElement??null}getEngineInfo(){const e=this.renderer,t=e?.capabilities,i=e?.domElement,s=this.getGLContext(),r=t?.isWebGL2??s instanceof WebGL2RenderingContext,n=[];if(s){const e=s.getSupportedExtensions();if(e){const t=["EXT_disjoint_timer_query","EXT_disjoint_timer_query_webgl2","OES_texture_float","OES_texture_half_float","WEBGL_compressed_texture_s3tc","WEBGL_compressed_texture_astc","EXT_texture_filter_anisotropic","WEBGL_draw_buffers","OES_element_index_uint"];for(const i of t)e.includes(i)&&n.push(i)}}return{name:"Three.js",version:window.THREE?.REVISION?`r${window.THREE.REVISION}`:"unknown",renderer:r?"WebGL2":"WebGL",canvasWidth:i?.width??0,canvasHeight:i?.height??0,pixelRatio:e?.getPixelRatio()??1,extensions:n,maxTextureSize:t?.maxTextureSize??(s?s.getParameter(s.MAX_TEXTURE_SIZE):void 0),antialias:s?!!s.getContextAttributes()?.antialias:void 0,shadows:e?.shadowMap?{enabled:e.shadowMap.enabled,type:void 0!==e.shadowMap.type?m[e.shadowMap.type]:void 0}:void 0,toneMapping:void 0!==e?.toneMapping?u[e.toneMapping]:void 0}}getHotObjects(){if(!this.scene)return null;const e=[],t=[this.scene];for(;t.length>0;){const i=t.pop();if(i.isMesh||i.isSkinnedMesh||i.isInstancedMesh||i.isSprite||i.isPoints||i.isLine){const t=i.geometry;let s=0;t&&(t.index?s=(t.index.count??0)/3:t.attributes?.position&&(s=(t.attributes.position.count??0)/3),i.isInstancedMesh&&i.count&&(s*=i.count));let r=0;const n=Array.isArray(i.material)?i.material:i.material?[i.material]:[];for(const e of n){const t=[e.map,e.normalMap,e.roughnessMap,e.metalnessMap,e.emissiveMap,e.aoMap,e.envMap];for(const e of t)if(e){const t=e.image||e.source?.data;t?.width&&t?.height&&(r+=t.width*t.height*4)}}e.push({name:i.name||i.type,type:i.type,triangles:s,drawCalls:i.isInstancedMesh?1:n.length||1,textureBytes:r,visible:i.visible,position:{x:i.position.x,y:i.position.y,z:i.position.z}})}for(let e=i.children.length-1;e>=0;e--)t.push(i.children[e])}return e.sort((e,t)=>t.triangles-e.triangles),e.slice(0,20)}onEngineReady(){this.renderer=window.__THREEJS_RENDERER__,this.scene=window.__THREEJS_SCENE__,this.camera=window.__THREEJS_CAMERA__||this.findCamera(this.scene),this.log(`Three.js ${window.THREE?.REVISION?"r"+window.THREE.REVISION:""} detected`),this.log(`Scene: ${this.scene.children.length} top-level objects`),super.onEngineReady()}findCamera(e){if(!e)return null;const t=[e];for(;t.length>0;){const e=t.pop();if(e.isCamera)return e;for(const i of e.children)t.push(i)}return null}}function p(){new d({debug:!0})}return"loading"===document.readyState?document.addEventListener("DOMContentLoaded",p):p(),e.ThreeJsProfiler=d,e}({});

package/dist/direct/moves.js

@@ -0,0 +1,234 @@
+import { deltaE, lab, palette } from "../score/measure.js";
+const DEG = Math.PI / 180;
+const r1 = (v) => Math.round(v * 10) / 10;
+const r2 = (v) => Math.round(v * 100) / 100;
+const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+const fmt = (v) => `(${v.map((x) => r1(x)).join(', ')})`;
+export function horizonAt(pitch, vfov) {
+    return 0.5 - 0.5 * Math.tan(pitch) / Math.tan((vfov * DEG) / 2);
+}
+export function pitchFor(h, vfov) {
+    return Math.atan((0.5 - h) * 2 * Math.tan((vfov * DEG) / 2));
+}
+export function fovFor(vfov, k) {
+    return (2 * Math.atan(Math.tan((vfov * DEG) / 2) / k)) / DEG;
+}
+const hfovOf = (vfov, aspect) => (2 * Math.atan(Math.tan((vfov * DEG) / 2) * aspect)) / DEG;
+export const HORIZON_TRUST = 0.2;
+export const YAW_GAIN = 0.5;
+export const CLEARANCE = 0.4;
+export function framingK(d) {
+    if (d.hero)
+        return d.hero.target / d.hero.capture;
+    return d.zoom >= 1.12 || d.zoom <= 0.9 ? d.zoom : null;
+}
+export const LENS = { min: 22, max: 75, step: 1.25 };
+export function cameraMoves(d, cam) {
+    if (!cam)
+        return [];
+    return cam.kind === '2d' ? moves2d(d, cam) : moves3d(d, cam);
+}
+function moves3d(d, cam) {
+    const out = [];
+    const sp = cam.shotParams ?? null;
+    const vfov = sp?.fov ?? cam.fov ?? null;
+    if (vfov === null)
+        return out;
+    const aspect = cam.aspect ?? 16 / 9;
+    const k = framingK(d);
+    let fov = vfov, distK = 1;
+    if (k !== null && Math.abs(Math.log(k)) > Math.log(1.08)) {
+        const lensK = clamp(k, 1 / LENS.step, LENS.step);
+        fov = clamp(fovFor(vfov, lensK), LENS.min, LENS.max);
+        const got = Math.tan((vfov * DEG) / 2) / Math.tan((fov * DEG) / 2);
+        distK = got / k;
+    }
+    const ht = d.horizon.target, hc = d.horizon.capture;
+    let horizonNote = null;
+    const pitchToward = (pitch, lens) => {
+        if (ht === null)
+            return pitch;
+        if (hc !== null && Math.abs(hc - horizonAt(pitch, vfov)) > HORIZON_TRUST) {
+            horizonNote = `the read skyline (${Math.round(hc * 100)}% down) is not where this camera's pitch puts the horizon (${Math.round(horizonAt(pitch, vfov) * 100)}%): an edge, not a horizon, so no tilt from it`;
+            return pitch;
+        }
+        if (hc === null) {
+            horizonNote = `a skyline is read in the target only (${Math.round(ht * 100)}% down), none in the capture: tilt by eye if the target's is a true horizon`;
+            return pitch;
+        }
+        if (Math.abs(ht - hc) < 0.06)
+            return pitch;
+        return pitchFor(horizonAt(pitch, lens) + (ht - hc), lens);
+    };
+    if (sp) {
+        const pitch = Math.atan2(sp.height, sp.distance), reach = Math.hypot(sp.distance, sp.height);
+        const want = pitchToward(pitch, fov);
+        const newReach = reach * distK;
+        const dist = newReach * Math.cos(want), height = newReach * Math.sin(want);
+        const base = cam.source;
+        if (Math.abs(fov - vfov) >= 1)
+            out.push({ param: `${base}.fov`, from: r1(vfov), to: r1(fov), closes: d.hero ? 'hero' : 'composition', why: `frame ×${r2(k)} ${k > 1 ? 'tighter' : 'wider'}${d.hero ? ` (the hero is ${Math.round(d.hero.capture * 100)}% of the height, the target's ${Math.round(d.hero.target * 100)}%)` : ' (the edge fit of the capture over the target)'}` });
+        if (Math.abs(height - sp.height) >= 0.1)
+            out.push({ param: `${base}.height`, from: r2(sp.height), to: r2(height), closes: 'composition', why: ht !== null ? `the horizon at ${Math.round(ht * 100)}% down the frame, as the target's (pitch ${r1(pitch / DEG)}° → ${r1(want / DEG)}° down at the same reach)` : `the same pitch at ${distK > 1 ? 'a longer' : 'a shorter'} reach` });
+        if (Math.abs(dist - sp.distance) >= 0.1)
+            out.push({ param: `${base}.distance`, from: r2(sp.distance), to: r2(dist), closes: 'composition', why: distK !== 1 ? `the rest of the framing is distance: the reach ×${r2(distK)} (the lens moves at most ×${LENS.step} a round, within ${LENS.min}–${LENS.max}°)` : 'keeps the reach while the pitch changes' });
+        const yaw = yawMove(d, fov, aspect);
+        if (horizonNote)
+            out.push({ param: 'note', from: '', to: '', closes: 'composition', why: horizonNote });
+        if (yaw !== null)
+            out.push({ param: `${base}.yaw`, from: r2(sp.yaw ?? 0), to: r2((sp.yaw ?? 0) + yaw), closes: 'composition', why: `the scene sits ${Math.round(Math.abs(d.pan.x) * 100)}% of the width to the ${d.pan.x > 0 ? 'left' : 'right'} of the target's: turn ${yaw > 0 ? 'left' : 'right'} ${r1(Math.abs(yaw) / DEG)}°` });
+        return out;
+    }
+    if (!cam.position || !cam.target) {
+        if (Math.abs(fov - vfov) >= 1)
+            out.push({ param: 'camera.fov', from: r1(vfov), to: r1(fov), closes: 'composition', why: `frame ×${r2(k)} ${k > 1 ? 'tighter' : 'wider'}` });
+        return out;
+    }
+    const P = cam.position, T0 = cam.target;
+    const L = [T0[0] - P[0], T0[1] - P[1], T0[2] - P[2]];
+    const reach = Math.hypot(...L), flat = Math.hypot(L[0], L[2]) || 1e-6;
+    const pitch = Math.atan2(-L[1], flat);
+    const vt = vanishTurn(d, vfov, aspect);
+    const yaw = vt ? (Math.abs(vt.left) >= 0.5 * DEG ? vt.left : null) : yawMove(d, fov, aspect);
+    const want = vt ? pitch - vt.up : pitchToward(pitch, fov);
+    let fx = L[0] / flat, fz = L[2] / flat;
+    if (yaw !== null) {
+        const c = Math.cos(yaw), s2 = Math.sin(yaw);
+        [fx, fz] = [fx * c + fz * s2, -fx * s2 + fz * c];
+    }
+    const dir = [fx * Math.cos(want), -Math.sin(want), fz * Math.cos(want)];
+    const turned = yaw !== null || Math.abs(want - pitch) >= 0.3 * DEG;
+    const T = turned ? [P[0] + dir[0] * reach, P[1] + dir[1] * reach, P[2] + dir[2] * reach] : T0;
+    const roomBehind = cam.room?.behind ?? null, roomAbove = cam.room?.above ?? null;
+    let nr = reach * distK, boxed = false;
+    if (roomBehind !== null && nr > reach + Math.max(0, roomBehind - CLEARANCE)) {
+        nr = reach + Math.max(0, roomBehind - CLEARANCE);
+        boxed = true;
+    }
+    const np = [T[0] - dir[0] * nr, T[1] - dir[1] * nr, T[2] - dir[2] * nr];
+    if (roomAbove !== null && np[1] > P[1] + Math.max(0, roomAbove - CLEARANCE)) {
+        np[1] = P[1] + Math.max(0, roomAbove - CLEARANCE);
+        boxed = true;
+    }
+    if (Math.abs(fov - vfov) >= 1)
+        out.push({ param: 'camera.fov', from: r1(vfov), to: r1(fov), closes: d.hero ? 'hero' : 'composition', why: `frame ×${r2(k)} ${k > 1 ? 'tighter' : 'wider'}${d.hero ? ` (hero ${Math.round(d.hero.capture * 100)}% of the height, target ${Math.round(d.hero.target * 100)}%)` : ''}` });
+    if (turned) {
+        const how = [yaw !== null ? `turn ${yaw > 0 ? 'left' : 'right'} ${r1(Math.abs(yaw) / DEG)}°` : '', Math.abs(want - pitch) >= 0.3 * DEG ? `tilt ${want < pitch ? 'up' : 'down'} ${r1(Math.abs(want - pitch) / DEG)}°` : ''].filter(Boolean).join(' and ');
+        const from = vt ? `the lines meet ${Math.round(d.vanish.capture.x * 100)}% across, ${Math.round(d.vanish.capture.y * 100)}% down; the target's at ${Math.round(d.vanish.target.x * 100)}%, ${Math.round(d.vanish.target.y * 100)}%` : yaw !== null ? `the scene sits ${Math.round(Math.abs(d.pan.x) * 100)}% of the width to the ${d.pan.x > 0 ? 'left' : 'right'} of the target's` : `the horizon to ${Math.round((ht ?? 0) * 100)}% down`;
+        out.push({ param: 'camera.lookAt', from: fmt(T0), to: fmt(T), closes: 'composition', why: `${from}: ${how}, in place` });
+    }
+    const moved = Math.hypot(np[0] - P[0], np[1] - P[1], np[2] - P[2]);
+    if (moved >= 0.1)
+        out.push({ param: 'camera.position', from: fmt(P), to: fmt(np), closes: 'composition', why: `along the view, ${r2(nr / reach)}× the reach (the lens moves at most ×${LENS.step} a round)${boxed ? `; held inside the room (${roomBehind !== null ? `${r1(roomBehind)} m free behind` : ''}${roomBehind !== null && roomAbove !== null ? ', ' : ''}${roomAbove !== null ? `${r1(roomAbove)} m above` : ''}): the rest of a wider frame is the lens, next round` : ''}` });
+    if (horizonNote)
+        out.push({ param: 'note', from: '', to: '', closes: 'composition', why: horizonNote });
+    return out;
+}
+export function vanishTurn(d, vfov, aspect) {
+    if (!d.vanish)
+        return null;
+    const th = Math.tan((hfovOf(vfov, aspect) * DEG) / 2), tv = Math.tan((vfov * DEG) / 2);
+    const ang = (u, t) => Math.atan(u * t);
+    return {
+        left: ang(2 * d.vanish.target.x - 1, th) - ang(2 * d.vanish.capture.x - 1, th),
+        up: ang(2 * d.vanish.target.y - 1, tv) - ang(2 * d.vanish.capture.y - 1, tv),
+    };
+}
+function yawMove(d, vfov, aspect) {
+    if (Math.abs(d.pan.x) < 0.05)
+        return null;
+    return YAW_GAIN * Math.atan(2 * d.pan.x * Math.tan((hfovOf(vfov, aspect) * DEG) / 2));
+}
+function moves2d(d, cam) {
+    const out = [];
+    const z = cam.zoom ?? 1, [w, h] = cam.viewport ?? [1280, 720], [ox, oy] = cam.offset ?? [0, 0];
+    const k = framingK(d);
+    if (k !== null && Math.abs(Math.log(k)) > Math.log(1.08))
+        out.push({ param: `${cam.source}.scale`, from: r2(z), to: r2(z * k), closes: d.hero ? 'hero' : 'composition', why: `frame ×${r2(k)} ${k > 1 ? 'tighter' : 'wider'}${d.hero ? ` (the hero ${Math.round(d.hero.capture * 100)}% of the height, the target's ${Math.round(d.hero.target * 100)}%)` : ''}` });
+    const dx = Math.abs(d.pan.x) >= 0.05 ? d.pan.x * w : 0;
+    const dy = Math.abs(d.pan.y) >= 0.05 ? d.pan.y * h : 0;
+    if (dx || dy)
+        out.push({ param: `${cam.source}.position`, from: `(${Math.round(ox)}, ${Math.round(oy)})`, to: `(${Math.round(ox + dx)}, ${Math.round(oy + dy)})`, closes: 'composition', why: `the scene moves ${dx ? `${Math.round(Math.abs(dx))} px ${dx > 0 ? 'right' : 'left'}` : ''}${dx && dy ? ' and ' : ''}${dy ? `${Math.round(Math.abs(dy))} px ${dy > 0 ? 'down' : 'up'}` : ''} to sit where the target has it` });
+    return out;
+}
+const lin = (c) => { const s = c / 255; return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4; };
+export function meanLuminance(p) {
+    let s = 0;
+    const n = p.width * p.height;
+    for (let i = 0; i < n; i++)
+        s += 0.2126 * lin(p.data[i * 4]) + 0.7152 * lin(p.data[i * 4 + 1]) + 0.0722 * lin(p.data[i * 4 + 2]);
+    return n ? s / n : 0;
+}
+export function labToHex([L, a, b]) {
+    const fy = (L + 16) / 116, fx = fy + a / 500, fz = fy - b / 200;
+    const inv = (t) => (t ** 3 > 0.008856 ? t ** 3 : (t - 16 / 116) / 7.787);
+    const X = inv(fx) * 0.95047, Y = inv(fy), Z = inv(fz) * 1.08883;
+    const R = 3.2406 * X - 1.5372 * Y - 0.4986 * Z, G = -0.9689 * X + 1.8758 * Y + 0.0415 * Z, B = 0.0557 * X - 0.204 * Y + 1.057 * Z;
+    const g = (c) => Math.round(255 * clamp(c <= 0.0031308 ? 12.92 * c : 1.055 * c ** (1 / 2.4) - 0.055, 0, 1));
+    return `#${[R, G, B].map((c) => g(c).toString(16).padStart(2, '0')).join('')}`;
+}
+export function lookMoves(capture, target, cam) {
+    const out = [];
+    const yc = meanLuminance(capture), yt = meanLuminance(target);
+    if (yc > 0 && yt > 0) {
+        const ratio = yt / yc;
+        if (ratio > 1.25 || ratio < 0.8) {
+            const say = `the target's mean light is ×${r2(ratio)} the capture's (${ratio > 1 ? 'lighter' : 'darker'})`;
+            if (cam?.exposure != null)
+                out.push({ param: 'renderer.toneMappingExposure', from: r2(cam.exposure), to: r2(cam.exposure * ratio), closes: 'palette_light', why: say });
+            else
+                out.push({ param: 'light', from: '×1', to: `×${r2(ratio)}`, closes: 'palette_light', why: `${say}: scale the key and ambient light (or the sprites' tint) by that much` });
+        }
+    }
+    const pc = palette(capture), pt = palette(target);
+    const near = (s, list) => list.reduce((best, x) => { const e = deltaE(s.lab, x.lab); return e < best.e ? { e, x } : best; }, { e: Infinity, x: list[0] });
+    for (const s of pt.filter((x) => x.weight >= 0.1)) {
+        const n = near(s, pc);
+        if (n.e > 18 && n.x)
+            out.push({ param: 'colour', from: labToHex(n.x.lab), to: labToHex(s.lab), closes: 'palette_light', why: `the target spends ${Math.round(s.weight * 100)}% of the frame on ${labToHex(s.lab)}; the capture's nearest is ${labToHex(n.x.lab)} (ΔE ${Math.round(n.e)}): move that surface (sky, fog, ground or light) to it` });
+    }
+    for (const s of pc.filter((x) => x.weight >= 0.12)) {
+        const n = near(s, pt);
+        if (n.e > 22 && n.x && !out.some((m) => m.from === labToHex(s.lab)))
+            out.push({ param: 'colour', from: labToHex(s.lab), to: labToHex(n.x.lab), closes: 'palette_light', why: `the capture spends ${Math.round(s.weight * 100)}% of the frame on ${labToHex(s.lab)}, a colour the target does not use (nearest ${labToHex(n.x.lab)}, ΔE ${Math.round(n.e)})` });
+    }
+    return out.slice(0, 4);
+}
+const REGION = ['top left', 'top', 'top right', 'left', 'centre', 'right', 'bottom left', 'bottom', 'bottom right'];
+function busyThirds(p, spread = 18) {
+    const out = new Array(9).fill(0), n = new Array(9).fill(0);
+    const TX = 16, TY = 9;
+    for (let ty = 0; ty < TY; ty++)
+        for (let tx = 0; tx < TX; tx++) {
+            let lo = 255, hi = 0;
+            for (let y = Math.floor((ty * p.height) / TY); y < Math.floor(((ty + 1) * p.height) / TY); y++)
+                for (let x = Math.floor((tx * p.width) / TX); x < Math.floor(((tx + 1) * p.width) / TX); x++) {
+                    const i = (y * p.width + x) * 4, v = 0.299 * p.data[i] + 0.587 * p.data[i + 1] + 0.114 * p.data[i + 2];
+                    lo = Math.min(lo, v);
+                    hi = Math.max(hi, v);
+                }
+            const r = Math.min(2, Math.floor((ty * 3) / TY)) * 3 + Math.min(2, Math.floor((tx * 3) / TX));
+            n[r]++;
+            if (hi - lo > spread)
+                out[r]++;
+        }
+    return out.map((v, i) => (n[i] ? v / n[i] : 0));
+}
+export function densityMoves(capture, target) {
+    const c = busyThirds(capture), t = busyThirds(target);
+    const bare = REGION.filter((_, i) => t[i] - c[i] >= 0.35), busy = REGION.filter((_, i) => c[i] - t[i] >= 0.35);
+    const out = [];
+    const pct = (xs) => Math.round((xs.reduce((a, b) => a + b, 0) / xs.length) * 100);
+    if (bare.length)
+        out.push({ param: 'dressing', from: `${pct(c)}% of the frame with detail`, to: `${pct(t)}%`, closes: 'density', why: `the target carries detail where the capture is bare: ${bare.join(', ')} — props, texture or set dressing there` });
+    if (busy.length)
+        out.push({ param: 'dressing', from: busy.join(', '), to: 'quieter', closes: 'density', why: `the capture is busy where the target rests: ${busy.join(', ')}` });
+    return out;
+}
+export function fixesFor(o) {
+    const all = [...(o.delta ? cameraMoves(o.delta, o.cam) : []), ...lookMoves(o.capture, o.target, o.cam), ...densityMoves(o.capture, o.target)];
+    const rank = (m) => (o.gaps.includes(m.closes) ? 0 : 1);
+    return all.map((m, i) => ({ m, i })).sort((a, b) => rank(a.m) - rank(b.m) || a.i - b.i).map((x) => x.m);
+}
+export const moveLine = (m) => `${m.param} ${m.from} → ${m.to} — ${m.why}`;
+export { lab };

package/dist/direct/read.js

@@ -0,0 +1,59 @@
+export const READ_CAMERA_JS = `(() => { try {
+  const W = window, out = (o) => JSON.stringify(o);
+  if (typeof W.__FPX_CAMERA__ === 'function') { const c = W.__FPX_CAMERA__(); if (c && typeof c === 'object') return out(c); }
+  const cam = W.__THREEJS_CAMERA__ || (W.camera && W.camera.isPerspectiveCamera ? W.camera : null);
+  if (cam && cam.isPerspectiveCamera) {
+    cam.updateMatrixWorld && cam.updateMatrixWorld();
+    const p = cam.getWorldPosition ? cam.getWorldPosition(new cam.position.constructor()) : cam.position;
+    const d = cam.getWorldDirection ? cam.getWorldDirection(new cam.position.constructor()) : null;
+    let hy = 0;
+    const scene = W.__THREEJS_SCENE__;
+    const hero = scene && scene.getObjectByName ? scene.getObjectByName('player') : null;
+    if (hero && hero.getWorldPosition) hy = hero.getWorldPosition(new cam.position.constructor()).y + 1;
+    let t = null;
+    if (d) { const k = Math.abs(d.y) > 1e-3 ? (hy - p.y) / d.y : -1; const s = k > 0.5 && k < 200 ? k : 10; t = [p.x + d.x * s, p.y + d.y * s, p.z + d.z * s]; }
+    const r = W.__THREEJS_RENDERER__;
+    // Room behind and above the eye, when the page offers three.js to cast with: a pull-back never leaves the room.
+    let room = null;
+    try { const T3 = W.THREE; if (T3 && scene && d) { const rc = new T3.Raycaster(); const free = (dir) => { rc.set(p, dir); rc.far = 200; const hit = rc.intersectObjects(scene.children, true).find((h) => h.object && h.object.isMesh && h.object.visible); return hit ? hit.distance : null; };
+      // Behind: the frustum's centre and its four edges cast backwards, each hit projected on the view axis (a wall with a
+      // doorway on the axis still frames the shot, so the centre ray alone overstates the room; one game's vestibule).
+      const back = d.clone().negate(), up = new T3.Vector3(0, 1, 0), right = new T3.Vector3().crossVectors(d, up).normalize(), up2 = new T3.Vector3().crossVectors(right, d).normalize();
+      const tv = Math.tan(cam.fov * Math.PI / 360), th = tv * (cam.aspect || 1.78);
+      let behind = null;
+      for (const [a, b] of [[0, 0], [th, 0], [-th, 0], [0, tv], [0, -tv]]) { const e = back.clone().addScaledVector(right, a).addScaledVector(up2, b).normalize(); const h = free(e); if (h !== null) { const along = h * e.dot(back); behind = behind === null ? along : Math.min(behind, along); } }
+      room = { behind, above: free(up) }; } } catch (e) { room = null; }
+    return out({ kind: '3d', source: 'the three.js camera', room, position: [p.x, p.y, p.z], target: t, fov: cam.fov / (cam.zoom || 1) === cam.fov ? cam.fov : 2 * Math.atan(Math.tan(cam.fov * Math.PI / 360) / (cam.zoom || 1)) * 180 / Math.PI, aspect: cam.aspect, exposure: r && typeof r.toneMappingExposure === 'number' ? r.toneMappingExposure : null });
+  }
+  const app = W.__PIXI_APP__;
+  if (app && app.stage) {
+    const kids = app.stage.children || [];
+    const world = kids.find((c) => c.label === 'world' || c.name === 'world') || kids[0];
+    if (world) return out({ kind: '2d', source: 'the world container (' + (world.label || world.name || 'stage child 0') + ')', zoom: world.scale ? world.scale.x : 1, offset: [world.position ? world.position.x : 0, world.position ? world.position.y : 0], viewport: [innerWidth, innerHeight] });
+  }
+  return null;
+} catch (e) { return null; } })()`;
+export function parseCamera(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    let c;
+    try {
+        c = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!c || (c.kind !== '3d' && c.kind !== '2d'))
+        return null;
+    const v3 = (x) => (Array.isArray(x) && x.length === 3 && x.every((n) => Number.isFinite(n)) ? [x[0], x[1], x[2]] : undefined);
+    const num = (x) => (Number.isFinite(x) ? Number(x) : undefined);
+    const sp = c.shotParams && typeof c.shotParams === 'object' && [c.shotParams.distance, c.shotParams.height, c.shotParams.fov].every(Number.isFinite)
+        ? { distance: c.shotParams.distance, height: c.shotParams.height, fov: c.shotParams.fov, ...(Number.isFinite(c.shotParams.lookHeight) ? { lookHeight: c.shotParams.lookHeight } : {}), ...(Number.isFinite(c.shotParams.yaw) ? { yaw: c.shotParams.yaw } : {}) }
+        : null;
+    const read = { kind: c.kind, source: typeof c.source === 'string' ? c.source : c.kind === '3d' ? 'the camera' : 'the world', shot: typeof c.shot === 'string' ? c.shot : null, position: v3(c.position), target: v3(c.target), fov: num(c.fov), aspect: num(c.aspect), shotParams: sp, zoom: num(c.zoom), offset: Array.isArray(c.offset) && c.offset.length === 2 ? [Number(c.offset[0]), Number(c.offset[1])] : undefined, viewport: Array.isArray(c.viewport) && c.viewport.length === 2 ? [Number(c.viewport[0]), Number(c.viewport[1])] : undefined, exposure: num(c.exposure) ?? null, room: c.room && typeof c.room === 'object' ? { behind: num(c.room.behind) ?? null, above: num(c.room.above) ?? null } : null };
+    if (read.kind === '3d' && read.fov === undefined && !sp)
+        return null;
+    if (read.kind === '2d' && read.zoom === undefined)
+        return null;
+    return read;
+}

package/dist/direct/round.js

@@ -0,0 +1,80 @@
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export const SCORES_PATH = join('design', 'look', 'scores.json');
+export const HISTORY_PATH = join('design', 'look', 'score-history.jsonl');
+export const BAR_DEFAULT = 75;
+export const STRETCH_DEFAULT = 90;
+export const GAIN_MIN = 1;
+export const FLAT_ROUNDS = 3;
+const readJson = (p) => { try {
+    return JSON.parse(readFileSync(p, 'utf8'));
+}
+catch {
+    return null;
+} };
+export function appendHistory(root, record) {
+    if (!record || !Array.isArray(record.moments))
+        return;
+    const line = {
+        at: record.at ?? new Date().toISOString(), viewport: record.viewport ?? null, bar: record.bar ?? BAR_DEFAULT,
+        moments: record.moments.filter((m) => typeof m?.score === 'number').map((m) => ({ moment: m.moment, score: m.score, axes: Object.fromEntries(Object.entries(m.axes ?? {}).map(([k, v]) => [k, v?.score ?? null])), fixes: (m.fixes ?? []).slice(0, 6) })),
+    };
+    if (!line.moments.length)
+        return;
+    const p = join(root, HISTORY_PATH);
+    try {
+        mkdirSync(dirname(p), { recursive: true });
+        appendFileSync(p, JSON.stringify(line) + '\n');
+    }
+    catch { }
+}
+export function readHistory(root) {
+    let text = '';
+    try {
+        text = readFileSync(join(root, HISTORY_PATH), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    return text.split('\n').filter(Boolean).map((l) => { try {
+        return JSON.parse(l);
+    }
+    catch {
+        return null;
+    } }).filter((l) => !!l && Array.isArray(l.moments));
+}
+export function meanScore(record) {
+    const s = (record?.moments ?? []).map((m) => m?.score).filter((n) => typeof n === 'number');
+    return s.length ? Math.round(s.reduce((a, b) => a + b, 0) / s.length) : null;
+}
+export function fixList(root, raw = readJson(join(root, SCORES_PATH))) {
+    const bar = typeof raw?.bar === 'number' ? raw.bar : BAR_DEFAULT, stretch = typeof raw?.stretch === 'number' ? raw.stretch : STRETCH_DEFAULT;
+    const list = Array.isArray(raw?.moments) ? raw.moments : [];
+    const scored = list.filter((m) => typeof m?.score === 'number');
+    const below = scored.filter((m) => m.score < bar).sort((a, b) => a.score - b.score).map((m) => ({
+        moment: String(m.moment), score: m.score, bar, stretch, gaps: Array.isArray(m.gaps) ? m.gaps : [], source: m.camera_read?.source ?? null,
+        fixes: Array.isArray(m.fixes) && m.fixes.length ? m.fixes : (m.camera?.moves ?? []).map((w) => ({ param: 'camera', from: '', to: '', closes: 'composition', why: w })),
+    }));
+    return { at: raw?.at ?? null, bar, stretch, mean: meanScore(raw), below, atBar: scored.filter((m) => m.score >= bar).map((m) => `${m.moment} ${m.score}`) };
+}
+export const fixLine = (f) => (f.from === '' && f.to === '' ? f.why : `${f.param} ${f.from} → ${f.to} — ${f.why}`);
+export function fixSummary(fl, n = 3) {
+    const m = fl.below[0];
+    if (!m)
+        return null;
+    const moves = m.fixes.slice(0, n).map(fixLine);
+    return `${m.moment} ${m.score}/${m.bar}${fl.below.length > 1 ? ` (+${fl.below.length - 1} more under the bar)` : ''}: ${moves.length ? moves.join('; ') : `no move printed (gaps: ${m.gaps.join(', ') || 'none named'})`}`;
+}
+export function flatRounds(rounds, stage) {
+    const scored = rounds.filter((r) => r.stage === stage && r.closed_at && typeof r.accuracy === 'number');
+    let flat = 0;
+    for (let i = scored.length - 1; i >= 0; i--) {
+        const best = Math.max(-Infinity, ...scored.slice(0, i).map((r) => r.accuracy));
+        if (i > 0 && scored[i].accuracy >= best + GAIN_MIN)
+            break;
+        if (i === 0)
+            break;
+        flat++;
+    }
+    return flat;
+}