fix(cli): add unions to settings. (#5532)

fern/apis/generators-yml/definition/generators.yml

@@ -222,6 +222,9 @@ types:
       title-as-schema-name: optional<boolean>
       optional-additional-properties: optional<boolean>
       coerce-enums-to-literals: optional<boolean>
+      prefer-undiscriminated-unions-with-literals: 
+        type: optional<boolean>
+        docs: Whether to prefer undiscriminated unions with literals. Defaults to false.
       object-query-parameters: 
         type: optional<boolean>
         docs: Enables parsing deep object query parameters

generators-yml.schema.json

@@ -1366,6 +1366,16 @@
             }
           ]
         },
+        "prefer-undiscriminated-unions-with-literals": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "object-query-parameters": {
           "oneOf": [
             {

packages/cli/configuration-loader/src/generators-yml/convertGeneratorsConfiguration.ts

@@ -338,7 +338,8 @@ async function parseApiConfigurationV2Schema({
                 audiences: [],
                 settings: {
                     shouldUseTitleAsName: spec.settings?.["title-as-schema-name"],
-                    shouldUseUndiscriminatedUnionsWithLiterals: undefined,
+                    shouldUseUndiscriminatedUnionsWithLiterals:
+                        spec.settings?.["prefer-undiscriminated-unions-with-literals"] ?? false,
                     asyncApiMessageNaming: undefined,
                     onlyIncludeReferencedSchemas: spec.settings?.["only-include-referenced-schemas"],
                     shouldUseOptionalAdditionalProperties: spec.settings?.["optional-additional-properties"] ?? true,

packages/cli/configuration/src/generators-yml/schemas/api/resources/generators/types/OpenApiSettingsSchema.ts

@@ -8,6 +8,8 @@ export interface OpenApiSettingsSchema {
     "title-as-schema-name"?: boolean;
     "optional-additional-properties"?: boolean;
     "coerce-enums-to-literals"?: boolean;
+    /** Whether to prefer undiscriminated unions with literals. Defaults to false. */
+    "prefer-undiscriminated-unions-with-literals"?: boolean;
     /** Enables parsing deep object query parameters */
     "object-query-parameters"?: boolean;
     /** Enables exploring readonly schemas in OpenAPI specifications */

packages/cli/configuration/src/generators-yml/schemas/serialization/resources/generators/types/OpenApiSettingsSchema.ts

@@ -15,6 +15,7 @@ export const OpenApiSettingsSchema: core.serialization.ObjectSchema<
     "title-as-schema-name": core.serialization.boolean().optional(),
     "optional-additional-properties": core.serialization.boolean().optional(),
     "coerce-enums-to-literals": core.serialization.boolean().optional(),
+    "prefer-undiscriminated-unions-with-literals": core.serialization.boolean().optional(),
     "object-query-parameters": core.serialization.boolean().optional(),
     "respect-readonly-schemas": core.serialization.boolean().optional(),
     "only-include-referenced-schemas": core.serialization.boolean().optional(),
@@ -28,6 +29,7 @@ export declare namespace OpenApiSettingsSchema {
         "title-as-schema-name"?: boolean | null;
         "optional-additional-properties"?: boolean | null;
         "coerce-enums-to-literals"?: boolean | null;
+        "prefer-undiscriminated-unions-with-literals"?: boolean | null;
         "object-query-parameters"?: boolean | null;
         "respect-readonly-schemas"?: boolean | null;
         "only-include-referenced-schemas"?: boolean | null;