@perspective-dev/viewer 4.0.0

package/src/rust/config/columns_config.rs

@@ -0,0 +1,132 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::collections::HashMap;
+
+use serde::{Deserialize, Serialize};
+use serde_with::skip_serializing_none;
+use ts_rs::TS;
+
+use super::{
+    CustomNumberFormatConfig, DatetimeColumnStyleConfig, DatetimeColumnStyleDefaultConfig,
+    NumberColumnStyleConfig, NumberColumnStyleDefaultConfig, StringColumnStyleConfig,
+    StringColumnStyleDefaultConfig,
+};
+
+fn is_zero(x: &u32) -> bool {
+    x == &0
+}
+
+/// The value de/serialized and stored in the viewer config.
+/// Also passed to the plugin via `plugin.save()`.
+#[skip_serializing_none]
+#[derive(Clone, Debug, Default, Deserialize, PartialEq, Serialize, TS)]
+pub struct ColumnConfigValues {
+    #[serde(default)]
+    #[serde(skip_serializing_if = "HashMap::is_empty")]
+    pub symbols: HashMap<String, String>,
+
+    #[serde(flatten)]
+    pub datagrid_number_style: NumberColumnStyleConfig,
+
+    #[serde(flatten)]
+    pub datagrid_string_style: StringColumnStyleConfig,
+
+    #[serde(flatten)]
+    pub datagrid_datetime_style: DatetimeColumnStyleConfig,
+
+    #[serde(default)]
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub number_format: Option<CustomNumberFormatConfig>,
+
+    #[serde(default)]
+    #[serde(skip_serializing_if = "is_zero")]
+    pub aggregate_depth: u32,
+}
+
+#[derive(Debug)]
+pub enum ColumnConfigValueUpdate {
+    DatagridNumberStyle(Option<NumberColumnStyleConfig>),
+    DatagridStringStyle(Option<StringColumnStyleConfig>),
+    DatagridDatetimeStyle(Option<DatetimeColumnStyleConfig>),
+    Symbols(Option<HashMap<String, String>>),
+    CustomNumberStringFormat(Option<CustomNumberFormatConfig>),
+    AggregateDepth(u32),
+}
+
+impl ColumnConfigValues {
+    pub fn update(self, update: ColumnConfigValueUpdate) -> Self {
+        match update {
+            ColumnConfigValueUpdate::DatagridNumberStyle(update) => Self {
+                datagrid_number_style: update.unwrap_or_default(),
+                ..self
+            },
+            ColumnConfigValueUpdate::DatagridStringStyle(update) => Self {
+                datagrid_string_style: update.unwrap_or_default(),
+                ..self
+            },
+            ColumnConfigValueUpdate::DatagridDatetimeStyle(update) => Self {
+                datagrid_datetime_style: update.unwrap_or_default(),
+                ..self
+            },
+            ColumnConfigValueUpdate::Symbols(update) => Self {
+                symbols: update.unwrap_or_default(),
+                ..self
+            },
+            ColumnConfigValueUpdate::CustomNumberStringFormat(update) => Self {
+                number_format: update.filter(|x| x != &CustomNumberFormatConfig::default()),
+                ..self
+            },
+            ColumnConfigValueUpdate::AggregateDepth(aggregate_depth) => Self {
+                aggregate_depth,
+                ..self
+            },
+        }
+    }
+
+    pub fn is_empty(&self) -> bool {
+        self == &Self::default()
+    }
+}
+
+/// The controls returned by plugin.column_style_controls.
+///
+/// This is a way to fill out default values for the given controls.
+/// If a control is not given, it will not be rendered. I would like to
+/// eventually show these as inactive values.
+#[derive(Serialize, Deserialize, PartialEq, Debug, Default)]
+pub struct ColumnStyleOpts {
+    pub datagrid_number_style: Option<NumberColumnStyleDefaultConfig>,
+    pub datagrid_string_style: Option<StringColumnStyleDefaultConfig>,
+    pub datagrid_datetime_style: Option<DatetimeColumnStyleDefaultConfig>,
+    pub symbols: Option<KeyValueOpts>,
+    pub number_string_format: Option<bool>,
+}
+
+#[derive(Serialize, Deserialize, Debug, PartialEq, Clone, Copy)]
+#[serde(rename_all = "snake_case")]
+pub enum KvPairKeyValue {
+    Row,
+}
+
+#[derive(Serialize, Deserialize, Debug, PartialEq, Clone)]
+#[serde(untagged)]
+pub enum KvPairKeys {
+    String(KvPairKeyValue),
+    Vec(Vec<String>),
+}
+
+#[derive(Serialize, Deserialize, Debug, PartialEq, Clone)]
+pub struct KeyValueOpts {
+    pub keys: KvPairKeys,
+    pub values: Vec<String>,
+}

