fresh_core/
lib.rs

1use serde::{Deserialize, Serialize};
2
3use ts_rs::TS;
4
5/// Unique identifier for a cursor
6#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize, TS)]
7#[ts(export)]
8pub struct CursorId(pub usize);
9
10impl CursorId {
11    /// Sentinel value used for inverse events during undo/redo
12    /// This indicates that the event shouldn't move any cursor
13    pub const UNDO_SENTINEL: CursorId = CursorId(usize::MAX);
14}
15
16/// Unique identifier for a split pane (leaf or container)
17#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize, TS)]
18#[ts(export)]
19pub struct SplitId(pub usize);
20
21/// A split pane that displays a buffer (leaf node in the split tree)
22#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
23pub struct LeafId(pub SplitId);
24
25impl From<LeafId> for SplitId {
26    fn from(id: LeafId) -> Self {
27        id.0
28    }
29}
30
31/// A split container that holds two children (internal node in the split tree)
32#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
33pub struct ContainerId(pub SplitId);
34
35impl From<ContainerId> for SplitId {
36    fn from(id: ContainerId) -> Self {
37        id.0
38    }
39}
40
41/// Unique identifier for a buffer
42#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
43#[serde(transparent)]
44#[derive(TS)]
45#[ts(export)]
46pub struct BufferId(pub usize);
47
48/// Direction of a split
49#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, TS)]
50#[ts(export)]
51pub enum SplitDirection {
52    Horizontal,
53    Vertical,
54}
55
56pub mod action;
57pub mod api;
58pub mod command;
59pub mod hooks;
60
61/// Unique identifier for a terminal session
62#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, serde::Serialize, serde::Deserialize, TS)]
63#[ts(export)]
64pub struct TerminalId(pub usize);
65
66impl std::fmt::Display for TerminalId {
67    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
68        write!(f, "Terminal-{}", self.0)
69    }
70}
71
72/// Unique identifier for an editor `Window` — a project-rooted unit
73/// of editor state (file tree, LSP set, splits, buffer set, …) that
74/// the user can switch between as a whole. Modelled on a VS Code
75/// window. See `docs/internal/orchestrator-sessions-design.md`.
76///
77/// Windows are 1-indexed; the editor always boots with id=1 (the
78/// "base" window) so the previous single-root behaviour is the
79/// WindowId(1) special case. Ids are stable within a process and
80/// monotonic — closing a window does not free its id.
81///
82/// Note on naming: Orchestrator presents windows as "agent sessions"
83/// in its UX (matching the parallel-agents domain language), but
84/// internally the editor calls them windows to disambiguate from
85/// Fresh's pre-existing workspace-recovery and config-layer
86/// "session" concepts.
87#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, serde::Serialize, serde::Deserialize, TS)]
88#[ts(export)]
89pub struct WindowId(pub u64);
90
91impl std::fmt::Display for WindowId {
92    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
93        write!(f, "Window-{}", self.0)
94    }
95}
96pub mod config;
97pub mod file_explorer;
98pub mod file_uri;
99pub mod menu;
100pub mod overlay;
101pub mod services;
102pub mod text_property;
103
104#[cfg(test)]
105mod tests {
106    use super::*;
107
108    #[test]
109    fn terminal_id_display_format() {
110        assert_eq!(TerminalId(0).to_string(), "Terminal-0");
111        assert_eq!(TerminalId(42).to_string(), "Terminal-42");
112    }
113
114    #[test]
115    fn window_id_display_format() {
116        assert_eq!(WindowId(1).to_string(), "Window-1");
117        assert_eq!(WindowId(42).to_string(), "Window-42");
118    }
119}
fresh_core/lib.rs

fresh_core/
lib.rs
