fh-pydantic-form 0.3.7__py3-none-any.whl → 0.3.8__py3-none-any.whl

fh_pydantic_form/field_renderers.py

@@ -383,6 +383,9 @@ class BaseFieldRenderer(MetricsRendererMixin):
         metrics_dict: Optional[MetricsDict] = None,
         refresh_endpoint_override: Optional[str] = None,
         keep_skip_json_pathset: Optional[set[str]] = None,
+        comparison_copy_enabled: bool = False,
+        comparison_copy_target: Optional[str] = None,
+        comparison_name: Optional[str] = None,
         **kwargs,  # Accept additional kwargs for extensibility
     ):
         """
@@ -401,6 +404,9 @@ class BaseFieldRenderer(MetricsRendererMixin):
             metric_entry: Optional metric entry for visual feedback
             metrics_dict: Optional full metrics dict for auto-lookup
             refresh_endpoint_override: Optional override URL for refresh actions (used in ComparisonForm)
+            comparison_copy_enabled: If True, show copy button for this field
+            comparison_copy_target: "left" or "right" - which side this field is on
+            comparison_name: Name of the ComparisonForm (for copy route URLs)
             **kwargs: Additional keyword arguments for extensibility
         """
         self.field_name = f"{prefix}{field_name}" if prefix else field_name
@@ -425,6 +431,9 @@ class BaseFieldRenderer(MetricsRendererMixin):
         self.metrics_dict = metrics_dict
         self._refresh_endpoint_override = refresh_endpoint_override
         self._keep_skip_json_pathset = keep_skip_json_pathset or set()
+        self._cmp_copy_enabled = comparison_copy_enabled
+        self._cmp_copy_target = comparison_copy_target
+        self._cmp_name = comparison_name
 
         # Initialize metric entry attribute
         self.metric_entry: Optional[MetricEntry] = None
@@ -509,6 +518,38 @@ class BaseFieldRenderer(MetricsRendererMixin):
         """
         return f"text-{color}-600"
 
+    def _render_comparison_copy_button(self) -> Optional[FT]:
+        """
+        Render a copy button for comparison forms.
+
+        Note: Copy buttons are never disabled, even if the field itself is disabled.
+        This allows copying from disabled (read-only) fields to editable fields.
+
+        Returns:
+            A copy button component, or None if not in comparison mode
+        """
+        if not (self._cmp_copy_enabled and self._cmp_copy_target and self._cmp_name):
+            return None
+
+        path = self._build_path_string()
+        # Use arrow pointing in the direction of the copy (towards target)
+        arrow = "arrow-left" if self._cmp_copy_target == "left" else "arrow-right"
+        tooltip_text = f"Copy to {self._cmp_copy_target}"
+
+        # Note: We explicitly do NOT pass disabled=self.disabled here
+        # Copy buttons should always be enabled, even in disabled forms
+        #
+        # Pure JS copy: Bypass HTMX entirely to avoid accordion collapse
+        # Button is on SOURCE side, arrow points to TARGET side
+        return mui.Button(
+            mui.UkIcon(arrow, cls="w-4 h-4 text-gray-500 hover:text-blue-600"),
+            type="button",
+            onclick=f"window.fhpfPerformCopy('{path}', '{self.prefix}', '{self._cmp_copy_target}'); return false;",
+            uk_tooltip=tooltip_text,
+            cls="uk-button-text uk-button-small flex-shrink-0",
+            style="all: unset; display: inline-flex; align-items: center; justify-content: center; cursor: pointer; padding: 0.25rem; min-width: 1.5rem;",
+        )
+
     def render_label(self) -> FT:
         """
         Render label for the field
