@perspective-dev/viewer 5.1.0 → 5.3.0

package/src/ts/plugin.ts

@@ -93,6 +93,20 @@ export interface IPerspectiveViewerPlugin {
      */
     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/src/ts/providers.ts

@@ -0,0 +1,96 @@
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃ ██████ ██████ ██████       █      █      █      █      █ █▄  ▀███ █       ┃
+// ┃ ▄▄▄▄▄█ █▄▄▄▄▄ ▄▄▄▄▄█  ▀▀▀▀▀█▀▀▀▀▀ █ ▀▀▀▀▀█ ████████▌▐███ ███▄  ▀█ █ ▀▀▀▀▀ ┃
+// ┃ █▀▀▀▀▀ █▀▀▀▀▀ █▀██▀▀ ▄▄▄▄▄ █ ▄▄▄▄▄█ ▄▄▄▄▄█ ████████▌▐███ █████▄   █ ▄▄▄▄▄ ┃
+// ┃ █      ██████ █  ▀█▄       █ ██████      █      ███▌▐███ ███████▄ █       ┃
+// ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+// ┃ 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). ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+/**
+ * LLM provider presets for `viewer.agentConfig()`. These are plain data —
+ * the agent core is provider-agnostic (one OpenAI-chat-completions protocol
+ * over primitive `url`/`headers`/`apiKey` connection fields), so a
+ * "provider" is just a spreadable collection of those fields:
+ *
+ * ```javascript
+ * import { providers } from "@perspective-dev/viewer";
+ * viewer.agentConfig({
+ *     ...providers.anthropic,
+ *     apiKey: "sk-ant-...",
+ *     model: "claude-haiku-4-5",       // spread order = override order
+ * });
+ * ```
+ *
+ * Any OpenAI-compatible service works without a preset — pass its full
+ * chat-completions `url` (and `apiKey`/`headers` as needed) directly.
+ * Cloud presets call the provider from the browser tab; suitable for local
+ * development, or route `url` through your own proxy for production.
+ */
+
+/**
+ * A spreadable connection preset for `viewer.agentConfig()`.
+ */
+export interface AgentProviderPreset {
+    name: string;
+    url: string;
+    headers?: Record<string, string>;
+    model?: string;
+}
+
+export const providers = {
+    /**
+     * Anthropic's OpenAI-compatibility endpoint. `apiKey` required.
+     */
+    anthropic: {
+        name: "anthropic",
+        url: "https://api.anthropic.com/v1/chat/completions",
+        headers: { "anthropic-dangerous-direct-browser-access": "true" },
+        model: "claude-opus-5",
+    },
+
+    /**
+     * Google Gemini's OpenAI-compatibility endpoint. `apiKey` required.
+     */
+    gemini: {
+        name: "gemini",
+        url: "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions",
+        model: "gemini-2.5-flash",
+    },
+
+    /**
+     * LM Studio's local developer server (enable CORS in its settings).
+     */
+    lmstudio: {
+        name: "lmstudio",
+        url: "http://localhost:1234/v1/chat/completions",
+    },
+
+    /**
+     *  Local Ollama (set `OLLAMA_ORIGINS` for CORS).
+     */
+    ollama: {
+        name: "ollama",
+        url: "http://localhost:11434/v1/chat/completions",
+    },
+
+    /**
+     * OpenRouter. `apiKey` required.
+     */
+    openrouter: {
+        name: "openrouter",
+        url: "https://openrouter.ai/api/v1/chat/completions",
+    },
+
+    /**
+     * OpenAI. `apiKey` required.
+     */
+    openai: {
+        name: "openai",
+        url: "https://api.openai.com/v1/chat/completions",
+        model: "gpt-5.2",
+    },
+} as const satisfies Record<string, AgentProviderPreset>;

package/src/ts/ts-rs/CompactDisplay.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 CompactDisplay = { "compactDisplay": "short" } | { "compactDisplay": "long" };

package/src/ts/ts-rs/CurrencyCode.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 CurrencyCode = "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYR" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LTL" | "LVL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRO" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLL" | "SOS" | "SRD" | "SSP" | "STD" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USN" | "USS" | "UYI" | "UYU" | "UZS" | "VEF" | "VND" | "VUV" | "WST" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XDR" | "XFU" | "XOF" | "XPD" | "XPF" | "XPT" | "XTS" | "XXX" | "YER" | "ZAR" | "ZMW";

package/src/ts/ts-rs/CurrencyDisplay.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 CurrencyDisplay = "code" | "symbol" | "narrowSymbol" | "name";

package/src/ts/ts-rs/CurrencyNumberFormatStyle.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CurrencyCode } from "./CurrencyCode.js";
+import type { CurrencyDisplay } from "./CurrencyDisplay.js";
+import type { CurrencySign } from "./CurrencySign.js";
+
+export type CurrencyNumberFormatStyle = { currency: CurrencyCode, currencyDisplay: CurrencyDisplay | null, currencySign: CurrencySign | null, };

