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

package/dist/charts/chart-types/line-chart/LineChartYFieldsSelector.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo } from 'react';
+import { MultiFieldSelector } from '../../../components/MultiFieldSelector';
+import { AggregationSelector } from '../../../components/AggregationSelector';
+import { ColorSelector } from '../../../components/ColorSelector';
+import { useMosaicChartSettingsContext } from '../../chart-settings/MosaicChartSettingsContext';
+import { useColumnsContext } from '../../../components/ColumnsContext';
+import { isTemporalType } from '../../../column-types-utils';
+import { getUnusedColor } from './utils';
+import { DEFAULT_CHART_COLORS, DEFAULT_CHART_FALLBACK_COLOR, } from '../../../constants/chart-colors';
+/**
+ * Field selector specifically for line chart Y-axis fields.
+ * Includes aggregation and color selection.
+ */
+export const LineChartYFieldsSelector = () => {
+    const { onChangeConfig, config } = useMosaicChartSettingsContext('line-chart');
+    const { columns } = useColumnsContext();
+    const yFields = useMemo(() => config.settings.yFields ?? [], [config.settings.yFields]);
+    const xColumn = columns.find((c) => c.name === config.settings.x);
+    const isXFieldTemporal = xColumn && isTemporalType(xColumn.type);
+    const showAggregation = Boolean(isXFieldTemporal && config.settings.xInterval);
+    const handleChange = useCallback((newYFields) => onChangeConfig('yFields', newYFields), [onChangeConfig]);
+    const handleAdd = useCallback((fieldName) => {
+        if (fieldName) {
+            const usedColors = yFields
+                .map((f) => f.color)
+                .filter((c) => Boolean(c));
+            onChangeConfig('yFields', [
+                ...yFields,
+                {
+                    field: fieldName,
+                    aggregate: 'sum',
+                    color: getUnusedColor(DEFAULT_CHART_COLORS, usedColors),
+                },
+            ]);
+        }
+    }, [yFields, onChangeConfig]);
+    return (_jsx(MultiFieldSelector.Numeric, { value: yFields, onChange: handleChange, onAdd: handleAdd, renderItem: (fieldConfig, index, handleUpdate) => (_jsxs("div", { className: "grid items-end gap-2", style: {
+                gridTemplateColumns: showAggregation ? 'auto auto' : 'auto',
+            }, children: [showAggregation && (_jsx(AggregationSelector, { value: fieldConfig.aggregate || 'sum', onChange: (newAggregate) => handleUpdate(index, { aggregate: newAggregate }) })), _jsx(ColorSelector, { items: DEFAULT_CHART_COLORS, value: fieldConfig.color ?? DEFAULT_CHART_FALLBACK_COLOR, onChange: (color) => handleUpdate(index, { color }) })] })) }));
+};
+//# sourceMappingURL=LineChartYFieldsSelector.js.map

