WIP: Enhance inject route utilities

[Dafnik]

Adds the following options to all utilities and therefore aligns them.

• injectParams
  • transform
  • defaultValue
  • injector
• injectQueryParams
  • defaultValue
  • injector
• injectQueryParams.array
  • defaultValue
  • injector
• injectRouteData
  • defaultValue
  • injector
• injectRouteFragment
  • defaultValue

I also took the chance to rename initialValue to defaultValue (as I think it's a more fitting name).
injectQueryParams supports both values, as to not introduce a breaking change.

Tests are still missing.

[nartc]

is this still WIP?

[Dafnik]

Yes, docs and tests are missing.

[eneajaho]

Hello @Dafnik
Thanks for this great PR.

Regarding

I also took the chance to rename initialValue to defaultValue (as I think it's a more fitting name).
injectQueryParams supports both values, as to not introduce a breaking change.

I think initialValue is a better fit there because after the initialValue, the params can change however the router needs, and we shouldn't call it default value (as that would mean that we will reapply it again based on some condition, which we don't because we only need it the first time).

[Dafnik]

Hi, thank you very much :)

But it is actually a default value. 😅

Lets say we have the route test and use the URL /test?a=1234.
If we use injectQueryParams('a', {defaultValue: '1111'}) we will get the result 1234.
But now the route changes to /test. The query param is null and the default value 1111 will be emitted.

Or did I get this wrong?

[Dafnik]

Ping @eneajaho

[krisatopi]

This one should be included in the docs too https://timdeschryver.dev/blog/til-paramsinheritancestrategy-to-always-have-access-to-parent-route-info

[eneajaho]

Hello @Dafnik
Sorry for this taking so long..

As you may have already seen, I've published linkedQueryParam, https://ngxtension.netlify.app/utilities/injectors/linked-query-param/

In order for things to be consistent, I'd like to convert the method transform to be called parse in order for utilities to align
For the initialValue, as you said, defaultValue would be a better fit.

So, all the utils should contain: defaultValue, injector, parse options.

If you don't have time to finish this one, I can take over anytime. Please let me know, as I'd like to get these features out as they are really needed.

Happy new year ✨

[eneajaho]

Btw, just re-read this one reply #495 (comment)

Looks like I can take over 🙌

[Dafnik]

Yeah please take it over!

The parse function sound good for me!
Also gives it a distinction of Angular's tranform.

I've already tried out linkedQueryParams and I love it!! Really great UX and much better than just having injectQueryParams.