@zinejs/core 0.1.0

package/dist/index.umd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.cjs","names":["#radius","#mounted","#listeners","#state","#handlers","#activeId","#start","#prev","#last","#end","#reset","#pinching","#points","#pair","#startDistance","#remove","#container","#clip","#viewport","#book","#pageLeft","#makeCanvas","#pageRight","#leaf","#leafFront","#leafBack","#leafShadow","#paint","#container","#canvas","#onContextLost","#onContextRestored","#onVisibilityChange","#gl","#buildGlResources","#clearRestoreTimer","#texCache","#blankTex","#quadVao","#gridVao","#flat","#curl","#cacheBytes","#content","#flip","#fatalHandler","#fill","#render","#flipDir","#flipT","#view","#contextLost","#restoreTimer","#fatal","#fatalFired","#flatU","#curlU","#makeVao","#gridCount","#makeBlankTexture","#resize","#drawFlip","#drawStatic","#useFlat","#drawQuad","#bindFace","#dpr","#textureFor","#evictTextures","#renderer","#container","#source","#direction","#cover","#clickToFlip","#clickZoneSize","#singlePageThreshold","#startPageOption","#buildSpreadModel","#flipDuration","#zoomEnabled","#wheelZoom","#doubleClickLevels","#maxZoom","#honorDoubleClickInFlipZone","#clickFlipDelayValue","#ready","#init","#currentPage","#startFlip","#current","#spreadIndexForPage","#scale","#tx","#ty","#clampPan","#emitter","#destroyed","#raf","#clearPendingClickFlip","#resizeObserver","#a11yCleanup","#unbindWheel","#unbindDblClick","#unbindInput","#spreads","#machine","#leadPage","#runFlip","#resolveContent","#currentContent","#singlePage","#animateProgress","#commit","#effectiveDuration","#paintSpread","#prefetchWindow","#announce","#pinching","#pan","#press","#pendingGrab","#drag","#stageDrag","#promoteGrab","#maybeClickFlip","#cancelFlip","#clickFlipDirection","#pendingClickTimer","#pinchBaseScale","#mountWithFallback","#applySinglePage","#onDragStart","#onDragMove","#onDragEnd","#onPinchStart","#onPinchMove","#onPinchEnd","#bindWheelZoom","#bindDoubleClickZoom","#setupReducedMotion","#setupA11y","#renderCurrent","#observeResize","#fallbackToCss","#fellBack","#reducedMotion","#onKeyDown","#liveRegion","#scheduleUpdate","#updateScheduled","#getPage","#virtualizer","#urls","#preload","#decode","#cache"],"sources":["../src/engine/spread.ts","../src/engine/virtualizer.ts","../src/engine/emitter.ts","../src/engine/stateMachine.ts","../src/engine/input.ts","../src/geometry/hitTest.ts","../src/geometry/flipProgressToPose.ts","../src/renderer/cssRenderer.ts","../src/renderer/gl/context.ts","../src/renderer/gl/program.ts","../src/renderer/gl/texture.ts","../src/renderer/webglRenderer.ts","../src/renderer/select.ts","../src/zine.ts","../src/source/imageSource.ts"],"sourcesContent":["export type Direction = 'ltr' | 'rtl';\n\nexport interface Spread {\n  /** Page index shown on the left, or null for a blank side. */\n  left: number | null;\n  /** Page index shown on the right, or null for a blank side. */\n  right: number | null;\n}\n\nexport interface SpreadOptions {\n  direction?: Direction;\n  /** First page is a lone cover on the leading side; interior pages pair up after it. */\n  cover?: boolean;\n  /** One page per spread (narrow/portrait viewports). Takes precedence over `cover`. */\n  singlePage?: boolean;\n}\n\n/**\n * Map a flat page list (indices 0..pageCount-1) into display spreads.\n *\n * Reading order is always preserved; `direction` only mirrors each spread's\n * left/right positions, so RTL is just an LTR layout with the sides swapped.\n * Out-of-range slots are `null` (a blank half on odd counts / the back cover).\n */\nexport function buildSpreads(pageCount: number, options: SpreadOptions = {}): Spread[] {\n  const { direction = 'ltr', cover = false, singlePage = false } = options;\n  if (pageCount <= 0) return [];\n\n  const page = (i: number): number | null => (i >= 0 && i < pageCount ? i : null);\n  const spreads: Spread[] = [];\n\n  if (singlePage) {\n    for (let i = 0; i < pageCount; i++) {\n      spreads.push({ left: null, right: i });\n    }\n  } else if (cover) {\n    spreads.push({ left: null, right: 0 });\n    for (let i = 1; i < pageCount; i += 2) {\n      spreads.push({ left: page(i), right: page(i + 1) });\n    }\n  } else {\n    for (let i = 0; i < pageCount; i += 2) {\n      spreads.push({ left: page(i), right: page(i + 1) });\n    }\n  }\n\n  return direction === 'rtl'\n    ? spreads.map((s) => ({ left: s.right, right: s.left }))\n    : spreads;\n}\n\n/** Whether a container this wide should fall back to one page per spread. */\nexport function shouldSinglePage(containerWidth: number, threshold: number): boolean {\n  return containerWidth < threshold;\n}\n","/** Spread indices that should be mounted around `current`, clamped to the book. */\nexport function mountWindow(current: number, spreadCount: number, radius: number): number[] {\n  const window: number[] = [];\n  const from = Math.max(0, current - radius);\n  const to = Math.min(spreadCount - 1, current + radius);\n  for (let i = from; i <= to; i++) {\n    window.push(i);\n  }\n  return window;\n}\n\nexport interface VirtualizerDelta {\n  toMount: number[];\n  toEvict: number[];\n}\n\n/**\n * Tracks which spreads are mounted and, on each move, reports the difference:\n * spreads entering the ±radius window (`toMount`) and those leaving it\n * (`toEvict`). Default radius 2 = current spread ±2.\n */\nexport class Virtualizer {\n  #radius: number;\n  #mounted = new Set<number>();\n\n  constructor(radius = 2) {\n    this.#radius = radius;\n  }\n\n  get mounted(): number[] {\n    return [...this.#mounted].sort((a, b) => a - b);\n  }\n\n  /** Recenter on `current`; mounts/evicts to match the window and returns the delta. */\n  update(current: number, spreadCount: number): VirtualizerDelta {\n    const window = new Set(mountWindow(current, spreadCount, this.#radius));\n    const toMount = [...window].filter((i) => !this.#mounted.has(i)).sort((a, b) => a - b);\n    const toEvict = [...this.#mounted].filter((i) => !window.has(i)).sort((a, b) => a - b);\n    for (const i of toEvict) this.#mounted.delete(i);\n    for (const i of toMount) this.#mounted.add(i);\n    return { toMount, toEvict };\n  }\n}\n","export type Listener<T> = (payload: T) => void;\n\n/** Events typed as `void` are emitted with no payload argument. */\ntype PayloadArgs<T> = [T] extends [void] ? [] : [payload: T];\n\n/** Minimal typed event emitter keyed by an event map. */\nexport class Emitter<Events> {\n  #listeners = new Map<keyof Events, Set<Listener<unknown>>>();\n\n  /** Subscribe; returns an unsubscribe function. */\n  on<K extends keyof Events>(type: K, listener: Listener<Events[K]>): () => void {\n    let set = this.#listeners.get(type);\n    if (!set) {\n      set = new Set();\n      this.#listeners.set(type, set);\n    }\n    set.add(listener as Listener<unknown>);\n    return () => this.off(type, listener);\n  }\n\n  off<K extends keyof Events>(type: K, listener: Listener<Events[K]>): void {\n    this.#listeners.get(type)?.delete(listener as Listener<unknown>);\n  }\n\n  emit<K extends keyof Events>(type: K, ...args: PayloadArgs<Events[K]>): void {\n    const payload = args[0] as Events[K];\n    // Copy so a listener that unsubscribes mid-emit doesn't disturb iteration.\n    const set = this.#listeners.get(type);\n    if (!set) return;\n    for (const listener of [...set]) {\n      (listener as Listener<Events[K]>)(payload);\n    }\n  }\n\n  clear(): void {\n    this.#listeners.clear();\n  }\n}\n\n/**\n * Public event surface of a Zine instance. Payloads are provisional and will\n * firm up as the engine wires the emitters that fire them.\n */\nexport interface ZineEventMap {\n  ready: void;\n  flipStart: { from: number; to: number };\n  flipEnd: { page: number };\n  pageChanged: { page: number };\n  zoomChanged: { scale: number };\n  sourceError: { index: number; error: unknown };\n  rendererFallback: { from: string; to: string };\n}\n\nexport type ZineEmitter = Emitter<ZineEventMap>;\n","export type FlipState = 'idle' | 'dragging' | 'animating' | 'zoomed-panning';\n\nexport type FlipEvent = 'grab' | 'release' | 'settle' | 'panStart' | 'panEnd' | 'flip';\n\n/**\n * Legal transitions. A flip drag runs idle → dragging → animating → idle; a\n * programmatic flip jumps idle → animating directly via `flip`; zoom panning\n * (only reachable when zoomed in) is a separate branch idle → zoomed-panning →\n * idle. Any (state, event) pair absent here is illegal.\n */\nconst TRANSITIONS: Record<FlipState, Partial<Record<FlipEvent, FlipState>>> = {\n  idle: { grab: 'dragging', panStart: 'zoomed-panning', flip: 'animating' },\n  dragging: { release: 'animating' },\n  animating: { settle: 'idle' },\n  'zoomed-panning': { panEnd: 'idle' },\n};\n\n/** Pure transition: the next state, or null if `event` is illegal from `state`. */\nexport function nextState(state: FlipState, event: FlipEvent): FlipState | null {\n  return TRANSITIONS[state][event] ?? null;\n}\n\n/** Stateful holder around `nextState`; illegal events are ignored. */\nexport class FlipMachine {\n  #state: FlipState;\n\n  constructor(initial: FlipState = 'idle') {\n    this.#state = initial;\n  }\n\n  get state(): FlipState {\n    return this.#state;\n  }\n\n  /** Apply `event`; returns the new state, or null (no-op) if the event was illegal. */\n  send(event: FlipEvent): FlipState | null {\n    const next = nextState(this.#state, event);\n    if (next !== null) {\n      this.#state = next;\n    }\n    return next;\n  }\n}\n","export interface GestureStart {\n  x: number;\n  y: number;\n  t: number;\n}\n\nexport interface GestureMove {\n  x: number;\n  y: number;\n  /** Displacement from the start point. */\n  dx: number;\n  dy: number;\n}\n\nexport interface GestureEnd {\n  x: number;\n  y: number;\n  dx: number;\n  dy: number;\n  /** Elapsed time from start to end (ms). */\n  dt: number;\n  /** Velocity of the final move segment (px/ms). */\n  vx: number;\n  vy: number;\n  /** A fast flick: final speed exceeded the swipe threshold and the gesture was not canceled. */\n  swipe: boolean;\n  /** The pointer was canceled (e.g. pointercancel) rather than lifted. */\n  canceled: boolean;\n}\n\nexport interface PointerHandlers {\n  onStart?: (g: GestureStart) => void;\n  onMove?: (g: GestureMove) => void;\n  onEnd?: (g: GestureEnd) => void;\n}\n\n/** Flick threshold in px/ms; a release faster than this is a swipe. */\nconst SWIPE_VELOCITY = 0.3;\n\ninterface Sample {\n  x: number;\n  y: number;\n  t: number;\n}\n\n/**\n * Recognizes a single-pointer drag from raw pointer samples and reports normalized\n * gestures. DOM-agnostic on purpose: `bindPointerInput` maps real PointerEvents onto\n * it, but the kinematics stay pure and unit-testable. Extra pointers are ignored\n * (multi-touch pinch is a separate recognizer).\n */\nexport class PointerRecognizer {\n  #handlers: PointerHandlers;\n  #activeId: number | null = null;\n  #start: Sample | null = null;\n  #prev: Sample | null = null;\n  #last: Sample | null = null;\n\n  constructor(handlers: PointerHandlers = {}) {\n    this.#handlers = handlers;\n  }\n\n  get active(): boolean {\n    return this.#activeId !== null;\n  }\n\n  down(id: number, x: number, y: number, t: number): void {\n    if (this.#activeId !== null) return; // single-pointer; ignore extra pointers\n    this.#activeId = id;\n    const s: Sample = { x, y, t };\n    this.#start = s;\n    this.#prev = s;\n    this.#last = s;\n    this.#handlers.onStart?.({ x, y, t });\n  }\n\n  move(id: number, x: number, y: number, t: number): void {\n    if (id !== this.#activeId || this.#start === null) return;\n    this.#prev = this.#last;\n    this.#last = { x, y, t };\n    this.#handlers.onMove?.({ x, y, dx: x - this.#start.x, dy: y - this.#start.y });\n  }\n\n  up(id: number, x: number, y: number, t: number): void {\n    this.#end(id, x, y, t, false);\n  }\n\n  cancel(id: number, x: number, y: number, t: number): void {\n    this.#end(id, x, y, t, true);\n  }\n\n  #end(id: number, x: number, y: number, t: number, canceled: boolean): void {\n    if (id !== this.#activeId || this.#start === null) return;\n    const start = this.#start;\n    // Velocity comes from the last move segment, not the release point — on lift the\n    // pointer usually stops, so release-relative velocity would kill every flick.\n    const last = this.#last ?? start;\n    const prev = this.#prev ?? start;\n    const segDt = last.t - prev.t;\n    const vx = segDt > 0 ? (last.x - prev.x) / segDt : 0;\n    const vy = segDt > 0 ? (last.y - prev.y) / segDt : 0;\n    const speed = Math.hypot(vx, vy);\n    this.#reset();\n    this.#handlers.onEnd?.({\n      x,\n      y,\n      dx: x - start.x,\n      dy: y - start.y,\n      dt: t - start.t,\n      vx,\n      vy,\n      swipe: !canceled && speed > SWIPE_VELOCITY,\n      canceled,\n    });\n  }\n\n  #reset(): void {\n    this.#activeId = null;\n    this.#start = null;\n    this.#prev = null;\n    this.#last = null;\n  }\n}\n\n/**\n * Wire real PointerEvents from `target` into a recognizer. Returns an unbind\n * function that removes every listener. Coordinates are passed through as\n * client-space; mapping to page-local space is the engine's job.\n */\nexport function bindPointerInput(target: EventTarget, recognizer: PointerRecognizer): () => void {\n  const down = (e: Event): void => {\n    const p = e as PointerEvent;\n    recognizer.down(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n  };\n  const move = (e: Event): void => {\n    const p = e as PointerEvent;\n    recognizer.move(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n  };\n  const up = (e: Event): void => {\n    const p = e as PointerEvent;\n    recognizer.up(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n  };\n  const cancel = (e: Event): void => {\n    const p = e as PointerEvent;\n    recognizer.cancel(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n  };\n  target.addEventListener('pointerdown', down);\n  target.addEventListener('pointermove', move);\n  target.addEventListener('pointerup', up);\n  target.addEventListener('pointercancel', cancel);\n  return () => {\n    target.removeEventListener('pointerdown', down);\n    target.removeEventListener('pointermove', move);\n    target.removeEventListener('pointerup', up);\n    target.removeEventListener('pointercancel', cancel);\n  };\n}\n\n/**\n * Wire PointerEvents from `target` into a drag recognizer and/or a pinch\n * recognizer at once, so a single pointer stream feeds both. Returns an unbind.\n */\nexport function bindGestures(\n  target: EventTarget,\n  recognizers: { pointer?: PointerRecognizer; pinch?: PinchRecognizer },\n): () => void {\n  const { pointer, pinch } = recognizers;\n  const down = (e: Event): void => {\n    const p = e as PointerEvent;\n    pointer?.down(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n    pinch?.down(p.pointerId, p.clientX, p.clientY);\n  };\n  const move = (e: Event): void => {\n    const p = e as PointerEvent;\n    pointer?.move(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n    pinch?.move(p.pointerId, p.clientX, p.clientY);\n  };\n  const up = (e: Event): void => {\n    const p = e as PointerEvent;\n    pointer?.up(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n    pinch?.up(p.pointerId);\n  };\n  const cancel = (e: Event): void => {\n    const p = e as PointerEvent;\n    pointer?.cancel(p.pointerId, p.clientX, p.clientY, p.timeStamp);\n    pinch?.cancel(p.pointerId);\n  };\n  target.addEventListener('pointerdown', down);\n  target.addEventListener('pointermove', move);\n  target.addEventListener('pointerup', up);\n  target.addEventListener('pointercancel', cancel);\n  return () => {\n    target.removeEventListener('pointerdown', down);\n    target.removeEventListener('pointermove', move);\n    target.removeEventListener('pointerup', up);\n    target.removeEventListener('pointercancel', cancel);\n  };\n}\n\nexport interface PinchStart {\n  centerX: number;\n  centerY: number;\n  /** Distance between the two pointers at pinch start. */\n  distance: number;\n}\n\nexport interface PinchMove {\n  centerX: number;\n  centerY: number;\n  /** Current distance / start distance. */\n  scale: number;\n}\n\nexport interface PinchHandlers {\n  onPinchStart?: (g: PinchStart) => void;\n  onPinchMove?: (g: PinchMove) => void;\n  onPinchEnd?: () => void;\n}\n\ninterface Pt {\n  x: number;\n  y: number;\n}\n\nfunction distance(a: Pt, b: Pt): number {\n  return Math.hypot(a.x - b.x, a.y - b.y);\n}\n\n/**\n * Recognizes a two-pointer pinch and reports zoom scale (relative to the start\n * distance) and the live center point. No timestamps: pinch drives zoom, not a\n * flick. A third pointer is ignored; lifting either tracked pointer ends the pinch.\n * Coordinating this with the drag recognizer (a second finger should suspend a\n * single-finger drag) is the engine's job.\n */\nexport class PinchRecognizer {\n  #handlers: PinchHandlers;\n  #points = new Map<number, Pt>();\n  #startDistance = 0;\n  #pinching = false;\n\n  constructor(handlers: PinchHandlers = {}) {\n    this.#handlers = handlers;\n  }\n\n  get pinching(): boolean {\n    return this.#pinching;\n  }\n\n  down(id: number, x: number, y: number): void {\n    if (this.#points.has(id) || this.#points.size >= 2) return; // track only two\n    this.#points.set(id, { x, y });\n    if (this.#points.size === 2) {\n      const { a, b } = this.#pair();\n      this.#startDistance = distance(a, b);\n      this.#pinching = true;\n      this.#handlers.onPinchStart?.({\n        centerX: (a.x + b.x) / 2,\n        centerY: (a.y + b.y) / 2,\n        distance: this.#startDistance,\n      });\n    }\n  }\n\n  move(id: number, x: number, y: number): void {\n    const p = this.#points.get(id);\n    if (!p) return;\n    p.x = x;\n    p.y = y;\n    if (!this.#pinching) return;\n    const { a, b } = this.#pair();\n    this.#handlers.onPinchMove?.({\n      centerX: (a.x + b.x) / 2,\n      centerY: (a.y + b.y) / 2,\n      scale: this.#startDistance > 0 ? distance(a, b) / this.#startDistance : 1,\n    });\n  }\n\n  up(id: number): void {\n    this.#remove(id);\n  }\n\n  cancel(id: number): void {\n    this.#remove(id);\n  }\n\n  #remove(id: number): void {\n    if (!this.#points.delete(id)) return;\n    if (this.#pinching && this.#points.size < 2) {\n      this.#pinching = false;\n      this.#startDistance = 0;\n      this.#handlers.onPinchEnd?.();\n    }\n  }\n\n  #pair(): { a: Pt; b: Pt } {\n    const values = [...this.#points.values()];\n    const a = values[0];\n    const b = values[1];\n    if (!a || !b) throw new Error('pinch requires two active pointers');\n    return { a, b };\n  }\n}\n","import type { PageRect, Vec2 } from './foldFromPointer';\n\nexport type HitRegion = 'corner' | 'page' | 'outside';\n\n/**\n * Classify a page-local point into a hit region.\n *\n * Coordinates are page-local (see `foldFromPointer`): (0,0) top-left,\n * page spanning (0,0)..(width,height). `cornerSize` is the width/height of each\n * grabbable corner box. All four corners report `corner`; the engine decides\n * which are actually grabbable for the current spread layout (LTR/RTL, cover).\n */\nexport function hitTest(point: Vec2, pageRect: PageRect, cornerSize: number): HitRegion {\n  const { width, height } = pageRect;\n  if (point.x < 0 || point.x > width || point.y < 0 || point.y > height) {\n    return 'outside';\n  }\n  const nearX = point.x <= cornerSize || point.x >= width - cornerSize;\n  const nearY = point.y <= cornerSize || point.y >= height - cornerSize;\n  return nearX && nearY ? 'corner' : 'page';\n}\n","export interface FlipPose {\n  /** Turning-page rotation about the spine, radians: 0 (flat/open) → π (fully turned). */\n  angle: number;\n  /** Mesh cylinder-wrap curl, 0..1 — flat at the ends, peaks edge-on at t=0.5. CSS renderer ignores it. */\n  curl: number;\n  /** Fold-shadow intensity, 0..1 — peaks edge-on at t=0.5. */\n  shadowAlpha: number;\n}\n\n/**\n * Map a 0→1 flip progress to a renderer-neutral fold pose.\n *\n * Linear in `t` on purpose — easing belongs to the animator that produces `t`,\n * so seeking to a fixed progress (e.g. the 0/.25/.5/.75/1 visual-regression stops)\n * is deterministic. The CSS renderer consumes `angle` as a spine `rotateY`; the\n * WebGL2 renderer additionally bends its mesh by `curl`.\n */\nexport function flipProgressToPose(t: number): FlipPose {\n  const clamped = t < 0 ? 0 : t > 1 ? 1 : t;\n  const arc = Math.sin(clamped * Math.PI);\n  return {\n    angle: clamped * Math.PI,\n    curl: arc,\n    shadowAlpha: arc,\n  };\n}\n","import { flipProgressToPose } from '../geometry/flipProgressToPose';\nimport type { Spread } from '../engine/spread';\nimport type {\n  FlipDirection,\n  LayoutMetrics,\n  PageContent,\n  Renderer,\n  RenderOptions,\n  SpreadContent,\n} from './types';\n\nconst RAD_TO_DEG = 180 / Math.PI;\n\n/**\n * Layered gradients painted over the turning leaf to fake paper depth on the flat\n * fold: a crease shadow at the spine, a soft curve sheen, and a free-edge shade.\n * The spine is the leaf's pivot edge — left for a forward flip, right for backward.\n */\nfunction foldOverlay(direction: FlipDirection): string {\n  const dir = direction === 'forward' ? 'to right' : 'to left';\n  return [\n    `linear-gradient(${dir}, rgba(0,0,0,0.6), rgba(0,0,0,0.15) 40%, rgba(0,0,0,0) 60%)`,\n    `linear-gradient(${dir}, transparent 40%, rgba(255,255,255,0.32) 66%, transparent 90%)`,\n    `linear-gradient(${dir}, transparent 66%, rgba(0,0,0,0.35))`,\n  ].join(',');\n}\n\n/**\n * Baseline renderer: a 2-panel CSS-3D fold. Runs on every browser, no GPU. Pages\n * are <canvas> elements; the turning leaf (front + back faces, backface-hidden)\n * rotates about the spine driven by flipProgressToPose(), with a gradient shadow\n * overlay for depth. `beginFlip` stages the surfaces; `setFlipProgress` animates.\n */\nexport class CssRenderer implements Renderer {\n  #container: HTMLElement | null = null;\n  #clip!: HTMLDivElement;\n  #viewport!: HTMLDivElement;\n  #book!: HTMLDivElement;\n  #pageLeft!: HTMLCanvasElement;\n  #pageRight!: HTMLCanvasElement;\n  #leaf!: HTMLDivElement;\n  #leafFront!: HTMLCanvasElement;\n  #leafBack!: HTMLCanvasElement;\n  #leafShadow!: HTMLDivElement;\n\n  mount(container: HTMLElement): Promise<void> {\n    const doc = container.ownerDocument;\n    this.#container = container;\n\n    // Fixed-size clip box; NOT transformed, so zoom can't scale the crop region.\n    this.#clip = doc.createElement('div');\n    this.#clip.className = 'zine-clip';\n    this.#clip.style.cssText = 'position:relative;width:100%;height:100%;overflow:hidden;';\n\n    // Transform target for zoom/pan; lives inside the clip.\n    this.#viewport = doc.createElement('div');\n    this.#viewport.className = 'zine-viewport';\n    this.#viewport.style.cssText = 'position:absolute;inset:0;transform-origin:0 0;';\n\n    this.#book = doc.createElement('div');\n    this.#book.className = 'zine-book';\n    this.#book.style.cssText =\n      'position:absolute;inset:0;perspective:2000px;transform-style:preserve-3d;';\n\n    this.#pageLeft = this.#makeCanvas(doc, 'zine-page-left', 'left:0;');\n    this.#pageRight = this.#makeCanvas(doc, 'zine-page-right', 'right:0;');\n\n    this.#leaf = doc.createElement('div');\n    this.#leaf.className = 'zine-leaf';\n    this.#leaf.style.cssText =\n      'position:absolute;top:0;width:50%;height:100%;transform-style:preserve-3d;display:none;';\n\n    this.#leafFront = doc.createElement('canvas');\n    this.#leafFront.className = 'zine-leaf-front';\n    this.#leafFront.style.cssText =\n      'position:absolute;inset:0;width:100%;height:100%;backface-visibility:hidden;';\n\n    this.#leafBack = doc.createElement('canvas');\n    this.#leafBack.className = 'zine-leaf-back';\n    this.#leafBack.style.cssText =\n      'position:absolute;inset:0;width:100%;height:100%;backface-visibility:hidden;transform:rotateY(180deg);';\n\n    this.#leafShadow = doc.createElement('div');\n    this.#leafShadow.className = 'zine-leaf-shadow';\n    this.#leafShadow.style.cssText = 'position:absolute;inset:0;opacity:0;pointer-events:none;';\n    this.#leafShadow.style.background = foldOverlay('forward'); // default; beginFlip sets per direction\n\n    this.#leaf.append(this.#leafFront, this.#leafBack, this.#leafShadow);\n    this.#book.append(this.#pageLeft, this.#pageRight, this.#leaf);\n    this.#viewport.append(this.#book);\n    this.#clip.append(this.#viewport);\n    container.append(this.#clip);\n\n    return Promise.resolve();\n  }\n\n  destroy(): void {\n    this.#clip?.remove();\n    this.#container = null;\n  }\n\n  renderSpread(_spread: Spread, content: SpreadContent, options?: RenderOptions): void {\n    if (options?.fill) {\n      // Single-page mode: the lone page fills the container; hide the other panel.\n      this.#pageLeft.style.width = '100%';\n      this.#pageRight.style.display = 'none';\n      this.#paint(this.#pageLeft, content.right ?? content.left);\n    } else {\n      this.#pageLeft.style.width = '50%';\n      this.#pageRight.style.display = '';\n      this.#paint(this.#pageLeft, content.left);\n      this.#paint(this.#pageRight, content.right);\n    }\n    // A fresh spread cancels any in-progress flip.\n    this.#leaf.style.display = 'none';\n    this.#leaf.style.transform = '';\n    this.#leafShadow.style.opacity = '0';\n  }\n\n  beginFlip(\n    from: SpreadContent,\n    to: SpreadContent,\n    direction: FlipDirection,\n    options?: RenderOptions,\n  ): void {\n    if (options?.fill) {\n      // Single-page: a full-width leaf turns about one edge, revealing `to` underneath.\n      this.#pageLeft.style.width = '100%';\n      this.#pageRight.style.display = 'none';\n      this.#leaf.style.width = '100%';\n      this.#leaf.style.left = '0';\n      this.#leaf.style.transformOrigin = direction === 'forward' ? 'left center' : 'right center';\n      this.#paint(this.#pageLeft, to.right ?? to.left);\n      this.#paint(this.#leafFront, from.right ?? from.left);\n      this.#paint(this.#leafBack, to.right ?? to.left);\n    } else {\n      this.#pageLeft.style.width = '50%';\n      this.#pageRight.style.display = '';\n      this.#leaf.style.width = '50%';\n      if (direction === 'forward') {\n        // Right page lifts and swings left about the spine. Left stays; right reveals `to`.\n        this.#paint(this.#pageLeft, from.left);\n        this.#paint(this.#pageRight, to.right);\n        this.#paint(this.#leafFront, from.right);\n        this.#paint(this.#leafBack, to.left);\n        this.#leaf.style.left = '50%';\n        this.#leaf.style.transformOrigin = 'left center';\n      } else {\n        // Left page swings right about its right edge. Right stays; left reveals `to`.\n        this.#paint(this.#pageRight, from.right);\n        this.#paint(this.#pageLeft, to.left);\n        this.#paint(this.#leafFront, from.left);\n        this.#paint(this.#leafBack, to.right);\n        this.#leaf.style.left = '0';\n        this.#leaf.style.transformOrigin = 'right center';\n      }\n    }\n    this.#leaf.style.display = 'block';\n    this.#leaf.style.transform = 'rotateY(0deg)';\n    this.#leafShadow.style.background = foldOverlay(direction);\n    this.#leafShadow.style.opacity = '0';\n  }\n\n  setFlipProgress(t: number, direction: FlipDirection): void {\n    const pose = flipProgressToPose(t);\n    const deg = pose.angle * RAD_TO_DEG;\n    this.#leaf.style.display = 'block';\n    this.#leaf.style.transform = `rotateY(${direction === 'forward' ? -deg : deg}deg)`;\n    this.#leafShadow.style.opacity = String(pose.shadowAlpha);\n  }\n\n  setViewTransform(scale: number, x: number, y: number): void {\n    this.#viewport.style.transform = `translate(${x}px, ${y}px) scale(${scale})`;\n  }\n\n  measure(): LayoutMetrics {\n    const el = this.#container;\n    const w = el?.clientWidth ?? 0;\n    const h = el?.clientHeight ?? 0;\n    return { containerWidth: w, containerHeight: h, pageWidth: w / 2, pageHeight: h };\n  }\n\n  #makeCanvas(doc: Document, className: string, extra: string): HTMLCanvasElement {\n    const c = doc.createElement('canvas');\n    c.className = className;\n    c.style.cssText = `position:absolute;top:0;width:50%;height:100%;${extra}`;\n    return c;\n  }\n\n  #paint(canvas: HTMLCanvasElement, content: PageContent | null): void {\n    const ctx = canvas.getContext('2d');\n    if (content === null) {\n      ctx?.clearRect(0, 0, canvas.width, canvas.height);\n      return;\n    }\n    canvas.width = content.width;\n    canvas.height = content.height;\n    ctx?.drawImage(content, 0, 0);\n  }\n}\n","/** Create a WebGL2 context, or throw so the caller can fall back to CSS (§8.4). */\nexport function createGlContext(canvas: HTMLCanvasElement): WebGL2RenderingContext {\n  const gl = canvas.getContext('webgl2', {\n    alpha: true,\n    premultipliedAlpha: true,\n    antialias: true,\n    depth: false,\n    stencil: false,\n    // We render on demand (not every frame), so the buffer must persist between\n    // composites — otherwise the settled page flickers once the flip animation\n    // stops and nothing is redrawing each frame.\n    preserveDrawingBuffer: true,\n  });\n  if (gl === null) {\n    throw new Error('WebglRenderer: could not create a WebGL2 context.');\n  }\n  return gl;\n}\n","/** Compile + link a shader program; throws with the driver log on failure. */\nexport function createProgram(\n  gl: WebGL2RenderingContext,\n  vertexSrc: string,\n  fragmentSrc: string,\n): WebGLProgram {\n  const program = gl.createProgram();\n  if (program === null) throw new Error('WebglRenderer: could not create a program.');\n\n  const vs = compileShader(gl, gl.VERTEX_SHADER, vertexSrc);\n  const fs = compileShader(gl, gl.FRAGMENT_SHADER, fragmentSrc);\n  gl.attachShader(program, vs);\n  gl.attachShader(program, fs);\n  gl.linkProgram(program);\n\n  // Shaders can be detached/deleted once linked.\n  gl.deleteShader(vs);\n  gl.deleteShader(fs);\n\n  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {\n    const log = gl.getProgramInfoLog(program);\n    gl.deleteProgram(program);\n    throw new Error(`WebglRenderer: program link failed: ${log ?? 'unknown error'}`);\n  }\n  return program;\n}\n\nfunction compileShader(gl: WebGL2RenderingContext, type: number, src: string): WebGLShader {\n  const shader = gl.createShader(type);\n  if (shader === null) throw new Error('WebglRenderer: could not create a shader.');\n  gl.shaderSource(shader, src);\n  gl.compileShader(shader);\n  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {\n    const log = gl.getShaderInfoLog(shader);\n    gl.deleteShader(shader);\n    throw new Error(`WebglRenderer: shader compile failed: ${log ?? 'unknown error'}`);\n  }\n  return shader;\n}\n","/** Create a page texture with clamp + linear filtering (no mipmaps — §8.3). */\nexport function createTexture(gl: WebGL2RenderingContext): WebGLTexture {\n  const tex = gl.createTexture();\n  if (tex === null) throw new Error('WebglRenderer: could not create a texture.');\n  gl.bindTexture(gl.TEXTURE_2D, tex);\n  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);\n  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);\n  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);\n  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);\n  return tex;\n}\n\n/** Upload a decoded page raster (ImageBitmap or canvas) into `tex`. */\nexport function uploadTexture(\n  gl: WebGL2RenderingContext,\n  tex: WebGLTexture,\n  source: TexImageSource,\n): void {\n  gl.bindTexture(gl.TEXTURE_2D, tex);\n  // No Y flip: the vertex shader maps aUnit.y=0 to the page top and samples the\n  // source's top row there. UNPACK_FLIP_Y is honored for <canvas> sources but\n  // IGNORED for ImageBitmap, so flipping would invert PDF (canvas) pages while\n  // leaving image (ImageBitmap) pages upright. Off keeps both consistent.\n  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);\n  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);\n  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);\n}\n","import { flipProgressToPose } from '../geometry/flipProgressToPose';\nimport type { Spread } from '../engine/spread';\nimport type {\n  FlipDirection,\n  LayoutMetrics,\n  Renderer,\n  RenderOptions,\n  SpreadContent,\n} from './types';\nimport { createGlContext } from './gl/context';\nimport { createProgram } from './gl/program';\nimport { createTexture, uploadTexture } from './gl/texture';\n\n// Flat program: maps a unit quad to a page rect (device px, top-left origin) with\n// zoom/pan. aUnit.y=0 is the page top and samples the source's top row (no flip).\nconst FLAT_VERT = `#version 300 es\nin vec2 aUnit;\nuniform vec2 uViewport;\nuniform vec4 uRect;\nuniform vec3 uView;\nout vec2 vUv;\nvoid main() {\n  vec2 px = uRect.xy + aUnit * uRect.zw;\n  px = px * uView.x + uView.yz;\n  vec2 clip = px / uViewport * 2.0 - 1.0;\n  gl_Position = vec4(clip.x, -clip.y, 0.0, 1.0);\n  vUv = aUnit;\n}`;\n\nconst FLAT_FRAG = `#version 300 es\nprecision mediump float;\nin vec2 vUv;\nuniform sampler2D uTex;\nuniform float uGutterSide; // +1 = spine at the right edge, -1 = at the left edge, 0 = none\nout vec4 outColor;\nvoid main() {\n  vec4 c = texture(uTex, vUv);\n  if (uGutterSide != 0.0) {\n    // Soft, permanent gutter shadow: darken toward the spine edge where the pages\n    // meet, so the turning leaf's spine shadow lands into it instead of vanishing.\n    float d = uGutterSide > 0.0 ? (1.0 - vUv.x) : vUv.x;\n    c.rgb *= mix(0.72, 1.0, smoothstep(0.0, 0.10, d));\n  }\n  outColor = c;\n}`;\n\n// Curl program: the turning leaf. u runs from the spine (0) to the free edge (1).\n// The page wraps around a vertical cylinder (radius shrinks with uCurl) and rotates\n// about the spine by uAngle; orthographic (no perspective yet).\nconst CURL_VERT = `#version 300 es\nin vec2 aUnit;\nuniform vec2 uViewport;\nuniform vec4 uLeaf;   // spineX, y, width, height (device px)\nuniform vec3 uView;   // scale, tx, ty\nuniform float uAngle; // spine rotation 0..PI\nuniform float uCurl;  // 0..1 bend amount\nuniform float uDir;   // +1 leaf sweeps from +x side, -1 from -x side\nout vec2 vUv;\nout float vU;\nout float vLight; // surface facing: +1 toward viewer, 0 edge-on, -1 away\nconst float CAM = 3.0; // perspective camera distance, in page widths (bigger = subtler)\nvoid main() {\n  float u = aUnit.x;\n  float W = uLeaf.z;\n  // Cylinder wrap of the turning sheet, rotated about the spine (vertical y axis).\n  float bend = uCurl * 1.5;\n  float phi, xw, zw;\n  if (bend > 0.001) {\n    float R = W / bend;\n    phi = u * bend;\n    xw = R * sin(phi);\n    zw = R * (1.0 - cos(phi));\n  } else {\n    phi = 0.0;\n    xw = u * W;\n    zw = 0.0;\n  }\n  float X = xw * cos(uAngle) - zw * sin(uAngle); // in-plane\n  float Z = xw * sin(uAngle) + zw * cos(uAngle); // depth (+ toward viewer)\n  float px = uLeaf.x + uDir * X;\n  float py = uLeaf.y + aUnit.y * uLeaf.w;\n  // Perspective by depth. X may bulge toward the viewer for 3D pop; Y only ever\n  // SHRINKS (persp clamped <= 1) about the page's own vertical center, so the top\n  // is never pushed past the frame (that was the hidden-top bug).\n  float D = W * CAM;\n  float persp = D / max(D - Z, 1.0);\n  float cx = uViewport.x * 0.5;\n  float cy = uLeaf.y + 0.5 * uLeaf.w;\n  px = cx + (px - cx) * persp;\n  py = cy + (py - cy) * min(persp, 1.0);\n  vec2 p = vec2(px, py) * uView.x + uView.yz;\n  vec2 clip = p / uViewport * 2.0 - 1.0;\n  gl_Position = vec4(clip.x, -clip.y, 0.0, 1.0);\n  vUv = aUnit;\n  vU = u;\n  vLight = cos(phi + uAngle);\n}`;\n\n// Per-fragment facing: whichever side of the curling sheet faces the viewer shows\n// its own page, so mid-curl you see a sliver of the next page (continuous handoff).\nconst CURL_FRAG = `#version 300 es\nprecision mediump float;\nin vec2 vUv;\nin float vU;\nin float vLight;\nuniform sampler2D uFront;\nuniform sampler2D uBack;\nuniform highp float uDir; // must match the vertex stage's default highp\nout vec4 outColor;\nvoid main() {\n  // A backward flip (uDir < 0) mirrors the mesh horizontally, which flips both the\n  // projected winding (gl_FrontFacing) and the page's u->x mapping; undo both here.\n  float fx = uDir > 0.0 ? vUv.x : 1.0 - vUv.x;\n  // Front/back from the sheet's smooth facing (vLight), NOT gl_FrontFacing: the\n  // winding-based test flickers per-pixel at grazing angles as the curl overlaps.\n  bool showFront = vLight > 0.0;\n  vec4 c = showFront ? texture(uFront, vec2(fx, vUv.y)) : texture(uBack, vec2(1.0 - fx, vUv.y));\n\n  // Diffuse curl shading from the (smooth) facing magnitude: face-on bright, edge-on dark.\n  float diff = clamp(abs(vLight), 0.0, 1.0);\n  float lit = mix(0.72, 1.0, diff);                    // ambient floor, never crushed\n  float sheen = smoothstep(0.6, 0.95, diff) * (1.0 - diff) * 0.5; // soft crest highlight\n  // Spine crease uses the SAME curve as the static gutter shadow, so when the leaf\n  // lands the shadow is continuous instead of popping away.\n  lit *= mix(0.72, 1.0, smoothstep(0.0, 0.10, vU));\n\n  c.rgb = clamp(c.rgb * lit + sheen, 0.0, 1.0);\n  outColor = c;\n}`;\n\nconst GRID_COLS = 24;\n// If a lost context is not restored within this window, give up and let the engine\n// fall back to the CSS renderer (§8.4).\nconst RESTORE_TIMEOUT_MS = 4000;\n// GPU texture LRU ceiling (§9). Page textures are cached by content and evicted\n// least-recently-used beyond this, so flips/zooms don't re-upload every frame.\nconst MAX_TEXTURE_CACHE_BYTES = 256 * 1024 * 1024;\n\ninterface Rect {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\ninterface FlipState {\n  underLeft: TexImageSource | null;\n  underRight: TexImageSource | null;\n  underFull: TexImageSource | null; // fill mode\n  front: TexImageSource | null;\n  back: TexImageSource | null;\n  dir: number; // +1 / -1 for the curl sweep\n  spineAtStart: number; // 0 = spine at left edge, 0.5 = center, 1 = right edge\n  fill: boolean;\n}\n\n/**\n * GPU renderer (WebGL2, hand-written, no third-party library). The turning leaf is\n * a grid mesh bent around a cylinder (driven by the shared flipProgressToPose), the\n * static pages are flat textured quads underneath. Restores its GL state in place on\n * context loss; if that fails it signals `onFatal` so the engine can fall back to CSS.\n */\nexport class WebglRenderer implements Renderer {\n  #container: HTMLElement | null = null;\n  #canvas: HTMLCanvasElement | null = null;\n  #gl: WebGL2RenderingContext | null = null;\n\n  #flat: WebGLProgram | null = null;\n  #curl: WebGLProgram | null = null;\n  #quadVao: WebGLVertexArrayObject | null = null;\n  #gridVao: WebGLVertexArrayObject | null = null;\n  #gridCount = 0;\n  #texCache = new Map<TexImageSource, { tex: WebGLTexture; bytes: number }>();\n  #cacheBytes = 0;\n  #blankTex: WebGLTexture | null = null; // 1x1 transparent, for blank leaf faces\n\n  #flatU: Record<string, WebGLUniformLocation | null> = {};\n  #curlU: Record<string, WebGLUniformLocation | null> = {};\n\n  #view = { scale: 1, tx: 0, ty: 0 };\n  #dpr = 1;\n  #content: SpreadContent | null = null;\n  #fill = false;\n  #flip: FlipState | null = null;\n  #flipT = 0;\n  #flipDir: FlipDirection = 'forward';\n\n  #contextLost = false;\n  #fatalFired = false;\n  #restoreTimer: ReturnType<typeof setTimeout> | null = null;\n  #fatalHandler: (() => void) | null = null;\n\n  mount(container: HTMLElement): Promise<void> {\n    this.#container = container;\n    const doc = container.ownerDocument;\n    const canvas = doc.createElement('canvas');\n    // Fill the container as a plain block, so it doesn't depend on the container\n    // being positioned (an absolute canvas would escape a static container).\n    canvas.style.cssText = 'display:block;width:100%;height:100%;';\n    container.append(canvas);\n    this.#canvas = canvas;\n\n    canvas.addEventListener('webglcontextlost', this.#onContextLost as EventListener);\n    canvas.addEventListener('webglcontextrestored', this.#onContextRestored as EventListener);\n    doc.addEventListener('visibilitychange', this.#onVisibilityChange);\n\n    this.#gl = createGlContext(canvas); // throws if unavailable -> engine falls back (§8.4)\n    this.#buildGlResources();\n\n    return Promise.resolve();\n  }\n\n  destroy(): void {\n    this.#clearRestoreTimer();\n    const canvas = this.#canvas;\n    if (canvas !== null) {\n      canvas.removeEventListener('webglcontextlost', this.#onContextLost as EventListener);\n      canvas.removeEventListener('webglcontextrestored', this.#onContextRestored as EventListener);\n      canvas.ownerDocument.removeEventListener('visibilitychange', this.#onVisibilityChange);\n    }\n    const gl = this.#gl;\n    if (gl !== null) {\n      for (const cached of this.#texCache.values()) gl.deleteTexture(cached.tex);\n      if (this.#blankTex !== null) gl.deleteTexture(this.#blankTex);\n      if (this.#quadVao !== null) gl.deleteVertexArray(this.#quadVao);\n      if (this.#gridVao !== null) gl.deleteVertexArray(this.#gridVao);\n      if (this.#flat !== null) gl.deleteProgram(this.#flat);\n      if (this.#curl !== null) gl.deleteProgram(this.#curl);\n      gl.getExtension('WEBGL_lose_context')?.loseContext();\n    }\n    canvas?.remove();\n    this.#texCache.clear();\n    this.#cacheBytes = 0;\n    this.#blankTex = null;\n    this.#container = null;\n    this.#canvas = null;\n    this.#gl = null;\n    this.#content = null;\n    this.#flip = null;\n  }\n\n  onFatal(handler: () => void): void {\n    this.#fatalHandler = handler;\n  }\n\n  renderSpread(_spread: Spread, content: SpreadContent, options?: RenderOptions): void {\n    this.#content = content;\n    this.#fill = options?.fill ?? false;\n    this.#flip = null;\n    this.#render();\n  }\n\n  beginFlip(\n    from: SpreadContent,\n    to: SpreadContent,\n    direction: FlipDirection,\n    options?: RenderOptions,\n  ): void {\n    const fill = options?.fill ?? false;\n    this.#flipDir = direction;\n    this.#flipT = 0;\n    if (fill) {\n      this.#flip = {\n        underLeft: null,\n        underRight: null,\n        underFull: to.right ?? to.left,\n        front: from.right ?? from.left,\n        back: to.right ?? to.left,\n        dir: direction === 'forward' ? 1 : -1,\n        spineAtStart: direction === 'forward' ? 0 : 1,\n        fill: true,\n      };\n    } else if (direction === 'forward') {\n      // Right page lifts and swings left about the spine; left stays, right reveals `to`.\n      this.#flip = {\n        underLeft: from.left,\n        underRight: to.right,\n        underFull: null,\n        front: from.right,\n        back: to.left,\n        dir: 1,\n        spineAtStart: 0.5,\n        fill: false,\n      };\n    } else {\n      // Left page swings right about the spine; right stays, left reveals `to`.\n      this.#flip = {\n        underLeft: to.left,\n        underRight: from.right,\n        underFull: null,\n        front: from.left,\n        back: to.right,\n        dir: -1,\n        spineAtStart: 0.5,\n        fill: false,\n      };\n    }\n    this.#render();\n  }\n\n  setFlipProgress(t: number, direction: FlipDirection): void {\n    this.#flipT = t;\n    this.#flipDir = direction;\n    this.#render();\n  }\n\n  setViewTransform(scale: number, x: number, y: number): void {\n    this.#view = { scale, tx: x, ty: y };\n    this.#render();\n  }\n\n  measure(): LayoutMetrics {\n    const el = this.#container;\n    const w = el?.clientWidth ?? 0;\n    const h = el?.clientHeight ?? 0;\n    return { containerWidth: w, containerHeight: h, pageWidth: w / 2, pageHeight: h };\n  }\n\n  // --- context loss / restore ---------------------------------------------------\n\n  #onContextLost = (event: Event): void => {\n    event.preventDefault(); // required, or the browser won't fire 'restored'\n    this.#contextLost = true;\n    if (this.#restoreTimer === null) {\n      this.#restoreTimer = setTimeout(() => this.#fatal(), RESTORE_TIMEOUT_MS);\n    }\n  };\n\n  #onContextRestored = (): void => {\n    this.#clearRestoreTimer();\n    this.#contextLost = false;\n    this.#buildGlResources(); // old GL objects are gone; rebuild on the same context\n    this.#render(); // CPU-side content/flip/view were retained, so re-upload + repaint\n  };\n\n  #onVisibilityChange = (): void => {\n    if (this.#canvas?.ownerDocument.visibilityState === 'visible') this.#render();\n  };\n\n  #fatal(): void {\n    if (this.#fatalFired) return;\n    this.#fatalFired = true;\n    this.#fatalHandler?.();\n  }\n\n  #clearRestoreTimer(): void {\n    if (this.#restoreTimer !== null) {\n      clearTimeout(this.#restoreTimer);\n      this.#restoreTimer = null;\n    }\n  }\n\n  #buildGlResources(): void {\n    const gl = this.#gl;\n    if (gl === null) return;\n\n    this.#flat = createProgram(gl, FLAT_VERT, FLAT_FRAG);\n    this.#curl = createProgram(gl, CURL_VERT, CURL_FRAG);\n    for (const name of ['uViewport', 'uRect', 'uView', 'uTex', 'uGutterSide']) {\n      this.#flatU[name] = gl.getUniformLocation(this.#flat, name);\n    }\n    for (const name of ['uViewport', 'uLeaf', 'uView', 'uAngle', 'uCurl', 'uDir', 'uFront', 'uBack']) {\n      this.#curlU[name] = gl.getUniformLocation(this.#curl, name);\n    }\n\n    this.#quadVao = this.#makeVao(gl, this.#flat, new Float32Array([0, 0, 1, 0, 0, 1, 1, 1]));\n\n    // Grid strip across the width (columns subdivided, 2 rows) for a smooth bend.\n    const grid: number[] = [];\n    for (let c = 0; c <= GRID_COLS; c++) {\n      const u = c / GRID_COLS;\n      grid.push(u, 0, u, 1);\n    }\n    this.#gridCount = (GRID_COLS + 1) * 2;\n    this.#gridVao = this.#makeVao(gl, this.#curl, new Float32Array(grid));\n\n    // A (re)created context has no live textures; drop the cache and remake the blank.\n    this.#texCache.clear();\n    this.#cacheBytes = 0;\n    this.#blankTex = this.#makeBlankTexture(gl);\n    gl.useProgram(this.#flat);\n    gl.uniform1i(this.#flatU.uTex ?? null, 0);\n    gl.useProgram(this.#curl);\n    gl.uniform1i(this.#curlU.uFront ?? null, 0);\n    gl.uniform1i(this.#curlU.uBack ?? null, 1);\n    gl.clearColor(0, 0, 0, 0);\n    gl.enable(gl.BLEND);\n    gl.blendFunc(gl.ONE, gl.ONE_MINUS_SRC_ALPHA); // premultiplied alpha\n  }\n\n  // --- drawing ------------------------------------------------------------------\n\n  #render(): void {\n    const gl = this.#gl;\n    const canvas = this.#canvas;\n    if (gl === null || canvas === null || this.#contextLost || gl.isContextLost()) return;\n    this.#resize();\n    gl.clear(gl.COLOR_BUFFER_BIT);\n    if (this.#flip !== null) this.#drawFlip();\n    else if (this.#content !== null) this.#drawStatic();\n  }\n\n  #drawStatic(): void {\n    const canvas = this.#canvas!;\n    const w = canvas.width;\n    const h = canvas.height;\n    this.#useFlat();\n    const content = this.#content!;\n    if (this.#fill) {\n      this.#drawQuad({ x: 0, y: 0, w, h }, content.right ?? content.left);\n    } else {\n      this.#drawQuad({ x: 0, y: 0, w: w / 2, h }, content.left, 1);\n      this.#drawQuad({ x: w / 2, y: 0, w: w / 2, h }, content.right, -1);\n    }\n  }\n\n  #drawFlip(): void {\n    const gl = this.#gl!;\n    const canvas = this.#canvas!;\n    const w = canvas.width;\n    const h = canvas.height;\n    const flip = this.#flip!;\n    const pose = flipProgressToPose(this.#flipT);\n\n    // Static pages underneath.\n    this.#useFlat();\n    if (flip.fill) {\n      this.#drawQuad({ x: 0, y: 0, w, h }, flip.underFull);\n    } else {\n      this.#drawQuad({ x: 0, y: 0, w: w / 2, h }, flip.underLeft, 1);\n      this.#drawQuad({ x: w / 2, y: 0, w: w / 2, h }, flip.underRight, -1);\n    }\n\n    // Turning leaf: both faces uploaded, per-fragment facing picks front vs back.\n    if (flip.front === null && flip.back === null) return;\n    this.#bindFace(gl.TEXTURE0, flip.front);\n    this.#bindFace(gl.TEXTURE1, flip.back);\n    gl.activeTexture(gl.TEXTURE0);\n\n    const leafW = flip.fill ? w : w / 2;\n    const spineX = flip.spineAtStart * w;\n    gl.useProgram(this.#curl);\n    gl.bindVertexArray(this.#gridVao);\n    gl.uniform2f(this.#curlU.uViewport ?? null, w, h);\n    gl.uniform3f(this.#curlU.uView ?? null, this.#view.scale, this.#view.tx * this.#dpr, this.#view.ty * this.#dpr);\n    gl.uniform4f(this.#curlU.uLeaf ?? null, spineX, 0, leafW, h);\n    gl.uniform1f(this.#curlU.uAngle ?? null, pose.angle);\n    gl.uniform1f(this.#curlU.uCurl ?? null, pose.curl);\n    gl.uniform1f(this.#curlU.uDir ?? null, flip.dir);\n    gl.drawArrays(gl.TRIANGLE_STRIP, 0, this.#gridCount);\n  }\n\n  #useFlat(): void {\n    const gl = this.#gl!;\n    const canvas = this.#canvas!;\n    gl.useProgram(this.#flat);\n    gl.bindVertexArray(this.#quadVao);\n    gl.activeTexture(gl.TEXTURE0);\n    gl.uniform2f(this.#flatU.uViewport ?? null, canvas.width, canvas.height);\n    gl.uniform3f(this.#flatU.uView ?? null, this.#view.scale, this.#view.tx * this.#dpr, this.#view.ty * this.#dpr);\n  }\n\n  #drawQuad(rect: Rect, source: TexImageSource | null, gutterSide = 0): void {\n    const gl = this.#gl!;\n    if (source === null) return;\n    this.#bindFace(gl.TEXTURE0, source);\n    gl.uniform4f(this.#flatU.uRect ?? null, rect.x, rect.y, rect.w, rect.h);\n    gl.uniform1f(this.#flatU.uGutterSide ?? null, gutterSide);\n    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);\n  }\n\n  /** Bind the texture for `source` (a blank 1x1 when null) to a texture unit. */\n  #bindFace(unit: number, source: TexImageSource | null): void {\n    const gl = this.#gl!;\n    gl.activeTexture(unit);\n    gl.bindTexture(gl.TEXTURE_2D, source !== null ? this.#textureFor(source) : this.#blankTex);\n  }\n\n  /** Page texture cached by content: uploaded once, reused across frames, LRU-capped. */\n  #textureFor(source: TexImageSource): WebGLTexture {\n    const gl = this.#gl!;\n    const existing = this.#texCache.get(source);\n    if (existing !== undefined) {\n      this.#texCache.delete(source); // move to most-recently-used\n      this.#texCache.set(source, existing);\n      return existing.tex;\n    }\n    const tex = createTexture(gl); // binds + uploads on the active unit set by the caller\n    uploadTexture(gl, tex, source);\n    const dims = source as unknown as { width: number; height: number }; // page rasters have both\n    const bytes = dims.width * dims.height * 4;\n    this.#texCache.set(source, { tex, bytes });\n    this.#cacheBytes += bytes;\n    this.#evictTextures();\n    return tex;\n  }\n\n  /** Drop least-recently-used page textures past the byte ceiling (keep a small floor). */\n  #evictTextures(): void {\n    const gl = this.#gl!;\n    for (const [src, cached] of this.#texCache) {\n      if (this.#cacheBytes <= MAX_TEXTURE_CACHE_BYTES || this.#texCache.size <= 4) break;\n      this.#texCache.delete(src);\n      this.#cacheBytes -= cached.bytes;\n      gl.deleteTexture(cached.tex);\n    }\n  }\n\n  #makeBlankTexture(gl: WebGL2RenderingContext): WebGLTexture {\n    const tex = createTexture(gl);\n    gl.bindTexture(gl.TEXTURE_2D, tex);\n    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, new Uint8Array([0, 0, 0, 0]));\n    return tex;\n  }\n\n  #makeVao(gl: WebGL2RenderingContext, program: WebGLProgram, data: Float32Array): WebGLVertexArrayObject {\n    const vao = gl.createVertexArray();\n    const buffer = gl.createBuffer();\n    if (vao === null || buffer === null) throw new Error('WebglRenderer: could not create buffers.');\n    gl.bindVertexArray(vao);\n    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);\n    gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);\n    const aUnit = gl.getAttribLocation(program, 'aUnit');\n    gl.enableVertexAttribArray(aUnit);\n    gl.vertexAttribPointer(aUnit, 2, gl.FLOAT, false, 0, 0);\n    gl.bindVertexArray(null);\n    return vao;\n  }\n\n  #resize(): void {\n    const gl = this.#gl;\n    const canvas = this.#canvas;\n    const el = this.#container;\n    if (gl === null || canvas === null || el === null) return;\n    this.#dpr = typeof devicePixelRatio === 'number' ? devicePixelRatio : 1;\n    const w = Math.max(1, Math.round(el.clientWidth * this.#dpr));\n    const h = Math.max(1, Math.round(el.clientHeight * this.#dpr));\n    if (canvas.width !== w || canvas.height !== h) {\n      canvas.width = w;\n      canvas.height = h;\n      gl.viewport(0, 0, w, h);\n    }\n  }\n}\n","import type { Renderer } from './types';\n\nexport type RendererKind = 'css' | 'webgl2';\n\n/**\n * How the consumer chooses a renderer:\n * - `'auto'` (default): prefer the GPU path (WebGL2), else CSS.\n * - a single kind: force it (`'webgl2'` throws if the device has no WebGL2).\n * - an ordered array: try each in turn, first viable wins.\n * - a `Renderer` instance: use it as-is (custom implementation, §6.1/§11).\n */\nexport type RendererOption = 'auto' | RendererKind | RendererKind[] | Renderer;\n\nexport interface Capabilities {\n  /** WebGL2 available — the GPU renderer's only backend. */\n  gpu: boolean;\n}\n\ntype RendererLoader = () => Promise<Renderer>;\n\n/**\n * Lazy loaders, one per kind. Each is a dynamic `import()` so the bundler\n * code-splits it into its own chunk and a device fetches only the one selected.\n */\nconst LOADERS: Partial<Record<RendererKind, RendererLoader>> = {\n  css: async () => new (await import('./cssRenderer')).CssRenderer(),\n  webgl2: async () => new (await import('./webglRenderer')).WebglRenderer(),\n};\n\n// The WebGL2 renderer is auto-selected on GPU-capable devices; CSS is the baseline\n// for non-GPU devices and the fallback for unrecoverable GPU failures (§8.4).\nconst WEBGL2_AUTO = true;\n\nfunction isRenderer(option: RendererOption): option is Renderer {\n  return (\n    typeof option === 'object' &&\n    option !== null &&\n    !Array.isArray(option) &&\n    typeof (option as Renderer).mount === 'function'\n  );\n}\n\nfunction autoOrder(caps: Capabilities): RendererKind[] {\n  return caps.gpu && WEBGL2_AUTO ? ['webgl2', 'css'] : ['css'];\n}\n\n/** Detect WebGL2 support — the GPU renderer's only backend (no WebGL1, no WebGPU). */\nexport function detectCapabilities(): Capabilities {\n  return { gpu: hasWebGl2() };\n}\n\nfunction hasWebGl2(): boolean {\n  try {\n    return Boolean(document.createElement('canvas').getContext('webgl2'));\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve the `renderer` option to a mounted renderer instance, lazy-loading its\n * chunk. Throws an agent-actionable error if nothing viable can be loaded.\n */\nexport async function selectRenderer(\n  option: RendererOption = 'auto',\n  caps: Capabilities = detectCapabilities(),\n): Promise<Renderer> {\n  if (isRenderer(option)) return option;\n\n  const order = Array.isArray(option) ? option : option === 'auto' ? autoOrder(caps) : [option];\n\n  for (const kind of order) {\n    if (kind === 'webgl2' && !caps.gpu) continue; // skip the GPU path without WebGL2\n    const loader = LOADERS[kind];\n    if (loader) return loader();\n  }\n\n  if (order.length === 1 && order[0] === 'webgl2' && !caps.gpu) {\n    throw new Error(\n      \"renderer: 'webgl2' was forced but this device has no WebGL2. Use 'css' or 'auto'.\",\n    );\n  }\n  throw new Error(\n    `renderer: none of [${order.join(', ')}] could be loaded — use 'css' or 'auto'.`,\n  );\n}\n","import { buildSpreads, shouldSinglePage, type Direction, type Spread } from './engine/spread';\nimport { Virtualizer } from './engine/virtualizer';\nimport { Emitter, type ZineEventMap } from './engine/emitter';\nimport { FlipMachine } from './engine/stateMachine';\nimport { PointerRecognizer, PinchRecognizer, bindGestures, type GestureEnd } from './engine/input';\nimport { hitTest } from './geometry/hitTest';\nimport { selectRenderer, type RendererOption } from './renderer/select';\nimport type { FlipDirection, PageContent, Renderer, SpreadContent } from './renderer/types';\nimport type { Source } from './source/types';\n\n/** Grab-zone size as a fraction of the smaller container dimension. */\nconst CORNER_FRACTION = 0.25;\n\n/** Wheel-zoom sensitivity: scale multiplies by exp(-deltaY * this) per wheel event. */\nconst WHEEL_ZOOM_SENSITIVITY = 0.0015;\n\n/** Pointer movement (px) beyond which a press becomes a drag rather than a tap. */\nconst DRAG_THRESHOLD = 6;\n\n/** Window (ms) a single click waits to rule out a double-click before flipping. */\nconst DOUBLE_CLICK_MS = 250;\n\ninterface DragState {\n  direction: FlipDirection;\n  targetIndex: number;\n  toPage: number;\n  toContent: SpreadContent;\n  width: number;\n  t: number;\n}\n\nexport interface ZoomOptions {\n  /** Whether zooming is allowed at all; default true. */\n  enabled?: boolean;\n  /** Maximum zoom scale; default 4. */\n  max?: number;\n  /** Zoom on Ctrl/⌘ + wheel (also how trackpad pinch arrives on desktop); default true. */\n  wheel?: boolean;\n  /** Zoom levels cycled by double-click (wraps to the first); `false` disables. Default [1, 2, 4]. */\n  doubleClick?: number[] | false;\n  /**\n   * Listen for double-click zoom inside the click-to-flip zones. Default: off in 'edge' mode\n   * (edges flip instantly, no delay), on in 'half' mode. Turning it on in 'edge' mode makes\n   * clicks wait out `clickFlipDelay` so a double-click can preempt them with a zoom.\n   */\n  doubleClickInFlipZone?: boolean;\n}\n\nexport interface ZineOptions {\n  /** Content source (e.g. an ImageSource). Required. */\n  source: Source;\n  /** Renderer selection; default 'auto'. */\n  renderer?: RendererOption;\n  /** Fixed container width in px; omit to let the container/CSS drive the size. */\n  width?: number;\n  /** Fixed container height in px; omit to let the container/CSS drive the size. */\n  height?: number;\n  /** Reading direction; default 'ltr'. */\n  direction?: Direction;\n  /** First page is a lone cover; default false. */\n  cover?: boolean;\n  /** Page to open on; default 0. */\n  startPage?: number;\n  /** Flip animation duration in ms; default 500. */\n  flipDuration?: number;\n  /** How a tap/click turns pages: near an edge ('edge'), by page half ('half'), or 'off'. Default 'edge'. */\n  clickToFlip?: 'edge' | 'half' | 'off';\n  /** Edge-zone size in px per side, used when clickToFlip is 'edge'. Default 64. */\n  clickZoneSize?: number;\n  /**\n   * Delay (ms) a click waits before flipping, so a double-click can preempt it with a zoom.\n   * Omit for auto: 0 when double-click zoom is inactive, 250 when it's active.\n   */\n  clickFlipDelay?: number;\n  /** Zoom behavior. */\n  zoom?: ZoomOptions;\n  /** Container widths below this (px) switch to one page per spread; default 640. */\n  singlePageThreshold?: number;\n}\n\n/**\n * The public flipbook. Composes the engine (spreads, virtualizer, events), a\n * lazily-selected renderer, and a content source. Construction is synchronous\n * but setup is async — await `ready` (or listen for the `ready` event) before\n * driving it.\n */\nexport class Zine {\n  #container: HTMLElement;\n  #source: Source;\n  #emitter = new Emitter<ZineEventMap>();\n  #virtualizer = new Virtualizer(2);\n  #machine = new FlipMachine();\n  #direction: Direction;\n  #cover: boolean;\n  #clickToFlip: 'edge' | 'half' | 'off';\n  #clickZoneSize: number;\n  #honorDoubleClickInFlipZone: boolean;\n  #clickFlipDelayValue: number;\n  #singlePageThreshold: number;\n  #singlePage = false;\n  #startPageOption: number | undefined;\n  #spreads: Spread[] = [];\n  #current = 0;\n  #currentPage = 0;\n  #currentContent: SpreadContent = { left: null, right: null };\n  #flipDuration: number;\n  #zoomEnabled: boolean;\n  #wheelZoom: boolean;\n  #doubleClickLevels: number[] | null;\n  #maxZoom: number;\n  #resizeObserver: ResizeObserver | null = null;\n  #updateScheduled = false;\n  #scale = 1;\n  #tx = 0;\n  #ty = 0;\n  #renderer: Renderer | null = null;\n  #fellBack = false;\n  #destroyed = false;\n  #raf: number | null = null;\n  #drag: DragState | null = null;\n  #pendingGrab: { direction: FlipDirection; targetIndex: number; toPage: number; width: number } | null = null;\n  #press: { x: number; y: number } | null = null;\n  #pendingClickTimer: ReturnType<typeof setTimeout> | null = null;\n  #pan: { baseTx: number; baseTy: number } | null = null;\n  #pinching = false;\n  #pinchBaseScale = 1;\n  #reducedMotion = false;\n  #liveRegion: HTMLElement | null = null;\n  #unbindInput: (() => void) | null = null;\n  #unbindWheel: (() => void) | null = null;\n  #unbindDblClick: (() => void) | null = null;\n  #a11yCleanup: (() => void) | null = null;\n  #ready: Promise<void>;\n\n  /** Stable seek API: drive the fold to a fixed progress without animating (visual regression). */\n  readonly debug = {\n    setFlipProgress: (t: number, direction: FlipDirection): void => {\n      this.#renderer?.setFlipProgress(t, direction);\n    },\n  };\n\n  constructor(container: HTMLElement, options: ZineOptions) {\n    validateOptions(container, options);\n    this.#container = container;\n    if (options.width !== undefined) container.style.width = `${options.width}px`;\n    if (options.height !== undefined) container.style.height = `${options.height}px`;\n    this.#source = options.source;\n    const direction = options.direction ?? 'ltr';\n    const cover = options.cover ?? false;\n    this.#direction = direction;\n    this.#cover = cover;\n    this.#clickToFlip = options.clickToFlip ?? 'edge';\n    this.#clickZoneSize = options.clickZoneSize ?? 64;\n    this.#singlePageThreshold = options.singlePageThreshold ?? 640;\n    this.#startPageOption = options.startPage;\n    // Sync sources (a known page count) build spreads now — so bad pageCount/startPage\n    // throw immediately from `new Zine`. Async sources (an `open()`) defer to #init.\n    if (typeof this.#source.open !== 'function') {\n      this.#buildSpreadModel();\n    }\n    this.#flipDuration = options.flipDuration ?? 800;\n    this.#zoomEnabled = options.zoom?.enabled ?? true;\n    this.#wheelZoom = options.zoom?.wheel ?? true;\n    const dbl = options.zoom?.doubleClick;\n    const levels = dbl === false ? [] : [...(dbl ?? [1, 2, 4])].sort((a, b) => a - b);\n    this.#doubleClickLevels = levels.length > 0 ? levels : null;\n    this.#maxZoom = options.zoom?.max ?? 4;\n\n    // Arbitrate click-to-flip vs double-click zoom inside the flip zones.\n    // Listen for double-click zoom in flip zones: default off in 'edge', on in 'half'.\n    // clickFlipDelay === 0 hard-disables it. When honored, a delay lets a click wait\n    // out a possible double-click; auto default 250 ms, overridable.\n    const doubleClickZoomActive = this.#zoomEnabled && this.#doubleClickLevels !== null;\n    const listenInFlipZone = options.zoom?.doubleClickInFlipZone ?? (this.#clickToFlip === 'half');\n    this.#honorDoubleClickInFlipZone =\n      this.#clickToFlip !== 'off' &&\n      doubleClickZoomActive &&\n      listenInFlipZone &&\n      options.clickFlipDelay !== 0;\n    this.#clickFlipDelayValue = this.#honorDoubleClickInFlipZone\n      ? (options.clickFlipDelay ?? DOUBLE_CLICK_MS)\n      : 0;\n\n    this.#ready = this.#init(options.renderer ?? 'auto');\n  }\n\n  /** Resolves once the renderer is mounted and the first spread is painted. */\n  get ready(): Promise<void> {\n    return this.#ready;\n  }\n\n  getPageCount(): number {\n    return this.#source.pageCount;\n  }\n\n  getPage(): number {\n    return this.#currentPage;\n  }\n\n  flipNext(): void {\n    this.#startFlip(this.#current + 1);\n  }\n\n  flipPrev(): void {\n    this.#startFlip(this.#current - 1);\n  }\n\n  flipTo(page: number): void {\n    const target = clamp(page, 0, Math.max(0, this.#source.pageCount - 1));\n    this.#startFlip(this.#spreadIndexForPage(target));\n  }\n\n  getZoom(): number {\n    return this.#scale;\n  }\n\n  /** Zoom to `scale` (clamped to [1, zoom.max]), keeping `center` (container-local) fixed. */\n  setZoom(scale: number, center?: { x: number; y: number }): void {\n    if (!this.#renderer || !this.#zoomEnabled) return;\n    const s2 = clamp(scale, 1, this.#maxZoom);\n    const m = this.#renderer.measure();\n    const focal = center ?? { x: m.containerWidth / 2, y: m.containerHeight / 2 };\n    const s1 = this.#scale;\n    // Solve for the translate that keeps the focal screen point fixed as s1→s2.\n    let tx = s2 === 1 ? 0 : focal.x - (s2 / s1) * (focal.x - this.#tx);\n    let ty = s2 === 1 ? 0 : focal.y - (s2 / s1) * (focal.y - this.#ty);\n    [tx, ty] = this.#clampPan(tx, ty, s2, m.containerWidth, m.containerHeight);\n    this.#scale = s2;\n    this.#tx = tx;\n    this.#ty = ty;\n    this.#renderer.setViewTransform(s2, tx, ty);\n    this.#emitter.emit('zoomChanged', { scale: s2 });\n  }\n\n  resetZoom(): void {\n    this.setZoom(1);\n  }\n\n  #clampPan(tx: number, ty: number, scale: number, w: number, h: number): [number, number] {\n    // Keep the scaled content covering the viewport (transform-origin is 0,0).\n    return [clamp(tx, w * (1 - scale), 0), clamp(ty, h * (1 - scale), 0)];\n  }\n\n  on<K extends keyof ZineEventMap>(\n    event: K,\n    listener: (payload: ZineEventMap[K]) => void,\n  ): () => void {\n    return this.#emitter.on(event, listener);\n  }\n\n  destroy(): void {\n    this.#destroyed = true;\n    if (this.#raf !== null) cancelAnimationFrame(this.#raf);\n    this.#clearPendingClickFlip();\n    this.#resizeObserver?.disconnect();\n    this.#a11yCleanup?.();\n    this.#unbindWheel?.();\n    this.#unbindDblClick?.();\n    this.#unbindInput?.();\n    this.#renderer?.destroy();\n    this.#renderer = null;\n    this.#source.destroy();\n    this.#emitter.clear();\n  }\n\n  #startFlip(targetIndex: number): void {\n    if (targetIndex < 0 || targetIndex >= this.#spreads.length || targetIndex === this.#current) {\n      return;\n    }\n    // `flip` is legal only from idle; otherwise a flip/drag is already in flight.\n    if (this.#machine.send('flip') === null) return;\n\n    const direction: FlipDirection = targetIndex > this.#current ? 'forward' : 'backward';\n    const toPage = this.#leadPage(targetIndex);\n    // State is already locked (send('flip') above), so re-entrant flips are rejected\n    // even though staging the destination content below is async.\n    this.#emitter.emit('flipStart', { from: this.#currentPage, to: toPage });\n    void this.#runFlip(targetIndex, direction, toPage);\n  }\n\n  async #runFlip(targetIndex: number, direction: FlipDirection, toPage: number): Promise<void> {\n    const toSpread = this.#spreads[targetIndex];\n    const toContent: SpreadContent = toSpread\n      ? await this.#resolveContent(toSpread)\n      : { left: null, right: null };\n    this.#renderer?.beginFlip(this.#currentContent, toContent, direction, {\n      fill: this.#singlePage,\n    });\n    this.#animateProgress(0, 1, direction, () => this.#commit(targetIndex, toPage, toContent));\n  }\n\n  /** Animate the fold from `fromT` to `toT`, easing per-frame, then run `onDone`. */\n  #animateProgress(\n    fromT: number,\n    toT: number,\n    direction: FlipDirection,\n    onDone: () => void,\n  ): void {\n    const duration = this.#effectiveDuration() * Math.abs(toT - fromT);\n    if (duration <= 0) {\n      // Reduced motion (or zero-duration): swap without the curl sweep.\n      this.#renderer?.setFlipProgress(toT, direction);\n      onDone();\n      return;\n    }\n    const start = performance.now();\n    const step = (now: number): void => {\n      // Easing lives here; flipProgressToPose stays linear so seeks are deterministic.\n      const raw = Math.min(1, (now - start) / duration);\n      this.#renderer?.setFlipProgress(fromT + (toT - fromT) * easeInOutCubic(raw), direction);\n      if (raw < 1) {\n        this.#raf = requestAnimationFrame(step);\n      } else {\n        this.#raf = null;\n        onDone();\n      }\n    };\n    this.#raf = requestAnimationFrame(step);\n  }\n\n  #commit(targetIndex: number, toPage: number, toContent: SpreadContent): void {\n    const spread = this.#spreads[targetIndex];\n    this.#current = targetIndex;\n    this.#currentPage = toPage;\n    this.#currentContent = toContent;\n    // renderSpread paints the landed spread and clears the turning leaf.\n    if (spread) this.#paintSpread(spread, toContent);\n    this.#prefetchWindow();\n    this.#machine.send('settle');\n    this.#announce();\n    this.#emitter.emit('pageChanged', { page: toPage });\n    this.#emitter.emit('flipEnd', { page: toPage });\n  }\n\n  #leadPage(spreadIndex: number): number {\n    const spread = this.#spreads[spreadIndex];\n    if (!spread) return this.#currentPage;\n    const pages = [spread.left, spread.right].filter((p): p is number => p !== null);\n    return pages.length > 0 ? Math.min(...pages) : this.#currentPage;\n  }\n\n  #onDragStart(clientX: number, clientY: number): void {\n    if (this.#pinching || !this.#renderer || this.#machine.state !== 'idle') return;\n    this.#clearPendingClickFlip(); // a new press cancels a click-flip still waiting out its window\n    // Zoomed in → a drag pans; at scale 1 → a corner drag flips (§9 mode switch).\n    if (this.#scale > 1) {\n      if (this.#machine.send('panStart') === null) return;\n      this.#pan = { baseTx: this.#tx, baseTy: this.#ty };\n      return;\n    }\n    const rect = this.#container.getBoundingClientRect();\n    const point = { x: clientX - rect.left, y: clientY - rect.top };\n    this.#press = point; // remembered for tap classification / click-to-flip zone\n    const { containerWidth, containerHeight } = this.#renderer.measure();\n    const cornerSize = Math.min(containerWidth, containerHeight) * CORNER_FRACTION;\n    if (hitTest(point, { width: containerWidth, height: containerHeight }, cornerSize) !== 'corner') {\n      return; // not a corner — no drag; a tap here may still click-to-flip on release\n    }\n    // Arm a potential drag; it only becomes a real flip once the pointer moves\n    // (so a corner *tap* never fires a spurious flipStart). Right-side corner\n    // turns the page forward in LTR; RTL mirrors it.\n    const rightSide = point.x > containerWidth / 2;\n    const forward = this.#direction === 'rtl' ? !rightSide : rightSide;\n    const targetIndex = this.#current + (forward ? 1 : -1);\n    if (targetIndex < 0 || targetIndex >= this.#spreads.length) return;\n    this.#pendingGrab = {\n      direction: forward ? 'forward' : 'backward',\n      targetIndex,\n      toPage: this.#leadPage(targetIndex),\n      width: containerWidth,\n    };\n  }\n\n  /** Turn an armed corner press into a live drag flip once the pointer has moved. */\n  #promoteGrab(): void {\n    const grab = this.#pendingGrab;\n    if (!grab) return;\n    this.#pendingGrab = null;\n    if (this.#machine.send('grab') === null) return;\n    this.#drag = {\n      direction: grab.direction,\n      targetIndex: grab.targetIndex,\n      toPage: grab.toPage,\n      toContent: { left: null, right: null },\n      width: grab.width,\n      t: 0,\n    };\n    this.#emitter.emit('flipStart', { from: this.#currentPage, to: grab.toPage });\n    void this.#stageDrag(grab.targetIndex, grab.direction);\n  }\n\n  async #stageDrag(targetIndex: number, direction: FlipDirection): Promise<void> {\n    const toSpread = this.#spreads[targetIndex];\n    const toContent: SpreadContent = toSpread\n      ? await this.#resolveContent(toSpread)\n      : { left: null, right: null };\n    // The drag may have ended (or retargeted) while content was resolving.\n    if (this.#drag?.targetIndex !== targetIndex) return;\n    this.#drag.toContent = toContent;\n    this.#renderer?.beginFlip(this.#currentContent, toContent, direction, {\n      fill: this.#singlePage,\n    });\n    this.#renderer?.setFlipProgress(this.#drag.t, direction);\n  }\n\n  #onDragMove(dx: number, dy: number): void {\n    if (this.#pinching) return;\n    if (this.#pan) {\n      if (!this.#renderer) return;\n      const m = this.#renderer.measure();\n      const [tx, ty] = this.#clampPan(\n        this.#pan.baseTx + dx,\n        this.#pan.baseTy + dy,\n        this.#scale,\n        m.containerWidth,\n        m.containerHeight,\n      );\n      this.#tx = tx;\n      this.#ty = ty;\n      this.#renderer.setViewTransform(this.#scale, tx, ty);\n      return;\n    }\n    // An armed corner press becomes a real flip once it moves past the threshold.\n    if (this.#pendingGrab && Math.hypot(dx, dy) > DRAG_THRESHOLD) {\n      this.#promoteGrab();\n    }\n    const drag = this.#drag;\n    if (!drag) return;\n    const signed = drag.direction === 'forward' ? -dx : dx;\n    drag.t = clamp(signed / drag.width, 0, 1);\n    this.#renderer?.setFlipProgress(drag.t, drag.direction);\n  }\n\n  #onDragEnd(gesture: GestureEnd): void {\n    if (this.#pinching) return;\n    if (this.#pan) {\n      this.#pan = null;\n      this.#machine.send('panEnd');\n      return;\n    }\n    const drag = this.#drag;\n    if (!drag) {\n      // Never became a drag → it was a tap; maybe flip via clickToFlip.\n      this.#pendingGrab = null;\n      this.#maybeClickFlip(gesture);\n      return;\n    }\n    this.#drag = null;\n    this.#machine.send('release');\n\n    const swiped =\n      gesture.swipe &&\n      (drag.direction === 'forward' ? gesture.dx < 0 : gesture.dx > 0);\n    if (drag.t >= 0.5 || swiped) {\n      this.#animateProgress(drag.t, 1, drag.direction, () =>\n        this.#commit(drag.targetIndex, drag.toPage, drag.toContent),\n      );\n    } else {\n      this.#animateProgress(drag.t, 0, drag.direction, () => this.#cancelFlip());\n    }\n  }\n\n  #maybeClickFlip(gesture: GestureEnd): void {\n    if (this.#clickToFlip === 'off' || this.#scale > 1 || !this.#press) return;\n    // A tap barely moves; anything more was a drag we already ignored.\n    if (Math.abs(gesture.dx) > DRAG_THRESHOLD || Math.abs(gesture.dy) > DRAG_THRESHOLD) return;\n    const direction = this.#clickFlipDirection(this.#press);\n    if (!direction) return;\n    const targetIndex = this.#current + (direction === 'forward' ? 1 : -1);\n    if (targetIndex < 0 || targetIndex >= this.#spreads.length) return;\n    this.#clearPendingClickFlip();\n    if (this.#clickFlipDelayValue <= 0) {\n      // No double-click competing here → flip right away.\n      this.#startFlip(targetIndex);\n      return;\n    }\n    // Wait out the window; a double-click (zoom) cancels this.\n    this.#pendingClickTimer = setTimeout(() => {\n      this.#pendingClickTimer = null;\n      this.#startFlip(targetIndex);\n    }, this.#clickFlipDelayValue);\n  }\n\n  /** Which way a tap at `point` (container-local) turns the page, or null for a dead zone. */\n  #clickFlipDirection(point: { x: number; y: number }): FlipDirection | null {\n    if (!this.#renderer) return null;\n    const { containerWidth } = this.#renderer.measure();\n    let side: 'left' | 'right' | null;\n    if (this.#clickToFlip === 'half') {\n      side = point.x > containerWidth / 2 ? 'right' : 'left';\n    } else if (point.x <= this.#clickZoneSize) {\n      side = 'left';\n    } else if (point.x >= containerWidth - this.#clickZoneSize) {\n      side = 'right';\n    } else {\n      side = null; // center dead zone in 'edge' mode\n    }\n    if (!side) return null;\n    const forwardSide = this.#direction === 'rtl' ? 'left' : 'right';\n    return side === forwardSide ? 'forward' : 'backward';\n  }\n\n  #clearPendingClickFlip(): void {\n    if (this.#pendingClickTimer !== null) {\n      clearTimeout(this.#pendingClickTimer);\n      this.#pendingClickTimer = null;\n    }\n  }\n\n  #cancelFlip(): void {\n    const spread = this.#spreads[this.#current];\n    if (spread) this.#paintSpread(spread, this.#currentContent);\n    this.#machine.send('settle');\n    this.#emitter.emit('flipEnd', { page: this.#currentPage });\n  }\n\n  #onPinchStart(): void {\n    // A second finger abandons any single-pointer gesture in flight.\n    this.#pendingGrab = null;\n    this.#clearPendingClickFlip();\n    if (this.#drag) {\n      this.#drag = null;\n      this.#machine.send('release');\n      this.#machine.send('settle');\n      const spread = this.#spreads[this.#current];\n      if (spread) this.#paintSpread(spread, this.#currentContent);\n    } else if (this.#pan) {\n      this.#pan = null;\n      this.#machine.send('panEnd');\n    }\n    this.#pinching = true;\n    this.#pinchBaseScale = this.#scale;\n  }\n\n  #onPinchMove(centerX: number, centerY: number, scale: number): void {\n    if (!this.#pinching) return;\n    const rect = this.#container.getBoundingClientRect();\n    this.setZoom(this.#pinchBaseScale * scale, { x: centerX - rect.left, y: centerY - rect.top });\n  }\n\n  #onPinchEnd(): void {\n    this.#pinching = false;\n  }\n\n  #bindWheelZoom(): void {\n    const onWheel = (event: WheelEvent): void => {\n      // Ctrl/⌘ + wheel only — this is also what a desktop trackpad pinch emits.\n      if (!this.#wheelZoom || !this.#zoomEnabled || !(event.ctrlKey || event.metaKey)) return;\n      // Override the browser's native page zoom.\n      event.preventDefault();\n      const rect = this.#container.getBoundingClientRect();\n      const factor = Math.exp(-event.deltaY * WHEEL_ZOOM_SENSITIVITY);\n      this.setZoom(this.#scale * factor, {\n        x: event.clientX - rect.left,\n        y: event.clientY - rect.top,\n      });\n    };\n    this.#container.addEventListener('wheel', onWheel as EventListener, { passive: false });\n    this.#unbindWheel = () =>\n      this.#container.removeEventListener('wheel', onWheel as EventListener);\n  }\n\n  #bindDoubleClickZoom(): void {\n    const onDoubleClick = (event: MouseEvent): void => {\n      const levels = this.#doubleClickLevels;\n      if (!this.#zoomEnabled || levels === null) return;\n      // At scale 1 a double-click inside a flip zone belongs to click-to-flip, not zoom,\n      // unless we're honoring double-click zoom there.\n      if (this.#scale <= 1 && this.#clickToFlip !== 'off' && !this.#honorDoubleClickInFlipZone) {\n        const rect = this.#container.getBoundingClientRect();\n        const local = { x: event.clientX - rect.left, y: event.clientY - rect.top };\n        if (this.#clickFlipDirection(local) !== null) return; // in a flip zone → leave it to click-to-flip\n      }\n      // A double-click means the single-click flip we may have queued was really a zoom.\n      this.#clearPendingClickFlip();\n      event.preventDefault();\n      // Next configured level above the current scale, else wrap to the first.\n      const next = levels.find((l) => l > this.#scale + 1e-6) ?? levels[0] ?? this.#scale;\n      const rect = this.#container.getBoundingClientRect();\n      this.setZoom(next, { x: event.clientX - rect.left, y: event.clientY - rect.top });\n    };\n    this.#container.addEventListener('dblclick', onDoubleClick as EventListener);\n    this.#unbindDblClick = () =>\n      this.#container.removeEventListener('dblclick', onDoubleClick as EventListener);\n  }\n\n  async #init(rendererOption: RendererOption): Promise<void> {\n    // Load the renderer chunk while opening an async source (e.g. a PDF) in parallel.\n    const rendererPromise = selectRenderer(rendererOption);\n    if (typeof this.#source.open === 'function') {\n      await this.#source.open();\n      this.#buildSpreadModel(); // page count known now; validates + builds spreads\n    }\n    this.#source.prefetch([this.#currentPage]);\n\n    const selected = await rendererPromise;\n    const renderer = await this.#mountWithFallback(selected);\n    this.#renderer = renderer;\n\n    // Now that we can measure, apply single-page mode if the container is narrow.\n    this.#applySinglePage(renderer.measure().containerWidth);\n\n    const pointer = new PointerRecognizer({\n      onStart: (g) => this.#onDragStart(g.x, g.y),\n      onMove: (g) => this.#onDragMove(g.dx, g.dy),\n      onEnd: (g) => this.#onDragEnd(g),\n    });\n    const pinch = new PinchRecognizer({\n      onPinchStart: () => this.#onPinchStart(),\n      onPinchMove: (g) => this.#onPinchMove(g.centerX, g.centerY, g.scale),\n      onPinchEnd: () => this.#onPinchEnd(),\n    });\n    this.#unbindInput = bindGestures(this.#container, { pointer, pinch });\n    this.#bindWheelZoom();\n    this.#bindDoubleClickZoom();\n    this.#setupReducedMotion();\n    this.#a11yCleanup = this.#setupA11y();\n\n    await this.#renderCurrent();\n    this.#observeResize();\n    this.#prefetchWindow();\n    this.#announce();\n    this.#emitter.emit('ready');\n  }\n\n  /** Mount `renderer`; if it can't initialize (e.g. no WebGL2 context) fall back to CSS. */\n  async #mountWithFallback(renderer: Renderer): Promise<Renderer> {\n    try {\n      await renderer.mount(this.#container);\n      renderer.onFatal?.(() => {\n        void this.#fallbackToCss();\n      });\n      return renderer;\n    } catch {\n      renderer.destroy();\n      const css = await selectRenderer('css');\n      await css.mount(this.#container);\n      this.#fellBack = true;\n      this.#emitter.emit('rendererFallback', { from: 'webgl2', to: 'css' });\n      return css;\n    }\n  }\n\n  /** Runtime fallback: a live renderer signaled an unrecoverable failure (§8.4). */\n  async #fallbackToCss(): Promise<void> {\n    if (this.#fellBack || this.#destroyed) return;\n    this.#fellBack = true;\n    this.#renderer?.destroy();\n    this.#renderer = null;\n    const css = await selectRenderer('css');\n    if (this.#destroyed) {\n      css.destroy();\n      return;\n    }\n    await css.mount(this.#container);\n    this.#renderer = css;\n    this.#applySinglePage(css.measure().containerWidth);\n    await this.#renderCurrent();\n    this.#emitter.emit('rendererFallback', { from: 'webgl2', to: 'css' });\n  }\n\n  #setupReducedMotion(): void {\n    if (typeof matchMedia !== 'function') return;\n    const query = matchMedia('(prefers-reduced-motion: reduce)');\n    this.#reducedMotion = query.matches;\n    query.addEventListener?.('change', (e) => {\n      this.#reducedMotion = e.matches;\n    });\n  }\n\n  /** Wire keyboard nav + an aria-live page announcer. Skips non-DOM containers. */\n  #setupA11y(): (() => void) | null {\n    const container = this.#container;\n    const doc = container.ownerDocument;\n    if (!doc || typeof container.setAttribute !== 'function') return null;\n\n    if (!container.hasAttribute('tabindex')) container.tabIndex = 0;\n    container.setAttribute('aria-roledescription', 'flipbook');\n    const onKey = (e: KeyboardEvent): void => this.#onKeyDown(e);\n    container.addEventListener('keydown', onKey);\n\n    const live = doc.createElement('div');\n    live.setAttribute('aria-live', 'polite');\n    live.setAttribute('aria-atomic', 'true');\n    live.style.cssText =\n      'position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0;';\n    container.appendChild(live);\n    this.#liveRegion = live;\n\n    return () => {\n      container.removeEventListener('keydown', onKey);\n      live.remove();\n      this.#liveRegion = null;\n    };\n  }\n\n  #onKeyDown(event: KeyboardEvent): void {\n    const forwardKey = this.#direction === 'rtl' ? 'ArrowLeft' : 'ArrowRight';\n    switch (event.key) {\n      case 'ArrowRight':\n      case 'ArrowLeft':\n        if (event.key === forwardKey) this.flipNext();\n        else this.flipPrev();\n        event.preventDefault();\n        break;\n      case 'Home':\n        this.flipTo(0);\n        event.preventDefault();\n        break;\n      case 'End':\n        this.flipTo(this.#source.pageCount - 1);\n        event.preventDefault();\n        break;\n      default:\n        break;\n    }\n  }\n\n  #announce(): void {\n    if (this.#liveRegion) {\n      this.#liveRegion.textContent = `Page ${this.#currentPage + 1} of ${this.#source.pageCount}`;\n    }\n  }\n\n  #effectiveDuration(): number {\n    return this.#reducedMotion ? 0 : this.#flipDuration;\n  }\n\n  /** Re-measure and re-render; call after the container resizes. */\n  update(): void {\n    if (!this.#renderer || this.#machine.state !== 'idle') return;\n    this.#applySinglePage(this.#renderer.measure().containerWidth);\n    void this.#renderCurrent();\n  }\n\n  #applySinglePage(containerWidth: number): void {\n    const single = shouldSinglePage(containerWidth, this.#singlePageThreshold);\n    if (single === this.#singlePage) return;\n    this.#singlePage = single;\n    this.#spreads = buildSpreads(this.#source.pageCount, {\n      direction: this.#direction,\n      cover: this.#cover,\n      singlePage: single,\n    });\n    this.#current = this.#spreadIndexForPage(this.#currentPage);\n  }\n\n  async #renderCurrent(): Promise<void> {\n    const spread = this.#spreads[this.#current];\n    if (!spread || !this.#renderer) return;\n    this.#currentContent = await this.#resolveContent(spread);\n    this.#paintSpread(spread, this.#currentContent);\n  }\n\n  #paintSpread(spread: Spread, content: SpreadContent): void {\n    this.#renderer?.renderSpread(spread, content, { fill: this.#singlePage });\n  }\n\n  #observeResize(): void {\n    if (typeof ResizeObserver === 'undefined') return;\n    this.#resizeObserver = new ResizeObserver(() => this.#scheduleUpdate());\n    this.#resizeObserver.observe(this.#container);\n  }\n\n  #scheduleUpdate(): void {\n    if (this.#updateScheduled) return;\n    this.#updateScheduled = true;\n    requestAnimationFrame(() => {\n      this.#updateScheduled = false;\n      this.update();\n    });\n  }\n\n  async #resolveContent(spread: Spread): Promise<SpreadContent> {\n    const [left, right] = await Promise.all([this.#getPage(spread.left), this.#getPage(spread.right)]);\n    return { left, right };\n  }\n\n  /** Decode one page; on failure emit `sourceError` and degrade to a blank (null) page. */\n  async #getPage(index: number | null): Promise<PageContent | null> {\n    if (index === null) return null;\n    try {\n      return await this.#source.get(index);\n    } catch (error) {\n      this.#emitter.emit('sourceError', { index, error });\n      return null;\n    }\n  }\n\n  #prefetchWindow(): void {\n    const { toMount } = this.#virtualizer.update(this.#current, this.#spreads.length);\n    const pages: number[] = [];\n    for (const index of toMount) {\n      const spread = this.#spreads[index];\n      if (spread?.left != null) pages.push(spread.left);\n      if (spread?.right != null) pages.push(spread.right);\n    }\n    this.#source.prefetch(pages);\n  }\n\n  #spreadIndexForPage(page: number): number {\n    const index = this.#spreads.findIndex((s) => s.left === page || s.right === page);\n    return index === -1 ? 0 : index;\n  }\n\n  /** Validate the (now-known) page count + startPage and build the spread model. */\n  #buildSpreadModel(): void {\n    const pageCount = this.#source.pageCount;\n    if (!Number.isInteger(pageCount) || pageCount < 1) {\n      throw new Error(`Zine: source has ${pageCount} pages; a Source must have at least 1 page.`);\n    }\n    const startPage = this.#startPageOption;\n    if (\n      startPage !== undefined &&\n      (!Number.isInteger(startPage) || startPage < 0 || startPage >= pageCount)\n    ) {\n      throw new Error(\n        `Zine: startPage ${JSON.stringify(startPage)} is out of range for a ${pageCount}-page book (valid 0..${pageCount - 1}).`,\n      );\n    }\n    this.#spreads = buildSpreads(pageCount, { direction: this.#direction, cover: this.#cover });\n    this.#currentPage = clamp(startPage ?? 0, 0, pageCount - 1);\n    this.#current = this.#spreadIndexForPage(this.#currentPage);\n  }\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return value < min ? min : value > max ? max : value;\n}\n\nfunction easeInOutCubic(t: number): number {\n  return t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;\n}\n\nfunction typeName(v: unknown): string {\n  if (v === null) return 'null';\n  if (Array.isArray(v)) return 'array';\n  return typeof v;\n}\n\n/** Validate constructor inputs up front, throwing agent-actionable errors. */\nfunction validateOptions(container: unknown, options: unknown): void {\n  if (\n    typeof container !== 'object' ||\n    container === null ||\n    typeof (container as { appendChild?: unknown }).appendChild !== 'function' ||\n    typeof (container as { addEventListener?: unknown }).addEventListener !== 'function'\n  ) {\n    throw new Error(`Zine: container must be a DOM element; received ${typeName(container)}.`);\n  }\n  if (typeof options !== 'object' || options === null) {\n    throw new Error('Zine: an options object with a `source` is required.');\n  }\n  const o = options as Record<string, unknown>;\n\n  const source = o.source as { get?: unknown; pageCount?: unknown } | undefined;\n  if (\n    typeof source !== 'object' ||\n    source === null ||\n    typeof source.get !== 'function' ||\n    typeof source.pageCount !== 'number'\n  ) {\n    throw new Error('Zine: `source` is required and must be a Source, e.g. new ImageSource(urls).');\n  }\n  // Note: pageCount >= 1 and startPage-in-range are validated in #buildSpreadModel —\n  // synchronously for a sync source, or after open() for an async one (e.g. PdfSource).\n\n  const startPage = o.startPage;\n  if (startPage !== undefined && (typeof startPage !== 'number' || !Number.isInteger(startPage) || startPage < 0)) {\n    throw new Error(`Zine: startPage must be a non-negative integer; got ${JSON.stringify(startPage)}.`);\n  }\n\n  const direction = o.direction;\n  if (direction !== undefined && direction !== 'ltr' && direction !== 'rtl') {\n    throw new Error(`Zine: direction must be 'ltr' or 'rtl'; got ${JSON.stringify(direction)}.`);\n  }\n\n  const clickToFlip = o.clickToFlip;\n  if (clickToFlip !== undefined && !['edge', 'half', 'off'].includes(clickToFlip as string)) {\n    throw new Error(`Zine: clickToFlip must be 'edge', 'half', or 'off'; got ${JSON.stringify(clickToFlip)}.`);\n  }\n\n  assertMin(o.width, 'width', 1);\n  assertMin(o.height, 'height', 1);\n  assertMin(o.flipDuration, 'flipDuration', 0);\n  assertMin(o.clickZoneSize, 'clickZoneSize', 0);\n  assertMin(o.clickFlipDelay, 'clickFlipDelay', 0);\n  assertMin(o.singlePageThreshold, 'singlePageThreshold', 0);\n  validateZoomOption(o.zoom);\n  validateRendererOption(o.renderer);\n}\n\nfunction assertMin(value: unknown, name: string, min: number): void {\n  if (value === undefined) return;\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < min) {\n    throw new Error(`Zine: ${name} must be a number >= ${min}; got ${JSON.stringify(value)}.`);\n  }\n}\n\nfunction validateZoomOption(zoom: unknown): void {\n  if (zoom === undefined) return;\n  if (typeof zoom !== 'object' || zoom === null || Array.isArray(zoom)) {\n    throw new Error('Zine: zoom must be an object, e.g. { max: 4 }.');\n  }\n  const z = zoom as Record<string, unknown>;\n  if (z.enabled !== undefined && typeof z.enabled !== 'boolean') {\n    throw new Error(`Zine: zoom.enabled must be a boolean; got ${JSON.stringify(z.enabled)}.`);\n  }\n  if (z.wheel !== undefined && typeof z.wheel !== 'boolean') {\n    throw new Error(`Zine: zoom.wheel must be a boolean; got ${JSON.stringify(z.wheel)}.`);\n  }\n  if (z.doubleClickInFlipZone !== undefined && typeof z.doubleClickInFlipZone !== 'boolean') {\n    throw new Error(\n      `Zine: zoom.doubleClickInFlipZone must be a boolean; got ${JSON.stringify(z.doubleClickInFlipZone)}.`,\n    );\n  }\n  if (z.doubleClick !== undefined && z.doubleClick !== false) {\n    const levels = z.doubleClick;\n    if (\n      !Array.isArray(levels) ||\n      levels.some((n) => typeof n !== 'number' || !Number.isFinite(n) || n < 1)\n    ) {\n      throw new Error(\n        'Zine: zoom.doubleClick must be false or an array of zoom levels >= 1, e.g. [1, 2, 4].',\n      );\n    }\n  }\n  assertMin(z.max, 'zoom.max', 1);\n}\n\nfunction validateRendererOption(renderer: unknown): void {\n  if (renderer === undefined) return;\n  if (typeof renderer === 'string') {\n    if (renderer !== 'auto' && renderer !== 'css' && renderer !== 'webgl2') {\n      throw new Error(\n        `Zine: renderer '${renderer}' is not recognized; use 'auto', 'css', 'webgl2', an array of those, or a custom Renderer.`,\n      );\n    }\n    return;\n  }\n  if (Array.isArray(renderer)) {\n    for (const kind of renderer) {\n      if (kind !== 'css' && kind !== 'webgl2') {\n        throw new Error(\n          `Zine: renderer order array may only contain 'css' or 'webgl2'; got ${JSON.stringify(kind)}.`,\n        );\n      }\n    }\n    return;\n  }\n  if (\n    typeof renderer === 'object' &&\n    renderer !== null &&\n    typeof (renderer as { mount?: unknown }).mount === 'function'\n  ) {\n    return;\n  }\n  throw new Error(\n    \"Zine: renderer must be 'auto', 'css', 'webgl2', an array of those, or a custom Renderer instance.\",\n  );\n}\n","import type { PageContent } from '../renderer/types';\nimport type { Source } from './types';\n\nexport type ImageFit = 'contain' | 'cover';\n\nexport interface ImageSourceOptions {\n  /** How many adjacent pages to prefetch around a requested page. Default 1. */\n  preload?: number;\n  /** How each image fits its page; a hint consumed by the render layer. Default 'contain'. */\n  fit?: ImageFit;\n}\n\n/**\n * Default content source for image books: decodes a list of image URLs to\n * ImageBitmaps, memoizes them, and prefetches neighbors on access.\n */\nexport class ImageSource implements Source {\n  readonly pageCount: number;\n  readonly fit: ImageFit;\n  #urls: string[];\n  #preload: number;\n  #cache = new Map<number, Promise<ImageBitmap>>();\n\n  constructor(urls: string[], options: ImageSourceOptions = {}) {\n    this.#urls = urls;\n    this.pageCount = urls.length;\n    this.#preload = options.preload ?? 1;\n    this.fit = options.fit ?? 'contain';\n  }\n\n  get(index: number): Promise<PageContent> {\n    const decoded = this.#decode(index);\n    for (let d = 1; d <= this.#preload; d++) {\n      this.prefetch([index - d, index + d]);\n    }\n    return decoded;\n  }\n\n  prefetch(indices: number[]): void {\n    for (const i of indices) {\n      if (i >= 0 && i < this.pageCount) {\n        void this.#decode(i).catch(() => {}); // swallow: prefetch failures surface on real get()\n      }\n    }\n  }\n\n  destroy(): void {\n    for (const pending of this.#cache.values()) {\n      void pending.then((bitmap) => bitmap.close()).catch(() => {});\n    }\n    this.#cache.clear();\n  }\n\n  #decode(index: number): Promise<ImageBitmap> {\n    const cached = this.#cache.get(index);\n    if (cached) return cached;\n\n    const url = this.#urls[index];\n    if (url === undefined) {\n      return Promise.reject(\n        new RangeError(`ImageSource: page ${index} is out of range (0..${this.pageCount - 1}).`),\n      );\n    }\n\n    const promise = (async () => {\n      const res = await fetch(url);\n      if (!res.ok) {\n        throw new Error(`ImageSource: failed to fetch page ${index} (${url}) — HTTP ${res.status}.`);\n      }\n      return createImageBitmap(await res.blob());\n    })().catch((err: unknown) => {\n      this.#cache.delete(index); // drop the failed entry so a later get() can retry\n      throw err;\n    });\n\n    this.#cache.set(index, promise);\n    return promise;\n  }\n}\n"],"mappings":"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"}

