🎉 Initial Release #

This is the first release of zeba_academy_measure.

✨ Added #

• 📏 Measure widget size using GlobalKey
• 📍 Get widget global position on screen
• 🔑 GlobalKey extension helpers:
  • key.size → returns widget size
  • key.position → returns global offset position
  • key.metrics → returns combined WidgetMetrics
• 🧩 MeasureController for manual measurement trigger with callback support
• 📦 MeasureWidget for automatic size and position tracking
• 🔄 SizeChangeListener for detecting layout size changes in real time
• ⚡ Post-frame safe measurement using WidgetsBinding.instance.addPostFrameCallback

---

🧠 Technical Details #

• Uses RenderBox for accurate layout measurement
• Uses LayoutBuilder for constraint-based size detection
• Uses GlobalKey extensions for simplified API
• Safe post-frame execution to avoid build-time errors

---

⚠️ Notes #

• Measurements are only available after the first frame is rendered
• Best used with constrained widgets (e.g., SizedBox, Container with fixed size)
• Avoid using inside unbounded layouts for accurate results

---

🧪 Testing #

• Added widget test support for WidgetMetrics
• Added basic integration test for GlobalKey measurement accuracy

---

[Unreleased] #

🚧 Planned #

• 🔥 Stream-based live measurement updates
• 🔥 Visibility detection (in-view tracking)
• 🔥 Scroll-aware measurement system
• 🔥 Riverpod integration support
• 🔥 Animation triggers on size change
• 🔥 Performance optimizations for frequent layout changes

---

📌 Versioning Strategy #

• Patch versions (0.0.x): Bug fixes and minor improvements
• Minor versions (0.x.0): New features, backward compatible
• Major versions (x.0.0): Breaking changes

---

👨‍💻 Maintainer #

Sufyan bin Uzayr
Open-source developer building developer tools and learning platforms.

🌐 https://zeba.academy
📚 https://code.zeba.academy
💼 https://www.linkedin.com/in/sufyanism
📺 https://www.youtube.com/@zeba.academy

---

📄 License #

Licensed under GNU General Public License v3.0 (GPL-3.0)