fix(gsplat): address review issues from #259 — transforms, progress bar, themeable colors

[lucianfialho]

Built on top of @ManzoliW's excellent work in #259. This PR addresses the 5 issues raised in the maintainer review.

Changes

1. Splat transforms now applied (position, rotation, scale)

Loader.LoadAsync returns a Splat object — the d.ts declared it as Promise<void>, so transforms were impossible to apply. Fixed the type declaration and now apply position/rotation/scale after each load. Added eulerToQuaternion helper to convert Vec3 degree angles to Quaternion.

2. visible prop forwarded end-to-end

Added visible to SplatEntry, GaussianSplatHandle, and the load loop. The GaussianSplatComponent now tracks and exposes it via useImperativeHandle.

3. quality, alphaHash, toneMapped removed from standalone catalog

These have no equivalent in the gsplat.js API. They remain in @json-render/react-three-fiber where drei's Splat supports them. Keeping them in the standalone catalog was misleading — silently ignored.

4. Progress bar can no longer jump backwards

setProgress(overallProgress) → setProgress(prev => Math.max(prev, overallProgress)).

5. ProgressIndicator colors are now themeable

Added progressBarColor, progressTrackColor, progressTextColor, progressBackgroundColor props to GaussianSplatViewer.

Bonus: Pre-existing TS2769/TS2322 type error fixed

props.position ?? DEFAULT_POS inferred as [number, number, number, ...unknown[]] instead of Vec3 — added explicit as Vec3 casts.

[vercel]

@lucianfialho is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	gsplat@​1.2.9

View full report

[vercel]

The standalone gsplat API docs incorrectly list quality, alphaHash, and toneMapped as GaussianSplat props, but these don't exist in the standalone gsplat schema.

[vercel]

Suggested change

	// Rotate the camera around the Y axis
	const speed = autoRotateSpeed * 0.5;
	const angle = speed * dt;
	const pos = camera.position;
	const cos = Math.cos(angle);
	const sin = Math.sin(angle);
	camera.position = new SPLAT.Vector3(
	pos.x * cos - pos.z * sin,
	pos.y,
	pos.x * sin + pos.z * cos,
	// Rotate the camera around the Y axis, centered on the camera target
	const speed = autoRotateSpeed * 0.5;
	const angle = speed * dt;
	const pos = camera.position;
	const cos = Math.cos(angle);
	const sin = Math.sin(angle);
	const tx = cameraTarget ? cameraTarget[0] : 0;
	const tz = cameraTarget ? cameraTarget[2] : 0;
	const dx = pos.x - tx;
	const dz = pos.z - tz;
	camera.position = new SPLAT.Vector3(
	tx + dx * cos - dz * sin,
	pos.y,
	tz + dx * sin + dz * cos,

Auto-rotation rotates the camera around the world origin (0,0,0) instead of around the configured cameraTarget, causing visible wobble/drift when the target is not at origin.