1# Release Notes
2
3## 0.2.0
4
5### 0.2.0 Added
6
7- Added `taffy::error::InvalidChild` Error type
8- `taffy::node::Taffy.new_leaf()` which allows the creation of new leaf-nodes without having to supply a measure function
9- Builder methods are now `const` where possible
10  - Several convenience constants have been defined: notably `FlexboxLayout::DEFAULT`
11- New `Layout` convenience constructor: `with_order(order: u32)`
12
13### 0.2.0 Changed
14
15- `Size<f32>.zero()` is now `Size::<f32>::ZERO`
16- `Point<f32>.zero()` is now  `Point::<f32>::ZERO`
17- renamed `taffy::node::Taffy.new_leaf()` -> `taffy::node::Taffy.new_leaf_with_measure()`
18- removed the public `Number` type; a more idiomatic `Option<f32>` is used instead
19  - the associated public `MinMax` and `OrElse` traits have also been removed; these should never have been public
20- `Sprawl::remove` now returns a `Result<usize, Error>`, to indicate if the operation was sucessful, and if it was, which ID was invalidated.
21- renamed `taffy::forest::Forest.new-node(..)` `taffy::forest::Forest.new_with_children(..)`
22- renamed `taffy::node::Taffy.new-node(..)` -> `taffy::node::Taffy.new_with_children(..)`
23- renamed `taffy::style::Style` -> `taffy::style::FlexboxLayout` to more precicely indicate its purpose
24- renamed `taffy::Error` -> `taffy::error::TaffyError`
25- `taffy::Taffy::remove_child_at_index`, `taffy::Taffy::replace_child_at_index`, and `taffy::Taffy::child_at_index` now return `taffy::InvalidChild::ChildIndexOutOfBounds` instead of panicing
26- `taffy::Node` is now unique only to the Taffy instance from which it was created.
27- `taffy::error::InvalidChild` is now `taffy::error::TaffyError`
28- `taffy::error::InvalidNode` has been removed and is now just a branch on the `TaffyError` enum
29- `taffy::forest::Forest` has been merged into `taffy::node::Taffy` for a performance boost up to 90%
30- `Size::undefined()` has been removed, use `Size::NONE` instead.
31
32### 0.2.0 Fixed
33
34- nodes can only ever have one parent
35- fixed rounding of fractional values to follow latest Chrome - values are now rounded the same regardless of their position
36- fixed computing free space when using both `flex-grow` and a minimum size
37- padding is now only subtracted when determining the available space if the node size is unspecified, following [section 9.2.2 of the flexbox spec](https://www.w3.org/TR/css-flexbox-1/#line-sizing)
38- `MeasureFunc` (and hence `NodeData` and hence `Forest` and hence the public `Taffy` type) are now `Send` and `Sync`, enabling their use in async and parallel applications
39
40### 0.2.0 Removed
41
42- various internal types are no longer public
43  - if you needed one of these, please file an issue!
44
45## 0.1.0
46
47### 0.1.0 Changed
48
49- the `order` field of `Layout` is now public, and describes the relative z-ordering of nodes
50- renamed crate from `stretch2` to `taffy`
51- updated to the latest version of all dependencies to reduce upstream pain caused by duplicate dependencies
52- renamed `stretch::node::Strech` -> `taffy::node::Taffy`
53
54### 0.1.0 Fixed
55
56- fixed feature strategy for `alloc` and `std`: these can now be compiled together, with `std`'s types taking priority
57
58### 0.1.0 Removed
59
60- removed Javascript / Kotlin / Swift bindings
61  - the maintainer team lacks expertise to keep these working
62  - more serious refactors are planned, and this will be challenging to keep working through that process
63  - if you are interested in helping us maintain bindings to other languages, [get in touch](https://github.com/DioxusLabs/taffy/discussions)!
64- the `serde_camel_case` and `serde_kebab_case` features have been removed: they were poorly motivated and were not correctly additive (if both were enabled compilation would fail)
65- removed the `Direction` and `Overflow` structs, and the corresponding `direction` and `overflow` fields from `Style`
66  - these had no effect in the current code base and were actively misleading
67
68## stretch2 0.4.3
69
70This is the final release of `stretch`: migrate to the crate named `taffy` for future fixes and features!
71
72These notes describe the differences between this release and `stretch` 0.3.2, the abandoned crate from which this library was forked.
73
74### Changed
75
76- updated [assorted dependencies](https://github.com/vislyhq/stretch/commit/a6491117379cea52dedc9584d892594a143e8cb0)
77
78### Fixed
79
80- fixed an exponential performance blow-up with deep nesting
81- fixed percent height values, which were using parent width
82- recomputing layout no longer moves children of non-zero-positioned parent
83- fixed broken Swift bindings