Add schema_features property to parsers for version detection (#2929)

* Add schema_features property to parsers for version detection

* Add version-specific schema processing using schema_features (#2934)

* Add --jsonschema-version and --openapi-version CLI options

* Add --schema-version and --schema-version-mode CLI options

* Regenerate CLI docs

* Add version-specific schema processing using schema_features

* Implement flag-based behavior control for schema version

* Add comprehensive version-specific feature checks with exclusive_as_number flag

* Replace getattr with direct config access for schema_version_mode

* docs: update llms.txt files

Generated by GitHub Actions

* docs: update CLI reference documentation and prompt data

🤖 Generated by GitHub Actions

* Add SchemaFeaturesT generic type parameter to Parser

* Fix test snapshot: add exclusive_as_number field

* Refactor: genericize _create_default_config using _get_config_class

* Add parameterized e2e tests for --schema-version and --schema-version-mode

* docs: update CLI reference documentation and prompt data

🤖 Generated by GitHub Actions

* docs: update llms.txt files

Generated by GitHub Actions

* Refactor: use _config_class_name class variable instead of method override

* docs: update CLI reference documentation and prompt data

🤖 Generated by GitHub Actions

* docs: update llms.txt files

Generated by GitHub Actions

* Add Schema Version Support to docs navigation

* docs: update llms.txt files

Generated by GitHub Actions

* Docs: add detailed unsupported features tables

* docs: update llms.txt files

Generated by GitHub Actions

* Docs: add version info to unsupported features tables

* docs: update llms.txt files

Generated by GitHub Actions

* Add e2e tests for schema version error handling and strict mode warnings

---------

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

Author: koxudaxi

docs/cli-reference/base-options.md

@@ -10,6 +10,8 @@
 | [`--input-model`](#input-model) | Import a Python type or dict schema from a module. |
 | [`--input-model-ref-strategy`](#input-model-ref-strategy) | Strategy for referenced types when using --input-model. |
 | [`--output`](#output) | Specify the destination path for generated Python code. |
+| [`--schema-version`](#schema-version) | Schema version to use for parsing. |
+| [`--schema-version-mode`](#schema-version-mode) | Schema version validation mode. |
 | [`--url`](#url) | Fetch schema from URL with custom HTTP headers. |
 
 ---
@@ -326,6 +328,290 @@ is written to stdout.
 
 ---
 
+## `--schema-version` {#schema-version}
+
+Schema version to use for parsing.
+
+The `--schema-version` option specifies the schema version to use instead of auto-detection.
+Valid values depend on input type: JsonSchema (draft-04, draft-06, draft-07, 2019-09, 2020-12)
+or OpenAPI (3.0, 3.1). Default is 'auto' (detected from $schema or openapi field).
+
+!!! tip "Usage"
+
+    ```bash
+    datamodel-codegen --input schema.json --schema-version draft-07 # (1)!
+    ```
+
+    1. :material-arrow-left: `--schema-version` - the option documented here
+
+??? example "Examples"
+
+    === "OpenAPI"
+
+        **Input Schema:**
+
+        ```yaml
+        openapi: "3.0.0"
+        info:
+          version: 1.0.0
+          title: Swagger Petstore
+          license:
+            name: MIT
+        servers:
+          - url: http://petstore.swagger.io/v1
+        paths:
+          /pets:
+            get:
+              summary: List all pets
+              operationId: listPets
+              tags:
+                - pets
+              parameters:
+                - name: limit
+                  in: query
+                  description: How many items to return at one time (max 100)
+                  required: false
+                  schema:
+                    type: integer
+                    format: int32
+              responses:
+                '200':
+                  description: A paged array of pets
+                  headers:
+                    x-next:
+                      description: A link to the next page of responses
+                      schema:
+                        type: string
+                  content:
+                    application/json:
+                      schema:
+                        $ref: "#/components/schemas/Pets"
+                default:
+                  description: unexpected error
+                  content:
+                    application/json:
+                      schema:
+                        $ref: "#/components/schemas/Error"
+                        x-amazon-apigateway-integration:
+                          uri:
+                            Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${PythonVersionFunction.Arn}/invocations
+                          passthroughBehavior: when_no_templates
+                          httpMethod: POST
+                          type: aws_proxy
+            post:
+              summary: Create a pet
+              operationId: createPets
+              tags:
+                - pets
+              responses:
+                '201':
+                  description: Null response
+                default:
+                  description: unexpected error
+                  content:
+                    application/json:
+                      schema:
+                        $ref: "#/components/schemas/Error"
+                        x-amazon-apigateway-integration:
+                          uri:
+                            Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${PythonVersionFunction.Arn}/invocations
+                          passthroughBehavior: when_no_templates
+                          httpMethod: POST
+                          type: aws_proxy
+          /pets/{petId}:
+            get:
+              summary: Info for a specific pet
+              operationId: showPetById
+              tags:
+                - pets
+              parameters:
+                - name: petId
+                  in: path
+                  required: true
+                  description: The id of the pet to retrieve
+                  schema:
+                    type: string
+              responses:
+                '200':
+                  description: Expected response to a valid request
+                  content:
+                    application/json:
+                      schema:
+                        $ref: "#/components/schemas/Pets"
+                default:
+                  description: unexpected error
+                  content:
+                    application/json:
+                      schema:
+                        $ref: "#/components/schemas/Error"
+            x-amazon-apigateway-integration:
+              uri:
+                Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${PythonVersionFunction.Arn}/invocations
+              passthroughBehavior: when_no_templates
+              httpMethod: POST
+              type: aws_proxy
+        components:
+          schemas:
+            Pet:
+              required:
+                - id
+                - name
+              properties:
+                id:
+                  type: integer
+                  format: int64
+                  default: 1
+                name:
+                  type: string
+                tag:
+                  type: string
+            Pets:
+              type: array
+              items:
+                $ref: "#/components/schemas/Pet"
+            Users:
+              type: array
+              items:
+                required:
+                  - id
+                  - name
+                properties:
+                  id:
+                    type: integer
+                    format: int64
+                  name:
+                    type: string
+                  tag:
+                    type: string
+            Id:
+              type: string
+            Rules:
+              type: array
+              items:
+                type: string
+            Error:
+              description: error result
+              required:
+                - code
+                - message
+              properties:
+                code:
+                  type: integer
+                  format: int32
+                message:
+                  type: string
+            apis:
+              type: array
+              items:
+                type: object
+                properties:
+                  apiKey:
+                    type: string
+                    description: To be used as a dataset parameter value
+                  apiVersionNumber:
+                    type: string
+                    description: To be used as a version parameter value
+                  apiUrl:
+                    type: string
+                    format: uri
+                    description: "The URL describing the dataset's fields"
+                  apiDocumentationUrl:
+                    type: string
+                    format: uri
+                    description: A URL to the API console for each API
+            Event:
+              type: object
+              description: Event object
+              properties:
+                name:
+                  type: string
+            Result:
+                type: object
+                properties:
+                  event:
+                    $ref: '#/components/schemas/Event'
+        ```
+
+        **Output:**
+
+        > **Error:** File not found: openapi/api.py
+
+    === "JSON Schema"
+
+        **Input Schema:**
+
+        ```json
+        {
+          "$schema": "http://json-schema.org/draft-07/schema",
+          "type": "object",
+          "properties": {"s": {"type": ["string"]}},
+          "required": ["s"]
+        }
+        ```
+
+        **Output:**
+
+        ```python
+        # generated by datamodel-codegen:
+        #   filename:  simple_string.json
+        
+        from __future__ import annotations
+        
+        from pydantic import BaseModel
+        
+        
+        class Model(BaseModel):
+            s: str
+        ```
+
+---
+
+## `--schema-version-mode` {#schema-version-mode}
+
+Schema version validation mode.
+
+The `--schema-version-mode` option controls how schema version validation is performed.
+'lenient' (default): accept all features regardless of version.
+'strict': warn on features outside the declared/detected version.
+
+!!! tip "Usage"
+
+    ```bash
+    datamodel-codegen --input schema.json --schema-version-mode lenient # (1)!
+    ```
+
+    1. :material-arrow-left: `--schema-version-mode` - the option documented here
+
+??? example "Examples"
+
+    **Input Schema:**
+
+    ```json
+    {
+      "$schema": "http://json-schema.org/draft-07/schema",
+      "type": "object",
+      "properties": {"s": {"type": ["string"]}},
+      "required": ["s"]
+    }
+    ```
+
+    **Output:**
+
+    ```python
+    # generated by datamodel-codegen:
+    #   filename:  simple_string.json
+    
+    from __future__ import annotations
+    
+    from pydantic import BaseModel
+    
+    
+    class Model(BaseModel):
+        s: str
+    ```
+
+---
+
 ## `--url` {#url}
 
 Fetch schema from URL with custom HTTP headers.

docs/cli-reference/index.md

@@ -8,7 +8,7 @@ This documentation is auto-generated from test cases.
 
 | Category | Options | Description |
 |----------|---------|-------------|
-| 📁 [Base Options](base-options.md) | 7 | Input/output configuration |
+| 📁 [Base Options](base-options.md) | 9 | Input/output configuration |
 | 🔧 [Typing Customization](typing-customization.md) | 27 | Type annotation and import behavior |
 | 🏷️ [Field Customization](field-customization.md) | 24 | Field naming and docstring behavior |
 | 🏗️ [Model Customization](model-customization.md) | 39 | Model generation behavior |
@@ -161,6 +161,8 @@ This documentation is auto-generated from test cases.
 
 ### S {#s}
 
+- [`--schema-version`](base-options.md#schema-version)
+- [`--schema-version-mode`](base-options.md#schema-version-mode)
 - [`--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)

docs/cli-reference/quick-reference.md

@@ -22,6 +22,8 @@ datamodel-codegen [OPTIONS]
 | [`--input-model`](base-options.md#input-model) | Import a Python type or dict schema from a module. |
 | [`--input-model-ref-strategy`](base-options.md#input-model-ref-strategy) | Strategy for referenced types when using --input-model. |
 | [`--output`](base-options.md#output) | Specify the destination path for generated Python code. |
+| [`--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. |
 | [`--url`](base-options.md#url) | Fetch schema from URL with custom HTTP headers. |
 
 ### 🔧 Typing Customization
@@ -299,6 +301,8 @@ All options sorted alphabetically:
 - [`--remove-special-field-name-prefix`](field-customization.md#remove-special-field-name-prefix) - Remove the special prefix from field names.
 - [`--reuse-model`](model-customization.md#reuse-model) - Reuse identical model definitions instead of generating dupl...
 - [`--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.
 - [`--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...