fix(openapi): preserve component schema names through dereferencing

[ALagoni97]

Problem

Generating a client from an OpenAPI spec with namespaced component schemas (e.g. Safepay's GetTransactions.Model.TransactionModel) produced corrupt payload models:

• The parser fully dereferences the document, discarding all $ref component names. Modelina then falls back to naming nested anonymous models after the property path, so every items array item across the whole spec was named ItemsItem.
• Each operation's payload is generated in a separate pass into the same output folder, and file dedup is first-path-wins — so the first ItemsItem.ts written (the users item model) silently replaced all others. GetV2TransactionsResponse_200.items was typed as ItemsItem[] containing safepayAccountId/name/phoneNumber instead of transactionId/amount/currency.

Fix

• After dereferencing, tag each components.schemas / definitions entry with Modelina's x-modelgen-inferred-name hint (lowest naming precedence — never overrides an author-provided title/$id, and no $id base-URI side effects). Dereferencing inlines refs by object reference, so the tag on the component entry propagates to every usage site.
• Namespaced names shorten to their last dot-segment when unambiguous across the spec (GetTransactions.Model.TransactionModel → TransactionModel); ambiguous ones (GetUsers.Model / GetTransactions.Model both ending in .Model) keep the full name.
• Standalone component models (otherPayloads) reuse the same chosen name, so the nested split model and the standalone component model resolve to one identical file instead of two divergent classes.
• Response schemas are now copied before being decorated with x-modelina-status-codes; previously the shared post-dereference schema object was mutated, leaking status codes between operations reusing the same component.

Result (safepay-v2)

// GetV2TransactionsResponse_200.ts
private _items?: TransactionModel[];

// TransactionModel.ts
private _transactionId: string;
private _amount: string | number;
private _currency: Currencies;

No ItemsItem anywhere; the full 203-file generated client type-checks cleanly.

Testing

• New regression fixture test/configs/openapi-shared-items.json reproducing the collision; end-to-end test asserts distinct TransactionModel/UserModel files with correct properties and no ItemsItem.
• Unit tests for the shortening/ambiguity rules and tag precedence.
• Full test/codegen suite: 372 passing, no snapshot changes. npm run lint clean.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
the-codegen-project	Ready	Preview, Comment	Jul 15, 2026 7:41am
the-codegen-project-mcp	Ready	Preview, Comment	Jul 15, 2026 7:41am

[ALagoni97]

Will be reopenend towards main