@perspective-dev/viewer 4.0.0

package/src/rust/components/style/style_cache.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::cell::RefCell;
+use std::collections::{BTreeMap, BTreeSet};
+use std::ops::Deref;
+use std::rc::Rc;
+
+use wasm_bindgen::JsCast;
+
+use crate::*;
+
+type CSSResource = (&'static str, &'static str);
+
+/// A dictionary of CSS fragments for native HTML elements which should always
+/// be loaded (and perhaps lack yew components wrappers from which to have
+/// their styles registered).
+static DOM_STYLES: &[CSSResource] = &[css!("dom/checkbox"), css!("dom/select")];
+
+thread_local! {
+    /// Cache of `CssStyleSheet` objects, which can safely be re-used across
+    /// `HTMLPerspectiveViewerElement` instances
+    static STYLE_SHEET_CACHE: RefCell<BTreeMap<&'static str, web_sys::CssStyleSheet>> = RefCell::new(
+        DOM_STYLES
+            .iter()
+            .map(|x| (x.0, StyleCache::into_style(x.1)))
+            .collect(),
+    );
+}
+
+/// A state object for `<style>` snippets used by a yew `Component` with a
+/// `<StyleProvider>` at the root.
+#[derive(Clone)]
+pub struct StyleCache(Rc<StyleCacheData>);
+
+impl Deref for StyleCache {
+    type Target = StyleCacheData;
+
+    fn deref(&self) -> &Self::Target {
+        &self.0
+    }
+}
+
+impl PartialEq for StyleCache {
+    fn eq(&self, _other: &Self) -> bool {
+        true
+    }
+}
+
+impl StyleCache {
+    pub fn new(is_shadow: bool, elem: &web_sys::HtmlElement) -> StyleCache {
+        StyleCache(Rc::new(StyleCacheData::new(is_shadow, elem)))
+    }
+
+    /// Insert a new stylesheet into this manager, _immediately_ inserting it
+    /// into the DOM as well if any other elements are already connected,
+    /// bypassing yew rendering;  when the yew `Component::view` method is
+    /// later invoked, this element will get re-attached to the same parent
+    /// (though likely in a different order).
+    ///
+    /// This is done synchronously because CSS registration occurs during
+    /// the `create` lifecycle phase, and we want these style elements to be
+    /// attached _before_ the style's target nodes are attached.
+    pub fn add_style(&self, name: &'static str, css: &'static str) {
+        let mut map = self.0.styles.borrow_mut();
+        STYLE_SHEET_CACHE.with_borrow_mut(|cache| {
+            if !map.contains(name) {
+                map.insert(name);
+                if !cache.contains_key(name) {
+                    let style = Self::into_style(css);
+                    cache.insert(name, style);
+                }
+
+                self.adopted_style_sheets.splice(
+                    map.iter().position(|x| x == &name).unwrap() as u32,
+                    0,
+                    cache.get(name).unwrap(),
+                );
+            }
+        });
+    }
+
+    /// Concert a CSS string to an `HtmlStyleElement`, which are memoized due
+    /// to their size and DOM performance impact.
+    fn into_style(css: &str) -> web_sys::CssStyleSheet {
+        let sheet = web_sys::CssStyleSheet::new().unwrap();
+        sheet.replace_sync(css).unwrap();
+        sheet
+    }
+}
+
+/// Using a `BTreeMap` so the resulting `<style>` elements have a stable order
+/// when rendered to the DOM.
+pub struct StyleCacheData {
+    styles: RefCell<BTreeSet<&'static str>>,
+    adopted_style_sheets: js_sys::Array,
+}
+
+impl StyleCacheData {
+    fn new(is_shadow: bool, elem: &web_sys::HtmlElement) -> Self {
+        let styles: RefCell<BTreeSet<&'static str>> =
+            RefCell::new(DOM_STYLES.iter().map(|x| x.0).collect());
+
+        let root: &JsValue = if is_shadow {
+            &elem.shadow_root().unwrap()
+        } else {
+            &web_sys::window().unwrap().document().unwrap()
+        };
+
+        let adopted_style_sheets = js_sys::Reflect::get(root, &"adoptedStyleSheets".into())
+            .unwrap()
+            .unchecked_into::<js_sys::Array>();
+
+        for name in styles.borrow().iter() {
+            STYLE_SHEET_CACHE.with_borrow(|x| adopted_style_sheets.push(x.get(name).unwrap()));
+        }
+
+        Self {
+            styles,
+            adopted_style_sheets,
+        }
+    }
+}

package/src/rust/components/style/style_provider.rs

