servo/components/devtools/actors/inspector/layout.rs

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */

//! The layout actor informs the DevTools client of the layout properties of the document, such as
//! grids or flexboxes. It acts as a placeholder for now.

use serde::Serialize;
use serde_json::{Map, Value};

use crate::StreamId;
use crate::actor::{Actor, ActorError, ActorRegistry};
use crate::protocol::ClientRequest;

#[derive(Serialize)]
pub struct LayoutInspectorActorMsg {
    actor: String,
}

pub struct LayoutInspectorActor {
    name: String,
}

#[derive(Serialize)]
pub struct GetGridsReply {
    from: String,
    grids: Vec<String>,
}

#[derive(Serialize)]
pub struct GetCurrentFlexboxReply {
    from: String,
    flexbox: Option<()>,
}

impl Actor for LayoutInspectorActor {
    fn name(&self) -> String {
        self.name.clone()
    }

    /// The layout inspector actor can handle the following messages:
    ///
    /// - `getGrids`: Returns a list of CSS grids, non functional at the moment
    ///
    /// - `getCurrentFlexbox`: Returns the active flexbox, non functional at the moment
    fn handle_message(
        &self,
        request: ClientRequest,
        _registry: &ActorRegistry,
        msg_type: &str,
        _msg: &Map<String, Value>,
        _id: StreamId,
    ) -> Result<(), ActorError> {
        match msg_type {
            "getGrids" => {
                let msg = GetGridsReply {
                    from: self.name(),
                    // TODO: Actually create a list of grids
                    grids: vec![],
                };
                request.reply_final(&msg)?
            },
            "getCurrentFlexbox" => {
                let msg = GetCurrentFlexboxReply {
                    from: self.name(),
                    // TODO: Create and return the current flexbox object
                    flexbox: None,
                };
                request.reply_final(&msg)?
            },
            _ => return Err(ActorError::UnrecognizedPacketType),
        };
        Ok(())
    }

    fn cleanup(&self, _id: StreamId) {}
}

impl LayoutInspectorActor {
    pub fn new(name: String) -> Self {
        Self { name }
    }

    pub fn encodable(&self) -> LayoutInspectorActorMsg {
        LayoutInspectorActorMsg { actor: self.name() }
    }
}