objectstate 1.1.8__tar.gz → 1.2.0__tar.gz

{objectstate-1.1.8 → objectstate-1.2.0}/.github/badges/coverage.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 72.72%"><title>coverage: 72.72%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#ea7233"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">72.72%</text><text x="865" y="150" fill-opacity=".3" textLength="430">72.72%</text></g><text x="865" y="140" textLength="430">72.72%</text></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 74.21%"><title>coverage: 74.21%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#ea7233"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">74.21%</text><text x="865" y="150" fill-opacity=".3" textLength="430">74.21%</text></g><text x="865" y="140" textLength="430">74.21%</text></g></g></svg>

{objectstate-1.1.8 → objectstate-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: objectstate
-Version: 1.1.8
+Version: 1.2.0
 Summary: Generic lazy dataclass configuration framework with dual-axis inheritance and contextvars-based resolution
 Project-URL: Homepage, https://github.com/OpenHCSDev/objectstate
 Project-URL: Documentation, https://objectstate.readthedocs.io
@@ -168,6 +168,23 @@ state.restore_saved()
 ObjectStateRegistry.unregister(state)
 ```
 
+Headless compilation can resolve a submitted saved declaration without creating
+or registering an editing state:
+
+```python
+resolved_step, provenance = ObjectState.resolve_saved_object(
+    submitted_step,
+    scope_id="pipeline::step_0",
+    ancestor_objects_with_scopes=(("pipeline", saved_pipeline_config),),
+)
+```
+
+This uses the saved global context and the same scoped inheritance and nominal
+construction as editing states. The caller supplies saved ancestors in order
+from least to most specific. Provenance describes the same saved values; mutable
+results are detached together while callable identities and shared aliases stay
+intact. The existing live editor and saved-baseline APIs retain their lifecycle.
+
 ## Undo/Redo and Time Travel
 
 Git-like DAG history with branching timelines:

{objectstate-1.1.8 → objectstate-1.2.0}/README.md

@@ -132,6 +132,23 @@ state.restore_saved()
 ObjectStateRegistry.unregister(state)
 ```
 
+Headless compilation can resolve a submitted saved declaration without creating
+or registering an editing state:
+
+```python
+resolved_step, provenance = ObjectState.resolve_saved_object(
+    submitted_step,
+    scope_id="pipeline::step_0",
+    ancestor_objects_with_scopes=(("pipeline", saved_pipeline_config),),
+)
+```
+
+This uses the saved global context and the same scoped inheritance and nominal
+construction as editing states. The caller supplies saved ancestors in order
+from least to most specific. Provenance describes the same saved values; mutable
+results are detached together while callable identities and shared aliases stay
+intact. The existing live editor and saved-baseline APIs retain their lifecycle.
+
 ## Undo/Redo and Time Travel
 
 Git-like DAG history with branching timelines:

{objectstate-1.1.8 → objectstate-1.2.0}/src/objectstate/__init__.py

@@ -216,7 +216,7 @@ __all__ = [
     'ObjectStateEditSession',
 ]
 
-__version__ = "1.1.8"
+__version__ = "1.2.0"
 __author__ = 'OpenHCS Team'
 __description__ = 'Generic configuration framework for lazy dataclass resolution'
 

{objectstate-1.1.8 → objectstate-1.2.0}/src/objectstate/context_manager.py

@@ -66,10 +66,21 @@ def _merge_nested_dataclass(base, override, mask_with_none: bool = False):
     if not is_dataclass(base) or not is_dataclass(override):
         return override
 
+    from objectstate.lazy_factory import get_base_type_for_lazy, replace_raw
+
+    base_type = get_base_type_for_lazy(type(base)) or type(base)
+    override_type = get_base_type_for_lazy(type(override)) or type(override)
+    # Lazy overlays of the same owner inherit on the base instance. An authored
+    # nominal change instead owns the result, including subtype-only fields.
+    result_owner = base if base_type is override_type else override
+    base_fields = {field_info.name for field_info in fields(base)}
     merge_values = {}
     for field_info in fields(override):
         field_name = field_info.name
         override_value = object.__getattribute__(override, field_name)
+        if field_name not in base_fields:
+            # This field belongs only to the authored nominal owner.
+            continue
         base_value = object.__getattribute__(base, field_name)
 
         if override_value is None:
@@ -77,8 +88,9 @@ def _merge_nested_dataclass(base, override, mask_with_none: bool = False):
                 # None overrides base value (masking mode)
                 merge_values[field_name] = None
             else:
-                # None means "don't override" - keep base value
-                continue
+                # None means inherit, including when the result owner changes.
+                if result_owner is override:
+                    merge_values[field_name] = base_value
         elif is_dataclass(override_value):
             # Recursively merge nested dataclass
             if base_value is not None and is_dataclass(base_value):
@@ -89,13 +101,12 @@ def _merge_nested_dataclass(base, override, mask_with_none: bool = False):
             # Concrete value - use override
             merge_values[field_name] = override_value
 
-    # Merge with base using replace_raw to preserve None values
+    # Merge on the nominal owner using replace_raw to preserve None values
     # (dataclasses.replace triggers lazy resolution, baking in resolved values)
     if merge_values:
-        from objectstate.lazy_factory import replace_raw
-        return replace_raw(base, **merge_values)
+        return replace_raw(result_owner, **merge_values)
     else:
-        return base
+        return result_owner
 
 
 @contextmanager

{objectstate-1.1.8 → objectstate-1.2.0}/src/objectstate/lazy_factory.py

@@ -795,6 +795,11 @@ class LazyMethodBindings:
 class LazyDataclassFactory:
     """Generic factory for creating lazy dataclasses with flexible resolution."""
 
+    @staticmethod
+    def registered_type_pairs() -> tuple[tuple[type, type], ...]:
+        """Project current lazy/public declarations without constructing values."""
+        return tuple(_lazy_type_registry.items())
+