hikari-components 0.2.2

// packages/components/src/display/timeline.rs
// Timeline component

use hikari_palette::classes::{ClassesBuilder, TimelineClass, TypedClass};
use tairitsu_vdom::events::MouseEvent;

use crate::prelude::*;
use crate::styled::StyledComponent;

pub struct TimelineComponent;

/// Timeline position determining item placement
#[derive(Clone, Copy, PartialEq, Debug, Default)]
pub enum TimelinePosition {
    #[default]
    Alternate,
    Left,
    Right,
}

/// Props for the Timeline component.
#[define_props]
pub struct TimelineProps {
    pub position: TimelinePosition,
    #[default(true)]
    pub line: bool,
    pub class: String,
    pub style: String,
    pub children: Element,
}

/// A vertical timeline component for displaying a sequence of events.
#[component]
pub fn Timeline(props: TimelineProps) -> Element {
    let position_class = match props.position {
        TimelinePosition::Alternate => TimelineClass::Alternate,
        TimelinePosition::Left => TimelineClass::Left,
        TimelinePosition::Right => TimelineClass::Right,
    };

    let timeline_classes = ClassesBuilder::new()
        .add_typed(TimelineClass::Timeline)
        .add_typed(position_class)
        .add_typed_if(TimelineClass::NoLine, !props.line)
        .add(&props.class)
        .build();

    rsx! {
        div { class: timeline_classes, style: props.style, {props.children} }
    }
}

/// Props for the TimelineItem component.
#[define_props]
pub struct TimelineItemProps {
    pub position: TimelinePosition,
    pub time: String,
    pub title: String,
    pub description: String,
    pub icon: Option<Element>,
    pub color: String,
    pub last: bool,
    #[default(false)]
    pub expanded: bool,
    pub extra: Option<Element>,
    pub class: String,
    pub style: String,
    pub children: Element,
}

/// A single item within a timeline with expandable description.
#[component]
pub fn TimelineItem(props: TimelineItemProps) -> Element {
    let position_class = match props.position {
        TimelinePosition::Alternate => TimelineClass::Alternate,
        TimelinePosition::Left => TimelineClass::Left,
        TimelinePosition::Right => TimelineClass::Right,
    };

    let mut expanded = use_signal(|| props.expanded);
    let has_description = !props.description.is_empty() || props.extra.is_some();

    let toggle_expanded = {
        let expanded = expanded.clone();
        move |_: MouseEvent| {
            if has_description {
                expanded.set(!expanded.get());
            }
        }
    };

    let is_expanded = expanded.get();

    let item_classes = ClassesBuilder::new()
        .add_typed(TimelineClass::Item)
        .add_typed(position_class)
        .add_typed_if(TimelineClass::Last, props.last)
        .add(&props.class)
        .build();

    let dot_style = if props.color.is_empty() {
        String::new()
    } else {
        format!(
            "background-color: {}; border-color: {};",
            props.color, props.color
        )
    };

    let header_classes = ClassesBuilder::new()
        .add("hi-timeline-header")
        .add_if("hi-timeline-header-clickable", has_description)
        .build();

    let description_classes = format!(
        "hi-timeline-description {}",
        if is_expanded {
            "hi-timeline-description-expanded"
        } else {
            "hi-timeline-description-collapsed"
        }
    );

    rsx! {
        div { class: item_classes, style: props.style,

            // Timeline dot
            div { class: TimelineClass::Dot.class_name(), style: dot_style,
                if let Some(icon) = props.icon {
                    {icon}
                }
            }

            // Timeline content
            div { class: TimelineClass::Content.class_name(),

                div { class: header_classes, onclick: toggle_expanded,

                    if !props.time.is_empty() {
                        div { class: TimelineClass::Time.class_name(), "{props.time}" }
                    }

                    if !props.title.is_empty() {
                        div { class: TimelineClass::Title.class_name(), "{props.title}" }
                    }
                }

                if has_description {
                    div { class: description_classes,

                        if !props.description.is_empty() {
                            div { class: "hi-timeline-description-text", "{props.description}" }
                        }

                        if let Some(extra) = props.extra {
                            div { class: "hi-timeline-extra", { extra } }
                        }
                    }
                }

                {props.children}
            }
        }
    }
}

