@zkmake/three-audit 0.2.1 → 0.3.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/patch.ts","../src/black-frames.ts","../src/draw-ledger.ts","../src/console-helpers.ts"],"sourcesContent":["/** Swap `key` on `target` for `value`; the returned function puts back exactly what was there. */\nexport const patch = <Target extends object, Key extends keyof Target>(\n  target: Target,\n  key: Key,\n  value: Target[Key],\n) => {\n  const own = Object.hasOwn(target, key);\n  const original = target[key];\n\n  target[key] = value;\n\n  return () => {\n    if (own) {\n      target[key] = original;\n    } else {\n      delete target[key];\n    }\n  };\n};\n","/**\n * Black-frame probe: after each frame, samples a grid of the drawing buffer and counts frames\n * where several samples are pure black. Catches the flash a NaN pixel makes once bloom spreads it,\n * which lasts one frame in twenty and never shows in a screenshot.\n *\n * WebGL only (`readPixels`). Each sample stalls the GPU pipeline, so watch, read, stop.\n */\nimport type { Camera, Object3D } from \"three\";\n\nimport { patch } from \"./patch.ts\";\n\n/** The `WebGLRenderer` methods the probe uses. */\nexport type ProbeRenderer = {\n  render(scene: Object3D, camera: Camera): void;\n  getContext(): unknown;\n  getRenderTarget(): unknown;\n};\n\nexport type BlackFrameOptions = {\n  /** Samples per side: 3 reads a 3 × 3 grid at the quarter lines. */\n  grid?: number;\n  /** Black samples that make a frame black. */\n  threshold?: number;\n};\n\nexport type BlackFrameWatch = {\n  /** Frames sampled since the start or the last `reset()`. */\n  readonly frames: number;\n  /** Which of those frames (1-based) were black. */\n  readonly blackFrames: readonly number[];\n  reset: () => void;\n  /** Restore the renderer and stop sampling. */\n  stop: () => void;\n};\n\ntype ReadPixels = Pick<\n  WebGLRenderingContext,\n  \"RGBA\" | \"UNSIGNED_BYTE\" | \"drawingBufferHeight\" | \"drawingBufferWidth\" | \"readPixels\"\n>;\n\n/**\n * Sample every frame the app draws to the screen. Several screen renders in one frame (an overlay\n * redrawn after the composer) count once, as the last of them: the image the display shows.\n * Browser only: frames are told apart by `requestAnimationFrame`.\n */\nexport const watchBlackFrames = (\n  renderer: ProbeRenderer,\n  options: BlackFrameOptions = {},\n): BlackFrameWatch => {\n  const context = renderer.getContext() as Partial<ReadPixels> | null;\n\n  if (typeof context?.readPixels !== \"function\") {\n    throw new TypeError(\"three-audit: the black-frame probe needs a WebGLRenderer\");\n  }\n\n  if (typeof requestAnimationFrame !== \"function\") {\n    throw new TypeError(\"three-audit: the black-frame probe needs requestAnimationFrame\");\n  }\n\n  const gl = context as ReadPixels;\n  const grid = options.grid ?? 3;\n  const threshold = options.threshold ?? 3;\n  const pixel = new Uint8Array(4);\n  const render = renderer.render;\n  let frames = 0;\n  let black: number[] = [];\n  let pending: boolean | null = null;\n\n  const isBlack = () => {\n    let count = 0;\n\n    for (let i = 1; i <= grid; i += 1) {\n      for (let j = 1; j <= grid; j += 1) {\n        const x = Math.floor((gl.drawingBufferWidth * i) / (grid + 1));\n        const y = Math.floor((gl.drawingBufferHeight * j) / (grid + 1));\n\n        gl.readPixels(x, y, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, pixel);\n\n        if (pixel[0]! < 4 && pixel[1]! < 4 && pixel[2]! < 4 && pixel[3]! > 250) {\n          count += 1;\n        }\n      }\n    }\n\n    return count >= threshold;\n  };\n\n  // Commit the frame's last screen sample once per animation frame.\n  let raf = 0;\n  const commit = () => {\n    if (pending !== null) {\n      frames += 1;\n\n      if (pending) {\n        black.push(frames);\n      }\n\n      pending = null;\n    }\n\n    raf = requestAnimationFrame(commit);\n  };\n\n  raf = requestAnimationFrame(commit);\n\n  const restore = patch(renderer, \"render\", function (this: unknown, scene, camera) {\n    render.call(this, scene, camera);\n\n    // Read before the browser presents (and, without preserveDrawingBuffer, clears) the buffer.\n    if (renderer.getRenderTarget() === null) {\n      pending = isBlack();\n    }\n  });\n\n  return {\n    get frames() {\n      return frames;\n    },\n    get blackFrames() {\n      return black;\n    },\n    reset: () => {\n      frames = 0;\n      black = [];\n      pending = null;\n    },\n    stop: () => {\n      cancelAnimationFrame(raf);\n      restore();\n    },\n  };\n};\n","/**\n * A ledger of every draw call over one frame: which object drew, in which pass. Exact counts from\n * the renderer itself, where `renderer.info` gives one total (and resets it every `render()`).\n *\n * WebGL only: it wraps `WebGLRenderer.renderBufferDirect`, which every draw goes through, and\n * `render()`, to tell passes apart. Draws with a depth or distance material are the shadow maps.\n */\nimport type { BufferGeometry, Camera, Material, Object3D, Scene } from \"three\";\n\nimport { patch } from \"./patch.ts\";\n\n/** The two `WebGLRenderer` methods the ledger wraps. */\nexport type LedgerRenderer = {\n  render(scene: Object3D, camera: Camera): void;\n  renderBufferDirect(\n    camera: Camera,\n    scene: Scene | null,\n    geometry: BufferGeometry,\n    material: Material,\n    object: Object3D,\n    group: unknown,\n  ): void;\n};\n\nexport type DrawLedgerOptions = {\n  /**\n   * The group an object name files under. Default: up to the first `:` or `#`, so a bake's\n   * `wagon:paint` and a strip's `grass#3` group as `wagon` and `grass`.\n   */\n  groupOf?: (name: string) => string;\n};\n\nexport type LedgerRow = {\n  name: string;\n  total: number;\n  /** Draws per pass name. */\n  passes: Record<string, number>;\n};\n\nexport type DrawLedger = {\n  /**\n   * Pass names in the order they first drew: `shadow`, then each `render()` call as its scene's\n   * name, or `render 1`, `render 2`… when unnamed (a post-processing chain is several).\n   */\n  passes: string[];\n  /** By group, most draws first. */\n  groups: LedgerRow[];\n  /** By object name, most draws first. */\n  objects: LedgerRow[];\n  draws: number;\n};\n\nexport type DrawLedgerRecording = {\n  /** Restore the renderer and return what was drawn since `beginDrawLedger`. */\n  end: () => DrawLedger;\n};\n\nconst defaultGroupOf = (name: string) => name.split(/[:#]/)[0] || name;\n\nconst nameOf = (object: Object3D, material: Material) =>\n  object.name || `${object.type}:${material.name || material.type}`;\n\nconst tally = (rows: Map<string, LedgerRow>, name: string, pass: string) => {\n  const row = rows.get(name) ?? { name, total: 0, passes: {} };\n\n  row.total += 1;\n  row.passes[pass] = (row.passes[pass] ?? 0) + 1;\n  rows.set(name, row);\n};\n\nconst sorted = (rows: Map<string, LedgerRow>) =>\n  [...rows.values()].sort((a, b) => b.total - a.total);\n\n/** Start counting every draw. Call `end()` after the frame to restore the renderer and read it. */\nexport const beginDrawLedger = (\n  renderer: LedgerRenderer,\n  options: DrawLedgerOptions = {},\n): DrawLedgerRecording => {\n  if (typeof renderer.renderBufferDirect !== \"function\") {\n    throw new TypeError(\"three-audit: the draw ledger needs a WebGLRenderer\");\n  }\n\n  const groupOf = options.groupOf ?? defaultGroupOf;\n  const render = renderer.render;\n  const renderBufferDirect = renderer.renderBufferDirect;\n  const passes: string[] = [];\n  const objects = new Map<string, LedgerRow>();\n  const groups = new Map<string, LedgerRow>();\n  let renders = 0;\n  let current = \"direct\";\n  let draws = 0;\n\n  const restoreRender = patch(renderer, \"render\", function (this: unknown, scene, camera) {\n    const outer = current;\n\n    renders += 1;\n    current = scene.name || `render ${renders}`;\n\n    try {\n      render.call(this, scene, camera);\n    } finally {\n      current = outer;\n    }\n  });\n\n  const restoreDraw = patch(\n    renderer,\n    \"renderBufferDirect\",\n    function (this: unknown, camera, scene, geometry, material, object, group) {\n      const shadow =\n        (material as { isMeshDepthMaterial?: boolean }).isMeshDepthMaterial === true ||\n        (material as { isMeshDistanceMaterial?: boolean }).isMeshDistanceMaterial === true;\n      const pass = shadow ? \"shadow\" : current;\n      const name = nameOf(object, material);\n\n      if (!passes.includes(pass)) {\n        passes.push(pass);\n      }\n\n      draws += 1;\n      tally(objects, name, pass);\n      tally(groups, groupOf(name), pass);\n      renderBufferDirect.call(this, camera, scene, geometry, material, object, group);\n    },\n  );\n\n  return {\n    end: () => {\n      restoreDraw();\n      restoreRender();\n\n      return { passes, groups: sorted(groups), objects: sorted(objects), draws };\n    },\n  };\n};\n\n/**\n * Record exactly one frame of an app that renders from `requestAnimationFrame` (three's\n * `setAnimationLoop`, React Three Fiber): from one animation frame to the next. A demand-driven\n * loop that renders nothing that frame gives an empty ledger. Browser only.\n */\nexport const recordDrawLedger = (renderer: LedgerRenderer, options: DrawLedgerOptions = {}) =>\n  new Promise<DrawLedger>((resolve, reject) => {\n    if (typeof requestAnimationFrame !== \"function\") {\n      reject(new Error(\"three-audit: recordDrawLedger needs requestAnimationFrame\"));\n\n      return;\n    }\n\n    requestAnimationFrame(() => {\n      try {\n        const recording = beginDrawLedger(renderer, options);\n\n        requestAnimationFrame(() => resolve(recording.end()));\n      } catch (error) {\n        reject(error);\n      }\n    });\n  });\n\n/** Rows shaped for `console.table`: one column per pass, then the total. */\nexport const ledgerTable = (rows: LedgerRow[], passes: string[]) =>\n  rows.map((row) => ({\n    name: row.name,\n    ...Object.fromEntries(passes.map((pass) => [pass, row.passes[pass] ?? 0])),\n    total: row.total,\n  }));\n\n/** The ledger as two console tables: by group, and every object collapsed beneath. */\nexport const printDrawLedger = (ledger: DrawLedger) => {\n  /* oxlint-disable no-console -- printing is this function's job */\n  console.group(`Draw ledger: ${ledger.draws} draws in one frame`);\n  console.table(ledgerTable(ledger.groups, ledger.passes));\n  console.groupCollapsed(\"Every object\");\n  console.table(ledgerTable(ledger.objects, ledger.passes));\n  console.groupEnd();\n  console.groupEnd();\n  /* oxlint-enable no-console */\n};\n","/**\n * The checks as short console globals, for a dev page or a headless browser's `eval`:\n * `tris()`, `meshes()`, `census()`, `audit()`, `zfight()`, `report()`, and with a renderer\n * `ledger()` and `blackFrames()`.\n */\nimport type { Object3D } from \"three\";\n\nimport { auditScene } from \"./audit-scene.ts\";\nimport { findBadGeometry } from \"./bad-geometry.ts\";\nimport { type ProbeRenderer, watchBlackFrames } from \"./black-frames.ts\";\nimport { type LedgerRenderer, printDrawLedger, recordDrawLedger } from \"./draw-ledger.ts\";\nimport type { Skip } from \"./scene.ts\";\nimport { countTriangles, geometryCensus, listMeshes } from \"./triangles.ts\";\nimport { findZFighting } from \"./z-fighting.ts\";\n\nexport type AuditHelpersOptions = {\n  /** A `WebGLRenderer`, for `ledger()` and `blackFrames()`. */\n  renderer?: (LedgerRenderer & ProbeRenderer) | undefined;\n  skip?: Skip | undefined;\n  tagKey?: string;\n};\n\nconst NAMES = [\n  \"auditRoot\",\n  \"tris\",\n  \"meshes\",\n  \"census\",\n  \"audit\",\n  \"zfight\",\n  \"report\",\n  \"ledger\",\n  \"blackFrames\",\n] as const;\n\nconst needsRenderer = (name: string) => () => {\n  throw new Error(`three-audit: ${name}() needs installAuditHelpers(scene, { renderer })`);\n};\n\n/**\n * Put the helpers on `globalThis`. Returns a function that removes them.\n *\n *   vanilla: installAuditHelpers(scene, { renderer })\n *   R3F:     const { scene, gl } = useThree();\n *            useLayoutEffect(() => installAuditHelpers(scene, { renderer: gl }), [scene, gl]);\n */\nexport const installAuditHelpers = (root: Object3D, options: AuditHelpersOptions = {}) => {\n  const { renderer, skip } = options;\n  const tagKey = options.tagKey ?? \"studioObject\";\n\n  const helpers: Record<(typeof NAMES)[number], unknown> = {\n    auditRoot: root,\n    tris: () => countTriangles(root, { skip }),\n    meshes: () => listMeshes(root, { skip }),\n    census: () => geometryCensus(root, { skip }),\n    audit: () => findBadGeometry(root, { skip, tagKey }),\n    zfight: (gap?: number, self?: boolean) =>\n      findZFighting(root, {\n        skip,\n        tagKey,\n        ...(gap === undefined ? {} : { gap }),\n        ...(self === undefined ? {} : { self }),\n      }),\n    report: () => auditScene(root, { skip, tagKey }),\n    ledger: renderer\n      ? async () => {\n          const ledger = await recordDrawLedger(renderer);\n\n          printDrawLedger(ledger);\n\n          return ledger;\n        }\n      : needsRenderer(\"ledger\"),\n    blackFrames: renderer\n      ? (seconds = 10) =>\n          new Promise<{ frames: number; blackFrames: readonly number[] }>((resolve) => {\n            const watch = watchBlackFrames(renderer);\n\n            setTimeout(() => {\n              watch.stop();\n              resolve({ frames: watch.frames, blackFrames: watch.blackFrames });\n            }, seconds * 1000);\n          })\n      : needsRenderer(\"blackFrames\"),\n  };\n\n  Object.assign(globalThis, helpers);\n\n  return () => {\n    const scope = globalThis as Record<string, unknown>;\n\n    for (const name of NAMES) {\n      if (scope[name] === helpers[name]) {\n        delete scope[name];\n      }\n    }\n  };\n};\n"],"mappings":";;;AACA,MAAa,SACX,QACA,KACA,UACG;CACH,MAAM,MAAM,OAAO,OAAO,QAAQ,GAAG;CACrC,MAAM,WAAW,OAAO;CAExB,OAAO,OAAO;CAEd,aAAa;EACX,IAAI,KACF,OAAO,OAAO;OAEd,OAAO,OAAO;CAElB;AACF;;;;;;;;AC2BA,MAAa,oBACX,UACA,UAA6B,CAAC,MACV;CACpB,MAAM,UAAU,SAAS,WAAW;CAEpC,IAAI,OAAO,SAAS,eAAe,YACjC,MAAM,IAAI,UAAU,0DAA0D;CAGhF,IAAI,OAAO,0BAA0B,YACnC,MAAM,IAAI,UAAU,gEAAgE;CAGtF,MAAM,KAAK;CACX,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,wBAAQ,IAAI,WAAW,CAAC;CAC9B,MAAM,SAAS,SAAS;CACxB,IAAI,SAAS;CACb,IAAI,QAAkB,CAAC;CACvB,IAAI,UAA0B;CAE9B,MAAM,gBAAgB;EACpB,IAAI,QAAQ;EAEZ,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,KAAK,GAC9B,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,KAAK,GAAG;GACjC,MAAM,IAAI,KAAK,MAAO,GAAG,qBAAqB,KAAM,OAAO,EAAE;GAC7D,MAAM,IAAI,KAAK,MAAO,GAAG,sBAAsB,KAAM,OAAO,EAAE;GAE9D,GAAG,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,eAAe,KAAK;GAE1D,IAAI,MAAM,KAAM,KAAK,MAAM,KAAM,KAAK,MAAM,KAAM,KAAK,MAAM,KAAM,KACjE,SAAS;EAEb;EAGF,OAAO,SAAS;CAClB;CAGA,IAAI,MAAM;CACV,MAAM,eAAe;EACnB,IAAI,YAAY,MAAM;GACpB,UAAU;GAEV,IAAI,SACF,MAAM,KAAK,MAAM;GAGnB,UAAU;EACZ;EAEA,MAAM,sBAAsB,MAAM;CACpC;CAEA,MAAM,sBAAsB,MAAM;CAElC,MAAM,UAAU,MAAM,UAAU,UAAU,SAAyB,OAAO,QAAQ;EAChF,OAAO,KAAK,MAAM,OAAO,MAAM;EAG/B,IAAI,SAAS,gBAAgB,MAAM,MACjC,UAAU,QAAQ;CAEtB,CAAC;CAED,OAAO;EACL,IAAI,SAAS;GACX,OAAO;EACT;EACA,IAAI,cAAc;GAChB,OAAO;EACT;EACA,aAAa;GACX,SAAS;GACT,QAAQ,CAAC;GACT,UAAU;EACZ;EACA,YAAY;GACV,qBAAqB,GAAG;GACxB,QAAQ;EACV;CACF;AACF;;;AC1EA,MAAM,kBAAkB,SAAiB,KAAK,MAAM,MAAM,CAAC,CAAC,MAAM;AAElE,MAAM,UAAU,QAAkB,aAChC,OAAO,QAAQ,GAAG,OAAO,KAAK,GAAG,SAAS,QAAQ,SAAS;AAE7D,MAAM,SAAS,MAA8B,MAAc,SAAiB;CAC1E,MAAM,MAAM,KAAK,IAAI,IAAI,KAAK;EAAE;EAAM,OAAO;EAAG,QAAQ,CAAC;CAAE;CAE3D,IAAI,SAAS;CACb,IAAI,OAAO,SAAS,IAAI,OAAO,SAAS,KAAK;CAC7C,KAAK,IAAI,MAAM,GAAG;AACpB;AAEA,MAAM,UAAU,SACd,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;;AAGrD,MAAa,mBACX,UACA,UAA6B,CAAC,MACN;CACxB,IAAI,OAAO,SAAS,uBAAuB,YACzC,MAAM,IAAI,UAAU,oDAAoD;CAG1E,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,SAAS;CACxB,MAAM,qBAAqB,SAAS;CACpC,MAAM,SAAmB,CAAC;CAC1B,MAAM,0BAAU,IAAI,IAAuB;CAC3C,MAAM,yBAAS,IAAI,IAAuB;CAC1C,IAAI,UAAU;CACd,IAAI,UAAU;CACd,IAAI,QAAQ;CAEZ,MAAM,gBAAgB,MAAM,UAAU,UAAU,SAAyB,OAAO,QAAQ;EACtF,MAAM,QAAQ;EAEd,WAAW;EACX,UAAU,MAAM,QAAQ,UAAU;EAElC,IAAI;GACF,OAAO,KAAK,MAAM,OAAO,MAAM;EACjC,UAAU;GACR,UAAU;EACZ;CACF,CAAC;CAED,MAAM,cAAc,MAClB,UACA,sBACA,SAAyB,QAAQ,OAAO,UAAU,UAAU,QAAQ,OAAO;EAIzE,MAAM,OAFH,SAA+C,wBAAwB,QACvE,SAAkD,2BAA2B,OAC1D,WAAW;EACjC,MAAM,OAAO,OAAO,QAAQ,QAAQ;EAEpC,IAAI,CAAC,OAAO,SAAS,IAAI,GACvB,OAAO,KAAK,IAAI;EAGlB,SAAS;EACT,MAAM,SAAS,MAAM,IAAI;EACzB,MAAM,QAAQ,QAAQ,IAAI,GAAG,IAAI;EACjC,mBAAmB,KAAK,MAAM,QAAQ,OAAO,UAAU,UAAU,QAAQ,KAAK;CAChF,CACF;CAEA,OAAO,EACL,WAAW;EACT,YAAY;EACZ,cAAc;EAEd,OAAO;GAAE;GAAQ,QAAQ,OAAO,MAAM;GAAG,SAAS,OAAO,OAAO;GAAG;EAAM;CAC3E,EACF;AACF;;;;;;AAOA,MAAa,oBAAoB,UAA0B,UAA6B,CAAC,MACvF,IAAI,SAAqB,SAAS,WAAW;CAC3C,IAAI,OAAO,0BAA0B,YAAY;EAC/C,uBAAO,IAAI,MAAM,2DAA2D,CAAC;EAE7E;CACF;CAEA,4BAA4B;EAC1B,IAAI;GACF,MAAM,YAAY,gBAAgB,UAAU,OAAO;GAEnD,4BAA4B,QAAQ,UAAU,IAAI,CAAC,CAAC;EACtD,SAAS,OAAO;GACd,OAAO,KAAK;EACd;CACF,CAAC;AACH,CAAC;;AAGH,MAAa,eAAe,MAAmB,WAC7C,KAAK,KAAK,SAAS;CACjB,MAAM,IAAI;CACV,GAAG,OAAO,YAAY,OAAO,KAAK,SAAS,CAAC,MAAM,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC;CACzE,OAAO,IAAI;AACb,EAAE;;AAGJ,MAAa,mBAAmB,WAAuB;CAErD,QAAQ,MAAM,gBAAgB,OAAO,MAAM,oBAAoB;CAC/D,QAAQ,MAAM,YAAY,OAAO,QAAQ,OAAO,MAAM,CAAC;CACvD,QAAQ,eAAe,cAAc;CACrC,QAAQ,MAAM,YAAY,OAAO,SAAS,OAAO,MAAM,CAAC;CACxD,QAAQ,SAAS;CACjB,QAAQ,SAAS;AAEnB;;;AC5JA,MAAM,QAAQ;CACZ;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,iBAAiB,eAAuB;CAC5C,MAAM,IAAI,MAAM,gBAAgB,KAAK,kDAAkD;AACzF;;;;;;;;AASA,MAAa,uBAAuB,MAAgB,UAA+B,CAAC,MAAM;CACxF,MAAM,EAAE,UAAU,SAAS;CAC3B,MAAM,SAAS,QAAQ,UAAU;CAEjC,MAAM,UAAmD;EACvD,WAAW;EACX,YAAY,eAAe,MAAM,EAAE,KAAK,CAAC;EACzC,cAAc,WAAW,MAAM,EAAE,KAAK,CAAC;EACvC,cAAc,eAAe,MAAM,EAAE,KAAK,CAAC;EAC3C,aAAa,gBAAgB,MAAM;GAAE;GAAM;EAAO,CAAC;EACnD,SAAS,KAAc,SACrB,cAAc,MAAM;GAClB;GACA;GACA,GAAI,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,IAAI;GACnC,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;EACvC,CAAC;EACH,cAAc,WAAW,MAAM;GAAE;GAAM;EAAO,CAAC;EAC/C,QAAQ,WACJ,YAAY;GACV,MAAM,SAAS,MAAM,iBAAiB,QAAQ;GAE9C,gBAAgB,MAAM;GAEtB,OAAO;EACT,IACA,cAAc,QAAQ;EAC1B,aAAa,YACR,UAAU,OACT,IAAI,SAA6D,YAAY;GAC3E,MAAM,QAAQ,iBAAiB,QAAQ;GAEvC,iBAAiB;IACf,MAAM,KAAK;IACX,QAAQ;KAAE,QAAQ,MAAM;KAAQ,aAAa,MAAM;IAAY,CAAC;GAClE,GAAG,UAAU,GAAI;EACnB,CAAC,IACH,cAAc,aAAa;CACjC;CAEA,OAAO,OAAO,YAAY,OAAO;CAEjC,aAAa;EACX,MAAM,QAAQ;EAEd,KAAK,MAAM,QAAQ,OACjB,IAAI,MAAM,UAAU,QAAQ,OAC1B,OAAO,MAAM;CAGnB;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/patch.ts","../src/black-frames.ts","../src/frames.ts","../src/draw-ledger.ts","../src/measure.ts","../src/console-helpers.ts"],"sourcesContent":["/** Swap `key` on `target` for `value`; the returned function puts back exactly what was there. */\nexport const patch = <Target extends object, Key extends keyof Target>(\n  target: Target,\n  key: Key,\n  value: Target[Key],\n) => {\n  const own = Object.hasOwn(target, key);\n  const original = target[key];\n\n  target[key] = value;\n\n  return () => {\n    if (own) {\n      target[key] = original;\n    } else {\n      delete target[key];\n    }\n  };\n};\n","/**\n * Black-frame probe: after each frame, samples a grid of the drawing buffer and counts frames\n * where several samples are pure black. Catches the flash a NaN pixel makes once bloom spreads it,\n * which lasts one frame in twenty and never shows in a screenshot.\n *\n * WebGL only (`readPixels`). Each sample stalls the GPU pipeline, so watch, read, stop.\n */\nimport { patch } from \"./patch.ts\";\nimport type { AnyObject3D } from \"./scene.ts\";\n\n/** The `WebGLRenderer` methods the probe uses, typed loosely to fit any copy of three's types. */\nexport type ProbeRenderer = {\n  render(scene: AnyObject3D, camera: object): void;\n  getContext(): unknown;\n  getRenderTarget(): unknown;\n};\n\nexport type BlackFrameOptions = {\n  /** Samples per side: 3 reads a 3 × 3 grid at the quarter lines. */\n  grid?: number;\n  /** Black samples that make a frame black. */\n  threshold?: number;\n};\n\nexport type BlackFrameWatch = {\n  /** Frames sampled since the start or the last `reset()`. */\n  readonly frames: number;\n  /** Which of those frames (1-based) were black. */\n  readonly blackFrames: readonly number[];\n  reset: () => void;\n  /** Restore the renderer and stop sampling. */\n  stop: () => void;\n};\n\ntype ReadPixels = Pick<\n  WebGLRenderingContext,\n  \"RGBA\" | \"UNSIGNED_BYTE\" | \"drawingBufferHeight\" | \"drawingBufferWidth\" | \"readPixels\"\n>;\n\n/**\n * Sample every frame the app draws to the screen. Several screen renders in one frame (an overlay\n * redrawn after the composer) count once, as the last of them: the image the display shows.\n * Browser only: frames are told apart by `requestAnimationFrame`.\n */\nexport const watchBlackFrames = (\n  renderer: ProbeRenderer,\n  options: BlackFrameOptions = {},\n): BlackFrameWatch => {\n  const context = renderer.getContext() as Partial<ReadPixels> | null;\n\n  if (typeof context?.readPixels !== \"function\") {\n    throw new TypeError(\"three-audit: the black-frame probe needs a WebGLRenderer\");\n  }\n\n  if (typeof requestAnimationFrame !== \"function\") {\n    throw new TypeError(\"three-audit: the black-frame probe needs requestAnimationFrame\");\n  }\n\n  const gl = context as ReadPixels;\n  const grid = options.grid ?? 3;\n  const threshold = options.threshold ?? 3;\n  const pixel = new Uint8Array(4);\n  const render = renderer.render;\n  let frames = 0;\n  let black: number[] = [];\n  let pending: boolean | null = null;\n\n  const isBlack = () => {\n    let count = 0;\n\n    for (let i = 1; i <= grid; i += 1) {\n      for (let j = 1; j <= grid; j += 1) {\n        const x = Math.floor((gl.drawingBufferWidth * i) / (grid + 1));\n        const y = Math.floor((gl.drawingBufferHeight * j) / (grid + 1));\n\n        gl.readPixels(x, y, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, pixel);\n\n        if (pixel[0]! < 4 && pixel[1]! < 4 && pixel[2]! < 4 && pixel[3]! > 250) {\n          count += 1;\n        }\n      }\n    }\n\n    return count >= threshold;\n  };\n\n  // Commit the frame's last screen sample once per animation frame.\n  let raf = 0;\n  const commit = () => {\n    if (pending !== null) {\n      frames += 1;\n\n      if (pending) {\n        black.push(frames);\n      }\n\n      pending = null;\n    }\n\n    raf = requestAnimationFrame(commit);\n  };\n\n  raf = requestAnimationFrame(commit);\n\n  const restore = patch(renderer, \"render\", function (this: unknown, scene, camera) {\n    render.call(this, scene, camera);\n\n    // Read before the browser presents (and, without preserveDrawingBuffer, clears) the buffer.\n    if (renderer.getRenderTarget() === null) {\n      pending = isBlack();\n    }\n  });\n\n  return {\n    get frames() {\n      return frames;\n    },\n    get blackFrames() {\n      return black;\n    },\n    reset: () => {\n      frames = 0;\n      black = [];\n      pending = null;\n    },\n    stop: () => {\n      cancelAnimationFrame(raf);\n      restore();\n    },\n  };\n};\n","/**\n * Waiting on animation frames without hanging: a tab in the background (an agent's browser, an\n * occluded window) gets none, so every wait gives up after a timeout and says why.\n */\n\n/** Frames an agent-driven tab should see within this long, in ms. */\nexport const FRAME_TIMEOUT = 2000;\n\nconst noFrame = (caller: string, timeout: number, hint: string) => {\n  const hidden = typeof document !== \"undefined\" && document.hidden;\n\n  return new Error(\n    `three-audit: ${caller} got no animation frame in ${timeout / 1000} s${\n      hidden\n        ? \" (document.hidden is true: browsers pause requestAnimationFrame in background tabs)\"\n        : \"\"\n    }. ${hint}`,\n  );\n};\n\n/** The next animation frame, or an error naming the cause when none comes within `timeout`. */\nexport const nextFrame = (caller: string, timeout: number, hint: string) =>\n  new Promise<void>((resolve, reject) => {\n    if (typeof requestAnimationFrame !== \"function\") {\n      reject(new Error(`three-audit: ${caller} needs requestAnimationFrame`));\n\n      return;\n    }\n\n    let frame = 0;\n    const timer = setTimeout(() => {\n      cancelAnimationFrame(frame);\n      reject(noFrame(caller, timeout, hint));\n    }, timeout);\n\n    frame = requestAnimationFrame(() => {\n      clearTimeout(timer);\n      resolve();\n    });\n  });\n","/**\n * A ledger of every draw call over one frame: which object drew, in which pass. Exact counts from\n * the renderer itself, where `renderer.info` gives one total (and resets it every `render()`).\n *\n * WebGL only: it wraps `WebGLRenderer.renderBufferDirect`, which every draw goes through, and\n * `render()`, to tell passes apart. Draws with a depth or distance material are the shadow maps.\n */\nimport type { BufferGeometry, Material, Mesh, Object3D } from \"three\";\n\nimport { FRAME_TIMEOUT, nextFrame } from \"./frames.ts\";\nimport { patch } from \"./patch.ts\";\nimport {\n  type AnyObject3D,\n  batchedTriangles,\n  isBatched,\n  isInstanced,\n  pathOf,\n  triangleCount,\n} from \"./scene.ts\";\n\n/**\n * The two `WebGLRenderer` methods the ledger wraps. Typed loosely, so a renderer from any copy of\n * three's types fits.\n */\nexport type LedgerRenderer = {\n  render(scene: AnyObject3D, camera: object): void;\n  renderBufferDirect(\n    camera: object,\n    scene: object | null,\n    geometry: object,\n    material: object,\n    object: AnyObject3D,\n    group: unknown,\n  ): void;\n  /** For pass sizes: the target being drawn to, `null` for the screen. */\n  getRenderTarget?(): unknown;\n  /** For pass sizes: the screen's drawing buffer, device pixels. */\n  getContext?(): unknown;\n};\n\nexport type DrawLedgerOptions = {\n  /**\n   * The group an object name files under. Default: up to the first `:` or `#`, so a bake's\n   * `wagon:paint` and a strip's `grass#3` group as `wagon` and `grass`.\n   */\n  groupOf?: (name: string) => string;\n};\n\nexport type RecordDrawLedgerOptions = DrawLedgerOptions & {\n  /**\n   * Record one call of this (the app's own render, sync or async) instead of one animation frame.\n   * For a tab in the background, where no frames come.\n   */\n  render?: () => unknown;\n  /** How long to wait for each animation frame before failing, in ms. Default 2000. */\n  timeout?: number;\n};\n\nexport type LedgerRow = {\n  name: string;\n  total: number;\n  /** Draws per pass name. */\n  passes: Record<string, number>;\n};\n\nexport type PassRow = {\n  name: string;\n  draws: number;\n  /** Distinct objects drawn: for `shadow`, the casters. */\n  objects: number;\n  /** Triangles drawn, instances counted. */\n  triangles: number;\n  /** Sizes drawn to, in device pixels: `2880×1800`, or `screen 2880×1800`. */\n  targets: string[];\n  /** Every call was one small mesh through an orthographic camera: a post-processing pass. */\n  fullscreen: boolean;\n};\n\nexport type DrawLedger = {\n  /**\n   * Pass names in the order they first drew: `shadow`, then each `render()` call as its scene's\n   * name, or `render 1`, `render 2`… when unnamed (a post-processing chain is several).\n   */\n  passes: string[];\n  /** By group, most draws first. */\n  groups: LedgerRow[];\n  /** By object name, most draws first. */\n  objects: LedgerRow[];\n  draws: number;\n  /** Each pass's draws, triangles, casters and target sizes, in `passes` order. */\n  passStats: PassRow[];\n  /** `render()` calls that drew one fullscreen pass, and the pixels they shaded between them. */\n  fullscreenPasses: number;\n  fullscreenPixels: number;\n};\n\nexport type DrawLedgerRecording = {\n  /** Restore the renderer and return what was drawn since `beginDrawLedger`. */\n  end: () => DrawLedger;\n};\n\nconst defaultGroupOf = (name: string) => name.split(/[:#]/)[0] || name;\n\n/** The object's name, or for an unnamed one its named ancestors, type and material. */\nconst nameOf = (object: Object3D, material: Material) =>\n  object.name ||\n  `${[...pathOf(object, null, undefined, 2), object.type].join(\"/\")} [${material.name || material.type}]`;\n\nconst tally = (rows: Map<string, LedgerRow>, name: string, pass: string) => {\n  const row = rows.get(name) ?? { name, total: 0, passes: {} };\n\n  row.total += 1;\n  row.passes[pass] = (row.passes[pass] ?? 0) + 1;\n  rows.set(name, row);\n};\n\nconst sorted = (rows: Map<string, LedgerRow>) =>\n  [...rows.values()].sort((a, b) => b.total - a.total);\n\n/** Triangles one draw makes: its material group's range, times its instances. */\nconst drawTriangles = (geometry: BufferGeometry, object: Object3D, group: unknown) => {\n  const mesh = object as Mesh;\n\n  if (mesh.isMesh !== true) {\n    return 0;\n  }\n\n  if (isBatched(mesh)) {\n    return batchedTriangles(mesh).triangles;\n  }\n\n  const range = group as { start?: number; count?: number } | null;\n  const elements = geometry.index?.count ?? geometry.attributes.position?.count ?? 0;\n  const own =\n    range && typeof range.count === \"number\"\n      ? Math.floor(Math.max(0, Math.min(range.count, elements - (range.start ?? 0))) / 3)\n      : triangleCount(geometry);\n\n  return own * (isInstanced(mesh) ? mesh.count : 1);\n};\n\ntype Size = { width: number; height: number; screen: boolean };\n\ntype PassTally = Omit<PassRow, \"objects\" | \"targets\" | \"fullscreen\"> & {\n  objects: Set<Object3D>;\n  targets: Set<string>;\n  calls: number;\n  fullscreenCalls: number;\n};\n\ntype Call = {\n  pass: string;\n  draws: number;\n  orthographic: boolean;\n  /** Vertices of the one draw so far. */\n  vertices: number;\n  size: Size | null;\n};\n\n/** Start counting every draw. Call `end()` after the frame to restore the renderer and read it. */\nexport const beginDrawLedger = (\n  renderer: LedgerRenderer,\n  options: DrawLedgerOptions = {},\n): DrawLedgerRecording => {\n  if (typeof renderer.renderBufferDirect !== \"function\") {\n    throw new TypeError(\"three-audit: the draw ledger needs a WebGLRenderer\");\n  }\n\n  const groupOf = options.groupOf ?? defaultGroupOf;\n  const render = renderer.render;\n  const renderBufferDirect = renderer.renderBufferDirect;\n  const passes: string[] = [];\n  const objects = new Map<string, LedgerRow>();\n  const groups = new Map<string, LedgerRow>();\n  const stats = new Map<string, PassTally>();\n  const calls: Call[] = [];\n  let renders = 0;\n  let current = \"direct\";\n  let draws = 0;\n  let fullscreenPasses = 0;\n  let fullscreenPixels = 0;\n\n  const statOf = (pass: string) => {\n    let stat = stats.get(pass);\n\n    if (!stat) {\n      stat = {\n        name: pass,\n        draws: 0,\n        triangles: 0,\n        objects: new Set(),\n        targets: new Set(),\n        calls: 0,\n        fullscreenCalls: 0,\n      };\n      stats.set(pass, stat);\n    }\n\n    return stat;\n  };\n\n  const sizeNow = (): Size | null => {\n    const target = renderer.getRenderTarget?.() as { width?: number; height?: number } | null;\n\n    if (target && typeof target.width === \"number\" && typeof target.height === \"number\") {\n      return { width: target.width, height: target.height, screen: false };\n    }\n\n    const gl = renderer.getContext?.() as\n      | { drawingBufferWidth?: number; drawingBufferHeight?: number }\n      | null\n      | undefined;\n\n    return target === null && typeof gl?.drawingBufferWidth === \"number\"\n      ? { width: gl.drawingBufferWidth, height: gl.drawingBufferHeight ?? 0, screen: true }\n      : null;\n  };\n\n  const restoreRender = patch(renderer, \"render\", function (this: unknown, scene, camera) {\n    const outer = current;\n\n    renders += 1;\n    current = (scene as Partial<Object3D>).name || `render ${renders}`;\n\n    const call: Call = {\n      pass: current,\n      draws: 0,\n      orthographic: (camera as { isOrthographicCamera?: boolean }).isOrthographicCamera === true,\n      vertices: 0,\n      size: null,\n    };\n\n    calls.push(call);\n\n    try {\n      render.call(this, scene, camera);\n    } finally {\n      calls.pop();\n      current = outer;\n\n      const stat = stats.get(call.pass);\n\n      if (stat) {\n        stat.calls += 1;\n\n        // One small mesh through an orthographic camera: a fullscreen quad or triangle.\n        if (call.draws === 1 && call.orthographic && call.vertices <= 6) {\n          stat.fullscreenCalls += 1;\n          fullscreenPasses += 1;\n          fullscreenPixels += call.size ? call.size.width * call.size.height : 0;\n        }\n      }\n    }\n  });\n\n  const restoreDraw = patch(\n    renderer,\n    \"renderBufferDirect\",\n    function (this: unknown, camera, scene, geometry, material, object, group) {\n      const shadow =\n        (material as { isMeshDepthMaterial?: boolean }).isMeshDepthMaterial === true ||\n        (material as { isMeshDistanceMaterial?: boolean }).isMeshDistanceMaterial === true;\n      const pass = shadow ? \"shadow\" : current;\n      const name = nameOf(object as unknown as Object3D, material as Material);\n\n      if (!passes.includes(pass)) {\n        passes.push(pass);\n      }\n\n      const stat = statOf(pass);\n      const size = sizeNow();\n      const drawn = geometry as BufferGeometry;\n\n      stat.draws += 1;\n      stat.triangles += drawTriangles(drawn, object as unknown as Object3D, group);\n      stat.objects.add(object as unknown as Object3D);\n\n      if (size) {\n        stat.targets.add(`${size.screen ? \"screen \" : \"\"}${size.width}×${size.height}`);\n      }\n\n      const call = calls.at(-1);\n\n      if (call && !shadow) {\n        call.draws += 1;\n        call.vertices = drawn.attributes?.position?.count ?? Infinity;\n        call.size = size;\n      }\n\n      draws += 1;\n      tally(objects, name, pass);\n      tally(groups, groupOf(name), pass);\n      renderBufferDirect.call(this, camera, scene, geometry, material, object, group);\n    },\n  );\n\n  return {\n    end: () => {\n      restoreDraw();\n      restoreRender();\n\n      return {\n        passes,\n        groups: sorted(groups),\n        objects: sorted(objects),\n        draws,\n        passStats: passes.map((pass) => {\n          const stat = stats.get(pass)!;\n\n          return {\n            name: pass,\n            draws: stat.draws,\n            objects: stat.objects.size,\n            triangles: stat.triangles,\n            targets: [...stat.targets],\n            fullscreen: stat.calls > 0 && stat.fullscreenCalls === stat.calls,\n          };\n        }),\n        fullscreenPasses,\n        fullscreenPixels,\n      };\n    },\n  };\n};\n\n/**\n * Record exactly one frame of an app that renders from `requestAnimationFrame` (three's\n * `setAnimationLoop`, React Three Fiber): from one animation frame to the next. A demand-driven\n * loop that renders nothing that frame gives an empty ledger. Browser only.\n *\n * With `render`, records one call of it instead, frames or not. Without, fails after `timeout`\n * when no frame comes (a background tab), rather than waiting for ever.\n */\nexport const recordDrawLedger = async (\n  renderer: LedgerRenderer,\n  options: RecordDrawLedgerOptions = {},\n): Promise<DrawLedger> => {\n  const { render, timeout = FRAME_TIMEOUT, ...ledgerOptions } = options;\n\n  if (render) {\n    const recording = beginDrawLedger(renderer, ledgerOptions);\n\n    try {\n      await render();\n    } catch (error) {\n      recording.end();\n      throw error;\n    }\n\n    return recording.end();\n  }\n\n  const hint = \"Bring the tab to the front, or pass { render } to record one call of your own.\";\n\n  await nextFrame(\"recordDrawLedger\", timeout, hint);\n\n  const recording = beginDrawLedger(renderer, ledgerOptions);\n\n  try {\n    await nextFrame(\"recordDrawLedger\", timeout, hint);\n  } catch (error) {\n    recording.end();\n    throw error;\n  }\n\n  return recording.end();\n};\n\n/** Rows shaped for `console.table`: one column per pass, then the total. */\nexport const ledgerTable = (rows: LedgerRow[], passes: string[]) =>\n  rows.map((row) => ({\n    name: row.name,\n    ...Object.fromEntries(passes.map((pass) => [pass, row.passes[pass] ?? 0])),\n    total: row.total,\n  }));\n\n/** The ledger as two console tables: by group, and every object collapsed beneath. */\nexport const printDrawLedger = (ledger: DrawLedger) => {\n  /* oxlint-disable no-console -- printing is this function's job */\n  console.group(`Draw ledger: ${ledger.draws} draws in one frame`);\n  console.table(ledgerTable(ledger.groups, ledger.passes));\n  console.table(ledger.passStats.map((pass) => ({ ...pass, targets: pass.targets.join(\", \") })));\n\n  if (ledger.fullscreenPasses > 0) {\n    console.log(\n      `${ledger.fullscreenPasses} fullscreen passes: ${(ledger.fullscreenPixels / 1e6).toFixed(1)} Mpx shaded`,\n    );\n  }\n\n  console.groupCollapsed(\"Every object\");\n  console.table(ledgerTable(ledger.objects, ledger.passes));\n  console.groupEnd();\n  console.groupEnd();\n  /* oxlint-enable no-console */\n};\n","/**\n * Measuring a layout: an object's world envelope, and the gap between two objects. The questions\n * a scene raises before anything renders wrong: does the train fit under the crossbar, does the\n * lid clear the hinge.\n *\n * Measured from the vertices as drawn (instances and batches included), not from bounding boxes\n * transformed after the fact, which grow with every rotation.\n */\nimport type { BatchedMesh, Mesh, Object3D } from \"three\";\n\nimport {\n  type AnyObject3D,\n  asObject3D,\n  isBatched,\n  isInstanced,\n  isMesh,\n  meshLabel,\n  walk,\n} from \"./scene.ts\";\n\nexport type MeasureOptions = {\n  /** `userData` key a string target is looked up by. Default `studioObject`. */\n  tagKey?: string;\n};\n\n/** What to measure: an object, or a tag (`userData[tagKey]`), or failing that an object name. */\nexport type Target = string | AnyObject3D;\n\nexport type Bounds = {\n  min: [number, number, number];\n  max: [number, number, number];\n  size: [number, number, number];\n  centre: [number, number, number];\n};\n\nexport type Clearance = {\n  /**\n   * The smallest gap between the two, in world units. Measured between triangles' bounding boxes:\n   * exact for faces square to the axes, a slight underestimate for sloped ones. 0 when they touch\n   * or intersect.\n   */\n  gap: number;\n  /** The axis the gap is measured along, when it's straight along one; `null` when diagonal. */\n  axis: \"x\" | \"y\" | \"z\" | null;\n  /** The closest meshes, one from each side. */\n  between: [string, string];\n};\n\n/** A 4 × 4 column-major matrix, as three stores them. */\ntype Elements = ArrayLike<number>;\n\nconst multiply = (a: Elements, b: Elements, out: number[]) => {\n  for (let row = 0; row < 4; row += 1) {\n    for (let column = 0; column < 4; column += 1) {\n      let sum = 0;\n\n      for (let k = 0; k < 4; k += 1) {\n        sum += a[k * 4 + row]! * b[column * 4 + k]!;\n      }\n\n      out[column * 4 + row] = sum;\n    }\n  }\n\n  return out;\n};\n\ntype Triangle = (\n  ax: number,\n  ay: number,\n  az: number,\n  bx: number,\n  by: number,\n  bz: number,\n  cx: number,\n  cy: number,\n  cz: number,\n) => void;\n\n/** Every triangle a mesh draws, in world space: each instance of an instanced or batched mesh. */\nconst eachTriangle = (mesh: Mesh, visit: Triangle) => {\n  const { index, attributes } = mesh.geometry;\n  const position = attributes.position;\n\n  if (!position) {\n    return;\n  }\n\n  const world = mesh.matrixWorld.elements;\n  const corner = [0, 0, 0, 0, 0, 0, 0, 0, 0];\n  const emit = (matrix: Elements, first: number, count: number, indexed: boolean) => {\n    for (let k = first; k + 2 < first + count; k += 3) {\n      for (let c = 0; c < 3; c += 1) {\n        const v = indexed ? index!.getX(k + c) : k + c;\n        const x = position.getX(v);\n        const y = position.getY(v);\n        const z = position.getZ(v);\n\n        for (let axis = 0; axis < 3; axis += 1) {\n          corner[c * 3 + axis] =\n            matrix[axis]! * x + matrix[axis + 4]! * y + matrix[axis + 8]! * z + matrix[axis + 12]!;\n        }\n      }\n\n      visit(\n        ...(corner as [number, number, number, number, number, number, number, number, number]),\n      );\n    }\n  };\n\n  if (isBatched(mesh)) {\n    const batch = mesh as BatchedMesh;\n    const instance = Array.from({ length: 16 }, () => 0);\n    const matrix = Array.from({ length: 16 }, () => 0);\n    // `getMatrixAt` fills whatever has three's `fromArray`, so no Matrix4 is needed.\n    const target = {\n      fromArray(array: ArrayLike<number>, offset = 0) {\n        for (let i = 0; i < 16; i += 1) {\n          instance[i] = array[offset + i]!;\n        }\n\n        return target;\n      },\n    };\n\n    for (let id = 0; id < batch.maxInstanceCount; id += 1) {\n      let range: {\n        vertexStart: number;\n        vertexCount: number;\n        indexStart: number;\n        indexCount: number;\n      };\n\n      try {\n        if (!batch.getVisibleAt(id)) {\n          continue;\n        }\n\n        range = batch.getGeometryRangeAt(batch.getGeometryIdAt(id)) as typeof range;\n        batch.getMatrixAt(id, target as never);\n      } catch {\n        continue;\n      }\n\n      multiply(world, instance, matrix);\n\n      if (index) {\n        emit(matrix, range.indexStart, range.indexCount, true);\n      } else {\n        emit(matrix, range.vertexStart, range.vertexCount, false);\n      }\n    }\n\n    return;\n  }\n\n  const { start, count } = mesh.geometry.drawRange;\n  const elements = index?.count ?? position.count;\n  const first = Math.min(start, elements);\n  const drawn = Math.min(elements, start + count) - first;\n\n  if (isInstanced(mesh)) {\n    const matrix = Array.from({ length: 16 }, () => 0);\n    const instances = mesh.instanceMatrix.array;\n\n    for (let i = 0; i < mesh.count; i += 1) {\n      multiply(world, Array.prototype.slice.call(instances, i * 16, i * 16 + 16), matrix);\n      emit(matrix, first, drawn, index !== null);\n    }\n\n    return;\n  }\n\n  emit(world, first, drawn, index !== null);\n};\n\n/** A box as [minX, minY, minZ, maxX, maxY, maxZ]. */\ntype Box = [number, number, number, number, number, number];\n\nconst emptyBox = (): Box => [Infinity, Infinity, Infinity, -Infinity, -Infinity, -Infinity];\n\nconst grow = (box: Box, x: number, y: number, z: number) => {\n  box[0] = Math.min(box[0], x);\n  box[1] = Math.min(box[1], y);\n  box[2] = Math.min(box[2], z);\n  box[3] = Math.max(box[3], x);\n  box[4] = Math.max(box[4], y);\n  box[5] = Math.max(box[5], z);\n};\n\n/** Per axis, how far apart two boxes are (0 where they overlap). */\nconst apart = (\n  a: ArrayLike<number>,\n  ai: number,\n  b: ArrayLike<number>,\n  bi: number,\n  out: number[],\n) => {\n  for (let axis = 0; axis < 3; axis += 1) {\n    out[axis] = Math.max(0, a[ai + axis]! - b[bi + axis + 3]!, b[bi + axis]! - a[ai + axis + 3]!);\n  }\n\n  return Math.hypot(out[0]!, out[1]!, out[2]!);\n};\n\nconst round = (value: number) => {\n  const rounded = Math.round(value * 1000) / 1000;\n\n  return rounded === 0 ? 0 : rounded;\n};\n\n/** The visible meshes a target stands for. */\nconst meshesOf = (root: Object3D, target: Target, tagKey: string, role: string) => {\n  let objects: Object3D[];\n\n  if (typeof target === \"string\") {\n    const tagged: Object3D[] = [];\n    const named: Object3D[] = [];\n\n    walk(root, {}, (object) => {\n      const tag: unknown = object.userData[tagKey];\n\n      if (tag !== undefined && tag !== null && String(tag) === target) {\n        tagged.push(object);\n      } else if (object.name === target) {\n        named.push(object);\n      }\n    });\n    objects = tagged.length > 0 ? tagged : named;\n\n    if (objects.length === 0) {\n      throw new Error(\n        `three-audit: ${role}: nothing is tagged userData.${tagKey} = \"${target}\" or named \"${target}\"`,\n      );\n    }\n  } else {\n    objects = [asObject3D(target)];\n  }\n\n  const meshes = new Set<Mesh>();\n\n  for (const object of objects) {\n    walk(object, { visibleOnly: true }, (child) => {\n      if (isMesh(child)) {\n        meshes.add(child);\n      }\n    });\n  }\n\n  return meshes;\n};\n\n/** A target's world envelope, from its visible meshes' vertices; `null` when it draws nothing. */\nexport const measureBounds = (\n  root: AnyObject3D,\n  target: Target,\n  options: MeasureOptions = {},\n): Bounds | null => {\n  const scene = asObject3D(root);\n\n  scene.updateWorldMatrix(true, true);\n\n  const box = emptyBox();\n\n  for (const mesh of meshesOf(scene, target, options.tagKey ?? \"studioObject\", \"bounds\")) {\n    eachTriangle(mesh, (ax, ay, az, bx, by, bz, cx, cy, cz) => {\n      grow(box, ax, ay, az);\n      grow(box, bx, by, bz);\n      grow(box, cx, cy, cz);\n    });\n  }\n\n  if (box[0] > box[3]) {\n    return null;\n  }\n\n  const min = [box[0], box[1], box[2]].map(round) as Bounds[\"min\"];\n  const max = [box[3], box[4], box[5]].map(round) as Bounds[\"max\"];\n\n  return {\n    min,\n    max,\n    size: [0, 1, 2].map((axis) => round(box[axis + 3]! - box[axis]!)) as Bounds[\"size\"],\n    centre: [0, 1, 2].map((axis) => round((box[axis]! + box[axis + 3]!) / 2)) as Bounds[\"centre\"],\n  };\n};\n\n/** Triangle boxes past this many pairs, a mesh pair is measured by its whole boxes instead. */\nconst PAIR_LIMIT = 4_000_000;\n\ntype Measured = { mesh: Mesh; box: Box; triangles: Float64Array | null };\n\n/**\n * The gap between two targets, and which of their meshes come closest. Throws when a target\n * matches nothing; `null` when either draws nothing. Meshes in both targets are left out of `a`.\n */\nexport const measureClearance = (\n  root: AnyObject3D,\n  a: Target,\n  b: Target,\n  options: MeasureOptions = {},\n): Clearance | null => {\n  const scene = asObject3D(root);\n  const tagKey = options.tagKey ?? \"studioObject\";\n\n  scene.updateWorldMatrix(true, true);\n\n  const inB = meshesOf(scene, b, tagKey, \"clearance b\");\n  const inA = [...meshesOf(scene, a, tagKey, \"clearance a\")].filter((mesh) => !inB.has(mesh));\n  const measure = (mesh: Mesh): Measured => {\n    const box = emptyBox();\n\n    eachTriangle(mesh, (ax, ay, az, bx, by, bz, cx, cy, cz) => {\n      grow(box, ax, ay, az);\n      grow(box, bx, by, bz);\n      grow(box, cx, cy, cz);\n    });\n\n    return { mesh, box, triangles: null };\n  };\n  const sideA = inA.map(measure).filter(({ box }) => box[0] <= box[3]);\n  const sideB = [...inB].map(measure).filter(({ box }) => box[0] <= box[3]);\n\n  if (sideA.length === 0 || sideB.length === 0) {\n    return null;\n  }\n\n  const trianglesOf = (side: Measured) => {\n    if (!side.triangles) {\n      const boxes: number[] = [];\n\n      eachTriangle(side.mesh, (ax, ay, az, bx, by, bz, cx, cy, cz) => {\n        boxes.push(\n          Math.min(ax, bx, cx),\n          Math.min(ay, by, cy),\n          Math.min(az, bz, cz),\n          Math.max(ax, bx, cx),\n          Math.max(ay, by, cy),\n          Math.max(az, bz, cz),\n        );\n      });\n      side.triangles = Float64Array.from(boxes);\n    }\n\n    return side.triangles;\n  };\n\n  const axes = [0, 0, 0];\n  const pairs = sideA\n    .flatMap((left) =>\n      sideB.map((right) => ({ left, right, distance: apart(left.box, 0, right.box, 0, axes) })),\n    )\n    .sort((x, y) => x.distance - y.distance);\n  let best = Infinity;\n  let bestAxes = [0, 0, 0];\n  let between: [Mesh, Mesh] = [pairs[0]!.left.mesh, pairs[0]!.right.mesh];\n\n  for (const { left, right, distance } of pairs) {\n    if (distance >= best) {\n      break;\n    }\n\n    const leftTriangles = trianglesOf(left);\n    const rightTriangles = trianglesOf(right);\n    // Only triangles that could beat the best so far, measured against the other mesh's box.\n    const near = (triangles: Float64Array, other: Box) => {\n      const kept: number[] = [];\n\n      for (let t = 0; t < triangles.length; t += 6) {\n        if (apart(triangles, t, other, 0, axes) < best) {\n          kept.push(t);\n        }\n      }\n\n      return kept;\n    };\n    const nearLeft = near(leftTriangles, right.box);\n    const nearRight = near(rightTriangles, left.box);\n\n    if (nearLeft.length * nearRight.length > PAIR_LIMIT) {\n      if (distance < best) {\n        best = distance;\n        apart(left.box, 0, right.box, 0, axes);\n        bestAxes = [...axes];\n        between = [left.mesh, right.mesh];\n      }\n\n      continue;\n    }\n\n    for (const i of nearLeft) {\n      for (const j of nearRight) {\n        const gap = apart(leftTriangles, i, rightTriangles, j, axes);\n\n        if (gap < best) {\n          best = gap;\n          bestAxes = [...axes];\n          between = [left.mesh, right.mesh];\n        }\n      }\n    }\n  }\n\n  const separated = bestAxes.flatMap((value, axis) => (value > 0 ? [axis] : []));\n\n  return {\n    gap: round(best),\n    axis: separated.length === 1 ? ([\"x\", \"y\", \"z\"] as const)[separated[0]!]! : null,\n    between: [meshLabel(between[0], scene, tagKey), meshLabel(between[1], scene, tagKey)],\n  };\n};\n","/**\n * The checks as console globals, for a dev page or a headless browser's `eval`: `summary()`,\n * `tris()`, `meshes()`, `census()`, `audit()`, `zfight()`, `report()`, `bbox()`, `clearance()`,\n * and with a renderer `ledger()`, `beginLedger()` and `blackFrames()`. All of them also sit on\n * `threeAudit`, which is the only global with `globals: false`.\n */\nimport type { BatchedMesh } from \"three\";\n\nimport { auditScene, type AuditSummaryOptions, summarizeScene } from \"./audit-scene.ts\";\nimport { findBadGeometry } from \"./bad-geometry.ts\";\nimport { type ProbeRenderer, watchBlackFrames } from \"./black-frames.ts\";\nimport {\n  beginDrawLedger,\n  type DrawLedgerOptions,\n  type LedgerRenderer,\n  printDrawLedger,\n  recordDrawLedger,\n  type RecordDrawLedgerOptions,\n} from \"./draw-ledger.ts\";\nimport { FRAME_TIMEOUT, nextFrame } from \"./frames.ts\";\nimport { measureBounds, measureClearance, type Target } from \"./measure.ts\";\nimport type { AnyObject3D, Skip } from \"./scene.ts\";\nimport { type CensusOptions, countTriangles, geometryCensus, listMeshes } from \"./triangles.ts\";\nimport { findZFighting } from \"./z-fighting.ts\";\n\nexport type AuditHelpersOptions = {\n  /** A `WebGLRenderer`, for `ledger()`, `beginLedger()` and `blackFrames()`. */\n  renderer?: (LedgerRenderer & ProbeRenderer) | undefined;\n  skip?: Skip | undefined;\n  tagKey?: string;\n  /** Names geometries inside a batch in `census()`: see `geometryCensus`'s `label`. */\n  batchLabel?: ((batch: BatchedMesh, geometryId: number) => string | undefined) | undefined;\n  /**\n   * Also put each helper on `globalThis` under its short name (`tris`, `report`…). Default true;\n   * false leaves only `threeAudit`, for pages where short names collide with other tooling.\n   */\n  globals?: boolean;\n};\n\nconst NAMESPACE = \"threeAudit\";\n\nconst NAMES = [\n  \"auditRoot\",\n  \"summary\",\n  \"tris\",\n  \"meshes\",\n  \"census\",\n  \"audit\",\n  \"zfight\",\n  \"report\",\n  \"bbox\",\n  \"clearance\",\n  \"ledger\",\n  \"beginLedger\",\n  \"blackFrames\",\n] as const;\n\nconst needsRenderer = (name: string) => () => {\n  throw new Error(`three-audit: ${name}() needs installAuditHelpers(scene, { renderer })`);\n};\n\n/**\n * Put the helpers on `globalThis`, and on `globalThis.threeAudit`. Returns a function that\n * removes them.\n *\n *   vanilla: installAuditHelpers(scene, { renderer })\n *   R3F:     const { scene, gl } = useThree();\n *            useLayoutEffect(() => installAuditHelpers(scene, { renderer: gl }), [scene, gl]);\n */\nexport const installAuditHelpers = (root: AnyObject3D, options: AuditHelpersOptions = {}) => {\n  const { renderer, skip, batchLabel } = options;\n  const tagKey = options.tagKey ?? \"studioObject\";\n\n  const helpers: Record<(typeof NAMES)[number], unknown> = {\n    auditRoot: root,\n    summary: (tag?: string, summaryOptions: Pick<AuditSummaryOptions, \"gap\" | \"zFighting\"> = {}) =>\n      summarizeScene(root, {\n        skip,\n        tagKey,\n        ...summaryOptions,\n        ...(tag === undefined ? {} : { tag }),\n      }),\n    tris: () => countTriangles(root, { skip }),\n    meshes: () => listMeshes(root, { skip }),\n    census: (censusOptions: Pick<CensusOptions, \"budget\" | \"label\"> = {}) =>\n      geometryCensus(root, { skip, label: batchLabel, ...censusOptions }),\n    audit: () => findBadGeometry(root, { skip, tagKey }),\n    zfight: (gap?: number, self?: boolean) =>\n      findZFighting(root, {\n        skip,\n        tagKey,\n        ...(gap === undefined ? {} : { gap }),\n        ...(self === undefined ? {} : { self }),\n      }),\n    report: (tag?: string) =>\n      auditScene(root, { skip, tagKey, ...(tag === undefined ? {} : { tag }) }),\n    bbox: (target: Target) => measureBounds(root, target, { tagKey }),\n    clearance: (a: Target, b: Target) => measureClearance(root, a, b, { tagKey }),\n    ledger: renderer\n      ? async (ledgerOptions?: RecordDrawLedgerOptions) => {\n          const ledger = await recordDrawLedger(renderer, ledgerOptions);\n\n          printDrawLedger(ledger);\n\n          return ledger;\n        }\n      : needsRenderer(\"ledger\"),\n    beginLedger: renderer\n      ? (ledgerOptions?: DrawLedgerOptions) => {\n          const recording = beginDrawLedger(renderer, ledgerOptions);\n\n          return {\n            end: () => {\n              const ledger = recording.end();\n\n              printDrawLedger(ledger);\n\n              return ledger;\n            },\n          };\n        }\n      : needsRenderer(\"beginLedger\"),\n    blackFrames: renderer\n      ? async (seconds = 10) => {\n          await nextFrame(\n            \"blackFrames()\",\n            FRAME_TIMEOUT,\n            \"Black frames only show in a visible tab: bring it to the front.\",\n          );\n\n          const watch = watchBlackFrames(renderer);\n\n          return new Promise<{ frames: number; blackFrames: readonly number[] }>((resolve) => {\n            setTimeout(() => {\n              watch.stop();\n              resolve({ frames: watch.frames, blackFrames: watch.blackFrames });\n            }, seconds * 1000);\n          });\n        }\n      : needsRenderer(\"blackFrames\"),\n  };\n  const namespace = { ...helpers };\n  const scope = globalThis as Record<string, unknown>;\n\n  if (options.globals !== false) {\n    Object.assign(scope, helpers);\n  }\n\n  scope[NAMESPACE] = namespace;\n\n  return () => {\n    for (const name of NAMES) {\n      if (scope[name] === helpers[name]) {\n        delete scope[name];\n      }\n    }\n\n    if (scope[NAMESPACE] === namespace) {\n      delete scope[NAMESPACE];\n    }\n  };\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkmake/three-audit",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Scene checks for three.js: triangle counts, cost census, NaN normals, z-fighting, black frames and a one-frame draw-call ledger. Zero dependencies.",
   "keywords": [
     "audit",

package/dist/audit-scene-D5ZaENGZ.js

@@ -1,425 +0,0 @@
-//#region src/scene.ts
-/** Depth-first, in child order. A skipped (or, with `visibleOnly`, hidden) object prunes its subtree. */
-const walk = (root, options, visit) => {
-	const stack = [root];
-	while (stack.length > 0) {
-		const object = stack.pop();
-		if (options.visibleOnly === true && !object.visible || options.skip?.(object) === true) continue;
-		visit(object);
-		for (let i = object.children.length - 1; i >= 0; i -= 1) stack.push(object.children[i]);
-	}
-};
-const isMesh = (object) => object.isMesh === true;
-const isInstanced = (mesh) => mesh.isInstancedMesh === true;
-const isBatched = (mesh) => mesh.isBatchedMesh === true;
-/** Triangles one draw of this geometry makes: indexed or not, within its draw range. */
-const triangleCount = (geometry) => {
-	const elements = geometry.index?.count ?? geometry.attributes.position?.count ?? 0;
-	const { start, count } = geometry.drawRange;
-	const drawn = Math.min(elements, start + count) - start;
-	return Math.max(0, Math.floor(drawn / 3));
-};
-/** Triangles a batch draws across its visible instances, and how many instances that is. */
-const batchedTriangles = (batch) => {
-	let triangles = 0;
-	let instances = 0;
-	for (let id = 0; id < batch.maxInstanceCount; id += 1) {
-		let geometryId;
-		try {
-			if (!batch.getVisibleAt(id)) continue;
-			geometryId = batch.getGeometryIdAt(id);
-		} catch {
-			continue;
-		}
-		const range = batch.getGeometryRangeAt(geometryId);
-		const elements = range.count ?? (batch.geometry.index ? range.indexCount : range.vertexCount);
-		triangles += Math.floor(elements / 3);
-		instances += 1;
-	}
-	return {
-		instances,
-		triangles
-	};
-};
-/** The tag of the nearest tagged ancestor (the object itself included), or `null`. */
-const tagOf = (object, tagKey) => {
-	for (let at = object; at; at = at.parent) {
-		const tag = at.userData[tagKey];
-		if (tag !== void 0 && tag !== null) return String(tag);
-	}
-	return null;
-};
-const hasTag = (root, tagKey, skip) => {
-	let found = false;
-	walk(root, { skip }, (object) => {
-		found ||= object.userData[tagKey] !== void 0 && object.userData[tagKey] !== null;
-	});
-	return found;
-};
-const meshName = (mesh) => mesh.name || mesh.geometry.name || mesh.geometry.type;
-const materialName = (mesh) => {
-	const material = Array.isArray(mesh.material) ? mesh.material[0] : mesh.material;
-	return material ? material.name || material.type : "none";
-};
-/** Adds a property JSON and `console.table` leave out: a live object that would serialise the scene. */
-const withHidden = (row, key, value) => Object.defineProperty(row, key, {
-	value,
-	enumerable: false
-});
-//#endregion
-//#region src/bad-geometry.ts
-const corner = (geometry, k) => geometry.index?.getX(k) ?? k;
-const check = (geometry) => {
-	const position = geometry.attributes.position;
-	const normal = geometry.attributes.normal;
-	const flagged = new Uint8Array(position.count);
-	let nonFinite = 0;
-	let zeroNormals = 0;
-	for (let v = 0; v < position.count; v += 1) if (!(Number.isFinite(position.getX(v)) && Number.isFinite(position.getY(v)) && Number.isFinite(position.getZ(v)) && (!normal || Number.isFinite(normal.getX(v)) && Number.isFinite(normal.getY(v)) && Number.isFinite(normal.getZ(v))))) {
-		flagged[v] = 1;
-		nonFinite += 1;
-	}
-	if (!normal) return {
-		nonFinite,
-		zeroNormals
-	};
-	const corners = geometry.index?.count ?? position.count;
-	for (let k = 0; k + 2 < corners; k += 3) {
-		const a = corner(geometry, k);
-		const b = corner(geometry, k + 1);
-		const c = corner(geometry, k + 2);
-		const ux = position.getX(b) - position.getX(a);
-		const uy = position.getY(b) - position.getY(a);
-		const uz = position.getZ(b) - position.getZ(a);
-		const vx = position.getX(c) - position.getX(a);
-		const vy = position.getY(c) - position.getY(a);
-		const vz = position.getZ(c) - position.getZ(a);
-		if (!(Math.hypot(uy * vz - uz * vy, uz * vx - ux * vz, ux * vy - uy * vx) > 1e-8)) continue;
-		for (const v of [
-			a,
-			b,
-			c
-		]) if (flagged[v] === 0 && Math.hypot(normal.getX(v), normal.getY(v), normal.getZ(v)) < 1e-4) {
-			flagged[v] = 1;
-			zeroNormals += 1;
-		}
-	}
-	return {
-		nonFinite,
-		zeroNormals
-	};
-};
-/** Meshes with geometry that renders NaN, hidden ones included. `[]` is a pass. */
-const findBadGeometry = (root, options = {}) => {
-	const tagKey = options.tagKey ?? "studioObject";
-	const rows = [];
-	walk(root, { skip: options.skip }, (object) => {
-		if (!isMesh(object) || !object.geometry.attributes.position) return;
-		const { nonFinite, zeroNormals } = check(object.geometry);
-		if (nonFinite > 0 || zeroNormals > 0) {
-			const under = tagOf(object, tagKey) ?? object.parent?.name ?? "";
-			rows.push(withHidden({
-				mesh: meshName(object),
-				under,
-				nonFinite,
-				zeroNormals
-			}, "object", object));
-		}
-	});
-	return rows;
-};
-//#endregion
-//#region src/triangles.ts
-const cost = (mesh) => {
-	if (isBatched(mesh)) return batchedTriangles(mesh);
-	const instances = isInstanced(mesh) ? mesh.count : 1;
-	return {
-		instances,
-		triangles: triangleCount(mesh.geometry) * instances
-	};
-};
-/**
-* Triangles one pass draws: visible meshes, instances counted, no frustum culling. A shadow pass
-* adds roughly as much again for each shadow-casting light.
-*/
-const countTriangles = (root, options = {}) => {
-	let total = 0;
-	walk(root, {
-		skip: options.skip,
-		visibleOnly: true
-	}, (object) => {
-		if (isMesh(object)) total += cost(object).triangles;
-	});
-	return total;
-};
-/** Every visible mesh, most triangles drawn first. */
-const listMeshes = (root, options = {}) => {
-	const rows = [];
-	walk(root, {
-		skip: options.skip,
-		visibleOnly: true
-	}, (object) => {
-		if (!isMesh(object)) return;
-		const { instances, triangles } = cost(object);
-		const row = {
-			name: meshName(object),
-			triangles: instances > 0 ? Math.round(triangles / instances) : 0,
-			instances,
-			total: triangles
-		};
-		rows.push(withHidden(row, "mesh", object));
-	});
-	return rows.sort((a, b) => b.total - a.total);
-};
-/**
-* Geometries by triangles drawn, hidden meshes included, most first. Name geometries
-* (`geometry.name`) to make this readable. Batches are left out: their shared buffer is not one
-* geometry; `listMeshes` counts them.
-*/
-const geometryCensus = (root, options = {}) => {
-	const rows = /* @__PURE__ */ new Map();
-	walk(root, { skip: options.skip }, (object) => {
-		if (!isMesh(object) || isBatched(object) || !object.geometry.attributes.position) return;
-		const geometry = object.geometry;
-		const key = geometry.name || `${geometry.type}:${geometry.uuid.slice(0, 6)}`;
-		const triangles = triangleCount(geometry);
-		const uses = isInstanced(object) ? object.count : 1;
-		const row = rows.get(key) ?? {
-			geometry: key,
-			uses: 0,
-			triangles,
-			total: 0
-		};
-		row.uses += uses;
-		row.total += triangles * uses;
-		rows.set(key, row);
-	});
-	return [...rows.values()].sort((a, b) => b.total - a.total);
-};
-//#endregion
-//#region src/z-fighting.ts
-/** Normals quantised to 1/40: neighbouring buckets are searched, so this only sets bucket size. */
-const QUANT = 40;
-/** Normals this aligned count as parallel (about 2.6°). */
-const PARALLEL = .999;
-const round = (value) => Math.round(value * 100) / 100;
-const labelOf = (part) => {
-	const centre = part.min.map((low, axis) => round((low + part.max[axis]) / 2));
-	return `${part.tag === null ? "" : `${part.tag}/`}${meshName(part.mesh)} [${materialName(part.mesh)}] @ (${centre.join(", ")})`;
-};
-/** Pairs of meshes that z-fight, most overlapping triangles first. `[]` is a pass. */
-const findZFighting = (root, options = {}) => {
-	const gap = options.gap ?? .004;
-	const self = options.self ?? false;
-	const tagKey = options.tagKey ?? "studioObject";
-	const tagged = options.tagged ?? hasTag(root, tagKey, options.skip);
-	root.updateWorldMatrix(true, true);
-	const parts = [];
-	const owner = [];
-	const planes = [];
-	const corners = [];
-	const keys = [];
-	const buckets = /* @__PURE__ */ new Map();
-	const keyOf = (x, y, z, d) => `${x},${y},${z},${d}`;
-	walk(root, { skip: options.skip }, (object) => {
-		if (!isMesh(object) || isInstanced(object) || isBatched(object) || !object.geometry.attributes.position) return;
-		const tag = tagOf(object, tagKey);
-		if (tagged && tag === null) return;
-		const part = parts.length;
-		const { index, attributes } = object.geometry;
-		const position = attributes.position;
-		const e = object.matrixWorld.elements;
-		const min = [
-			Infinity,
-			Infinity,
-			Infinity
-		];
-		const max = [
-			-Infinity,
-			-Infinity,
-			-Infinity
-		];
-		const count = index?.count ?? position.count;
-		const world = [
-			0,
-			0,
-			0,
-			0,
-			0,
-			0,
-			0,
-			0,
-			0
-		];
-		parts.push({
-			mesh: object,
-			tag,
-			min,
-			max
-		});
-		for (let k = 0; k + 2 < count; k += 3) {
-			for (let c = 0; c < 3; c += 1) {
-				const v = index?.getX(k + c) ?? k + c;
-				const x = position.getX(v);
-				const y = position.getY(v);
-				const z = position.getZ(v);
-				for (let axis = 0; axis < 3; axis += 1) {
-					const value = e[axis] * x + e[axis + 4] * y + e[axis + 8] * z + e[axis + 12];
-					world[c * 3 + axis] = value;
-					min[axis] = Math.min(min[axis], value);
-					max[axis] = Math.max(max[axis], value);
-				}
-			}
-			const [ax, ay, az, bx, by, bz, cx, cy, cz] = world;
-			const ux = bx - ax;
-			const uy = by - ay;
-			const uz = bz - az;
-			const vx = cx - ax;
-			const vy = cy - ay;
-			const vz = cz - az;
-			let nx = uy * vz - uz * vy;
-			let ny = uz * vx - ux * vz;
-			let nz = ux * vy - uy * vx;
-			const length = Math.hypot(nx, ny, nz);
-			if (!(length / 2 >= 1e-5)) continue;
-			nx /= length;
-			ny /= length;
-			nz /= length;
-			const d = nx * ax + ny * ay + nz * az;
-			const id = owner.length;
-			const key = [
-				Math.round(nx * QUANT),
-				Math.round(ny * QUANT),
-				Math.round(nz * QUANT),
-				Math.round(d / gap)
-			];
-			const bucket = buckets.get(keyOf(...key));
-			owner.push(part);
-			planes.push(nx, ny, nz, d);
-			corners.push(...world);
-			keys.push(key);
-			if (bucket) bucket.push(id);
-			else buckets.set(keyOf(...key), [id]);
-		}
-	});
-	const margin = gap / 2;
-	const flat = [
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0,
-		0
-	];
-	const overlaps = (s, t) => {
-		const S = s * 9;
-		const T = t * 9;
-		let ux = corners[S + 3] - corners[S];
-		let uy = corners[S + 4] - corners[S + 1];
-		let uz = corners[S + 5] - corners[S + 2];
-		const length = Math.hypot(ux, uy, uz) || 1;
-		ux /= length;
-		uy /= length;
-		uz /= length;
-		const nx = planes[s * 4];
-		const ny = planes[s * 4 + 1];
-		const nz = planes[s * 4 + 2];
-		const vx = ny * uz - nz * uy;
-		const vy = nz * ux - nx * uz;
-		const vz = nx * uy - ny * ux;
-		for (let i = 0; i < 6; i += 1) {
-			const at = i < 3 ? S + i * 3 : T + (i - 3) * 3;
-			const px = corners[at];
-			const py = corners[at + 1];
-			const pz = corners[at + 2];
-			flat[i * 2] = px * ux + py * uy + pz * uz;
-			flat[i * 2 + 1] = px * vx + py * vy + pz * vz;
-		}
-		for (let edge = 0; edge < 6; edge += 1) {
-			const from = edge;
-			const to = edge < 3 ? (edge + 1) % 3 : 3 + (edge + 1) % 3;
-			const ex = flat[to * 2] - flat[from * 2];
-			const ey = flat[to * 2 + 1] - flat[from * 2 + 1];
-			const edgeLength = Math.hypot(ex, ey) || 1;
-			const axisX = -ey / edgeLength;
-			const axisY = ex / edgeLength;
-			let p0 = Infinity;
-			let p1 = -Infinity;
-			let q0 = Infinity;
-			let q1 = -Infinity;
-			for (let i = 0; i < 6; i += 1) {
-				const value = flat[i * 2] * axisX + flat[i * 2 + 1] * axisY;
-				if (i < 3) {
-					p0 = Math.min(p0, value);
-					p1 = Math.max(p1, value);
-				} else {
-					q0 = Math.min(q0, value);
-					q1 = Math.max(q1, value);
-				}
-			}
-			if (Math.min(p1, q1) - Math.max(p0, q0) < margin) return false;
-		}
-		return true;
-	};
-	const onPlane = (s, t) => {
-		const nx = planes[s * 4];
-		const ny = planes[s * 4 + 1];
-		const nz = planes[s * 4 + 2];
-		const d = planes[s * 4 + 3];
-		for (let c = 0; c < 3; c += 1) {
-			const at = t * 9 + c * 3;
-			if (Math.abs(nx * corners[at] + ny * corners[at + 1] + nz * corners[at + 2] - d) > gap) return false;
-		}
-		return true;
-	};
-	const pairs = /* @__PURE__ */ new Map();
-	for (let s = 0; s < owner.length; s += 1) {
-		const [kx, ky, kz, kd] = keys[s];
-		for (let i = -1; i <= 1; i += 1) for (let j = -1; j <= 1; j += 1) for (let k = -1; k <= 1; k += 1) for (let l = -1; l <= 1; l += 1) for (const t of buckets.get(keyOf(kx + i, ky + j, kz + k, kd + l)) ?? []) {
-			const a = owner[s];
-			const b = owner[t];
-			if (t <= s || a === b && !self || planes[s * 4] * planes[t * 4] + planes[s * 4 + 1] * planes[t * 4 + 1] + planes[s * 4 + 2] * planes[t * 4 + 2] < PARALLEL || !onPlane(s, t) || !onPlane(t, s) || !overlaps(s, t)) continue;
-			const key = a < b ? `${a}:${b}` : `${b}:${a}`;
-			const pair = pairs.get(key) ?? {
-				a: Math.min(a, b),
-				b: Math.max(a, b),
-				triangles: 0
-			};
-			pair.triangles += 1;
-			pairs.set(key, pair);
-		}
-	}
-	return [...pairs.values()].sort((x, y) => y.triangles - x.triangles).map(({ a, b, triangles }) => withHidden({
-		a: labelOf(parts[a]),
-		b: labelOf(parts[b]),
-		triangles
-	}, "meshes", [parts[a].mesh, parts[b].mesh]));
-};
-//#endregion
-//#region src/audit-scene.ts
-/**
-* Every check at once, JSON-safe: what a test asserts on or a headless browser prints. A clean
-* scene has `zFighting` and `badGeometry` both `[]`.
-*/
-const auditScene = (root, options = {}) => {
-	const { skip, tagKey } = options;
-	return {
-		triangles: countTriangles(root, { skip }),
-		zFighting: findZFighting(root, options),
-		badGeometry: findBadGeometry(root, tagKey === void 0 ? { skip } : {
-			skip,
-			tagKey
-		}),
-		meshes: listMeshes(root, { skip }).slice(0, options.top ?? 10)
-	};
-};
-//#endregion
-export { listMeshes as a, geometryCensus as i, findZFighting as n, findBadGeometry as o, countTriangles as r, triangleCount as s, auditScene as t };
-
-//# sourceMappingURL=audit-scene-D5ZaENGZ.js.map