package/dist/renderer/cssRenderer.d.ts

@@ -0,0 +1,18 @@
+import type { Spread } from '../engine/spread';
+import type { FlipDirection, LayoutMetrics, Renderer, RenderOptions, SpreadContent } from './types';
+/**
+ * Baseline renderer: a 2-panel CSS-3D fold. Runs on every browser, no GPU. Pages
+ * are <canvas> elements; the turning leaf (front + back faces, backface-hidden)
+ * rotates about the spine driven by flipProgressToPose(), with a gradient shadow
+ * overlay for depth. `beginFlip` stages the surfaces; `setFlipProgress` animates.
+ */
+export declare class CssRenderer implements Renderer {
+    #private;
+    mount(container: HTMLElement): Promise<void>;
+    destroy(): void;
+    renderSpread(_spread: Spread, content: SpreadContent, options?: RenderOptions): void;
+    beginFlip(from: SpreadContent, to: SpreadContent, direction: FlipDirection, options?: RenderOptions): void;
+    setFlipProgress(t: number, direction: FlipDirection): void;
+    setViewTransform(scale: number, x: number, y: number): void;
+    measure(): LayoutMetrics;
+}

package/dist/renderer/gl/context.d.ts

@@ -0,0 +1,2 @@
+/** Create a WebGL2 context, or throw so the caller can fall back to CSS (§8.4). */
+export declare function createGlContext(canvas: HTMLCanvasElement): WebGL2RenderingContext;