@@ -579,13 +620,16 @@ class BaseFieldRenderer(MetricsRendererMixin):
         Returns:
             A FastHTML component containing the complete field
         """
-        # 1. Get the label component
+        # 1. Get the label component (without copy button)
         label_component = self.render_label()
 
         # 2. Render the input field
         input_component = self.render_input()
 
-        # 3. Choose layout based on spacing theme
+        # 3. Get the copy button if enabled
+        copy_button = self._render_comparison_copy_button()
+
+        # 4. Choose layout based on spacing theme
         if self.spacing == SpacingTheme.COMPACT:
             # Horizontal layout for compact mode
             field_element = fh.Div(
@@ -597,15 +641,25 @@ class BaseFieldRenderer(MetricsRendererMixin):
                 cls=f"{spacing('outer_margin', self.spacing)} w-full",
             )
         else:
-            # Vertical layout for normal mode (existing behavior)
+            # Vertical layout for normal mode
             field_element = fh.Div(
                 label_component,
                 input_component,
                 cls=spacing("outer_margin", self.spacing),
             )
 
-        # 4. Apply metrics decoration if available
-        return self._decorate_metrics(field_element, self.metric_entry)
+        # 5. Apply metrics decoration if available
+        decorated_field = self._decorate_metrics(field_element, self.metric_entry)
+
+        # 6. If copy button exists, wrap the entire decorated field with copy button on the right
+        if copy_button:
+            return fh.Div(
+                decorated_field,
+                copy_button,
+                cls="flex items-start gap-2 w-full",
+            )
+        else:
+            return decorated_field
 
 
 # ---- Specific Field Renderers ----
@@ -662,6 +716,7 @@ class StringFieldRenderer(BaseFieldRenderer):
             "cls": " ".join(input_cls_parts),
             "rows": rows,
             "style": "resize: vertical; min-height: 2.5rem; padding: 0.5rem; line-height: 1.25;",
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -719,6 +774,7 @@ class NumberFieldRenderer(BaseFieldRenderer):
             if self.field_info.annotation is float
             or get_origin(self.field_info.annotation) is float
             else "1",
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -779,6 +835,7 @@ class DecimalFieldRenderer(BaseFieldRenderer):
             "required": is_field_required,
             "cls": " ".join(input_cls_parts),
             "step": "any",  # Allow arbitrary decimal precision
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -806,6 +863,7 @@ class BooleanFieldRenderer(BaseFieldRenderer):
             "id": self.field_name,
             "name": self.field_name,
             "checked": bool(self.value),
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -829,6 +887,9 @@ class BooleanFieldRenderer(BaseFieldRenderer):
         # Get the checkbox component
         checkbox_component = self.render_input()
 
+        # Get the copy button if enabled
+        copy_button = self._render_comparison_copy_button()
+
         # Create a flex container to place label and checkbox side by side
         field_element = fh.Div(
             fh.Div(
@@ -840,10 +901,20 @@ class BooleanFieldRenderer(BaseFieldRenderer):
         )
 
         # Apply metrics decoration if available (border only, as bullet is in the label)
-        return self._decorate_metrics(
+        decorated_field = self._decorate_metrics(
             field_element, self.metric_entry, scope=DecorationScope.BORDER
         )
 
+        # If copy button exists, wrap the entire decorated field with copy button on the right
+        if copy_button:
+            return fh.Div(
+                decorated_field,
+                copy_button,
+                cls="flex items-start gap-2 w-full",
+            )
+        else:
+            return decorated_field
+
 
 class DateFieldRenderer(BaseFieldRenderer):
     """Renderer for date fields"""
@@ -891,6 +962,7 @@ class DateFieldRenderer(BaseFieldRenderer):
             "placeholder": placeholder_text,
             "required": is_field_required,
             "cls": " ".join(input_cls_parts),
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -955,6 +1027,7 @@ class TimeFieldRenderer(BaseFieldRenderer):
             "placeholder": placeholder_text,
             "required": is_field_required,
             "cls": " ".join(input_cls_parts),
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -1032,6 +1105,7 @@ class LiteralFieldRenderer(BaseFieldRenderer):
             "required": is_field_required,
             "placeholder": placeholder_text,
             "cls": " ".join(select_cls_parts),
+            "data-field-path": self._build_path_string(),
         }
 
         if self.disabled:
@@ -1120,6 +1194,7 @@ class EnumFieldRenderer(BaseFieldRenderer):
                 "w-full",
                 f"{spacing('input_size', self.spacing)} {spacing('input_padding', self.spacing)}".strip(),
             ),
+            "data-field-path": self._build_path_string(),
         }
 
         # Only add the disabled attribute if the field should actually be disabled
@@ -1152,34 +1227,45 @@ class BaseModelFieldRenderer(BaseFieldRenderer):
         if self.label_color:
             if self._is_inline_color(self.label_color):
                 # Color value - apply as inline style
-                title_component = fh.Span(
+                title_span = fh.Span(
                     label_text,
                     style=f"color: {self.label_color};",
                     cls="text-sm font-medium",
                 )
             else:
                 # CSS class - apply as Tailwind class (includes emerald, amber, rose, teal, indigo, lime, violet, etc.)
-                title_component = fh.Span(
+                title_span = fh.Span(
                     label_text,
                     cls=f"text-sm font-medium {self._get_color_class(self.label_color)}",
                 )
         else:
             # No color specified - use default styling
-            title_component = fh.Span(
-                label_text, cls="text-sm font-medium text-gray-700"
-            )
+            title_span = fh.Span(label_text, cls="text-sm font-medium text-gray-700")
 
         # Add tooltip if description is available
         description = getattr(self.field_info, "description", None)
         if description:
-            title_component.attrs["uk-tooltip"] = description
-            title_component.attrs["title"] = description
+            title_span.attrs["uk-tooltip"] = description
+            title_span.attrs["title"] = description
 
         # Apply metrics decoration to title (bullet only, no border)
-        title_component = self._decorate_metrics(
-            title_component, self.metric_entry, scope=DecorationScope.BULLET
+        title_with_metrics = self._decorate_metrics(
+            title_span, self.metric_entry, scope=DecorationScope.BULLET
         )
 
+        # Get copy button if enabled - add it AFTER metrics decoration
+        copy_button = self._render_comparison_copy_button()
+
+        # Wrap title (with metrics) and copy button together if copy button exists
+        if copy_button:
+            title_component = fh.Div(
+                title_with_metrics,
+                copy_button,
+                cls="flex items-center justify-between gap-2 w-full",
+            )
+        else:
+            title_component = title_with_metrics
+
         # Compute border color for the top-level BaseModel card
         border_color = self._metric_border_color(self.metric_entry)
         li_style = {}
@@ -1321,6 +1407,9 @@ class BaseModelFieldRenderer(BaseFieldRenderer):
                     metrics_dict=self.metrics_dict,  # Pass down the metrics dict
                     refresh_endpoint_override=self._refresh_endpoint_override,  # Propagate refresh override
                     keep_skip_json_pathset=self._keep_skip_json_pathset,  # Propagate keep paths
+                    comparison_copy_enabled=self._cmp_copy_enabled,  # Propagate comparison copy settings
+                    comparison_copy_target=self._cmp_copy_target,
+                    comparison_name=self._cmp_name,
                 )
 
                 nested_inputs.append(renderer.render())
@@ -1500,7 +1589,10 @@ class ListFieldRenderer(BaseFieldRenderer):
 
         # Metric decoration will be applied to the title_component below
 
-        # Only add refresh icon if we have a form name and field is not disabled
+        # Build action buttons row (refresh only, NOT copy - copy goes after metrics)
+        action_buttons = []
+
+        # Add refresh icon if we have a form name and field is not disabled
         if form_name and not self.disabled:
             # Create the smaller icon component
             refresh_icon_component = mui.UkIcon(
@@ -1527,7 +1619,7 @@ class ListFieldRenderer(BaseFieldRenderer):
                 hx_include="closest form",  # Include all form fields from the enclosing form
                 hx_preserve="scroll",
                 uk_tooltip="Refresh form display to update list summaries",
-                style="all: unset; display: inline-flex; align-items: center; cursor: pointer; padding: 0 0.5rem; margin-left: 0.5rem;",
+                style="all: unset; display: inline-flex; align-items: center; cursor: pointer; padding: 0 0.5rem;",
                 **{
                     "hx-on::before-request": f"window.saveAccordionState && window.saveAccordionState('{container_id}')"
                 },
@@ -1535,32 +1627,47 @@ class ListFieldRenderer(BaseFieldRenderer):
                     "hx-on::after-swap": f"window.restoreAccordionState && window.restoreAccordionState('{container_id}')"
                 },
             )
+            action_buttons.append(refresh_icon_trigger)
 
-            # Combine label and icon - put refresh icon in a separate div to isolate it
-            title_component = fh.Div(
+        # Build title component with label and action buttons (excluding copy button)
+        if action_buttons:
+            # Combine label and action buttons
+            title_base = fh.Div(
                 fh.Div(
                     label_span,  # Use the properly styled label span
                     cls="flex-1",  # Take up remaining space
                 ),
                 fh.Div(
-                    refresh_icon_trigger,
-                    cls="flex-shrink-0 px-1",  # Don't shrink, add horizontal padding for larger click area
-                    onclick="event.stopPropagation();",  # Isolate the refresh icon area
+                    *action_buttons,
+                    cls="flex-shrink-0 flex items-center gap-1 px-1",  # Don't shrink, add horizontal padding
+                    onclick="event.stopPropagation();",  # Isolate the action buttons area
                 ),
                 cls="flex items-center",
             )
         else:
-            # If no form name, just use the styled label
-            title_component = fh.Div(
+            # If no action buttons, just use the styled label
+            title_base = fh.Div(
                 label_span,  # Use the properly styled label span
-                cls="flex items-center",  # Remove cursor-pointer and click handler
+                cls="flex items-center",
             )
 
         # Apply metrics decoration to title (bullet only, no border)
-        title_component = self._decorate_metrics(
-            title_component, self.metric_entry, scope=DecorationScope.BULLET
+        title_with_metrics = self._decorate_metrics(
+            title_base, self.metric_entry, scope=DecorationScope.BULLET
         )
 
+        # Add copy button AFTER metrics decoration
+        copy_button = self._render_comparison_copy_button()
+        if copy_button:
+            # Wrap title (with metrics) and copy button together
+            title_component = fh.Div(
+                title_with_metrics,
+                copy_button,
+                cls="flex items-center justify-between gap-2 w-full",
+            )
+        else:
+            title_component = title_with_metrics
+
         # Compute border color for the wrapper accordion
         border_color = self._metric_border_color(self.metric_entry)
         li_style = {}
@@ -1875,6 +1982,9 @@ class ListFieldRenderer(BaseFieldRenderer):
                         metrics_dict=self.metrics_dict,  # Pass down the metrics dict
                         refresh_endpoint_override=self._refresh_endpoint_override,  # Propagate refresh override
                         keep_skip_json_pathset=self._keep_skip_json_pathset,  # Propagate keep paths
+                        comparison_copy_enabled=self._cmp_copy_enabled,  # Propagate comparison copy settings
+                        comparison_copy_target=self._cmp_copy_target,
+                        comparison_name=self._cmp_name,
                     )
                     # Add the rendered input to content elements
                     item_content_elements.append(item_renderer.render_input())
@@ -1945,6 +2055,9 @@ class ListFieldRenderer(BaseFieldRenderer):
                                 metrics_dict=self.metrics_dict,  # Pass down the metrics dict
                                 refresh_endpoint_override=self._refresh_endpoint_override,  # Propagate refresh override
                                 keep_skip_json_pathset=self._keep_skip_json_pathset,  # Propagate keep paths
+                                comparison_copy_enabled=self._cmp_copy_enabled,  # Propagate comparison copy settings
+                                comparison_copy_target=self._cmp_copy_target,
+                                comparison_name=self._cmp_name,
                             )
 
                             # Add rendered field to valid fields
@@ -2087,15 +2200,46 @@ class ListFieldRenderer(BaseFieldRenderer):
             )
 
             # Return the accordion item
-            title_component = fh.Span(
+            title_span = fh.Span(
                 item_summary_text, cls="text-gray-700 font-medium pl-3"
             )
 
-            # Apply metrics decoration to the title (bullet only)
-            title_component = self._decorate_metrics(
-                title_component, item_metric_entry, scope=DecorationScope.BULLET
+            # Apply metrics decoration to the title span FIRST (bullet only)
+            title_with_metrics = self._decorate_metrics(
+                title_span, item_metric_entry, scope=DecorationScope.BULLET
             )
 
+            # Get copy button for this specific list item (if enabled) - add AFTER metrics
+            # Create a temporary renderer context with this item's path
+            if self._cmp_copy_enabled and self._cmp_copy_target and self._cmp_name:
+                # Build the path for this specific item
+                item_path_for_copy = self.field_path + [str(idx)]
+                item_path_string = _build_path_string_static(item_path_for_copy)
+                arrow = (
+                    "arrow-left" if self._cmp_copy_target == "left" else "arrow-right"
+                )
+                tooltip_text = f"Copy item to {self._cmp_copy_target}"
+
+                # Note: Copy button is never disabled, even in disabled forms
+                # Pure JS copy: Bypass HTMX entirely to avoid accordion collapse
+                item_copy_button = mui.Button(
+                    mui.UkIcon(arrow, cls="w-4 h-4 text-gray-500 hover:text-blue-600"),
+                    type="button",
+                    onclick=f"window.fhpfPerformCopy('{item_path_string}', '{self.prefix}', '{self._cmp_copy_target}'); return false;",
+                    uk_tooltip=tooltip_text,
+                    cls="uk-button-text uk-button-small flex-shrink-0",
+                    style="all: unset; display: inline-flex; align-items: center; justify-content: center; cursor: pointer; padding: 0.25rem; min-width: 1.5rem;",
+                )
+
+                # Wrap title (with metrics) and copy button together
+                title_component = fh.Div(
+                    title_with_metrics,
+                    item_copy_button,
+                    cls="flex items-center justify-between gap-2 w-full",
+                )
+            else:
+                title_component = title_with_metrics
+
             # Prepare li attributes with optional border styling
             li_attrs = {"id": full_card_id}
 

fh_pydantic_form/form_renderer.py

@@ -215,18 +215,46 @@ window.restoreAccordionState = function(containerId) {
     }
 };
 
-// Save all accordion states in the form
+// Save all accordion states in the form (both lists and nested BaseModels)
 window.saveAllAccordionStates = function() {
+    // Save list container states
     document.querySelectorAll('[id$="_items_container"]').forEach(container => {
         window.saveAccordionState(container.id);
     });
+
+    // Save all UIkit accordion item states (nested BaseModels, etc.)
+    document.querySelectorAll('.uk-accordion > li').forEach(item => {
+        if (item.id) {
+            const isOpen = item.classList.contains('uk-open');
+            sessionStorage.setItem('accordion_state_' + item.id, isOpen ? 'open' : 'closed');
+        }
+    });
 };
 
-// Restore all accordion states in the form
+// Restore all accordion states in the form (both lists and nested BaseModels)
 window.restoreAllAccordionStates = function() {
+    // Restore list container states
     document.querySelectorAll('[id$="_items_container"]').forEach(container => {
         window.restoreAccordionState(container.id);
     });
+
+    // Use requestAnimationFrame to ensure DOM has fully updated after swap
+    requestAnimationFrame(() => {
+        setTimeout(() => {
+            // Restore ALL UIkit accordion item states in the entire document (not just swapped area)
+            document.querySelectorAll('.uk-accordion > li').forEach(item => {
+                if (item.id) {
+                    const savedState = sessionStorage.getItem('accordion_state_' + item.id);
+
+                    if (savedState === 'open' && !item.classList.contains('uk-open')) {
+                        item.classList.add('uk-open');
+                    } else if (savedState === 'closed' && item.classList.contains('uk-open')) {
+                        item.classList.remove('uk-open');
+                    }
+                }
+            });
+        }, 150);
+    });
 };
 
 // Wait for the DOM to be fully loaded before initializing
@@ -235,8 +263,8 @@ document.addEventListener('DOMContentLoaded', () => {
     document.querySelectorAll('[id$="_items_container"]').forEach(container => {
         updateMoveButtons(container);
     });
-    
-    // Now it's safe to attach the HTMX event listener to document.body
+
+    // Attach HTMX event listener to document.body for list operations
     document.body.addEventListener('htmx:afterSwap', function(event) {
         // Check if this is an insert (afterend swap)
         const targetElement = event.detail.target;
@@ -708,13 +736,14 @@ class PydanticForm(Generic[ModelType]):
 
     def _inject_missing_defaults(self, data: Dict[str, Any]) -> Dict[str, Any]:
         """
