@outsidedata/dolex 0.1.0

package/dist/src/mcp/tools/dsl-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-schemas.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/dsl-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tools/dsl-schemas.js

@@ -0,0 +1,237 @@
+/**
+ * Shared Zod schemas for the query DSL.
+ * Used by both query_source and visualize_from_source tools.
+ */
+import { z } from 'zod';
+// ─── INPUT NORMALIZATION ─────────────────────────────────────────────────────
+// Accepts common LLM-generated aliases and shorthand forms, normalizing them
+// to canonical schema before Zod validation. This reduces round-trips caused
+// by avoidable validation errors.
+const FILTER_SHORTHAND_OPS = {
+    equals: '=',
+    not_equals: '!=',
+    gt: '>',
+    gte: '>=',
+    lt: '<',
+    lte: '<=',
+};
+const AGGREGATE_NAMES = new Set([
+    'sum', 'avg', 'min', 'max', 'count', 'count_distinct',
+    'median', 'p25', 'p75', 'stddev', 'percentile',
+]);
+/** Normalize "column" → "field" alias on an object (mutates). */
+function normalizeFieldAlias(obj) {
+    if (!obj.field && obj.column) {
+        obj.field = obj.column;
+        delete obj.column;
+    }
+}
+function normalizeFilterInput(raw) {
+    if (!raw || typeof raw !== 'object')
+        return raw;
+    const obj = { ...raw };
+    normalizeFieldAlias(obj);
+    // Alias: "operator" → "op"
+    if (!obj.op && obj.operator) {
+        obj.op = obj.operator;
+        delete obj.operator;
+    }
+    if (obj.op)
+        return obj;
+    for (const [key, op] of Object.entries(FILTER_SHORTHAND_OPS)) {
+        if (key in obj) {
+            return { field: obj.field, op, value: obj[key] };
+        }
+    }
+    return obj;
+}
+function normalizeOrderByInput(raw) {
+    // Bare string → ascending sort
+    if (typeof raw === 'string') {
+        return { field: raw, direction: 'asc' };
+    }
+    if (!raw || typeof raw !== 'object')
+        return raw;
+    const obj = { ...raw };
+    normalizeFieldAlias(obj);
+    return obj;
+}
+function normalizeSelectInput(raw) {
+    if (typeof raw === 'string' || !raw || typeof raw !== 'object')
+        return raw;
+    const obj = { ...raw };
+    normalizeFieldAlias(obj);
+    // Already canonical aggregate or window
+    if (obj.aggregate || obj.window)
+        return obj;
+    // Shorthand: { count: "X", as: "Y" } → { field: "X", aggregate: "count", as: "Y" }
+    for (const agg of AGGREGATE_NAMES) {
+        if (agg in obj) {
+            return { field: obj[agg], aggregate: agg, as: obj.as };
+        }
+    }
+    return obj;
+}
+function normalizeGroupByInput(raw) {
+    if (typeof raw === 'string' || !raw || typeof raw !== 'object')
+        return raw;
+    const obj = { ...raw };
+    normalizeFieldAlias(obj);
+    return obj;
+}
+function normalizeArrayOrSingle(val, normalizeItem) {
+    if (val === undefined || val === null)
+        return val;
+    const arr = Array.isArray(val) ? val : [val];
+    return normalizeItem ? arr.map(normalizeItem) : arr;
+}
+export function normalizeDslQueryInput(raw) {
+    if (!raw || typeof raw !== 'object')
+        return raw;
+    const obj = raw;
+    const result = { ...obj };
+    if (result.filter !== undefined) {
+        result.filter = normalizeArrayOrSingle(result.filter, normalizeFilterInput);
+    }
+    if (result.having !== undefined) {
+        result.having = normalizeArrayOrSingle(result.having, normalizeFilterInput);
+    }
+    if (result.orderBy !== undefined) {
+        result.orderBy = normalizeArrayOrSingle(result.orderBy, normalizeOrderByInput);
+    }
+    if (result.select !== undefined && Array.isArray(result.select)) {
+        result.select = result.select.map(normalizeSelectInput);
+    }
+    if (result.groupBy !== undefined && Array.isArray(result.groupBy)) {
+        result.groupBy = result.groupBy.map(normalizeGroupByInput);
+    }
+    return result;
+}
+// ─── SCHEMAS ───────────────────────────────────────────────────────────────
+export const dslJoinSchema = z.object({
+    table: z.string().describe('Table name to join within the same source'),
+    on: z.object({
+        left: z.string().describe('Field from the current/left table (supports table.field dot notation for chained joins)'),
+        right: z.string().describe('Field from the joined table'),
+    }),
+    type: z.enum(['inner', 'left']).optional().describe('Join type. Default: left'),
+});
+export const dslAggregateFieldSchema = z.object({
+    field: z.string().describe('Field to aggregate'),
+    aggregate: z.enum(['sum', 'avg', 'min', 'max', 'count', 'count_distinct', 'median', 'p25', 'p75', 'stddev', 'percentile']).describe('Aggregation function'),
+    as: z.string().describe('Output column name'),
+    percentile: z.number().min(0).max(1).optional().describe('For aggregate "percentile": the percentile value (0–1), e.g. 0.95 for p95, 0.99 for p99'),
+}).describe('Aggregated field — e.g. { field: "revenue", aggregate: "sum", as: "total_revenue" }');
+export const dslWindowFieldSchema = z.object({
+    window: z.enum(['lag', 'lead', 'rank', 'dense_rank', 'row_number', 'running_sum', 'running_avg', 'pct_of_total']).describe('Window function. lag/lead: compare to previous/next row. rank/dense_rank/row_number: ranking. running_sum/running_avg: cumulative. pct_of_total: fraction of partition total.'),
+    field: z.string().optional().describe('Base query output column to operate on. Required for lag, lead, running_sum, running_avg, pct_of_total. Must reference an alias or pass-through field from the same select.'),
+    as: z.string().describe('Output column name for the window result'),
+    partitionBy: z.array(z.string()).optional().describe('Partition columns — window resets per group. Omit for whole-result-set partition. Must reference base query output columns.'),
+    orderBy: z.array(z.object({
+        field: z.string(),
+        direction: z.enum(['asc', 'desc']),
+    })).optional().describe('Sort order within the window. Required for lag, lead, rank, dense_rank, row_number, running_sum, running_avg. Must reference base query output columns.'),
+    offset: z.number().optional().describe('Row offset for lag/lead (default: 1)'),
+    default: z.any().optional().describe('Default value when lag/lead offset is out of range'),
+}).describe('Window function — e.g. { window: "lag", field: "monthly_revenue", offset: 1, as: "prev_month", orderBy: [{ field: "month", direction: "asc" }] }');
+export const dslSelectFieldSchema = z.union([
+    z.string().describe('Plain field name (e.g. "region") or dot-notation for joined tables (e.g. "products.category")'),
+    dslAggregateFieldSchema,
+    dslWindowFieldSchema,
+]);
+export const dslGroupByFieldSchema = z.union([
+    z.string().describe('Field to group by'),
+    z.object({
+        field: z.string().describe('Date/time field to bucket'),
+        bucket: z.enum(['day', 'week', 'month', 'quarter', 'year']).describe('Time bucket size'),
+    }).describe('Time-bucketed group — e.g. { field: "order_date", bucket: "month" }'),
+]);
+export const dslFilterSchema = z.object({
+    field: z.string().describe('Field to filter on'),
+    op: z.enum(['=', '!=', '>', '>=', '<', '<=', 'in', 'not_in', 'between', 'is_null', 'is_not_null']).describe('Comparison operator'),
+    value: z.any().optional().describe('Filter value. For "in"/"not_in": use an array. For "between": use [min, max]. For "is_null"/"is_not_null": omit.'),
+});
+const dslQueryInnerSchema = z.object({
+    join: z.array(dslJoinSchema).optional().describe('Tables to join within the same source. Example: [{ table: "products", on: { left: "product_id", right: "id" } }]'),
+    select: z.array(dslSelectFieldSchema).describe('Fields to return. Mix plain fields and aggregates. Examples: ["region", { field: "revenue", aggregate: "sum", as: "total" }]'),
+    groupBy: z.array(dslGroupByFieldSchema).optional().describe('Group rows before aggregating. Supports time bucketing. Examples: ["region"], [{ field: "order_date", bucket: "month" }]'),
+    filter: z.array(dslFilterSchema).optional().describe('Row filters (before aggregation). Array or single object. Shorthand: { field, equals: value } or { field, gt/gte/lt/lte: value }. Canonical: { field, op, value }.'),
+    having: z.array(dslFilterSchema).optional().describe('Post-aggregation filters — reference aggregate aliases. Array or single object. Same shorthand as filter.'),
+    orderBy: z.array(z.object({
+        field: z.string(),
+        direction: z.enum(['asc', 'desc']),
+    })).optional().describe('Sort order. Array or single object. Example: { field: "total", direction: "desc" }'),
+    limit: z.number().optional().describe('Max rows to return'),
+});
+export const dslQuerySchema = z.preprocess(normalizeDslQueryInput, dslQueryInnerSchema);
+// ─── DASHBOARD SCHEMAS ──────────────────────────────────────────────────────
+const ALL_PALETTE_NAMES = [
+    'categorical', 'blue', 'green', 'purple', 'warm',
+    'blueRed', 'greenPurple', 'tealOrange', 'redGreen',
+    'traffic-light', 'profit-loss', 'temperature',
+];
+export const dashboardViewSchema = z.object({
+    id: z.string().describe('Stable view identifier (e.g., "revenue-trend", "sales-by-region")'),
+    title: z.string().describe('View title displayed above the chart'),
+    intent: z.string().describe('What this view shows — drives pattern selection (e.g., "compare revenue by region")'),
+    query: dslQuerySchema.describe('Per-view DSL query for this view\'s data'),
+    pattern: z.string().optional().describe('Pattern override (e.g., "bar", "line"). Auto-selected if omitted.'),
+    colorPreferences: z.object({
+        palette: z.enum(ALL_PALETTE_NAMES).optional(),
+        highlight: z.object({
+            values: z.array(z.any()),
+            color: z.union([z.string(), z.array(z.string())]).optional(),
+            mutedColor: z.string().optional(),
+            mutedOpacity: z.number().optional(),
+        }).optional(),
+        colorField: z.string().optional(),
+    }).optional().describe('Color preferences for this view'),
+    config: z.record(z.any()).optional().describe('Pattern-specific config overrides'),
+});
+export const dashboardFilterSchema = z.object({
+    field: z.string().describe('Data field to filter on'),
+    label: z.string().optional().describe('Display label (defaults to field name)'),
+    type: z.enum(['select', 'multi-select', 'range', 'date-range']).describe('Filter control type'),
+    values: z.array(z.any()).optional().describe('Allowed values (auto-populated from data if omitted)'),
+    currentValue: z.any().optional().describe('Initial filter value'),
+});
+export const dashboardLayoutSchema = z.object({
+    columns: z.number().min(1).max(4).describe('Grid columns (1-4)'),
+    viewSizes: z.record(z.object({
+        colSpan: z.number().optional(),
+        rowSpan: z.number().optional(),
+    })).optional().describe('Per-view size overrides keyed by view ID'),
+});
+export const dashboardInteractionSchema = z.object({
+    type: z.enum(['crossfilter', 'highlight']).describe('Interaction type'),
+    field: z.string().describe('Data field to link on'),
+    views: z.array(z.string()).optional().describe('Participating view IDs (all if omitted)'),
+});
+export const createDashboardInputSchema = z.object({
+    sourceId: z.string().describe('Source ID from add_source'),
+    table: z.string().describe('Base table within the source'),
+    title: z.string().optional().describe('Dashboard title'),
+    description: z.string().optional().describe('Dashboard description'),
+    views: z.array(dashboardViewSchema).min(1).describe('Dashboard views — each with its own query and intent'),
+    globalFilters: z.array(dashboardFilterSchema).optional().describe('Global filter controls'),
+    layout: dashboardLayoutSchema.optional().describe('Grid layout (auto-calculated if omitted)'),
+    interactions: z.array(dashboardInteractionSchema).optional().describe('Cross-view interactions'),
+    theme: z.enum(['dark', 'light']).optional().describe('Color theme (default: dark)'),
+});
+export const refineDashboardInputSchema = z.object({
+    currentSpec: z.object({
+        dashboard: z.literal(true),
+        id: z.string(),
+        title: z.string(),
+        description: z.string().optional(),
+        sourceId: z.string(),
+        table: z.string(),
+        views: z.array(z.any()),
+        globalFilters: z.array(z.any()).optional(),
+        layout: z.any(),
+        interactions: z.array(z.any()).optional(),
+        theme: z.enum(['dark', 'light']).optional(),
+    }).describe('The current dashboard spec to refine'),
+    refinement: z.string().describe('What to change — e.g., "add a chart showing revenue by month", "remove the trend chart", "make it 3 columns", "add a region filter"'),
+});
+//# sourceMappingURL=dsl-schemas.js.map

