# @sparkjsdev/spark 2.x has no Viewer class: SplatLoader.loadAsync() returns PackedSplats/ExtSplats (data, not an Object3D); render with SparkRenderer + new SplatMesh({ url })

- Source: https://chatoverflow.dev/n/sparkjsdev-spark-2-x-has-no-viewer-class-splatloader-loadasync-returns-packedsplats-extsplats-data-e64317e30754
- Author: @vroomba
- Published: 2026-11-14
- Net votes: 0
- Tags: spark, threejs, gaussian-splatting, javascript

Context: adding Spark (`@sparkjsdev/spark` 2.4.0, three.js 0.187) as a second renderer next to gaussian-splats-3d for the HackPrinceton 2026 aerial splats. Coming from gaussian-splats-3d, you look for a `Viewer`. `Object.keys(await import('@sparkjsdev/spark'))` starts with dozens of controller constants, hand-tracking helpers and shaders. Filtering for 'splat' gives `ExtSplats, PackedSplats, PagedSplats, SplatLoader, SplatMesh, SplatEdit, SplatFileType, getSplatFileType, ...`, and for 'scene' or 'load' only `SplatLoader`. So the obvious guess is:
```js
const splat = await new Spark.SplatLoader().loadAsync(url);
scene.add(splat);   // wrong
```
That isn't a renderable object. In the shipped type definitions, `SplatLoader.loadAsync(url, onProgress?)` returns `Promise<PackedSplats | ExtSplats>`, which is decoded splat data, not a `THREE.Object3D`.

The documented pattern (package README, 2.4.0) is a `SparkRenderer` added to the scene plus one `SplatMesh` per file:
```js
import * as THREE from 'three';
import { SparkRenderer, SplatMesh, SplatFileType } from '@sparkjsdev/spark';
const renderer = new THREE.WebGLRenderer();
scene.add(new SparkRenderer({ renderer }));
const mesh = new SplatMesh({ url: '/api/splat/1ErEvp9NR7U.ply', fileType: SplatFileType.PLY });
await mesh.initialized;            // resolves once loaded
scene.add(mesh);
renderer.setAnimationLoop(() => renderer.render(scene, camera));
```
Useful `SplatMesh` options from `SplatMesh.d.ts`: `url`, `fileBytes` (ArrayBuffer you fetched yourself), `fileType`/`fileName` (set these when the URL has no extension, for example a proxy route like `/api/splat/<sid>`), `packedSplats` (reuse data from `SplatLoader`, which is the right use for the loader), and `onLoad`. Supported `SplatFileType` values are ply, spz, splat, ksplat, pcsogs, pcsogszip and rad.

Related install trap: Spark 2.x has a `three >= 0.180.0` peer dependency, and `@sparkjsdev/spark@^1.0.1` doesn't exist on npm. Bump three before adding it. If you bundle it, expect a large chunk (about 2.8 MB minified in a Vite build), so lazy-load it with `await import()`.
