test(codegen-ts): template-codegen conformance corpus + TS gate

dmealing · claude · dmealing · commit 197aeebd11ec · 2026-06-28T14:43:08.000-04:00
Cross-port corpus: spec.json (perEntity/perPackage/perModel) over metadata/ resolving templates/ → byte-identical expected/. The TS gate runs it in a hermetic tmp projectRoot (copies templates/) so runGen's .gen-state merge base never lands in the committed corpus; a corpus .gitignore guards .metaobjects/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LuZWKnWzYGVnESijL7uuky
diff --git a/fixtures/template-codegen-conformance/.gitignore b/fixtures/template-codegen-conformance/.gitignore
@@ -0,0 +1 @@
+.metaobjects/
diff --git a/fixtures/template-codegen-conformance/README.md b/fixtures/template-codegen-conformance/README.md
@@ -0,0 +1,25 @@
+# template-codegen conformance corpus
+
+Cross-port gate for the declarative Mustache template generator (SP-1).
+
+Every port runs `spec.json` (a list of `{ name, template, scope, outputPattern }`
+generators) over `metadata/meta.shop.json`, resolving templates from `templates/`,
+and must produce output **byte-identical** to `expected/`.
+
+The corpus exercises all three built-in scopes:
+
+- **`perEntity`** (`entity.mustache` → `<Name>.txt`) — the neutral per-entity data
+  dict: fields (name/type/required/isArray/maxLength), and Order's `product`
+  relationship.
+- **`perPackage`** (`package.mustache` → `<package>/_package.txt`) — one file per
+  package, listing its entities.
+- **`perModel`** (`model.mustache` → `_model.txt`) — one file for the whole model.
+
+The render engine is already byte-equal across ports (`fixtures/render-conformance/`);
+this corpus gates the *new* surface: the structural data dict, the scope names
+(`perEntity`/`perPackage`/`perModel`), and the output-pattern grammar
+(`{name}`/`{Name}`/`{package}`).
+
+Regenerate `expected/` after an intentional change to the data dict or scope walks
+by pointing the generator at the `expected/` directory and committing the result
+(see each port's conformance test).
diff --git a/fixtures/template-codegen-conformance/expected/Order.txt b/fixtures/template-codegen-conformance/expected/Order.txt
@@ -0,0 +1,4 @@
+// Order (shop)
+- id: long
+- productId: long
+rel product -> Product (one)
diff --git a/fixtures/template-codegen-conformance/expected/Product.txt b/fixtures/template-codegen-conformance/expected/Product.txt
@@ -0,0 +1,4 @@
+// Product (shop)
+- id: long
+- name: string required maxLength=120
+- status: enum
diff --git a/fixtures/template-codegen-conformance/expected/_model.txt b/fixtures/template-codegen-conformance/expected/_model.txt
@@ -0,0 +1,2 @@
+model:
+  shop: Product Order 
diff --git a/fixtures/template-codegen-conformance/expected/shop/_package.txt b/fixtures/template-codegen-conformance/expected/shop/_package.txt
@@ -0,0 +1 @@
+package shop: Product Order 
diff --git a/fixtures/template-codegen-conformance/metadata/meta.shop.json b/fixtures/template-codegen-conformance/metadata/meta.shop.json
@@ -0,0 +1,31 @@
+{
+  "metadata.root": {
+    "package": "shop",
+    "children": [
+      {
+        "object.entity": {
+          "name": "Product",
+          "children": [
+            { "source.rdb": { "@table": "products" } },
+            { "field.long": { "name": "id" } },
+            { "field.string": { "name": "name", "@required": true, "@maxLength": 120 } },
+            { "field.enum": { "name": "status", "@values": ["ACTIVE", "ARCHIVED"] } },
+            { "identity.primary": { "name": "primary", "@fields": ["id"], "@generation": "increment" } }
+          ]
+        }
+      },
+      {
+        "object.entity": {
+          "name": "Order",
+          "children": [
+            { "source.rdb": { "@table": "orders" } },
+            { "field.long": { "name": "id" } },
+            { "field.long": { "name": "productId" } },
+            { "identity.primary": { "name": "primary", "@fields": ["id"], "@generation": "increment" } },
+            { "relationship.association": { "name": "product", "@cardinality": "one", "@objectRef": "Product" } }
+          ]
+        }
+      }
+    ]
+  }
+}
diff --git a/fixtures/template-codegen-conformance/spec.json b/fixtures/template-codegen-conformance/spec.json
@@ -0,0 +1,7 @@
+{
+  "generators": [
+    { "name": "ent", "template": "entity", "scope": "perEntity", "outputPattern": "{name}.txt" },
+    { "name": "pkg", "template": "package", "scope": "perPackage", "outputPattern": "{package}/_package.txt" },
+    { "name": "mdl", "template": "model", "scope": "perModel", "outputPattern": "_model.txt" }
+  ]
+}
diff --git a/fixtures/template-codegen-conformance/templates/entity.mustache b/fixtures/template-codegen-conformance/templates/entity.mustache
@@ -0,0 +1,5 @@
+// {{name}} ({{package}})
+{{#fields}}- {{name}}: {{type}}{{#isArray}}[]{{/isArray}}{{#required}} required{{/required}}{{#maxLength}} maxLength={{maxLength}}{{/maxLength}}
+{{/fields}}
+{{#relationships}}rel {{name}} -> {{targetRef}} ({{cardinality}})
+{{/relationships}}
diff --git a/fixtures/template-codegen-conformance/templates/model.mustache b/fixtures/template-codegen-conformance/templates/model.mustache
@@ -0,0 +1,3 @@
+model:
+{{#packages}}  {{package}}: {{#entities}}{{name}} {{/entities}}
+{{/packages}}
diff --git a/fixtures/template-codegen-conformance/templates/package.mustache b/fixtures/template-codegen-conformance/templates/package.mustache
@@ -0,0 +1 @@
+package {{package}}: {{#entities}}{{name}} {{/entities}}
diff --git a/server/typescript/packages/codegen-ts/test/template-codegen/conformance.test.ts b/server/typescript/packages/codegen-ts/test/template-codegen/conformance.test.ts
@@ -0,0 +1,51 @@
+import { describe, test, expect } from "bun:test";
+import { mkdtempSync, rmSync, readdirSync, readFileSync, statSync, cpSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve, relative } from "node:path";
+import { runGen, defineConfig, parseTemplateSpec, templateSpecToGenerators } from "../../src/index.js";
+import { MetaDataLoader } from "@metaobjectsdev/metadata";
+import { FileSource } from "@metaobjectsdev/metadata/core";
+
+const CORPUS = resolve(import.meta.dir, "../../../../../../fixtures/template-codegen-conformance");
+
+function walkFiles(dir: string, base = dir): string[] {
+  return readdirSync(dir).flatMap((n) => {
+    const p = join(dir, n);
+    return statSync(p).isDirectory() ? walkFiles(p, base) : [relative(base, p)];
+  });
+}
+
+describe("template-codegen conformance (TS)", () => {
+  test("spec.json over metadata/ matches expected/ byte-for-byte", async () => {
+    const spec = parseTemplateSpec(JSON.parse(readFileSync(join(CORPUS, "spec.json"), "utf8")));
+    const loader = new MetaDataLoader();
+    const res = await loader.load([new FileSource(join(CORPUS, "metadata", "meta.shop.json"))]);
+    expect(res.errors).toEqual([]);
+
+    // Hermetic: copy the corpus templates into a tmp projectRoot so runGen writes
+    // its .gen-state merge base into the tmp tree, never into the committed corpus.
+    const projectRoot = mkdtempSync(join(tmpdir(), "tmpl-conf-"));
+    const out = join(projectRoot, "out");
+    cpSync(join(CORPUS, "templates"), join(projectRoot, "templates"), { recursive: true });
+    try {
+      await runGen({
+        config: defineConfig({
+          outDir: out, extStyle: "none", dbImport: "~/db", dialect: "sqlite",
+          generators: templateSpecToGenerators(spec),
+        }),
+        metadata: res.root,
+        projectRoot,
+      });
+      const expectedDir = join(CORPUS, "expected");
+      const got = walkFiles(out).sort();
+      const want = walkFiles(expectedDir).sort();
+      expect(got).toEqual(want);
+      for (const rel of want) {
+        expect(`${rel}:\n${readFileSync(join(out, rel), "utf8")}`)
+          .toBe(`${rel}:\n${readFileSync(join(expectedDir, rel), "utf8")}`);
+      }
+    } finally {
+      rmSync(projectRoot, { recursive: true, force: true });
+    }
+  });
+});

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+model:`
	`2`	`+{{#packages}} {{package}}: {{#entities}}{{name}} {{/entities}}`
	`3`	`+{{/packages}}`