three-blocks-benchmark 0.2.0-alpha.280.g945a5d860d58

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+# three-blocks-benchmark
+
+## 0.2.0-alpha.280.g945a5d860d58
+
+- CLI: New projects return to the shell and prefer Bun for the development command.
+
+- Devtools: Development stays available when compatible shader receipts predate a version bump.
+
+- Devtools: Headless shader checks ignore automatic favicon misses and allow slow screenshots.
+
+- Library: Gaussian splats now promote still scenes to the fast tile compositor automatically.
+
+- Library: Gaussian splats now stage tile-compositor promotion to avoid frame spikes.
+
+- Library: Gaussian splats now use faster subgroup sorting when the GPU supports it.
+
+- Packages: Benchmarks settle each frame lane before sampling steady-state performance.
+
+- Packages: Benchmarks now compare GaussianSplats3D under the same standard protocol.
+
+- Website: Agent docs and llms.txt match the shipped release and cover Baked Motion format 3.
+
+- Website: Example search now connects every showcased feature to its matching library blocks.
+
+- Packages: Built from `945a5d860d58`.
+
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [22be294]
+  - three-blocks@0.3.1
+
+## 0.1.0
+
+### Minor Changes
+
+- 96be509: Packages: Splat benchmarks compare Three Blocks, Spark, and SuperSplat on canonical scenes.
+- 8bd64d6: Standard suite: the Three Blocks viewer now runs the Graphdeco-faithful configuration — display-space compositing (the 3DGS training convention), classic uncompensated 0.3 screen-space dilation, reference view-Z ordering, and a half-float accumulation target resolved to the canvas once — and streams the PLY read through the library's Response-based parse API so fetch and parsing overlap. Query parameters can override every knob for local experiments; harness diagnostics now include loader phase timings and load-waterfall marks.
+
+### Patch Changes
+
+- Updated dependencies [beb026f]
+- Updated dependencies [967a0ee]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [96be509]
+- Updated dependencies [967a0ee]
+- Updated dependencies [beb026f]
+- Updated dependencies [0c23333]
+- Updated dependencies [e8e7e30]
+- Updated dependencies [a59c7b8]
+- Updated dependencies [beb026f]
+- Updated dependencies [967a0ee]
+- Updated dependencies [8bd64d6]
+- Updated dependencies [a59c7b8]
+- Updated dependencies [967a0ee]
+- Updated dependencies [b328fab]
+- Updated dependencies [0ca530e]
+- Updated dependencies [beb026f]
+- Updated dependencies [8bd64d6]
+- Updated dependencies [e8e7e30]
+- Updated dependencies [967a0ee]
+- Updated dependencies [0ca530e]
+- Updated dependencies [967a0ee]
+- Updated dependencies [9daa49d]
+- Updated dependencies [9daa49d]
+- Updated dependencies [beb026f]
+- Updated dependencies [9daa49d]
+- Updated dependencies [967a0ee]
+- Updated dependencies [967a0ee]
+- Updated dependencies [74a7597]
+- Updated dependencies [0c23333]
+- Updated dependencies [e8e7e30]
+  - three-blocks@0.3.0
+
+## 0.0.0
+
+- Reserved for the first public release.

package/LICENSE

