@perspective-dev/viewer 4.5.2 → 5.0.0

package/src/svg/active-indicator.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="12" viewBox="0 -0.5 18 18" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <path d="M15.1593 1.64958L10.3424 7.71878V7.81838L18 6.84731V10.1465L10.3424 9.27499V9.37459L15.2113 15.201L12.0195 16.9502L8.97725 10.1527H8.87974L5.58397 17L2.69772 15.2508L7.50813 9.33101V9.23142L0 10.1402L0 6.84108L7.44962 7.76858V7.66899L2.68472 1.74918L5.77898 0.0497986L8.91874 6.79751H9.02275L12.117 0L15.1593 1.64958Z" fill="#042121"/>
+</svg>

package/src/themes/botanical.css

@@ -14,11 +14,13 @@
 
 /* Register theme for auto-detection */
 perspective-viewer,
-perspective-viewer[theme="Botanical"] {
+perspective-viewer[theme="Botanical"],
+perspective-viewer [theme="Botanical"] {
     --psp-theme-name: "Botanical";
 }
 
-perspective-viewer[theme="Botanical"] {
+perspective-viewer[theme="Botanical"],
+perspective-viewer [theme="Botanical"] {
     /* perspective-viewer-botanical--colors */
     background-color: #1a2e1a;
     color: #e0ead8;
@@ -90,6 +92,7 @@ perspective-viewer[theme="Botanical"] {
     --psp-charts--map-tiles--attribution-: "I <3 Open Source";
 }
 
+perspective-context-menu[theme="Botanical"],
 perspective-copy-menu[theme="Botanical"],
 perspective-export-menu[theme="Botanical"],
 perspective-dropdown[theme="Botanical"],

package/src/themes/defaults.css

@@ -14,7 +14,21 @@
 @import "./intl.css";
 
 perspective-viewer,
-perspective-workspace,
+/* Per-panel light-DOM descendants (the plugin + `<PanelTab>`, both carrying a
+   `theme` attribute) get the complete base too — so each panel resolves real
+   `color`/`font-family` and every `--psp-*` from its OWN theme instead of
+   inheriting the active panel's. Theme overrides refine this via the matching
+   `perspective-viewer [theme="X"]` rule.
+
+   `:where()` gives this clause ZERO specificity, so the panel's own
+   `[theme="X"]` override (specificity 0,1,1) ALWAYS wins over this default base.
+   Without it the two would tie at (0,1,1) and import order would decide — and
+   because every theme file `@import`s `defaults.css`, the base is inlined after
+   later overrides and the default would leak over the panel's theme. A
+   zero-specificity rule still beats inheritance, so the base values apply where
+   the override is silent. */
+:where(perspective-viewer [theme]),
+perspective-context-menu,
 perspective-copy-menu,
 perspective-export-menu,
 perspective-dropdown,
@@ -26,7 +40,6 @@ perspective-string-column-style {
     --psp--color: #161616;
 
     color: var(--psp--color);
-    background-color: transparent;
 
     --psp-inactive--color: #ababab;
     --psp-inactive--border-color: #dadada;
@@ -127,9 +140,48 @@ perspective-string-column-style {
         #42b3d5 67.5%,
         #1a237e 100%
     );
+
+    /* Completeness anchors for per-panel theming. These are color/appearance
+       vars that some themes (e.g. Pro Dark) set but the light default does not
+       — so without a base value an unthemed/light panel would *inherit* them
+       from a differently-themed (active) panel, mixing themes. `initial` makes
+       the custom property the guaranteed-invalid value: consumers fall back to
+       their own default (identical to the current unthemed rendering) AND the
+       element no longer inherits a neighboring panel's value. A theme that
+       wants a real value overrides it in its `[theme="X"]` block as usual. */
+    --psp-active--background: initial;
+    --psp-calendar--filter: initial;
+    --psp-charts--legend--color: initial;
+    --psp-charts--tooltip--background: initial;
+    --psp-charts--treemap--hover-highlight: initial;
+    --psp-charts--treemap--labels: initial;
+    --psp-code-editor--column--color: initial;
+    --psp-code-editor--comment--color: initial;
+    --psp-code-editor--literal--color: initial;
+    --psp-code-editor--operator--color: initial;
+    --psp-code-editor--symbol--color: initial;
+    --psp-expression--error--color: initial;
+    --psp-expression--function--color: initial;
+    --psp-expression--operator--color: initial;
+    --psp-input--filter: initial;
+    --psp-openlayers--attribution--filter: initial;
+    --psp-charts--series-11--color: initial;
+    --psp-charts--series-12--color: initial;
+    --psp-charts--map-tiles--url: initial;
+    --psp-column-type--boolean--color: initial;
+    --psp-column-type--date--color: initial;
+    --psp-column-type--float--color: initial;
+    --psp-column-type--string--color: initial;
+    --psp-datagrid--border-color: initial;
+    --psp-datagrid--hover--border-color: initial;
+    --psp-expression--psp-error--color: initial;
+    --psp-status-icon--connected--color: initial;
+    --psp-status-icon--initializing--color: initial;
+    --psp-status-icon--psp-error--color: initial;
 }
 
 /* Modal defaults */
+perspective-context-menu,
 perspective-copy-menu,
 perspective-export-menu,
 perspective-dropdown,

package/src/themes/dracula.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Dracula"] {
+perspective-viewer[theme="Dracula"],
+perspective-viewer [theme="Dracula"] {
     --psp-theme-name: "Dracula";
 }
 
-perspective-viewer[theme="Dracula"] {
+perspective-viewer[theme="Dracula"],
+perspective-viewer [theme="Dracula"] {
     /* perspective-viewer-pro-dark--colors (overrides) */
     background-color: #242526;
     color: white;
@@ -122,7 +124,7 @@ perspective-viewer[theme="Dracula"] {
     --theme-pink: #ff79c6;
 
     color: var(--theme-fg0);
-    background-color: var(--theme-bg0);
+    background-color: var(--theme-bg1);
     --psp--color: var(--theme-fg1);
     --psp-inactive--color: var(--theme-fg2);
     --psp-inactive--border-color: var(--theme-bg2);
@@ -154,6 +156,7 @@ perspective-viewer[theme="Dracula"] {
     ) !important;
 }
 
+perspective-context-menu[theme="Dracula"],
 perspective-copy-menu[theme="Dracula"],
 perspective-export-menu[theme="Dracula"],
 perspective-dropdown[theme="Dracula"] {

package/src/themes/gruvbox-dark.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Gruvbox Dark"] {
+perspective-viewer[theme="Gruvbox Dark"],
+perspective-viewer [theme="Gruvbox Dark"] {
     --psp-theme-name: "Gruvbox Dark";
 }
 
-perspective-viewer[theme="Gruvbox Dark"] {
+perspective-viewer[theme="Gruvbox Dark"],
+perspective-viewer [theme="Gruvbox Dark"] {
     /* perspective-viewer-pro-dark--colors (overrides) */
     background-color: #242526;
     color: white;
@@ -167,6 +169,7 @@ perspective-viewer[theme="Gruvbox Dark"] {
     ) !important;
 }
 
+perspective-context-menu[theme="Gruvbox Dark"],
 perspective-copy-menu[theme="Gruvbox Dark"],
 perspective-export-menu[theme="Gruvbox Dark"],
 perspective-dropdown[theme="Gruvbox Dark"] {

package/src/themes/gruvbox.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Gruvbox Light"] {
+perspective-viewer[theme="Gruvbox Light"],
+perspective-viewer [theme="Gruvbox Light"] {
     --psp-theme-name: "Gruvbox Light";
 }
 
-perspective-viewer[theme="Gruvbox Light"] {
+perspective-viewer[theme="Gruvbox Light"],
+perspective-viewer [theme="Gruvbox Light"] {
     /* perspective-viewer-gruvbox-light--colors */
     --theme-fg0: #282828;
     --theme-fg1: #3c3836;
@@ -83,6 +85,7 @@ perspective-viewer[theme="Gruvbox Light"] {
     ) !important;
 }
 
+perspective-context-menu[theme="Gruvbox Light"],
 perspective-copy-menu[theme="Gruvbox Light"],
 perspective-export-menu[theme="Gruvbox Light"],
 perspective-dropdown[theme="Gruvbox Light"] {

package/src/themes/icons.css

@@ -11,14 +11,15 @@
  * ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ */
 
 perspective-viewer,
-perspective-workspace,
+perspective-context-menu,
 perspective-copy-menu,
 perspective-export-menu,
 perspective-dropdown,
 perspective-date-column-style,
 perspective-datetime-column-style,
 perspective-number-column-style,
-perspective-string-column-style {
+perspective-string-column-style,
+perspective-viewer-tab {
     /* Icons */
     --psp-column-type--integer--mask-image: url("../svg/number-type.svg");
     --psp-column-type--float--mask-image: var(
@@ -55,6 +56,7 @@ perspective-string-column-style {
     --psp-label--active-column-selector--content: url("../svg/checkbox-checked-icon.svg");
     --psp-icon--select-arrow-light--mask-image: url("../svg/dropdown-selector-light.svg");
     --psp-icon--select-arrow-dark--mask-image: url("../svg/dropdown-selector.svg");
+    --psp-icon--active-indicator--mask-image: url("../svg/active-indicator.svg");
     --psp-icon-overflow-hint--content: "!";
     --psp-label--reset-button-icon--content: "refresh";
     --psp-label--save-button-icon--content: "save";

package/src/themes/monokai.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Monokai"] {
+perspective-viewer[theme="Monokai"],
+perspective-viewer [theme="Monokai"] {
     --psp-theme-name: "Monokai";
 }
 
-perspective-viewer[theme="Monokai"] {
+perspective-viewer[theme="Monokai"],
+perspective-viewer [theme="Monokai"] {
     /* perspective-viewer-pro-dark--colors (overrides) */
     background-color: #242526;
     color: white;
@@ -163,6 +165,7 @@ perspective-viewer[theme="Monokai"] {
     );
 }
 
+perspective-context-menu[theme="Monokai"],
 perspective-copy-menu[theme="Monokai"],
 perspective-export-menu[theme="Monokai"],
 perspective-dropdown[theme="Monokai"],

package/src/themes/phosphor.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Phosphor"] {
+perspective-viewer[theme="Phosphor"],
+perspective-viewer [theme="Phosphor"] {
     --psp-theme-name: "Phosphor";
 }
 
-perspective-viewer[theme="Phosphor"] {
+perspective-viewer[theme="Phosphor"],
+perspective-viewer [theme="Phosphor"] {
     /* perspective-viewer-phosphor--colors */
     --theme-bg0: #0a0a0a;
     --theme-bg1: #0d0d0d;
@@ -124,6 +126,7 @@ perspective-viewer[theme="Phosphor"] {
     );
 }
 
+perspective-context-menu[theme="Phosphor"],
 perspective-copy-menu[theme="Phosphor"],
 perspective-export-menu[theme="Phosphor"],
 perspective-dropdown[theme="Phosphor"],

package/src/themes/pro-dark.css

@@ -14,11 +14,13 @@
 
 /* Register theme for auto-detection */
 perspective-viewer,
-perspective-viewer[theme="Pro Dark"] {
+perspective-viewer[theme="Pro Dark"],
+perspective-viewer [theme="Pro Dark"] {
     --psp-theme-name: "Pro Dark";
 }
 
-perspective-viewer[theme="Pro Dark"] {
+perspective-viewer[theme="Pro Dark"],
+perspective-viewer [theme="Pro Dark"] {
     /* perspective-viewer-pro-dark--colors (overrides) */
     background-color: #242526;
     color: white;
@@ -107,6 +109,7 @@ perspective-viewer[theme="Pro Dark"] {
     );
 }
 
+perspective-context-menu[theme="Pro Dark"],
 perspective-copy-menu[theme="Pro Dark"],
 perspective-export-menu[theme="Pro Dark"],
 perspective-dropdown[theme="Pro Dark"],

package/src/themes/pro.css

@@ -13,6 +13,7 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Pro Light"] {
+perspective-viewer[theme="Pro Light"],
+perspective-viewer [theme="Pro Light"] {
     --psp-theme-name: "Pro Light";
 }

package/src/themes/solarized-dark.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Solarized Dark"] {
+perspective-viewer[theme="Solarized Dark"],
+perspective-viewer [theme="Solarized Dark"] {
     --psp-theme-name: "Solarized Dark";
 }
 
-perspective-viewer[theme="Solarized Dark"] {
+perspective-viewer[theme="Solarized Dark"],
+perspective-viewer [theme="Solarized Dark"] {
     /* perspective-viewer-solarized--colors */
     color: #586e75;
     background-color: #eee8d5;
@@ -82,6 +84,7 @@ perspective-viewer[theme="Solarized Dark"] {
     );
 }
 
+perspective-context-menu[theme="Solarized Dark"],
 perspective-copy-menu[theme="Solarized Dark"],
 perspective-export-menu[theme="Solarized Dark"],
 perspective-dropdown[theme="Solarized Dark"],

package/src/themes/solarized.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Solarized"] {
+perspective-viewer[theme="Solarized"],
+perspective-viewer [theme="Solarized"] {
     --psp-theme-name: "Solarized";
 }
 
-perspective-viewer[theme="Solarized"] {
+perspective-viewer[theme="Solarized"],
+perspective-viewer [theme="Solarized"] {
     /* perspective-viewer-solarized--colors */
     color: #586e75;
     background-color: #eee8d5;
@@ -61,6 +63,7 @@ x {
     color: #cb4b16;
 }
 
+perspective-context-menu[theme="Solarized"],
 perspective-copy-menu[theme="Solarized"],
 perspective-export-menu[theme="Solarized"],
 perspective-dropdown[theme="Solarized"],

package/src/themes/vaporwave.css

@@ -13,11 +13,13 @@
 @import "./defaults.css";
 
 perspective-viewer,
-perspective-viewer[theme="Vaporwave"] {
+perspective-viewer[theme="Vaporwave"],
+perspective-viewer [theme="Vaporwave"] {
     --psp-theme-name: "Vaporwave";
 }
 
-perspective-viewer[theme="Vaporwave"] {
+perspective-viewer[theme="Vaporwave"],
+perspective-viewer [theme="Vaporwave"] {
     /* perspective-viewer-pro-dark--colors (overrides) */
     background-color: #242526;
     color: white;
@@ -175,6 +177,7 @@ perspective-viewer[theme="Vaporwave"] {
     ) !important;
 }
 
+perspective-context-menu[theme="Vaporwave"],
 perspective-copy-menu[theme="Vaporwave"],
 perspective-export-menu[theme="Vaporwave"],
 perspective-dropdown[theme="Vaporwave"],

package/src/ts/bootstrap.ts

@@ -26,12 +26,13 @@ export async function init_client(
 ) {
     // @ts-ignore
     const url = await worker_url.getWorkerURL();
-    if (wasm_module === undefined) {
-        wasm_module = (await import(url)) as typeof wasm_module_type;
-    }
+    const [wasm_module2, module_or_path] = await Promise.all([
+        wasm_module === undefined ? import(url) : wasm_module,
+        load_wasm_stage_0(wasm_binary).then((unzipped) =>
+            WebAssembly.compile(unzipped as BufferSource),
+        ),
+    ]);
 
-    const unzipped = await load_wasm_stage_0(wasm_binary);
-    const module_or_path = await WebAssembly.compile(unzipped as BufferSource);
-    await wasm_module.default({ module_or_path });
-    await wasm_module.init(module_or_path, url);
+    await wasm_module2.default({ module_or_path });
+    await wasm_module2.init(module_or_path, url);
 }

package/src/ts/extensions.ts

@@ -26,18 +26,21 @@ export class PerspectiveSelectDetail {
     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[] {
@@ -72,12 +75,27 @@ export type PerspectiveClickEventDetail = {
     config: ViewerConfigUpdate;
     row: Record<string, any>;
     column_names: Array<string | Array<string>>;
+    panel?: string;
 };
 
 export type PerspectiveSelectEventDetail = {
     view_window: ViewWindow;
 };
 
+export type PerspectiveConfigUpdateEventDetail = {
+    /**
+     * Serialize the panel config that triggered this event, ON DEMAND. The
+     * serialization is deferred so a config change with no interested listener
+     * costs nothing; call `getConfig()` only if you need the config.
+     *
+     * Valid ONLY synchronously within the event callback — the backing closure
+     * is released immediately after dispatch, so stashing `getConfig` and
+     * calling it later throws. To read config outside the callback, use
+     * `viewer.save()` / `viewer.saveWorkspace()`.
+     */
+    getConfig(): ViewerConfigUpdate;
+};
+
 // JSX / React extensions
 
 type ReactPerspectiveViewerAttributes<T> = React.HTMLAttributes<T>;
@@ -196,7 +214,13 @@ export interface PerspectiveViewerElementExt {
 
     addEventListener(
         name: "perspective-global-filter",
-        cb: (e: CustomEvent<PerspectiveSelectEventDetail>) => void,
+        cb: (e: CustomEvent<PerspectiveSelectDetail>) => void,
+        options?: { signal: AbortSignal },
+    ): void;
+
+    addEventListener(
+        name: "perspective-global-filter-update",
+        cb: (e: CustomEvent<Filter[]>) => void,
         options?: { signal: AbortSignal },
     ): void;
 
@@ -214,7 +238,7 @@ export interface PerspectiveViewerElementExt {
 
     addEventListener(
         name: "perspective-config-update",
-        cb: (e: CustomEvent) => void,
+        cb: (e: CustomEvent<PerspectiveConfigUpdateEventDetail>) => void,
         options?: { signal: AbortSignal },
     ): void;
 
@@ -239,6 +263,10 @@ export interface PerspectiveViewerElementExt {
     removeEventListener(name: "perspective-click", cb: any): void;
     removeEventListener(name: "perspective-select", cb: any): void;
     removeEventListener(name: "perspective-global-filter", cb: any): void;
+    removeEventListener(
+        name: "perspective-global-filter-update",
+        cb: any,
+    ): void;
     removeEventListener(name: "perspective-toggle-settings", cb: any): void;
     removeEventListener(
         name: "perspective-toggle-settings-before",

package/src/ts/perspective-viewer.ts

@@ -31,6 +31,8 @@
  * @module perspective-viewer
  */
 
+import "regular-layout";
+
 export { IPerspectiveViewerPlugin } from "./plugin";
 export { HTMLPerspectiveViewerPluginElement } from "./plugin";
 
@@ -46,10 +48,18 @@ export type * from "./extensions.ts";
 export { PerspectiveSelectDetail } from "./extensions.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";
+export type * from "./ts-rs/WorkspaceConfig.d.ts";
 export type * from "./ts-rs/Filter.d.ts";
 export type * from "./ts-rs/FilterTerm.d.ts";
 export type * from "./ts-rs/FilterReducer.d.ts";
 export type * from "./ts-rs/PluginStaticConfig.ts";
+export type * from "./ts-rs/ExportMethod.d.ts";
+export type * from "./ts-rs/PanelOptions.d.ts";
+export type * from "./ts-rs/ClientOptions.d.ts";
+export type * from "./ts-rs/ExportOptions.d.ts";
+export type * from "./ts-rs/GetTableOptions.d.ts";
+export type * from "./ts-rs/GetClientOptions.d.ts";
 
 export { init_client } from "./bootstrap";
 import { init_client } from "./bootstrap";

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, };