gaussian-splat-lite 1.2.2 → 1.3.1

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

@@ -1,44 +1,54 @@
-import { Group, LoadingManager } from 'three';
-import { SplatRequestOptions } from '../loadTypes.cjs';
+import type { Group, LoadingManager } from "three";
+import type { SplatRequestOptions } from "../loadTypes.cjs";
 export type StreamRequestOptions = SplatRequestOptions & {
-    manager?: LoadingManager;
+  manager?: LoadingManager;
 };
 export type StreamSchedulerOptions = {
-    group?: Group;
-    /** Initial Splat budget; update scheduler.splatBudget to change it at runtime. */
-    splatBudget?: number;
-    /** Milliseconds to retain unused data after fade-out; defaults to 2000. */
-    cooldownMs?: number;
-    fadeDurationMs?: number;
-    /** Active downloads/decodes. Ready copies use a separate bounded byte queue. */
-    maxConcurrentLoads?: number;
-    onChange?: () => void;
-    onError?: (error: unknown, url: string) => void;
+  group?: Group;
+  /** Initial Splat budget; update scheduler.splatBudget to change it at runtime. */
+  splatBudget?: number;
+  /** Milliseconds to retain unused data after fade-out; defaults to 2000. */
+  cooldownMs?: number;
+  fadeDurationMs?: number;
+  /** Maximum simultaneous downloads/decodes; defaults to 4. */
+  maxConcurrentLoads?: number;
+  onChange?: () => void;
+  onError?: (error: unknown, url: string) => void;
 };
 export type StreamStats = {
-    visibleSplats: number;
-    visibleMeshes: number;
-    residentMeshes: number;
-    /** Decoded chunks, including cached chunks that are not currently drawn. */
-    residentChunks: number;
-    /** Retained CPU and estimated GPU bytes, excluding pending copies and WASM. */
-    residentBytes: number;
-    /** Reserved or ready copies awaiting publication into source storage. */
-    pendingBytes: number;
-    loadingChunks: number;
-    downloadedBytes: number;
-    peakWasmMemoryBytes: number;
+  visibleSplats: number;
+  visibleMeshes: number;
+  residentMeshes: number;
+  /** Decoded chunks, including cached chunks that are not currently drawn. */
+  residentChunks: number;
+  /** Retained CPU data, excluding pending copies and WASM memory. */
+  residentCpuBytes: number;
+  /** Estimated GPU storage for resident streaming data; excludes renderer buffers. */
+  residentGpuBytes: number;
+  /** Sum of residentCpuBytes and residentGpuBytes. */
+  residentBytes: number;
+  /** Estimated in-flight or ready copies awaiting publication into source storage. */
+  pendingBytes: number;
+  loadingChunks: number;
+  /** Ready share of the current view's requested detail, from 0 to 1. Changes with the view. */
+  loadProgress: number;
+  downloadedBytes: number;
+  peakWasmMemoryBytes: number;
 };
 export declare function positiveInteger(value: number, name: string): number;
 export declare function streamSettings(options: StreamSchedulerOptions): {
-    splatBudget: number;
-    cooldownMs: number;
-    fadeDurationMs: number;
-    maxConcurrentLoads: number;
+  splatBudget: number;
+  cooldownMs: number;
+  fadeDurationMs: number;
+  maxConcurrentLoads: number;
 };
-/** Bound queued decode/extraction copies independently of per-update publication. */
-export declare function streamPendingLimit(concurrency: number, unitBytes?: number): number;
 /** Format errors are permanent; transient failures retry with capped backoff. */
 export declare function streamRetryAt(error: unknown, failures: number): number;
-export declare function notifyStreamChange(options: StreamSchedulerOptions): void;
-export declare function notifyStreamError(options: StreamSchedulerOptions, error: unknown, url: string): void;
+export declare function notifyStreamChange(
+  options: StreamSchedulerOptions,
+): void;
+export declare function notifyStreamError(
+  options: StreamSchedulerOptions,
+  error: unknown,
+  url: string,
+): void;

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

