feat(cli): Add inline property to type references from properties in Fern definition with OpenAPI importer

[Swimburger]

Description

In the Fern definition, you can express your desire to inline a type from a property on a type or request:

service:
  endpoints:
    endpointName:
      ...
      request:
        ...
        body:
          ...
          properties:
            bar:
              inline: true
              type: InlineType

types:
  RootType:
    properties:
      bar:
        type: InlineType
        inline: true
  InlineType:
    properties:
      ...

The IR generated from this Fern definition will store the desire to inline a type on the property and on the type declaration. For the type declaration, inline will only be true if all properties reference the type express desire to inline a type.

Changes Made

• Update Fern definition to allow inline true on properties referencing a type
• Update OpenAPI parser and OpenAPI IR to pass inline to the generated Fern definition
• Update Fern to IR generator to pass on inline to property and to type

Testing

• Unit tests added/updated

Added more test definitions + evaluate existing test definition snapshots.

[github-actions]

🌿 Preview your docs: https://fern-preview-bb3f524d-4817-4e52-8921-691f5af95bdf.docs.buildwithfern.com/learn

[dsinghvi]

i assume this is the only thing that changed? nit: would be nice to remove the formatting changes for this PR

[dsinghvi]

what happens if an inline type is "extended" or if a discriminated union references the inline type as a variant?

[dsinghvi]

I think you need to iterate over every single TypeReference and store the reference. Maybe we make parseTypeReference stateful?

https://github.com/fern-api/fern/blob/cf894f08ab4d3f0dad59f4512a3c822ac558530e/packages/cli/generation/ir-generator/src/converters/type-declarations/convertObjectTypeDeclaration.ts#L36C24-L36C67

[dsinghvi]

Do you need this property? If a SchemaWithExample contains another SchemaWithExample that is not a reference, you already know the type is inlined

[dsinghvi]

In other words, in openapi-ir-to-fern when you call buildTypeDeclaration() and then that calls buildTypeReference and that calls buildTypeDeclaration again, you know that the second declaration call is for an inlined type.

[dsinghvi]

So if we just tracked depth of call, then i think we should be able to control inline based on that