@perspective-dev/viewer 4.5.2 → 5.1.0

package/src/ts/plugin.ts

@@ -28,6 +28,36 @@ import { PluginStaticConfig } from "./ts-rs/PluginStaticConfig.js";
  * level (if packaged as a library), or during application init to ensure global
  * availability of a plugin.
  *
+ * ## Dispatch contract
+ *
+ * The host dispatches each method for exactly one reason, and never
+ * defensively — implementations may rely on these meanings:
+ *
+ * - `draw(view)` — `view` is NEW to this plugin: a new engine `View` was
+ *   constructed, or this plugin was freshly selected and owes its first
+ *   render. Safe to reset zoom/scroll/selection state.
+ * - `update(view)` — same `View`, but a plugin-visible input genuinely
+ *   changed: new data (`View.on_update`), an effective view-config delta
+ *   without a rebuild, a *changed* plugin/columns config just delivered
+ *   via `restore()`, changed CSS just applied via `restyle()`, a
+ *   render-limits change, or an explicit public `viewer.restore()` call
+ *   (the no-op-restore refresh affordance). Host-internal operations that
+ *   change none of these dispatch nothing.
+ * - `resize(view)` — geometry or visibility changed (including panel
+ *   activation); repaint from retained state, no data or CSS re-read.
+ * - `restyle()` — the effective theme genuinely changed; when a
+ *   `draw`/`update` is part of the same operation, `restyle()` is called
+ *   immediately BEFORE it, so one render pass paints in the new theme.
+ * - `restore()`/`save()` — state transfer only. Plugins must NOT render
+ *   from `restore()` (a changed restore is always followed by exactly one
+ *   `update`) and must NOT call host APIs from inside it — a
+ *   `restore()` echo re-enters the host's public surface and forces
+ *   a redundant render (the classic double-render-on-load bug).
+ *
+ * Rendering methods (`draw`, `update`, `resize`, `render`, `clear`) and
+ * `delete` are serialized per element — the host never overlaps them, and
+ * each call runs to completion before the next begins.
+ *
  * @example
  * ```javascript
  * const BasePlugin = customElements.get("perspective-viewer-plugin");
@@ -68,6 +98,14 @@ export interface IPerspectiveViewerPlugin {
      * provision to cancel a render in progress per se, calling a method on
      * a `View` which has been deleted will throw an exception.
      *
+     * The host invokes `draw` ONLY when `view` is NEW to this plugin — a
+     * new engine `View` was constructed for a config change, or this plugin
+     * element was freshly selected and owes its first render of the bound
+     * `View` — so implementations may treat it as "new data shape" and
+     * reset zoom/scroll/selection-domain state. Repaints of the same
+     * `View` arrive as `update()` (data or style refresh) or `resize()`
+     * (geometry/chrome), never `draw()`.
+     *
      * @example
      * ```
      * async draw(view: perspective.View): Promise<void> {
@@ -79,9 +117,9 @@ export interface IPerspectiveViewerPlugin {
     draw(view: View): Promise<void>;
 
     /**
-     * Draw under the assumption that the `ViewConfig` has not changed since
-     * the previous call to `draw()`, but the underlying data has.  Defaults to
-     * dispatch to `draw()`.
+     * Draw under the assumption that the `View` has not changed since the
+     * previous call to `draw()`, but some plugin-visible input has.
+     * Defaults to dispatch to `draw()`.
      *
      * @example
      * ```javascript
@@ -109,21 +147,50 @@ export interface IPerspectiveViewerPlugin {
 
     /**
      * Like `update()`, but for when the dimensions of the plugin have changed
-     * and the underlying data has not.
+     * and the underlying data has not — a repaint from retained state,
+     * invoked ONLY when geometry or visibility changed: box resizes,
+     * presize sweeps, and the panel-ACTIVATION chrome nudge (multi-panel),
+     * so implementations should repaint activation-dependent chrome here
+     * and no-op while hidden (`offsetParent == null`).
      */
     resize(view: View): Promise<void>;
 
     /**
      * Notify the plugin that the style environment has changed.  Useful for
-     * plugins which read CSS styles via `window.getComputedStyle()`.
+     * plugins which read CSS styles via `window.getComputedStyle()` — this
+     * is the ONLY point at which a plugin is expected to (re-)read them
+     * (besides its first `draw()`), so implementations may cache computed
+     * styles between `restyle()` calls.
      */
     restyle(): void;
 
     /**
      * Restore this plugin to a state previously returned by `save()`.
+     *
+     * State transfer ONLY — implementations must not render from
+     * `restore()` (the host follows a restore that genuinely changed
+     * plugin state with exactly one `update()` in the same serialized
+     * sequence), and must not call host `<perspective-viewer>` APIs from
+     * inside it: an echoed `restore()` re-enters the host's public
+     * surface where it is indistinguishable from a user call and forces a
+     * redundant render. Host API calls to persist plugin state belong to
+     * genuine user-gesture handlers (e.g. a toolbar click), never to the
+     * `restore()` delivery path.
      */
     restore(config: any): void;
 
+    /**
+     * OPTIONAL — clear any visible user selection state (highlighted rows,
+     * pinned tooltips) WITHOUT emitting selection events. The host
+     * `<perspective-viewer>` invokes this when an element-level global
+     * filter contributed by this plugin's selection is removed from the
+     * global filter bar, so the selection visual can't outlive the filter
+     * it produced. Called under the host's per-panel render serialization
+     * (like `draw`), so implementations may redraw. Plugins without a
+     * selection UI may omit it.
+     */
+    deselect?(): Promise<void>;
+
     /**
      * Free any resources acquired by this plugin and prepare to be deleted.
      */

package/src/ts/ts-rs/ClientOptions.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The `eject` argument: the loaded client to remove by name; the active
+ * panel's client when omitted.
+ */
+export type ClientOptions = { client?: string, };

package/src/ts/ts-rs/ExportMethod.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ExportMethod = "csv" | "csv-all" | "csv-selected" | "json" | "json-all" | "json-selected" | "ndjson" | "ndjson-all" | "ndjson-selected" | "html" | "plugin" | "arrow" | "arrow-selected" | "arrow-all" | "json-config";

package/src/ts/ts-rs/ExportOptions.ts

@@ -0,0 +1,8 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExportMethod } from "./ExportMethod.js";
+
+/**
+ * The `download` / `export` / `copy` argument: the `ExportMethod` and target
+ * panel.
+ */
+export type ExportOptions = { method?: ExportMethod, panel?: string, };

package/src/ts/ts-rs/GetClientOptions.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The `getClient` argument: whether to `wait` for a `Client`, and the target
+ * panel.
+ */
+export type GetClientOptions = { wait?: boolean, panel?: string, };

package/src/ts/ts-rs/GetTableOptions.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The `getTable` argument: whether to `wait` for a `Table`, and the target
+ * panel.
+ */
+export type GetTableOptions = { wait?: boolean, panel?: string, };

package/src/ts/ts-rs/Layout.ts

@@ -0,0 +1,9 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SplitLayout } from "./SplitLayout.js";
+import type { TabLayout } from "./TabLayout.js";
+
+/**
+ * A serde mirror of `regular-layout`'s serialized layout tree, as returned by
+ * [`RegularLayout::save`] and accepted by [`RegularLayout::restore`].
+ */
+export type Layout = { "type": "split-layout" } & SplitLayout | { "type": "tab-layout" } & TabLayout;

