Upload folder using huggingface_hub

README.md

@@ -10,7 +10,7 @@ app_file: space.py
 ---
 
 # `gradio_propertysheet`
-<img alt="Static Badge" src="https://img.shields.io/badge/version%20-%200.0.11%20-%20blue"> <a href="https://huggingface.co/spaces/elismasilva/gradio_propertysheet"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-blue"></a><p><span>💻 <a href='https://github.com/DEVAIEXP/gradio_component_propertysheet'>Component GitHub Code</a></span></p>
+<img alt="Static Badge" src="https://img.shields.io/badge/version%20-%200.0.12%20-%20blue"> <a href="https://huggingface.co/spaces/elismasilva/gradio_propertysheet"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-blue"></a><p><span>💻 <a href='https://github.com/DEVAIEXP/gradio_component_propertysheet'>Component GitHub Code</a></span></p>
 
 The **PropertySheet** component for Gradio allows you to automatically generate a complete and interactive settings panel from a standard Python `dataclass`. It's designed to bring the power of IDE-like property editors directly into your Gradio applications.
 

src/README.md

@@ -10,7 +10,7 @@ app_file: space.py
 ---
 
 # `gradio_propertysheet`
-<img alt="Static Badge" src="https://img.shields.io/badge/version%20-%200.0.11%20-%20blue"> <a href="https://huggingface.co/spaces/elismasilva/gradio_propertysheet"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-blue"></a><p><span>💻 <a href='https://github.com/DEVAIEXP/gradio_component_propertysheet'>Component GitHub Code</a></span></p>
+<img alt="Static Badge" src="https://img.shields.io/badge/version%20-%200.0.12%20-%20blue"> <a href="https://huggingface.co/spaces/elismasilva/gradio_propertysheet"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-blue"></a><p><span>💻 <a href='https://github.com/DEVAIEXP/gradio_component_propertysheet'>Component GitHub Code</a></span></p>
 
 The **PropertySheet** component for Gradio allows you to automatically generate a complete and interactive settings panel from a standard Python `dataclass`. It's designed to bring the power of IDE-like property editors directly into your Gradio applications.
 

src/backend/gradio_propertysheet/helpers.py

@@ -1,9 +1,8 @@
 from dataclasses import fields, is_dataclass
 import dataclasses
-from gradio_client.documentation import document
-from typing import Any, Dict, Literal, Type, get_args, get_origin, get_type_hints
+from typing import Any, Dict, List, Literal, Type, get_args, get_origin, get_type_hints
+
 
-@document()
 def extract_prop_metadata(cls: Type, field: dataclasses.Field) -> Dict[str, Any]:
     """
     Inspects a dataclass field and extracts metadata for UI rendering.
@@ -50,7 +49,33 @@ def extract_prop_metadata(cls: Type, field: dataclasses.Field) -> Dict[str, Any]
     return metadata
 
 
-@document()
+def build_path_to_metadata_key_map(cls: Type, prefix_list: List[str]) -> Dict[str, str]:
+    """
+    Builds a map from a dataclass field path (e.g., 'image_settings.model') to the
+    expected key in the metadata dictionary (e.g., 'Image Settings - Model').
+    """
+    path_map = {}
+    if not is_dataclass(cls):
+        return {}
+
+    for f in fields(cls):
+        current_path = f.name
+        
+        if is_dataclass(f.type):
+            parent_label = f.metadata.get("label", f.name.replace("_", " ").title())
+            new_prefix_list = prefix_list + [parent_label]
+            nested_map = build_path_to_metadata_key_map(f.type, new_prefix_list)
+            for nested_path, metadata_key in nested_map.items():
+                path_map[f"{current_path}.{nested_path}"] = metadata_key
+        else:
+            label = f.metadata.get("label", f.name.replace("_", " ").title())
+            full_prefix = " - ".join(prefix_list)
+            metadata_key = f"{full_prefix} - {label}" if full_prefix else label
+            path_map[current_path] = metadata_key
+            
+    return path_map
+
+
 def build_dataclass_fields(cls: Type, prefix: str = "") -> Dict[str, str]:
     """
     Recursively builds a mapping of field labels to field paths for a dataclass.
@@ -85,7 +110,7 @@ def build_dataclass_fields(cls: Type, prefix: str = "") -> Dict[str, str]:
     
     return dataclass_fields
 
-@document()
+
 def create_dataclass_instance(cls: Type, data: Dict[str, Any]) -> Any:
     """
     Recursively creates an instance of a dataclass from a nested dictionary.
@@ -119,4 +144,29 @@ def create_dataclass_instance(cls: Type, data: Dict[str, Any]) -> Any:
             else:
                 kwargs[field_name] = field.default
     
-    return cls(**kwargs)
+    return cls(**kwargs)
+
+
+def flatten_dataclass_with_labels(instance: Any, prefix_labels: List[str] = []) -> Dict[str, Any]:
+    """
+    Recursively flattens a dataclass instance, creating a dictionary
+    where the key is a hierarchical, dash-separated label string.
+    """
+    flat_map = {}
+    if not is_dataclass(instance):
+        return {}
+
+    for f in fields(instance):
+        value = getattr(instance, f.name)
+        
+        if is_dataclass(value):
+            group_label = f.metadata.get("label", f.name.replace("_", " ").title())
+            new_prefix_list = prefix_labels + [group_label]
+            flat_map.update(flatten_dataclass_with_labels(value, new_prefix_list))
+        else:
+            field_label = f.metadata.get("label", f.name.replace("_", " ").title())
+            all_labels = prefix_labels + [field_label]
+            hierarchical_key = " - ".join(all_labels)
+            flat_map[hierarchical_key] = value
+            
+    return flat_map

src/backend/gradio_propertysheet/propertysheet.py

@@ -7,6 +7,7 @@ from gradio.components.base import Component
 from gradio_propertysheet.helpers import extract_prop_metadata
 from gradio_client.documentation import document
 from gradio.events import Events, EventListener
+
 def prop_meta(**kwargs) -> dataclasses.Field:
     """
     A helper function to create a dataclass field with Gradio-specific metadata.

src/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gradio_propertysheet"
-version = "0.0.11"
+version = "0.0.12"
 description = "Property sheet"
 readme = "README.md"
 license = "apache-2.0"