@volter/cyclotron 0.5.201 → 0.5.203

package/dist/assets/volter-sdk-widgets-primitives-EditorIcon-BBWNM0Qo.js

@@ -1 +0,0 @@
-import{dO as s,bO as c,pr as e}from"./volter-sdk-CjkJnQ6d.js";export{s as DisclosureIcon,c as EditorIcon,e as TreeDisclosureIcon};

package/dist/assets/volter-sdk-widgets-primitives-FormControls-BWxUJrgm.js

@@ -1 +0,0 @@
-import{C as e,pf as t,pg as s,ph as n,jp as o,pi as x,cx as c}from"./volter-sdk-CjkJnQ6d.js";export{e as Checkbox,t as ColorSwatchInput,s as FileInput,n as RangeInput,o as Select,x as TextArea,c as TextInput};

package/dist/assets/volter-sdk-widgets-primitives-HoverPreview-DWhR7NPO.js

@@ -1 +0,0 @@
-import{ps as o}from"./volter-sdk-CjkJnQ6d.js";export{o as HoverPreview};

package/dist/assets/volter-sdk-widgets-primitives-JsonInput-DT-JU62m.js

@@ -1 +0,0 @@
-import{pt as t}from"./volter-sdk-CjkJnQ6d.js";export{t as JsonInput};

package/dist/assets/volter-sdk-widgets-primitives-Layout-DdGxhqhS.js

@@ -1 +0,0 @@
-import{od as s,oe as e,k4 as i,of as r,k3 as c}from"./volter-sdk-CjkJnQ6d.js";export{s as Actions,e as Divider,i as Inline,r as Spacer,c as Stack};

package/dist/assets/volter-sdk-widgets-primitives-Menu-DZZRIImg.js

@@ -1 +0,0 @@
-import{dM as r,dN as s,ik as u,il as M,ow as n}from"./volter-sdk-CjkJnQ6d.js";export{r as Menu,s as MenuItem,u as MenuSeparator,M as MenuTrigger,n as focusFirstMenuItem};

package/dist/assets/volter-sdk-widgets-primitives-NumberInput-BhCoXeub.js

@@ -1 +0,0 @@
-import{kK as m}from"./volter-sdk-CjkJnQ6d.js";export{m as NumberInput};

package/dist/assets/volter-sdk-widgets-primitives-Panel-CBt-GWg4.js

@@ -1 +0,0 @@
-import{dp as o}from"./volter-sdk-CjkJnQ6d.js";export{o as Panel};

package/dist/assets/volter-sdk-widgets-primitives-SectionHeader-zNqJ43pZ.js

@@ -1 +0,0 @@
-import{px as r}from"./volter-sdk-CjkJnQ6d.js";export{r as SectionHeader};

package/dist/assets/volter-sdk-widgets-primitives-Text-D5kMrfFl.js

@@ -1 +0,0 @@
-import{og as o,T as p}from"./volter-sdk-CjkJnQ6d.js";export{o as Keycap,p as Text};

package/dist/assets/volter-sdk-widgets-primitives-ThemeRootPortal-C3qNx2NP.js

@@ -1 +0,0 @@
-import{dL as r}from"./volter-sdk-CjkJnQ6d.js";export{r as ThemeRootPortal};

package/dist/assets/volter-sdk-widgets-primitives-Tooltip-BZa_2pgU.js

@@ -1 +0,0 @@
-import{eE as p}from"./volter-sdk-CjkJnQ6d.js";export{p as Tooltip};

package/dist/assets/volter-sdk-widgets-primitives-Vec3Input-DHMZkNZm.js

@@ -1 +0,0 @@
-import{py as o}from"./volter-sdk-CjkJnQ6d.js";export{o as Vec3Input};

package/dist/assets/volter-sdk-widgets-primitives-banner-tones-B0Vu5nrN.js

@@ -1 +0,0 @@
-import{pb as p,pc as E}from"./volter-sdk-CjkJnQ6d.js";export{p as TONE_ERROR,E as TONE_WARNING};

package/dist/assets/volter-sdk-widgets-primitives-clamp-to-viewport-gPoKdjpr.js

@@ -1 +0,0 @@
-import{dw as p}from"./volter-sdk-CjkJnQ6d.js";export{p as clampRectToViewport};

package/dist/assets/volter-sdk-widgets-primitives-editor-icons-CzOo1YYK.js

@@ -1 +0,0 @@
-import{ew as r}from"./volter-sdk-CjkJnQ6d.js";export{r as editorIcons};

package/dist/assets/volter-sdk-widgets-primitives-panel-header-styles-L08FUXCP.js

@@ -1 +0,0 @@
-import{pu as l,pv as p,pw as r}from"./volter-sdk-CjkJnQ6d.js";export{l as panelHeaderLabelStyle,p as panelHeaderStyle,r as sectionHeaderLabelStyle};

package/dist/assets/volter-sdk-widgets-theme-3FhMTQQW.js

@@ -1 +0,0 @@
-import{ox as e,oy as o,l3 as i,oz as t,oA as r,oB as d,oC as n,oD as h,oE as E,oF as c,du as m,oG as l,oH as p,oI as T,oJ as g,oK as u,oL as S,oM as M,oN as D,oO as R,ip as V,oP as _,oQ as z,dY as O,oR as f,oS as A,oT as G,l4 as I,oU as H,oV as L,oW as N,oX as b,dQ as k,oY as w,oZ as x,o_ as y,o$ as C,p0 as W,eL as Y,p1 as q,p2 as B,p3 as F,p4 as Q,cz as X,cr as J,p5 as K,p6 as P,p7 as U,dX as Z,t as $,p8 as j,p9 as v,pa as aa,cd as sa}from"./volter-sdk-CjkJnQ6d.js";export{e as EDITOR_CATEGORY_NAMES,o as EDITOR_REGION_NAMES,i as EDITOR_THEME_CLASS,t as STAGE_WORD_MODES,r as accent,d as accentMuted,n as applyEditorTheme,h as areaEmbossValue,E as bg,c as border,m as chromeSize,l as controlSize,p as danger,T as dangerFaint,g as dangerMuted,u as dynamic,S as dynamicBg,M as editorThemeVariables,D as editorThemes,R as focusRing,V as fontMono,_ as fontSans,z as fontSize,O as fontSizeVar,f as fontWeight,A as glassDarkEditorTheme,G as glassDarkLiteEditorTheme,I as graphiteDarkEditorTheme,H as graphiteNeutralEditorTheme,L as iconSize,N as isEditorThemeId,b as lineHeight,k as lineHeightVar,w as liquidGlassEditorTheme,x as liquidGlassLiteEditorTheme,y as midnightHighContrastEditorTheme,C as motion,W as motionVar,Y as radius,q as regionRowAltValue,B as scrim,F as selection,Q as shadow,X as space,J as spaceVar,K as strokeWidth,P as success,U as successMuted,Z as text,$ as themeVars,j as usesGlassMaterial,v as warn,aa as warnMuted,sa as zIndex};

package/dist/assets/volter-sdk-widgets-z-index-BY332K7Z.js

@@ -1 +0,0 @@
-import{cd as o}from"./volter-sdk-CjkJnQ6d.js";export{o as zIndex};

package/dist/assets/volter-shared-fontawesome-DpCdukGW.js

