{
 "_doc": "Single shared contract for the website track (public/scene/scene.js) and the Blender track (blender/*.py). Read-only after Step 0. All stage numbers are in a 1600x900 coordinate space (origin top-left, y down). World numbers are metres, Blender axes: X screen-right, Y into the room (away from camera), Z up. Origin = floor under the chair centre.",
 "version": 1,
 "stage": {
  "w": 1600,
  "h": 900,
  "aspect": "16:9",
  "_notes": "All stage rects are from the approved mock .impeccable/mocks/hero-concept/index.html (percent boxes x16/x9). Render density 1.6 px per stage px (2560x1440 for the full stage); crop rects below are multiples of 5 stage px so 1.6x gives whole, even pixel sizes (H.264 needs even)."
 },
 "renderDensity": 1.6,
 "draftScale": {
  "value": 0.375,
  "_notes": "Multiply every pixel size in `render` by this for a draft run (room plate 2560x1440 -> 960x540, the plan's B1c size). Also use 16 samples. Frame counts stay the same unless a script passes a reduced frame count."
 },
 "timing": {
  "fps": 24,
  "loopSeconds": 24,
  "loopFrames": 576,
  "gustPeriodSeconds": 8,
  "gustsPerLoop": 3,
  "gustPeakAtSeconds": 2.8,
  "_notes": "gustPeakAtSeconds is the mock's keyTimes .35 of 8 s (curtain farthest in). Curtain, lantern turn (1 full turn per 24 s) and arm (3 cycles per 24 s) all loop at exactly 576 frames; frame 0 == frame 576."
 },
 "chair": {
  "fps": 24,
  "totalFrames": 312,
  "restFrame": 0,
  "restTailFrames": 8,
  "clips": {
   "rock": {
    "start": 0,
    "end": 240
   },
   "shift": {
    "start": 240,
    "end": 312
   }
  },
  "schedule": {
   "firstDelayS": [
    3,
    5
   ],
   "intervalS": [
    10,
    22
   ],
   "rockWeight": 0.8
  },
  "_notes": "Turned-around executive chair rocking on its tilt mechanism (pivot under the seat), no occupant (removed at the owner's request 2026-11-16; only the empty chair moves). One video: rock = frames 0..239 (10 s, 3-4 uneven rocks, about 12.5 deg back / 2 deg forward with a +/-4 deg swivel at a different period), shift = 240..311 (3 s: small swivel and settle). Frame `start` of each clip and its last restTailFrames frames are exactly the rest pose (= frame 0 = poster), so the player only ever seeks or pauses on rest frames. end is exclusive."
 },
 "arm": {
  "cycleSeconds": 8,
  "cycleFrames": 192,
  "moveSeconds": 0.7,
  "moveFrames": 17,
  "restPoses": [
   "home",
   "atBook",
   "bookPulled"
  ],
  "workCycle": {
   "start": 0,
   "end": 192,
   "repeatsPerLoop": 3,
   "timeline": [
    {
     "what": "hold home",
     "from": 0,
     "to": 36
    },
    {
     "what": "reach (home->atBook)",
     "from": 36,
     "to": 53,
     "move": true
    },
    {
     "what": "hold atBook",
     "from": 53,
     "to": 72
    },
    {
     "what": "pull book halfway (atBook->bookPulled)",
     "from": 72,
     "to": 89,
     "move": true
    },
    {
     "what": "hold bookPulled",
     "from": 89,
     "to": 120
    },
    {
     "what": "push book back (bookPulled->atBook)",
     "from": 120,
     "to": 137,
     "move": true
    },
    {
     "what": "hold atBook",
     "from": 137,
     "to": 156
    },
    {
     "what": "return home (atBook->home)",
     "from": 156,
     "to": 173,
     "move": true
    },
    {
     "what": "hold home (wraps into frame 0)",
     "from": 173,
     "to": 192
    }
   ]
  },
  "holds": {
   "home": [
    {
     "from": 173,
     "to": 228,
     "_wrap": "frames 173..191 then 0..35 of the next cycle (to = 192+36)",
     "resumeFrame": 36
    }
   ],
   "atBook": [
    {
     "from": 53,
     "to": 72,
     "resumeFrame": 72
    },
    {
     "from": 137,
     "to": 156,
     "resumeFrame": 156
    }
   ],
   "bookPulled": [
    {
     "from": 89,
     "to": 120,
     "resumeFrame": 120
    }
   ]
  },
  "segments": {
   "work": {
    "start": 0,
    "end": 192
   },
   "home_startle": {
    "start": 192,
    "end": 216,
    "pose": "home"
   },
   "home_hold": {
    "start": 216,
    "end": 228,
    "pose": "home",
    "loop": true
   },
   "home_return": {
    "start": 228,
    "end": 245,
    "pose": "home"
   },
   "atBook_startle": {
    "start": 245,
    "end": 269,
    "pose": "atBook"
   },
   "atBook_hold": {
    "start": 269,
    "end": 281,
    "pose": "atBook",
    "loop": true
   },
   "atBook_return": {
    "start": 281,
    "end": 298,
    "pose": "atBook"
   },
   "bookPulled_startle": {
    "start": 298,
    "end": 322,
    "pose": "bookPulled"
   },
   "bookPulled_hold": {
    "start": 322,
    "end": 334,
    "pose": "bookPulled",
    "loop": true
   },
   "bookPulled_return": {
    "start": 334,
    "end": 351,
    "pose": "bookPulled"
   }
  },
  "totalFrames": 351,
  "hoverRule": "On hover: wait until the current move ends (<= 17 frames = 0.708 s), then seek to <pose>_startle start, play through, loop <pose>_hold while hovered, on leave play <pose>_return, then seek to the work-cycle frame `resumeFrame` of the hold that was interrupted. Rest-pose frames are identical, so every seek happens on a still frame. Segment `end` is exclusive.",
  "_notes": "JUDGMENT: 0.7 s = 16.8 frames, rounded to 17 frames (0.708 s) so every segment boundary is a whole frame. Hold lengths (1.5/0.8/1.3/0.8/0.8 s) are my choice; any split summing to 192 is fine. Startle+thumbs-up = 24 frames, thumbs-up hold = 12 frames (must loop seamlessly), return = 17 frames; 192 + 3x53 = 351 (plan said about 350). Pose at frame 0 must equal pose at frame 192 and the last frame of each *_return must equal its pose."
 },
 "camera": {
  "heightM": 1.1,
  "distanceToChairM": 3.0,
  "position": [
   0,
   -3.0,
   1.1
  ],
  "rotationEulerDeg": [
   90,
   0,
   0
  ],
  "pitch": "level",
  "sensorWidthMm": 36,
  "sensorFit": "HORIZONTAL",
  "lensMm": 26,
  "hFovDeg": 69.39,
  "focalPx": 1155.56,
  "horizonY": 522.0,
  "shiftY": 0.045,
  "shiftX": 0,
  "marginPass": {
   "factor": 1.1,
   "_how": "For exterior/bridge passes: sensor_width = 36*1.1, resolution = 2816x1584, shift_y = 72/1760 = 0.04091 (blender/common.py does this). Covers stage rect -80,-45,1760,990."
  },
  "_notes": "Level camera, horizon pushed down to stage y 522 with positive lens shift_y = 72/1600 = 0.045 (Blender shift is a fraction of the larger dimension; positive moves the image down). Stage->world: X=(x-800)*Z/1155.56, Zup=1.1+(522-y)*Z/1155.56 where Z is depth from camera (= worldY+3)."
 },
 "room": {
  "dimsM": {
   "width": 10.07,
   "depth": 11.27,
   "height": 5.13
  },
  "glassWallY": 7.772,
  "xHalf": 5.034,
  "floorZ": 0,
  "ceilingZ": 5.127,
  "backOfRoomY": -3.5,
  "glassOpeningStage": {
   "x": 260,
   "y": 90,
   "w": 1080,
   "h": 550
  },
  "mullionsStageX": [
   258,
   528,
   798,
   1068,
   1336
  ],
  "_notes": "The glass wall is at the depth where its floor edge lands on stage y 640 and top on y 90 (10.77 m). The mock's side walls/ceiling are a stylised drawing, not true perspective, so the Blender shell is derived from the glass opening only; hotspot objects are anchored to their stage rects instead (objectsWorld). Room plate has alpha in the glass opening so the exterior layers show through (film_transparent + transparent glass opening)."
 },
 "stageRects": {
  "hotspots": {
   "reaper": {
    "x": 990,
    "y": 72,
    "w": 560,
    "h": 173,
    "route": "/projects",
    "label": "Projects"
   },
   "arm": {
    "x": 57.6,
    "y": 54,
    "w": 278.4,
    "h": 513,
    "route": "/courses",
    "label": "Teaching"
   },
   "manuscript": {
    "x": 980,
    "y": 600,
    "w": 190,
    "h": 120,
    "route": "/publications",
    "label": "Publications"
   },
   "trophy": {
    "x": 315,
    "y": 490,
    "w": 110,
    "h": 212,
    "route": "/awards",
    "label": "Awards"
   },
   "phone": {
    "x": 451.2,
    "y": 622.8,
    "w": 115.2,
    "h": 86.4,
    "route": "/contact",
    "label": "Connect"
   }
  },
  "publicationsViewBox": "980 600 190 120",
  "nameplate": {
   "x": 540,
   "y": 612,
   "w": 520,
   "h": 112,
   "centerX": 800,
   "bottomY": 723.6,
   "_notes": "Mock nameplate is HTML text (Azwad Abid + sub line); width 520 and height 112 are estimated from the CSS (50 px caps text + padding), not measured."
  },
  "lantern": {
   "x": 406.4,
   "y": 99,
   "w": 99.2,
   "h": 207
  },
  "curtain": {
   "x": 1096,
   "y": 92,
   "w": 244,
   "h": 556
  },
  "chairSlot": {
   "x": 649.6,
   "y": 288,
   "w": 300.8,
   "h": 450
  },
  "deskTopFarEdge": {
   "y": 660,
   "xFrom": 250,
   "xTo": 1350
  },
  "deskTopNearEdge": {
   "y": 722,
   "xFrom": 130,
   "xTo": 1470
  },
  "deskBox": {
   "x": 0,
   "y": 630,
   "w": 1600,
   "h": 270
  },
  "horizonY": 522.0,
  "glassWall": {
   "x": 260,
   "y": 90,
   "w": 1080,
   "h": 550
  },
  "hagiaSophia": {
   "x": 319,
   "y": 354,
   "w": 263,
   "h": 206,
   "localOrigin": [
    330,
    380
   ],
   "headland": {
    "x": 260,
    "y": 527,
    "w": 430,
    "h": 48
   },
   "_notes": "Mock group translate(330 380); local x -11..252, y -26..180."
  },
  "bridge": {
   "x": 800,
   "y": 321,
   "w": 580,
   "h": 227,
   "localOrigin": [
    860,
    336
   ],
   "deckY": 476,
   "deckLocalY": 140,
   "towerTopY": 324,
   "pierBottomY": 548,
   "_notes": "Mock group translate(860 336); local x -60..520. Clipped by the glass at x 1340. Deck y 476, thickness to 487."
  },
  "reaperSprite": {
   "x": 960,
   "y": 0,
   "w": 620,
   "h": 248
  },
  "shipLanes": {
   "far": {
    "waterlineY": 527,
    "scale": [
     0.26,
     0.31
    ],
    "behindBridge": true
   },
   "A1": {
    "waterlineY": 541,
    "scale": [
     0.5,
     0.54
    ],
    "behindBridge": true,
    "direction": "right"
   },
   "A2": {
    "waterlineY": 549,
    "scale": [
     0.56,
     0.6
    ],
    "behindBridge": true,
    "direction": "left"
   },
   "near": {
    "waterlineY": 606,
    "scale": [
     0.88,
     1.0
    ],
    "behindBridge": false
   }
  }
 },
 "crops": {
  "lantern": {
   "x": 380,
   "y": 80,
   "w": 165,
   "h": 255
  },
  "curtain": {
   "x": 1095,
   "y": 90,
   "w": 255,
   "h": 565
  },
  "arm": {
   "x": 50,
   "y": 50,
   "w": 335,
   "h": 525
  },
  "chair": {
   "x": 480,
   "y": 245,
   "w": 640,
   "h": 410
  },
  "trophyLit": {
   "x": 300,
   "y": 475,
   "w": 140,
   "h": 235
  },
  "phoneLit": {
   "x": 440,
   "y": 615,
   "w": 140,
   "h": 105
  },
  "manuscriptLit": {
   "x": 965,
   "y": 540,
   "w": 220,
   "h": 190
  },
  "_notes": "All multiples of 5 so x1.6 is integer. Lantern x 380..545 and arm x 50..350 are 30 stage px apart (no overlap). Chosen so edges fall on the dark left bookcase / glass-edge area, but I could not verify 'dark at the edge' against a render yet: re-check once the room exists. Curtain crop reaches x 1350, 10 px into the right wall, because the cloth edge needs slack. manuscriptLit extends above the paper for the 38 px lift, glow and motes."
 },
 "layers": [
  {
   "id": "exterior",
   "order": 1,
   "parallaxPx": 18,
   "pass": "exterior",
   "type": "still",
   "rect": {
    "x": -80,
    "y": -45,
    "w": 1760,
    "h": 990
   }
  },
  {
   "id": "shipsBack",
   "order": 2,
   "parallaxPx": 18,
   "pass": "ships",
   "type": "sprites",
   "rect": {
    "x": 260,
    "y": 90,
    "w": 1080,
    "h": 550
   },
   "_notes": "Lanes far, A1, A2; clipped to the glass opening."
  },
  {
   "id": "bridge",
   "order": 3,
   "parallaxPx": 12,
   "pass": "bridge",
   "type": "still",
   "rect": {
    "x": -80,
    "y": -45,
    "w": 1760,
    "h": 990
   },
   "hasAlpha": true
  },
  {
   "id": "shipsNear",
   "order": 4,
   "parallaxPx": 12,
   "pass": "ships",
   "type": "sprites",
   "rect": {
    "x": 260,
    "y": 90,
    "w": 1080,
    "h": 550
   }
  },
  {
   "id": "room",
   "order": 5,
   "parallaxPx": 0,
   "pass": "room",
   "type": "still",
   "rect": {
    "x": 0,
    "y": 0,
    "w": 1600,
    "h": 900
   },
   "hasAlpha": true,
   "_notes": "Alpha in the glass opening."
  },
  {
   "id": "curtain",
   "order": 6,
   "parallaxPx": 0,
   "pass": "curtain",
   "type": "alphaVideo",
   "rect": {
    "x": 1095,
    "y": 90,
    "w": 255,
    "h": 565
   }
  },
  {
   "id": "lantern",
   "order": 7,
   "parallaxPx": 0,
   "pass": "lantern",
   "type": "alphaVideo",
   "rect": {
    "x": 380,
    "y": 80,
    "w": 165,
    "h": 255
   }
  },
  {
   "id": "arm",
   "order": 8,
   "parallaxPx": 0,
   "pass": "arm",
   "type": "alphaVideo",
   "rect": {
    "x": 50,
    "y": 50,
    "w": 335,
    "h": 525
   }
  },
  {
   "id": "reaper",
   "order": 9,
   "parallaxPx": 0,
   "pass": "reaper",
   "type": "still",
   "rect": {
    "x": 960,
    "y": 0,
    "w": 620,
    "h": 248
   },
   "hasAlpha": true,
   "variants": [
    "dark",
    "lit"
   ],
   "_notes": "Owner 2026-11-16: a 3.3 m model hung by two cables from the ceiling inside the room, top right, in front of the window, mullions and curtain (so above them in order). Rect reaches y 0 so the cables meet the ceiling. Parallax 0 like the room: cables must not slide on the ceiling."
  },
  {
   "id": "figure",
   "order": 10,
   "parallaxPx": 0,
   "pass": null,
   "type": "empty",
   "rect": {
    "x": 649.6,
    "y": 288,
    "w": 300.8,
    "h": 450
   },
   "_notes": "Empty slot between room and desk until footage day."
  },
  {
   "id": "chair",
   "order": 10.5,
   "parallaxPx": 0,
   "pass": "chair",
   "type": "alphaVideo",
   "rect": {
    "x": 480,
    "y": 245,
    "w": 640,
    "h": 410
   },
   "_notes": "Rocking chair, empty (stacked colour-over-matte). Above the room plate and the figure slot, below the desk (the desk + nameplate occlude its lower part). chair.js plays the rock/shift clips; poster = rest frame."
  },
  {
   "id": "desk",
   "order": 11,
   "parallaxPx": 0,
   "pass": "desk",
   "type": "still",
   "rect": {
    "x": 0,
    "y": 630,
    "w": 1600,
    "h": 270
   },
   "hasAlpha": true,
   "_notes": "Parallax +-6 px: scene.js scales this layer 1.008 about its centre so edges never show."
  },
  {
   "id": "litCrops",
   "order": 12,
   "parallaxPx": 0,
   "pass": "lit",
   "type": "still|spriteSheet",
   "rect": null,
   "_notes": "trophyLit, phoneLit, manuscriptLit; rects in `crops`; cross-faded over the dark room on hover."
  },
  {
   "id": "nameplate",
   "order": 13,
   "parallaxPx": 0,
   "pass": null,
   "type": "dom",
   "rect": {
    "x": 540,
    "y": 612,
    "w": 520,
    "h": 112
   }
  }
 ],
 "parallax": {
  "exterior": 18,
  "bridge": 12,
  "room": 0,
  "figure": 0,
  "desk": 0,
  "reaper": 0,
  "_notes": "Amplitude in stage px at pointer extremes (+-). Horizontal full amplitude, vertical 0.5x. All layers move opposite to the pointer, scaled by amplitude. Judgment; scene.js owns the exact curve."
 },
 "portrait": {
  "window": {
   "x": 480,
   "y": 0,
   "w": 640,
   "h": 900
  },
  "safeCore916": {
   "x": 547,
   "y": 0,
   "w": 506,
   "h": 900
  },
  "centerX": 800,
  "reaper": {
   "x": 810,
   "y": 0,
   "w": 300,
   "h": 120
  },
  "reaperScale": 0.8,
  "_notes": "Window is 640x900 (0.711, a bit wider than 9:16) so the chair (centre 800) and the 520 px nameplate fit; scene.js shows it cover-fit and may narrow to safeCore916 on taller phones (nameplate then scales to ~0.95). Reaper moves to the top right inside the glass at 0.8x. In this window: chair, nameplate, the bridge's left half, the manuscript's left 140 px, phone partly (451..566 is cut at 480). Lantern, arm, trophy and Hagia Sophia fall outside, so the five hotspots become a row of labels under the scene (plan). No separate portrait render."
 },
 "objectsWorld": {
  "_notes": "Each object is anchored by stage rect + depth from the camera; positions are bounding-box centres (Z = height) unless 'base' is given (centre of the footprint on the surface). Judgment: depths picked to make real-world sizes plausible.",
  "chair": {
   "position": [
    0,
    0,
    0
   ],
   "facing": "+Y (high back to camera)",
   "slotTopZ": 1.708,
   "slotBottomZ": 0.539,
   "backTopZ": 1.71,
   "slotSizeM": [
    0.781,
    1.168
   ],
   "_notes": "Chair at 3.0 m from the camera, slot 0.78 x 1.17 m."
  },
  "desk": {
   "sizeM": [
    2.6,
    0.91,
    0.75
   ],
   "topZ": 0.75,
   "farEdgeY": -0.069,
   "nearEdgeY": -0.978,
   "centerXY": [
    0,
    -0.524
   ],
   "_notes": "Mock far edge 1100 px wide would be 2.79 m, near edge 2.34 m; 2.6 m is the compromise, so desk edges land +-30 px off the mock."
  },
  "nameplate": {
   "base": [
    0.0,
    -0.994,
    0.75
   ],
   "sizeM": [
    0.9,
    0.19
   ],
   "rotateXDeg": 22,
   "_notes": "Large because the mock's plate is 520 px wide on a desk 2 m away. If too big, shrink to 0.6 and keep the DOM text rect."
  },
  "lantern": {
   "center": [
    -1.488,
    2.0,
    2.482
   ],
   "sizeM": [
    0.429,
    0.896
   ],
   "hangsFromZ": 5.127,
   "turnSeconds": 24
  },
  "curtain": {
   "railZ": 5.077,
   "restXRange": [
    4.495,
    4.934
   ],
   "y": 7.472,
   "peakInwardX": 2.9,
   "_notes": "Hangs 0.3 m in front of the glass; 3 gusts per 24 s, peak at 35% of each 8 s."
  },
  "arm": {
   "center": [
    -4.28,
    5.2,
    2.601
   ],
   "sizeM": [
    1.976,
    3.64
   ],
   "mountedOn": "left bookcase (X=-5.03)",
   "_notes": "Hotspot rect is partly over the glass wall in the mock; the arm stands 0.75 m off the left wall at depth 8.2 m."
  },
  "trophy": {
   "base": [
    -0.863,
    -0.684,
    0.75
   ],
   "sizeM": [
    0.207,
    0.414
   ],
   "onDeskTop": true
  },
  "phone": {
   "base": [
    -0.544,
    -0.84,
    0.75
   ],
   "sizeM": [
    0.215,
    0.162
   ],
   "onDeskTop": true
  },
  "manuscript": {
   "base": [
    0.535,
    -0.75,
    0.75
   ],
   "paperSizeM": [
    0.36,
    0.26
   ],
   "stackLiftM": 0.16,
   "onDeskTop": true,
   "_notes": "Hotspot rect includes the lift, glow and motes; paper footprint is smaller."
  },
  "lamp": {
   "base": [
    0.784,
    -0.55,
    0.74
   ],
   "_notes": "Desk lamp from the mock (light pool at stage 1170,692); warm pool on the desk."
  },
  "blotter": {
   "base": [
    0.0,
    -0.65,
    0.758
   ],
   "_notes": "Leather blotter centred in front of the chair."
  },
  "reaper": {
   "center": [
    23.538,
    82.0,
    15.995
   ],
   "wingspanM": 20,
   "depthM": 85
  },
  "bridge": {
   "origin": [
    37.154,
    712.556,
    116.277
   ],
   "metersPerStagePx": 0.6192,
   "depthM": 715.6,
   "deckAboveSeaM": 44.6,
   "_notes": "Build in mock local coordinates x metersPerStagePx; at this depth the deck is ~45 m above the sea and towers ~130 m, like the real Manhattan Bridge."
  },
  "hagiaSophia": {
   "origin": [
    -142.774,
    348.027,
    44.236
   ],
   "metersPerStagePx": 0.3038,
   "depthM": 351.0,
   "_notes": "263 stage px = ~80 m; minarets ~62 m above the sea."
  },
  "sea": {
   "z": -15.0,
   "horizonStageY": 522.0,
   "_notes": "Sea plane 16.1 m below the camera. Waterline of an object at stage y waterY sits at depth (1.1-seaZ)*1155.56/(waterY-522)."
  },
  "farCity": {
   "depthM": 6000,
   "stageX": [
    260,
    1340
   ],
   "stageY": 522
  }
 },
 "render": {
  "_notes": "Sizes in px at full quality; multiply by draftScale.value for draft. Limit/fallback copied from the plan's render budget.",
  "exterior": {
   "engine": "CYCLES",
   "device": "GPU",
   "samples": 256,
   "denoise": true,
   "w": 2816,
   "h": 1584,
   "margin": 1.1,
   "transparent": false,
   "targetMin": 3,
   "limitMin": 6,
   "fallback": "EEVEE"
  },
  "bridge": {
   "engine": "CYCLES",
   "device": "GPU",
   "samples": 256,
   "denoise": true,
   "w": 2816,
   "h": 1584,
   "margin": 1.1,
   "transparent": true,
   "targetMin": 3,
   "limitMin": 6,
   "fallback": "EEVEE"
  },
  "room": {
   "engine": "EEVEE",
   "samples": 256,
   "w": 2560,
   "h": 1440,
   "transparent": true,
   "targetMin": 1,
   "limitMin": 5,
   "fallback": "1920x1080"
  },
  "desk": {
   "engine": "EEVEE",
   "samples": 256,
   "w": 2560,
   "h": 1440,
   "region": "stageRects.deskBox",
   "transparent": true,
   "targetMin": 1,
   "limitMin": 5,
   "fallback": "1920x1080",
   "_notes": "Render the full frame with a border region = stageRects.deskBox, so the output is 2560x432 (crop_to_border)."
  },
  "litTrophy": {
   "engine": "EEVEE",
   "samples": 256,
   "w": 176,
   "h": 264,
   "region": "crops.trophyLit",
   "_notes": "Plan says about 400x400; I use the exact crop at 1.6x so pixels match the room plate.",
   "targetSec": 30,
   "limitMin": 2,
   "fallback": "CSS brightening"
  },
  "litPhone": {
   "engine": "EEVEE",
   "samples": 256,
   "w": 224,
   "h": 168,
   "region": "crops.phoneLit",
   "targetSec": 30,
   "limitMin": 2,
   "fallback": "CSS brightening"
  },
  "publicationsStack": {
   "engine": "EEVEE",
   "samples": 256,
   "frameW": 352,
   "frameH": 304,
   "frames": 16,
   "fallbackFrames": 8,
   "region": "crops.manuscriptLit",
   "targetMin": 3,
   "limitMin": 6
  },
  "reaper": {
   "engine": "CYCLES",
   "device": "GPU",
   "samples": 256,
   "w": 1395,
   "h": 558,
   "transparent": true,
   "variants": [
    "dark",
    "lit"
   ],
   "targetMin": 1,
   "limitMin": 3,
   "fallback": "EEVEE"
  },
  "ships": {
   "engine": "CYCLES",
   "device": "GPU",
   "samples": 256,
   "w": 512,
   "h": 160,
   "transparent": true,
   "count": 6,
   "pxPerMockUnit": 1.6,
   "waterlineY": 144,
   "anchorX": 256,
   "targetMin": 2,
   "limitMin": 4,
   "fallback": "mock vector shapes"
  },
  "curtain": {
   "engine": "EEVEE",
   "w": 408,
   "h": 904,
   "frames": 576,
   "fps": 24,
   "transparent": true,
   "alphaLayout": "stacked",
   "stackedH": 1808,
   "targetMin": 4,
   "limitMin": 10,
   "fallback": "12 fps then still"
  },
  "lantern": {
   "engine": "EEVEE",
   "w": 264,
   "h": 408,
   "frames": 576,
   "fps": 24,
   "targetMin": 3,
   "limitMin": 8,
   "fallback": "12 fps then still"
  },
  "arm": {
   "engine": "EEVEE",
   "w": 480,
   "h": 840,
   "frames": 351,
   "fps": 24,
   "targetMin": 3,
   "limitMin": 8,
   "fallback": "Home reaction only (frames 0..191 + home_*)"
  },
  "chair": {
   "engine": "CYCLES",
   "samples": 64,
   "region": "crops.chair",
   "frames": 312,
   "fps": 24,
   "transparent": true,
   "limitMin": 15,
   "fallback": "32 spp",
   "_notes": "Empty chair only (occupant removed 2026-11-16, room.CHAIR_OCCUPANT = False), every other collection a holdout (desk occludes the base), exterior/bridge hidden like the plate. The plate keeps the chair for shadows/reflections but hides it from camera rays. 64 spp + denoise; min_transparent_bounces = max so rays through the holdout reflection pane are never Russian-rouletted (that left a noisy alpha veil). Crop = old chair+occupant bbox over all frames (stage x 496..1107, top y 258) + 12 px, kept: it holds the empty chair at every frame; bottom 655: below ~630 the nameplate/desk cover the chair."
  },
  "ruleEngineSplit": "EEVEE for room and every solid crop (pixel match). Cycles only for separate transparent layers."
 },
 "ships": {
  "sprites": [
   {
    "id": "container",
    "lengthUnits": 304,
    "lanes": [
     "A1",
     "A2",
     "far"
    ]
   },
   {
    "id": "cruise",
    "lengthUnits": 272,
    "lanes": [
     "far"
    ],
    "_notes": "The liner on the horizon"
   },
   {
    "id": "ferry",
    "lengthUnits": 148,
    "lanes": [
     "A1",
     "A2",
     "far",
     "near"
    ]
   },
   {
    "id": "tug",
    "lengthUnits": 60,
    "lanes": [
     "A1",
     "A2",
     "near"
    ]
   },
   {
    "id": "yacht",
    "lengthUnits": 68,
    "lanes": [
     "A1",
     "A2",
     "near"
    ]
   },
   {
    "id": "launch",
    "lengthUnits": 40,
    "lanes": [
     "near"
    ]
   }
  ],
  "spriteFacing": "right (bow +x); scene.js mirrors for leftward travel",
  "stagePxFormula": "sprite px / 1.6 * laneScale; waterlineY (sprite px from top) is aligned to the lane waterline y",
  "_notes": "lengthUnits = the mock's hull length (2 x half) in stage px at scale 1. All sprites drawn at 1.6 sprite px per unit on a 512x160 canvas, hull centred at x 256, waterline at y 144 (so a 96-unit yacht mast = 154 px just fits). Container 304 units = 486 px fits."
 },
 "routes": {
  "projects": "/projects",
  "teaching": "/courses",
  "publications": "/publications",
  "awards": "/awards",
  "connect": "/contact",
  "credits": "/credits"
 },
 "hotspotToRoute": {
  "reaper": "/projects",
  "arm": "/courses",
  "manuscript": "/publications",
  "trophy": "/awards",
  "phone": "/contact"
 },
 "assets": {
  "basePath": "/scene/assets/",
  "manifest": "/scene/manifest.json",
  "hashedNamePattern": "^[a-z0-9-]+\\.[0-9a-f]{8}\\.(webp|mp4|json)$",
  "hash": "first 8 hex of sha256 over file bytes",
  "video": {
   "codec": "h264",
   "pixFmt": "yuv420p",
   "colorSpace": "bt709",
   "tags": "-colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv",
   "movflags": "+faststart",
   "crf": 22,
   "gopFrames": 24,
   "audio": false
  },
  "stills": {
   "format": "webp",
   "quality": 88,
   "alphaQuality": 100
  }
 },
 "manifestSchema": {
  "_notes": "blender/encode.py writes public/scene/manifest.json; public/scene/scene.js reads it. Every `src` is relative to assetBase. Unknown keys must be ignored by the reader.",
  "example": {
   "version": 1,
   "draft": false,
   "generated": "2026-11-16T15:30:00Z",
   "stage": {
    "w": 1600,
    "h": 900
   },
   "assetBase": "/scene/assets/",
   "loop": {
    "fps": 24,
    "frames": 576,
    "seconds": 24
   },
   "layers": [
    {
     "id": "exterior",
     "order": 1,
     "type": "still",
     "src": "exterior.1a2b3c4d.webp",
     "px": {
      "w": 2816,
      "h": 1584
     },
     "rect": {
      "x": -80,
      "y": -45,
      "w": 1760,
      "h": 990
     },
     "parallaxPx": 18,
     "hasAlpha": false
    },
    {
     "id": "room",
     "order": 5,
     "type": "still",
     "src": "room.5e6f7a8b.webp",
     "px": {
      "w": 2560,
      "h": 1440
     },
     "rect": {
      "x": 0,
      "y": 0,
      "w": 1600,
      "h": 900
     },
     "parallaxPx": 0,
     "hasAlpha": true
    },
    {
     "id": "lantern",
     "order": 7,
     "type": "video",
     "src": "lantern.9c0d1e2f.mp4",
     "poster": "lantern-poster.3a4b5c6d.webp",
     "px": {
      "w": 264,
      "h": 408
     },
     "rect": {
      "x": 380,
      "y": 80,
      "w": 165,
      "h": 255
     },
     "parallaxPx": 0,
     "video": {
      "fps": 24,
      "frames": 576,
      "loop": true,
      "colorSpace": "bt709"
     },
     "mask": {
      "featherStagePx": 6
     }
    },
    {
     "id": "curtain",
     "order": 6,
     "type": "alphaVideo",
     "src": "curtain.7b8c9d0e.mp4",
     "px": {
      "w": 408,
      "h": 1808
     },
     "rect": {
      "x": 1095,
      "y": 90,
      "w": 255,
      "h": 565
     },
     "parallaxPx": 0,
     "video": {
      "fps": 24,
      "frames": 576,
      "loop": true,
      "colorSpace": "bt709"
     },
     "alpha": {
      "layout": "stacked",
      "colour": {
       "x": 0,
       "y": 0,
       "w": 408,
       "h": 904
      },
      "matte": {
       "x": 0,
       "y": 904,
       "w": 408,
       "h": 904
      },
      "_notes": "matte is greyscale alpha; shader: rgb=colour.rgb, a=matte.r. Colour is un-premultiplied."
     }
    },
    {
     "id": "arm",
     "order": 8,
     "type": "video",
     "src": "arm.1f2e3d4c.mp4",
     "px": {
      "w": 480,
      "h": 840
     },
     "rect": {
      "x": 50,
      "y": 50,
      "w": 300,
      "h": 525
     },
     "parallaxPx": 0,
     "video": {
      "fps": 24,
      "frames": 351,
      "loop": false,
      "colorSpace": "bt709"
     },
     "segments": {
      "work": {
       "startS": 0,
       "endS": 8.0,
       "loop": true
      },
      "home_startle": {
       "startS": 8.0,
       "endS": 9.0
      },
      "home_hold": {
       "startS": 9.0,
       "endS": 9.5,
       "loop": true
      },
      "home_return": {
       "startS": 9.5,
       "endS": 10.2083
      },
      "atBook_startle": {
       "startS": 10.2083,
       "endS": 11.2083
      },
      "...": "all 10 segments from constants.arm.segments, seconds = frame/24, end exclusive"
     },
     "holds": {
      "home": [
       {
        "fromS": 7.2083,
        "toS": 9.5,
        "resumeS": 1.5
       }
      ],
      "atBook": [
       {
        "fromS": 2.2083,
        "toS": 3.0,
        "resumeS": 3.0
       },
       {
        "fromS": 5.7083,
        "toS": 6.5,
        "resumeS": 6.5
       }
      ],
      "bookPulled": [
       {
        "fromS": 3.7083,
        "toS": 5.0,
        "resumeS": 5.0
       }
      ]
     }
    },
    {
     "id": "reaper",
     "order": 9,
     "type": "still",
     "variants": {
      "dark": "reaper-dark.aaaa1111.webp",
      "lit": "reaper-lit.bbbb2222.webp"
     },
     "px": {
      "w": 1395,
      "h": 558
     },
     "rect": {
      "x": 960,
      "y": 0,
      "w": 620,
      "h": 248
     },
     "parallaxPx": 0,
     "hasAlpha": true
    },
    {
     "id": "manuscript-stack",
     "order": 12,
     "hotspot": "manuscript",
     "type": "spriteSheet",
     "src": "manuscript-stack.cccc3333.webp",
     "px": {
      "w": 1408,
      "h": 1216
     },
     "rect": {
      "x": 965,
      "y": 540,
      "w": 220,
      "h": 190
     },
     "parallaxPx": 0,
     "hasAlpha": true,
     "sprite": {
      "frames": 16,
      "cols": 4,
      "rows": 4,
      "frameW": 352,
      "frameH": 304,
      "fps": 24,
      "playOnce": true
     }
    }
   ],
   "hotspots": [
    {
     "id": "reaper",
     "route": "/projects",
     "rect": {
      "x": 984,
      "y": 261,
      "w": 272,
      "h": 117
     },
     "layer": "reaper",
     "litLayer": "reaper"
    },
    "... one per constants.hotspotToRoute"
   ],
   "ships": {
    "sprites": [
     {
      "id": "tug",
      "src": "ship-tug.dddd4444.webp",
      "px": {
       "w": 512,
       "h": 160
      },
      "waterlineY": 144,
      "anchorX": 256,
      "lengthPx": 96,
      "lengthUnits": 60,
      "facing": "right"
     }
    ],
    "lanes": {
     "A1": {
      "waterlineY": 541,
      "scale": [
       0.5,
       0.54
      ],
      "behindBridge": true
     }
    },
    "pxPerUnit": 1.6
   },
   "portrait": {
    "window": {
     "x": 480,
     "y": 0,
     "w": 640,
     "h": 900
    },
    "reaper": {
     "x": 810,
     "y": 0,
     "w": 300,
     "h": 120
    }
   },
   "reduced": {
    "stillFrame": "room.5e6f7a8b.webp",
    "_notes": "Reduced motion: scene.js uses stills and poster frames; videos are not loaded."
   }
  },
  "rules": [
   "layers[] is sorted by `order` ascending (back to front).",
   "type is one of still|video|alphaVideo|spriteSheet|empty; hasAlpha defaults to false.",
   "Video times in seconds = frame/24, segments end exclusive.",
   "Sprite sheets are row-major, frame i at col=i%cols,row=floor(i/cols).",
   "`draft:true` manifests use draftScale pixel sizes; rects are identical, so scene.js needs no change.",
   "File names are name.<8hex>.ext in /scene/assets/; the manifest itself is not hashed and is served no-cache."
  ]
 }
}