Add beta Documentation

src/.documentation/cache/summaries/NexusReader.UI.Shared__Services__IFocusModeService.cs.json

@@ -0,0 +1 @@
+{"path":"NexusReader.UI.Shared/Services/IFocusModeService.cs","purpose":"Defines an abstraction for a UI focus mode service used by shared UI code to query, initialize, toggle, and observe focus-mode state.","classification":{"role":"service","layer":"frontend","confidence":0.85,"evidence":["Service naming pattern","Application/service path heuristic","Namespace NexusReader.UI.Shared.Services indicates a shared UI service","Interface name IFocusModeService and methods InitializeAsync/ToggleAsync imply UI-state management"]},"className":"IFocusModeService","methods":[{"name":"IsFocusModeActive","line":5,"endLine":5,"signature":"get IsFocusModeActive() -> bool","purpose":"Exposes whether focus mode is currently active (read-only).","calls":[],"actions":[{"id":"accessor_5","kind":"mapping","label":"Read-only boolean property","line":5,"detail":"Provides synchronous read access to the current focus-mode state.","visibility":"detail-only","confidence":0.7}]},{"name":"OnFocusModeChanged","line":6,"endLine":6,"signature":"event Func<Task>? OnFocusModeChanged","purpose":"Event subscribers are notified when focus mode changes; implementations should invoke this when state changes.","calls":[],"actions":[{"id":"event_6","kind":"mapping","label":"Publish/subscribe event","line":6,"detail":"Allows components to subscribe to asynchronous notifications about focus-mode changes.","visibility":"detail-only","confidence":0.7}]},{"name":"InitializeAsync","line":7,"endLine":7,"signature":"() -> Task","purpose":"Initialization hook for the focus-mode service (e.g., restore persisted state, subscribe to lifecycle events).","calls":[],"actions":[{"id":"startup_7","kind":"mapping","label":"Initialization entrypoint","line":7,"detail":"Declared initialization method; concrete implementations likely perform startup reads, subscription setup, or state restoration and may fire OnFocusModeChanged.","visibility":"detail-only","confidence":0.7}]},{"name":"ToggleAsync","line":8,"endLine":8,"signature":"() -> Task","purpose":"Toggles the focus-mode state and notifies subscribers of the change.","calls":[],"actions":[{"id":"orchestration_8","kind":"mapping","label":"Toggle operation","line":8,"detail":"Declared toggle command; typical implementations will flip state, persist it, and invoke OnFocusModeChanged.","visibility":"detail-only","confidence":0.7}]}],"types":[{"name":"IFocusModeService","kind":"interface","line":3,"purpose":"Abstraction for controlling and observing a UI focus mode across shared UI clients.","fields":[{"name":"IsFocusModeActive","type":"bool","required":true,"line":5,"description":"Read-only flag indicating if focus mode is active."},{"name":"OnFocusModeChanged","type":"Func<Task>?","required":false,"line":6,"description":"Asynchronous event invoked when focus-mode state changes; nullable to allow no subscribers."},{"name":"InitializeAsync","type":"Task","required":true,"line":7,"description":"Async initialization method for the service implementation."},{"name":"ToggleAsync","type":"Task","required":true,"line":8,"description":"Async method to toggle focus mode state."}]}],"serviceRegistrations":[],"startupActions":[],"dependencies":[],"patterns":["Service","Observer/Event"],"domainConcepts":["FocusMode","UI state"],"keyDetails":"Interface is a small contract for UI state management; all runtime behavior is implementation-defined (initialize, toggle, and event publication).","orchestrationMethods":[],"typedContracts":[{"name":"IFocusModeService","kind":"interface","line":3,"fieldCount":4,"evidencePaths":["NexusReader.UI.Shared/Services/IFocusModeService.cs"]}],"persistenceInteractions":[],"externalInteractions":[],"evidenceAnchors":[{"kind":"typed-contract","label":"IFocusModeService","line":3,"summary":"interface with 4 fields.","confidence":0.8,"evidencePaths":["NexusReader.UI.Shared/Services/IFocusModeService.cs"]}]}