@perspective-dev/viewer 4.4.1 → 4.5.0

package/src/themes/vaporwave.css

@@ -53,41 +53,33 @@ perspective-viewer[theme="Vaporwave"] {
     --psp-datagrid--pos-cell--color: #7dc3f0;
     --psp-datagrid--neg-cell--color: #ff9485;
 
-    /* perspective-viewer-pro-dark--d3fc (overrides) */
-    --psp-d3fc--legend--color: #c5c9d0;
-    --psp-d3fc--treemap--labels: white;
-    --psp-d3fc--treemap--hover-highlight: white;
-    --psp-d3fc--tooltip--color: white;
-    --psp-d3fc--axis-ticks--color: #c5c9d0;
-    --psp-d3fc--axis-lines--color: #61656e;
-    --psp-d3fc--gridline--color: #3b3f46;
-    --psp-d3fc--tooltip--background: rgba(42, 44, 47, 1);
-    --psp-d3fc--tooltip--border-color: #242526;
-    --psp-d3fc--legend--background: var(--psp--background-color);
-    --psp-d3fc--series--color: rgb(71, 120, 194);
-    --psp-d3fc--series-1--color: rgb(71, 120, 194);
-    --psp-d3fc--series-2--color: rgb(204, 120, 48);
-    --psp-d3fc--series-3--color: rgb(158, 84, 192);
-    --psp-d3fc--series-4--color: rgb(51, 150, 153);
-    --psp-d3fc--series-5--color: rgb(102, 114, 143);
-    --psp-d3fc--series-6--color: rgb(211, 103, 189);
-    --psp-d3fc--series-7--color: rgb(109, 124, 77);
-    --psp-d3fc--series-8--color: rgb(221, 99, 103);
-    --psp-d3fc--series-9--color: rgb(120, 104, 206);
-    --psp-d3fc--series-10--color: rgb(23, 166, 123);
-    --psp-d3fc--full-gradient--background: linear-gradient(
+    /* perspective-viewer-pro-dark--webgl (overrides) */
+    --psp-charts--legend--color: #c5c9d0;
+    --psp-charts--treemap--labels: white;
+    --psp-charts--treemap--hover-highlight: white;
+    --psp-charts--tooltip--color: white;
+    --psp-charts--axis-ticks--color: #c5c9d0;
+    --psp-charts--axis-lines--color: #61656e;
+    --psp-charts--gridline--color: #3b3f46;
+    --psp-charts--tooltip--background: rgba(42, 44, 47, 1);
+    --psp-charts--tooltip--border-color: #242526;
+    --psp-charts--legend--background: var(--psp--background-color);
+    --psp-charts--series--color: rgb(71, 120, 194);
+    --psp-charts--series-1--color: rgb(71, 120, 194);
+    --psp-charts--series-2--color: rgb(204, 120, 48);
+    --psp-charts--series-3--color: rgb(158, 84, 192);
+    --psp-charts--series-4--color: rgb(51, 150, 153);
+    --psp-charts--series-5--color: rgb(102, 114, 143);
+    --psp-charts--series-6--color: rgb(211, 103, 189);
+    --psp-charts--series-7--color: rgb(109, 124, 77);
+    --psp-charts--series-8--color: rgb(221, 99, 103);
+    --psp-charts--series-9--color: rgb(120, 104, 206);
+    --psp-charts--series-10--color: rgb(23, 166, 123);
+    --psp-charts--gradient--background: linear-gradient(
         #dd6367 0%,
         #242526 50%,
         #3289c8 100%
     );
-    --psp-d3fc--pos-gradient--background: linear-gradient(
-        #242526 0%,
-        #3289c8 100%
-    );
-    --psp-d3fc--neg-gradient--background: linear-gradient(
-        #dd6367 0%,
-        #242526 100%
-    );
 
     /* perspective-viewer-pro-dark--openlayers (overrides) */
     --psp-openlayers--tile-url: "http://{a-c}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png";
@@ -143,49 +135,23 @@ perspective-viewer[theme="Vaporwave"] {
         background-position: 0px -10px;
     }
 
-    /* perspective-viewer-vaporwave--d3fc */
-    --psp-d3fc--axis-ticks--color: #49acff;
-    --psp-d3fc--gridline--color: rgb(19, 33, 50);
-    --psp-d3fc--series--color: #01cdfe;
-    --psp-d3fc--series-1--color: #01cdfe;
-    --psp-d3fc--series-2--color: #ff71ce;
-    --psp-d3fc--series-3--color: #05ffa1;
-    --psp-d3fc--series-4--color: #b967ff;
-    --psp-d3fc--series-5--color: #fffb96;
-
-    --psp-d3fc--series-6--color: hsl(192, 99%, 25%);
-    --psp-d3fc--series-7--color: hsl(321, 100%, 36%);
-    --psp-d3fc--series-8--color: hsl(192, 99%, 25%);
-    --psp-d3fc--series-9--color: hsl(157, 100%, 25%);
-    --psp-d3fc--series-10--color: hsl(272, 100%, 35%);
-
-    --psp-d3fc--neg-gradient--background: linear-gradient(
-        #f3d431,
-        #efb92d,
-        #ed9c25,
-        #eb7e20,
-        #e75d1e,
-        #d14632,
-        #b03e38,
-        #8c3a36,
-        #643633,
-        #07081d
-    ) !important;
-
-    --psp-d3fc--pos-gradient--background: linear-gradient(
-        #07081d,
-        #2e4463,
-        #1e588a,
-        #086da7,
-        #0082b9,
-        #039ac7,
-        #12b1d4,
-        #2bc8e2,
-        #3ddff0,
-        #61f4fb
-    ) !important;
-
-    --psp-d3fc--full-gradient--background: linear-gradient(
+    /* perspective-viewer-vaporwave--webgl */
+    --psp-charts--axis-ticks--color: #49acff;
+    --psp-charts--gridline--color: rgb(19, 33, 50);
+    --psp-charts--series--color: #01cdfe;
+    --psp-charts--series-1--color: #01cdfe;
+    --psp-charts--series-2--color: #ff71ce;
+    --psp-charts--series-3--color: #05ffa1;
+    --psp-charts--series-4--color: #b967ff;
+    --psp-charts--series-5--color: #fffb96;
+
+    --psp-charts--series-6--color: hsl(192, 99%, 25%);
+    --psp-charts--series-7--color: hsl(321, 100%, 36%);
+    --psp-charts--series-8--color: hsl(192, 99%, 25%);
+    --psp-charts--series-9--color: hsl(157, 100%, 25%);
+    --psp-charts--series-10--color: hsl(272, 100%, 35%);
+
+    --psp-charts--gradient--background: linear-gradient(
         #f3d431,
         #efb92d,
         #ed9c25,

package/src/ts/bootstrap.ts

@@ -10,17 +10,28 @@
 // ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-import * as wasm_module from "../../dist/wasm/perspective-viewer.js";
+import type * as wasm_module_type from "../../dist/wasm/perspective-viewer.js";
 import { load_wasm_stage_0 } from "@perspective-dev/client/src/ts/wasm/decompress.ts";
 
+// @ts-ignore
+import * as worker_url from "./perspective-viewer.worker";
+
 export async function init_client(
     wasm_binary:
         | Promise<Response | ArrayBuffer | Uint8Array>
         | Response
         | ArrayBuffer
         | Uint8Array,
+    wasm_module?: typeof wasm_module_type,
 ) {
-    const module_or_path = await load_wasm_stage_0(wasm_binary);
+    // @ts-ignore
+    const url = await worker_url.getWorkerURL();
+    if (wasm_module === undefined) {
+        wasm_module = (await import(url)) as typeof wasm_module_type;
+    }
+
+    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();
+    await wasm_module.init(module_or_path, url);
 }

package/src/ts/column-format.ts

@@ -0,0 +1,162 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+/**
+ * Cross-package helpers for per-column value formatting. Used by both
+ * `viewer-datagrid` (cell formatting) and `viewer-charts` (axis ticks,
+ * tooltips, legends) so a column's `number_format` / `date_format`
+ * configuration produces identical output across plugins.
+ *
+ * The format configs mirror the `Intl.NumberFormatOptions` /
+ * `Intl.DateTimeFormatOptions` shapes one-for-one — they're written
+ * straight into the respective constructors. The `date_format.format`
+ * discriminator ("simple" | "custom") selects between two derivation
+ * paths: simple uses `dateStyle` / `timeStyle`, custom uses the
+ * per-field overrides (year / month / day / ...).
+ */
+
+export interface NumberFormatConfig {
+    style?: "decimal" | "currency" | "percent" | "unit";
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    minimumIntegerDigits?: number;
+    minimumSignificantDigits?: number;
+    maximumSignificantDigits?: number;
+    currency?: string;
+    currencyDisplay?: "code" | "symbol" | "narrowSymbol" | "name";
+    notation?: "standard" | "scientific" | "engineering" | "compact";
+    compactDisplay?: "short" | "long";
+    useGrouping?: boolean;
+}
+
+export interface DateFormatConfig {
+    format?: "custom" | string;
+    timeZone?: string;
+    dateStyle?: "short" | "medium" | "long" | "full" | "disabled";
+    timeStyle?: "short" | "medium" | "long" | "full" | "disabled";
+    second?: "numeric" | "2-digit" | "disabled";
+    minute?: "numeric" | "2-digit" | "disabled";
+    hour?: "numeric" | "2-digit" | "disabled";
+    day?: "numeric" | "2-digit" | "disabled";
+    weekday?: "narrow" | "short" | "long" | "disabled";
+    month?: "numeric" | "2-digit" | "narrow" | "short" | "long" | "disabled";
+    year?: "numeric" | "2-digit" | "disabled";
+    hour12?: boolean;
+    fractionalSecondDigits?: 1 | 2 | 3;
+}
+
+/**
+ * Default `Intl.NumberFormatOptions` applied when a numeric column has no
+ * `number_format` configured. Float columns get two fractional digits to
+ * match the legacy datagrid behavior; integer columns get an empty
+ * options bag (locale-default integer rendering).
+ */
+const NUMERIC_LEGACY_DEFAULTS: Record<string, Intl.NumberFormatOptions> = {
+    float: {
+        style: "decimal",
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    },
+};
+
+/**
+ * Default `Intl.DateTimeFormatOptions` applied when a datetime column has
+ * no `date_format` configured.
+ */
+const DATETIME_LEGACY_DEFAULTS: Intl.DateTimeFormatOptions = {
+    dateStyle: "short",
+    timeStyle: "medium",
+};
+
+const DATE_LEGACY_DEFAULTS: Intl.DateTimeFormatOptions = {
+    dateStyle: "short",
+};
+
+export function createNumberFormatter(
+    type: string,
+    cfg?: NumberFormatConfig,
+): Intl.NumberFormat {
+    const opts: Intl.NumberFormatOptions =
+        cfg ?? NUMERIC_LEGACY_DEFAULTS[type] ?? {};
+    return new Intl.NumberFormat(navigator.languages as string[], opts);
+}
+
+export function createDatetimeFormatter(
+    cfg?: DateFormatConfig,
+): Intl.DateTimeFormat {
+    if (!cfg || cfg.format !== "custom") {
+        const opts: Intl.DateTimeFormatOptions = {
+            timeZone: cfg?.timeZone,
+            dateStyle:
+                cfg?.dateStyle === "disabled"
+                    ? undefined
+                    : (cfg?.dateStyle ?? DATETIME_LEGACY_DEFAULTS.dateStyle),
+            timeStyle:
+                cfg?.timeStyle === "disabled"
+                    ? undefined
+                    : (cfg?.timeStyle ?? DATETIME_LEGACY_DEFAULTS.timeStyle),
+        };
+
+        return new Intl.DateTimeFormat(navigator.languages as string[], opts);
+    }
+
+    const opts: Intl.DateTimeFormatOptions = {
+        timeZone: cfg.timeZone,
+        hour12: cfg.hour12 ?? true,
+        fractionalSecondDigits: cfg.fractionalSecondDigits,
+    };
+    if (cfg.year !== "disabled") {
+        opts.year = cfg.year ?? "2-digit";
+    }
+    if (cfg.month !== "disabled") {
+        opts.month = cfg.month ?? "numeric";
+    }
+    if (cfg.day !== "disabled") {
+        opts.day = cfg.day ?? "numeric";
+    }
+    if (cfg.weekday && cfg.weekday !== "disabled") {
+        opts.weekday = cfg.weekday;
+    }
+    if (cfg.hour !== "disabled") {
+        opts.hour = cfg.hour ?? "numeric";
+    }
+    if (cfg.minute !== "disabled") {
+        opts.minute = cfg.minute ?? "numeric";
+    }
+    if (cfg.second !== "disabled") {
+        opts.second = cfg.second ?? "numeric";
+    }
+    return new Intl.DateTimeFormat(navigator.languages as string[], opts);
+}
+
+export function createDateFormatter(
+    cfg?: DateFormatConfig,
+): Intl.DateTimeFormat {
+    const opts: Intl.DateTimeFormatOptions = {
+        timeZone: "utc",
+        dateStyle:
+            cfg?.dateStyle === "disabled"
+                ? undefined
+                : (cfg?.dateStyle ?? DATE_LEGACY_DEFAULTS.dateStyle),
+    };
+    return new Intl.DateTimeFormat(navigator.languages as string[], opts);
+}
+
+/**
+ * Recover the source column name from a synthetic split-by path. Split
+ * pivoting produces paths of the form `<split_val_1>|...|<source_col>`;
+ * per-column config (formatters, aggregate styling, …) is always keyed
+ * on the trailing source column.
+ */
+export function sourceColumn(path: string): string {
+    return path.split("|").at(-1) ?? path;
+}

package/src/ts/extensions.ts

@@ -178,6 +178,10 @@ export interface PerspectiveViewerElementExt {
      */
     registerPlugin(name: string): Promise<void>;
 
+    get_wasm_module(): WebAssembly.Module;
+
+    get_worker_url(): URL;
+
     addEventListener(
         name: "perspective-click",
         cb: (e: CustomEvent) => void,

package/src/ts/perspective-viewer.ts

@@ -34,14 +34,22 @@
 export { IPerspectiveViewerPlugin } from "./plugin";
 export { HTMLPerspectiveViewerPluginElement } from "./plugin";
 
+export {
+    createNumberFormatter,
+    createDatetimeFormatter,
+    createDateFormatter,
+    sourceColumn,
+} from "./column-format";
+export type { NumberFormatConfig, DateFormatConfig } from "./column-format";
+
 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/ColumnConfigValues.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 { init_client } from "./bootstrap";
 import { init_client } from "./bootstrap";

package/src/{rust/components/column_settings_sidebar/style_tab/stub.rs → ts/perspective-viewer.worker.ts}

@@ -10,25 +10,5 @@
 // ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-use yew::{Html, Properties, function_component, html};
-
-#[derive(Properties, PartialEq)]
-pub struct StubProps {
-    pub error: Option<String>,
-    pub message: String,
-}
-
-#[function_component(Stub)]
-pub fn stub(p: &StubProps) -> Html {
-    if let Some(error) = p.error.clone() {
-        tracing::error!("Rendered stub: {error}");
-    }
-
-    html! {
-        <div class="style_contents">
-            <div id="column-style-container" class="no-style">
-                <div class="style-contents">{ p.message.clone() }</div>
-            </div>
-        </div>
-    }
-}
+export * from "../../dist/wasm/perspective-viewer.js";
+export { default } from "../../dist/wasm/perspective-viewer.js";

package/src/ts/plugin.ts

@@ -11,8 +11,7 @@
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
 import type { View } from "@perspective-dev/client";
-
-// import type * as perspective from "@perspective-dev/client";
+import { PluginStaticConfig } from "./ts-rs/PluginStaticConfig.js";
 
 /**
  * The `IPerspectiveViewerPlugin` interface defines the necessary API for a
@@ -21,7 +20,8 @@ import type { View } from "@perspective-dev/client";
  * scratch however, the simplest way is to inherit from
  * `<perspective-viewer-plugin>`, which implements `IPerspectiveViewerPlugin`
  * with non-offensive default implementations, where only the `draw()` and
- * `name()` methods need be overridden to get started with a simple plugin.
+ * `get_static_config()` methods need be overridden to get started with a
+ * simple plugin.
  *
  * Note that plugins are frozen once a `<perspective-viewer>` has been
  * instantiated, so generally new plugin code must be executed at the module
@@ -32,8 +32,8 @@ import type { View } from "@perspective-dev/client";
  * ```javascript
  * const BasePlugin = customElements.get("perspective-viewer-plugin");
  * class MyPlugin extends BasePlugin {
- *     get name() {
- *         return "My Plugin";
+ *     get_static_config() {
+ *         return { name: "My Plugin", config_column_names: [] };
  *     }
  *     async draw(view) {
  *         const count = await view.num_rows();
@@ -49,63 +49,17 @@ import type { View } from "@perspective-dev/client";
  */
 export interface IPerspectiveViewerPlugin {
     /**
-     * The name for this plugin, which is used as both it's unique key for use
-     * as a parameter for the `plugin` field of a `ViewerConfig`, and as the
-     * display name for this plugin in the `<perspective-viewer>` UI.
-     */
-    get name(): string;
-
-    /**
-     * Select mode determines how column add/remove buttons behave for this
-     * plugin.  `"select"` mode exclusively selects the added column, removing
-     * other columns.  `"toggle"` mode toggles the column on or off (dependent
-     * on column state), leaving existing columns alone.
-     */
-    get select_mode(): string | undefined;
-
-    /**
-     * The minimum number of columns required for this plugin to operate.
-     * This mostly affects drag/drop and column remove button behavior,
-     * preventing the use from applying configs which violate this min.
-     *
-     * While this option can technically be `undefined` (as in the case of
-     * `@perspective-dev/viewer-datagrid`), doing so currently has nearly
-     * identical behavior to 1.
-     */
-    get min_config_columns(): number | undefined;
-
-    /**
-     * The named column labels, if desired.  Named columns behave differently
-     * in drag/drop mode than unnamed columns, having replace/swap behavior
-     * rather than insert.  If provided, the length of `config_column_names`
-     * _must_ be `>= min_config_columns`, as this is assumed by the drag/drop
-     * logic.
-     */
-    get config_column_names(): string[] | undefined;
-
-    /**
-     * The load priority of the plugin. If the plugin shares priority with another,
-     * the first to load has a higher priority.
-     *
-     * A larger number has a higher priority.
-     *
-     * The plugin with the highest priority will be loaded by default by the Perspective viewer.
-     * If you would like to instead begin with a lower priority plugin, choose it explicitly with
-     * a `HTMLPerspectiveViewerPluginElement.restore` call.
-     */
-    get priority(): number | undefined;
-
-    /**
-     * Given a column's grouping (determined by indexing it in `plugin.config_column_names`)
-     * and its view type, determines whether or not to render column styles in the settings sidebar.
-     * Implementing this function and `column_style_config` allows the plugin to interface with the viewer's column configuration API.
+     * Static plugin configuration. Called exactly once per plugin at
+     * registration time and cached; the result must be stable for the
+     * lifetime of the application.
      */
-    can_render_column_styles?: (view_type: string, group: string) => boolean;
+    get_static_config(): PluginStaticConfig;
 
     /**
      * Determines which column configuration controls are populated in the viewer.
-     * Corresponds to the data the plugin will recieve on save.
-     * Implementing this function and `can_render_column_styles` allows the plugin to interface with the viewer's column configuration API.
+     * Corresponds to the data the plugin will recieve on save. Only
+     * invoked when `can_render_column_styles` is `true` in the static
+     * config.
      */
     column_style_config?: (view_type: string, group: string) => any;
 
@@ -163,20 +117,7 @@ export interface IPerspectiveViewerPlugin {
      * Notify the plugin that the style environment has changed.  Useful for
      * plugins which read CSS styles via `window.getComputedStyle()`.
      */
-    restyle(view: View): Promise<void>;
-
-    /**
-     * Save this plugin's state to a JSON-serializable value.  While this value
-     * can be anything, it should work reciprocally with `restore()` to return
-     * this plugin's renderer to the same state, though potentially with a
-     * different `View`.
-     *
-     * `save()` should be used for user-persistent settings that are
-     * data-agnostic, so the user can have persistent view during refresh or
-     * reload.  For example, `@perspective-dev/viewer-d3fc` uses
-     * `plugin_config` to remember the user-repositionable legend coordinates.
-     */
-    save(): any;
+    restyle(): void;
 
     /**
      * Restore this plugin to a state previously returned by `save()`.
@@ -213,33 +154,16 @@ export class HTMLPerspectiveViewerPluginElement
         super();
     }
 
-    get name(): string {
-        return "Debug";
-    }
-
-    get select_mode(): "select" | "toggle" {
-        return "select";
-    }
-
-    get min_config_columns(): number | undefined {
-        return undefined;
-    }
-
-    get config_column_names(): string[] | undefined {
-        return undefined;
-    }
-
-    get priority(): number {
-        return 0;
-    }
-
-    can_render_column_styles(): boolean {
-        return false;
+    get_static_config(): PluginStaticConfig {
+        return {
+            name: "Debug",
+            select_mode: "select",
+            config_column_names: [],
+        };
     }
 
     column_style_config(): any {
-        {
-        }
+        return {};
     }
 
     async update(view: View): Promise<void> {
@@ -261,11 +185,7 @@ export class HTMLPerspectiveViewerPluginElement
         // Not Implemented
     }
 
-    async restyle(view: View): Promise<void> {
-        // Not Implemented
-    }
-
-    save(): any {
+    restyle() {
         // Not Implemented
     }
 
@@ -276,4 +196,8 @@ export class HTMLPerspectiveViewerPluginElement
     async delete(): Promise<void> {
         // Not Implemented
     }
+
+    get supports_streaming(): boolean {
+        return false;
+    }
 }

package/src/ts/ts-rs/{FormatUnit.ts → ColumnSelectMode.ts}

@@ -1,3 +1,3 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
-export type FormatUnit = "custom";
+export type ColumnSelectMode = "toggle" | "select";

package/src/ts/ts-rs/PluginStaticConfig.ts

@@ -0,0 +1,78 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ColumnSelectMode } from "./ColumnSelectMode.js";
+import type { GroupRollupMode } from "./GroupRollupMode.js";
+
+/**
+ * Static, immutable configuration for a plugin.
+ *
+ * Returned once per plugin from `get_static_config()` at registration
+ * time and cached in [`crate::renderer::PluginRecord`]. Consumers
+ * (renderer, session, queries, components) read these fields off the
+ * renderer's active-plugin metadata rather than calling back into JS.
+ *
+ * `<perspective-viewer>` reads this exactly once per plugin (at
+ * `registerPlugin` time) and caches it for the lifetime of the
+ * application. The result must be stable; do not mutate any field
+ * after registration.
+ */
+export type PluginStaticConfig = { 
+/**
+ * The unique key for this plugin. Used as the `plugin` field in a
+ * `ViewerConfig` and as the display name key in the
+ * `<perspective-viewer>` UI.
+ */
+name: string, 
+/**
+ * Category in the plugin picker menu.
+ */
+category?: string | null, 
+/**
+ * Soft limit on the number of columns the plugin will render.
+ * Triggers the "Rendering N of M" warning when the view exceeds
+ * this value (until dismissed).
+ */
+max_columns?: number | null, 
+/**
+ * Soft limit on the number of cells (rows × columns) the plugin
+ * will render. Triggers the "Rendering N of M" warning when the view
+ * exceeds this value (until dismissed).
+ */
+max_cells?: number | null, 
+/**
+ * Column add/remove behavior. `"select"` exclusively selects the
+ * added column, removing other columns. `"toggle"` toggles the
+ * column on or off based on its current state, leaving other
+ * columns alone.
+ */
+select_mode?: ColumnSelectMode, 
+/**
+ * Minimum number of columns the plugin requires to render. Mostly
+ * affects drag/drop and column-remove button behavior. `undefined`
+ * is treated identically to `1`.
+ */
+min_config_columns?: number | null, 
+/**
+ * Named column slots. Named columns have replace/swap behavior in
+ * drag/drop rather than insert. The length must be at least
+ * `min_config_columns`.
+ */
+config_column_names?: Array<string>, 
+/**
+ * Group-rollup modes the plugin accepts, in preference order.
+ * The first entry that matches a feature flag becomes the default.
+ */
+group_rollup_modes?: Array<GroupRollupMode> | null, 
+/**
+ * Plugin load priority. Higher numbers win; ties resolve in
+ * registration order. The highest-priority plugin is loaded by
+ * default unless `restore({ plugin })` overrides it.
+ */
+priority?: number | null, 
+/**
+ * Whether this plugin opts into per-column style controls in the
+ * settings sidebar. When `true`, the StyleTab is shown for active
+ * columns and the plugin's `column_config_schema` is queried for
+ * the per-column field set. When `false` or omitted, no StyleTab
+ * is shown.
+ */
+can_render_column_styles?: boolean, };