@outsidedata/dolex 0.1.0

package/dist/src/theme/typography.js

@@ -0,0 +1,139 @@
+/**
+ * Dolex Design System — Typography Tokens
+ *
+ * Consistent type scale for chart titles, labels, annotations, and UI elements.
+ * Designed for data-dense visualizations where readability at small sizes is critical.
+ *
+ * Font stack: Inter is the primary face (excellent tabular figures, narrow at small sizes).
+ * Falls back through system-ui to ensure consistent metrics cross-platform.
+ */
+// ─── FONT FAMILIES ────────────────────────────────────────────────────────────
+export const fontFamily = {
+    /** Primary sans-serif stack for all chart text */
+    sans: 'Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    /** Monospace stack for data values, code, and tabular figures */
+    mono: '"JetBrains Mono", "Fira Code", "SF Mono", Menlo, Consolas, monospace',
+};
+// ─── FONT SIZES ───────────────────────────────────────────────────────────────
+//
+// Pixel values. SVG text uses these directly; CSS renderers can convert to rem.
+// Scale is tighter than typical UI because chart text lives inside constrained space.
+export const fontSize = {
+    /** Chart title — the largest text element in a visualization */
+    title: 14,
+    /** Chart subtitle, section headers within legends */
+    subtitle: 12,
+    /** Axis labels, legend items, tick labels */
+    label: 11,
+    /** Annotations, footnotes, data source attribution */
+    annotation: 10,
+    /** Sparkline labels, dense small-multiples, compact mode ticks */
+    micro: 9,
+};
+// ─── FONT WEIGHTS ─────────────────────────────────────────────────────────────
+export const fontWeight = {
+    /** Body text, tick labels, legend items */
+    regular: 400,
+    /** Axis titles, emphasized labels */
+    medium: 500,
+    /** Chart titles, highlighted values */
+    semibold: 600,
+};
+// ─── LINE HEIGHTS ─────────────────────────────────────────────────────────────
+//
+// Unitless multipliers relative to font-size. Tighter for chart elements
+// (single-line), looser for multi-line annotations.
+export const lineHeight = {
+    /** Single-line chart elements: titles, labels, ticks */
+    tight: 1.2,
+    /** Default for most text */
+    normal: 1.4,
+    /** Multi-line annotations, tooltip content, descriptions */
+    relaxed: 1.6,
+};
+// ─── LETTER SPACING ───────────────────────────────────────────────────────────
+//
+// Em values. Slight tracking aids legibility at small sizes.
+export const letterSpacing = {
+    /** Default — no adjustment */
+    normal: '0em',
+    /** Slight expansion for labels at micro size */
+    wide: '0.02em',
+    /** Uppercase text or very small elements */
+    wider: '0.04em',
+};
+export const textStyles = {
+    /** Chart title */
+    chartTitle: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.title,
+        fontWeight: fontWeight.semibold,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Chart subtitle or legend header */
+    chartSubtitle: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.subtitle,
+        fontWeight: fontWeight.medium,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Axis titles */
+    axisTitle: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.subtitle,
+        fontWeight: fontWeight.medium,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Tick labels, legend item text */
+    axisLabel: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.label,
+        fontWeight: fontWeight.regular,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Data labels placed on or near marks */
+    dataLabel: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.label,
+        fontWeight: fontWeight.medium,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Annotations and footnotes */
+    annotation: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.annotation,
+        fontWeight: fontWeight.regular,
+        lineHeight: lineHeight.relaxed,
+        letterSpacing: letterSpacing.wide,
+    },
+    /** Very small text for dense layouts */
+    micro: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.micro,
+        fontWeight: fontWeight.regular,
+        lineHeight: lineHeight.tight,
+        letterSpacing: letterSpacing.wider,
+    },
+    /** Monospace data values (tables, tooltips) */
+    dataValue: {
+        fontFamily: fontFamily.mono,
+        fontSize: fontSize.label,
+        fontWeight: fontWeight.regular,
+        lineHeight: lineHeight.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    /** Tooltip text */
+    tooltip: {
+        fontFamily: fontFamily.sans,
+        fontSize: fontSize.subtitle,
+        fontWeight: fontWeight.regular,
+        lineHeight: lineHeight.relaxed,
+        letterSpacing: letterSpacing.normal,
+    },
+};
+//# sourceMappingURL=typography.js.map

