@perspective-dev/viewer 5.5.0 → 5.6.0

package/dist/esm/plugin.d.ts

@@ -82,8 +82,11 @@ 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, group: string | undefined, column_name: string, current_value: Record<string, unknown> | null, viewer_config?: Record<string, unknown>, column_stats?: Record<string, unknown>): {
+    column_config_schema?(view_type: string, group: string | undefined, column_name: string, current_value: Record<string, unknown> | null, viewer_config?: Record<string, unknown>, plugin_config?: Record<string, unknown> | null): {
         fields: Array<Record<string, unknown> & {
             kind: string;
         }>;

package/dist/esm/select-detail.d.ts

@@ -0,0 +1,15 @@
+import type { ViewConfigUpdate, Filter } from "@perspective-dev/client";
+/**
+ * The `detail` of a `perspective-global-filter` event.
+ */
+export declare 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);
+    get removeFilters(): Filter[];
+    get insertFilters(): Filter[];
+}

package/dist/esm/select-detail.js

@@ -0,0 +1,2 @@
+var i=class{selected;row;column_names;removeConfigs;insertConfigs;panel;constructor(e,t,n,r,s,o){this.selected=e,this.row=t,this.column_names=n,this.removeConfigs=r,this.insertConfigs=s,this.panel=o}get removeFilters(){return this.removeConfigs.flatMap(e=>e.filter??[])}get insertFilters(){return this.insertConfigs.flatMap(e=>e.filter??[])}};export{i as PerspectiveSelectDetail};
+//# sourceMappingURL=select-detail.js.map

package/dist/esm/select-detail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ts/select-detail.ts"],
+  "sourcesContent": ["// \u250F\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n// \u2503 \u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588       \u2588      \u2588      \u2588      \u2588      \u2588 \u2588\u2584  \u2580\u2588\u2588\u2588 \u2588       \u2503\n// \u2503 \u2584\u2584\u2584\u2584\u2584\u2588 \u2588\u2584\u2584\u2584\u2584\u2584 \u2584\u2584\u2584\u2584\u2584\u2588  \u2580\u2580\u2580\u2580\u2580\u2588\u2580\u2580\u2580\u2580\u2580 \u2588 \u2580\u2580\u2580\u2580\u2580\u2588 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u258C\u2590\u2588\u2588\u2588 \u2588\u2588\u2588\u2584  \u2580\u2588 \u2588 \u2580\u2580\u2580\u2580\u2580 \u2503\n// \u2503 \u2588\u2580\u2580\u2580\u2580\u2580 \u2588\u2580\u2580\u2580\u2580\u2580 \u2588\u2580\u2588\u2588\u2580\u2580 \u2584\u2584\u2584\u2584\u2584 \u2588 \u2584\u2584\u2584\u2584\u2584\u2588 \u2584\u2584\u2584\u2584\u2584\u2588 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u258C\u2590\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2584   \u2588 \u2584\u2584\u2584\u2584\u2584 \u2503\n// \u2503 \u2588      \u2588\u2588\u2588\u2588\u2588\u2588 \u2588  \u2580\u2588\u2584       \u2588 \u2588\u2588\u2588\u2588\u2588\u2588      \u2588      \u2588\u2588\u2588\u258C\u2590\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2584 \u2588       \u2503\n// \u2523\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u252B\n// \u2503 Copyright (c) 2017, the Perspective Authors.                              \u2503\n// \u2503 \u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C\u254C \u2503\n// \u2503 This file is part of the Perspective library, distributed under the terms \u2503\n// \u2503 of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). \u2503\n// \u2517\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u251B\n\nimport type { ViewConfigUpdate, Filter } from \"@perspective-dev/client\";\n\n/**\n * The `detail` of a `perspective-global-filter` event.\n */\nexport class PerspectiveSelectDetail {\n    selected: boolean;\n    row: Record<string, unknown>;\n    column_names?: string[];\n    removeConfigs: ViewConfigUpdate[];\n    insertConfigs: ViewConfigUpdate[];\n    panel?: string;\n    constructor(\n        selected: boolean,\n        row: Record<string, unknown>,\n        column_names: string[],\n        removeConfigs: ViewConfigUpdate[],\n        insertConfigs: ViewConfigUpdate[],\n        panel?: string,\n    ) {\n        this.selected = selected;\n        this.row = row;\n        this.column_names = column_names;\n        this.removeConfigs = removeConfigs;\n        this.insertConfigs = insertConfigs;\n        this.panel = panel;\n    }\n\n    get removeFilters(): Filter[] {\n        return this.removeConfigs.flatMap((x) => x.filter ?? []);\n    }\n\n    get insertFilters(): Filter[] {\n        return this.insertConfigs.flatMap((x) => x.filter ?? []);\n    }\n}\n"],
+  "mappings": "AAiBO,IAAMA,EAAN,KAA8B,CACjC,SACA,IACA,aACA,cACA,cACA,MACA,YACIC,EACAC,EACAC,EACAC,EACAC,EACAC,EACF,CACE,KAAK,SAAWL,EAChB,KAAK,IAAMC,EACX,KAAK,aAAeC,EACpB,KAAK,cAAgBC,EACrB,KAAK,cAAgBC,EACrB,KAAK,MAAQC,CACjB,CAEA,IAAI,eAA0B,CAC1B,OAAO,KAAK,cAAc,QAASC,GAAMA,EAAE,QAAU,CAAC,CAAC,CAC3D,CAEA,IAAI,eAA0B,CAC1B,OAAO,KAAK,cAAc,QAASA,GAAMA,EAAE,QAAU,CAAC,CAAC,CAC3D,CACJ",
+  "names": ["PerspectiveSelectDetail", "selected", "row", "column_names", "removeConfigs", "insertConfigs", "panel", "x"]
+}