package/src/ts/ts-rs/Orientation.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The orientation of a [`SplitLayout`].
+ */
+export type Orientation = "horizontal" | "vertical";

package/src/ts/ts-rs/PanelOptions.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Selects the target panel of a panel-scoped `<perspective-viewer>` method;
+ * the active panel when `panel` is omitted.
+ */
+export type PanelOptions = { panel?: string, };

package/src/ts/ts-rs/PanelViewerConfig.ts

@@ -0,0 +1,16 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Aggregate } from "./Aggregate.js";
+import type { Expressions } from "./Expressions.js";
+import type { Filter } from "./Filter.js";
+import type { FilterReducer } from "./FilterReducer.js";
+import type { GroupRollupMode } from "./GroupRollupMode.js";
+import type { Sort } from "./Sort.js";
+import type { Windows } from "./Windows.js";
+import type { JsonValue } from "./serde_json/JsonValue.js";
+
+/**
+ * The per-panel state of a [`ViewerConfig`] — everything except the
+ * element-level `settings` flag. This is the `panels` entry type of the
+ * whole-element config format.
+ */
+export type PanelViewerConfig<V = string> = { version: V, columns_config: { [key in string]?: { [key in string]?: JsonValue } }, plugin: string, plugin_config: { [key in string]?: JsonValue }, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, windows?: Windows, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };

