@voluma/vlam 0.3.0 → 0.3.2

package/dist/{unified-splat-mesh.d.ts → unified/unified-splat-mesh.d.ts}

@@ -1,11 +1,12 @@
 import * as THREE from 'three/webgpu';
-import { type DepthOfFieldSettings } from './depth-of-field';
-import { type RelightingSettings, type RelightingUniforms } from './relighting';
-import { SplatMesh } from './splat-mesh';
-import type { SplatPickOptions, SplatPickResult } from './splat-mesh';
+import { type DepthOfFieldSettings } from '../core/depth-of-field';
+import { type RelightingSettings, type RelightingUniforms } from '../core/relighting';
+import { SplatMesh } from '../core/splat-mesh';
+import type { SplatPickOptions, SplatPickResult } from '../core/splat-mesh';
 /** Registration settings for one source in a {@link UnifiedSplatMesh}. */
 export interface UnifiedSplatSourceOptions {
-    /** Whole-source opacity applied after its modifier stack. Defaults to `1`. */
+    /** Whole-source display opacity applied after gather falloff. Defaults to `1`.
+     * Does not change RAD LOD classification or splat shape. */
     opacity?: number;
     /** Whether this source contributes to the unified draw. Defaults to `true`. */
     visible?: boolean;
@@ -149,7 +150,13 @@ export declare class UnifiedSplatMesh extends THREE.Mesh {
     get droppedSourceCount(): number;
     /** Number of active splats omitted in the most recent update due to capacity. */
     get droppedSplatCount(): number;
-    /** Updates a source's resolved opacity without rebuilding its gather pipeline. */
+    /**
+     * Sets whole-source display opacity without rebuilding the gather pipeline.
+     *
+     * This scales the completed fragment after RAD merged-vs-leaf classification
+     * and falloff. It must never alter LOD selection or splat shape; hosts such as
+     * marker crossfades rely on that. Values `<= 0` skip drawing the source.
+     */
     setSourceOpacity(source: SplatMesh, opacity: number): void;
     /** Shows or hides a source without changing its residency. */
     setSourceVisible(source: SplatMesh, visible: boolean): void;

package/dist/{work-buffer-gather.d.ts → unified/work-buffer-gather.d.ts}

@@ -1,6 +1,6 @@
 import * as THREE from 'three/webgpu';
-import { type SplatShInputs, type Vec3Uniform } from './splat-mesh-material';
-import type { SplatModifier } from './splat-modifier';
+import { type SplatShInputs, type Vec3Uniform } from '../core/splat-mesh-material';
+import type { SplatModifier } from '../core/splat-modifier';
 /**
  * GPU gather pass for Phase 0 of the unified renderer. It resolves a source
  * pool's active local centers into a shared world-space storage buffer. The
@@ -12,7 +12,7 @@ import type { SplatModifier } from './splat-modifier';
 /** Shared GPU storage for every gathered source in one unified frame. */
 export declare class WorkBuffer {
     readonly capacity: number;
-    /** World-space center xyz; w is the drawable flag (1 draw, 0 modifier-hidden). */
+    /** World-space center xyz; w is display opacity (`visibility × source opacity ×` RAD modifier ratio). */
     readonly centers: THREE.StorageBufferAttribute;
     /** Resolved color and opacity per work slot. */
     readonly colors: THREE.StorageBufferAttribute;
@@ -86,8 +86,8 @@ export declare class WorkBufferGather {
         srgbOutput?: boolean;
         /**
          * Source stores Spark LOD alpha (`alpha ÷ 2`, `.rad`). Recover the full
-         * `alpha ∈ [0,2]` here so the shared draw material sees one convention;
-         * `alpha > 1` then marks a merged node (see `createWorkBufferMaterial`).
+         * `alpha ∈ [0,2]` into `colors.a` from the *original* texture channel so the
+         * shared draw material can classify merged vs leaf without seeing fades.
          */
         lodAlpha?: boolean;
         /** Reuse one target across all source gather passes. */

package/dist/{work-buffer-material.d.ts → unified/work-buffer-material.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three/webgpu';
-import type { FloatUniform, Vec2Uniform } from './splat-mesh-material';
+import type { FloatUniform, Vec2Uniform } from '../core/splat-mesh-material';
 /**
  * Creates the unified EWA draw material for gathered world-space splats.
  *