@perspective-dev/viewer 5.2.0 → 5.3.0

package/dist/esm/plugin.d.ts

@@ -78,6 +78,16 @@ export interface IPerspectiveViewerPlugin {
      * config.
      */
     column_style_config?: (view_type: string, group: string) => any;
+    /**
+     * 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`.
+     */
+    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>): {
+        fields: Array<Record<string, unknown> & {
+            kind: string;
+        }>;
+    };
     /**
      * Render this plugin using the provided `View`.  While there is no
      * provision to cancel a render in progress per se, calling a method on

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

@@ -10,7 +10,7 @@ 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.
+ * workspace config format.
  */
 export type PanelViewerConfig<V = string> = {
     /**

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

@@ -0,0 +1,10 @@
+/**
+ * Options for the `saveWorkspace()` method.
+ */
+export type SaveWorkspaceOptions = {
+    /**
+     * When `true`, the emitted `palette` is the full set the element
+     * holds rather than only the values the panels reference.
+     */
+    full_palette?: boolean;
+};

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

@@ -10,7 +10,7 @@ import type { JsonValue } from "./serde_json/JsonValue.js";
 /**
  * The state of an entire `custom_elements::PerspectiveViewerElement` component
  * and its `Plugin`: the element-level `settings` flag plus the per-panel
- * [`PanelViewerConfig`]. The split exists so the whole-element config format
+ * [`PanelViewerConfig`]. The split exists so the workspace 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.

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

@@ -2,7 +2,7 @@ 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 workspace config format (`{version, active?, layout, panels}`) —
  * the multi-panel counterpart of the single-panel [`ViewerConfig`] — as
  * emitted by [`PerspectiveViewerElement::save`].
  *
@@ -37,4 +37,12 @@ export type WorkspaceConfig = {
      * `global_filters` are one unattributed bucket. Omitted when empty.
      */
     masters?: Array<string>;
+    /**
+     * Named color-scale definitions shared by every panel: CSS custom
+     * property name (`--psp-user--<kind>-<name>`) → canonical CSS
+     * value.
+     */
+    palette?: {
+        [key in string]?: string;
+    };
 };

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

@@ -2,7 +2,7 @@ import type { Filter } from "./Filter.js";
 import type { Layout } from "./Layout.js";
 import type { ViewerConfigInitial } from "./ViewerConfigInitial.js";
 /**
- * The parse target of a whole-element config in
+ * The parse target of a workspace config in
  * [`PerspectiveViewerElement::restoreWorkspace`]. Mirrors
  * [`WorkspaceConfig`], but `panels` entries are [`ViewerConfigInitial`]s —
  * every entry creates a NEW panel, so `table` is required by type (a
@@ -19,11 +19,21 @@ export type WorkspaceConfigUpdate = {
      * 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.
+     * `Option` so an explicit `undefined` property deserializes as
+     * `None` like an absent key (also `masters` / `palette` below).
      */
-    global_filters?: Array<Filter>;
+    global_filters?: Array<Filter> | null;
     /**
      * The master (filter-source) panels, by saved `panels` key. An id not in
      * `panels` warns and is dropped.
      */
-    masters?: Array<string>;
+    masters?: Array<string> | null;
+    /**
+     * Named color-scale definitions to apply to the host (see
+     * [`WorkspaceConfig::palette`]), replacing any previously restored
+     * palette.
+     */
+    palette?: {
+        [key in string]?: string;
+    } | null;
 };

package/dist/wasm/perspective-viewer.d.ts

@@ -111,6 +111,7 @@ 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";
 export type * from "../../src/ts/ts-rs/RestoreOptions.d.ts";
+export type * from "../../src/ts/ts-rs/SaveWorkspaceOptions.d.ts";
 export type * from "../../src/ts/ts-rs/ClientOptions.d.ts";
 export type * from "../../src/ts/ts-rs/ExportOptions.d.ts";
 export type * from "../../src/ts/ts-rs/GetTableOptions.d.ts";
