tear_types/
lib.rs

1//! `tear-types` — pure typed domain for the tear multiplexer.
2//!
3//! Owns the typed primitives ([`TearSession`], [`TearWindow`],
4//! [`TearPane`], [`LayoutNode`], [`KeyTable`], [`StatusBar`],
5//! [`TearTheme`]) plus the [`MultiplexerControl`] trait that every
6//! backend (in-process, local daemon, remote SSH, tmux passthrough)
7//! implements.
8//!
9//! **No I/O. No subprocess. No filesystem.** Just types + serde.
10//!
11//! ## Why this crate exists at all
12//!
13//! `mado` (the pleme-io GPU terminal emulator) and `tear` (this
14//! multiplexer) both need to model panes, windows, sessions, splits,
15//! key tables, and status bars. Without a shared typed surface the
16//! two apps would each grow their own duplicated `Pane` /
17//! `WindowState` types — typical fleet drift. Putting the canonical
18//! types here lets:
19//!
20//! 1. `mado` consume the same [`PaneId`] / [`WindowId`] it would
21//!    receive from a remote `tear-daemon`, so tier-2 (mado driving a
22//!    remote tear) and tier-3 (mado embedding `tear-core` in-process)
23//!    speak the same vocabulary.
24//! 2. Third-party drivers (a TUI status bar, a Slack notifier, a JIT
25//!    pane-snapshot exporter) can implement [`MultiplexerControl`]
26//!    against this crate alone — no runtime dep, no GPU surface, no
27//!    tmux dep.
28//! 3. The compounding directive's "solve once" rule applies — the
29//!    next consumer (a hypothetical `gunma` shell-replay tool, a
30//!    fleet pane-monitor) gets these types for free.
31//!
32//! ## What lives here vs. elsewhere
33//!
34//! Pure data + the trait surface. Anything that opens a PTY or talks
35//! to disk lives in `tear-core`. Anything that opens a socket or
36//! speaks RPC lives in `tear-daemon` / `tear-client`.
37
38#![forbid(unsafe_code)]
39#![doc(html_root_url = "https://docs.rs/tear-types/0.1.0")]
40
41pub mod block;
42pub mod capability;
43pub mod cast;
44pub mod control;
45#[cfg(feature = "engate")]
46pub mod engate_wrap;
47pub mod direction;
48pub mod freio;
49pub mod geometry;
50pub mod graphics;
51pub mod host_role;
52pub mod id;
53pub mod keybind;
54pub mod layout;
55pub mod live;
56pub mod modes;
57pub mod pane;
58pub mod plan;
59pub mod path;
60pub mod pane_snapshot;
61pub mod session;
62pub mod shutai;
63pub mod spawn_env;
64pub mod statusbar;
65pub mod theme;
66pub mod window;
67pub mod wire;
68pub mod yurai;
69
70pub use capability::{Capability, DaemonHello, DaemonIdentity};
71pub use control::{ControlError, ControlResult, MultiplexerControl};
72pub use direction::{Direction, SplitOrientation};
73pub use geometry::Rect;
74pub use freio::{Admission, Freio, RefusalReason};
75pub use graphics::{Graphic, GraphicProtocol, GRAPHIC_PAYLOAD_MAX};
76pub use host_role::{HostRole, TearCaps};
77pub use modes::{ModeSet, MouseTracking};
78pub use shutai::{Attested, Declared, Shutai};
79pub use yurai::Yurai;
80pub use id::{DefinitionId, InstanceId, PaneId, SessionId, WindowId};
81pub use keybind::{Action, KeyBind, KeyChord, KeyTable, KeyTableName};
82pub use layout::{LayoutError, LayoutKind, LayoutNode, LeafRemoval, Size, MIN_RATIO};
83pub use live::{Durability, LiveSession};
84pub use plan::{LayoutPlan, PaneSlot, PlanError, SpawnSpec, WindowPlan};
85pub use block::Block;
86pub use cast::{CastParseError, CastRow, CastRowKind};
87pub use pane::{InputPolicy, PaneState, PaneStats, TearPane};
88pub use pane_snapshot::{
89    ansi_256_color, default_ansi_palette, Cell, CellAttrs, Color, PaneSnapshot, ANSI_BRIGHT_COLORS,
90    ANSI_COLORS,
91};
92pub use session::{SessionSource, SessionState, TearSession};
93pub use spawn_env::SpawnEnv;
94pub use statusbar::{Segment, SegmentAlignment, SignalRenderMode, StatusBar, TearSignalKind};
95pub use theme::HexColor;
96pub use theme::TearTheme;
97pub use window::{TearWindow, WindowState};
tear_types/lib.rs

tear_types/
lib.rs
