@myned-ai/gsplat-flame-avatar-renderer 1.0.6 → 1.0.7

package/src/core/index.js

@@ -1,13 +0,0 @@
-/**
- * gsplat-flame-avatar - Core Module
- * Core rendering engine components.
- * 
- * Based on @mkkellogg/gaussian-splats-3d (MIT License)
- * Extended with FLAME avatar support.
- */
-
-export { SplatGeometry } from './SplatGeometry.js';
-export { SplatMesh } from './SplatMesh.js';
-export { SplatScene } from './SplatScene.js';
-export { SplatTree } from './SplatTree.js';
-export { Viewer } from './Viewer.js';

package/src/enums/EngineConstants.js

@@ -1,58 +0,0 @@
-/**
- * EngineConstants
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- * 
- * Core constants for Gaussian Splat rendering.
- */
-
-export class Constants {
-    static DefaultSplatSortDistanceMapPrecision = 16;
-    static MemoryPageSize = 65536;
-    static BytesPerFloat = 4;
-    static BytesPerInt = 4;
-    static MaxScenes = 32;
-    static ProgressiveLoadSectionSize = 262144;
-    static ProgressiveLoadSectionDelayDuration = 15;
-    static SphericalHarmonics8BitCompressionRange = 3;
-}
-
-export const DefaultSphericalHarmonics8BitCompressionRange = Constants.SphericalHarmonics8BitCompressionRange;
-
-// SplatMesh constants
-export const COVARIANCES_ELEMENTS_PER_SPLAT = 6;
-export const CENTER_COLORS_ELEMENTS_PER_SPLAT = 4;
-
-export const COVARIANCES_ELEMENTS_PER_TEXEL_STORED = 4;
-export const COVARIANCES_ELEMENTS_PER_TEXEL_ALLOCATED = 4;
-export const COVARIANCES_ELEMENTS_PER_TEXEL_COMPRESSED_STORED = 6;
-export const COVARIANCES_ELEMENTS_PER_TEXEL_COMPRESSED_ALLOCATED = 8;
-export const SCALES_ROTATIONS_ELEMENTS_PER_TEXEL = 4;
-export const CENTER_COLORS_ELEMENTS_PER_TEXEL = 4;
-export const SCENE_INDEXES_ELEMENTS_PER_TEXEL = 1;
-
-export const SCENE_FADEIN_RATE_FAST = 0.012;
-export const SCENE_FADEIN_RATE_GRADUAL = 0.003;
-
-// Viewer constants
-export const THREE_CAMERA_FOV = 50;
-export const MINIMUM_DISTANCE_TO_NEW_FOCAL_POINT = 0.5;
-export const CONSECUTIVE_RENDERED_FRAMES_FOR_FPS_CALCULATION = 60;
-export const MIN_SPLAT_COUNT_TO_SHOW_SPLAT_TREE_LOADING_SPINNER = 1500000;
-export const FOCUS_MARKER_FADE_IN_SPEED = 0.4;
-export const FOCUS_MARKER_FADE_OUT_SPEED = 0.12;
-
-// Internal load types for loaders
-export const InternalLoadType = {
-    DirectToSplatBuffer: 0,
-    DirectToSplatArray: 1,
-    DownloadBeforeProcessing: 2
-};
-
-// Loader status
-export const LoaderStatus = {
-    'Downloading': 0,
-    'Processing': 1,
-    'Done': 2
-};

package/src/enums/LogLevel.js

@@ -1,13 +0,0 @@
-/**
- * Log level enumeration for controlling verbosity
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- */
-export const LogLevel = {
-    None: 0,
-    Error: 1,
-    Warning: 2,
-    Info: 3,
-    Debug: 4
-};

package/src/enums/RenderMode.js

@@ -1,11 +0,0 @@
-/**
- * Render mode enumeration
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- */
-export const RenderMode = {
-    Always: 0,
-    OnChange: 1,
-    Never: 2
-};

package/src/enums/SceneFormat.js

@@ -1,21 +0,0 @@
-/**
- * Scene format enumeration for supported file types
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- * 
- * Simplified for FLAME avatar usage - only PLY format is supported.
- */
-export const SceneFormat = {
-    'Ply': 0
-};
-
-/**
- * Determine scene format from file path
- * @param {string} path - File path
- * @returns {number|null} Scene format or null if unknown
- */
-export const sceneFormatFromPath = (path) => {
-    if (path.endsWith('.ply')) return SceneFormat.Ply;
-    return null;
-};

package/src/enums/SceneRevealMode.js

@@ -1,11 +0,0 @@
-/**
- * Scene reveal mode enumeration
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- */
-export const SceneRevealMode = {
-    Default: 0,
-    Gradual: 1,
-    Instant: 2
-};

package/src/enums/SplatRenderMode.js

@@ -1,10 +0,0 @@
-/**
- * Splat render mode enumeration
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- * https://github.com/mkkellogg/GaussianSplats3D
- */
-export const SplatRenderMode = {
-    ThreeD: 0,
-    TwoD: 1
-};

package/src/enums/index.js

@@ -1,13 +0,0 @@
-/**
- * gsplat-flame-avatar - Enums Module
- * Constants and enumerations for rendering configuration.
- * 
- * Derived from @mkkellogg/gaussian-splats-3d (MIT License)
- */
-
-export * from './LogLevel.js';
-export * from './RenderMode.js';
-export * from './SceneFormat.js';
-export * from './SceneRevealMode.js';
-export * from './SplatRenderMode.js';
-export * from './EngineConstants.js';

package/src/errors/ApplicationError.js

