@zylem/game-lib 0.8.4 → 0.8.6

package/dist/chunk-YOVE25NW.js

@@ -0,0 +1 @@
+import{a as f}from"./chunk-BMRFDDMR.js";import{b as u,r as C,s as V,t as d,v as G,w as U,y as v,z as b}from"./chunk-SAQA4SXW.js";import{e as D}from"./chunk-7NYP4YAG.js";import{c as h,d as y,h as m,i as E,j as x}from"./chunk-7WRQ2UAN.js";import{Color as B,Group as st,Sprite as ot,SpriteMaterial as at,CanvasTexture as H,LinearFilter as w,Vector2 as pt,ClampToEdgeWrapping as W}from"three";var g={position:void 0,text:"",fontFamily:'Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',fontSize:18,fontColor:"#FFFFFF",backgroundColor:null,padding:4,stickToViewport:!0,screenPosition:new pt(24,24),zDistance:1},O=class extends v{createEntity(t){return new _(t)}},lt=Symbol("Text"),_=class i extends d{static type=lt;_sprite=null;_texture=null;_canvas=null;_ctx=null;_cameraRef=null;_lastCanvasW=0;_lastCanvasH=0;constructor(t){super(),this.options=u(g,t),this.options.screenPosition=E(this.options.screenPosition,g.screenPosition),this.prependSetup(this.textSetup.bind(this)),this.prependUpdate(this.textUpdate.bind(this)),this.onCleanup(this.textDestroy.bind(this))}create(){return this._sprite=null,this._texture=null,this._canvas=null,this._ctx=null,this._lastCanvasW=0,this._lastCanvasH=0,this.group=new st,this.createSprite(),super.create()}createSprite(){this._canvas=document.createElement("canvas"),this._ctx=this._canvas.getContext("2d"),this._texture=new H(this._canvas),this._texture.minFilter=w,this._texture.magFilter=w;let t=new at({map:this._texture,transparent:!0,depthTest:!1,depthWrite:!1,alphaTest:.5});this._sprite=new ot(t),this.group?.add(this._sprite),this.redrawText(this.options.text??"")}measureAndResizeCanvas(t,e,n,s){if(!this._canvas||!this._ctx)return{sizeChanged:!1};this._ctx.font=`${e}px ${n}`;let r=this._ctx.measureText(t),o=Math.ceil(r.width),a=Math.ceil(e*1.4),p=Math.max(2,o+s*2),l=Math.max(2,a+s*2),T=p!==this._lastCanvasW||l!==this._lastCanvasH;return this._canvas.width=p,this._canvas.height=l,this._lastCanvasW=p,this._lastCanvasH=l,{sizeChanged:T}}drawCenteredText(t,e,n){!this._canvas||!this._ctx||(this._ctx.font=`${e}px ${n}`,this._ctx.textAlign="center",this._ctx.textBaseline="middle",this._ctx.clearRect(0,0,this._canvas.width,this._canvas.height),this.options.backgroundColor&&(this._ctx.fillStyle=this.toCssColor(this.options.backgroundColor),this._ctx.fillRect(0,0,this._canvas.width,this._canvas.height)),this._ctx.fillStyle=this.toCssColor(this.options.fontColor??"#FFFFFF"),this._ctx.fillText(t,this._canvas.width/2,this._canvas.height/2))}updateTexture(t){!this._texture||!this._canvas||(t&&(this._texture.dispose(),this._texture=new H(this._canvas),this._texture.minFilter=w,this._texture.magFilter=w,this._texture.wrapS=W,this._texture.wrapT=W),this._texture.image=this._canvas,this._texture.needsUpdate=!0,this._sprite&&this._sprite.material&&(this._sprite.material.map=this._texture,this._sprite.material.needsUpdate=!0))}redrawText(t){if(!this._canvas||!this._ctx)return;let e=this.options.fontSize??18,n=this.options.fontFamily??g.fontFamily,s=this.options.padding??4,{sizeChanged:r}=this.measureAndResizeCanvas(t,e,n,s);this.drawCenteredText(t,e,n),this.updateTexture(!!r),this.options.stickToViewport&&this._cameraRef?this.updateStickyTransform():this.updateWorldSpriteScale()}toCssColor(t){return typeof t=="string"?t:`#${(t instanceof B?t:new B(t)).getHexString()}`}textSetup(t){this._cameraRef=t.camera,this.options.stickToViewport&&this._cameraRef&&(this._cameraRef.camera.add(this.group),this.updateStickyTransform())}textUpdate(t){this._sprite&&this.options.stickToViewport&&this._cameraRef&&this.updateStickyTransform()}getResolution(){return{width:this._cameraRef?.screenResolution.x??1,height:this._cameraRef?.screenResolution.y??1}}getScreenPixels(t,e,n){let s=t.x>=0&&t.x<=1,r=t.y>=0&&t.y<=1;return{px:s?t.x*e:t.x,py:r?t.y*n:t.y}}computeWorldExtents(t,e){let n=1,s=1;if(t.isPerspectiveCamera){let r=t,o=Math.tan(r.fov*Math.PI/180/2)*e;n=o*r.aspect,s=o}else if(t.isOrthographicCamera){let r=t;n=(r.right-r.left)/2,s=(r.top-r.bottom)/2}return{worldHalfW:n,worldHalfH:s}}updateSpriteScale(t,e){if(!this._canvas||!this._sprite)return;let s=t*2/e,r=this._canvas.height,o=Math.max(1e-4,r*s),a=this._canvas.width/this._canvas.height,p=o*a;this._sprite.scale.set(p,o,1)}updateWorldSpriteScale(){if(!this._canvas||!this._sprite)return;let t=this._canvas.width/Math.max(1,this._canvas.height),e=Math.max(1,this.options.fontSize??18),n=Math.max(.25,e/32),s=n*t;this._sprite.scale.set(s,n,1)}updateStickyTransform(){if(!this._sprite||!this._cameraRef)return;let t=this._cameraRef.camera,{width:e,height:n}=this.getResolution(),s=E(this.options.screenPosition,g.screenPosition),{px:r,py:o}=this.getScreenPixels(s,e,n),a=Math.max(.001,this.options.zDistance??1),{worldHalfW:p,worldHalfH:l}=this.computeWorldExtents(t,a),T=r/e*2-1,it=1-o/n*2,nt=T*p,rt=it*l;this.group?.position.set(nt,rt,-a),this.updateSpriteScale(l,n)}updateText(t){this.options.text=t,this.redrawText(t),this.options.stickToViewport&&this._cameraRef&&this.updateStickyTransform()}buildInfo(){return{...new f(this).buildDebugInfo(),type:String(i.type),text:this.options.text??"",sticky:this.options.stickToViewport}}textDestroy(){this._texture?.dispose(),this._sprite?.material&&this._sprite.material.dispose(),this._sprite&&this._sprite.removeFromParent(),this.group?.removeFromParent(),this._sprite=null,this._texture=null,this._canvas=null,this._ctx=null,this._cameraRef=null}};function F(...i){return b({args:i,defaultConfig:{...g},EntityClass:_,BuilderClass:O,entityType:_.type,cloneFactory:t=>F(t??{})})}import{Euler as ct,Group as X,Quaternion as ht,Vector3 as mt}from"three";import{TextureLoader as N,SpriteMaterial as Y,Sprite as $,SRGBColorSpace as j}from"three";import{ClampToEdgeWrapping as Q,LinearFilter as ut,NearestFilter as dt}from"three";var q={...C,size:new mt(1,1,1),images:[],animations:[]},L=class extends U{collider(t){let e=x(t.collisionSize,t.size??y);return{shape:{type:"box",halfExtents:[e.x/2,e.y/2,e.z/2]}}}},I=class extends v{createEntity(t){return new S(t)}},ft=Symbol("Sprite"),S=class i extends d{static type=ft;sprites=[];spriteMap=new Map;currentSpriteIndex=0;animations=new Map;currentAnimation=null;currentAnimationFrame="";currentAnimationIndex=0;currentAnimationTime=0;sheetTexture=null;flippedX=!1;constructor(t){super(),this.options=u(q,t),this.prependSetup(this.spriteSetup.bind(this)),this.prependUpdate(this.spriteUpdate.bind(this)),this.onCleanup(this.spriteDestroy.bind(this))}create(){return this.sprites=[],this.spriteMap.clear(),this.animations.clear(),this.currentAnimation=null,this.currentAnimationFrame="",this.currentAnimationIndex=0,this.currentAnimationTime=0,this.sheetTexture=null,this.group=void 0,this.options?.sheet?this.createSpriteFromSheet(this.options.sheet):this.createSpritesFromImages(this.options?.images||[]),this.createAnimations(this.options?.animations||[]),super.create()}createSpritesFromImages(t){let e=new N,n=x(this.options.size,y);t.forEach((s,r)=>{let o=e.load(s.file);o.colorSpace=j,o.anisotropy=D;let a=new Y({map:o,transparent:!0}),p=new $(a);p.position.normalize(),p.scale.set(n.x,n.y,n.z),p.visible=r===0,this.sprites.push(p),this.spriteMap.set(s.name,r)}),this.group=new X,this.group.add(...this.sprites)}createSpriteFromSheet(t){let e=x(this.options.size,y),n=new N().load(t.file);n.colorSpace=j,n.wrapS=Q,n.wrapT=Q;let s=t.filter==="linear"?ut:dt;n.magFilter=s,n.minFilter=s,n.generateMipmaps=!1,n.repeat.set(1/t.columns,1/t.rows);let r=new Y({map:n,transparent:!0}),o=new $(r);o.position.normalize(),o.scale.set(e.x,e.y,e.z),this.sheetTexture=n,this.sprites.push(o),t.frames.forEach((p,l)=>{p&&this.spriteMap.set(p,l)}),this.group=new X,this.group.add(o);let a=t.frames.find(p=>!!p);a&&this.setSprite(a)}createAnimations(t){t.forEach(e=>{let{name:n,frames:s,loop:r=!1,speed:o=1}=e,a={frames:s.map((p,l)=>({key:p,index:l,duration:typeof o=="number"?o:o[l]})),loop:r};this.animations.set(n,a)})}setSprite(t){let n=this.spriteMap.get(t)??0;if(this.currentSpriteIndex=n,this.sheetTexture){this.applySheetFrame(n);return}this.sprites.forEach((s,r)=>{s.visible=this.currentSpriteIndex===r})}setFlipX(t){if(this.flippedX!==t){if(this.flippedX=t,this.sheetTexture){this.applySheetFrame(this.currentSpriteIndex);return}this.sprites.forEach(e=>{e.material.map?.repeat.setX(t?-1:1),e.material.map?.offset.setX(t?1:0)})}}isFlippedX(){return this.flippedX}applySheetFrame(t){let e=this.options.sheet,n=this.sheetTexture;if(!e||!n)return;let s=t%e.columns,r=Math.floor(t/e.columns),o=1/e.columns,a=1/e.rows;n.repeat.x=this.flippedX?-o:o,n.offset.x=this.flippedX?(s+1)*o:s*o,n.offset.y=1-(r+1)*a}setAnimation(t,e){let n=this.animations.get(t);if(!n)return;let{loop:s,frames:r}=n;if(r.length!==0){for(t!==this.currentAnimation?(this.currentAnimation=t,this.currentAnimationIndex=0,this.currentAnimationTime=0):this.currentAnimationTime+=e;;){let o=r[this.currentAnimationIndex].duration;if(!(o>0)||this.currentAnimationTime<o)break;if(this.currentAnimationTime-=o,this.currentAnimationIndex+1<r.length)this.currentAnimationIndex++;else if(s)this.currentAnimationIndex=0;else{this.currentAnimationTime=0;break}}this.currentAnimationFrame=r[this.currentAnimationIndex].key,this.setSprite(this.currentAnimationFrame)}}getCurrentRotationQuaternion(){return this.transformStore?.dirty.rotation?this.transformStore.rotation:this.body?.rotation?.()??null}syncSpriteMaterials(){let t=this.getCurrentRotationQuaternion();this.sprites.forEach(e=>{if(e.material&&t){let s=new ht(t.x,t.y,t.z,t.w),r=new ct().setFromQuaternion(s,"XYZ");e.material.rotation=r.z}let n=x(this.options.size,y);e.scale.set(n.x,n.y,n.z)})}spriteSetup(t){this.syncSpriteMaterials()}spriteUpdate(t){this.syncSpriteMaterials()}spriteDestroy(t){this.sprites.forEach(e=>{e.removeFromParent()}),this.group?.remove(...this.sprites),this.group?.removeFromParent(),this.sheetTexture?.dispose(),this.sheetTexture=null}buildInfo(){return{...new f(this).buildDebugInfo(),type:String(i.type)}}};function z(...i){return b({args:i,defaultConfig:q,EntityClass:S,BuilderClass:I,CollisionBuilderClass:L,entityType:S.type,cloneFactory:t=>z(t??{})})}import{Color as tt,Group as xt}from"three";import{Line2NodeMaterial as gt}from"three/webgpu";import{Line2 as _t}from"three/addons/lines/webgpu/Line2.js";import{Color as J}from"three";import{LineGeometry as yt}from"three/addons/lines/LineGeometry.js";function R(i){let t=[];for(let e of i){let{x:n,y:s,z:r}=m(e,h);t.push(n,s,r)}return t}function P(i,t,e){if(!i||i.length===0)return;let n=[],s=new J(e);for(let r=0;r<t;r++){let o=i[r]??i[i.length-1]??e,a=new J(o??s);n.push(a.r,a.g,a.b)}return n}function K(i){let t=new yt,e=R(i.points);t.setPositions(e);let n=P(i.colors,i.points.length,"#ffffff");return n&&t.setColors(n),t}var c={...C,points:[{x:0,y:0,z:0},{x:1,y:0,z:0}],linewidth:1,worldUnits:!0,alphaToCoverage:!1,opacity:1,transparent:!1,dashed:!1,dashSize:1,gapSize:1,pickThreshold:0},St=Symbol("Line");function Z(i,t){if(!i||i.length<2)throw new Error(`${t}: at least two points are required`);return i}function et(i){return i instanceof tt?i.clone():new tt(i??"#ffffff")}function Ct(i){let t=!!i.colors?.length,e=new gt({color:et(i.color).getHex(),linewidth:i.linewidth??c.linewidth,worldUnits:i.worldUnits??c.worldUnits,vertexColors:t,dashed:i.dashed??!1,dashSize:i.dashSize??c.dashSize,gapSize:i.gapSize??c.gapSize,transparent:i.transparent??!1,opacity:i.opacity??1});return e.alphaToCoverage=i.alphaToCoverage??!1,e}function vt(i){return!i.point||!i.pointOnLine||i.faceIndex==null?null:{point:i.point.clone(),pointOnLine:i.pointOnLine.clone(),faceIndex:i.faceIndex,distance:i.distance}}function bt(i,t,e={}){let n=t.getLineObject();if(!n)return null;let s=e.threshold??t.options.pickThreshold??0,r=i.params.Line2??{threshold:0};r.threshold=s,i.params.Line2=r;let a=i.intersectObject(n,!1)[0];return a?vt(a):null}var A=class i extends d{static type=St;_line=null;_geometry=null;_material=null;constructor(t){super();let e=u(c,t);e.points=Z(e.points,"ZylemLine").map(n=>m(n,h)),this.options=e}create(){return this.disposeLineResources(),this.group=new xt,this.rebuildLine(),this.applyGroupPosition(),super.create()}setPoints(t,e){if(Z(t,"setPoints"),this.options.points=t.map(s=>m(s,h)),e&&(this.options.colors=e),!this._line||!this._geometry||!this._material)return this;this._geometry.setPositions(R(this.options.points));let n=P(this.options.colors,this.options.points.length,et(this.options.color));return n&&this._geometry.setColors(n),this._material.vertexColors=!!this.options.colors?.length,this.options.dashed&&this._line.computeLineDistances(),this._geometry.computeBoundingBox(),this._geometry.computeBoundingSphere(),this}getLineObject(){return this._line}pickFromRaycaster(t,e={}){return bt(t,this,e)}buildInfo(){return{...new f(this).buildDebugInfo(),type:String(i.type),points:this.options.points.length,linewidth:this.options.linewidth??c.linewidth,worldUnits:this.options.worldUnits??c.worldUnits}}rebuildLine(){this._geometry=K({points:this.options.points,colors:this.options.colors}),this._material=Ct(this.options),this._line=new _t(this._geometry,this._material),this.options.dashed&&this._line.computeLineDistances(),this.group?.add(this._line)}applyGroupPosition(){if(!this.group)return;let t=m(this.options.position,h);this.group.position.set(t.x,t.y,t.z)}_cleanup(t){this.disposeLineResources(),super._cleanup(t)}disposeLineResources(){this._line?.removeFromParent(),this._geometry?.dispose(),this._material?.dispose(),this._line=null,this._geometry=null,this._material=null}};function M(...i){let t=V(i,c);Z(t.points,"createLine");let e=new A(t);return G(e,n=>M(n??{}))}var k={registry:new Map,register(i,t){this.registry.set(i,t)},createFromBlueprint(i){let t=this.registry.get(i.type);if(!t)throw new Error(`Unknown entity type: ${i.type}`);let e={...i.data,position:i.position?{x:i.position[0],y:i.position[1],z:0}:void 0,name:i.id};return t(e)}};k.register("text",i=>F(i));k.register("sprite",i=>z(i));k.register("line",i=>M(i));function ge(i){return{template:i,generate(t){let e=[];for(let n=0;n<t;n++)e.push(i.clone());return e}}}export{lt as a,_ as b,F as c,ft as d,S as e,z as f,St as g,bt as h,A as i,M as j,k,ge as l};