package/src/ts/ts-rs/SplitLayout.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Layout } from "./Layout.js";
+import type { Orientation } from "./Orientation.js";
+
+export type SplitLayout = { children: Array<Layout>, sizes: Array<number>, orientation: Orientation, };

package/src/ts/ts-rs/TabLayout.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TabLayout = { 
+/**
+ * Panel ids (slot names) in this stack.
+ */
+tabs: Array<string>, 
+/**
+ * Index of the selected tab within `tabs`.
+ */
+selected?: number, };

package/src/ts/ts-rs/ViewerConfig.ts

@@ -5,10 +5,15 @@ import type { Filter } from "./Filter.js";
 import type { FilterReducer } from "./FilterReducer.js";
 import type { GroupRollupMode } from "./GroupRollupMode.js";
 import type { Sort } from "./Sort.js";
+import type { Windows } from "./Windows.js";
 import type { JsonValue } from "./serde_json/JsonValue.js";
 
 /**
  * The state of an entire `custom_elements::PerspectiveViewerElement` component
- * and its `Plugin`.
+ * and its `Plugin`: the element-level `settings` flag plus the per-panel
+ * [`PanelViewerConfig`]. The split exists so the whole-element config format
+ * can serialize panel entries *without* a `settings` key (it is element-level
+ * state there, carried by the top-level `active` field instead), while the
+ * single-panel format flattens back to the legacy shape.
  */
-export type ViewerConfig<V = string> = { version: V, columns_config: { [key in string]?: { [key in string]?: JsonValue } }, plugin: string, plugin_config: { [key in string]?: JsonValue }, settings: boolean, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };
+export type ViewerConfig<V = string> = { settings: boolean, version: V, columns_config: { [key in string]?: { [key in string]?: JsonValue } }, plugin: string, plugin_config: { [key in string]?: JsonValue }, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, windows?: Windows, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };

package/src/ts/ts-rs/ViewerConfigUpdate.ts

@@ -6,6 +6,7 @@ import type { FilterReducer } from "./FilterReducer.js";
 import type { GroupRollupMode } from "./GroupRollupMode.js";
 import type { OptionalUpdate } from "./OptionalUpdate.js";
 import type { Sort } from "./Sort.js";