package/src/rust/config/datetime_column_style/color_mode.rs

@@ -0,0 +1,62 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::fmt::Display;
+use std::str::FromStr;
+
+use serde::{Deserialize, Serialize};
+use strum::EnumIter;
+use ts_rs::TS;
+
+#[derive(Clone, Copy, Debug, Default, Deserialize, EnumIter, Eq, PartialEq, Serialize, TS)]
+pub enum DatetimeColorMode {
+    #[default]
+    #[serde(rename = "none")]
+    None,
+
+    #[serde(rename = "foreground")]
+    Foreground,
+
+    #[serde(rename = "background")]
+    Background,
+}
+
+impl Display for DatetimeColorMode {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        let text = match self {
+            Self::None => "none",
+            Self::Foreground => "foreground",
+            Self::Background => "background",
+        };
+
+        write!(f, "{text}")
+    }
+}
+
+impl FromStr for DatetimeColorMode {
+    type Err = String;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match s {
+            "none" => Ok(Self::None),
+            "foreground" => Ok(Self::Foreground),
+            "background" => Ok(Self::Background),
+            x => Err(format!("Unknown DatetimeColorMode::{x}")),
+        }
+    }
+}
+
+impl DatetimeColorMode {
+    pub fn is_none(&self) -> bool {
+        self == &Self::None
+    }
+}

package/src/rust/config/datetime_column_style/custom.rs

@@ -0,0 +1,121 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use super::custom_format::CustomDatetimeFormat;
+
+#[derive(Clone, Debug, Default, Deserialize, Eq, PartialEq, Serialize, TS)]
+pub enum FormatUnit {
+    #[serde(rename = "custom")]
+    #[default]
+    FormatUnit,
+}
+
+const fn is_zero(x: &u32) -> bool {
+    *x == 0
+}
+
+const fn is_true(x: &bool) -> bool {
+    *x
+}
+
+const fn is_disabled(x: &CustomDatetimeFormat) -> bool {
+    matches!(x, CustomDatetimeFormat::Disabled)
+}
+
+const fn is_numeric(x: &CustomDatetimeFormat) -> bool {
+    matches!(x, CustomDatetimeFormat::Numeric)
+}
+
+const fn is_two_digit(x: &CustomDatetimeFormat) -> bool {
+    matches!(x, CustomDatetimeFormat::TwoDigit)
+}
+
+const fn second_default() -> CustomDatetimeFormat {
+    CustomDatetimeFormat::Numeric
+}
+
+const fn weekday_default() -> CustomDatetimeFormat {
+    CustomDatetimeFormat::Disabled
+}
+
+const fn year_default() -> CustomDatetimeFormat {
+    CustomDatetimeFormat::TwoDigit
+}
+
+const fn hour12_default() -> bool {
+    true
+}
+
+const fn numeric_default() -> u32 {
+    0
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize, TS)]
+pub struct CustomDatetimeStyleConfig {
+    format: FormatUnit,
+
+    #[serde(default)]
+    #[serde(rename = "timeZone", skip_serializing_if = "Option::is_none")]
+    pub time_zone: Option<String>,
+
+    #[serde(
+        skip_serializing_if = "is_zero",
+        rename = "fractionalSecondDigits",
+        default = "numeric_default"
+    )]
+    pub fractional_seconds: u32,
+
+    #[serde(skip_serializing_if = "is_numeric", default = "second_default")]
+    pub second: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_numeric", default = "second_default")]
+    pub minute: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_numeric", default = "second_default")]
+    pub hour: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_numeric", default = "second_default")]
+    pub day: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_disabled", default = "weekday_default")]
+    pub weekday: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_numeric", default = "second_default")]
+    pub month: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_two_digit", default = "year_default")]
+    pub year: CustomDatetimeFormat,
+
+    #[serde(skip_serializing_if = "is_true", default = "hour12_default")]
+    pub hour12: bool,
+}
+
+impl Default for CustomDatetimeStyleConfig {
+    fn default() -> Self {
+        CustomDatetimeStyleConfig {
+            format: FormatUnit::FormatUnit,
+            fractional_seconds: 0,
+            time_zone: None,
+            second: CustomDatetimeFormat::Numeric,
+            minute: CustomDatetimeFormat::Numeric,
+            hour: CustomDatetimeFormat::Numeric,
+            weekday: CustomDatetimeFormat::Disabled,
+            day: CustomDatetimeFormat::Numeric,
+            month: CustomDatetimeFormat::Numeric,
+            year: CustomDatetimeFormat::TwoDigit,
+            hour12: true,
+        }
+    }
+}

