fix(codegen-ts): annotate cross-entity FK .references() with Any*Column

The Drizzle schema generator only emitted the explicit `(): Any{Pg,SQLite}Column`
return-type annotation on the .references() callback for SELF-referential FKs
(targetEntityName === currentEntityName). Cross-MODULE circular references — table
A → B while B → A — also form an import cycle that makes TypeScript infer the table
const as `any` (TS7022 "implicitly has type 'any' … referenced in its own
initializer") under `strict`, but those went through the un-annotated branch.

Emit the annotation unconditionally on .references() callbacks: it is the
Drizzle-documented fix for circular inference and is a harmless explicit supertype
for acyclic FKs.

- drizzle-schema.ts: hoist the Any*Column symbol and annotate both the self-ref and
  cross-entity branches.
- Regenerated postgres/sqlite/package golden snapshots (cross-entity FKs now carry
  the annotation) + updated the field-extends-attr inline assertion.
- Added a cross-module circular-FK regression test (Author <-> Book) asserting both
  directions emit `(): AnyPgColumn => ...`.

Surfaced by a downstream consumer whose generated schema has mutually-referential
tables (e.g. active_npcs <-> npc_groups): `tsc --strict` failed with TS7022 on the
0.12 output. 819 tests pass.

Author: dmealing

server/typescript/packages/codegen-ts/src/templates/drizzle-schema.ts

@@ -326,12 +326,18 @@ function renderColumn(
   // FK .references() uses imp() so ts-poet tracks the cross-entity import.
   let fkRefSegment: Code | null = null;
   if (fkInfo !== undefined && !isPk) {
+    // Always annotate the .references() callback with the dialect's Any*Column return
+    // type. Drizzle needs this to break circular type inference — not only for
+    // self-referential FKs but also for cross-module circular references (table A → B
+    // while B → A), which otherwise surface as TS7022 ("implicitly has type 'any'
+    // because it does not have a type annotation and is referenced … in its own
+    // initializer") under `strict`. The annotation is a harmless explicit supertype
+    // for acyclic FKs, so emitting it unconditionally is safe.
+    const anyColType = ctx.dialect === "sqlite" ? "AnySQLiteColumn" : "AnyPgColumn";
+    const anyColSym = imp(`${anyColType}@${spec.importModule}`);
     if (fkInfo.targetEntityName === currentEntityName) {
-      // Self-referential FK (e.g. createdBy → this same table). Drizzle requires
-      // referencing the local table const directly — NOT a self-import — with an
-      // explicit `Any*Column` return type to break the circular type inference.
-      const anyColType = ctx.dialect === "sqlite" ? "AnySQLiteColumn" : "AnyPgColumn";
-      const anyColSym = imp(`${anyColType}@${spec.importModule}`);
+      // Self-referential FK (e.g. createdBy → this same table): reference the local
+      // table const directly — NOT a self-import.
       fkRefSegment = code`.references((): ${anyColSym} => ${fkInfo.targetVarName}.${fkInfo.targetPkField})`;
     } else {
       const targetSpec = crossEntitySpecifier(
@@ -342,7 +348,7 @@ function renderColumn(
         ctx.extStyle,
       );
       const targetVarSym = imp(`${fkInfo.targetVarName}@${targetSpec}`);
-      fkRefSegment = code`.references(() => ${targetVarSym}.${fkInfo.targetPkField})`;
+      fkRefSegment = code`.references((): ${anyColSym} => ${targetVarSym}.${fkInfo.targetPkField})`;
     }
   }
 

server/typescript/packages/codegen-ts/test/field-extends-attr.test.ts

@@ -40,6 +40,6 @@ describe("field-level extends + qualified-ref codegen", () => {
 
   test("a package-qualified FK target still emits .references()", async () => {
     const out = await renderWidget();
-    expect(out).toContain("ownerId: uuid(\"owner_id\").references(() => owners.id)");
+    expect(out).toContain("ownerId: uuid(\"owner_id\").references((): AnyPgColumn => owners.id)");
   });
 });

server/typescript/packages/codegen-ts/test/golden/__snapshots__/package/Tag.ts

@@ -2,7 +2,12 @@
 // Source metadata: Tag (Tag)
 // Customize via Tag.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
-import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+import {
+  AnySQLiteColumn,
+  integer,
+  sqliteTable,
+  text,
+} from "drizzle-orm/sqlite-core";
 import { z } from "zod";
 import { products } from "./shop/commerce/Product";
 import { customers } from "./shop/users/Customer";
@@ -12,7 +17,7 @@ export const tags = sqliteTable("tags", {
   label: text("label").notNull(),
   customerId: integer("customer_id")
     .notNull()
-    .references(() => customers.id),
+    .references((): AnySQLiteColumn => customers.id),
 });
 export const tagsRelations = relations(tags, ({ one, many }) => ({
   products: many(products),

server/typescript/packages/codegen-ts/test/golden/__snapshots__/package/shop/commerce/Order.ts

@@ -2,7 +2,7 @@
 // Source metadata: Order (shop::commerce::Order)
 // Customize via Order.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
-import { integer, sqliteTable } from "drizzle-orm/sqlite-core";
+import { AnySQLiteColumn, integer, sqliteTable } from "drizzle-orm/sqlite-core";
 import { z } from "zod";
 import { customers } from "../users/Customer";
 import { products } from "./Product";
@@ -11,10 +11,10 @@ export const orders = sqliteTable("orders", {
   id: integer("id").primaryKey({ autoIncrement: true }),
   customerId: integer("customer_id")
     .notNull()
-    .references(() => customers.id),
+    .references((): AnySQLiteColumn => customers.id),
   productId: integer("product_id")
     .notNull()
-    .references(() => products.id),
+    .references((): AnySQLiteColumn => products.id),
   quantity: integer("quantity").notNull(),
 });
 export const ordersRelations = relations(orders, ({ one }) => ({

server/typescript/packages/codegen-ts/test/golden/__snapshots__/package/shop/commerce/Product.ts

@@ -2,7 +2,12 @@
 // Source metadata: Product (shop::commerce::Product)
 // Customize via Product.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
-import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+import {
+  AnySQLiteColumn,
+  integer,
+  sqliteTable,
+  text,
+} from "drizzle-orm/sqlite-core";
 import { z } from "zod";
 import { tags } from "../../Tag";
 import { orders } from "./Order";
@@ -12,7 +17,7 @@ export const products = sqliteTable("products", {
   name: text("name").notNull(),
   tagId: integer("tag_id")
     .notNull()
-    .references(() => tags.id),
+    .references((): AnySQLiteColumn => tags.id),
 });
 export const productsRelations = relations(products, ({ one, many }) => ({
   orders: many(orders),

server/typescript/packages/codegen-ts/test/golden/__snapshots__/postgres/Exercise.ts

@@ -3,6 +3,7 @@
 // Customize via Exercise.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
 import {
+  AnyPgColumn,
   bigint,
   bigserial,
   integer,
@@ -18,7 +19,7 @@ export const exercises = pgTable("exercises", {
   id: bigserial("id", { mode: "number" }).primaryKey(),
   workoutId: bigint("workout_id", { mode: "number" })
     .notNull()
-    .references(() => workouts.id),
+    .references((): AnyPgColumn => workouts.id),
   name: varchar("name", { length: 200 }).notNull(),
   sets: integer("sets"),
   reps: integer("reps"),

server/typescript/packages/codegen-ts/test/golden/__snapshots__/postgres/Purchase.ts

@@ -3,6 +3,7 @@
 // Customize via Purchase.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
 import {
+  AnyPgColumn,
   bigint,
   bigserial,
   integer,
@@ -17,10 +18,10 @@ export const purchases = pgTable("purchases", {
   id: bigserial("id", { mode: "number" }).primaryKey(),
   subscriberId: bigint("subscriber_id", { mode: "number" })
     .notNull()
-    .references(() => subscribers.id),
+    .references((): AnyPgColumn => subscribers.id),
   programId: bigint("program_id", { mode: "number" })
     .notNull()
-    .references(() => programs.id),
+    .references((): AnyPgColumn => programs.id),
   amountCents: integer("amount_cents").notNull(),
   purchasedAt: timestamp("purchased_at", { mode: "string" })
     .notNull()

server/typescript/packages/codegen-ts/test/golden/__snapshots__/postgres/Video.ts

@@ -3,6 +3,7 @@
 // Customize via Video.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
 import {
+  AnyPgColumn,
   bigint,
   bigserial,
   integer,
@@ -16,7 +17,7 @@ export const videos = pgTable("videos", {
   id: bigserial("id", { mode: "number" }).primaryKey(),
   exerciseId: bigint("exercise_id", { mode: "number" })
     .notNull()
-    .references(() => exercises.id),
+    .references((): AnyPgColumn => exercises.id),
   url: varchar("url", { length: 500 }).notNull(),
   title: varchar("title", { length: 200 }),
   durationSeconds: integer("duration_seconds"),

server/typescript/packages/codegen-ts/test/golden/__snapshots__/postgres/Week.ts

@@ -3,6 +3,7 @@
 // Customize via Week.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
 import {
+  AnyPgColumn,
   bigint,
   bigserial,
   integer,
@@ -17,7 +18,7 @@ export const weeks = pgTable("weeks", {
   id: bigserial("id", { mode: "number" }).primaryKey(),
   programId: bigint("program_id", { mode: "number" })
     .notNull()
-    .references(() => programs.id),
+    .references((): AnyPgColumn => programs.id),
   weekNumber: integer("week_number").notNull(),
   title: varchar("title", { length: 200 }).notNull(),
 });

server/typescript/packages/codegen-ts/test/golden/__snapshots__/postgres/Workout.ts

@@ -3,6 +3,7 @@
 // Customize via Workout.extra.ts in this directory.
 import { InferInsertModel, InferSelectModel, relations } from "drizzle-orm";
 import {
+  AnyPgColumn,
   bigint,
   bigserial,
   integer,
@@ -18,7 +19,7 @@ export const workouts = pgTable("workouts", {
   id: bigserial("id", { mode: "number" }).primaryKey(),
   weekId: bigint("week_id", { mode: "number" })
     .notNull()
-    .references(() => weeks.id),
+    .references((): AnyPgColumn => weeks.id),
   title: varchar("title", { length: 200 }).notNull(),
   orderIndex: integer("order_index").notNull(),
   durationMinutes: integer("duration_minutes"),