package/dist/{collision-builder-4TVDzXsp.d.ts → collision-builder-BckxkdmA.d.ts}

@@ -1,5 +1,5 @@
 import { SimulationBodyDefinition, SimulationColliderDefinition } from '@zylem/behaviors/core';
-import { e as Vec3Input } from './vector-DPbwlzgG.js';
+import { e as Vec3Input } from './vector-D3eDzvcA.js';
 
 /** Per-axis lock input: `true` locks all axes, or pass an [x, y, z] tuple. */
 type LockAxesInput = boolean | readonly [boolean, boolean, boolean];

package/dist/core.d.ts

@@ -1,27 +1,30 @@
-import { B as Stage, E as StageStateInterface, C as CameraWrapper } from './game-4fsy55uN.js';
-export { A as AspectRatio, q as AspectRatioValue, k as CameraManager, j as CameraOptions, D as DeviceProfile, p as FirstPersonOptions, l as FirstPersonPerspective, o as Fixed2DOptions, F as Fixed2DPerspective, G as Game, b as GameConfigLike, d as GameDeviceConfig, a as GameLoadingEvent, P as PerspectiveOptions, y as RenderBundleManager, z as RenderStrategyManager, R as ResolutionInput, e as ResolveGameConfigRuntime, v as RetroPreset, w as RetroPresetKey, x as RetroResolution, S as StageConfigLike, h as StageOptions, n as ThirdPersonOptions, T as ThirdPersonPerspective, i as createCamera, c as createGame, m as createPerspective, f as createStage, g as gameConfig, r as getDisplayAspect, t as getPresetResolution, u as parseResolution, s as stageConfig } from './game-4fsy55uN.js';
+import { B as Stage, E as StageStateInterface, C as CameraWrapper } from './game-Cy8f6gJm.js';
+export { A as AspectRatio, q as AspectRatioValue, k as CameraManager, j as CameraOptions, D as DeviceProfile, p as FirstPersonOptions, l as FirstPersonPerspective, o as Fixed2DOptions, F as Fixed2DPerspective, G as Game, b as GameConfigLike, d as GameDeviceConfig, a as GameLoadingEvent, P as PerspectiveOptions, y as RenderBundleManager, z as RenderStrategyManager, R as ResolutionInput, e as ResolveGameConfigRuntime, v as RetroPreset, w as RetroPresetKey, x as RetroResolution, S as StageConfigLike, h as StageOptions, n as ThirdPersonOptions, T as ThirdPersonPerspective, i as createCamera, c as createGame, m as createPerspective, f as createStage, g as gameConfig, r as getDisplayAspect, t as getPresetResolution, u as parseResolution, s as stageConfig } from './game-Cy8f6gJm.js';
 export { G as GameInputConfig, a as GameInputPlayerConfig, K as KeyboardMapping, M as MouseConfig, b as MouseMapping, V as VirtualTouchButtonConfig, d as VirtualTouchButtonSlot, c as VirtualTouchButtonsConfig, e as VirtualTouchConfig, f as VirtualTouchJoystickConfig, g as VirtualTouchJoysticksConfig, h as VirtualTouchPosition, i as VirtualTouchStyle, Z as ZylemGameConfig } from './game-interfaces-vF5sRi1n.js';
 import { Vector2 } from 'three';
