gaussian-splat-lite 1.4.2 → 1.4.3

package/dist/types/data/IndexedSplats.d.cts

@@ -53,7 +53,6 @@ export declare abstract class IndexedSplats extends Splats {
     allocation: number,
   ): void;
   private getStorageIndex;
-  getSourceIndex(index: number): number;
   private checkVisibleRange;
   getNumSh(): 0 | 1 | 2 | 3 | 4;
   /** Estimated GPU storage for packed records, render indices and opacity tables. */
@@ -84,9 +83,7 @@ export declare abstract class IndexedSplats extends Splats {
     callback: (index: number, x: number, y: number, z: number) => void,
   ): void;
   forEachSplat(callback: Parameters<Splats["forEachSplat"]>[0]): void;
-  takeData(): SplatResult & {
-    sourceIds: Uint32Array;
-  };
+  takeData(): SplatResult;
   setTextureUniforms(uniforms: Record<string, THREE.IUniform>): void;
   dispose(): void;
 }

package/dist/types/data/IndexedSplats.d.ts

@@ -53,7 +53,6 @@ export declare abstract class IndexedSplats extends Splats {
     allocation: number,
   ): void;
   private getStorageIndex;
-  getSourceIndex(index: number): number;
   private checkVisibleRange;
   getNumSh(): 0 | 1 | 2 | 3 | 4;
   /** Estimated GPU storage for packed records, render indices and opacity tables. */
@@ -84,9 +83,7 @@ export declare abstract class IndexedSplats extends Splats {
     callback: (index: number, x: number, y: number, z: number) => void,
   ): void;
   forEachSplat(callback: Parameters<Splats["forEachSplat"]>[0]): void;
-  takeData(): SplatResult & {
-    sourceIds: Uint32Array;
-  };
+  takeData(): SplatResult;
   setTextureUniforms(uniforms: Record<string, THREE.IUniform>): void;
   dispose(): void;
 }

package/dist/types/data/Splats.d.cts

