Chat readme & comments

This commit is contained in:
nworbnhoj 2023-09-01 05:41:40 +10:00
parent f9c9521c8a
commit c7c0041922
5 changed files with 308 additions and 45 deletions

28
libs/chat/src/README.md Normal file
View file

@ -0,0 +1,28 @@
# chat lib
This Chat library provides a generic Chat UI to read a series of Posts in a Dialogue stored in the pddb - and to Author a new Post.
The idea is to provide a solid common Xous Chat interface, so that Chat Apps can concentrate on the unique protocols of each platform (such as Matrix or Signal).
This is a work-in-progress accepting all contributions from ideas and discussion, thru to pull-requests.
## UI User Interface
A Dialogue of Posts appears as a cascade of "speech bubbles" with the most recent at the bottom. The user can use the up/down ↑↓ keys to scroll up/down thru the Posts. One Post will be hilited/selected and the right → key will provide options to reply, edit, delete etc. The left ← key will show the Chat App menu to login, logout, change conversation etc.
A new Post may be authored in the input area at the bottom of the screen.
The Chat UI can provide read-only access to Dialogues in the pddb when offline.
## Integration
A Chat App will typically call `Chat::new()` to setup a Chat UI server, and a 2 way connection between the Chat App server and the Chat UI server. The Chat UI can raise a menu on behalf of the Chat App, allowing for protocol specific actions. The Chat App can receive messages representing:
* a new outbound user Post
* key UI events, such as F1 click, Left click, Top Post, etc,
* raw keystrokes.
The Chat App will next typically call `Chat::dialogue_set()` with a pddb dict and key holding a Dialogue of Posts.
When the Chat App receives a new Post from the Platform, it will call Chat::post_add() to have it saved in the pddb, and displayed.

View file

