haiway 0.24.3__tar.gz → 0.25.0__tar.gz

{haiway-0.24.3 → haiway-0.25.0}/Makefile

@@ -10,7 +10,7 @@ TESTS_PATH := tests
 -include .env
 
 ifndef UV_VERSION
-	UV_VERSION := 0.7.6
+	UV_VERSION := 0.7.20
 endif
 
 .PHONY: uv_check venv sync update format lint test release

{haiway-0.24.3 → haiway-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.24.3
+Version: 0.25.0
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Project-URL: Homepage, https://miquido.com
 Project-URL: Repository, https://github.com/miquido/haiway.git

haiway-0.25.0/junit/test-results.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8"?><testsuites name="pytest tests"><testsuite name="pytest" errors="0" failures="0" skipped="0" tests="199" time="3.844" timestamp="2025-07-14T10:25:32.182364+00:00" hostname="pkrvmq0rgcvqdmg"><testcase classname="tests.test_async_queue" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_queue" name="test_buffers_values_when_not_reading" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_buffer_when_streaming_fails" time="0.001" /><testcase classname="tests.test_async_queue" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_queue" name="test_fails_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_queue" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_when_stream_fails" time="0.001" /><testcase classname="tests.test_async_stream" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ends_when_stream_ends" time="0.001" /><testcase classname="tests.test_async_stream" name="test_finishes_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_fails_without_buffer" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_updates_when_sending" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_sending_to_failed" time="0.001" /><testcase classname="tests.test_async_stream" name="test_ignores_when_finishing_when_finished" time="0.001" /><testcase classname="tests.test_async_stream" name="test_delivers_all_when_sending_async" time="0.001" /><testcase classname="tests.test_attribute_path" name="test_id_path_points_to_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_points_to_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_path_points_to_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_points_to_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_id_path_set_updates_self" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_attribute_path_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_nested_attribute_path_set_updates_nested_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_recursive_attribute_set_updates_attribute" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_list_item_path_set_updates_item" time="0.001" /><testcase classname="tests.test_attribute_path" name="test_tuple_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_mixed_tuple_item_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_path" name="test_dict_item_path_set_updates_item" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_not_equal_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contains_any_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_contained_in_requirement" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_logical_and_or_requirements" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_filter" time="0.000" /><testcase classname="tests.test_attribute_requirement" name="test_immutability" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_logs_issue_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_returns_value_without_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_exceeding_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_cancellation" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_when_cancelled" time="0.021" /><testcase classname="tests.test_auto_retry" name="test_async_uses_delay_with_errors" time="0.102" /><testcase classname="tests.test_auto_retry" name="test_async_uses_computed_delay_with_errors" time="0.106" /><testcase classname="tests.test_auto_retry" name="test_async_logs_issue_with_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_retries_with_selected_errors" time="0.001" /><testcase classname="tests.test_auto_retry" name="test_async_fails_with_not_selected_errors" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_cache_value_with_same_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_different_argument" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_limit_exceed" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_same_value_with_repeating_argument" time="0.000" /><testcase classname="tests.test_cache" name="test_fails_with_error" time="0.000" /><testcase classname="tests.test_cache" name="test_returns_fresh_value_with_expiration_time_exceed" time="0.020" /><testcase classname="tests.test_cache" name="test_async_returns_cache_value_with_same_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_different_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_limit_exceed" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_same_value_with_repeating_argument" time="0.001" /><testcase classname="tests.test_cache" name="test_async_returns_fresh_value_with_expiration_time_exceed" time="0.021" /><testcase classname="tests.test_cache" name="test_async_cancel_waiting_does_not_cancel_task" time="0.501" /><testcase classname="tests.test_cache" name="test_async_expiration_does_not_cancel_task" time="0.021" /><testcase classname="tests.test_cache" name="test_async_fails_with_error" time="0.001" /><testcase classname="tests.test_context" name="test_state_is_available_according_to_context" time="0.001" /><testcase classname="tests.test_context" name="test_state_update_updates_local_context" time="0.001" /><testcase classname="tests.test_context" name="test_exceptions_are_propagated" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_creation" time="0.000" /><testcase classname="tests.test_context_presets" name="test_preset_with_state" time="0.000" /><testcase classname="tests.test_context_presets" name="test_preset_with_disposable" time="0.000" /><testcase classname="tests.test_context_presets" name="test_preset_extended" time="0.000" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_with_static_state" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_with_state_factory" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_with_multiple_states_factory" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_with_disposables" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_with_multiple_disposables" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_prepare_mixed_state_and_disposables" time="0.001" /><testcase classname="tests.test_context_presets" name="test_registry_creation" time="0.000" /><testcase classname="tests.test_context_presets" name="test_registry_immutable" time="0.000" /><testcase classname="tests.test_context_presets" name="test_scope_with_preset" time="0.001" /><testcase classname="tests.test_context_presets" name="test_scope_preset_with_override" time="0.001" /><testcase classname="tests.test_context_presets" name="test_scope_preset_not_found" time="0.001" /><testcase classname="tests.test_context_presets" name="test_sync_scope_with_preset_fails" time="0.000" /><testcase classname="tests.test_context_presets" name="test_preset_with_async_state_factory" time="0.021" /><testcase classname="tests.test_context_presets" name="test_preset_with_disposable_lifecycle" time="0.001" /><testcase classname="tests.test_context_presets" name="test_nested_preset_registries" time="0.001" /><testcase classname="tests.test_context_presets" name="test_preset_with_mixed_state_sources" time="0.011" /><testcase classname="tests.test_disposables" name="test_empty_initialization" time="0.000" /><testcase classname="tests.test_disposables" name="test_single_disposable_initialization" time="0.000" /><testcase classname="tests.test_disposables" name="test_multiple_disposables_initialization" time="0.000" /><testcase classname="tests.test_disposables" name="test_cannot_set_attributes" time="0.000" /><testcase classname="tests.test_disposables" name="test_cannot_delete_attributes" time="0.000" /><testcase classname="tests.test_disposables" name="test_empty_disposables_is_falsy" time="0.000" /><testcase classname="tests.test_disposables" name="test_non_empty_disposables_is_truthy" time="0.000" /><testcase classname="tests.test_disposables" name="test_setup_with_no_disposables" time="0.001" /><testcase classname="tests.test_disposables" name="test_setup_with_disposable_returning_none" time="0.001" /><testcase classname="tests.test_disposables" name="test_setup_with_disposable_returning_single_state" time="0.001" /><testcase classname="tests.test_disposables" name="test_setup_with_disposable_returning_multiple_states" time="0.001" /><testcase classname="tests.test_disposables" name="test_setup_with_multiple_disposables_mixed_returns" time="0.001" /><testcase classname="tests.test_disposables" name="test_setup_sets_loop_correctly" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_with_no_disposables" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_with_successful_cleanup" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_with_exception_context" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_with_multiple_exceptions_creates_group" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_with_single_exception_is_risen" time="0.001" /><testcase classname="tests.test_disposables" name="test_dispose_resets_loop_even_on_exception" time="0.001" /><testcase classname="tests.test_disposables" name="test_same_loop_cleanup" time="0.001" /><testcase classname="tests.test_disposables" name="test_exception_during_setup_phase" time="0.001" /><testcase classname="tests.test_disposables" name="test_assertion_on_doubleprepare" time="0.001" /><testcase classname="tests.test_disposables" name="test_assertion_on_dispose_withoutprepare" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_processes_all_elements" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_preserves_order" time="0.302" /><testcase classname="tests.test_execute_concurrently" name="test_handles_empty_collection" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_propagates_handler_exceptions" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_returns_exceptions_when_configured" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_cancels_running_tasks_on_cancellation" time="0.101" /><testcase classname="tests.test_execute_concurrently" name="test_respects_concurrency_limit" time="0.202" /><testcase classname="tests.test_execute_concurrently" name="test_works_with_different_types" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_handles_mixed_success_and_failure" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_works_with_sets_and_tuples" time="0.001" /><testcase classname="tests.test_execute_concurrently" name="test_exception_details_preserved" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_processes_all_elements" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_concurrently" time="0.302" /><testcase classname="tests.test_process_concurrently" name="test_handles_empty_source" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_propagates_handler_exceptions" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_ignores_handler_exceptions_when_configured" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_handles_source_exception" time="0.001" /><testcase classname="tests.test_process_concurrently" name="test_cancels_running_tasks_on_cancellation" time="0.101" /><testcase classname="tests.test_process_concurrently" name="test_respects_concurrency_limit" time="0.202" /><testcase classname="tests.test_process_concurrently" name="test_processes_elements_from_queue" time="0.052" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments" time="0.002" /><testcase classname="tests.test_state" name="test_basic_initializes_with_defaults" time="0.001" /><testcase classname="tests.test_state" name="test_basic_equals_checks_properties" time="0.000" /><testcase classname="tests.test_state" name="test_basic_initializes_with_arguments_and_defaults" time="0.001" /><testcase classname="tests.test_state" name="test_parametrized_initializes_with_proper_parameters" time="0.000" /><testcase classname="tests.test_state" name="test_nested_initializes_with_proper_arguments" time="0.001" /><testcase classname="tests.test_state" name="test_dict_skips_missing_properties" time="0.000" /><testcase classname="tests.test_state" name="test_initialization_allows_missing_properties" time="0.000" /><testcase classname="tests.test_state" name="test_generic_subtypes_validation" time="0.002" /><testcase classname="tests.test_state" name="test_copying_leaves_same_object" time="0.000" /><testcase classname="tests.test_state" name="test_hash_consistency_with_missing_values" time="0.000" /><testcase classname="tests.test_state" name="test_hash_with_unhashable_attributes" time="0.001" /><testcase classname="tests.test_state" name="test_hash_with_dict_key_order_independence" time="0.000" /><testcase classname="tests.test_state" name="test_hash_with_custom_objects" time="0.000" /><testcase classname="tests.test_state" name="test_hash_performance_with_many_attributes" time="0.000" /><testcase classname="tests.test_state" name="test_hash_with_nested_unhashable_collections" time="0.000" /><testcase classname="tests.test_state" name="test_hash_stability_across_instances" time="0.000" /><testcase classname="tests.test_state" name="test_hash_excludes_missing_values" time="0.000" /><testcase classname="tests.test_state_typing" name="test_state_typing_subclass_and_instance_checks" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_basic_types" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_none_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_missing_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_literal_type" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_enum_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_sequence_type" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_set_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_mapping_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_tuple_type" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_union_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_callable_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_typed_dict" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_state_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_complex_types" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validator_recursive_state" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_generic_state" time="0.001" /><testcase classname="tests.test_state_validation" name="test_validation_error_messages" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validation_any_type" time="0.000" /><testcase classname="tests.test_state_validation" name="test_validator_with_defaults" time="0.000" /><testcase classname="tests.test_state_validation" name="test_attribute_validator_direct_usage" time="0.000" /><testcase classname="tests.test_state_validation" name="test_unsupported_type_annotation" time="0.000" /><testcase classname="tests.test_stream_concurrently" name="test_merges_two_streams" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_interleaves_based_on_timing" time="0.152" /><testcase classname="tests.test_stream_concurrently" name="test_handles_empty_iterators" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_handles_different_lengths" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_propagates_exceptions_from_source_a" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_propagates_exceptions_from_source_b" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_cancellation_cancels_both_sources" time="0.201" /><testcase classname="tests.test_stream_concurrently" name="test_works_with_different_types" time="0.001" /><testcase classname="tests.test_stream_concurrently" name="test_immediate_yield" time="0.601" /><testcase classname="tests.test_stream_concurrently" name="test_concurrent_execution" time="0.201" /><testcase classname="tests.test_streaming" name="test_fails_when_generator_fails" time="0.001" /><testcase classname="tests.test_streaming" name="test_cancels_when_iteration_cancels" time="0.001" /><testcase classname="tests.test_streaming" name="test_ends_when_generator_ends" time="0.001" /><testcase classname="tests.test_streaming" name="test_delivers_updates_when_generating" time="0.001" /><testcase classname="tests.test_streaming" name="test_streaming_context_variables_access_is_preserved" time="0.001" /><testcase classname="tests.test_streaming" name="test_nested_streaming_streams_correctly" time="0.001" /><testcase classname="tests.test_timeout" name="test_returns_result_when_returning_value" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_error" time="0.001" /><testcase classname="tests.test_timeout" name="test_raises_with_cancel" time="0.011" /><testcase classname="tests.test_timeout" name="test_raises_with_timeout" time="0.011" /></testsuite></testsuites>

{haiway-0.24.3 → haiway-0.25.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "haiway"
 description = "Framework for dependency injection and state management within structured concurrency model."
-version = "0.24.3"
+version = "0.25.0"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },

{haiway-0.24.3 → haiway-0.25.0}/src/haiway/__init__.py

@@ -1,4 +1,5 @@
 from haiway.context import (
+    ContextPresets,
     Disposable,
     Disposables,
     MissingContext,
@@ -26,7 +27,7 @@ from haiway.helpers import (
     timeout,
     traced,
 )
-from haiway.state import AttributePath, AttributeRequirement, State
+from haiway.state import AttributePath, AttributeRequirement, Immutable, State
 from haiway.types import (
     MISSING,
     Default,
@@ -64,12 +65,14 @@ __all__ = (
     "AsyncStream",
     "AttributePath",
     "AttributeRequirement",
+    "ContextPresets",
     "Default",
     "DefaultValue",
     "Disposable",
     "Disposables",
     "File",
     "FileAccess",
+    "Immutable",
     "LoggerObservability",
     "Missing",
     "MissingContext",

{haiway-0.24.3 → haiway-0.25.0}/src/haiway/context/__init__.py

@@ -14,12 +14,16 @@ from haiway.context.observability import (
     ObservabilityScopeExiting,
     ObservabilityTraceIdentifying,
 )
+from haiway.context.presets import ContextPresets
 from haiway.context.state import StateContext
 from haiway.context.types import MissingContext, MissingState
+from haiway.state import Immutable
 
 __all__ = (
+    "ContextPresets",
     "Disposable",
     "Disposables",
+    "Immutable",
     "MissingContext",
     "MissingState",
     "Observability",

{haiway-0.24.3 → haiway-0.25.0}/src/haiway/context/access.py

@@ -8,6 +8,7 @@ from collections.abc import (
     AsyncGenerator,
     AsyncIterator,
     Callable,
+    Collection,
     Coroutine,
     Iterable,
     Mapping,
@@ -24,16 +25,20 @@ from haiway.context.observability import (
     ObservabilityContext,
     ObservabilityLevel,
 )
+from haiway.context.presets import (
+    ContextPresets,
+    ContextPresetsRegistry,
+    ContextPresetsRegistryContext,
+)
 from haiway.context.state import ScopeState, StateContext
 from haiway.context.tasks import TaskGroupContext
-from haiway.state import State
+from haiway.state import Immutable, State
 from haiway.utils.stream import AsyncStream
 
 __all__ = ("ctx",)
 
 
-@final
-class ScopeContext:
+class ScopeContext(Immutable):
     """
     Context manager for executing code within a defined scope.
 
@@ -45,42 +50,62 @@ class ScopeContext:
     to create scope contexts.
     """
 
-    __slots__ = (
-        "_disposables",
-        "_identifier",
-        "_observability_context",
-        "_state_context",
-        "_task_group_context",
-    )
+    _identifier: ScopeIdentifier
+    _state: Collection[State]
+    _captured_state: Collection[State]
+    _resolved_state_context: StateContext | None
+    _disposables: Disposables | None
+    _presets: ContextPresets | None
+    _presets_disposables: Disposables | None
+    _observability_context: ObservabilityContext
+    _task_group_context: TaskGroupContext | None
 
     def __init__(
         self,
-        label: str,
+        name: str,
         task_group: TaskGroup | None,
         state: tuple[State, ...],
         disposables: Disposables | None,
         observability: Observability | Logger | None,
     ) -> None:
-        self._identifier: ScopeIdentifier
         object.__setattr__(
             self,
             "_identifier",
-            ScopeIdentifier.scope(label),
+            ScopeIdentifier.scope(name),
         )
-        # prepare state context to capture current state
-        self._state_context: StateContext
+        # store explicit state separately for priority control
         object.__setattr__(
             self,
-            "_state_context",
-            StateContext.updated(state),
+            "_state",
+            state,
+        )
+        # capture current contextual state (without new additions)
+        object.__setattr__(
+            self,
+            "_captured_state",
+            StateContext.current_state(),
+        )
+        # placeholder for temporary, resolved state context
+        object.__setattr__(
+            self,
+            "_resolved_state_context",
+            None,
         )
-        self._disposables: Disposables | None
         object.__setattr__(
             self,
             "_disposables",
             disposables,
         )
-        self._observability_context: ObservabilityContext
+        object.__setattr__(
+            self,
+            "_presets",
+            ContextPresetsRegistryContext.select(name),
+        )
+        object.__setattr__(
+            self,
+            "_presets_disposables",
+            None,
+        )
         object.__setattr__(
             self,
             "_observability_context",
@@ -90,7 +115,6 @@ class ScopeContext:
                 observability=observability,
             ),
         )
-        self._task_group_context: TaskGroupContext | None
         object.__setattr__(
             self,
             "_task_group_context",
@@ -99,35 +123,27 @@ class ScopeContext:
             else None,
         )
 
-    def __setattr__(
-        self,
-        name: str,
-        value: Any,
-    ) -> Any:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be modified"
-        )
-
-    def __delattr__(
-        self,
-        name: str,
-    ) -> None:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be deleted"
-        )
-
     def __enter__(self) -> str:
         assert (  # nosec: B101
             self._task_group_context is None or self._identifier.is_root
         ), "Can't enter synchronous context with task group"
         assert self._disposables is None, "Can't enter synchronous context with disposables"  # nosec: B101
+        assert self._resolved_state_context is None  # nosec: B101
+        assert self._presets is None, "Can't enter synchronous context with presets"  # nosec: B101
         self._identifier.__enter__()
         self._observability_context.__enter__()
-        self._state_context.__enter__()
+        # For sync context, only use explicit state (no presets or disposables allowed)
+        resolved_state_context: StateContext = StateContext(
+            _state=ScopeState((*self._captured_state, *self._state))
+        )
+        object.__setattr__(
+            self,
+            "_resolved_state_context",
+            resolved_state_context,
+        )
+        resolved_state_context.__enter__()
 
-        return self._observability_context.observability.trace_identifying(self._identifier).hex
+        return str(self._observability_context.observability.trace_identifying(self._identifier))
 
     def __exit__(
         self,
@@ -135,11 +151,17 @@ class ScopeContext:
         exc_val: BaseException | None,
         exc_tb: TracebackType | None,
     ) -> None:
-        self._state_context.__exit__(
+        assert self._resolved_state_context is not None  # nosec: B101
+        self._resolved_state_context.__exit__(
             exc_type=exc_type,
             exc_val=exc_val,
             exc_tb=exc_tb,
         )
+        object.__setattr__(
+            self,
+            "_resolved_state_context",
+            None,
+        )
         self._observability_context.__exit__(
             exc_type=exc_type,
             exc_val=exc_val,
@@ -152,31 +174,49 @@ class ScopeContext:
         )
 
     async def __aenter__(self) -> str:
+        assert self._presets_disposables is None  # nosec: B101
+        assert self._resolved_state_context is None  # nosec: B101
         self._identifier.__enter__()
         self._observability_context.__enter__()
 
         if task_group := self._task_group_context:
             await task_group.__aenter__()
 
-        # lazily initialize state to include disposables results
-        if disposables := self._disposables:
-            assert self._state_context._token is None  # nosec: B101
+        # Collect all state sources in priority order (lowest to highest priority)
+        collected_state: list[State] = []
+
+        # 1. Add contextual state first (lowest priority)
+        collected_state.extend(self._captured_state)
+
+        # 2. Add preset state (low priority, overrides contextual)
+        if self._presets is not None:
+            presets_disposables: Disposables = await self._presets.prepare()
             object.__setattr__(
                 self,
-                "_state_context",
-                StateContext(
-                    state=ScopeState(
-                        (
-                            *self._state_context._state._state.values(),
-                            *await disposables.prepare(),
-                        )
-                    ),
-                ),
+                "_presets_disposables",
+                presets_disposables,
             )
+            collected_state.extend(await presets_disposables.prepare())
+
+        # 3. Add explicit disposables state (medium priority)
+        if self._disposables is not None:
+            collected_state.extend(await self._disposables.prepare())
+
+        # 4. Add explicit state last (highest priority)
+        collected_state.extend(self._state)
+        # Create resolved state context with all collected state
+        resolved_state_context: StateContext = StateContext(
+            _state=ScopeState(tuple(collected_state))
+        )
 
-        self._state_context.__enter__()
+        resolved_state_context.__enter__()
+        object.__setattr__(
+            self,
+            "_resolved_state_context",
+            resolved_state_context,
+        )
 
-        return self._observability_context.observability.trace_identifying(self._identifier).hex
+        return str(self._observability_context.observability.trace_identifying(self._identifier))
 
     async def __aexit__(
         self,
@@ -184,12 +224,25 @@ class ScopeContext:
         exc_val: BaseException | None,
         exc_tb: TracebackType | None,
     ) -> None:
-        if disposables := self._disposables:
-            await disposables.dispose(
+        assert self._resolved_state_context is not None  # nosec: B101
+        if self._disposables is not None:
+            await self._disposables.dispose(
+                exc_type=exc_type,
+                exc_val=exc_val,
+                exc_tb=exc_tb,
+            )
+
+        if self._presets_disposables is not None:
+            await self._presets_disposables.dispose(
                 exc_type=exc_type,
                 exc_val=exc_val,
                 exc_tb=exc_tb,
             )
+            object.__setattr__(
+                self,
+                "_presets_disposables",
+                None,
+            )
 
         if task_group := self._task_group_context:
             await task_group.__aexit__(
@@ -198,11 +251,16 @@ class ScopeContext:
                 exc_tb=exc_tb,
             )
 
-        self._state_context.__exit__(
+        self._resolved_state_context.__exit__(
             exc_type=exc_type,
             exc_val=exc_val,
             exc_tb=exc_tb,
         )
+        object.__setattr__(
+            self,
+            "_resolved_state_context",
+            None,
+        )
 
         self._observability_context.__exit__(
             exc_type=exc_type,
@@ -258,9 +316,90 @@ class ctx:
         """
         return ObservabilityContext.trace_id(scope_identifier)
 
+    @staticmethod
+    def presets(
+        *presets: ContextPresets,
+    ) -> ContextPresetsRegistryContext:
+        """
+        Create a context manager for a preset registry.
+
+        This method creates a registry of context presets that can be used within
+        nested scopes. Presets allow you to define reusable combinations of state
+        and disposables that can be referenced by name when creating scopes.
+
+        When entering this context manager, the provided presets become available
+        for use with ctx.scope(). The presets are looked up by their name when
+        creating scopes.
+
+        Parameters
+        ----------
+        *presets: ContextPresets
+            Variable number of preset configurations to register. Each preset
+            must have a unique name within the registry.
+
+        Returns
+        -------
+        ContextPresetsRegistryContext
+            A context manager that makes the presets available in nested scopes
+
+        Examples
+        --------
+        Basic preset usage:
+
+        >>> from haiway import ctx, State
+        >>> from haiway.context import ContextPresets
+        >>>
+        >>> class ApiConfig(State):
+        ...     base_url: str
+        ...     timeout: int = 30
+        >>>
+        >>> # Define presets
+        >>> dev_preset = ContextPresets(
+        ...     name="development",
+        ...     _state=[ApiConfig(base_url="https://dev-api.example.com")]
+        ... )
+        >>>
+        >>> prod_preset = ContextPresets(
+        ...     name="production",
+        ...     _state=[ApiConfig(base_url="https://api.example.com", timeout=60)]
+        ... )
+        >>>
+        >>> # Use presets
+        >>> with ctx.presets(dev_preset, prod_preset):
+        ...     async with ctx.scope("development"):
+        ...         config = ctx.state(ApiConfig)
+        ...         assert config.base_url == "https://dev-api.example.com"
+
+        Nested preset registries:
+
+        >>> base_presets = [dev_preset, prod_preset]
+        >>> override_preset = ContextPresets(
+        ...     name="development",
+        ...     _state=[ApiConfig(base_url="https://staging.example.com")]
+        ... )
+        >>>
+        >>> with ctx.presets(*base_presets):
+        ...     # Outer registry has dev and prod presets
+        ...     with ctx.presets(override_preset):
+        ...         # Inner registry overrides dev preset
+        ...         async with ctx.scope("development"):
+        ...             config = ctx.state(ApiConfig)
+        ...             assert config.base_url == "https://staging.example.com"
+
+        See Also
+        --------
+        ContextPresets : For creating individual preset configurations
+        ctx.scope : For creating scopes that can use presets
+        """
+        return ContextPresetsRegistryContext(
+            registry=ContextPresetsRegistry(
+                presets=presets,
+            ),
+        )
+
     @staticmethod
     def scope(
-        label: str,
+        name: str,
         /,
         *state: State | None,
         disposables: Disposables | Iterable[Disposable] | None = None,
@@ -271,10 +410,22 @@ class ctx:
         Prepare scope context with given parameters. When called within an existing context\
          it becomes nested with current context as its parent.
 
+        State Priority System
+        ---------------------
+        State resolution follows a 4-layer priority system (highest to lowest):
+
+        1. **Explicit state** (passed to ctx.scope()) - HIGHEST priority
+        2. **Explicit disposables** (passed to ctx.scope()) - medium priority
+        3. **Preset state** (from presets) - low priority
+        4. **Contextual state** (from parent contexts) - LOWEST priority
+
+        When state types conflict, higher priority sources override lower priority ones.
+        State objects are resolved by type, with the highest priority instance winning.
+
         Parameters
         ----------
-        label: str
-            name of the scope context
+        name: str
+            name of the scope context, can be associated with state presets
 
         *state: State | None
             state propagated within the scope context, will be merged with current state by\
@@ -313,7 +464,7 @@ class ctx:
                 resolved_disposables = Disposables(*iterable)
 
         return ScopeContext(
-            label=label,
+            name=name,
             task_group=task_group,
             state=tuple(element for element in state if element is not None),
             disposables=resolved_disposables,