Changelog

What changed between runtime versions. Scripts pin to the version they were written against, so older experiences keep running unchanged. See the Migration Guide when you move an experience forward.

0.2.0 Beta

A large, mostly additive release. Highlights:

New APIs

• Location – read the device location from a script via environment.location (requestAccess, current, watch, precise-accuracy opt-in) with a GeoCoordinate type carrying distanceTo / bearingTo helpers.
• Paths / splines – scene.createPath({ points }) builds a runtime spline; drive an object along it with entity.followPath(path, { duration, constantSpeed, alignsToTangent }).
• Mesh instancing – render thousands of copies of one object with rep.setInstances(Instances.transforms([...])) (rendering-only; far cheaper than cloning).
• Compute kernels – run GPU compute from a script: Kernel.fromSource / Kernel.fromAsset, Buffer handles, Texture.compute, and mesh.runCompute(...).
• Dynamic meshes – build and update geometry at runtime with createMesh(...), writeVertices / writeIndices, and per-frame draw-range updates.
• User interface – author panels from a script with createPanel(...) and the UI.* builders (label, slider, stacks, …), live ${var} label interpolation, findView, and property binding. (Beta.)
• Materials – inline material factories: Material.pbr(...), Material.unlit(...), Material.occlusion(...), Material.customShader(...), Material.materialX(...), Material.video(...), with web-standard property names and texture maps.
• Screen gestures – scene.on('pan' | 'pinch' | 'rotate') with velocity (the raw input for mechanics like flick-to-launch), entity.on('doubleTap' | 'longPress'), per-object camera-claim arbitration, and environment.deviceCategory. iPhone / iPad / Mac only – gate with environment.features.has('screenGestures').
• Physics primitives – entity.applyImpulse, applyAngularImpulse, setVelocity / setAngularVelocity, and the .physics({...}) trait for giving an object a body.
• Gestures trait – the typed .gestures({...}) API, including releaseBehavior (stay / reset / momentum) for drag-and-release mechanics.
• Live value views – write through vector components directly, e.g. entity.position.x = 2.
• Tracking providers – opt into hand tracking and read articulated joint transforms without planting a hand-anchored element: scene.tracking.hands (enable, left / right, anchors), plus scene.tracking.face for blendshapes / eye transforms. Gate with environment.features.has('handTracking'). (Apple Vision Pro.)
• Cross-platform surface input – scene.createSurfaceInput({ target }) yields interaction points on a surface in its own local frame, using fingertips on Apple Vision Pro and screen taps / drags elsewhere – the same points either way, so your logic never branches on platform.
• Authored object descriptors – read and adjust an object you built in the editor before it's shown: scene.getObjectDescriptor(nameOrId) → edit with the trait methods / .asset(...) (swap a model or video source) / .representation(...) (swap the whole visual) → scene.setObjectDescriptor(...). Plus descriptor.clone() (fresh-id copy for spawning variants) and read-only descriptor.id / descriptor.kind.

Changed

• Traits flattened onto the descriptor. The trait configurators are now direct chainable methods – createSphere(0.05).physics({...}).material(...).shadow({...}) – instead of the .traits(t => …) callback. .traits(fn) still works but is deprecated; see the Migration Guide.
• Options-object substrate for primitive factories, e.g. createBox(w, h, d, r, { physics, material, … }).

0.1.0

Initial scripting runtime.