feat: phone format (###) ###-#### + discard-draft UX on submission detail (v0.37.11)

Phone field:
- Enforce (###) ###-#### format with optional +## country-code prefix
- Updated HTML pattern, RegexValidator, placeholder, and error message
- Applied to both DynamicForm.add_field and ApprovalStepForm._create_field

Discard draft:
- submission_detail.html now shows Continue Editing + Discard Draft
  action buttons when the viewing user owns a draft submission
- Links to existing form_submit and discard_draft views respectively

Bump version 0.37.10 → 0.37.11

Author: matteius

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.11] - 2026-03-27
+
+### Added
+- **Phone field format** — `phone` field type now enforces the `(###) ###-####` format with an optional international country-code prefix (`+## `). The HTML `pattern` attribute, the server-side `RegexValidator`, the placeholder, and the error message all reflect the new format. Valid examples: `(555) 867-5309`, `+1 (555) 867-5309`, `+44 (555) 867-5309`.
+- **Discard Draft on submission detail page** — when a user views their own draft via `submission_detail`, the action bar now shows a **Continue Editing** button (links back to the form to resume editing) and a **Discard Draft** button (links to the existing confirmation page at `submissions/<id>/discard/`). Both buttons are only shown when `submission.submitter == user`.
+
 ## [0.37.10] - 2026-03-27
 
 ### Added

django_forms_workflows/forms.py

@@ -342,11 +342,15 @@ def add_field(self, field_def, initial_data):
             )
 
         elif field_def.field_type == "phone":
+            # Format: optional country code (+## ) then (###) ###-####
+            # Examples: (555) 867-5309  |  +1 (555) 867-5309  |  +44 (555) 867-5309
+            _phone_pattern = r"(\+[0-9]{1,3} )?\([0-9]{3}\) [0-9]{3}-[0-9]{4}"
             widget_attrs.update(
                 {
                     "type": "tel",
                     "inputmode": "tel",
-                    "pattern": r"[+]?[(]?[0-9]{3}[)]?[-\s.]?[0-9]{3}[-\s.]?[0-9]{4,6}",
+                    "pattern": _phone_pattern,
+                    "placeholder": widget_attrs.get("placeholder", "(555) 867-5309"),
                 }
             )
             field = forms.CharField(
@@ -356,8 +360,11 @@ def add_field(self, field_def, initial_data):
             )
             field.validators.append(
                 RegexValidator(
-                    regex=r"^\+?[(]?[0-9]{3}[)]?[-\s.]?[0-9]{3}[-\s.]?[0-9]{4,6}$",
-                    message="Enter a valid phone number (e.g. 555-555-5555 or +1 555 555 5555).",
+                    regex=r"^(\+[0-9]{1,3} )?\([0-9]{3}\) [0-9]{3}-[0-9]{4}$",
+                    message=(
+                        "Enter a phone number in the format (555) 867-5309 "
+                        "or +1 (555) 867-5309 for international numbers."
+                    ),
                 )
             )
             self.fields[field_def.field_name] = field
@@ -1141,11 +1148,14 @@ def _create_field(self, field_def, field_args, widget_attrs, is_editable):
             )
 
         elif field_def.field_type == "phone":
+            # Format: optional country code (+## ) then (###) ###-####
+            _phone_pattern = r"(\+[0-9]{1,3} )?\([0-9]{3}\) [0-9]{3}-[0-9]{4}"
             widget_attrs.update(
                 {
                     "type": "tel",
                     "inputmode": "tel",
-                    "pattern": r"[+]?[(]?[0-9]{3}[)]?[-\s.]?[0-9]{3}[-\s.]?[0-9]{4,6}",
+                    "pattern": _phone_pattern,
+                    "placeholder": widget_attrs.get("placeholder", "(555) 867-5309"),
                 }
             )
             field = forms.CharField(
@@ -1155,8 +1165,11 @@ def _create_field(self, field_def, field_args, widget_attrs, is_editable):
             )
             field.validators.append(
                 RegexValidator(
-                    regex=r"^\+?[(]?[0-9]{3}[)]?[-\s.]?[0-9]{3}[-\s.]?[0-9]{4,6}$",
-                    message="Enter a valid phone number (e.g. 555-555-5555 or +1 555 555 5555).",
+                    regex=r"^(\+[0-9]{1,3} )?\([0-9]{3}\) [0-9]{3}-[0-9]{4}$",
+                    message=(
+                        "Enter a phone number in the format (555) 867-5309 "
+                        "or +1 (555) 867-5309 for international numbers."
+                    ),
                 )
             )
             self.fields[field_def.field_name] = field

django_forms_workflows/templates/django_forms_workflows/submission_detail.html

@@ -483,10 +483,22 @@ <h5 class="mb-0">Approval History</h5>
 
 
         <!-- Actions -->
-        <div class="mt-3">
+        <div class="mt-3 d-flex flex-wrap gap-2 align-items-center">
             <a href="{% url 'forms_workflows:my_submissions' %}" class="btn btn-outline-secondary">
                 <i class="bi bi-arrow-left"></i> Back to My Submissions
             </a>
+            {% if submission.status == 'draft' %}
+                {% if submission.submitter == user %}
+                    <a href="{% url 'forms_workflows:form_submit' submission.form_definition.slug %}"
+                       class="btn btn-primary">
+                        <i class="bi bi-pencil"></i> Continue Editing
+                    </a>
+                    <a href="{% url 'forms_workflows:discard_draft' submission.id %}"
+                       class="btn btn-outline-danger">
+                        <i class="bi bi-trash"></i> Discard Draft
+                    </a>
+                {% endif %}
+            {% endif %}
             {% if submission.status == 'submitted' or submission.status == 'pending_approval' %}
                 {% if submission.form_definition.allow_withdrawal and submission.submitter == user %}
                     <a href="{% url 'forms_workflows:withdraw_submission' submission.id %}" class="btn btn-outline-danger">
@@ -501,7 +513,6 @@ <h5 class="mb-0">Approval History</h5>
                     </a>
                 {% endif %}
             {% endif %}
-
         </div>
     </div>
 </div>

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-forms-workflows"
-version = "0.37.10"
+version = "0.37.11"
 description = "Enterprise-grade, database-driven form builder with approval workflows and external data integration"
 license = "LGPL-3.0-only"
 readme = "README.md"