castle-web-cli 0.4.1 → 0.4.3

package/kits/basic-2d/editors/SceneEditor.jsx

@@ -0,0 +1,1012 @@
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+import { basename, formatJson, parseJsonFile } from '../engine/files';
+import { TouchControls } from '../engine/TouchControls';
+import {
+  addActor,
+  configureSceneCanvas,
+  duplicateActors,
+  makeScene,
+  removeActorComponent,
+  removeActors,
+  screenToCard,
+  setActorComponent,
+} from '../engine/scene';
+import {
+  cx,
+  CheckboxField,
+  ColorField,
+  EditorBody,
+  EditorHeader,
+  Icon,
+  IconButton,
+  NumberField,
+  Panel,
+  SheetGrabHandle,
+  styles,
+  TextField,
+  useMobileSheet,
+} from '../engine/ui';
+import { AutoInspector } from '../engine/autoInspector';
+import { SceneUI } from '../engine/SceneUI';
+import { behaviorClasses, findBehaviorClass } from './behaviorRegistry';
+import { useEditHistory } from './editorHistory';
+const LONG_PRESS_MS = 500;
+const DRAG_THRESHOLD = 4;
+const DEFAULT_GRID_SIZE = 25;
+export function SceneEditor({
+  path,
+  text,
+  files,
+  drawings,
+  onChange,
+  onToggleFiles,
+  filesOpen,
+  selectedActorIds,
+  onSelectActorIds,
+  multiSelectMode,
+  onSetMultiSelectMode,
+}) {
+  const canvasRef = useRef(null);
+  const runtimeRef = useRef(null);
+  const marqueeRef = useRef(null);
+  const editCameraRef = useRef({ x: 0, y: 0 });
+  const selectedActorIdsRef = useRef(selectedActorIds);
+  selectedActorIdsRef.current = selectedActorIds;
+  const [isPlaying, setIsPlaying] = useState(false);
+  const [panMode, setPanMode] = useState(false);
+  const history = useEditHistory(text, onChange);
+  const showMulti = selectedActorIds.length > 1 || multiSelectMode;
+  const inspectorSheet = useSelectionInspectorSheet(true);
+  const { value: sceneData, error } = parseJsonFile(path, text);
+  const getRuntimeKeys = useCallback(() => runtimeRef.current?.keys ?? null, []);
+  const getRuntime = useCallback(() => runtimeRef.current, []);
+  useScenePlayLoop({
+    sceneData,
+    drawings,
+    isPlaying,
+    text,
+    canvasRef,
+    runtimeRef,
+    editCameraRef,
+    selectedActorIds,
+    marqueeRef,
+  });
+  const panGesture = usePanGesture({ canvasRef, editCameraRef, enabled: panMode && !isPlaying });
+  useScenePlayKeys(runtimeRef, setIsPlaying);
+  const gesture = useSelectionGesture({
+    canvasRef,
+    sceneData,
+    drawings,
+    isPlaying,
+    selectedActorIds,
+    onSelectActorIds,
+    multiSelectMode,
+    onSetMultiSelectMode,
+    marqueeRef,
+    editCameraRef,
+    applyScene: (next) => onChange(formatJson(next)),
+    recordSceneSnapshot: history.recordSnapshot,
+  });
+  const playPointer = usePlayPointerGesture({ canvasRef, runtimeRef });
+  useSelectionKeyboard({
+    sceneData,
+    selectedActorIds,
+    onSelectActorIds,
+    multiSelectMode,
+    onSetMultiSelectMode,
+    isPlaying,
+    commitScene: (next) => history.commit(formatJson(next)),
+  });
+  if (!sceneData) {
+    return (
+      <>
+        <EditorHeader title={basename(path)} onToggleFiles={onToggleFiles} filesOpen={filesOpen} />
+        <EditorBody>
+          <div className={styles.inspector}>{error}</div>
+        </EditorBody>
+      </>
+    );
+  }
+  const selectedActor =
+    selectedActorIds.length === 1
+      ? sceneData.actors.find((actor) => actor.id === selectedActorIds[0])
+      : undefined;
+  const actions = makeSceneActions({
+    sceneData,
+    commit: history.commit,
+    selectedActorIds,
+    onSelectActorIds,
+  });
+  const snapSettings = getSnapSettings(sceneData);
+  const updateSceneSettings = (nextScene) => {
+    history.commit(formatJson(setSceneSettings(sceneData, nextScene)));
+  };
+  const updateSceneEditorSettings = (nextEditor) => {
+    history.commit(formatJson(setSceneEditorSettings(sceneData, nextEditor)));
+  };
+  const inspectorLabel = showMulti ? 'Multi-select' : selectedActor ? 'Inspector' : 'Scene';
+  const inspectorHint = showMulti
+    ? `${selectedActorIds.length} actor${selectedActorIds.length === 1 ? '' : 's'} selected`
+    : selectedActor
+      ? `actor ${selectedActor.id}`
+      : 'scene settings';
+  const playbackButtons = (
+    <PlaybackButtons
+      isPlaying={isPlaying}
+      setIsPlaying={setIsPlaying}
+      history={history}
+      panMode={panMode}
+      setPanMode={setPanMode}
+    />
+  );
+  const actorButtons = (
+    <ActorToolButtons
+      sceneData={sceneData}
+      files={files}
+      drawings={drawings}
+      selectedActorIds={selectedActorIds}
+      onSelectActorIds={onSelectActorIds}
+      isPlaying={isPlaying}
+      onChange={onChange}
+      history={history}
+    />
+  );
+  return (
+    <>
+      <EditorHeader
+        title={sceneData.name ?? basename(path)}
+        subtitle={isPlaying ? 'WASD / arrows' : `${sceneData.actors.length} actors`}
+        right={
+          <span className={styles.mobileOnly}>
+            {playbackButtons}
+            {actorButtons}
+          </span>
+        }
+        onToggleFiles={onToggleFiles}
+        filesOpen={filesOpen}
+      />
+      <EditorBody>
+        <div className={styles.sceneWorkspace}>
+          <div className={styles.sceneTools}>
+            <span aria-hidden="true" />
+            <div className={styles.sceneToolsGroup}>{playbackButtons}</div>
+            <div className={styles.sceneToolsGroup}>{actorButtons}</div>
+          </div>
+          <div className={styles.stageWrap}>
+            <div className={styles.stageCard}>
+              <canvas
+                ref={canvasRef}
+                className={styles.stageCanvas}
+                onPointerDown={
+                  isPlaying
+                    ? playPointer.onPointerDown
+                    : panMode
+                      ? panGesture.onPointerDown
+                      : gesture.onPointerDown
+                }
+                onPointerMove={
+                  isPlaying
+                    ? playPointer.onPointerMove
+                    : panMode
+                      ? panGesture.onPointerMove
+                      : gesture.onPointerMove
+                }
+                onPointerUp={
+                  isPlaying
+                    ? playPointer.onPointerUp
+                    : panMode
+                      ? panGesture.onPointerUp
+                      : gesture.onPointerUp
+                }
+                onPointerCancel={
+                  isPlaying
+                    ? playPointer.onPointerUp
+                    : panMode
+                      ? panGesture.onPointerUp
+                      : gesture.onPointerUp
+                }
+              />
+              {isPlaying && <SceneUI getRuntime={getRuntime} />}
+            </div>
+          </div>
+          <aside {...inspectorSheet.rootProps}>
+            <div {...inspectorSheet.grabProps}>
+              <SheetGrabHandle label={inspectorLabel} hint={inspectorHint} />
+            </div>
+            <div className={cx(styles.sheetBody, styles.inspectorBody)}>
+              {showMulti ? (
+                <MultiSelectInspector
+                  count={selectedActorIds.length}
+                  onDelete={actions.deleteSelection}
+                  onDuplicate={actions.duplicateSelection}
+                  onDeselectAll={() => {
+                    onSelectActorIds([]);
+                    onSetMultiSelectMode(false);
+                  }}
+                />
+              ) : selectedActor ? (
+                <ActorInspector
+                  selectedActor={selectedActor}
+                  files={files}
+                  onSetComponent={actions.updateComponent}
+                  onAddBehavior={actions.addBehavior}
+                  onRemoveBehavior={actions.removeBehavior}
+                />
+              ) : (
+                <SceneInspector
+                  sceneData={sceneData}
+                  snapSettings={snapSettings}
+                  onChangeScene={updateSceneSettings}
+                  onChangeEditor={updateSceneEditorSettings}
+                />
+              )}
+            </div>
+          </aside>
+        </div>
+      </EditorBody>
+      <TouchControls getKeys={getRuntimeKeys} visible={isPlaying} />
+    </>
+  );
+}
+function PlaybackButtons({ isPlaying, setIsPlaying, history, panMode, setPanMode }) {
+  return (
+    <>
+      <IconButton
+        icon={isPlaying ? 'stop' : 'play'}
+        label={isPlaying ? 'Stop' : 'Play'}
+        active={isPlaying}
+        variant={isPlaying ? 'primary' : ''}
+        onClick={() => setIsPlaying(!isPlaying)}
+      />
+      <IconButton
+        icon="undo"
+        label="Undo"
+        onClick={history.undo}
+        disabled={!history.canUndo || isPlaying}
+      />
+      <IconButton
+        icon="redo"
+        label="Redo"
+        onClick={history.redo}
+        disabled={!history.canRedo || isPlaying}
+      />
+      <span style={{ width: 16 }} aria-hidden="true" />
+      <IconButton
+        icon="camera"
+        label="Pan camera"
+        active={panMode}
+        onClick={() => setPanMode((value) => !value)}
+        disabled={isPlaying}
+      />
+    </>
+  );
+}
+function ActorToolButtons({
+  sceneData,
+  files,
+  drawings,
+  selectedActorIds,
+  onSelectActorIds,
+  isPlaying,
+  onChange,
+  history,
+}) {
+  const applyScene = (next) => onChange(formatJson(next));
+  const onAdd = () => {
+    const { sceneData: next, newId } = addActor(sceneData, files, drawings);
+    history.recordSnapshot();
+    applyScene(next);
+    onSelectActorIds([newId]);
+  };
+  const onDuplicate = () => {
+    if (selectedActorIds.length === 0) return;
+    const { sceneData: next, newIds } = duplicateActors(sceneData, selectedActorIds);
+    history.recordSnapshot();
+    applyScene(next);
+    if (newIds.length) onSelectActorIds(newIds);
+  };
+  const onRemove = () => {
+    if (selectedActorIds.length === 0) return;
+    history.recordSnapshot();
+    applyScene(removeActors(sceneData, selectedActorIds));
+    onSelectActorIds([]);
+  };
+  const hasSelection = selectedActorIds.length > 0;
+  return (
+    <>
+      <IconButton icon="plus" label="Add actor" onClick={onAdd} disabled={isPlaying} />
+      <IconButton
+        icon="clone"
+        label="Duplicate"
+        onClick={onDuplicate}
+        disabled={!hasSelection || isPlaying}
+      />
+      <IconButton
+        icon="trash"
+        label="Remove"
+        onClick={onRemove}
+        disabled={!hasSelection || isPlaying}
+      />
+    </>
+  );
+}
+function makeSceneActions({ sceneData, commit, selectedActorIds, onSelectActorIds }) {
+  function commitScene(next) {
+    commit(formatJson(next));
+  }
+  return {
+    updateComponent: (actorId, behaviorName, nextProps) =>
+      commitScene(setActorComponent(sceneData, actorId, behaviorName, nextProps)),
+    addBehavior: (actorId, behaviorName) => {
+      const Behavior = findBehaviorClass(behaviorName);
+      if (!Behavior) return;
+      commitScene(
+        setActorComponent(sceneData, actorId, behaviorName, { ...Behavior.defaultProps })
+      );
+    },
+    removeBehavior: (actorId, behaviorName) =>
+      commitScene(removeActorComponent(sceneData, actorId, behaviorName)),
+    deleteSelection: () => {
+      if (selectedActorIds.length === 0) return;
+      commitScene(removeActors(sceneData, selectedActorIds));
+      onSelectActorIds([]);
+    },
+    duplicateSelection: () => {
+      if (selectedActorIds.length === 0) return;
+      const { sceneData: next, newIds } = duplicateActors(sceneData, selectedActorIds);
+      commitScene(next);
+      if (newIds.length) onSelectActorIds(newIds);
+    },
+  };
+}
+function setSceneSettings(sceneData, nextScene) {
+  return {
+    ...sceneData,
+    ...nextScene,
+  };
+}
+function setSceneEditorSettings(sceneData, nextEditor) {
+  return {
+    ...sceneData,
+    editor: {
+      ...(sceneData.editor ?? {}),
+      ...nextEditor,
+    },
+  };
+}
+function useSelectionInspectorSheet(open) {
+  const [snap, setSnap] = useState('high');
+  // Inspector visibility is driven by selection / multi-mode. Snap state
+  // persists across selections so switching keeps the user's chosen snap.
+  const effectiveSnap = open ? snap : 'hidden';
+  return useMobileSheet({
+    snap: effectiveSnap,
+    baseClassName: styles.inspector,
+    onTransition: (direction) => {
+      if (!open) return;
+      if (direction === 'tap') setSnap((prev) => (prev === 'high' ? 'low' : 'high'));
+      else if (direction === 'down') setSnap('low');
+      else if (direction === 'up') setSnap('high');
+    },
+  });
+}
+function useSelectionGesture(args) {
+  const dragRef = useRef(null);
+  // Pin args in a ref so the timer callback reads the latest values without
+  // re-creating the handlers each render.
+  const argsRef = useRef(args);
+  argsRef.current = args;
+  const onPointerDown = useCallback((event) => {
+    const current = argsRef.current;
+    if (current.isPlaying || !current.canvasRef.current || !current.sceneData) return;
+    const raw = screenToCard(current.canvasRef.current, event.clientX, event.clientY);
+    const cam = current.editCameraRef.current;
+    const point = { x: raw.x + cam.x, y: raw.y + cam.y };
+    current.canvasRef.current.setPointerCapture(event.pointerId);
+    const scene = makeScene(current.sceneData, behaviorClasses, current.drawings);
+    const actor = scene.actorAt(point.x, point.y);
+    const drag = {
+      pointerId: event.pointerId,
+      startPoint: point,
+      lastPoint: point,
+      startedOnActorId: actor?.id ?? null,
+      modeAtStart: current.multiSelectMode,
+      movedFar: false,
+      longPressTimer: null,
+      longPressFired: false,
+      kind: 'idle',
+      pendingMarquee: false,
+      movingActorIds: [],
+      moveStarts: {},
+      recordedMoveSnapshot: false,
+      selectionBeforeMarquee: [...current.selectedActorIds],
+    };
+    if (event.shiftKey) {
+      handleShiftPointerDown(drag, actor, current);
+    } else if (current.multiSelectMode) {
+      handleModePointerDown(drag, actor, current);
+    } else {
+      handleDefaultPointerDown(drag, actor, point, current);
+    }
+    drag.moveStarts = collectMoveStarts(current.sceneData, drag.movingActorIds);
+    dragRef.current = drag;
+  }, []);
+  const onPointerMove = useCallback((event) => {
+    const drag = dragRef.current;
+    const current = argsRef.current;
+    if (!drag || drag.pointerId !== event.pointerId) return;
+    if (!current.canvasRef.current || !current.sceneData) return;
+    const raw = screenToCard(current.canvasRef.current, event.clientX, event.clientY);
+    const cam = current.editCameraRef.current;
+    const point = { x: raw.x + cam.x, y: raw.y + cam.y };
+    const dxTotal = point.x - drag.startPoint.x;
+    const dyTotal = point.y - drag.startPoint.y;
+    if (!drag.movedFar && Math.hypot(dxTotal, dyTotal) > DRAG_THRESHOLD) {
+      drag.movedFar = true;
+      if (drag.longPressTimer !== null) {
+        window.clearTimeout(drag.longPressTimer);
+        drag.longPressTimer = null;
+      }
+      if (drag.pendingMarquee && drag.kind === 'idle') drag.kind = 'marquee';
+    }
+    if (drag.kind === 'move' && drag.movedFar) {
+      const snap = getSnapSettings(current.sceneData);
+      const dx = snapDelta(dxTotal, snap.gridSize, snap.enabled);
+      const dy = snapDelta(dyTotal, snap.gridSize, snap.enabled);
+      drag.lastPoint = point;
+      const nextScene = moveActorsFromStarts(
+        current.sceneData,
+        drag.movingActorIds,
+        drag.moveStarts,
+        dx,
+        dy
+      );
+      if (nextScene === current.sceneData) return;
+      if (!drag.recordedMoveSnapshot) {
+        current.recordSceneSnapshot();
+        drag.recordedMoveSnapshot = true;
+      }
+      current.applyScene(nextScene);
+    } else if (drag.kind === 'marquee') {
+      drag.lastPoint = point;
+      current.marqueeRef.current = {
+        x: Math.min(drag.startPoint.x, point.x),
+        y: Math.min(drag.startPoint.y, point.y),
+        width: Math.abs(point.x - drag.startPoint.x),
+        height: Math.abs(point.y - drag.startPoint.y),
+      };
+    }
+  }, []);
+  const onPointerUp = useCallback((event) => {
+    const drag = dragRef.current;
+    const current = argsRef.current;
+    if (!drag || drag.pointerId !== event.pointerId) return;
+    if (drag.longPressTimer !== null) {
+      window.clearTimeout(drag.longPressTimer);
+      drag.longPressTimer = null;
+    }
+    if (drag.kind === 'marquee') {
+      finalizeMarquee(drag, current);
+    } else if (drag.kind === 'idle' && !drag.movedFar && !drag.longPressFired) {
+      handleTap(drag, current);
+    }
+    current.marqueeRef.current = null;
+    dragRef.current = null;
+  }, []);
+  return { onPointerDown, onPointerMove, onPointerUp };
+}
+function getSnapSettings(sceneData) {
+  const rawSize = sceneData.editor?.gridSize;
+  return {
+    enabled: sceneData.editor?.snapToGrid ?? true,
+    gridSize: Number.isFinite(rawSize) && rawSize && rawSize > 0 ? rawSize : DEFAULT_GRID_SIZE,
+  };
+}
+function snapDelta(delta, gridSize, enabled) {
+  if (!enabled) return delta;
+  return Math.round(delta / gridSize) * gridSize;
+}
+function collectMoveStarts(sceneData, actorIds) {
+  const starts = {};
+  const movingIds = new Set(actorIds);
+  for (const actor of sceneData.actors) {
+    if (!movingIds.has(actor.id)) continue;
+    const layout = actor.components.Layout;
+    if (!layout) continue;
+    starts[actor.id] = { x: layout.x, y: layout.y };
+  }
+  return starts;
+}
+function moveActorsFromStarts(sceneData, actorIds, starts, dx, dy) {
+  if (actorIds.length === 0) return sceneData;
+  const movingIds = new Set(actorIds);
+  const next = structuredClone(sceneData);
+  let changed = false;
+  for (const actor of next.actors) {
+    if (!movingIds.has(actor.id)) continue;
+    const start = starts[actor.id];
+    const layout = actor.components.Layout;
+    if (!start || !layout) continue;
+    const nextX = Math.round(start.x + dx);
+    const nextY = Math.round(start.y + dy);
+    if (layout.x === nextX && layout.y === nextY) continue;
+    actor.components.Layout = {
+      ...layout,
+      x: nextX,
+      y: nextY,
+    };
+    changed = true;
+  }
+  return changed ? next : sceneData;
+}
+function usePlayPointerGesture({ canvasRef, runtimeRef }) {
+  const setPointer = useCallback(
+    (event, down) => {
+      const canvas = canvasRef.current;
+      const runtime = runtimeRef.current;
+      if (!canvas || !runtime) return;
+      runtime.setPointerFromScreen(canvas, event.clientX, event.clientY, down);
+    },
+    [canvasRef, runtimeRef]
+  );
+  const onPointerDown = useCallback(
+    (event) => {
+      event.currentTarget.setPointerCapture(event.pointerId);
+      setPointer(event, true);
+    },
+    [setPointer]
+  );
+  const onPointerMove = useCallback(
+    (event) => {
+      setPointer(event);
+    },
+    [setPointer]
+  );
+  const onPointerUp = useCallback(
+    (event) => {
+      setPointer(event, false);
+      try {
+        event.currentTarget.releasePointerCapture(event.pointerId);
+      } catch {
+        // Pointer capture may already be gone after cancel/blur.
+      }
+    },
+    [setPointer]
+  );
+  return { onPointerDown, onPointerMove, onPointerUp };
+}
+function usePanGesture({ canvasRef, editCameraRef, enabled }) {
+  const dragRef = useRef(null);
+  const onPointerDown = useCallback(
+    (event) => {
+      if (!enabled) return;
+      const canvas = canvasRef.current;
+      if (!canvas) return;
+      const point = screenToCard(canvas, event.clientX, event.clientY);
+      event.currentTarget.setPointerCapture(event.pointerId);
+      dragRef.current = { id: event.pointerId, last: point };
+    },
+    [canvasRef, enabled]
+  );
+  const onPointerMove = useCallback(
+    (event) => {
+      const drag = dragRef.current;
+      if (!drag || drag.id !== event.pointerId) return;
+      const canvas = canvasRef.current;
+      if (!canvas) return;
+      const point = screenToCard(canvas, event.clientX, event.clientY);
+      const dx = point.x - drag.last.x;
+      const dy = point.y - drag.last.y;
+      drag.last = point;
+      editCameraRef.current = {
+        x: editCameraRef.current.x - dx,
+        y: editCameraRef.current.y - dy,
+      };
+    },
+    [canvasRef, editCameraRef]
+  );
+  const onPointerUp = useCallback((event) => {
+    const drag = dragRef.current;
+    if (!drag || drag.id !== event.pointerId) return;
+    try {
+      event.currentTarget.releasePointerCapture(event.pointerId);
+    } catch {
+      // pointer capture may already be gone
+    }
+    dragRef.current = null;
+  }, []);
+  return { onPointerDown, onPointerMove, onPointerUp };
+}
+function handleShiftPointerDown(drag, actor, current) {
+  if (actor) {
+    const wasSelected = current.selectedActorIds.includes(actor.id);
+    const nextIds = wasSelected
+      ? current.selectedActorIds.filter((id) => id !== actor.id)
+      : [...current.selectedActorIds, actor.id];
+    current.onSelectActorIds(nextIds);
+    if (!wasSelected) {
+      drag.kind = 'move';
+      drag.movingActorIds = nextIds;
+    }
+  } else {
+    drag.pendingMarquee = true;
+  }
+}
+function handleModePointerDown(drag, actor, current) {
+  if (actor) {
+    if (current.selectedActorIds.includes(actor.id)) {
+      drag.kind = 'move';
+      drag.movingActorIds = [...current.selectedActorIds];
+    }
+    // else: leave kind='idle' so pointerup triggers the tap-toggle path.
+  } else {
+    // Defer marquee until movement, so a stationary press/release reaches
+    // the tap handler (which exits multi mode on empty tap).
+    drag.pendingMarquee = true;
+  }
+}
+function handleDefaultPointerDown(drag, actor, point, current) {
+  if (actor) {
+    if (!current.selectedActorIds.includes(actor.id)) {
+      current.onSelectActorIds([actor.id]);
+      drag.movingActorIds = [actor.id];
+    } else {
+      drag.movingActorIds = [...current.selectedActorIds];
+    }
+    drag.kind = 'move';
+    drag.longPressTimer = window.setTimeout(() => {
+      if (drag.movedFar) return;
+      drag.longPressFired = true;
+      current.onSetMultiSelectMode(true);
+    }, LONG_PRESS_MS);
+  } else {
+    current.onSelectActorIds([]);
+    drag.longPressTimer = window.setTimeout(() => {
+      if (drag.movedFar) return;
+      drag.longPressFired = true;
+      current.onSetMultiSelectMode(true);
+      drag.kind = 'marquee';
+      current.marqueeRef.current = { x: point.x, y: point.y, width: 0, height: 0 };
+    }, LONG_PRESS_MS);
+  }
+}
+function finalizeMarquee(drag, current) {
+  const m = current.marqueeRef.current;
+  if (!m || !current.sceneData) return;
+  if (m.width === 0 && m.height === 0) return;
+  const scene = makeScene(current.sceneData, behaviorClasses, current.drawings);
+  const hits = scene.actorIdsInRect(m);
+  const merged = new Set(drag.selectionBeforeMarquee);
+  for (const id of hits) merged.add(id);
+  current.onSelectActorIds([...merged]);
+}
+function handleTap(drag, current) {
+  if (!drag.modeAtStart) return;
+  if (drag.startedOnActorId !== null) {
+    const id = drag.startedOnActorId;
+    const wasSelected = current.selectedActorIds.includes(id);
+    current.onSelectActorIds(
+      wasSelected
+        ? current.selectedActorIds.filter((x) => x !== id)
+        : [...current.selectedActorIds, id]
+    );
+  } else {
+    current.onSetMultiSelectMode(false);
+    current.onSelectActorIds([]);
+  }
+}
+function useSelectionKeyboard(args) {
+  const ref = useRef(args);
+  ref.current = args;
+  useEffect(() => {
+    function onKeyDown(event) {
+      const current = ref.current;
+      if (current.isPlaying || isEditableTarget(event.target)) return;
+      if (event.key === 'Escape') {
+        if (current.selectedActorIds.length || current.multiSelectMode) {
+          event.preventDefault();
+          current.onSelectActorIds([]);
+          current.onSetMultiSelectMode(false);
+        }
+        return;
+      }
+      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === 'a') {
+        if (!current.sceneData) return;
+        event.preventDefault();
+        current.onSelectActorIds(current.sceneData.actors.map((actor) => actor.id));
+        return;
+      }
+      if (event.key === 'Delete' || event.key === 'Backspace') {
+        if (!current.sceneData || current.selectedActorIds.length === 0) return;
+        event.preventDefault();
+        current.commitScene(removeActors(current.sceneData, current.selectedActorIds));
+        current.onSelectActorIds([]);
+      }
+    }
+    window.addEventListener('keydown', onKeyDown);
+    return () => window.removeEventListener('keydown', onKeyDown);
+  }, []);
+}
+function useScenePlayLoop({
+  sceneData,
+  drawings,
+  isPlaying,
+  text,
+  canvasRef,
+  runtimeRef,
+  editCameraRef,
+  selectedActorIds,
+  marqueeRef,
+}) {
+  // Spin up / tear down the play-mode runtime as the user toggles play. `text`
+  // is the stable identity for `sceneData` (which is re-parsed every render);
+  // depending on `sceneData` here would reset the runtime — and any
+  // behavior-mutated state like Layout.rotation — on every parent re-render.
+  useEffect(() => {
+    if (!isPlaying) {
+      runtimeRef.current = null;
+      return;
+    }
+    if (!sceneData) return;
+    runtimeRef.current = makeScene(sceneData, behaviorClasses, drawings).clone();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [drawings, isPlaying, text, runtimeRef]);
+  // Animation loop -- draws edit-mode previews and ticks the play-mode runtime.
+  useEffect(() => {
+    if (!sceneData || !canvasRef.current) return undefined;
+    const canvas = canvasRef.current;
+    const ctx = canvas.getContext('2d');
+    if (!ctx) return undefined;
+    configureSceneCanvas(canvas, ctx);
+    let raf = 0;
+    let last = performance.now();
+    const frame = (now) => {
+      const dt = Math.min(0.033, (now - last) / 1000);
+      last = now;
+      const scene = isPlaying
+        ? runtimeRef.current
+        : makeScene(sceneData, behaviorClasses, drawings);
+      if (scene) {
+        if (isPlaying) scene.update(dt);
+        if (!isPlaying) scene.camera = { ...editCameraRef.current };
+        configureSceneCanvas(canvas, ctx);
+        scene.draw(ctx, {
+          selectedActorIds: isPlaying ? [] : selectedActorIds,
+          marquee: isPlaying ? null : marqueeRef.current,
+          showGrid: false,
+          showDebugColliders: false,
+          useCamera: true,
+          editPlaceholders: !isPlaying,
+        });
+      }
+      raf = requestAnimationFrame(frame);
+    };
+    raf = requestAnimationFrame(frame);
+    return () => cancelAnimationFrame(raf);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `text` proxies `sceneData` identity; resetting on every parse churns the loop and wipes runtime state.
+  }, [drawings, isPlaying, selectedActorIds, text, canvasRef, runtimeRef, marqueeRef]);
+}
+function useScenePlayKeys(runtimeRef, setIsPlaying) {
+  useEffect(() => {
+    const down = (event) => {
+      if (event.key === ' ' && !isEditableTarget(event.target)) {
+        event.preventDefault();
+        setIsPlaying((current) => !current);
+        return;
+      }
+      if (!runtimeRef.current) return;
+      runtimeRef.current.keys.add(event.key);
+    };
+    const up = (event) => {
+      if (!runtimeRef.current) return;
+      runtimeRef.current.keys.delete(event.key);
+    };
+    window.addEventListener('keydown', down);
+    window.addEventListener('keyup', up);
+    return () => {
+      window.removeEventListener('keydown', down);
+      window.removeEventListener('keyup', up);
+    };
+  }, [runtimeRef, setIsPlaying]);
+}
+function isEditableTarget(target) {
+  return (
+    target instanceof Element &&
+    !!target.closest('input, textarea, select, [contenteditable="true"]')
+  );
+}
+function MultiSelectInspector({ count, onDelete, onDuplicate, onDeselectAll }) {
+  return (
+    <div style={{ padding: '14px 16px', display: 'flex', flexDirection: 'column', gap: 12 }}>
+      <div style={{ fontSize: 13, opacity: 0.8 }}>
+        {count === 0
+          ? 'Multi-select mode -- tap actors to add'
+          : `${count} actor${count === 1 ? '' : 's'} selected`}
+      </div>
+      <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
+        <button
+          type="button"
+          onClick={onDuplicate}
+          disabled={count === 0}
+          style={inspectorActionStyle(count === 0)}>
+          <Icon name="clone" /> Duplicate
+        </button>
+        <button
+          type="button"
+          onClick={onDelete}
+          disabled={count === 0}
+          style={inspectorActionStyle(count === 0)}>
+          <Icon name="trash" /> Delete
+        </button>
+        <button type="button" onClick={onDeselectAll} style={inspectorActionStyle(false)}>
+          <Icon name="times" /> Deselect all
+        </button>
+      </div>
+    </div>
+  );
+}
+function inspectorActionStyle(disabled) {
+  return {
+    display: 'inline-flex',
+    alignItems: 'center',
+    gap: 6,
+    padding: '6px 10px',
+    background: 'transparent',
+    color: 'inherit',
+    border: '1px solid var(--castle-inspector-divider)',
+    borderRadius: 6,
+    cursor: disabled ? 'default' : 'pointer',
+    opacity: disabled ? 0.5 : 1,
+    fontSize: 13,
+  };
+}
+function SceneInspector({ sceneData, snapSettings, onChangeScene, onChangeEditor }) {
+  return (
+    <Panel title="Scene">
+      <TextField
+        label="Name"
+        value={sceneData.name ?? ''}
+        onChange={(name) => onChangeScene({ name })}
+      />
+      <ColorField
+        label="Background"
+        value={sceneData.background ?? '#121213'}
+        onChange={(background) => onChangeScene({ background })}
+      />
+      <CheckboxField
+        label="Snap to grid"
+        checked={snapSettings.enabled}
+        onChange={(snapToGrid) => onChangeEditor({ snapToGrid })}
+      />
+      <NumberField
+        label="Grid size"
+        value={snapSettings.gridSize}
+        min={1}
+        step={1}
+        onChange={(gridSize) => onChangeEditor({ gridSize: Math.round(gridSize) })}
+      />
+    </Panel>
+  );
+}
+function ActorInspector({ selectedActor, files, onSetComponent, onAddBehavior, onRemoveBehavior }) {
+  const presentNames = new Set(
+    Object.entries(selectedActor.components)
+      .filter(([, component]) => !!component)
+      .map(([behaviorName]) => behaviorName)
+  );
+  const availableBehaviors = behaviorClasses.filter(
+    (candidate) => !presentNames.has(candidate.behaviorName)
+  );
+  const behaviorEntries = Object.entries(selectedActor.components).filter((entry) => !!entry[1]);
+  return (
+    <>
+      <AddBehaviorPicker
+        available={availableBehaviors}
+        onAdd={(behaviorName) => onAddBehavior(selectedActor.id, behaviorName)}
+      />
+      {behaviorEntries.map(([behaviorName, component], index) => {
+        const Behavior = behaviorClasses.find(
+          (candidate) => candidate.behaviorName === behaviorName
+        );
+        const Inspector = Behavior?.Inspector;
+        const body = Inspector ? (
+          <Inspector
+            actor={selectedActor}
+            component={component}
+            files={files}
+            setComponent={(nextProps) => onSetComponent(selectedActor.id, behaviorName, nextProps)}
+          />
+        ) : (
+          <AutoInspector
+            behaviorName={behaviorName}
+            defaultProps={Behavior?.defaultProps ?? component}
+            component={component}
+            setComponent={(nextProps) => onSetComponent(selectedActor.id, behaviorName, nextProps)}
+          />
+        );
+        // Layout is core to every actor -- it cannot be removed.
+        const removable = behaviorName !== 'Layout';
+        const isLast = index === behaviorEntries.length - 1;
+        // Trash renders before the panel so the panel stays the wrapper's
+        // last child -- the panel's own `:last-child` border zeroes out, and
+        // this wrapper owns the divider between panels deterministically.
+        return (
+          <div
+            key={behaviorName}
+            style={{
+              position: 'relative',
+              borderBottom: isLast ? undefined : '1px solid var(--castle-inspector-divider)',
+            }}>
+            {removable ? (
+              <button
+                type="button"
+                aria-label={`Remove ${behaviorName}`}
+                title={`Remove ${behaviorName}`}
+                onClick={() => onRemoveBehavior(selectedActor.id, behaviorName)}
+                style={{
+                  position: 'absolute',
+                  top: 14,
+                  right: 16,
+                  border: 'none',
+                  background: 'transparent',
+                  padding: 0,
+                  margin: 0,
+                  cursor: 'pointer',
+                  color: 'inherit',
+                  fontSize: 16,
+                  lineHeight: 1,
+                }}>
+                <Icon name="trash" />
+              </button>
+            ) : null}
+            {body}
+          </div>
+        );
+      })}
+    </>
+  );
+}
+function AddBehaviorPicker({ available, onAdd }) {
+  if (!available.length) return null;
+  return (
+    <div
+      style={{
+        padding: '12px 16px',
+        borderBottom: '1px solid var(--castle-inspector-divider)',
+      }}>
+      <div style={{ position: 'relative' }}>
+        <select
+          className={styles.select}
+          value=""
+          onChange={(event) => {
+            if (event.target.value) onAdd(event.target.value);
+          }}
+          style={{
+            appearance: 'none',
+            WebkitAppearance: 'none',
+            MozAppearance: 'none',
+            paddingRight: 30,
+          }}>
+          <option value="">+ Add behavior</option>
+          {available.map((behavior) => (
+            <option key={behavior.behaviorName} value={behavior.behaviorName}>
+              {behavior.behaviorName}
+            </option>
+          ))}
+        </select>
+        <span
+          style={{
+            position: 'absolute',
+            right: 11,
+            top: '50%',
+            transform: 'translateY(-50%)',
+            pointerEvents: 'none',
+            fontSize: 12,
+            opacity: 0.6,
+          }}>
+          <Icon name="chevron-down" />
+        </span>
+      </div>
+    </div>
+  );
+}