docs: sync generated docs (#3148)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: dcg-generated-docs[bot]

docs/cli-reference/field-customization.md

@@ -2014,10 +2014,20 @@ or validation aliases while using separate output-only names for serialization.
                   "type": "string"
                 }
               },
-              "required": ["known-name", "missing-required", "plain-missing"]
+              "required": [
+                "known-name",
+                "missing-required",
+                "plain-missing",
+                "allof-unmapped"
+              ]
             }
           ],
-          "required": ["known-name", "missing-required", "plain-missing"]
+          "required": [
+            "known-name",
+            "missing-required",
+            "plain-missing",
+            "allof-unmapped"
+          ]
         },
         "RequiredOnlyGrandBase": {
           "type": "object",
@@ -2173,6 +2183,7 @@ or validation aliases while using separate output-only names for serialization.
         plainMissingInput: Any = Field(
             ..., alias='plain-missing', serialization_alias='plainMissing'
         )
+        allof_unmapped: Any = Field(..., alias='allof-unmapped')
 
 
     class RequiredOnlyGrandBase(BaseModel):
@@ -2192,6 +2203,7 @@ or validation aliases while using separate output-only names for serialization.
             validation_alias=AliasChoices('grand-name', 'grandInput'),
         )
         bare_name: Any = Field(..., alias='bare-name', serialization_alias='bareName')