@@ -1,44 +1,54 @@
-import { Group, LoadingManager } from 'three';
-import { SplatRequestOptions } from '../loadTypes';
+import type { Group, LoadingManager } from "three";
+import type { SplatRequestOptions } from "../loadTypes.js";
 export type StreamRequestOptions = SplatRequestOptions & {
-    manager?: LoadingManager;
+  manager?: LoadingManager;
 };
 export type StreamSchedulerOptions = {
-    group?: Group;
-    /** Initial Splat budget; update scheduler.splatBudget to change it at runtime. */
-    splatBudget?: number;
-    /** Milliseconds to retain unused data after fade-out; defaults to 2000. */
-    cooldownMs?: number;
-    fadeDurationMs?: number;
-    /** Active downloads/decodes. Ready copies use a separate bounded byte queue. */
-    maxConcurrentLoads?: number;
-    onChange?: () => void;
-    onError?: (error: unknown, url: string) => void;
+  group?: Group;
+  /** Initial Splat budget; update scheduler.splatBudget to change it at runtime. */
+  splatBudget?: number;
+  /** Milliseconds to retain unused data after fade-out; defaults to 2000. */
+  cooldownMs?: number;
+  fadeDurationMs?: number;
+  /** Maximum simultaneous downloads/decodes; defaults to 4. */
+  maxConcurrentLoads?: number;
+  onChange?: () => void;
+  onError?: (error: unknown, url: string) => void;
 };
 export type StreamStats = {
-    visibleSplats: number;
-    visibleMeshes: number;
-    residentMeshes: number;
-    /** Decoded chunks, including cached chunks that are not currently drawn. */
-    residentChunks: number;
-    /** Retained CPU and estimated GPU bytes, excluding pending copies and WASM. */
-    residentBytes: number;
-    /** Reserved or ready copies awaiting publication into source storage. */
-    pendingBytes: number;
-    loadingChunks: number;
-    downloadedBytes: number;
-    peakWasmMemoryBytes: number;
+  visibleSplats: number;
+  visibleMeshes: number;
+  residentMeshes: number;
+  /** Decoded chunks, including cached chunks that are not currently drawn. */
+  residentChunks: number;
+  /** Retained CPU data, excluding pending copies and WASM memory. */
+  residentCpuBytes: number;
+  /** Estimated GPU storage for resident streaming data; excludes renderer buffers. */
+  residentGpuBytes: number;
+  /** Sum of residentCpuBytes and residentGpuBytes. */
+  residentBytes: number;
+  /** Estimated in-flight or ready copies awaiting publication into source storage. */
+  pendingBytes: number;
+  loadingChunks: number;
+  /** Ready share of the current view's requested detail, from 0 to 1. Changes with the view. */
+  loadProgress: number;
+  downloadedBytes: number;
+  peakWasmMemoryBytes: number;
 };
 export declare function positiveInteger(value: number, name: string): number;
 export declare function streamSettings(options: StreamSchedulerOptions): {
-    splatBudget: number;
-    cooldownMs: number;
-    fadeDurationMs: number;
-    maxConcurrentLoads: number;
+  splatBudget: number;
+  cooldownMs: number;
+  fadeDurationMs: number;
+  maxConcurrentLoads: number;
 };
-/** Bound queued decode/extraction copies independently of per-update publication. */
-export declare function streamPendingLimit(concurrency: number, unitBytes?: number): number;
 /** Format errors are permanent; transient failures retry with capped backoff. */
 export declare function streamRetryAt(error: unknown, failures: number): number;
-export declare function notifyStreamChange(options: StreamSchedulerOptions): void;
-export declare function notifyStreamError(options: StreamSchedulerOptions, error: unknown, url: string): void;
+export declare function notifyStreamChange(
+  options: StreamSchedulerOptions,
+): void;
+export declare function notifyStreamError(
+  options: StreamSchedulerOptions,
+  error: unknown,
+  url: string,
+): void;

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

