Merge pull request #2 from noties/v3

V3

CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## 2.2.0
+# 2.3.0-SNAPSHOT
+* Add `ItemViewGroup` for a group of items with the usage of `AdaptViewGroup`
+* Add `ViewState` utility to save/restore view state (deprecated `NestedRecyclerState`)
+* Add `@CheckResult` for `Holder.requireView` methods
+* Add `HasChildrenItems` common interface for a group item (`ItemGroup` and `ItemViewGroup`)
+* Add `Adapt#onSaveInstanceState` and `Adapt#onRestoreInstanceState` for easier state saving/restoration
+* Add `AdaptViewGroup.ChangeHandler` with `ChangeHandlerDef` and `TransitionChangeHandler` implementations
+* Add `AdaptViewGroup#findItemForView` method
+* `AdaptViewGroup` checks if Item returns a View already attached to a parent
+* `StickyItemDecoration`: use view-type from supplied item (for wrapped items), allow exact size of 
+header (instead of assuming that height is `wrap_content`)
+
+# 2.2.0
 * create `ItemGroup` for easier nested RecyclerView support
 * create `ItemLayoutWrapper` for easier wrapping of an `Item` inside a different layout
 * add `HasWrappedItem` interface (2 implementations - `ItemWrapper` and `ItemLayoutWrapper`)

DOC.md

@@ -0,0 +1,16 @@
+attempt at creating proper abstraction for re-usable view components across different contexts
+
+# Item
+* ~~Override `equals` when in RecyclerView and diff is used to detect if contents are the same~~
+
+## ViewGroup
+* _if wrapping happens_, then diff must use a different logic, to check viewType properly and then id,
+  currently class is compared directly
+
+## Wrapping
+* distinct viewType for a wrapping chain
+  `Padding Margin Item` and `Margin Padding Item` are not the same 
+  `Padding Margin Item` and `Padding Item` are not the same
+* uniqueness of generated viewType combined with reliable generator that can 
+  be proven and does not rely on some randomness of hashcode
+