package/dist/esm/ts-rs/DerivedTableConfig.d.ts

@@ -0,0 +1,35 @@
+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/dist/esm/ts-rs/ExportMethod.d.ts

@@ -1 +1 @@
-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";
+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" | "arrow-lz4" | "arrow-lz4-selected" | "arrow-lz4-all" | "arrow-zstd" | "arrow-zstd-selected" | "arrow-zstd-all" | "json-config";

package/dist/esm/ts-rs/PanelViewerConfig.d.ts

@@ -5,6 +5,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";
 /**
@@ -12,7 +13,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
@@ -48,12 +49,12 @@ export type PanelViewerConfig<V = string> = {
         [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/dist/esm/ts-rs/RestoreOptions.d.ts

@@ -7,13 +7,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/dist/esm/ts-rs/TableRef.d.ts

@@ -0,0 +1,9 @@
+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/dist/esm/ts-rs/ViewerConfig.d.ts

@@ -5,6 +5,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";
 /**
@@ -15,7 +16,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> = {
+export type ViewerConfig<V = string, T = TableRef> = {
     settings: boolean;
     /**
      * The `@perspective-dev/viewer` version that wrote this config,
@@ -52,12 +53,12 @@ export type ViewerConfig<V = string> = {
         [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/dist/esm/ts-rs/ViewerConfigUpdate.d.ts

@@ -6,6 +6,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";
 export type ViewerConfigUpdate = {
@@ -31,12 +32,13 @@ export type ViewerConfigUpdate = {
      */
     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/dist/esm/ts-rs/WorkspaceConfig.d.ts

@@ -1,3 +1,4 @@
+import type { DerivedTableConfig } from "./DerivedTableConfig.js";
 import type { Filter } from "./Filter.js";
 import type { Layout } from "./Layout.js";
 import type { PanelViewerConfig } from "./PanelViewerConfig.js";
