// Tiny driver for a 16x2 LCD with a PCF8574 I2C backpack (no library needed).
#pragma once
#include <Wire.h>

class LcdI2C {
 public:
  bool begin() {
    for (uint8_t a : {0x27, 0x3F}) {           // the two usual backpack addresses
      Wire.beginTransmission(a);
      if (Wire.endTransmission() == 0) { addr_ = a; break; }
    }
    if (!addr_) return false;
    delay(50);
    write4(0x30); delay(5); write4(0x30); delay(1); write4(0x30); write4(0x20);  // 4-bit mode
    command(0x28);  // 2 lines, 5x8 font
    command(0x0C);  // display on, no cursor
    command(0x06);  // move right after each character
    clear();
    return true;
  }
  void clear() { command(0x01); delay(2); }
  // Prints exactly 16 characters on a line (pads with spaces, so old text disappears).
  void line(uint8_t row, const String &text) {
    if (!addr_) return;
    command(0x80 | (row ? 0x40 : 0x00));
    for (int i = 0; i < 16; i++) send(i < (int)text.length() ? text[i] : ' ', 0x01);
  }

 private:
  uint8_t addr_ = 0;
  static const uint8_t BACKLIGHT = 0x08, ENABLE = 0x04;
  void expander(uint8_t v) { Wire.beginTransmission(addr_); Wire.write(v | BACKLIGHT); Wire.endTransmission(); }
  void write4(uint8_t v) { expander(v); expander(v | ENABLE); delayMicroseconds(1); expander(v); delayMicroseconds(50); }
  void send(uint8_t v, uint8_t mode) { write4((v & 0xF0) | mode); write4(((v << 4) & 0xF0) | mode); }
  void command(uint8_t v) { if (addr_) send(v, 0); }
};
