@perspective-dev/viewer 5.5.1 → 5.6.0

package/src/ts/extensions.ts

@@ -14,43 +14,10 @@ import type { HTMLPerspectiveViewerPluginElement } from "./plugin";
 import type { PerspectiveViewerElement } from "../../dist/wasm/perspective-viewer.js";
 import type React from "react";
 import type { ViewerConfigUpdate } from "./ts-rs/ViewerConfigUpdate.js";
-import type {
-    ViewWindow,
-    ViewConfigUpdate,
-    Filter,
-} from "@perspective-dev/client";
-
-export class PerspectiveSelectDetail {
-    selected: boolean;
-    row: Record<string, unknown>;
-    column_names?: string[];
-    removeConfigs: ViewConfigUpdate[];
-    insertConfigs: ViewConfigUpdate[];
-    panel?: string;
-    constructor(
-        selected: boolean,
-        row: Record<string, unknown>,
-        column_names: string[],
-        removeConfigs: ViewConfigUpdate[],
-        insertConfigs: ViewConfigUpdate[],
-        panel?: string,
-    ) {
-        this.selected = selected;
-        this.row = row;
-        this.column_names = column_names;
-        this.removeConfigs = removeConfigs;
-        this.insertConfigs = insertConfigs;
-        this.panel = panel;
-    }
-
-    get removeFilters(): Filter[] {
-        return this.removeConfigs.flatMap((x) => x.filter ?? []);
-    }
+import type { ViewWindow, Filter } from "@perspective-dev/client";
+import type { PerspectiveSelectDetail } from "./select-detail.ts";
 
-    get insertFilters(): Filter[] {
-        return this.insertConfigs.flatMap((x) => x.filter ?? []);
-    }
-}
+export { PerspectiveSelectDetail } from "./select-detail.ts";
 
 // DOM extensions
 

package/src/ts/perspective-viewer.ts

