@scenography/engine 0.1.0

package/dist/index.cjs

@@ -0,0 +1,399 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let three = require("three");
+//#region src/controls/boundaries.ts
+/**
+* Clamp a step on the XZ plane to a square `[-bound, bound]`. Axes are clamped
+* independently so sliding along a wall still works when one axis is blocked.
+*/
+const clampToBounds = (current, step, bound) => {
+	const next = new three.Vector3().addVectors(current, step);
+	if (next.x < -bound || next.x > bound) next.x = current.x;
+	if (next.z < -bound || next.z > bound) next.z = current.z;
+	return next;
+};
+//#endregion
+//#region src/controls/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/controls/keyboard.ts
+const createKeyboardState = () => ({});
+const onKeyDown = (state, event) => {
+	state[event.code] = true;
+};
+const onKeyUp = (state, event) => {
+	state[event.code] = false;
+};
+/**
+* Compute the per-frame translation from WASD input, oriented by the current
+* yaw (`phi`). Holding Shift acts as a speed booster.
+*/
+const movementFromKeyboard = (state, phi, delta) => {
+	const has = (code) => state[code] ? 1 : 0;
+	const forwardVelocity = has("KeyW") - has("KeyS");
+	const strafeVelocity = has("KeyA") - has("KeyD");
+	const factor = state["ShiftLeft"] || state["ShiftRight"] ? 30 : 10;
+	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);
+};
+//#endregion
+//#region src/controls/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);
+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 a look quaternion. Mutates `look` and
+* returns the resulting rotation. 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, -Math.PI / 3, Math.PI / 3);
+	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);
+};
+//#endregion
+//#region src/controls/FreeRoamControls.ts
+/**
+* First-person, free-roaming camera controls ported from the original Virtual
+* Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while
+* moving, and square boundary clamping. The cardboard / device-orientation path
+* was intentionally dropped.
+*
+* Framework-agnostic: construct it with a camera and the canvas element, call
+* `attach()`, then `update(delta)` once per frame.
+*/
+var FreeRoamControls = class {
+	bounds;
+	camera;
+	domElement;
+	mouse = createMouseState();
+	keyboard = createKeyboardState();
+	headBob = createHeadBobState();
+	look = {
+		phi: 0,
+		theta: 0
+	};
+	rotation = new three.Quaternion();
+	translation = new three.Vector3(0, 170, 0);
+	handlers = [];
+	constructor(camera, domElement, options = {}) {
+		this.camera = camera;
+		this.domElement = domElement;
+		this.bounds = options.bounds ?? 450;
+		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);
+	}
+	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;
+	}
+	/** Advance the camera by `delta` seconds of input. */
+	update(delta) {
+		if (this.mouse.dragging) this.rotation = updateLookFromMouse(this.mouse, this.look);
+		const step = movementFromKeyboard(this.keyboard, this.look.phi, delta);
+		this.translation = clampToBounds(this.translation, step, this.bounds);
+		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/builders/wall.ts
+/** Build the three.js object that materializes a `Wall` definition. */
+function buildWall(wall) {
+	const [width, height] = wall.size;
+	const mesh = new three.Mesh(new three.PlaneGeometry(width, height), new three.MeshStandardMaterial({
+		color: wall.color ?? "#ffffff",
+		side: three.DoubleSide
+	}));
+	mesh.position.set(wall.position[0], wall.position[1], wall.position[2]);
+	mesh.rotation.y = wall.rotation ?? 0;
+	mesh.name = `wall:${wall.id}`;
+	mesh.userData.scenographyId = wall.id;
+	return mesh;
+}
+//#endregion
+//#region src/builders/artwork.ts
+const loader = new three.TextureLoader();
+const FRAME_MARGIN = 4;
+const SURFACE_OFFSET = 1;
+/**
+* Build the three.js object for an `Artwork`, placing it on its wall. The piece
+* is positioned in the wall's local plane via `offset` and nudged forward along
+* the wall normal so it sits in front of the surface.
+*/
+function buildArtwork(artwork, wall) {
+	const [width, height] = artwork.size;
+	const [offsetX, offsetY] = artwork.offset ?? [0, 0];
+	const yaw = wall.rotation ?? 0;
+	const group = new three.Group();
+	const wallQuat = new three.Quaternion().setFromAxisAngle(new three.Vector3(0, 1, 0), yaw);
+	const right = new three.Vector3(1, 0, 0).applyQuaternion(wallQuat);
+	const normal = new three.Vector3(0, 0, 1).applyQuaternion(wallQuat);
+	const position = new three.Vector3(wall.position[0], wall.position[1], wall.position[2]).add(right.clone().multiplyScalar(offsetX)).add(new three.Vector3(0, offsetY, 0)).add(normal.clone().multiplyScalar(SURFACE_OFFSET));
+	group.position.copy(position);
+	group.rotation.y = yaw;
+	const frame = new three.Mesh(new three.PlaneGeometry(width + FRAME_MARGIN, height + FRAME_MARGIN), new three.MeshStandardMaterial({ color: "#1a1a1a" }));
+	group.add(frame);
+	const texture = loader.load(artwork.src);
+	texture.colorSpace = three.SRGBColorSpace;
+	const image = new three.Mesh(new three.PlaneGeometry(width, height), new three.MeshBasicMaterial({ map: texture }));
+	image.position.z = .1;
+	group.add(image);
+	group.name = `artwork:${artwork.id}`;
+	group.userData.scenographyId = artwork.id;
+	group.userData.wallId = artwork.wall;
+	return group;
+}
+//#endregion
+//#region src/SceneManager.ts
+const disposeObject = (object) => {
+	object.traverse((child) => {
+		const mesh = child;
+		mesh.geometry?.dispose?.();
+		const material = mesh.material;
+		const dispose = (m) => m?.dispose?.();
+		if (Array.isArray(material)) material.forEach(dispose);
+		else dispose(material);
+	});
+};
+/**
+* Owns the live three.js scene graph and keeps it in sync with a `Scene`
+* definition. `reconcile` diffs the incoming definition against what is already
+* mounted — by `id` — and only adds/removes/rebuilds what changed. This is what
+* makes hot scene edits cheap: add a wing or drop one while moving and only the
+* touched objects are rebuilt.
+*/
+var SceneManager = class {
+	root;
+	walls = /* @__PURE__ */ new Map();
+	artworks = /* @__PURE__ */ new Map();
+	constructor(root) {
+		this.root = root;
+	}
+	reconcile(scene) {
+		const wallById = new Map(scene.walls.map((w) => [w.id, w]));
+		this.reconcileWalls(scene.walls);
+		this.reconcileArtworks(scene.artworks, wallById);
+	}
+	reconcileWalls(walls) {
+		const next = new Set(walls.map((w) => w.id));
+		for (const [id, entry] of this.walls) if (!next.has(id)) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+			this.walls.delete(id);
+		}
+		for (const wall of walls) {
+			const hash = JSON.stringify(wall);
+			const existing = this.walls.get(wall.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.root.remove(existing.object);
+				disposeObject(existing.object);
+			}
+			const object = buildWall(wall);
+			this.root.add(object);
+			this.walls.set(wall.id, {
+				object,
+				hash
+			});
+		}
+	}
+	reconcileArtworks(artworks, wallById) {
+		const next = new Set(artworks.map((a) => a.id));
+		for (const [id, entry] of this.artworks) if (!next.has(id)) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+			this.artworks.delete(id);
+		}
+		for (const artwork of artworks) {
+			const wall = wallById.get(artwork.wall);
+			if (!wall) continue;
+			const hash = JSON.stringify({
+				a: artwork,
+				w: wall
+			});
+			const existing = this.artworks.get(artwork.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.root.remove(existing.object);
+				disposeObject(existing.object);
+			}
+			const object = buildArtwork(artwork, wall);
+			this.root.add(object);
+			this.artworks.set(artwork.id, {
+				object,
+				hash
+			});
+		}
+	}
+	/** Look up the live three.js object for a wall or artwork `id`. */
+	get(id) {
+		return this.walls.get(id)?.object ?? this.artworks.get(id)?.object;
+	}
+	dispose() {
+		for (const entry of [...this.walls.values(), ...this.artworks.values()]) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+		}
+		this.walls.clear();
+		this.artworks.clear();
+	}
+};
+//#endregion
+//#region src/createGallery.ts
+/**
+* Create and run a gallery from a scene definition. Sets up the three.js
+* renderer, camera, lights and free-roam controls, materializes the scene, and
+* starts the render loop. `setScene` later reconciles changes in place.
+*/
+function createGallery(scene, options) {
+	const { canvas } = options;
+	const width = canvas.clientWidth || window.innerWidth;
+	const height = canvas.clientHeight || window.innerHeight;
+	const renderer = new three.WebGLRenderer({
+		canvas,
+		antialias: options.antialias ?? true
+	});
+	renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
+	renderer.setSize(width, height, false);
+	const threeScene = new three.Scene();
+	const camera = new three.PerspectiveCamera(75, width / height, .1, 5e3);
+	const { position, yaw } = scene.camera.start;
+	camera.position.set(position[0], position[1], position[2]);
+	threeScene.add(new three.AmbientLight(16777215, 1.4));
+	threeScene.add(new three.HemisphereLight(16777215, 4473924, 1));
+	const manager = new SceneManager(threeScene);
+	manager.reconcile(scene);
+	const controls = new FreeRoamControls(camera, canvas, {
+		bounds: scene.camera.bounds,
+		position: camera.position.clone(),
+		yaw
+	});
+	controls.attach();
+	const listeners = /* @__PURE__ */ new Map();
+	const clock = new three.Clock();
+	let rafId = null;
+	const renderFrame = () => {
+		rafId = requestAnimationFrame(renderFrame);
+		controls.update(clock.getDelta());
+		renderer.render(threeScene, camera);
+	};
+	return {
+		ctx: {
+			entity: (id) => manager.get(id),
+			three: {
+				scene: threeScene,
+				camera,
+				renderer
+			}
+		},
+		setScene(next) {
+			manager.reconcile(next);
+			if (next.camera.bounds !== void 0) controls.bounds = next.camera.bounds;
+		},
+		start() {
+			if (rafId === null) {
+				clock.start();
+				renderFrame();
+			}
+		},
+		stop() {
+			if (rafId !== null) {
+				cancelAnimationFrame(rafId);
+				rafId = null;
+			}
+		},
+		dispose() {
+			this.stop();
+			controls.detach();
+			manager.dispose();
+			renderer.dispose();
+			listeners.clear();
+		},
+		on(event, handler) {
+			const set = listeners.get(event) ?? /* @__PURE__ */ new Set();
+			set.add(handler);
+			listeners.set(event, set);
+			return () => set.delete(handler);
+		},
+		emit(event, payload) {
+			listeners.get(event)?.forEach((handler) => handler(payload));
+		},
+		resize(w, h) {
+			camera.aspect = w / h;
+			camera.updateProjectionMatrix();
+			renderer.setSize(w, h, false);
+		}
+	};
+}
+//#endregion
+exports.FreeRoamControls = FreeRoamControls;
+exports.SceneManager = SceneManager;
+exports.buildArtwork = buildArtwork;
+exports.buildWall = buildWall;
+exports.createGallery = createGallery;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Vector3","Quaternion","Vector3","Vector2","Quaternion","Vector3","Quaternion","Vector3","Mesh","PlaneGeometry","MeshStandardMaterial","DoubleSide","TextureLoader","Group","Quaternion","Vector3","Mesh","PlaneGeometry","MeshStandardMaterial","SRGBColorSpace","MeshBasicMaterial","WebGLRenderer","ThreeScene","PerspectiveCamera","AmbientLight","HemisphereLight","Clock"],"sources":["../src/controls/boundaries.ts","../src/controls/headBob.ts","../src/controls/keyboard.ts","../src/controls/mouse.ts","../src/controls/FreeRoamControls.ts","../src/builders/wall.ts","../src/builders/artwork.ts","../src/SceneManager.ts","../src/createGallery.ts"],"sourcesContent":["import { Vector3 } from \"three\";\n\n/**\n * Clamp a step on the XZ plane to a square `[-bound, bound]`. Axes are clamped\n * independently so sliding along a wall still works when one axis is blocked.\n */\nexport const clampToBounds = (current: Vector3, step: Vector3, bound: number): Vector3 => {\n  const next = new Vector3().addVectors(current, step);\n  if (next.x < -bound || next.x > bound) next.x = current.x;\n  if (next.z < -bound || next.z > bound) next.z = current.z;\n  return next;\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\nexport const onKeyDown = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = true;\n};\n\nexport const onKeyUp = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = false;\n};\n\n/**\n * Compute the per-frame translation from WASD input, oriented by the current\n * yaw (`phi`). Holding Shift acts as a speed booster.\n */\nexport const movementFromKeyboard = (state: KeyboardState, phi: number, delta: number): Vector3 => {\n  const has = (code: string): number => (state[code] ? 1 : 0);\n  const forwardVelocity = has(\"KeyW\") - has(\"KeyS\");\n  const strafeVelocity = has(\"KeyA\") - has(\"KeyD\");\n  const boosted = state[\"ShiftLeft\"] || state[\"ShiftRight\"];\n  const factor = boosted ? 30 : 10;\n\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","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\nconst clamp = (x: number, a: number, b: number): number => Math.min(Math.max(x, a), b);\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 a look quaternion. Mutates `look` and\n * returns the resulting rotation. Yaw is unbounded; pitch is clamped to avoid\n * flipping over.\n */\nexport const updateLookFromMouse = (mouse: MouseState, look: LookState): Quaternion => {\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, -Math.PI / 3, Math.PI / 3);\n\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","import { Quaternion, Vector3, type PerspectiveCamera } from \"three\";\n\nimport { clampToBounds } from \"./boundaries\";\nimport { createHeadBobState, headBobOffset, updateHeadBob } from \"./headBob\";\nimport { createKeyboardState, movementFromKeyboard, onKeyDown, onKeyUp } from \"./keyboard\";\nimport {\n  commitMouseFrame,\n  createMouseState,\n  onMouseDown,\n  onMouseMove,\n  onMouseUp,\n  updateLookFromMouse,\n  type LookState,\n} from \"./mouse\";\n\nexport interface FreeRoamOptions {\n  /** Square half-extent that clamps XZ movement. */\n  bounds?: number;\n  /** Starting position. */\n  position?: Vector3;\n  /** Starting yaw in radians. */\n  yaw?: number;\n}\n\n/**\n * First-person, free-roaming camera controls ported from the original Virtual\n * Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while\n * moving, and square boundary clamping. The cardboard / device-orientation path\n * was intentionally dropped.\n *\n * Framework-agnostic: construct it with a camera and the canvas element, call\n * `attach()`, then `update(delta)` once per frame.\n */\nexport class FreeRoamControls {\n  bounds: number;\n\n  private readonly camera: PerspectiveCamera;\n  private readonly domElement: HTMLElement;\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\n  private readonly handlers: Array<[EventTarget, string, EventListener]> = [];\n\n  constructor(camera: PerspectiveCamera, domElement: HTMLElement, options: FreeRoamOptions = {}) {\n    this.camera = camera;\n    this.domElement = domElement;\n    this.bounds = options.bounds ?? 450;\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  }\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  /** Advance the camera by `delta` seconds of input. */\n  update(delta: number): void {\n    if (this.mouse.dragging) this.rotation = updateLookFromMouse(this.mouse, this.look);\n\n    const step = movementFromKeyboard(this.keyboard, this.look.phi, delta);\n    this.translation = clampToBounds(this.translation, step, this.bounds);\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 { DoubleSide, Mesh, MeshStandardMaterial, PlaneGeometry, type Object3D } from \"three\";\nimport type { Wall } from \"@scenography/core\";\n\n/** Build the three.js object that materializes a `Wall` definition. */\nexport function buildWall(wall: Wall): Object3D {\n  const [width, height] = wall.size;\n  const geometry = new PlaneGeometry(width, height);\n  const material = new MeshStandardMaterial({ color: wall.color ?? \"#ffffff\", side: DoubleSide });\n\n  const mesh = new Mesh(geometry, material);\n  mesh.position.set(wall.position[0], wall.position[1], wall.position[2]);\n  mesh.rotation.y = wall.rotation ?? 0;\n  mesh.name = `wall:${wall.id}`;\n  mesh.userData.scenographyId = wall.id;\n  return mesh;\n}\n","import {\n  Group,\n  Mesh,\n  MeshBasicMaterial,\n  MeshStandardMaterial,\n  PlaneGeometry,\n  Quaternion,\n  SRGBColorSpace,\n  TextureLoader,\n  Vector3,\n  type Object3D,\n} from \"three\";\nimport type { Artwork, Wall } from \"@scenography/core\";\n\nconst loader = new TextureLoader();\nconst FRAME_MARGIN = 4;\nconst SURFACE_OFFSET = 1;\n\n/**\n * Build the three.js object for an `Artwork`, placing it on its wall. The piece\n * is positioned in the wall's local plane via `offset` and nudged forward along\n * the wall normal so it sits in front of the surface.\n */\nexport function buildArtwork(artwork: Artwork, wall: Wall): Object3D {\n  const [width, height] = artwork.size;\n  const [offsetX, offsetY] = artwork.offset ?? [0, 0];\n  const yaw = wall.rotation ?? 0;\n\n  const group = new Group();\n  const wallQuat = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), yaw);\n  const right = new Vector3(1, 0, 0).applyQuaternion(wallQuat);\n  const normal = new Vector3(0, 0, 1).applyQuaternion(wallQuat);\n\n  const position = new Vector3(wall.position[0], wall.position[1], wall.position[2])\n    .add(right.clone().multiplyScalar(offsetX))\n    .add(new Vector3(0, offsetY, 0))\n    .add(normal.clone().multiplyScalar(SURFACE_OFFSET));\n  group.position.copy(position);\n  group.rotation.y = yaw;\n\n  // Frame: a slightly larger dark plane behind the image.\n  const frame = new Mesh(\n    new PlaneGeometry(width + FRAME_MARGIN, height + FRAME_MARGIN),\n    new MeshStandardMaterial({ color: \"#1a1a1a\" }),\n  );\n  group.add(frame);\n\n  // Image: textured plane, nudged forward so it reads above the frame.\n  const texture = loader.load(artwork.src);\n  texture.colorSpace = SRGBColorSpace;\n  const image = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));\n  image.position.z = 0.1;\n  group.add(image);\n\n  group.name = `artwork:${artwork.id}`;\n  group.userData.scenographyId = artwork.id;\n  group.userData.wallId = artwork.wall;\n  return group;\n}\n","import type { Object3D, Scene as ThreeScene } from \"three\";\nimport type { Artwork, Scene, Wall } from \"@scenography/core\";\n\nimport { buildArtwork, buildWall } from \"./builders\";\n\ninterface Entry {\n  object: Object3D;\n  /** JSON snapshot used to detect changes between reconciles. */\n  hash: string;\n}\n\nconst disposeObject = (object: Object3D): void => {\n  object.traverse((child) => {\n    const mesh = child as { geometry?: { dispose?: () => void }; material?: unknown };\n    mesh.geometry?.dispose?.();\n    const material = mesh.material;\n    const dispose = (m: unknown): void => (m as { dispose?: () => void })?.dispose?.();\n    if (Array.isArray(material)) material.forEach(dispose);\n    else dispose(material);\n  });\n};\n\n/**\n * Owns the live three.js scene graph and keeps it in sync with a `Scene`\n * definition. `reconcile` diffs the incoming definition against what is already\n * mounted — by `id` — and only adds/removes/rebuilds what changed. This is what\n * makes hot scene edits cheap: add a wing or drop one while moving and only the\n * touched objects are rebuilt.\n */\nexport class SceneManager {\n  private readonly root: ThreeScene;\n  private readonly walls = new Map<string, Entry>();\n  private readonly artworks = new Map<string, Entry>();\n\n  constructor(root: ThreeScene) {\n    this.root = root;\n  }\n\n  reconcile(scene: Scene): void {\n    const wallById = new Map(scene.walls.map((w) => [w.id, w] as const));\n    this.reconcileWalls(scene.walls);\n    this.reconcileArtworks(scene.artworks, wallById);\n  }\n\n  private reconcileWalls(walls: Wall[]): void {\n    const next = new Set(walls.map((w) => w.id));\n    for (const [id, entry] of this.walls) {\n      if (!next.has(id)) {\n        this.root.remove(entry.object);\n        disposeObject(entry.object);\n        this.walls.delete(id);\n      }\n    }\n    for (const wall of walls) {\n      const hash = JSON.stringify(wall);\n      const existing = this.walls.get(wall.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.root.remove(existing.object);\n        disposeObject(existing.object);\n      }\n      const object = buildWall(wall);\n      this.root.add(object);\n      this.walls.set(wall.id, { object, hash });\n    }\n  }\n\n  private reconcileArtworks(artworks: Artwork[], wallById: Map<string, Wall>): void {\n    const next = new Set(artworks.map((a) => a.id));\n    for (const [id, entry] of this.artworks) {\n      if (!next.has(id)) {\n        this.root.remove(entry.object);\n        disposeObject(entry.object);\n        this.artworks.delete(id);\n      }\n    }\n    for (const artwork of artworks) {\n      const wall = wallById.get(artwork.wall);\n      if (!wall) continue;\n      // Rebuild when either the artwork or the wall it hangs on changed.\n      const hash = JSON.stringify({ a: artwork, w: wall });\n      const existing = this.artworks.get(artwork.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.root.remove(existing.object);\n        disposeObject(existing.object);\n      }\n      const object = buildArtwork(artwork, wall);\n      this.root.add(object);\n      this.artworks.set(artwork.id, { object, hash });\n    }\n  }\n\n  /** Look up the live three.js object for a wall or artwork `id`. */\n  get(id: string): Object3D | undefined {\n    return this.walls.get(id)?.object ?? this.artworks.get(id)?.object;\n  }\n\n  dispose(): void {\n    for (const entry of [...this.walls.values(), ...this.artworks.values()]) {\n      this.root.remove(entry.object);\n      disposeObject(entry.object);\n    }\n    this.walls.clear();\n    this.artworks.clear();\n  }\n}\n","import {\n  AmbientLight,\n  Clock,\n  HemisphereLight,\n  PerspectiveCamera,\n  Scene as ThreeScene,\n  WebGLRenderer,\n  type Object3D,\n} from \"three\";\nimport type { Scene } from \"@scenography/core\";\n\nimport { FreeRoamControls } from \"./controls\";\nimport { SceneManager } from \"./SceneManager\";\n\nexport interface GalleryOptions {\n  /** Canvas the gallery renders into. */\n  canvas: HTMLCanvasElement;\n  /** Background color. Defaults to a soft gray. */\n  background?: string;\n  antialias?: boolean;\n}\n\n/**\n * High-level API handed to behavior code. Deliberately NOT raw three.js: this is\n * the supported surface. Reach into `three` only as a documented escape hatch.\n */\nexport interface GalleryContext {\n  /** Resolve the live object for a wall/artwork `id`. */\n  entity(id: string): Object3D | undefined;\n  /** Escape hatch to the underlying three.js objects for advanced use. */\n  readonly three: {\n    scene: ThreeScene;\n    camera: PerspectiveCamera;\n    renderer: WebGLRenderer;\n  };\n}\n\nexport interface Gallery {\n  /** Apply a new scene definition, reconciling only what changed (hot-swap). */\n  setScene(scene: Scene): void;\n  /** Start the render loop. */\n  start(): void;\n  /** Stop the render loop. */\n  stop(): void;\n  /** Tear everything down and release GPU resources. */\n  dispose(): void;\n  /** Subscribe to a named event; returns an unsubscribe function. */\n  on(event: string, handler: (payload?: unknown) => void): () => void;\n  /** Emit a named event to subscribers. */\n  emit(event: string, payload?: unknown): void;\n  /** Resize the renderer/camera to the given pixel size. */\n  resize(width: number, height: number): void;\n  readonly ctx: GalleryContext;\n}\n\n/**\n * Create and run a gallery from a scene definition. Sets up the three.js\n * renderer, camera, lights and free-roam controls, materializes the scene, and\n * starts the render loop. `setScene` later reconciles changes in place.\n */\nexport function createGallery(scene: Scene, options: GalleryOptions): Gallery {\n  const { canvas } = options;\n  const width = canvas.clientWidth || window.innerWidth;\n  const height = canvas.clientHeight || window.innerHeight;\n\n  const renderer = new WebGLRenderer({ canvas, antialias: options.antialias ?? true });\n  renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n  renderer.setSize(width, height, false);\n\n  const threeScene = new ThreeScene();\n\n  const camera = new PerspectiveCamera(75, width / height, 0.1, 5000);\n  const { position, yaw } = scene.camera.start;\n  camera.position.set(position[0], position[1], position[2]);\n\n  threeScene.add(new AmbientLight(0xffffff, 1.4));\n  threeScene.add(new HemisphereLight(0xffffff, 0x444444, 1));\n\n  const manager = new SceneManager(threeScene);\n  manager.reconcile(scene);\n\n  const controls = new FreeRoamControls(camera, canvas, {\n    bounds: scene.camera.bounds,\n    position: camera.position.clone(),\n    yaw,\n  });\n  controls.attach();\n\n  const listeners = new Map<string, Set<(payload?: unknown) => void>>();\n  const clock = new Clock();\n  let rafId: number | null = null;\n\n  const renderFrame = (): void => {\n    rafId = requestAnimationFrame(renderFrame);\n    controls.update(clock.getDelta());\n    renderer.render(threeScene, camera);\n  };\n\n  const ctx: GalleryContext = {\n    entity: (id) => manager.get(id),\n    three: { scene: threeScene, camera, renderer },\n  };\n\n  return {\n    ctx,\n    setScene(next) {\n      manager.reconcile(next);\n      if (next.camera.bounds !== undefined) controls.bounds = next.camera.bounds;\n    },\n    start() {\n      if (rafId === null) {\n        clock.start();\n        renderFrame();\n      }\n    },\n    stop() {\n      if (rafId !== null) {\n        cancelAnimationFrame(rafId);\n        rafId = null;\n      }\n    },\n    dispose() {\n      this.stop();\n      controls.detach();\n      manager.dispose();\n      renderer.dispose();\n      listeners.clear();\n    },\n    on(event, handler) {\n      const set = listeners.get(event) ?? new Set();\n      set.add(handler);\n      listeners.set(event, set);\n      return () => set.delete(handler);\n    },\n    emit(event, payload) {\n      listeners.get(event)?.forEach((handler) => handler(payload));\n    },\n    resize(w, h) {\n      camera.aspect = w / h;\n      camera.updateProjectionMatrix();\n      renderer.setSize(w, h, false);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,120 @@
+import { Object3D, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from "three";
+import { Artwork, Scene as Scene$1, Wall } from "@scenography/core";
+
+//#region src/createGallery.d.ts
+interface GalleryOptions {
+  /** Canvas the gallery renders into. */
+  canvas: HTMLCanvasElement;
+  /** Background color. Defaults to a soft gray. */
+  background?: string;
+  antialias?: boolean;
+}
+/**
+ * High-level API handed to behavior code. Deliberately NOT raw three.js: this is
+ * the supported surface. Reach into `three` only as a documented escape hatch.
+ */
+interface GalleryContext {
+  /** Resolve the live object for a wall/artwork `id`. */
+  entity(id: string): Object3D | undefined;
+  /** Escape hatch to the underlying three.js objects for advanced use. */
+  readonly three: {
+    scene: Scene;
+    camera: PerspectiveCamera;
+    renderer: WebGLRenderer;
+  };
+}
+interface Gallery {
+  /** Apply a new scene definition, reconciling only what changed (hot-swap). */
+  setScene(scene: Scene$1): void;
+  /** Start the render loop. */
+  start(): void;
+  /** Stop the render loop. */
+  stop(): void;
+  /** Tear everything down and release GPU resources. */
+  dispose(): void;
+  /** Subscribe to a named event; returns an unsubscribe function. */
+  on(event: string, handler: (payload?: unknown) => void): () => void;
+  /** Emit a named event to subscribers. */
+  emit(event: string, payload?: unknown): void;
+  /** Resize the renderer/camera to the given pixel size. */
+  resize(width: number, height: number): void;
+  readonly ctx: GalleryContext;
+}
+/**
+ * Create and run a gallery from a scene definition. Sets up the three.js
+ * renderer, camera, lights and free-roam controls, materializes the scene, and
+ * starts the render loop. `setScene` later reconciles changes in place.
+ */
+declare function createGallery(scene: Scene$1, options: GalleryOptions): Gallery;
+//#endregion
+//#region src/SceneManager.d.ts
+/**
+ * Owns the live three.js scene graph and keeps it in sync with a `Scene`
+ * definition. `reconcile` diffs the incoming definition against what is already
+ * mounted — by `id` — and only adds/removes/rebuilds what changed. This is what
+ * makes hot scene edits cheap: add a wing or drop one while moving and only the
+ * touched objects are rebuilt.
+ */
+declare class SceneManager {
+  private readonly root;
+  private readonly walls;
+  private readonly artworks;
+  constructor(root: Scene);
+  reconcile(scene: Scene$1): void;
+  private reconcileWalls;
+  private reconcileArtworks;
+  /** Look up the live three.js object for a wall or artwork `id`. */
+  get(id: string): Object3D | undefined;
+  dispose(): void;
+}
+//#endregion
+//#region src/controls/FreeRoamControls.d.ts
+interface FreeRoamOptions {
+  /** Square half-extent that clamps XZ movement. */
+  bounds?: number;
+  /** Starting position. */
+  position?: Vector3;
+  /** Starting yaw in radians. */
+  yaw?: number;
+}
+/**
+ * First-person, free-roaming camera controls ported from the original Virtual
+ * Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while
+ * moving, and square boundary clamping. The cardboard / device-orientation path
+ * was intentionally dropped.
+ *
+ * Framework-agnostic: construct it with a camera and the canvas element, call
+ * `attach()`, then `update(delta)` once per frame.
+ */
+declare class FreeRoamControls {
+  bounds: number;
+  private readonly camera;
+  private readonly domElement;
+  private readonly mouse;
+  private readonly keyboard;
+  private readonly headBob;
+  private readonly look;
+  private rotation;
+  private translation;
+  private readonly handlers;
+  constructor(camera: PerspectiveCamera, domElement: HTMLElement, options?: FreeRoamOptions);
+  attach(): void;
+  detach(): void;
+  /** Advance the camera by `delta` seconds of input. */
+  update(delta: number): void;
+}
+//#endregion
+//#region src/builders/wall.d.ts
+/** Build the three.js object that materializes a `Wall` definition. */
+declare function buildWall(wall: Wall): Object3D;
+//#endregion
+//#region src/builders/artwork.d.ts
+/**
+ * Build the three.js object for an `Artwork`, placing it on its wall. The piece
+ * is positioned in the wall's local plane via `offset` and nudged forward along
+ * the wall normal so it sits in front of the surface.
+ */
+declare function buildArtwork(artwork: Artwork, wall: Wall): Object3D;
+//#endregion
+export { FreeRoamControls, type FreeRoamOptions, type Gallery, type GalleryContext, type GalleryOptions, SceneManager, buildArtwork, buildWall, createGallery };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,120 @@
+import { Object3D, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from "three";
+import { Artwork, Scene as Scene$1, Wall } from "@scenography/core";
+
+//#region src/createGallery.d.ts
+interface GalleryOptions {
+  /** Canvas the gallery renders into. */
+  canvas: HTMLCanvasElement;
+  /** Background color. Defaults to a soft gray. */
+  background?: string;
+  antialias?: boolean;
+}
+/**
+ * High-level API handed to behavior code. Deliberately NOT raw three.js: this is
+ * the supported surface. Reach into `three` only as a documented escape hatch.
+ */
+interface GalleryContext {
+  /** Resolve the live object for a wall/artwork `id`. */
+  entity(id: string): Object3D | undefined;
+  /** Escape hatch to the underlying three.js objects for advanced use. */
+  readonly three: {
+    scene: Scene;
+    camera: PerspectiveCamera;
+    renderer: WebGLRenderer;
+  };
+}
+interface Gallery {
+  /** Apply a new scene definition, reconciling only what changed (hot-swap). */
+  setScene(scene: Scene$1): void;
+  /** Start the render loop. */
+  start(): void;
+  /** Stop the render loop. */
+  stop(): void;
+  /** Tear everything down and release GPU resources. */
+  dispose(): void;
+  /** Subscribe to a named event; returns an unsubscribe function. */
+  on(event: string, handler: (payload?: unknown) => void): () => void;
+  /** Emit a named event to subscribers. */
+  emit(event: string, payload?: unknown): void;
+  /** Resize the renderer/camera to the given pixel size. */
+  resize(width: number, height: number): void;
+  readonly ctx: GalleryContext;
+}
+/**
+ * Create and run a gallery from a scene definition. Sets up the three.js
+ * renderer, camera, lights and free-roam controls, materializes the scene, and
+ * starts the render loop. `setScene` later reconciles changes in place.
+ */
+declare function createGallery(scene: Scene$1, options: GalleryOptions): Gallery;
+//#endregion
+//#region src/SceneManager.d.ts
+/**
+ * Owns the live three.js scene graph and keeps it in sync with a `Scene`
+ * definition. `reconcile` diffs the incoming definition against what is already
+ * mounted — by `id` — and only adds/removes/rebuilds what changed. This is what
+ * makes hot scene edits cheap: add a wing or drop one while moving and only the
+ * touched objects are rebuilt.
+ */
+declare class SceneManager {
+  private readonly root;
+  private readonly walls;
+  private readonly artworks;
+  constructor(root: Scene);
+  reconcile(scene: Scene$1): void;
+  private reconcileWalls;
+  private reconcileArtworks;
+  /** Look up the live three.js object for a wall or artwork `id`. */
+  get(id: string): Object3D | undefined;
+  dispose(): void;
+}
+//#endregion
+//#region src/controls/FreeRoamControls.d.ts
+interface FreeRoamOptions {
+  /** Square half-extent that clamps XZ movement. */
+  bounds?: number;
+  /** Starting position. */
+  position?: Vector3;
+  /** Starting yaw in radians. */
+  yaw?: number;
+}
+/**
+ * First-person, free-roaming camera controls ported from the original Virtual
+ * Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while
+ * moving, and square boundary clamping. The cardboard / device-orientation path
+ * was intentionally dropped.
+ *
+ * Framework-agnostic: construct it with a camera and the canvas element, call
+ * `attach()`, then `update(delta)` once per frame.
+ */
+declare class FreeRoamControls {
+  bounds: number;
+  private readonly camera;
+  private readonly domElement;
+  private readonly mouse;
+  private readonly keyboard;
+  private readonly headBob;
+  private readonly look;
+  private rotation;
+  private translation;
+  private readonly handlers;
+  constructor(camera: PerspectiveCamera, domElement: HTMLElement, options?: FreeRoamOptions);
+  attach(): void;
+  detach(): void;
+  /** Advance the camera by `delta` seconds of input. */
+  update(delta: number): void;
+}
+//#endregion
+//#region src/builders/wall.d.ts
+/** Build the three.js object that materializes a `Wall` definition. */
+declare function buildWall(wall: Wall): Object3D;
+//#endregion
+//#region src/builders/artwork.d.ts
+/**
+ * Build the three.js object for an `Artwork`, placing it on its wall. The piece
+ * is positioned in the wall's local plane via `offset` and nudged forward along
+ * the wall normal so it sits in front of the surface.
+ */
+declare function buildArtwork(artwork: Artwork, wall: Wall): Object3D;
+//#endregion
+export { FreeRoamControls, type FreeRoamOptions, type Gallery, type GalleryContext, type GalleryOptions, SceneManager, buildArtwork, buildWall, createGallery };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,394 @@
+import { AmbientLight, Clock, DoubleSide, Group, HemisphereLight, Mesh, MeshBasicMaterial, MeshStandardMaterial, PerspectiveCamera, PlaneGeometry, Quaternion, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
+//#region src/controls/boundaries.ts
+/**
+* Clamp a step on the XZ plane to a square `[-bound, bound]`. Axes are clamped
+* independently so sliding along a wall still works when one axis is blocked.
+*/
+const clampToBounds = (current, step, bound) => {
+	const next = new Vector3().addVectors(current, step);
+	if (next.x < -bound || next.x > bound) next.x = current.x;
+	if (next.z < -bound || next.z > bound) next.z = current.z;
+	return next;
+};
+//#endregion
+//#region src/controls/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/controls/keyboard.ts
+const createKeyboardState = () => ({});
+const onKeyDown = (state, event) => {
+	state[event.code] = true;
+};
+const onKeyUp = (state, event) => {
+	state[event.code] = false;
+};
+/**
+* Compute the per-frame translation from WASD input, oriented by the current
+* yaw (`phi`). Holding Shift acts as a speed booster.
+*/
+const movementFromKeyboard = (state, phi, delta) => {
+	const has = (code) => state[code] ? 1 : 0;
+	const forwardVelocity = has("KeyW") - has("KeyS");
+	const strafeVelocity = has("KeyA") - has("KeyD");
+	const factor = state["ShiftLeft"] || state["ShiftRight"] ? 30 : 10;
+	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);
+};
+//#endregion
+//#region src/controls/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);
+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 a look quaternion. Mutates `look` and
+* returns the resulting rotation. 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, -Math.PI / 3, Math.PI / 3);
+	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);
+};
+//#endregion
+//#region src/controls/FreeRoamControls.ts
+/**
+* First-person, free-roaming camera controls ported from the original Virtual
+* Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while
+* moving, and square boundary clamping. The cardboard / device-orientation path
+* was intentionally dropped.
+*
+* Framework-agnostic: construct it with a camera and the canvas element, call
+* `attach()`, then `update(delta)` once per frame.
+*/
+var FreeRoamControls = class {
+	bounds;
+	camera;
+	domElement;
+	mouse = createMouseState();
+	keyboard = createKeyboardState();
+	headBob = createHeadBobState();
+	look = {
+		phi: 0,
+		theta: 0
+	};
+	rotation = new Quaternion();
+	translation = new Vector3(0, 170, 0);
+	handlers = [];
+	constructor(camera, domElement, options = {}) {
+		this.camera = camera;
+		this.domElement = domElement;
+		this.bounds = options.bounds ?? 450;
+		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);
+	}
+	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;
+	}
+	/** Advance the camera by `delta` seconds of input. */
+	update(delta) {
+		if (this.mouse.dragging) this.rotation = updateLookFromMouse(this.mouse, this.look);
+		const step = movementFromKeyboard(this.keyboard, this.look.phi, delta);
+		this.translation = clampToBounds(this.translation, step, this.bounds);
+		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/builders/wall.ts
+/** Build the three.js object that materializes a `Wall` definition. */
+function buildWall(wall) {
+	const [width, height] = wall.size;
+	const mesh = new Mesh(new PlaneGeometry(width, height), new MeshStandardMaterial({
+		color: wall.color ?? "#ffffff",
+		side: DoubleSide
+	}));
+	mesh.position.set(wall.position[0], wall.position[1], wall.position[2]);
+	mesh.rotation.y = wall.rotation ?? 0;
+	mesh.name = `wall:${wall.id}`;
+	mesh.userData.scenographyId = wall.id;
+	return mesh;
+}
+//#endregion
+//#region src/builders/artwork.ts
+const loader = new TextureLoader();
+const FRAME_MARGIN = 4;
+const SURFACE_OFFSET = 1;
+/**
+* Build the three.js object for an `Artwork`, placing it on its wall. The piece
+* is positioned in the wall's local plane via `offset` and nudged forward along
+* the wall normal so it sits in front of the surface.
+*/
+function buildArtwork(artwork, wall) {
+	const [width, height] = artwork.size;
+	const [offsetX, offsetY] = artwork.offset ?? [0, 0];
+	const yaw = wall.rotation ?? 0;
+	const group = new Group();
+	const wallQuat = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), yaw);
+	const right = new Vector3(1, 0, 0).applyQuaternion(wallQuat);
+	const normal = new Vector3(0, 0, 1).applyQuaternion(wallQuat);
+	const position = new Vector3(wall.position[0], wall.position[1], wall.position[2]).add(right.clone().multiplyScalar(offsetX)).add(new Vector3(0, offsetY, 0)).add(normal.clone().multiplyScalar(SURFACE_OFFSET));
+	group.position.copy(position);
+	group.rotation.y = yaw;
+	const frame = new Mesh(new PlaneGeometry(width + FRAME_MARGIN, height + FRAME_MARGIN), new MeshStandardMaterial({ color: "#1a1a1a" }));
+	group.add(frame);
+	const texture = loader.load(artwork.src);
+	texture.colorSpace = SRGBColorSpace;
+	const image = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));
+	image.position.z = .1;
+	group.add(image);
+	group.name = `artwork:${artwork.id}`;
+	group.userData.scenographyId = artwork.id;
+	group.userData.wallId = artwork.wall;
+	return group;
+}
+//#endregion
+//#region src/SceneManager.ts
+const disposeObject = (object) => {
+	object.traverse((child) => {
+		const mesh = child;
+		mesh.geometry?.dispose?.();
+		const material = mesh.material;
+		const dispose = (m) => m?.dispose?.();
+		if (Array.isArray(material)) material.forEach(dispose);
+		else dispose(material);
+	});
+};
+/**
+* Owns the live three.js scene graph and keeps it in sync with a `Scene`
+* definition. `reconcile` diffs the incoming definition against what is already
+* mounted — by `id` — and only adds/removes/rebuilds what changed. This is what
+* makes hot scene edits cheap: add a wing or drop one while moving and only the
+* touched objects are rebuilt.
+*/
+var SceneManager = class {
+	root;
+	walls = /* @__PURE__ */ new Map();
+	artworks = /* @__PURE__ */ new Map();
+	constructor(root) {
+		this.root = root;
+	}
+	reconcile(scene) {
+		const wallById = new Map(scene.walls.map((w) => [w.id, w]));
+		this.reconcileWalls(scene.walls);
+		this.reconcileArtworks(scene.artworks, wallById);
+	}
+	reconcileWalls(walls) {
+		const next = new Set(walls.map((w) => w.id));
+		for (const [id, entry] of this.walls) if (!next.has(id)) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+			this.walls.delete(id);
+		}
+		for (const wall of walls) {
+			const hash = JSON.stringify(wall);
+			const existing = this.walls.get(wall.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.root.remove(existing.object);
+				disposeObject(existing.object);
+			}
+			const object = buildWall(wall);
+			this.root.add(object);
+			this.walls.set(wall.id, {
+				object,
+				hash
+			});
+		}
+	}
+	reconcileArtworks(artworks, wallById) {
+		const next = new Set(artworks.map((a) => a.id));
+		for (const [id, entry] of this.artworks) if (!next.has(id)) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+			this.artworks.delete(id);
+		}
+		for (const artwork of artworks) {
+			const wall = wallById.get(artwork.wall);
+			if (!wall) continue;
+			const hash = JSON.stringify({
+				a: artwork,
+				w: wall
+			});
+			const existing = this.artworks.get(artwork.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.root.remove(existing.object);
+				disposeObject(existing.object);
+			}
+			const object = buildArtwork(artwork, wall);
+			this.root.add(object);
+			this.artworks.set(artwork.id, {
+				object,
+				hash
+			});
+		}
+	}
+	/** Look up the live three.js object for a wall or artwork `id`. */
+	get(id) {
+		return this.walls.get(id)?.object ?? this.artworks.get(id)?.object;
+	}
+	dispose() {
+		for (const entry of [...this.walls.values(), ...this.artworks.values()]) {
+			this.root.remove(entry.object);
+			disposeObject(entry.object);
+		}
+		this.walls.clear();
+		this.artworks.clear();
+	}
+};
+//#endregion
+//#region src/createGallery.ts
+/**
+* Create and run a gallery from a scene definition. Sets up the three.js
+* renderer, camera, lights and free-roam controls, materializes the scene, and
+* starts the render loop. `setScene` later reconciles changes in place.
+*/
+function createGallery(scene, options) {
+	const { canvas } = options;
+	const width = canvas.clientWidth || window.innerWidth;
+	const height = canvas.clientHeight || window.innerHeight;
+	const renderer = new WebGLRenderer({
+		canvas,
+		antialias: options.antialias ?? true
+	});
+	renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
+	renderer.setSize(width, height, false);
+	const threeScene = new Scene();
+	const camera = new PerspectiveCamera(75, width / height, .1, 5e3);
+	const { position, yaw } = scene.camera.start;
+	camera.position.set(position[0], position[1], position[2]);
+	threeScene.add(new AmbientLight(16777215, 1.4));
+	threeScene.add(new HemisphereLight(16777215, 4473924, 1));
+	const manager = new SceneManager(threeScene);
+	manager.reconcile(scene);
+	const controls = new FreeRoamControls(camera, canvas, {
+		bounds: scene.camera.bounds,
+		position: camera.position.clone(),
+		yaw
+	});
+	controls.attach();
+	const listeners = /* @__PURE__ */ new Map();
+	const clock = new Clock();
+	let rafId = null;
+	const renderFrame = () => {
+		rafId = requestAnimationFrame(renderFrame);
+		controls.update(clock.getDelta());
+		renderer.render(threeScene, camera);
+	};
+	return {
+		ctx: {
+			entity: (id) => manager.get(id),
+			three: {
+				scene: threeScene,
+				camera,
+				renderer
+			}
+		},
+		setScene(next) {
+			manager.reconcile(next);
+			if (next.camera.bounds !== void 0) controls.bounds = next.camera.bounds;
+		},
+		start() {
+			if (rafId === null) {
+				clock.start();
+				renderFrame();
+			}
+		},
+		stop() {
+			if (rafId !== null) {
+				cancelAnimationFrame(rafId);
+				rafId = null;
+			}
+		},
+		dispose() {
+			this.stop();
+			controls.detach();
+			manager.dispose();
+			renderer.dispose();
+			listeners.clear();
+		},
+		on(event, handler) {
+			const set = listeners.get(event) ?? /* @__PURE__ */ new Set();
+			set.add(handler);
+			listeners.set(event, set);
+			return () => set.delete(handler);
+		},
+		emit(event, payload) {
+			listeners.get(event)?.forEach((handler) => handler(payload));
+		},
+		resize(w, h) {
+			camera.aspect = w / h;
+			camera.updateProjectionMatrix();
+			renderer.setSize(w, h, false);
+		}
+	};
+}
+//#endregion
+export { FreeRoamControls, SceneManager, buildArtwork, buildWall, createGallery };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["ThreeScene"],"sources":["../src/controls/boundaries.ts","../src/controls/headBob.ts","../src/controls/keyboard.ts","../src/controls/mouse.ts","../src/controls/FreeRoamControls.ts","../src/builders/wall.ts","../src/builders/artwork.ts","../src/SceneManager.ts","../src/createGallery.ts"],"sourcesContent":["import { Vector3 } from \"three\";\n\n/**\n * Clamp a step on the XZ plane to a square `[-bound, bound]`. Axes are clamped\n * independently so sliding along a wall still works when one axis is blocked.\n */\nexport const clampToBounds = (current: Vector3, step: Vector3, bound: number): Vector3 => {\n  const next = new Vector3().addVectors(current, step);\n  if (next.x < -bound || next.x > bound) next.x = current.x;\n  if (next.z < -bound || next.z > bound) next.z = current.z;\n  return next;\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\nexport const onKeyDown = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = true;\n};\n\nexport const onKeyUp = (state: KeyboardState, event: KeyboardEvent): void => {\n  state[event.code] = false;\n};\n\n/**\n * Compute the per-frame translation from WASD input, oriented by the current\n * yaw (`phi`). Holding Shift acts as a speed booster.\n */\nexport const movementFromKeyboard = (state: KeyboardState, phi: number, delta: number): Vector3 => {\n  const has = (code: string): number => (state[code] ? 1 : 0);\n  const forwardVelocity = has(\"KeyW\") - has(\"KeyS\");\n  const strafeVelocity = has(\"KeyA\") - has(\"KeyD\");\n  const boosted = state[\"ShiftLeft\"] || state[\"ShiftRight\"];\n  const factor = boosted ? 30 : 10;\n\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","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\nconst clamp = (x: number, a: number, b: number): number => Math.min(Math.max(x, a), b);\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 a look quaternion. Mutates `look` and\n * returns the resulting rotation. Yaw is unbounded; pitch is clamped to avoid\n * flipping over.\n */\nexport const updateLookFromMouse = (mouse: MouseState, look: LookState): Quaternion => {\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, -Math.PI / 3, Math.PI / 3);\n\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","import { Quaternion, Vector3, type PerspectiveCamera } from \"three\";\n\nimport { clampToBounds } from \"./boundaries\";\nimport { createHeadBobState, headBobOffset, updateHeadBob } from \"./headBob\";\nimport { createKeyboardState, movementFromKeyboard, onKeyDown, onKeyUp } from \"./keyboard\";\nimport {\n  commitMouseFrame,\n  createMouseState,\n  onMouseDown,\n  onMouseMove,\n  onMouseUp,\n  updateLookFromMouse,\n  type LookState,\n} from \"./mouse\";\n\nexport interface FreeRoamOptions {\n  /** Square half-extent that clamps XZ movement. */\n  bounds?: number;\n  /** Starting position. */\n  position?: Vector3;\n  /** Starting yaw in radians. */\n  yaw?: number;\n}\n\n/**\n * First-person, free-roaming camera controls ported from the original Virtual\n * Gallery: drag-to-look with the mouse, WASD to walk, a subtle head-bob while\n * moving, and square boundary clamping. The cardboard / device-orientation path\n * was intentionally dropped.\n *\n * Framework-agnostic: construct it with a camera and the canvas element, call\n * `attach()`, then `update(delta)` once per frame.\n */\nexport class FreeRoamControls {\n  bounds: number;\n\n  private readonly camera: PerspectiveCamera;\n  private readonly domElement: HTMLElement;\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\n  private readonly handlers: Array<[EventTarget, string, EventListener]> = [];\n\n  constructor(camera: PerspectiveCamera, domElement: HTMLElement, options: FreeRoamOptions = {}) {\n    this.camera = camera;\n    this.domElement = domElement;\n    this.bounds = options.bounds ?? 450;\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  }\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  /** Advance the camera by `delta` seconds of input. */\n  update(delta: number): void {\n    if (this.mouse.dragging) this.rotation = updateLookFromMouse(this.mouse, this.look);\n\n    const step = movementFromKeyboard(this.keyboard, this.look.phi, delta);\n    this.translation = clampToBounds(this.translation, step, this.bounds);\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 { DoubleSide, Mesh, MeshStandardMaterial, PlaneGeometry, type Object3D } from \"three\";\nimport type { Wall } from \"@scenography/core\";\n\n/** Build the three.js object that materializes a `Wall` definition. */\nexport function buildWall(wall: Wall): Object3D {\n  const [width, height] = wall.size;\n  const geometry = new PlaneGeometry(width, height);\n  const material = new MeshStandardMaterial({ color: wall.color ?? \"#ffffff\", side: DoubleSide });\n\n  const mesh = new Mesh(geometry, material);\n  mesh.position.set(wall.position[0], wall.position[1], wall.position[2]);\n  mesh.rotation.y = wall.rotation ?? 0;\n  mesh.name = `wall:${wall.id}`;\n  mesh.userData.scenographyId = wall.id;\n  return mesh;\n}\n","import {\n  Group,\n  Mesh,\n  MeshBasicMaterial,\n  MeshStandardMaterial,\n  PlaneGeometry,\n  Quaternion,\n  SRGBColorSpace,\n  TextureLoader,\n  Vector3,\n  type Object3D,\n} from \"three\";\nimport type { Artwork, Wall } from \"@scenography/core\";\n\nconst loader = new TextureLoader();\nconst FRAME_MARGIN = 4;\nconst SURFACE_OFFSET = 1;\n\n/**\n * Build the three.js object for an `Artwork`, placing it on its wall. The piece\n * is positioned in the wall's local plane via `offset` and nudged forward along\n * the wall normal so it sits in front of the surface.\n */\nexport function buildArtwork(artwork: Artwork, wall: Wall): Object3D {\n  const [width, height] = artwork.size;\n  const [offsetX, offsetY] = artwork.offset ?? [0, 0];\n  const yaw = wall.rotation ?? 0;\n\n  const group = new Group();\n  const wallQuat = new Quaternion().setFromAxisAngle(new Vector3(0, 1, 0), yaw);\n  const right = new Vector3(1, 0, 0).applyQuaternion(wallQuat);\n  const normal = new Vector3(0, 0, 1).applyQuaternion(wallQuat);\n\n  const position = new Vector3(wall.position[0], wall.position[1], wall.position[2])\n    .add(right.clone().multiplyScalar(offsetX))\n    .add(new Vector3(0, offsetY, 0))\n    .add(normal.clone().multiplyScalar(SURFACE_OFFSET));\n  group.position.copy(position);\n  group.rotation.y = yaw;\n\n  // Frame: a slightly larger dark plane behind the image.\n  const frame = new Mesh(\n    new PlaneGeometry(width + FRAME_MARGIN, height + FRAME_MARGIN),\n    new MeshStandardMaterial({ color: \"#1a1a1a\" }),\n  );\n  group.add(frame);\n\n  // Image: textured plane, nudged forward so it reads above the frame.\n  const texture = loader.load(artwork.src);\n  texture.colorSpace = SRGBColorSpace;\n  const image = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));\n  image.position.z = 0.1;\n  group.add(image);\n\n  group.name = `artwork:${artwork.id}`;\n  group.userData.scenographyId = artwork.id;\n  group.userData.wallId = artwork.wall;\n  return group;\n}\n","import type { Object3D, Scene as ThreeScene } from \"three\";\nimport type { Artwork, Scene, Wall } from \"@scenography/core\";\n\nimport { buildArtwork, buildWall } from \"./builders\";\n\ninterface Entry {\n  object: Object3D;\n  /** JSON snapshot used to detect changes between reconciles. */\n  hash: string;\n}\n\nconst disposeObject = (object: Object3D): void => {\n  object.traverse((child) => {\n    const mesh = child as { geometry?: { dispose?: () => void }; material?: unknown };\n    mesh.geometry?.dispose?.();\n    const material = mesh.material;\n    const dispose = (m: unknown): void => (m as { dispose?: () => void })?.dispose?.();\n    if (Array.isArray(material)) material.forEach(dispose);\n    else dispose(material);\n  });\n};\n\n/**\n * Owns the live three.js scene graph and keeps it in sync with a `Scene`\n * definition. `reconcile` diffs the incoming definition against what is already\n * mounted — by `id` — and only adds/removes/rebuilds what changed. This is what\n * makes hot scene edits cheap: add a wing or drop one while moving and only the\n * touched objects are rebuilt.\n */\nexport class SceneManager {\n  private readonly root: ThreeScene;\n  private readonly walls = new Map<string, Entry>();\n  private readonly artworks = new Map<string, Entry>();\n\n  constructor(root: ThreeScene) {\n    this.root = root;\n  }\n\n  reconcile(scene: Scene): void {\n    const wallById = new Map(scene.walls.map((w) => [w.id, w] as const));\n    this.reconcileWalls(scene.walls);\n    this.reconcileArtworks(scene.artworks, wallById);\n  }\n\n  private reconcileWalls(walls: Wall[]): void {\n    const next = new Set(walls.map((w) => w.id));\n    for (const [id, entry] of this.walls) {\n      if (!next.has(id)) {\n        this.root.remove(entry.object);\n        disposeObject(entry.object);\n        this.walls.delete(id);\n      }\n    }\n    for (const wall of walls) {\n      const hash = JSON.stringify(wall);\n      const existing = this.walls.get(wall.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.root.remove(existing.object);\n        disposeObject(existing.object);\n      }\n      const object = buildWall(wall);\n      this.root.add(object);\n      this.walls.set(wall.id, { object, hash });\n    }\n  }\n\n  private reconcileArtworks(artworks: Artwork[], wallById: Map<string, Wall>): void {\n    const next = new Set(artworks.map((a) => a.id));\n    for (const [id, entry] of this.artworks) {\n      if (!next.has(id)) {\n        this.root.remove(entry.object);\n        disposeObject(entry.object);\n        this.artworks.delete(id);\n      }\n    }\n    for (const artwork of artworks) {\n      const wall = wallById.get(artwork.wall);\n      if (!wall) continue;\n      // Rebuild when either the artwork or the wall it hangs on changed.\n      const hash = JSON.stringify({ a: artwork, w: wall });\n      const existing = this.artworks.get(artwork.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.root.remove(existing.object);\n        disposeObject(existing.object);\n      }\n      const object = buildArtwork(artwork, wall);\n      this.root.add(object);\n      this.artworks.set(artwork.id, { object, hash });\n    }\n  }\n\n  /** Look up the live three.js object for a wall or artwork `id`. */\n  get(id: string): Object3D | undefined {\n    return this.walls.get(id)?.object ?? this.artworks.get(id)?.object;\n  }\n\n  dispose(): void {\n    for (const entry of [...this.walls.values(), ...this.artworks.values()]) {\n      this.root.remove(entry.object);\n      disposeObject(entry.object);\n    }\n    this.walls.clear();\n    this.artworks.clear();\n  }\n}\n","import {\n  AmbientLight,\n  Clock,\n  HemisphereLight,\n  PerspectiveCamera,\n  Scene as ThreeScene,\n  WebGLRenderer,\n  type Object3D,\n} from \"three\";\nimport type { Scene } from \"@scenography/core\";\n\nimport { FreeRoamControls } from \"./controls\";\nimport { SceneManager } from \"./SceneManager\";\n\nexport interface GalleryOptions {\n  /** Canvas the gallery renders into. */\n  canvas: HTMLCanvasElement;\n  /** Background color. Defaults to a soft gray. */\n  background?: string;\n  antialias?: boolean;\n}\n\n/**\n * High-level API handed to behavior code. Deliberately NOT raw three.js: this is\n * the supported surface. Reach into `three` only as a documented escape hatch.\n */\nexport interface GalleryContext {\n  /** Resolve the live object for a wall/artwork `id`. */\n  entity(id: string): Object3D | undefined;\n  /** Escape hatch to the underlying three.js objects for advanced use. */\n  readonly three: {\n    scene: ThreeScene;\n    camera: PerspectiveCamera;\n    renderer: WebGLRenderer;\n  };\n}\n\nexport interface Gallery {\n  /** Apply a new scene definition, reconciling only what changed (hot-swap). */\n  setScene(scene: Scene): void;\n  /** Start the render loop. */\n  start(): void;\n  /** Stop the render loop. */\n  stop(): void;\n  /** Tear everything down and release GPU resources. */\n  dispose(): void;\n  /** Subscribe to a named event; returns an unsubscribe function. */\n  on(event: string, handler: (payload?: unknown) => void): () => void;\n  /** Emit a named event to subscribers. */\n  emit(event: string, payload?: unknown): void;\n  /** Resize the renderer/camera to the given pixel size. */\n  resize(width: number, height: number): void;\n  readonly ctx: GalleryContext;\n}\n\n/**\n * Create and run a gallery from a scene definition. Sets up the three.js\n * renderer, camera, lights and free-roam controls, materializes the scene, and\n * starts the render loop. `setScene` later reconciles changes in place.\n */\nexport function createGallery(scene: Scene, options: GalleryOptions): Gallery {\n  const { canvas } = options;\n  const width = canvas.clientWidth || window.innerWidth;\n  const height = canvas.clientHeight || window.innerHeight;\n\n  const renderer = new WebGLRenderer({ canvas, antialias: options.antialias ?? true });\n  renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n  renderer.setSize(width, height, false);\n\n  const threeScene = new ThreeScene();\n\n  const camera = new PerspectiveCamera(75, width / height, 0.1, 5000);\n  const { position, yaw } = scene.camera.start;\n  camera.position.set(position[0], position[1], position[2]);\n\n  threeScene.add(new AmbientLight(0xffffff, 1.4));\n  threeScene.add(new HemisphereLight(0xffffff, 0x444444, 1));\n\n  const manager = new SceneManager(threeScene);\n  manager.reconcile(scene);\n\n  const controls = new FreeRoamControls(camera, canvas, {\n    bounds: scene.camera.bounds,\n    position: camera.position.clone(),\n    yaw,\n  });\n  controls.attach();\n\n  const listeners = new Map<string, Set<(payload?: unknown) => void>>();\n  const clock = new Clock();\n  let rafId: number | null = null;\n\n  const renderFrame = (): void => {\n    rafId = requestAnimationFrame(renderFrame);\n    controls.update(clock.getDelta());\n    renderer.render(threeScene, camera);\n  };\n\n  const ctx: GalleryContext = {\n    entity: (id) => manager.get(id),\n    three: { scene: threeScene, camera, renderer },\n  };\n\n  return {\n    ctx,\n    setScene(next) {\n      manager.reconcile(next);\n      if (next.camera.bounds !== undefined) controls.bounds = next.camera.bounds;\n    },\n    start() {\n      if (rafId === null) {\n        clock.start();\n        renderFrame();\n      }\n    },\n    stop() {\n      if (rafId !== null) {\n        cancelAnimationFrame(rafId);\n        rafId = null;\n      }\n    },\n    dispose() {\n      this.stop();\n      controls.detach();\n      manager.dispose();\n      renderer.dispose();\n      listeners.clear();\n    },\n    on(event, handler) {\n      const set = listeners.get(event) ?? new Set();\n      set.add(handler);\n      listeners.set(event, set);\n      return () => set.delete(handler);\n    },\n    emit(event, payload) {\n      listeners.get(event)?.forEach((handler) => handler(payload));\n    },\n    resize(w, h) {\n      camera.aspect = w / h;\n      camera.updateProjectionMatrix();\n      renderer.setSize(w, h, false);\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@scenography/engine",
+  "version": "0.1.0",
+  "description": "The scenography runtime: materializes a scene definition with three.js and runs it. Reconciles by id for hot scene changes.",
+  "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/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.160.0",
+    "three": "^0.160.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}