+import type { Windows } from "./Windows.js";
 import type { JsonValue } from "./serde_json/JsonValue.js";
 
 export type ViewerConfigUpdate = { version?: OptionalUpdate<string>, plugin?: OptionalUpdate<string>, title?: OptionalUpdate<string>, table?: OptionalUpdate<string>, theme?: OptionalUpdate<string>, settings?: OptionalUpdate<boolean>, plugin_config?: OptionalUpdate<{ [key in string]?: JsonValue }>, columns_config?: OptionalUpdate<{ [key in string]?: { [key in string]?: JsonValue } }>, 
@@ -74,6 +75,14 @@ sort?: Array<Sort>,
  * panel.
  */
 expressions?: Expressions, 
+/**
+ * The `windows` property declares ordered, partitioned rolling
+ * computations (moving aggregates, cumulative sums) as _new_ columns
+ * keyed by output alias (`{"name": {...spec}}`, symmetric with
+ * `expressions`), analogous to SQL window functions. See
+ * [`crate::config::WindowSpec`].
+ */
+windows?: Windows, 
 /**
  * Aggregates perform a calculation over an entire column, and are
  * displayed when one or more [Group By](#group-by) are applied to the

package/src/ts/ts-rs/WindowAggregate.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WindowAggregate = "sum" | "avg" | "count" | "min" | "max" | "stddev" | "var" | "first" | "last" | "lag" | "lead" | "diff" | "rate" | "ema";

package/src/ts/ts-rs/WindowSort.ts

@@ -0,0 +1,9 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WindowSortDir } from "./WindowSortDir.js";
+
+/**
+ * The `Table` column which orders each partition, with its direction -
+ * serialized as a two-element array (`["ts", "desc"]`), symmetric with the
+ * `ViewConfig`'s `sort` field.
+ */
+export type WindowSort = [string, WindowSortDir];

package/src/ts/ts-rs/WindowSortDir.ts

@@ -0,0 +1,8 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A window's order direction. A dedicated two-variant enum rather than
+ * [`crate::config::SortDir`] - the column-sort extras (`col asc`, `abs`,
+ * `none`) are meaningless inside a window frame and unrepresentable here.
+ */
+export type WindowSortDir = "asc" | "desc";

package/src/ts/ts-rs/WindowSpec.ts

@@ -0,0 +1,46 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WindowAggregate } from "./WindowAggregate.js";
+import type { WindowSort } from "./WindowSort.js";
+
+/**
+ * The serialized form of [`WindowSpec`].
+ */
+export type WindowSpec = { 
+/**
+ * The input column - either a real `Table` column or an expression
+ * alias from the same `ViewConfig`.
+ */
+column: string, aggregate: WindowAggregate, 
+/**
+ * Columns whose distinct value tuples partition the rows; empty
+ * partitions the whole `Table` as one group.
+ */
+partition_by?: Array<string>, 
+/**
+ * The `Table` column which orders each partition, and the direction.
+ */
+order_by?: WindowSort | null, 
+/**
+ * A frame of the `rows` preceding each row, plus the row itself.
+ * Mutually exclusive with `range` and `cumulative`.
+ */
+rows?: number | null, 
+/**
+ * A frame of the rows whose `order_by` value lies within `range` of
+ * each row's, requiring a numeric or temporal `order_by`. Mutually
+ * exclusive with `rows` and `cumulative`.
+ */
+range?: number | null, 
+/**
+ * `true` frames all rows from the partition start through each row.
+ * Default can be omitted.
+ */
+cumulative?: boolean | null, 
+/**
+ * Row offset for `lag`/`lead` (default 1).
+ */
+offset?: number | null, 
+/**
+ * Smoothing factor in `(0, 1]` for `ema`.
+ */
+alpha?: number | null, };

package/src/ts/ts-rs/Windows.ts

@@ -0,0 +1,10 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WindowSpec } from "./WindowSpec.js";
+
+/**
+ * The window columns of a `ViewConfig`, keyed by output column alias -
+ * symmetric with `expressions` (`{"name": {...spec}}`). An alias must not
+ * collide with a `Table` column, expression alias, or another window's
+ * key.
+ */
+export type Windows = { [key in string]?: WindowSpec };

package/src/ts/ts-rs/WorkspaceConfig.ts

@@ -0,0 +1,36 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Filter } from "./Filter.js";
+import type { Layout } from "./Layout.js";
+import type { PanelViewerConfig } from "./PanelViewerConfig.js";
+
+/**
+ * The whole-element config format (`{version, active?, layout, panels}`) —
+ * the multi-panel counterpart of the single-panel [`ViewerConfig`] — as
+ * emitted by [`PerspectiveViewerElement::save`].
+ *
+ * - `panels` entries are [`PanelViewerConfig`]s: per-panel state only, no
+ *   `settings` key (element-level state).
+ * - `active` names the panel targeted by the *open* settings sidebar; it is
+ *   omitted when the sidebar is closed.
+ */
+export type WorkspaceConfig = { version: string, active?: string, layout: Layout | null, 
+/**
+ * `BTreeMap` (not `HashMap`) so `save()` serializes panels in a
+ * DETERMINISTIC (sorted) key order — a fresh `HashMap` per call
+ * iterates in a per-instance random order, which made consecutive
+ * `save()` outputs byte-unstable.
+ */
+panels: { [key in string]?: PanelViewerConfig<string> }, 
+/**
+ * The element-level global (master/detail cross-) filters. A transient
+ * overlay on every detail panel's view — persisted here, never in a
+ * per-panel entry. Omitted when empty.
+ */
+global_filters?: Array<Filter>, 
+/**
+ * The MASTER (filter-source) panels' ids, referencing `panels` keys.
+ * Roles are layout state (like the panel arrangement), so they persist;
+ * which master contributed which clause does not — restored
+ * `global_filters` are one unattributed bucket. Omitted when empty.
+ */
+masters?: Array<string>, };

