@scenography/plugin-fpc 0.2.0

package/dist/index.cjs

@@ -0,0 +1,367 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _scenography_engine = require("@scenography/engine");
+let three = require("three");
+//#region src/collision.ts
+/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */
+const insidePolygon = (x, z, polygon) => {
+	let inside = false;
+	for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+		const a = polygon[i];
+		const b = polygon[j];
+		if (!a || !b) continue;
+		if (a[1] > z !== b[1] > z && x < (b[0] - a[0]) * (z - a[1]) / (b[1] - a[1]) + a[0]) inside = !inside;
+	}
+	return inside;
+};
+/** Whether a circle of `radius` centered at `(x, z)` overlaps any collider box. */
+const hits = (x, z, radius, colliders) => {
+	const r2 = radius * radius;
+	for (const c of colliders) {
+		const px = x - c.cx;
+		const pz = z - c.cz;
+		const along = px * c.dx + pz * c.dz;
+		const perp = px * -c.dz + pz * c.dx;
+		const ddAlong = along - Math.max(-c.halfLength, Math.min(c.halfLength, along));
+		const ddPerp = perp - Math.max(-c.halfThickness, Math.min(c.halfThickness, perp));
+		if (ddAlong * ddAlong + ddPerp * ddPerp < r2) return true;
+	}
+	return false;
+};
+/**
+* Resolve a desired XZ step against wall colliders and an optional walkable-area
+* boundary, one axis at a time so the camera slides along an obstacle instead of
+* sticking when it can't move straight.
+*/
+const resolveMove = (current, step, colliders, radius, boundary) => {
+	let { x, z } = current;
+	const free = (nx, nz) => !hits(nx, nz, radius, colliders) && (!boundary || insidePolygon(nx, nz, boundary));
+	if (step.x !== 0 && free(x + step.x, z)) x += step.x;
+	if (step.z !== 0 && free(x, z + step.z)) z += step.z;
+	return new three.Vector3(x, current.y, z);
+};
+//#endregion
+//#region src/headBob.ts
+const createHeadBobState = () => ({
+	active: false,
+	timer: 0
+});
+/**
+* Advance the head-bob timer by `elapsed` seconds, snapping to half-wavelength
+* steps so the bob always settles back to neutral when movement stops.
+*/
+const updateHeadBob = (state, elapsed) => {
+	if (!state.active) return;
+	const wavelength = Math.PI;
+	const nextStepTime = (1 + Math.floor((state.timer + 1e-6) * 10 / wavelength)) * wavelength / 10;
+	state.timer = Math.min(state.timer + elapsed, nextStepTime);
+	if (state.timer === nextStepTime) state.active = false;
+};
+/** Vertical offset to add to the camera, in world units. */
+const headBobOffset = (state) => Math.sin(state.timer * 10) * 1.5;
+//#endregion
+//#region src/keyboard.ts
+const createKeyboardState = () => ({});
+/** Codes the controls consume; preventDefault'd so the arrows don't scroll. */
+const MOVEMENT_KEYS = new Set([
+	"KeyW",
+	"KeyA",
+	"KeyS",
+	"KeyD",
+	"ArrowUp",
+	"ArrowDown",
+	"ArrowLeft",
+	"ArrowRight"
+]);
+const onKeyDown = (state, event) => {
+	state[event.code] = true;
+	if (MOVEMENT_KEYS.has(event.code)) event.preventDefault();
+};
+const onKeyUp = (state, event) => {
+	state[event.code] = false;
+};
+/** Yaw turn rate for the Q/E keys, in radians per second. */
+const KEY_TURN_SPEED = 1.8;
+/**
+* Turn a forward/strafe pair (each in `-1..1`) into a per-frame translation
+* oriented by the current yaw (`phi`). Shared by keyboard and touch input.
+*/
+const movementFromAxis = (forwardVelocity, strafeVelocity, phi, delta, boosted = false) => {
+	const factor = boosted ? 60 : 20;
+	const yaw = new three.Quaternion().setFromAxisAngle(new three.Vector3(0, 1, 0), phi);
+	const forward = new three.Vector3(0, 0, -10).applyQuaternion(yaw).multiplyScalar(forwardVelocity * delta * factor);
+	const left = new three.Vector3(-10, 0, 0).applyQuaternion(yaw).multiplyScalar(strafeVelocity * delta * factor);
+	return forward.add(left);
+};
+/**
+* Compute the per-frame translation from WASD or arrow-key input, oriented by
+* the current yaw (`phi`). Holding Shift acts as a speed booster.
+*/
+const movementFromKeyboard = (state, phi, delta) => {
+	const has = (...codes) => codes.some((c) => state[c]) ? 1 : 0;
+	return movementFromAxis(has("KeyW", "ArrowUp") - has("KeyS", "ArrowDown"), has("KeyA", "ArrowLeft") - has("KeyD", "ArrowRight"), phi, delta, Boolean(state["ShiftLeft"] || state["ShiftRight"]));
+};
+/**
+* Per-frame yaw delta (radians) from the Q/E turn keys. Q turns left
+* (increasing yaw), E turns right.
+*/
+const yawFromKeyboard = (state, delta) => {
+	return ((state["KeyQ"] ? 1 : 0) - (state["KeyE"] ? 1 : 0)) * KEY_TURN_SPEED * delta;
+};
+//#endregion
+//#region src/mouse.ts
+const PHI_SPEED = 8;
+const THETA_SPEED = 5;
+const createMouseState = () => ({
+	dragging: false,
+	pos: new three.Vector2(),
+	prevPos: new three.Vector2(),
+	delta: new three.Vector2()
+});
+const clamp = (x, a, b) => Math.min(Math.max(x, a), b);
+/** Maximum up/down look angle (radians) — keeps the camera from flipping over. */
+const MAX_PITCH = Math.PI / 3;
+/** Build the look quaternion from the current yaw/pitch angles. */
+const quaternionFromLook = (look) => {
+	const qy = new three.Quaternion().setFromAxisAngle(new three.Vector3(0, 1, 0), look.phi);
+	const qx = new three.Quaternion().setFromAxisAngle(new three.Vector3(1, 0, 0), look.theta);
+	return new three.Quaternion().multiply(qy).multiply(qx);
+};
+const onMouseDown = (state, event) => {
+	state.dragging = event.button === 0;
+};
+const onMouseUp = (state) => {
+	state.dragging = false;
+};
+const onMouseMove = (state, event) => {
+	state.pos.set(event.pageX - window.innerWidth / 2, event.pageY - window.innerHeight / 2);
+	state.delta.subVectors(state.pos, state.prevPos);
+};
+const commitMouseFrame = (state) => {
+	state.prevPos.copy(state.pos);
+	state.delta.set(0, 0);
+};
+/**
+* Integrate the pointer delta into the look angles. Mutates `look` in place.
+* Yaw is unbounded; pitch is clamped to avoid flipping over.
+*/
+const updateLookFromMouse = (mouse, look) => {
+	const xh = mouse.delta.x / window.innerWidth;
+	const yh = mouse.delta.y / window.innerHeight;
+	look.phi += -xh * PHI_SPEED;
+	look.theta = clamp(look.theta + -yh * THETA_SPEED, -MAX_PITCH, MAX_PITCH);
+};
+//#endregion
+//#region src/touch.ts
+/** Look turn rate driven by the joystick, in radians per second at full deflection. */
+const LOOK_SPEED = 2.2;
+/** Per-frame translation from the analog move axes, oriented by yaw (`phi`). */
+const movementFromTouch = (state, phi, delta) => {
+	if (state.moveForward === 0 && state.moveStrafe === 0) return new three.Vector3();
+	return movementFromAxis(state.moveForward, -state.moveStrafe, phi, delta);
+};
+/** Integrate the look joystick into the look angles, mutating `look` in place. */
+const updateLookFromTouch = (state, look, delta) => {
+	if (state.lookX === 0 && state.lookY === 0) return;
+	look.phi -= state.lookX * LOOK_SPEED * delta;
+	look.theta = clamp(look.theta + state.lookY * LOOK_SPEED * delta, -MAX_PITCH, MAX_PITCH);
+};
+//#endregion
+//#region src/FreeRoamControls.ts
+/**
+* First-person, free-roaming camera controls: drag-to-look with the mouse, WASD
+* to walk, a subtle head-bob while moving, wall collision and terrain following.
+* The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on
+* top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the
+* camera upright (no roll) and clamps pitch — the first-person contract.
+*
+* Framework-agnostic: construct it with a camera, the canvas and the input,
+* call `attach()`, then `update(delta)` once per frame.
+*/
+var FreeRoamControls = class {
+	colliders;
+	playerRadius;
+	camera;
+	domElement;
+	input;
+	mouse = createMouseState();
+	keyboard = createKeyboardState();
+	headBob = createHeadBobState();
+	look = {
+		phi: 0,
+		theta: 0
+	};
+	rotation = new three.Quaternion();
+	translation = new three.Vector3(0, 170, 0);
+	enabled = true;
+	boundary;
+	groundHeight;
+	start;
+	eyeHeight;
+	handlers = [];
+	constructor(camera, domElement, input, options = {}) {
+		this.camera = camera;
+		this.domElement = domElement;
+		this.input = input;
+		this.colliders = options.colliders ?? [];
+		this.playerRadius = options.playerRadius ?? 25;
+		if (options.position) this.translation.copy(options.position);
+		if (options.yaw !== void 0) this.look.phi = options.yaw;
+		this.rotation.setFromAxisAngle(new three.Vector3(0, 1, 0), this.look.phi);
+		this.boundary = options.boundary;
+		this.groundHeight = options.groundHeight ?? null;
+		this.start = this.translation.clone();
+		const groundAtStart = this.groundHeight?.(this.start.x, this.start.z) ?? 0;
+		this.eyeHeight = options.eyeHeight ?? this.start.y - groundAtStart;
+	}
+	/** Current eye height above the ground (world units). */
+	getEyeHeight() {
+		return this.eyeHeight;
+	}
+	/** Fix the eye height above the ground (world units). */
+	setEyeHeight(eyeHeight) {
+		this.eyeHeight = eyeHeight;
+	}
+	/**
+	* Re-derive the default eye height (start Y over the ground under the start
+	* position). Call once asynchronous ground data (a floor heightmap) has
+	* loaded: the value captured at construction was measured against the
+	* not-yet-displaced floor.
+	*/
+	recalibrateEyeHeight() {
+		const ground = this.groundHeight?.(this.start.x, this.start.z) ?? 0;
+		this.eyeHeight = this.start.y - ground;
+	}
+	attach() {
+		const bind = (target, type, listener) => {
+			target.addEventListener(type, listener);
+			this.handlers.push([
+				target,
+				type,
+				listener
+			]);
+		};
+		bind(this.domElement, "mousedown", (e) => onMouseDown(this.mouse, e));
+		bind(window, "mousemove", (e) => onMouseMove(this.mouse, e));
+		bind(window, "mouseup", () => onMouseUp(this.mouse));
+		bind(window, "keydown", (e) => onKeyDown(this.keyboard, e));
+		bind(window, "keyup", (e) => onKeyUp(this.keyboard, e));
+	}
+	detach() {
+		for (const [target, type, listener] of this.handlers) target.removeEventListener(type, listener);
+		this.handlers.length = 0;
+	}
+	/** Replace the wall collision set (e.g. after the scene's walls change). */
+	setColliders(colliders) {
+		this.colliders = colliders;
+	}
+	/** Replace the walkable-area boundary polygon (or clear it with `undefined`). */
+	setBoundary(boundary) {
+		this.boundary = boundary;
+	}
+	/** Replace the ground-height function (or clear it to stop following terrain). */
+	setGroundHeight(groundHeight) {
+		this.groundHeight = groundHeight;
+	}
+	/**
+	* Enable/disable user input. While disabled, `update()` leaves the camera
+	* untouched so another driver (e.g. a camera tween) can own it; re-enable after
+	* syncing the pose with `setPose` so free-roam continues from there.
+	*/
+	setEnabled(enabled) {
+		this.enabled = enabled;
+	}
+	/** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */
+	getPose() {
+		return {
+			position: this.translation.clone(),
+			phi: this.look.phi,
+			theta: this.look.theta
+		};
+	}
+	/** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */
+	setPose(position, phi, theta) {
+		this.translation.copy(position);
+		this.look.phi = phi;
+		this.look.theta = theta;
+		this.rotation = quaternionFromLook(this.look);
+	}
+	/** Advance the camera by `delta` seconds of input. */
+	update(delta) {
+		if (!this.enabled) {
+			commitMouseFrame(this.mouse);
+			return;
+		}
+		if (this.mouse.dragging) updateLookFromMouse(this.mouse, this.look);
+		this.look.phi += yawFromKeyboard(this.keyboard, delta);
+		updateLookFromTouch(this.input, this.look, delta);
+		this.rotation = quaternionFromLook(this.look);
+		const step = movementFromKeyboard(this.keyboard, this.look.phi, delta).add(movementFromTouch(this.input, this.look.phi, delta));
+		this.translation = resolveMove(this.translation, step, this.colliders, this.playerRadius, this.boundary);
+		if (this.groundHeight) this.translation.y = this.groundHeight(this.translation.x, this.translation.z) + this.eyeHeight;
+		if (step.x !== 0 || step.z !== 0) this.headBob.active = true;
+		updateHeadBob(this.headBob, delta);
+		this.camera.quaternion.copy(this.rotation);
+		this.camera.position.copy(this.translation);
+		this.camera.position.y += headBobOffset(this.headBob);
+		const target = new three.Vector3(0, 0, -1).applyQuaternion(this.rotation).multiplyScalar(100).add(this.translation);
+		this.camera.lookAt(target);
+		commitMouseFrame(this.mouse);
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* First-person camera — a *system* plugin. It drives the kernel camera from
+* WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`
+* over the terrain, and blocks it against wall colliders. Consumes the `terrain`
+* and `colliders` capabilities (live, so it tracks async heightmaps and hot wall
+* edits) and publishes `roamControl` so a framing/tour system can suspend it.
+*/
+const fpc = () => ({
+	name: "fpc",
+	setup: (ctx) => {
+		const { camera, canvas, input, capabilities, scene } = ctx;
+		const terrainHeight = (x, z) => capabilities.get(_scenography_engine.TERRAIN)?.heightAt(x, z) ?? 0;
+		const groundHeight = () => capabilities.get(_scenography_engine.TERRAIN) ? terrainHeight : void 0;
+		const start = scene.camera.start;
+		const controls = new FreeRoamControls(camera, canvas, input, {
+			position: new three.Vector3(start.position[0], start.position[1], start.position[2]),
+			yaw: start.yaw,
+			boundary: scene.boundary,
+			eyeHeight: scene.camera.eyeHeight,
+			groundHeight: groundHeight()
+		});
+		controls.attach();
+		capabilities.provide(_scenography_engine.ROAM_CONTROL, controls);
+		const calibrateEyeHeight = (s) => {
+			if (s.camera.eyeHeight !== void 0) controls.setEyeHeight(s.camera.eyeHeight);
+			else {
+				const terrain = capabilities.get(_scenography_engine.TERRAIN);
+				if (terrain) terrain.ready.then(() => controls.recalibrateEyeHeight());
+			}
+		};
+		calibrateEyeHeight(scene);
+		return {
+			update: (deltaMs) => {
+				controls.setColliders(capabilities.get(_scenography_engine.COLLIDERS) ?? []);
+				controls.update(deltaMs / 1e3);
+			},
+			setScene: (s) => {
+				controls.setBoundary(s.boundary);
+				controls.setGroundHeight(groundHeight() ?? null);
+				calibrateEyeHeight(s);
+			},
+			dispose: () => {
+				controls.detach();
+				capabilities.revoke(_scenography_engine.ROAM_CONTROL);
+			}
+		};
+	}
+});
+//#endregion
+exports.FreeRoamControls = FreeRoamControls;
+exports.fpc = fpc;
+exports.insidePolygon = insidePolygon;
+exports.resolveMove = resolveMove;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Vector3","Quaternion","Vector3","Vector2","Quaternion","Vector3","Vector3","Quaternion","Vector3","TERRAIN","Vector3","ROAM_CONTROL","COLLIDERS"],"sources":["../src/collision.ts","../src/headBob.ts","../src/keyboard.ts","../src/mouse.ts","../src/touch.ts","../src/FreeRoamControls.ts","../src/plugin.ts"],"sourcesContent":["import { Vector3 } from \"three\";\nimport type { Vec2 } from \"@scenography/scene\";\nimport type { Collider } from \"@scenography/engine\";\n\n/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */\nexport const insidePolygon = (x: number, z: number, polygon: Vec2[]): boolean => {\n  let inside = false;\n  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n    const a = polygon[i];\n    const b = polygon[j];\n    if (!a || !b) continue; // unreachable given the loop bounds; satisfies strict indexing\n    if (a[1] > z !== b[1] > z && x < ((b[0] - a[0]) * (z - a[1])) / (b[1] - a[1]) + a[0]) {\n      inside = !inside;\n    }\n  }\n  return inside;\n};\n\n/** Whether a circle of `radius` centered at `(x, z)` overlaps any collider box. */\nconst hits = (x: number, z: number, radius: number, colliders: Collider[]): boolean => {\n  const r2 = radius * radius;\n  for (const c of colliders) {\n    const px = x - c.cx;\n    const pz = z - c.cz;\n    // Project onto the box axes: along its length and along its thickness normal.\n    const along = px * c.dx + pz * c.dz;\n    const perp = px * -c.dz + pz * c.dx;\n    // Distance from the point to the closest point on the box.\n    const ddAlong = along - Math.max(-c.halfLength, Math.min(c.halfLength, along));\n    const ddPerp = perp - Math.max(-c.halfThickness, Math.min(c.halfThickness, perp));\n    if (ddAlong * ddAlong + ddPerp * ddPerp < r2) return true;\n  }\n  return false;\n};\n\n/**\n * Resolve a desired XZ step against wall colliders and an optional walkable-area\n * boundary, one axis at a time so the camera slides along an obstacle instead of\n * sticking when it can't move straight.\n */\nexport const resolveMove = (\n  current: Vector3,\n  step: Vector3,\n  colliders: Collider[],\n  radius: number,\n  boundary?: Vec2[],\n): Vector3 => {\n  let { x, z } = current;\n  const free = (nx: number, nz: number): boolean =>\n    !hits(nx, nz, radius, colliders) && (!boundary || insidePolygon(nx, nz, boundary));\n  if (step.x !== 0 && free(x + step.x, z)) x += step.x;\n  if (step.z !== 0 && free(x, z + step.z)) z += step.z;\n  return new Vector3(x, current.y, z);\n};\n","/** State for the subtle vertical bob applied while walking. */\nexport interface HeadBobState {\n  active: boolean;\n  timer: number;\n}\n\nexport const createHeadBobState = (): HeadBobState => ({ active: false, timer: 0 });\n\n/**\n * Advance the head-bob timer by `elapsed` seconds, snapping to half-wavelength\n * steps so the bob always settles back to neutral when movement stops.\n */\nexport const updateHeadBob = (state: HeadBobState, elapsed: number): void => {\n  if (!state.active) return;\n\n  const wavelength = Math.PI;\n  const nextStep = 1 + Math.floor(((state.timer + 1e-6) * 10) / wavelength);\n  const nextStepTime = (nextStep * wavelength) / 10;\n  state.timer = Math.min(state.timer + elapsed, nextStepTime);\n\n  if (state.timer === nextStepTime) state.active = false;\n};\n\n/** Vertical offset to add to the camera, in world units. */\nexport const headBobOffset = (state: HeadBobState): number => Math.sin(state.timer * 10) * 1.5;\n","import { Quaternion, Vector3 } from \"three\";\n\n/** Set of currently-pressed key codes. */\nexport type KeyboardState = Record<string, boolean>;\n\nexport const createKeyboardState = (): KeyboardState => ({});\n\n/** Codes the controls consume; preventDefault'd so the arrows don't scroll. */\nconst MOVEMENT_KEYS = new Set([\n  \"KeyW\",\n  \"KeyA\",\n  \"KeyS\",\n  \"KeyD\",\n  \"ArrowUp\",\n  \"ArrowDown\",\n  \"ArrowLeft\",\n  \"ArrowRight\",\n]);\n\nexport const onKeyDown = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = true;\n  if (MOVEMENT_KEYS.has(event.code)) event.preventDefault();\n};\n\nexport const onKeyUp = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = false;\n};\n\n/** Yaw turn rate for the Q/E keys, in radians per second. */\nconst KEY_TURN_SPEED = 1.8;\n\n/**\n * Turn a forward/strafe pair (each in `-1..1`) into a per-frame translation\n * oriented by the current yaw (`phi`). Shared by keyboard and touch input.\n */\nexport const movementFromAxis = (\n  forwardVelocity: number,\n  strafeVelocity: number,\n  phi: number,\n  delta: number,\n  boosted = false,\n): Vector3 => {\n  const factor = boosted ? 60 : 20;\n  const yaw = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), phi);\n\n  const forward = new Vector3(0, 0, -10)\n    .applyQuaternion(yaw)\n    .multiplyScalar(forwardVelocity * delta * factor);\n  const left = new Vector3(-10, 0, 0)\n    .applyQuaternion(yaw)\n    .multiplyScalar(strafeVelocity * delta * factor);\n\n  return forward.add(left);\n};\n\n/**\n * Compute the per-frame translation from WASD or arrow-key input, oriented by\n * the current yaw (`phi`). Holding Shift acts as a speed booster.\n */\nexport const movementFromKeyboard = (state: KeyboardState, phi: number, delta: number): Vector3 => {\n  const has = (...codes: string[]): number => (codes.some((c) => state[c]) ? 1 : 0);\n  const forwardVelocity = has(\"KeyW\", \"ArrowUp\") - has(\"KeyS\", \"ArrowDown\");\n  const strafeVelocity = has(\"KeyA\", \"ArrowLeft\") - has(\"KeyD\", \"ArrowRight\");\n  const boosted = Boolean(state[\"ShiftLeft\"] || state[\"ShiftRight\"]);\n\n  return movementFromAxis(forwardVelocity, strafeVelocity, phi, delta, boosted);\n};\n\n/**\n * Per-frame yaw delta (radians) from the Q/E turn keys. Q turns left\n * (increasing yaw), E turns right.\n */\nexport const yawFromKeyboard = (state: KeyboardState, delta: number): number => {\n  const turn = (state[\"KeyQ\"] ? 1 : 0) - (state[\"KeyE\"] ? 1 : 0);\n  return turn * KEY_TURN_SPEED * delta;\n};\n","import { Quaternion, Vector2, Vector3 } from \"three\";\n\n/** Mutable pointer state accumulated between frames. */\nexport interface MouseState {\n  /** Whether the primary button is held (drag-to-look). */\n  dragging: boolean;\n  pos: Vector2;\n  prevPos: Vector2;\n  delta: Vector2;\n}\n\n/** Look angles driven by the pointer. */\nexport interface LookState {\n  phi: number;\n  theta: number;\n}\n\nconst PHI_SPEED = 8;\nconst THETA_SPEED = 5;\n\nexport const createMouseState = (): MouseState => ({\n  dragging: false,\n  pos: new Vector2(),\n  prevPos: new Vector2(),\n  delta: new Vector2(),\n});\n\nexport const clamp = (x: number, a: number, b: number): number => Math.min(Math.max(x, a), b);\n\n/** Maximum up/down look angle (radians) — keeps the camera from flipping over. */\nexport const MAX_PITCH = Math.PI / 3;\n\n/** Build the look quaternion from the current yaw/pitch angles. */\nexport const quaternionFromLook = (look: LookState): Quaternion => {\n  const qy = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), look.phi);\n  const qx = new Quaternion().setFromAxisAngle(new Vector3(1, 0, 0), look.theta);\n  return new Quaternion().multiply(qy).multiply(qx);\n};\n\nexport const onMouseDown = (state: MouseState, event: MouseEvent): void => {\n  state.dragging = event.button === 0;\n};\n\nexport const onMouseUp = (state: MouseState): void => {\n  state.dragging = false;\n};\n\nexport const onMouseMove = (state: MouseState, event: MouseEvent): void => {\n  state.pos.set(event.pageX - window.innerWidth / 2, event.pageY - window.innerHeight / 2);\n  state.delta.subVectors(state.pos, state.prevPos);\n};\n\nexport const commitMouseFrame = (state: MouseState): void => {\n  state.prevPos.copy(state.pos);\n  state.delta.set(0, 0);\n};\n\n/**\n * Integrate the pointer delta into the look angles. Mutates `look` in place.\n * Yaw is unbounded; pitch is clamped to avoid flipping over.\n */\nexport const updateLookFromMouse = (mouse: MouseState, look: LookState): void => {\n  const xh = mouse.delta.x / window.innerWidth;\n  const yh = mouse.delta.y / window.innerHeight;\n\n  look.phi += -xh * PHI_SPEED;\n  look.theta = clamp(look.theta + -yh * THETA_SPEED, -MAX_PITCH, MAX_PITCH);\n};\n","import { Vector3 } from \"three\";\n\nimport { movementFromAxis } from \"./keyboard\";\nimport { clamp, MAX_PITCH, type LookState } from \"./mouse\";\n\n/**\n * The shape of the shared analog input fpc reads (the kernel's `InputBus`): the\n * move/look axes a joystick feeds. Structural, so any producer with these fields\n * works. fpc interprets them as walking + turning; another camera might not.\n */\nexport interface AnalogInput {\n  /** Forward (`+1`) / backward (`-1`) movement. */\n  moveForward: number;\n  /** Strafe right (`+1`) / left (`-1`). */\n  moveStrafe: number;\n  /** Look right (`+1`) / left (`-1`). */\n  lookX: number;\n  /** Look up (`+1`) / down (`-1`). */\n  lookY: number;\n}\n\n/** Look turn rate driven by the joystick, in radians per second at full deflection. */\nconst LOOK_SPEED = 2.2;\n\n/** Per-frame translation from the analog move axes, oriented by yaw (`phi`). */\nexport const movementFromTouch = (state: AnalogInput, phi: number, delta: number): Vector3 => {\n  if (state.moveForward === 0 && state.moveStrafe === 0) return new Vector3();\n  // Strafe sign matches the keyboard helper (left strafe is +1 there).\n  return movementFromAxis(state.moveForward, -state.moveStrafe, phi, delta);\n};\n\n/** Integrate the look joystick into the look angles, mutating `look` in place. */\nexport const updateLookFromTouch = (state: AnalogInput, look: LookState, delta: number): void => {\n  if (state.lookX === 0 && state.lookY === 0) return;\n  look.phi -= state.lookX * LOOK_SPEED * delta;\n  look.theta = clamp(look.theta + state.lookY * LOOK_SPEED * delta, -MAX_PITCH, MAX_PITCH);\n};\n","import { Quaternion, Vector3, type PerspectiveCamera } from \"three\";\nimport type { Vec2 } from \"@scenography/scene\";\nimport type { Collider } from \"@scenography/engine\";\n\nimport { resolveMove } from \"./collision\";\nimport { createHeadBobState, headBobOffset, updateHeadBob } from \"./headBob\";\nimport {\n  createKeyboardState,\n  movementFromKeyboard,\n  onKeyDown,\n  onKeyUp,\n  yawFromKeyboard,\n} from \"./keyboard\";\nimport {\n  commitMouseFrame,\n  createMouseState,\n  onMouseDown,\n  onMouseMove,\n  onMouseUp,\n  quaternionFromLook,\n  updateLookFromMouse,\n  type LookState,\n} from \"./mouse\";\nimport { movementFromTouch, updateLookFromTouch, type AnalogInput } from \"./touch\";\n\nexport interface FreeRoamOptions {\n  /** Wall collision boxes the camera can't pass through. */\n  colliders?: Collider[];\n  /** Camera collision radius in world units. Defaults to `25`. */\n  playerRadius?: number;\n  /** Starting position. */\n  position?: Vector3;\n  /** Starting yaw in radians. */\n  yaw?: number;\n  /** Walkable-area polygon (XZ ring); the camera can't step outside it. */\n  boundary?: Vec2[];\n  /** Ground height at `(x, z)`; when set the camera follows the terrain. */\n  groundHeight?: (x: number, z: number) => number;\n  /** Eye height above the ground. Defaults to the start Y over the start ground. */\n  eyeHeight?: number;\n}\n\n/**\n * First-person, free-roaming camera controls: drag-to-look with the mouse, WASD\n * to walk, a subtle head-bob while moving, wall collision and terrain following.\n * The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on\n * top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the\n * camera upright (no roll) and clamps pitch — the first-person contract.\n *\n * Framework-agnostic: construct it with a camera, the canvas and the input,\n * call `attach()`, then `update(delta)` once per frame.\n */\nexport class FreeRoamControls {\n  private colliders: Collider[];\n  private readonly playerRadius: number;\n\n  private readonly camera: PerspectiveCamera;\n  private readonly domElement: HTMLElement;\n  private readonly input: AnalogInput;\n  private readonly mouse = createMouseState();\n  private readonly keyboard = createKeyboardState();\n  private readonly headBob = createHeadBobState();\n  private readonly look: LookState = { phi: 0, theta: 0 };\n  private rotation = new Quaternion();\n  private translation = new Vector3(0, 170, 0);\n  private enabled = true;\n  private boundary: Vec2[] | undefined;\n  private groundHeight: ((x: number, z: number) => number) | null;\n  private readonly start: Vector3;\n  private eyeHeight: number;\n\n  private readonly handlers: Array<[EventTarget, string, EventListener]> = [];\n\n  constructor(\n    camera: PerspectiveCamera,\n    domElement: HTMLElement,\n    input: AnalogInput,\n    options: FreeRoamOptions = {},\n  ) {\n    this.camera = camera;\n    this.domElement = domElement;\n    this.input = input;\n    this.colliders = options.colliders ?? [];\n    this.playerRadius = options.playerRadius ?? 25;\n    if (options.position) this.translation.copy(options.position);\n    if (options.yaw !== undefined) this.look.phi = options.yaw;\n    this.rotation.setFromAxisAngle(new Vector3(0, 1, 0), this.look.phi);\n    this.boundary = options.boundary;\n    this.groundHeight = options.groundHeight ?? null;\n    this.start = this.translation.clone();\n    // Eye height = start Y above the ground under the start position.\n    const groundAtStart = this.groundHeight?.(this.start.x, this.start.z) ?? 0;\n    this.eyeHeight = options.eyeHeight ?? this.start.y - groundAtStart;\n  }\n\n  /** Current eye height above the ground (world units). */\n  getEyeHeight(): number {\n    return this.eyeHeight;\n  }\n\n  /** Fix the eye height above the ground (world units). */\n  setEyeHeight(eyeHeight: number): void {\n    this.eyeHeight = eyeHeight;\n  }\n\n  /**\n   * Re-derive the default eye height (start Y over the ground under the start\n   * position). Call once asynchronous ground data (a floor heightmap) has\n   * loaded: the value captured at construction was measured against the\n   * not-yet-displaced floor.\n   */\n  recalibrateEyeHeight(): void {\n    const ground = this.groundHeight?.(this.start.x, this.start.z) ?? 0;\n    this.eyeHeight = this.start.y - ground;\n  }\n\n  attach(): void {\n    const bind = (target: EventTarget, type: string, listener: EventListener): void => {\n      target.addEventListener(type, listener);\n      this.handlers.push([target, type, listener]);\n    };\n\n    bind(this.domElement, \"mousedown\", (e) => onMouseDown(this.mouse, e as MouseEvent));\n    bind(window, \"mousemove\", (e) => onMouseMove(this.mouse, e as MouseEvent));\n    bind(window, \"mouseup\", () => onMouseUp(this.mouse));\n    bind(window, \"keydown\", (e) => onKeyDown(this.keyboard, e as KeyboardEvent));\n    bind(window, \"keyup\", (e) => onKeyUp(this.keyboard, e as KeyboardEvent));\n  }\n\n  detach(): void {\n    for (const [target, type, listener] of this.handlers)\n      target.removeEventListener(type, listener);\n    this.handlers.length = 0;\n  }\n\n  /** Replace the wall collision set (e.g. after the scene's walls change). */\n  setColliders(colliders: Collider[]): void {\n    this.colliders = colliders;\n  }\n\n  /** Replace the walkable-area boundary polygon (or clear it with `undefined`). */\n  setBoundary(boundary: Vec2[] | undefined): void {\n    this.boundary = boundary;\n  }\n\n  /** Replace the ground-height function (or clear it to stop following terrain). */\n  setGroundHeight(groundHeight: ((x: number, z: number) => number) | null): void {\n    this.groundHeight = groundHeight;\n  }\n\n  /**\n   * Enable/disable user input. While disabled, `update()` leaves the camera\n   * untouched so another driver (e.g. a camera tween) can own it; re-enable after\n   * syncing the pose with `setPose` so free-roam continues from there.\n   */\n  setEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n  }\n\n  /** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */\n  getPose(): { position: Vector3; phi: number; theta: number } {\n    return { position: this.translation.clone(), phi: this.look.phi, theta: this.look.theta };\n  }\n\n  /** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */\n  setPose(position: Vector3, phi: number, theta: number): void {\n    this.translation.copy(position);\n    this.look.phi = phi;\n    this.look.theta = theta;\n    this.rotation = quaternionFromLook(this.look);\n  }\n\n  /** Advance the camera by `delta` seconds of input. */\n  update(delta: number): void {\n    // Disabled: another driver owns the camera this frame. Drop any accumulated\n    // pointer delta so look doesn't jump when control is handed back.\n    if (!this.enabled) {\n      commitMouseFrame(this.mouse);\n      return;\n    }\n    // Accumulate look from every source into the angles, then derive rotation.\n    if (this.mouse.dragging) updateLookFromMouse(this.mouse, this.look);\n    this.look.phi += yawFromKeyboard(this.keyboard, delta);\n    updateLookFromTouch(this.input, this.look, delta);\n    this.rotation = quaternionFromLook(this.look);\n\n    const step = movementFromKeyboard(this.keyboard, this.look.phi, delta).add(\n      movementFromTouch(this.input, this.look.phi, delta),\n    );\n    this.translation = resolveMove(\n      this.translation,\n      step,\n      this.colliders,\n      this.playerRadius,\n      this.boundary,\n    );\n    // Follow the terrain: keep the eye a fixed height above the ground below.\n    if (this.groundHeight) {\n      this.translation.y = this.groundHeight(this.translation.x, this.translation.z) + this.eyeHeight;\n    }\n    if (step.x !== 0 || step.z !== 0) this.headBob.active = true;\n    updateHeadBob(this.headBob, delta);\n\n    this.camera.quaternion.copy(this.rotation);\n    this.camera.position.copy(this.translation);\n    this.camera.position.y += headBobOffset(this.headBob);\n\n    const target = new Vector3(0, 0, -1)\n      .applyQuaternion(this.rotation)\n      .multiplyScalar(100)\n      .add(this.translation);\n    this.camera.lookAt(target);\n\n    commitMouseFrame(this.mouse);\n  }\n}\n","import {\n  COLLIDERS,\n  ROAM_CONTROL,\n  TERRAIN,\n  type Collider,\n  type RoamControl,\n  type SystemPlugin,\n  type TerrainCapability,\n} from \"@scenography/engine\";\nimport type { Scene } from \"@scenography/scene\";\nimport { Vector3 } from \"three\";\n\nimport { FreeRoamControls } from \"./FreeRoamControls\";\n\n/**\n * First-person camera — a *system* plugin. It drives the kernel camera from\n * WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`\n * over the terrain, and blocks it against wall colliders. Consumes the `terrain`\n * and `colliders` capabilities (live, so it tracks async heightmaps and hot wall\n * edits) and publishes `roamControl` so a framing/tour system can suspend it.\n */\nexport const fpc = (): SystemPlugin => ({\n  name: \"fpc\",\n  setup: (ctx) => {\n    const { camera, canvas, input, capabilities, scene } = ctx;\n    const terrainHeight = (x: number, z: number): number =>\n      capabilities.get<TerrainCapability>(TERRAIN)?.heightAt(x, z) ?? 0;\n    // Follow terrain only when some plugin provides it; otherwise keep a fixed Y.\n    const groundHeight = (): ((x: number, z: number) => number) | undefined =>\n      capabilities.get<TerrainCapability>(TERRAIN) ? terrainHeight : undefined;\n\n    const start = scene.camera.start;\n    const controls = new FreeRoamControls(camera, canvas, input, {\n      position: new Vector3(start.position[0], start.position[1], start.position[2]),\n      yaw: start.yaw,\n      boundary: scene.boundary,\n      eyeHeight: scene.camera.eyeHeight,\n      groundHeight: groundHeight(),\n    });\n    controls.attach();\n    capabilities.provide(ROAM_CONTROL, controls satisfies RoamControl);\n\n    // Eye height: an explicit `camera.eyeHeight` wins. Otherwise it was derived\n    // from the start Y over the ground — but a floor heightmap loads async, so\n    // recalibrate once the terrain is real, or the visitor walks in the air.\n    const calibrateEyeHeight = (s: Scene): void => {\n      if (s.camera.eyeHeight !== undefined) controls.setEyeHeight(s.camera.eyeHeight);\n      else {\n        const terrain = capabilities.get<TerrainCapability>(TERRAIN);\n        if (terrain) void terrain.ready.then(() => controls.recalibrateEyeHeight());\n      }\n    };\n    calibrateEyeHeight(scene);\n\n    return {\n      update: (deltaMs) => {\n        controls.setColliders(capabilities.get<Collider[]>(COLLIDERS) ?? []);\n        controls.update(deltaMs / 1000);\n      },\n      setScene: (s) => {\n        controls.setBoundary(s.boundary);\n        controls.setGroundHeight(groundHeight() ?? null);\n        calibrateEyeHeight(s);\n      },\n      dispose: () => {\n        controls.detach();\n        capabilities.revoke(ROAM_CONTROL);\n      },\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,126 @@
+import { Collider, SystemPlugin } from "@scenography/engine";
+import { PerspectiveCamera, Vector3 } from "three";
+import { Vec2 } from "@scenography/scene";
+
+//#region src/plugin.d.ts
+/**
+ * First-person camera — a *system* plugin. It drives the kernel camera from
+ * WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`
+ * over the terrain, and blocks it against wall colliders. Consumes the `terrain`
+ * and `colliders` capabilities (live, so it tracks async heightmaps and hot wall
+ * edits) and publishes `roamControl` so a framing/tour system can suspend it.
+ */
+declare const fpc: () => SystemPlugin;
+//#endregion
+//#region src/touch.d.ts
+/**
+ * The shape of the shared analog input fpc reads (the kernel's `InputBus`): the
+ * move/look axes a joystick feeds. Structural, so any producer with these fields
+ * works. fpc interprets them as walking + turning; another camera might not.
+ */
+interface AnalogInput {
+  /** Forward (`+1`) / backward (`-1`) movement. */
+  moveForward: number;
+  /** Strafe right (`+1`) / left (`-1`). */
+  moveStrafe: number;
+  /** Look right (`+1`) / left (`-1`). */
+  lookX: number;
+  /** Look up (`+1`) / down (`-1`). */
+  lookY: number;
+}
+//#endregion
+//#region src/FreeRoamControls.d.ts
+interface FreeRoamOptions {
+  /** Wall collision boxes the camera can't pass through. */
+  colliders?: Collider[];
+  /** Camera collision radius in world units. Defaults to `25`. */
+  playerRadius?: number;
+  /** Starting position. */
+  position?: Vector3;
+  /** Starting yaw in radians. */
+  yaw?: number;
+  /** Walkable-area polygon (XZ ring); the camera can't step outside it. */
+  boundary?: Vec2[];
+  /** Ground height at `(x, z)`; when set the camera follows the terrain. */
+  groundHeight?: (x: number, z: number) => number;
+  /** Eye height above the ground. Defaults to the start Y over the start ground. */
+  eyeHeight?: number;
+}
+/**
+ * First-person, free-roaming camera controls: drag-to-look with the mouse, WASD
+ * to walk, a subtle head-bob while moving, wall collision and terrain following.
+ * The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on
+ * top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the
+ * camera upright (no roll) and clamps pitch — the first-person contract.
+ *
+ * Framework-agnostic: construct it with a camera, the canvas and the input,
+ * call `attach()`, then `update(delta)` once per frame.
+ */
+declare class FreeRoamControls {
+  private colliders;
+  private readonly playerRadius;
+  private readonly camera;
+  private readonly domElement;
+  private readonly input;
+  private readonly mouse;
+  private readonly keyboard;
+  private readonly headBob;
+  private readonly look;
+  private rotation;
+  private translation;
+  private enabled;
+  private boundary;
+  private groundHeight;
+  private readonly start;
+  private eyeHeight;
+  private readonly handlers;
+  constructor(camera: PerspectiveCamera, domElement: HTMLElement, input: AnalogInput, options?: FreeRoamOptions);
+  /** Current eye height above the ground (world units). */
+  getEyeHeight(): number;
+  /** Fix the eye height above the ground (world units). */
+  setEyeHeight(eyeHeight: number): void;
+  /**
+   * Re-derive the default eye height (start Y over the ground under the start
+   * position). Call once asynchronous ground data (a floor heightmap) has
+   * loaded: the value captured at construction was measured against the
+   * not-yet-displaced floor.
+   */
+  recalibrateEyeHeight(): void;
+  attach(): void;
+  detach(): void;
+  /** Replace the wall collision set (e.g. after the scene's walls change). */
+  setColliders(colliders: Collider[]): void;
+  /** Replace the walkable-area boundary polygon (or clear it with `undefined`). */
+  setBoundary(boundary: Vec2[] | undefined): void;
+  /** Replace the ground-height function (or clear it to stop following terrain). */
+  setGroundHeight(groundHeight: ((x: number, z: number) => number) | null): void;
+  /**
+   * Enable/disable user input. While disabled, `update()` leaves the camera
+   * untouched so another driver (e.g. a camera tween) can own it; re-enable after
+   * syncing the pose with `setPose` so free-roam continues from there.
+   */
+  setEnabled(enabled: boolean): void;
+  /** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */
+  getPose(): {
+    position: Vector3;
+    phi: number;
+    theta: number;
+  };
+  /** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */
+  setPose(position: Vector3, phi: number, theta: number): void;
+  /** Advance the camera by `delta` seconds of input. */
+  update(delta: number): void;
+}
+//#endregion
+//#region src/collision.d.ts
+/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */
+declare const insidePolygon: (x: number, z: number, polygon: Vec2[]) => boolean;
+/**
+ * Resolve a desired XZ step against wall colliders and an optional walkable-area
+ * boundary, one axis at a time so the camera slides along an obstacle instead of
+ * sticking when it can't move straight.
+ */
+declare const resolveMove: (current: Vector3, step: Vector3, colliders: Collider[], radius: number, boundary?: Vec2[]) => Vector3;
+//#endregion
+export { FreeRoamControls, type FreeRoamOptions, fpc, insidePolygon, resolveMove };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,126 @@
+import { Collider, SystemPlugin } from "@scenography/engine";
+import { PerspectiveCamera, Quaternion, Vector2, Vector3 } from "three";
+import { Vec2 } from "@scenography/scene";
+
+//#region src/plugin.d.ts
+/**
+ * First-person camera — a *system* plugin. It drives the kernel camera from
+ * WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`
+ * over the terrain, and blocks it against wall colliders. Consumes the `terrain`
+ * and `colliders` capabilities (live, so it tracks async heightmaps and hot wall
+ * edits) and publishes `roamControl` so a framing/tour system can suspend it.
+ */
+declare const fpc: () => SystemPlugin;
+//#endregion
+//#region src/touch.d.ts
+/**
+ * The shape of the shared analog input fpc reads (the kernel's `InputBus`): the
+ * move/look axes a joystick feeds. Structural, so any producer with these fields
+ * works. fpc interprets them as walking + turning; another camera might not.
+ */
+interface AnalogInput {
+  /** Forward (`+1`) / backward (`-1`) movement. */
+  moveForward: number;
+  /** Strafe right (`+1`) / left (`-1`). */
+  moveStrafe: number;
+  /** Look right (`+1`) / left (`-1`). */
+  lookX: number;
+  /** Look up (`+1`) / down (`-1`). */
+  lookY: number;
+}
+//#endregion
+//#region src/FreeRoamControls.d.ts
+interface FreeRoamOptions {
+  /** Wall collision boxes the camera can't pass through. */
+  colliders?: Collider[];
+  /** Camera collision radius in world units. Defaults to `25`. */
+  playerRadius?: number;
+  /** Starting position. */
+  position?: Vector3;
+  /** Starting yaw in radians. */
+  yaw?: number;
+  /** Walkable-area polygon (XZ ring); the camera can't step outside it. */
+  boundary?: Vec2[];
+  /** Ground height at `(x, z)`; when set the camera follows the terrain. */
+  groundHeight?: (x: number, z: number) => number;
+  /** Eye height above the ground. Defaults to the start Y over the start ground. */
+  eyeHeight?: number;
+}
+/**
+ * First-person, free-roaming camera controls: drag-to-look with the mouse, WASD
+ * to walk, a subtle head-bob while moving, wall collision and terrain following.
+ * The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on
+ * top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the
+ * camera upright (no roll) and clamps pitch — the first-person contract.
+ *
+ * Framework-agnostic: construct it with a camera, the canvas and the input,
+ * call `attach()`, then `update(delta)` once per frame.
+ */
+declare class FreeRoamControls {
+  private colliders;
+  private readonly playerRadius;
+  private readonly camera;
+  private readonly domElement;
+  private readonly input;
+  private readonly mouse;
+  private readonly keyboard;
+  private readonly headBob;
+  private readonly look;
+  private rotation;
+  private translation;
+  private enabled;
+  private boundary;
+  private groundHeight;
+  private readonly start;
+  private eyeHeight;
+  private readonly handlers;
+  constructor(camera: PerspectiveCamera, domElement: HTMLElement, input: AnalogInput, options?: FreeRoamOptions);
+  /** Current eye height above the ground (world units). */
+  getEyeHeight(): number;
+  /** Fix the eye height above the ground (world units). */
+  setEyeHeight(eyeHeight: number): void;
+  /**
+   * Re-derive the default eye height (start Y over the ground under the start
+   * position). Call once asynchronous ground data (a floor heightmap) has
+   * loaded: the value captured at construction was measured against the
+   * not-yet-displaced floor.
+   */
+  recalibrateEyeHeight(): void;
+  attach(): void;
+  detach(): void;
+  /** Replace the wall collision set (e.g. after the scene's walls change). */
+  setColliders(colliders: Collider[]): void;
+  /** Replace the walkable-area boundary polygon (or clear it with `undefined`). */
+  setBoundary(boundary: Vec2[] | undefined): void;
+  /** Replace the ground-height function (or clear it to stop following terrain). */
+  setGroundHeight(groundHeight: ((x: number, z: number) => number) | null): void;
+  /**
+   * Enable/disable user input. While disabled, `update()` leaves the camera
+   * untouched so another driver (e.g. a camera tween) can own it; re-enable after
+   * syncing the pose with `setPose` so free-roam continues from there.
+   */
+  setEnabled(enabled: boolean): void;
+  /** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */
+  getPose(): {
+    position: Vector3;
+    phi: number;
+    theta: number;
+  };
+  /** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */
+  setPose(position: Vector3, phi: number, theta: number): void;
+  /** Advance the camera by `delta` seconds of input. */
+  update(delta: number): void;
+}
+//#endregion
+//#region src/collision.d.ts
+/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */
+declare const insidePolygon: (x: number, z: number, polygon: Vec2[]) => boolean;
+/**
+ * Resolve a desired XZ step against wall colliders and an optional walkable-area
+ * boundary, one axis at a time so the camera slides along an obstacle instead of
+ * sticking when it can't move straight.
+ */
+declare const resolveMove: (current: Vector3, step: Vector3, colliders: Collider[], radius: number, boundary?: Vec2[]) => Vector3;
+//#endregion
+export { FreeRoamControls, type FreeRoamOptions, fpc, insidePolygon, resolveMove };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,363 @@
+import { COLLIDERS, ROAM_CONTROL, TERRAIN } from "@scenography/engine";
+import { Quaternion, Vector2, Vector3 } from "three";
+//#region src/collision.ts
+/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */
+const insidePolygon = (x, z, polygon) => {
+	let inside = false;
+	for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+		const a = polygon[i];
+		const b = polygon[j];
+		if (!a || !b) continue;
+		if (a[1] > z !== b[1] > z && x < (b[0] - a[0]) * (z - a[1]) / (b[1] - a[1]) + a[0]) inside = !inside;
+	}
+	return inside;
+};
+/** Whether a circle of `radius` centered at `(x, z)` overlaps any collider box. */
+const hits = (x, z, radius, colliders) => {
+	const r2 = radius * radius;
+	for (const c of colliders) {
+		const px = x - c.cx;
+		const pz = z - c.cz;
+		const along = px * c.dx + pz * c.dz;
+		const perp = px * -c.dz + pz * c.dx;
+		const ddAlong = along - Math.max(-c.halfLength, Math.min(c.halfLength, along));
+		const ddPerp = perp - Math.max(-c.halfThickness, Math.min(c.halfThickness, perp));
+		if (ddAlong * ddAlong + ddPerp * ddPerp < r2) return true;
+	}
+	return false;
+};
+/**
+* Resolve a desired XZ step against wall colliders and an optional walkable-area
+* boundary, one axis at a time so the camera slides along an obstacle instead of
+* sticking when it can't move straight.
+*/
+const resolveMove = (current, step, colliders, radius, boundary) => {
+	let { x, z } = current;
+	const free = (nx, nz) => !hits(nx, nz, radius, colliders) && (!boundary || insidePolygon(nx, nz, boundary));
+	if (step.x !== 0 && free(x + step.x, z)) x += step.x;
+	if (step.z !== 0 && free(x, z + step.z)) z += step.z;
+	return new Vector3(x, current.y, z);
+};
+//#endregion
+//#region src/headBob.ts
+const createHeadBobState = () => ({
+	active: false,
+	timer: 0
+});
+/**
+* Advance the head-bob timer by `elapsed` seconds, snapping to half-wavelength
+* steps so the bob always settles back to neutral when movement stops.
+*/
+const updateHeadBob = (state, elapsed) => {
+	if (!state.active) return;
+	const wavelength = Math.PI;
+	const nextStepTime = (1 + Math.floor((state.timer + 1e-6) * 10 / wavelength)) * wavelength / 10;
+	state.timer = Math.min(state.timer + elapsed, nextStepTime);
+	if (state.timer === nextStepTime) state.active = false;
+};
+/** Vertical offset to add to the camera, in world units. */
+const headBobOffset = (state) => Math.sin(state.timer * 10) * 1.5;
+//#endregion
+//#region src/keyboard.ts
+const createKeyboardState = () => ({});
+/** Codes the controls consume; preventDefault'd so the arrows don't scroll. */
+const MOVEMENT_KEYS = new Set([
+	"KeyW",
+	"KeyA",
+	"KeyS",
+	"KeyD",
+	"ArrowUp",
+	"ArrowDown",
+	"ArrowLeft",
+	"ArrowRight"
+]);
+const onKeyDown = (state, event) => {
+	state[event.code] = true;
+	if (MOVEMENT_KEYS.has(event.code)) event.preventDefault();
+};
+const onKeyUp = (state, event) => {
+	state[event.code] = false;
+};
+/** Yaw turn rate for the Q/E keys, in radians per second. */
+const KEY_TURN_SPEED = 1.8;
+/**
+* Turn a forward/strafe pair (each in `-1..1`) into a per-frame translation
+* oriented by the current yaw (`phi`). Shared by keyboard and touch input.
+*/
+const movementFromAxis = (forwardVelocity, strafeVelocity, phi, delta, boosted = false) => {
+	const factor = boosted ? 60 : 20;
+	const yaw = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), phi);
+	const forward = new Vector3(0, 0, -10).applyQuaternion(yaw).multiplyScalar(forwardVelocity * delta * factor);
+	const left = new Vector3(-10, 0, 0).applyQuaternion(yaw).multiplyScalar(strafeVelocity * delta * factor);
+	return forward.add(left);
+};
+/**
+* Compute the per-frame translation from WASD or arrow-key input, oriented by
+* the current yaw (`phi`). Holding Shift acts as a speed booster.
+*/
+const movementFromKeyboard = (state, phi, delta) => {
+	const has = (...codes) => codes.some((c) => state[c]) ? 1 : 0;
+	return movementFromAxis(has("KeyW", "ArrowUp") - has("KeyS", "ArrowDown"), has("KeyA", "ArrowLeft") - has("KeyD", "ArrowRight"), phi, delta, Boolean(state["ShiftLeft"] || state["ShiftRight"]));
+};
+/**
+* Per-frame yaw delta (radians) from the Q/E turn keys. Q turns left
+* (increasing yaw), E turns right.
+*/
+const yawFromKeyboard = (state, delta) => {
+	return ((state["KeyQ"] ? 1 : 0) - (state["KeyE"] ? 1 : 0)) * KEY_TURN_SPEED * delta;
+};
+//#endregion
+//#region src/mouse.ts
+const PHI_SPEED = 8;
+const THETA_SPEED = 5;
+const createMouseState = () => ({
+	dragging: false,
+	pos: new Vector2(),
+	prevPos: new Vector2(),
+	delta: new Vector2()
+});
+const clamp = (x, a, b) => Math.min(Math.max(x, a), b);
+/** Maximum up/down look angle (radians) — keeps the camera from flipping over. */
+const MAX_PITCH = Math.PI / 3;
+/** Build the look quaternion from the current yaw/pitch angles. */
+const quaternionFromLook = (look) => {
+	const qy = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), look.phi);
+	const qx = new Quaternion().setFromAxisAngle(new Vector3(1, 0, 0), look.theta);
+	return new Quaternion().multiply(qy).multiply(qx);
+};
+const onMouseDown = (state, event) => {
+	state.dragging = event.button === 0;
+};
+const onMouseUp = (state) => {
+	state.dragging = false;
+};
+const onMouseMove = (state, event) => {
+	state.pos.set(event.pageX - window.innerWidth / 2, event.pageY - window.innerHeight / 2);
+	state.delta.subVectors(state.pos, state.prevPos);
+};
+const commitMouseFrame = (state) => {
+	state.prevPos.copy(state.pos);
+	state.delta.set(0, 0);
+};
+/**
+* Integrate the pointer delta into the look angles. Mutates `look` in place.
+* Yaw is unbounded; pitch is clamped to avoid flipping over.
+*/
+const updateLookFromMouse = (mouse, look) => {
+	const xh = mouse.delta.x / window.innerWidth;
+	const yh = mouse.delta.y / window.innerHeight;
+	look.phi += -xh * PHI_SPEED;
+	look.theta = clamp(look.theta + -yh * THETA_SPEED, -MAX_PITCH, MAX_PITCH);
+};
+//#endregion
+//#region src/touch.ts
+/** Look turn rate driven by the joystick, in radians per second at full deflection. */
+const LOOK_SPEED = 2.2;
+/** Per-frame translation from the analog move axes, oriented by yaw (`phi`). */
+const movementFromTouch = (state, phi, delta) => {
+	if (state.moveForward === 0 && state.moveStrafe === 0) return new Vector3();
+	return movementFromAxis(state.moveForward, -state.moveStrafe, phi, delta);
+};
+/** Integrate the look joystick into the look angles, mutating `look` in place. */
+const updateLookFromTouch = (state, look, delta) => {
+	if (state.lookX === 0 && state.lookY === 0) return;
+	look.phi -= state.lookX * LOOK_SPEED * delta;
+	look.theta = clamp(look.theta + state.lookY * LOOK_SPEED * delta, -MAX_PITCH, MAX_PITCH);
+};
+//#endregion
+//#region src/FreeRoamControls.ts
+/**
+* First-person, free-roaming camera controls: drag-to-look with the mouse, WASD
+* to walk, a subtle head-bob while moving, wall collision and terrain following.
+* The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on
+* top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the
+* camera upright (no roll) and clamps pitch — the first-person contract.
+*
+* Framework-agnostic: construct it with a camera, the canvas and the input,
+* call `attach()`, then `update(delta)` once per frame.
+*/
+var FreeRoamControls = class {
+	colliders;
+	playerRadius;
+	camera;
+	domElement;
+	input;
+	mouse = createMouseState();
+	keyboard = createKeyboardState();
+	headBob = createHeadBobState();
+	look = {
+		phi: 0,
+		theta: 0
+	};
+	rotation = new Quaternion();
+	translation = new Vector3(0, 170, 0);
+	enabled = true;
+	boundary;
+	groundHeight;
+	start;
+	eyeHeight;
+	handlers = [];
+	constructor(camera, domElement, input, options = {}) {
+		this.camera = camera;
+		this.domElement = domElement;
+		this.input = input;
+		this.colliders = options.colliders ?? [];
+		this.playerRadius = options.playerRadius ?? 25;
+		if (options.position) this.translation.copy(options.position);
+		if (options.yaw !== void 0) this.look.phi = options.yaw;
+		this.rotation.setFromAxisAngle(new Vector3(0, 1, 0), this.look.phi);
+		this.boundary = options.boundary;
+		this.groundHeight = options.groundHeight ?? null;
+		this.start = this.translation.clone();
+		const groundAtStart = this.groundHeight?.(this.start.x, this.start.z) ?? 0;
+		this.eyeHeight = options.eyeHeight ?? this.start.y - groundAtStart;
+	}
+	/** Current eye height above the ground (world units). */
+	getEyeHeight() {
+		return this.eyeHeight;
+	}
+	/** Fix the eye height above the ground (world units). */
+	setEyeHeight(eyeHeight) {
+		this.eyeHeight = eyeHeight;
+	}
+	/**
+	* Re-derive the default eye height (start Y over the ground under the start
+	* position). Call once asynchronous ground data (a floor heightmap) has
+	* loaded: the value captured at construction was measured against the
+	* not-yet-displaced floor.
+	*/
+	recalibrateEyeHeight() {
+		const ground = this.groundHeight?.(this.start.x, this.start.z) ?? 0;
+		this.eyeHeight = this.start.y - ground;
+	}
+	attach() {
+		const bind = (target, type, listener) => {
+			target.addEventListener(type, listener);
+			this.handlers.push([
+				target,
+				type,
+				listener
+			]);
+		};
+		bind(this.domElement, "mousedown", (e) => onMouseDown(this.mouse, e));
+		bind(window, "mousemove", (e) => onMouseMove(this.mouse, e));
+		bind(window, "mouseup", () => onMouseUp(this.mouse));
+		bind(window, "keydown", (e) => onKeyDown(this.keyboard, e));
+		bind(window, "keyup", (e) => onKeyUp(this.keyboard, e));
+	}
+	detach() {
+		for (const [target, type, listener] of this.handlers) target.removeEventListener(type, listener);
+		this.handlers.length = 0;
+	}
+	/** Replace the wall collision set (e.g. after the scene's walls change). */
+	setColliders(colliders) {
+		this.colliders = colliders;
+	}
+	/** Replace the walkable-area boundary polygon (or clear it with `undefined`). */
+	setBoundary(boundary) {
+		this.boundary = boundary;
+	}
+	/** Replace the ground-height function (or clear it to stop following terrain). */
+	setGroundHeight(groundHeight) {
+		this.groundHeight = groundHeight;
+	}
+	/**
+	* Enable/disable user input. While disabled, `update()` leaves the camera
+	* untouched so another driver (e.g. a camera tween) can own it; re-enable after
+	* syncing the pose with `setPose` so free-roam continues from there.
+	*/
+	setEnabled(enabled) {
+		this.enabled = enabled;
+	}
+	/** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */
+	getPose() {
+		return {
+			position: this.translation.clone(),
+			phi: this.look.phi,
+			theta: this.look.theta
+		};
+	}
+	/** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */
+	setPose(position, phi, theta) {
+		this.translation.copy(position);
+		this.look.phi = phi;
+		this.look.theta = theta;
+		this.rotation = quaternionFromLook(this.look);
+	}
+	/** Advance the camera by `delta` seconds of input. */
+	update(delta) {
+		if (!this.enabled) {
+			commitMouseFrame(this.mouse);
+			return;
+		}
+		if (this.mouse.dragging) updateLookFromMouse(this.mouse, this.look);
+		this.look.phi += yawFromKeyboard(this.keyboard, delta);
+		updateLookFromTouch(this.input, this.look, delta);
+		this.rotation = quaternionFromLook(this.look);
+		const step = movementFromKeyboard(this.keyboard, this.look.phi, delta).add(movementFromTouch(this.input, this.look.phi, delta));
+		this.translation = resolveMove(this.translation, step, this.colliders, this.playerRadius, this.boundary);
+		if (this.groundHeight) this.translation.y = this.groundHeight(this.translation.x, this.translation.z) + this.eyeHeight;
+		if (step.x !== 0 || step.z !== 0) this.headBob.active = true;
+		updateHeadBob(this.headBob, delta);
+		this.camera.quaternion.copy(this.rotation);
+		this.camera.position.copy(this.translation);
+		this.camera.position.y += headBobOffset(this.headBob);
+		const target = new Vector3(0, 0, -1).applyQuaternion(this.rotation).multiplyScalar(100).add(this.translation);
+		this.camera.lookAt(target);
+		commitMouseFrame(this.mouse);
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* First-person camera — a *system* plugin. It drives the kernel camera from
+* WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`
+* over the terrain, and blocks it against wall colliders. Consumes the `terrain`
+* and `colliders` capabilities (live, so it tracks async heightmaps and hot wall
+* edits) and publishes `roamControl` so a framing/tour system can suspend it.
+*/
+const fpc = () => ({
+	name: "fpc",
+	setup: (ctx) => {
+		const { camera, canvas, input, capabilities, scene } = ctx;
+		const terrainHeight = (x, z) => capabilities.get(TERRAIN)?.heightAt(x, z) ?? 0;
+		const groundHeight = () => capabilities.get(TERRAIN) ? terrainHeight : void 0;
+		const start = scene.camera.start;
+		const controls = new FreeRoamControls(camera, canvas, input, {
+			position: new Vector3(start.position[0], start.position[1], start.position[2]),
+			yaw: start.yaw,
+			boundary: scene.boundary,
+			eyeHeight: scene.camera.eyeHeight,
+			groundHeight: groundHeight()
+		});
+		controls.attach();
+		capabilities.provide(ROAM_CONTROL, controls);
+		const calibrateEyeHeight = (s) => {
+			if (s.camera.eyeHeight !== void 0) controls.setEyeHeight(s.camera.eyeHeight);
+			else {
+				const terrain = capabilities.get(TERRAIN);
+				if (terrain) terrain.ready.then(() => controls.recalibrateEyeHeight());
+			}
+		};
+		calibrateEyeHeight(scene);
+		return {
+			update: (deltaMs) => {
+				controls.setColliders(capabilities.get(COLLIDERS) ?? []);
+				controls.update(deltaMs / 1e3);
+			},
+			setScene: (s) => {
+				controls.setBoundary(s.boundary);
+				controls.setGroundHeight(groundHeight() ?? null);
+				calibrateEyeHeight(s);
+			},
+			dispose: () => {
+				controls.detach();
+				capabilities.revoke(ROAM_CONTROL);
+			}
+		};
+	}
+});
+//#endregion
+export { FreeRoamControls, fpc, insidePolygon, resolveMove };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/collision.ts","../src/headBob.ts","../src/keyboard.ts","../src/mouse.ts","../src/touch.ts","../src/FreeRoamControls.ts","../src/plugin.ts"],"sourcesContent":["import { Vector3 } from \"three\";\nimport type { Vec2 } from \"@scenography/scene\";\nimport type { Collider } from \"@scenography/engine\";\n\n/** Whether `(x, z)` lies inside the XZ polygon (even-odd ray casting). */\nexport const insidePolygon = (x: number, z: number, polygon: Vec2[]): boolean => {\n  let inside = false;\n  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n    const a = polygon[i];\n    const b = polygon[j];\n    if (!a || !b) continue; // unreachable given the loop bounds; satisfies strict indexing\n    if (a[1] > z !== b[1] > z && x < ((b[0] - a[0]) * (z - a[1])) / (b[1] - a[1]) + a[0]) {\n      inside = !inside;\n    }\n  }\n  return inside;\n};\n\n/** Whether a circle of `radius` centered at `(x, z)` overlaps any collider box. */\nconst hits = (x: number, z: number, radius: number, colliders: Collider[]): boolean => {\n  const r2 = radius * radius;\n  for (const c of colliders) {\n    const px = x - c.cx;\n    const pz = z - c.cz;\n    // Project onto the box axes: along its length and along its thickness normal.\n    const along = px * c.dx + pz * c.dz;\n    const perp = px * -c.dz + pz * c.dx;\n    // Distance from the point to the closest point on the box.\n    const ddAlong = along - Math.max(-c.halfLength, Math.min(c.halfLength, along));\n    const ddPerp = perp - Math.max(-c.halfThickness, Math.min(c.halfThickness, perp));\n    if (ddAlong * ddAlong + ddPerp * ddPerp < r2) return true;\n  }\n  return false;\n};\n\n/**\n * Resolve a desired XZ step against wall colliders and an optional walkable-area\n * boundary, one axis at a time so the camera slides along an obstacle instead of\n * sticking when it can't move straight.\n */\nexport const resolveMove = (\n  current: Vector3,\n  step: Vector3,\n  colliders: Collider[],\n  radius: number,\n  boundary?: Vec2[],\n): Vector3 => {\n  let { x, z } = current;\n  const free = (nx: number, nz: number): boolean =>\n    !hits(nx, nz, radius, colliders) && (!boundary || insidePolygon(nx, nz, boundary));\n  if (step.x !== 0 && free(x + step.x, z)) x += step.x;\n  if (step.z !== 0 && free(x, z + step.z)) z += step.z;\n  return new Vector3(x, current.y, z);\n};\n","/** State for the subtle vertical bob applied while walking. */\nexport interface HeadBobState {\n  active: boolean;\n  timer: number;\n}\n\nexport const createHeadBobState = (): HeadBobState => ({ active: false, timer: 0 });\n\n/**\n * Advance the head-bob timer by `elapsed` seconds, snapping to half-wavelength\n * steps so the bob always settles back to neutral when movement stops.\n */\nexport const updateHeadBob = (state: HeadBobState, elapsed: number): void => {\n  if (!state.active) return;\n\n  const wavelength = Math.PI;\n  const nextStep = 1 + Math.floor(((state.timer + 1e-6) * 10) / wavelength);\n  const nextStepTime = (nextStep * wavelength) / 10;\n  state.timer = Math.min(state.timer + elapsed, nextStepTime);\n\n  if (state.timer === nextStepTime) state.active = false;\n};\n\n/** Vertical offset to add to the camera, in world units. */\nexport const headBobOffset = (state: HeadBobState): number => Math.sin(state.timer * 10) * 1.5;\n","import { Quaternion, Vector3 } from \"three\";\n\n/** Set of currently-pressed key codes. */\nexport type KeyboardState = Record<string, boolean>;\n\nexport const createKeyboardState = (): KeyboardState => ({});\n\n/** Codes the controls consume; preventDefault'd so the arrows don't scroll. */\nconst MOVEMENT_KEYS = new Set([\n  \"KeyW\",\n  \"KeyA\",\n  \"KeyS\",\n  \"KeyD\",\n  \"ArrowUp\",\n  \"ArrowDown\",\n  \"ArrowLeft\",\n  \"ArrowRight\",\n]);\n\nexport const onKeyDown = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = true;\n  if (MOVEMENT_KEYS.has(event.code)) event.preventDefault();\n};\n\nexport const onKeyUp = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = false;\n};\n\n/** Yaw turn rate for the Q/E keys, in radians per second. */\nconst KEY_TURN_SPEED = 1.8;\n\n/**\n * Turn a forward/strafe pair (each in `-1..1`) into a per-frame translation\n * oriented by the current yaw (`phi`). Shared by keyboard and touch input.\n */\nexport const movementFromAxis = (\n  forwardVelocity: number,\n  strafeVelocity: number,\n  phi: number,\n  delta: number,\n  boosted = false,\n): Vector3 => {\n  const factor = boosted ? 60 : 20;\n  const yaw = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), phi);\n\n  const forward = new Vector3(0, 0, -10)\n    .applyQuaternion(yaw)\n    .multiplyScalar(forwardVelocity * delta * factor);\n  const left = new Vector3(-10, 0, 0)\n    .applyQuaternion(yaw)\n    .multiplyScalar(strafeVelocity * delta * factor);\n\n  return forward.add(left);\n};\n\n/**\n * Compute the per-frame translation from WASD or arrow-key input, oriented by\n * the current yaw (`phi`). Holding Shift acts as a speed booster.\n */\nexport const movementFromKeyboard = (state: KeyboardState, phi: number, delta: number): Vector3 => {\n  const has = (...codes: string[]): number => (codes.some((c) => state[c]) ? 1 : 0);\n  const forwardVelocity = has(\"KeyW\", \"ArrowUp\") - has(\"KeyS\", \"ArrowDown\");\n  const strafeVelocity = has(\"KeyA\", \"ArrowLeft\") - has(\"KeyD\", \"ArrowRight\");\n  const boosted = Boolean(state[\"ShiftLeft\"] || state[\"ShiftRight\"]);\n\n  return movementFromAxis(forwardVelocity, strafeVelocity, phi, delta, boosted);\n};\n\n/**\n * Per-frame yaw delta (radians) from the Q/E turn keys. Q turns left\n * (increasing yaw), E turns right.\n */\nexport const yawFromKeyboard = (state: KeyboardState, delta: number): number => {\n  const turn = (state[\"KeyQ\"] ? 1 : 0) - (state[\"KeyE\"] ? 1 : 0);\n  return turn * KEY_TURN_SPEED * delta;\n};\n","import { Quaternion, Vector2, Vector3 } from \"three\";\n\n/** Mutable pointer state accumulated between frames. */\nexport interface MouseState {\n  /** Whether the primary button is held (drag-to-look). */\n  dragging: boolean;\n  pos: Vector2;\n  prevPos: Vector2;\n  delta: Vector2;\n}\n\n/** Look angles driven by the pointer. */\nexport interface LookState {\n  phi: number;\n  theta: number;\n}\n\nconst PHI_SPEED = 8;\nconst THETA_SPEED = 5;\n\nexport const createMouseState = (): MouseState => ({\n  dragging: false,\n  pos: new Vector2(),\n  prevPos: new Vector2(),\n  delta: new Vector2(),\n});\n\nexport const clamp = (x: number, a: number, b: number): number => Math.min(Math.max(x, a), b);\n\n/** Maximum up/down look angle (radians) — keeps the camera from flipping over. */\nexport const MAX_PITCH = Math.PI / 3;\n\n/** Build the look quaternion from the current yaw/pitch angles. */\nexport const quaternionFromLook = (look: LookState): Quaternion => {\n  const qy = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), look.phi);\n  const qx = new Quaternion().setFromAxisAngle(new Vector3(1, 0, 0), look.theta);\n  return new Quaternion().multiply(qy).multiply(qx);\n};\n\nexport const onMouseDown = (state: MouseState, event: MouseEvent): void => {\n  state.dragging = event.button === 0;\n};\n\nexport const onMouseUp = (state: MouseState): void => {\n  state.dragging = false;\n};\n\nexport const onMouseMove = (state: MouseState, event: MouseEvent): void => {\n  state.pos.set(event.pageX - window.innerWidth / 2, event.pageY - window.innerHeight / 2);\n  state.delta.subVectors(state.pos, state.prevPos);\n};\n\nexport const commitMouseFrame = (state: MouseState): void => {\n  state.prevPos.copy(state.pos);\n  state.delta.set(0, 0);\n};\n\n/**\n * Integrate the pointer delta into the look angles. Mutates `look` in place.\n * Yaw is unbounded; pitch is clamped to avoid flipping over.\n */\nexport const updateLookFromMouse = (mouse: MouseState, look: LookState): void => {\n  const xh = mouse.delta.x / window.innerWidth;\n  const yh = mouse.delta.y / window.innerHeight;\n\n  look.phi += -xh * PHI_SPEED;\n  look.theta = clamp(look.theta + -yh * THETA_SPEED, -MAX_PITCH, MAX_PITCH);\n};\n","import { Vector3 } from \"three\";\n\nimport { movementFromAxis } from \"./keyboard\";\nimport { clamp, MAX_PITCH, type LookState } from \"./mouse\";\n\n/**\n * The shape of the shared analog input fpc reads (the kernel's `InputBus`): the\n * move/look axes a joystick feeds. Structural, so any producer with these fields\n * works. fpc interprets them as walking + turning; another camera might not.\n */\nexport interface AnalogInput {\n  /** Forward (`+1`) / backward (`-1`) movement. */\n  moveForward: number;\n  /** Strafe right (`+1`) / left (`-1`). */\n  moveStrafe: number;\n  /** Look right (`+1`) / left (`-1`). */\n  lookX: number;\n  /** Look up (`+1`) / down (`-1`). */\n  lookY: number;\n}\n\n/** Look turn rate driven by the joystick, in radians per second at full deflection. */\nconst LOOK_SPEED = 2.2;\n\n/** Per-frame translation from the analog move axes, oriented by yaw (`phi`). */\nexport const movementFromTouch = (state: AnalogInput, phi: number, delta: number): Vector3 => {\n  if (state.moveForward === 0 && state.moveStrafe === 0) return new Vector3();\n  // Strafe sign matches the keyboard helper (left strafe is +1 there).\n  return movementFromAxis(state.moveForward, -state.moveStrafe, phi, delta);\n};\n\n/** Integrate the look joystick into the look angles, mutating `look` in place. */\nexport const updateLookFromTouch = (state: AnalogInput, look: LookState, delta: number): void => {\n  if (state.lookX === 0 && state.lookY === 0) return;\n  look.phi -= state.lookX * LOOK_SPEED * delta;\n  look.theta = clamp(look.theta + state.lookY * LOOK_SPEED * delta, -MAX_PITCH, MAX_PITCH);\n};\n","import { Quaternion, Vector3, type PerspectiveCamera } from \"three\";\nimport type { Vec2 } from \"@scenography/scene\";\nimport type { Collider } from \"@scenography/engine\";\n\nimport { resolveMove } from \"./collision\";\nimport { createHeadBobState, headBobOffset, updateHeadBob } from \"./headBob\";\nimport {\n  createKeyboardState,\n  movementFromKeyboard,\n  onKeyDown,\n  onKeyUp,\n  yawFromKeyboard,\n} from \"./keyboard\";\nimport {\n  commitMouseFrame,\n  createMouseState,\n  onMouseDown,\n  onMouseMove,\n  onMouseUp,\n  quaternionFromLook,\n  updateLookFromMouse,\n  type LookState,\n} from \"./mouse\";\nimport { movementFromTouch, updateLookFromTouch, type AnalogInput } from \"./touch\";\n\nexport interface FreeRoamOptions {\n  /** Wall collision boxes the camera can't pass through. */\n  colliders?: Collider[];\n  /** Camera collision radius in world units. Defaults to `25`. */\n  playerRadius?: number;\n  /** Starting position. */\n  position?: Vector3;\n  /** Starting yaw in radians. */\n  yaw?: number;\n  /** Walkable-area polygon (XZ ring); the camera can't step outside it. */\n  boundary?: Vec2[];\n  /** Ground height at `(x, z)`; when set the camera follows the terrain. */\n  groundHeight?: (x: number, z: number) => number;\n  /** Eye height above the ground. Defaults to the start Y over the start ground. */\n  eyeHeight?: number;\n}\n\n/**\n * First-person, free-roaming camera controls: drag-to-look with the mouse, WASD\n * to walk, a subtle head-bob while moving, wall collision and terrain following.\n * The shared analog input (`AnalogInput`, the kernel's InputBus) is folded in on\n * top of keyboard/mouse, so on-screen joysticks drive it too. It keeps the\n * camera upright (no roll) and clamps pitch — the first-person contract.\n *\n * Framework-agnostic: construct it with a camera, the canvas and the input,\n * call `attach()`, then `update(delta)` once per frame.\n */\nexport class FreeRoamControls {\n  private colliders: Collider[];\n  private readonly playerRadius: number;\n\n  private readonly camera: PerspectiveCamera;\n  private readonly domElement: HTMLElement;\n  private readonly input: AnalogInput;\n  private readonly mouse = createMouseState();\n  private readonly keyboard = createKeyboardState();\n  private readonly headBob = createHeadBobState();\n  private readonly look: LookState = { phi: 0, theta: 0 };\n  private rotation = new Quaternion();\n  private translation = new Vector3(0, 170, 0);\n  private enabled = true;\n  private boundary: Vec2[] | undefined;\n  private groundHeight: ((x: number, z: number) => number) | null;\n  private readonly start: Vector3;\n  private eyeHeight: number;\n\n  private readonly handlers: Array<[EventTarget, string, EventListener]> = [];\n\n  constructor(\n    camera: PerspectiveCamera,\n    domElement: HTMLElement,\n    input: AnalogInput,\n    options: FreeRoamOptions = {},\n  ) {\n    this.camera = camera;\n    this.domElement = domElement;\n    this.input = input;\n    this.colliders = options.colliders ?? [];\n    this.playerRadius = options.playerRadius ?? 25;\n    if (options.position) this.translation.copy(options.position);\n    if (options.yaw !== undefined) this.look.phi = options.yaw;\n    this.rotation.setFromAxisAngle(new Vector3(0, 1, 0), this.look.phi);\n    this.boundary = options.boundary;\n    this.groundHeight = options.groundHeight ?? null;\n    this.start = this.translation.clone();\n    // Eye height = start Y above the ground under the start position.\n    const groundAtStart = this.groundHeight?.(this.start.x, this.start.z) ?? 0;\n    this.eyeHeight = options.eyeHeight ?? this.start.y - groundAtStart;\n  }\n\n  /** Current eye height above the ground (world units). */\n  getEyeHeight(): number {\n    return this.eyeHeight;\n  }\n\n  /** Fix the eye height above the ground (world units). */\n  setEyeHeight(eyeHeight: number): void {\n    this.eyeHeight = eyeHeight;\n  }\n\n  /**\n   * Re-derive the default eye height (start Y over the ground under the start\n   * position). Call once asynchronous ground data (a floor heightmap) has\n   * loaded: the value captured at construction was measured against the\n   * not-yet-displaced floor.\n   */\n  recalibrateEyeHeight(): void {\n    const ground = this.groundHeight?.(this.start.x, this.start.z) ?? 0;\n    this.eyeHeight = this.start.y - ground;\n  }\n\n  attach(): void {\n    const bind = (target: EventTarget, type: string, listener: EventListener): void => {\n      target.addEventListener(type, listener);\n      this.handlers.push([target, type, listener]);\n    };\n\n    bind(this.domElement, \"mousedown\", (e) => onMouseDown(this.mouse, e as MouseEvent));\n    bind(window, \"mousemove\", (e) => onMouseMove(this.mouse, e as MouseEvent));\n    bind(window, \"mouseup\", () => onMouseUp(this.mouse));\n    bind(window, \"keydown\", (e) => onKeyDown(this.keyboard, e as KeyboardEvent));\n    bind(window, \"keyup\", (e) => onKeyUp(this.keyboard, e as KeyboardEvent));\n  }\n\n  detach(): void {\n    for (const [target, type, listener] of this.handlers)\n      target.removeEventListener(type, listener);\n    this.handlers.length = 0;\n  }\n\n  /** Replace the wall collision set (e.g. after the scene's walls change). */\n  setColliders(colliders: Collider[]): void {\n    this.colliders = colliders;\n  }\n\n  /** Replace the walkable-area boundary polygon (or clear it with `undefined`). */\n  setBoundary(boundary: Vec2[] | undefined): void {\n    this.boundary = boundary;\n  }\n\n  /** Replace the ground-height function (or clear it to stop following terrain). */\n  setGroundHeight(groundHeight: ((x: number, z: number) => number) | null): void {\n    this.groundHeight = groundHeight;\n  }\n\n  /**\n   * Enable/disable user input. While disabled, `update()` leaves the camera\n   * untouched so another driver (e.g. a camera tween) can own it; re-enable after\n   * syncing the pose with `setPose` so free-roam continues from there.\n   */\n  setEnabled(enabled: boolean): void {\n    this.enabled = enabled;\n  }\n\n  /** Current pose: world position plus yaw (`phi`) and pitch (`theta`) in radians. */\n  getPose(): { position: Vector3; phi: number; theta: number } {\n    return { position: this.translation.clone(), phi: this.look.phi, theta: this.look.theta };\n  }\n\n  /** Force the pose (e.g. at the end of a camera tween) so input resumes from it. */\n  setPose(position: Vector3, phi: number, theta: number): void {\n    this.translation.copy(position);\n    this.look.phi = phi;\n    this.look.theta = theta;\n    this.rotation = quaternionFromLook(this.look);\n  }\n\n  /** Advance the camera by `delta` seconds of input. */\n  update(delta: number): void {\n    // Disabled: another driver owns the camera this frame. Drop any accumulated\n    // pointer delta so look doesn't jump when control is handed back.\n    if (!this.enabled) {\n      commitMouseFrame(this.mouse);\n      return;\n    }\n    // Accumulate look from every source into the angles, then derive rotation.\n    if (this.mouse.dragging) updateLookFromMouse(this.mouse, this.look);\n    this.look.phi += yawFromKeyboard(this.keyboard, delta);\n    updateLookFromTouch(this.input, this.look, delta);\n    this.rotation = quaternionFromLook(this.look);\n\n    const step = movementFromKeyboard(this.keyboard, this.look.phi, delta).add(\n      movementFromTouch(this.input, this.look.phi, delta),\n    );\n    this.translation = resolveMove(\n      this.translation,\n      step,\n      this.colliders,\n      this.playerRadius,\n      this.boundary,\n    );\n    // Follow the terrain: keep the eye a fixed height above the ground below.\n    if (this.groundHeight) {\n      this.translation.y = this.groundHeight(this.translation.x, this.translation.z) + this.eyeHeight;\n    }\n    if (step.x !== 0 || step.z !== 0) this.headBob.active = true;\n    updateHeadBob(this.headBob, delta);\n\n    this.camera.quaternion.copy(this.rotation);\n    this.camera.position.copy(this.translation);\n    this.camera.position.y += headBobOffset(this.headBob);\n\n    const target = new Vector3(0, 0, -1)\n      .applyQuaternion(this.rotation)\n      .multiplyScalar(100)\n      .add(this.translation);\n    this.camera.lookAt(target);\n\n    commitMouseFrame(this.mouse);\n  }\n}\n","import {\n  COLLIDERS,\n  ROAM_CONTROL,\n  TERRAIN,\n  type Collider,\n  type RoamControl,\n  type SystemPlugin,\n  type TerrainCapability,\n} from \"@scenography/engine\";\nimport type { Scene } from \"@scenography/scene\";\nimport { Vector3 } from \"three\";\n\nimport { FreeRoamControls } from \"./FreeRoamControls\";\n\n/**\n * First-person camera — a *system* plugin. It drives the kernel camera from\n * WASD/drag plus the shared analog input (joysticks), keeps it at `eyeHeight`\n * over the terrain, and blocks it against wall colliders. Consumes the `terrain`\n * and `colliders` capabilities (live, so it tracks async heightmaps and hot wall\n * edits) and publishes `roamControl` so a framing/tour system can suspend it.\n */\nexport const fpc = (): SystemPlugin => ({\n  name: \"fpc\",\n  setup: (ctx) => {\n    const { camera, canvas, input, capabilities, scene } = ctx;\n    const terrainHeight = (x: number, z: number): number =>\n      capabilities.get<TerrainCapability>(TERRAIN)?.heightAt(x, z) ?? 0;\n    // Follow terrain only when some plugin provides it; otherwise keep a fixed Y.\n    const groundHeight = (): ((x: number, z: number) => number) | undefined =>\n      capabilities.get<TerrainCapability>(TERRAIN) ? terrainHeight : undefined;\n\n    const start = scene.camera.start;\n    const controls = new FreeRoamControls(camera, canvas, input, {\n      position: new Vector3(start.position[0], start.position[1], start.position[2]),\n      yaw: start.yaw,\n      boundary: scene.boundary,\n      eyeHeight: scene.camera.eyeHeight,\n      groundHeight: groundHeight(),\n    });\n    controls.attach();\n    capabilities.provide(ROAM_CONTROL, controls satisfies RoamControl);\n\n    // Eye height: an explicit `camera.eyeHeight` wins. Otherwise it was derived\n    // from the start Y over the ground — but a floor heightmap loads async, so\n    // recalibrate once the terrain is real, or the visitor walks in the air.\n    const calibrateEyeHeight = (s: Scene): void => {\n      if (s.camera.eyeHeight !== undefined) controls.setEyeHeight(s.camera.eyeHeight);\n      else {\n        const terrain = capabilities.get<TerrainCapability>(TERRAIN);\n        if (terrain) void terrain.ready.then(() => controls.recalibrateEyeHeight());\n      }\n    };\n    calibrateEyeHeight(scene);\n\n    return {\n      update: (deltaMs) => {\n        controls.setColliders(capabilities.get<Collider[]>(COLLIDERS) ?? []);\n        controls.update(deltaMs / 1000);\n      },\n      setScene: (s) => {\n        controls.setBoundary(s.boundary);\n        controls.setGroundHeight(groundHeight() ?? null);\n        calibrateEyeHeight(s);\n      },\n      dispose: () => {\n        controls.detach();\n        capabilities.revoke(ROAM_CONTROL);\n      },\n    };\n  },\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@scenography/plugin-fpc",
+  "version": "0.2.0",
+  "description": "First-person camera plugin for scenography: WASD + drag/touch free-roam with head-bob, wall collision and terrain following. A system plugin that drives the kernel camera.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@scenography/scene": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.160.0",
+    "three": "^0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}