package/src/ts/ts-rs/CurrencySign.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 CurrencySign = "standard" | "accounting";

package/src/ts/ts-rs/CustomDatetimeFormat.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 CustomDatetimeFormat = "long" | "short" | "narrow" | "numeric" | "2-digit" | "disabled";

package/src/ts/ts-rs/CustomDatetimeStyleConfig.ts

@@ -0,0 +1,54 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CustomDatetimeFormat } from "./CustomDatetimeFormat.js";
+import type { FormatUnit } from "./FormatUnit.js";
+
+/**
+ * A datetime column's `date_format` in its `Custom` form: per-part
+ * `Intl.DateTimeFormatOptions` overrides, discriminated from the `Simple`
+ * preset form by the required `format: "custom"` key. Each part is a
+ * [`CustomDatetimeFormat`] variant valid for that `Intl` option;
+ * `"disabled"` omits the part from the formatted output entirely.
+ */
+export type CustomDatetimeStyleConfig = { format: FormatUnit, 
+/**
+ * An IANA time zone name (e.g. `"America/New_York"`); defaults to the
+ * browser's local time zone.
+ */
+timeZone?: string | null, 
+/**
+ * Sub-second digits to display, 0-3 (0 = none).
+ */
+fractionalSecondDigits?: number, 
+/**
+ * Defaults to `"numeric"`.
+ */
+second?: CustomDatetimeFormat, 
+/**
+ * Defaults to `"numeric"`.
+ */
+minute?: CustomDatetimeFormat, 
+/**
+ * Defaults to `"numeric"`.
+ */
+hour?: CustomDatetimeFormat, 
+/**
+ * Defaults to `"numeric"`.
+ */
+day?: CustomDatetimeFormat, 
+/**
+ * A name form (`"long"`/`"short"`/`"narrow"`); defaults to
+ * `"disabled"` (weekday not shown).
+ */
+weekday?: CustomDatetimeFormat, 
+/**
+ * Numeric or name form; defaults to `"numeric"`.
+ */
+month?: CustomDatetimeFormat, 
+/**
+ * Defaults to `"2-digit"`.
+ */
+year?: CustomDatetimeFormat, 
+/**
+ * 12-hour clock; defaults to `true`.
+ */
+hour12?: boolean, };

package/src/ts/ts-rs/CustomNumberFormatConfig.ts

@@ -0,0 +1,25 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RoundingMode } from "./RoundingMode.js";
+import type { RoundingPriority } from "./RoundingPriority.js";
+import type { SignDisplay } from "./SignDisplay.js";
+import type { TrailingZeroDisplay } from "./TrailingZeroDisplay.js";
+import type { UseGrouping } from "./UseGrouping.js";
+
+/**
+ * A numeric column's `number_format` (`columns_config` value) —
+ * `Intl.NumberFormat`-shaped options, written by the Style tab's number
+ * format editor and read by `createNumberFormatter`. The `style` and
+ * `notation` families ([`NumberFormatStyle`] / [`Notation`]) are serde-
+ * FLATTENED into this object but `#[ts(skip)]`'d (ts-rs cannot flatten
+ * `Option<enum>`) — the package's `NumberFormatConfig` re-composes the
+ * full wire type as `CustomNumberFormatConfig & Partial<NumberFormatStyle>
+ * & Partial<Notation>` (see `column-format.ts`).
+ */
+export type CustomNumberFormatConfig = { minimumIntegerDigits?: number | null, minimumFractionDigits?: number | null, maximumFractionDigits?: number | null, minimumSignificantDigits?: number | null, maximumSignificantDigits?: number | null, roundingPriority?: RoundingPriority | null, roundingIncrement?: number | null, roundingMode?: RoundingMode | null, trailingZeroDisplay?: TrailingZeroDisplay | null, 
+/**
+ * NOTE (audit 2026-08-05): serialized values are the STRINGS
+ * `"always"`/`"auto"`/`"min2"` or the untagged BOOLEAN `false` —
+ * the former hand-written TS `useGrouping?: boolean` was wrong for
+ * the string cases.
+ */
+useGrouping?: UseGrouping | null, signDisplay?: SignDisplay | null, };