@ -10,22 +10,25 @@ pub const POST_SELECTED_PREV: usize = usize::MAX - 1;
#[derive(Debug, num_derive::FromPrimitive, num_derive::ToPrimitive)] #[derive(Debug, num_derive::FromPrimitive, num_derive::ToPrimitive)]
pub enum ChatOp { pub enum ChatOp {
// Sve the Dialogue to pddb (ie after PostAdd, PostDelete) // Save the Dialogue to pddb (ie after PostAdd, PostDelete)
DialogueSave = 0, DialogueSave = 0,
/// /// Set the current Dialogue to be displayed
DialogueSet, DialogueSet,
/// /// change the Chat UI in/out of focus
GamChangeFocus, GamChangeFocus,
/// a line of text has arrived /// a line of text has arrived
GamLine, GamLine,
/// receive rawkeys from gam /// receive rawkeys from gam
GamRawkeys, GamRawkeys,
/// redraw our UI /// redraw our Chat UI
GamRedraw, GamRedraw,
Icontray, /// Add a new MenuItem to the App menu
MenuAdd, MenuAdd,
/// Add a new Post to the Dialogue
PostAdd, PostAdd,
/// Delete a Post from the Dialogue
PostDel, PostDel,
/// Find a Post by timestamp and Author
PostFind, PostFind,
PostFlag, PostFlag,
UiButton, UiButton,
@ -65,6 +68,7 @@ pub struct Post {
pub attach_url: Option<xous_ipc::String<128>>, pub attach_url: Option<xous_ipc::String<128>>,
} }
/// Events are sent to the Chat App when key things occur in the Chat UI
#[derive(Debug, num_derive::FromPrimitive, num_derive::ToPrimitive)] #[derive(Debug, num_derive::FromPrimitive, num_derive::ToPrimitive)]
pub enum Event { pub enum Event {
Focus, Focus,

View file

@ -15,17 +15,28 @@ use std::io::{Error, ErrorKind};
pub const MAX_BYTES: usize = 4000; pub const MAX_BYTES: usize = 4000;
/// A Dialogue is a generic representation of a series of Posts
/// This might represent a room, group, or direct-message conversation
#[derive(Archive, Serialize, Deserialize, Debug)] #[derive(Archive, Serialize, Deserialize, Debug)]
pub struct Dialogue { pub struct Dialogue {
/// A title of the Dialogue
pub title: String, pub title: String,
/// A time ordered sequence of posts in the Dialogue
posts: Vec<Post>, posts: Vec<Post>,
/// An index of unique Author id's (internal)
authors: HashMap<u16, Author>, authors: HashMap<u16, Author>,
/// A lookup on Author names
author_lookup: HashMap<String, u16>, author_lookup: HashMap<String, u16>,
/// The timestamp on the most recent Post
last_timestamp: u64, last_timestamp: u64,
/// The id assigned to the most recent new Author
last_author_id: u16, last_author_id: u16,
} }
impl Dialogue { impl Dialogue {
/// Creates a new Dialogue with a single Author.
/// Author id=0 is assigned to the user of this Chat App.
pub fn new(title: &str) -> Self { pub fn new(title: &str) -> Self {
let first_author_id = 0; let first_author_id = 0;
let author = Author::new("me"); let author = Author::new("me");
@ -41,10 +52,19 @@ impl Dialogue {
} }
} }
// add a new post to the dialog /// Add a new Post to the Dialogue
// note: posts are sorted by timestamp, so: ///
// - add post at beginning or end is fast (middle triggers a binary partition) /// note: posts are sorted by timestamp, so:
// - if adding multiple posts then add oldest/newest last! /// - `post_add` at beginning or end is fast (middle triggers a binary partition)
/// - if adding multiple posts then add oldest/newest last!
///
/// # Arguments
///
/// * `author` - the name of the Author of the Post
/// * `timestamp` - the timestamp of the Post
/// * `text` - the text content of the Post
/// * `attach_url` - a url of an attachment (image for example)
///
pub fn post_add( pub fn post_add(
&mut self, &mut self,
author: &str, author: &str,
@ -72,6 +92,8 @@ impl Dialogue {
self.posts.insert(0, new); self.posts.insert(0, new);
} else { } else {
log::info!("{:?}", new); log::info!("{:?}", new);
// insert a new post in the correct position
// OR replace an existing post with matching timestamp & author
let i = self.posts.partition_point(|p| p.timestamp() < new_ts); let i = self.posts.partition_point(|p| p.timestamp() < new_ts);
let last = self.posts.len() - 1; let last = self.posts.len() - 1;
for n in i..last { for n in i..last {
@ -96,6 +118,13 @@ impl Dialogue {
} }
} }
/// Returns Some(index) of a matching Post by Author and Timestamp, or None
///
/// # Arguments
///
/// * `timestamp` - the Post timestamp criteria
/// * `author` - the Post Author criteria
///
pub fn post_find(&self, author: &str, timestamp: u64) -> Option<usize> { pub fn post_find(&self, author: &str, timestamp: u64) -> Option<usize> {
if let Some(author_id) = self.author_lookup.get(author) { if let Some(author_id) = self.author_lookup.get(author) {
let i = self.posts.partition_point(|p| p.timestamp() < timestamp); let i = self.posts.partition_point(|p| p.timestamp() < timestamp);
@ -115,12 +144,18 @@ impl Dialogue {
None None
} }
// return an arbitrary post in the dialogue by index /// Return Some<Post> by index in the Dialogue, or None.
///
/// # Arguments
///
/// * `index` - the index of the required Post
///
pub fn post_get(&self, index: usize) -> Option<&Post> { pub fn post_get(&self, index: usize) -> Option<&Post> {
self.posts.get(index) self.posts.get(index)
} }
// return the index of the most recent post in the dialogue /// Return the index of the most recent Post in the Dialogue
///
pub fn post_last(&self) -> Option<usize> { pub fn post_last(&self) -> Option<usize> {
if self.posts.len() == 0 { if self.posts.len() == 0 {
None None
@ -129,15 +164,29 @@ impl Dialogue {
} }
} }
/// Return an iterator over the Dialogue Posts (oldest first)
///
pub fn posts(&self) -> Iter<Post> { pub fn posts(&self) -> Iter<Post> {
return self.posts.iter(); return self.posts.iter();
} }
/// Return Some<Author> by id, or None.
///
/// # Arguments
///
/// * `id` - the index of the required Author
///
pub fn author(&self, id: u16) -> Option<&Author> { pub fn author(&self, id: u16) -> Option<&Author> {
self.authors.get(&id) self.authors.get(&id)
} }
// get internal author_id for external author str
/// Return Some<author_id> by Author name, or None.
///
/// # Arguments
///
/// * `author` - the (external) name of the Author
///
pub fn author_id(&mut self, author: &str) -> Option<u16> { pub fn author_id(&mut self, author: &str) -> Option<u16> {
match self.author_lookup.get(author) { match self.author_lookup.get(author) {
Some(id) => Some(*id), Some(id) => Some(*id),
@ -153,7 +202,8 @@ impl Dialogue {
} }
} }
// assign the next available interanl author_id /// Assign and Return Some<author_id>, or None
///
fn author_id_next(&mut self) -> Option<u16> { fn author_id_next(&mut self) -> Option<u16> {
if self.last_author_id < u16::max_value() { if self.last_author_id < u16::max_value() {
self.last_author_id += 1; self.last_author_id += 1;

View file

@ -19,6 +19,18 @@ pub struct Chat {
} }
impl Chat { impl Chat {
/// Create a new Chat UI
///
/// # Arguments
///
/// * `app_name` - registered with GAM
/// * `app_menu` - with menu items handled by the Chat App rather than the Chat UI
/// * `app_cid` - to accept messages from the Chat UI (see below)
/// * `post_opcode` - to handle a `MemoryMessage` containing a new outbound user Post
/// * `event_opcode` - to handle `ScalarMessage` representing a UI Event, such as F1 click, Left click, Top Post, etc.
/// * `rawkeys_opcode` - to handle a raw-keystroke.
///
pub fn new( pub fn new(
app_name: &'static str, app_name: &'static str,
app_menu: &'static str, app_menu: &'static str,
@ -48,17 +60,34 @@ impl Chat {
Chat { cid: chat_cid } Chat { cid: chat_cid }
} }
/// Return the Chat App CID
///
/// This cid allows the Chat App to contact this Chat UI server
///
pub fn cid(&self) -> CID { pub fn cid(&self) -> CID {
self.cid self.cid
} }
/// Create an offline/read-only Chat UI over and existing Dialogue in pddb
///
/// # Arguments
///
/// * `pddb_dict` - the pddb dict holding all Dialogues for this Chat App
/// * `pddb_key` - the pddb key holding a Dialogue
///
pub fn read_only(pddb_dict: &str, pddb_key: Option<&str>) -> Self { pub fn read_only(pddb_dict: &str, pddb_key: Option<&str>) -> Self {
let chat = Chat::new("_Chat Read_", "unused", None, None, None, None); let chat = Chat::new("_Chat Read_", "unused", None, None, None, None);
chat.dialogue_set(pddb_dict, pddb_key).unwrap(); chat.dialogue_set(pddb_dict, pddb_key).unwrap();
chat chat
} }
// set the current Dialogue /// Set the current Dialogue
///
/// # Arguments
///
/// * `pddb_dict` - the pddb dict holding all Dialogues for this Chat App
/// * `pddb_key` - the pddb key holding a Dialogue
///
pub fn dialogue_set(&self, pddb_dict: &str, pddb_key: Option<&str>) -> Result<(), Error> { pub fn dialogue_set(&self, pddb_dict: &str, pddb_key: Option<&str>) -> Result<(), Error> {
let dialogue = api::Dialogue { let dialogue = api::Dialogue {
dict: xous_ipc::String::from_str(pddb_dict), dict: xous_ipc::String::from_str(pddb_dict),
@ -70,6 +99,12 @@ impl Chat {
} }
} }
/// Add a new MenuItem to the App menu
///
/// # Arguments
///
/// * `item` - an item action not handled by the Chat UI
///
pub fn menu_add(&self, item: MenuItem) -> Result<(), Error> { pub fn menu_add(&self, item: MenuItem) -> Result<(), Error> {
match Buffer::into_buf(item) { match Buffer::into_buf(item) {
Ok(buf) => buf.send(self.cid, ChatOp::MenuAdd as u32).map(|_| ()), Ok(buf) => buf.send(self.cid, ChatOp::MenuAdd as u32).map(|_| ()),
@ -77,7 +112,19 @@ impl Chat {
} }
} }
// add a new Post to the current Dialogue /// Add a new Post to the current Dialogue
///
/// note: posts are sorted by timestamp, so:
/// - `post_add` at beginning or end is fast (middle triggers a binary partition)
/// - if adding multiple posts then add oldest/newest last!
///
/// # Arguments
///
/// * `author` - the name of the Author of the Post
/// * `timestamp` - the timestamp of the Post
/// * `text` - the text content of the Post
/// * `attach_url` - a url of an attachment (image for example)
///
pub fn post_add( pub fn post_add(
&self, &self,
author: &str, author: &str,
@ -102,13 +149,31 @@ impl Chat {
} }
} }
// delete a Post from the current Dialogue /// Delete a Post from the current Dialogue
pub fn post_del(&self, _key: u32) -> Result<(), Error> { ///
log::warn!("not implemented"); /// # Arguments
Err(xous::Error::InternalError) ///
/// * `index` - the index of the Post to delete.
///
pub fn post_del(&self, index: usize) -> Result<(), Error> {
xous::send_message(
self.cid,
xous::Message::new_scalar(ChatOp::PostDel as usize, index, 0, 0, 0),
)
.map(|_| ())
.expect("failed to delete Pose {index}");
Ok(())
} }
// get a Post from the current Dialogue /// Returns Some(index) of a matching Post by Author and Timestamp, or None
///
/// # Arguments
///
/// * `timestamp` - the Post timestamp criteria
/// * `author` - the Post Author criteria
///
/// Error if unable to send the msg to the Chat UI server
///
pub fn post_find(&self, author: &str, timestamp: u64) -> Result<Option<usize>, Error> { pub fn post_find(&self, author: &str, timestamp: u64) -> Result<Option<usize>, Error> {
let mut find = Find { let mut find = Find {
author: xous_ipc::String::new(), author: xous_ipc::String::new(),
@ -128,12 +193,17 @@ impl Chat {
} }
} }
// set various status flags on a Post in the current Dialogue /// Set various status flags on a Post in the current Dialogue
///
/// TODO: not implemented
///
pub fn post_flag(&self, _key: &str) -> Result<(), Error> { pub fn post_flag(&self, _key: &str) -> Result<(), Error> {
log::warn!("not implemented"); log::warn!("not implemented");
Err(xous::Error::InternalError) Err(xous::Error::InternalError)
} }
/// Redraw our Chat UI.
///
pub fn redraw(&self) { pub fn redraw(&self) {
xous::send_message( xous::send_message(
self.cid, self.cid,
@ -162,6 +232,20 @@ impl Chat {
} }
} }
/// The Chat UI server a manages a Chat UI to read a display and navigate a
/// series of Posts in a Dialogue stored in the pddb - and to Author a new
/// Post.
///
/// # Arguments
///
/// * `app_name` - registered with GAM
/// * `app_menu` - with menu items handled by the Chat App rather than the Chat UI
/// * `app_cid` - to accept messages from the Chat UI (see below)
/// * `post_opcode` - to handle a `MemoryMessage` containing a new outbound user Post
/// * `event_opcode` - to handle `ScalarMessage` representing a UI Event, such as F1 click, Left click, Top Post, etc.
/// * `rawkeys_opcode` - to handle a raw-keystroke.
///
pub fn server( pub fn server(
sid: SID, sid: SID,
app_name: &'static str, app_name: &'static str,

View file

@ -145,6 +145,9 @@ impl Ui {
} }
} }
/// Read the current Dialogue from pddb
///
pub fn dialogue_read(&mut self) -> Result<(), Error> { pub fn dialogue_read(&mut self) -> Result<(), Error> {
match (&self.pddb_dict, &self.pddb_key) { match (&self.pddb_dict, &self.pddb_key) {
(Some(dict), Some(key)) => { (Some(dict), Some(key)) => {
@ -200,6 +203,9 @@ impl Ui {
} }
} }
/// Save the current Dialogue to pddb
///
pub fn dialogue_save(&self) -> Result<(), Error> { pub fn dialogue_save(&self) -> Result<(), Error> {
match (&self.dialogue, &self.pddb_dict, &self.pddb_key) { match (&self.dialogue, &self.pddb_dict, &self.pddb_key) {
(Some(dialogue), Some(dict), Some(key)) => { (Some(dialogue), Some(dict), Some(key)) => {
@ -246,7 +252,13 @@ impl Ui {
} }
} }
// set the current Dialogue /// Set the current Dialogue
///
/// # Arguments
///
/// * `pddb_dict` - the pddb dict holding all Dialogues for this Chat App
/// * `pddb_key` - the pddb key holding a Dialogue
///
pub fn dialogue_set(&mut self, pddb_dict: &str, pddb_key: Option<&str>) { pub fn dialogue_set(&mut self, pddb_dict: &str, pddb_key: Option<&str>) {
self.pddb_dict = Some(pddb_dict.to_string()); self.pddb_dict = Some(pddb_dict.to_string());
self.pddb_key = pddb_key.map(|key| key.to_string()); self.pddb_key = pddb_key.map(|key| key.to_string());
@ -273,6 +285,12 @@ impl Ui {
} }
} }
/// Present a Modal to select Dialogue from pddb
///
/// typically called in offline mode
///
/// TODO move non-dialogue keys elsewhere
///
pub fn dialogue_modal(&mut self) { pub fn dialogue_modal(&mut self) {
if let Some(dict) = &self.pddb_dict { if let Some(dict) = &self.pddb_dict {
match self.pddb.list_keys(&dict, None) { match self.pddb.list_keys(&dict, None) {
@ -297,11 +315,31 @@ impl Ui {
} }
} }
/// Add a new MenuItem to the App menu
///
/// # Arguments
///
/// * `item` - an item action not handled by the Chat UI
///
pub fn menu_add(&self, item: MenuItem) { pub fn menu_add(&self, item: MenuItem) {
self.menu_mgr.add_item(item); self.menu_mgr.add_item(item);
} }
// add a new Post to the current Dialogue /// Add a new Post to the current Dialogue
///
/// TODO posts are truncated to mask a critical error on some posts (long with replies????)
///
/// note: posts are sorted by timestamp, so:
/// - `post_add` at beginning or end is fast (middle triggers a binary partition)
/// - if adding multiple posts then add oldest/newest last!
///
/// # Arguments
///
/// * `author` - the name of the Author of the Post
/// * `timestamp` - the timestamp of the Post
/// * `text` - the text content of the Post
/// * `attach_url` - a url of an attachment (image for example)
///
pub fn post_add( pub fn post_add(
&mut self, &mut self,
author: &str, author: &str,
@ -320,13 +358,23 @@ impl Ui {
Ok(()) Ok(())
} }
// delete a Post from the current Dialogue /// Delete a Post from the current Dialogue
pub fn post_del(&self, _key: u32) -> Result<(), Error> { pub fn post_del(&self, _key: u32) -> Result<(), Error> {
///
/// TODO: implement post_delete()
///
log::warn!("not implemented"); log::warn!("not implemented");
Err(Error::new(ErrorKind::Other, "not implemented")) Err(Error::new(ErrorKind::Other, "not implemented"))
} }
// get a Post from the current Dialogue /// Returns Some(index) of a matching Post by Author and Timestamp, or None
///
/// # Arguments
///
/// * `timestamp` - the Post timestamp criteria
/// * `author` - the Post Author criteria
///
pub fn post_find(&self, author: &str, timestamp: u64) -> Option<usize> { pub fn post_find(&self, author: &str, timestamp: u64) -> Option<usize> {
match &self.dialogue { match &self.dialogue {
Some(dialogue) => dialogue.post_find(author, timestamp), Some(dialogue) => dialogue.post_find(author, timestamp),
@ -334,22 +382,33 @@ impl Ui {
} }
} }
// get a Post from the current Dialogue /// Return Some<Post> from the current Dialogue, or None
pub fn post_get(&self, key: usize) -> Option<&Post> { ///
/// # Arguments
///
/// * `index` - index of the Post to retrieve
///
pub fn post_get(&self, index: usize) -> Option<&Post> {
match &self.dialogue { match &self.dialogue {
Some(dialogue) => dialogue.post_get(key), Some(dialogue) => dialogue.post_get(index),
None => None, None => None,
} }
} }
// set various status flags on a Post in the current Dialogue /// Set various status flags on a Post in the current Dialogue
///
/// TODO: not implemented
///
pub fn post_flag(&self, _key: u32) -> Result<(), Error> { pub fn post_flag(&self, _key: u32) -> Result<(), Error> {
log::warn!("not implemented"); log::warn!("not implemented");
Err(Error::new(ErrorKind::Other, "not implemented")) Err(Error::new(ErrorKind::Other, "not implemented"))
} }
// set the index of the selected post to an arbitrary index /// Set the Selected Post to an arbitrary index
// or select adjacent post with POST_SELECT_NEXT or POST_SELECT_PREV ///
/// # Arguments
///
/// * `index` - POST_SELECT_NEXT or POST_SELECT_PREV or an arbitraty index
pub fn post_select(&mut self, index: usize) { pub fn post_select(&mut self, index: usize) {
self.post_selected = match &self.dialogue { self.post_selected = match &self.dialogue {
Some(dialogue) => { Some(dialogue) => {
@ -404,7 +463,22 @@ impl Ui {
self.app_cid self.app_cid
} }
// send a xous scalar message with an Event to the Chat App cid/opcode
/// Send a xous scalar message with an Event to the Chat App cid/opcode
///
/// # Arguments
///
/// * `event` - the type of event to send
///
/// Error when `app_cid` == None or `opcode_event` == None
///
pub fn event(&self, event: Event) { pub fn event(&self, event: Event) {
log::info!("Event {:?}", event); log::info!("Event {:?}", event);
match (self.app_cid, self.opcode_event) { match (self.app_cid, self.opcode_event) {
@ -419,12 +493,15 @@ impl Ui {
} }
} }
// Create a bubble representing a Dialogue Post /// Return a TextView bubble representing a Dialogue Post
// return: a TextView bubble representing a Post ///
// post: the post to represent in a TextView bubble /// # Arguments
// dialogue: containing the Post for context info ///
// hilite: hilite this Post on the screen (thicker border) /// * `post` - the post to represent in a TextView bubble
// anchor_y: the vertical position on screen to draw TextView bubble /// * `dialogue` - containing the Post for context info
/// * `hilite` - hilite this Post on the screen (thicker border)
/// * `anchor_y` - the vertical position on screen to draw TextView bubble
///
fn bubble(&self, post: &Post, dialogue: &Dialogue, hilite: bool, anchor_y: i16) -> TextView { fn bubble(&self, post: &Post, dialogue: &Dialogue, hilite: bool, anchor_y: i16) -> TextView {
// set alignment of bubble left/right // set alignment of bubble left/right
let mut align_right = false; let mut align_right = false;
@ -466,6 +543,8 @@ impl Ui {
bubble_tv bubble_tv
} }
// Clear the screen area
//
fn clear_area(&self) { fn clear_area(&self) {
self.gam self.gam
.draw_rectangle( .draw_rectangle(
@ -483,15 +562,21 @@ impl Ui {
.expect("can't clear canvas area"); .expect("can't clear canvas area");
} }
pub(crate) fn raise_menu(&mut self) { /// Show the App Menu (← key)
// self.title_dirty = true; ///
pub(crate) fn raise_app_menu(&mut self) {
self.gam self.gam
.raise_menu(&self.app_menu) .raise_menu(&self.app_menu)
.expect("couldn't raise our submenu"); .expect("couldn't raise our submenu");
log::info!("raised menu"); log::info!("raised app menu");
} }
// redraw posts on the screen ensuring the selected post is fully visible /// Redraw posts on the screen.
///
/// Up to three attempts are made to layout the Posts:
/// * ensuring the selected post is fully visible, and
/// * best use of the screen is achieved
///
pub(crate) fn redraw(&mut self) -> Result<(), xous::Error> { pub(crate) fn redraw(&mut self) -> Result<(), xous::Error> {
if self.dialogue.is_some() { if self.dialogue.is_some() {
let mut attempt = 0; let mut attempt = 0;
@ -507,9 +592,21 @@ impl Ui {
Ok(()) Ok(())
} }
// Layout the post bubbles on the screen from top-down or bottom-up /// Layout the post bubbles on the screen.
// return: true if the selected post is fully visible ///
// error: if Dialogue == None /// The layout proceeds from top-down or bottom-up (starting with the
/// `post_anchor`), drawing a bubble for each Post, until the available space
/// is exhausted.
/// * If the `post_selected` is fully displayed, then `Ok(true)` is Returned.
/// * If the `post_selected` is NOT fully displayed, then the `post_anchor`
/// is set as the `post_anchor`, and `Ok(false)` is Returned - signalling that
/// a re-layout is in order.
/// * If the first/last Post is fully displayed, then the `post_topdown` is
/// toggled, the `post_anchor` is set to the first/last Post, and `Ok(false)`
/// is Returned - signalling that a re-layout is in order.
///
/// Error if there if Dialogue is None
///
fn layout(&mut self) -> Result<bool, Error> { fn layout(&mut self) -> Result<bool, Error> {
self.clear_area(); self.clear_area();
match (&self.dialogue, &self.post_anchor ) { match (&self.dialogue, &self.post_anchor ) {