-import { G as GameEntity, B as BaseNode, N as NodeInterface, a as GameEntityOptions } from './entity-BI7cSlK8.js';
+import { G as GameEntity, a as GameEntityOptions } from './entity-XZNGBeca.js';
 import { S as StageBlueprint } from './blueprints-TbGY-h53.js';
 import { a as SetupContext, k as LoadedContext, U as UpdateContext, D as DestroyContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
 export { L as LoadingEvent, S as StageNavigationOptions } from './base-node-life-cycle-BK9xebT9.js';
 export { S as StageTransitionConfig, a as StageTransitionEasing, Z as ZylemTransitionShader, c as crossfadeTransitionShader } from './stage-transition-CmGpV4tc.js';
-import { f as CameraBehavior } from './zylem-camera-B73ZNcgs.js';
-export { g as CameraAction, d as CameraContext, e as CameraPerspective, j as CameraPipeline, h as CameraPipelineState, C as CameraPose, P as PerspectiveType, a as Perspectives, c as PoseDelta, T as TransformLike, V as Viewport, b as ZylemRenderer, i as isWebGPUSupported } from './zylem-camera-B73ZNcgs.js';
-import { e as Vec3Input, c as Vec3 } from './vector-DPbwlzgG.js';
-export { f as VEC2_ONE, g as VEC2_ZERO, h as VEC3_ONE, i as VEC3_ZERO, V as Vec2, a as Vec2Components, b as Vec2Input, d as Vec3Components, n as normalizeVec2, j as normalizeVec3, t as toThreeVector2, k as toThreeVector3 } from './vector-DPbwlzgG.js';
-import { S as StageEntity } from './entity-DDks47JB.js';
-import './entity-type-map-COHu4fkW.js';
-import './material-BKPYeBC6.js';
+import { f as CameraBehavior } from './zylem-camera-DZTpPOiD.js';
+export { g as CameraAction, d as CameraContext, e as CameraPerspective, j as CameraPipeline, h as CameraPipelineState, C as CameraPose, P as PerspectiveType, a as Perspectives, c as PoseDelta, T as TransformLike, V as Viewport, b as ZylemRenderer, i as isWebGPUSupported } from './zylem-camera-DZTpPOiD.js';
+import { e as Vec3Input, c as Vec3 } from './vector-D3eDzvcA.js';
+export { f as VEC2_ONE, g as VEC2_ZERO, h as VEC3_ONE, i as VEC3_ZERO, V as Vec2, a as Vec2Components, b as Vec2Input, d as Vec3Components, n as normalizeVec2, j as normalizeVec3, t as toThreeVector2, k as toThreeVector3 } from './vector-D3eDzvcA.js';
+import { S as StageEntity } from './entity-BIf_a4dl.js';
+import { B as BaseNode, N as NodeInterface } from './base-node-idopiSw5.js';
+import './entity-type-map-CkkFMSrL.js';
+import './material-CxxAyJYp.js';
 import 'three/webgpu';
 import '@zylem/behaviors/core';
 import '@zylem/behaviors/particle-emitter';
 import 'three/addons/lines/webgpu/Line2.js';
+import './simulation-body-zQw-emOr.js';
+import '@zylem/bridge';
 import './events.js';
 import 'mitt';
 import './default-controls-CAKJ5zlo.js';
-import './collision-builder-4TVDzXsp.js';
+import './collision-builder-BckxkdmA.js';
 import '@sinclair/typebox';
 
 /**

package/dist/core.js

@@ -1 +1 @@
-import{a as b,b as c,c as d,d as e,e as f,f as H,g as I,h as J,i as K,j as L,k as M,l as N,m as O,n as P,o as Q}from"./chunk-6B5JP7T5.js";import{a,c as h,d as i,e as j,f as s,g as t,h as u,i as v,k as w,l as x,m as y,n as z,o as A,p as B,q as C,r as D,s as E,t as F,v as G}from"./chunk-4CHZUWLF.js";import{a as g}from"./chunk-7GYFZKK7.js";import"./chunk-VIPINV7V.js";import"./chunk-C5NEGC3S.js";import"./chunk-D3JO4HW2.js";import"./chunk-LKFF6XJC.js";import"./chunk-W5SXED5T.js";import"./chunk-WBQ5TNRZ.js";import"./chunk-PNLNC3FA.js";import"./chunk-3I537JFL.js";import"./chunk-CM5YRNBJ.js";import"./chunk-AIQ6IVT5.js";import"./chunk-QXVH6POE.js";import"./chunk-EVYHPR3J.js";import"./chunk-D2PATZCC.js";import"./chunk-4QLJUQSJ.js";import{a as k,b as l,c as m,d as n,g as o,h as p,i as q,j as r}from"./chunk-7WRQ2UAN.js";import"./chunk-BH53MBAZ.js";import"./chunk-XRP4JJXL.js";import"./chunk-PCFF4LLO.js";import"./chunk-UG22Z42P.js";export{b as AspectRatio,B as CameraManager,w as CameraPipeline,C as CameraWrapper,z as FirstPersonPerspective,y as Fixed2DPerspective,J as Game,v as Perspectives,s as RenderBundleManager,t as RenderStrategyManager,M as STAGE_STATE_CHANGE,I as StageManager,x as ThirdPersonPerspective,l as VEC2_ONE,k as VEC2_ZERO,n as VEC3_ONE,m as VEC3_ZERO,D as createCamera,P as createFollowTarget,K as createGame,A as createPerspective,G as createStage,g as crossfadeTransitionShader,O as dispatchStageState,L as entitySpawner,f as gameConfig,c as getDisplayAspect,d as getPresetResolution,N as initStageStateDispatcher,j as isManagedRenderEntity,a as isWebGPUSupported,o as normalizeVec2,p as normalizeVec3,e as parseResolution,h as resolveRenderCategory,Q as setCameraFeed,u as setStageFrameProfilerEnabled,E as stageConfig,H as stageState,q as toThreeVector2,r as toThreeVector3,i as usesManagedRenderPath,F as vessel};
+import{a as b,b as c,c as d,d as e,e as f,f as H,g as I,h as J,i as K,j as L,k as M,l as N,m as O,n as P,o as Q}from"./chunk-LD4KDRYL.js";import{a,c as p,d as q,e as r,f as s,g as t,h as u,i as v,k as w,l as x,m as y,n as z,o as A,p as B,q as C,r as D,s as E,t as F,v as G}from"./chunk-FYQNZCIP.js";import{a as o}from"./chunk-7GYFZKK7.js";import"./chunk-Q2YDBMVY.js";import"./chunk-BCFFS3FP.js";import"./chunk-QDQ4QMAI.js";import"./chunk-AE3CTVHY.js";import"./chunk-DQQA3VJH.js";import"./chunk-VJZMSBKP.js";import"./chunk-DECK4UEC.js";import"./chunk-WBQ5TNRZ.js";import"./chunk-YOVE25NW.js";import"./chunk-MXO4VGDB.js";import"./chunk-BMRFDDMR.js";import"./chunk-SAQA4SXW.js";import"./chunk-7NYP4YAG.js";import"./chunk-AIQ6IVT5.js";import"./chunk-QXVH6POE.js";import"./chunk-EVYHPR3J.js";import"./chunk-D2PATZCC.js";import"./chunk-4QLJUQSJ.js";import{a as g,b as h,c as i,d as j,g as k,h as l,i as m,j as n}from"./chunk-7WRQ2UAN.js";import"./chunk-BH53MBAZ.js";import"./chunk-XRP4JJXL.js";import"./chunk-PCFF4LLO.js";import"./chunk-UG22Z42P.js";export{b as AspectRatio,B as CameraManager,w as CameraPipeline,C as CameraWrapper,z as FirstPersonPerspective,y as Fixed2DPerspective,J as Game,v as Perspectives,s as RenderBundleManager,t as RenderStrategyManager,M as STAGE_STATE_CHANGE,I as StageManager,x as ThirdPersonPerspective,h as VEC2_ONE,g as VEC2_ZERO,j as VEC3_ONE,i as VEC3_ZERO,D as createCamera,P as createFollowTarget,K as createGame,A as createPerspective,G as createStage,o as crossfadeTransitionShader,O as dispatchStageState,L as entitySpawner,f as gameConfig,c as getDisplayAspect,d as getPresetResolution,N as initStageStateDispatcher,r as isManagedRenderEntity,a as isWebGPUSupported,k as normalizeVec2,l as normalizeVec3,e as parseResolution,p as resolveRenderCategory,Q as setCameraFeed,u as setStageFrameProfilerEnabled,E as stageConfig,H as stageState,m as toThreeVector2,n as toThreeVector3,q as usesManagedRenderPath,F as vessel};

package/dist/debug-state-B5awuDHl.d.ts

@@ -0,0 +1,89 @@
+import { G as GameEntity } from './entity-XZNGBeca.js';
+
+type DebugTools = 'select' | 'translate' | 'rotate' | 'scale' | 'delete' | 'add' | 'none';
+/** Tools that manipulate a selected entity's transform via the gizmo. */
+declare const TRANSFORM_TOOLS: readonly ["translate", "rotate", "scale"];
+type TransformTool = (typeof TRANSFORM_TOOLS)[number];
+declare function isTransformTool(tool: DebugTools): tool is TransformTool;
+/** Grid increments applied to gizmo drags, in world units and radians. */
+interface SnapSettings {
+    enabled: boolean;
+    translate: number;
+    /** Radians. Defaults to 15 degrees. */
+    rotate: number;
+    scale: number;
+}
+declare const DEFAULT_SNAP_SETTINGS: SnapSettings;
+interface DebugState {
+    enabled: boolean;
+    paused: boolean;
+    tool: DebugTools;
+    /**
+     * UUID of the selected entity, never the entity itself. Valtio deep-proxies
+     * any object assigned into a proxy, so storing a live `GameEntity` here
+     * would walk `group.parent` into the entire THREE scene graph and
+     * `physicsWorldRef` into the Rapier world, freezing the tab and handing
+     * Proxy wrappers to engine code that expects real instances.
+     */
+    selectedEntityId: string | null;
+    /**
+     * Full selection, in click order. `selectedEntityId` mirrors the first
+     * entry. Only ever holds one uuid today, but the gizmo and scene operations
+     * are already written against the list so multi-select needs no rework here.
+     */
+    selectedEntityIds: string[];
+    /** UUID of the hovered entity. Same constraint as `selectedEntityId`. */
+    hoveredEntityId: string | null;
+    snap: SnapSettings;
+    /** Whether the construction-plane grid is drawn. */
+    gridVisible: boolean;
+    /** Catalog type the add tool will spawn, or null when disarmed. */
+    addTypeId: string | null;
+    /** Creation options merged over the armed type's defaults. */
+    addTypeProps: Record<string, unknown> | null;
+    flags: Set<string>;
+}
+declare const debugState: DebugState;
+/** Resolves a UUID to the live entity owned by the active stage. */
+type DebugEntityResolver = (uuid: string) => GameEntity<any> | null;
+/**
+ * Register the active stage's entity resolver so `getSelectedEntity` /
+ * `getHoveredEntity` can hand back live entities without the reactive store
+ * ever holding one.
+ *
+ * @returns An unregister function.
+ */
+declare function registerDebugEntityResolver(resolver: DebugEntityResolver): () => void;
+/** Resolve a UUID through the active stage, or null when unavailable. */
+declare function resolveDebugEntity(uuid: string | null): GameEntity<any> | null;
+declare function setPaused(paused: boolean): void;
+declare function setDebugTool(tool: DebugTools): void;
+declare function getSelectedEntityId(): string | null;
+declare function setSelectedEntityId(uuid: string | null): void;
+/** Every selected uuid, in click order. */
+declare function getSelectedEntityIds(): string[];
+/**
+ * Replace the selection. `selectedEntityId` follows the first entry so the
+ * single-select consumers (debug cursor, orbit focus target, bridge mirror)
+ * keep working unchanged.
+ */
+declare function setSelectedEntityIds(uuids: string[]): void;
+/** Current snap increments. */
+declare function getSnapSettings(): SnapSettings;
+declare function setSnapSettings(snap: Partial<SnapSettings>): void;
+declare function setGridVisible(visible: boolean): void;
+/** Arm the add tool with a catalog type, or pass `null` to disarm it. */
+declare function setAddType(typeId: string | null, props?: Record<string, unknown> | null): void;
+declare function getHoveredEntityId(): string | null;
+declare function setHoveredEntityId(uuid: string | null): void;
+/** The live selected entity, resolved on demand through the active stage. */
+declare function getSelectedEntity(): GameEntity<any> | null;
+/** The live hovered entity, resolved on demand through the active stage. */
+declare function getHoveredEntity(): GameEntity<any> | null;
+/**
+ * @deprecated Pass a UUID to {@link setSelectedEntityId} instead. Accepts a
+ * live entity only to keep the previous public API working.
+ */
+declare function setSelectedEntity(entity: GameEntity<any> | string | null): void;
+
+export { DEFAULT_SNAP_SETTINGS as D, type SnapSettings as S, TRANSFORM_TOOLS as T, setPaused as a, setSelectedEntity as b, setSelectedEntityId as c, debugState as d, getSelectedEntity as e, setSelectedEntityIds as f, getSelectedEntityId as g, getSelectedEntityIds as h, setHoveredEntityId as i, getHoveredEntityId as j, getHoveredEntity as k, resolveDebugEntity as l, getSnapSettings as m, setSnapSettings as n, setGridVisible as o, setAddType as p, isTransformTool as q, registerDebugEntityResolver as r, setDebugTool as s, type DebugTools as t, type DebugEntityResolver as u, type TransformTool as v };

package/dist/debug.d.ts

@@ -1,16 +1,203 @@
-export { k as DebugEntityResolver, D as DebugTools, d as debugState, i as getHoveredEntity, h as getHoveredEntityId, e as getSelectedEntity, g as getSelectedEntityId, r as registerDebugEntityResolver, j as resolveDebugEntity, s as setDebugTool, f as setHoveredEntityId, a as setPaused, b as setSelectedEntity, c as setSelectedEntityId } from './debug-state-s0s-qndj.js';
-import { Object3D, Vector3 } from 'three';
-import { G as GameEntity } from './entity-BI7cSlK8.js';
+export { D as DEFAULT_SNAP_SETTINGS, u as DebugEntityResolver, t as DebugTools, S as SnapSettings, T as TRANSFORM_TOOLS, v as TransformTool, d as debugState, k as getHoveredEntity, j as getHoveredEntityId, e as getSelectedEntity, g as getSelectedEntityId, h as getSelectedEntityIds, m as getSnapSettings, q as isTransformTool, r as registerDebugEntityResolver, l as resolveDebugEntity, p as setAddType, s as setDebugTool, o as setGridVisible, i as setHoveredEntityId, a as setPaused, b as setSelectedEntity, c as setSelectedEntityId, f as setSelectedEntityIds, n as setSnapSettings } from './debug-state-B5awuDHl.js';
+import * as three from 'three';
+import { Group, Scene, Vector3, Camera, Object3D } from 'three';
+import { c as Vec3 } from './vector-D3eDzvcA.js';
+import { G as GameEntity } from './entity-XZNGBeca.js';
 import { WebGPURenderer } from 'three/webgpu';
 import '@zylem/behaviors/core';
-import './vector-DPbwlzgG.js';
-import './material-BKPYeBC6.js';
-import './collision-builder-4TVDzXsp.js';
+import './simulation-body-zQw-emOr.js';
+import './material-CxxAyJYp.js';
+import './collision-builder-BckxkdmA.js';
+import './base-node-idopiSw5.js';
 import './base-node-life-cycle-BK9xebT9.js';
 import './stage-transition-CmGpV4tc.js';
 import './events.js';
 import 'mitt';
 
+type GizmoMode = 'translate' | 'rotate' | 'scale';
+/** Single-axis, planar, and uniform handle identifiers. */
+type GizmoAxis = 'x' | 'y' | 'z' | 'xy' | 'yz' | 'xz' | 'xyz';
+/** A raw, unsnapped drag result in world space. */
+type GizmoDelta = {
+    kind: 'translate';
+    offset: Vector3;
+} | {
+    kind: 'rotate';
+    axis: Vector3;
+    angle: number;
+} | {
+    kind: 'scale';
+    factor: Vector3;
+};
+/** A mouse ray in world space. */
+interface GizmoRay {
+    origin: Vector3;
+    direction: Vector3;
+}
+/**
+ * Closest point along an infinite line to a ray, as a distance along the line.
+ *
+ * Returns `null` when the ray is close enough to parallel with the line that the
+ * closest point becomes unstable; see {@link MAX_DRAG_GAIN}.
+ */
+declare function closestAxisValue(ray: GizmoRay, origin: Vector3, axis: Vector3): number | null;
+/**
+ * Intersect a ray with the plane through `origin` with the given normal.
+ *
+ * Returns `null` for a plane seen too close to edge-on, where the hit point
+ * races away across the plane for very little pointer motion.
+ */
+declare function intersectPlane(ray: GizmoRay, origin: Vector3, normal: Vector3, target: Vector3): Vector3 | null;
+declare class TransformGizmo {
+    /** Root added to the scene; carries the pivot transform. */
+    readonly root: Group<three.Object3DEventMap>;
+    private scene;
+    private modeGroups;
+    private handles;
+    private materials;
+    private geometries;
+    private mode;
+    private highlighted;
+    private drag;
+    private raycaster;
+    constructor();
+    addTo(scene: Scene): void;
+    removeFromScene(): void;
+    dispose(): void;
+    setMode(mode: GizmoMode): void;
+    getMode(): GizmoMode;
+    /** Place the gizmo at a pivot and show it. */
+    show(pivot: Vector3): void;
+    hide(): void;
+    get visible(): boolean;
+    get pivot(): Vector3;
+    /**
+     * Keep the gizmo a constant size on screen.
+     *
+     * A world-sized gizmo is unusable in an orbit view: it fills the screen up
+     * close and disappears from a distance.
+     */
+    update(camera: Camera): void;
+    /**
+     * Which handle a ray hits, or `null`.
+     *
+     * Raycasts the gizmo's own meshes rather than the physics world. Handles are
+     * render-only objects with no colliders, so the physics raycast used to pick
+     * entities cannot see them at all.
+     */
+    pick(ray: GizmoRay): GizmoAxis | null;
+    /**
+     * Whether a handle can be dragged from the current viewing angle.
+     *
+     * Each handle type degenerates differently: an arrow aimed at the camera has
+     * no screen-space direction left to follow, while a plane quad or rotation
+     * ring seen edge-on turns a pixel of motion into a huge sweep across it.
+     */
+    private isHandleDraggable;
+    /** Tint a handle to show it is hovered or being dragged. */
+    setHighlight(axis: GizmoAxis | null): void;
+    /**
+     * Begin a drag on a handle.
+     *
+     * @returns `false` when the gesture cannot be tracked (a near-parallel view
+     * of the drag axis), so the caller can ignore the press rather than start a
+     * drag that would jump.
+     */
+    beginDrag(axis: GizmoAxis, ray: GizmoRay, camera: Camera): boolean;
+    /** Raw delta for the current pointer position, or `null` when unusable. */
+    updateDrag(ray: GizmoRay, camera: Camera): GizmoDelta | null;
+    endDrag(): void;
+    get isDragging(): boolean;
+    get draggingAxis(): GizmoAxis | null;
+    private isPlaneAxis;
+    /** Signed angle of the ray's hit point around `normal`, in radians. */
+    private angleOnPlane;
+    /** Distance from pivot to the ray hit on the camera-facing plane. */
+    private cameraPlaneRadius;
+    private applyModeVisibility;
+    private makeMaterial;
+    private track;
+    /**
+     * An invisible, generously sized mesh used only for hit testing.
+     *
+     * The visible shafts and rings are a couple of pixels wide, which is
+     * miserable to click. The raycaster still reaches `visible: false` meshes,
+     * so picking accuracy is decoupled from how thin the handle looks.
+     */
+    private makePicker;
+    private orientAlongAxis;
+    private buildTranslate;
+    private positionPlaneHandle;
+    private buildRotate;
+    private orientRing;
+    private buildScale;
+}
+
+/**
+ * The y=0 construction plane, drawn so the snap lattice is legible.
+ *
+ * Two overlaid grids: fine lines at the translation snap increment, and heavier
+ * lines every metre. Without the coarse pass a 0.25 grid over any useful area
+ * reads as flat grey noise.
+ */
+
+declare class ConstructionGrid {
+    private group;
+    private scene;
+    private fine;
+    private coarse;
+    private increment;
+    constructor();
+    addTo(scene: Scene): void;
+    /** Rebuild only when the increment actually changed; this allocates. */
+    setIncrement(increment: number): void;
+    setVisible(visible: boolean): void;
+    get visible(): boolean;
+    dispose(): void;
+    private rebuild;
+    private clearHelpers;
+}
+
+/**
+ * Pure transform math shared by the editor gizmo, the bridge adapter, and
+ * their tests. No THREE scene state and no simulation access, so it can be
+ * exercised in a plain node environment.
+ */
+
+/** Quaternion as carried by the bridge and the wasm runtime. */
+interface Quat {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/** Convert Euler angles (radians, XYZ order) to a quaternion. */
+declare function eulerToQuaternion(rotation: Vec3): Quat;
+/** Convert a quaternion to Euler angles (radians, XYZ order). */
+declare function quaternionToEuler(rotation: Quat): Vec3;
+/**
+ * Snap a value onto an absolute lattice of `increment`-sized steps.
+ *
+ * Absolute rather than relative to where the drag started: the result is
+ * always a multiple of the increment, so independently placed entities line up
+ * with each other instead of each keeping its own arbitrary offset.
+ */
+declare function snapToIncrement(value: number, increment: number): number;
+/** {@link snapToIncrement} across all three components. */
+declare function snapVec3(value: Vec3, increment: number): Vec3;
+/**
+ * Snap a scale, clamped away from zero.
+ *
+ * A snapped-to-zero axis would collapse the collider into a degenerate shape
+ * that the physics runtime cannot solve, so the smallest representable scale
+ * is one increment.
+ */
+declare function snapScale(value: Vec3, increment: number): Vec3;
+/** Degrees to radians. */
+declare function degreesToRadians(degrees: number): number;
+/** Radians to degrees. */
+declare function radiansToDegrees(radians: number): number;
+
 /**
  * Context registered by the active stage so the editor can focus entities
  * without importing stage internals.
@@ -98,4 +285,4 @@ declare class EntityThumbnailCache {
 /** Shared cache used by the running game to feed editor entity payloads. */
 declare const entityThumbnailCache: EntityThumbnailCache;
 
-export { type EntityFocusContext, EntityThumbnailCache, type EntityThumbnailCacheEntry, type EntityThumbnailResult, entityThumbnailCache, focusEntity, registerEntityFocusContext };
+export { ConstructionGrid, type EntityFocusContext, EntityThumbnailCache, type EntityThumbnailCacheEntry, type EntityThumbnailResult, type GizmoAxis, type GizmoDelta, type GizmoMode, type GizmoRay, type Quat, TransformGizmo, closestAxisValue, degreesToRadians, entityThumbnailCache, eulerToQuaternion, focusEntity, intersectPlane, quaternionToEuler, radiansToDegrees, registerEntityFocusContext, snapScale, snapToIncrement, snapVec3 };

package/dist/debug.js

@@ -1 +1 @@
-import"./chunk-DFLI7ICU.js";import{a as m,b as n}from"./chunk-VIPINV7V.js";import"./chunk-C5NEGC3S.js";import{a as o,b as p}from"./chunk-LKFF6XJC.js";import{a,b,c,e as d,g as e,h as f,i as g,j as h,k as i,m as j,n as k,o as l}from"./chunk-W5SXED5T.js";export{m as EntityThumbnailCache,a as debugState,n as entityThumbnailCache,p as focusEntity,k as getHoveredEntity,h as getHoveredEntityId,j as getSelectedEntity,f as getSelectedEntityId,b as registerDebugEntityResolver,o as registerEntityFocusContext,c as resolveDebugEntity,e as setDebugTool,i as setHoveredEntityId,d as setPaused,l as setSelectedEntity,g as setSelectedEntityId};
+import"./chunk-MSCVL5OK.js";import{a as v,b as w}from"./chunk-Q2YDBMVY.js";import{c as G,d as H,e as I,f as J}from"./chunk-BCFFS3FP.js";import{a as x,b as y,c as z,d as A,e as B,f as C,g as D,h as E,i as F}from"./chunk-VJZMSBKP.js";import{a,b,c,d,e,f,h as g,j as h,l as i,m as j,n as k,o as l,p as m,q as n,r as o,s as p,t as q,u as r,w as s,x as t,y as u}from"./chunk-DECK4UEC.js";export{G as ConstructionGrid,c as DEFAULT_SNAP_SETTINGS,v as EntityThumbnailCache,a as TRANSFORM_TOOLS,J as TransformGizmo,H as closestAxisValue,d as debugState,E as degreesToRadians,w as entityThumbnailCache,z as eulerToQuaternion,y as focusEntity,t as getHoveredEntity,q as getHoveredEntityId,s as getSelectedEntity,i as getSelectedEntityId,k as getSelectedEntityIds,m as getSnapSettings,I as intersectPlane,b as isTransformTool,A as quaternionToEuler,F as radiansToDegrees,e as registerDebugEntityResolver,x as registerEntityFocusContext,f as resolveDebugEntity,p as setAddType,h as setDebugTool,o as setGridVisible,r as setHoveredEntityId,g as setPaused,u as setSelectedEntity,j as setSelectedEntityId,l as setSelectedEntityIds,n as setSnapSettings,D as snapScale,B as snapToIncrement,C as snapVec3};

package/dist/{entity-DDks47JB.d.ts → entity-BIf_a4dl.d.ts}

@@ -1,5 +1,5 @@
 import { Group, Mesh } from 'three';
-import { l as SimulationBody } from './vector-DPbwlzgG.js';
+import { a as SimulationBody } from './simulation-body-zQw-emOr.js';
 
 type LifecycleFunction<T> = (params?: any) => void;
 interface Entity<T = any> {

package/dist/{entity-BI7cSlK8.d.ts → entity-XZNGBeca.d.ts}

@@ -1,104 +1,13 @@
 import { BufferGeometry, Material, Mesh, Group, Vector3, Color, ShaderMaterial } from 'three';
 import { SimulationColliderDefinition, TransformState, SimulationBodyDefinition, MoveableEntity, BehaviorRuntime, Vector, BehaviorDescriptor, BehaviorHandle, BehaviorRef } from '@zylem/behaviors/core';
-import { c as Vec3, e as Vec3Input, b as Vec2Input, l as SimulationBody } from './vector-DPbwlzgG.js';
-import { M as MaterialBuilder, e as MaterialOptions } from './material-BKPYeBC6.js';
-import { C as CollisionBuilder, L as LockAxesInput, a as CollisionOptions } from './collision-builder-4TVDzXsp.js';
-import { a as SetupContext, U as UpdateContext, D as DestroyContext, h as SetupFunction, i as LoadedFunction, g as UpdateFunction, j as DestroyFunction, C as CleanupFunction, k as LoadedContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
+import { a as SimulationBody } from './simulation-body-zQw-emOr.js';
+import { c as Vec3, e as Vec3Input, b as Vec2Input } from './vector-D3eDzvcA.js';
+import { M as MaterialBuilder, e as MaterialOptions } from './material-CxxAyJYp.js';
+import { C as CollisionBuilder, L as LockAxesInput, a as CollisionOptions } from './collision-builder-BckxkdmA.js';
+import { B as BaseNode, N as NodeInterface } from './base-node-idopiSw5.js';
+import { a as SetupContext, U as UpdateContext, D as DestroyContext, k as LoadedContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
 import { EventEmitterDelegate, EntityEvents } from './events.js';
 
-interface NodeInterface {
-    uuid: string;
-    name: string;
-    markedForRemoval: boolean;
-    nodeSetup(params: SetupContext<any>): void;
-    nodeUpdate(params: UpdateContext<any>): void;
-    nodeDestroy(params: DestroyContext<any>): void;
-    setParent(parent: NodeInterface | null): void;
-    getParent(): NodeInterface | null;
-}
-
-type BaseNodeOptions<T = any> = BaseNode | Partial<T>;
-/**
- * Lifecycle callback arrays - each lifecycle event can have multiple callbacks
- * that execute in order.
- */
-interface LifecycleCallbacks<T> {
-    setup: Array<SetupFunction<T>>;
-    loaded: Array<LoadedFunction<T>>;
-    update: Array<UpdateFunction<T>>;
-    destroy: Array<DestroyFunction<T>>;
-    cleanup: Array<CleanupFunction<T>>;
-}
-declare abstract class BaseNode<Options = any, T = any> implements NodeInterface {
-    protected parent: NodeInterface | null;
-    protected children: NodeInterface[];
-    options: Options;
-    uuid: string;
-    name: string;
-    markedForRemoval: boolean;
-    /**
-     * Lifecycle callback arrays - use onSetup(), onUpdate(), etc. to add callbacks
-     * Uses `any` for the type parameter to avoid invariance issues when subclasses
-     * are assigned to BaseNode references. Type safety is enforced by the public
-     * onSetup/onUpdate/etc. methods which are typed with `this`.
-     */
-    protected lifecycleCallbacks: LifecycleCallbacks<any>;
-    private trackLifecycleRegistrations;
-    private userLifecycleRegistrations;
-    constructor(args?: BaseNodeOptions[]);
-    /**
-     * Add setup callbacks to be executed in order during nodeSetup
-     */
-    onSetup(...callbacks: Array<SetupFunction<this>>): this;
-    /**
-     * Add loaded callbacks to be executed in order during nodeLoaded
-     */
-    onLoaded(...callbacks: Array<LoadedFunction<this>>): this;
-    /**
-     * Add update callbacks to be executed in order during nodeUpdate
-     */
-    onUpdate(...callbacks: Array<UpdateFunction<this>>): this;
-    /**
-     * Add destroy callbacks to be executed in order during nodeDestroy
-     */
-    onDestroy(...callbacks: Array<DestroyFunction<this>>): this;
-    /**
-     * Add cleanup callbacks to be executed in order during nodeCleanup
-     */
-    onCleanup(...callbacks: Array<CleanupFunction<this>>): this;
-    /**
-     * Prepend setup callbacks (run before existing ones)
-     */
-    prependSetup(...callbacks: Array<SetupFunction<this>>): this;
-    /**
-     * Prepend update callbacks (run before existing ones)
-     */
-    prependUpdate(...callbacks: Array<UpdateFunction<this>>): this;
-    setParent(parent: NodeInterface | null): void;
-    getParent(): NodeInterface | null;
-    add(baseNode: NodeInterface): void;
-    remove(baseNode: NodeInterface): void;
-    getChildren(): NodeInterface[];
-    isComposite(): boolean;
-    enableUserLifecycleTracking(): void;
-    protected replayUserLifecycleRegistrationsTo(target: BaseNode<any, any>, wrap?: <T extends Function>(callback: T) => T): void;
-    protected cloneChildrenInto(target: BaseNode<any, any>): void;
-    abstract create(): T;
-    protected abstract _setup(params: SetupContext<this>): void;
-    protected abstract _loaded(params: LoadedContext<this>): Promise<void>;
-    protected abstract _update(params: UpdateContext<this>): void;
-    protected abstract _destroy(params: DestroyContext<this>): void;
-    protected abstract _cleanup(params: CleanupContext<this>): void;
-    nodeSetup(params: SetupContext<this>): void;
-    nodeUpdate(params: UpdateContext<this>): void;
-    nodeDestroy(params: DestroyContext<this>): void;
-    nodeLoaded(params: LoadedContext<this>): Promise<void>;
-    nodeCleanup(params: CleanupContext<this>): void;
-    getOptions(): Options;
-    setOptions(options: Partial<Options>): void;
-    private recordLifecycleRegistration;
-}
-
 /**
  * TODO: allow for multiple materials requires geometry groups
  * TODO: allow for instanced uniforms
@@ -460,6 +369,18 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
     physicsWorldRef: unknown;
     colliderDesc: SimulationColliderDefinition | undefined;
     custom: Record<string, any>;
+    /**
+     * Pristine collider definitions captured before the first scale change, so
+     * scaling stays absolute rather than compounding. See
+     * {@link ensureColliderBaseline}.
+     */
+    colliderBaseline: SimulationColliderDefinition[] | null;
+    /**
+     * Set when {@link GameEntity.setScale} has scaled the render object but the
+     * colliders have not been rebuilt yet. Cleared by
+     * {@link commitColliderScale}.
+     */
+    colliderScaleDirty: boolean;
     /** All collider descriptions for this entity (including primary) */
     colliderDescs: SimulationColliderDefinition[];
     /** Additional meshes for compound visual entities (added via add()) */
@@ -499,6 +420,8 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
     private trackAddedComponents;
     private trackedComponents;
     transformStore: TransformState;
+    /** Absolute scale, authored by the editor. Unit scale until changed. */
+    private _scale;
     /** Hide render target until spawn placement is confirmed. */
     _spawnPlacementPending: boolean;
     /** Author passed `position` in create options. */
@@ -570,6 +493,17 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
             w: number;
         };
     }): boolean;
+    /** Current absolute scale. */
+    getScale(): Vec3;
+    /**
+     * Set absolute scale on the render object.
+     *
+     * Colliders are *not* resized here — they are baked into the wasm
+     * simulation and can only be replaced by respawning the body, which is far
+     * too costly to do per drag frame. The entity is flagged instead, and
+     * {@link commitColliderScale} rebuilds them once the gesture commits.
+     */
+    setScale(x: number, y: number, z: number): void;
     /**
      * Add meshes, collision components, or child entities to this entity.
      * Supports fluent chaining: `entity.add(boxMesh()).add(boxCollision())`.
@@ -687,4 +621,4 @@ declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implem
  */
 declare function create(options?: Partial<GameEntityOptions>): GameEntity<GameEntityOptions>;
 
-export { type Action as A, BaseNode as B, type CollisionComponent as C, EntityMeshBuilder as D, EntityBuilder as E, EntityCollisionBuilder as F, GameEntity as G, type NodeInterface as N, type GameEntityOptions as a, boxCollision as b, create as c, coneCollision as d, cylinderCollision as e, pillCollision as f, planeCollision as g, rotateYEuler as h, rotateEuler as i, rotateX as j, rotateY as k, rotateZ as l, setRotationY as m, setRotationX as n, setRotationZ as o, pyramidCollision as p, setRotationDegrees as q, rotateInDirection as r, sphereCollision as s, setRotationDegreesY as t, setRotationDegreesX as u, setRotationDegreesZ as v, setRotation as w, getRotation as x, GameEntityLifeCycle as y, zoneCollision as z };
+export { type Action as A, EntityMeshBuilder as B, type CollisionComponent as C, EntityCollisionBuilder as D, EntityBuilder as E, GameEntity as G, type GameEntityOptions as a, boxCollision as b, create as c, coneCollision as d, cylinderCollision as e, pillCollision as f, planeCollision as g, rotateYEuler as h, rotateEuler as i, rotateX as j, rotateY as k, rotateZ as l, setRotationY as m, setRotationX as n, setRotationZ as o, pyramidCollision as p, setRotationDegrees as q, rotateInDirection as r, sphereCollision as s, setRotationDegreesY as t, setRotationDegreesX as u, setRotationDegreesZ as v, setRotation as w, getRotation as x, GameEntityLifeCycle as y, zoneCollision as z };

package/dist/{entity-type-map-COHu4fkW.d.ts → entity-type-map-CkkFMSrL.d.ts}

@@ -1,10 +1,11 @@
 import { Vector3, Sprite, Texture, Color, Object3D, ColorRepresentation, Light, Fog, FogExp2, Scene, Raycaster } from 'three';
-import { G as GameEntity, a as GameEntityOptions, B as BaseNode } from './entity-BI7cSlK8.js';
-import { d as Vec3Components, e as Vec3Input, b as Vec2Input } from './vector-DPbwlzgG.js';
+import { B as BaseNode } from './base-node-idopiSw5.js';
+import { G as GameEntity, a as GameEntityOptions } from './entity-XZNGBeca.js';
+import { d as Vec3Components, e as Vec3Input, b as Vec2Input } from './vector-D3eDzvcA.js';
 import { U as UpdateContext, a as SetupContext, D as DestroyContext, l as CleanupContext } from './base-node-life-cycle-BK9xebT9.js';
-import { T as TexturePath, e as MaterialOptions } from './material-BKPYeBC6.js';
+import { T as TexturePath, e as MaterialOptions } from './material-CxxAyJYp.js';
 import { Simulation } from '@zylem/behaviors/core';
-import { E as Entity } from './entity-DDks47JB.js';
+import { E as Entity } from './entity-BIf_a4dl.js';
 import { ParticleEmitterBehaviorOptions, ParticleEffectDefinition, ParticleEmitterHandle } from '@zylem/behaviors/particle-emitter';
 import { Line2 } from 'three/addons/lines/webgpu/Line2.js';
 

package/dist/entity.d.ts

@@ -1,16 +1,18 @@
-export { A as ACTOR_TYPE, a0 as AmbientLightOptions, B as BOX_TYPE, E as CONE_TYPE, K as CYLINDER_TYPE, C as CollisionShapeType, D as DISK_TYPE, a2 as DirectionalLightOptions, ak as EntityForType, aj as EntityTypeMap, a8 as FOG_TYPE, a1 as HemisphereLightOptions, _ as LIGHT_TYPE, ab as LINE_TYPE, a5 as LightShadowOptions, ae as LinePickResult, o as OnEnterParams, p as OnExitParams, O as OnHeldParams, V as PARTICLE_SYSTEM_TYPE, N as PILL_TYPE, P as PLANE_TYPE, H as PYRAMID_TYPE, a3 as PointLightOptions, R as RECT_TYPE, S as SPHERE_TYPE, f as SPRITE_TYPE, a4 as SpotLightOptions, h as SpriteAnimation, g as SpriteImage, i as SpriteSheet, T as TEXT_TYPE, n as ZONE_TYPE, r as ZylemActor, Z as ZylemBox, z as ZylemCone, J as ZylemCylinder, x as ZylemDisk, a7 as ZylemFog, ah as ZylemFogHeightOptions, ai as ZylemFogNoiseOptions, af as ZylemFogOptions, ag as ZylemFogType, Y as ZylemLight, $ as ZylemLightOptions, aa as ZylemLine, ad as ZylemLineOptions, U as ZylemParticleSystem, W as ZylemParticleSystemOptions, M as ZylemPill, k as ZylemPlane, G as ZylemPyramid, v as ZylemRect, b as ZylemSphere, e as ZylemSprite, t as ZylemText, m as ZylemZone, q as createActor, c as createBox, y as createCone, I as createCylinder, w as createDisk, a6 as createFog, X as createLight, a9 as createLine, Q as createParticleSystem, L as createPill, j as createPlane, F as createPyramid, u as createRect, a as createSphere, d as createSprite, s as createText, l as createZone, ac as pickZylemLine } from './entity-type-map-COHu4fkW.js';
-import { G as GameEntity, a as GameEntityOptions, E as EntityBuilder, D as EntityMeshBuilder, F as EntityCollisionBuilder, B as BaseNode } from './entity-BI7cSlK8.js';
-export { C as CollisionComponent, b as boxCollision, d as coneCollision, c as create, e as cylinderCollision, f as pillCollision, g as planeCollision, p as pyramidCollision, s as sphereCollision, z as zoneCollision } from './entity-BI7cSlK8.js';
+export { A as ACTOR_TYPE, a0 as AmbientLightOptions, B as BOX_TYPE, E as CONE_TYPE, K as CYLINDER_TYPE, C as CollisionShapeType, D as DISK_TYPE, a2 as DirectionalLightOptions, ak as EntityForType, aj as EntityTypeMap, a8 as FOG_TYPE, a1 as HemisphereLightOptions, _ as LIGHT_TYPE, ab as LINE_TYPE, a5 as LightShadowOptions, ae as LinePickResult, o as OnEnterParams, p as OnExitParams, O as OnHeldParams, V as PARTICLE_SYSTEM_TYPE, N as PILL_TYPE, P as PLANE_TYPE, H as PYRAMID_TYPE, a3 as PointLightOptions, R as RECT_TYPE, S as SPHERE_TYPE, f as SPRITE_TYPE, a4 as SpotLightOptions, h as SpriteAnimation, g as SpriteImage, i as SpriteSheet, T as TEXT_TYPE, n as ZONE_TYPE, r as ZylemActor, Z as ZylemBox, z as ZylemCone, J as ZylemCylinder, x as ZylemDisk, a7 as ZylemFog, ah as ZylemFogHeightOptions, ai as ZylemFogNoiseOptions, af as ZylemFogOptions, ag as ZylemFogType, Y as ZylemLight, $ as ZylemLightOptions, aa as ZylemLine, ad as ZylemLineOptions, U as ZylemParticleSystem, W as ZylemParticleSystemOptions, M as ZylemPill, k as ZylemPlane, G as ZylemPyramid, v as ZylemRect, b as ZylemSphere, e as ZylemSprite, t as ZylemText, m as ZylemZone, q as createActor, c as createBox, y as createCone, I as createCylinder, w as createDisk, a6 as createFog, X as createLight, a9 as createLine, Q as createParticleSystem, L as createPill, j as createPlane, F as createPyramid, u as createRect, a as createSphere, d as createSprite, s as createText, l as createZone, ac as pickZylemLine } from './entity-type-map-CkkFMSrL.js';
+import { G as GameEntity, a as GameEntityOptions, E as EntityBuilder, B as EntityMeshBuilder, D as EntityCollisionBuilder } from './entity-XZNGBeca.js';
+export { C as CollisionComponent, b as boxCollision, d as coneCollision, c as create, e as cylinderCollision, f as pillCollision, g as planeCollision, p as pyramidCollision, s as sphereCollision, z as zoneCollision } from './entity-XZNGBeca.js';
 import { Color, Mesh } from 'three';
-import { b as Vec2Input, e as Vec3Input } from './vector-DPbwlzgG.js';
-import { e as MaterialOptions } from './material-BKPYeBC6.js';
+import { B as BaseNode } from './base-node-idopiSw5.js';
+import { b as Vec2Input, e as Vec3Input } from './vector-D3eDzvcA.js';
+import { e as MaterialOptions } from './material-CxxAyJYp.js';
 import './base-node-life-cycle-BK9xebT9.js';
 import './stage-transition-CmGpV4tc.js';
 import '@zylem/behaviors/core';
-import './entity-DDks47JB.js';
+import './entity-BIf_a4dl.js';
+import './simulation-body-zQw-emOr.js';
 import '@zylem/behaviors/particle-emitter';
 import 'three/addons/lines/webgpu/Line2.js';
-import './collision-builder-4TVDzXsp.js';
+import './collision-builder-BckxkdmA.js';
 import './events.js';
 import 'mitt';
 import 'three/webgpu';