package/dist/src/mcp/tools/dsl-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-schemas.js","sourceRoot":"","sources":["../../../../src/mcp/tools/dsl-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tools/export-html.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Tool: export_html
+ * Returns the full rendered HTML for a previously-created visualization.
+ * Accepts a specId from a visualize, visualize_from_source, or refine call.
+ *
+ * Designed for programmatic consumption — the returned HTML is a complete,
+ * self-contained document that can be opened in a browser or screenshotted.
+ */
+import { z } from 'zod';
+export declare const exportHtmlInputSchema: z.ZodObject<{
+    specId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    specId: string;
+}, {
+    specId: string;
+}>;
+export declare function handleExportHtml(): (args: z.infer<typeof exportHtmlInputSchema>) => Promise<import("./shared.js").McpResponse>;
+//# sourceMappingURL=export-html.d.ts.map

package/dist/src/mcp/tools/export-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-html.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/export-html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,wBAAgB,gBAAgB,KAChB,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,gDAwB1D"}

package/dist/src/mcp/tools/export-html.js

@@ -0,0 +1,40 @@
+/**
+ * MCP Tool: export_html
+ * Returns the full rendered HTML for a previously-created visualization.
+ * Accepts a specId from a visualize, visualize_from_source, or refine call.
+ *
+ * Designed for programmatic consumption — the returned HTML is a complete,
+ * self-contained document that can be opened in a browser or screenshotted.
+ */
+import { z } from 'zod';
+import { isCompoundSpec } from '../../types.js';
+import { buildChartHtml, isHtmlPatternSupported } from '../../renderers/html/index.js';
+import { buildCompoundHtml } from '../../renderers/html/builders/compound.js';
+import { specStore } from '../spec-store.js';
+import { errorResponse } from './shared.js';
+export const exportHtmlInputSchema = z.object({
+    specId: z.string().describe('Spec ID from a previous visualize, visualize_from_source, or refine call'),
+});
+export function handleExportHtml() {
+    return async (args) => {
+        const stored = specStore.get(args.specId);
+        if (!stored) {
+            return errorResponse(`Spec "${args.specId}" not found or expired. Create a new visualization first.`);
+        }
+        const { spec } = stored;
+        if (isCompoundSpec(spec)) {
+            const html = buildCompoundHtml(spec);
+            return {
+                content: [{ type: 'text', text: html }],
+            };
+        }
+        if (!isHtmlPatternSupported(spec.pattern)) {
+            return errorResponse(`Pattern "${spec.pattern}" does not have an HTML builder.`);
+        }
+        const html = buildChartHtml(spec);
+        return {
+            content: [{ type: 'text', text: html }],
+        };
+    };
+}
+//# sourceMappingURL=export-html.js.map

