@sqlrooms/mosaic 0.29.0-rc.8 → 0.29.0-rc.9

package/dist/charts/chart-types/count-plot/validation.js

@@ -0,0 +1,20 @@
+import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
+import { isCategoricalType } from '../../../column-types-utils';
+export function validateCountPlotSettings({ dataTable, settings: { field }, }) {
+    // Basic validation for required fields
+    if (!field) {
+        throw new RequiredFieldsError('Field');
+    }
+    // Validate field existence and type
+    const fieldColumn = dataTable.columns.find((col) => col.name === field);
+    if (!fieldColumn) {
+        throw new MissingColumnsError(field);
+    }
+    if (!isCategoricalType(fieldColumn.type)) {
+        throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');
+    }
+    return {
+        fieldColumn,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/charts/chart-types/count-plot/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/validation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAO9D,MAAM,UAAU,yBAAyB,CAAC,EACxC,SAAS,EACT,QAAQ,EAAE,EAAC,KAAK,EAAC,GAC2B;IAC5C,uCAAuC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,sBAAsB,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import {CountPlotChartSettings} from './schema';\nimport {ValidateSpecOptions} from '../base-types';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {isCategoricalType} from '../../../column-types-utils';\nimport {TableColumn} from '@sqlrooms/duckdb';\n\nexport type ValidatedCountPlotSettings = {\n  fieldColumn: TableColumn;\n};\n\nexport function validateCountPlotSettings({\n  dataTable,\n  settings: {field},\n}: ValidateSpecOptions<CountPlotChartSettings>): ValidatedCountPlotSettings {\n  // Basic validation for required fields\n  if (!field) {\n    throw new RequiredFieldsError('Field');\n  }\n\n  // Validate field existence and type\n  const fieldColumn = dataTable.columns.find((col) => col.name === field);\n\n  if (!fieldColumn) {\n    throw new MissingColumnsError(field);\n  }\n\n  if (!isCategoricalType(fieldColumn.type)) {\n    throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');\n  }\n\n  return {\n    fieldColumn,\n  };\n}\n"]}

package/dist/charts/chart-types/createChartInstructions.d.ts

@@ -0,0 +1,3 @@
+import type { ChartTypeDefinition } from './base-types';
+export declare function createChartToolsInstructions(chartTypes: ChartTypeDefinition<any>[], toolNamePrefix: string): string;
+//# sourceMappingURL=createChartInstructions.d.ts.map

package/dist/charts/chart-types/createChartInstructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChartInstructions.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAGtD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,EACtC,cAAc,EAAE,MAAM,GACrB,MAAM,CAUR"}

package/dist/charts/chart-types/createChartInstructions.js

@@ -0,0 +1,12 @@
+import { getChartToolName } from './utils';
+export function createChartToolsInstructions(chartTypes, toolNamePrefix) {
+    return chartTypes
+        .filter((chartType) => chartType.createTool)
+        .map((chartType) => {
+        const toolName = getChartToolName(chartType, toolNamePrefix);
+        const description = chartType.aiDescription;
+        return `${toolName} - ${description}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=createChartInstructions.js.map

package/dist/charts/chart-types/createChartInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChartInstructions.js","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartInstructions.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAEzC,MAAM,UAAU,4BAA4B,CAC1C,UAAsC,EACtC,cAAsB;IAEtB,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;SAC3C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,SAAS,CAAC,aAAa,CAAC;QAE5C,OAAO,GAAG,QAAQ,MAAM,WAAW,EAAE,CAAC;IACxC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC","sourcesContent":["import type {ChartTypeDefinition} from './base-types';\nimport {getChartToolName} from './utils';\n\nexport function createChartToolsInstructions(\n  chartTypes: ChartTypeDefinition<any>[],\n  toolNamePrefix: string,\n): string {\n  return chartTypes\n    .filter((chartType) => chartType.createTool)\n    .map((chartType) => {\n      const toolName = getChartToolName(chartType, toolNamePrefix);\n      const description = chartType.aiDescription;\n\n      return `${toolName} - ${description}`;\n    })\n    .join('\\n');\n}\n"]}

package/dist/charts/chart-types/createChartTools.d.ts

@@ -1,17 +1,23 @@
 import type { Tool } from 'ai';
-import type { ChartTypeDefinition, DashboardToolDeps } from './base-types';
+import type { ChartTypeDefinition } from './base-types';
+import type { ChartToolParams } from './tool-types';
 /**
- * Dynamically generate AI tools from chart type definitions.
+ * Dynamically generate chart configuration tools from chart type definitions.
  *
- * @param chartTypes Array of chart type definitions
- * @param deps Dependencies needed by tool creators (resolveArtifact, resolveTable, addPanel, etc.)
- * @param toolNamePrefix Prefix for generated tool names (default: 'create_dashboard_')
+ * @param chartTypes - Array of chart type definitions
+ * @param params - Chart tool parameters containing addChart function, maxDataPoints limit, and databaseAdapter for table/column resolution
+ * @param toolNamePrefix - Required prefix for generated tool names (e.g., 'create_dashboard_' or 'create_block_document_chart_')
  * @returns Record mapping tool names to tool instances
  *
  * @example
- * const chartTypes = createDefaultChartTypes({includeCustomSpec: false});
- * const tools = createChartTools(chartTypes, deps);
- * // Returns: { create_dashboard_histogram: ..., create_dashboard_line_chart: ..., ... }
+ * const chartTypes = resolveChartTypes();
+ * const params: ChartToolParams = {
+ *   addChart: (chartParams) => dashboardAdapter.addPanel(chartParams),
+ *   maxDataPoints: 10000,
+ *   databaseAdapter: myDatabaseAdapter
+ * };
+ * const tools = createChartTools(chartTypes, params, 'create_dashboard_');
+ * // Returns: { create_dashboard_histogram: Tool, create_dashboard_line_chart: Tool, ... }
  */
-export declare function createChartTools(chartTypes: ChartTypeDefinition<any>[], deps: DashboardToolDeps, toolNamePrefix?: string): Record<string, Tool>;
+export declare function createChartTools(chartTypes: ChartTypeDefinition<any>[], params: ChartToolParams, toolNamePrefix: string): Record<string, Tool>;
 //# sourceMappingURL=createChartTools.d.ts.map

package/dist/charts/chart-types/createChartTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createChartTools.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,EACtC,IAAI,EAAE,iBAAiB,EACvB,cAAc,GAAE,MAA4B,GAC3C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAWtB"}
+{"version":3,"file":"createChartTools.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,EACtC,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAWtB"}

package/dist/charts/chart-types/createChartTools.js

@@ -1,22 +1,28 @@
+import { getChartToolName } from './utils';
 /**
- * Dynamically generate AI tools from chart type definitions.
+ * Dynamically generate chart configuration tools from chart type definitions.
  *
- * @param chartTypes Array of chart type definitions
- * @param deps Dependencies needed by tool creators (resolveArtifact, resolveTable, addPanel, etc.)
- * @param toolNamePrefix Prefix for generated tool names (default: 'create_dashboard_')
+ * @param chartTypes - Array of chart type definitions
+ * @param params - Chart tool parameters containing addChart function, maxDataPoints limit, and databaseAdapter for table/column resolution
+ * @param toolNamePrefix - Required prefix for generated tool names (e.g., 'create_dashboard_' or 'create_block_document_chart_')
  * @returns Record mapping tool names to tool instances
  *
  * @example
- * const chartTypes = createDefaultChartTypes({includeCustomSpec: false});
- * const tools = createChartTools(chartTypes, deps);
- * // Returns: { create_dashboard_histogram: ..., create_dashboard_line_chart: ..., ... }
+ * const chartTypes = resolveChartTypes();
+ * const params: ChartToolParams = {
+ *   addChart: (chartParams) => dashboardAdapter.addPanel(chartParams),
+ *   maxDataPoints: 10000,
+ *   databaseAdapter: myDatabaseAdapter
+ * };
+ * const tools = createChartTools(chartTypes, params, 'create_dashboard_');
+ * // Returns: { create_dashboard_histogram: Tool, create_dashboard_line_chart: Tool, ... }
  */
-export function createChartTools(chartTypes, deps, toolNamePrefix = 'create_dashboard_') {
+export function createChartTools(chartTypes, params, toolNamePrefix) {
     const tools = {};
     for (const chartType of chartTypes) {
         if (chartType.createTool) {
-            const toolName = `${toolNamePrefix}${chartType.id.replace(/-/g, '_')}`;
-            tools[toolName] = chartType.createTool(deps);
+            const toolName = getChartToolName(chartType, toolNamePrefix);
+            tools[toolName] = chartType.createTool(params);
         }
     }
     return tools;

package/dist/charts/chart-types/createChartTools.js.map

@@ -1 +1 @@
-{"version":3,"file":"createChartTools.js","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartTools.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAsC,EACtC,IAAuB,EACvB,iBAAyB,mBAAmB;IAE5C,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACvE,KAAK,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport type {ChartTypeDefinition, DashboardToolDeps} from './base-types';\n\n/**\n * Dynamically generate AI tools from chart type definitions.\n *\n * @param chartTypes Array of chart type definitions\n * @param deps Dependencies needed by tool creators (resolveArtifact, resolveTable, addPanel, etc.)\n * @param toolNamePrefix Prefix for generated tool names (default: 'create_dashboard_')\n * @returns Record mapping tool names to tool instances\n *\n * @example\n * const chartTypes = createDefaultChartTypes({includeCustomSpec: false});\n * const tools = createChartTools(chartTypes, deps);\n * // Returns: { create_dashboard_histogram: ..., create_dashboard_line_chart: ..., ... }\n */\nexport function createChartTools(\n  chartTypes: ChartTypeDefinition<any>[],\n  deps: DashboardToolDeps,\n  toolNamePrefix: string = 'create_dashboard_',\n): Record<string, Tool> {\n  const tools: Record<string, Tool> = {};\n\n  for (const chartType of chartTypes) {\n    if (chartType.createTool) {\n      const toolName = `${toolNamePrefix}${chartType.id.replace(/-/g, '_')}`;\n      tools[toolName] = chartType.createTool(deps);\n    }\n  }\n\n  return tools;\n}\n"]}
+{"version":3,"file":"createChartTools.js","sourceRoot":"","sources":["../../../src/charts/chart-types/createChartTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAsC,EACtC,MAAuB,EACvB,cAAsB;IAEtB,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAC7D,KAAK,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport type {ChartTypeDefinition} from './base-types';\nimport type {ChartToolParams} from './tool-types';\nimport {getChartToolName} from './utils';\n\n/**\n * Dynamically generate chart configuration tools from chart type definitions.\n *\n * @param chartTypes - Array of chart type definitions\n * @param params - Chart tool parameters containing addChart function, maxDataPoints limit, and databaseAdapter for table/column resolution\n * @param toolNamePrefix - Required prefix for generated tool names (e.g., 'create_dashboard_' or 'create_block_document_chart_')\n * @returns Record mapping tool names to tool instances\n *\n * @example\n * const chartTypes = resolveChartTypes();\n * const params: ChartToolParams = {\n *   addChart: (chartParams) => dashboardAdapter.addPanel(chartParams),\n *   maxDataPoints: 10000,\n *   databaseAdapter: myDatabaseAdapter\n * };\n * const tools = createChartTools(chartTypes, params, 'create_dashboard_');\n * // Returns: { create_dashboard_histogram: Tool, create_dashboard_line_chart: Tool, ... }\n */\nexport function createChartTools(\n  chartTypes: ChartTypeDefinition<any>[],\n  params: ChartToolParams,\n  toolNamePrefix: string,\n): Record<string, Tool> {\n  const tools: Record<string, Tool> = {};\n\n  for (const chartType of chartTypes) {\n    if (chartType.createTool) {\n      const toolName = getChartToolName(chartType, toolNamePrefix);\n      tools[toolName] = chartType.createTool(params);\n    }\n  }\n\n  return tools;\n}\n"]}

package/dist/charts/chart-types/custom-spec/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,qBAAqB,EAA0B,MAAM,UAAU,CAAC;AASxE,eAAO,MAAM,mBAAmB,EAAE,uBAAuB,CAAC,qBAAqB,CAe5E,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,qBAAqB,EAA0B,MAAM,UAAU,CAAC;AASxE,eAAO,MAAM,mBAAmB,EAAE,uBAAuB,CAAC,qBAAqB,CAgB5E,CAAC"}

package/dist/charts/chart-types/custom-spec/definition.js

@@ -9,6 +9,7 @@ export const customSpecChartType = {
     id: 'custom-spec',
     label: 'Custom Spec',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - custom visualization using Mosaic vgplot spec`,
     icon: Code,
     schema: CustomSpecChartSettings,
     settingsComponent: CustomSpecSettingsComponent,

package/dist/charts/chart-types/custom-spec/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACxE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,2BAA2B,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAC,gBAAgB,EAAC,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD,MAAM,CAAC,MAAM,mBAAmB,GAC9B;IACE,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,uBAAuB;IAC/B,iBAAiB,EAAE,2BAA2B;IAC9C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,6BAA6B;QACtC,MAAM,EACJ,0GAA0G;KAC7G,CAAC;IACF,UAAU,EAAE,gBAAgB;CAC7B,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {CustomSpecChartConfig, CustomSpecChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {CustomSpecSettingsComponent} from './CustomSpecSettings';\nimport {Code} from 'lucide-react';\nimport {createCustomSpec} from './spec';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a chart with custom spec';\n\nexport const customSpecChartType: SpecChartTypeDefinition<CustomSpecChartConfig> =\n  {\n    id: 'custom-spec',\n    label: 'Custom Spec',\n    description: DESCRIPTION,\n    icon: Code,\n    schema: CustomSpecChartSettings,\n    settingsComponent: CustomSpecSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    getDataPolicy: () => ({\n      maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n      reason:\n        'Custom specs are validated conservatively because SQLRooms cannot infer whether each mark is aggregated.',\n    }),\n    createSpec: createCustomSpec,\n  };\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACxE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,2BAA2B,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAC,gBAAgB,EAAC,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD,MAAM,CAAC,MAAM,mBAAmB,GAC9B;IACE,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,kDAAkD;IAC/E,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,uBAAuB;IAC/B,iBAAiB,EAAE,2BAA2B;IAC9C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,6BAA6B;QACtC,MAAM,EACJ,0GAA0G;KAC7G,CAAC;IACF,UAAU,EAAE,gBAAgB;CAC7B,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {CustomSpecChartConfig, CustomSpecChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {CustomSpecSettingsComponent} from './CustomSpecSettings';\nimport {Code} from 'lucide-react';\nimport {createCustomSpec} from './spec';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a chart with custom spec';\n\nexport const customSpecChartType: SpecChartTypeDefinition<CustomSpecChartConfig> =\n  {\n    id: 'custom-spec',\n    label: 'Custom Spec',\n    description: DESCRIPTION,\n    aiDescription: `${DESCRIPTION} - custom visualization using Mosaic vgplot spec`,\n    icon: Code,\n    schema: CustomSpecChartSettings,\n    settingsComponent: CustomSpecSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    getDataPolicy: () => ({\n      maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n      reason:\n        'Custom specs are validated conservatively because SQLRooms cannot infer whether each mark is aggregated.',\n    }),\n    createSpec: createCustomSpec,\n  };\n"]}

package/dist/charts/chart-types/errors.d.ts

@@ -29,4 +29,14 @@ export declare class InvalidColumnTypeError extends ChartSpecError {
     readonly expectedType: string;
     constructor(columnNames: string[] | string, expectedType: string);
 }
+/**
+ * Error thrown when attempting to create a chart that would render too many data points.
+ * Used to prevent browser crashes from non-aggregated charts on large datasets.
+ */
+export declare class TooMuchDataError extends ChartSpecError {
+    readonly chartType: string;
+    readonly rowCount: number;
+    readonly maxDataPoints: number;
+    constructor(chartType: string, rowCount: number, maxDataPoints: number);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/charts/chart-types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAElB,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAM1C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;CAM3C;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM;CAQjE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAElB,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAM1C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;CAM3C;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM;CAQjE;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAYvE"}

package/dist/charts/chart-types/errors.js

@@ -45,4 +45,22 @@ export class InvalidColumnTypeError extends ChartSpecError {
         this.name = 'InvalidColumnTypeError';
     }
 }
+/**
+ * Error thrown when attempting to create a chart that would render too many data points.
+ * Used to prevent browser crashes from non-aggregated charts on large datasets.
+ */
+export class TooMuchDataError extends ChartSpecError {
+    chartType;
+    rowCount;
+    maxDataPoints;
+    constructor(chartType, rowCount, maxDataPoints) {
+        super(`Cannot create ${chartType} with ${rowCount.toLocaleString()} rows. ` +
+            `This chart type renders individual data points and is limited to ${maxDataPoints.toLocaleString()} rows. ` +
+            `Use an aggregated visualization instead (histogram, heatmap, or line chart with time intervals).`);
+        this.chartType = chartType;
+        this.rowCount = rowCount;
+        this.maxDataPoints = maxDataPoints;
+        this.name = 'TooMuchDataError';
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/charts/chart-types/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/charts/chart-types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAC5C,UAAU,CAAW;IAE9B,YAAY,UAA6B;QACvC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAErC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAC5C,WAAW,CAAW;IAE/B,YAAY,WAA8B;QACxC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAEzC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IAC/C,WAAW,CAAW;IACtB,YAAY,CAAS;IAE9B,YAAY,WAA8B,EAAE,YAAoB;QAC9D,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE7B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF","sourcesContent":["/**\n * Base error class for chart specification generation errors.\n */\nexport class ChartSpecError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ChartSpecError';\n  }\n}\n\n/**\n * Error thrown when required chart configuration fields are missing.\n * Used during chart validation to indicate which fields must be provided.\n */\nexport class RequiredFieldsError extends ChartSpecError {\n  readonly fieldNames: string[];\n\n  constructor(fieldNames: string | string[]) {\n    super('Required fields are missing');\n\n    this.fieldNames = Array.isArray(fieldNames) ? fieldNames : [fieldNames];\n    this.name = 'RequiredFieldsError';\n  }\n}\n\n/**\n * Error thrown when chart configuration references columns that don't exist in the data table.\n * Used during chart validation to indicate which columns could not be found.\n */\nexport class MissingColumnsError extends ChartSpecError {\n  readonly columnNames: string[];\n\n  constructor(columnNames: string | string[]) {\n    super('Columns not found in data table');\n\n    this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];\n    this.name = 'MissingColumnsError';\n  }\n}\n\n/**\n * Error thrown when chart configuration uses columns with incompatible data types.\n * Used during chart validation to indicate which columns have invalid types and what type is expected.\n */\nexport class InvalidColumnTypeError extends ChartSpecError {\n  readonly columnNames: string[];\n  readonly expectedType: string;\n\n  constructor(columnNames: string[] | string, expectedType: string) {\n    super('Invalid column type');\n\n    this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];\n    this.expectedType = expectedType;\n\n    this.name = 'InvalidColumnTypeError';\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/charts/chart-types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAC5C,UAAU,CAAW;IAE9B,YAAY,UAA6B;QACvC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAErC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAC5C,WAAW,CAAW;IAE/B,YAAY,WAA8B;QACxC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAEzC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IAC/C,WAAW,CAAW;IACtB,YAAY,CAAS;IAE9B,YAAY,WAA8B,EAAE,YAAoB;QAC9D,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE7B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzC,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,aAAa,CAAS;IAE/B,YAAY,SAAiB,EAAE,QAAgB,EAAE,aAAqB;QACpE,KAAK,CACH,iBAAiB,SAAS,SAAS,QAAQ,CAAC,cAAc,EAAE,SAAS;YACnE,oEAAoE,aAAa,CAAC,cAAc,EAAE,SAAS;YAC3G,kGAAkG,CACrG,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF","sourcesContent":["/**\n * Base error class for chart specification generation errors.\n */\nexport class ChartSpecError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ChartSpecError';\n  }\n}\n\n/**\n * Error thrown when required chart configuration fields are missing.\n * Used during chart validation to indicate which fields must be provided.\n */\nexport class RequiredFieldsError extends ChartSpecError {\n  readonly fieldNames: string[];\n\n  constructor(fieldNames: string | string[]) {\n    super('Required fields are missing');\n\n    this.fieldNames = Array.isArray(fieldNames) ? fieldNames : [fieldNames];\n    this.name = 'RequiredFieldsError';\n  }\n}\n\n/**\n * Error thrown when chart configuration references columns that don't exist in the data table.\n * Used during chart validation to indicate which columns could not be found.\n */\nexport class MissingColumnsError extends ChartSpecError {\n  readonly columnNames: string[];\n\n  constructor(columnNames: string | string[]) {\n    super('Columns not found in data table');\n\n    this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];\n    this.name = 'MissingColumnsError';\n  }\n}\n\n/**\n * Error thrown when chart configuration uses columns with incompatible data types.\n * Used during chart validation to indicate which columns have invalid types and what type is expected.\n */\nexport class InvalidColumnTypeError extends ChartSpecError {\n  readonly columnNames: string[];\n  readonly expectedType: string;\n\n  constructor(columnNames: string[] | string, expectedType: string) {\n    super('Invalid column type');\n\n    this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];\n    this.expectedType = expectedType;\n\n    this.name = 'InvalidColumnTypeError';\n  }\n}\n\n/**\n * Error thrown when attempting to create a chart that would render too many data points.\n * Used to prevent browser crashes from non-aggregated charts on large datasets.\n */\nexport class TooMuchDataError extends ChartSpecError {\n  readonly chartType: string;\n  readonly rowCount: number;\n  readonly maxDataPoints: number;\n\n  constructor(chartType: string, rowCount: number, maxDataPoints: number) {\n    super(\n      `Cannot create ${chartType} with ${rowCount.toLocaleString()} rows. ` +\n        `This chart type renders individual data points and is limited to ${maxDataPoints.toLocaleString()} rows. ` +\n        `Use an aggregated visualization instead (histogram, heatmap, or line chart with time intervals).`,\n    );\n\n    this.chartType = chartType;\n    this.rowCount = rowCount;\n    this.maxDataPoints = maxDataPoints;\n    this.name = 'TooMuchDataError';\n  }\n}\n"]}

package/dist/charts/chart-types/heatmap/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,kBAAkB,EAAuB,MAAM,UAAU,CAAC;AASlE,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,CAAC,kBAAkB,CAUxE,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,kBAAkB,EAAuB,MAAM,UAAU,CAAC;AASlE,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,CAAC,kBAAkB,CAWxE,CAAC"}

package/dist/charts/chart-types/heatmap/definition.js

@@ -9,6 +9,7 @@ export const heatmapChartType = {
     id: 'heatmap',
     label: 'Heatmap',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - density/patterns across two dimensions (preferred for large datasets)`,
     icon: Grid3X3,
     schema: HeatmapChartSettings,
     settingsComponent: HeatmapSettingsComponent,

package/dist/charts/chart-types/heatmap/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AACrC,OAAO,EAAC,iBAAiB,EAAC,MAAM,QAAQ,CAAC;AAEzC,MAAM,WAAW,GAAG,mCAAmC,CAAC;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,oBAAoB;IAC5B,iBAAiB,EAAE,wBAAwB;IAC3C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,iBAAiB;CAC9B,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {HeatmapChartConfig, HeatmapChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {HeatmapSettingsComponent} from './HeatmapSettings';\nimport {createHeatmapAiTool} from './tool';\nimport {Grid3X3} from 'lucide-react';\nimport {createHeatmapSpec} from './spec';\n\nconst DESCRIPTION = 'Create a 2D heatmap of two fields';\n\nexport const heatmapChartType: SpecChartTypeDefinition<HeatmapChartConfig> = {\n  id: 'heatmap',\n  label: 'Heatmap',\n  description: DESCRIPTION,\n  icon: Grid3X3,\n  schema: HeatmapChartSettings,\n  settingsComponent: HeatmapSettingsComponent,\n  buildTitle: titleFromDescription(DESCRIPTION),\n  createTool: createHeatmapAiTool,\n  createSpec: createHeatmapSpec,\n};\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AACrC,OAAO,EAAC,iBAAiB,EAAC,MAAM,QAAQ,CAAC;AAEzC,MAAM,WAAW,GAAG,mCAAmC,CAAC;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,0EAA0E;IACvG,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,oBAAoB;IAC5B,iBAAiB,EAAE,wBAAwB;IAC3C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,iBAAiB;CAC9B,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {HeatmapChartConfig, HeatmapChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {HeatmapSettingsComponent} from './HeatmapSettings';\nimport {createHeatmapAiTool} from './tool';\nimport {Grid3X3} from 'lucide-react';\nimport {createHeatmapSpec} from './spec';\n\nconst DESCRIPTION = 'Create a 2D heatmap of two fields';\n\nexport const heatmapChartType: SpecChartTypeDefinition<HeatmapChartConfig> = {\n  id: 'heatmap',\n  label: 'Heatmap',\n  description: DESCRIPTION,\n  aiDescription: `${DESCRIPTION} - density/patterns across two dimensions (preferred for large datasets)`,\n  icon: Grid3X3,\n  schema: HeatmapChartSettings,\n  settingsComponent: HeatmapSettingsComponent,\n  buildTitle: titleFromDescription(DESCRIPTION),\n  createTool: createHeatmapAiTool,\n  createSpec: createHeatmapSpec,\n};\n"]}

package/dist/charts/chart-types/heatmap/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAM9C,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAGxE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAC/C,IAAI,CAgCN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAGxE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAC/C,IAAI,CAgCN"}

package/dist/charts/chart-types/heatmap/spec.js

@@ -1,6 +1,5 @@
-import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
 import { getChartTableReference } from '../base-types';
-import { isNumericType } from '../../../column-types-utils';
+import { validateHeatmapSettings } from './validation';
 export function createHeatmapSpec(options) {
     const { dataTable, selectionName } = options;
     const { xColumn, yColumn } = validateHeatmapSettings(options);
@@ -30,35 +29,4 @@ export function createHeatmapSpec(options) {
         params: { brush: { select: 'crossfilter' } },
     };
 }
-function validateHeatmapSettings({ dataTable, settings: { x, y }, }) {
-    // Basic validation for required fields
-    if (!x || !y) {
-        throw new RequiredFieldsError([
-            ...(x ? [] : ['X field']),
-            ...(y ? [] : ['Y field']),
-        ]);
-    }
-    // Validate X and Y field existence
-    const xColumn = dataTable.columns.find((col) => col.name === x);
-    const yColumn = dataTable.columns.find((col) => col.name === y);
-    if (!xColumn || !yColumn) {
-        throw new MissingColumnsError([
-            ...(xColumn ? [] : [x]),
-            ...(yColumn ? [] : [y]),
-        ]);
-    }
-    // Validate X and Y field are numeric
-    const xIsNumeric = isNumericType(xColumn.type);
-    const yIsNumeric = isNumericType(yColumn.type);
-    if (!xIsNumeric || !yIsNumeric) {
-        throw new InvalidColumnTypeError([
-            ...(!xIsNumeric ? [xColumn.name] : []),
-            ...(!yIsNumeric ? [yColumn.name] : []),
-        ], 'numeric');
-    }
-    return {
-        xColumn,
-        yColumn,
-    };
-}
 //# sourceMappingURL=spec.js.map

package/dist/charts/chart-types/heatmap/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAoB,sBAAsB,EAAC,MAAM,eAAe,CAAC;AACxE,OAAO,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAC/B,OAAgD;IAEhD,MAAM,EAAC,SAAS,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IAE3C,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAc;QACtB;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,EAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAC;YACnE,CAAC,EAAE,OAAO,CAAC,IAAI;YACf,CAAC,EAAE,OAAO,CAAC,IAAI;YACf,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;SACb;KACF,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAC;QACnD,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC;AAED,SAAS,uBAAuB,CAAC,EAC/B,SAAS,EACT,QAAQ,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,GACwB;IACxC,uCAAuC;IACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAEhE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,sBAAsB,CAC9B;YACE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,EACD,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {HeatmapChartSettings} from './schema';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {isNumericType} from '../../../column-types-utils';\n\nexport function createHeatmapSpec(\n  options: CreateSpecOptions<HeatmapChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {xColumn, yColumn} = validateHeatmapSettings(options);\n\n  const plot: unknown[] = [\n    {\n      mark: 'raster',\n      data: {from: getChartTableReference(dataTable), filterBy: '$brush'},\n      x: xColumn.name,\n      y: yColumn.name,\n      fill: 'density',\n      bandwidth: 0,\n      pixelSize: 3,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalXY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    colorScale: 'sqrt',\n    colorScheme: 'ylorrd',\n    xLabel: xColumn.name,\n    yLabel: yColumn.name,\n    height: 250,\n    width: 380,\n    margins: {left: 50, right: 20, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n\nfunction validateHeatmapSettings({\n  dataTable,\n  settings: {x, y},\n}: CreateSpecOptions<HeatmapChartSettings>) {\n  // Basic validation for required fields\n  if (!x || !y) {\n    throw new RequiredFieldsError([\n      ...(x ? [] : ['X field']),\n      ...(y ? [] : ['Y field']),\n    ]);\n  }\n\n  // Validate X and Y field existence\n  const xColumn = dataTable.columns.find((col) => col.name === x);\n  const yColumn = dataTable.columns.find((col) => col.name === y);\n\n  if (!xColumn || !yColumn) {\n    throw new MissingColumnsError([\n      ...(xColumn ? [] : [x]),\n      ...(yColumn ? [] : [y]),\n    ]);\n  }\n\n  // Validate X and Y field are numeric\n  const xIsNumeric = isNumericType(xColumn.type);\n  const yIsNumeric = isNumericType(yColumn.type);\n  if (!xIsNumeric || !yIsNumeric) {\n    throw new InvalidColumnTypeError(\n      [\n        ...(!xIsNumeric ? [xColumn.name] : []),\n        ...(!yIsNumeric ? [yColumn.name] : []),\n      ],\n      'numeric',\n    );\n  }\n\n  return {\n    xColumn,\n    yColumn,\n  };\n}\n"]}
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,sBAAsB,EAAC,MAAM,eAAe,CAAC;AACxE,OAAO,EAAC,uBAAuB,EAAC,MAAM,cAAc,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAC/B,OAAgD;IAEhD,MAAM,EAAC,SAAS,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IAE3C,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAc;QACtB;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,EAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAC;YACnE,CAAC,EAAE,OAAO,CAAC,IAAI;YACf,CAAC,EAAE,OAAO,CAAC,IAAI;YACf,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;SACb;KACF,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAC;QACnD,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {HeatmapChartSettings} from './schema';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {validateHeatmapSettings} from './validation';\n\nexport function createHeatmapSpec(\n  options: CreateSpecOptions<HeatmapChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {xColumn, yColumn} = validateHeatmapSettings(options);\n\n  const plot: unknown[] = [\n    {\n      mark: 'raster',\n      data: {from: getChartTableReference(dataTable), filterBy: '$brush'},\n      x: xColumn.name,\n      y: yColumn.name,\n      fill: 'density',\n      bandwidth: 0,\n      pixelSize: 3,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalXY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    colorScale: 'sqrt',\n    colorScheme: 'ylorrd',\n    xLabel: xColumn.name,\n    yLabel: yColumn.name,\n    height: 250,\n    width: 380,\n    margins: {left: 50, right: 20, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n"]}

package/dist/charts/chart-types/heatmap/tool.d.ts

@@ -1,9 +1,8 @@
 import { z } from 'zod';
-import { type DashboardToolDeps } from '../base-types';
-export declare const HeatmapToolParameters: z.ZodObject<{
-    artifactId: z.ZodOptional<z.ZodString>;
-    tableName: z.ZodOptional<z.ZodString>;
-    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+import { ChartToolParams, ChartToolOutput } from '../tool-types';
+export declare const HeatmapToolInput: z.ZodObject<{
+    tableName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
@@ -11,30 +10,27 @@ export declare const HeatmapToolParameters: z.ZodObject<{
         y: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export type HeatmapToolParams = z.infer<typeof HeatmapToolParameters>;
-export declare function createHeatmapAiTool(deps: DashboardToolDeps): import("ai").Tool<{
-    createArtifactIfMissing: boolean;
+export type HeatmapToolInput = z.infer<typeof HeatmapToolInput>;
+export declare function createHeatmapAiTool({ databaseAdapter, addChart, maxDataPoints, }: ChartToolParams): import("ai").Tool<{
+    tableName: string;
     reasoning: string;
     settings: {
         x: string;
         y: string;
     };
-    artifactId?: string | undefined;
-    tableName?: string | undefined;
+    title?: string | undefined;
     panelId?: string | undefined;
-}, {
-    llmResult: {
-        success: boolean;
-        details: string;
-        data: import("..").PanelResult;
-        errorMessage?: undefined;
-    };
-} | {
-    llmResult: {
-        success: boolean;
-        errorMessage: string;
-        details?: undefined;
-        data?: undefined;
+}, ChartToolOutput<{
+    chartType: "heatmap";
+    settings: {
+        x?: string | undefined;
+        y?: string | undefined;
     };
-}>;
+    settingsOpen?: boolean | undefined;
+    dataPolicy?: {
+        disabled?: boolean | undefined;
+        maxRows?: number | undefined;
+        reason?: string | undefined;
+    } | undefined;
+}>>;
 //# sourceMappingURL=tool.d.ts.map

package/dist/charts/chart-types/heatmap/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,EAAC,KAAK,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAKrD,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAEhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;GA+E1D"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAI/D,eAAO,MAAM,gBAAgB;;;;;;;;;iBAE3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CAAC,EAClC,eAAe,EACf,QAAQ,EACR,aAAa,GACd,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;IAiDjB"}

package/dist/charts/chart-types/heatmap/tool.js

@@ -1,13 +1,13 @@
 import { tool } from 'ai';
 import { HeatmapChartSettings } from './schema';
-import { BaseChartToolParameters } from '../../../ai/tool-schemas';
-import { validateColumnExists } from '../../../ai/tool-validation';
+import { BaseChartToolInput } from '../../../ai/tool-schemas';
 import { NUMERIC_COLUMN_TYPES } from '../../../column-types-utils';
-import { createOrUpdateChartPanel } from '../../../ai/tool-helpers';
-export const HeatmapToolParameters = BaseChartToolParameters.extend({
+import { validateHeatmapSettings } from './validation';
+import { ensureTable } from '../../../ai/tool-helpers';
+export const HeatmapToolInput = BaseChartToolInput.extend({
     settings: HeatmapChartSettings.required(),
 });
-export function createHeatmapAiTool(deps) {
+export function createHeatmapAiTool({ databaseAdapter, addChart, maxDataPoints, }) {
     return tool({
         description: `Heatmap: visualizes density or aggregated values across two dimensions using color intensity in a grid. Each cell color shows count/sum at that x,y position.
 
@@ -16,49 +16,39 @@ Example queries: "heatmap of population density by latitude and longitude", "tem
 
 Required: x and y should be numeric (${NUMERIC_COLUMN_TYPES.join(', ')}) for creating the grid.
 
-NOTE: Heatmaps aggregate data into grid cells and compute density/counts, so they handle large datasets efficiently (no data point limit). Heatmaps are a good alternative when scatter charts would exceed ${deps.maxDataPoints.toLocaleString()} rows.
-
-To UPDATE an existing heatmap: provide the panelId parameter. Otherwise creates new panel.
+NOTE: Heatmaps aggregate data into grid cells and compute density/counts, so they handle large datasets efficiently (no data point limit). Heatmaps are a good alternative when scatter charts would exceed ${maxDataPoints.toLocaleString()} rows.
 
 Best for: large datasets with overlapping points, finding patterns/hotspots in 2D space, temporal patterns (hour×day), spatial density visualization.
 
 Do NOT use for: individual point plots (use scatter-plot), single variable distribution (use histogram), time trends (use line-chart).`,
-        inputSchema: HeatmapToolParameters,
-        execute: async (params, context) => {
+        inputSchema: HeatmapToolInput,
+        execute: async ({ tableName, title, settings, panelId }) => {
             try {
-                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
-                const { tableName, columns } = deps.resolveTable(artifactId, params.tableName);
-                // Validate settings
-                validateColumnExists(params.settings.x, NUMERIC_COLUMN_TYPES, columns, 'x');
-                validateColumnExists(params.settings.y, NUMERIC_COLUMN_TYPES, columns, 'y');
-                const result = createOrUpdateChartPanel(deps, {
-                    panelId: params.panelId,
-                    dashboardId: artifactId,
+                const dataTable = ensureTable(databaseAdapter, tableName);
+                validateHeatmapSettings({
+                    dataTable,
+                    settings,
+                });
+                const chartConfig = {
+                    chartType: 'heatmap',
+                    settings,
+                };
+                await addChart({
                     tableName,
-                    title: params.settings.x && params.settings.y
-                        ? `Heatmap - ${params.settings.x} vs ${params.settings.y}`
-                        : 'Heatmap',
-                    config: {
-                        chartType: 'heatmap',
-                        settings: params.settings,
-                    },
+                    panelId,
+                    title,
+                    config: chartConfig,
                 });
                 return {
-                    llmResult: {
-                        success: true,
-                        details: params.panelId
-                            ? `Updated heatmap "${result.title}".`
-                            : `Created heatmap "${result.title}".`,
-                        data: result,
-                    },
+                    success: true,
+                    details: `Generated heatmap configuration.`,
+                    data: chartConfig,
                 };
             }
             catch (error) {
                 return {
-                    llmResult: {
-                        success: false,
-                        errorMessage: error instanceof Error ? error.message : String(error),
-                    },
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
                 };
             }
         },

package/dist/charts/chart-types/heatmap/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;uCAKsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;;8MAEwI,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE;;;;;;uIAM1G;QACnI,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,uBAAuB,EAC9B,OAAO,CACR,CAAC;gBACF,MAAM,EAAC,SAAS,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,YAAY,CAC5C,UAAU,EACV,MAAM,CAAC,SAAS,CACjB,CAAC;gBAEF,oBAAoB;gBAEpB,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,CAAC,EACjB,oBAAoB,EACpB,OAAO,EACP,GAAG,CACJ,CAAC;gBAEF,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,CAAC,EACjB,oBAAoB,EACpB,OAAO,EACP,GAAG,CACJ,CAAC;gBAEF,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE;oBAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,SAAS;oBACT,KAAK,EACH,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;wBACpC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE;wBAC1D,CAAC,CAAC,SAAS;oBACf,MAAM,EAAE;wBACN,SAAS,EAAE,SAAS;wBACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;iBACF,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM,CAAC,OAAO;4BACrB,CAAC,CAAC,oBAAoB,MAAM,CAAC,KAAK,IAAI;4BACtC,CAAC,CAAC,oBAAoB,MAAM,CAAC,KAAK,IAAI;wBACxC,IAAI,EAAE,MAAM;qBACb;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,KAAK;wBACd,YAAY,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {HeatmapChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {NUMERIC_COLUMN_TYPES} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nexport const HeatmapToolParameters = BaseChartToolParameters.extend({\n  settings: HeatmapChartSettings.required(),\n});\n\nexport type HeatmapToolParams = z.infer<typeof HeatmapToolParameters>;\n\nexport function createHeatmapAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Heatmap: visualizes density or aggregated values across two dimensions using color intensity in a grid. Each cell color shows count/sum at that x,y position.\n\nUse when: user asks about \"heatmap\", \"density by X and Y\", \"activity by [category] and [category]\", \"intensity\", \"patterns across two dimensions\".\nExample queries: \"heatmap of population density by latitude and longitude\", \"temperature by elevation and month\", \"show building density by coordinates\", \"land use intensity by region and type\", \"feature distribution by grid cell\".\n\nRequired: x and y should be numeric (${NUMERIC_COLUMN_TYPES.join(', ')}) for creating the grid.\n\nNOTE: Heatmaps aggregate data into grid cells and compute density/counts, so they handle large datasets efficiently (no data point limit). Heatmaps are a good alternative when scatter charts would exceed ${deps.maxDataPoints.toLocaleString()} rows.\n\nTo UPDATE an existing heatmap: provide the panelId parameter. Otherwise creates new panel.\n\nBest for: large datasets with overlapping points, finding patterns/hotspots in 2D space, temporal patterns (hour×day), spatial density visualization.\n\nDo NOT use for: individual point plots (use scatter-plot), single variable distribution (use histogram), time trends (use line-chart).`,\n    inputSchema: HeatmapToolParameters,\n    execute: async (params, context) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n          context,\n        );\n        const {tableName, columns} = deps.resolveTable(\n          artifactId,\n          params.tableName,\n        );\n\n        // Validate settings\n\n        validateColumnExists(\n          params.settings.x,\n          NUMERIC_COLUMN_TYPES,\n          columns,\n          'x',\n        );\n\n        validateColumnExists(\n          params.settings.y,\n          NUMERIC_COLUMN_TYPES,\n          columns,\n          'y',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title:\n            params.settings.x && params.settings.y\n              ? `Heatmap - ${params.settings.x} vs ${params.settings.y}`\n              : 'Heatmap',\n          config: {\n            chartType: 'heatmap',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated heatmap \"${result.title}\".`\n              : `Created heatmap \"${result.title}\".`,\n            data: result,\n          },\n        };\n      } catch (error) {\n        return {\n          llmResult: {\n            success: false,\n            errorMessage:\n              error instanceof Error ? error.message : String(error),\n          },\n        };\n      }\n    },\n  });\n}\n"]}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAC,uBAAuB,EAAC,MAAM,cAAc,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,EAClC,eAAe,EACf,QAAQ,EACR,aAAa,GACG;IAChB,OAAO,IAAI,CAAwD;QACjE,WAAW,EAAE;;;;;uCAKsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;;8MAEwI,aAAa,CAAC,cAAc,EAAE;;;;uIAIrG;QACnI,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,KAAK,EAAE,EAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAC,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;gBAE1D,uBAAuB,CAAC;oBACtB,SAAS;oBACT,QAAQ;iBACT,CAAC,CAAC;gBAEH,MAAM,WAAW,GAAuB;oBACtC,SAAS,EAAE,SAAkB;oBAC7B,QAAQ;iBACT,CAAC;gBAEF,MAAM,QAAQ,CAAC;oBACb,SAAS;oBACT,OAAO;oBACP,KAAK;oBACL,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,kCAAkC;oBAC3C,IAAI,EAAE,WAAW;iBAClB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {HeatmapChartConfig, HeatmapChartSettings} from './schema';\nimport {BaseChartToolInput} from '../../../ai/tool-schemas';\nimport {NUMERIC_COLUMN_TYPES} from '../../../column-types-utils';\nimport {ChartToolParams, ChartToolOutput} from '../tool-types';\nimport {validateHeatmapSettings} from './validation';\nimport {ensureTable} from '../../../ai/tool-helpers';\n\nexport const HeatmapToolInput = BaseChartToolInput.extend({\n  settings: HeatmapChartSettings.required(),\n});\n\nexport type HeatmapToolInput = z.infer<typeof HeatmapToolInput>;\n\nexport function createHeatmapAiTool({\n  databaseAdapter,\n  addChart,\n  maxDataPoints,\n}: ChartToolParams) {\n  return tool<HeatmapToolInput, ChartToolOutput<HeatmapChartConfig>>({\n    description: `Heatmap: visualizes density or aggregated values across two dimensions using color intensity in a grid. Each cell color shows count/sum at that x,y position.\n\nUse when: user asks about \"heatmap\", \"density by X and Y\", \"activity by [category] and [category]\", \"intensity\", \"patterns across two dimensions\".\nExample queries: \"heatmap of population density by latitude and longitude\", \"temperature by elevation and month\", \"show building density by coordinates\", \"land use intensity by region and type\", \"feature distribution by grid cell\".\n\nRequired: x and y should be numeric (${NUMERIC_COLUMN_TYPES.join(', ')}) for creating the grid.\n\nNOTE: Heatmaps aggregate data into grid cells and compute density/counts, so they handle large datasets efficiently (no data point limit). Heatmaps are a good alternative when scatter charts would exceed ${maxDataPoints.toLocaleString()} rows.\n\nBest for: large datasets with overlapping points, finding patterns/hotspots in 2D space, temporal patterns (hour×day), spatial density visualization.\n\nDo NOT use for: individual point plots (use scatter-plot), single variable distribution (use histogram), time trends (use line-chart).`,\n    inputSchema: HeatmapToolInput,\n    execute: async ({tableName, title, settings, panelId}) => {\n      try {\n        const dataTable = ensureTable(databaseAdapter, tableName);\n\n        validateHeatmapSettings({\n          dataTable,\n          settings,\n        });\n\n        const chartConfig: HeatmapChartConfig = {\n          chartType: 'heatmap' as const,\n          settings,\n        };\n\n        await addChart({\n          tableName,\n          panelId,\n          title,\n          config: chartConfig,\n        });\n\n        return {\n          success: true,\n          details: `Generated heatmap configuration.`,\n          data: chartConfig,\n        };\n      } catch (error) {\n        return {\n          success: false,\n          errorMessage: error instanceof Error ? error.message : String(error),\n        };\n      }\n    },\n  });\n}\n"]}

package/dist/charts/chart-types/heatmap/validation.d.ts

@@ -0,0 +1,9 @@
+import { HeatmapChartSettings } from './schema';
+import { ValidateSpecOptions } from '../base-types';
+import { TableColumn } from '@sqlrooms/duckdb';
+export type ValidatedHeatmapSettings = {
+    xColumn: TableColumn;
+    yColumn: TableColumn;
+};
+export declare function validateHeatmapSettings({ dataTable, settings: { x, y }, }: ValidateSpecOptions<HeatmapChartSettings>): ValidatedHeatmapSettings;
+//# sourceMappingURL=validation.d.ts.map

package/dist/charts/chart-types/heatmap/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAOlD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,QAAQ,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,GACjB,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,GAAG,wBAAwB,CAqCtE"}

package/dist/charts/chart-types/heatmap/validation.js

@@ -0,0 +1,34 @@
+import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
+import { isNumericType } from '../../../column-types-utils';
+export function validateHeatmapSettings({ dataTable, settings: { x, y }, }) {
+    // Basic validation for required fields
+    if (!x || !y) {
+        throw new RequiredFieldsError([
+            ...(x ? [] : ['X field']),
+            ...(y ? [] : ['Y field']),
+        ]);
+    }
+    // Validate X and Y field existence
+    const xColumn = dataTable.columns.find((col) => col.name === x);
+    const yColumn = dataTable.columns.find((col) => col.name === y);
+    if (!xColumn || !yColumn) {
+        throw new MissingColumnsError([
+            ...(xColumn ? [] : [x]),
+            ...(yColumn ? [] : [y]),
+        ]);
+    }
+    // Validate X and Y field are numeric
+    const xIsNumeric = isNumericType(xColumn.type);
+    const yIsNumeric = isNumericType(yColumn.type);
+    if (!xIsNumeric || !yIsNumeric) {
+        throw new InvalidColumnTypeError([
+            ...(!xIsNumeric ? [xColumn.name] : []),
+            ...(!yIsNumeric ? [yColumn.name] : []),
+        ], 'numeric');
+    }
+    return {
+        xColumn,
+        yColumn,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/charts/chart-types/heatmap/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/validation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAQ1D,MAAM,UAAU,uBAAuB,CAAC,EACtC,SAAS,EACT,QAAQ,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,GAC0B;IAC1C,uCAAuC;IACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAEhE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,sBAAsB,CAC9B;YACE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,EACD,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["import {HeatmapChartSettings} from './schema';\nimport {ValidateSpecOptions} from '../base-types';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {isNumericType} from '../../../column-types-utils';\nimport {TableColumn} from '@sqlrooms/duckdb';\n\nexport type ValidatedHeatmapSettings = {\n  xColumn: TableColumn;\n  yColumn: TableColumn;\n};\n\nexport function validateHeatmapSettings({\n  dataTable,\n  settings: {x, y},\n}: ValidateSpecOptions<HeatmapChartSettings>): ValidatedHeatmapSettings {\n  // Basic validation for required fields\n  if (!x || !y) {\n    throw new RequiredFieldsError([\n      ...(x ? [] : ['X field']),\n      ...(y ? [] : ['Y field']),\n    ]);\n  }\n\n  // Validate X and Y field existence\n  const xColumn = dataTable.columns.find((col) => col.name === x);\n  const yColumn = dataTable.columns.find((col) => col.name === y);\n\n  if (!xColumn || !yColumn) {\n    throw new MissingColumnsError([\n      ...(xColumn ? [] : [x]),\n      ...(yColumn ? [] : [y]),\n    ]);\n  }\n\n  // Validate X and Y field are numeric\n  const xIsNumeric = isNumericType(xColumn.type);\n  const yIsNumeric = isNumericType(yColumn.type);\n  if (!xIsNumeric || !yIsNumeric) {\n    throw new InvalidColumnTypeError(\n      [\n        ...(!xIsNumeric ? [xColumn.name] : []),\n        ...(!yIsNumeric ? [yColumn.name] : []),\n      ],\n      'numeric',\n    );\n  }\n\n  return {\n    xColumn,\n    yColumn,\n  };\n}\n"]}

package/dist/charts/chart-types/histogram/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,oBAAoB,EAAyB,MAAM,UAAU,CAAC;AAStE,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,oBAAoB,CAW1E,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,oBAAoB,EAAyB,MAAM,UAAU,CAAC;AAStE,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,oBAAoB,CAY1E,CAAC"}