package/src/ts/ts-rs/WorkspaceConfigUpdate.ts

@@ -0,0 +1,24 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Filter } from "./Filter.js";
+import type { Layout } from "./Layout.js";
+import type { ViewerConfigUpdate } from "./ViewerConfigUpdate.js";
+
+/**
+ * The parse target of a whole-element config in
+ * [`PerspectiveViewerElement::restore`]. Mirrors [`WorkspaceConfig`],
+ * but `panels` entries are full [`ViewerConfigUpdate`]s so a stray per-panel
+ * `settings` can be detected (warned, then ignored — `create_panel` strips
+ * it).
+ */
+export type WorkspaceConfigUpdate = { active?: string, layout?: Layout, panels: { [key in string]?: ViewerConfigUpdate }, 
+/**
+ * The element-level global (master/detail cross-) filters to re-apply as
+ * a transient overlay on every DETAIL panel. Restored as one
+ * unattributed bucket: the next selection on any master replaces it.
+ */
+global_filters?: Array<Filter>, 
+/**
+ * The master (filter-source) panels, by saved `panels` key. An id not in
+ * `panels` warns and is dropped.
+ */
+masters?: Array<string>, };

package/src/rust/tasks/intersection_observer.rs

@@ -1,98 +0,0 @@
-// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
-// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
-// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
-// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
-// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
-// ┃ 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 wasm_bindgen::JsCast;
-use wasm_bindgen::prelude::*;
-use web_sys::*;
-
-use crate::config::ViewerConfigUpdate;
-use crate::js::*;
-use crate::presentation::Presentation;
-use crate::renderer::*;
-use crate::session::Session;
-use crate::utils::*;
-use crate::*;
-
-pub struct IntersectionObserverHandle {
-    elem: HtmlElement,
-    observer: IntersectionObserver,
-    _callback: Closure<dyn FnMut(js_sys::Array)>,
-}
-
-impl IntersectionObserverHandle {
-    pub fn new(
-        elem: &HtmlElement,
-        presentation: &Presentation,
-        session: &Session,
-        renderer: &Renderer,
-    ) -> Self {
-        clone!(session, renderer, presentation);
-        let _callback = Closure::new(move |xs: js_sys::Array| {
-            // https://stackoverflow.com/questions/53862160/intersectionobserver-multiple-entries
-            let intersect = xs
-                .pop()
-                .unchecked_into::<IntersectionObserverEntry>()
-                .is_intersecting();
-
-            clone!(session, renderer, presentation);
-            let state = IntersectionObserverState {
-                presentation,
-                session,
-                renderer,
-            };
-
-            ApiFuture::spawn(state.set_pause(intersect));
-        });
-
-        let func = _callback.as_ref().unchecked_ref::<js_sys::Function>();
-        let observer = IntersectionObserver::new(func);
-        observer.observe(elem);
-        Self {
-            elem: elem.clone(),
-            _callback,
-            observer,
-        }
-    }
-}
-
-impl Drop for IntersectionObserverHandle {
-    fn drop(&mut self) {
-        self.observer.unobserve(&self.elem);
-    }
-}
-
-struct IntersectionObserverState {
-    session: Session,
-    renderer: Renderer,
-    presentation: Presentation,
-}
-
-impl IntersectionObserverState {
-    async fn set_pause(self, intersect: bool) -> ApiResult<()> {
-        if intersect {
-            if self.session.set_pause(false) {
-                super::restore_and_render(
-                    &self.session,
-                    &self.renderer,
-                    &self.presentation,
-                    ViewerConfigUpdate::default(),
-                    async move { Ok(()) },
-                )
-                .await?;
-            }
-        } else {
-            self.session.set_pause(true);
-        };
-
-        Ok(())
-    }
-}

