@perspective-dev/viewer 5.1.0 → 5.2.0

package/src/themes/intl/fr.css

@@ -118,6 +118,22 @@ perspective-dropdown {
     --psp-label--query-tab--content: "Requête";
     --psp-label--plugin-tab--content: "Plugin";
     --psp-label--debug-tab--content: "JSON";
+    --psp-label--chat-tab--content: "Discussion";
+
+    /* Chat panel */
+    --psp-label--chat-reasoning--content: "Raisonnement";
+    --psp-label--chat-send--content: "Envoyer";
+    --psp-label--chat-stop--content: "Arrêter";
+    --psp-label--chat-placeholder--content: "Question sur vos données…";
+
+    /* Plugin-declared pivot roles (PluginStaticConfig) */
+    --psp-label--role--x-axis--content: "Axe X";
+    --psp-label--role--y-axis--content: "Axe Y";
+    --psp-label--role--series--content: "Séries";
+    --psp-label--role--hierarchy--content: "Hiérarchie";
+    --psp-label--role--facets--content: "Facettes";
+    --psp-label--role--row-groups--content: "Groupes de lignes";
+    --psp-label--role--column-groups--content: "Groupes de colonnes";
 
     /* Plugin settings */
     --psp-label--edit-mode--content: "Mode édition";

package/src/themes/intl/ja.css

@@ -118,6 +118,22 @@ perspective-dropdown {
     --psp-label--query-tab--content: "クエリ";
     --psp-label--plugin-tab--content: "プラグイン";
     --psp-label--debug-tab--content: "JSON";
+    --psp-label--chat-tab--content: "チャット";
+
+    /* Chat panel */
+    --psp-label--chat-reasoning--content: "推論";
+    --psp-label--chat-send--content: "送信";
+    --psp-label--chat-stop--content: "停止";
+    --psp-label--chat-placeholder--content: "データについて質問…";
+
+    /* Plugin-declared pivot roles (PluginStaticConfig) */
+    --psp-label--role--x-axis--content: "X軸";
+    --psp-label--role--y-axis--content: "Y軸";
+    --psp-label--role--series--content: "系列";
+    --psp-label--role--hierarchy--content: "階層";
+    --psp-label--role--facets--content: "ファセット";
+    --psp-label--role--row-groups--content: "行グループ";
+    --psp-label--role--column-groups--content: "列グループ";
 
     /* Plugin settings */
     --psp-label--edit-mode--content: "編集モード";

package/src/themes/intl/pt.css

@@ -118,6 +118,22 @@ perspective-dropdown {
     --psp-label--query-tab--content: "Consulta";
     --psp-label--plugin-tab--content: "Plugin";
     --psp-label--debug-tab--content: "JSON";
+    --psp-label--chat-tab--content: "Conversa";
+
+    /* Chat panel */
+    --psp-label--chat-reasoning--content: "Raciocínio";
+    --psp-label--chat-send--content: "Enviar";
+    --psp-label--chat-stop--content: "Parar";
+    --psp-label--chat-placeholder--content: "Pergunte sobre seus dados…";
+
+    /* Plugin-declared pivot roles (PluginStaticConfig) */
+    --psp-label--role--x-axis--content: "Eixo X";
+    --psp-label--role--y-axis--content: "Eixo Y";
+    --psp-label--role--series--content: "Séries";
+    --psp-label--role--hierarchy--content: "Hierarquia";
+    --psp-label--role--facets--content: "Facetas";
+    --psp-label--role--row-groups--content: "Grupos de linhas";
+    --psp-label--role--column-groups--content: "Grupos de colunas";
 
     /* Plugin settings */
     --psp-label--edit-mode--content: "Modo de edição";

package/src/themes/intl/zh.css

@@ -118,6 +118,22 @@ perspective-dropdown {
     --psp-label--query-tab--content: "查询";
     --psp-label--plugin-tab--content: "插件";
     --psp-label--debug-tab--content: "JSON";
+    --psp-label--chat-tab--content: "聊天";
+
+    /* Chat panel */
+    --psp-label--chat-reasoning--content: "推理";
+    --psp-label--chat-send--content: "发送";
+    --psp-label--chat-stop--content: "停止";
+    --psp-label--chat-placeholder--content: "询问您的数据…";
+
+    /* Plugin-declared pivot roles (PluginStaticConfig) */
+    --psp-label--role--x-axis--content: "X 轴";
+    --psp-label--role--y-axis--content: "Y 轴";
+    --psp-label--role--series--content: "系列";
+    --psp-label--role--hierarchy--content: "层级";
+    --psp-label--role--facets--content: "分面";
+    --psp-label--role--row-groups--content: "行分组";
+    --psp-label--role--column-groups--content: "列分组";
 
     /* Plugin settings */
     --psp-label--edit-mode--content: "编辑模式";

package/src/themes/intl.css

@@ -108,6 +108,22 @@ perspective-dropdown {
     --psp-label--query-tab--content: "Query";
     --psp-label--plugin-tab--content: "Plugin";
     --psp-label--debug-tab--content: "JSON";
+    --psp-label--chat-tab--content: "Chat";
+
+    /* Chat panel */
+    --psp-label--chat-reasoning--content: "Reasoning";
+    --psp-label--chat-send--content: "Send";
+    --psp-label--chat-stop--content: "Stop";
+    --psp-label--chat-placeholder--content: "Ask Perspective ...";
+
+    /* Plugin-declared pivot roles (PluginStaticConfig) */
+    --psp-label--role--x-axis--content: "X Axis";
+    --psp-label--role--y-axis--content: "Y Axis";
+    --psp-label--role--series--content: "Series";
+    --psp-label--role--hierarchy--content: "Hierarchy";
+    --psp-label--role--facets--content: "Facets";
+    --psp-label--role--row-groups--content: "Row Groups";
+    --psp-label--role--column-groups--content: "Column Groups";
 
     /* Window editor */
     --psp-label--window-source--content: "Column";

package/src/ts/column-format.ts

@@ -24,34 +24,36 @@
  * 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;
-}
+import type { CustomNumberFormatConfig } from "./ts-rs/CustomNumberFormatConfig.d.ts";
+import type { NumberFormatStyle } from "./ts-rs/NumberFormatStyle.d.ts";
+import type { Notation } from "./ts-rs/Notation.d.ts";
+import type { DatetimeFormatType } from "./ts-rs/DatetimeFormatType.d.ts";
+import type { SimpleDatetimeStyleConfig } from "./ts-rs/SimpleDatetimeStyleConfig.d.ts";
+
+/**
+ * A numeric column's `number_format` (`columns_config` value), exactly as
+ * the Style tab's editor WRITES it — the ts-rs projection of the Rust
+ * `CustomNumberFormatConfig`, re-composed with its serde-flattened
+ * `style` and `notation` families (ts-rs cannot flatten `Option<enum>`,
+ * so the Rust type `#[ts(skip)]`s them and they export separately).
+ */
+export type NumberFormatConfig = CustomNumberFormatConfig &
+    Partial<NumberFormatStyle> &
+    Partial<Notation>;
 
-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;
+/**
+ * A datetime column's `date_format` (`columns_config` value) — the Rust
+ * `DatetimeFormatType` union: a `Simple` preset (`dateStyle` /
+ * `timeStyle`), or per-part custom fields discriminated by
+ * `format: "custom"`.
+ */
+export type DateFormatConfig = DatetimeFormatType;
+
+/** Narrow a [`DateFormatConfig`] to its `Simple` arm, if it is one. */
+function simple_config(
+    cfg?: DateFormatConfig,
+): SimpleDatetimeStyleConfig | undefined {
+    return cfg && !("format" in cfg) ? cfg : undefined;
 }
 
 /**
@@ -85,55 +87,73 @@ export function createNumberFormatter(
     type: string,
     cfg?: NumberFormatConfig,
 ): Intl.NumberFormat {
-    const opts: Intl.NumberFormatOptions =
-        cfg ?? NUMERIC_LEGACY_DEFAULTS[type] ?? {};
+    // ts-rs renders serde-absent keys as `T | null`; the wire never
+    // carries an explicit `null` (`skip_serializing_if`), and
+    // `Intl.NumberFormat` treats both absent and `undefined` the same, so
+    // the cast is presentation-only.
+    const opts = (cfg ??
+        NUMERIC_LEGACY_DEFAULTS[type] ??
+        {}) as Intl.NumberFormatOptions;
     return new Intl.NumberFormat(navigator.languages as string[], opts);
 }
 
 export function createDatetimeFormatter(
     cfg?: DateFormatConfig,
 ): Intl.DateTimeFormat {
-    if (!cfg || cfg.format !== "custom") {
+    if (!cfg || !("format" in cfg)) {
+        const preset = simple_config(cfg);
         const opts: Intl.DateTimeFormatOptions = {
-            timeZone: cfg?.timeZone,
+            timeZone: preset?.timeZone ?? undefined,
             dateStyle:
-                cfg?.dateStyle === "disabled"
+                preset?.dateStyle === "disabled"
                     ? undefined
-                    : (cfg?.dateStyle ?? DATETIME_LEGACY_DEFAULTS.dateStyle),
+                    : (preset?.dateStyle ?? DATETIME_LEGACY_DEFAULTS.dateStyle),
             timeStyle:
-                cfg?.timeStyle === "disabled"
+                preset?.timeStyle === "disabled"
                     ? undefined
-                    : (cfg?.timeStyle ?? DATETIME_LEGACY_DEFAULTS.timeStyle),
+                    : (preset?.timeStyle ?? DATETIME_LEGACY_DEFAULTS.timeStyle),
         };
 
         return new Intl.DateTimeFormat(navigator.languages as string[], opts);
     }
 
+    // Per-part fields are the shared `CustomDatetimeFormat` enum; the
+    // editor only writes each part's `Intl`-valid subset, so the
+    // narrowing casts below are presentation-only.
     const opts: Intl.DateTimeFormatOptions = {
-        timeZone: cfg.timeZone,
+        timeZone: cfg.timeZone ?? undefined,
         hour12: cfg.hour12 ?? true,
-        fractionalSecondDigits: cfg.fractionalSecondDigits,
+        fractionalSecondDigits: cfg.fractionalSecondDigits as
+            | 1
+            | 2
+            | 3
+            | undefined,
     };
     if (cfg.year !== "disabled") {
-        opts.year = cfg.year ?? "2-digit";
+        opts.year = (cfg.year ??
+            "2-digit") as Intl.DateTimeFormatOptions["year"];
     }
     if (cfg.month !== "disabled") {
-        opts.month = cfg.month ?? "numeric";
+        opts.month = (cfg.month ??
+            "numeric") as Intl.DateTimeFormatOptions["month"];
     }
     if (cfg.day !== "disabled") {
-        opts.day = cfg.day ?? "numeric";
+        opts.day = (cfg.day ?? "numeric") as Intl.DateTimeFormatOptions["day"];
     }
     if (cfg.weekday && cfg.weekday !== "disabled") {
-        opts.weekday = cfg.weekday;
+        opts.weekday = cfg.weekday as Intl.DateTimeFormatOptions["weekday"];
     }
     if (cfg.hour !== "disabled") {
-        opts.hour = cfg.hour ?? "numeric";
+        opts.hour = (cfg.hour ??
+            "numeric") as Intl.DateTimeFormatOptions["hour"];
     }
     if (cfg.minute !== "disabled") {
-        opts.minute = cfg.minute ?? "numeric";
+        opts.minute = (cfg.minute ??
+            "numeric") as Intl.DateTimeFormatOptions["minute"];
     }
     if (cfg.second !== "disabled") {
-        opts.second = cfg.second ?? "numeric";
+        opts.second = (cfg.second ??
+            "numeric") as Intl.DateTimeFormatOptions["second"];
     }
     return new Intl.DateTimeFormat(navigator.languages as string[], opts);
 }
@@ -141,12 +161,13 @@ export function createDatetimeFormatter(
 export function createDateFormatter(
     cfg?: DateFormatConfig,
 ): Intl.DateTimeFormat {
+    const preset = simple_config(cfg);
     const opts: Intl.DateTimeFormatOptions = {
         timeZone: "utc",
         dateStyle:
-            cfg?.dateStyle === "disabled"
+            preset?.dateStyle === "disabled"
                 ? undefined
-                : (cfg?.dateStyle ?? DATE_LEGACY_DEFAULTS.dateStyle),
+                : (preset?.dateStyle ?? DATE_LEGACY_DEFAULTS.dateStyle),
     };
     return new Intl.DateTimeFormat(navigator.languages as string[], opts);
 }

package/src/ts/perspective-viewer.ts

@@ -35,6 +35,8 @@ import "regular-layout";
 
 export { IPerspectiveViewerPlugin } from "./plugin";
 export { HTMLPerspectiveViewerPluginElement } from "./plugin";
+export { providers } from "./providers";
+export type { AgentProviderPreset } from "./providers";
 
 export {
     createNumberFormatter,

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,6 +5,7 @@ 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";
 
@@ -13,4 +14,49 @@ import type { JsonValue } from "./serde_json/JsonValue.js";
  * element-level `settings` flag. This is the `panels` entry type of the
  * whole-element 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, };