@@ -1 +0,0 @@
-import{_ as o}from"./volter-sdk-CjkJnQ6d.js";const e=o,t=e.FontAwesomeIcon,n=e.FontAwesomeLayers,r=e.LayersCounter,a=e.LayersText;export{t as FontAwesomeIcon,n as FontAwesomeLayers,r as LayersCounter,a as LayersText,e as default};

package/dist/assets/volter-shared-jsx-dev-runtime-Dzhuy0jr.js

@@ -1 +0,0 @@
-import{j as t}from"./volter-sdk-CjkJnQ6d.js";function j(e,n,s,r){return r?t.jsxs(e,n,s):t.jsx(e,n,s)}const a=Object.freeze(Object.defineProperty({__proto__:null,Fragment:t.Fragment,jsxDEV:j},Symbol.toStringTag,{value:"Module"})),o=a,x=o.Fragment,_=o.jsxDEV;export{x as Fragment,o as default,_ as jsxDEV};

package/dist/assets/volter-shared-jsx-runtime-CZf-NxSP.js

@@ -1 +0,0 @@
-import{e as t,f as n}from"./volter-sdk-CjkJnQ6d.js";const s=t??n,a=s.Fragment,e=s.jsx,m=s.jsxs;export{a as Fragment,s as default,e as jsx,m as jsxs};

package/dist/assets/volter-shared-react-B8I974G-.js

@@ -1 +0,0 @@
-import{R as t,a as s}from"./volter-sdk-CjkJnQ6d.js";const e=t??s,c=e.Activity,o=e.Children,a=e.Component,u=e.Fragment,r=e.Profiler,i=e.PureComponent,E=e.StrictMode,_=e.Suspense,l=e.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,f=e.__COMPILER_RUNTIME,R=e.cache,m=e.cacheSignal,S=e.cloneElement,C=e.createContext,d=e.createElement,N=e.createRef,T=e.forwardRef,I=e.isValidElement,p=e.lazy,A=e.memo,O=e.startTransition,h=e.unstable_useCacheRefresh,v=e.use,y=e.useActionState,D=e.useCallback,L=e.useContext,M=e.useDebugValue,P=e.useDeferredValue,U=e.useEffect,x=e.useEffectEvent,b=e.useId,g=e.useImperativeHandle,V=e.useInsertionEffect,H=e.useLayoutEffect,k=e.useMemo,w=e.useOptimistic,z=e.useReducer,F=e.useRef,G=e.useState,W=e.useSyncExternalStore,Y=e.useTransition,$=e.version;export{c as Activity,o as Children,a as Component,u as Fragment,r as Profiler,i as PureComponent,E as StrictMode,_ as Suspense,l as __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,f as __COMPILER_RUNTIME,R as cache,m as cacheSignal,S as cloneElement,C as createContext,d as createElement,N as createRef,e as default,T as forwardRef,I as isValidElement,p as lazy,A as memo,O as startTransition,h as unstable_useCacheRefresh,v as use,y as useActionState,D as useCallback,L as useContext,M as useDebugValue,P as useDeferredValue,U as useEffect,x as useEffectEvent,b as useId,g as useImperativeHandle,V as useInsertionEffect,H as useLayoutEffect,k as useMemo,w as useOptimistic,z as useReducer,F as useRef,G as useState,W as useSyncExternalStore,Y as useTransition,$ as version};

package/dist/assets/volter-shared-react-dom-BSKZma7T.js

@@ -1 +0,0 @@
-import{i as t,b as o}from"./volter-sdk-CjkJnQ6d.js";const e=t??o,n=e.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,_=e.createPortal,r=e.flushSync,c=e.preconnect,a=e.prefetchDNS,u=e.preinit,p=e.preinitModule,S=e.preload,l=e.preloadModule,d=e.requestFormReset,N=e.unstable_batchedUpdates,i=e.useFormState,R=e.useFormStatus,E=e.version;export{n as __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,_ as createPortal,e as default,r as flushSync,c as preconnect,a as prefetchDNS,u as preinit,p as preinitModule,S as preload,l as preloadModule,d as requestFormReset,N as unstable_batchedUpdates,i as useFormState,R as useFormStatus,E as version};

package/dist/assets/volter-shared-react-dom-client-aO0ss-5e.js

@@ -1 +0,0 @@
-import{c as t,d as e}from"./volter-sdk-CjkJnQ6d.js";const o=t??e,r=o.createRoot,a=o.hydrateRoot,c=o.version;export{r as createRoot,o as default,a as hydrateRoot,c as version};

package/dist/assets/worker-C7WcdPfy.js