+        ignored_missing: Any = Field(..., alias='ignored-missing')
         refMissingInput: Any = Field(
             ...,
             serialization_alias='refMissingRequired',

docs/llms-full.txt

@@ -245,7 +245,7 @@ This documentation is auto-generated from test cases.
 |----------|---------|-------------|
 | 📁 [Base Options](base-options.md) | 10 | Input/output configuration |
 | 🔧 [Typing Customization](typing-customization.md) | 29 | Type annotation and import behavior |
-| 🏷️ [Field Customization](field-customization.md) | 25 | Field naming and docstring behavior |
+| 🏷️ [Field Customization](field-customization.md) | 26 | Field naming and docstring behavior |
 | 🏗️ [Model Customization](model-customization.md) | 39 | Model generation behavior |
 | 🎨 [Template Customization](template-customization.md) | 21 | Output formatting and custom rendering |
 | 📘 [OpenAPI-only Options](openapi-only-options.md) | 7 | OpenAPI-specific features |
@@ -403,6 +403,7 @@ This documentation is auto-generated from test cases.
 
 - [`--schema-version`](base-options.md#schema-version)
 - [`--schema-version-mode`](base-options.md#schema-version-mode)
+- [`--serialization-aliases`](field-customization.md#serialization-aliases)
 - [`--set-default-enum-member`](field-customization.md#set-default-enum-member)
 - [`--shared-module-name`](general-options.md#shared-module-name)
 - [`--skip-root-model`](model-customization.md#skip-root-model)
@@ -7481,6 +7482,7 @@ Source: https://datamodel-code-generator.koxudaxi.dev/cli-reference/field-custom
 | [`--no-alias`](#no-alias) | Disable Field alias generation for non-Python-safe property ... |
 | [`--original-field-name-delimiter`](#original-field-name-delimiter) | Specify delimiter for original field names when using snake-... |
 | [`--remove-special-field-name-prefix`](#remove-special-field-name-prefix) | Remove the special prefix from field names. |
+| [`--serialization-aliases`](#serialization-aliases) | Apply custom Pydantic v2 serialization aliases from JSON fil... |
 | [`--set-default-enum-member`](#set-default-enum-member) | Set the first enum member as the default value for enum fiel... |
 | [`--snake-case-field`](#snake-case-field) | Convert field names to snake_case format. |
 | [`--special-field-name-prefix`](#special-field-name-prefix) | Prefix to add to special field names (like reserved keywords... |
@@ -9415,6 +9417,306 @@ The `--remove-special-field-name-prefix` flag configures the code generation beh
 
 ---
 
+## `--serialization-aliases` {#serialization-aliases}
+
+Apply custom Pydantic v2 serialization aliases from JSON file.
+
+The `--serialization-aliases` option lets Pydantic v2 models keep input aliases
+or validation aliases while using separate output-only names for serialization.
+
+!!! tip "Usage"
+
+    ```bash
+    datamodel-codegen --input schema.json --aliases aliases/serialization_aliases.json --serialization-aliases aliases/serialization_aliases_output.json --output-model-type pydantic_v2.BaseModel # (1)!
+    ```
+
+    1. :material-arrow-left: `--serialization-aliases` - the option documented here
+
+??? example "Examples"
+
+    **Input Schema:**
+
+    ```json
+    {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "title": "Messaging",
+      "type": "object",
+      "definitions": {
+        "SendMessageV2": {
+          "type": "object",
+          "properties": {
+            "textMessage": {
+              "type": "string"
+            }
+          },
+          "required": ["textMessage"]
+        },
+        "OtherMessage": {
+          "type": "object",
+          "properties": {
+            "other-name": {
+              "type": "string"
+            }
+          },
+          "required": ["other-name"]
+        },
+        "SameNameMessage": {
+          "type": "object",
+          "properties": {
+            "same-name": {
+              "type": "string"
+            }
+          },
+          "required": ["same-name"]
+        },
+        "RequiredOnlyMessage": {
+          "type": "object",
+          "allOf": [
+            {
+              "type": "object",
+              "properties": {
+                "known-name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "known-name",
+                "missing-required",
+                "plain-missing",
+                "allof-unmapped"
+              ]
+            }
+          ],
+          "required": [
+            "known-name",
+            "missing-required",
+            "plain-missing",
+            "allof-unmapped"
+          ]
+        },
+        "RequiredOnlyGrandBase": {
+          "type": "object",
+          "properties": {
+            "grand-name": {
+              "type": "integer"
+            },
+            "bare-name": {}
+          },
+          "required": ["grand-name", "bare-name"]
+        },
+        "RequiredOnlyBase": {
+          "type": "object",
+          "properties": {
+            "base-name": {
+              "type": "string"
+            }
+          },
+          "allOf": [
+            {
+              "$ref": "#/definitions/RequiredOnlyGrandBase"
+            }
+          ],
+          "required": ["base-name"]
+        },
+        "RequiredOnlyRefMessage": {
+          "type": "object",
+          "properties": {
+            "own-name": {
+              "type": "string"
+            }
+          },
+          "allOf": [
+            {
+              "$ref": "#/definitions/RequiredOnlyBase"
+            }
+          ],
+          "required": [
+            "own-name",
+            "grand-name",
+            "bare-name",
+            "ignored-missing",
+            "ref-missing-required",
+            "ref-plain-missing"
+          ]
+        },
+        "RequiredOnlyEmptyAllOfBase": {
+          "type": "object",
+          "allOf": [
+            {
+              "type": "object"
+            }
+          ]
+        },
+        "RequiredOnlyEmptyAllOfMessage": {
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/RequiredOnlyEmptyAllOfBase"
+            }
+          ],
+          "required": ["empty-missing"]
+        },
+        "RequiredOnlyRecursiveEmptyGrandBase": {
+          "type": "object",
+          "properties": {
+            "unrelated-name": {
+              "type": "string"
+            }
+          }
+        },
+        "RequiredOnlyRecursiveEmptyBase": {
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/RequiredOnlyRecursiveEmptyGrandBase"
+            }
+          ]
+        },
+        "RequiredOnlyRecursiveEmptyMessage": {
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/RequiredOnlyRecursiveEmptyBase"
+            }
+          ],
+          "required": ["recursive-missing"]
+        }
+      },
+      "properties": {
+        "send": {
+          "$ref": "#/definitions/SendMessageV2"
+        },
+        "other": {
+          "$ref": "#/definitions/OtherMessage"
+        },
+        "same": {
+          "$ref": "#/definitions/SameNameMessage"
+        },
+        "requiredOnly": {
+          "$ref": "#/definitions/RequiredOnlyMessage"
+        },
+        "requiredOnlyRef": {
+          "$ref": "#/definitions/RequiredOnlyRefMessage"
+        },
+        "requiredOnlyEmptyAllOf": {
+          "$ref": "#/definitions/RequiredOnlyEmptyAllOfMessage"
+        },
+        "requiredOnlyRecursiveEmpty": {
+          "$ref": "#/definitions/RequiredOnlyRecursiveEmptyMessage"
+        }
+      }
+    }
+    ```
+
+    **Output:**
+
+    ```python
+    # generated by datamodel-codegen:
+    #   filename:  serialization_aliases.json
+    #   timestamp: 2019-07-26T00:00:00+00:00
+
+    from __future__ import annotations
+
+    from typing import Any
+
+    from pydantic import AliasChoices, BaseModel, Field
+
+
+    class SendMessageV2(BaseModel):
+        message: str = Field(
+            ...,
+            serialization_alias='messageText',
+            validation_alias=AliasChoices('textMessage', 'message', 'text'),
+        )
+
+
+    class OtherMessage(BaseModel):
+        other_name: str = Field(..., alias='other-name', serialization_alias='otherName')
+
+
+    class SameNameMessage(BaseModel):
+        same_name: str = Field(..., alias='same-name', serialization_alias='same_name')
+
+
+    class RequiredOnlyMessage(BaseModel):
+        known_name: str = Field(..., alias='known-name')
+        missingRequiredInput: Any = Field(
+            ...,
+            serialization_alias='missingRequired',
+            validation_alias=AliasChoices('missing-required', 'missingRequiredInput'),
+        )
+        plainMissingInput: Any = Field(
+            ..., alias='plain-missing', serialization_alias='plainMissing'
+        )
+        allof_unmapped: Any = Field(..., alias='allof-unmapped')
+
+
+    class RequiredOnlyGrandBase(BaseModel):
+        grand_name: int = Field(..., alias='grand-name')
+        bare_name: Any = Field(..., alias='bare-name')
+
+
+    class RequiredOnlyBase(RequiredOnlyGrandBase):
+        base_name: str = Field(..., alias='base-name')
+
+
+    class RequiredOnlyRefMessage(RequiredOnlyBase):
+        own_name: str = Field(..., alias='own-name')
+        grand_name: int = Field(
+            ...,
+            serialization_alias='grandName',
+            validation_alias=AliasChoices('grand-name', 'grandInput'),
+        )
+        bare_name: Any = Field(..., alias='bare-name', serialization_alias='bareName')
+        ignored_missing: Any = Field(..., alias='ignored-missing')
+        refMissingInput: Any = Field(
+            ...,
+            serialization_alias='refMissingRequired',
+            validation_alias=AliasChoices('ref-missing-required', 'refMissingInput'),
+        )
+        refPlainMissingInput: Any = Field(
+            ..., alias='ref-plain-missing', serialization_alias='refPlainMissing'
+        )
+
+
+    class RequiredOnlyEmptyAllOfBase(BaseModel):
+        pass
+
+
+    class RequiredOnlyEmptyAllOfMessage(RequiredOnlyEmptyAllOfBase):
+        emptyMissingInput: Any = Field(
+            ...,
+            serialization_alias='emptyMissing',
+            validation_alias=AliasChoices('empty-missing', 'emptyMissingInput'),
+        )
+
+
+    class RequiredOnlyRecursiveEmptyGrandBase(BaseModel):
+        unrelated_name: str | None = Field(None, alias='unrelated-name')
+
+
+    class RequiredOnlyRecursiveEmptyBase(RequiredOnlyRecursiveEmptyGrandBase):
+        pass
+
+
+    class RequiredOnlyRecursiveEmptyMessage(RequiredOnlyRecursiveEmptyBase):
+        recursiveMissingInput: Any = Field(
+            ..., alias='recursive-missing', serialization_alias='recursiveMissing'
+        )
+
+
+    class Messaging(BaseModel):
+        send: SendMessageV2 | None = None
+        other: OtherMessage | None = None
+        same: SameNameMessage | None = None
+        requiredOnly: RequiredOnlyMessage | None = None
+        requiredOnlyRef: RequiredOnlyRefMessage | None = None
+        requiredOnlyEmptyAllOf: RequiredOnlyEmptyAllOfMessage | None = None
+        requiredOnlyRecursiveEmpty: RequiredOnlyRecursiveEmptyMessage | None = None
+    ```
+
+---
+
 ## `--set-default-enum-member` {#set-default-enum-member}
 
 Set the first enum member as the default value for enum fields.
@@ -24114,6 +24416,7 @@ datamodel-codegen [OPTIONS]
 | [`--no-alias`](field-customization.md#no-alias) | Disable Field alias generation for non-Python-safe property names. |
 | [`--original-field-name-delimiter`](field-customization.md#original-field-name-delimiter) | Specify delimiter for original field names when using snake-case conversion. |
 | [`--remove-special-field-name-prefix`](field-customization.md#remove-special-field-name-prefix) | Remove the special prefix from field names. |
+| [`--serialization-aliases`](field-customization.md#serialization-aliases) | Apply custom Pydantic v2 serialization aliases from JSON file. |
 | [`--set-default-enum-member`](field-customization.md#set-default-enum-member) | Set the first enum member as the default value for enum fields. |
 | [`--snake-case-field`](field-customization.md#snake-case-field) | Convert field names to snake_case format. |
 | [`--special-field-name-prefix`](field-customization.md#special-field-name-prefix) | Prefix to add to special field names (like reserved keywords). |
@@ -24352,6 +24655,7 @@ All options sorted alphabetically:
 - [`--reuse-scope`](model-customization.md#reuse-scope) - Scope for model reuse detection (root or tree).
 - [`--schema-version`](base-options.md#schema-version) - Schema version to use for parsing.
 - [`--schema-version-mode`](base-options.md#schema-version-mode) - Schema version validation mode.
+- [`--serialization-aliases`](field-customization.md#serialization-aliases) - Apply custom Pydantic v2 serialization aliases from JSON fil...
 - [`--set-default-enum-member`](field-customization.md#set-default-enum-member) - Set the first enum member as the default value for enum fiel...
 - [`--shared-module-name`](general-options.md#shared-module-name) - Customize the name of the shared module for deduplicated mod...
 - [`--skip-root-model`](model-customization.md#skip-root-model) - Skip generation of root model when schema contains nested de...

src/datamodel_code_generator/prompt_data.py

@@ -100,8 +100,8 @@
     "--reuse-scope": "Scope for model reuse detection (root or tree).",
     "--schema-version": "Schema version to use for parsing.",
     "--schema-version-mode": "Schema version validation mode.",
-    "--set-default-enum-member": "Set the first enum member as the default value for enum fields.",
     "--serialization-aliases": "Apply custom Pydantic v2 serialization aliases from JSON file.",
+    "--set-default-enum-member": "Set the first enum member as the default value for enum fields.",
     "--shared-module-name": "Customize the name of the shared module for deduplicated models.",
     "--skip-root-model": "Skip generation of root model when schema contains nested definitions.",
     "--snake-case-field": "Convert field names to snake_case format.",