#pragma once

#include "esphome/core/component.h"
#include "esphome/core/entity_base.h"
#include "esphome/core/helpers.h"
#ifdef USE_TEXT_SENSOR_FILTER
#include "esphome/components/text_sensor/filter.h"
#endif

#include <initializer_list>
#include <memory>

namespace esphome::text_sensor {

class TextSensor;

void log_text_sensor(const char *tag, const char *prefix, const char *type, TextSensor *obj);

#define LOG_TEXT_SENSOR(prefix, type, obj) log_text_sensor(TAG, prefix, LOG_STR_LITERAL(type), obj)

#define SUB_TEXT_SENSOR(name) \
 protected: \
  text_sensor::TextSensor *name##_text_sensor_{nullptr}; \
\
 public: \
  void set_##name##_text_sensor(text_sensor::TextSensor *text_sensor) { this->name##_text_sensor_ = text_sensor; }

class TextSensor : public EntityBase {
 public:
  std::string state;

#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
  /// @deprecated Use get_raw_state() instead. This member will be removed in ESPHome 2026.6.0.
  ESPDEPRECATED("Use get_raw_state() instead of .raw_state. Will be removed in 2026.6.0", "2025.12.0")
  std::string raw_state;

  TextSensor() = default;
  ~TextSensor() = default;
#pragma GCC diagnostic pop

  /// Getter-syntax for .state.
  const std::string &get_state() const;
  /// Getter-syntax for .raw_state
  const std::string &get_raw_state() const;

  void publish_state(const std::string &state);
  void publish_state(const char *state);
  void publish_state(const char *state, size_t len);

#ifdef USE_TEXT_SENSOR_FILTER
  /// Add a filter to the filter chain. Will be appended to the back.
  void add_filter(Filter *filter);

  /// Add a list of vectors to the back of the filter chain.
  void add_filters(std::initializer_list<Filter *> filters);

  /// Clear the filters and replace them by filters.
  void set_filters(std::initializer_list<Filter *> filters);

  /// Clear the entire filter chain.
  void clear_filters();
#endif

  template<typename F> void add_on_state_callback(F &&callback) { this->callback_.add(std::forward<F>(callback)); }
  /// Add a callback that will be called every time the sensor sends a raw value.
  /// When USE_TEXT_SENSOR_FILTER is not enabled, delegates to the regular callback
  /// since raw state equals filtered state without filter support compiled in.
  template<typename F> void add_on_raw_state_callback(F &&callback) {
#ifdef USE_TEXT_SENSOR_FILTER
    this->raw_callback_.add(std::forward<F>(callback));
#else
    this->callback_.add(std::forward<F>(callback));
#endif
  }

  // ========== INTERNAL METHODS ==========
  // (In most use cases you won't need these)

  void internal_send_state_to_frontend(const std::string &state);
  void internal_send_state_to_frontend(const char *state, size_t len);

 protected:
  /// Notify frontend that state has changed (assumes this->state is already set)
  void notify_frontend_();
#ifdef USE_TEXT_SENSOR_FILTER
  LazyCallbackManager<void(const std::string &)> raw_callback_;  ///< Storage for raw state callbacks.
#endif
  LazyCallbackManager<void(const std::string &)> callback_;  ///< Storage for filtered state callbacks.

#ifdef USE_TEXT_SENSOR_FILTER
  Filter *filter_list_{nullptr};  ///< Store all active filters.
#endif
};

}  // namespace esphome::text_sensor
