FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.
C++ ai-agentsalgorithmic-tradingbloomberg-terminalcppfinancefinancial-marketsfintechgood-first-issueinvestmentinvestment-researchmachine-learningopensourcepythonqtquantitative-financestock-markettrading
#pragma once
#include "core/identity/Uuid.h"
#include "core/layout/LayoutTypes.h"
#include <QString>
namespace fincept::layout {
/// Phase 6 final: shell-level Workspace capture/apply helpers.
///
/// These walk `WindowRegistry` (every live `WindowFrame`) and either
/// gather their `FrameLayout`s into a `Workspace`, or take a saved
/// `Workspace` and apply each of its FrameLayouts to existing or
/// freshly-spawned frames.
///
/// `capture` also captures the current monitor topology and stores
/// per-frame geometry into a `WorkspaceVariant`, so the workspace
/// becomes self-contained for the desk-vs-laptop variant matcher
/// (decision 4.5).
///
/// `apply` consults `WorkspaceMatcher::match` to pick the variant that
/// best fits the current monitor topology, then applies frame
/// geometries from that variant after each frame's `apply_layout`
/// finishes restoring its dock contents.
class WorkspaceShell {
public:
/// Capture the current shell state into a `Workspace`. The returned
/// Workspace gets a fresh UUID + updated_at timestamp and a
/// `WorkspaceVariant` for the current monitor topology.
///
/// `name` and `kind` populate the Workspace metadata. If `previous`
/// is provided, its UUID + variants list are preserved (so adding
/// a new variant for a different monitor topology doesn't lose the
/// existing variants).
static Workspace capture(const QString& name, const QString& kind = "user", const Workspace* previous = nullptr);
/// Apply a saved Workspace to the current shell. Walks the workspace's
/// frames, reuses existing frames where window UUIDs match, spawns
/// new frames otherwise. Each frame's apply_layout restores dock
/// contents. The matched WorkspaceVariant (via WorkspaceMatcher)
/// supplies frame geometries.
///
/// Returns the number of frames successfully applied.
static int apply(const Workspace& workspace);
/// Name of the most recently applied workspace this session. Empty if
/// nothing has been applied yet. Updated by `apply()` on success.
/// Drives the title bar suffix.
static QString current_name();
/// UUID of the most recently applied workspace this session. Null if
/// nothing applied yet. Drives the toolbar's "Save Layout" (vs "Save
/// Layout As…") decision.
static LayoutId current_id();
/// Reset the process-wide "currently loaded" pointers (`current_name` /
/// `current_id`). Called by `LayoutCatalog::remove_layout` when the
/// deleted layout is the currently-loaded one (so the title bar suffix
/// and the toolbar's Save-vs-Save-As decision don't keep pointing at a
/// dead UUID), and by `TerminalShell::shutdown` for hygiene.
static void clear_current();
/// Cold-boot restore. Tries, in order:
/// 1. `LayoutCatalog::last_loaded_id()` → `load_workspace` → `apply`
/// 2. Most recent `kind='auto'` snapshot from the
/// `TerminalShell::snapshot_ring()` → `apply`
/// 3. No-op (first run / fresh profile — Launchpad's template picker
/// handles this case).
/// Returns the number of frames restored (0 if nothing restored).
/// Safe to call before any frame exists; will spawn frames as needed
/// via the standard `apply()` path.
static int load_last_or_default();
};
} // namespace fincept::layout