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- Added support for `AlignContent::SpaceEvenly`
13- Added `AvailableSpace` enum
14- Added `debug` modules with a `print_tree` function, which prints a debug representation of the computed layout for a tree of nodes.
15- Added support for `gap` property (shorthand form of `row-gap`/`column-gap`)
16
17### 0.2.0 Changed
18
19- `Size<f32>.zero()` is now `Size::<f32>::ZERO`
20- `Point<f32>.zero()` is now  `Point::<f32>::ZERO`
21- renamed `taffy::node::Taffy.new_leaf()` -> `taffy::node::Taffy.new_leaf_with_measure()`
22- removed the public `Number` type; a more idiomatic `Option<f32>` is used instead
23  - the associated public `MinMax` and `OrElse` traits have also been removed; these should never have been public
24- `Sprawl::remove` now returns a `Result<usize, Error>`, to indicate if the operation was sucessful, and if it was, which ID was invalidated.
25- renamed `taffy::forest::Forest.new-node(..)` `taffy::forest::Forest.new_with_children(..)`
26- renamed `taffy::node::Taffy.new-node(..)` -> `taffy::node::Taffy.new_with_children(..)`
27- renamed `taffy::style::Style` -> `taffy::style::FlexboxLayout` to more precicely indicate its purpose
28- renamed `taffy::Error` -> `taffy::error::TaffyError`
29- `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
30- `taffy::Node` is now unique only to the Taffy instance from which it was created.
31- `taffy::error::InvalidChild` is now `taffy::error::TaffyError`
32- `taffy::error::InvalidNode` has been removed and is now just a branch on the `TaffyError` enum
33- `taffy::forest::Forest` has been merged into `taffy::node::Taffy` for a performance boost up to 90%
34- `Size::undefined()` has been removed, use `Size::NONE` instead.
35- `Taffy.compute_layout()` now takes `Size<AvailableSpace>` instead of `Size<Option<f32>>`. If you were previously passing `Size::NONE` to this function, you will now need to pass `Size::MAX_CONTENT`
36- Measure functions now have an additional `available_space` parameter which indicates the size of the parent or a min/max-content sizing constraint.
37- Added `Size::MIN_CONTENT` and `Size::MAX_CONTENT` constants. In many cases, you will want to replace `Size::NONE` with `Size::MAX_CONTENT`.
38
39### 0.2.0 Fixed
40
41- Performance with deep hierarchies is greatly improved. It is now comparable to that of shallow hierarchies with the same number of nodes.
42- nodes can only ever have one parent
43- fixed rounding of fractional values to follow latest Chrome - values are now rounded the same regardless of their position
44- fixed computing free space when using both `flex-grow` and a minimum size
45- 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)
46- `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
47
48### 0.2.0 Removed
49
50- various internal types are no longer public
51  - if you needed one of these, please file an issue!
52
53## 0.1.0
54
55### 0.1.0 Changed
56
57- the `order` field of `Layout` is now public, and describes the relative z-ordering of nodes
58- renamed crate from `stretch2` to `taffy`
59- updated to the latest version of all dependencies to reduce upstream pain caused by duplicate dependencies
60- renamed `stretch::node::Strech` -> `taffy::node::Taffy`
61
62### 0.1.0 Fixed
63
64- fixed feature strategy for `alloc` and `std`: these can now be compiled together, with `std`'s types taking priority
65
66### 0.1.0 Removed
67
68- removed Javascript / Kotlin / Swift bindings
69  - the maintainer team lacks expertise to keep these working
70  - more serious refactors are planned, and this will be challenging to keep working through that process
71  - if you are interested in helping us maintain bindings to other languages, [get in touch](https://github.com/DioxusLabs/taffy/discussions)!
72- 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)
73- removed the `Direction` and `Overflow` structs, and the corresponding `direction` and `overflow` fields from `Style`
74  - these had no effect in the current code base and were actively misleading
75
76## stretch2 0.4.3
77
78This is the final release of `stretch`: migrate to the crate named `taffy` for future fixes and features!
79
80These notes describe the differences between this release and `stretch` 0.3.2, the abandoned crate from which this library was forked.
81
82### Changed
83
84- updated [assorted dependencies](https://github.com/vislyhq/stretch/commit/a6491117379cea52dedc9584d892594a143e8cb0)
85
86### Fixed
87
88- fixed an exponential performance blow-up with deep nesting
89- fixed percent height values, which were using parent width
90- recomputing layout no longer moves children of non-zero-positioned parent
91- fixed broken Swift bindings