package/src/ts/ts-rs/DatetimeColorMode.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 DatetimeColorMode = "none" | "foreground" | "background";

package/src/ts/ts-rs/DatetimeFormatType.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 { CustomDatetimeStyleConfig } from "./CustomDatetimeStyleConfig.js";
+import type { SimpleDatetimeStyleConfig } from "./SimpleDatetimeStyleConfig.js";
+
+/**
+ * `Simple` case has all default-able keys and must be last!
+ */
+export type DatetimeFormatType = CustomDatetimeStyleConfig | SimpleDatetimeStyleConfig;

package/src/ts/ts-rs/FormatMode.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 FormatMode = "none" | "link" | "bold" | "italics";

package/src/ts/ts-rs/FormatUnit.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 FormatUnit = "custom";

package/src/ts/ts-rs/Notation.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CompactDisplay } from "./CompactDisplay.js";
+
+/**
+ * The `notation` family of a numeric column's `number_format` —
+ * serialized FLATTENED into [`CustomNumberFormatConfig`]'s object,
+ * discriminated by the `notation` key (`"standard"` default,
+ * `"scientific"`, `"engineering"`, `"compact"` + `compactDisplay`),
+ * mirroring `Intl.NumberFormat` options.
+ */
+export type Notation = { "notation": "standard" } | { "notation": "scientific" } | { "notation": "engineering" } | { "notation": "compact" } & CompactDisplay;

package/src/ts/ts-rs/NumberFormatStyle.ts

@@ -0,0 +1,12 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CurrencyNumberFormatStyle } from "./CurrencyNumberFormatStyle.js";
+import type { UnitNumberFormatStyle } from "./UnitNumberFormatStyle.js";
+
+/**
+ * The `style` family of a numeric column's `number_format` — serialized
+ * FLATTENED into [`CustomNumberFormatConfig`]'s object, discriminated by
+ * the `style` key (`"decimal"` default, `"currency"` + `currency`/
+ * `currencyDisplay`/`currencySign`, `"percent"`, `"unit"` + `unit`/
+ * `unitDisplay`), mirroring `Intl.NumberFormat` options.
+ */
+export type NumberFormatStyle = { "style": "decimal" } | { "style": "currency" } & CurrencyNumberFormatStyle | { "style": "percent" } | { "style": "unit" } & UnitNumberFormatStyle;

package/src/ts/ts-rs/PanelViewerConfig.ts

@@ -5,12 +5,58 @@ 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";
 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> = { version: V, columns_config: { [key in string]?: { [key in string]?: JsonValue } }, plugin: string, plugin_config: { [key in string]?: JsonValue }, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, windows?: Windows, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };
+export type PanelViewerConfig<V = string> = { 
+/**
+ * The `@perspective-dev/viewer` version that wrote this config,
+ * stamped on save and used to migrate older tokens. Callers do not
+ * set it.
+ */
+version: V, 
+/**
+ * Per-column styling, keyed by column name. The viewer treats the
+ * values as opaque — their shape is defined by the ACTIVE plugin,
+ * so a config written for one plugin may carry keys another
+ * ignores. Query the live shape with the `get_style_schema` agent
+ * tool, or the plugin's `column_config_schema()`.
+ */
+columns_config: { [key in string]?: { [key in string]?: JsonValue } }, 
+/**
+ * Name of the visualization plugin, from the set registered on the
+ * page (the `list_plugins` agent tool, or the plugin picker). This
+ * also decides what the view fields MEAN visually: `columns` is
+ * positional and each plugin reads the positions differently, and
+ * `group_by`/`split_by` draw different things per plugin.
+ */
+plugin: string, 
+/**
+ * Plugin-wide settings (as opposed to the per-column
+ * [`Self::columns_config`]). Opaque to the viewer and defined by
+ * the active plugin; see `get_style_schema`.
+ */
+plugin_config: { [key in string]?: JsonValue }, 
+/**
+ * Name of the `Table` this panel renders, as hosted on the panel's
+ * `Client`. Every placed panel has a table binding (creation
+ * requires one by type — [`ViewerConfigInitial`]), so the saved
+ * config carries it unconditionally.
+ */
+table: string, 
+/**
+ * Selected theme NAME (e.g. `"Pro Dark"`) — not a CSS value. Valid
+ * names are the Perspective themes loaded on the page, which
+ * `resetThemes()` re-scans. `None` selects the first available.
+ */
+theme: string | null, 
+/**
+ * Panel title, shown in its tab. `None` renders the default title.
+ */
+title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, split_rollup_mode: SplitRollupMode, filter_op?: FilterReducer, expressions: Expressions, windows?: Windows, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };

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

