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

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

@@ -3,6 +3,7 @@ import { titleFromDescription } from '../../chart-builders/chartTypeUtils';
 import { CustomSpecSettingsComponent } from './CustomSpecSettings';
 import { Code } from 'lucide-react';
 import { createCustomSpec } from './spec';
+import { DEFAULT_CHART_MAX_DATA_POINTS } from '../../chart-runtime';
 const DESCRIPTION = 'Create a chart with custom spec';
 export const customSpecChartType = {
     id: 'custom-spec',
@@ -12,6 +13,10 @@ export const customSpecChartType = {
     schema: CustomSpecChartSettings,
     settingsComponent: CustomSpecSettingsComponent,
     buildTitle: titleFromDescription(DESCRIPTION),
+    getDataPolicy: () => ({
+        maxRows: DEFAULT_CHART_MAX_DATA_POINTS,
+        reason: 'Custom specs are validated conservatively because SQLRooms cannot infer whether each mark is aggregated.',
+    }),
     createSpec: createCustomSpec,
 };
 //# sourceMappingURL=definition.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACxE,OAAO,EAAC,oBAAoB,EAAC,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAC,2BAA2B,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAC,gBAAgB,EAAC,MAAM,QAAQ,CAAC;AAExC,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,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';\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    createSpec: createCustomSpec,\n  };\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACxE,OAAO,EAAC,oBAAoB,EAAC,MAAM,qCAAqC,CAAC;AACzE,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,qBAAqB,CAAC;AAElE,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"]}

package/dist/chart-types/custom-spec/schema.d.ts

@@ -9,6 +9,11 @@ export declare const CustomSpecChartConfig: z.ZodObject<{
     settings: z.ZodObject<{
         vgPlotSpec: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$strip>;
+    dataPolicy: z.ZodOptional<z.ZodObject<{
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CustomSpecChartConfig = z.infer<typeof CustomSpecChartConfig>;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,qBAAqB;;;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/chart-types/custom-spec/schema.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ChartDataPolicyOverrideConfig } from '../data-policy-schema';
 export const CustomSpecChartSettings = z.object({
     vgPlotSpec: z.unknown().optional(),
 });
@@ -6,5 +7,6 @@ export const CustomSpecChartConfig = z.object({
     chartType: z.literal('custom-spec'),
     settingsOpen: z.boolean().optional(),
     settings: CustomSpecChartSettings,
+    dataPolicy: ChartDataPolicyOverrideConfig.optional(),
 });
 //# sourceMappingURL=schema.js.map

package/dist/chart-types/custom-spec/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,uBAAuB;CAClC,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const CustomSpecChartSettings = z.object({\n  vgPlotSpec: z.unknown().optional(),\n});\n\nexport type CustomSpecChartSettings = z.infer<typeof CustomSpecChartSettings>;\n\nexport const CustomSpecChartConfig = z.object({\n  chartType: z.literal('custom-spec'),\n  settingsOpen: z.boolean().optional(),\n  settings: CustomSpecChartSettings,\n});\n\nexport type CustomSpecChartConfig = z.infer<typeof CustomSpecChartConfig>;\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/chart-types/custom-spec/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\nimport {ChartDataPolicyOverrideConfig} from '../data-policy-schema';\n\nexport const CustomSpecChartSettings = z.object({\n  vgPlotSpec: z.unknown().optional(),\n});\n\nexport type CustomSpecChartSettings = z.infer<typeof CustomSpecChartSettings>;\n\nexport const CustomSpecChartConfig = z.object({\n  chartType: z.literal('custom-spec'),\n  settingsOpen: z.boolean().optional(),\n  settings: CustomSpecChartSettings,\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type CustomSpecChartConfig = z.infer<typeof CustomSpecChartConfig>;\n"]}

package/dist/chart-types/data-policy-schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const ChartDataPolicyOverrideConfig: z.ZodObject<{
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChartDataPolicyOverrideConfig = z.infer<typeof ChartDataPolicyOverrideConfig>;
+//# sourceMappingURL=data-policy-schema.d.ts.map

package/dist/chart-types/data-policy-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-policy-schema.d.ts","sourceRoot":"","sources":["../../src/chart-types/data-policy-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAC"}

package/dist/chart-types/data-policy-schema.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const ChartDataPolicyOverrideConfig = z.object({
+    disabled: z.boolean().optional(),
+    maxRows: z.number().int().min(1).optional(),
+    reason: z.string().optional(),
+});
+//# sourceMappingURL=data-policy-schema.js.map

package/dist/chart-types/data-policy-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-policy-schema.js","sourceRoot":"","sources":["../../src/chart-types/data-policy-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const ChartDataPolicyOverrideConfig = z.object({\n  disabled: z.boolean().optional(),\n  maxRows: z.number().int().min(1).optional(),\n  reason: z.string().optional(),\n});\n\nexport type ChartDataPolicyOverrideConfig = z.infer<\n  typeof ChartDataPolicyOverrideConfig\n>;\n"]}

package/dist/chart-types/heatmap/schema.d.ts

@@ -11,6 +11,11 @@ export declare const HeatmapChartConfig: z.ZodObject<{
         y: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    dataPolicy: z.ZodOptional<z.ZodObject<{
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type HeatmapChartConfig = z.infer<typeof HeatmapChartConfig>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/chart-types/heatmap/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/chart-types/heatmap/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;;iBAI7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/chart-types/heatmap/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/chart-types/heatmap/schema.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ChartDataPolicyOverrideConfig } from '../data-policy-schema';
 export const HeatmapChartSettings = z.object({
     x: z.string().optional().describe('Column for X axis'),
     y: z.string().optional().describe('Column for Y axis'),
@@ -7,5 +8,6 @@ export const HeatmapChartConfig = z.object({
     chartType: z.literal('heatmap'),
     settings: HeatmapChartSettings,
     settingsOpen: z.boolean().optional(),
+    dataPolicy: ChartDataPolicyOverrideConfig.optional(),
 });
 //# sourceMappingURL=schema.js.map

package/dist/chart-types/heatmap/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/chart-types/heatmap/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACtD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACvD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC/B,QAAQ,EAAE,oBAAoB;IAC9B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const HeatmapChartSettings = z.object({\n  x: z.string().optional().describe('Column for X axis'),\n  y: z.string().optional().describe('Column for Y axis'),\n});\n\nexport type HeatmapChartSettings = z.infer<typeof HeatmapChartSettings>;\n\nexport const HeatmapChartConfig = z.object({\n  chartType: z.literal('heatmap'),\n  settings: HeatmapChartSettings,\n  settingsOpen: z.boolean().optional(),\n});\n\nexport type HeatmapChartConfig = z.infer<typeof HeatmapChartConfig>;\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/chart-types/heatmap/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACtD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACvD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC/B,QAAQ,EAAE,oBAAoB;IAC9B,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 HeatmapChartSettings = z.object({\n  x: z.string().optional().describe('Column for X axis'),\n  y: z.string().optional().describe('Column for Y axis'),\n});\n\nexport type HeatmapChartSettings = z.infer<typeof HeatmapChartSettings>;\n\nexport const HeatmapChartConfig = z.object({\n  chartType: z.literal('heatmap'),\n  settings: HeatmapChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type HeatmapChartConfig = z.infer<typeof HeatmapChartConfig>;\n"]}

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

@@ -1,9 +1,10 @@
 import { z } from 'zod';
-import { type ChartToolDeps } from '../base-types';
+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>>;
+    panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
         x: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
@@ -11,7 +12,7 @@ export declare const HeatmapToolParameters: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type HeatmapToolParams = z.infer<typeof HeatmapToolParameters>;
-export declare function createHeatmapAiTool(deps: ChartToolDeps): import("ai").Tool<{
+export declare function createHeatmapAiTool(deps: DashboardToolDeps): import("ai").Tool<{
     createArtifactIfMissing: boolean;
     reasoning: string;
     settings: {
@@ -20,17 +21,12 @@ export declare function createHeatmapAiTool(deps: ChartToolDeps): import("ai").T
     };
     artifactId?: string | undefined;
     tableName?: string | undefined;
+    panelId?: string | undefined;
 }, {
     llmResult: {
         success: boolean;
         details: string;
-        data: {
-            panelId: string;
-            artifactId: string;
-            tableName: string;
-            title: string;
-            config: any;
-        };
+        data: import("..").PanelResult;
         errorMessage?: undefined;
     };
 } | {

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/chart-types/heatmap/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,EAAC,KAAK,aAAa,EAAC,MAAM,eAAe,CAAC;AAIjD,eAAO,MAAM,qBAAqB;;;;;;;;;iBAEhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEtD"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/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"}

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

@@ -3,6 +3,7 @@ import { HeatmapChartSettings } from './schema';
 import { BaseChartToolParameters } from '../tool-schemas';
 import { validateColumnExists } from '../tool-validation';
 import { NUMERIC_COLUMN_TYPES } from '../../chart-builders/constants';
+import { createOrUpdateChartPanel } from '../tool-helpers';
 export const HeatmapToolParameters = BaseChartToolParameters.extend({
     settings: HeatmapChartSettings.required(),
 });
@@ -15,32 +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.
+
 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) => {
             try {
-                const { artifactId, tableName, columns } = deps.resolveResources(params, context);
+                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 title = params.settings.x && params.settings.y
-                    ? `Heatmap - ${params.settings.x} vs ${params.settings.y}`
-                    : 'Heatmap';
-                const result = deps.createChart({
-                    artifactId,
+                const result = createOrUpdateChartPanel(deps, {
+                    panelId: params.panelId,
+                    dashboardId: artifactId,
                     tableName,
+                    title: params.settings.x && params.settings.y
+                        ? `Heatmap - ${params.settings.x} vs ${params.settings.y}`
+                        : 'Heatmap',
                     config: {
                         chartType: 'heatmap',
                         settings: params.settings,
                     },
-                    title,
                 });
                 return {
                     llmResult: {
                         success: true,
-                        details: `Created heatmap "${result.title}".`,
+                        details: params.panelId
+                            ? `Updated heatmap "${result.title}".`
+                            : `Created heatmap "${result.title}".`,
                         data: result,
                     },
                 };

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

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/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,iBAAiB,CAAC;AAExD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;uCAKsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;uIAIiE;QACnI,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,EAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,gBAAgB,CAC5D,MAAM,EACN,OAAO,CACR,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,KAAK,GACT,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACpC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE;oBAC1D,CAAC,CAAC,SAAS,CAAC;gBAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;oBAC9B,UAAU;oBACV,SAAS;oBACT,MAAM,EAAE;wBACN,SAAS,EAAE,SAAS;wBACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;oBACD,KAAK;iBACN,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,oBAAoB,MAAM,CAAC,KAAK,IAAI;wBAC7C,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 '../tool-schemas';\nimport {type ChartToolDeps} from '../base-types';\nimport {validateColumnExists} from '../tool-validation';\nimport {NUMERIC_COLUMN_TYPES} from '../../chart-builders/constants';\n\nexport const HeatmapToolParameters = BaseChartToolParameters.extend({\n  settings: HeatmapChartSettings.required(),\n});\n\nexport type HeatmapToolParams = z.infer<typeof HeatmapToolParameters>;\n\nexport function createHeatmapAiTool(deps: ChartToolDeps) {\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\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, tableName, columns} = deps.resolveResources(\n          params,\n          context,\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 title =\n          params.settings.x && params.settings.y\n            ? `Heatmap - ${params.settings.x} vs ${params.settings.y}`\n            : 'Heatmap';\n\n        const result = deps.createChart({\n          artifactId,\n          tableName,\n          config: {\n            chartType: 'heatmap',\n            settings: params.settings,\n          },\n          title,\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: `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/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,iBAAiB,CAAC;AAExD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAC,wBAAwB,EAAC,MAAM,iBAAiB,CAAC;AAEzD,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 '../tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../tool-validation';\nimport {NUMERIC_COLUMN_TYPES} from '../../chart-builders/constants';\nimport {createOrUpdateChartPanel} from '../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"]}

package/dist/chart-types/histogram/HistogramSettings.d.ts.map

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

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

@@ -1,9 +1,11 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Input } from '@sqlrooms/ui';
 import { Field } from '../../chart-builders/Field';
 import { ColumnSelector } from '../../chart-builders/ColumnSelector';
 import { useChartSettingsContext } from '../../chart/chart-settings/ChartSettingsContext';
+import { MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT } from './schema';
 export const HistogramSettingsComponent = () => {
     const { onChangeConfig, config } = useChartSettingsContext('histogram');
-    return (_jsx("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) }) }) }));
+    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) }) })] }));
 };
 //# sourceMappingURL=HistogramSettings.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"HistogramSettings.js","sourceRoot":"","sources":["../../../src/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,KAAK,EAAC,MAAM,4BAA4B,CAAC;AACjD,OAAO,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAC,uBAAuB,EAAC,MAAM,iDAAiD,CAAC;AAExF,MAAM,CAAC,MAAM,0BAA0B,GAAO,GAAG,EAAE;IACjD,MAAM,EAAC,cAAc,EAAE,MAAM,EAAC,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAEtE,OAAO,CACL,cAAK,SAAS,EAAC,WAAW,YACxB,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,GACJ,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {type FC} from 'react';\nimport {Field} from '../../chart-builders/Field';\nimport {ColumnSelector} from '../../chart-builders/ColumnSelector';\nimport {useChartSettingsContext} from '../../chart/chart-settings/ChartSettingsContext';\n\nexport const HistogramSettingsComponent: FC = () => {\n  const {onChangeConfig, config} = useChartSettingsContext('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    </div>\n  );\n};\n"]}
+{"version":3,"file":"HistogramSettings.js","sourceRoot":"","sources":["../../../src/chart-types/histogram/HistogramSettings.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,KAAK,EAAC,MAAM,cAAc,CAAC;AACnC,OAAO,EAAC,KAAK,EAAC,MAAM,4BAA4B,CAAC;AACjD,OAAO,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAC,uBAAuB,EAAC,MAAM,iDAAiD,CAAC;AACxF,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,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAEtE,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 '../../chart-builders/Field';\nimport {ColumnSelector} from '../../chart-builders/ColumnSelector';\nimport {useChartSettingsContext} from '../../chart/chart-settings/ChartSettingsContext';\nimport {MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT} from './schema';\n\nexport const HistogramSettingsComponent: FC = () => {\n  const {onChangeConfig, config} = useChartSettingsContext('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"]}

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

@@ -1,14 +1,24 @@
 import { z } from 'zod';
+export declare const MIN_BINS_COUNT = 1;
+export declare const MAX_BINS_COUNT = 1000;
+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>>;
 }, z.core.$strip>;
 export type HistogramChartSettings = z.infer<typeof HistogramChartSettings>;
 export declare const HistogramChartConfig: z.ZodObject<{
     chartType: z.ZodLiteral<"histogram">;
     settings: z.ZodObject<{
         field: z.ZodOptional<z.ZodString>;
+        maxBins: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, z.core.$strip>;
     settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    dataPolicy: z.ZodOptional<z.ZodObject<{
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type HistogramChartConfig = z.infer<typeof HistogramChartConfig>;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,sBAAsB;;iBAKjC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/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"}

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

@@ -1,13 +1,26 @@
 import { z } from 'zod';
+import { ChartDataPolicyOverrideConfig } from '../data-policy-schema';
+export const MIN_BINS_COUNT = 1;
+export const MAX_BINS_COUNT = 1000;
+export const DEFAULT_BINS_COUNT = 20;
 export const HistogramChartSettings = z.object({
     field: z
         .string()
         .optional()
         .describe('Numeric column to create histogram distribution for'),
+    maxBins: z
+        .number()
+        .int()
+        .min(MIN_BINS_COUNT)
+        .max(MAX_BINS_COUNT)
+        .default(DEFAULT_BINS_COUNT)
+        .optional()
+        .describe(`Maximum number of bins for the histogram (default: ${DEFAULT_BINS_COUNT})`),
 });
 export const HistogramChartConfig = z.object({
     chartType: z.literal('histogram'),
     settings: HistogramChartSettings,
     settingsOpen: z.boolean().optional(),
+    dataPolicy: ChartDataPolicyOverrideConfig.optional(),
 });
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/chart-types/histogram/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,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;CACrC,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const HistogramChartSettings = z.object({\n  field: z\n    .string()\n    .optional()\n    .describe('Numeric column to create histogram distribution for'),\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});\n\nexport type HistogramChartConfig = z.infer<typeof HistogramChartConfig>;\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/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"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/chart-types/histogram/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAMhD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,EAAC,KAAK,EAAC,EAAE,sBAAsB,GAC9B,IAAI,CAgCN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/chart-types/histogram/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAqB,MAAM,UAAU,CAAC;AAMpE,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,EAAC,KAAK,EAAE,OAA4B,EAAC,EAAE,sBAAsB,GAC5D,IAAI,CAgCN"}

package/dist/chart-types/histogram/spec.js

@@ -1,7 +1,8 @@
+import { DEFAULT_BINS_COUNT } from './schema';
 import { SpecGenerationError } from '../errors';
 const BG_COLOR = 'var(--color-chart-overlay)';
 const FG_COLOR = 'var(--color-chart-1)';
-export function createHistogramSpec(tableName, { field }) {
+export function createHistogramSpec(tableName, { field, maxBins = DEFAULT_BINS_COUNT }) {
     if (!field) {
         throw new SpecGenerationError('Field is required for histogram');
     }
@@ -10,7 +11,7 @@ export function createHistogramSpec(tableName, { field }) {
             {
                 mark: 'rectY',
                 data: { from: tableName },
-                x: { bin: field, maxbins: 40 },
+                x: { bin: field, steps: maxBins },
                 y: { count: null },
                 fill: BG_COLOR,
                 inset: 0.5,
@@ -18,7 +19,7 @@ export function createHistogramSpec(tableName, { field }) {
             {
                 mark: 'rectY',
                 data: { from: tableName, filterBy: '$brush' },
-                x: { bin: field, maxbins: 40 },
+                x: { bin: field, steps: maxBins },
                 y: { count: null },
                 fill: FG_COLOR,
                 inset: 0.5,

package/dist/chart-types/histogram/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../src/chart-types/histogram/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAC;AAE9C,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,EAAC,KAAK,EAAyB;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;gBACvB,CAAC,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAC;gBAC5B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAC;gBAC5B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC;SACpC;QACD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,OAAO;QACf,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 {HistogramChartSettings} from './schema';\nimport {SpecGenerationError} from '../errors';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createHistogramSpec(\n  tableName: string,\n  {field}: HistogramChartSettings,\n): Spec {\n  if (!field) {\n    throw new SpecGenerationError('Field is required for histogram');\n  }\n\n  return {\n    plot: [\n      {\n        mark: 'rectY',\n        data: {from: tableName},\n        x: {bin: field, maxbins: 40},\n        y: {count: null},\n        fill: BG_COLOR,\n        inset: 0.5,\n      },\n      {\n        mark: 'rectY',\n        data: {from: tableName, filterBy: '$brush'},\n        x: {bin: field, maxbins: 40},\n        y: {count: null},\n        fill: FG_COLOR,\n        inset: 0.5,\n      },\n      {select: 'intervalX', as: '$brush'},\n    ],\n    xLabel: field,\n    yLabel: 'Count',\n    height: 200,\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/chart-types/histogram/spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,kBAAkB,EAAC,MAAM,UAAU,CAAC;AACpE,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAC;AAE9C,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,EAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,EAAyB;IAE7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;gBACvB,CAAC,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAC;gBAC/B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC,EAAE,EAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAC;gBAC/B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC;SACpC;QACD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,OAAO;QACf,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 {HistogramChartSettings, DEFAULT_BINS_COUNT} from './schema';\nimport {SpecGenerationError} from '../errors';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createHistogramSpec(\n  tableName: string,\n  {field, maxBins = DEFAULT_BINS_COUNT}: HistogramChartSettings,\n): Spec {\n  if (!field) {\n    throw new SpecGenerationError('Field is required for histogram');\n  }\n\n  return {\n    plot: [\n      {\n        mark: 'rectY',\n        data: {from: tableName},\n        x: {bin: field, steps: maxBins},\n        y: {count: null},\n        fill: BG_COLOR,\n        inset: 0.5,\n      },\n      {\n        mark: 'rectY',\n        data: {from: tableName, filterBy: '$brush'},\n        x: {bin: field, steps: maxBins},\n        y: {count: null},\n        fill: FG_COLOR,\n        inset: 0.5,\n      },\n      {select: 'intervalX', as: '$brush'},\n    ],\n    xLabel: field,\n    yLabel: 'Count',\n    height: 200,\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/chart-types/histogram/tool.d.ts

@@ -1,34 +1,32 @@
 import { z } from 'zod';
-import type { ChartToolDeps } from '../base-types';
+import type { DashboardToolDeps } from '../base-types';
 export declare const HistogramToolParameters: z.ZodObject<{
     artifactId: z.ZodOptional<z.ZodString>;
     tableName: z.ZodOptional<z.ZodString>;
     createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
         field: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+        maxBins: z.ZodNonOptional<z.ZodOptional<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type HistogramToolParams = z.infer<typeof HistogramToolParameters>;
-export declare function createHistogramAiTool(deps: ChartToolDeps): import("ai").Tool<{
+export declare function createHistogramAiTool(deps: DashboardToolDeps): import("ai").Tool<{
     createArtifactIfMissing: boolean;
     reasoning: string;
     settings: {
         field: string;
+        maxBins: number;
     };
     artifactId?: string | undefined;
     tableName?: string | undefined;
+    panelId?: string | undefined;
 }, {
     llmResult: {
         success: boolean;
         details: string;
-        data: {
-            panelId: string;
-            artifactId: string;
-            tableName: string;
-            title: string;
-            config: any;
-        };
+        data: import("..").PanelResult;
         errorMessage?: undefined;
     };
 } | {

package/dist/chart-types/histogram/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/chart-types/histogram/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAIjD,eAAO,MAAM,uBAAuB;;;;;;;;iBAElC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDxD"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/chart-types/histogram/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAQtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAKrD,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAElC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;GAqE5D"}

package/dist/chart-types/histogram/tool.js

@@ -1,8 +1,9 @@
 import { tool } from 'ai';
-import { HistogramChartSettings } from './schema';
+import { HistogramChartSettings, MIN_BINS_COUNT, MAX_BINS_COUNT, DEFAULT_BINS_COUNT, } from './schema';
 import { BaseChartToolParameters } from '../tool-schemas';
 import { validateColumnExists } from '../tool-validation';
 import { QUANTITATIVE_COLUMN_TYPES } from '../../chart-builders/constants';
+import { createOrUpdateChartPanel } from '../tool-helpers';
 export const HistogramToolParameters = BaseChartToolParameters.extend({
     settings: HistogramChartSettings.required(),
 });
@@ -15,28 +16,37 @@ Example queries: "distribution of population density", "show elevation distribut
 
 Required: field must be quantitative not text/categorical: (${QUANTITATIVE_COLUMN_TYPES.join(', ')}).
 
+NOTE: Histograms automatically bin data into ranges and aggregate counts, so they handle large datasets efficiently (no data point limit).
+
+To UPDATE an existing histogram: provide the panelId parameter. Otherwise creates new panel.
+
+Optional: maxBins (${MIN_BINS_COUNT}-${MAX_BINS_COUNT}, default ${DEFAULT_BINS_COUNT}) controls the number of bins/bars in the histogram. Use fewer bins for coarse overview, more bins for detailed distribution.
+
 CRITICAL: Only for quantitative continuous data to see distribution shape, outliers, skewness.
 Do NOT use for: categorical data (use count-plot), relationships between columns (use bubble-chart), time series trends (use line-chart).`,
         inputSchema: HistogramToolParameters,
         execute: async (params, context) => {
             try {
-                const { artifactId, tableName, columns } = deps.resolveResources(params, context);
+                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
+                const { tableName, columns } = deps.resolveTable(artifactId, params.tableName);
                 // Validate settings
                 validateColumnExists(params.settings.field, QUANTITATIVE_COLUMN_TYPES, columns, 'field');
-                const title = `Histogram of ${params.settings.field}`;
-                const result = deps.createChart({
-                    artifactId,
+                const result = createOrUpdateChartPanel(deps, {
+                    panelId: params.panelId,
+                    dashboardId: artifactId,
                     tableName,
+                    title: `Histogram of ${params.settings.field}`,
                     config: {
                         chartType: 'histogram',
                         settings: params.settings,
                     },
-                    title,
                 });
                 return {
                     llmResult: {
                         success: true,
-                        details: `Created histogram "${result.title}".`,
+                        details: params.panelId
+                            ? `Updated histogram "${result.title}".`
+                            : `Created histogram "${result.title}".`,
                         data: result,
                     },
                 };

package/dist/chart-types/histogram/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/chart-types/histogram/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAChD,OAAO,EAAC,uBAAuB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,yBAAyB,EAAC,MAAM,gCAAgC,CAAC;AAEzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAmB;IACvD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;8DAK6C,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;;;0IAGwC;QACtI,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,EAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,gBAAgB,CAC5D,MAAM,EACN,OAAO,CACR,CAAC;gBAEF,oBAAoB;gBACpB,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EACrB,yBAAyB,EACzB,OAAO,EACP,OAAO,CACR,CAAC;gBAEF,MAAM,KAAK,GAAG,gBAAgB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAEtD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;oBAC9B,UAAU;oBACV,SAAS;oBACT,MAAM,EAAE;wBACN,SAAS,EAAE,WAAW;wBACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;oBACD,KAAK;iBACN,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,sBAAsB,MAAM,CAAC,KAAK,IAAI;wBAC/C,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 {HistogramChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../tool-schemas';\nimport type {ChartToolDeps} from '../base-types';\nimport {validateColumnExists} from '../tool-validation';\nimport {QUANTITATIVE_COLUMN_TYPES} from '../../chart-builders/constants';\n\nexport const HistogramToolParameters = BaseChartToolParameters.extend({\n  settings: HistogramChartSettings.required(),\n});\n\nexport type HistogramToolParams = z.infer<typeof HistogramToolParameters>;\n\nexport function createHistogramAiTool(deps: ChartToolDeps) {\n  return tool({\n    description: `Histogram: shows distribution of numeric values by automatically grouping data into bins/ranges.\n\nUse when: user asks about \"distribution of [numeric column]\", \"spread of\", \"range of\", \"how values are distributed\", \"show histogram\".\nExample queries: \"distribution of population density\", \"show elevation distribution\", \"histogram of parcel areas\", \"how are building heights spread\", \"temperature range distribution\".\n\nRequired: field must be quantitative not text/categorical: (${QUANTITATIVE_COLUMN_TYPES.join(', ')}).\n\nCRITICAL: Only for quantitative continuous data to see distribution shape, outliers, skewness.\nDo NOT use for: categorical data (use count-plot), relationships between columns (use bubble-chart), time series trends (use line-chart).`,\n    inputSchema: HistogramToolParameters,\n    execute: async (params, context) => {\n      try {\n        const {artifactId, tableName, columns} = deps.resolveResources(\n          params,\n          context,\n        );\n\n        // Validate settings\n        validateColumnExists(\n          params.settings.field,\n          QUANTITATIVE_COLUMN_TYPES,\n          columns,\n          'field',\n        );\n\n        const title = `Histogram of ${params.settings.field}`;\n\n        const result = deps.createChart({\n          artifactId,\n          tableName,\n          config: {\n            chartType: 'histogram',\n            settings: params.settings,\n          },\n          title,\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: `Created histogram \"${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/chart-types/histogram/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,uBAAuB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,yBAAyB,EAAC,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAC,wBAAwB,EAAC,MAAM,iBAAiB,CAAC;AAEzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;8DAK6C,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;qBAM7E,cAAc,IAAI,cAAc,aAAa,kBAAkB;;;0IAGsD;QACtI,WAAW,EAAE,uBAAuB;QACpC,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;gBACpB,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EACrB,yBAAyB,EACzB,OAAO,EACP,OAAO,CACR,CAAC;gBAEF,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE;oBAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,SAAS;oBACT,KAAK,EAAE,gBAAgB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC9C,MAAM,EAAE;wBACN,SAAS,EAAE,WAAW;wBACtB,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,sBAAsB,MAAM,CAAC,KAAK,IAAI;4BACxC,CAAC,CAAC,sBAAsB,MAAM,CAAC,KAAK,IAAI;wBAC1C,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 {\n  HistogramChartSettings,\n  MIN_BINS_COUNT,\n  MAX_BINS_COUNT,\n  DEFAULT_BINS_COUNT,\n} from './schema';\nimport {BaseChartToolParameters} from '../tool-schemas';\nimport type {DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../tool-validation';\nimport {QUANTITATIVE_COLUMN_TYPES} from '../../chart-builders/constants';\nimport {createOrUpdateChartPanel} from '../tool-helpers';\n\nexport const HistogramToolParameters = BaseChartToolParameters.extend({\n  settings: HistogramChartSettings.required(),\n});\n\nexport type HistogramToolParams = z.infer<typeof HistogramToolParameters>;\n\nexport function createHistogramAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Histogram: shows distribution of numeric values by automatically grouping data into bins/ranges.\n\nUse when: user asks about \"distribution of [numeric column]\", \"spread of\", \"range of\", \"how values are distributed\", \"show histogram\".\nExample queries: \"distribution of population density\", \"show elevation distribution\", \"histogram of parcel areas\", \"how are building heights spread\", \"temperature range distribution\".\n\nRequired: field must be quantitative not text/categorical: (${QUANTITATIVE_COLUMN_TYPES.join(', ')}).\n\nNOTE: Histograms automatically bin data into ranges and aggregate counts, so they handle large datasets efficiently (no data point limit).\n\nTo UPDATE an existing histogram: provide the panelId parameter. Otherwise creates new panel.\n\nOptional: maxBins (${MIN_BINS_COUNT}-${MAX_BINS_COUNT}, default ${DEFAULT_BINS_COUNT}) controls the number of bins/bars in the histogram. Use fewer bins for coarse overview, more bins for detailed distribution.\n\nCRITICAL: Only for quantitative continuous data to see distribution shape, outliers, skewness.\nDo NOT use for: categorical data (use count-plot), relationships between columns (use bubble-chart), time series trends (use line-chart).`,\n    inputSchema: HistogramToolParameters,\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        validateColumnExists(\n          params.settings.field,\n          QUANTITATIVE_COLUMN_TYPES,\n          columns,\n          'field',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: `Histogram of ${params.settings.field}`,\n          config: {\n            chartType: 'histogram',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated histogram \"${result.title}\".`\n              : `Created histogram \"${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"]}