use serde::{Deserialize, Serialize};
use crate::a11y::A11yCapability;
use crate::routing::SurfaceContractMode;
use crate::surface_engine::WebSurfaceCapabilities;
mod builtin;
pub use builtin::{default_declarations, external_protocol_declaration};
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct PresentationDeclaration {
pub id: String,
#[serde(default)]
pub presents: Presents,
pub reaches: Reaches,
#[serde(default)]
pub accepts: Accepts,
#[serde(default)]
pub operations: Vec<Operation>,
}
#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct Presents {
#[serde(default)]
pub schemes: Vec<String>,
#[serde(default)]
pub content_types: Vec<String>,
#[serde(default)]
pub extensions: Vec<String>,
}
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub struct Reaches {
pub mode: SurfaceContractMode,
pub a11y: A11yCapability,
#[serde(default)]
pub producer: Option<Box<WebSurfaceCapabilities>>,
}
#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct Accepts {
#[serde(default)]
pub source_edits: bool,
#[serde(default)]
pub commands: Vec<String>,
}
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "kebab-case")]
pub enum Operation {
Inspect,
Annotate,
Reclip,
Open,
Play,
Edit,
Apply,
}
impl PresentationDeclaration {
pub fn reader(id: impl Into<String>) -> Self {
Self::with_reach(id, A11yCapability::Full)
}
pub fn surface(id: impl Into<String>) -> Self {
Self::with_reach(id, A11yCapability::Opaque)
}
fn with_reach(id: impl Into<String>, a11y: A11yCapability) -> Self {
Self {
id: id.into(),
presents: Presents::default(),
reaches: Reaches {
mode: SurfaceContractMode::CompositedTexture,
a11y,
producer: None,
},
accepts: Accepts::default(),
operations: Vec::new(),
}
}
pub fn schemes(mut self, schemes: impl IntoIterator<Item = impl Into<String>>) -> Self {
self.presents.schemes = schemes.into_iter().map(Into::into).collect();
self
}
pub fn content_types(mut self, types: impl IntoIterator<Item = impl Into<String>>) -> Self {
self.presents.content_types = types.into_iter().map(Into::into).collect();
self
}
pub fn extensions(mut self, extensions: impl IntoIterator<Item = impl Into<String>>) -> Self {
self.presents.extensions = extensions.into_iter().map(Into::into).collect();
self
}
pub fn mode(mut self, mode: SurfaceContractMode) -> Self {
self.reaches.mode = mode;
self
}
pub fn a11y(mut self, a11y: A11yCapability) -> Self {
self.reaches.a11y = a11y;
self
}
pub fn exposing(mut self, operations: impl IntoIterator<Item = Operation>) -> Self {
self.operations = operations.into_iter().collect();
self
}
pub fn presents_nothing(&self) -> bool {
let presents = &self.presents;
presents.schemes.is_empty()
&& presents.content_types.is_empty()
&& presents.extensions.is_empty()
}
}
#[cfg(test)]
mod tests;