@@ -1,185 +0,0 @@
-/**
- * ApplicationError - Base error class for all application errors
- *
- * Provides structured error handling with error codes and cause tracking.
- * All domain-specific errors should extend this class.
- *
- * @extends Error
- */
-export class ApplicationError extends Error {
-    /**
-     * Create an ApplicationError
-     * @param {string} message - Human-readable error message
-     * @param {string} code - Machine-readable error code for programmatic handling
-     * @param {Error} [cause=null] - Original error that caused this error (for error chaining)
-     */
-    constructor(message, code, cause = null) {
-        super(message);
-        this.name = this.constructor.name;
-        this.code = code;
-        this.cause = cause;
-
-        // Capture stack trace, excluding constructor call from it
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-    }
-
-    /**
-     * Convert error to JSON for logging/transmission
-     * @returns {object} JSON representation of error
-     */
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            stack: this.stack,
-            cause: this.cause ? {
-                name: this.cause.name,
-                message: this.cause.message
-            } : null
-        };
-    }
-}
-
-/**
- * ValidationError - Thrown when input validation fails
- *
- * Used for invalid parameters, out-of-range values, or malformed data.
- *
- * @extends ApplicationError
- */
-export class ValidationError extends ApplicationError {
-    /**
-     * Create a ValidationError
-     * @param {string} message - Validation failure description
-     * @param {string} field - Name of the field that failed validation
-     * @param {Error} [cause=null] - Original error that caused this validation failure
-     */
-    constructor(message, field, cause = null) {
-        super(message, 'VALIDATION_ERROR', cause);
-        this.field = field;
-    }
-}
-
-/**
- * NetworkError - Thrown when network operations fail
- *
- * Used for fetch failures, timeouts, or HTTP error responses.
- *
- * @extends ApplicationError
- */
-export class NetworkError extends ApplicationError {
-    /**
-     * Create a NetworkError
-     * @param {string} message - Network error description
-     * @param {number} [statusCode=0] - HTTP status code (if applicable)
-     * @param {Error} [cause=null] - Original error that caused this network failure
-     */
-    constructor(message, statusCode = 0, cause = null) {
-        super(message, 'NETWORK_ERROR', cause);
-        this.statusCode = statusCode;
-    }
-}
-
-/**
- * AssetLoadError - Thrown when asset loading fails
- *
- * Used for failures loading models, textures, or other asset files.
- *
- * @extends ApplicationError
- */
-export class AssetLoadError extends ApplicationError {
-    /**
-     * Create an AssetLoadError
-     * @param {string} message - Asset load failure description
-     * @param {string} assetPath - Path to the asset that failed to load
-     * @param {Error} [cause=null] - Original error that caused this load failure
-     */
-    constructor(message, assetPath, cause = null) {
-        super(message, 'ASSET_LOAD_ERROR', cause);
-        this.assetPath = assetPath;
-    }
-}
-
-/**
- * ResourceDisposedError - Thrown when attempting to use a disposed resource
- *
- * Used to prevent use-after-dispose bugs.
- *
- * @extends ApplicationError
- */
-export class ResourceDisposedError extends ApplicationError {
-    /**
-     * Create a ResourceDisposedError
-     * @param {string} resourceName - Name of the disposed resource
-     */
-    constructor(resourceName) {
-        super(
-            `Cannot use ${resourceName}: resource has been disposed`,
-            'RESOURCE_DISPOSED_ERROR'
-        );
-        this.resourceName = resourceName;
-    }
-}
-
-/**
- * InitializationError - Thrown when initialization fails
- *
- * Used when required setup steps fail or prerequisites are not met.
- *
- * @extends ApplicationError
- */
-export class InitializationError extends ApplicationError {
-    /**
-     * Create an InitializationError
-     * @param {string} message - Initialization failure description
-     * @param {string} component - Name of component that failed to initialize
-     * @param {Error} [cause=null] - Original error that caused this initialization failure
-     */
-    constructor(message, component, cause = null) {
-        super(message, 'INITIALIZATION_ERROR', cause);
-        this.component = component;
-    }
-}
-
-/**
- * ParseError - Thrown when parsing data fails
- *
- * Used for malformed file formats, invalid JSON, or corrupt data.
- *
- * @extends ApplicationError
- */
-export class ParseError extends ApplicationError {
-    /**
-     * Create a ParseError
-     * @param {string} message - Parse failure description
-     * @param {string} dataType - Type of data being parsed (e.g., 'JSON', 'PLY', 'GLB')
-     * @param {Error} [cause=null] - Original error that caused this parse failure
-     */
-    constructor(message, dataType, cause = null) {
-        super(message, 'PARSE_ERROR', cause);
-        this.dataType = dataType;
-    }
-}
-
-/**
- * ConfigurationError - Thrown when configuration is invalid
- *
- * Used for invalid settings, missing required configuration, or conflicting options.
- *
- * @extends ApplicationError
- */
-export class ConfigurationError extends ApplicationError {
-    /**
-     * Create a ConfigurationError
-     * @param {string} message - Configuration error description
-     * @param {string} configKey - Configuration key that is invalid
-     * @param {Error} [cause=null] - Original error
-     */
-    constructor(message, configKey, cause = null) {
-        super(message, 'CONFIGURATION_ERROR', cause);
-        this.configKey = configKey;
-    }
-}

package/src/errors/index.js

@@ -1,17 +0,0 @@
-/**
- * Error classes for structured error handling
- *
- * This module exports all custom error classes used throughout the application.
- * All errors extend ApplicationError for consistent error handling.
- */
-
-export {
-    ApplicationError,
-    ValidationError,
-    NetworkError,
-    AssetLoadError,
-    ResourceDisposedError,
-    InitializationError,
-    ParseError,
-    ConfigurationError
-} from './ApplicationError.js';