CHANGELOG.md in ecoportal-api-v2-0.8.26 vs CHANGELOG.md in ecoportal-api-v2-0.8.27

@@ -1,15 +1,76 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-## [0.8.26] - 2022-02-xx
+## [0.8.27] - 2022-03-xx
 
 ### Added
-  `Ecoportal::API::V2::Page::Stage#add_permit`
-  `Ecoportal::API::V2::Page::Permit.new_doc`
-  
+  - `Ecoportal::API::Common::Content::CollectionModel#clear`
+    - It calls `#delete!` on each item from an `Array` copy
+  - `Ecoportal::API::V2::Page::Components#add`
+    - Now it allows to use a `Hash` _doc_ model to create the `Component`
+  - `Ecoportal::API::V2::Page::Component::SelectionField` **added** some methods:
+    - `#numeric?`, `#text?` to check the `data_type` of the _selection options_
+    - `#switch_type!` to switch the `data_type` between `txt` and `num`
+    - `#deselect` to mark as `false` the property `selected` of some _selection option_
+    - `#name` counterpart of `#value`
+    - `#values` and `#names` they return always an `Array` (no matter if the field is **not** `multiple`)
+    - `#options_by_value` which returns a `Hash` with all the options by their `value`
+    - `#options_by_name` which returns a `Hash` with all the options by their `name`
+  - `Ecoportal::API::V2::Page::Component` **added** some methods:
+    - `#forces`, `#bindings` and `#bindings?` to check if a _Component_ has bindings in what forces and what those bindings are.
+  - `Ecoportal::API::V2::Page::Force#bind` to add a _binding_
+  - `Ecoportal::API::V2::Page::Force::Binding` **added** a couple of methods:
+    - `#force` to refer to the _Force_ object of a binding
+    - `#reference` to retrieve the _component_ or _section_ the binding refers to
+  - `Ecoportal::API::V2::Page::Force::Bindings` **added** some methods:
+    - `#force` to refer to the _Force_ object of the bindings
+    - `#by_name` and `#by_reference` to obtain a `Hash` with all the _bindings_
+    - `#reference?` to check if a _section_ or _component_ have a binding to the _force_
+    - `#get_by_reference` to retrieve an `Array` with all the _bindings_ to one _section_ or _component_
+  - `Ecoportal::API::V2::Page::Forces#bindings_by_reference`
+    - For (script) **optimization** purposes. It gets all the _bindings_ as a `Hash` of _reference_ to `Array<Binding>`
+  - `Ecoportal::API::V2::Page::Section` **added** some methods:
+    - `#shared?` to know if the _section_ is shared by multiple stages
+    - `#bindings` to obtain the _bindings_ of the _section_ in any _force_
+    - `#forces` all the _forces_ that this _section_ has a _binding_ to
+    - `#bindings?` whether or not the _section_ has any force _binding_
+  - `Ecoportal::API::V2::Page::Sections` **added** some methods:
+    - `#any_shared?` whether or not there are shared sections
+    - `#move` to **move** the _section_ to some specific position
+
 ### Changed
+  - `ecoportal-api` dependency upgrade
+  - `Ecoportal::API::V2::Page::PermissionFlags#configure`
+    - Added option to pass a `Hash` with pairs `Symbol`, `Boolean`
+    - `flags.configure {subscribed: true}`
+  - `Ecoportal::API::Common::Content::ModelHelpers#same_string?`
+    - Added parameter `mild:` to compare the strings with only alphabetic characters
+  - `Ecoportal::API::V2::Page::Component::SelectionField` **added** some methods:
+    - `#selected` **added** parameters to modify the _returned_ value
+      - `by_name:` and `by_value:` to return a `Hash`
+      - `value:` and `name:` which combines respectively with the above, to cast them in the `Hash`
+  - `Ecoportal::API::V2::Page::Sections#get_by_heading`
+    - added `mild:` option to allow more flexibility on searches
+
 ### Fixed
+  - `Ecoportall::API::Common::Content::DoubleModel#dirty?`
+    - It was checking that `#as_update` equaled `{}`. Now it also checks on `null` too.
+  - `Ecoportal::API::V2::Page::Component::SelectionOption#numeric!`
+    - It was using `to_i` which would return `0` when the source `value` was not numeric.
+    - Now it uses `Float(value)`, provided that it can throw an exception
+  - `Ecoportal::API::V2::Pages::Stages#get`
+    - The _page_ `id` and `stage_id` were used exchanged in the message
+  - `Ecoportal::API::V2::Page::Forces` fixed the `weight` (position) scoping
+    - It was not positioning correctly
+  - `Ecoportal::API::V2::Page::Sections` fixed the `weight` (position) scoping
+    - It was not positioning correctly
+
+## [0.8.26] - 2022-03-25
+
+### Added
+  `Ecoportal::API::V2::Page::Stage#add_permit`
+  `Ecoportal::API::V2::Page::Permit.new_doc`
 
 ## [0.8.25] - 2022-02-04
 
 ### Added
   - `Ecoportal::API::V2::Page::Component::ReferenceField#add` to add new references