Merge codegen-kotlin Phase R — snapshot fixtures (J/K/Q) + README typed-enum fix

3 new snapshot regression fixtures:
- entity-with-bidirectional-fk: Author cardinality=many → Post inferred FK
  on PostTable + AuthorRelations.kt with postsQuery extension fn
- entity-with-view: source.rdb @kind=view → READ-ONLY VIEW Table, no
  autoIncrement, no FK refs
- entity-with-stored-proc: source.rdb @kind=storedProc + @param on orderId
  → typed call(orderId: Long) function with SELECT * FROM ${PROC_NAME}(?)
  binding + result-row mapping

KotlinCodegenSnapshotTest gained "relations" + "storedproc" generator-name
arms in its when-switch.

README typed-enum row corrected — Phase G shipped typed Kotlin enum class
(separate <Entity><Field>.kt with @serializable, mapped via
enumerationByName(name, 64, <Entity><Field>::class)). Test count bumped to 75.

75 module tests green (72 baseline + 3 new parameterized snapshot cases).

Author: dmealing

server/java/codegen-kotlin/README.md

@@ -26,7 +26,7 @@ Kotlin codegen target for Spring-Boot-Kotlin consumers on Exposed + Flyway. Emit
 | `field.timestamp` | `java.time.Instant` | `timestampWithTimeZone(name)` |
 | `field.currency` | `Long` (minor units — wire format invariant) | `long(name)` |
 | `field.uuid` | `java.util.UUID` | `uuid(name)` |
-| `field.enum` | `String` (TBD: typed enum class) | `varchar(name, 64)` |
+| `field.enum` | typed Kotlin `enum class` (separate `<Entity><Field>.kt` file with `@Serializable`) | `enumerationByName(name, 64, <Entity><Field>::class)` |
 | `field.object` (`@storage="flattened"`) | reference to the generated VO data class | per-sub-field columns: `<parent>_<sub>` |
 | `field.object` (`@storage="jsonb"` or default) | reference to the generated VO data class | single `jsonb(name, { Json.encodeToString(it) }, { Json.decodeFromString(it) })` |
 
@@ -165,4 +165,4 @@ The shared cross-language codegen conformance corpus is **FR-007** — see [`doc
 
 ## Test count
 
-45 tests in this module (`mvn -pl codegen-kotlin test`). Snapshot tests gate within-Java output stability; `kotlin-compile-testing` gates generated-code validity; an E2E test exercises the full loop including the Java `Renderer`.
+75 tests in this module (`mvn -pl codegen-kotlin test`). Snapshot tests gate within-Java output stability; `kotlin-compile-testing` gates generated-code validity; an E2E test exercises the full loop including the Java `Renderer`.

server/java/codegen-kotlin/src/test/kotlin/com/metaobjects/generator/kotlin/KotlinCodegenSnapshotTest.kt

@@ -48,10 +48,12 @@ class KotlinCodegenSnapshotTest {
             val loader = loadString(name, metaText)
             for (g in config.generators) {
                 val gen = when (g) {
-                    "entity"    -> KotlinEntityGenerator()
-                    "table"     -> KotlinExposedTableGenerator()
-                    "payload"   -> KotlinPayloadGenerator()
-                    "validator" -> KotlinValidatorGenerator()
+                    "entity"     -> KotlinEntityGenerator()
+                    "table"      -> KotlinExposedTableGenerator()
+                    "payload"    -> KotlinPayloadGenerator()
+                    "validator"  -> KotlinValidatorGenerator()
+                    "relations"  -> KotlinRelationsGenerator()
+                    "storedproc" -> KotlinStoredProcGenerator()
                     else -> fail("unknown generator name in config: $g")
                 }
                 val args = mutableMapOf("outputDir" to outDir.toString())

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-bidirectional-fk/config.json

@@ -0,0 +1 @@
+{ "generators": ["entity", "table", "relations"] }

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-bidirectional-fk/meta.json

@@ -0,0 +1,23 @@
+{
+  "metadata.root": {
+    "package": "acme::blog",
+    "children": [
+      { "object.entity": { "name": "Author", "children": [
+          { "field.long":   { "name": "id" } },
+          { "field.string": { "name": "name", "@maxLength": 100 } },
+          { "relationship.composition": { "name": "posts",
+              "@cardinality": "many",
+              "@objectRef": "Post",
+              "@onDelete": "cascade" } },
+          { "source.rdb":   { "@table": "authors" } },
+          { "identity.primary": { "@fields": "id", "@generation": "increment" } }
+      ] } },
+      { "object.entity": { "name": "Post", "children": [
+          { "field.long":   { "name": "id" } },
+          { "field.string": { "name": "title", "@maxLength": 200 } },
+          { "source.rdb":   { "@table": "posts" } },
+          { "identity.primary": { "@fields": "id", "@generation": "increment" } }
+      ] } }
+    ]
+  }
+}

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-stored-proc/config.json

@@ -0,0 +1 @@
+{ "generators": ["entity", "storedproc"] }

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-stored-proc/meta.json

@@ -0,0 +1,13 @@
+{
+  "metadata.root": {
+    "package": "acme::ops",
+    "children": [
+      { "object.entity": { "name": "OrderReport", "children": [
+          { "field.long":   { "name": "orderId", "@param": true } },
+          { "field.string": { "name": "status", "@maxLength": 50 } },
+          { "field.long":   { "name": "totalCents" } },
+          { "source.rdb":   { "@kind": "storedProc", "@table": "get_order_report" } }
+      ] } }
+    ]
+  }
+}

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-view/config.json

@@ -0,0 +1 @@
+{ "generators": ["entity", "table"] }

server/java/codegen-kotlin/src/test/resources/fixtures/entity-with-view/meta.json

@@ -0,0 +1,14 @@
+{
+  "metadata.root": {
+    "package": "acme::report",
+    "children": [
+      { "object.entity": { "name": "SalesReport", "children": [
+          { "field.long":   { "name": "id" } },
+          { "field.string": { "name": "regionName", "@maxLength": 100 } },
+          { "field.long":   { "name": "totalCents" } },
+          { "source.rdb":   { "@table": "v_sales_report", "@kind": "view" } },
+          { "identity.primary": { "@fields": "id" } }
+      ] } }
+    ]
+  }
+}

server/java/codegen-kotlin/src/test/resources/snapshots/entity-with-bidirectional-fk/acme/blog/Author.kt

@@ -0,0 +1,14 @@
+package acme.blog
+
+import kotlin.Long
+import kotlin.String
+import kotlinx.serialization.Serializable
+
+/**
+ * GENERATED — do not hand-edit. Regenerated from metadata.
+ */
+@Serializable
+public data class Author(
+  public val id: Long? = null,
+  public val name: String? = null,
+)

server/java/codegen-kotlin/src/test/resources/snapshots/entity-with-bidirectional-fk/acme/blog/AuthorRelations.kt

@@ -0,0 +1,9 @@
+package acme.blog
+
+import org.jetbrains.exposed.sql.Query
+import org.jetbrains.exposed.sql.selectAll
+
+/** GENERATED — extension fns for `Author` to-many relationships. Do not hand-edit. */
+/** Query `Author.posts` (cardinality=many) on the Post side. */
+fun AuthorTable.postsQuery(authorId: Long): Query =
+    PostTable.selectAll().where { PostTable.authorId eq authorId }