Refactor code and improve test coverage

- Reordered imports in `registry.py` for consistency.
- Updated string formatting to use double quotes for consistency.
- Enhanced `_init_builtin_types` function by organizing field imports and registration.
- Improved readability of test cases by formatting data dictionaries and assertions.
- Added comprehensive tests for JSON Schema export functionality.
- Ensured backward compatibility in tests for form construction and validation.
- Cleaned up unnecessary whitespace and comments across various test files.

Author: Juan Pablo Manson

.gitignore

@@ -15,6 +15,8 @@ info
 # Agents
 CLAUDE.md
 .claude
+.agents
+knowledge.md
 
 # Caches and temps
 .uv-cache

README.md

@@ -167,11 +167,115 @@ print(dict_output)
 | `html` | Semantic HTML |
 | `html_bootstrap4` | HTML with Bootstrap 4 classes |
 | `html_bootstrap5` | HTML with Bootstrap 5 classes |
+| `json_schema` | [JSON Schema](http://json-schema.org/draft-07/schema#) (draft-07) |
 | `json` | JSON representation of the form |
 | `dict` | Python dictionary representation |
 
 HTML export can also generate a `<script>` block for basic client-side validation.
 
+### JSON Schema Export
+
+Generate a standard [JSON Schema (draft-07)](http://json-schema.org/draft-07/schema#) from any form. The resulting schema is compatible with tools like [React JSON Schema Form](https://github.com/rjsf-team/react-jsonschema-form), [Angular Formly](https://formly.dev/), and any JSON Schema validator.
+
+```python
+import json
+from codeforms import (
+    Form, TextField, EmailField, NumberField, SelectField, SelectOption,
+    CheckboxField, form_to_json_schema,
+)
+
+form = Form(
+    name="registration",
+    fields=[
+        TextField(name="name", label="Full Name", required=True, minlength=2, maxlength=100),
+        EmailField(name="email", label="Email", required=True),
+        NumberField(name="age", label="Age", min_value=18, max_value=120),
+        SelectField(
+            name="country",
+            label="Country",
+            required=True,
+            options=[
+                SelectOption(value="us", label="United States"),
+                SelectOption(value="uk", label="United Kingdom"),
+            ],
+        ),
+        CheckboxField(name="terms", label="Accept Terms", required=True),
+    ],
+)
+
+# Option 1: Direct function call
+schema = form_to_json_schema(form)
+print(json.dumps(schema, indent=2))
+
+# Option 2: Via form.export()
+result = form.export("json_schema")
+schema = result["output"]
+```
+
+Output:
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "registration",
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 100,
+      "title": "Full Name"
+    },
+    "email": {
+      "type": "string",
+      "format": "email",
+      "title": "Email"
+    },
+    "age": {
+      "type": "number",
+      "minimum": 18,
+      "maximum": 120,
+      "title": "Age"
+    },
+    "country": {
+      "type": "string",
+      "enum": ["us", "uk"],
+      "title": "Country"
+    },
+    "terms": {
+      "type": "boolean",
+      "title": "Accept Terms"
+    }
+  },
+  "required": ["name", "email", "country", "terms"],
+  "additionalProperties": false
+}
+```
+
+#### Field Type Mapping
+
+| codeforms Field | JSON Schema Type | Extra Keywords |
+|---|---|---|
+| `TextField` | `string` | `minLength`, `maxLength`, `pattern` |
+| `EmailField` | `string` (`format: "email"`) | — |
+| `NumberField` | `number` | `minimum`, `maximum`, `multipleOf` |
+| `DateField` | `string` (`format: "date"`) | — |
+| `SelectField` | `string` + `enum` | — |
+| `SelectField` (`multiple=True`) | `array` of `enum` strings | `minItems`, `maxItems`, `uniqueItems` |
+| `RadioField` | `string` + `enum` | — |
+| `CheckboxField` | `boolean` | — |
+| `CheckboxGroupField` | `array` of `enum` strings | `uniqueItems` |
+| `FileField` | `string` (`contentEncoding: "base64"`) | — |
+| `FileField` (`multiple=True`) | `array` of base64 strings | — |
+| `HiddenField` | `string` | — |
+| `UrlField` | `string` (`format: "uri"`) | `minLength`, `maxLength` |
+| `TextareaField` | `string` | `minLength`, `maxLength` |
+| `ListField` | `array` | `minItems`, `maxItems` |
+
+Field annotations like `label`, `help_text`, `default_value`, and `readonly` map to the JSON Schema keywords `title`, `description`, `default`, and `readOnly` respectively.
+
+Fields inside `FieldGroup` and `FormStep` containers are flattened into the top-level `properties` automatically.
+
 ## Internationalization (i18n)
 
 All validation and export messages are locale-aware. **English** (`en`) and **Spanish** (`es`) are included out of the box, and you can register any additional language at runtime via `register_locale()`.

examples/basic_usage.py

@@ -6,14 +6,14 @@
 """
 
 from codeforms import (
-    Form,
-    TextField,
-    EmailField,
-    SelectField,
     CheckboxField,
     CheckboxGroupField,
+    EmailField,
+    Form,
     RadioField,
+    SelectField,
     SelectOption,
+    TextField,
     ValidationRule,
     validate_form_data,
 )
@@ -205,7 +205,9 @@ def create_product_form() -> Form:
         ],
     )
 
-    contact_form.set_default_values(data={"name": "John Doe", "email": "john@example.com"})
+    contact_form.set_default_values(
+        data={"name": "John Doe", "email": "john@example.com"}
+    )
 
     # Export as Bootstrap 4 HTML
     print(contact_form.export(output_format="html_bootstrap4", id="my_form"))

examples/conditional_visibility.py

@@ -7,9 +7,9 @@
 
 from codeforms import (
     Form,
-    TextField,
     SelectField,
     SelectOption,
+    TextField,
     VisibilityRule,
     validate_form_data,
     validate_form_data_dynamic,
@@ -79,7 +79,9 @@ def create_address_form() -> Form:
     print(f"US data: success={result['success']}")
     if not result["success"]:
         print(f"  Errors: {result['errors']}")
-        print("  (Province and County are required but missing — legacy doesn't know they're hidden)")
+        print(
+            "  (Province and County are required but missing — legacy doesn't know they're hidden)"
+        )
 
     # --- Dynamic validation: respects visible_when ---
     print("\n=== Dynamic validate_form_data_dynamic (respects visible_when) ===")

examples/custom_fields.py

@@ -11,29 +11,31 @@
 from pydantic import field_validator
 
 from codeforms import (
+    EmailField,
+    FieldGroup,
     Form,
     FormFieldBase,
-    FieldGroup,
     TextField,
-    EmailField,
-    register_field_type,
     get_registered_field_types,
+    register_field_type,
 )
 
-
 # ---------------------------------------------------------------------------
 # 1. Define custom field types
 # ---------------------------------------------------------------------------
 
+
 class PhoneField(FormFieldBase):
     """A phone number field with an optional country code."""
+
     field_type: str = "phone"
     country_code: str = "+1"
     placeholder: Optional[str] = "e.g. +1-555-0100"
 
 
 class RatingField(FormFieldBase):
     """A numeric rating field with configurable range."""
+
     field_type: str = "rating"
     min_rating: int = 1
     max_rating: int = 5
@@ -49,6 +51,7 @@ def max_above_min(cls, v, info):
 
 class ColorField(FormFieldBase):
     """A colour picker field."""
+
     field_type: str = "color"
     color_format: str = "hex"  # hex | rgb | hsl
 

examples/dependent_options.py

@@ -6,10 +6,10 @@
 """
 
 from codeforms import (
+    DependentOptionsConfig,
     Form,
     SelectField,
     SelectOption,
-    DependentOptionsConfig,
 )
 
 
@@ -62,6 +62,7 @@ def create_location_form() -> Form:
 
     # La metadata de dependencia se serializa a JSON
     import json
+
     data = json.loads(form.model_dump_json(exclude_none=True))
     city_field = data["content"][1]
     print("City field dependent_options:")

examples/i18n_usage.py

@@ -6,18 +6,18 @@
 """
 
 from codeforms import (
-    Form,
-    TextField,
     EmailField,
+    Form,
     NumberField,
     SelectField,
     SelectOption,
-    validate_form_data,
-    set_locale,
-    get_locale,
+    TextField,
     get_available_locales,
+    get_locale,
     register_locale,
+    set_locale,
     t,
+    validate_form_data,
 )
 
 
@@ -90,15 +90,18 @@ def example_register_custom_locale():
     """Register a new locale (Portuguese) and use it."""
     print("=== Custom locale (Portuguese) ===")
 
-    register_locale("pt", {
-        "field.required": "Este campo é obrigatório",
-        "field.required_named": "O campo {name} é obrigatório",
-        "email.invalid": "E-mail inválido",
-        "number.min_value": "O valor deve ser maior ou igual a {min}",
-        "number.max_value": "O valor deve ser menor ou igual a {max}",
-        "form.validation_success": "Dados validados com sucesso",
-        "form.data_validation_error": "Erro na validação dos dados",
-    })
+    register_locale(
+        "pt",
+        {
+            "field.required": "Este campo é obrigatório",
+            "field.required_named": "O campo {name} é obrigatório",
+            "email.invalid": "E-mail inválido",
+            "number.min_value": "O valor deve ser maior ou igual a {min}",
+            "number.max_value": "O valor deve ser menor ou igual a {max}",
+            "form.validation_success": "Dados validados com sucesso",
+            "form.data_validation_error": "Erro na validação dos dados",
+        },
+    )
 
     set_locale("pt")
     print(f"Available locales: {get_available_locales()}")
@@ -114,9 +117,14 @@ def example_register_custom_locale():
     print(f"Email error: {result['errors'][0]['message']}")
 
     # Key not in 'pt' catalog → falls back to English
-    result = validate_form_data(form, {
-        "name": "João", "email": "a@b.com", "country": "invalid",
-    })
+    result = validate_form_data(
+        form,
+        {
+            "name": "João",
+            "email": "a@b.com",
+            "country": "invalid",
+        },
+    )
     print(f"Select error (fallback to English): {result['errors'][0]['message']}")
 
     set_locale("en")  # Restore default

examples/wizard_form.py

@@ -6,16 +6,14 @@
 """
 
 from codeforms import (
+    CheckboxField,
+    EmailField,
     Form,
     FormStep,
-    TextField,
-    EmailField,
     NumberField,
     SelectField,
     SelectOption,
-    CheckboxField,
-    FieldGroup,
-    validate_form_data_dynamic,
+    TextField,
 )
 
 
@@ -85,35 +83,45 @@ def create_registration_wizard() -> Form:
     for i, step in enumerate(form.get_steps()):
         print(f"\n  Step {i + 1}: {step.title}")
         for field in step.fields:
-            print(f"    - {field.name} ({'required' if field.required else 'optional'})")
+            print(
+                f"    - {field.name} ({'required' if field.required else 'optional'})"
+            )
 
     # Validar paso 1
     print("\n--- Validating Step 1 ---")
-    result = form.validate_step(0, {
-        "first_name": "John",
-        "last_name": "Doe",
-        "email": "john@example.com",
-    })
+    result = form.validate_step(
+        0,
+        {
+            "first_name": "John",
+            "last_name": "Doe",
+            "email": "john@example.com",
+        },
+    )
     print(f"Step 1 valid: {result['success']}")
 
     # Validar paso 2
     print("\n--- Validating Step 2 ---")
-    result = form.validate_step(1, {
-        "plan": "pro",
-        "team_size": 5,
-    })
+    result = form.validate_step(
+        1,
+        {
+            "plan": "pro",
+            "team_size": 5,
+        },
+    )
     print(f"Step 2 valid: {result['success']}")
 
     # Validar todos los pasos
     print("\n--- Validating All Steps ---")
-    result = form.validate_all_steps({
-        "first_name": "John",
-        "last_name": "Doe",
-        "email": "john@example.com",
-        "plan": "pro",
-        "team_size": 5,
-        "terms": True,
-    })
+    result = form.validate_all_steps(
+        {
+            "first_name": "John",
+            "last_name": "Doe",
+            "email": "john@example.com",
+            "plan": "pro",
+            "team_size": 5,
+            "terms": True,
+        }
+    )
     print(f"All steps valid: {result['success']}")
 
     # Exportar HTML