#ifndef _LIVOX_GEN1_PCLOUD_AMBIENCE_STIMULUS_BUFFER_H
#define _LIVOX_GEN1_PCLOUD_AMBIENCE_STIMULUS_BUFFER_H

#include <memory>
#include <cstdint>
#include <list>
#include <cstddef>
#include <vector>
#include <string>
#include <user/stimulusBuffer.h>
#include <user/stagingBuffer.h>
#include <user/deviceAttachmentSpec.h>
#include <user/intrinThresholdParams.h>
#include "lg1PcloudAmbienceStencil.h"

namespace smo {
namespace stim_buff {

inline intrin::ParsedThresholdParam parsePostrinInterestParam(
	const std::shared_ptr<device::DeviceAttachmentSpec>& deviceAttachmentSpec)
{
	return intrin::parseOptionalThresholdParam(
		deviceAttachmentSpec->qualeIfaceApiParams,
		intrin::kPosIntPcParamNames,
		intrin::kPosIntThrParamNames,
		90,
		intrin::ThresholdUnit::Percentage);
}

// Forward declaration
class StimulusProducer;

/**
 * PcloudAmbienceStimulusBuffer is a specialized StimulusBuffer for ambience point cloud data.
 */
class PcloudAmbienceStimulusBuffer
:	public StimulusBuffer
{
public:
	explicit PcloudAmbienceStimulusBuffer(
		StimulusProducer& parent,
		const std::shared_ptr<device::DeviceAttachmentSpec>& deviceAttachmentSpec,
		int histbuffMs,
		const StagingBuffer::IOEngineConstraints& inputEngineConstraints,
		const StagingBuffer::IOEngineConstraints& outputEngineConstraints,
		const SmoCallbacks& callbacks,
		cl_mem_flags flags,
		size_t nStencils_, size_t nDgramsPerFrame_)
	:	StimulusBuffer(
			parent, deviceAttachmentSpec, histbuffMs,
			inputEngineConstraints, outputEngineConstraints,
			callbacks, flags),
	nStencils(nStencils_)
	{
		intrin::validateNoForbiddenUnitlessIntrinParams(
			deviceAttachmentSpec->qualeIfaceApiParams);

		const auto postrinInterestParam =
			parsePostrinInterestParam(deviceAttachmentSpec);
		postrinInterestPercentage =
			postrinInterestParam.unit == intrin::ThresholdUnit::Percentage
				? static_cast<uint32_t>(postrinInterestParam.value)
				: 0U;
		postrinInterestThreshold = intrin::resolveThresholdValue(
			postrinInterestParam, nDgramsPerFrame_);

		// Parse ambienceIntensityLowVal from qualeIfaceApiParams
		const std::vector<std::string> ambienceIntensityLowValParamNames = {
			"ambience-intensity-low-val"
		};
		ambienceIntensityLowVal = static_cast<uint32_t>(
			device::DeviceAttachmentSpec::parseOptionalParamAsIntWithSynonyms(
				deviceAttachmentSpec->qualeIfaceApiParams,
				ambienceIntensityLowValParamNames, 8));

		// Construct stencils and add to list (FIFO behavior)
		for (size_t i = 0; i < nStencils; ++i) {
			stencils.emplace_back();
		}
	}

	~PcloudAmbienceStimulusBuffer() = default;

	// Non-copyable, non-movable: inherited pinner lifetime is instance-bound
	PcloudAmbienceStimulusBuffer(const PcloudAmbienceStimulusBuffer&) = delete;
	PcloudAmbienceStimulusBuffer& operator=(const PcloudAmbienceStimulusBuffer&) = delete;
	PcloudAmbienceStimulusBuffer(PcloudAmbienceStimulusBuffer&&) = delete;
	PcloudAmbienceStimulusBuffer& operator=(PcloudAmbienceStimulusBuffer&&) = delete;

public:
	uint32_t postrinInterestPercentage;
	uint32_t postrinInterestThreshold;
	uint32_t ambienceIntensityLowVal;
	size_t nStencils;
	std::list<LG1PcloudAmbienceStencil> stencils;
};

} // namespace stim_buff
} // namespace smo

#endif // _LIVOX_GEN1_PCLOUD_AMBIENCE_STIMULUS_BUFFER_H