@@ -1,8 +0,0 @@
-let ce=0;class de{constructor(t){this.work=t,this.job=++ce,this.started=!1,this.finished=!1,this.sequence=0,this.expected=null,this.resume=null,this.waiter=null,this.ended=null}step(t){if(this.ended&&!this.waiter&&t===this.expected){const r=this.ended;return this.ended=null,this.expected=null,this.resume=null,"error"in r?Promise.reject(r.error):Promise.resolve({load:"done",value:r.value})}if(this.finished||this.waiter||(this.started?t!==this.expected||!this.resume:t!==void 0))return Promise.reject(new Error("Invalid or replayed load continuation"));const n=new Promise((r,s)=>{this.waiter={resolve:r,reject:s}});if(!this.started)this.started=!0,Promise.resolve().then(()=>this.work(r=>new Promise(s=>{this.resume=s,this.expected=`load:${this.job}:${++this.sequence}`;const o=this.waiter;this.waiter=null,o.resolve({load:"continue",token:this.expected,phase:r})}))).then(r=>{this.finished=!0;const s=this.waiter;this.waiter=null,s?s.resolve({load:"done",value:r}):this.ended={value:r}},r=>{this.finished=!0;const s=this.waiter;this.waiter=null,s?s.reject(r):(this.ended={error:r},console.warn("A Blender load failed between steps; the next step reports it:",r))});else{const r=this.resume;this.resume=null,this.expected=null,r()}return n}}function le(e,t){const n=e.getReader();let r,s=0;return new ReadableStream({async pull(o){try{if(!r||s===r.length){const a=await n.read();if(a.done){n.releaseLock(),o.close();return}r=a.value,s=0}await t();const i=Math.min(r.length,s+1024*1024);o.enqueue(r.subarray(s,i)),s=i}catch(i){await n.cancel(i).catch(()=>{}),o.error(i)}},async cancel(o){await n.cancel(o),n.releaseLock()}},{highWaterMark:0})}const V=1024*1024,fe={Uint8Array,Int8Array,Uint16Array,Int16Array,Uint32Array,Int32Array,Float32Array,Float64Array},ue=async e=>Array.from(new Uint8Array(await crypto.subtle.digest("SHA-256",e)),t=>t.toString(16).padStart(2,"0")).join("");async function he(e,t){const n=[],r=JSON.stringify(e,(s,o)=>{if(!ArrayBuffer.isView(o))return o;const i=o.constructor.name;if(!Object.hasOwn(fe,i))throw new Error(`Unsupported frame column ${i}`);return n.push(new Uint8Array(o.buffer,o.byteOffset,o.byteLength)),{$frameColumn:n.length,type:i}});n.unshift(new TextEncoder().encode(r)),await t({kind:"begin",lengths:n.map(s=>s.byteLength)});for(const[s,o]of n.entries())for(let i=0;i<o.byteLength;i+=V){const a=o.slice(i,i+V),c=await ue(a);await t({kind:"bytes",slot:s,offset:i,bytes:a,sha256:c})}return t({kind:"end"})}function A(e,t=!0){if(e instanceof Error)return(t?e.stack:void 0)??`${e.name}: ${e.message}`;if(typeof e=="object"&&e!==null){const n=e;if(typeof n.message=="string")return typeof n.name=="string"?`${n.name}: ${n.message}`:n.message;try{return JSON.stringify(e)??Object.prototype.toString.call(e)}catch{return Object.prototype.toString.call(e)}}return String(e)}const p="/work/.volter-session",Je=`${p}/session.py`,De=[`${p}/in`,`${p}/reply`],q="/__editor/blender-wasm";function We(e){return e.startsWith("@@VOLTER-ERROR")?"error":e.startsWith("@@VOLTER-WARN")?"warn":"log"}function we(e){return new URL(`${q}/${e}`,import.meta.url).href}async function T(e,t,n){try{return await n()}catch(r){const s=A(r,!1);throw new Error(`Blender startup ${t} (${e}): ${s}`,{cause:r})}}async function pe(){const e=we("status"),t=await T(e,"fetch status",()=>fetch(e));return t.ok?T(e,"decode status JSON",()=>t.json()):{available:!1,skew:null,dir:null,sizes:{},encoded:{},missing:[`${q}/status answered ${t.status}`]}}async function ye(e){const t=await pe();if(await e.ask({checkpoint:"artifact-status"}),!t.available)throw new Error(`The headless Blender WebAssembly build is not served by this editor: ${t.missing.join("; ")}`);if(t.skew==="wali"){const{startWaliBlenderEngine:r}=await T(import.meta.url,"import WALI engine module from",()=>import("./blender-wali-engine-x-OfFUGX.js"));return r(e,t)}const{startEmscriptenBlenderEngine:n}=await T(import.meta.url,"import Emscripten engine module from",()=>import("./blender-emscripten-engine-DnJ85_-l.js"));return n(e,t)}function me(e){return e<200?1:e<5e3?5:25}const ge=e=>new Promise(t=>setTimeout(t,e)),K=new TextDecoder;function He(e,t,n){let r=0,s=0;const o=new Set;async function i(l){for(const d of o)l.has(`${d}.done`)||(await e.unlink(`${p}/reply/${d}.json`),await e.unlink(`${p}/reply/${d}.done`),o.delete(d))}async function a(){let l;try{l=await e.readdir(`${p}/ask`)}catch{return!1}const d=new Set(l.filter(h=>h.endsWith(".done")));await i(d);let f=!1;for(const h of d){const y=h.slice(0,-5);if(Number(y)<=s)continue;s=Number(y);const u=JSON.parse(K.decode(await e.readFile(`${p}/ask/${y}.json`)));let w;try{w=await t.ask(u)}catch(v){w={error:v instanceof Error?v.message:String(v)}}await Promise.all([e.writeFile(`${p}/reply/${y}.json`,JSON.stringify(w??null)),e.writeFile(`${p}/reply/${y}.done`,"1")]),o.add(y),f=!0}return f}async function c(l){const d=String(++r);await Promise.all([e.writeFile(`${p}/in/${d}.json`,JSON.stringify(l)),e.writeFile(`${p}/in/${d}.done`,"1")]);let f=performance.now();for(;;){if(await a()&&(f=performance.now()),await e.stat(`${p}/out/${d}.done`)){const u=JSON.parse(K.decode(await e.readFile(`${p}/out/${d}.json`)));if(await e.unlink(`${p}/in/${d}.json`),await e.unlink(`${p}/in/${d}.done`),u.error)throw new Error(u.error);return u.result}const h=n?.();if(h)throw new Error(`Blender is gone, so this call will never be answered: ${h}. The session keeps its directory and its cached banner, so every later call would wait on the same missing answer; start a new program with \`blender-start {fresh: true}\` (\`VOLTER_BLENDER_FRESH_SESSION=1\` for the battery harness).`);const y=me(performance.now()-f);await(e.changed?e.changed(y):ge(y))}}return{request:c}}const be=256*1024,$e=4*1024*1024,ve=(1<<20)-1,Ee=(()=>{const e=new Uint32Array(256);let t=2654435769;for(let n=0;n<256;n+=1)t^=t<<13,t^=t>>>17,t^=t<<5,e[n]=t>>>0;return e})();function Se(e){const t=[];let n=0;for(;n<e.length;){const r=Math.min(e.length,n+$e);let s=r,o=0;for(let i=n+Math.min(be,r-n);i<r;i+=1)if(o=(o<<1)+Ee[e[i]]>>>0,(o&ve)===0){s=i+1;break}t.push(s),n=s}return t}async function ke(e){const t=[];let n=0;for(const r of Se(e)){const s=new Uint8Array(await crypto.subtle.digest("SHA-256",e.slice(n,r)));t.push({hash:Array.from(s,o=>o.toString(16).padStart(2,"0")).join(""),start:n,end:r}),n=r}return t}const R=e=>typeof e=="object"&&e!==null&&typeof e.offset=="number"&&typeof e.length=="number"&&typeof e.dtype=="string"&&typeof e.count=="number"&&typeof e.stride=="number",je={f32:e=>new Float32Array(e.buffer,e.byteOffset,e.byteLength>>2),f64:e=>new Float64Array(e.buffer,e.byteOffset,e.byteLength>>3),u32:e=>new Uint32Array(e.buffer,e.byteOffset,e.byteLength>>2),i32:e=>new Int32Array(e.buffer,e.byteOffset,e.byteLength>>2),u16:e=>new Uint16Array(e.buffer,e.byteOffset,e.byteLength>>1),i16:e=>new Int16Array(e.buffer,e.byteOffset,e.byteLength>>1),u8:e=>e,i8:e=>new Int8Array(e.buffer,e.byteOffset,e.byteLength)};function Ae(e,t,n){const r=je[n.dtype];if(!r)throw new Error(`Blender frame column ${t}: unknown dtype ${n.dtype}`);const{offset:s,length:o}=n;if(s<0||o<0||s+o>e.byteLength)throw new Error(`Blender frame column ${t}: bytes ${s}..${s+o} lie outside the ${e.byteLength}-byte export arena`);const i=e.subarray(s,s+o).slice(),a=r(i),c=n.count*n.stride;if(a.length!==c)throw new Error(`Blender frame column ${t}: ${a.length} values, ${c} declared (${n.count} x ${n.stride})`);return a}function I(e,t){const n=(r,s)=>{if(R(r))return Ae(e,s,r);if(Array.isArray(r))return r.map(o=>n(o,s));if(typeof r=="object"&&r!==null){const o={};for(const[i,a]of Object.entries(r))o[i]=n(a,i);return o}return r};return n(t,"")}async function _(e,t){const n=async(r,s)=>{if(R(r)){const{offset:o,length:i,dtype:a}=r;if(o<0||i<0||o+i>e.byteLength)throw new Error(`Blender frame column ${s}: bytes ${o}..${o+i} lie outside the ${e.byteLength}-byte export arena`);const c=e.subarray(o,o+i).slice(),l=await crypto.subtle.digest("SHA-256",c),d=[...new Uint8Array(l)].map(f=>f.toString(16).padStart(2,"0")).join("");return{dtype:a,length:i,sha256:d}}if(Array.isArray(r))return Promise.all(r.map(o=>n(o,s)));if(typeof r=="object"&&r!==null){const o={};for(const[i,a]of Object.entries(r))o[i]=await n(a,i);return o}return r};return n(t,"")}const k=e=>self.postMessage(e),O=(e,t)=>k({op:"log",level:e,text:t});let S=null,U=null,Te=0;const N=new Map;async function F(e){return await he(e,async t=>{const n=e;await g?.(`frame-transfer/${n.op??"unknown"}/${n.mesh!==void 0?"mesh":n.image!==void 0?"image":"manifest"}/${t.kind}`);const r=++Te;return new Promise((s,o)=>{N.set(r,{resolve:s,reject:o});try{self.postMessage({op:"frame-stream",id:r,chunk:t},t.kind==="bytes"?[t.bytes.buffer]:[])}catch(i){N.delete(r),o(i)}})})}function Oe(e,t,n){return F({op:"present",frame:e,description:t,...n?{capture:n}:{}})}let m=null,x=null,g=null,P=null,J=!1,G=Promise.resolve();function Be(e){const t=G.then(e);return G=t.catch(()=>{}),t}let b=null;async function xe(e,t){const n=new Map,r=async(s,o)=>{if(R(s)){n.set(s.offset,{typed:I(e,{[o]:s})[o],description:await _(e,s)});return}if(Array.isArray(s))for(const i of s)await r(i,o);else if(typeof s=="object"&&s!==null)for(const[i,a]of Object.entries(s))await r(a,i)};return await r(t,""),n}function Pe(e,t){const n=r=>{const s=(o,i)=>{if(R(o)){const c=e.columns.get(o.offset);if(!c)throw new Error(`Blender frame column ${i.join(".")}: not in the held frame`);return c[r]}if(Array.isArray(o))return o.map(c=>s(c,i));if(typeof o!="object"||o===null)return o;if(o.deferred===!0){const[c,l]=i.slice(-2),d=(c==="meshes"?e.meshes:e.images).get(l);if(!d)throw new Error(`Blender frame ${c} ${l}: deferred and never pulled`);return d[r]}const a={};for(const[c,l]of Object.entries(o)){const d=s(l,[...i,c]);d!==void 0&&(a[c]=d)}return a};return s(t,[])};return{typed:n("typed"),description:n("description")}}function D(e){J=e,k({op:"document-dirty",dirty:e})}async function ee(){if(!m||P===null)return;const e=P,t={};let n=performance.now();const r=a=>{const c=performance.now();t[a]=Math.round(c-n),n=c};let s;try{s=await m.request({op:"save-document"}),r("save")}catch(a){throw new Error(`The Blender document ${e} could not be saved: ${A(a)}`)}if(!s?.saved||typeof s.path!="string")throw new Error(`Blender did not save the document ${e}`);let o;try{o=await m.files.readFile(s.path),r("read")}catch(a){throw new Error(`The Blender document ${e} could not be read back out of the engine: ${A(a)}`)}$.delete(s.path);let i=0;try{const a=await ke(o);r("chunk");const c=`path=${encodeURIComponent(e)}`,l=JSON.stringify({chunks:a.map(({hash:d,start:f,end:h})=>[d,h-f])});for(let d=0;;d+=1){const f=await fetch(`/__editor/blender-document?${c}`,{method:"POST",headers:{"content-type":"application/json"},body:l}),h=await f.json().catch(()=>null);if(r(`manifest${d}`),!f.ok)throw new Error(`HTTP ${f.status} ${h?.error??""}`);if(h?.ok){for(const[u,w]of Object.entries(h.ms??{}))t[`server.${u}`]=w;break}if(d===2||!Array.isArray(h?.missing))throw new Error(`the server still lacks ${h?.missing?.length??"?"} chunks`);const y=new Set(h.missing);for(const u of a){if(!y.delete(u.hash))continue;const w=await fetch(`/__editor/blender-document-chunk?${c}&hash=${u.hash}`,{method:"POST",headers:{"content-type":"application/octet-stream"},body:new Blob([o.subarray(u.start,u.end)])});if(!w.ok)throw new Error(`HTTP ${w.status} ${await w.text().catch(()=>"")}`);i+=u.end-u.start}r(`send${d}`)}}catch(a){throw new Error(`The Blender document ${e} was not written to the project: ${A(a)}`)}D(!1),O("log",`@@VOLTER-DOCUMENT ${JSON.stringify({path:e,bytes:o.length,sent:i,ms:t})}`)}async function Ne(e,t){const n={engine:null},r=await ye({project:e,log:O,ask:async({frame:o,hold:i,mesh:a,image:c,piece:l,present:d,capture:f,saveDue:h,checkpoint:y,evaluation:u})=>{if(typeof y=="string")return await g?.(y),{};if(!n.engine)throw new Error("The Blender session presented before it started");h&&P!==null&&D(!0);const w=await n.engine.readArena();if(i!==void 0){const E=i;return b={...u?{evaluation:u}:{},session:E.session,revision:E.revision,columns:await xe(w,i),meshes:new Map,images:new Map},await F({op:"stage",evaluation:u,session:E.session,revision:E.revision}),{}}if(a!==void 0||c!==void 0){if(!b)throw new Error(`The Blender session sent ${a??c} before its frame`);const E=l?.encodedPath;let j;if(c!==void 0&&typeof E=="string"){const{encodedPath:H,...z}=l,M=(await n.engine.files.readFile(E)).slice(),se=new Uint8Array(await crypto.subtle.digest("SHA-256",M)),ie=Array.from(se,ae=>ae.toString(16).padStart(2,"0")).join("");j={typed:{...z,encoded:M},description:{...z,encoded:{dtype:"u8",length:M.length,sha256:ie}}}}else j={typed:I(w,l),description:await _(w,l)};if(await F({op:"stage",evaluation:b.evaluation,session:b.session,revision:b.revision,...a!==void 0?{mesh:a}:{image:c},piece:j.typed}),a!==void 0){const H=j.typed;b.meshes.set(a,{typed:{revision:H.revision,unchanged:!0},description:j.description})}else b.images.set(c,{typed:void 0,description:j.description});return{}}let v,L;if(d){if(!b)throw new Error("The Blender session presented a frame it never sent");({typed:v,description:L}=Pe(b,o)),b=null}else v=I(w,o),L=await _(w,o);const B=await Oe(v,L,f);return{...typeof B.capture=="object"&&B.capture!==null?B.capture:{},..."held"in B?{held:B.held}:{}}}});if(n.engine=r,await g?.("engine-ready"),m=r,t){const i=(await ne(r.files,e)).find(a=>a.startsWith("The project's files are not readable")||a.startsWith(`${t} `));if(i)throw new Error(`${t} could not be copied into Blender, so it cannot be opened: ${i}`)}await g?.("project-imported");const s=await r.request({op:"start",project:e,...t?{document:t}:{}});return t&&(P=t),S={start:async()=>s,execute:async o=>{const i=await r.request({op:"execute",code:o});return i.error?`Error executing code: ${i.error}`:`Code executed successfully: ${i.result}`},sceneInfo:async()=>JSON.stringify(await r.request({op:"scene-info"}),null,2),objectInfo:async o=>JSON.stringify(await r.request({op:"object-info",name:o}),null,2),screenshotView:async o=>(await r.request({op:"present",capture:{size:o}}),JSON.stringify({view:{size:o}}))},{...s,engine:"blender-wasm",skew:r.skew,bootMs:Math.round(r.bootMs),releasedPayloadMB:r.releasedPayloadBytes===null?null:Math.round(r.releasedPayloadBytes/1048576)}}async function Re(){const e="/__editor/blender-wasm/status";try{const t=await T(e,"fetch initial status",()=>fetch(e));return t.ok?await T(e,"decode initial status JSON",()=>t.json()):{available:!1,missing:[`${e}: HTTP ${t.status}`]}}catch(t){return{available:!1,missing:[String(t)]}}}function W(e){return/^[A-Za-z]:[\\/]/.test(e)?`/${e.replaceAll("\\","/")}`:e}async function Le(e,t){if(S)throw new Error("The Blender session is already started");const n=W(e);if(!n.startsWith("/"))throw new Error("The Blender session needs the project's absolute path");if(t!==void 0&&!te(t))throw new Error(`The Blender document must be a project-relative .blend path with no traversal (models/model.blend); got ${JSON.stringify(t)}`);const r=await Re();if(!r.available)throw new Error(`Headless Blender is not served by this editor, so there is no modeling engine: ${r.missing.join("; ")}. The engine is Blender compiled to WebAssembly (packages/blender-engine/wasm, or the directory VOLTER_BLENDER_WASM_DIR names); nothing stands in for it.`);return U=n,Ne(n,t)}function te(e){return!e.endsWith(".blend")||e.startsWith("/")||e.includes("\\")?!1:e.split("/").every(n=>n!==""&&n!=="."&&n!=="..")}const X=new Set;function C(e){X.has(e)||(X.add(e),O("error",e))}async function Me(e){const t=i=>{const a=`The project's files are not readable from Python: ${i}`;return C(a),a};let n;try{n=await fetch("/__editor/blender-project-index")}catch(i){return t(String(i))}if(!n.ok)return t(`/__editor/blender-project-index answered ${n.status}`);let r;try{if(r=await n.json(),typeof r?.root!="string"||!Array.isArray(r.files))return t("invalid project index")}catch(i){return t(String(i))}const{root:s,files:o}=r;return W(s)!==e&&C(`The editor serving this tab has ${s} open, not ${e}; its files are mounted at ${e}, which is where Python is looking.`),o}const $=new Map;async function Ie(e,t){const n=await e.stat(t);return n?`${n.size}:${n.mtimeMs}`:""}async function ne(e,t){const n=await Me(t);if(typeof n=="string")return[n];const r=[],s=new Set(n.map(o=>`${t}/${o.path}`));for(const o of[...$.keys()])if(!s.has(o)){try{await e.unlink(o)}catch{}$.delete(o)}for(const o of n){const i=`${t}/${o.path}`,a=`${o.size}:${o.mtime}`;if($.get(i)?.host===a||!$.has(i)&&await e.stat(i)!==null)continue;const c=await fetch(`/__editor/blender-project-file?path=${encodeURIComponent(o.path)}`);if(!c.ok){C(`${o.path}: HTTP ${c.status}`),r.push(`${o.path} (the session answered HTTP ${c.status})`);continue}const l=Number(c.headers.get("content-length")),d=c.headers.has("content-length")&&Number.isSafeInteger(l)&&l>=0?l:o.size,f=i.slice(0,i.lastIndexOf("/"));f&&await e.mkdirTree(f),e.writeFileStream&&c.body?await e.writeFileStream(i,g?le(c.body,()=>g("file-import")):c.body,d):await e.writeFile(i,new Uint8Array(await c.arrayBuffer())),$.set(i,{host:a,engine:await Ie(e,i)})}return r}function _e(e){if(!e)return"";if(!e.moved){const n=`Blender now has ${e.outside} open, which is outside the project, so the editor cannot follow it there: this session's document stays ${e.from}, and the model keeps saving to ${e.from}. To move the model to another file, save it inside the project (src/models/<name>.blend).`;return O("warn",n),`
-
-${n}`}if(!te(e.document))throw new Error(`Blender moved its document to ${JSON.stringify(e.document)}, which is not a project .blend path`);P=e.document,D(!0),k({op:"document-moved",from:e.from,document:e.document});const t=`Blender now has ${e.document} open (this code saved or opened it), so the editor follows it: the model saves to ${e.document} from now on, and ${e.from} keeps what it last saved.`;return O("log",`@@VOLTER-DOCUMENT-MOVED ${JSON.stringify({from:e.from,document:e.document})}`),`
-
-${t}`}function Ue(e){return e.length===0?"":`
-
-These project files could not be copied into Blender, so this code did not see their current contents: ${e.join("; ")}`}async function Y(e,t){const n=W(t),r=[];if(await e.stat(n)===null)return r;const s=async o=>{let i;try{i=await e.readdir(o)}catch(a){throw new Error(`Blender's files under ${o} could not be listed, so its outputs there cannot be written back: ${String(a)}`)}for(const a of i){if(a==="."||a==="..")continue;const c=`${o.replace(/\/$/,"")}/${a}`,l=await e.stat(c);if(l){if((l.mode&61440)===16384){await s(c);continue}$.get(c)?.engine!==`${l.size}:${l.mtimeMs}`&&r.push({path:c,size:l.size,mtime:l.mtimeMs})}}};return await s(n),r}function Z(e,t){if(g)throw new Error("The current Blender operation must finish first");return x=new de(async n=>{g=n;const r=performance.now();try{return await t()}finally{g=null,O("log",`@@VOLTER-WORK op=${e} totalMs=${Math.round(performance.now()-r)}`)}}),x.step()}async function re(e){switch(e.op){case"start":{if(x)throw new Error("The Blender load has already started");return Z("start",()=>Le(e.project,e.document))}case"load-next":if(!x)throw new Error("No Blender load to continue");return x.step(e.token);case"present-result":{const r=N.get(e.id);N.delete(e.id),r&&(e.error?r.reject(new Error(e.error)):r.resolve({...e.capture===void 0?{}:{capture:e.capture},..."held"in e?{held:e.held}:{}}));return}}if(g)throw new Error("The Blender load must finish before another command");if(!S||!U||!m)throw new Error("The Blender session has not started");const t=m.files,n=m.request.bind(m);switch(e.op){case"flush-document":return J?(await ee(),{saved:!0}):{saved:!1};case"history-begin":case"history-end":return n({op:e.op});case"history-step":return n({op:"history-step",token:e.token,direction:e.direction});case"execute":{const r=Ue(await ne(t,U)),s=await n({op:"execute",code:e.code,history:e.history??!0,label:e.label??"Blender Python"});return(s.error?`Error executing code: ${s.error}`:`Code executed successfully: ${s.result}`)+r+_e(s.document)}case"present":return Z("present",()=>n({op:"present"}));case"native-preview":return n({op:"native-preview",width:e.width,height:e.height,samples:e.samples,...e.camera===void 0?{}:{camera:e.camera}});case"list-files-snapshot":{const r=await n({op:"document-info"});return{entries:await Y(t,e.path),document:r}}case"scene-info":return S.sceneInfo();case"object-info":return S.objectInfo(e.name);case"rna":return n({op:"rna",path:e.path,...e.names===void 0?{}:{names:e.names}});case"rna-context":return n({op:"rna-context",...e.object===void 0?{}:{object:e.object},...e.collection===void 0?{}:{collection:e.collection}});case"view-shading":return n({op:"view-shading",shading:e.shading});case"rna-set":return n({op:"rna-set",history:e.history!==!1,path:e.path,property:e.property,value:e.value,...e.index===void 0?{}:{index:e.index}});case"outliner":return n({op:"outliner",...e.selected===void 0?{}:{selected:[...e.selected]}});case"node-tree":return n({op:"node-tree",...e.path===void 0?{}:{path:e.path},...e.material===void 0?{}:{material:e.material}});case"uv-layout":return n({op:"uv-layout",...e.object===void 0?{}:{object:e.object},...e.uvLayer===void 0?{}:{uvLayer:e.uvLayer}});case"action-clip":return n({op:"action-clip",...e.object===void 0?{}:{object:e.object},...e.bake===void 0?{}:{bake:e.bake},...e.action===void 0?{}:{action:e.action}});case"outliner-set":return n({op:"outliner-set",path:e.path,column:e.column,value:e.value});case"screenshot-view":return JSON.parse(await S.screenshotView(e.maxSize));case"read-file":return t.readFile(e.path);case"write-file":{const r=e.path.slice(0,e.path.lastIndexOf("/"));r&&await t.mkdirTree(r),await t.writeFile(e.path,e.bytes),$.delete(e.path);return}case"list-files":return Y(t,e.path)}throw new Error(`Unknown Blender worker request ${e.op}`)}function oe(){if(!m)return;const e=m.memoryBytes();e!==null&&k({op:"memory",bytes:e})}self.addEventListener("error",oe);self.onmessage=e=>{const t=e.data;if(t.op==="present-result"){re(t);return}Be(()=>Fe(t))};async function Fe(e){try{const t=await re(e);!g&&J&&await ee(),await Q(),k({id:e.id,result:t})}catch(t){let n=A(t);try{await Q()}catch(r){n+=`
-Unable to deliver Blender history: ${A(r)}`}k({id:e.id,error:n})}oe()}async function Q(){if(g||!m||!S)return;const e=await m.request({op:"history-events"});e.length&&k({op:"history",entries:e})}export{q as A,De as P,p as S,we as a,Je as b,We as c,T as d,le as e,He as o,ge as s};