@@ -47,7 +47,7 @@ export {
 export type { NumberFormatConfig, DateFormatConfig } from "./column-format";
 
 export type * from "./extensions.ts";
-export { PerspectiveSelectDetail } from "./extensions.ts";
+export { PerspectiveSelectDetail } from "./select-detail.ts";
 export type * from "./ts-rs/ViewerConfigUpdate.d.ts";
 export type * from "./ts-rs/ViewerConfig.d.ts";
 export type * from "./ts-rs/WorkspaceConfigUpdate.d.ts";

package/src/ts/plugin.ts

@@ -97,6 +97,9 @@ export interface IPerspectiveViewerPlugin {
      * The per-column Style-tab schema: the controls the viewer renders
      * for one column, re-queried on every field edit so the field set
      * may depend on `current_value`.
+     *
+     * Must be a function of its arguments alone, never of what this element
+     * last drew or was last `restore`d with.
      */
     column_config_schema?(
         view_type: string,
@@ -104,7 +107,7 @@ export interface IPerspectiveViewerPlugin {
         column_name: string,
         current_value: Record<string, unknown> | null,
         viewer_config?: Record<string, unknown>,
-        column_stats?: Record<string, unknown>,
+        plugin_config?: Record<string, unknown> | null,
     ): { fields: Array<Record<string, unknown> & { kind: string }> };
 
     /**

package/src/{rust/utils/tests/request_animation_frame.rs → ts/select-detail.ts}

@@ -10,33 +10,39 @@
 // ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-use std::cell::*;
-use std::rc::*;
+import type { ViewConfigUpdate, Filter } from "@perspective-dev/client";
 
-use wasm_bindgen_futures::spawn_local;
-use wasm_bindgen_test::*;
+/**
+ * The `detail` of a `perspective-global-filter` event.
+ */
+export class PerspectiveSelectDetail {
+    selected: boolean;
+    row: Record<string, unknown>;
+    column_names?: string[];
+    removeConfigs: ViewConfigUpdate[];
+    insertConfigs: ViewConfigUpdate[];
+    panel?: string;
+    constructor(
+        selected: boolean,
+        row: Record<string, unknown>,
+        column_names: string[],
+        removeConfigs: ViewConfigUpdate[],
+        insertConfigs: ViewConfigUpdate[],
+        panel?: string,
+    ) {
+        this.selected = selected;
+        this.row = row;
+        this.column_names = column_names;
+        this.removeConfigs = removeConfigs;
+        this.insertConfigs = insertConfigs;
+        this.panel = panel;
+    }
 
-use crate::utils::*;
+    get removeFilters(): Filter[] {
+        return this.removeConfigs.flatMap((x) => x.filter ?? []);
+    }
 
-#[wasm_bindgen_test]
-async fn test_request_animation_frame_async() {
-    // Merely test that this Promise resolves at all ..
-    request_animation_frame().await;
-}
-
-#[wasm_bindgen_test]
-async fn test_async_in_correct_order() {
-    let cell = Rc::new(RefCell::new(vec![]));
-    spawn_local({
-        clone!(cell);
-        async move {
-            request_animation_frame().await;
-            cell.borrow_mut().push("1");
-        }
-    });
-
-    request_animation_frame().await;
-    cell.borrow_mut().push("2");
-    request_animation_frame().await;
-    assert_eq!(vec!["2", "1"], *cell.borrow());
+    get insertFilters(): Filter[] {
+        return this.insertConfigs.flatMap((x) => x.filter ?? []);
+    }
 }

package/src/ts/ts-rs/DerivedTableConfig.ts

@@ -0,0 +1,22 @@
+// 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 { SplitRollupMode } from "./SplitRollupMode.js";
+import type { Windows } from "./Windows.js";
+
+/**
+ * A derived `Table`'s definition: the `Table` its source `View` reads, and
+ * the config of that `View`; generic over the `table` slot, which is a name
+ * in the workspace `derived_tables` map and a recursive [`TableRef`] when
+ * inlined in a single-panel config.
+ */
+export type DerivedTableConfig<T = string> = { 
+/**
+ * The `Table` this derivation reads, which may itself be another
+ * derived `Table`.
+ */
+table: T, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, split_rollup_mode: SplitRollupMode, 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/PanelViewerConfig.ts

@@ -6,6 +6,7 @@ import type { FilterReducer } from "./FilterReducer.js";
 import type { GroupRollupMode } from "./GroupRollupMode.js";
 import type { Sort } from "./Sort.js";
 import type { SplitRollupMode } from "./SplitRollupMode.js";
+import type { TableRef } from "./TableRef.js";
 import type { Windows } from "./Windows.js";
 import type { JsonValue } from "./serde_json/JsonValue.js";
 
@@ -14,7 +15,7 @@ import type { JsonValue } from "./serde_json/JsonValue.js";
  * element-level `settings` flag. This is the `panels` entry type of the
  * workspace config format.
  */
-export type PanelViewerConfig<V = string> = { 
+export type PanelViewerConfig<V = string, T = TableRef> = { 
 /**
  * The `@perspective-dev/viewer` version that wrote this config,
  * stamped on save and used to migrate older tokens. Callers do not
@@ -44,12 +45,12 @@ plugin: string,
  */
 plugin_config: { [key in string]?: JsonValue }, 
 /**
- * Name of the `Table` this panel renders, as hosted on the panel's
- * `Client`. Every placed panel has a table binding (creation
- * requires one by type — [`ViewerConfigInitial`]), so the saved
- * config carries it unconditionally.
+ * The `Table` this panel renders: its hosted name in a
+ * [`WorkspaceConfig`] `panels` entry (`T = String`), and a
+ * [`TableRef`] — a name, or a recursively inlined derived-table
+ * definition — in the single-panel `save()` format.
  */
-table: string, 
+table: T, 
 /**
  * Selected theme NAME (e.g. `"Pro Dark"`) — not a CSS value. Valid
  * names are the Perspective themes loaded on the page, which

package/src/ts/ts-rs/RestoreOptions.ts

@@ -9,13 +9,9 @@ export type RestoreOptions = {
  */
 panel?: string, 
 /**
- * When `true`, a failed restore only REJECTS the returned `Promise` —
- * the error is not committed to the viewer's visible error state, and
- * the session remains usable for subsequent calls. For programmatic
- * callers (e.g. the LLM agent's `set_view_config` tool) for whom a
- * failed config patch is feedback rather than a user-facing fault.
- * The config may be partially applied on failure; restore a
- * known-good config to recover exactly.
+ * When `true`, a config that was applied and then failed to render only
+ * rejects the returned `Promise`, without raising the panel's visible
+ * error state.
  */
 suppress_errors?: boolean, 
 /**

package/src/ts/ts-rs/TableRef.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 { DerivedTableConfig } from "./DerivedTableConfig.js";
+
+/**
+ * What may occupy a `table` position in a single-panel config: a hosted
+ * `Table`'s name, or an inline derived-table definition recursing through
+ * its own `table` field until a concrete name.
+ */
+export type TableRef = string | (Omit<DerivedTableConfig, "table"> & { table: TableRef });

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

@@ -6,6 +6,7 @@ import type { FilterReducer } from "./FilterReducer.js";
 import type { GroupRollupMode } from "./GroupRollupMode.js";
 import type { Sort } from "./Sort.js";
 import type { SplitRollupMode } from "./SplitRollupMode.js";
+import type { TableRef } from "./TableRef.js";
 import type { Windows } from "./Windows.js";
 import type { JsonValue } from "./serde_json/JsonValue.js";
 
@@ -17,7 +18,7 @@ import type { JsonValue } from "./serde_json/JsonValue.js";
  * 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> = { settings: boolean, 
+export type ViewerConfig<V = string, T = TableRef> = { settings: boolean, 
 /**
  * The `@perspective-dev/viewer` version that wrote this config,
  * stamped on save and used to migrate older tokens. Callers do not
@@ -47,12 +48,12 @@ plugin: string,
  */
 plugin_config: { [key in string]?: JsonValue }, 
 /**
- * Name of the `Table` this panel renders, as hosted on the panel's
- * `Client`. Every placed panel has a table binding (creation
- * requires one by type — [`ViewerConfigInitial`]), so the saved
- * config carries it unconditionally.
+ * The `Table` this panel renders: its hosted name in a
+ * [`WorkspaceConfig`] `panels` entry (`T = String`), and a
+ * [`TableRef`] — a name, or a recursively inlined derived-table
+ * definition — in the single-panel `save()` format.
  */
-table: string, 
+table: T, 
 /**
  * Selected theme NAME (e.g. `"Pro Dark"`) — not a CSS value. Valid
  * names are the Perspective themes loaded on the page, which

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

@@ -7,6 +7,7 @@ import type { GroupRollupMode } from "./GroupRollupMode.js";
 import type { OptionalUpdate } from "./OptionalUpdate.js";
 import type { Sort } from "./Sort.js";
 import type { SplitRollupMode } from "./SplitRollupMode.js";
+import type { TableRef } from "./TableRef.js";
 import type { Windows } from "./Windows.js";
 import type { JsonValue } from "./serde_json/JsonValue.js";
 
@@ -33,12 +34,13 @@ plugin?: OptionalUpdate<string>,
  */
 title?: OptionalUpdate<string>, 
 /**
- * Name of the `Table` to render, as hosted on this panel's
- * `Client`. Rebinding an existing panel to another table keeps the
- * rest of the config, so column names that do not exist in the new
- * table will fail validation.
+ * The `Table` to render: a name as hosted on this panel's `Client`,
+ * or an inline derived-table definition to materialize (reusing a
+ * structurally identical derived `Table` when one exists). Rebinding
+ * an existing panel keeps the rest of the config, so column names
+ * that do not exist in the new table will fail validation.
  */
-table?: OptionalUpdate<string>, 
+table?: OptionalUpdate<TableRef>, 
 /**
  * Theme NAME (e.g. `"Pro Dark"`) — not a CSS value. Valid names are
  * the Perspective themes loaded on the page, re-scanned by

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

@@ -1,4 +1,5 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { DerivedTableConfig } from "./DerivedTableConfig.js";
 import type { Filter } from "./Filter.js";
 import type { Layout } from "./Layout.js";
 import type { PanelViewerConfig } from "./PanelViewerConfig.js";
@@ -20,7 +21,12 @@ export type WorkspaceConfig = { version: string, active?: string, layout: Layout
  * iterates in a per-instance random order, which made consecutive
  * `save()` outputs byte-unstable.
  */
-panels: { [key in string]?: PanelViewerConfig<string> }, 
+panels: { [key in string]?: PanelViewerConfig<string, string> }, 
+/**
+ * Named derived `Table`s, each a `View` of its `parent` promoted to a
+ * `Table`. A `BTreeMap` for the same determinism reason as `panels`.
+ */
+derived_tables?: { [key in string]?: DerivedTableConfig<string> }, 
 /**
  * The element-level global (master/detail cross-) filters. A transient
  * overlay on every detail panel's view — persisted here, never in a

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

@@ -1,4 +1,5 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { DerivedTableConfig } from "./DerivedTableConfig.js";
 import type { Filter } from "./Filter.js";
 import type { Layout } from "./Layout.js";
 import type { OptionalUpdate } from "./OptionalUpdate.js";
@@ -26,6 +27,12 @@ layout?: Layout,
  * existing panels.
  */
 panels?: { [key in string]?: ViewerConfigInitial }, 
+/**
+ * The complete replacement set of derived `Table`s, in any order (they
+ * are built parent-first); absent keeps the current ones, `{}` deletes
+ * them all.
+ */
+derived_tables?: { [key in string]?: DerivedTableConfig<string> }, 
 /**
  * The element-level cross-filter set applied to every detail panel as
  * one unattributed bucket, replacing the current set; `null` clears it.

package/dist/esm/perspective-viewer.inline.d.ts

@@ -1,3 +0,0 @@
-import perspective_viewer from "./perspective-viewer.ts";
-export * from "./perspective-viewer.ts";
-export default perspective_viewer;