package/dist/renderer/gl/program.d.ts

@@ -0,0 +1,2 @@
+/** Compile + link a shader program; throws with the driver log on failure. */
+export declare function createProgram(gl: WebGL2RenderingContext, vertexSrc: string, fragmentSrc: string): WebGLProgram;

package/dist/renderer/gl/texture.d.ts

@@ -0,0 +1,4 @@
+/** Create a page texture with clamp + linear filtering (no mipmaps — §8.3). */
+export declare function createTexture(gl: WebGL2RenderingContext): WebGLTexture;
+/** Upload a decoded page raster (ImageBitmap or canvas) into `tex`. */
+export declare function uploadTexture(gl: WebGL2RenderingContext, tex: WebGLTexture, source: TexImageSource): void;

package/dist/renderer/select.d.ts

@@ -0,0 +1,21 @@
+import type { Renderer } from './types';
+export type RendererKind = 'css' | 'webgl2';
+/**
+ * How the consumer chooses a renderer:
+ * - `'auto'` (default): prefer the GPU path (WebGL2), else CSS.
+ * - a single kind: force it (`'webgl2'` throws if the device has no WebGL2).
+ * - an ordered array: try each in turn, first viable wins.
+ * - a `Renderer` instance: use it as-is (custom implementation, §6.1/§11).
+ */
+export type RendererOption = 'auto' | RendererKind | RendererKind[] | Renderer;
+export interface Capabilities {
+    /** WebGL2 available — the GPU renderer's only backend. */
+    gpu: boolean;
+}
+/** Detect WebGL2 support — the GPU renderer's only backend (no WebGL1, no WebGPU). */
+export declare function detectCapabilities(): Capabilities;
+/**
+ * Resolve the `renderer` option to a mounted renderer instance, lazy-loading its
+ * chunk. Throws an agent-actionable error if nothing viable can be loaded.
+ */
+export declare function selectRenderer(option?: RendererOption, caps?: Capabilities): Promise<Renderer>;

