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

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

@@ -4,4 +4,39 @@
 export declare class ChartSpecError extends Error {
     constructor(message: string);
 }
+/**
+ * Error thrown when required chart configuration fields are missing.
+ * Used during chart validation to indicate which fields must be provided.
+ */
+export declare class RequiredFieldsError extends ChartSpecError {
+    readonly fieldNames: string[];
+    constructor(fieldNames: string | string[]);
+}
+/**
+ * Error thrown when chart configuration references columns that don't exist in the data table.
+ * Used during chart validation to indicate which columns could not be found.
+ */
+export declare class MissingColumnsError extends ChartSpecError {
+    readonly columnNames: string[];
+    constructor(columnNames: string | string[]);
+}
+/**
+ * Error thrown when chart configuration uses columns with incompatible data types.
+ * Used during chart validation to indicate which columns have invalid types and what type is expected.
+ */
+export declare class InvalidColumnTypeError extends ChartSpecError {
+    readonly columnNames: string[];
+    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"}
+{"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

@@ -7,4 +7,60 @@ export class ChartSpecError extends Error {
         this.name = 'ChartSpecError';
     }
 }
+/**
+ * Error thrown when required chart configuration fields are missing.
+ * Used during chart validation to indicate which fields must be provided.
+ */
+export class RequiredFieldsError extends ChartSpecError {
+    fieldNames;
+    constructor(fieldNames) {
+        super('Required fields are missing');
+        this.fieldNames = Array.isArray(fieldNames) ? fieldNames : [fieldNames];
+        this.name = 'RequiredFieldsError';
+    }
+}
+/**
+ * Error thrown when chart configuration references columns that don't exist in the data table.
+ * Used during chart validation to indicate which columns could not be found.
+ */
+export class MissingColumnsError extends ChartSpecError {
+    columnNames;
+    constructor(columnNames) {
+        super('Columns not found in data table');
+        this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];
+        this.name = 'MissingColumnsError';
+    }
+}
+/**
+ * Error thrown when chart configuration uses columns with incompatible data types.
+ * Used during chart validation to indicate which columns have invalid types and what type is expected.
+ */
+export class InvalidColumnTypeError extends ChartSpecError {
+    columnNames;
+    expectedType;
+    constructor(columnNames, expectedType) {
+        super('Invalid column type');
+        this.columnNames = Array.isArray(columnNames) ? columnNames : [columnNames];
+        this.expectedType = expectedType;
+        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","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"]}
+{"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

@@ -1,4 +1,5 @@
 import type { Spec } from '@uwdata/mosaic-spec';
 import { HeatmapChartSettings } from './schema';
-export declare function createHeatmapSpec(tableName: string, { x, y }: HeatmapChartSettings): Spec;
+import { CreateSpecOptions } from '../base-types';
+export declare function createHeatmapSpec(options: CreateSpecOptions<HeatmapChartSettings>): Spec;
 //# sourceMappingURL=spec.d.ts.map

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;AAG9C,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,oBAAoB,GAC3B,IAAI,CA6BN"}
+{"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,28 +1,28 @@
-import { ChartSpecError } from '../errors';
-export function createHeatmapSpec(tableName, { x, y }) {
-    if (!x) {
-        throw new ChartSpecError('X field is required for heatmap');
-    }
-    if (!y) {
-        throw new ChartSpecError('Y field is required for heatmap');
+import { getChartTableReference } from '../base-types';
+import { validateHeatmapSettings } from './validation';
+export function createHeatmapSpec(options) {
+    const { dataTable, selectionName } = options;
+    const { xColumn, yColumn } = validateHeatmapSettings(options);
+    const plot = [
+        {
+            mark: 'raster',
+            data: { from: getChartTableReference(dataTable), filterBy: '$brush' },
+            x: xColumn.name,
+            y: yColumn.name,
+            fill: 'density',
+            bandwidth: 0,
+            pixelSize: 3,
+        },
+    ];
+    if (selectionName) {
+        plot.push({ select: 'intervalXY', as: '$brush' });
     }
     return {
-        plot: [
-            {
-                mark: 'raster',
-                data: { from: tableName, filterBy: '$brush' },
-                x,
-                y,
-                fill: 'density',
-                bandwidth: 0,
-                pixelSize: 3,
-            },
-            { select: 'intervalXY', as: '$brush' },
-        ],
+        plot,
         colorScale: 'sqrt',
         colorScheme: 'ylorrd',
-        xLabel: x,
-        yLabel: y,
+        xLabel: xColumn.name,
+        yLabel: yColumn.name,
         height: 250,
         width: 380,
         margins: { left: 50, right: 20, top: 20, bottom: 50 },

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,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAEzC,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,EAAC,CAAC,EAAE,CAAC,EAAuB;IAE5B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,iCAAiC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,iCAAiC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO;QACL,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC;gBACD,CAAC;gBACD,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACb;YACD,EAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAC;SACrC;QACD,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,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 {ChartSpecError} from '../errors';\n\nexport function createHeatmapSpec(\n  tableName: string,\n  {x, y}: HeatmapChartSettings,\n): Spec {\n  if (!x) {\n    throw new ChartSpecError('X field is required for heatmap');\n  }\n  if (!y) {\n    throw new ChartSpecError('Y field is required for heatmap');\n  }\n  return {\n    plot: [\n      {\n        mark: 'raster',\n        data: {from: tableName, filterBy: '$brush'},\n        x,\n        y,\n        fill: 'density',\n        bandwidth: 0,\n        pixelSize: 3,\n      },\n      {select: 'intervalXY', as: '$brush'},\n    ],\n    colorScale: 'sqrt',\n    colorScheme: 'ylorrd',\n    xLabel: x,\n    yLabel: y,\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"]}
+{"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 bubble 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 bubble-chart), single variable distribution (use histogram), time trends (use line-chart).`,
-        inputSchema: HeatmapToolParameters,
-        execute: async (params, context) => {
+Do NOT use for: individual point plots (use scatter-plot), single variable distribution (use histogram), time trends (use line-chart).`,
+        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;;6MAEuI,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE;;;;;;uIAMzG;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 bubble 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 bubble-chart), 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/HistogramSettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HistogramSettings.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,EAAC,MAAM,OAAO,CAAC;AAO9B,eAAO,MAAM,0BAA0B,EAAE,EA0BxC,CAAC"}
+{"version":3,"file":"HistogramSettings.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,EAAC,MAAM,OAAO,CAAC;AAY9B,eAAO,MAAM,0BAA0B,EAAE,EAkCxC,CAAC"}

package/dist/charts/chart-types/histogram/HistogramSettings.js

@@ -2,10 +2,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Input } from '@sqlrooms/ui';
 import { Field } from '../../../components/Field';
 import { ColumnSelector } from '../../../components/ColumnSelector';
+import { ColorSelector } from '../../../components/ColorSelector';
 import { useMosaicChartSettingsContext } from '../../chart-settings/MosaicChartSettingsContext';
 import { MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT } from './schema';
+import { DEFAULT_CHART_COLORS, DEFAULT_CHART_FALLBACK_COLOR, } from '../../../constants/chart-colors';
 export const HistogramSettingsComponent = () => {
     const { onChangeConfig, config } = useMosaicChartSettingsContext('histogram');
-    return (_jsxs("div", { className: "space-y-4", children: [_jsx(Field, { label: "Field", required: true, children: _jsx(ColumnSelector.Quantitative, { value: config.settings.field, onChange: (field) => onChangeConfig('field', field) }) }), _jsx(Field, { label: "Max Bins", children: _jsx(Input, { type: "number", min: MIN_BINS_COUNT, max: MAX_BINS_COUNT, value: config.settings.maxBins ?? DEFAULT_BINS_COUNT, className: "no-spinner", onChange: (e) => onChangeConfig('maxBins', parseInt(e.target.value, 10)), placeholder: String(DEFAULT_BINS_COUNT) }) })] }));
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(Field, { label: "Field", required: true, children: _jsxs("div", { className: "flex items-end gap-2", children: [_jsx(ColumnSelector.Quantitative, { className: "flex-1", value: config.settings.field, onChange: (field) => onChangeConfig('field', field) }), _jsx(ColorSelector, { items: DEFAULT_CHART_COLORS, value: config.settings.color ?? DEFAULT_CHART_FALLBACK_COLOR, onChange: (color) => onChangeConfig('color', color) })] }) }), _jsx(Field, { label: "Max Bins", children: _jsx(Input, { type: "number", min: MIN_BINS_COUNT, max: MAX_BINS_COUNT, value: config.settings.maxBins ?? DEFAULT_BINS_COUNT, className: "no-spinner", onChange: (e) => onChangeConfig('maxBins', parseInt(e.target.value, 10)), placeholder: String(DEFAULT_BINS_COUNT) }) })] }));
 };
 //# sourceMappingURL=HistogramSettings.js.map

package/dist/charts/chart-types/histogram/HistogramSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"HistogramSettings.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,KAAK,EAAC,MAAM,cAAc,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAC,6BAA6B,EAAC,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAC,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAO,GAAG,EAAE;IACjD,MAAM,EAAC,cAAc,EAAE,MAAM,EAAC,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAE5E,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,kBAC3B,KAAC,cAAc,CAAC,YAAY,IAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,GACnD,GACI,EACR,KAAC,KAAK,IAAC,KAAK,EAAC,UAAU,YACrB,KAAC,KAAK,IACJ,IAAI,EAAC,QAAQ,EACb,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,kBAAkB,EACpD,SAAS,EAAC,YAAY,EACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CACd,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAEzD,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,GACvC,GACI,IACJ,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {type FC} from 'react';\nimport {Input} from '@sqlrooms/ui';\nimport {Field} from '../../../components/Field';\nimport {ColumnSelector} from '../../../components/ColumnSelector';\nimport {useMosaicChartSettingsContext} from '../../chart-settings/MosaicChartSettingsContext';\nimport {MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT} from './schema';\n\nexport const HistogramSettingsComponent: FC = () => {\n  const {onChangeConfig, config} = useMosaicChartSettingsContext('histogram');\n\n  return (\n    <div className=\"space-y-4\">\n      <Field label=\"Field\" required>\n        <ColumnSelector.Quantitative\n          value={config.settings.field}\n          onChange={(field) => onChangeConfig('field', field)}\n        />\n      </Field>\n      <Field label=\"Max Bins\">\n        <Input\n          type=\"number\"\n          min={MIN_BINS_COUNT}\n          max={MAX_BINS_COUNT}\n          value={config.settings.maxBins ?? DEFAULT_BINS_COUNT}\n          className=\"no-spinner\"\n          onChange={(e) =>\n            onChangeConfig('maxBins', parseInt(e.target.value, 10))\n          }\n          placeholder={String(DEFAULT_BINS_COUNT)}\n        />\n      </Field>\n    </div>\n  );\n};\n"]}
+{"version":3,"file":"HistogramSettings.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,KAAK,EAAC,MAAM,cAAc,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAC,aAAa,EAAC,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAC,6BAA6B,EAAC,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAC,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,CAAC,MAAM,0BAA0B,GAAO,GAAG,EAAE;IACjD,MAAM,EAAC,cAAc,EAAE,MAAM,EAAC,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAE5E,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,kBAC3B,eAAK,SAAS,EAAC,sBAAsB,aACnC,KAAC,cAAc,CAAC,YAAY,IAC1B,SAAS,EAAC,QAAQ,EAClB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,GACnD,EACF,KAAC,aAAa,IACZ,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,4BAA4B,EAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,GACnD,IACE,GACA,EACR,KAAC,KAAK,IAAC,KAAK,EAAC,UAAU,YACrB,KAAC,KAAK,IACJ,IAAI,EAAC,QAAQ,EACb,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,kBAAkB,EACpD,SAAS,EAAC,YAAY,EACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CACd,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAEzD,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,GACvC,GACI,IACJ,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {type FC} from 'react';\nimport {Input} from '@sqlrooms/ui';\nimport {Field} from '../../../components/Field';\nimport {ColumnSelector} from '../../../components/ColumnSelector';\nimport {ColorSelector} from '../../../components/ColorSelector';\nimport {useMosaicChartSettingsContext} from '../../chart-settings/MosaicChartSettingsContext';\nimport {MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT} from './schema';\nimport {\n  DEFAULT_CHART_COLORS,\n  DEFAULT_CHART_FALLBACK_COLOR,\n} from '../../../constants/chart-colors';\n\nexport const HistogramSettingsComponent: FC = () => {\n  const {onChangeConfig, config} = useMosaicChartSettingsContext('histogram');\n\n  return (\n    <div className=\"space-y-4\">\n      <Field label=\"Field\" required>\n        <div className=\"flex items-end gap-2\">\n          <ColumnSelector.Quantitative\n            className=\"flex-1\"\n            value={config.settings.field}\n            onChange={(field) => onChangeConfig('field', field)}\n          />\n          <ColorSelector\n            items={DEFAULT_CHART_COLORS}\n            value={config.settings.color ?? DEFAULT_CHART_FALLBACK_COLOR}\n            onChange={(color) => onChangeConfig('color', color)}\n          />\n        </div>\n      </Field>\n      <Field label=\"Max Bins\">\n        <Input\n          type=\"number\"\n          min={MIN_BINS_COUNT}\n          max={MAX_BINS_COUNT}\n          value={config.settings.maxBins ?? DEFAULT_BINS_COUNT}\n          className=\"no-spinner\"\n          onChange={(e) =>\n            onChangeConfig('maxBins', parseInt(e.target.value, 10))\n          }\n          placeholder={String(DEFAULT_BINS_COUNT)}\n        />\n      </Field>\n    </div>\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"}

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

@@ -9,6 +9,7 @@ export const histogramChartType = {
     id: 'histogram',
     label: 'Histogram',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - distribution of numeric values (always safe, aggregates automatically)`,
     icon: BarChart3,
     schema: HistogramChartSettings,
     settingsComponent: HistogramSettingsComponent,

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

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,sBAAsB,EAAC,MAAM,UAAU,CAAC;AACtE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAC7B;IACE,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,sBAAsB;IAC9B,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {HistogramChartConfig, HistogramChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {HistogramSettingsComponent} from './HistogramSettings';\nimport {createHistogramAiTool} from './tool';\nimport {BarChart3} from 'lucide-react';\nimport {createHistogramSpec} from './spec';\n\nconst DESCRIPTION = 'Create a histogram of a field';\n\nexport const histogramChartType: SpecChartTypeDefinition<HistogramChartConfig> =\n  {\n    id: 'histogram',\n    label: 'Histogram',\n    description: DESCRIPTION,\n    icon: BarChart3,\n    schema: HistogramChartSettings,\n    settingsComponent: HistogramSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    createTool: createHistogramAiTool,\n    createSpec: createHistogramSpec,\n  };\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,sBAAsB,EAAC,MAAM,UAAU,CAAC;AACtE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAC7B;IACE,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,2EAA2E;IACxG,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,sBAAsB;IAC9B,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {HistogramChartConfig, HistogramChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {HistogramSettingsComponent} from './HistogramSettings';\nimport {createHistogramAiTool} from './tool';\nimport {BarChart3} from 'lucide-react';\nimport {createHistogramSpec} from './spec';\n\nconst DESCRIPTION = 'Create a histogram of a field';\n\nexport const histogramChartType: SpecChartTypeDefinition<HistogramChartConfig> =\n  {\n    id: 'histogram',\n    label: 'Histogram',\n    description: DESCRIPTION,\n    aiDescription: `${DESCRIPTION} - distribution of numeric values (always safe, aggregates automatically)`,\n    icon: BarChart3,\n    schema: HistogramChartSettings,\n    settingsComponent: HistogramSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    createTool: createHistogramAiTool,\n    createSpec: createHistogramSpec,\n  };\n"]}

package/dist/charts/chart-types/histogram/schema.d.ts

@@ -5,6 +5,7 @@ export declare const DEFAULT_BINS_COUNT = 20;
 export declare const HistogramChartSettings: z.ZodObject<{
     field: z.ZodOptional<z.ZodString>;
     maxBins: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    color: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type HistogramChartSettings = z.infer<typeof HistogramChartSettings>;
 export declare const HistogramChartConfig: z.ZodObject<{
@@ -12,6 +13,7 @@ export declare const HistogramChartConfig: z.ZodObject<{
     settings: z.ZodObject<{
         field: z.ZodOptional<z.ZodString>;
         maxBins: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        color: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     settingsOpen: z.ZodOptional<z.ZodBoolean>;
     dataPolicy: z.ZodOptional<z.ZodObject<{

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,sBAAsB;;;iBAejC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,sBAAsB;;;;iBAgBjC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/charts/chart-types/histogram/schema.js

@@ -16,6 +16,7 @@ export const HistogramChartSettings = z.object({
         .default(DEFAULT_BINS_COUNT)
         .optional()
         .describe(`Maximum number of bins for the histogram (default: ${DEFAULT_BINS_COUNT})`),
+    color: z.string().optional().describe('Optional color for histogram bars'),
 });
 export const HistogramChartConfig = z.object({
     chartType: z.literal('histogram'),

package/dist/charts/chart-types/histogram/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,cAAc,CAAC;SACnB,GAAG,CAAC,cAAc,CAAC;SACnB,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CACP,sDAAsD,kBAAkB,GAAG,CAC5E;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACjC,QAAQ,EAAE,sBAAsB;IAChC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\nimport {ChartDataPolicyOverrideConfig} from '../data-policy-schema';\n\nexport const MIN_BINS_COUNT = 1;\nexport const MAX_BINS_COUNT = 1000;\nexport const DEFAULT_BINS_COUNT = 20;\n\nexport const HistogramChartSettings = z.object({\n  field: z\n    .string()\n    .optional()\n    .describe('Numeric column to create histogram distribution for'),\n  maxBins: z\n    .number()\n    .int()\n    .min(MIN_BINS_COUNT)\n    .max(MAX_BINS_COUNT)\n    .default(DEFAULT_BINS_COUNT)\n    .optional()\n    .describe(\n      `Maximum number of bins for the histogram (default: ${DEFAULT_BINS_COUNT})`,\n    ),\n});\n\nexport type HistogramChartSettings = z.infer<typeof HistogramChartSettings>;\n\nexport const HistogramChartConfig = z.object({\n  chartType: z.literal('histogram'),\n  settings: HistogramChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type HistogramChartConfig = z.infer<typeof HistogramChartConfig>;\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,cAAc,CAAC;SACnB,GAAG,CAAC,cAAc,CAAC;SACnB,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CACP,sDAAsD,kBAAkB,GAAG,CAC5E;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC3E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACjC,QAAQ,EAAE,sBAAsB;IAChC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\nimport {ChartDataPolicyOverrideConfig} from '../data-policy-schema';\n\nexport const MIN_BINS_COUNT = 1;\nexport const MAX_BINS_COUNT = 1000;\nexport const DEFAULT_BINS_COUNT = 20;\n\nexport const HistogramChartSettings = z.object({\n  field: z\n    .string()\n    .optional()\n    .describe('Numeric column to create histogram distribution for'),\n  maxBins: z\n    .number()\n    .int()\n    .min(MIN_BINS_COUNT)\n    .max(MAX_BINS_COUNT)\n    .default(DEFAULT_BINS_COUNT)\n    .optional()\n    .describe(\n      `Maximum number of bins for the histogram (default: ${DEFAULT_BINS_COUNT})`,\n    ),\n  color: z.string().optional().describe('Optional color for histogram bars'),\n});\n\nexport type HistogramChartSettings = z.infer<typeof HistogramChartSettings>;\n\nexport const HistogramChartConfig = z.object({\n  chartType: z.literal('histogram'),\n  settings: HistogramChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type HistogramChartConfig = z.infer<typeof HistogramChartConfig>;\n"]}

package/dist/charts/chart-types/histogram/spec.d.ts

@@ -1,4 +1,5 @@
 import type { Spec } from '@uwdata/mosaic-spec';
 import { HistogramChartSettings } from './schema';
-export declare function createHistogramSpec(tableName: string, { field, maxBins }: HistogramChartSettings): Spec;
+import { CreateSpecOptions } from '../base-types';
+export declare function createHistogramSpec(options: CreateSpecOptions<HistogramChartSettings>): Spec;
 //# sourceMappingURL=spec.d.ts.map