impl StyledComponent for TimelineComponent {
    fn styles() -> &'static str {
        r#"
.hi-timeline {
    position: relative;
    padding: 1rem 0;
}

.hi-timeline::before {
    content: '';
    position: absolute;
    top: 0;
    bottom: 0;
    left: 50%;
    width: 2px;
    background: linear-gradient(
        to bottom,
        var(--hi-color-border),
        var(--hi-color-primary)
    );
    transform: translateX(-50%);
}

.hi-timeline-alternate .hi-timeline-item:nth-child(odd) {
    flex-direction: row-reverse;
}

.hi-timeline-left .hi-timeline-item,
.hi-timeline-right .hi-timeline-item {
    flex-direction: row;
}

.hi-timeline-left .hi-timeline-item {
    text-align: left;
}

.hi-timeline-right .hi-timeline-item {
    text-align: right;
    flex-direction: row-reverse;
}

.hi-timeline-no-line::before {
    display: none;
}

.hi-timeline-item {
    display: flex;
    align-items: flex-start;
    gap: 1.5rem;
    margin-bottom: 2rem;
    position: relative;
}

.hi-timeline-item:last-child {
    margin-bottom: 0;
}

.hi-timeline-dot {
    position: relative;
    display: flex;
    align-items: center;
    justify-content: center;
    width: 16px;
    height: 16px;
    border-radius: 50%;
    background-color: var(--hi-color-primary);
    border: 3px solid var(--hi-color-bg-container);
    box-shadow: 0 0 0 2px var(--hi-color-primary),
                0 0 8px var(--hi-glow-button-primary);
    flex-shrink: 0;
    z-index: 1;
    transition: all 0.3s ease;
}

.hi-timeline-dot:hover {
    transform: scale(1.2);
    box-shadow: 0 0 0 2px var(--hi-color-primary),
                0 0 16px var(--hi-glow-button-primary);
}

.hi-timeline-content {
    flex: 1;
    padding: 1rem;
    background-color: var(--hi-color-bg-elevated);
    border: 1px solid var(--hi-color-border);
    border-radius: 8px;
    transition: all 0.3s ease;
}

.hi-timeline-content:hover {
    border-color: var(--hi-color-primary);
    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.1),
                0 0 8px var(--hi-glow-button-primary);
}

.hi-timeline-time {
    font-size: 0.75rem;
    color: var(--hi-color-text-secondary);
    margin-bottom: 0.25rem;
    font-weight: 500;
}

.hi-timeline-title {
    font-size: 1rem;
    font-weight: 600;
    color: var(--hi-color-text-primary);
    margin-bottom: 0.5rem;
}

.hi-timeline-header {
    cursor: default;
}

.hi-timeline-header-clickable {
    cursor: pointer;
}

.hi-timeline-description {
    overflow: hidden;
    transition: max-height 0.3s ease, opacity 0.3s ease, padding 0.3s ease;
}

.hi-timeline-description-expanded {
    max-height: 500px;
    opacity: 1;
    padding-top: 0.5rem;
}

.hi-timeline-description-collapsed {
    max-height: 0;
    opacity: 0;
    padding-top: 0;
}

.hi-timeline-description-text {
    font-size: 0.875rem;
    color: var(--hi-color-text-secondary);
    margin-bottom: 0.5rem;
}

.hi-timeline-extra {
    margin-top: 0.5rem;
}

.hi-timeline-last::after {
    display: none;
}
"#
    }

    fn name() -> &'static str {
        "timeline"
    }
}