raytracing

type Blas struct {
	// Label is the debug label from the creation descriptor.
	Label string

	// Raw is the underlying HAL acceleration structure handle.
	// Nil if the BLAS is in an invalid state (e.g., creation failed).
	Raw hal.AccelerationStructure

	// SizeInfo contains the build/update/structure sizes returned by
	// GetAccelerationStructureBuildSizes at creation time.
	SizeInfo hal.AccelerationStructureBuildSizes

	// Flags are the acceleration structure creation flags.
	Flags gputypes.AccelerationStructureFlags

	// UpdateMode determines whether this BLAS supports incremental updates.
	UpdateMode gputypes.AccelerationStructureUpdateMode

	// Compaction tracks the compaction lifecycle state.
	// Matches Rust wgpu-core Blas.compacted_state (Mutex<BlasCompactState>).
	Compaction CompactionState

	// CompactedSize holds the compacted size in bytes, valid only when
	// Compaction == CompactionReady.
	CompactedSize uint64

	// BuiltIndex is a monotonically increasing index assigned when this BLAS
	// is built. Used for dependency ordering: a TLAS can only reference BLASes
	// that were built before or in the same build command.
	// Zero means not yet built.
	// Matches Rust wgpu-core Blas.built_index (RwLock<Option<NonZeroU64>>).
	BuiltIndex uint64

	// GeometryCount is the number of geometries in this BLAS, stored at
	// creation time for validation during build commands.
	GeometryCount uint32

	// Handle is the device address of this BLAS, used by TLAS instances
	// to reference this structure. Set after the first successful build.
	// Matches Rust wgpu-core Blas.handle (u64).
	Handle uint64
}

type BlasAction uint8

type BlasBuildEntry struct {
	// Blas is the acceleration structure to build or update.
	Blas *Blas

	// Geometries provides the geometry input for the build.
	// Must match the geometry type (triangles or AABBs) used at creation.
	Geometries *hal.AccelerationStructureEntries
}

type BuildContext struct {
	// contains filtered or unexported fields
}

type CompactionState uint8

type DeviceContext interface {
	// CreateBuffer creates a GPU buffer for scratch or instance data.
	CreateBuffer(desc *hal.BufferDescriptor) (hal.Buffer, error)

	// DestroyBuffer releases a GPU buffer.
	DestroyBuffer(buffer hal.Buffer)

	// HALDevice returns the underlying HAL device for acceleration
	// structure operations (create, destroy, build size queries).
	HALDevice() hal.Device

	// DeviceFeatures returns the features enabled on this device.
	// Used to validate that RT features are present before operations.
	DeviceFeatures() gputypes.Features

	// DeviceLimits returns the resource limits of this device.
	// Used to validate geometry counts, instance counts, etc.
	DeviceLimits() gputypes.Limits

	// DeviceAlignments returns the alignment requirements of this device.
	// Used for scratch buffer alignment during AS builds.
	DeviceAlignments() hal.Alignments
}

type Tlas struct {
	// Label is the debug label from the creation descriptor.
	Label string

	// Raw is the underlying HAL acceleration structure handle.
	// Nil if the TLAS is in an invalid state.
	Raw hal.AccelerationStructure

	// SizeInfo contains the build/update/structure sizes returned by
	// GetAccelerationStructureBuildSizes at creation time.
	SizeInfo hal.AccelerationStructureBuildSizes

	// Flags are the acceleration structure creation flags.
	Flags gputypes.AccelerationStructureFlags

	// UpdateMode determines whether this TLAS supports incremental updates.
	UpdateMode gputypes.AccelerationStructureUpdateMode

	// MaxInstances is the maximum number of BLAS instances this TLAS can
	// hold, specified at creation time. Determines the instance buffer size.
	// Matches Rust wgpu-core Tlas.max_instance_count.
	MaxInstances uint32

	// BuiltIndex is a monotonically increasing index assigned when this TLAS
	// is built. Used for ordering builds within a single command.
	// Zero means not yet built.
	// Matches Rust wgpu-core Tlas.built_index (RwLock<Option<NonZeroU64>>).
	BuiltIndex uint64

	// InstanceBuffer is the persistent GPU buffer holding packed TlasInstance
	// data (64 bytes per instance). Allocated at creation time and reused
	// across rebuilds.
	// Matches Rust wgpu-core TlasState.instance_buffer.
	InstanceBuffer hal.Buffer

	// Dependencies tracks the BLAS device addresses that this TLAS currently
	// references. Updated on each build to reflect the active instance set.
	// Used for validation: all referenced BLASes must be built before or in
	// the same build command as this TLAS.
	// Matches Rust wgpu-core Tlas.dependencies (RwLock<Vec<Arc<Blas>>>).
	Dependencies []uint64
}

type TlasBuildEntry struct {
	// Tlas is the acceleration structure to build or update.
	Tlas *Tlas

	// InstanceBuffer is the GPU buffer containing packed instance data.
	InstanceBuffer hal.Buffer

	// InstanceCount is the number of active instances in the buffer.
	InstanceCount uint32
}

type ValidationError struct {
	Op      string
	Message string
}