package/src/rust/config/datetime_column_style/custom_format.rs

@@ -0,0 +1,90 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::fmt::Display;
+use std::str::FromStr;
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+#[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize, TS)]
+pub enum CustomDatetimeFormat {
+    #[serde(rename = "long")]
+    Long,
+
+    #[serde(rename = "short")]
+    Short,
+
+    #[serde(rename = "narrow")]
+    Narrow,
+
+    #[serde(rename = "numeric")]
+    Numeric,
+
+    #[serde(rename = "2-digit")]
+    TwoDigit,
+
+    #[serde(rename = "disabled")]
+    Disabled,
+}
+
+impl CustomDatetimeFormat {
+    pub const fn values() -> &'static [Self] {
+        &[
+            Self::Long,
+            Self::Short,
+            Self::Narrow,
+            Self::Numeric,
+            Self::TwoDigit,
+            Self::Disabled,
+        ]
+    }
+
+    pub fn values_1() -> &'static [Self] {
+        &[Self::Numeric, Self::TwoDigit, Self::Disabled]
+    }
+
+    pub fn values_2() -> &'static [Self] {
+        &[Self::Long, Self::Narrow, Self::Short, Self::Disabled]
+    }
+}
+
+impl Display for CustomDatetimeFormat {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        let text = match self {
+            Self::Long => "long",
+            Self::Short => "short",
+            Self::Narrow => "narrow",
+            Self::Numeric => "numeric",
+            Self::TwoDigit => "2-digit",
+            Self::Disabled => "disabled",
+        };
+
+        write!(f, "{text}")
+    }
+}
+
+impl FromStr for CustomDatetimeFormat {
+    type Err = String;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match s {
+            "long" => Ok(Self::Long),
+            "short" => Ok(Self::Short),
+            "narrow" => Ok(Self::Narrow),
+            "numeric" => Ok(Self::Numeric),
+            "2-digit" => Ok(Self::TwoDigit),
+            "disabled" => Ok(Self::Disabled),
+            x => Err(format!("Unknown DatetimeFormat::{x}")),
+        }
+    }
+}

package/src/rust/config/datetime_column_style/simple.rs

@@ -0,0 +1,55 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use serde::{Deserialize, Serialize};
+use ts_rs::TS;
+
+use super::simple_format::*;
+
+const fn date_style_default() -> SimpleDatetimeFormat {
+    SimpleDatetimeFormat::Short
+}
+
+const fn time_style_default() -> SimpleDatetimeFormat {
+    SimpleDatetimeFormat::Medium
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize, TS)]
+pub struct SimpleDatetimeStyleConfig {
+    #[serde(default)]
+    #[serde(rename = "timeZone", skip_serializing_if = "Option::is_none")]
+    pub time_zone: Option<String>,
+
+    #[serde(
+        default = "date_style_default",
+        rename = "dateStyle",
+        skip_serializing_if = "SimpleDatetimeFormat::is_short"
+    )]
+    pub date_style: SimpleDatetimeFormat,
+
+    #[serde(
+        default = "time_style_default",
+        rename = "timeStyle",
+        skip_serializing_if = "SimpleDatetimeFormat::is_medium"
+    )]
+    pub time_style: SimpleDatetimeFormat,
+}
+
+impl Default for SimpleDatetimeStyleConfig {
+    fn default() -> Self {
+        Self {
+            time_zone: None,
+            date_style: SimpleDatetimeFormat::Short,
+            time_style: SimpleDatetimeFormat::Medium,
+        }
+    }
+}

package/src/rust/config/datetime_column_style/simple_format.rs