@@ -0,0 +1,65 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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 web_sys::HtmlStyleElement;
+use yew::prelude::*;
+use yew::virtual_dom::VNode;
+
+use super::style_cache::StyleCache;
+
+#[derive(Properties, PartialEq)]
+pub struct StyleProviderProps {
+    pub root: web_sys::HtmlElement,
+    #[prop_or(true)]
+    pub is_shadow: bool,
+    pub children: Children,
+}
+
+/// A context which injects any CSS snippet registered within its tree, doing
+/// so only once for each unqiue snippet name.
+///
+/// CSS can be registered within sub-components via the `<LocalStyle>` component
+/// and `css!()` resource inlining macro.
+pub struct StyleProvider {
+    cache: StyleCache,
+}
+
+impl Component for StyleProvider {
+    type Message = ();
+    type Properties = StyleProviderProps;
+
+    fn create(ctx: &Context<Self>) -> Self {
+        let cache = StyleCache::new(ctx.props().is_shadow, &ctx.props().root);
+        Self { cache }
+    }
+
+    fn view(&self, ctx: &Context<Self>) -> Html {
+        html! {
+            <ContextProvider<StyleCache> context={self.cache.clone()}>
+                { for ctx.props().children.iter() }
+            </ContextProvider<StyleCache>>
+        }
+    }
+}
+
+#[derive(Properties, PartialEq)]
+struct StyleKeyedProps {
+    elem: HtmlStyleElement,
+}
+
+/// Necessary only to attach `key` to individual `HtmlStylElement` children,
+/// as `yew` does not calculate list updates correctly for sequences of these
+/// without keys.
+#[function_component(StyleKeyed)]
+fn style_renderer(props: &StyleKeyedProps) -> Html {
+    VNode::VRef(props.elem.clone().into())
+}

package/src/rust/components/style_controls/number_string_format/digits_section.rs

@@ -0,0 +1,140 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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::rc::Rc;
+
+use itertools::Itertools;
+use perspective_client::config::ColumnType;
+use yew::html;
+
+use super::CustomNumberFormat;
+use crate::components::containers::select::{Select, SelectItem};
+use crate::components::form::number_field::NumberField;
+use crate::components::form::number_range_field::NumberRangeField;
+use crate::components::form::optional_field::OptionalField;
+use crate::components::form::select_field::SelectEnumField;
+use crate::components::style_controls::CustomNumberFormatMsg;
+use crate::config::{
+    ROUNDING_INCREMENTS, RoundingIncrement, RoundingMode, RoundingPriority, TrailingZeroDisplay,
+};
+
+impl CustomNumberFormat {
+    pub fn digits_section(&self, ctx: &yew::prelude::Context<Self>) -> yew::prelude::Html {
+        let is_float = matches!(ctx.props().view_type, ColumnType::Float);
+        html! {
+            <>
+                <NumberField
+                    label="minimum-integer-digits"
+                    min=1.
+                    max=21.
+                    step=1.
+                    default=1.
+                    current_value={self.config.minimum_integer_digits}
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::MinimumIntegerDigits)}
+                />
+                if is_float { { self.float_section(ctx) } } else { { self.rounding_increment(ctx) } }
+            </>
+        }
+    }
+
+    fn rounding_increment(&self, ctx: &yew::prelude::Context<Self>) -> yew::prelude::Html {
+        // let disabled = self.disable_rounding_increment;
+        let values = ROUNDING_INCREMENTS
+            .iter()
+            .map(|val| RoundingIncrement::Custom(*val))
+            .map(SelectItem::Option)
+            .collect_vec();
+
+        let values = Rc::new([vec![SelectItem::Option(RoundingIncrement::Auto)], values].concat());
+        let on_check = ctx
+            .link()
+            .callback(|_| CustomNumberFormatMsg::RoundingIncrement(RoundingIncrement::default()));
+
+        let selected = self
+            .config
+            .rounding_increment
+            .map(RoundingIncrement::Custom)
+            .unwrap_or_default();
+
+        html! {
+            <div class="row">
+                <OptionalField
+                    label="rounding-increment"
+                    {on_check}
+                    // {disabled}
+                    checked={self.config.rounding_increment.is_some()}
+                >
+                    <Select<RoundingIncrement>
+                        {values}
+                        {selected}
+                        on_select={ctx.link().callback(CustomNumberFormatMsg::RoundingIncrement)}
+                    />
+                </OptionalField>
+            </div>
+        }
+    }
+
+    fn float_section(&self, ctx: &yew::prelude::Context<Self>) -> yew::prelude::Html {
+        let fractional_value = Some((
+            self.config.minimum_fraction_digits.unwrap_or(2.),
+            self.config.maximum_fraction_digits.unwrap_or(2.),
+        ));
+
+        let significant_value = Some((
+            self.config.minimum_significant_digits.unwrap_or(1.),
+            self.config.maximum_significant_digits.unwrap_or(21.),
+        ));
+
+        html! {
+            <>
+                <div class="row">
+                    <NumberRangeField
+                        label="fractional-digits"
+                        min=0.
+                        max=20.
+                        step=1.
+                        default={(2., 2.)}
+                        current_value={fractional_value}
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::FracChange)}
+                    />
+                </div>
+                <div class="row">
+                    <NumberRangeField
+                        label="significant-digits"
+                        min=1.
+                        max=21.
+                        step=1.
+                        default={(1., 21.)}
+                        current_value={significant_value}
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::SigChange)}
+                    />
+                </div>
+                { self.rounding_increment(ctx) }
+                <SelectEnumField<RoundingPriority>
+                    label="rounding-priority"
+                    current_value={self.config.rounding_priority}
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::RoundingPriority)}
+                />
+                <SelectEnumField<RoundingMode>
+                    label="rounding-mode"
+                    current_value={self.config.rounding_mode}
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::RoundingMode)}
+                />
+                <SelectEnumField<TrailingZeroDisplay>
+                    label="trailing-zero-display"
+                    current_value={self.config.trailing_zero_display}
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::TrailingZero)}
+                />
+            </>
+        }
+    }
+}