@@ -33,7 +33,7 @@ export declare class Splats {
   numSplats: number;
   private splatArrays;
   private sortCenters?;
-  protected sourceIds: Uint32Array;
+  private storageOrder?;
   protected centerOnlyBounds: Float32Array;
   protected bounds: Float32Array;
   private spatialBounds;
@@ -59,11 +59,7 @@ export declare class Splats {
   /** Current retained bytes for encoded Splat, sort-center, and SH arrays. */
   getByteLength(): number;
   /** @internal Consume owned arrays for transfer to a streaming worker. */
-  takeData(): SplatResult & {
-    sourceIds: Uint32Array;
-  };
-  /** Original source ID, retained across reordering and range extraction. */
-  getSourceIndex(index: number): number;
+  takeData(): SplatResult;
   getSplat(index: number): DecodedSplatWithSh;
   getSplat(index: number, includeSh: true): DecodedSplatWithSh;
   getSplat(index: number, includeSh: false): DecodedSplat;

package/dist/types/data/Splats.d.ts

@@ -33,7 +33,7 @@ export declare class Splats {
   numSplats: number;
   private splatArrays;
   private sortCenters?;
-  protected sourceIds: Uint32Array;
+  private storageOrder?;
   protected centerOnlyBounds: Float32Array;
   protected bounds: Float32Array;
   private spatialBounds;
@@ -59,11 +59,7 @@ export declare class Splats {
   /** Current retained bytes for encoded Splat, sort-center, and SH arrays. */
   getByteLength(): number;
   /** @internal Consume owned arrays for transfer to a streaming worker. */
-  takeData(): SplatResult & {
-    sourceIds: Uint32Array;
-  };
-  /** Original source ID, retained across reordering and range extraction. */
-  getSourceIndex(index: number): number;
+  takeData(): SplatResult;
   getSplat(index: number): DecodedSplatWithSh;
   getSplat(index: number, includeSh: true): DecodedSplatWithSh;
   getSplat(index: number, includeSh: false): DecodedSplat;

package/dist/types/data/defines.d.cts

@@ -25,8 +25,8 @@ export type SplatResult = {
   numSplats: number;
   splatArrays: [Uint32Array, Uint32Array];
   sortCenters?: Float32Array;
-  /** Storage index to original source index; absent for identity order. */
-  sourceIds?: Uint32Array;
+  /** Internal permutation for restoring custom SOG chunks to decoded record order. */
+  storageOrder?: Uint32Array;
   /** Local finite center bounds: min XYZ followed by max XYZ. */
   centerOnlyBoundingBox?: Float32Array;
   /** Local scale/rotation bounds at source alpha 0.01, including kernel shape. */
@@ -35,9 +35,8 @@ export type SplatResult = {
   spatialBounds?: Float32Array;
   extra: SplatExtra;
 };
-/** Spatially reordered records with source IDs and cached local bounds. */
+/** Spatially reordered records with cached local bounds. */
 export type ReorderedSplatResult = SplatResult & {
-  sourceIds: Uint32Array;
   centerOnlyBoundingBox: Float32Array;
   boundingBox: Float32Array;
   spatialBounds: Float32Array;

package/dist/types/data/defines.d.ts

@@ -25,8 +25,8 @@ export type SplatResult = {
   numSplats: number;
   splatArrays: [Uint32Array, Uint32Array];
   sortCenters?: Float32Array;
-  /** Storage index to original source index; absent for identity order. */
-  sourceIds?: Uint32Array;
+  /** Internal permutation for restoring custom SOG chunks to decoded record order. */
+  storageOrder?: Uint32Array;
   /** Local finite center bounds: min XYZ followed by max XYZ. */
   centerOnlyBoundingBox?: Float32Array;
   /** Local scale/rotation bounds at source alpha 0.01, including kernel shape. */
@@ -35,9 +35,8 @@ export type SplatResult = {
   spatialBounds?: Float32Array;
   extra: SplatExtra;
 };
-/** Spatially reordered records with source IDs and cached local bounds. */
+/** Spatially reordered records with cached local bounds. */
 export type ReorderedSplatResult = SplatResult & {
-  sourceIds: Uint32Array;
   centerOnlyBoundingBox: Float32Array;
   boundingBox: Float32Array;
   spatialBounds: Float32Array;

package/dist/types/data/splatData.d.cts

@@ -25,7 +25,7 @@ export declare function getSplatTextureBytes(
 export declare function getSplatByteLength(data: {
   splatArrays: readonly Uint32Array[];
   sortCenters?: Float32Array;
-  sourceIds?: Uint32Array;
+  storageOrder?: Uint32Array;
   centerOnlyBoundingBox?: Float32Array;
   boundingBox?: Float32Array;
   spatialBounds?: Float32Array;

package/dist/types/data/splatData.d.ts

@@ -25,7 +25,7 @@ export declare function getSplatTextureBytes(
 export declare function getSplatByteLength(data: {
   splatArrays: readonly Uint32Array[];
   sortCenters?: Float32Array;
-  sourceIds?: Uint32Array;
+  storageOrder?: Uint32Array;
   centerOnlyBoundingBox?: Float32Array;
   boundingBox?: Float32Array;
   spatialBounds?: Float32Array;

package/dist/types/data/splatRange.d.cts

@@ -1,5 +1,5 @@
 import type { SplatResult } from "./defines.cjs";
-/** Copy file-order records; the caller assigns source IDs after reordering. */
+/** Copy a contiguous range of file-order records before spatial reordering. */
 export declare function extractSplatRange(
   source: SplatResult,
   start: number,

package/dist/types/data/splatRange.d.ts

@@ -1,5 +1,5 @@
 import type { SplatResult } from "./defines.js";
-/** Copy file-order records; the caller assigns source IDs after reordering. */
+/** Copy a contiguous range of file-order records before spatial reordering. */
 export declare function extractSplatRange(
   source: SplatResult,
   start: number,

package/dist/types/loaders/morton.d.cts

@@ -1,9 +1,12 @@
 import type { ReorderedSplatResult, SplatResult } from "../data/defines.cjs";
-/** Reorder packed attributes together and retain their original source indices. */
+/** Reorder packed attributes and bounds, optionally writing the storage permutation. */
 export declare function reorderSplats(
   data: SplatResult,
-  boundsBlocks?: Float32Array,
-  onProgress?: (loaded: number, total: number) => void,
+  options?: {
+    boundsBlocks?: Float32Array;
+    storageOrder?: Uint32Array;
+    onProgress?: (loaded: number, total: number) => void;
+  },
 ): asserts data is ReorderedSplatResult;
 /** Restore packed chunk file order bit for bit; discard unused sort centers. */
 export declare function restoreSplatOrder(data: SplatResult): void;

package/dist/types/loaders/morton.d.ts

@@ -1,9 +1,12 @@
 import type { ReorderedSplatResult, SplatResult } from "../data/defines.js";
-/** Reorder packed attributes together and retain their original source indices. */
+/** Reorder packed attributes and bounds, optionally writing the storage permutation. */
 export declare function reorderSplats(
   data: SplatResult,
-  boundsBlocks?: Float32Array,
-  onProgress?: (loaded: number, total: number) => void,
+  options?: {
+    boundsBlocks?: Float32Array;
+    storageOrder?: Uint32Array;
+    onProgress?: (loaded: number, total: number) => void;
+  },
 ): asserts data is ReorderedSplatResult;
 /** Restore packed chunk file order bit for bit; discard unused sort centers. */
 export declare function restoreSplatOrder(data: SplatResult): void;

package/dist/types/loaders/postDecode/protocol.d.cts

@@ -183,6 +183,7 @@ export type PostDecodeSplatData = {
   splat0: Uint32Array;
   splat1: Uint32Array;
   sortCenters: Float32Array;
+  /** Original RAD node indices for attributes after non-leaf records are omitted. */
   sourceIds?: Uint32Array;
   shBlock0?: Uint32Array;
   shBlock1?: Uint32Array;

package/dist/types/loaders/postDecode/protocol.d.ts

@@ -183,6 +183,7 @@ export type PostDecodeSplatData = {
   splat0: Uint32Array;
   splat1: Uint32Array;
   sortCenters: Float32Array;
+  /** Original RAD node indices for attributes after non-leaf records are omitted. */
   sourceIds?: Uint32Array;
   shBlock0?: Uint32Array;
   shBlock1?: Uint32Array;

package/dist/types/loaders/rad.d.cts

@@ -1,8 +1,8 @@
-import type { SplatSourceArgs as LoadRadArgs } from "./loadTypes.cjs";
+import type { SplatLoadArgs, SplatSourceArgs } from "./loadTypes.cjs";
 import type { PostDecodeSplatData } from "./postDecode/protocol.cjs";
 export { isRadPrefix } from "./rad/radFormat.cjs";
-type RadOutput = PostDecodeSplatData & {
-  sourceIds: Uint32Array;
-};
+type LoadRadArgs = SplatSourceArgs & Pick<SplatLoadArgs, "postDecode">;
 /** Complete-file RAD decode with validated chunk coverage and LOD trees. */
-export declare function loadRad(args: LoadRadArgs): Promise<RadOutput>;
+export declare function loadRad(
+  args: LoadRadArgs,
+): Promise<PostDecodeSplatData>;

package/dist/types/loaders/rad.d.ts

@@ -1,8 +1,8 @@
-import type { SplatSourceArgs as LoadRadArgs } from "./loadTypes.js";
+import type { SplatLoadArgs, SplatSourceArgs } from "./loadTypes.js";
 import type { PostDecodeSplatData } from "./postDecode/protocol.js";
 export { isRadPrefix } from "./rad/radFormat.js";
-type RadOutput = PostDecodeSplatData & {
-  sourceIds: Uint32Array;
-};
+type LoadRadArgs = SplatSourceArgs & Pick<SplatLoadArgs, "postDecode">;
 /** Complete-file RAD decode with validated chunk coverage and LOD trees. */
-export declare function loadRad(args: LoadRadArgs): Promise<RadOutput>;
+export declare function loadRad(
+  args: LoadRadArgs,
+): Promise<PostDecodeSplatData>;

package/dist/types/loaders/stream/rad-stream/RadStreamScheduler.d.cts

@@ -119,8 +119,6 @@ export declare class RadStreamScheduler {
   private releasePage;
   private isPageRequired;
   private releaseUnused;
-  /** Map a raycast hit's rendered index back to its stable file index. */
-  getGlobalIndex(mesh: THREE.Object3D, renderedIndex: number): number;
   private changed;
   private failed;
   private stopRefinement;

package/dist/types/loaders/stream/rad-stream/RadStreamScheduler.d.ts

@@ -119,8 +119,6 @@ export declare class RadStreamScheduler {
   private releasePage;
   private isPageRequired;
   private releaseUnused;
-  /** Map a raycast hit's rendered index back to its stable file index. */
-  getGlobalIndex(mesh: THREE.Object3D, renderedIndex: number): number;
   private changed;
   private failed;
   private stopRefinement;

package/dist/types/loaders/stream/sog-stream/SogStreamLoader.d.cts

@@ -6,7 +6,7 @@ import type { SogLodRequest } from "./sogVisibility.cjs";
 import type { SogChunkInfo } from "./workerHandlers.cjs";
 export type SogStreamLoaderOptions = StreamRequestOptions & {
   url: string;
-  /** Returns owned data in file order, or with a complete source ID map. */
+  /** Returns owned Splats; the loader restores their decoded record order before slicing. */
   loadChunk?: (url: string, signal: AbortSignal) => Promise<Splats>;
 };
 /** A retained worker cache; extraction transfers owned packed arrays to the caller. */

package/dist/types/loaders/stream/sog-stream/SogStreamLoader.d.ts

@@ -6,7 +6,7 @@ import type { SogLodRequest } from "./sogVisibility.js";
 import type { SogChunkInfo } from "./workerHandlers.js";
 export type SogStreamLoaderOptions = StreamRequestOptions & {
   url: string;
-  /** Returns owned data in file order, or with a complete source ID map. */
+  /** Returns owned Splats; the loader restores their decoded record order before slicing. */
   loadChunk?: (url: string, signal: AbortSignal) => Promise<Splats>;
 };
 /** A retained worker cache; extraction transfers owned packed arrays to the caller. */

package/dist/types/loaders/stream/sog-stream/SogStreamScheduler.d.cts

@@ -10,6 +10,10 @@ export type SogStreamSchedulerOptions = SogStreamLoaderOptions &
     lodBaseDistance?: number;
     /** Distance multiplier between LOD levels in both modes; defaults to 2. Must be finite and at least 1. */
     lodMultiplier?: number;
+    /** Effective distance multiplier directly behind a camera; defaults to 4. Must be finite and at least 1. */
+    lodBehindPenalty?: number;
+    /** Shrinks oversized regions toward their median size for LOD distance only; defaults to 0.75. Must be between 0 and 1. */
+    lodDistanceShrink?: number;
   };
 export type SogStreamStats = StreamStats & {
   visibleRegions: number;
@@ -26,6 +30,8 @@ export declare class SogStreamScheduler {
   private _splatBudgetMode;
   private _lodBaseDistance;
   private _lodMultiplier;
+  private _lodBehindPenalty;
+  private _lodDistanceShrink;
   private readonly options;
   private readonly loader;
   private readonly abort;
@@ -35,6 +41,7 @@ export declare class SogStreamScheduler {
   private view?;
   private lastRequestedKey;
   private selecting;
+  private refinementStopped;
   private selection;
   private chunks;
   /** Chunks with a batch, cached source or in-flight load. */
@@ -60,6 +67,12 @@ export declare class SogStreamScheduler {
   /** Distance multiplier between LOD levels; affects both budget modes. */
   get lodMultiplier(): number;
   set lodMultiplier(value: number);
+  /** Effective distance multiplier directly behind a camera; 1 disables it. */
+  get lodBehindPenalty(): number;
+  set lodBehindPenalty(value: number);
+  /** Fraction of excess region size removed when measuring LOD distance. */
+  get lodDistanceShrink(): number;
+  set lodDistanceShrink(value: number);
   get stats(): SogStreamStats;
   /** Group-local bounds from the index; available after initialized resolves. */
   getBoundingBox(): THREE.Box3;
@@ -70,7 +83,7 @@ export declare class SogStreamScheduler {
   /**
    * Select detail for this camera on each update. Detail follows distance,
    * so it needs no resolution. For WebXR register renderer.xr.getCamera(): it
-   * selects the greatest detail needed by any eye that sees the region. Returns whether the camera was
+   * selects the greatest detail needed by any eye. Returns whether the camera was
    * newly added.
    */
   setCamera(camera: THREE.Camera): boolean;
@@ -78,7 +91,7 @@ export declare class SogStreamScheduler {
   deleteCamera(camera: THREE.Camera): boolean;
   /**
    * Call before rendering. Returns whether the displayed data changed. Each
-   * leaf uses the distance of the nearest registered camera that sees it.
+   * leaf uses the smallest effective distance across registered cameras.
    */
   update(): boolean;
   private requestSelection;
@@ -103,5 +116,6 @@ export declare class SogStreamScheduler {
   private failed;
   private readonly retryTimer;
   private rejectFirstIfUnavailable;
+  private stopRefinement;
   dispose(): void;
 }

package/dist/types/loaders/stream/sog-stream/SogStreamScheduler.d.ts

@@ -10,6 +10,10 @@ export type SogStreamSchedulerOptions = SogStreamLoaderOptions &
     lodBaseDistance?: number;
     /** Distance multiplier between LOD levels in both modes; defaults to 2. Must be finite and at least 1. */
     lodMultiplier?: number;
+    /** Effective distance multiplier directly behind a camera; defaults to 4. Must be finite and at least 1. */
+    lodBehindPenalty?: number;
+    /** Shrinks oversized regions toward their median size for LOD distance only; defaults to 0.75. Must be between 0 and 1. */
+    lodDistanceShrink?: number;
   };
 export type SogStreamStats = StreamStats & {
   visibleRegions: number;
@@ -26,6 +30,8 @@ export declare class SogStreamScheduler {
   private _splatBudgetMode;
   private _lodBaseDistance;
   private _lodMultiplier;
+  private _lodBehindPenalty;
+  private _lodDistanceShrink;
   private readonly options;
   private readonly loader;
   private readonly abort;
@@ -35,6 +41,7 @@ export declare class SogStreamScheduler {
   private view?;
   private lastRequestedKey;
   private selecting;
+  private refinementStopped;
   private selection;
   private chunks;
   /** Chunks with a batch, cached source or in-flight load. */
@@ -60,6 +67,12 @@ export declare class SogStreamScheduler {
   /** Distance multiplier between LOD levels; affects both budget modes. */
   get lodMultiplier(): number;
   set lodMultiplier(value: number);
+  /** Effective distance multiplier directly behind a camera; 1 disables it. */
+  get lodBehindPenalty(): number;
+  set lodBehindPenalty(value: number);
+  /** Fraction of excess region size removed when measuring LOD distance. */
+  get lodDistanceShrink(): number;
+  set lodDistanceShrink(value: number);
   get stats(): SogStreamStats;
   /** Group-local bounds from the index; available after initialized resolves. */
   getBoundingBox(): THREE.Box3;
@@ -70,7 +83,7 @@ export declare class SogStreamScheduler {
   /**
    * Select detail for this camera on each update. Detail follows distance,
    * so it needs no resolution. For WebXR register renderer.xr.getCamera(): it
-   * selects the greatest detail needed by any eye that sees the region. Returns whether the camera was
+   * selects the greatest detail needed by any eye. Returns whether the camera was
    * newly added.
    */
   setCamera(camera: THREE.Camera): boolean;
@@ -78,7 +91,7 @@ export declare class SogStreamScheduler {
   deleteCamera(camera: THREE.Camera): boolean;
   /**
    * Call before rendering. Returns whether the displayed data changed. Each
-   * leaf uses the distance of the nearest registered camera that sees it.
+   * leaf uses the smallest effective distance across registered cameras.
    */
   update(): boolean;
   private requestSelection;
@@ -103,5 +116,6 @@ export declare class SogStreamScheduler {
   private failed;
   private readonly retryTimer;
   private rejectFirstIfUnavailable;
+  private stopRefinement;
   dispose(): void;
 }

package/dist/types/loaders/stream/sog-stream/sogLod.d.cts

@@ -32,8 +32,10 @@ export type SogLodManifest = {
 export declare const SOG_LOD_STRIDE = 4;
 /** Packed worker index. Float64 preserves source bounds and safe-integer counts. */
 export type SogLodIndex = {
-  /** Preorder nodes: min XYZ, max XYZ, next index after the subtree, leaf ID (-1 for interiors). */
-  nodes: Float64Array;
+  /** Root min XYZ and max XYZ. */
+  bounds: Float64Array;
+  /** Per leaf ID: min XYZ and max XYZ. */
+  leafBounds: Float64Array;
   leafOffsets: Uint32Array;
   /** Per level: level, file, offset, count. */
   lods: Float64Array;
@@ -42,12 +44,9 @@ export type SogLodIndex = {
   counts: Float64Array;
   environment?: string;
 };
-/** Scheduler metadata; the complete spatial tree stays in the LOD worker. */
-export type SogLodMetadata = Omit<SogLodIndex, "nodes" | "lodLevels"> & {
-  /** Root min XYZ and max XYZ. */
-  bounds: Float64Array;
-};
-/** Flatten the tree and ranges into transferable typed arrays. */
+/** Scheduler metadata; per-region bounds stay in the LOD worker. */
+export type SogLodMetadata = Omit<SogLodIndex, "leafBounds" | "lodLevels">;
+/** Pack region bounds and ranges into transferable typed arrays. */
 export declare function packSogLodIndex(manifest: SogLodManifest): SogLodIndex;
 /** Materialize only leaves visited by the camera, preserving stable range identities. */
 export declare function readSogLodLeaf(
@@ -61,7 +60,7 @@ export declare function parseSogLodManifest(
 ): SogLodManifest;
 export type SogVisibleLeaf = {
   leaf: SogLodLeaf;
-  /** World-space distance to the region, compensated for the camera's field of view. */
+  /** Distance to the corrected region bounds, including camera direction and field of view. */
   distance: number;
 };
 export type SogBudgetMode = "target" | "limit";

package/dist/types/loaders/stream/sog-stream/sogLod.d.ts

@@ -32,8 +32,10 @@ export type SogLodManifest = {
 export declare const SOG_LOD_STRIDE = 4;
 /** Packed worker index. Float64 preserves source bounds and safe-integer counts. */
 export type SogLodIndex = {
-  /** Preorder nodes: min XYZ, max XYZ, next index after the subtree, leaf ID (-1 for interiors). */
-  nodes: Float64Array;
+  /** Root min XYZ and max XYZ. */
+  bounds: Float64Array;
+  /** Per leaf ID: min XYZ and max XYZ. */
+  leafBounds: Float64Array;
   leafOffsets: Uint32Array;
   /** Per level: level, file, offset, count. */
   lods: Float64Array;
@@ -42,12 +44,9 @@ export type SogLodIndex = {
   counts: Float64Array;
   environment?: string;
 };
-/** Scheduler metadata; the complete spatial tree stays in the LOD worker. */
-export type SogLodMetadata = Omit<SogLodIndex, "nodes" | "lodLevels"> & {
-  /** Root min XYZ and max XYZ. */
-  bounds: Float64Array;
-};
-/** Flatten the tree and ranges into transferable typed arrays. */
+/** Scheduler metadata; per-region bounds stay in the LOD worker. */
+export type SogLodMetadata = Omit<SogLodIndex, "leafBounds" | "lodLevels">;
+/** Pack region bounds and ranges into transferable typed arrays. */
 export declare function packSogLodIndex(manifest: SogLodManifest): SogLodIndex;
 /** Materialize only leaves visited by the camera, preserving stable range identities. */
 export declare function readSogLodLeaf(
@@ -61,7 +60,7 @@ export declare function parseSogLodManifest(
 ): SogLodManifest;
 export type SogVisibleLeaf = {
   leaf: SogLodLeaf;
-  /** World-space distance to the region, compensated for the camera's field of view. */
+  /** Distance to the corrected region bounds, including camera direction and field of view. */
   distance: number;
 };
 export type SogBudgetMode = "target" | "limit";

package/dist/types/loaders/stream/sog-stream/sogVisibility.d.cts

@@ -2,19 +2,21 @@ import type * as THREE from "three";
 import type { SogLodIndex, SogLodOptions } from "./sogLod.cjs";
 export type SogCamera = {
   modelView: number[];
-  projection: number[];
-  coordinateSystem: THREE.CoordinateSystem;
-  reversedDepth: boolean;
+  fovScale: number;
 };
 export type SogView = {
   /** The registered cameras that see the group; selection serves all of them. */
   cameras: SogCamera[];
   shown: boolean;
 };
-export type SogLodRequest = SogLodOptions & { view: SogView };
+export type SogLodRequest = SogLodOptions & {
+  view: SogView;
+  lodBehindPenalty: number;
+  lodDistanceShrink: number;
+};
 /**
  * Capture the cameras that see the group without traversing the manifest or
- * reducing matrix precision. WebXR selects detail from each eye's current pose and frustum.
+ * reducing matrix precision. WebXR selects detail from each eye's current pose.
  */
 export declare function captureSogView(
   cameras: readonly THREE.Camera[],
@@ -27,12 +29,16 @@ export declare class SogVisibility {
   private readonly manifest;
   private readonly leaves;
   private readonly cameras;
-  private readonly clip;
   private readonly bound;
+  private readonly typicalHalfSize;
+  private readonly shrink;
   private readonly closest;
   private readonly inverseModelView;
   constructor(
-    manifest: Pick<SogLodIndex, "nodes" | "leafOffsets" | "lods" | "lodLevels">,
+    manifest: Pick<
+      SogLodIndex,
+      "leafBounds" | "leafOffsets" | "lods" | "lodLevels"
+    >,
   );
   private prepareCameras;
   private collect;

package/dist/types/loaders/stream/sog-stream/sogVisibility.d.ts

@@ -2,19 +2,21 @@ import type * as THREE from "three";
 import type { SogLodIndex, SogLodOptions } from "./sogLod.js";
 export type SogCamera = {
   modelView: number[];
-  projection: number[];
-  coordinateSystem: THREE.CoordinateSystem;
-  reversedDepth: boolean;
+  fovScale: number;
 };
 export type SogView = {
   /** The registered cameras that see the group; selection serves all of them. */
   cameras: SogCamera[];
   shown: boolean;
 };
-export type SogLodRequest = SogLodOptions & { view: SogView };
+export type SogLodRequest = SogLodOptions & {
+  view: SogView;
+  lodBehindPenalty: number;
+  lodDistanceShrink: number;
+};
 /**
  * Capture the cameras that see the group without traversing the manifest or
- * reducing matrix precision. WebXR selects detail from each eye's current pose and frustum.
+ * reducing matrix precision. WebXR selects detail from each eye's current pose.
  */
 export declare function captureSogView(
   cameras: readonly THREE.Camera[],
@@ -27,12 +29,16 @@ export declare class SogVisibility {
   private readonly manifest;
   private readonly leaves;
   private readonly cameras;
-  private readonly clip;
   private readonly bound;
+  private readonly typicalHalfSize;
+  private readonly shrink;
   private readonly closest;
   private readonly inverseModelView;
   constructor(
-    manifest: Pick<SogLodIndex, "nodes" | "leafOffsets" | "lods" | "lodLevels">,
+    manifest: Pick<
+      SogLodIndex,
+      "leafBounds" | "leafOffsets" | "lods" | "lodLevels"
+    >,
   );
   private prepareCameras;
   private collect;

package/dist/types/loaders/stream/streamOptions.d.cts

@@ -21,7 +21,7 @@ export type StreamStats = {
   residentMeshes: number;
   /** Decoded chunks, including cached chunks that are not currently drawn. */
   residentChunks: number;
-  /** Retained CPU data, excluding pending copies and WASM memory. */
+  /** Estimated CPU cache, excluding pending copies and worker heap overhead. */
   residentCpuBytes: number;
   /** Estimated GPU storage for resident streaming data; excludes renderer buffers. */
   residentGpuBytes: number;

package/dist/types/loaders/stream/streamOptions.d.ts

@@ -21,7 +21,7 @@ export type StreamStats = {
   residentMeshes: number;
   /** Decoded chunks, including cached chunks that are not currently drawn. */
   residentChunks: number;
-  /** Retained CPU data, excluding pending copies and WASM memory. */
+  /** Estimated CPU cache, excluding pending copies and worker heap overhead. */
   residentCpuBytes: number;
   /** Estimated GPU storage for resident streaming data; excludes renderer buffers. */
   residentGpuBytes: number;

package/dist/types/scene/SplatMesh.d.cts

@@ -38,8 +38,6 @@ export type SplatMeshFrameContext = {
 export type SplatIntersection = THREE.Intersection<SplatMesh> & {
   /** Current readable index in this mesh's Splats. */
   index: number;
-  /** Original file index; for streamed SOG, relative to this batch's chunk. */
-  sourceIndex: number;
 };
 /** A scene object backed by a fixed encoded splat source and RGBA SDF edits. */
 export declare class SplatMesh extends THREE.Object3D {

package/dist/types/scene/SplatMesh.d.ts

@@ -38,8 +38,6 @@ export type SplatMeshFrameContext = {
 export type SplatIntersection = THREE.Intersection<SplatMesh> & {
   /** Current readable index in this mesh's Splats. */
   index: number;
-  /** Original file index; for streamed SOG, relative to this batch's chunk. */
-  sourceIndex: number;
 };
 /** A scene object backed by a fixed encoded splat source and RGBA SDF edits. */
 export declare class SplatMesh extends THREE.Object3D {

package/docs/BuildRad.md

@@ -84,6 +84,7 @@ See [RadStreamScheduler](RadStreamScheduler.md) for the complete loading and dis
 | --- | --- | --- |
 | `--lod-base <base>` | `1.75` | LOD spacing, from `1.1` to `16`; smaller values retain more detail levels. |
 | `--max-sh <0..3>` | `3` | Highest SH degree to keep, limited by the input. |
+| `--within-dist <x,y,z,radius>` | Disabled | Keep splat centers inside or on a sphere before building LOD, in input coordinates. |
 | `--memory-budget <GiB>` | `4` | Target memory use in GiB, at least `1`; for example `16`. |
 | `--temp-dir <path>` | System temp directory | Location for temporary files; created if needed. |
 | `--rad-chunked` | Disabled | Write a header and separate `.radc` files. |