tRPC: detect imported procedures and treat as first-class concept

[glorat]

Problem

tRPC routers that import procedures from separate files are not detected. This pattern is common in larger tRPC codebases, where each procedure lives in its own file.

// src/router.ts
import { router } from "./trpc";
import { getUsers } from "./procedures/getUsers";
import { createUser } from "./procedures/createUser";

export const appRouter = router({
  getUsers,       // ShorthandPropertyAssignment — not detected
  createUser,     // ShorthandPropertyAssignment — not detected
  inline: publicProcedure.query(async () => "ok"),  // detected ✓
});

Issues

• Only inline procedure chains (.query(), .mutation()) are detected.
• Imported procedures using shorthand syntax produce zero routes.
• Most real-world tRPC projects end up with incomplete route coverage.
• Detected tRPC procedures are incorrectly grouped under "GraphQL" due to shared method names (QUERY, MUTATION, SUBSCRIPTION), which is misleading.

---

Proposed Changes

1. AST Enhancements: Support Missing tRPC Patterns

Add handling for the following patterns:

• Shorthand Property Assignment

  router({ getUsers })

• Identifier Initializer

  router({ getUsers: getUsersProcedure })

• Nested Namespace Objects

  router({ admin: { users: usersRouter } })

---

2. Treat tRPC as a First-Class Concept

• Filter routes using:

  framework === "trpc"

  instead of relying on method names.

• Render a dedicated section:

  ## tRPC Procedures
  

• Standardize all detected procedures to:

  method: PROCEDURE
  

• Do not attempt to resolve query vs mutation:

  • Requires fragile import resolution
  • Provides minimal value in this context
  • The distinction can be determined when inspecting the source file

---

3. Deduplicate tRPC Routes

• When both AST and regex fallback detect the same procedure:

  • Prefer the AST result

[glorat]

I've got working code to address the above which I'm using for my own project. But not in full ready state to submit as a PR. If you're interested in the patch for the above, I'm more than happy to clean up and submit the PR for this

[Houseofmvps]

Fixed in v1.12.1:

• Shorthand property assignments (router({ getUsers })) now detected as PROCEDURE
• Identifier initializers ({ getUsers: getUsersProcedure }) now detected as PROCEDURE
• tRPC routes grouped by first dotted path segment in wiki — no longer bleeds into GraphQL or other HTTP domains

[glorat]

Nicely done!