package/src/rust/tasks/update_and_render.rs

@@ -1,110 +0,0 @@
-// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
-// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
-// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
-// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
-// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
-// ┃ 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). ┃
-// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
-
-//! Apply a [`ViewConfigUpdate`] to the active [`Session`], validate it, then
-//! draw with the active [`Renderer`].  The companion `*_callback` helpers
-//! return [`yew::Callback`]s suitable for wiring as Yew child-component
-//! props.
-
-use perspective_client::config::ViewConfigUpdate;
-use yew::prelude::*;
-
-use crate::renderer::Renderer;
-use crate::session::Session;
-use crate::utils::*;
-use crate::*;
-
-/// Create a [`Callback`] that renders from the current `View` and `Plugin`.
-pub fn render_callback(session: &Session, renderer: &Renderer) -> Callback<()> {
-    clone!(session, renderer);
-    Callback::from(move |_| {
-        clone!(session, renderer);
-        ApiFuture::spawn(async move {
-            renderer.draw(async { Ok(session.get_view()) }).await?;
-            Ok(())
-        })
-    })
-}
-
-/// Create a [`Callback`] that resizes from the current `View` and `Plugin`.
-pub fn resize_callback(session: &Session, renderer: &Renderer) -> Callback<()> {
-    clone!(session, renderer);
-    Callback::from(move |_| {
-        clone!(renderer, session);
-        ApiFuture::spawn(async move {
-            if !renderer.is_plugin_activated()? {
-                update_and_render_inner(session, renderer).await?
-            } else {
-                renderer.resize().await?;
-            }
-
-            Ok(())
-        })
-    })
-}
-
-/// Apply a `ViewConfigUpdate` to the current `View` and render.
-pub fn update_and_render(
-    session: &Session,
-    renderer: &Renderer,
-    update: ViewConfigUpdate,
-) -> ApiResult<ApiFuture<()>> {
-    session.update_view_config(update)?;
-    clone!(session, renderer);
-    Ok(ApiFuture::new(update_and_render_inner(session, renderer)))
-}
-
-/// Re-render the current `View` and `Plugin` without applying a new
-/// `ViewConfigUpdate`.
-pub fn just_render(session: &Session, renderer: &Renderer) -> ApiResult<ApiFuture<()>> {
-    clone!(session, renderer);
-    Ok(ApiFuture::new(update_and_render_inner(session, renderer)))
-}
-
-#[tracing::instrument(level = "debug", skip(session, renderer))]
-async fn update_and_render_inner(session: Session, renderer: Renderer) -> ApiResult<()> {
-    // The previous call which acquired the lock errored, so skip this render
-    if session.get_error().is_some() {
-        return Ok(());
-    }
-
-    let plugin_swapped = renderer.apply_pending_plugin()?;
-
-    // Validate + create the view BEFORE the plugin-swap materialize
-    // so the schema query sees fresh `expression_schema` /
-    // `view_schema` and `resolve_abs_max` has a bound view that
-    // knows about any new expression columns.
-    let view = session.validate().await?.create_view().await?;
-
-    if plugin_swapped {
-        // `commit_plugin_idx` already restored the new plugin from its
-        // raw bucket; re-run with the materialized snapshot so any
-        // `include: true` schema defaults (e.g. Datagrid's
-        // `fg_gradient` when `number_fg_mode = "bar"`) make it into
-        // the plugin's state before the first draw. The Session is in
-        // scope here but not at `commit_plugin_idx`'s call sites in
-        // the column-selector tree, so we do the second restore at
-        // the caller instead of plumbing `&Session` through every
-        // `apply_pending_plugin` site.
-        let view_config_snapshot = session.get_view_config().clone();
-        let plugin_token = wasm_bindgen::JsValue::from_serde_ext(&renderer.get_plugin_config())
-            .unwrap_or(wasm_bindgen::JsValue::NULL);
-        let columns_config = renderer
-            .all_columns_configs_materialized(&view_config_snapshot, &session)
-            .await;
-        renderer
-            .get_active_plugin()?
-            .restore(&plugin_token, Some(&columns_config))?;
-    }
-
-    renderer.draw(async { Ok(view) }).await
-}