perspective-viewer 5.6.0

The `<perspective-viewer>` Custom Element: a WebAssembly data grid, pivot table and charting UI for large, real-time and streaming datasets.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
// ┃ 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 futures::FutureExt;
use perspective_client::clone;
use perspective_js::utils::*;

use crate::config::ColumnConfigFieldUpdate;
use crate::renderer::{Renderer, StagedEdit};
use crate::session::{EditDelta, OpKind, Session};

/// Apply a [`ColumnConfigFieldUpdate`] from a column-style sidebar
/// control to the active plugin's per-column config bucket on
/// [`Renderer`], then re-`restore` the active plugin with the
/// updated maps and trigger a render.
///
/// Plugin-level (non-column) field updates go through
/// [`super::send_plugin_config`] instead.
pub fn send_column_config(
    session: &Session,
    renderer: &Renderer,
    column_name: &str,
    update: ColumnConfigFieldUpdate,
) {
    let column = column_name.to_string();
    let staged = renderer.stage(StagedEdit::ColumnField {
        column: column.clone(),
        update: update.clone(),
    });

    let kind = OpKind::Edit {
        delta: EditDelta::Renderer,
        swaps_plugin: false,
    };

    let ticket = session.submit(kind, {
        clone!(session, renderer);
        move |_ctx| {
            Box::pin(async move {
                let view_config = session.committed_view_config().clone();
                renderer.update_columns_config_field(&view_config, &session, column, update);
                drop(staged);
                Ok(Some(
                    async move {
                        let view_config_snapshot = session.committed_view_config().clone();
                        let columns_configs = renderer
                            .all_columns_configs_materialized(&view_config_snapshot, &session)
                            .await;

                        let plugin_token = wasm_bindgen::JsValue::from_serde_ext(
                            &renderer.committed_plugin_config(),
                        )
                        .unwrap();

                        renderer
                            .ensure_plugin_selected()?
                            .restore(&plugin_token, Some(&columns_configs))?;

                        clone!(session);
                        renderer
                            .update_lazy(async move { Ok(session.get_view_with_dimensions()) })
                            .await?;

                        renderer
                            .columns_config_changed
                            .emit(columns_configs.clone());

                        renderer.column_style_changed.emit(columns_configs);
                        Ok(())
                    }
                    .boxed_local(),
                ))
            })
        }
    });

    ApiFuture::spawn(ticket.settle());
}