drizzle-cube 0.8.2 → 0.9.0

package/dist/adapters/utils.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-C1JpSDOX.cjs");exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.S,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-DXWQUJbD.cjs");exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.x,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;

package/dist/adapters/utils.js

@@ -1,2 +1,2 @@
-import { S as e, a as t, c as n, d as r, f as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-BhlkVCzZ.js";
-export { m as buildTransformedQuery, l as calculateQueryComplexity, f as formatCubeResponse, o as formatErrorResponse, t as formatMetaResponse, u as formatSqlResponse, e as formatSqlString, p as generateRequestId, n as getDatabaseType, s as handleBatchRequest, d as handleDiscover, h as handleDryRun, c as handleLoad, r as handleSuggest, i as handleValidate, a as normalizeQueryFields };
+import { a as e, c as t, d as n, f as r, h as i, i as a, l as o, m as s, n as c, o as l, p as u, r as d, s as f, t as p, u as m, x as h } from "./utils-C_RKaP0n.js";
+export { p as buildTransformedQuery, c as calculateQueryComplexity, d as formatCubeResponse, a as formatErrorResponse, e as formatMetaResponse, l as formatSqlResponse, h as formatSqlString, f as generateRequestId, t as getDatabaseType, o as handleBatchRequest, u as handleDiscover, m as handleDryRun, s as handleLoad, n as handleSuggest, r as handleValidate, i as normalizeQueryFields };

package/dist/cjs/client/components/AgenticNotebook/chatMessageParts.d.ts

@@ -1,7 +1,5 @@
 import { default as React } from 'react';
 import { ChatMessage as ChatMessageType, ToolCallRecord } from '../../stores/notebookStore.js';
-/** Simple inline markdown parser for bold, italic, and code in chat text */
-export declare function renderInlineMarkdown(text: string): React.ReactNode[];
 /** Compute the bubble background/text classes for a message. */
 export declare function getBubbleClass(isUser: boolean, hasError: boolean, hasContent: boolean): string;
 export declare function ToolCallIndicator({ toolCall, loadingComponent, }: {

package/dist/cjs/client/components/PortletGroupCard.d.ts

@@ -14,5 +14,7 @@ export interface PortletGroupCardProps {
     onChildDragEnd: () => void;
     /** Snap bands rendered inside each child; supplied by the row layout. */
     renderSnapBands?: (portletId: string) => ReactNode;
+    /** Set inside a section card, which draws the only frame for the whole band. */
+    frameless?: boolean;
 }
-export default function PortletGroupCard({ group, portlets, canEdit, renderChild, onRename, onUngroup, onDelete, onChildDragStart, onChildDragEnd, renderSnapBands }: PortletGroupCardProps): import("react").JSX.Element;
+export default function PortletGroupCard({ group, portlets, canEdit, renderChild, onRename, onUngroup, onDelete, onChildDragStart, onChildDragEnd, renderSnapBands, frameless }: PortletGroupCardProps): import("react").JSX.Element;

package/dist/cjs/client/components/RowManagedLayout.d.ts

@@ -1,6 +1,7 @@
 import { HTMLAttributes, ReactNode, MouseEvent, DragEvent } from 'react';
 import { DashboardGridSettings, PortletConfig, PortletGroup, RowLayout } from '../types.js';
 import { SnapEdge } from '../hooks/dashboard/groupUtils.js';
+import { PortletCardVariant } from './dashboardPortletCard/cardStyles.js';
 interface RowManagedLayoutProps {
     rows: RowLayout[];
     portlets: PortletConfig[];
@@ -23,9 +24,11 @@ interface RowManagedLayoutProps {
     draggingPortletId?: string | null;
     /** Id of the group currently being dragged, so its members ignore their bands. */
     draggingGroupId?: string | null;
-    renderPortlet: (portlet: PortletConfig, containerProps?: HTMLAttributes<HTMLDivElement>, headerProps?: HTMLAttributes<HTMLDivElement>) => ReactNode;
+    renderPortlet: (portlet: PortletConfig, containerProps?: HTMLAttributes<HTMLDivElement>, headerProps?: HTMLAttributes<HTMLDivElement>, variant?: PortletCardVariant) => ReactNode;
     /** Renders a group column. Omitted in contexts that have no groups. */
-    renderGroup?: (group: PortletGroup, renderSnapBands: (portletId: string) => ReactNode) => ReactNode;
+    renderGroup?: (group: PortletGroup, renderSnapBands: (portletId: string) => ReactNode, 
+    /** Set inside a section, where the section card draws the only frame. */
+    frameless?: boolean) => ReactNode;
 }
 export default function RowManagedLayout({ rows, portlets, groups, gridSettings, gridWidth, canEdit, isDragging, onRowResize, onColumnResize, onPortletDragStart, onPortletDragEnd, onRowDrop, onNewRowDrop, onSnapDrop, draggingPortletId, draggingGroupId, renderPortlet, renderGroup }: RowManagedLayoutProps): import("react").JSX.Element;
 export {};

package/dist/cjs/client/components/dashboardPortletCard/cardStyles.d.ts

@@ -1,7 +1,11 @@
 import { CSSProperties } from 'react';
 import { ChartType, ChartDisplayConfig } from '../../types.js';
-/** How much chrome a card draws. Group children are frameless and headerless. */
-export type PortletCardVariant = 'standalone' | 'groupChild';
+/**
+ * How much chrome a card draws. Group children are frameless and headerless;
+ * section children are frameless but otherwise behave like standalone cards,
+ * because the section card around them supplies the only frame.
+ */
+export type PortletCardVariant = 'standalone' | 'groupChild' | 'sectionChild';
 export interface PortletDisplayModes {
     isMarkdownAutoHeight: boolean;
     isTransparentContent: boolean;
@@ -28,7 +32,7 @@ export declare function buildContainerClassName(params: {
     extraClassName?: string;
     variant?: PortletCardVariant;
 }): string;
-export declare function buildHeaderClassName(isEditMode: boolean, extraClassName?: string): string;
+export declare function buildHeaderClassName(isEditMode: boolean, extraClassName?: string, variant?: PortletCardVariant): string;
 export declare function buildContainerStyle(params: {
     isTransparent: boolean;
     isInSelectionMode: boolean;

package/dist/cjs/client/components/markdownOverrides.d.ts

@@ -0,0 +1,202 @@
+import { default as React } from 'react';
+/** Scrollable table wrapper so wide tables don't overflow their container */
+export declare function ScrollableTable({ children, ...props }: React.HTMLAttributes<HTMLTableElement>): React.JSX.Element;
+/** Notebook canvas blocks — roomy, distinct heading sizes. */
+export declare const NOTEBOOK_MARKDOWN_OPTIONS: {
+    overrides: {
+        code: {
+            props: {
+                className: string;
+            };
+        };
+        pre: {
+            props: {
+                className: string;
+            };
+        };
+        a: {
+            props: {
+                className: string;
+                target: string;
+                rel: string;
+            };
+        };
+        table: {
+            component: typeof ScrollableTable;
+            props: {
+                className: string;
+            };
+        };
+        thead: {
+            props: {
+                className: string;
+            };
+        };
+        th: {
+            props: {
+                className: string;
+            };
+        };
+        td: {
+            props: {
+                className: string;
+            };
+        };
+        tr: {
+            props: {
+                className: string;
+            };
+        };
+        h1: {
+            props: {
+                className: string;
+            };
+        };
+        h2: {
+            props: {
+                className: string;
+            };
+        };
+        h3: {
+            props: {
+                className: string;
+            };
+        };
+        p: {
+            props: {
+                className: string;
+            };
+        };
+        strong: {
+            props: {
+                className: string;
+            };
+        };
+        ul: {
+            props: {
+                className: string;
+            };
+        };
+        ol: {
+            props: {
+                className: string;
+            };
+        };
+        li: {
+            props: {
+                className: string;
+            };
+        };
+        hr: {
+            props: {
+                className: string;
+            };
+        };
+        blockquote: {
+            props: {
+                className: string;
+            };
+        };
+    };
+};
+/**
+ * Chat bubbles — the bubble already sets the font size, so headings only carry
+ * weight, and every block margin is tighter to suit an ~85%-width bubble.
+ */
+export declare const CHAT_MARKDOWN_OPTIONS: {
+    overrides: {
+        code: {
+            props: {
+                className: string;
+            };
+        };
+        pre: {
+            props: {
+                className: string;
+            };
+        };
+        a: {
+            props: {
+                className: string;
+                target: string;
+                rel: string;
+            };
+        };
+        table: {
+            component: typeof ScrollableTable;
+            props: {
+                className: string;
+            };
+        };
+        thead: {
+            props: {
+                className: string;
+            };
+        };
+        th: {
+            props: {
+                className: string;
+            };
+        };
+        td: {
+            props: {
+                className: string;
+            };
+        };
+        tr: {
+            props: {
+                className: string;
+            };
+        };
+        h1: {
+            props: {
+                className: string;
+            };
+        };
+        h2: {
+            props: {
+                className: string;
+            };
+        };
+        h3: {
+            props: {
+                className: string;
+            };
+        };
+        p: {
+            props: {
+                className: string;
+            };
+        };
+        strong: {
+            props: {
+                className: string;
+            };
+        };
+        ul: {
+            props: {
+                className: string;
+            };
+        };
+        ol: {
+            props: {
+                className: string;
+            };
+        };
+        li: {
+            props: {
+                className: string;
+            };
+        };
+        hr: {
+            props: {
+                className: string;
+            };
+        };
+        blockquote: {
+            props: {
+                className: string;
+            };
+        };
+    };
+};

package/dist/cjs/client/components/rowManagedLayout/sections.d.ts

@@ -0,0 +1,46 @@
+import { PortletConfig, RowLayout } from '../../types.js';
+/** A markdown portlet that sizes itself to its content - the shape of a header. */
+export declare function isAutoHeightMarkdownPortlet(portlet: PortletConfig): boolean;
+/**
+ * A row sizes itself to its content only when every column is a markdown
+ * portlet asking for it. A group column has an explicit height, so it never
+ * auto-heights.
+ */
+export declare function isAutoHeightRow(row: RowLayout, portletMap: Map<string, PortletConfig>): boolean;
+/**
+ * A section header is a lone full-width auto-height markdown row.
+ *
+ * The width test matters: a single column is not automatically full width, and
+ * one narrower than `cols` renders as a partial-width card that shouldn't
+ * capture the rows below it. `normalizeRows` -> `adjustRowWidths` guarantees a
+ * row's columns sum to exactly `cols`, so a lone column does reach it.
+ */
+export declare function isSectionHeaderRow(row: RowLayout, portletMap: Map<string, PortletConfig>, cols: number): boolean;
+/**
+ * True when the header already draws its own line along its bottom edge -
+ * either the `accentBorder: 'bottom'` display option, or markdown content
+ * ending in a horizontal rule.
+ *
+ * Such a header separates itself from the section body, so the section must not
+ * draw its own divider underneath as well: two parallel lines a few pixels
+ * apart is the thing this whole feature exists to avoid.
+ */
+export declare function headerHasBottomRule(portlet: PortletConfig): boolean;
+export type RowBand = 
+/** A row that belongs to no section, drawn exactly as it always has been. */
+{
+    kind: 'loose';
+    rowIndex: number;
+} | {
+    kind: 'section';
+    headerRowIndex: number;
+    bodyRowIndices: number[];
+};
+/**
+ * Split `rows` into bands top-down. Rows before the first header stay loose,
+ * and a header with nothing beneath it stays loose too - a trailing markdown
+ * note is a note, not an empty section card.
+ */
+export declare function computeRowBands(rows: RowLayout[], portletMap: Map<string, PortletConfig>, cols: number): RowBand[];
+/** True when at least one section would be drawn - lets callers skip the wrapper entirely. */
+export declare function hasSection(bands: RowBand[]): boolean;

package/dist/cjs/client/hooks/agentChatStream.d.ts

@@ -2,12 +2,13 @@ import { PortletBlock, MarkdownBlock } from '../stores/notebookStore.js';
 /** Clean up raw API errors into user-friendly messages */
 export declare function formatUserFacingError(message: string): string;
 export interface AgentSSEEvent {
-    type: 'text_delta' | 'tool_use_start' | 'tool_use_result' | 'add_portlet' | 'add_markdown' | 'dashboard_saved' | 'turn_complete' | 'done' | 'error';
+    type: 'text_delta' | 'tool_use_start' | 'tool_use_result' | 'add_portlet' | 'update_portlet' | 'add_markdown' | 'dashboard_saved' | 'turn_complete' | 'done' | 'error';
     data: any;
 }
 /** Subset of the hook options that handleAgentEvent dispatches to. */
 export interface AgentEventCallbacks {
     onAddPortlet: (data: PortletBlock) => void;
+    onUpdatePortlet?: (data: PortletBlock) => void;
     onAddMarkdown: (data: MarkdownBlock) => void;
     onDashboardSaved?: (data: {
         title: string;
@@ -16,7 +17,7 @@ export interface AgentEventCallbacks {
     }) => void;
     onTextDelta: (text: string) => void;
     onToolStart: (id: string, name: string, input?: unknown) => void;
-    onToolResult: (id: string, name: string, result?: unknown, isError?: boolean) => void;
+    onToolResult: (id: string, name: string, result?: unknown, isError?: boolean, input?: unknown) => void;
     onDone: (sessionId: string, traceId?: string) => void;
     onTurnComplete?: () => void;
     onError: (message: string) => void;

package/dist/cjs/client/hooks/useAgentChat.d.ts

@@ -12,6 +12,7 @@ export interface UseAgentChatOptions {
     agentProviderEndpoint?: string;
     /** Called when agent adds a portlet to the notebook */
     onAddPortlet: (data: PortletBlock) => void;
+    onUpdatePortlet?: (data: PortletBlock) => void;
     /** Called when agent adds a markdown block to the notebook */
     onAddMarkdown: (data: MarkdownBlock) => void;
     /** Called when the agent saves a dashboard configuration */

package/dist/cjs/server/agent/agent-prompts.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Notebook-agent prompt fragments.
+ *
+ * The agent used to inline `MCP_GUIDE_PROMPT` from `../ai/mcp-prompts.js`, which
+ * documents the MCP transport's `discover` / `validate` / `load` tools. Those
+ * are real tools — over MCP. The notebook agent has a different set entirely, so
+ * the guide was naming tools it cannot call.
+ *
+ * `MCP_GUIDE_PROMPT` stays as it is: it is a public export and is served through
+ * `ALL_PROMPTS`, so real MCP clients depend on it. This is the agent's own copy.
+ * `QUERY_LANGUAGE_PROMPT` and `DATE_FILTERING_PROMPT` remain shared — they name
+ * no tools and are correct for both.
+ */
+export declare const AGENT_WORKFLOW_GUIDE: string;

package/dist/cjs/server/agent/chart-validation.d.ts

@@ -13,6 +13,20 @@ interface ValidationResult {
  * Validate chartConfig against the chart type's drop zone requirements.
  */
 export declare function validateChartConfig(chartType: string, chartConfig: Record<string, unknown> | undefined, query: Record<string, unknown>): ValidationResult;
+/**
+ * Pick a chart type that can actually render the query.
+ *
+ * A `bar` over a measures-only query has no category axis: `resolveChartAxisFields`
+ * reports `axisInvalid` and the portlet renders a config-error card. Rejecting it
+ * instead costs the model a full query+portlet rebuild, so swap to a type that
+ * shows the same numbers and tell it what happened.
+ *
+ * The note is model-facing, not user-facing, so it is deliberately not translated.
+ */
+export declare function resolveChartTypeFallback(chartType: string, chartConfig: Record<string, unknown> | undefined, query: Record<string, unknown>): {
+    chartType: string;
+    note?: string;
+};
 export declare function inferChartConfig(chartType: string, chartConfig: Record<string, unknown> | undefined, query: Record<string, unknown>): Record<string, unknown>;
 /**
  * Build per-chart-type requirements text for the agent tool description.

package/dist/cjs/server/agent/data-shape.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Data-shape summary for the agent's `execute_query` results.
+ *
+ * The agent used to receive every row and no summary, so it chose a chart type
+ * blind and then spent its context — and its output-token budget — on raw data.
+ * A per-field summary is what the chart decision actually needs: how many
+ * distinct categories there are, and whether measures share a scale.
+ */
+/** How many rows of the result set are handed back to the model. */
+export declare const AGENT_RESULT_ROW_LIMIT = 25;
+/** Per-field summary of a query result. */
+export interface FieldShape {
+    field: string;
+    kind: 'measure' | 'dimension' | 'timeDimension';
+    type?: string;
+    /** Distinct non-null values seen. Capped at the rows inspected. */
+    distinctCount: number;
+    nullCount: number;
+    /** Numeric range, present only when every non-null value is a number. */
+    min?: number;
+    max?: number;
+}
+interface ResultAnnotation {
+    measures?: Record<string, {
+        type?: string;
+    }>;
+    dimensions?: Record<string, {
+        type?: string;
+    }>;
+    timeDimensions?: Record<string, {
+        type?: string;
+    }>;
+}
+/**
+ * Build a per-field summary of a query result.
+ *
+ * Computed from the rows handed to the model, so `distinctCount` is a floor
+ * rather than an exact count when the result was truncated.
+ */
+export declare function summariseDataShape(rows: Record<string, unknown>[], annotation: ResultAnnotation | undefined): FieldShape[];
+export {};

package/dist/cjs/server/agent/providers/anthropic.d.ts

@@ -20,5 +20,6 @@ export declare class AnthropicProvider implements LLMProvider {
     };
     formatToolResults(results: ToolResult[]): unknown;
     shouldContinue(stopReason: string): boolean;
+    isTruncated(stopReason: string): boolean;
     formatError(error: unknown): string;
 }

package/dist/cjs/server/agent/providers/google.d.ts

@@ -19,5 +19,6 @@ export declare class GoogleProvider implements LLMProvider {
     };
     formatToolResults(results: ToolResult[]): unknown;
     shouldContinue(stopReason: string): boolean;
+    isTruncated(stopReason: string): boolean;
     formatError(error: unknown): string;
 }

package/dist/cjs/server/agent/providers/openai.d.ts

@@ -22,5 +22,6 @@ export declare class OpenAIProvider implements LLMProvider {
     };
     formatToolResults(results: ToolResult[]): unknown[];
     shouldContinue(stopReason: string): boolean;
+    isTruncated(stopReason: string): boolean;
     formatError(error: unknown): string;
 }

package/dist/cjs/server/agent/providers/types.d.ts

@@ -31,6 +31,12 @@ export interface ContentBlock {
     input?: Record<string, unknown>;
     /** Provider-specific metadata (e.g. Gemini thoughtSignature) */
     metadata?: Record<string, unknown>;
+    /**
+     * Set when the tool-call arguments could not be parsed as JSON. The handler
+     * returns an error tool_result instead of executing the tool with an empty
+     * input — running on `{}` silently produced empty notebook blocks.
+     */
+    inputParseError?: boolean;
 }
 export interface ToolResult {
     toolUseId: string;
@@ -58,6 +64,7 @@ export type NormalizedEvent = {
     type: 'tool_use_end';
     id?: string;
     input?: Record<string, unknown>;
+    parseError?: boolean;
 } | {
     type: 'message_meta';
     inputTokens?: number;
@@ -90,6 +97,12 @@ export interface LLMProvider {
     formatToolResults(results: ToolResult[]): unknown;
     /** Return true if the stop reason means the model wants to continue (tool use). */
     shouldContinue(stopReason: string): boolean;
+    /**
+     * Return true if the stop reason means the response was cut off by the output
+     * token limit rather than finished. Without this the loop breaks silently and
+     * the notebook just stops mid-analysis.
+     */
+    isTruncated(stopReason: string): boolean;
     /** Format a provider-specific error into a user-friendly message. */
     formatError(error: unknown): string;
 }

package/dist/cjs/server/agent/tools.d.ts

@@ -1,3 +1,4 @@
+import { BuiltInChartType } from '../../client/types.js';
 import { SemanticLayerCompiler } from '../compiler.js';
 import { SecurityContext } from '../types/index.js';
 import { AgentSSEEvent } from './types.js';
@@ -13,15 +14,28 @@ export interface ToolExecutionResult {
     /** Optional SSE event to emit as a side effect (add_portlet, add_markdown) */
     sideEffect?: AgentSSEEvent;
 }
+/**
+ * Chart types the notebook agent may create — an explicit list, not a derived
+ * one, so widening it stays a product decision. It now covers every
+ * `BuiltInChartType`: the config each one needs is expressible through the
+ * `add_portlet` chartConfig/displayConfig schema below, and a narrower list was
+ * making the agent reach for `bar` and `table` for everything.
+ *
+ * Two carry caveats the system prompt spells out rather than the schema:
+ * `gauge` needs an explicit `maxValue` (it otherwise scales to the data and
+ * reads as 100%), and `candlestick` needs its measures in OHLC order, which
+ * JSON Schema cannot express.
+ *
+ * Typed against `BuiltInChartType` (type-only import — no runtime dependency on
+ * the client graph) so a renamed or removed chart type fails `npm run typecheck`
+ * here instead of silently offering the model a type that no longer renders.
+ */
+export declare const AGENT_ALLOWED_CHART_TYPES: BuiltInChartType[];
 /**
  * Returns the array of tool definitions for the Anthropic Messages API.
  * Plain JSON schema — no Zod dependency.
  */
 export declare function getToolDefinitions(): ToolDefinition[];
-/**
- * Create a tool executor map that closes over the semantic layer and security context.
- * Returns a Map<toolName, handler> where each handler takes parsed input and returns a result.
- */
 export declare function createToolExecutor(options: {
     semanticLayer: SemanticLayerCompiler;
     securityContext: SecurityContext;

package/dist/cjs/server/agent/types.d.ts

@@ -100,7 +100,7 @@ export interface AgentConfig {
     model?: string;
     /** Maximum agentic turns per request (default: 25) */
     maxTurns?: number;
-    /** Maximum tokens per response (default: 4096) */
+    /** Maximum tokens per response (default: 8192) */
     maxTokens?: number;
     /** Allow X-Agent-Api-Key header to override server apiKey */
     allowClientApiKey?: boolean;
@@ -163,12 +163,16 @@ export type AgentSSEEvent = {
     data: {
         id: string;
         name: string;
+        input?: unknown;
         result?: unknown;
         isError?: boolean;
     };
 } | {
     type: 'add_portlet';
     data: PortletBlockData;
+} | {
+    type: 'update_portlet';
+    data: PortletBlockData;
 } | {
     type: 'add_markdown';
     data: MarkdownBlockData;

package/dist/cjs/server/ai/chart-schema.d.ts

@@ -11,6 +11,43 @@
  * never guessed from the data, so a model that cannot see this shape produces a
  * listing of unformatted strings.
  */
+/**
+ * `chartConfig` fields for the charts whose mandatory drop zones are not the
+ * usual axes. Without these the model cannot state them at all: `heatmap` needs
+ * a `valueField` to colour its cells, and `activityGrid` lays itself out from a
+ * date field plus a value field. Both were only ever filled by inference.
+ */
+export declare const FIELD_ZONE_CHART_CONFIG_SCHEMA: {
+    readonly valueField: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "heatmap and activityGrid: single measure driving cell colour intensity. Required for both — the chart renders empty without it.";
+    };
+    readonly dateField: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "activityGrid only: single time dimension laying out the grid. Query it with day granularity over several months, or the grid has nothing to show.";
+    };
+};
+/** `displayConfig` fields for charts that need an explicit scale or template. */
+export declare const SCALE_DISPLAY_CONFIG_SCHEMA: {
+    readonly minValue: {
+        readonly type: "number";
+        readonly description: "gauge only: scale minimum (defaults to 0).";
+    };
+    readonly maxValue: {
+        readonly type: "number";
+        readonly description: "gauge only: scale maximum. ALWAYS set this — without it the gauge scales to the data it was given, so a single value always reads as 100%.";
+    };
+    readonly template: {
+        readonly type: "string";
+        readonly description: "kpiText only: sentence template around the value, e.g. \"${fieldLabel}: ${value}\". Defaults to that if omitted.";
+    };
+};
 /** `chartConfig` fields specific to the records table. */
 export declare const RECORDS_TABLE_CHART_CONFIG_SCHEMA: {
     readonly columns: {

package/dist/client/charts.js

@@ -1,14 +1,14 @@
-import { dt as e, ft as t, gt as n, ht as r, lt as i, mt as a, pt as o, t as s, ut as c } from "./chunks/chart-data-table-Cou9qOab.js";
-import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-CJzxC18G.js";
-import { t as p } from "./chunks/chart-funnel-B0775aaT.js";
-import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-tCSbqT7H.js";
-import { t as x } from "./chunks/chart-area-C66dgy84.js";
+import { dt as e, ft as t, gt as n, ht as r, lt as i, mt as a, pt as o, t as s, ut as c } from "./chunks/chart-data-table-CCvvgeG_.js";
+import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-UZIp9_2E.js";
+import { t as p } from "./chunks/chart-funnel-D2vGQhaz.js";
+import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-OHpTBq8c.js";
+import { t as x } from "./chunks/chart-area-CEBcvCcn.js";
 import { i as S } from "./chunks/utils-CToHkuhU.js";
-import { t as C } from "./chunks/chart-bar-D9kiSOCT.js";
-import { t as w } from "./chunks/chart-line-IwXqPY80.js";
-import { t as T } from "./chunks/chart-pie-LDJfDXfX.js";
-import { t as E } from "./chunks/chart-scatter-DP-nn9hH.js";
-import { t as D } from "./chunks/chart-radar-BZY6TP9m.js";
-import { t as O } from "./chunks/chart-radial-bar-aga05X7h.js";
-import { t as k } from "./chunks/chart-tree-map-C3O6uQcP.js";
+import { t as C } from "./chunks/chart-bar-DGh7cpU-.js";
+import { t as w } from "./chunks/chart-line-C4r44HWi.js";
+import { t as T } from "./chunks/chart-pie-BHrPxga2.js";
+import { t as E } from "./chunks/chart-scatter-BHttSxcc.js";
+import { t as D } from "./chunks/chart-radar-I9sOFbG5.js";
+import { t as O } from "./chunks/chart-radial-bar-DeDMMf9P.js";
+import { t as k } from "./chunks/chart-tree-map-CdSwr_zI.js";
 export { d as CHART_COLORS, u as CHART_MARGINS, s as DataTable, p as FunnelChart, b as LazyChart, f as NEGATIVE_COLOR, l as POSITIVE_COLOR, x as RechartsAreaChart, C as RechartsBarChart, w as RechartsLineChart, T as RechartsPieChart, D as RechartsRadarChart, O as RechartsRadialBarChart, E as RechartsScatterChart, k as RechartsTreeMapChart, i as clearChartConfigCache, S as formatChartData, g as getAvailableChartTypes, c as getChartConfigAsync, e as getChartConfigSync, v as getUnavailableChartTypes, t as isChartConfigLoaded, h as isChartTypeAvailable, m as isValidChartType, o as loadAllChartConfigs, _ as preloadChart, a as preloadChartConfig, r as preloadChartConfigs, y as preloadCharts, n as useChartConfig };