docs: finalize LibForm 2.0.0 changelog

Author: ImperaZim

CHANGELOG.md

@@ -1,31 +1,85 @@
-
-# Changelog
+# LibForm Changelog
 
 All notable changes to `LibForm` should be documented in this file.
 
-The format is inspired by Keep a Changelog and uses semantic versioning where possible.
+The format is inspired by Keep a Changelog and uses semantic versioning where
+possible.
+
+## [2.0.0] - 2026-06-16
+
+### Release Focus
+
+LibForm 2.0.0 is the form authoring release for the 2.0 core library line. It
+standardizes PocketMine Bedrock forms around reusable classes, fluent builders,
+typed form data, pagination, conditional elements, async loading, history and
+presets.
 
-## [Unreleased]
+The release is meant to remove the common "array of JSON by hand" pattern from
+plugins. Developers can build simple one-off forms quickly, but still have a
+class-based structure for large menus and multi-step flows.
 
 ### Added
 
-- Community health files and GitHub templates.
-- Quality workflow scaffolding.
-- Compatibility and standalone/embedded documentation.
+- Added long, modal and custom form foundations with class-based definitions.
+- Added `FormBuilder::long()`, `FormBuilder::modal()` and
+  `FormBuilder::custom()` for concise fluent form creation.
+- Added `FormData` as an array-accessible state container shared between form
+  steps.
+- Added `FormResult` to control close, keep-open and flow behavior.
+- Added paginated long forms for large button lists.
+- Added dynamic button generation from runtime data sources.
+- Added `FormChain` for multi-step menus and wizard-like flows.
+- Added conditional custom form elements that can show or hide based on previous
+  values.
+- Added async form data loading with a loading form while work is prepared.
+- Added form history so menus can implement back navigation.
+- Added form timeouts for interactions that should expire automatically.
+- Added presets for common dialogs such as confirm, player select, color pick,
+  text input and number input.
+- Added validated inputs and searchable dropdown helpers.
 
 ### Changed
 
-- Quality analysis now uses the real PocketMine-MP 5 API instead of unresolved framework types.
-- Form collections now declare their key and value types for static analysis.
+- Changed form collections to declare key and value types for static analysis.
+- Changed the documentation toward component-based usage with examples for each
+  major form family.
+- Changed quality analysis to validate against the real PocketMine-MP 5 API
+  instead of unresolved framework placeholders.
+- Changed sync workflows to stage files before checking diffs and to retry
+  rebased pushes to EasyLibrary.
 
 ### Fixed
 
-- PHPStan now runs correctly through the Composer quality script on Windows.
-- Removed unused persisted constructor state while preserving the public form APIs.
-- Sync workflow now stages files before checking diffs and retries/rebases pushes to EasyLibrary.
+- Fixed PHPStan execution on Windows through the Composer quality script.
+- Fixed unused persisted constructor state while preserving public form APIs.
+- Fixed quality coverage around form collection generics and JSON structures.
+- Removed an unused icon resource from the release tree.
+
+### Compatibility Notes
+
+- Requires PocketMine-MP API `5.0.0+`.
+- Requires PHP `8.2+`.
+- The public namespace is `imperazim\form`.
+- Can be used as a standalone plugin or through EasyLibrary's embedded copy.
+
+### Migration Notes
+
+- Prefer builders for small menus and dedicated classes for reusable menus.
+- Use `FormData` instead of passing loose arrays between chained forms.
+- Use `FormResult::KEEP` only when the form should be resent after validation.
 
-## [2.0.0] - TBD
+### Example
 
-### Notes
+```php
+use imperazim\form\builder\FormBuilder;
+use imperazim\form\FormResult;
 
-- Current repository baseline.
+FormBuilder::custom('Profile')
+    ->input('nickname', 'Nickname')
+    ->toggle('public', 'Public profile', true)
+    ->onSubmit(function ($player, $data): FormResult {
+        $player->sendMessage('Saved as ' . $data->get('nickname'));
+        return FormResult::CLOSE;
+    })
+    ->send($player);
+```