docs: update CLI reference documentation and prompt data

🤖 Generated by GitHub Actions

Author: github-actions[bot]

docs/cli-reference/general-options.md

@@ -6,6 +6,7 @@
 |--------|-------------|
 | [`--all-exports-collision-strategy`](#all-exports-collision-strategy) | Handle name collisions when exporting recursive module hiera... |
 | [`--all-exports-scope`](#all-exports-scope) | Generate __all__ exports for child modules in __init__.py fi... |
+| [`--allow-remote-refs`](#allow-remote-refs) | Enable fetching of `$ref` targets over HTTP/HTTPS. |
 | [`--check`](#check) | Verify generated code matches existing output without modify... |
 | [`--disable-warnings`](#disable-warnings) | Suppress warning messages during code generation. |
 | [`--generate-cli-command`](#generate-cli-command) | Generate CLI command from pyproject.toml configuration. |
@@ -1161,6 +1162,94 @@ Use 'recursive' to include all descendant exports with collision handling.
 
 ---
 
+## `--allow-remote-refs` {#allow-remote-refs}
+
+Enable fetching of `$ref` targets over HTTP/HTTPS.
+
+When enabled, the generator will resolve `$ref` references that point to remote URLs,
+including relative refs resolved against a schema's `$id` base URL. This is required
+for schemas that reference definitions hosted on external servers.
+
+Automatically enabled when using `--url` input.
+
+!!! tip "Usage"
+
+    ```bash
+    datamodel-codegen --input schema.json --allow-remote-refs # (1)!
+    ```
+
+    1. :material-arrow-left: `--allow-remote-refs` - the option documented here
+
+??? example "Examples"
+
+    **Input Schema:**
+
+    ```json
+    {
+      "$id": "https://example.com/root_id.json",
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "definitions": {
+        "Person": {
+          "$ref": "person.json"
+        },
+        "OriginalPerson": {
+          "$ref": "person.json"
+        },
+        "Pet": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "examples": ["dog", "cat"]
+            },
+            "owner": {
+               "$ref": "person.json"
+            }
+          }
+        }
+      }
+    }
+    ```
+
+    **Output:**
+
+    ```python
+    # generated by datamodel-codegen:
+    #   filename:  root_id.json
+    #   timestamp: 2019-07-26T00:00:00+00:00
+    
+    from __future__ import annotations
+    
+    from typing import Any
+    
+    from pydantic import BaseModel, Field, RootModel, conint
+    
+    
+    class Model(RootModel[Any]):
+        root: Any
+    
+    
+    class Person(BaseModel):
+        firstName: str | None = Field(None, description="The person's first name.")
+        lastName: str | None = Field(None, description="The person's last name.")
+        age: conint(ge=0) | None = Field(
+            None, description='Age in years which must be equal to or greater than zero.'
+        )
+        friends: list[Any] | None = None
+        comment: None = None
+    
+    
+    class OriginalPerson(RootModel[Person]):
+        root: Person
+    
+    
+    class Pet(BaseModel):
+        name: str | None = Field(None, examples=['dog', 'cat'])
+        owner: Person | None = None
+    ```
+
+---
+
 ## `--check` {#check}
 
 Verify generated code matches existing output without modifying files.

docs/cli-reference/index.md

@@ -15,7 +15,7 @@ This documentation is auto-generated from test cases.
 | 🎨 [Template Customization](template-customization.md) | 21 | Output formatting and custom rendering |
 | 📘 [OpenAPI-only Options](openapi-only-options.md) | 7 | OpenAPI-specific features |
 | 📋 [GraphQL-only Options](graphql-only-options.md) | 1 |  |
-| ⚙️ [General Options](general-options.md) | 15 | Utilities and meta options |
+| ⚙️ [General Options](general-options.md) | 16 | Utilities and meta options |
 | 📝 [Utility Options](utility-options.md) | 6 | Help, version, debug options |
 
 ## All Options
@@ -33,6 +33,7 @@ This documentation is auto-generated from test cases.
 - [`--allof-merge-mode`](typing-customization.md#allof-merge-mode)
 - [`--allow-extra-fields`](model-customization.md#allow-extra-fields)
 - [`--allow-population-by-field-name`](model-customization.md#allow-population-by-field-name)
+- [`--allow-remote-refs`](general-options.md#allow-remote-refs)
 
 ### B {#b}
 

docs/cli-reference/quick-reference.md

@@ -184,6 +184,7 @@ datamodel-codegen [OPTIONS]
 |--------|-------------|
 | [`--all-exports-collision-strategy`](general-options.md#all-exports-collision-strategy) | Handle name collisions when exporting recursive module hierarchies. |
 | [`--all-exports-scope`](general-options.md#all-exports-scope) | Generate __all__ exports for child modules in __init__.py files. |
+| [`--allow-remote-refs`](general-options.md#allow-remote-refs) | Enable fetching of `$ref` targets over HTTP/HTTPS. |
 | [`--check`](general-options.md#check) | Verify generated code matches existing output without modifying files. |
 | [`--disable-warnings`](general-options.md#disable-warnings) | Suppress warning messages during code generation. |
 | [`--generate-cli-command`](general-options.md#generate-cli-command) | Generate CLI command from pyproject.toml configuration. |
@@ -223,6 +224,7 @@ All options sorted alphabetically:
 - [`--allof-merge-mode`](typing-customization.md#allof-merge-mode) - Merge constraints from root model references in allOf schema...
 - [`--allow-extra-fields`](model-customization.md#allow-extra-fields) - Allow extra fields in generated Pydantic models (extra='allo...
 - [`--allow-population-by-field-name`](model-customization.md#allow-population-by-field-name) - Allow Pydantic model population by field name (not just alia...
+- [`--allow-remote-refs`](general-options.md#allow-remote-refs) - Enable fetching of `$ref` targets over HTTP/HTTPS.
 - [`--base-class`](model-customization.md#base-class) - Specify a custom base class for generated models.
 - [`--base-class-map`](model-customization.md#base-class-map) - Specify different base classes for specific models via JSON ...
 - [`--capitalize-enum-members`](field-customization.md#capitalize-enum-members) - Capitalize enum member names to UPPER_CASE format.

src/datamodel_code_generator/prompt_data.py

@@ -15,6 +15,7 @@
     "--allof-merge-mode": "Merge constraints from root model references in allOf schemas.",
     "--allow-extra-fields": "Allow extra fields in generated Pydantic models (extra='allow').",
     "--allow-population-by-field-name": "Allow Pydantic model population by field name (not just alias).",
+    "--allow-remote-refs": "Enable fetching of `$ref` targets over HTTP/HTTPS.",
     "--base-class": "Specify a custom base class for generated models.",
     "--base-class-map": "Specify different base classes for specific models via JSON mapping.",
     "--capitalize-enum-members": "Capitalize enum member names to UPPER_CASE format.",