lecodes-sdk 1.1.0 → 2.0.0

package/src/gl/touch.ts

@@ -2,17 +2,18 @@
 // the struck Node and to the active scene's listeners. Ported from worker/src/TouchEventSystem.ts.
 
 import { ClickEvent, TouchStartEvent, type TrackHandler } from "../runtime/touch"
-import { nodeRegistry } from "./Node"
+import { ensureEmitter, setSceneTouchHandlers } from "../ui/tree"
+import { nodes } from "./Node"
 import { glState } from "./state"
 
 // Hits inside a loaded model (GLB) land on sub-entities the user never created a Node for — walk up
 // the transform hierarchy to the nearest entity someone actually holds (the model's Node).
 const resolveHitNode = (entityId: number) => {
-  let node = nodeRegistry.get(entityId)
+  let node = nodes.get(entityId)
   for (let id = entityId, i = 0; !node && i < 32; i++) {
     id = _creator.getParent(id)
     if (id === 0) break
-    node = nodeRegistry.get(id)
+    node = nodes.get(id)
   }
   return node ?? null
 }
@@ -53,16 +54,14 @@ const onTouchStart = (pointerId: number, clientX: number, clientY: number, entit
   return null
 }
 
-let touchStartRegistered = false
-export const registerTouchStartEvent = (): void => {
-  if (touchStartRegistered) return
-  touchStartRegistered = true
-  _creatorUI.registerTouchStartEvent(onTouchStart)
-}
-
-let touchEndRegistered = false
-export const registerTouchEndEvent = (): void => {
-  if (touchEndRegistered) return
-  touchEndRegistered = true
-  _creatorUI.registerTouchEndEvent(onTouchEnd)
+// The scene-level pointer dispatch rides the tree emitter (TREE_EVENT_SCENE_TOUCH_START / SCENE_CLICK):
+// installed once, on the first listener.
+let registered = false
+const register = (): void => {
+  if (registered) return
+  registered = true
+  ensureEmitter()
+  setSceneTouchHandlers(onTouchStart, onTouchEnd)
 }
+export const registerTouchStartEvent = register
+export const registerTouchEndEvent = register

package/src/host.d.ts

@@ -1,6 +1,5 @@
 // JS-runtime globals provided by the host engine (web viewer / desktop / iOS), NOT by the SDK.
-// Declared only so SDK and user code type-check — never bundled or injected. Mirrors
-// packages/projects/src/global.d.ts.
+// Declared only so SDK and user code type-check — never bundled or injected.
 
 declare global {
   function setTimeout(handler: (...args: any[]) => void, timeout?: number): number
@@ -57,7 +56,7 @@ declare global {
    *  `Style<typeof myButton>`) is what you'd pass to `el.style(...)` — for typing reusable style
    *  presets. Deliberately no `Partial<>` wrapper: every style prop is already optional, and
    *  Partial over ClassStyles' `$`-index signature adds `| undefined`, breaking assignability back
-   *  into `.style(...)`. Round-trip guarded by sdk/tests/ui-types.test.ts. */
+   *  into `.style(...)`. Round-trip guarded by sdk/tests/ui/types.test.ts. */
   type Style<T> = T extends { style: (s: infer S) => any } ? S : never
 }
 

package/src/inject.editor.ts

@@ -0,0 +1,7 @@
+// The SECOND inject module of an editor bundle (a compile with `editor: true` — bundler.ts adds it
+// after inject.ts): what a scene editor's in-world half may name and an app may not. A shipped
+// bundle is compiled without it, so nothing here can reach one.
+//
+// Same rule as inject.ts: the only file that exports these names.
+
+export { sceneEditor as __sceneEditor, type SceneEditorApi } from "./scene/editor"

package/src/inject.ts

@@ -1,236 +1,233 @@
-// THE aggregation point. Every public global the SDK provides is re-exported here under the exact
-// name user code uses it as. The bundler passes this file to esbuild's `inject:` option, so user
-// code references `Scene`, `Sprite`, `toast`, … with no imports; esbuild tree-shakes away whatever
-// a given project does not use (so a pure-2D project drops all 3D classes, and vice versa).
-//
-// Rule: this is the ONLY file that `export`s public names. Everything else is internal and imported
-// by it. Host-provided globals (setLoop, console, setTimeout, DEG2RAD, asset, …) are NOT here —
-// they live in src/host.d.ts as declarations and stay as free references at runtime.
-
-// ---- math ----
-export { Mathf } from "./math/Mathf"
-export { Vec2, Vec3 } from "./math/vec"
-export { Quat } from "./math/quat"
-export { Mat4 } from "./math/mat4"
-export { Color } from "./core/color"
-
-// ---- aspects (attachable node capabilities) ----
-export { Aspect, System, type With, type SystemHost } from "./core/Aspect"
-export { type EventMap } from "./core/events"
-export { Time } from "./core/time"
-export { StateMachine, defineStates, type StateDef, type StatesDef, type StateGuard, type StateHandler, type StateMachineEvents } from "./core/StateMachine"
-export { InspectorUI } from "./core/InspectorUI"
-
-// ---- reactivity (signals; UI text/style props also accept `() => value` bindings) ----
-export { signal, computed, effect, type Signal, type Computed } from "./core/signals"
-export { __compWrite, __compOp, type CompAxis, type CompWriter } from "./core/compWrite"
-
-// ---- canvas (core 2D drawing that bakes to a texture; shared by 2D/3D/UI) ----
-export { Canvas, Bitmap } from "./canvas/Canvas"
-
-// ---- platform runtime (injected globals; the host provides the lower-level _creator* bridges) ----
-export { toast, openURL, SvgSource } from "./runtime/misc"
-export { app, type AppState, type OrientationLock } from "./runtime/app"
-export { clipboard } from "./runtime/clipboard"
-export { date, type DateValue, type DateInput, type Unit, type Locale } from "./runtime/datetime"
-export { fetch, fetchLocal, FormData, File, type FetchResponse } from "./runtime/fetch"
-export { localStorage } from "./runtime/storage"
-export { device, type HapticStyle, type MotionOptions } from "./runtime/device"
-export { Input, InputChannel, type InputKeyEvent, type InputGamepadEvent, type InputEventName, type GamepadState, type GamepadAxisName } from "./runtime/input"
-export { WebSocket } from "./runtime/net"
-// Multiplayer (docs/multiplayer-plan.md): roles, players, JSON messages over the _creatorNet transport.
-export { Net, NetPlayer, Replicated, NetEntity, type NetMessage, type NetRole, type NetStatus, type NetEvents, type NetLaunch, type NetInput, type NetKind, type NetTransform } from "./net"
-// App-backend transport: the compiler-generated stubs of `*.server.ts` modules call these; user code
-// only ever imports its server functions (docs/backend-plan.md §4).
-export { __rpc, __channel, __serverOnly, RpcError, type ClientChannel } from "./runtime/rpc"
-export { AudioPlayer, VideoPlayer } from "./runtime/media"
-// Game audio (docs/audio-plan.md): decoded clips, a voice pool, buses with effects; 3D through the
-// AudioSource / AudioZone aspects (gl/) and scene.audio.
-export { Sound, type SoundOptions } from "./audio/Sound"
-export { Voice, type VoiceEvents } from "./audio/Voice"
-export { Bus, REVERB_PRESETS, type ReverbPreset, type ReverbParams, type EchoParams } from "./audio/Bus"
-export { audio, type PlaySoundOptions, type SpatialOptions, type Rolloff, type AudioStats } from "./audio/audio"
-export { openFilePicker, files, type FileData } from "./runtime/files"
-export { share } from "./runtime/share"
-export { ClickEvent, TouchStartEvent, LongPressEvent } from "./runtime/touch"
-
-// ---- 2D engine (creator-2d) ----
-export { Scene2D } from "./g2/Scene2D"
-export { Node2D } from "./g2/Node2D"
-export { Camera2D } from "./g2/Camera2D"
-export { Sprite } from "./g2/Sprite"
-export { SpriteAnimation } from "./g2/SpriteAnimation"
-export { Shape2D } from "./g2/Shape2D"
-export { Physics2D } from "./g2/Physics2D"
-export { Trigger2D } from "./g2/Trigger2D"
-export { CharacterController2D } from "./g2/CharacterController2D"
-export { OneWay2D } from "./g2/OneWay2D"
-export { PhysicsGroup2D } from "./g2/groups2d"
-export { Tilemap } from "./g2/Tilemap"
-export { Texture2D } from "./g2/Texture2D"
-// sprite sheets as data (.sprite.ts files — see src/g2/SpriteSheet.ts)
-export { SpriteSheet, defineSpriteSheet } from "./g2/SpriteSheet"
-export type { SpriteSheetDef, SheetSprite, SpriteMakeOptions } from "./g2/SpriteSheet"
-// tilesets as data (.tiles.ts files — autotile materials, see src/g2/Tileset.ts + autotile.ts)
-export { Tileset, defineTileset, Autotile2D } from "./g2/Tileset"
-export { rawCell, isRawCell, rawIndex } from "./g2/autotile"
-export { rot90, rot180, rot270, flipX, packTile, tileIndex, tileTurns, tileFlip, tileOriented } from "./g2/autotile"
-export type {
-  TilesetDef, TileMaterial, PatchMaterial, PathMaterial, PatchSlots, EdgeSlot, FillBlock, BlockEntry,
-  TileBlock, TilePart,
-} from "./g2/autotile"
-// 2D scenes as data (.scene2d.ts files — see src/g2/defineScene2d.ts) + the cells('…') payload
-export { defineScene2d, Scene2dHandle } from "./g2/defineScene2d"
-export type { Scene2dDef, Scene2dNodeDef, Scene2dEnv, SpriteSourceDef, TilemapSourceDef, Camera2dNodeDef, LoadedScene2d } from "./g2/defineScene2d"
-export { cells, encodeCells, type CellsData } from "./g2/cells"
-// no-code 2D scenario aspects (attachable in scene files — see src/g2/scenarios2d.ts)
-export { CameraFollow } from "./g2/scenarios2d"
-
-// ---- UI (creator-ui) ----
-export {
-  UIScreen, type UIScreenStyle,
-  UIRow, UIColumn, UIBox, type UIContainerStyle,
-  UIText, type UITextStyle,
-  UIButton, type UIButtonStyle,
-  UIImage, type UIImageStyle,
-  UIVideo, type UIVideoStyle,
-  UIInput, UITextArea, type UIInputStyle,
-  UIScrollable, type UIScrollableStyle,
-  UIPager, type UIPagerStyle,
-  UITabs, type UITabDef,
-  defineTabs, type TabDef, type TabsHandle,
-  UIWidget, type UIWidgetStyle,
-  UIModal, type UIModalStyle,
-  UIBottomSheet, type UIBottomSheetStyle,
-  UIPopover, type UIPopoverStyle,
-  UISpacer, type UISpacerStyle,
-  UIVirtualizedList,
-  Router,
-  NativeView, type UINativeViewStyle,
-  registerFont,
-  __uiMap,
-  __UIColumn, __UIRow, __UIBox, __UIButton, __UIScreen, __UIScrollable, __UIWidget,
-} from "./ui/UI"
-// The Presentable navigation contract (docs/navigation-presentable-plan.md). `Presentable` is
-// interface + runtime companion (declaration merging): `Presentable.current` = what's on screen.
-export { Presentable } from "./ui/UI"
-export type { PresentOptions, Transition, TransitionName, TransitionSpec, TransitionTransform } from "./ui/UI"
-// The base node type + the union a container accepts as children — documented as the signature of
-// UIColumn/UIRow/append/etc., so they must be global (type-only; erased at runtime).
-export type { UINode, UINodeChild } from "./ui/UINode"
-// App theme variables (docs/ui-theme-plan.md): theme({...}) merges + returns typed var()
-// accessors; system vars are static props (theme.primaryColor, theme["comfort-top"], …).
-export { theme, type ThemeValues, type ThemeAccessors } from "./ui/theme"
-
-// ---- animate ----
-// animate() runs on the keyframe core (a VALUE track) since 2026-09-14: same handle, easing and clocks
-// as animateTo; stop / pause / resume are the handle's methods, a matrix is just a value kind.
-export { animate, type AnimateOptions, type AnimateValue, type AnimateOut } from "./animate/tween/animateValue"
-export { cubicBezier } from "./animate/bezier"
-// Keyframe animation core (docs/timeline-plan.md): the handle `animateTo` / `animateFrom` return,
-// and `Timeline()` — choreography over UI elements, 3D / 2D nodes, lights and cameras.
-export { Timeline, type TimelineOptions, type TimelineAddOptions, type TimelinePosition } from "./animate/tween/Timeline"
-export { type Animation } from "./animate/tween/Animation"
-export { type TweenMeta } from "./animate/tween/spec"
-export { type EasingInput } from "./animate/tween/easing"
-export { easeIn, easeOut, easeInOut } from "./animate/easings"
-
-// ---- plugins (optional, host-provided capabilities — typed NativeView/service wrappers, see src/plugins/) ----
-export { QRScanner } from "./plugins/qr"
-export { CameraView, type CameraFacing } from "./plugins/camera"
-export { Geolocation, type GeoPosition, type GeoOptions, type GeoWatch } from "./plugins/geolocation"
-export {
-  MapView, type MapOptions, type MapStyle, type MapStyleName, type MapCamera, type MapTap, type LngLat, type CameraMove, type FitOptions,
-  type MapPaddingValues, type MarkerItem, type MarkerTap, type MarkerLayer, type MarkerLayerOptions,
-  type LineLayer, type LineLayerOptions, type UserLocationOptions,
-} from "./plugins/map"
-export { Push, type PushPayload, type PushStatus, type PushRegisterOptions, type PushEvent } from "./plugins/push"
-export { OAuth, type OAuthCredential, type OAuthProviderName } from "./plugins/oauth"
-export { Service } from "./plugins/service"
-
-// ---- scenes as data (.scene.ts files — see src/scene/defineScene.ts) ----
-export { defineScene, use, ref, make, SceneHandle, applyEditorPose as __applyEditorPose } from "./scene/defineScene"
-export {
-  defineMaterial, MaterialHandle,
-  // editor-harness helpers (the scene editor's live material paths — not app API)
-  assignMaterialDef as __assignMaterialDef, applyMaterialParam as __applyMaterialParam,
-} from "./scene/material"
-export type { MaterialData, MaterialParamValue, ShaderMaterialDef, LitMaterialDef, UnlitMaterialDef } from "./scene/material"
-export type { SceneDef, SceneNodeDef, MeshDef, LightDef, MaterialDef, CameraNodeDef, AspectEntry, MakeEntry, LoadedScene, SceneInstance } from "./scene/defineScene"
-export { CameraPlace } from "./gl/CameraPlace"
-// Procedural placement for large maps (line/grid/ring/scatter/place) — built for make() factories.
-export { Level } from "./scene/level"
-export type { LevelSpot, LevelBuild, LevelCollider, LevelLineOptions, LevelGridOptions, LevelRingOptions, LevelScatterOptions, LevelPlaceOptions } from "./scene/level"
-export type { FieldMeta } from "./core/fields"
-// Editor-only line drawing from generator rebuild() / make() factories / tool hooks — drawn by the
-// scene editor's viewport overlay, a no-op everywhere else (see src/scene/gizmos.ts).
-export { Gizmos, GizmoBuffer as __GizmoBuffer, withGizmoScope as __withGizmoScope } from "./scene/gizmos"
-export type { GizmoStyle, GizmoAnchor } from "./scene/gizmos"
-
-// ---- no-code scenario aspects (attachable in the scene editor — see src/gl/scenarios.ts) ----
-export { MoveTo, FollowPath, Spin, LookAt, PlayAnimation } from "./gl/scenarios"
-
-// ---- editor plugins (called from `*.editor.ts` files — editor bundles only; DCE'd from apps) ----
-export { registerEditorWindow, registerEditorTool, __editorPlugins } from "./scene/editorPlugins"
-export type { EditorApi, EditorRayHit, EditorToolHooks, EditorWindowFn } from "./scene/editorPlugins"
-
-// ---- 3D engine (creator-gl) ----
-export { Scene, ARScene, VRScene } from "./gl/Scene"
-export { Node } from "./gl/Node"
-export { Mesh } from "./gl/Mesh"
-export { Model } from "./gl/Model"
-export { Shape } from "./gl/physics/Shape"
-export { Physics } from "./gl/physics/Physics"
-export { Trigger } from "./gl/physics/Trigger"
-export { AudioSource, type AudioCone } from "./gl/audio/AudioSource"
-export { AudioZone } from "./gl/audio/AudioZone"
-export { SceneAudio } from "./gl/audio/SceneAudio"
-export { CharacterController } from "./gl/physics/CharacterController"
-export { Vehicle } from "./gl/vehicle/Vehicle"
-export type { DriveLayout, DifferentialMode, EngineConfig, SteeringConfig, SteeringFeedback, SteeringDriver, AeroConfig } from "./gl/vehicle/Vehicle"
-export { Wheel, Tire, resolveTire } from "./gl/vehicle/Wheel"
-export { Ragdoll } from "./gl/physics/Ragdoll"
-export type { RagdollPart, RagdollHinge, RagdollFacing, RagdollActivateOptions, RagdollDeactivateOptions, RagdollHitOptions } from "./gl/physics/Ragdoll"
-export type { Point, WheelSuspension } from "./gl/vehicle/Wheel"
-export { AnimationClip } from "./gl/animation/AnimationClip"
-export type { ClipDef, ClipTrackDef, ClipKey } from "./gl/animation/AnimationClip"
-export { Animator } from "./gl/animation/Animator"
-export type { LodMode } from "./gl/animation/Animator"
-export type { TrianglePick } from "./gl/Model"
-export { Feet } from "./gl/animation/Feet"
-export type { FeetOptions, FootState } from "./gl/animation/Feet"
-export { Warp } from "./gl/animation/Warp"
-export type { WarpOptions, StepWarpOptions } from "./gl/animation/Warp"
-export { Playback } from "./gl/animation/Playback"
-export { Loop } from "./gl/animation/Loop"
-export { Layer } from "./gl/animation/Layer"
-export type { PlayOptions, StopOptions, LayerOptions, LoopOptions, LoopDef, BlendPosition, BlendMember, ActiveClip, ClipInfo, ClipCycle, ClipAlign, KneeAxisReport, StepHandler, ClipEventHandler } from "./gl/animation/core"
-export { IK } from "./gl/animation/IK"
-export { DynamicBone, DynamicBoneCollider } from "./gl/animation/DynamicBone"
-export type { DynamicBoneCurve, DynamicBoneFloor, DynamicBoneColliders } from "./gl/animation/DynamicBone"
-export type { IKTwoBone, IKLookAt } from "./gl/animation/IK"
-export { Light } from "./gl/Light"
-export { Lightmap } from "./gl/Lightmap"
-export { Foliage } from "./gl/Foliage"
-export type { FoliageOptions, FoliageWind } from "./gl/Foliage"
-export { Terrain } from "./gl/terrain/Terrain"
-export type { TerrainOptions, TerrainLayer, TerrainRegion, ConformOptions, RibbonOptions, AutoPaintRules, SculptOptions, TerrainHit, TerrainSnapshot } from "./gl/terrain/Terrain"
-export { NavMesh, NavCrowd } from "./gl/nav/NavMesh"
-export type { NavMeshLoadOptions, NavMeshInfo, NavPath, NavQueryOptions, NavRaycastHit, NavAgentSize } from "./gl/nav/NavMesh"
-export { NavAgent } from "./gl/nav/NavAgent"
-export type { NavAgentState, NavAgentAvoidance, NavAgentDrive, NavAgentEvents } from "./gl/nav/NavAgent"
-export { Locomotion } from "./gl/animation/Locomotion"
-export type { LocomotionSet, LocomotionClip, LocomotionTuning, LocomotionState, LocomotionEvents, Displacement, Gait } from "./gl/animation/Locomotion"
-export { Material } from "./gl/Material"
-export { Geometry } from "./gl/Geometry"
-export { InstancedMesh } from "./gl/InstancedMesh"
-export type { InstanceTransform } from "./gl/InstancedMesh"
-export { Texture } from "./gl/Texture"
-export type { TextureLoadOptions } from "./gl/Texture"
-export { Camera } from "./gl/Camera"
-export { Ray } from "./gl/Ray"
-export { Plane } from "./gl/Plane"
-export { Noise } from "./gl/Noise"
-export { Particles, Trail, curve, colorCurve } from "./gl/Particles"
-export { DecalSet, DecalTrail } from "./gl/DecalSet"
-export type { DecalOptions, DecalSetOptions, DecalSpawnOptions, DecalPlacement, DecalTrailOptions } from "./gl/DecalSet"
+// THE aggregation point. Every public global the SDK provides is re-exported here under the exact
+// name user code uses it as. The bundler passes this file to esbuild's `inject:` option, so user
+// code references `Scene`, `Sprite`, `toast`, … with no imports; esbuild tree-shakes away whatever
+// a given project does not use (so a pure-2D project drops all 3D classes, and vice versa).
+//
+// Rule: this is the ONLY file that `export`s public names. Everything else is internal and imported
+// by it. Host-provided globals (setLoop, console, setTimeout, DEG2RAD, asset, …) are NOT here —
+// they live in src/host.d.ts as declarations and stay as free references at runtime.
+
+// ---- math ----
+export { Mathf } from "./math/Mathf"
+export { Vec2, Vec3 } from "./math/vec"
+export { Quat } from "./math/quat"
+export { Mat4 } from "./math/mat4"
+export { Color } from "./core/color"
+
+// ---- aspects (attachable node capabilities) ----
+export { Aspect, System, type With, type SystemHost } from "./core/Aspect"
+export { type EventMap } from "./core/events"
+export { Time } from "./core/time"
+export { StateMachine, defineStates, type StateDef, type StatesDef, type StateGuard, type StateHandler, type StateMachineEvents } from "./core/StateMachine"
+export { InspectorUI } from "./core/InspectorUI"
+
+// ---- reactivity (signals; UI text/style props also accept `() => value` bindings) ----
+export { signal, computed, effect, type Signal, type Computed } from "./core/signals"
+export { __compWrite, __compOp, type CompAxis, type CompWriter } from "./core/compWrite"
+
+// ---- canvas (core 2D drawing that bakes to a texture; shared by 2D/3D/UI) ----
+export { Canvas, Bitmap } from "./canvas/Canvas"
+
+// ---- platform runtime (injected globals; the host provides the lower-level _creator* bridges) ----
+export { toast, openURL, SvgSource } from "./runtime/misc"
+export { app, type AppState, type OrientationLock } from "./runtime/app"
+export { clipboard } from "./runtime/clipboard"
+export { date, type DateValue, type DateInput, type Unit, type Locale } from "./runtime/datetime"
+export { fetch, fetchLocal, FormData, File, type FetchResponse } from "./runtime/fetch"
+export { localStorage } from "./runtime/storage"
+export { device, type HapticStyle, type MotionOptions } from "./runtime/device"
+export { Input, InputChannel, type InputKeyEvent, type InputGamepadEvent, type InputEventName, type GamepadState, type GamepadAxisName } from "./runtime/input"
+export { WebSocket } from "./runtime/net"
+// Multiplayer (docs/multiplayer-plan.md): roles, players, JSON messages over the _creatorNet transport.
+export { Net, NetPlayer, Replicated, NetEntity, type NetMessage, type NetRole, type NetStatus, type NetEvents, type NetLaunch, type NetInput, type NetKind, type NetTransform } from "./net"
+// App-backend transport: the compiler-generated stubs of `*.server.ts` modules call these; user code
+// only ever imports its server functions (docs/backend-plan.md §4).
+export { __rpc, __channel, __serverOnly, RpcError, type ClientChannel } from "./runtime/rpc"
+export { AudioPlayer, VideoPlayer } from "./runtime/media"
+// Game audio (docs/audio-plan.md): decoded clips, a voice pool, buses with effects; 3D through the
+// AudioSource / AudioZone aspects (gl/) and scene.audio.
+export { Sound, type SoundOptions } from "./audio/Sound"
+export { Voice, type VoiceEvents } from "./audio/Voice"
+export { Bus, REVERB_PRESETS, type ReverbPreset, type ReverbParams, type EchoParams } from "./audio/Bus"
+export { audio, type PlaySoundOptions, type SpatialOptions, type Rolloff, type AudioStats } from "./audio/audio"
+export { openFilePicker, files, type FileData } from "./runtime/files"
+export { share } from "./runtime/share"
+export { ClickEvent, TouchStartEvent, LongPressEvent, MouseEnterEvent } from "./runtime/touch"
+
+// ---- 2D engine (creator-2d) ----
+export { Scene2D } from "./g2/Scene2D"
+export { Node2D } from "./g2/Node2D"
+export { Camera2D } from "./g2/Camera2D"
+export { Sprite } from "./g2/Sprite"
+export { SpriteAnimation } from "./g2/SpriteAnimation"
+export { Shape2D } from "./g2/Shape2D"
+export { Physics2D } from "./g2/Physics2D"
+export { Trigger2D } from "./g2/Trigger2D"
+export { CharacterController2D } from "./g2/CharacterController2D"
+export { OneWay2D } from "./g2/OneWay2D"
+export { PhysicsGroup2D } from "./g2/groups2d"
+export { Tilemap } from "./g2/Tilemap"
+export { Texture2D } from "./g2/Texture2D"
+// sprite sheets as data (.sprite.ts files — see src/g2/SpriteSheet.ts)
+export { SpriteSheet, defineSpriteSheet } from "./g2/SpriteSheet"
+export type { SpriteSheetDef, SheetSprite, SpriteMakeOptions } from "./g2/SpriteSheet"
+// tilesets as data (.tiles.ts files — autotile materials, see src/g2/Tileset.ts + autotile.ts)
+export { Tileset, defineTileset, Autotile2D } from "./g2/Tileset"
+export { rawCell, isRawCell, rawIndex } from "./g2/autotile"
+export { rot90, rot180, rot270, flipX, packTile, tileIndex, tileTurns, tileFlip, tileOriented } from "./g2/autotile"
+export type {
+  TilesetDef, TileMaterial, PatchMaterial, PathMaterial, PatchSlots, EdgeSlot, FillBlock, BlockEntry,
+  TileBlock, TilePart,
+} from "./g2/autotile"
+// 2D scenes as data (.scene2d.ts files — see src/g2/defineScene2d.ts) + the cells('…') payload
+export { defineScene2d, Scene2dHandle } from "./g2/defineScene2d"
+export type { Scene2dDef, Scene2dNodeDef, Scene2dEnv, SpriteSourceDef, TilemapSourceDef, Camera2dNodeDef, LoadedScene2d } from "./g2/defineScene2d"
+export { cells, encodeCells, type CellsData } from "./g2/cells"
+// no-code 2D scenario aspects (attachable in scene files — see src/g2/scenarios2d.ts)
+export { CameraFollow } from "./g2/scenarios2d"
+
+// ---- UI (creator-ui) ----
+export {
+  UIScreen, type UIScreenStyle,
+  UIRow, UIColumn, UIBox, type UIContainerStyle,
+  UIText, type UITextStyle,
+  UIButton, type UIButtonStyle,
+  UIImage, type UIImageStyle,
+  UIVideo, type UIVideoStyle,
+  UIInput, UITextArea, type UIInputStyle,
+  UIScrollable, type UIScrollableStyle,
+  UIPager, type UIPagerStyle,
+  UITabs, type UITabDef,
+  defineTabs, type TabDef, type TabsHandle,
+  UIWidget, type UIWidgetStyle,
+  UIModal, type UIModalStyle,
+  UIBottomSheet, type UIBottomSheetStyle,
+  UIPopover, type UIPopoverStyle,
+  UISpacer, type UISpacerStyle,
+  UIVirtualizedList,
+  Router,
+  NativeView, type UINativeViewStyle,
+  registerFont,
+  __uiMap,
+  __UIColumn, __UIRow, __UIBox, __UIButton, __UIScreen, __UIScrollable, __UIWidget,
+} from "./ui/UI"
+// The Presentable navigation contract (docs/navigation-presentable-plan.md). `Presentable` is
+// interface + runtime companion (declaration merging): `Presentable.current` = what's on screen.
+export { Presentable } from "./ui/UI"
+export type { DismissOptions, PresentOptions, Transition, TransitionName, TransitionPose, TransitionSpec } from "./ui/UI"
+// The base node type + the union a container accepts as children — documented as the signature of
+// UIColumn/UIRow/append/etc., so they must be global (type-only; erased at runtime).
+export type { UINode, UINodeChild } from "./ui/UINode"
+// App theme variables (docs/ui-theme-plan.md): theme({...}) merges + returns typed var()
+// accessors; system vars are static props (theme.primaryColor, theme["comfort-top"], …).
+export { theme, type ThemeValues, type ThemeAccessors } from "./ui/theme"
+
+// ---- animate ----
+// animate() runs on the keyframe core (a VALUE track) since 2026-09-14: same handle, easing and clocks
+// as animateTo; stop / pause / resume are the handle's methods, a matrix is just a value kind.
+export { animate, type AnimateOptions, type AnimateValue, type AnimateOut } from "./animate/tween/animateValue"
+export { cubicBezier } from "./animate/bezier"
+// Keyframe animation core (docs/timeline-plan.md): the handle `animateTo` / `animateFrom` return,
+// and `Timeline()` — choreography over UI elements, 3D / 2D nodes, lights and cameras.
+export { Timeline, type TimelineOptions, type TimelineAddOptions, type TimelinePosition } from "./animate/tween/Timeline"
+export { type Animation } from "./animate/tween/Animation"
+export { type TweenMeta } from "./animate/tween/spec"
+export { type EasingInput } from "./animate/tween/easing"
+export { easeIn, easeOut, easeInOut } from "./animate/easings"
+
+// ---- plugins (optional, host-provided capabilities — typed NativeView/service wrappers). The first-party
+// ones are VENDORED from the plugin repo (src/plugins/gen, `bun run vendor:plugins`); oauth / service are the SDK's. ----
+export { QRScanner } from "./plugins/gen/qr-scanner/sdk/qr-scanner"
+export { CameraView, type CameraFacing } from "./plugins/gen/camera/sdk/camera"
+export { Geolocation, type GeoPosition, type GeoOptions, type GeoWatch } from "./plugins/gen/geolocation/sdk/geolocation"
+export {
+  MapView, type MapOptions, type MapStyle, type MapStyleName, type MapCamera, type MapTap, type LngLat, type CameraMove, type FitOptions,
+  type MapPaddingValues, type MarkerItem, type MarkerTap, type MarkerLayer, type MarkerLayerOptions,
+  type LineLayer, type LineLayerOptions, type UserLocationOptions,
+} from "./plugins/gen/map/sdk/map"
+export { Push, type PushPayload, type PushStatus, type PushRegisterOptions, type PushEvent } from "./plugins/gen/push/sdk/push"
+export { OAuth, type OAuthCredential, type OAuthProviderName } from "./plugins/oauth"
+export { Service } from "./plugins/service"
+
+// ---- scenes as data (.scene.ts files — see src/scene/defineScene.ts) ----
+export { defineScene, use, ref, make, SceneHandle } from "./scene/defineScene"
+export { defineMaterial, MaterialHandle } from "./scene/material"
+export type { MaterialData, MaterialParamValue, ShaderMaterialDef, LitMaterialDef, UnlitMaterialDef } from "./scene/material"
+export type { SceneDef, SceneNodeDef, MeshDef, LightDef, MaterialDef, CameraNodeDef, AspectEntry, MakeEntry, LoadedScene, SceneInstance } from "./scene/defineScene"
+export { CameraPlace } from "./gl/CameraPlace"
+// Procedural placement for large maps (line/grid/ring/scatter/place) — built for make() factories.
+export { Level } from "./scene/level"
+export type { LevelSpot, LevelBuild, LevelCollider, LevelLineOptions, LevelGridOptions, LevelRingOptions, LevelScatterOptions, LevelPlaceOptions } from "./scene/level"
+export type { FieldMeta } from "./core/fields"
+// Editor-only line drawing from generator rebuild() / make() factories / tool hooks — drawn by the
+// scene editor's viewport overlay, a no-op everywhere else (see src/scene/gizmos.ts).
+export { Gizmos } from "./scene/gizmos"
+export type { GizmoStyle, GizmoAnchor } from "./scene/gizmos"
+
+// ---- no-code scenario aspects (attachable in the scene editor — see src/gl/scenarios.ts) ----
+export { MoveTo, FollowPath, Spin, LookAt, PlayAnimation } from "./gl/scenarios"
+
+// ---- editor plugins (called from `*.editor.ts` files — editor bundles only; DCE'd from apps) ----
+export { registerEditorWindow, registerEditorTool } from "./scene/editorPlugins"
+export type { EditorApi, EditorRayHit, EditorToolHooks, EditorWindowFn } from "./scene/editorPlugins"
+
+// ---- 3D engine (creator-gl) ----
+export { Scene, ARScene, VRScene } from "./gl/Scene"
+export { Node } from "./gl/Node"
+export { Mesh } from "./gl/Mesh"
+export { Model } from "./gl/Model"
+export { Shape } from "./gl/physics/Shape"
+export { Physics } from "./gl/physics/Physics"
+export { Trigger } from "./gl/physics/Trigger"
+export { AudioSource, type AudioCone } from "./gl/audio/AudioSource"
+export { AudioZone } from "./gl/audio/AudioZone"
+export { SceneAudio } from "./gl/audio/SceneAudio"
+export { CharacterController } from "./gl/physics/CharacterController"
+export { Vehicle } from "./gl/vehicle/Vehicle"
+export type { DriveLayout, DifferentialMode, EngineConfig, SteeringConfig, SteeringFeedback, SteeringDriver, AeroConfig } from "./gl/vehicle/Vehicle"
+export { Wheel, Tire, resolveTire } from "./gl/vehicle/Wheel"
+export { Ragdoll } from "./gl/physics/Ragdoll"
+export type { RagdollPart, RagdollHinge, RagdollFacing, RagdollActivateOptions, RagdollDeactivateOptions, RagdollHitOptions } from "./gl/physics/Ragdoll"
+export type { Point, WheelSuspension } from "./gl/vehicle/Wheel"
+export { AnimationClip } from "./gl/animation/AnimationClip"
+export type { ClipDef, ClipTrackDef, ClipKey } from "./gl/animation/AnimationClip"
+export { Animator } from "./gl/animation/Animator"
+export type { LodMode } from "./gl/animation/Animator"
+export type { TrianglePick } from "./gl/Model"
+export { Feet } from "./gl/animation/Feet"
+export type { FeetOptions, FootState } from "./gl/animation/Feet"
+export { Warp } from "./gl/animation/Warp"
+export type { WarpOptions, StepWarpOptions } from "./gl/animation/Warp"
+export { Playback } from "./gl/animation/Playback"
+export { Loop } from "./gl/animation/Loop"
+export { Layer } from "./gl/animation/Layer"
+export type { PlayOptions, StopOptions, LayerOptions, LoopOptions, LoopDef, BlendPosition, BlendMember, ActiveClip, ClipInfo, ClipCycle, ClipAlign, KneeAxisReport, StepHandler, ClipEventHandler } from "./gl/animation/core"
+export { IK } from "./gl/animation/IK"
+export { DynamicBone, DynamicBoneCollider } from "./gl/animation/DynamicBone"
+export type { DynamicBoneCurve, DynamicBoneFloor, DynamicBoneColliders } from "./gl/animation/DynamicBone"
+export type { IKTwoBone, IKLookAt } from "./gl/animation/IK"
+export { Light } from "./gl/Light"
+export { Lightmap } from "./gl/Lightmap"
+export { Foliage } from "./gl/Foliage"
+export type { FoliageOptions, FoliageWind } from "./gl/Foliage"
+export { Terrain } from "./gl/terrain/Terrain"
+export type { TerrainOptions, TerrainLayer, TerrainRegion, ConformOptions, RibbonOptions, AutoPaintRules, SculptOptions, TerrainHit, TerrainSnapshot } from "./gl/terrain/Terrain"
+export { NavMesh, NavCrowd } from "./gl/nav/NavMesh"
+export type { NavMeshLoadOptions, NavMeshInfo, NavPath, NavQueryOptions, NavRaycastHit, NavAgentSize } from "./gl/nav/NavMesh"
+export { NavAgent } from "./gl/nav/NavAgent"
+export type { NavAgentState, NavAgentAvoidance, NavAgentDrive, NavAgentEvents } from "./gl/nav/NavAgent"
+export { Locomotion } from "./gl/animation/Locomotion"
+export type { LocomotionSet, LocomotionClip, LocomotionTuning, LocomotionState, LocomotionEvents, Displacement, Gait } from "./gl/animation/Locomotion"
+export { Material } from "./gl/Material"
+export { Geometry } from "./gl/Geometry"
+export { InstancedMesh } from "./gl/InstancedMesh"
+export type { InstanceTransform } from "./gl/InstancedMesh"
+export { Texture } from "./gl/Texture"
+export type { TextureLoadOptions } from "./gl/Texture"
+export { Camera } from "./gl/Camera"
+export { Ray } from "./gl/Ray"
+export { Plane } from "./gl/Plane"
+export { Noise } from "./gl/Noise"
+export { Particles, Trail, curve, colorCurve } from "./gl/Particles"
+export { DecalSet, DecalTrail } from "./gl/DecalSet"
+export type { DecalOptions, DecalSetOptions, DecalSpawnOptions, DecalPlacement, DecalTrailOptions } from "./gl/DecalSet"

package/src/net/core.ts

@@ -43,6 +43,8 @@ export type NetEvents = {
 }
 
 export type NetLaunch = { role: "server" | "client"; address: string; port: number; maxClients: number }
+/** Link statistics (`player.rtt` / `player.loss` read them): the bridge's `NetStats`. */
+export type NetStats = { rtt: number; loss: number; sentKbps: number; receivedKbps: number }
 
 export const CH_RELIABLE = 0
 export const CH_UNRELIABLE = 1
@@ -80,8 +82,8 @@ export class NetPlayer {
 
   get isMe(): boolean { return state.me === this }
   /** Round trip to this player in ms (server side) or to the server (our own player on a client). */
-  get rtt(): number { return infoOf(this)[1] }
-  get loss(): number { return infoOf(this)[2] }
+  get rtt(): number { return infoOf(this)?.rtt ?? 0 }
+  get loss(): number { return infoOf(this)?.loss ?? 0 }
 
   /** Server → this player. */
   send<T>(msg: NetMessage<T>, data: T): void {
@@ -162,10 +164,9 @@ export const emit = (event: keyof NetEvents, ...args: any[]): void => {
   for (const fn of list.slice()) fn(...args)
 }
 
-const EMPTY_INFO = new Float32Array(5)
-const infoOf = (p: NetPlayer): Float32Array => {
+const infoOf = (p: NetPlayer): NetStats | null => {
   const b = bridge()
-  if (!b || p._slot === LOCAL_SLOT && state.role !== "client") return EMPTY_INFO
+  if (!b || p._slot === LOCAL_SLOT && state.role !== "client") return null
   return b.clientInfo(p._slot)
 }
 

package/src/net/index.ts

@@ -30,7 +30,7 @@ class NetImpl {
   get players(): readonly NetPlayer[] { if (state.role !== "server") ensureMe(); return state.players }
   player(id: number): NetPlayer | undefined { return state.players.find((p) => p.id === id) }
   /** Our round trip to the server (client), 0 otherwise. */
-  get rtt(): number { return state.role === "client" ? (bridge()?.clientInfo(0)[1] ?? 0) : 0 }
+  get rtt(): number { return state.role === "client" ? (bridge()?.clientInfo(0)?.rtt ?? 0) : 0 }
   /** The simulation tick — one per fixed step (`updateFixed`). The server's is THE tick; a client
    *  runs a few ticks ahead so its inputs arrive in time. */
   get tick(): number { return currentTick() }