package/dist/renderer/types.d.ts

@@ -0,0 +1,54 @@
+import type { Spread } from '../engine/spread';
+/** A decoded, ready-to-paint raster for one page (produced by a content source). */
+export type PageContent = ImageBitmap | HTMLCanvasElement;
+/** Resolved content for the two halves of a spread; null = blank side. */
+export interface SpreadContent {
+    left: PageContent | null;
+    right: PageContent | null;
+}
+export type FlipDirection = 'forward' | 'backward';
+export interface RenderOptions {
+    /** Render a lone page filling the container (single-page mode), not a half panel. */
+    fill?: boolean;
+}
+/** Layout metrics the engine needs for geometry and mode decisions. */
+export interface LayoutMetrics {
+    containerWidth: number;
+    containerHeight: number;
+    pageWidth: number;
+    pageHeight: number;
+}
+/**
+ * The contract every renderer implements (CSS baseline, WebGL2/GPU). The engine
+ * drives it and never reaches past it, so the renderers are interchangeable and
+ * behaviorally identical (PRD §8). One is selected at init; a device fetches one.
+ */
+export interface Renderer {
+    /** Attach to a container. Async to accommodate GPU context init (WebGL2). */
+    mount(container: HTMLElement): Promise<void>;
+    /** Tear down: remove DOM/listeners, release any GPU context. */
+    destroy(): void;
+    /** Paint a spread from already-resolved page rasters (static, no flip). */
+    renderSpread(spread: Spread, content: SpreadContent, options?: RenderOptions): void;
+    /**
+     * Set up a flip: the turning leaf's front is `from`'s leading page and its back
+     * is `to`'s facing page, with the destination revealed underneath. Call once at
+     * flip start, then drive `setFlipProgress`.
+     */
+    beginFlip(from: SpreadContent, to: SpreadContent, direction: FlipDirection, options?: RenderOptions): void;
+    /**
+     * Drive the turning page to progress `t` (0..1) in `direction`. Also the stable
+     * seek API used by visual-regression tests (call `beginFlip` first to stage content).
+     */
+    setFlipProgress(t: number, direction: FlipDirection): void;
+    /** Apply zoom/pan: uniform `scale` about the viewport, translated by (x, y). */
+    setViewTransform(scale: number, x: number, y: number): void;
+    /** Current layout metrics (container + page dimensions). */
+    measure(): LayoutMetrics;
+    /**
+     * Optional: register a handler the renderer calls when it hits an unrecoverable
+     * state (e.g. a GPU context that cannot be restored), so the engine can swap to
+     * the CSS fallback (§8.4). Renderers that cannot fail this way omit it.
+     */
+    onFatal?(handler: () => void): void;
+}