package/starter/race-state.ts

@@ -1,22 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-/** One race's state, shared by its play script and React DOM root in one mount. */
-export interface RaceState {
-  readonly lap: number;
-  readonly lapTime: number;
-  readonly lastLap: number;
-  readonly speed: number;
-  readonly fps: number;
-  readonly airborne: boolean;
-}
-let state: RaceState = { lap: 1, lapTime: 0, lastLap: 0, speed: 0, fps: 0, airborne: false };
-const listeners = new Set<() => void>();
-export const getRaceState = (): RaceState => state;
-export const subscribeRaceState = (listener: () => void): (() => void) => {
-  listeners.add(listener);
-  return () => { listeners.delete(listener); };
-};
-export function publishRaceState(next: RaceState): void {
-  state = next;
-  for (const listener of [...listeners]) listener();
-}

package/starter/track.play.ts

@@ -1,343 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-
-/** Drive the detached Cube. All positions under root are Blender's metres, Z up. */
-import * as THREE from 'three';
-import { publishRaceState } from './race-state';
-
-export default function play(context: {
-  readonly root: THREE.Object3D;
-  find(name: string): THREE.Object3D | null;
-  readonly camera: THREE.Camera;
-  readonly keys: ReadonlySet<string>;
-  /** Offers the bot the Game panel's Autoplay switches on; absent outside the editor. */
-  autoplay?(controller: (input: { readonly tick: number }) => Iterable<string>): void;
-}) {
-  const { root, find, keys } = context;
-  const car = find('Cube');
-  if (!car || !find('Track')) throw new Error('Open track.blend and run track.py first.');
-  const startPosition = car.position.clone();
-  const startHeading = car.rotation.z;
-  const wheels = ['Wheel.FL', 'Wheel.FR', 'Wheel.RL', 'Wheel.RR'].map((name) => {
-    const wheel = find(name);
-    if (!wheel) throw new Error(`The track model has no ${name}.`);
-    wheel.rotation.reorder('ZXY');
-    return wheel;
-  });
-  const startWheelRotations = wheels.map(wheel => wheel.quaternion.clone());
-  const surfaces: THREE.Object3D[] = [];
-  const kerbs: THREE.Vector3[] = [];
-  const obstacles: {
-    object: THREE.Object3D; position: THREE.Vector3; rotation: THREE.Quaternion;
-    velocity: THREE.Vector3; spin: THREE.Vector3; floor: number; hit: boolean;
-  }[] = [];
-  root.traverse((object) => {
-    if (!(object as THREE.Mesh).isMesh) return;
-    if (object.name.startsWith('Kerb.')) kerbs.push(object.position.clone());
-    if (object.name === 'Track' || object.name.startsWith('Ramp')) surfaces.push(object);
-    if (/^(Cone|Crate)\./.test(object.name)) {
-      find(object.name);
-      obstacles.push({ object, position: object.position.clone(), rotation: object.quaternion.clone(),
-        velocity: new THREE.Vector3(), spin: new THREE.Vector3(), floor: object.position.z, hit: false });
-    }
-  });
-  let speed = 0;
-  let heading = car.rotation.z;
-  let steering = 0;
-  let verticalSpeed = 0;
-  let grounded = true;
-  let pitch = 0;
-  let cameraStarted = false;
-  let elapsed = 0;
-  let lap = 0;
-  let lapStarted = 0;
-  let lastLap = 0;
-  let checkpoint = 0;
-  let previousY = car.position.y;
-  let effectClock = 0;
-  let hudClock = 0;
-  let restartHeld = false;
-  const checkpoints = [1, 2, 3].map(i => find(`Checkpoint.${i}`)).filter((o): o is THREE.Object3D => o !== null);
-  const velocity = new THREE.Vector2();
-  const effects = new THREE.Group();
-  effects.name = 'Race effects';
-  root.add(effects);
-  const markGeometry = new THREE.PlaneGeometry(0.32, 0.7);
-  const markMaterial = new THREE.MeshBasicMaterial({ color: '#0f1a1f', transparent: true, opacity: 0.6, depthWrite: false });
-  const marks = Array.from({ length: 128 }, () => {
-    const mark = new THREE.Mesh(markGeometry, markMaterial);
-    mark.visible = false;
-    effects.add(mark);
-    return mark;
-  });
-  let nextMark = 0;
-  const puffGeometry = new THREE.IcosahedronGeometry(0.22, 0);
-  const puffs = Array.from({ length: 24 }, () => {
-    const material = new THREE.MeshBasicMaterial({ color: '#e9edef', transparent: true, opacity: 0, depthWrite: false });
-    const mesh = new THREE.Mesh(puffGeometry, material);
-    mesh.visible = false;
-    effects.add(mesh);
-    return { mesh, life: 0 };
-  });
-  let nextPuff = 0;
-  let fps = 0;
-  let measuredFrames = 0;
-  let measuredSince = performance.now();
-  const ray = new THREE.Raycaster();
-  const origin = new THREE.Vector3();
-  const down = new THREE.Vector3();
-  const up = new THREE.Vector3();
-  const hitPoint = new THREE.Vector3();
-  const eye = new THREE.Vector3();
-  const target = new THREE.Vector3();
-  const cameraPosition = new THREE.Vector3();
-  const cameraTarget = new THREE.Vector3();
-  const held = (arrow: string, letter: string): boolean => keys.has(arrow) || keys.has(letter);
-  const approach = (value: number, goal: number, step: number): number =>
-    value < goal ? Math.min(value + step, goal) : Math.max(value - step, goal);
-  const surfaceAt = (x: number, y: number): number | null => {
-    root.localToWorld(origin.set(x, y, 40));
-    ray.set(origin, down);
-    ray.far = 100;
-    const hit = ray.intersectObjects(surfaces, false)[0];
-    return hit ? root.worldToLocal(hitPoint.copy(hit.point)).z : null;
-  };
-
-  const restart = () => {
-    car.position.copy(startPosition);
-    heading = startHeading;
-    car.rotation.set(0, 0, heading, 'ZXY');
-    speed = steering = verticalSpeed = pitch = 0;
-    velocity.set(0, 0);
-    grounded = true;
-    cameraStarted = false;
-    elapsed = lap = lapStarted = lastLap = checkpoint = effectClock = hudClock = 0;
-    previousY = startPosition.y;
-    for (const [index, wheel] of wheels.entries()) wheel.quaternion.copy(startWheelRotations[index]!);
-    for (const obstacle of obstacles) {
-      obstacle.object.position.copy(obstacle.position);
-      obstacle.object.quaternion.copy(obstacle.rotation);
-      obstacle.velocity.set(0, 0, 0);
-      obstacle.spin.set(0, 0, 0);
-      obstacle.hit = false;
-    }
-    for (const mark of marks) mark.visible = false;
-    for (const puff of puffs) {
-      puff.life = 0;
-      puff.mesh.visible = false;
-      puff.mesh.material.opacity = 0;
-    }
-    publishRaceState({ lap: 1, lapTime: 0, lastLap: 0, speed: 0, fps, airborne: false });
-  };
-
-  // THE BOT, offered to the editor: Autoplay in the Game panel lets it drive, and any key or
-  // click in the game hands the car back. It holds the same keys a person would, aiming at the
-  // next of track.py's control points and braking into turns it is taking too fast.
-  const route = [[32, -30], [32, -10], [32, 10], [32, 26], [22, 36], [8, 32], [4, 18], [-8, 16], [-16, 28],
-    [-30, 24], [-34, 10], [-22, 0], [-10, -4], [-16, -18], [-34, -28], [-30, -42], [-12, -44], [10, -44], [26, -40]]
-    .map(([x, y]) => new THREE.Vector2(x, y));
-  let waypoint = 0;
-  let botTick = -1;
-  context.autoplay?.(({ tick }) => {
-    const at = new THREE.Vector2(car.position.x, car.position.y);
-    // Switched on (again): aim past the nearest point, wherever the person left the car.
-    if (tick !== botTick + 1) {
-      const nearest = route.reduce((best, point, index) => point.distanceTo(at) < route[best]!.distanceTo(at) ? index : best, 0);
-      waypoint = (nearest + 1) % route.length;
-    }
-    botTick = tick;
-    if (route[waypoint]!.distanceTo(at) < 9) waypoint = (waypoint + 1) % route.length;
-    const target = route[waypoint]!;
-    const error = Math.atan2(target.y - at.y, target.x - at.x) - (heading + Math.PI / 2);
-    const turn = Math.atan2(Math.sin(error), Math.cos(error));
-    const hold = [Math.abs(turn) > 0.6 && speed > 14 ? 'ArrowDown' : 'ArrowUp'];
-    if (turn > 0.08) hold.push('ArrowLeft');
-    else if (turn < -0.08) hold.push('ArrowRight');
-    return hold;
-  });
-
-  return {
-    update(dt: number) {
-      if (dt <= 0) return;
-      const restarting = keys.has('KeyR');
-      const firstRestartFrame = restarting && !restartHeld;
-      restartHeld = restarting;
-      if (firstRestartFrame) {
-        restart();
-        return;
-      }
-      elapsed += dt;
-      measuredFrames++;
-      const now = performance.now();
-      if (now - measuredSince >= 1000) {
-        fps = measuredFrames * 1000 / (now - measuredSince);
-        measuredFrames = 0;
-        measuredSince = now;
-      }
-      root.updateMatrixWorld(true);
-      up.set(0, 0, 1).transformDirection(root.matrixWorld);
-      down.copy(up).negate();
-      const throttle = held('ArrowUp', 'KeyW');
-      const brake = held('ArrowDown', 'KeyS');
-      const turn = Number(held('ArrowLeft', 'KeyA')) - Number(held('ArrowRight', 'KeyD'));
-      const steps = Math.ceil(dt / (1 / 60));
-      const h = dt / steps;
-      let travelled = 0;
-      for (let step = 0; step < steps; step++) {
-        if (throttle && !brake) speed = approach(speed, 30, (speed < 0 ? 20 : 10) * h);
-        else if (brake && !throttle) speed = approach(speed, -8, (speed > 0 ? 20 : 7) * h);
-        else speed = approach(speed, 0, (throttle && brake ? 20 : 3) * h);
-        steering = approach(steering, turn * 0.5, 3 * h);
-        if (grounded) heading += speed / 1.8 * Math.tan(steering) / (1 + Math.abs(speed) / 8) * h;
-        const drifting = grounded && Math.abs(steering) > 0.3 && Math.abs(speed) > 13;
-        const grip = grounded ? (drifting ? 1.6 : 8) : 0.2;
-        velocity.lerp(new THREE.Vector2(-Math.sin(heading) * speed, Math.cos(heading) * speed), 1 - Math.exp(-grip * h));
-        travelled += velocity.length() * h * Math.sign(speed);
-        car.position.x += velocity.x * h;
-        car.position.y += velocity.y * h;
-        const road = surfaceAt(car.position.x, car.position.y);
-        const floor = road ?? 0;
-        if (road === null && grounded) {
-          speed *= Math.exp(-2 * h);
-          speed = THREE.MathUtils.clamp(speed, -4, 4);
-          velocity.multiplyScalar(Math.exp(-2 * h));
-        }
-        // Follow a rising surface; retain its launch velocity when the surface drops away.
-        if (grounded && floor >= car.position.z - 0.15) {
-          verticalSpeed = (floor - car.position.z) / h;
-          car.position.z = floor;
-          const ahead = surfaceAt(car.position.x - Math.sin(heading), car.position.y + Math.cos(heading));
-          const behind = surfaceAt(car.position.x + Math.sin(heading), car.position.y - Math.cos(heading));
-          const slope = ahead === null || behind === null ? 0 : Math.atan2(ahead - behind, 2);
-          pitch = THREE.MathUtils.lerp(pitch, slope, 1 - Math.exp(-10 * h));
-        } else {
-          grounded = false;
-          verticalSpeed -= 30 * h;
-          car.position.z += verticalSpeed * h;
-          if (car.position.z <= floor && verticalSpeed <= 0) {
-            car.position.z = floor;
-            verticalSpeed = 0;
-            grounded = true;
-          }
-          pitch = THREE.MathUtils.lerp(pitch, Math.atan2(verticalSpeed, Math.max(10, Math.abs(speed))), 1 - Math.exp(-3 * h));
-        }
-        for (const obstacle of obstacles) {
-          const { object, velocity, spin } = obstacle;
-          const dx = object.position.x - car.position.x;
-          const dy = object.position.y - car.position.y;
-          if (!obstacle.hit && Math.hypot(dx, dy) < 1.7 && Math.abs(object.position.z - car.position.z) < 2 && Math.abs(speed) > 1) {
-            obstacle.hit = true;
-            velocity.set(-Math.sin(heading) * speed * 0.8 + dx * 2, Math.cos(heading) * speed * 0.8 + dy * 2, 5);
-            spin.set(3, -4, 2);
-            speed *= 0.93;
-          }
-          if (!obstacle.hit) continue;
-          velocity.z -= 18 * h;
-          object.position.addScaledVector(velocity, h);
-          object.rotation.x += spin.x * h;
-          object.rotation.y += spin.y * h;
-          object.rotation.z += spin.z * h;
-          if (object.position.z < obstacle.floor) {
-            object.position.z = obstacle.floor;
-            velocity.z = Math.abs(velocity.z) * 0.25;
-            velocity.x *= Math.exp(-5 * h);
-            velocity.y *= Math.exp(-5 * h);
-            spin.multiplyScalar(Math.exp(-5 * h));
-          }
-        }
-      }
-      const roll = grounded ? -steering * Math.min(Math.abs(speed), 24) * 0.018 : 0;
-      car.rotation.set(pitch, roll, heading, 'ZXY');
-      effectClock += dt;
-      const slipping = grounded && Math.abs(steering) > 0.3 && Math.abs(speed) > 13;
-      const offroad = grounded && surfaceAt(car.position.x, car.position.y) === null;
-      if ((slipping || offroad) && effectClock > 0.06) {
-        effectClock = 0;
-        for (const side of [-1, 1]) {
-          const mark = marks[nextMark++ % marks.length]!;
-          mark.position.copy(car.position).add(new THREE.Vector3(side * 1.2 * Math.cos(heading) + Math.sin(heading) * 0.78,
-            side * 1.2 * Math.sin(heading) - Math.cos(heading) * 0.78, 0.018));
-          mark.rotation.z = heading;
-          mark.visible = true;
-          const puff = puffs[nextPuff++ % puffs.length]!;
-          puff.mesh.position.copy(mark.position).add(new THREE.Vector3(0, 0, 0.3));
-          puff.mesh.scale.setScalar(1);
-          puff.mesh.material.color.set(offroad ? '#c7641a' : '#e9edef');
-          puff.life = 0.7;
-          puff.mesh.visible = true;
-        }
-      }
-      for (const puff of puffs) {
-        if (puff.life <= 0) continue;
-        puff.life -= dt;
-        puff.mesh.visible = puff.life > 0;
-        puff.mesh.material.opacity = Math.max(0, puff.life * 0.5);
-        puff.mesh.position.z += dt * 0.9;
-        puff.mesh.scale.addScalar(dt * 1.8);
-      }
-      const nextCheckpoint = checkpoints[checkpoint];
-      if (lap > 0 && nextCheckpoint && Math.hypot(car.position.x - nextCheckpoint.position.x, car.position.y - nextCheckpoint.position.y) < 10)
-        checkpoint++;
-      if (previousY < -24 && car.position.y >= -24 && Math.abs(car.position.x - 32) < 5 && speed > 0) {
-        if (lap === 0 || checkpoint === checkpoints.length) {
-          lastLap = lap === 0 ? 0 : elapsed - lapStarted;
-          lap++;
-          checkpoint = 0;
-          lapStarted = elapsed;
-        }
-      }
-      previousY = car.position.y;
-      hudClock += dt;
-      if (hudClock >= 0.1) {
-        hudClock = 0;
-        publishRaceState({ lap: Math.max(1, lap), lapTime: lap ? elapsed - lapStarted : 0,
-          lastLap, speed: Math.abs(speed) * 3.6, fps, airborne: !grounded });
-      }
-      for (const [index, wheel] of wheels.entries()) {
-        wheel.rotation.z = index < 2 ? steering : 0;
-        wheel.rotation.x = (wheel.rotation.x - travelled / 0.57) % (2 * Math.PI);
-      }
-
-      // Smooth our own stage-space pose; navigation re-poses the stage camera each frame.
-      root.updateMatrixWorld(true);
-      const pace = Math.min(30, Math.abs(speed));
-      const distance = grounded ? 11 + pace * 0.07 : 12;
-      const lookAhead = grounded ? 2.5 + pace * 0.04 : 0.5;
-      const fov = 36 + pace * 0.28;
-      const height = 1.2 + (distance + lookAhead) * Math.tan(THREE.MathUtils.degToRad(fov * 0.22));
-      const kerb = grounded && kerbs.some(point => Math.hypot(point.x - car.position.x, point.y - car.position.y) < 1.4);
-      const rumble = kerb ? Math.sin(elapsed * 90) * Math.min(0.05, pace * 0.003) : 0;
-      const side = grounded ? 3 : 10;
-      root.localToWorld(eye.set(car.position.x + Math.sin(heading) * distance + side * Math.cos(heading),
-        car.position.y - Math.cos(heading) * distance + side * Math.sin(heading), car.position.z + height + rumble));
-      root.localToWorld(target.set(car.position.x - Math.sin(heading) * lookAhead,
-        car.position.y + Math.cos(heading) * lookAhead, car.position.z + (grounded ? 1.4 : 0.4)));
-      if (!cameraStarted) {
-        cameraPosition.copy(eye);
-        cameraTarget.copy(target);
-        cameraStarted = true;
-      }
-      const blend = 1 - Math.exp(-12 * dt);
-      cameraPosition.lerp(eye, blend);
-      cameraTarget.lerp(target, blend);
-      const camera = context.camera;
-      camera.position.copy(cameraPosition);
-      if (camera.parent) camera.parent.worldToLocal(camera.position);
-      camera.up.copy(up).applyAxisAngle(new THREE.Vector3().subVectors(cameraTarget, cameraPosition).normalize(), -roll * 0.3);
-      if ((camera as THREE.PerspectiveCamera).isPerspectiveCamera) {
-        const perspective = camera as THREE.PerspectiveCamera;
-        perspective.fov = fov;
-        perspective.updateProjectionMatrix();
-      }
-      camera.lookAt(cameraTarget);
-      camera.updateMatrixWorld(true);
-    },
-    dispose() {
-      root.remove(effects);
-      markGeometry.dispose();
-      markMaterial.dispose();
-      puffGeometry.dispose();
-      for (const puff of puffs) puff.mesh.material.dispose();
-    },
-  };
-}