package/dist/src/mcp/tools/export-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-html.js","sourceRoot":"","sources":["../../../../src/mcp/tools/export-html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0EAA0E,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,EAAE,IAA2C,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,aAAa,CAAC,SAAS,IAAI,CAAC,MAAM,2DAA2D,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aACjD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC,YAAY,IAAI,CAAC,OAAO,kCAAkC,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/list-patterns.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Tool: list_patterns
+ * Returns all available visualization patterns with their descriptions,
+ * best-for hints, data requirements, per-pattern capabilities, and
+ * full color system documentation.
+ */
+import type { VisualizationPattern } from '../../types.js';
+export declare function handleListPatterns(getPatterns: () => VisualizationPattern[]): () => Promise<import("./shared.js").McpResponse>;
+//# sourceMappingURL=list-patterns.d.ts.map

package/dist/src/mcp/tools/list-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-patterns.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/list-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAkR3D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,oBAAoB,EAAE,oDAmB3E"}

package/dist/src/mcp/tools/list-patterns.js

@@ -0,0 +1,286 @@
+/**
+ * MCP Tool: list_patterns
+ * Returns all available visualization patterns with their descriptions,
+ * best-for hints, data requirements, per-pattern capabilities, and
+ * full color system documentation.
+ */
+import { jsonResponse } from './shared.js';
+const PATTERN_CAPABILITIES = {
+    'bar': {
+        colorEncoding: 'Supports palette, highlight (emphasize specific bars), color.field for multi-series',
+    },
+    'diverging-bar': {
+        colorEncoding: 'Automatic positive/negative coloring. Supports palette (diverging palettes recommended: blueRed, greenPurple, tealOrange)',
+    },
+    'stacked-bar': {
+        colorEncoding: 'Color mapped to series field. Supports palette, highlight specific series',
+    },
+    'slope-chart': {
+        colorEncoding: 'Color mapped to category. Supports palette, highlight specific categories',
+    },
+    'connected-dot-plot': {
+        colorEncoding: 'Color distinguishes start/end points. Supports palette, highlight specific categories',
+    },
+    'bump-chart': {
+        colorEncoding: 'Color mapped to entity/series. Supports palette, highlight specific entities',
+    },
+    'histogram': {
+        colorEncoding: 'Single-color bars by default. Supports palette for fill color',
+    },
+    'beeswarm': {
+        colorEncoding: 'Supports palette, highlight, color.field for group coloring',
+    },
+    'violin': {
+        colorEncoding: 'Color mapped to group. Supports palette',
+        configOptions: { bandwidth: 'number (kernel bandwidth, default: auto-calculated)' },
+    },
+    'ridgeline': {
+        colorEncoding: 'Color per distribution row. Supports palette',
+        configOptions: { bandwidth: 'number (kernel bandwidth, default: auto-calculated)' },
+    },
+    'strip-plot': {
+        colorEncoding: 'Supports palette, highlight, color.field for group coloring',
+    },
+    'box-plot': {
+        colorEncoding: 'Color mapped to group. Supports palette',
+        configOptions: {
+            whiskerType: '"iqr" | "minmax" (whisker extent, default: "iqr")',
+            showOutliers: 'boolean (show outlier dots beyond whiskers, default: true)',
+            showMean: 'boolean (show diamond mean marker, default: false)',
+        },
+    },
+    'waffle': {
+        colorEncoding: 'Color mapped to category. Supports palette, highlight',
+    },
+    'treemap': {
+        colorEncoding: 'Color mapped to category/parent. Supports palette, highlight',
+    },
+    'sunburst': {
+        colorEncoding: 'Color mapped to hierarchy level. Supports palette',
+    },
+    'circle-pack': {
+        colorEncoding: 'Color mapped to group/parent. Supports palette, highlight',
+    },
+    'metric': {
+        colorEncoding: 'Minimal color support (dark background with light text, green/red for delta indicators)',
+        configOptions: {
+            labelField: 'string (field name for metric labels)',
+            valueField: 'string (field name for metric values)',
+            previousValueField: 'string | null (field name for previous/comparison values — enables delta % indicators)',
+            abbreviate: 'boolean (auto-abbreviate large numbers e.g. 1.2M, 450K — default: true)',
+            format: '"currency" | "percent" | "integer" | "decimal" | "auto" (default: "auto")',
+            prefix: 'string (prepended to value, e.g. "$" — default: "")',
+            suffix: 'string (appended to value, e.g. " units" — default: "")',
+            columns: 'number | "auto" (grid columns 1-4, or "auto" to choose based on count — default: "auto")',
+        },
+    },
+    'line': {
+        colorEncoding: 'Color mapped to series. Supports palette, highlight specific series',
+    },
+    'area': {
+        colorEncoding: 'Color mapped to series. Supports palette, highlight specific series',
+        configOptions: {
+            stacked: 'boolean (stack series on top of each other, default: false)',
+            normalized: 'boolean (100% stacked showing proportions, requires stacked, default: false)',
+            curve: '"linear" | "monotone" | "step" | "curve" | "cardinal" | "catmullRom" (interpolation mode — step=staircase, curve=smooth rounded, default: "monotone")',
+            opacity: 'number (fill opacity 0-1, default: 0.7)',
+        },
+    },
+    'small-multiples': {
+        colorEncoding: 'Color mapped to series within panels. Supports palette',
+    },
+    'sparkline-grid': {
+        colorEncoding: 'Supports palette for line colors',
+    },
+    'calendar-heatmap': {
+        colorEncoding: 'Sequential color scale for values. Supports palette (sequential palettes recommended: blue, green, purple, warm)',
+    },
+    'scatter': {
+        colorEncoding: 'Supports palette, highlight, color.field for group coloring',
+    },
+    'connected-scatter': {
+        colorEncoding: 'Color mapped to series. Supports palette, highlight',
+    },
+    'parallel-coordinates': {
+        colorEncoding: 'Color mapped to a chosen dimension. Supports palette, highlight',
+    },
+    'radar': {
+        colorEncoding: 'Color mapped to entity. Supports palette, highlight',
+    },
+    'heatmap': {
+        colorEncoding: 'Sequential or diverging color scale for cell values. Supports palette (sequential: blue, green, purple, warm; diverging: blueRed, greenPurple, tealOrange)',
+        configOptions: {
+            showValues: 'boolean (show numeric values in cells, auto-enabled when cells are large enough)',
+            sortRows: '"ascending" | "descending" (sort row categories alphabetically)',
+            sortCols: '"ascending" | "descending" (sort column categories alphabetically)',
+        },
+    },
+    'sankey': {
+        colorEncoding: 'Color by source or target node. Supports palette',
+        configOptions: { colorBy: '"source" | "target" (which node determines link color)' },
+    },
+    'alluvial': {
+        colorEncoding: 'Color by source or target. Supports palette',
+        configOptions: { colorBy: '"source" | "target" (which node determines flow color)' },
+    },
+    'chord': {
+        colorEncoding: 'Color mapped to source group. Supports palette',
+        configOptions: { colorBy: '"source" | "target"' },
+    },
+    'donut': {
+        colorEncoding: 'Color mapped to category slices. Supports palette, highlight',
+        configOptions: {
+            innerRadius: 'number (0 = pie, 0.5-0.7 = donut, default: 0.55)',
+            showLabels: 'boolean (show percentage labels on slices, default: true)',
+            showPercentages: 'boolean (labels show % vs absolute values, default: true)',
+            centerLabel: 'string (text displayed in the donut hole, default: empty — shows total)',
+        },
+    },
+    'choropleth': {
+        colorEncoding: 'Sequential or diverging color scale for map regions. Supports palette',
+        configOptions: {
+            topojsonUrl: 'string (URL to custom TopoJSON file)',
+            objectName: 'string (TopoJSON object to extract features from)',
+            nameProperty: 'string (feature property to match data, default: "name")',
+        },
+    },
+    'proportional-symbol': {
+        colorEncoding: 'Supports palette for symbol fill, color.field for grouping',
+        configOptions: {
+            topojsonUrl: 'string (URL to custom TopoJSON file)',
+            objectName: 'string (TopoJSON object to extract features from)',
+            nameProperty: 'string (feature property to match data, default: "name")',
+        },
+    },
+    'lollipop': {
+        colorEncoding: 'Color mapped to category. Supports palette, highlight',
+        configOptions: {
+            orientation: '"horizontal" | "vertical" (default: "horizontal")',
+        },
+    },
+    'bullet': {
+        colorEncoding: 'Color ranges for qualitative bands. Supports palette',
+        configOptions: {
+            targetField: 'string (field for target/goal marker)',
+            rangeFields: 'string[] (fields for qualitative range bands)',
+        },
+    },
+    'density-plot': {
+        colorEncoding: 'Color mapped to group. Supports palette',
+        configOptions: {
+            bandwidth: 'number (kernel bandwidth, default: auto-calculated)',
+            kernel: '"gaussian" | "epanechnikov" (kernel function, default: "gaussian")',
+        },
+    },
+    'marimekko': {
+        colorEncoding: 'Color mapped to sub-category. Supports palette, highlight',
+        configOptions: {
+            categoryField: 'string (field for column categories)',
+            subCategoryField: 'string (field for row segments within columns)',
+            valueField: 'string (field for segment values)',
+        },
+    },
+    'icicle': {
+        colorEncoding: 'Color mapped to top-level ancestor. Supports palette',
+        configOptions: {
+            orientation: '"horizontal" | "vertical" (default: "horizontal")',
+            showValues: 'boolean (show values in cells, default: true)',
+        },
+    },
+    'stream-graph': {
+        colorEncoding: 'Color mapped to series/layer. Supports palette',
+        configOptions: {
+            offset: '"wiggle" | "silhouette" | "expand" | "none" (stacking offset, default: "wiggle")',
+            curve: '"basis" | "cardinal" | "monotone" (interpolation, default: "basis")',
+        },
+    },
+    'horizon-chart': {
+        colorEncoding: 'Sequential color bands for value layers. Supports palette',
+        configOptions: {
+            bands: 'number (number of horizon bands, default: 4)',
+            mode: '"mirror" | "offset" (negative value handling, default: "mirror")',
+        },
+    },
+    'funnel': {
+        colorEncoding: 'Color mapped to stage. Supports palette, highlight',
+        configOptions: {
+            showConversion: 'boolean (show conversion rates between stages, default: true)',
+            orientation: '"vertical" | "horizontal" (default: "vertical")',
+        },
+    },
+    'grouped-bar': {
+        colorEncoding: 'Color mapped to series. Supports palette, highlight specific series',
+        configOptions: {
+            orientation: '"vertical" | "horizontal" (default: "vertical")',
+            categoryField: 'string (field for group categories)',
+            seriesField: 'string (field for series within groups)',
+            valueField: 'string (field for bar values)',
+        },
+    },
+    'waterfall': {
+        colorEncoding: 'Automatic positive (green) / negative (red) / total (blue) coloring',
+        configOptions: {
+            totalColumns: 'string[] | "first" | "last" (which bars are totals anchored to zero, default: ["first", "last"])',
+            showConnectors: 'boolean (show dashed connector lines between bars, default: true)',
+            positiveColor: 'string (CSS color for increases, default: "#3dd9a0")',
+            negativeColor: 'string (CSS color for decreases, default: "#ff6b5e")',
+            totalColor: 'string (CSS color for total bars, default: theme blue)',
+        },
+    },
+};
+// ─── COLOR SYSTEM DOCUMENTATION ─────────────────────────────────────────────
+const COLOR_SYSTEM_DOCS = {
+    palettes: {
+        categorical: ['categorical — 10 distinct colors for nominal categories'],
+        sequential: [
+            'blue — light-to-dark blue ramp',
+            'green — light-to-dark green ramp',
+            'purple — light-to-dark purple ramp',
+            'warm — light-to-dark warm (orange/red) ramp',
+        ],
+        diverging: [
+            'blueRed — blue↔red for +/- values',
+            'greenPurple — green↔purple diverging',
+            'tealOrange — teal↔orange diverging',
+            'redGreen — red↔green diverging',
+        ],
+        semantic: [
+            'traffic-light — red/yellow/green for status',
+            'profit-loss — green (profit) / red (loss)',
+            'temperature — cold-blue to hot-red',
+        ],
+    },
+    highlightMode: {
+        description: 'Emphasize specific data values while muting all others to gray. Works with any pattern that has categorical color mapping.',
+        usage: 'Set encoding.color.highlight.values to an array of values to emphasize. Optionally set color (CSS color or array), mutedColor (default: #6b7280), mutedOpacity (default: 1.0).',
+        examples: [
+            'highlight: { values: ["Offer"] } — highlight one value, others gray',
+            'highlight: { values: ["North", "South"], color: "#ff6b6b" } — highlight with custom color',
+            'highlight: { values: ["Q1"], mutedOpacity: 0.3 } — stronger de-emphasis',
+        ],
+    },
+    howToApply: {
+        visualize: 'Pass colorPreferences: { palette?, highlight?, colorField? } in the visualize tool input',
+        refine: 'Pass a natural language refinement like "use warm palette", "highlight Engineering and Science", "mute to 30% opacity", "color by target"',
+    },
+};
+// ─── HANDLER ────────────────────────────────────────────────────────────────
+export function handleListPatterns(getPatterns) {
+    return async () => {
+        const patterns = getPatterns();
+        const listing = patterns.map(p => ({
+            id: p.id,
+            name: p.name,
+            category: p.category,
+            description: p.description,
+            bestFor: p.bestFor,
+            notFor: p.notFor,
+            dataRequirements: p.dataRequirements,
+            capabilities: PATTERN_CAPABILITIES[p.id] || {
+                colorEncoding: 'Supports palette',
+            },
+        }));
+        return jsonResponse({ patterns: listing, colorSystem: COLOR_SYSTEM_DOCS });
+    };
+}
+//# sourceMappingURL=list-patterns.js.map