Method mergeSchemas

src/core/SpecProcessor.ts:165–206

* Merges multiple schemas into one * @param schemas The schemas to merge * @returns The merged schema

(schemas: SchemaOrRef[])

   * @returns The merged schema
   */
  private mergeSchemas(schemas: SchemaOrRef[]): SchemaObject {
    const merged: SchemaObject = {
      type: "object",
      properties: {},
      required: [] as string[],
    };

    for (const schema of schemas) {
      if (!this.isSchemaObject(schema)) continue;

      // Merge properties
      if (schema.properties) {
        merged.properties = {
          ...merged.properties,
          ...schema.properties,
        };
      }

      // Merge required fields
      if (schema.required) {
        const requiredSet = new Set([
          ...(merged.required || []),
          ...schema.required,
        ]);
        merged.required = Array.from(requiredSet);
      }

      // Merge other fields
      for (const [key, value] of Object.entries(schema)) {
        if (key !== "properties" && key !== "required" && key !== "type") {
          (merged as any)[key] = value;
        }
      }
    }

    // Clean up empty arrays
    if (merged.required?.length === 0) {
      delete merged.required;
    }

    return merged;
  }

  /**
   * Type guard to check if a schema is a SchemaObject (not a ReferenceObject)