Another attempt to more generic solution to transformations of collections and options from outside of standard library

[MateuszKubuszok]

Replacement for #444

TODO:

• create type classes representing: custom options, collections that can be always build, collections that are validated (integrations package)
• add support for new types to ChimneyTypes (macros internals)
• add support for summoning new type classes (macros internals)
• use scala.collection.Map explicitly to make sure we are handling both mutable and immmutable maps
• add support for IArray on Scala 3
• build new structures abstracting away the code in macros from the implementation (like IterableOrArray) delegating to
  • new type classes
  • or stdlib types
• update rules to use new structures instead of build-in types directly
  • start handling partially build collections in Maps and Iterables rules
• tests
  • OptionalValue to/from, wrapping, unwrapping
  • flag OptionDefaultsToNone for OptionalValue[To, ?]
  • path _.foo.matchingSome.bar for OptionalValue[Foo, ?]
  • TotallyBuildIterable to/from
  • path _.foo.everyItem.bar for TotallyBuildIterable[Foo, ?]
  • PartiallyBuildIterable to/from
  • path _.foo.everyItem.bar for PartiallyBuildIterable[Foo, ?]
  • TODO: subtypes and handling of Totally/PartiallyBuildMaps
  • test mutable collections (Maps!)
  • test IArray on Scala 3
• documentation

[codecov]

Codecov Report

Attention: Patch coverage is 83.30134% with 87 lines in your changes are missing coverage. Please review.

Project coverage is 88.06%. Comparing base (c1fa2e0) to head (cd1d846).

Files	Patch %	Lines
...er/rules/TransformProductToProductRuleModule.scala	72.22%	10 Missing ⚠️
...tion/transformer/integrations/OptionalValues.scala	78.04%	9 Missing ⚠️
...ey/internal/compiletime/ChimneyTypesPlatform.scala	70.37%	8 Missing ⚠️
...ernal/compiletime/datatypes/IterableOrArrays.scala	81.25%	6 Missing ⚠️
...ey/internal/compiletime/ChimneyExprsPlatform.scala	50.00%	6 Missing ⚠️
...ey/internal/compiletime/ChimneyTypesPlatform.scala	92.77%	6 Missing ⚠️
...nd/chimney/internal/compiletime/ChimneyExprs.scala	73.91%	6 Missing ⚠️
...scalaland/chimney/integrations/FactoryCompat.scala	63.63%	4 Missing ⚠️
...d/chimney/internal/compiletime/TypesPlatform.scala	76.92%	3 Missing ⚠️
...ransformer/rules/TransformMapToMapRuleModule.scala	92.85%	3 Missing ⚠️
... and 17 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #505      +/-   ##
==========================================
- Coverage   88.98%   88.06%   -0.93%     
==========================================
  Files         129      141      +12     
  Lines        5230     5530     +300     
  Branches      450      459       +9     
==========================================
+ Hits         4654     4870     +216     
- Misses        576      660      +84     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.