Pattern matching with `KClass` and `KProperty`

[serras]

This is a generalization of #3442, but using kotlin.reflect APIs instead of optics (and only the part in the standard library, so we actually do not depend on the kotlin.reflect library). The result doesn't look so nice, but it can still be very useful.

val User.shownName: String get() = this.matchOrThrow {
  Person::class.of(Person::name.of(Name::firstName), Person::age.suchThat { it < 18 }) then { (fn, _) -> fn }
  Person::class.of(Person::name.of(Name::firstName, Name::lastName)) then { (fn, ln) -> "Sir/Madam $fn $ln" }
  Company::class.of(Company::name, Company::director.of(Name::lastName)) then { (nm, d) -> "$nm, att. $d" }
}

Implementation note: I started with even shorter code, without .of (Person::name(Name::firstName)). However, it turns out that this is reserved syntax, so I had to come up with a small name instead.

[github-actions[bot]]

Kover Report

File	Coverage [32.50%]
arrow-libs/optics/arrow-optics/src/commonMain/kotlin/arrow/optics/match/Combinators.kt	32.50%

Total Project Coverage	60.34%

[nomisRev]

Sorry for the hold-up @serras. This is on my backlog for asap.

[serras]

Also, does arrow-match belong to arrow-optics if it doesn't depend on optics?

I'm not really sure about where it should be. In my mind it goes in optics because it's about immutable data inspection, like optics.

Also, I fear we end up with a super-big core folder.