@@ -1,6 +1,7 @@
 // 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";
+import type { SplitRollupMode } from "./SplitRollupMode.js";
 
 /**
  * Static, immutable configuration for a plugin.
@@ -62,6 +63,11 @@ config_column_names?: Array<string>,
  * The first entry that matches a feature flag becomes the default.
  */
 group_rollup_modes?: Array<GroupRollupMode> | null, 
+/**
+ * Split-rollup modes the plugin accepts, in preference order.
+ * The first entry that matches a feature flag becomes the default.
+ */
+split_rollup_modes?: Array<SplitRollupMode> | null, 
 /**
  * Plugin load priority. Higher numbers win; ties resolve in
  * registration order. The highest-priority plugin is loaded by
@@ -75,4 +81,33 @@ priority?: number | null,
  * the per-column field set. When `false` or omitted, no StyleTab
  * is shown.
  */
-can_render_column_styles?: boolean, };
+can_render_column_styles?: boolean, 
+/**
+ * What `group_by` MEANS visually for this plugin, e.g. `"X Axis"`
+ * for the Y-series charts or `"Hierarchy"` for treemap/sunburst.
+ * `None` where the field has no visual role of its own and is a
+ * plain aggregation key (the X/Y charts, whose axes both come from
+ * `columns`).
+ *
+ * This is the `group_by` counterpart of [`Self::config_column_names`]:
+ * the same declaration that names the positional `columns` slots
+ * should say what the other view fields draw, so that consumers —
+ * the settings UI's field labels, and the agent's `list_plugins`
+ * contract — read one source instead of restating the mapping.
+ */
+group_by_role?: string | null, 
+/**
+ * What `split_by` MEANS visually for this plugin, e.g. `"Series"`.
+ * See [`Self::group_by_role`].
+ */
+split_by_role?: string | null, 
+/**
+ * `true` when this plugin CONNECTS its points in row order, so the
+ * `View`'s row order is visible in the drawing: an unsorted config
+ * renders the table's natural order, which reads as a tangle unless
+ * the rows already arrive ordered along the axis. Declared rather
+ * than inferred, because "unsorted" is not itself a mistake — a
+ * pre-ordered table needs no `sort`, and the point plugins
+ * (scatter, density) do not care at all.
+ */
+connects_row_order?: boolean, };

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

@@ -0,0 +1,20 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Options for the `restore()` method.
+ */
+export type RestoreOptions = { 
+/**
+ * The target panel; the active panel when omitted.
+ */
+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.
+ */
+suppress_errors?: boolean, };

package/src/ts/ts-rs/RoundingMode.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 RoundingMode = "ceil" | "floor" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven";

package/src/ts/ts-rs/RoundingPriority.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 RoundingPriority = "auto" | "morePrecision" | "lessPrecision";

package/src/ts/ts-rs/SaveWorkspaceOptions.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * 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/src/ts/ts-rs/SignDisplay.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 SignDisplay = "auto" | "always" | "exceptZero" | "negative" | "never";

package/src/ts/ts-rs/SimpleDatetimeFormat.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 SimpleDatetimeFormat = "full" | "long" | "medium" | "short" | "disabled";

package/src/ts/ts-rs/SimpleDatetimeStyleConfig.ts

@@ -0,0 +1,25 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SimpleDatetimeFormat } from "./SimpleDatetimeFormat.js";
+
+/**
+ * A datetime column's `date_format` in its `Simple` preset form:
+ * `Intl.DateTimeFormatOptions`' `dateStyle`/`timeStyle` presets. This is
+ * the default form (no `format` key); setting `format: "custom"` selects
+ * the per-part `CustomDatetimeStyleConfig` instead.
+ */
+export type SimpleDatetimeStyleConfig = { 
+/**
+ * An IANA time zone name (e.g. `"America/New_York"`); defaults to the
+ * browser's local time zone.
+ */
+timeZone?: string | null, 
+/**
+ * Date preset breadth, or `"disabled"` to omit the date entirely;
+ * defaults to `"short"`.
+ */
+dateStyle?: SimpleDatetimeFormat, 
+/**
+ * Time preset breadth, or `"disabled"` to omit the time entirely;
+ * defaults to `"medium"`.
+ */
+timeStyle?: SimpleDatetimeFormat, };