@@ -125,6 +126,7 @@ export type * from "../../src/ts/ts-rs/FormatMode.d.ts";
 import type {GetTableOptions} from "../../src/ts/ts-rs/GetTableOptions.d.ts";
 import type {PanelOptions} from "../../src/ts/ts-rs/PanelOptions.d.ts";
 import type {RestoreOptions} from "../../src/ts/ts-rs/RestoreOptions.d.ts";
+import type {SaveWorkspaceOptions} from "../../src/ts/ts-rs/SaveWorkspaceOptions.d.ts";
 import type {ExportOptions} from "../../src/ts/ts-rs/ExportOptions.d.ts";
 import type {GetClientOptions} from "../../src/ts/ts-rs/GetClientOptions.d.ts";
 import type {ClientOptions} from "../../src/ts/ts-rs/ClientOptions.d.ts";
@@ -411,7 +413,7 @@ export class GenericSQLVirtualServerModel {
      * Returns the SQL query to create a view from a table with the given
      * configuration.
      */
-    tableMakeView(table_id: string, view_id: string, config: any): string;
+    tableMakeView(table_id: string, view_id: string, config: any, schema: any): string;
     /**
      * Returns the SQL query to describe a table's schema.
      */
@@ -836,6 +838,7 @@ export class PerspectiveViewerElement {
      * ```
      */
     getTable(options?: GetTableOptions | null): Promise<any>;
+    getThemes(): Promise<any>;
     /**
      * Get the underlying [`View`] for this viewer.
      *
@@ -957,9 +960,10 @@ export class PerspectiveViewerElement {
      * Reset a panel's `ViewerConfig` to its data-relative default.
      *
      * Without a `panel`, this is ELEMENT-LEVEL: EVERY panel is reset and the
-     * cross-filter overlay cleared (symmetric with whole-element
-     * [`Self::save`] / [`Self::restore`]). With `{panel}`, only that panel is
-     * reset — the other panels and the overlay are left untouched.
+     * cross-filter overlay cleared (symmetric with
+     * [`Self::saveWorkspace`] / [`Self::restoreWorkspace`]). With `{panel}`,
+     * only that panel is reset — the other panels and the overlay are left
+     * untouched.
      *
      * # Arguments
      *
@@ -1030,18 +1034,18 @@ export class PerspectiveViewerElement {
      * optional `{panel}` selector.
      *
      * If `panel` names no existing panel, a NEW panel is created with that id
-     * and the config restored into it (an upsert). As with a created panel,
-     * the element-level `settings`/`theme` fields are ignored in that case.
-     * Unlike [`Self::addPanel`], the argument is a PATCH, so a `table` is
-     * optional: creating without one yields a DEFERRED panel that the next
-     * [`Self::load`] binds. Such a panel renders but cannot be serialized —
-     * [`Self::save`] rejects with "Panel has no `table`" until it is bound.
+     * and the config restored into it (an upsert). Creation REQUIRES a
+     * `table` — the same rule [`Self::addPanel`] enforces in its argument
+     * type — and a would-create call without one REJECTS before any state
+     * (including `settings`) is applied: with no panel to target and no
+     * `table`, the patch has no data arrival path. In particular, on an
+     * element with zero panels every `restore` must carry a `table`.
      *
      * On an empty element with a pending [`Self::load`] whose payload is not
      * yet classified, the active-target form (no `panel`) instead claims and
      * restores into that load's reserved first panel — see [`Self::load`].
      *
-     * This restores a SINGLE panel; a whole-element config (with a `panels`
+     * This restores a SINGLE panel; a workspace config (with a `panels`
      * map) must be applied via [`Self::restoreWorkspace`] — its `panels` /
      * `layout` keys are ignored here.
      *
@@ -1082,8 +1086,8 @@ export class PerspectiveViewerElement {
      */
     restore(update: ViewerConfigUpdate, options?: RestoreOptions | null): Promise<void>;
     /**
-     * Restore the ENTIRE element from a whole-element
-     * [`WorkspaceConfigUpdate`] (`{version, active?, layout, panels, ...}`) —
+     * Restore the ENTIRE element from a [`WorkspaceConfigUpdate`]
+     * (`{version, active?, layout, panels, ...}`) —
      * the multi-panel counterpart of [`Self::restore`]. Every existing panel
      * is replaced by the `panels` entries, and the layout tree + master/detail
      * cross-filter state re-applied. Unlike [`Self::restore`], this never
@@ -1147,11 +1151,12 @@ export class PerspectiveViewerElement {
      */
     save(options?: PanelOptions | null): Promise<ViewerConfig>;
     /**
-     * Save the ENTIRE element to a whole-element [`WorkspaceConfig`]
-     * (`{version, active?, layout, panels, ...}`) — the multi-panel
-     * counterpart of [`Self::save`]. Unlike [`Self::save`] (which emits a
-     * single `ViewerConfig` for one panel), this ALWAYS emits the
-     * whole-element format, restorable via [`Self::restoreWorkspace`].
+     * Save the ENTIRE element to a [`WorkspaceConfig`]
+     * (`{version, active?, layout, panels, palette?, ...}`) — the
+     * multi-panel counterpart of [`Self::save`]. Unlike [`Self::save`]
+     * (which emits a single `ViewerConfig` for one panel), this ALWAYS
+     * emits the workspace format, restorable via
+     * [`Self::restoreWorkspace`].
      *
      * # JavaScript Examples
      *
@@ -1160,7 +1165,7 @@ export class PerspectiveViewerElement {
      * await viewer.restoreWorkspace(token);
      * ```
      */
-    saveWorkspace(): Promise<WorkspaceConfig>;
+    saveWorkspace(options?: SaveWorkspaceOptions | null): Promise<WorkspaceConfig>;
     /**
      * Make the panel with id `name` the active panel, re-targeting the
      * settings panel and status-bar toolbar (and the root's
@@ -1780,6 +1785,7 @@ export interface InitOutput {
     readonly perspectiveviewerelement_getRenderStats: (a: number, b: number, c: number) => void;
     readonly perspectiveviewerelement_getSelection: (a: number, b: number, c: number) => void;
     readonly perspectiveviewerelement_getTable: (a: number, b: number) => number;
+    readonly perspectiveviewerelement_getThemes: (a: number) => number;
     readonly perspectiveviewerelement_getView: (a: number, b: number) => number;
     readonly perspectiveviewerelement_getViewConfig: (a: number, b: number) => number;
     readonly perspectiveviewerelement_load: (a: number, b: number, c: number) => void;
@@ -1793,7 +1799,7 @@ export interface InitOutput {
     readonly perspectiveviewerelement_restoreWorkspace: (a: number, b: number) => number;
     readonly perspectiveviewerelement_restyleElement: (a: number) => number;
     readonly perspectiveviewerelement_save: (a: number, b: number) => number;
-    readonly perspectiveviewerelement_saveWorkspace: (a: number) => number;
+    readonly perspectiveviewerelement_saveWorkspace: (a: number, b: number) => number;
     readonly perspectiveviewerelement_setActivePanel: (a: number, b: number, c: number) => number;
     readonly perspectiveviewerelement_setAutoPause: (a: number, b: number) => number;
     readonly perspectiveviewerelement_setAutoSize: (a: number, b: number) => void;
@@ -1833,7 +1839,7 @@ export interface InitOutput {
     readonly client_terminate: (a: number, b: number) => void;
     readonly genericsqlvirtualservermodel_getHostedTables: (a: number, b: number) => void;
     readonly genericsqlvirtualservermodel_new: (a: number, b: number) => void;
-    readonly genericsqlvirtualservermodel_tableMakeView: (a: number, b: number, c: number, d: number, e: number, f: number, g: 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;
@@ -1900,21 +1906,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_17003: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_17713: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_18571: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_3989: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_23208: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_31328: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_17122: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_17718: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_6981: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_6982: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_6983: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_6979: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_23225: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_19569: (a: number, b: number) => number;
-    readonly __wasm_bindgen_func_elem_17717: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_17916: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_18625: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_19491: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_4310: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_24164: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_32290: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_18035: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_18630: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7520: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7521: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7522: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_7518: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_24181: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_20501: (a: number, b: number) => number;
+    readonly __wasm_bindgen_func_elem_18629: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_20502: (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;