@@ -0,0 +1,86 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+use std::fmt::Display;
+use std::str::FromStr;
+
+use serde::{Deserialize, Serialize};
+use strum::EnumIter;
+use ts_rs::TS;
+
+#[derive(Clone, Copy, Debug, Default, Deserialize, EnumIter, Eq, PartialEq, Serialize, TS)]
+pub enum SimpleDatetimeFormat {
+    #[serde(rename = "full")]
+    Full,
+
+    #[serde(rename = "long")]
+    Long,
+
+    #[serde(rename = "medium")]
+    Medium,
+
+    #[default]
+    #[serde(rename = "short")]
+    Short,
+
+    #[serde(rename = "disabled")]
+    Disabled,
+}
+
+impl SimpleDatetimeFormat {
+    pub fn is_short(&self) -> bool {
+        self == &Self::Short
+    }
+
+    pub fn is_medium(&self) -> bool {
+        self == &Self::Medium
+    }
+
+    pub const fn values() -> &'static [Self] {
+        &[
+            Self::Full,
+            Self::Long,
+            Self::Medium,
+            Self::Short,
+            Self::Disabled,
+        ]
+    }
+}
+
+impl Display for SimpleDatetimeFormat {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        let text = match self {
+            Self::Full => "full",
+            Self::Long => "long",
+            Self::Medium => "medium",
+            Self::Short => "short",
+            Self::Disabled => "disabled",
+        };
+
+        write!(f, "{text}")
+    }
+}
+
+impl FromStr for SimpleDatetimeFormat {
+    type Err = String;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match s {
+            "full" => Ok(Self::Full),
+            "long" => Ok(Self::Long),
+            "medium" => Ok(Self::Medium),
+            "short" => Ok(Self::Short),
+            "disabled" => Ok(Self::Disabled),
+            x => Err(format!("Unknown DatetimeFormat::{x}")),
+        }
+    }
+}

package/src/rust/config/datetime_column_style.rs

@@ -0,0 +1,104 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ Copyright (c) 2017, the Perspective Authors.                              ┃
+// ┃ ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ ┃
+// ┃ This file is part of the Perspective library, distributed under the terms ┃
+// ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+mod color_mode;
+mod custom;
+mod custom_format;
+mod simple;
+mod simple_format;
+
+pub use color_mode::*;
+pub use custom::*;
+pub use custom_format::*;
+use serde::{Deserialize, Serialize};
+pub use simple::*;
+pub use simple_format::*;
+use ts_rs::TS;
+
+use crate::*;
+
+/// `Simple` case has all default-able keys and must be last!
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize, TS)]
+// #[serde(tag = "format", content = "date_format")]
+#[serde(untagged)]
+pub enum DatetimeFormatType {
+    // #[serde(rename = "custom")]
+    Custom(CustomDatetimeStyleConfig),
+    Simple(SimpleDatetimeStyleConfig),
+}
+
+impl Default for DatetimeFormatType {
+    fn default() -> Self {
+        Self::Simple(SimpleDatetimeStyleConfig::default())
+    }
+}
+
+impl DatetimeFormatType {
+    fn is_simple(&self) -> bool {
+        self == &Self::Simple(SimpleDatetimeStyleConfig::default())
+    }
+
+    pub fn time_zone(&self) -> &Option<String> {
+        match self {
+            DatetimeFormatType::Custom(x) => &x.time_zone,
+            DatetimeFormatType::Simple(x) => &x.time_zone,
+        }
+    }
+
+    pub fn time_zone_mut(&mut self) -> &mut Option<String> {
+        match self {
+            DatetimeFormatType::Custom(x) => &mut x.time_zone,
+            DatetimeFormatType::Simple(x) => &mut x.time_zone,
+        }
+    }
+}
+
+/// A model for the JSON serialized style configuration for a column of type
+/// `datetime`.
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize, TS)]
+pub struct DatetimeColumnStyleConfig {
+    #[serde(default)]
+    #[serde(skip_serializing_if = "DatetimeFormatType::is_simple")]
+    pub date_format: DatetimeFormatType,
+
+    #[serde(default)]
+    #[serde(skip_serializing_if = "DatetimeColorMode::is_none")]
+    pub datetime_color_mode: DatetimeColorMode,
+
+    #[serde(default)]
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[ts(skip)]
+    pub color: Option<String>,
+}
+
+impl Default for DatetimeColumnStyleConfig {
+    fn default() -> Self {
+        Self {
+            date_format: DatetimeFormatType::Simple(SimpleDatetimeStyleConfig {
+                time_zone: Default::default(),
+                date_style: SimpleDatetimeFormat::Short,
+                time_style: SimpleDatetimeFormat::Medium,
+            }),
+            datetime_color_mode: Default::default(),
+            color: Default::default(),
+        }
+    }
+}
+
+derive_wasm_abi!(DatetimeColumnStyleConfig, FromWasmAbi, IntoWasmAbi);
+
+#[derive(Clone, Default, Deserialize, Eq, PartialEq, Serialize, Debug)]
+pub struct DatetimeColumnStyleDefaultConfig {
+    pub color: String,
+}
+
+derive_wasm_abi!(DatetimeColumnStyleDefaultConfig, FromWasmAbi);