@weasel-js/labkit 1.4.4 → 1.5.0

package/dist/chunk-QLSV2N3G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/surface/composeRects.ts","../src/surface/deviceRect.ts","../src/surface/useTiledSurface.ts"],"names":[],"mappings":"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","file":"chunk-QLSV2N3G.js","sourcesContent":["import type { Box, Rect } from './rect';\n\n/** Every tile's box expressed against the container's origin. */\nexport function composeRects(container: Box, tiles: ReadonlyMap<string, Box>): Map<string, Rect> {\n  const out = new Map<string, Rect>();\n  for (const [id, tile] of tiles) {\n    out.set(id, {\n      x: tile.left - container.left,\n      y: tile.top - container.top,\n      w: tile.width,\n      h: tile.height,\n    });\n  }\n  return out;\n}\n\nexport function rectsEqual(a: Rect | undefined, b: Rect): boolean {\n  return a !== undefined && a.x === b.x && a.y === b.y && a.w === b.w && a.h === b.h;\n}\n","import type { Rect } from './rect';\n\n/**\n * A DOM rect as a GL viewport rect: origin at the bottom-left, every edge snapped\n * to the device-pixel grid. Still CSS pixels, because three.js applies its own\n * pixel ratio — snapping here is what stops a tile and its neighbour rounding\n * apart and leaving a hairline column between them.\n */\nexport function toDeviceRect(rect: Rect, surfaceHeight: number, dpr: number): Rect {\n  const snap = (v: number) => Math.round(v * dpr) / dpr;\n  const x = snap(rect.x);\n  const y = snap(surfaceHeight - rect.y - rect.h);\n  return {\n    x,\n    y,\n    w: snap(rect.x + rect.w) - x,\n    h: snap(surfaceHeight - rect.y) - y,\n  };\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { useCallback, useEffect, useRef } from 'react';\nimport { composeRects, rectsEqual } from './composeRects';\nimport type { Box, Rect } from './rect';\n\n/** What a surface owner is handed once per animation frame. `rects` carries every\n *  tile, not only the dirty ones: a scissored draw has to know where it is drawing\n *  relative to a surface that may have resized under it.\n *\n *  Its keys are what `useTileId` returns — `<trial>/<id>` for a tile registered\n *  inside a trial — not the bare id the tile was named with. */\nexport interface SurfaceFrame {\n  dirty: ReadonlySet<string>;\n  rects: ReadonlyMap<string, Rect>;\n  dpr: number;\n  size: { width: number; height: number };\n  /** The tile geometry changed this frame — a tile moved, resized, appeared or\n   *  went away, or the dpr did. Every tile is dirty on such a frame, but the\n   *  pixels a tile vacated are in no tile's scissor now, so the owner clears\n   *  the whole buffer. `<Lab>` does; a host owning its own surface must too. */\n  retiled: boolean;\n}\n\n/** The invalidators and the two ref callbacks that publish geometry. */\nexport interface SurfaceHandle {\n  /** Mark one tile for redraw. */\n  invalidate: (id: string) => void;\n  /** Mark every tile — what a resize or a tile-set change means. */\n  invalidateAll: () => void;\n  /** Re-measure before the next frame. The escape hatch for a host that knows it\n   *  moved something a ResizeObserver cannot see. */\n  invalidateRects: () => void;\n  registerTile: (id: string, el: HTMLElement | null) => void;\n  /** Register a tenant's whole-buffer clear. Every one registered runs, before\n   *  any painter, on a frame where the tile geometry changed — the pixels a\n   *  tile vacated are in no scissor now, and only the context that drew them\n   *  can erase them. Backend-agnostic by necessity: labkit owns the canvas,\n   *  never the context. */\n  registerClear: (id: string, clear: SurfaceClear) => () => void;\n  /** Subscribe a tile to the frames it is dirty on. A tile paints on its own\n   *  loop, so this is how the surface wakes one: a resize of the shared buffer\n   *  clears every tile, not only the one that moved. */\n  registerPainter: (id: string, paint: TilePainter) => () => void;\n  containerRef: (el: HTMLElement | null) => void;\n  /** The element tile rects are measured against, and so the one a tile's own\n   *  chrome positions itself inside. Null before the owner attaches it. */\n  getContainer: () => HTMLElement | null;\n}\n\n/** What a tile's painter is handed: where it sits on the surface now, and the\n *  frame that dirtied it. */\nexport type TilePainter = (rect: Rect, frame: SurfaceFrame) => void;\n\n/** Erase the whole shared buffer. Device pixels, because that is what a GL\n *  viewport takes. */\nexport type SurfaceClear = (size: { width: number; height: number }, dpr: number) => void;\n\nexport interface UseTiledSurfaceOptions {\n  onFrame: (frame: SurfaceFrame) => void;\n}\n\nexport function useTiledSurface({ onFrame }: UseTiledSurfaceOptions): SurfaceHandle {\n  const container = useRef<HTMLElement | null>(null);\n  const tiles = useRef(new Map<string, HTMLElement>());\n  const rects = useRef(new Map<string, Rect>());\n  const dirty = useRef(new Set<string>());\n  const painters = useRef(new Map<string, TilePainter>());\n  const clears = useRef(new Map<string, SurfaceClear>());\n  const needsMeasure = useRef(true);\n  const observer = useRef<ResizeObserver | null>(null);\n  const lastDpr = useRef(0);\n\n  // Held in a ref so a caller passing an inline closure does not re-create every\n  // callback below on each render.\n  const onFrameRef = useRef(onFrame);\n  onFrameRef.current = onFrame;\n\n  const measure = useCallback((): boolean => {\n    const el = container.current;\n    if (!el) return false;\n    const boxes = new Map<string, Box>();\n    for (const [id, tile] of tiles.current) boxes.set(id, tile.getBoundingClientRect());\n    const next = composeRects(el.getBoundingClientRect(), boxes);\n    let changed = next.size !== rects.current.size;\n    for (const [id, rect] of next) {\n      if (!rectsEqual(rects.current.get(id), rect)) changed = true;\n    }\n    rects.current = next;\n    return changed;\n  }, []);\n\n  const frameLoop = useVisibleRaf(\n    () => {\n      const el = container.current;\n      if (!el) {\n        dirty.current.clear();\n        return;\n      }\n      let retiled = false;\n      if (needsMeasure.current) {\n        needsMeasure.current = false;\n        if (measure()) {\n          retiled = true;\n          for (const id of rects.current.keys()) dirty.current.add(id);\n          // Geometry that changed may still be moving: a panel whose size has\n          // settled while its position animates gives `ResizeObserver` nothing\n          // more to report, and the tile would hold the frame it was caught\n          // mid-flight at. Measure again next frame, and keep going until a\n          // measurement finds nothing moved.\n          needsMeasure.current = true;\n          schedule();\n        }\n      }\n      const dpr = globalThis.devicePixelRatio ?? 1;\n      if (dpr !== lastDpr.current) {\n        lastDpr.current = dpr;\n        retiled = true;\n        for (const id of rects.current.keys()) dirty.current.add(id);\n      }\n      if (dirty.current.size === 0) return;\n      const box = el.getBoundingClientRect();\n      const frame: SurfaceFrame = {\n        dirty: new Set(dirty.current),\n        rects: new Map(rects.current),\n        dpr,\n        size: { width: box.width, height: box.height },\n        retiled,\n      };\n      // Cleared before the owner runs, not after the painters: sizing the\n      // buffer blanks every tile, so the owner answers with `invalidateAll`,\n      // and a set cleared at the end of the frame would swallow it.\n      dirty.current.clear();\n      onFrameRef.current(frame);\n      // After the owner sized the buffer, before anything paints into it.\n      if (retiled) {\n        for (const clear of clears.current.values()) clear(frame.size, dpr);\n      }\n      // After the owner, which is what resized the buffer this frame — and\n      // whatever it just dirtied paints now rather than a frame later.\n      const painting = new Set(frame.dirty);\n      for (const id of dirty.current) painting.add(id);\n      dirty.current.clear();\n      const paintFrame: SurfaceFrame = { ...frame, dirty: painting };\n      for (const id of painting) {\n        const rect = frame.rects.get(id);\n        if (rect) painters.current.get(id)?.(rect, paintFrame);\n      }\n    },\n    // The host attaches its container through `containerRef`, which may land\n    // well after this hook's first effect; the gate re-resolves it per request.\n    { target: () => container.current },\n  );\n\n  const schedule = useCallback(() => {\n    frameLoop.request();\n  }, [frameLoop]);\n\n  const invalidate = useCallback(\n    (id: string) => {\n      dirty.current.add(id);\n      schedule();\n    },\n    [schedule],\n  );\n\n  const invalidateAll = useCallback(() => {\n    for (const id of tiles.current.keys()) dirty.current.add(id);\n    schedule();\n  }, [schedule]);\n\n  const invalidateRects = useCallback(() => {\n    needsMeasure.current = true;\n    schedule();\n  }, [schedule]);\n\n  const registerTile = useCallback(\n    (id: string, el: HTMLElement | null) => {\n      const known = tiles.current.get(id);\n      if (known === el) return;\n      if (known) observer.current?.unobserve(known);\n      if (el) {\n        tiles.current.set(id, el);\n        observer.current?.observe(el);\n      } else {\n        tiles.current.delete(id);\n        rects.current.delete(id);\n        dirty.current.delete(id);\n      }\n      needsMeasure.current = true;\n      schedule();\n    },\n    [schedule],\n  );\n\n  const registerClear = useCallback((id: string, clear: SurfaceClear) => {\n    clears.current.set(id, clear);\n    return () => {\n      if (clears.current.get(id) === clear) clears.current.delete(id);\n    };\n  }, []);\n\n  const registerPainter = useCallback((id: string, paint: TilePainter) => {\n    painters.current.set(id, paint);\n    return () => {\n      if (painters.current.get(id) === paint) painters.current.delete(id);\n    };\n  }, []);\n\n  const getContainer = useCallback(() => container.current, []);\n\n  const containerRef = useCallback(\n    (el: HTMLElement | null) => {\n      if (container.current === el) return;\n      if (container.current) observer.current?.unobserve(container.current);\n      container.current = el;\n      if (el) observer.current?.observe(el);\n      needsMeasure.current = true;\n      schedule();\n    },\n    [schedule],\n  );\n\n  useEffect(() => {\n    const ro = new ResizeObserver(() => {\n      needsMeasure.current = true;\n      schedule();\n    });\n    observer.current = ro;\n    if (container.current) ro.observe(container.current);\n    for (const el of tiles.current.values()) ro.observe(el);\n    return () => {\n      ro.disconnect();\n      observer.current = null;\n      frameLoop.cancel();\n    };\n  }, [schedule, frameLoop]);\n\n  return {\n    invalidate,\n    invalidateAll,\n    invalidateRects,\n    registerTile,\n    registerClear,\n    registerPainter,\n    containerRef,\n    getContainer,\n  };\n}\n"]}