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

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

@@ -25,6 +25,7 @@ export declare const ChartConfig: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [
     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<{
@@ -67,6 +68,7 @@ export declare const ChartConfig: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [
                 avg: "avg";
             }>>>;
         }, z.core.$strip>>>;
+        showLegend: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>;
     settingsOpen: z.ZodOptional<z.ZodBoolean>;
     dataPolicy: z.ZodOptional<z.ZodObject<{
@@ -75,7 +77,7 @@ export declare const ChartConfig: z.ZodUnion<[z.ZodDiscriminatedUnion<readonly [
         reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
-    chartType: z.ZodLiteral<"bubble-chart">;
+    chartType: z.ZodLiteral<"scatter-plot">;
     settings: z.ZodObject<{
         x: z.ZodOptional<z.ZodString>;
         y: z.ZodOptional<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"chart-config.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/chart-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAYtB,eAAO,MAAM,mBAAmB,wCAAoC,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgBtE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEA,CAAC;AAEzB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"chart-config.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/chart-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAYtB,eAAO,MAAM,mBAAmB,wCAAoC,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgBtE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEA,CAAC;AAEzB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC"}

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

@@ -7,7 +7,7 @@ import { z } from 'zod';
 import { HistogramChartConfig } from './histogram/schema';
 import { CountPlotChartConfig } from './count-plot/schema';
 import { LineChartConfig } from './line-chart/schema';
-import { BubbleChartConfig } from './bubble-chart/schema';
+import { ScatterPlotChartConfig } from './scatter-plot/schema';
 import { HeatmapChartConfig } from './heatmap/schema';
 import { BoxPlotChartConfig } from './box-plot/schema';
 import { CustomSpecChartConfig } from './custom-spec/schema';
@@ -17,7 +17,7 @@ const KNOWN_CHART_CONFIGS = [
     HistogramChartConfig,
     CountPlotChartConfig,
     LineChartConfig,
-    BubbleChartConfig,
+    ScatterPlotChartConfig,
     HeatmapChartConfig,
     BoxPlotChartConfig,
     CustomSpecChartConfig,

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

@@ -1 +1 @@
-{"version":3,"file":"chart-config.js","sourceRoot":"","sources":["../../../src/charts/chart-types/chart-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,uDAAuD;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,6BAA6B,EAAC,MAAM,sBAAsB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAIrE,MAAM,mBAAmB,GAAG;IAC1B,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;CACb,CAAC;AAEX,MAAM,iBAAiB,GAAa,mBAAmB,CAAC,GAAG,CACzD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACtE,OAAO,EAAE,wDAAwD;KAClE,CAAC;IACF,QAAQ,EAAE,mBAAmB;IAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,CAAC;KACpD,EAAE,CAAC,iBAAiB,CAAC,CAAC","sourcesContent":["/**\n * Central ChartConfig discriminated union.\n * Separated from index.ts to avoid circular dependencies with Settings components.\n */\n\nimport {z} from 'zod';\n\n// Import only the Zod schemas (no Settings components)\nimport {HistogramChartConfig} from './histogram/schema';\nimport {CountPlotChartConfig} from './count-plot/schema';\nimport {LineChartConfig} from './line-chart/schema';\nimport {BubbleChartConfig} from './bubble-chart/schema';\nimport {HeatmapChartConfig} from './heatmap/schema';\nimport {BoxPlotChartConfig} from './box-plot/schema';\nimport {CustomSpecChartConfig} from './custom-spec/schema';\nimport {ChartDataPolicyOverrideConfig} from './data-policy-schema';\n\nexport const CustomChartSettings = z.record(z.string(), z.unknown());\n\nexport type CustomChartSettings = z.infer<typeof CustomChartSettings>;\n\nconst KNOWN_CHART_CONFIGS = [\n  HistogramChartConfig,\n  CountPlotChartConfig,\n  LineChartConfig,\n  BubbleChartConfig,\n  HeatmapChartConfig,\n  BoxPlotChartConfig,\n  CustomSpecChartConfig,\n] as const;\n\nconst KNOWN_CHART_TYPES: string[] = KNOWN_CHART_CONFIGS.map(\n  (config) => config.shape.chartType.value,\n);\n\nexport const CustomChartConfig = z.object({\n  chartType: z.string().refine((val) => !KNOWN_CHART_TYPES.includes(val), {\n    message: 'Custom chart type cannot use reserved chart type names',\n  }),\n  settings: CustomChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type CustomChartConfig = z.infer<typeof CustomChartConfig>;\n\n/**\n * Discriminated union of all chart configuration types.\n * This schema is used for runtime validation and type inference.\n */\nexport const ChartConfig = z\n  .discriminatedUnion('chartType', KNOWN_CHART_CONFIGS)\n  .or(CustomChartConfig);\n\nexport type ChartConfig = z.infer<typeof ChartConfig>;\n\nexport type ChartSettings = ChartConfig['settings'];\nexport type ChartType = ChartConfig['chartType'];\n"]}
+{"version":3,"file":"chart-config.js","sourceRoot":"","sources":["../../../src/charts/chart-types/chart-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,uDAAuD;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,6BAA6B,EAAC,MAAM,sBAAsB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAIrE,MAAM,mBAAmB,GAAG;IAC1B,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,sBAAsB;IACtB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;CACb,CAAC;AAEX,MAAM,iBAAiB,GAAa,mBAAmB,CAAC,GAAG,CACzD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACtE,OAAO,EAAE,wDAAwD;KAClE,CAAC;IACF,QAAQ,EAAE,mBAAmB;IAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,CAAC;KACpD,EAAE,CAAC,iBAAiB,CAAC,CAAC","sourcesContent":["/**\n * Central ChartConfig discriminated union.\n * Separated from index.ts to avoid circular dependencies with Settings components.\n */\n\nimport {z} from 'zod';\n\n// Import only the Zod schemas (no Settings components)\nimport {HistogramChartConfig} from './histogram/schema';\nimport {CountPlotChartConfig} from './count-plot/schema';\nimport {LineChartConfig} from './line-chart/schema';\nimport {ScatterPlotChartConfig} from './scatter-plot/schema';\nimport {HeatmapChartConfig} from './heatmap/schema';\nimport {BoxPlotChartConfig} from './box-plot/schema';\nimport {CustomSpecChartConfig} from './custom-spec/schema';\nimport {ChartDataPolicyOverrideConfig} from './data-policy-schema';\n\nexport const CustomChartSettings = z.record(z.string(), z.unknown());\n\nexport type CustomChartSettings = z.infer<typeof CustomChartSettings>;\n\nconst KNOWN_CHART_CONFIGS = [\n  HistogramChartConfig,\n  CountPlotChartConfig,\n  LineChartConfig,\n  ScatterPlotChartConfig,\n  HeatmapChartConfig,\n  BoxPlotChartConfig,\n  CustomSpecChartConfig,\n] as const;\n\nconst KNOWN_CHART_TYPES: string[] = KNOWN_CHART_CONFIGS.map(\n  (config) => config.shape.chartType.value,\n);\n\nexport const CustomChartConfig = z.object({\n  chartType: z.string().refine((val) => !KNOWN_CHART_TYPES.includes(val), {\n    message: 'Custom chart type cannot use reserved chart type names',\n  }),\n  settings: CustomChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type CustomChartConfig = z.infer<typeof CustomChartConfig>;\n\n/**\n * Discriminated union of all chart configuration types.\n * This schema is used for runtime validation and type inference.\n */\nexport const ChartConfig = z\n  .discriminatedUnion('chartType', KNOWN_CHART_CONFIGS)\n  .or(CustomChartConfig);\n\nexport type ChartConfig = z.infer<typeof ChartConfig>;\n\nexport type ChartSettings = ChartConfig['settings'];\nexport type ChartType = ChartConfig['chartType'];\n"]}

package/dist/charts/chart-types/count-plot/spec.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/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,CA6CN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAMhD,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAMxE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,GACjD,IAAI,CA4DN"}

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

@@ -1,49 +1,80 @@
-import { ChartSpecError } from '../errors';
+import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
+import { getChartTableReference } from '../base-types';
+import { isCategoricalType } from '../../../column-types-utils';
 const BG_COLOR = 'var(--color-chart-overlay)';
 const FG_COLOR = 'var(--color-chart-1)';
-export function createCountPlotSpec(tableName, { field }) {
-    if (!field) {
-        throw new ChartSpecError('Field is required for count plot');
-    }
+export function createCountPlotSpec(options) {
+    const { dataTable, selectionName } = options;
+    const { fieldColumn } = validateCountPlotSettings(options);
+    const tableReference = getChartTableReference(dataTable);
     // Count plot shows categorical frequency as horizontal bars
     // Categories on Y-axis, counts on X-axis
-    return {
-        plot: [
-            {
-                mark: 'barX',
-                data: { from: tableName },
-                x: { count: null },
-                y: { column: field, sort: { x: 'sum', order: 'desc', limit: 100 } },
-                fill: BG_COLOR,
-                inset: 0.5,
+    const plot = [
+        {
+            mark: 'barX',
+            data: { from: tableReference },
+            x: { count: null },
+            y: {
+                column: fieldColumn.name,
+                sort: { x: 'sum', order: 'desc', limit: 100 },
             },
-            {
-                mark: 'barX',
-                data: { from: tableName, filterBy: '$brush' },
-                x: { count: null },
-                y: { column: field, sort: { x: 'sum', order: 'desc', limit: 100 } },
-                fill: FG_COLOR,
-                inset: 0.5,
+            fill: BG_COLOR,
+            inset: 0.5,
+        },
+        {
+            mark: 'barX',
+            data: { from: tableReference, filterBy: '$brush' },
+            x: { count: null },
+            y: {
+                column: fieldColumn.name,
+                sort: { x: 'sum', order: 'desc', limit: 100 },
             },
-            {
-                mark: 'text',
-                data: { from: tableName, filterBy: '$brush' },
-                x: { count: null },
-                y: { column: field, sort: { x: 'sum', order: 'desc', limit: 100 } },
-                text: { count: null },
-                dx: 5,
-                textAnchor: 'start',
-                fill: 'currentColor',
-                fontSize: 11,
+            fill: FG_COLOR,
+            inset: 0.5,
+        },
+        {
+            mark: 'text',
+            data: { from: tableReference, filterBy: '$brush' },
+            x: { count: null },
+            y: {
+                column: fieldColumn.name,
+                sort: { x: 'sum', order: 'desc', limit: 100 },
             },
-            { select: 'intervalY', as: '$brush' },
-        ],
+            text: { count: null },
+            dx: 5,
+            textAnchor: 'start',
+            fill: 'currentColor',
+            fontSize: 11,
+        },
+    ];
+    if (selectionName) {
+        plot.push({ select: 'intervalY', as: '$brush' });
+    }
+    return {
+        plot,
         xLabel: 'Count',
-        yLabel: field,
+        yLabel: fieldColumn.name,
         height: 400,
         width: 380,
         margins: { left: 50, right: 50, top: 20, bottom: 50 },
         params: { brush: { select: 'crossfilter' } },
     };
 }
+function validateCountPlotSettings({ dataTable, settings: { field }, }) {
+    // Basic validation for required fields
+    if (!field) {
+        throw new RequiredFieldsError('Field');
+    }
+    // Validate field existence and type
+    const fieldColumn = dataTable.columns.find((col) => col.name === field);
+    if (!fieldColumn) {
+        throw new MissingColumnsError(field);
+    }
+    if (!isCategoricalType(fieldColumn.type)) {
+        throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');
+    }
+    return {
+        fieldColumn,
+    };
+}
 //# sourceMappingURL=spec.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAEzC,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,cAAc,CAAC,kCAAkC,CAAC,CAAC;IAC/D,CAAC;IAED,4DAA4D;IAC5D,yCAAyC;IACzC,OAAO;QACL,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;gBACvB,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,CAAC,EAAE,EAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC,EAAC;gBAC/D,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,CAAC,EAAE,EAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC,EAAC;gBAC/D,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,CAAC,EAAE,EAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC,EAAC;gBAC/D,IAAI,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBACnB,EAAE,EAAE,CAAC;gBACL,UAAU,EAAE,OAAO;gBACnB,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,EAAE;aACb;YACD,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC;SACpC;QACD,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,KAAK;QACb,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 {CountPlotChartSettings} from './schema';\nimport {ChartSpecError} from '../errors';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createCountPlotSpec(\n  tableName: string,\n  {field}: CountPlotChartSettings,\n): Spec {\n  if (!field) {\n    throw new ChartSpecError('Field is required for count plot');\n  }\n\n  // Count plot shows categorical frequency as horizontal bars\n  // Categories on Y-axis, counts on X-axis\n  return {\n    plot: [\n      {\n        mark: 'barX',\n        data: {from: tableName},\n        x: {count: null},\n        y: {column: field, sort: {x: 'sum', order: 'desc', limit: 100}},\n        fill: BG_COLOR,\n        inset: 0.5,\n      },\n      {\n        mark: 'barX',\n        data: {from: tableName, filterBy: '$brush'},\n        x: {count: null},\n        y: {column: field, sort: {x: 'sum', order: 'desc', limit: 100}},\n        fill: FG_COLOR,\n        inset: 0.5,\n      },\n      {\n        mark: 'text',\n        data: {from: tableName, filterBy: '$brush'},\n        x: {count: null},\n        y: {column: field, sort: {x: 'sum', order: 'desc', limit: 100}},\n        text: {count: null},\n        dx: 5,\n        textAnchor: 'start',\n        fill: 'currentColor',\n        fontSize: 11,\n      },\n      {select: 'intervalY', as: '$brush'},\n    ],\n    xLabel: 'Count',\n    yLabel: field,\n    height: 400,\n    width: 380,\n    margins: {left: 50, right: 50, 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/count-plot/spec.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {CountPlotChartSettings} from './schema';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {isCategoricalType} from '../../../column-types-utils';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createCountPlotSpec(\n  options: CreateSpecOptions<CountPlotChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {fieldColumn} = validateCountPlotSettings(options);\n  const tableReference = getChartTableReference(dataTable);\n\n  // Count plot shows categorical frequency as horizontal bars\n  // Categories on Y-axis, counts on X-axis\n  const plot: unknown[] = [\n    {\n      mark: 'barX',\n      data: {from: tableReference},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: BG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'barX',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: FG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'text',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      text: {count: null},\n      dx: 5,\n      textAnchor: 'start',\n      fill: 'currentColor',\n      fontSize: 11,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    xLabel: 'Count',\n    yLabel: fieldColumn.name,\n    height: 400,\n    width: 380,\n    margins: {left: 50, right: 50, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n\nfunction validateCountPlotSettings({\n  dataTable,\n  settings: {field},\n}: CreateSpecOptions<CountPlotChartSettings>) {\n  // Basic validation for required fields\n  if (!field) {\n    throw new RequiredFieldsError('Field');\n  }\n\n  // Validate field existence and type\n  const fieldColumn = dataTable.columns.find((col) => col.name === field);\n\n  if (!fieldColumn) {\n    throw new MissingColumnsError(field);\n  }\n\n  if (!isCategoricalType(fieldColumn.type)) {\n    throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');\n  }\n\n  return {\n    fieldColumn,\n  };\n}\n"]}

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

@@ -21,7 +21,7 @@ NOTE: Count plots aggregate by counting unique values, so they handle large data
 To UPDATE an existing count plot: provide the panelId parameter. Otherwise creates new panel.
 
 CRITICAL: Only for categorical data (text, categories, enums).
-Do NOT use for: numeric distributions (use histogram), relationships between columns (use bubble-chart), time series (use line-chart).`,
+Do NOT use for: numeric distributions (use histogram), relationships between columns (use scatter-plot), time series (use line-chart).`,
         inputSchema: CountPlotToolParameters,
         execute: async (params, context) => {
             try {

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

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/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,0BAA0B,CAAC;AAEjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAC,wBAAwB,EAAC,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,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;;;;;4CAK2B,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;uIAOwD;QACnI,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,iDAAiD;gBACjD,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EACrB,wBAAwB,EACxB,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,iBAAiB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC/C,MAAM,EAAE;wBACN,SAAS,EAAE,YAAY;wBACvB,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,uBAAuB,MAAM,CAAC,KAAK,IAAI;4BACzC,CAAC,CAAC,uBAAuB,MAAM,CAAC,KAAK,IAAI;wBAC3C,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 {CountPlotChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {CATEGORICAL_COLUMN_TYPES} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nexport const CountPlotToolParameters = BaseChartToolParameters.extend({\n  settings: CountPlotChartSettings.required(),\n});\n\nexport type CountPlotToolParams = z.infer<typeof CountPlotToolParameters>;\n\nexport function createCountPlotAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Count plot: horizontal bar chart showing frequency of categorical/text values. Counts how many times each unique value appears.\n\nUse when: user asks to \"count\", \"frequency of\", \"how many\", \"breakdown by category\", \"distribution of [text/category column]\".\nExample queries: \"count by land use type\", \"how many features per administrative region\", \"frequency of terrain types\", \"breakdown by zone classification\", \"count parcels by ownership type\".\n\nRequired: field must be categorical/text (${CATEGORICAL_COLUMN_TYPES.join(', ')}).\n\nNOTE: Count plots aggregate by counting unique values, so they handle large datasets efficiently (no data point limit).\n\nTo UPDATE an existing count plot: provide the panelId parameter. Otherwise creates new panel.\n\nCRITICAL: Only for categorical data (text, categories, enums).\nDo NOT use for: numeric distributions (use histogram), relationships between columns (use bubble-chart), time series (use line-chart).`,\n    inputSchema: CountPlotToolParameters,\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 - expect categorical columns\n        validateColumnExists(\n          params.settings.field,\n          CATEGORICAL_COLUMN_TYPES,\n          columns,\n          'field',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: `Count plot of ${params.settings.field}`,\n          config: {\n            chartType: 'count-plot',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated count plot \"${result.title}\".`\n              : `Created count plot \"${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/count-plot/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,0BAA0B,CAAC;AAEjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAC,wBAAwB,EAAC,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,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;;;;;4CAK2B,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;uIAOwD;QACnI,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,iDAAiD;gBACjD,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EACrB,wBAAwB,EACxB,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,iBAAiB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC/C,MAAM,EAAE;wBACN,SAAS,EAAE,YAAY;wBACvB,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,uBAAuB,MAAM,CAAC,KAAK,IAAI;4BACzC,CAAC,CAAC,uBAAuB,MAAM,CAAC,KAAK,IAAI;wBAC3C,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 {CountPlotChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {CATEGORICAL_COLUMN_TYPES} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nexport const CountPlotToolParameters = BaseChartToolParameters.extend({\n  settings: CountPlotChartSettings.required(),\n});\n\nexport type CountPlotToolParams = z.infer<typeof CountPlotToolParameters>;\n\nexport function createCountPlotAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Count plot: horizontal bar chart showing frequency of categorical/text values. Counts how many times each unique value appears.\n\nUse when: user asks to \"count\", \"frequency of\", \"how many\", \"breakdown by category\", \"distribution of [text/category column]\".\nExample queries: \"count by land use type\", \"how many features per administrative region\", \"frequency of terrain types\", \"breakdown by zone classification\", \"count parcels by ownership type\".\n\nRequired: field must be categorical/text (${CATEGORICAL_COLUMN_TYPES.join(', ')}).\n\nNOTE: Count plots aggregate by counting unique values, so they handle large datasets efficiently (no data point limit).\n\nTo UPDATE an existing count plot: provide the panelId parameter. Otherwise creates new panel.\n\nCRITICAL: Only for categorical data (text, categories, enums).\nDo NOT use for: numeric distributions (use histogram), relationships between columns (use scatter-plot), time series (use line-chart).`,\n    inputSchema: CountPlotToolParameters,\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 - expect categorical columns\n        validateColumnExists(\n          params.settings.field,\n          CATEGORICAL_COLUMN_TYPES,\n          columns,\n          'field',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: `Count plot of ${params.settings.field}`,\n          config: {\n            chartType: 'count-plot',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated count plot \"${result.title}\".`\n              : `Created count plot \"${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/charts/chart-types/createDefaultChartTypes.js

@@ -3,7 +3,7 @@ import { lineChartChartType } from './line-chart/definition';
 import { countPlotChartType } from './count-plot/definition';
 import { heatmapChartType } from './heatmap/definition';
 import { boxPlotChartType } from './box-plot/definition';
-import { bubbleChartChartType } from './bubble-chart/definition';
+import { scatterPlotChartType } from './scatter-plot/definition';
 import { customSpecChartType } from './custom-spec/definition';
 /**
  * Creates the default set of chart type definitions.
@@ -20,7 +20,7 @@ export function createDefaultChartTypes(options) {
         lineChartChartType,
         heatmapChartType,
         boxPlotChartType,
-        bubbleChartChartType,
+        scatterPlotChartType,
     ];
     if (includeCustomSpec) {
         chartTypes.push(customSpecChartType);

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

@@ -1 +1 @@
-{"version":3,"file":"createDefaultChartTypes.js","sourceRoot":"","sources":["../../../src/charts/chart-types/createDefaultChartTypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAEvC;IACC,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,IAAI,CAAC;IAC7D,MAAM,UAAU,GAA+B;QAC7C,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB;QAChB,gBAAgB;QAChB,oBAAoB;KACrB,CAAC;IAEF,IAAI,iBAAiB,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,mBAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import type {ChartTypeDefinition} from './base-types';\nimport {histogramChartType} from './histogram/definition';\nimport {lineChartChartType} from './line-chart/definition';\nimport {countPlotChartType} from './count-plot/definition';\nimport {heatmapChartType} from './heatmap/definition';\nimport {boxPlotChartType} from './box-plot/definition';\nimport {bubbleChartChartType} from './bubble-chart/definition';\nimport {customSpecChartType} from './custom-spec/definition';\n\n/**\n * Creates the default set of chart type definitions.\n *\n * @param options - Configuration options\n * @param options.includeCustomSpec - Whether to include the custom spec chart type (default: true)\n * @returns Array of chart type definitions\n */\nexport function createDefaultChartTypes(options?: {\n  includeCustomSpec?: boolean;\n}): ChartTypeDefinition<any>[] {\n  const includeCustomSpec = options?.includeCustomSpec ?? true;\n  const chartTypes: ChartTypeDefinition<any>[] = [\n    histogramChartType,\n    countPlotChartType,\n    lineChartChartType,\n    heatmapChartType,\n    boxPlotChartType,\n    bubbleChartChartType,\n  ];\n\n  if (includeCustomSpec) {\n    chartTypes.push(customSpecChartType as ChartTypeDefinition<any>);\n  }\n\n  return chartTypes;\n}\n"]}
+{"version":3,"file":"createDefaultChartTypes.js","sourceRoot":"","sources":["../../../src/charts/chart-types/createDefaultChartTypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAEvC;IACC,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,IAAI,CAAC;IAC7D,MAAM,UAAU,GAA+B;QAC7C,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB;QAChB,gBAAgB;QAChB,oBAAoB;KACrB,CAAC;IAEF,IAAI,iBAAiB,EAAE,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,mBAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import type {ChartTypeDefinition} from './base-types';\nimport {histogramChartType} from './histogram/definition';\nimport {lineChartChartType} from './line-chart/definition';\nimport {countPlotChartType} from './count-plot/definition';\nimport {heatmapChartType} from './heatmap/definition';\nimport {boxPlotChartType} from './box-plot/definition';\nimport {scatterPlotChartType} from './scatter-plot/definition';\nimport {customSpecChartType} from './custom-spec/definition';\n\n/**\n * Creates the default set of chart type definitions.\n *\n * @param options - Configuration options\n * @param options.includeCustomSpec - Whether to include the custom spec chart type (default: true)\n * @returns Array of chart type definitions\n */\nexport function createDefaultChartTypes(options?: {\n  includeCustomSpec?: boolean;\n}): ChartTypeDefinition<any>[] {\n  const includeCustomSpec = options?.includeCustomSpec ?? true;\n  const chartTypes: ChartTypeDefinition<any>[] = [\n    histogramChartType,\n    countPlotChartType,\n    lineChartChartType,\n    heatmapChartType,\n    boxPlotChartType,\n    scatterPlotChartType,\n  ];\n\n  if (includeCustomSpec) {\n    chartTypes.push(customSpecChartType as ChartTypeDefinition<any>);\n  }\n\n  return chartTypes;\n}\n"]}

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

@@ -1,4 +1,5 @@
 import { Spec } from '@uwdata/mosaic-spec';
 import { CustomSpecChartSettings } from './schema';
-export declare function createCustomSpec(tableName: string, { vgPlotSpec }: CustomSpecChartSettings): Spec;
+import { CreateSpecOptions } from '../base-types';
+export declare function createCustomSpec({ dataTable, settings: { vgPlotSpec }, selectionName, }: CreateSpecOptions<CustomSpecChartSettings>): Spec;
 //# sourceMappingURL=spec.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AACzC,OAAO,EAAC,uBAAuB,EAAC,MAAM,UAAU,CAAC;AAEjD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,EAAC,UAAU,EAAC,EAAE,uBAAuB,GACpC,IAAI,CAuBN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AACzC,OAAO,EAAC,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACjD,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAExE,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EAAE,EAAC,UAAU,EAAC,EACtB,aAAa,GACd,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,GAAG,IAAI,CA4BnD"}

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

@@ -1,20 +1,24 @@
-export function createCustomSpec(tableName, { vgPlotSpec }) {
+import { getChartTableReference } from '../base-types';
+export function createCustomSpec({ dataTable, settings: { vgPlotSpec }, selectionName, }) {
     if (vgPlotSpec) {
         return vgPlotSpec;
     }
     // Default starter spec
+    const plot = [
+        {
+            mark: 'rectY',
+            data: { from: getChartTableReference(dataTable), filterBy: '$brush' },
+            x: { bin: 'field_name', maxbins: 25 },
+            y: { count: null },
+            fill: 'steelblue',
+            inset: 0.5,
+        },
+    ];
+    if (selectionName) {
+        plot.push({ select: 'intervalX', as: '$brush' });
+    }
     return {
-        plot: [
-            {
-                mark: 'rectY',
-                data: { from: tableName, filterBy: '$brush' },
-                x: { bin: 'field_name', maxbins: 25 },
-                y: { count: null },
-                fill: 'steelblue',
-                inset: 0.5,
-            },
-            { select: 'intervalX', as: '$brush' },
-        ],
+        plot,
         xLabel: 'field_name',
         height: 200,
         width: 380,

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

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/spec.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,EAAC,UAAU,EAA0B;IAErC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAkB,CAAC;IAC5B,CAAC;IAED,uBAAuB;IACvB,OAAO;QACL,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC;gBAC3C,CAAC,EAAE,EAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAC;gBACnC,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;gBAChB,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,GAAG;aACX;YACD,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC;SACpC;QACD,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC","sourcesContent":["import {Spec} from '@uwdata/mosaic-spec';\nimport {CustomSpecChartSettings} from './schema';\n\nexport function createCustomSpec(\n  tableName: string,\n  {vgPlotSpec}: CustomSpecChartSettings,\n): Spec {\n  if (vgPlotSpec) {\n    return vgPlotSpec as Spec;\n  }\n\n  // Default starter spec\n  return {\n    plot: [\n      {\n        mark: 'rectY',\n        data: {from: tableName, filterBy: '$brush'},\n        x: {bin: 'field_name', maxbins: 25},\n        y: {count: null},\n        fill: 'steelblue',\n        inset: 0.5,\n      },\n      {select: 'intervalX', as: '$brush'},\n    ],\n    xLabel: 'field_name',\n    height: 200,\n    width: 380,\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n"]}
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/custom-spec/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,sBAAsB,EAAC,MAAM,eAAe,CAAC;AAExE,MAAM,UAAU,gBAAgB,CAAC,EAC/B,SAAS,EACT,QAAQ,EAAE,EAAC,UAAU,EAAC,EACtB,aAAa,GAC8B;IAC3C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAkB,CAAC;IAC5B,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAI,GAAc;QACtB;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,EAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAC;YACnE,CAAC,EAAE,EAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAC;YACnC,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,GAAG;SACX;KACF,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC","sourcesContent":["import {Spec} from '@uwdata/mosaic-spec';\nimport {CustomSpecChartSettings} from './schema';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\n\nexport function createCustomSpec({\n  dataTable,\n  settings: {vgPlotSpec},\n  selectionName,\n}: CreateSpecOptions<CustomSpecChartSettings>): Spec {\n  if (vgPlotSpec) {\n    return vgPlotSpec as Spec;\n  }\n\n  // Default starter spec\n  const plot: unknown[] = [\n    {\n      mark: 'rectY',\n      data: {from: getChartTableReference(dataTable), filterBy: '$brush'},\n      x: {bin: 'field_name', maxbins: 25},\n      y: {count: null},\n      fill: 'steelblue',\n      inset: 0.5,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalX', as: '$brush'});\n  }\n\n  return {\n    plot,\n    xLabel: 'field_name',\n    height: 200,\n    width: 380,\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n"]}

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

@@ -4,4 +4,29 @@
 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);
+}
 //# 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"}

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

@@ -7,4 +7,42 @@ 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';
+    }
+}
 //# 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","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"]}

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

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

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/heatmap/spec.ts"],"names":[],"mappings":"AAEA,OAAO,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":"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","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {HeatmapChartSettings} from './schema';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {isNumericType} from '../../../column-types-utils';\n\nexport function createHeatmapSpec(\n  options: CreateSpecOptions<HeatmapChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {xColumn, yColumn} = validateHeatmapSettings(options);\n\n  const plot: unknown[] = [\n    {\n      mark: 'raster',\n      data: {from: getChartTableReference(dataTable), filterBy: '$brush'},\n      x: xColumn.name,\n      y: yColumn.name,\n      fill: 'density',\n      bandwidth: 0,\n      pixelSize: 3,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalXY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    colorScale: 'sqrt',\n    colorScheme: 'ylorrd',\n    xLabel: xColumn.name,\n    yLabel: yColumn.name,\n    height: 250,\n    width: 380,\n    margins: {left: 50, right: 20, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n\nfunction validateHeatmapSettings({\n  dataTable,\n  settings: {x, y},\n}: CreateSpecOptions<HeatmapChartSettings>) {\n  // Basic validation for required fields\n  if (!x || !y) {\n    throw new RequiredFieldsError([\n      ...(x ? [] : ['X field']),\n      ...(y ? [] : ['Y field']),\n    ]);\n  }\n\n  // Validate X and Y field existence\n  const xColumn = dataTable.columns.find((col) => col.name === x);\n  const yColumn = dataTable.columns.find((col) => col.name === y);\n\n  if (!xColumn || !yColumn) {\n    throw new MissingColumnsError([\n      ...(xColumn ? [] : [x]),\n      ...(yColumn ? [] : [y]),\n    ]);\n  }\n\n  // Validate X and Y field are numeric\n  const xIsNumeric = isNumericType(xColumn.type);\n  const yIsNumeric = isNumericType(yColumn.type);\n  if (!xIsNumeric || !yIsNumeric) {\n    throw new InvalidColumnTypeError(\n      [\n        ...(!xIsNumeric ? [xColumn.name] : []),\n        ...(!yIsNumeric ? [yColumn.name] : []),\n      ],\n      'numeric',\n    );\n  }\n\n  return {\n    xColumn,\n    yColumn,\n  };\n}\n"]}

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

@@ -16,13 +16,13 @@ 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.
+NOTE: Heatmaps aggregate data into grid cells and compute density/counts, so they handle large datasets efficiently (no data point limit). Heatmaps are a good alternative when scatter charts would exceed ${deps.maxDataPoints.toLocaleString()} rows.
 
 To UPDATE an existing heatmap: provide the panelId parameter. Otherwise creates new panel.
 
 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).`,
+Do NOT use for: individual point plots (use scatter-plot), single variable distribution (use histogram), time trends (use line-chart).`,
         inputSchema: HeatmapToolParameters,
         execute: async (params, context) => {
             try {