Struct SurfaceCaps 

pub struct SurfaceCaps {
    pub client_id: String,
    pub preset: Symbol,
    pub display: Expr,
    pub input: Expr,
    pub transport: Expr,
    pub privacy: Expr,
    pub codecs: Vec<Symbol>,
}

A surface’s advertised capabilities, as open metadata over Expr.

The four capability maps (display, input, transport, privacy) are open: a surface may carry fields beyond the well-known ones, and the ranker reads only the fields it understands. codecs lists the surface codecs the client can decode (lisp/json/bin/…).

Fields

client_id: String

A stable client identifier, e.g. "tty.local.1".

preset: Symbol

The preset name this surface is based on (surface/<preset>).

display: Expr

Display capabilities: cells/pixels, color, density, motion, budget.

input: Expr

Input capabilities: keyboard/pointer/touch/voice/camera/tap/…

transport: Expr

Transport capabilities: kind, round-trip, offline queue, ordering.

privacy: Expr

Privacy policy: redaction class, retention, private fields.

codecs: Vec<Symbol>

Surface codecs the client can decode, in preference order.

Implementations

impl SurfaceCaps

pub fn from_preset( preset_name: &str, client_id: impl Into<String>, ) -> Option<Self>

Builds caps from a preset name plus a concrete client_id.

Returns None when preset_name is not in SURFACE_PRESETS.

pub fn to_expr(&self) -> Expr

Encodes these caps as a surface/caps tagged Expr map.

pub fn from_expr(expr: &Expr) -> Result<Self, SurfaceError>

Parses caps from a surface/caps tagged Expr map, failing closed.

pub fn preset_name(&self) -> &str

Returns the unqualified preset name (cli, watch, …).

pub fn input_flag(&self, name: &str) -> bool

Reads a boolean input capability flag, defaulting to false.

pub fn display_density(&self) -> Option<Symbol>

Reads the display density symbol (glance/compact/regular/dense).

pub fn accepts_codec(&self, codec: &str) -> bool

Whether this surface can decode the named surface codec.

Trait Implementations

impl Clone for SurfaceCaps

fn clone(&self) -> SurfaceCaps

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SurfaceCaps

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SurfaceCaps

fn eq(&self, other: &SurfaceCaps) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SurfaceCaps