@@ -0,0 +1,75 @@
+Required Notice: Copyright (c) 2025-2026 ロリンジャー株式会社 (Rohlinger K.K.), doing business as Three.js Blocks (https://threejs-blocks.com)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/NOTICE

@@ -0,0 +1,11 @@
+Required Notice: Copyright (c) 2025-2026 ロリンジャー株式会社 (Rohlinger K.K.), doing business as Three.js Blocks (https://threejs-blocks.com)
+
+Three.js Blocks licensing notice
+================================
+
+This software is offered under the PolyForm Noncommercial License 1.0.0:
+https://polyformproject.org/licenses/noncommercial/1.0.0/
+
+LICENSE contains the controlling noncommercial terms. Commercial customers
+receive separate rights under the agreement they accept:
+https://threejs-blocks.com/license

package/README.md

@@ -0,0 +1,65 @@
+# three-blocks-benchmark
+
+Reproducible browser benchmarks for Three Blocks, Spark, and SuperSplat.
+The default `standard` suite uses fixed held-out cameras from Mip-NeRF 360
+Bonsai and a pinned NerfBaselines Graphdeco 30K artifact. The synthetic
+`micro` suite is performance-only.
+
+Published results and methodology:
+<https://threejs-blocks.com/benchmark/gaussian>
+
+## Run
+
+Install Chromium once:
+
+```sh
+npx playwright install chromium
+```
+
+Run the one-view standard validation from npm:
+
+```sh
+npx three-blocks-benchmark --suite standard --quick --output ./benchmark-results
+```
+
+Or run it with Bun:
+
+```sh
+bunx three-blocks-benchmark --suite standard --quick --output ./benchmark-results
+```
+
+Remove `--quick` for the publication run. Publication evidence requires headed
+Chromium on a physical GPU:
+
+```sh
+npx three-blocks-benchmark --suite standard --headed --output ./benchmark-results
+```
+
+The standard suite range-downloads and caches only the stored PLY, selected
+cameras, ground truth, upstream predictions, and provenance JSON. Use
+`--cache <directory>` to choose the cache. The output directory receives local
+renderer captures and `benchmark.json`; upstream and ground-truth PNGs stay in
+the cache. Use `--omit-captures` for metrics-only output. Standard inputs,
+references, and captures must not be redistributed without rights clearance.
+The package contains no Bonsai dataset or model bytes; runtime downloads remain
+subject to their upstream terms.
+
+Run the generated performance microbenchmarks without network data:
+
+```sh
+bunx three-blocks-benchmark --suite micro --quick --output ./micro-results
+```
+
+Use `--report <file>` to place the JSON elsewhere and `--scene <id>` to select
+a micro scene.
+`--revision <value>` and `--dirty` add optional repository metadata; neither
+Git nor a checkout is required.
+
+The CLI uses headed Chromium by default on macOS so WebGPU captures reach the
+physical GPU. `--headless` is available where the browser exposes a working
+WebGPU adapter in headless mode.
+
+Standard reports contain neutral PSNR and dm_pix-compatible SSIM versus ground
+truth. Metrics versus the pinned NerfBaselines Graphdeco 30K prediction are
+separately labeled renderer conformance and only verify camera/projection
+alignment. The three-view subset is not the canonical 37-view aggregate.

package/bin/three-blocks-benchmark.mjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { runBenchmark } from '../lib/run.mjs';
+
+const packageRoot = path.resolve( path.dirname( fileURLToPath( import.meta.url ) ), '..' );
+const { version } = JSON.parse( await readFile( path.join( packageRoot, 'package.json' ), 'utf8' ) );
+const HELP = `three-blocks-benchmark ${version}
+
+Usage:
+  three-blocks-benchmark --output <directory> [options]
+
+Options:
+  --suite <standard|micro>    Run canonical Bonsai quality or synthetic performance
+  --output <directory>       Write captures and the default benchmark.json here
+  --cache <directory>        Cache selectively downloaded standard-suite members
+  --report <file>            Write the JSON report to a different path
+  --capture-url-prefix <url> Prefix capture paths stored in the report
+  --scene <id>               Select a micro scene
+  --quick                    Use one view/scene and short measurements
+  --omit-captures            Write metrics JSON without renderer captures
+  --headed                   Show Chromium
+  --headless                 Hide Chromium
+  --revision <value>         Record an optional source revision
+  --dirty                    Record that the source tree had changes
+  --clean                    Record that the source tree was clean
+  --help                     Show this help
+  --version                  Print the package version
+`;
+
+function parseArgs( rawArgs ) {
+
+	const options = {};
+	for ( let index = 0; index < rawArgs.length; index ++ ) {
+
+		const argument = rawArgs[ index ];
+		if ( argument === '--quick' ) options.quick = true;
+		else if ( argument === '--omit-captures' ) options.omitCaptures = true;
+		else if ( argument === '--headed' ) options.headed = true;
+		else if ( argument === '--headless' ) options.headed = false;
+		else if ( argument === '--dirty' ) options.workingTreeDirty = true;
+		else if ( argument === '--clean' ) options.workingTreeDirty = false;
+		else if ( [ '--suite', '--output', '--cache', '--report', '--capture-url-prefix', '--scene', '--revision' ].includes( argument ) ) {
+
+			const value = rawArgs[ ++ index ];
+			if ( ! value || value.startsWith( '--' ) ) throw new Error( `${argument} requires a value.` );
+			const key = {
+				'--suite': 'suite',
+				'--output': 'output',
+				'--cache': 'cache',
+				'--report': 'report',
+				'--capture-url-prefix': 'captureUrlPrefix',
+				'--scene': 'scene',
+				'--revision': 'revision',
+			}[ argument ];
+			options[ key ] = value;
+
+		} else {
+
+			throw new Error( `Unknown option: ${argument}` );
+
+		}
+
+	}
+	if ( ! options.output ) throw new Error( '--output is required.' );
+	return options;
+
+}
+
+const args = process.argv.slice( 2 );
+if ( args.includes( '--help' ) ) {
+
+	process.stdout.write( HELP );
+
+} else if ( args.includes( '--version' ) ) {
+
+	process.stdout.write( `${version}\n` );
+
+} else {
+
+	runBenchmark( parseArgs( args ) ).catch( error => {
+
+		console.error( error );
+		process.exitCode = 1;
+
+	} );
+
+}