package/src/rust/components/style_controls/number_string_format/misc_section.rs

@@ -0,0 +1,56 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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 yew::html;
+
+use super::CustomNumberFormat;
+use crate::components::form::select_field::SelectEnumField;
+use crate::components::style_controls::{CustomNumberFormatMsg, NotationName};
+use crate::config::*;
+
+impl CustomNumberFormat {
+    pub fn misc_section(&self, ctx: &yew::prelude::Context<Self>) -> yew::prelude::Html {
+        let compact_display_checkbox = if let Some(Notation::Compact(val)) = self.config._notation {
+            let cb = ctx.link().callback(CustomNumberFormatMsg::CompactDisplay);
+            Some(html! {
+                <SelectEnumField<CompactDisplay>
+                    label="compact-display"
+                    on_change={cb}
+                    current_value={val}
+                />
+            })
+        } else {
+            None
+        };
+
+        html! {
+            <>
+                <SelectEnumField<NotationName>
+                    label="notation"
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::NotationChanged)}
+                    current_value={self.notation.unwrap_or_default()}
+                />
+                { compact_display_checkbox }
+                <SelectEnumField<UseGrouping>
+                    label="use-grouping"
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::UseGrouping)}
+                    current_value={self.config.use_grouping.unwrap_or_default()}
+                />
+                <SelectEnumField<SignDisplay>
+                    label="sign-display"
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::SignDisplay)}
+                    current_value={self.config.sign_display.unwrap_or_default()}
+                />
+            </>
+        }
+    }
+}

package/src/rust/components/style_controls/number_string_format/style_section.rs

@@ -0,0 +1,69 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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 yew::html;
+
+use super::CustomNumberFormat;
+use crate::components::form::select_field::SelectEnumField;
+use crate::components::style_controls::{CustomNumberFormatMsg, NumberStyle};
+use crate::config::*;
+
+impl CustomNumberFormat {
+    pub fn style_section(&self, ctx: &yew::prelude::Context<Self>) -> yew::prelude::Html {
+        let section = match &self.config._style {
+            Some(NumberFormatStyle::Currency(style)) => Some(html! {
+                <>
+                    <SelectEnumField<CurrencyCode>
+                        label="currency"
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::CurrencyCode)}
+                        current_value={style.currency}
+                    />
+                    <SelectEnumField<CurrencyDisplay>
+                        label="currency-display"
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::CurrencyDisplay)}
+                        current_value={style.currency_display.unwrap_or_default()}
+                    />
+                    <SelectEnumField<CurrencySign>
+                        label="currency-sign"
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::CurrencySign)}
+                        current_value={style.currency_sign.unwrap_or_default()}
+                    />
+                </>
+            }),
+            Some(NumberFormatStyle::Unit(style)) => Some(html!(
+                <>
+                    <SelectEnumField<Unit>
+                        label="unit"
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::Unit)}
+                        current_value={style.unit}
+                    />
+                    <SelectEnumField<UnitDisplay>
+                        label="unit-display"
+                        on_change={ctx.link().callback(CustomNumberFormatMsg::UnitDisplay)}
+                        current_value={style.unit_display.unwrap_or_default()}
+                    />
+                </>
+            )),
+            _ => None,
+        };
+        html! {
+            <>
+                <SelectEnumField<NumberStyle>
+                    label="style"
+                    current_value={self.style}
+                    on_change={ctx.link().callback(CustomNumberFormatMsg::StyleChanged)}
+                />
+                { section }
+            </>
+        }
+    }
+}

package/src/rust/components/style_controls/number_string_format/types.rs

@@ -0,0 +1,31 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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 strum::{Display, EnumIter};
+
+#[derive(Clone, PartialEq, Debug, Copy, Default, EnumIter, Display)]
+pub enum NumberStyle {
+    #[default]
+    Decimal,
+    Percent,
+    Currency,
+    Unit,
+}
+
+#[derive(Clone, PartialEq, Debug, Copy, Default, Display, EnumIter)]
+pub enum NotationName {
+    #[default]
+    Standard,
+    Scientific,
+    Engineering,
+    Compact,
+}