@@ -22,7 +23,14 @@ export type WorkspaceConfig = {
      * `save()` outputs byte-unstable.
      */
     panels: {
-        [key in string]?: PanelViewerConfig<string>;
+        [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

package/dist/esm/ts-rs/WorkspaceConfigUpdate.d.ts

@@ -1,3 +1,4 @@
+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,14 @@ export type WorkspaceConfigUpdate = {
     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/wasm/perspective-viewer.d.ts

@@ -11,6 +11,25 @@ export interface VirtualHostedTable {
     limit?: number;
 }
 
+/** One expression's compile error, as reported by `tableDescribe`. */
+export interface ExpressionError {
+    error_message: string;
+    line: number;
+    column: number;
+}
+
+/** The verdict of `VirtualServerHandler.tableDescribe`. */
+export type TableDescription =
+| {
+    expression_schema: Record<string, ColumnType>;
+    view_schema: Record<string, ColumnType>;
+}
+| {
+    expression_schema?: Record<string, ColumnType>;
+    expression_errors: Record<string, ExpressionError>;
+}
+| { config_error: string };
+
 /**
  * Handler interface that you implement to provide custom data sources.
  *
@@ -59,11 +78,14 @@ export interface VirtualServerHandler {
     config: ViewConfig,
     ): number | Promise<number>;
 
-    /** Required when `getFeatures()` reports `expressions: true`. */
-    tableValidateExpression?(
+    /**
+     * Validate a complete view config against a table and report the schema
+     * a view built from it would have, without creating one.
+     */
+    tableDescribe(
     tableId: string,
-    expression: string,
-    ): ColumnType | Promise<ColumnType>;
+    config: ViewConfig,
+    ): TableDescription | Promise<TableDescription>;
 
     viewGetMinMax?(
     viewId: string,
@@ -81,6 +103,12 @@ export interface VirtualServerHandler {
     tableId: string,
     data: string | Uint8Array,
     ): void | Promise<void>;
+    viewMakeTable?(
+    viewId: string,
+    tableId: string,
+    config: ViewConfig,
+    schema?: Record<string, ColumnType>,
+    ): void | Promise<void>;
 }
 
 
@@ -109,6 +137,8 @@ export type * from "../../src/ts/ts-rs/ViewerConfigUpdate.d.ts";
 export type * from "../../src/ts/ts-rs/ViewerConfigInitial.d.ts";
 export type * from "../../src/ts/ts-rs/PluginStaticConfig.d.ts";
 export type * from "../../src/ts/ts-rs/WorkspaceConfig.d.ts";
+export type * from "../../src/ts/ts-rs/TableRef.d.ts";
+export type * from "../../src/ts/ts-rs/DerivedTableConfig.d.ts";
 export type * from "../../src/ts/ts-rs/WorkspaceConfigUpdate.d.ts";
 export type * from "../../src/ts/ts-rs/ExportMethod.d.ts";
 export type * from "../../src/ts/ts-rs/PanelOptions.d.ts";
@@ -388,6 +418,17 @@ export class Client {
 export class GenericSQLVirtualServerModel {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Returns the SQL query that plans ONE expression against a table - for
+     * attributing a failed `expressionsDescribe` to the expressions at fault.
+     */
+    expressionDescribe(table_id: string, expression: string): string;
+    /**
+     * Returns the SQL query that plans every expression of `config` at once
+     * against a table, one result column per expression alias, or `undefined`
+     * when the config has no expressions.
+     */
+    expressionsDescribe(table_id: string, config: any): string;
     /**
      * Returns the SQL query to list all hosted tables.
      */
@@ -396,6 +437,13 @@ export class GenericSQLVirtualServerModel {
      * Creates a new `JsDuckDBSqlBuilder` instance.
      */
     constructor(args?: any | null);
+    /**
+     * Returns the SQL query that plans the view `config` would build and
+     * reports its result columns without materializing it (`split_by` folded
+     * into `group_by`, no `PIVOT`), or `undefined` when the config selects no
+     * columns.
+     */
+    tableDescribe(table_id: string, config: any, schema: any): string;
     /**
      * Returns the SQL query to create a view from a table with the given
      * configuration.
@@ -409,10 +457,6 @@ export class GenericSQLVirtualServerModel {
      * Returns the SQL query to get the row count of a table.
      */
     tableSize(table_id: string): string;
-    /**
-     * Returns the SQL query to validate an expression against a table.
-     */
-    tableValidateExpression(table_id: string, expression: string): string;
     /**
      * Returns the SQL query to get the column count of a view.
      */
@@ -429,6 +473,10 @@ export class GenericSQLVirtualServerModel {
      * Returns the SQL query to get the min and max values of a column.
      */
     viewGetMinMax(view_id: string, column_name: string, config: any): string;
+    /**
+     * Returns the SQL query to create a table from a view.
+     */
+    viewMakeTable(view_id: string, table_id: string, config: any, view_schema: any, schema: any): string;
     /**
      * Returns the SQL query to describe a view's schema.
      */
@@ -972,7 +1020,9 @@ export class PerspectiveViewerElement {
      * # Arguments
      *
      * - `reset_all` - If set, will clear expressions and column settings as
-     *   well.
+     *   well, and tear down the element's ENTIRE derived-table state: every
+     *   panel bound to a derived `Table` is released to its root table, and
+     *   every derivation (pending ones included) is deleted.
      * - `options` - An optional `{panel?: string}`; the panel to reset, or
      *   every panel when omitted.
      *
@@ -1064,11 +1114,9 @@ export class PerspectiveViewerElement {
      *   either "json", "string" or "arraybuffer" format.
      * - `options.panel` - The panel to target, or the active panel when
      *   omitted.
-     * - `options.suppress_errors` - when `true`, a failed restore only rejects
-     *   the returned `Promise` and rolls the view config back, leaving the
-     *   viewer's visible error state and any element-level state the call
-     *   already applied (theme, title, plugin, a successful `table` change)
-     *   untouched.
+     * - `options.suppress_errors` - 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.
      * - `options.wait_for_table` - when `true`, a `table` no loaded client
      *   hosts yet leaves the panel empty and pending until the table is
      *   created, instead of the default error.
@@ -1350,6 +1398,25 @@ export class Table {
      * ```
      */
     delete(options?: DeleteOptions | null): Promise<void>;
+    /**
+     * Validate a complete view config against this table and report the
+     * schema a [`View`] built from it would have, WITHOUT creating one.
+     *
+     * # JavaScript Examples
+     *
+     * ```javascript
+     * const verdict = await table.describe({
+     *     columns: ["Sales", "margin"],
+     *     group_by: ["Region"],
+     *     expressions: { margin: '"Profit" / "Sales"' },
+     * });
+     *
+     * if ("view_schema" in verdict) {
+     *     const view = await table.view(config);
+     * }
+     * ```
+     */
+    describe(config?: ViewConfigUpdate | null): Promise<any>;
     /**
      * Get a copy of the [`Client`] this [`Table`] came from.
      */
@@ -1527,13 +1594,22 @@ export class View {
      */
     collapse(row_index: number): Promise<number>;
     /**
-     * Returns an array of strings containing the column paths of the [`View`]
-     * without any of the source columns.
+     * Returns this [`View`]'s column header area for `window`, transposed as
+     * `area[level][column]`.
      *
      * A column path shows the columns that a given cell belongs to after
-     * pivots are applied.
+     * pivots are applied. The area is rectangular with one level per
+     * `split_by` plus one: a column's split values occupy the leading levels
+     * and its name always occupies the last, so a subtotal or grand total
+     * under `split_rollup_mode: "rollup"` reads `null` at the levels it does
+     * not pivot on. Values keep their column's type - a `datetime` split value
+     * is epoch milliseconds, not text - so formatting them is the caller's
+     * choice.
+     *
+     * `window` slices the *column* axis; the number of levels does not depend
+     * on it.
      */
-    column_paths(window?: ColumnWindow | null): Promise<any>;
+    column_paths(window?: ColumnWindow | null): Promise<(string | number | boolean | null)[][]>;
     /**
      * Delete this [`View`] and clean up all resources associated with it.
      * [`View`] objects do not stop consuming resources or processing
@@ -1691,6 +1767,17 @@ export class View {
     set_depth(depth: number): Promise<void>;
     /**
      * Serializes a [`View`] to the Apache Arrow data format.
+     *
+     * # Arguments
+     *
+     * - `window` - a [`ViewWindow`]; its `compression` key selects Arrow IPC
+     *   body compression, `"lz4"` or `"zstd"` (uncompressed when omitted).
+     *
+     * # JavaScript Examples
+     *
+     * ```javascript
+     * const arrow = await view.to_arrow({ compression: "zstd" });
+     * ```
      */
     to_arrow(window?: ViewWindow | null): Promise<ArrayBuffer>;
     /**
@@ -1868,16 +1955,19 @@ export interface InitOutput {
     readonly client_system_info: (a: number) => number;
     readonly client_table: (a: number, b: number, c: number) => number;
     readonly client_terminate: (a: number, b: number) => void;
+    readonly genericsqlvirtualservermodel_expressionDescribe: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+    readonly genericsqlvirtualservermodel_expressionsDescribe: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly genericsqlvirtualservermodel_getHostedTables: (a: number, b: number) => void;
     readonly genericsqlvirtualservermodel_new: (a: number, b: number) => void;
+    readonly genericsqlvirtualservermodel_tableDescribe: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly genericsqlvirtualservermodel_tableMakeView: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly genericsqlvirtualservermodel_tableSchema: (a: number, b: number, c: number, d: number) => void;
     readonly genericsqlvirtualservermodel_tableSize: (a: number, b: number, c: number, d: number) => void;
-    readonly genericsqlvirtualservermodel_tableValidateExpression: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly genericsqlvirtualservermodel_viewColumnSize: (a: number, b: number, c: number, d: number) => void;
     readonly genericsqlvirtualservermodel_viewDelete: (a: number, b: number, c: number, d: number) => void;
     readonly genericsqlvirtualservermodel_viewGetData: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly genericsqlvirtualservermodel_viewGetMinMax: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly genericsqlvirtualservermodel_viewMakeTable: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
     readonly genericsqlvirtualservermodel_viewSchema: (a: number, b: number, c: number, d: number) => void;
     readonly genericsqlvirtualservermodel_viewSize: (a: number, b: number, c: number, d: number) => void;
     readonly proxysession_close: (a: number) => number;
@@ -1887,6 +1977,7 @@ export interface InitOutput {
     readonly table_clear: (a: number) => number;
     readonly table_columns: (a: number) => number;
     readonly table_delete: (a: number, b: number) => number;
+    readonly table_describe: (a: number, b: number) => number;
     readonly table_get_client: (a: number) => number;
     readonly table_get_index: (a: number) => number;
     readonly table_get_limit: (a: number) => number;
@@ -1939,22 +2030,22 @@ export interface InitOutput {
     readonly virtualdataslice_setStringCol: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly virtualserver_handleRequest: (a: number, b: number, c: number) => number;
     readonly virtualserver_new: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_18885: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_4479: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_19596: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_20506: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_25319: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_33477: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_19005: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7877: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7878: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7879: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_7875: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_19601: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_25336: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_21545: (a: number, b: number) => number;
-    readonly __wasm_bindgen_func_elem_19600: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_21546: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_7435: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_20133: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_20746: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_22147: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_26709: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_35042: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_8469: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_8470: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_8471: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_8467: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_20156: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_20750: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_26711: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_22772: (a: number, b: number) => number;
+    readonly __wasm_bindgen_func_elem_20749: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_22773: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;