use std::cell::RefCell; use ely_gpui_component::theme::{ActiveTheme, TextSize}; use gpui::{ AnyElement, App, Div, Entity, FontWeight, Global, ImageSource, IntoElement, ParentElement, Resource, SharedString, Styled, Window, div, prelude::*, }; /// The one section a story draws, while a page renders; the rest draw nothing. pub struct Story { wanted: SharedString, met: RefCell>, } impl Global for Story {} impl Story { pub fn new(wanted: SharedString) -> Self { Self { wanted, met: RefCell::default(), } } fn answers(&self, title: &str) -> bool { *self.wanted == *title || *self.wanted == slug(title) } /// Why the page drew no single section by this name, if it did not. pub fn missing(&self, page: &str) -> Option { let met = self.met.borrow(); match met.iter().filter(|title| self.answers(title)).count() { 1 => None, 0 => Some(format!( "The page {page} has no story {}. Its stories: {}.", self.wanted, met.join(", ") )), n => Some(format!("{n} stories on {page} answer to {}.", self.wanted)), } } } /// A title as a story's address: lowercase letters and digits, dashes between. pub fn slug(title: &str) -> String { let mut slug = String::new(); for c in title.chars() { if c.is_ascii_alphanumeric() { slug.push(c.to_ascii_lowercase()); } else if !slug.is_empty() && !slug.ends_with('-') { slug.push('-'); } } slug.trim_end_matches('-').to_string() } /// Titled block of demos. Under a story, only the one asked for draws, without its title. pub fn section(title: impl Into, note: impl Into, cx: &App) -> Div { let title = title.into(); let theme = cx.theme(); let story = cx.try_global::(); let shown = story.is_none_or(|story| { story.met.borrow_mut().push(title.clone()); story.answers(&title) }); div() .flex() .flex_col() .gap_4() .when(story.is_none(), |section| section.pt_10()) .when(!shown, |section| section.hidden()) .child( div() .flex() .flex_col() .gap_1() .when(story.is_none(), |header| { header.child( div() .text_size(theme.text_size(TextSize::Md)) .font_weight(FontWeight::SEMIBOLD) .text_color(theme.colors.fg) .child(title), ) }) .child( div() .text_size(theme.text_size(TextSize::Sm)) .text_color(theme.colors.fg_muted) .child(note.into()), ), ) } /// A picture under the gallery's assets: a file natively, an address on the web. pub fn resource(path: impl Into) -> Resource { let path = path.into(); if cfg!(target_family = "wasm") { Resource::Uri(path.into()) } else { Resource::Path(std::path::Path::new(path.as_ref()).into()) } } pub fn picture(path: impl Into) -> ImageSource { ImageSource::Resource(resource(path)) } pub fn row() -> Div { div().flex().flex_wrap().items_center().gap_3() } /// Row whose captions share one line. pub fn specimens() -> Div { div().flex().flex_wrap().items_end().gap_6() } pub fn label(text: impl Into, cx: &App) -> impl IntoElement { let theme = cx.theme(); div() .text_size(theme.text_size(TextSize::Xs)) .text_color(theme.colors.fg_subtle) .child(text.into()) } /// Demo with a caption beneath. pub fn specimen(caption: impl Into, body: impl IntoElement, cx: &App) -> Div { div() .flex() .flex_col() .gap_2() .child(body) .child(label(caption, cx)) } /// Monospace hint naming the call. pub fn code(text: impl Into, cx: &App) -> impl IntoElement { let theme = cx.theme(); div() .font_family(theme.mono_family.clone()) .text_size(theme.text_size(TextSize::Xs)) .text_color(theme.colors.fg_muted) .child(text.into()) } /// Honest note for an entry gpui cannot support. pub fn blocked(text: impl Into, cx: &App) -> impl IntoElement { let theme = cx.theme(); div() .flex() .items_start() .gap_2() .text_size(theme.text_size(TextSize::Sm)) .text_color(theme.colors.warning) .child( div() .flex_none() .mt_1p5() .size_1p5() .rounded_full() .bg(theme.colors.warning), ) .child(div().flex_1().min_w_0().child(text.into())) } /// What a browser cannot do here, and why: a note on the web, nothing natively. pub fn web_note(text: &'static str, cx: &App) -> Option { cfg!(target_family = "wasm").then(|| blocked(text, cx).into_any_element()) } /// A button that opens a window of its own; a browser page is one window, so there a note stands in. pub fn own_window(button: impl IntoElement, cx: &App) -> AnyElement { match web_note( "A browser page is a single window: gpui opens no second window or popup on the web, so this one cannot open here.", cx, ) { Some(note) => note, None => button.into_any_element(), } } /// A demo's state, kept across frames under `key`. pub fn keep( key: &'static str, init: impl FnOnce() -> T, window: &mut Window, cx: &mut App, ) -> Entity { window.use_keyed_state(key, cx, move |_, _| init()) } /// Edits a demo's state in place and redraws. pub fn change(state: &Entity, cx: &mut App, edit: impl FnOnce(&mut T)) { state.update(cx, |state, cx| { edit(state); cx.notify(); }); } /// Replaces a demo's state and redraws. pub fn set(state: &Entity, value: T, cx: &mut App) { state.update(cx, |state, cx| { *state = value; cx.notify(); }); } /// A steady pseudo-random series, so captures repeat. pub fn noise(seed: u64) -> impl FnMut() -> f64 { let mut state = seed; move || { state = state .wrapping_mul(6364136223846793005) .wrapping_add(1442695040888963407); (state >> 33) as f64 / (1u64 << 31) as f64 } }