package/src/ts/ts-rs/SplitRollupMode.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The `split_by` corollary to [`GroupRollupMode`]. `Flat` (the default,
+ * matching this crate's historical behavior) emits only full-depth split
+ * combinations as columns; `Rollup` additionally emits grand-total and
+ * subtotal column groups in "totals before" order. There is no `Total`
+ * variant - an empty `split_by` already expresses a single grand-total
+ * column group.
+ */
+export type SplitRollupMode = "flat" | "rollup";

package/src/ts/ts-rs/StringColorMode.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 StringColorMode = "none" | "foreground" | "background" | "series";

package/src/ts/ts-rs/TrailingZeroDisplay.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 TrailingZeroDisplay = "auto" | "stripIfInteger";

package/src/ts/ts-rs/Unit.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 Unit = "acre" | "bit" | "byte" | "celsius" | "centimeter" | "day" | "degree" | "fahrenheit" | "fluid-ounce" | "foot" | "gallob" | "gigabit" | "gigabyte" | "gram" | "hectare" | "hour" | "inch" | "kilobit" | "kilobyte" | "kilogram" | "kilometer" | "liter" | "megabit" | "megabyte" | "meter" | "microsecond" | "mile" | "mile-scandinavian" | "milliliter" | "millimeter" | "millisecond" | "minute" | "month" | "nanosecond" | "ounce" | "percent" | "petabyte" | "pound" | "second" | "stone" | "terabit" | "terabyte" | "week" | "yard" | "year";

package/src/ts/ts-rs/UnitDisplay.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 UnitDisplay = "short" | "narrow" | "long";

package/src/ts/ts-rs/UnitNumberFormatStyle.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Unit } from "./Unit.js";
+import type { UnitDisplay } from "./UnitDisplay.js";
+
+export type UnitNumberFormatStyle = { unit: Unit, unitDisplay: UnitDisplay | null, };

package/src/ts/ts-rs/UseGrouping.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 UseGrouping = "always" | "auto" | "min2" | boolean;

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

@@ -5,15 +5,61 @@ 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";
 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.
  */
-export type ViewerConfig<V = string> = { settings: boolean, version: V, columns_config: { [key in string]?: { [key in string]?: JsonValue } }, plugin: string, plugin_config: { [key in string]?: JsonValue }, table: string | null, theme: string | null, title: string | null, group_by: Array<string>, split_by: Array<string>, sort: Array<Sort>, filter: Array<Filter>, group_rollup_mode: GroupRollupMode, filter_op?: FilterReducer, expressions: Expressions, windows?: Windows, columns: Array<string | null>, aggregates: { [key in string]?: Aggregate }, group_by_depth?: number | null, };
+export type ViewerConfig<V = string> = { settings: boolean, 
+/**
+ * The `@perspective-dev/viewer` version that wrote this config,
+ * stamped on save and used to migrate older tokens. Callers do not
+ * set it.
+ */
+version: V, 
+/**
+ * Per-column styling, keyed by column name. The viewer treats the
+ * values as opaque — their shape is defined by the ACTIVE plugin,
+ * so a config written for one plugin may carry keys another
+ * ignores. Query the live shape with the `get_style_schema` agent
+ * tool, or the plugin's `column_config_schema()`.
+ */
+columns_config: { [key in string]?: { [key in string]?: JsonValue } }, 
+/**
+ * Name of the visualization plugin, from the set registered on the
+ * page (the `list_plugins` agent tool, or the plugin picker). This
+ * also decides what the view fields MEAN visually: `columns` is
+ * positional and each plugin reads the positions differently, and
+ * `group_by`/`split_by` draw different things per plugin.
+ */
+plugin: string, 
+/**
+ * Plugin-wide settings (as opposed to the per-column
+ * [`Self::columns_config`]). Opaque to the viewer and defined by
+ * the active plugin; see `get_style_schema`.
+ */
+plugin_config: { [key in string]?: JsonValue }, 
+/**
+ * Name of the `Table` this panel renders, as hosted on the panel's
+ * `Client`. Every placed panel has a table binding (creation
+ * requires one by type — [`ViewerConfigInitial`]), so the saved
+ * config carries it unconditionally.
+ */
+table: string, 
+/**
+ * Selected theme NAME (e.g. `"Pro Dark"`) — not a CSS value. Valid
+ * names are the Perspective themes loaded on the page, which
+ * `resetThemes()` re-scans. `None` selects the first available.
+ */
+theme: string | null, 
+/**
+ * Panel title, shown in its tab. `None` renders the default title.
+ */
+title: string | null, 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, };