optitest 1.0.2

OptiTest — stable automation keys and testable widget wrappers for Flutter apps driven by Appium, Flutter Driver, or integration tests.

📌 Changelog

All notable changes to OptiTest are documented here. Most recent release at the top.

🔄 Versioning Strategy

Follows Semantic Versioning:

• 🚀 MAJOR — breaking API changes
• 🌟 MINOR — backward-compatible features
• 🛠 PATCH — backward-compatible fixes

---

🛠 [1.0.2] — Layout Safety Guardrail

• 🛡 Safety: Testable asserts in debug that child is not a ParentDataWidget (Expanded, Flexible, Positioned, …), which would otherwise break Flex/Stack layout silently
• ⚙️ Debug-only: zero cost in release builds

---

🛠 [1.0.1] — Documentation Polish

• 📚 Documentation: minor README improvements for better pub.dev rendering

---

🎯 [1.0.0] — Initial Release

• 🆕 New Features:

  • Testable widget — applies a stable ValueKey + Semantics.identifier for Appium, Flutter Driver, and integration tests
  • TestKey — 30 element factories (button, input, radio, listItem, bottomSheet, …) producing deterministic keys
  • ElementType enum — 3-char prefix per element kind, collision-free
  • ElementState enum — optional state suffix (disabled, error, loading, selected, …)
  • 40-character auto-truncation to stay within Appium / Semantics driver limits

• 📚 Documentation:

  • Usage guide, key reference, Appium integration, and testing best practices under doc/
  • Working example/ demonstrating login-style flow with Testable

• ⚙️ Infrastructure:

  • Zero runtime dependencies outside the Flutter SDK
  • MIT licensed, pub.dev ready