package/dist/renderer/webglRenderer.d.ts

@@ -0,0 +1,19 @@
+import type { Spread } from '../engine/spread';
+import type { FlipDirection, LayoutMetrics, Renderer, RenderOptions, SpreadContent } from './types';
+/**
+ * GPU renderer (WebGL2, hand-written, no third-party library). The turning leaf is
+ * a grid mesh bent around a cylinder (driven by the shared flipProgressToPose), the
+ * static pages are flat textured quads underneath. Restores its GL state in place on
+ * context loss; if that fails it signals `onFatal` so the engine can fall back to CSS.
+ */
+export declare class WebglRenderer implements Renderer {
+    #private;
+    mount(container: HTMLElement): Promise<void>;
+    destroy(): void;
+    onFatal(handler: () => void): void;
+    renderSpread(_spread: Spread, content: SpreadContent, options?: RenderOptions): void;
+    beginFlip(from: SpreadContent, to: SpreadContent, direction: FlipDirection, options?: RenderOptions): void;
+    setFlipProgress(t: number, direction: FlipDirection): void;
+    setViewTransform(scale: number, x: number, y: number): void;
+    measure(): LayoutMetrics;
+}

package/dist/source/imageSource.d.ts

@@ -0,0 +1,22 @@
+import type { PageContent } from '../renderer/types';
+import type { Source } from './types';
+export type ImageFit = 'contain' | 'cover';
+export interface ImageSourceOptions {
+    /** How many adjacent pages to prefetch around a requested page. Default 1. */
+    preload?: number;
+    /** How each image fits its page; a hint consumed by the render layer. Default 'contain'. */
+    fit?: ImageFit;
+}
+/**
+ * Default content source for image books: decodes a list of image URLs to
+ * ImageBitmaps, memoizes them, and prefetches neighbors on access.
+ */
+export declare class ImageSource implements Source {
+    #private;
+    readonly pageCount: number;
+    readonly fit: ImageFit;
+    constructor(urls: string[], options?: ImageSourceOptions);
+    get(index: number): Promise<PageContent>;
+    prefetch(indices: number[]): void;
+    destroy(): void;
+}

package/dist/source/types.d.ts

@@ -0,0 +1,21 @@
+import type { PageContent } from '../renderer/types';
+/**
+ * Resolves page indices to renderable rasters. `ImageSource` is the default; a
+ * `PdfSource` (Phase 3) implements the same shape. Output is renderer-agnostic —
+ * the same raster feeds the CSS and WebGL2 renderers.
+ */
+export interface Source {
+    readonly pageCount: number;
+    /**
+     * Optional async initialization (e.g. loading a PDF to learn its page count).
+     * Zine awaits this before reading `pageCount` / building spreads. Sources with a
+     * synchronously-known page count (e.g. ImageSource) can omit it.
+     */
+    open?(): Promise<void>;
+    /** Decode/resolve a single page to a raster. */
+    get(index: number): Promise<PageContent>;
+    /** Hint that these pages will be needed soon; out-of-range indices are ignored. */
+    prefetch(indices: number[]): void;
+    /** Release any decoded resources. */
+    destroy(): void;
+}