package/dist/src/theme/typography.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.js","sourceRoot":"","sources":["../../../src/theme/typography.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kDAAkD;IAClD,IAAI,EAAE,qFAAqF;IAC3F,iEAAiE;IACjE,IAAI,EAAE,sEAAsE;CACpE,CAAC;AAEX,iFAAiF;AACjF,EAAE;AACF,gFAAgF;AAChF,sFAAsF;AAEtF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,gEAAgE;IAChE,KAAK,EAAE,EAAE;IACT,qDAAqD;IACrD,QAAQ,EAAE,EAAE;IACZ,6CAA6C;IAC7C,KAAK,EAAE,EAAE;IACT,sDAAsD;IACtD,UAAU,EAAE,EAAE;IACd,kEAAkE;IAClE,KAAK,EAAE,CAAC;CACA,CAAC;AAIX,iFAAiF;AAEjF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2CAA2C;IAC3C,OAAO,EAAE,GAAG;IACZ,qCAAqC;IACrC,MAAM,EAAE,GAAG;IACX,uCAAuC;IACvC,QAAQ,EAAE,GAAG;CACL,CAAC;AAIX,iFAAiF;AACjF,EAAE;AACF,yEAAyE;AACzE,oDAAoD;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wDAAwD;IACxD,KAAK,EAAE,GAAG;IACV,4BAA4B;IAC5B,MAAM,EAAE,GAAG;IACX,4DAA4D;IAC5D,OAAO,EAAE,GAAG;CACJ,CAAC;AAIX,iFAAiF;AACjF,EAAE;AACF,6DAA6D;AAE7D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,8BAA8B;IAC9B,MAAM,EAAE,KAAK;IACb,gDAAgD;IAChD,IAAI,EAAE,QAAQ;IACd,4CAA4C;IAC5C,KAAK,EAAE,QAAQ;CACP,CAAC;AAeX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB;IAClB,UAAU,EAAE;QACV,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,UAAU,EAAE,UAAU,CAAC,QAAQ;QAC/B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,sCAAsC;IACtC,aAAa,EAAE;QACb,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,kBAAkB;IAClB,SAAS,EAAE;QACT,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,oCAAoC;IACpC,SAAS,EAAE;QACT,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,0CAA0C;IAC1C,SAAS,EAAE;QACT,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,gCAAgC;IAChC,UAAU,EAAE;QACV,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU;QAC7B,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,aAAa,EAAE,aAAa,CAAC,IAAI;KAClC;IACD,wCAAwC;IACxC,KAAK,EAAE;QACL,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,aAAa,EAAE,aAAa,CAAC,KAAK;KACnC;IACD,+CAA+C;IAC/C,SAAS,EAAE;QACT,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;IACD,mBAAmB;IACnB,OAAO,EAAE;QACP,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,aAAa,EAAE,aAAa,CAAC,MAAM;KACpC;CAC2C,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,473 @@
+/**
+ * Shared types for Dolex - Visualization MCP + Query Engine
+ */
+export interface DataColumn {
+    name: string;
+    type: 'numeric' | 'categorical' | 'date' | 'id' | 'text';
+    sampleValues: string[];
+    uniqueCount: number;
+    nullCount: number;
+    totalCount: number;
+    /** Numeric columns: summary statistics */
+    stats?: {
+        min: number;
+        max: number;
+        mean: number;
+        median: number;
+        stddev: number;
+        p25: number;
+        p75: number;
+    };
+    /** Categorical/date columns: most frequent values with counts */
+    topValues?: {
+        value: string;
+        count: number;
+    }[];
+}
+export interface DataTable {
+    name: string;
+    columns: DataColumn[];
+    rowCount: number;
+}
+/** Enhanced table profile returned by add_source — includes sample rows */
+export interface DataProfiledTable extends DataTable {
+    /** 5 representative sample rows picked for variety */
+    sampleRows: Record<string, any>[];
+}
+export interface ForeignKey {
+    fromTable: string;
+    fromColumn: string;
+    toTable: string;
+    toColumn: string;
+}
+export interface DataSchema {
+    tables: DataTable[];
+    foreignKeys: ForeignKey[];
+    source: DataSourceInfo;
+}
+export type DataSourceType = 'csv' | 'sqlite' | 'postgres' | 'mysql';
+export interface DataSourceInfo {
+    id: string;
+    type: DataSourceType;
+    name: string;
+    config: DataSourceConfig;
+}
+export type DataSourceConfig = CsvSourceConfig | SqliteSourceConfig | PostgresSourceConfig | MysqlSourceConfig;
+export interface CsvSourceConfig {
+    type: 'csv';
+    /** Directory containing CSV files, or path to a single CSV */
+    path: string;
+}
+export interface SqliteSourceConfig {
+    type: 'sqlite';
+    path: string;
+}
+export interface PostgresSourceConfig {
+    type: 'postgres';
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean;
+}
+export interface MysqlSourceConfig {
+    type: 'mysql';
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+}
+/** Aggregate function for the query DSL */
+export type DslAggregate = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'count_distinct' | 'median' | 'p25' | 'p75' | 'stddev' | 'percentile';
+/** An aggregate select field */
+export interface DslAggregateField {
+    field: string;
+    aggregate: DslAggregate;
+    as: string;
+    /** For aggregate: 'percentile' — the percentile value (0–1), e.g. 0.95 for p95 */
+    percentile?: number;
+}
+/** Window function name */
+export type DslWindowFunction = 'lag' | 'lead' | 'rank' | 'dense_rank' | 'row_number' | 'running_sum' | 'running_avg' | 'pct_of_total';
+/** A window function select field — references base query output columns */
+export interface DslWindowField {
+    window: DslWindowFunction;
+    /** Field to operate on (required for lag, lead, running_sum, running_avg, pct_of_total) */
+    field?: string;
+    /** Output column name */
+    as: string;
+    /** Partition columns (default: whole result set) */
+    partitionBy?: string[];
+    /** Sort order within the window (required for lag, lead, rank, dense_rank, row_number, running_sum, running_avg) */
+    orderBy?: DslOrderBy[];
+    /** Offset for lag/lead (default: 1) */
+    offset?: number;
+    /** Default value for lag/lead when offset is out of range */
+    default?: any;
+}
+/** A field selection — plain string for pass-through, object for aggregation or window */
+export type DslSelectField = string | DslAggregateField | DslWindowField;
+/** Type guard: check if a select field is an aggregate field */
+export declare function isDslAggregateField(field: DslSelectField): field is DslAggregateField;
+/** Type guard: check if a select field is a window function field */
+export declare function isDslWindowField(field: DslSelectField): field is DslWindowField;
+/** A group-by field — plain string or time-bucketed */
+export type DslGroupByField = string | {
+    field: string;
+    bucket: 'day' | 'week' | 'month' | 'quarter' | 'year';
+};
+/** Filter operator */
+export type DslFilterOp = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'in' | 'not_in' | 'between' | 'is_null' | 'is_not_null';
+/** A filter condition */
+export interface DslFilter {
+    field: string;
+    op: DslFilterOp;
+    value?: any;
+}
+/** Sort directive */
+export interface DslOrderBy {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+/** A join clause — attaches another table in the same source */
+export interface DslJoin {
+    /** Table name to join */
+    table: string;
+    /** Join key mapping */
+    on: {
+        /** Field from the left/current table (supports table.field dot notation) */
+        left: string;
+        /** Field from the joined table */
+        right: string;
+    };
+    /** Join type. Default: 'left' */
+    type?: 'inner' | 'left';
+}
+/** The full declarative query */
+export interface DslQuery {
+    join?: DslJoin[];
+    select: DslSelectField[];
+    groupBy?: DslGroupByField[];
+    filter?: DslFilter[];
+    having?: DslFilter[];
+    orderBy?: DslOrderBy[];
+    limit?: number;
+}
+/** Source-based input for visualize (alternative to inline data) */
+export interface SourceDataRef {
+    sourceId: string;
+    table: string;
+    query: DslQuery;
+}
+export type PatternCategory = 'comparison' | 'distribution' | 'composition' | 'time' | 'relationship' | 'flow' | 'geo';
+export interface DataRequirements {
+    /** Minimum number of data rows */
+    minRows?: number;
+    /** Maximum number of data rows (beyond this, consider alternatives) */
+    maxRows?: number;
+    /** Required column types */
+    requiredColumns?: {
+        type: DataColumn['type'];
+        count: number;
+        description: string;
+    }[];
+    /** Minimum number of categories */
+    minCategories?: number;
+    /** Maximum recommended categories */
+    maxCategories?: number;
+    /** Whether time-series data is required */
+    requiresTimeSeries?: boolean;
+    /** Whether hierarchical data is needed */
+    requiresHierarchy?: boolean;
+}
+/** Selection rule: when should this pattern be chosen over others */
+export interface SelectionRule {
+    /** Human-readable condition description */
+    condition: string;
+    /** Priority weight (higher = preferred when rule matches) */
+    weight: number;
+    /** Function that evaluates whether this rule matches the data shape */
+    matches: (ctx: PatternMatchContext) => boolean;
+}
+export interface PatternMatchContext {
+    data: Record<string, any>[];
+    columns: DataColumn[];
+    intent: string;
+    dataShape: {
+        rowCount: number;
+        categoryCount: number;
+        seriesCount: number;
+        numericColumnCount: number;
+        categoricalColumnCount: number;
+        dateColumnCount: number;
+        hasTimeSeries: boolean;
+        hasHierarchy: boolean;
+        hasNegativeValues: boolean;
+        valueRange: {
+            min: number;
+            max: number;
+        };
+    };
+}
+export interface VisualizationPattern {
+    id: string;
+    name: string;
+    category: PatternCategory;
+    description: string;
+    /** When to use this instead of the obvious choice */
+    bestFor: string;
+    /** What NOT to use this for */
+    notFor?: string;
+    /** Data shape requirements */
+    dataRequirements: DataRequirements;
+    /** Rules for when to select this pattern */
+    selectionRules: SelectionRule[];
+    /** Generate the output spec from data */
+    generateSpec: (data: Record<string, any>[], columns: string[], options?: Record<string, any>) => VisualizationSpec;
+}
+export interface VisualizationSpec {
+    pattern: string;
+    title: string;
+    data: Record<string, any>[];
+    encoding: {
+        x?: AxisEncoding;
+        y?: AxisEncoding;
+        color?: ColorEncoding;
+        size?: SizeEncoding;
+        [key: string]: any;
+    };
+    /** Pattern-specific configuration */
+    config: Record<string, any>;
+}
+export interface AxisEncoding {
+    field: string;
+    type: 'quantitative' | 'nominal' | 'ordinal' | 'temporal';
+    title?: string;
+    sort?: 'ascending' | 'descending' | null;
+    format?: string;
+}
+export type ColorPaletteName = 'categorical' | 'blue' | 'green' | 'purple' | 'warm' | 'blueRed' | 'greenPurple' | 'tealOrange' | 'redGreen' | 'traffic-light' | 'profit-loss' | 'temperature';
+export interface ColorEncoding {
+    field?: string;
+    type?: 'nominal' | 'ordinal' | 'quantitative';
+    scale?: {
+        domain?: any[];
+        range?: string[];
+    };
+    title?: string;
+    /** Named palette to use for color mapping (overrides default palette) */
+    palette?: ColorPaletteName;
+    /** Highlight mode: specific values get color, others are muted gray */
+    highlight?: {
+        /** Values to highlight (all others become muted) */
+        values: any[];
+        /** Color(s) for highlighted values. Single color or array matching values length. */
+        color?: string | string[];
+        /** Gray color for non-highlighted items (default: #6b7280) */
+        mutedColor?: string;
+        /** Opacity for muted items (default: 1.0, can reduce for stronger deemphasis) */
+        mutedOpacity?: number;
+    };
+}
+export interface SizeEncoding {
+    field: string;
+    type: 'quantitative';
+    title?: string;
+    range?: [number, number];
+}
+export interface VisualizationRecommendation {
+    pattern: VisualizationPattern;
+    spec: VisualizationSpec;
+    score: number;
+    reasoning: string;
+}
+export type GeoLevel = 'country' | 'subdivision';
+export interface VisualizeInput {
+    data: Record<string, any>[];
+    intent: string;
+    columns?: DataColumn[];
+    dataShapeHints?: Partial<PatternMatchContext['dataShape']>;
+    forcePattern?: string;
+    geoLevel?: GeoLevel;
+    geoRegion?: string;
+}
+export interface VisualizeOutput {
+    recommended: {
+        pattern: string;
+        spec: VisualizationSpec;
+        reasoning: string;
+    };
+    alternatives: {
+        pattern: string;
+        spec: VisualizationSpec;
+        reasoning: string;
+    }[];
+}
+export interface RefineInput {
+    specId: string;
+    refinement: string;
+    selectAlternative?: string;
+}
+export interface RefineOutput {
+    spec: VisualizationSpec | CompoundVisualizationSpec;
+    changes: string[];
+}
+/** A compound visualization: multiple linked views of the same data. */
+export interface CompoundVisualizationSpec {
+    /** Discriminator — renderers check this to decide how to render */
+    compound: true;
+    /** Overall title for the compound visualization */
+    title: string;
+    /** Shared data — all views reference this instead of embedding their own copy */
+    data: Record<string, any>[];
+    /** The views that make up this compound visualization */
+    views: CompoundView[];
+    /** How views are arranged */
+    layout: CompoundLayout;
+    /** Interaction links between views */
+    interactions: Interaction[];
+}
+/** A single view within a compound visualization */
+export interface CompoundView {
+    /** Unique ID within this compound spec */
+    id: string;
+    /** What kind of view this is */
+    type: 'chart' | 'table';
+    /** For chart views: a VisualizationSpec (minus data, which comes from parent) */
+    chart?: Omit<VisualizationSpec, 'data'>;
+    /** For table views: table-specific configuration */
+    table?: TableViewSpec;
+}
+/** Configuration for a data table view */
+export interface TableViewSpec {
+    /** Which columns to display, in order. Omit to show all. */
+    columns?: TableColumn[];
+    /** Default sort */
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    /** Maximum rows to show before scrolling */
+    pageSize?: number;
+}
+/** A column definition within a table view */
+export interface TableColumn {
+    /** Field name from the data */
+    field: string;
+    /** Display header (defaults to field name) */
+    title?: string;
+    /** Number format string (e.g., ',.0f' for integers, '$,.2f' for currency) */
+    format?: string;
+    /** Column width hint */
+    width?: 'narrow' | 'medium' | 'wide' | number;
+    /** Text alignment */
+    align?: 'left' | 'center' | 'right';
+}
+/** How views are arranged in a compound visualization */
+export interface CompoundLayout {
+    /** Arrangement of views */
+    type: 'rows' | 'columns';
+    /** Relative sizes of each view (maps to CSS fr units) */
+    sizes?: number[];
+    /** Gap between views in pixels */
+    gap?: number;
+}
+/** An interaction link between views */
+export interface Interaction {
+    /** What kind of linking */
+    type: 'highlight';
+    /** Which data field to link on */
+    field: string;
+    /** Which views participate (by ID). Omit to include all views. */
+    views?: string[];
+}
+/** Type guard: check if a spec is a CompoundVisualizationSpec */
+export declare function isCompoundSpec(spec: VisualizationSpec | CompoundVisualizationSpec): spec is CompoundVisualizationSpec;
+/** A dashboard: multiple views with independent queries, global filters, and cross-filtering. */
+export interface DashboardSpec {
+    /** Discriminator — renderers check this to decide how to render */
+    dashboard: true;
+    /** Stable ID for persistence across conversation turns */
+    id: string;
+    /** Dashboard title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** Single source for v1 */
+    sourceId: string;
+    /** Base table within the source */
+    table: string;
+    /** The views that make up this dashboard */
+    views: DashboardViewSpec[];
+    /** Global filter controls */
+    globalFilters?: DashboardFilter[];
+    /** Grid layout configuration */
+    layout: DashboardLayout;
+    /** Interaction links between views */
+    interactions?: DashboardInteraction[];
+    /** Color theme */
+    theme?: 'dark' | 'light';
+}
+/** A single view within a dashboard — each has its own query */
+export interface DashboardViewSpec {
+    /** Stable, user-referenceable ID */
+    id: string;
+    /** View title */
+    title: string;
+    /** Intent string for pattern selection */
+    intent: string;
+    /** Per-view DSL query */
+    query: DslQuery;
+    /** Optional pattern override (auto-select if omitted) */
+    pattern?: string;
+    /** Color preferences for this view */
+    colorPreferences?: {
+        palette?: ColorPaletteName;
+        highlight?: {
+            values: any[];
+            color?: string | string[];
+            mutedColor?: string;
+            mutedOpacity?: number;
+        };
+        colorField?: string;
+    };
+    /** Pattern-specific configuration overrides */
+    config?: Record<string, any>;
+}
+/** A global filter control on the dashboard */
+export interface DashboardFilter {
+    /** Field name to filter on */
+    field: string;
+    /** Display label (defaults to field name) */
+    label?: string;
+    /** Filter control type */
+    type: 'select' | 'multi-select' | 'range' | 'date-range';
+    /** Allowed values (populated from data at render time if omitted) */
+    values?: any[];
+    /** Current filter state */
+    currentValue?: any;
+}
+/** Grid layout configuration for a dashboard */
+export interface DashboardLayout {
+    /** Number of grid columns (1-4) */
+    columns: number;
+    /** Per-view size overrides: colSpan and rowSpan */
+    viewSizes?: Record<string, {
+        colSpan?: number;
+        rowSpan?: number;
+    }>;
+}
+/** An interaction link between dashboard views */
+export interface DashboardInteraction {
+    /** Interaction type */
+    type: 'crossfilter' | 'highlight';
+    /** Which data field to link on */
+    field: string;
+    /** Participating view IDs (all views if omitted) */
+    views?: string[];
+}
+/** Type guard: check if a spec is a DashboardSpec */
+export declare function isDashboardSpec(spec: VisualizationSpec | CompoundVisualizationSpec | DashboardSpec): spec is DashboardSpec;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,20 @@
+/**
+ * Shared types for Dolex - Visualization MCP + Query Engine
+ */
+/** Type guard: check if a select field is an aggregate field */
+export function isDslAggregateField(field) {
+    return typeof field !== 'string' && 'aggregate' in field;
+}
+/** Type guard: check if a select field is a window function field */
+export function isDslWindowField(field) {
+    return typeof field !== 'string' && 'window' in field;
+}
+/** Type guard: check if a spec is a CompoundVisualizationSpec */
+export function isCompoundSpec(spec) {
+    return 'compound' in spec && spec.compound === true;
+}
+/** Type guard: check if a spec is a DashboardSpec */
+export function isDashboardSpec(spec) {
+    return 'dashboard' in spec && spec.dashboard === true;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuIH,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACvD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,IAAI,KAAK,CAAC;AAC3D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,CAAC;AACxD,CAAC;AA6UD,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAC5B,IAAmD;IAEnD,OAAO,UAAU,IAAI,IAAI,IAAK,IAAkC,CAAC,QAAQ,KAAK,IAAI,CAAC;AACrF,CAAC;AAgHD,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAC7B,IAAmE;IAEnE,OAAO,WAAW,IAAI,IAAI,IAAK,IAAsB,CAAC,SAAS,KAAK,IAAI,CAAC;AAC3E,CAAC"}