sebnitu / vrembem / 11061120079

94%

main: 100%

push

github

Create new CollectionEntry class and add lifecycle hooks to Collections API (#2046)

## What changed?

The primary goal of this PR is to introduce the new `CollectionEntry` class used as the prototype of collection entries. This also introduces some new Collection API lifecycle hooks for both the root component (extended from Collection) and entries (extended from CollectionEntry).

**New API**

- `applySettings()` (collection and entry) method that allows passing a configuration object to settings.
- `createEntry()` (collection) method that returns an instantiation of the `CollectionEntry` class.

### Lifecycle Hooks

Lifecycle hooks are applied using a new helper `lifecycleHooks` and is applied to mount/unmount and register/deregister actions. The following are the lifecycle hooks and the order that they are called:

**On Mount:**

- `beforeMount`
- `entry.mount`
  - `entry.beforeMount`
  - `entry.afterMount`
- `beforeRegister`
- `entry.beforeRegister`
- Entry is added to collection.
- `entry.afterRegister`
- `afterRegister`
- `afterMount`

**On Unmount:**

- `beforeUnmount`
- `entry.unmount`
  - `entry.beforeUnmount`
  - `entry.afterUnmount`
- `beforeDeregister`
- `entry.beforeDeregister`
- Entry is removed from collection.
- `entry.afterDeregister`
- `afterDeregister`
- `afterUnmount`

### Additional changes

- Core modules have been refactored and organized in a more logic way (utilities, helpers, etc).
- Removed `registerCollection`
- Removed `deregisterCollection`
- `getCustomProps` now takes a collection entry as an argument.
- `getElement` now returns null in final case.
- `transition` no longer handles custom property fetching and instead requires some number value as the duration argument.
- Added `toMilliseconds` which converts a string or number to milliseconds if possible. 
- Renamed `updateGlobalState` to `setGlobalState`.
- All three component settings have been changed in the following ... (continued)

596 of 596 branches covered (100.0%)

Branch coverage included in aggregate %.

880 of 880 new or added lines in 29 files covered. (100.0%)

2486 of 2486 relevant lines covered (100.0%)

99.98 hits per line