-        Ensures all model fields with defaults are present in data if missing.
-        Handles excluded fields, SkipJsonSchema fields, and any other fields
-        not rendered in the form.
+        Ensure missing fields are filled following precedence:
+        1) form value (already in `data`)
+        2) initial_values
+        3) model/default_factory
+        4) sensible default (for SkipJsonSchema fields only)
 
-        Priority order:
-        1. initial_values (if provided during form creation)
-        2. model defaults/default_factory
+        For required fields without defaults or initial_values, they are left missing
+        so that Pydantic validation can properly surface the error.
 
         Args:
             data: Dictionary to modify in-place
@@ -722,43 +751,20 @@ class PydanticForm(Generic[ModelType]):
         Returns:
             The same dictionary instance for method chaining
         """
-        # Process ALL model fields, not just excluded ones
         for field_name, field_info in self.model_class.model_fields.items():
-            # Special handling for SkipJsonSchema fields
-            if _is_skip_json_schema_field(field_info):
-                # If keep_skip_json_fields was specified and this field is not kept, always use defaults
-                if self.keep_skip_json_fields and not self._is_kept_skip_field(
-                    [field_name]
-                ):
-                    # Remove any existing value and inject default
-                    if field_name in data:
-                        del data[field_name]
-                    # Fall through to default injection logic below
-                elif field_name in data:
-                    # This is either a kept SkipJsonSchema field or no keep list was specified, keep it
-                    continue
-                # If it's a kept field but not in data, fall through to default injection
-            else:
-                # Skip if already present in parsed data (normal fields)
-                if field_name in data:
-                    continue
-
-            # First priority: check if initial_values_dict has this field
-            # Use initial values for non-SkipJsonSchema fields, or SkipJsonSchema fields that are kept,
-            # or SkipJsonSchema fields when no keep_skip_json_fields list was specified
-            if field_name in self.initial_values_dict and (
-                not _is_skip_json_schema_field(field_info)
-                or not self.keep_skip_json_fields
-                or self._is_kept_skip_field([field_name])
-            ):
+            # 1) Respect any value already parsed from the form (top priority)
+            if field_name in data:
+                continue
+
+            # 2) Prefer initial_values for ANY missing field (including hidden SkipJsonSchema fields)
+            if field_name in self.initial_values_dict:
                 initial_val = self.initial_values_dict[field_name]
-                # If the initial value is a BaseModel, convert to dict for consistency
                 if hasattr(initial_val, "model_dump"):
                     initial_val = initial_val.model_dump()
                 data[field_name] = initial_val
                 continue
 
-            # Second priority: use model defaults
+            # 3) Use model/default_factory if available
             default_val = get_default(field_info)
             if default_val is not _UNSET:
                 # If the default is a BaseModel, convert to dict for consistency
@@ -766,12 +772,11 @@ class PydanticForm(Generic[ModelType]):
                     default_val = default_val.model_dump()
                 data[field_name] = default_val
             else:
-                # Check if this is a SkipJsonSchema field
+                # 4) For SkipJsonSchema fields without defaults, provide sensible defaults
+                # For regular required fields, leave them missing so validation catches them
                 if _is_skip_json_schema_field(field_info):
-                    pass  # Skip fields don't need defaults
-                else:
-                    # No default → leave missing; validation will surface error
-                    pass
+                    data[field_name] = default_for_annotation(field_info.annotation)
+                # else: leave missing, let validation fail
 
         return data
 

{fh_pydantic_form-0.3.7.dist-info → fh_pydantic_form-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fh-pydantic-form
-Version: 0.3.7
+Version: 0.3.8
 Summary: a library to turn any pydantic BaseModel object into a fasthtml/monsterui input form
 Project-URL: Homepage, https://github.com/Marcura/fh-pydantic-form
 Project-URL: Repository, https://github.com/Marcura/fh-pydantic-form
@@ -18,9 +18,9 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
-Requires-Dist: monsterui>=1.0.19
+Requires-Dist: monsterui>=1.0.29
 Requires-Dist: pydantic>=2.0
-Requires-Dist: python-fasthtml>=0.12.12
+Requires-Dist: python-fasthtml>=0.12.29
 Description-Content-Type: text/markdown
 
 # fh-pydantic-form
@@ -901,6 +901,38 @@ comparison_form.register_routes(app)
 - **Metrics Integration**: Right side typically shows LLM output quality scores
 - **Flexible Layout**: Responsive design works on desktop and mobile
 - **Form Validation**: Standard validation works with either form
+- **Intelligent List Copying**: Copy lists between forms with automatic length adjustment
+
+### Copying Between Forms
+
+The ComparisonForm provides granular copy functionality at multiple levels. When you enable copy buttons (via `copy_left=True` or `copy_right=True`), each field, nested model, and list item gets its own copy button for maximum flexibility:
+
+```python
+# Enable copy buttons (copy FROM right TO left)
+comparison_form = ComparisonForm(
+    name="extraction_evaluation",
+    left_form=left_form,
+    right_form=right_form,
+    left_label="Ground Truth",
+    right_label="LLM Output",
+    copy_left=True,  # Show copy buttons on right form to copy TO left
+)
+```
+
+**Copy Granularity Levels:**
+
+The copy feature works at five different levels of granularity:
+
+1. **Individual Fields** - Copy a single field value (e.g., `name`, `price`, `status`)
+
+2. **Nested BaseModel (Entire Object)** - Copy all fields within a nested model at once
+
+3. **Individual Fields in Nested Models** - Copy a specific field within a nested object
+
+4. **Full List Fields** - Copy entire lists with automatic length adjustment
+
+5. **Individual List Items** - Add a single item from one list to another
+
 
 ### Common Patterns
 

{fh_pydantic_form-0.3.7.dist-info → fh_pydantic_form-0.3.8.dist-info}/RECORD

@@ -1,17 +1,17 @@
 fh_pydantic_form/__init__.py,sha256=uPN0pwErHoe69tDoCDdIYD_iCslMKRgfYw6pvL4McHE,4608
 fh_pydantic_form/color_utils.py,sha256=M0HSXX0i-lSHkcsgesxw7d3PEAnLsZ46i_STymZAM_k,18271
-fh_pydantic_form/comparison_form.py,sha256=Y-OKAjTxMiixBC05SK1ofZ_A3zkvjUFp8tTE-_wUn60,21660
+fh_pydantic_form/comparison_form.py,sha256=UuA9QOM9V1hsg3oxZrO99Jp4xIi1if7uEuPN9U-SLqg,63793
 fh_pydantic_form/constants.py,sha256=-N9wzkibFNn-V6cO8iWTQ7_xBvwSr2hBdq-m3apmW4M,169
 fh_pydantic_form/defaults.py,sha256=9vV0f4PapTOgqNsIxoW6rEbpYO66O4uiKvpd6hzR1-M,6189
-fh_pydantic_form/field_renderers.py,sha256=DLEWFGneyRktp_f4e4IbD3IAb8P_1odx87eZ2FOfHsk,85746
+fh_pydantic_form/field_renderers.py,sha256=SYBXbFTrnZ9qQnEongrMUMaTu0OWKVluiZiA4lK8A3U,92747
 fh_pydantic_form/form_parser.py,sha256=LKeGiCeyYJ0eIZE6oETcxl1DpKjk1MpoCSh_VAvUgGk,29701
-fh_pydantic_form/form_renderer.py,sha256=ZTxr6tQrnMwR9cKO0iSvjfGGV8PqPrqMYzCW1fD2X14,39083
+fh_pydantic_form/form_renderer.py,sha256=looOW7nabPeQH3R7t5ZO_QMpBfoQtTO48p0QqZIhpfA,39175
 fh_pydantic_form/list_path.py,sha256=AA8bmDmaYy4rlGIvQOOZ0fP2tgcimNUB2Re5aVGnYc8,5182
 fh_pydantic_form/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fh_pydantic_form/registry.py,sha256=b5zIjOpfmCUCs2njgp4PdDu70ioDIAfl49oU-Nf2pg4,4810
 fh_pydantic_form/type_helpers.py,sha256=C6Oem1frgj_T_CqiE-9yyVKI7YpFFEAKAGVXe04OkJU,8245
 fh_pydantic_form/ui_style.py,sha256=UPK5OBwUVVTLnfvQ-yKukz2vbKZaT_GauaNB7OGc-Uw,3848
-fh_pydantic_form-0.3.7.dist-info/METADATA,sha256=l9jXcW7AXC1jBbVKw26f6Z6tpY7SDj9bs7QVgivc7iw,41200
-fh_pydantic_form-0.3.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fh_pydantic_form-0.3.7.dist-info/licenses/LICENSE,sha256=AOi2eNK3D2aDycRHfPRiuACZ7WPBsKHTV2tTYNl7cls,577
-fh_pydantic_form-0.3.7.dist-info/RECORD,,
+fh_pydantic_form-0.3.8.dist-info/METADATA,sha256=MdCq-9oxeFcKs3FZ6FY7MAQJWF55p-NiyMvJL9Nuu9w,42391
+fh_pydantic_form-0.3.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fh_pydantic_form-0.3.8.dist-info/licenses/LICENSE,sha256=AOi2eNK3D2aDycRHfPRiuACZ7WPBsKHTV2tTYNl7cls,577
+fh_pydantic_form-0.3.8.dist-info/RECORD,,