@sqlrooms/mosaic 0.29.0-rc.2 → 0.29.0-rc.4

package/dist/dashboard/MosaicDashboardSlice.d.ts

@@ -1,28 +1,462 @@
 import { DbSliceState } from '@sqlrooms/db';
-import { type DuckDbSliceState } from '@sqlrooms/duckdb';
-import type { LayoutMosaicSubNode } from '@sqlrooms/layout-config';
-import { LayoutSliceState } from '@sqlrooms/layout';
+import { type DataTable, type DuckDbSliceState } from '@sqlrooms/duckdb';
+import { type LayoutSliceState } from '@sqlrooms/layout';
+import { type LayoutNode } from '@sqlrooms/layout-config';
 import { BaseRoomStoreState, SliceFunctions } from '@sqlrooms/room-store';
+import type { ComponentType } from 'react';
 import { z } from 'zod';
+import type { ChartTypeDefinition } from '../chart-types/base-types';
 import { type MosaicSliceState } from '../MosaicSlice';
-export declare const DEFAULT_MOSAIC_DASHBOARD_CHART_VGPLOT: string;
-export declare const DEFAULT_MOSAIC_DASHBOARD_CHART_SPEC: Record<string, unknown>;
-export declare const MosaicDashboardChartConfig: z.ZodObject<{
+import { type RetainedVgPlotChart } from '../VgPlotChart';
+import { ChartConfig } from '../chart-types/chart-config';
+/**
+ * Panel key used for function-form panel definitions registered by
+ * `MosaicDashboardPanels`. Individual dashboard panels are represented as
+ * `LayoutPanelNode` entries whose `panel` property carries
+ * `{ key: MOSAIC_DASHBOARD_PANEL, meta: { dashboardId, panelId } }`.
+ */
+export declare const MOSAIC_DASHBOARD_PANEL = "mosaic-dashboard-panel";
+export declare const MOSAIC_DASHBOARD_CHART_PANEL_TYPE = "vgplot";
+export declare const MOSAIC_DASHBOARD_PROFILER_PANEL_TYPE = "profiler";
+export declare const MOSAIC_DASHBOARD_TEXT_PANEL_TYPE = "text";
+export declare const MosaicDashboardLayoutType: z.ZodEnum<{
+    grid: "grid";
+    dock: "dock";
+}>;
+export type MosaicDashboardLayoutType = z.infer<typeof MosaicDashboardLayoutType>;
+export declare const MosaicDashboardPanelSource: z.ZodObject<{
+    tableName: z.ZodOptional<z.ZodString>;
+    sqlQuery: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MosaicDashboardPanelSource = z.infer<typeof MosaicDashboardPanelSource>;
+export declare const ProfilerPanelConfig: z.ZodObject<{
+    pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ProfilerPanelConfig = z.infer<typeof ProfilerPanelConfig>;
+export declare const TextPanelConfig: z.ZodObject<{
+    content: z.ZodDefault<z.ZodString>;
+    toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+    sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TextPanelConfig = z.infer<typeof TextPanelConfig>;
+export declare const ChartPanelConfig: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"vgplot">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        chartType: z.ZodLiteral<"histogram">;
+        settings: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"count-plot">;
+        settings: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"line-chart">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            xInterval: z.ZodOptional<z.ZodEnum<{
+                second: "second";
+                minute: "minute";
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
+            yFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                color: z.ZodOptional<z.ZodString>;
+                aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                    sum: "sum";
+                    max: "max";
+                    min: "min";
+                    avg: "avg";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"bubble-chart">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            y: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"heatmap">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            y: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"box-plot">;
+        settings: z.ZodObject<{
+            x: z.ZodString;
+            y: z.ZodString;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"custom-spec">;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        settings: z.ZodObject<{
+            vgPlotSpec: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "chartType">, z.ZodObject<{
+        chartType: z.ZodString;
+        settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+export type ChartPanelConfig = z.infer<typeof ChartPanelConfig>;
+export declare const ProfilerPanel: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"profiler">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodObject<{
+        pageSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ProfilerPanel = z.infer<typeof ProfilerPanel>;
+export declare const TextPanel: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"text">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodObject<{
+        content: z.ZodDefault<z.ZodString>;
+        toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+        sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TextPanel = z.infer<typeof TextPanel>;
+export declare const LegacyPanelConfig: z.ZodObject<{
     id: z.ZodString;
+    type: z.ZodString;
     title: z.ZodDefault<z.ZodString>;
-    vgplot: z.ZodDefault<z.ZodObject<{}, z.core.$loose>>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-export type MosaicDashboardChartConfig = z.infer<typeof MosaicDashboardChartConfig>;
+export type LegacyPanelConfig = z.infer<typeof LegacyPanelConfig>;
+export declare const MosaicDashboardPanelConfig: z.ZodUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"vgplot">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        chartType: z.ZodLiteral<"histogram">;
+        settings: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"count-plot">;
+        settings: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"line-chart">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            xInterval: z.ZodOptional<z.ZodEnum<{
+                second: "second";
+                minute: "minute";
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
+            yFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                color: z.ZodOptional<z.ZodString>;
+                aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                    sum: "sum";
+                    max: "max";
+                    min: "min";
+                    avg: "avg";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"bubble-chart">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            y: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"heatmap">;
+        settings: z.ZodObject<{
+            x: z.ZodOptional<z.ZodString>;
+            y: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"box-plot">;
+        settings: z.ZodObject<{
+            x: z.ZodString;
+            y: z.ZodString;
+        }, z.core.$strip>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        chartType: z.ZodLiteral<"custom-spec">;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        settings: z.ZodObject<{
+            vgPlotSpec: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "chartType">, z.ZodObject<{
+        chartType: z.ZodString;
+        settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"profiler">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodObject<{
+        pageSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"text">;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodObject<{
+        content: z.ZodDefault<z.ZodString>;
+        toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+        sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    title: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        tableName: z.ZodOptional<z.ZodString>;
+        sqlQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+export type MosaicDashboardPanelConfig = z.infer<typeof MosaicDashboardPanelConfig>;
+export type MosaicDashboardPanelRendererProps<TPanel extends MosaicDashboardPanelConfig = MosaicDashboardPanelConfig> = {
+    dashboardId: string;
+    dashboard: MosaicDashboardEntry;
+    panel: TPanel;
+    selectionName: string;
+    resolvedSource?: MosaicDashboardPanelSource;
+};
+export type ChartPanelRendererProps = MosaicDashboardPanelRendererProps<ChartPanelConfig>;
+export type ProfilerPanelRendererProps = MosaicDashboardPanelRendererProps<ProfilerPanel>;
+export type TextPanelRendererProps = MosaicDashboardPanelRendererProps<TextPanel>;
+export type MosaicDashboardPanelRenderer<TPanel extends MosaicDashboardPanelConfig = MosaicDashboardPanelConfig> = {
+    component: ComponentType<MosaicDashboardPanelRendererProps<TPanel>>;
+    headerActions?: ComponentType<MosaicDashboardPanelRendererProps<TPanel>>;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+};
+export type AnyPanelRenderer = {
+    component: ComponentType<any>;
+    headerActions?: ComponentType<any>;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+};
+export type PanelTypeMap = {
+    [MOSAIC_DASHBOARD_CHART_PANEL_TYPE]: ChartPanelConfig;
+    [MOSAIC_DASHBOARD_PROFILER_PANEL_TYPE]: ProfilerPanel;
+    [MOSAIC_DASHBOARD_TEXT_PANEL_TYPE]: TextPanel;
+};
+export type PanelRenderersRecord = Record<string, AnyPanelRenderer>;
+export type MosaicDashboardAddPanelActionContext = {
+    dashboardId: string;
+    dashboard: MosaicDashboardEntry | undefined;
+    selectedTable: DataTable | undefined;
+    tables: DataTable[];
+};
+export type MosaicDashboardAddPanelAction = {
+    type: string;
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    isEnabled?: (context: MosaicDashboardAddPanelActionContext) => boolean;
+    createPanel: (context: MosaicDashboardAddPanelActionContext) => MosaicDashboardPanelConfig | undefined;
+};
+export declare function createMosaicDashboardPanelConfig(options: {
+    type: string;
+    title: string;
+    source?: MosaicDashboardPanelSource;
+    config?: Record<string, unknown>;
+}): MosaicDashboardPanelConfig;
+export declare function createMosaicDashboardChartPanelConfig(title: string, config: ChartConfig, source?: MosaicDashboardPanelSource): ChartPanelConfig;
+export declare function createMosaicDashboardProfilerPanelConfig(options?: {
+    title?: string;
+    source?: MosaicDashboardPanelSource;
+    pageSize?: number;
+}): MosaicDashboardPanelConfig;
+export declare function createMosaicDashboardTextPanelConfig(options?: {
+    title?: string;
+    content?: string;
+    source?: MosaicDashboardPanelSource;
+}): MosaicDashboardPanelConfig;
 export declare const MosaicDashboardEntry: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodDefault<z.ZodString>;
+    layoutType: z.ZodDefault<z.ZodEnum<{
+        grid: "grid";
+        dock: "dock";
+    }>>;
     selectedTable: z.ZodOptional<z.ZodString>;
-    charts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    panels: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
+        type: z.ZodLiteral<"vgplot">;
         title: z.ZodDefault<z.ZodString>;
-        vgplot: z.ZodDefault<z.ZodObject<{}, z.core.$loose>>;
-    }, z.core.$strip>>>;
-    layout: z.ZodDefault<z.ZodNullable<z.ZodType<LayoutMosaicSubNode, unknown, z.core.$ZodTypeInternals<LayoutMosaicSubNode, unknown>>>>;
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        config: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+            chartType: z.ZodLiteral<"histogram">;
+            settings: z.ZodObject<{
+                field: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"count-plot">;
+            settings: z.ZodObject<{
+                field: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"line-chart">;
+            settings: z.ZodObject<{
+                x: z.ZodOptional<z.ZodString>;
+                xInterval: z.ZodOptional<z.ZodEnum<{
+                    second: "second";
+                    minute: "minute";
+                    hour: "hour";
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    quarter: "quarter";
+                    year: "year";
+                }>>;
+                yFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    field: z.ZodString;
+                    color: z.ZodOptional<z.ZodString>;
+                    aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                        sum: "sum";
+                        max: "max";
+                        min: "min";
+                        avg: "avg";
+                    }>>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"bubble-chart">;
+            settings: z.ZodObject<{
+                x: z.ZodOptional<z.ZodString>;
+                y: z.ZodOptional<z.ZodString>;
+                size: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"heatmap">;
+            settings: z.ZodObject<{
+                x: z.ZodOptional<z.ZodString>;
+                y: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"box-plot">;
+            settings: z.ZodObject<{
+                x: z.ZodString;
+                y: z.ZodString;
+            }, z.core.$strip>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            chartType: z.ZodLiteral<"custom-spec">;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            settings: z.ZodObject<{
+                vgPlotSpec: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$strip>;
+        }, z.core.$strip>], "chartType">, z.ZodObject<{
+            chartType: z.ZodString;
+            settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            settingsOpen: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"profiler">;
+        title: z.ZodDefault<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        config: z.ZodObject<{
+            pageSize: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"text">;
+        title: z.ZodDefault<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        config: z.ZodObject<{
+            content: z.ZodDefault<z.ZodString>;
+            toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+            sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "type">, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodDefault<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>>>;
+    layout: z.ZodDefault<z.ZodNullable<z.ZodType<LayoutNode, unknown, z.core.$ZodTypeInternals<LayoutNode, unknown>>>>;
     updatedAt: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type MosaicDashboardEntry = z.infer<typeof MosaicDashboardEntry>;
@@ -30,13 +464,125 @@ export declare const MosaicDashboardSliceConfig: z.ZodObject<{
     dashboardsById: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         title: z.ZodDefault<z.ZodString>;
+        layoutType: z.ZodDefault<z.ZodEnum<{
+            grid: "grid";
+            dock: "dock";
+        }>>;
         selectedTable: z.ZodOptional<z.ZodString>;
-        charts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        panels: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"vgplot">;
+            title: z.ZodDefault<z.ZodString>;
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            config: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+                chartType: z.ZodLiteral<"histogram">;
+                settings: z.ZodObject<{
+                    field: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"count-plot">;
+                settings: z.ZodObject<{
+                    field: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"line-chart">;
+                settings: z.ZodObject<{
+                    x: z.ZodOptional<z.ZodString>;
+                    xInterval: z.ZodOptional<z.ZodEnum<{
+                        second: "second";
+                        minute: "minute";
+                        hour: "hour";
+                        day: "day";
+                        week: "week";
+                        month: "month";
+                        quarter: "quarter";
+                        year: "year";
+                    }>>;
+                    yFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        field: z.ZodString;
+                        color: z.ZodOptional<z.ZodString>;
+                        aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                            sum: "sum";
+                            max: "max";
+                            min: "min";
+                            avg: "avg";
+                        }>>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"bubble-chart">;
+                settings: z.ZodObject<{
+                    x: z.ZodOptional<z.ZodString>;
+                    y: z.ZodOptional<z.ZodString>;
+                    size: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"heatmap">;
+                settings: z.ZodObject<{
+                    x: z.ZodOptional<z.ZodString>;
+                    y: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"box-plot">;
+                settings: z.ZodObject<{
+                    x: z.ZodString;
+                    y: z.ZodString;
+                }, z.core.$strip>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>, z.ZodObject<{
+                chartType: z.ZodLiteral<"custom-spec">;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+                settings: z.ZodObject<{
+                    vgPlotSpec: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$strip>;
+            }, z.core.$strip>], "chartType">, z.ZodObject<{
+                chartType: z.ZodString;
+                settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                settingsOpen: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
+            type: z.ZodLiteral<"profiler">;
             title: z.ZodDefault<z.ZodString>;
-            vgplot: z.ZodDefault<z.ZodObject<{}, z.core.$loose>>;
-        }, z.core.$strip>>>;
-        layout: z.ZodDefault<z.ZodNullable<z.ZodType<LayoutMosaicSubNode, unknown, z.core.$ZodTypeInternals<LayoutMosaicSubNode, unknown>>>>;
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            config: z.ZodObject<{
+                pageSize: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"text">;
+            title: z.ZodDefault<z.ZodString>;
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            config: z.ZodObject<{
+                content: z.ZodDefault<z.ZodString>;
+                toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+                sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>], "type">, z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            title: z.ZodDefault<z.ZodString>;
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>]>>>;
+        layout: z.ZodDefault<z.ZodNullable<z.ZodType<LayoutNode, unknown, z.core.$ZodTypeInternals<LayoutNode, unknown>>>>;
         updatedAt: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
@@ -44,25 +590,59 @@ export type MosaicDashboardSliceConfig = z.infer<typeof MosaicDashboardSliceConf
 export type MosaicDashboardSliceState = {
     mosaicDashboard: SliceFunctions & {
         config: MosaicDashboardSliceConfig;
-        createDashboard: (title?: string) => string;
-        ensureDashboard: (dashboardId: string, title?: string) => void;
+        runtime: {
+            /**
+             * Live vgplot chart instances retained across transient dashboard panel
+             * remounts, keyed by `getMosaicDashboardPanelId(dashboardId, panelId)`.
+             *
+             * This is runtime-only state: entries are never serialized with dashboard
+             * config and must be evicted when their panel/dashboard lifecycle ends.
+             */
+            retainedChartsByPanelId: Record<string, RetainedVgPlotChart>;
+        };
+        chartTypes?: ChartTypeDefinition[];
+        addPanelActions: MosaicDashboardAddPanelAction[];
+        createDashboard: (title?: string, layoutType?: MosaicDashboardLayoutType) => string;
+        ensureDashboard: (dashboardId: string, title?: string, layoutType?: MosaicDashboardLayoutType) => void;
         removeDashboard: (dashboardId: string) => void;
         getDashboard: (dashboardId: string) => MosaicDashboardEntry | undefined;
         setSelectedTable: (dashboardId: string, tableName: string) => void;
-        addChart: (dashboardId: string, chart: MosaicDashboardChartConfig) => MosaicDashboardChartConfig['id'];
-        updateChart: (dashboardId: string, chartId: string, patch: Partial<Pick<MosaicDashboardChartConfig, 'title' | 'vgplot'>>) => void;
-        removeChart: (dashboardId: string, chartId: string) => void;
-        setLayout: (dashboardId: string, layout: LayoutMosaicSubNode | null) => void;
+        panelRenderers: PanelRenderersRecord;
+        registerPanelRenderer: (type: string, renderer: AnyPanelRenderer) => void;
+        unregisterPanelRenderer: (type: string) => void;
+        addPanel: (dashboardId: string, panel: MosaicDashboardPanelConfig) => MosaicDashboardPanelConfig['id'];
+        updatePanel: (dashboardId: string, panelId: string, patch: Partial<Omit<MosaicDashboardPanelConfig, 'id'>>) => void;
+        removePanel: (dashboardId: string, panelId: string) => void;
+        getRetainedChart: (dashboardId: string, panelId: string) => RetainedVgPlotChart | undefined;
+        setRetainedChart: (dashboardId: string, panelId: string, chart: RetainedVgPlotChart) => void;
+        evictPanelRuntime: (dashboardId: string, panelId: string) => void;
+        evictDashboardRuntime: (dashboardId: string, options?: {
+            resetSelection?: boolean;
+        }) => void;
+        clearAllDashboardRuntime: () => void;
+        setLayout: (dashboardId: string, layout: LayoutNode | null) => void;
     };
 };
 export type MosaicDashboardStoreState = BaseRoomStoreState & DbSliceState & DuckDbSliceState & LayoutSliceState & MosaicSliceState & MosaicDashboardSliceState;
-export declare function getMosaicDashboardPanelId(dashboardId: string, chartId: string): string;
-export declare function getMosaicDashboardMosaicId(dashboardId: string): string;
+export declare function isChartPanelConfig(panel: MosaicDashboardPanelConfig): panel is ChartPanelConfig;
+export declare function getMosaicDashboardPanelId(dashboardId: string, panelId: string): string;
+export declare function getMosaicDashboardDockId(dashboardId: string): string;
+export declare function getMosaicDashboardGridId(dashboardId: string): string;
 export declare function getMosaicDashboardSelectionName(dashboardId: string): string;
-export declare function parseMosaicDashboardChartId(dashboardId: string, panelId: string): string | undefined;
+/**
+ * Type guard to check if a panel config has a source property.
+ * All standard panel types (Chart, Profiler, Text) have optional sources.
+ */
+export declare function panelHasSource(panel: MosaicDashboardPanelConfig): panel is ChartPanelConfig | ProfilerPanel | TextPanel;
+export declare function resolveMosaicDashboardPanelSource(dashboard: MosaicDashboardEntry, panel: MosaicDashboardPanelConfig): MosaicDashboardPanelSource | undefined;
 export declare function createDefaultMosaicDashboardConfig(props?: Partial<MosaicDashboardSliceConfig>): MosaicDashboardSliceConfig;
-export declare function createMosaicDashboardSlice(props?: {
+type CreateMosaicDashboardSliceProps = {
     config?: Partial<MosaicDashboardSliceConfig>;
-}): import("zustand").StateCreator<MosaicDashboardSliceState>;
+    panelRenderers?: Record<string, MosaicDashboardPanelRenderer>;
+    addPanelActions?: MosaicDashboardAddPanelAction[];
+    chartTypes?: ChartTypeDefinition[];
+};
+export type { CreateMosaicDashboardSliceProps };
+export declare function createMosaicDashboardSlice(props?: CreateMosaicDashboardSliceProps): import("zustand").StateCreator<MosaicDashboardSliceState>;
 export declare function useStoreWithMosaicDashboard<T>(selector: (state: MosaicDashboardStoreState) => T): T;
 //# sourceMappingURL=MosaicDashboardSlice.d.ts.map