package/dist/charts/chart-types/line-chart/LineChartYFieldsSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineChartYFieldsSelector.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/LineChartYFieldsSelector.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,WAAW,EAAE,OAAO,EAAU,MAAM,OAAO,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAC,mBAAmB,EAAC,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAC,aAAa,EAAC,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAC,6BAA6B,EAAC,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAC,cAAc,EAAC,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAO,GAAG,EAAE;IAC/C,MAAM,EAAC,cAAc,EAAE,MAAM,EAAC,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC7E,MAAM,EAAC,OAAO,EAAC,GAAG,iBAAiB,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,EACnC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC1B,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,MAAM,eAAe,GAAG,OAAO,CAC7B,gBAAgB,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC9C,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,UAA0B,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,EACrE,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,SAAiB,EAAE,EAAE;QACpB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,UAAU,GAAG,OAAO;iBACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1C,cAAc,CAAC,SAAS,EAAE;gBACxB,GAAG,OAAO;gBACV;oBACE,KAAK,EAAE,SAAS;oBAChB,SAAS,EAAE,KAAK;oBAChB,KAAK,EAAE,cAAc,CAAC,oBAAoB,EAAE,UAAU,CAAC;iBACxD;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,cAAc,CAAC,CAC1B,CAAC;IAEF,OAAO,CACL,KAAC,kBAAkB,CAAC,OAAO,IACzB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAChD,eACE,SAAS,EAAC,sBAAsB,EAChC,KAAK,EAAE;gBACL,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;aAC5D,aAEA,eAAe,IAAI,CAClB,KAAC,mBAAmB,IAClB,KAAK,EAAE,WAAW,CAAC,SAAS,IAAI,KAAK,EACrC,QAAQ,EAAE,CAAC,YAAY,EAAE,EAAE,CACzB,YAAY,CAAC,KAAK,EAAE,EAAC,SAAS,EAAE,YAAY,EAAC,CAAC,GAEhD,CACH,EAED,KAAC,aAAa,IACZ,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,4BAA4B,EACxD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,EAAC,KAAK,EAAC,CAAC,GACjD,IACE,CACP,GACD,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {useCallback, useMemo, type FC} from 'react';\nimport {MultiFieldSelector} from '../../../components/MultiFieldSelector';\nimport {AggregationSelector} from '../../../components/AggregationSelector';\nimport {ColorSelector} from '../../../components/ColorSelector';\nimport {useMosaicChartSettingsContext} from '../../chart-settings/MosaicChartSettingsContext';\nimport {useColumnsContext} from '../../../components/ColumnsContext';\nimport {isTemporalType} from '../../../column-types-utils';\nimport {getUnusedColor} from './utils';\nimport {\n  DEFAULT_CHART_COLORS,\n  DEFAULT_CHART_FALLBACK_COLOR,\n} from '../../../constants/chart-colors';\n\n/**\n * Field selector specifically for line chart Y-axis fields.\n * Includes aggregation and color selection.\n */\nexport const LineChartYFieldsSelector: FC = () => {\n  const {onChangeConfig, config} = useMosaicChartSettingsContext('line-chart');\n  const {columns} = useColumnsContext();\n\n  const yFields = useMemo(\n    () => config.settings.yFields ?? [],\n    [config.settings.yFields],\n  );\n\n  const xColumn = columns.find((c) => c.name === config.settings.x);\n  const isXFieldTemporal = xColumn && isTemporalType(xColumn.type);\n\n  const showAggregation = Boolean(\n    isXFieldTemporal && config.settings.xInterval,\n  );\n\n  const handleChange = useCallback(\n    (newYFields: typeof yFields) => onChangeConfig('yFields', newYFields),\n    [onChangeConfig],\n  );\n\n  const handleAdd = useCallback(\n    (fieldName: string) => {\n      if (fieldName) {\n        const usedColors = yFields\n          .map((f) => f.color)\n          .filter((c): c is string => Boolean(c));\n\n        onChangeConfig('yFields', [\n          ...yFields,\n          {\n            field: fieldName,\n            aggregate: 'sum',\n            color: getUnusedColor(DEFAULT_CHART_COLORS, usedColors),\n          },\n        ]);\n      }\n    },\n    [yFields, onChangeConfig],\n  );\n\n  return (\n    <MultiFieldSelector.Numeric\n      value={yFields}\n      onChange={handleChange}\n      onAdd={handleAdd}\n      renderItem={(fieldConfig, index, handleUpdate) => (\n        <div\n          className=\"grid items-end gap-2\"\n          style={{\n            gridTemplateColumns: showAggregation ? 'auto auto' : 'auto',\n          }}\n        >\n          {showAggregation && (\n            <AggregationSelector\n              value={fieldConfig.aggregate || 'sum'}\n              onChange={(newAggregate) =>\n                handleUpdate(index, {aggregate: newAggregate})\n              }\n            />\n          )}\n\n          <ColorSelector\n            items={DEFAULT_CHART_COLORS}\n            value={fieldConfig.color ?? DEFAULT_CHART_FALLBACK_COLOR}\n            onChange={(color) => handleUpdate(index, {color})}\n          />\n        </div>\n      )}\n    />\n  );\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,eAAe,EAAoB,MAAM,UAAU,CAAC;AAU5D,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,eAAe,CAkBvE,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,eAAe,EAAoB,MAAM,UAAU,CAAC;AAU5D,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,eAAe,CAmBvE,CAAC"}

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

@@ -10,6 +10,7 @@ export const lineChartChartType = {
     id: 'line-chart',
     label: 'Line Chart',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - trends over time or ordered variable (use with aggregations for >10k rows)`,
     icon: LineChart,
     schema: LineChartSettings,
     settingsComponent: LineChartSettingsComponent,

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

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,mCAAmC,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,iBAAiB;IACzB,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,aAAa,EAAE,CAAC,EAAC,MAAM,EAAC,EAAE,EAAE,CAC1B,MAAM,CAAC,QAAQ,CAAC,SAAS;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,OAAO,EAAE,6BAA6B;YACtC,MAAM,EACJ,sHAAsH;SACzH;IACP,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {LineChartConfig, LineChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {LineChartSettingsComponent} from './LineChartSettings';\nimport {createLineChartAiTool} from './tool';\nimport {LineChart} from 'lucide-react';\nimport {createLineChartSpec} from './spec';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a line chart of two fields';\n\nexport const lineChartChartType: SpecChartTypeDefinition<LineChartConfig> = {\n  id: 'line-chart',\n  label: 'Line Chart',\n  description: DESCRIPTION,\n  icon: LineChart,\n  schema: LineChartSettings,\n  settingsComponent: LineChartSettingsComponent,\n  buildTitle: titleFromDescription(DESCRIPTION),\n  createTool: createLineChartAiTool,\n  getDataPolicy: ({config}) =>\n    config.settings.xInterval\n      ? null\n      : {\n          maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n          reason:\n            'Unaggregated line charts render source rows. Add a temporal interval or use an aggregated chart for larger datasets.',\n        },\n  createSpec: createLineChartSpec,\n};\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,mCAAmC,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,+EAA+E;IAC5G,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,iBAAiB;IACzB,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,aAAa,EAAE,CAAC,EAAC,MAAM,EAAC,EAAE,EAAE,CAC1B,MAAM,CAAC,QAAQ,CAAC,SAAS;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,OAAO,EAAE,6BAA6B;YACtC,MAAM,EACJ,sHAAsH;SACzH;IACP,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {LineChartConfig, LineChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {LineChartSettingsComponent} from './LineChartSettings';\nimport {createLineChartAiTool} from './tool';\nimport {LineChart} from 'lucide-react';\nimport {createLineChartSpec} from './spec';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a line chart of two fields';\n\nexport const lineChartChartType: SpecChartTypeDefinition<LineChartConfig> = {\n  id: 'line-chart',\n  label: 'Line Chart',\n  description: DESCRIPTION,\n  aiDescription: `${DESCRIPTION} - trends over time or ordered variable (use with aggregations for >10k rows)`,\n  icon: LineChart,\n  schema: LineChartSettings,\n  settingsComponent: LineChartSettingsComponent,\n  buildTitle: titleFromDescription(DESCRIPTION),\n  createTool: createLineChartAiTool,\n  getDataPolicy: ({config}) =>\n    config.settings.xInterval\n      ? null\n      : {\n          maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n          reason:\n            'Unaggregated line charts render source rows. Add a temporal interval or use an aggregated chart for larger datasets.',\n        },\n  createSpec: createLineChartSpec,\n};\n"]}

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

@@ -32,6 +32,7 @@ export declare const LineChartSettings: z.ZodObject<{
             avg: "avg";
         }>>>;
     }, z.core.$strip>>>;
+    showLegend: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type LineChartSettings = z.infer<typeof LineChartSettings>;
 export declare const LineChartConfig: z.ZodObject<{
@@ -58,6 +59,7 @@ export declare const LineChartConfig: z.ZodObject<{
                 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<{

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,eAAO,MAAM,YAAY;;;;;;;;;iBAMvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,eAAO,MAAM,YAAY;;;;;;;;;iBAMvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;iBAiB5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

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

@@ -19,6 +19,11 @@ export const LineChartSettings = z.object({
         .array(YFieldConfig)
         .optional()
         .describe('Array of Y fields to plot, supports multiple lines'),
+    showLegend: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Show interactive legend for toggling line visibility'),
 });
 export const LineChartConfig = z.object({
     chartType: z.literal('line-chart'),

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAErE,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE;SACpC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC7C,yDAAyD,CAC1D;IACD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,YAAY,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,QAAQ,EAAE,iBAAiB;IAC3B,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';\nimport {TemporalInterval, AggregateFunction} from '../../../schemas';\n\n// Y-field configuration\nexport const YFieldConfig = z.object({\n  field: z.string().describe('Numeric column name to plot on Y axis'),\n  color: z.string().optional().describe('Optional color for this line'),\n  aggregate: AggregateFunction.optional()\n    .default('sum')\n    .describe('Aggregation function: sum, avg, min, or max'),\n});\nexport type YFieldConfig = z.infer<typeof YFieldConfig>;\n\nexport const LineChartSettings = z.object({\n  x: z\n    .string()\n    .optional()\n    .describe('Column for X axis, typically temporal (date/time)'),\n  xInterval: TemporalInterval.optional().describe(\n    'Temporal binning interval: year, month, day, hour, etc.',\n  ),\n  yFields: z\n    .array(YFieldConfig)\n    .optional()\n    .describe('Array of Y fields to plot, supports multiple lines'),\n});\n\nexport type LineChartSettings = z.infer<typeof LineChartSettings>;\n\nexport const LineChartConfig = z.object({\n  chartType: z.literal('line-chart'),\n  settings: LineChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type LineChartConfig = z.infer<typeof LineChartConfig>;\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAErE,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE;SACpC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC7C,yDAAyD,CAC1D;IACD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,YAAY,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,UAAU,EAAE,CAAC;SACV,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,QAAQ,EAAE,iBAAiB;IAC3B,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';\nimport {TemporalInterval, AggregateFunction} from '../../../schemas';\n\n// Y-field configuration\nexport const YFieldConfig = z.object({\n  field: z.string().describe('Numeric column name to plot on Y axis'),\n  color: z.string().optional().describe('Optional color for this line'),\n  aggregate: AggregateFunction.optional()\n    .default('sum')\n    .describe('Aggregation function: sum, avg, min, or max'),\n});\nexport type YFieldConfig = z.infer<typeof YFieldConfig>;\n\nexport const LineChartSettings = z.object({\n  x: z\n    .string()\n    .optional()\n    .describe('Column for X axis, typically temporal (date/time)'),\n  xInterval: TemporalInterval.optional().describe(\n    'Temporal binning interval: year, month, day, hour, etc.',\n  ),\n  yFields: z\n    .array(YFieldConfig)\n    .optional()\n    .describe('Array of Y fields to plot, supports multiple lines'),\n  showLegend: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Show interactive legend for toggling line visibility'),\n});\n\nexport type LineChartSettings = z.infer<typeof LineChartSettings>;\n\nexport const LineChartConfig = z.object({\n  chartType: z.literal('line-chart'),\n  settings: LineChartSettings,\n  settingsOpen: z.boolean().optional(),\n  dataPolicy: ChartDataPolicyOverrideConfig.optional(),\n});\n\nexport type LineChartConfig = z.infer<typeof LineChartConfig>;\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAuB3C,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,EAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAC,EAAE,iBAAiB,GACzC,IAAI,CAgFN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAG3C,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAcxE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GAC5C,IAAI,CAsFN"}

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

@@ -1,90 +1,81 @@
-import { ChartSpecError } from '../errors';
-// Chart color palette matching theme colors from tailwind-preset.css
-const CHART_COLORS = [
-    '#ea7c5c', // chart-1: hsl(12, 76%, 61%)
-    '#2a9d8f', // chart-2: hsl(173, 58%, 39%)
-    '#264653', // chart-3: hsl(197, 37%, 24%)
-    '#e9c46a', // chart-4: hsl(43, 74%, 66%)
-    '#f4a261', // chart-5: hsl(27, 87%, 67%)
-];
-function getLineColor(fieldConfig, index) {
-    if (fieldConfig.color) {
-        return fieldConfig.color;
+import { isTemporalType } from '../../../column-types-utils';
+import { getChartTableReference } from '../base-types';
+import { DEFAULT_CHART_FALLBACK_COLOR } from '../../../constants/chart-colors';
+import { validateLineChartSettings } from './validation';
+function getLegendLabel(yColumn, hasAggregation) {
+    if (hasAggregation && yColumn.aggregate) {
+        return `${yColumn.field} (${yColumn.aggregate.toUpperCase()})`;
     }
-    // CHART_COLORS is non-empty, so this is always defined
-    return CHART_COLORS[index % CHART_COLORS.length];
+    return yColumn.field;
 }
-export function createLineChartSpec(tableName, { x, yFields, xInterval }) {
-    if (!x) {
-        throw new ChartSpecError('X field is required for line chart');
-    }
-    if (!yFields || yFields.length === 0) {
-        throw new ChartSpecError('At least one Y field is required for line chart');
-    }
+export function createLineChartSpec(options) {
+    const { dataTable, selectionName, settings } = options;
+    const { xColumn, yColumns, xInterval } = validateLineChartSettings(options);
+    const isXTemporal = isTemporalType(xColumn.type);
     const plotMarks = [];
-    // When temporal aggregation is active, use SQL binning
-    const dataSource = xInterval
-        ? {
-            from: tableName,
-            filterBy: '$brush',
-        }
-        : { from: tableName, filterBy: '$brush' };
-    // Generate lineY and text marks for each Y field
-    yFields.forEach((fieldConfig, index) => {
-        const color = getLineColor(fieldConfig, index);
-        const aggregate = fieldConfig.aggregate || 'sum';
+    // Data source always includes filterBy for brush
+    const dataSource = {
+        from: getChartTableReference(dataTable),
+        filterBy: '$brush',
+    };
+    // Generate lineY marks for each Y field
+    yColumns.forEach(({ color, column, aggregate }) => {
         // When temporal aggregation is active, use bin for X and aggregation for Y
-        if (xInterval) {
+        if (isXTemporal && xInterval) {
             // Use bin syntax for temporal aggregation
             plotMarks.push({
                 mark: 'lineY',
                 data: dataSource,
-                x: { bin: x, interval: xInterval },
-                y: { [aggregate]: fieldConfig.field },
+                x: { bin: xColumn.name, interval: xInterval },
+                y: { [aggregate]: column.name },
                 stroke: color,
             });
-            // Text label with aggregation info
-            plotMarks.push({
-                mark: 'text',
-                data: dataSource,
-                x: { bin: x, interval: xInterval },
-                y: { [aggregate]: fieldConfig.field },
-                text: [`${fieldConfig.field} (${aggregate})`],
-                fill: color,
-                dx: 5,
-                dy: -5,
-            });
         }
         else {
             // No aggregation - direct field references
             plotMarks.push({
                 mark: 'lineY',
                 data: dataSource,
-                x,
-                y: fieldConfig.field,
+                x: xColumn.name,
+                y: column.name,
                 stroke: color,
             });
-            plotMarks.push({
-                mark: 'text',
-                data: dataSource,
-                x,
-                y: fieldConfig.field,
-                text: [fieldConfig.field],
-                fill: color,
-                dx: 5,
-                dy: -5,
-            });
         }
     });
-    // Add brush
-    plotMarks.push({ select: 'intervalX', as: '$brush' });
-    return {
+    // Add brush control only if selectionName is provided
+    if (selectionName) {
+        plotMarks.push({ select: 'intervalX', as: '$brush' });
+    }
+    const showLegend = settings.showLegend ?? true;
+    const plotSpec = {
         plot: plotMarks,
-        xLabel: x,
+        name: 'lineChart',
+        xLabel: xColumn.name,
         yLabel: undefined,
-        height: 250,
-        width: 380,
-        margins: { left: 50, right: 20, top: 20, bottom: 50 },
+        margins: {
+            left: 50,
+            right: 20,
+            top: 20,
+            bottom: 50,
+        },
+        colorDomain: yColumns.map((yColumn) => getLegendLabel({ field: yColumn.column.name, aggregate: yColumn.aggregate }, Boolean(isXTemporal && xInterval))),
+        colorRange: yColumns.map((yColumn) => yColumn.color ?? DEFAULT_CHART_FALLBACK_COLOR),
+    };
+    if (!showLegend) {
+        return {
+            ...plotSpec,
+            params: { brush: { select: 'crossfilter' } },
+        };
+    }
+    return {
+        vconcat: [
+            plotSpec,
+            {
+                legend: 'color',
+                for: 'lineChart',
+                columns: yColumns.length,
+            },
+        ],
         params: { brush: { select: 'crossfilter' } },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/spec.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {LineChartSettings} from './schema';\nimport {ChartSpecError} from '../errors';\n\n// Chart color palette matching theme colors from tailwind-preset.css\nconst CHART_COLORS = [\n  '#ea7c5c', // chart-1: hsl(12, 76%, 61%)\n  '#2a9d8f', // chart-2: hsl(173, 58%, 39%)\n  '#264653', // chart-3: hsl(197, 37%, 24%)\n  '#e9c46a', // chart-4: hsl(43, 74%, 66%)\n  '#f4a261', // chart-5: hsl(27, 87%, 67%)\n];\n\nfunction getLineColor(\n  fieldConfig: {field: string; color?: string},\n  index: number,\n): string {\n  if (fieldConfig.color) {\n    return fieldConfig.color;\n  }\n  // CHART_COLORS is non-empty, so this is always defined\n  return CHART_COLORS[index % CHART_COLORS.length]!;\n}\n\nexport function createLineChartSpec(\n  tableName: string,\n  {x, yFields, xInterval}: LineChartSettings,\n): Spec {\n  if (!x) {\n    throw new ChartSpecError('X field is required for line chart');\n  }\n  if (!yFields || yFields.length === 0) {\n    throw new ChartSpecError('At least one Y field is required for line chart');\n  }\n\n  const plotMarks: any[] = [];\n\n  // When temporal aggregation is active, use SQL binning\n  const dataSource = xInterval\n    ? {\n        from: tableName,\n        filterBy: '$brush',\n      }\n    : {from: tableName, filterBy: '$brush'};\n\n  // Generate lineY and text marks for each Y field\n  yFields.forEach((fieldConfig, index) => {\n    const color = getLineColor(fieldConfig, index);\n    const aggregate = fieldConfig.aggregate || 'sum';\n\n    // When temporal aggregation is active, use bin for X and aggregation for Y\n    if (xInterval) {\n      // Use bin syntax for temporal aggregation\n      plotMarks.push({\n        mark: 'lineY',\n        data: dataSource,\n        x: {bin: x, interval: xInterval},\n        y: {[aggregate]: fieldConfig.field},\n        stroke: color,\n      });\n\n      // Text label with aggregation info\n      plotMarks.push({\n        mark: 'text',\n        data: dataSource,\n        x: {bin: x, interval: xInterval},\n        y: {[aggregate]: fieldConfig.field},\n        text: [`${fieldConfig.field} (${aggregate})`],\n        fill: color,\n        dx: 5,\n        dy: -5,\n      });\n    } else {\n      // No aggregation - direct field references\n      plotMarks.push({\n        mark: 'lineY',\n        data: dataSource,\n        x,\n        y: fieldConfig.field,\n        stroke: color,\n      });\n\n      plotMarks.push({\n        mark: 'text',\n        data: dataSource,\n        x,\n        y: fieldConfig.field,\n        text: [fieldConfig.field],\n        fill: color,\n        dx: 5,\n        dy: -5,\n      });\n    }\n  });\n\n  // Add brush\n  plotMarks.push({select: 'intervalX', as: '$brush'});\n\n  return {\n    plot: plotMarks,\n    xLabel: x,\n    yLabel: undefined,\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/line-chart/spec.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {LineChartSettings} from './schema';\nimport {isTemporalType} from '../../../column-types-utils';\nimport {AggregateFunction} from '../../../schemas';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {DEFAULT_CHART_FALLBACK_COLOR} from '../../../constants/chart-colors';\nimport {validateLineChartSettings} from './validation';\n\nfunction getLegendLabel(\n  yColumn: {field: string; aggregate?: AggregateFunction},\n  hasAggregation: boolean,\n): string {\n  if (hasAggregation && yColumn.aggregate) {\n    return `${yColumn.field} (${yColumn.aggregate.toUpperCase()})`;\n  }\n  return yColumn.field;\n}\n\nexport function createLineChartSpec(\n  options: CreateSpecOptions<LineChartSettings>,\n): Spec {\n  const {dataTable, selectionName, settings} = options;\n\n  const {xColumn, yColumns, xInterval} = validateLineChartSettings(options);\n\n  const isXTemporal = isTemporalType(xColumn.type);\n\n  const plotMarks: unknown[] = [];\n\n  // Data source always includes filterBy for brush\n  const dataSource = {\n    from: getChartTableReference(dataTable),\n    filterBy: '$brush',\n  };\n\n  // Generate lineY marks for each Y field\n  yColumns.forEach(({color, column, aggregate}) => {\n    // When temporal aggregation is active, use bin for X and aggregation for Y\n    if (isXTemporal && xInterval) {\n      // Use bin syntax for temporal aggregation\n      plotMarks.push({\n        mark: 'lineY',\n        data: dataSource,\n        x: {bin: xColumn.name, interval: xInterval},\n        y: {[aggregate]: column.name},\n        stroke: color,\n      });\n    } else {\n      // No aggregation - direct field references\n      plotMarks.push({\n        mark: 'lineY',\n        data: dataSource,\n        x: xColumn.name,\n        y: column.name,\n        stroke: color,\n      });\n    }\n  });\n\n  // Add brush control only if selectionName is provided\n  if (selectionName) {\n    plotMarks.push({select: 'intervalX', as: '$brush'});\n  }\n\n  const showLegend = settings.showLegend ?? true;\n\n  const plotSpec = {\n    plot: plotMarks,\n    name: 'lineChart',\n    xLabel: xColumn.name,\n    yLabel: undefined,\n    margins: {\n      left: 50,\n      right: 20,\n      top: 20,\n      bottom: 50,\n    },\n    colorDomain: yColumns.map((yColumn) =>\n      getLegendLabel(\n        {field: yColumn.column.name, aggregate: yColumn.aggregate},\n        Boolean(isXTemporal && xInterval),\n      ),\n    ),\n    colorRange: yColumns.map(\n      (yColumn) => yColumn.color ?? DEFAULT_CHART_FALLBACK_COLOR,\n    ),\n  };\n\n  if (!showLegend) {\n    return {\n      ...plotSpec,\n      params: {brush: {select: 'crossfilter'}},\n    } as Spec;\n  }\n\n  return {\n    vconcat: [\n      plotSpec,\n      {\n        legend: 'color',\n        for: 'lineChart',\n        columns: yColumns.length,\n      },\n    ],\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n"]}

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

@@ -1,9 +1,8 @@
 import { z } from 'zod';
-import type { DashboardToolDeps } from '../base-types';
-export declare const LineChartToolParameters: z.ZodObject<{
-    artifactId: z.ZodOptional<z.ZodString>;
-    tableName: z.ZodOptional<z.ZodString>;
-    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+import { ChartToolParams, ChartToolOutput } from '../tool-types';
+export declare const LineChartToolInput: z.ZodObject<{
+    tableName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
@@ -28,11 +27,12 @@ export declare const LineChartToolParameters: z.ZodObject<{
                 avg: "avg";
             }>>>;
         }, z.core.$strip>>>>;
+        showLegend: z.ZodNonOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export type LineChartToolParams = z.infer<typeof LineChartToolParameters>;
-export declare function createLineChartAiTool(deps: DashboardToolDeps): import("ai").Tool<{
-    createArtifactIfMissing: boolean;
+export type LineChartToolInput = z.infer<typeof LineChartToolInput>;
+export declare function createLineChartAiTool({ databaseAdapter, addChart, maxDataPoints, }: ChartToolParams): import("ai").Tool<{
+    tableName: string;
     reasoning: string;
     settings: {
         x: string;
@@ -42,23 +42,27 @@ export declare function createLineChartAiTool(deps: DashboardToolDeps): import("
             aggregate: "sum" | "max" | "min" | "avg";
             color?: string | undefined;
         }[];
+        showLegend: boolean;
     };
-    artifactId?: string | undefined;
-    tableName?: string | undefined;
+    title?: string | undefined;
     panelId?: string | undefined;
-}, {
-    llmResult: {
-        success: boolean;
-        details: string;
-        data: import("..").PanelResult;
-        errorMessage?: undefined;
-    };
-} | {
-    llmResult: {
-        success: boolean;
-        errorMessage: string;
-        details?: undefined;
-        data?: undefined;
+}, ChartToolOutput<{
+    chartType: "line-chart";
+    settings: {
+        showLegend: boolean;
+        x?: string | undefined;
+        xInterval?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+        yFields?: {
+            field: string;
+            aggregate: "sum" | "max" | "min" | "avg";
+            color?: string | undefined;
+        }[] | undefined;
     };
-}>;
+    settingsOpen?: boolean | undefined;
+    dataPolicy?: {
+        disabled?: boolean | undefined;
+        maxRows?: number | undefined;
+        reason?: string | undefined;
+    } | undefined;
+}>>;
 //# sourceMappingURL=tool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAYrD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkF5D"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAStB,OAAO,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAO/D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,QAAQ,EACR,aAAa,GACd,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoDjB"}

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

@@ -1,16 +1,16 @@
 import { tool } from 'ai';
 import { LineChartSettings } from './schema';
 import { AggregateFunction, TemporalInterval } from '../../../schemas';
-import { BaseChartToolParameters } from '../../../ai/tool-schemas';
-import { validateColumnExists } from '../../../ai/tool-validation';
+import { BaseChartToolInput } from '../../../ai/tool-schemas';
 import { NUMERIC_COLUMN_TYPES, QUANTITATIVE_COLUMN_TYPES, TEMPORAL_COLUMN_TYPES, } from '../../../column-types-utils';
-import { createOrUpdateChartPanel } from '../../../ai/tool-helpers';
+import { validateLineChartSettings } from './validation';
+import { ensureTable } from '../../../ai/tool-helpers';
 const AGGREGATE_FUNCTIONS = AggregateFunction.options;
 const TEMPORAL_INTERVALS = TemporalInterval.options;
-export const LineChartToolParameters = BaseChartToolParameters.extend({
+export const LineChartToolInput = BaseChartToolInput.extend({
     settings: LineChartSettings.required(),
 });
-export function createLineChartAiTool(deps) {
+export function createLineChartAiTool({ databaseAdapter, addChart, maxDataPoints, }) {
     return tool({
         description: `Line chart: shows trends and changes over time or ordered continuous variable. Connects data points to show progression.
 
@@ -24,49 +24,37 @@ Required:
 Optional: xInterval for temporal grouping (${TEMPORAL_INTERVALS.join(', ')}) when x is temporal (${TEMPORAL_COLUMN_TYPES.join(', ')}).
 Multiple yFields create multi-line chart for comparing metrics.
 
-NOTE: Line charts with aggregation (xInterval or aggregate functions) handle large datasets well. Without aggregation, line charts plot individual points and should not be used for tables with more than ${deps.maxDataPoints.toLocaleString()} rows - use aggregated visualizations instead.
+NOTE: Line charts with aggregation (xInterval or aggregate functions) handle large datasets well. Without aggregation, line charts plot individual points and should not be used for tables with more than ${maxDataPoints.toLocaleString()} rows - use aggregated visualizations instead.
 
-To UPDATE an existing line chart: provide the panelId parameter. Otherwise creates new panel.
-
-Do NOT use for: single point distributions (use histogram), categorical counts (use count-plot), two-variable correlations (use bubble-chart).`,
-        inputSchema: LineChartToolParameters,
-        execute: async (params, context) => {
+Do NOT use for: single point distributions (use histogram), categorical counts (use count-plot), two-variable correlations (use scatter-plot).`,
+        inputSchema: LineChartToolInput,
+        execute: async ({ tableName, title, settings, panelId }) => {
             try {
-                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
-                const { tableName, columns } = deps.resolveTable(artifactId, params.tableName);
-                // Validate settings
-                validateColumnExists(params.settings.x, QUANTITATIVE_COLUMN_TYPES, columns, 'x');
-                for (const yField of params.settings.yFields) {
-                    validateColumnExists(yField.field, NUMERIC_COLUMN_TYPES, columns, 'yFields');
-                }
-                const result = createOrUpdateChartPanel(deps, {
-                    panelId: params.panelId,
-                    dashboardId: artifactId,
+                const dataTable = ensureTable(databaseAdapter, tableName);
+                validateLineChartSettings({
+                    dataTable,
+                    settings,
+                });
+                const chartConfig = {
+                    chartType: 'line-chart',
+                    settings,
+                };
+                await addChart({
                     tableName,
-                    title: params.settings.x
-                        ? `Line chart - ${params.settings.yFields?.map((f) => f.field).join(', ') || ''} over ${params.settings.x}`
-                        : 'Line chart',
-                    config: {
-                        chartType: 'line-chart',
-                        settings: params.settings,
-                    },
+                    panelId,
+                    title,
+                    config: chartConfig,
                 });
                 return {
-                    llmResult: {
-                        success: true,
-                        details: params.panelId
-                            ? `Updated line chart "${result.title}".`
-                            : `Created line chart "${result.title}".`,
-                        data: result,
-                    },
+                    success: true,
+                    details: `Generated line chart configuration.`,
+                    data: chartConfig,
                 };
             }
             catch (error) {
                 return {
-                    llmResult: {
-                        success: false,
-                        errorMessage: error instanceof Error ? error.message : String(error),
-                    },
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
                 };
             }
         },

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

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/tool.ts"],"names":[],"mappings":"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","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {LineChartSettings} from './schema';\nimport {AggregateFunction, TemporalInterval} from '../../../schemas';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport type {DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {\n  NUMERIC_COLUMN_TYPES,\n  QUANTITATIVE_COLUMN_TYPES,\n  TEMPORAL_COLUMN_TYPES,\n} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nconst AGGREGATE_FUNCTIONS = AggregateFunction.options;\nconst TEMPORAL_INTERVALS = TemporalInterval.options;\n\nexport const LineChartToolParameters = BaseChartToolParameters.extend({\n  settings: LineChartSettings.required(),\n});\n\nexport type LineChartToolParams = z.infer<typeof LineChartToolParameters>;\n\nexport function createLineChartAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Line chart: shows trends and changes over time or ordered continuous variable. Connects data points to show progression.\n\nUse when: user asks about \"trend\", \"over time\", \"changes in\", \"time series\", \"progression of\", \"track X over Y\".\nExample queries: \"population growth over time\", \"temperature trend by month\", \"show land development over years\", \"elevation changes along route\", \"average precipitation by season\".\n\nRequired:\n- x: quantitative column (${QUANTITATIVE_COLUMN_TYPES.join(', ')})\n- yFields: array of {field: string (numeric: ${NUMERIC_COLUMN_TYPES.join(', ')}), aggregate?: ${AGGREGATE_FUNCTIONS.join('|')}}\n\nOptional: xInterval for temporal grouping (${TEMPORAL_INTERVALS.join(', ')}) when x is temporal (${TEMPORAL_COLUMN_TYPES.join(', ')}).\nMultiple yFields create multi-line chart for comparing metrics.\n\nNOTE: Line charts with aggregation (xInterval or aggregate functions) handle large datasets well. Without aggregation, line charts plot individual points and should not be used for tables with more than ${deps.maxDataPoints.toLocaleString()} rows - use aggregated visualizations instead.\n\nTo UPDATE an existing line chart: provide the panelId parameter. Otherwise creates new panel.\n\nDo NOT use for: single point distributions (use histogram), categorical counts (use count-plot), two-variable correlations (use bubble-chart).`,\n    inputSchema: LineChartToolParameters,\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.x,\n          QUANTITATIVE_COLUMN_TYPES,\n          columns,\n          'x',\n        );\n\n        for (const yField of params.settings.yFields) {\n          validateColumnExists(\n            yField.field,\n            NUMERIC_COLUMN_TYPES,\n            columns,\n            'yFields',\n          );\n        }\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: params.settings.x\n            ? `Line chart - ${params.settings.yFields?.map((f) => f.field).join(', ') || ''} over ${params.settings.x}`\n            : 'Line chart',\n          config: {\n            chartType: 'line-chart',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated line chart \"${result.title}\".`\n              : `Created line chart \"${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/line-chart/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAkB,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAC,yBAAyB,EAAC,MAAM,cAAc,CAAC;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,OAAO,CAAC;AACtD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,EACpC,eAAe,EACf,QAAQ,EACR,aAAa,GACG;IAChB,OAAO,IAAI,CAAuD;QAChE,WAAW,EAAE;;;;;;4BAMW,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;+CACjB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;;6CAEhF,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;;;6MAG0E,aAAa,CAAC,cAAc,EAAE;;+IAE5F;QAC3I,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,KAAK,EAAE,EAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAC,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;gBAE1D,yBAAyB,CAAC;oBACxB,SAAS;oBACT,QAAQ;iBACT,CAAC,CAAC;gBAEH,MAAM,WAAW,GAAoB;oBACnC,SAAS,EAAE,YAAqB;oBAChC,QAAQ;iBACT,CAAC;gBAEF,MAAM,QAAQ,CAAC;oBACb,SAAS;oBACT,OAAO;oBACP,KAAK;oBACL,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,qCAAqC;oBAC9C,IAAI,EAAE,WAAW;iBAClB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {LineChartConfig, LineChartSettings} from './schema';\nimport {AggregateFunction, TemporalInterval} from '../../../schemas';\nimport {BaseChartToolInput} from '../../../ai/tool-schemas';\nimport {\n  NUMERIC_COLUMN_TYPES,\n  QUANTITATIVE_COLUMN_TYPES,\n  TEMPORAL_COLUMN_TYPES,\n} from '../../../column-types-utils';\nimport {ChartToolParams, ChartToolOutput} from '../tool-types';\nimport {validateLineChartSettings} from './validation';\nimport {ensureTable} from '../../../ai/tool-helpers';\n\nconst AGGREGATE_FUNCTIONS = AggregateFunction.options;\nconst TEMPORAL_INTERVALS = TemporalInterval.options;\n\nexport const LineChartToolInput = BaseChartToolInput.extend({\n  settings: LineChartSettings.required(),\n});\n\nexport type LineChartToolInput = z.infer<typeof LineChartToolInput>;\n\nexport function createLineChartAiTool({\n  databaseAdapter,\n  addChart,\n  maxDataPoints,\n}: ChartToolParams) {\n  return tool<LineChartToolInput, ChartToolOutput<LineChartConfig>>({\n    description: `Line chart: shows trends and changes over time or ordered continuous variable. Connects data points to show progression.\n\nUse when: user asks about \"trend\", \"over time\", \"changes in\", \"time series\", \"progression of\", \"track X over Y\".\nExample queries: \"population growth over time\", \"temperature trend by month\", \"show land development over years\", \"elevation changes along route\", \"average precipitation by season\".\n\nRequired:\n- x: quantitative column (${QUANTITATIVE_COLUMN_TYPES.join(', ')})\n- yFields: array of {field: string (numeric: ${NUMERIC_COLUMN_TYPES.join(', ')}), aggregate?: ${AGGREGATE_FUNCTIONS.join('|')}}\n\nOptional: xInterval for temporal grouping (${TEMPORAL_INTERVALS.join(', ')}) when x is temporal (${TEMPORAL_COLUMN_TYPES.join(', ')}).\nMultiple yFields create multi-line chart for comparing metrics.\n\nNOTE: Line charts with aggregation (xInterval or aggregate functions) handle large datasets well. Without aggregation, line charts plot individual points and should not be used for tables with more than ${maxDataPoints.toLocaleString()} rows - use aggregated visualizations instead.\n\nDo NOT use for: single point distributions (use histogram), categorical counts (use count-plot), two-variable correlations (use scatter-plot).`,\n    inputSchema: LineChartToolInput,\n    execute: async ({tableName, title, settings, panelId}) => {\n      try {\n        const dataTable = ensureTable(databaseAdapter, tableName);\n\n        validateLineChartSettings({\n          dataTable,\n          settings,\n        });\n\n        const chartConfig: LineChartConfig = {\n          chartType: 'line-chart' as const,\n          settings,\n        };\n\n        await addChart({\n          tableName,\n          panelId,\n          title,\n          config: chartConfig,\n        });\n\n        return {\n          success: true,\n          details: `Generated line chart configuration.`,\n          data: chartConfig,\n        };\n      } catch (error) {\n        return {\n          success: false,\n          errorMessage: error instanceof Error ? error.message : String(error),\n        };\n      }\n    },\n  });\n}\n"]}

package/dist/charts/chart-types/line-chart/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Find the first unused color from the palette.
+ * Scans the used colors and returns the first palette color not in the set.
+ * If all colors are used, returns the first color.
+ */
+export declare function getUnusedColor(colors: readonly string[], usedColors: string[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/charts/chart-types/line-chart/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAYR"}

package/dist/charts/chart-types/line-chart/utils.js

@@ -0,0 +1,17 @@
+/**
+ * Find the first unused color from the palette.
+ * Scans the used colors and returns the first palette color not in the set.
+ * If all colors are used, returns the first color.
+ */
+export function getUnusedColor(colors, usedColors) {
+    const usedSet = new Set(usedColors);
+    // Find first unused color
+    for (const color of colors) {
+        if (!usedSet.has(color)) {
+            return color;
+        }
+    }
+    // All colors used, fallback to first color
+    return colors[0];
+}
+//# sourceMappingURL=utils.js.map

package/dist/charts/chart-types/line-chart/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/line-chart/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAyB,EACzB,UAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAEpC,0BAA0B;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;AACpB,CAAC","sourcesContent":["/**\n * Find the first unused color from the palette.\n * Scans the used colors and returns the first palette color not in the set.\n * If all colors are used, returns the first color.\n */\nexport function getUnusedColor(\n  colors: readonly string[],\n  usedColors: string[],\n): string {\n  const usedSet = new Set(usedColors);\n\n  // Find first unused color\n  for (const color of colors) {\n    if (!usedSet.has(color)) {\n      return color;\n    }\n  }\n\n  // All colors used, fallback to first color\n  return colors[0]!;\n}\n"]}

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

@@ -0,0 +1,16 @@
+import { LineChartSettings } from './schema';
+import { ValidateSpecOptions } from '../base-types';
+import { TableColumn } from '@sqlrooms/duckdb';
+import { AggregateFunction, TemporalInterval } from '../../../schemas';
+export type ValidatedLineChartSettings = {
+    xColumn: TableColumn;
+    yColumns: {
+        field: string;
+        column: TableColumn;
+        aggregate: AggregateFunction;
+        color: string;
+    }[];
+    xInterval?: TemporalInterval;
+};
+export declare function validateLineChartSettings({ dataTable, settings: { x, yFields, xInterval }, }: ValidateSpecOptions<LineChartSettings>): ValidatedLineChartSettings;
+//# sourceMappingURL=validation.d.ts.map