@@ -1,17 +1,35 @@
-import { ReorderedSplatResult, SplatResult } from '../data/defines.cjs';
-import { SplatFileInput, SplatLoadArgs, SplatLoadStatus } from './loadTypes.cjs';
+import type { ReorderedSplatResult, SplatResult } from "../data/defines.cjs";
+import type {
+  SplatFileInput,
+  SplatLoadArgs,
+  SplatLoadStatus,
+} from "./loadTypes.cjs";
 /** Decode in source order so streamed SOG can extract file ranges first. */
-export declare function decodeSplats(args: SplatLoadArgs, { sendStatus }: {
+export declare function decodeSplats(
+  args: SplatLoadArgs,
+  {
+    sendStatus,
+  }: {
     sendStatus: (data: SplatLoadStatus) => void;
-}): Promise<SplatResult>;
-export declare function loadSplats(args: SplatLoadArgs, options: {
+  },
+): Promise<SplatResult>;
+export declare function loadSplats(
+  args: SplatLoadArgs,
+  options: {
     sendStatus: (data: SplatLoadStatus) => void;
-}): Promise<ReorderedSplatResult>;
-export declare function resolveFile({ requestId, input, }: {
-    requestId: number;
-    input: SplatFileInput;
+  },
+): Promise<ReorderedSplatResult>;
+export declare function resolveFile({
+  requestId,
+  input,
+}: {
+  requestId: number;
+  input: SplatFileInput;
 }): void;
-export declare function resolveAsset({ requestId, url, }: {
-    requestId: number;
-    url: string;
+export declare function resolveAsset({
+  requestId,
+  url,
+}: {
+  requestId: number;
+  url: string;
 }): void;

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

@@ -1,17 +1,35 @@
-import { ReorderedSplatResult, SplatResult } from '../data/defines';
-import { SplatFileInput, SplatLoadArgs, SplatLoadStatus } from './loadTypes';
+import type { ReorderedSplatResult, SplatResult } from "../data/defines.js";
+import type {
+  SplatFileInput,
+  SplatLoadArgs,
+  SplatLoadStatus,
+} from "./loadTypes.js";
 /** Decode in source order so streamed SOG can extract file ranges first. */
-export declare function decodeSplats(args: SplatLoadArgs, { sendStatus }: {
+export declare function decodeSplats(
+  args: SplatLoadArgs,
+  {
+    sendStatus,
+  }: {
     sendStatus: (data: SplatLoadStatus) => void;
-}): Promise<SplatResult>;
-export declare function loadSplats(args: SplatLoadArgs, options: {
+  },
+): Promise<SplatResult>;
+export declare function loadSplats(
+  args: SplatLoadArgs,
+  options: {
     sendStatus: (data: SplatLoadStatus) => void;
-}): Promise<ReorderedSplatResult>;
-export declare function resolveFile({ requestId, input, }: {
-    requestId: number;
-    input: SplatFileInput;
+  },
+): Promise<ReorderedSplatResult>;
+export declare function resolveFile({
+  requestId,
+  input,
+}: {
+  requestId: number;
+  input: SplatFileInput;
 }): void;
-export declare function resolveAsset({ requestId, url, }: {
-    requestId: number;
-    url: string;
+export declare function resolveAsset({
+  requestId,
+  url,
+}: {
+  requestId: number;
+  url: string;
 }): void;

package/dist/types/patches/threeR186.d.cts

@@ -0,0 +1,3 @@
+import type { WebGPURenderer } from "three/webgpu";
+/** Apply r186 compatibility fixes to an initialized renderer once. */
+export declare function applyThreeR186Patch(renderer: WebGPURenderer): void;

package/dist/types/patches/threeR186.d.ts

@@ -0,0 +1,3 @@
+import type { WebGPURenderer } from "three/webgpu";
+/** Apply r186 compatibility fixes to an initialized renderer once. */
+export declare function applyThreeR186Patch(renderer: WebGPURenderer): void;