feat: add character studio and aircraft foundation

src/engine/scene.ts

@@ -65,7 +65,11 @@ import type {
 } from "./types.ts";
 import { World, type FieldProgress } from "./world.ts";
 import { createSceneActor, type SceneActorOptions } from "../actors/sceneActor.ts";
-import type { ActorActionSnapshot, ActorControllerSnapshot } from "../actors/controller.ts";
+import type {
+  ActorActionSnapshot,
+  ActorControllerSnapshot,
+  ActorIdentity,
+} from "../actors/controller.ts";
 
 export interface SceneOptions {
   city: City;
@@ -183,6 +187,8 @@ export interface SceneHandle {
   vehicleCamera(): VehicleCameraMode | null;
   setActorActions(actions: Partial<ActorActionSnapshot>): void;
   actorState(): Readonly<ActorControllerSnapshot> | null;
+  /** Replace the visible local actor profile without disturbing its position or controls. */
+  setActorIdentity(identity: ActorIdentity): void;
   setActorActive(active: boolean): void;
   actorActive(): boolean;
   setMarkers(markers: Marker[]): void;
@@ -580,6 +586,7 @@ export async function createScene(
     vehicleCamera: () => roadTraffic?.cameraMode() ?? null,
     setActorActions: (actions) => { sceneActor?.setActions(actions); },
     actorState: () => sceneActor?.state() ?? null,
+    setActorIdentity: (identity) => { sceneActor?.setIdentity(identity); },
     setActorActive(active) {
       sceneActor?.setActive(active);
       if (active) roadTraffic?.setFollowing(false);