@blazes/data-visualization 0.0.0-stage → 1.0.0-alpha.0

package/dist/core/adapter/standard-adapters.d.ts

@@ -0,0 +1,211 @@
+import type { BarBinding, LineBinding, MetricBinding, PieBinding, TableBinding, VisualizationEnhancement, WordCloudBinding } from "../config";
+import type { VisualizationAdapter } from "./types";
+import type { BarViewModel, LineViewModel, MetricViewModel, PieViewModel, TableViewModel, WordCloudViewModel } from "./view-models";
+type EnhancementFor<TType extends VisualizationEnhancement["type"]> = Extract<VisualizationEnhancement, {
+    type: TType;
+}>;
+export declare const metricAdapter: VisualizationAdapter<MetricBinding, EnhancementFor<"metric">, MetricViewModel>;
+export declare const lineAdapter: VisualizationAdapter<LineBinding, EnhancementFor<"line">, LineViewModel>;
+export declare const barAdapter: VisualizationAdapter<BarBinding, EnhancementFor<"bar">, BarViewModel>;
+export declare const pieAdapter: VisualizationAdapter<PieBinding, EnhancementFor<"pie">, PieViewModel>;
+export declare const wordCloudAdapter: VisualizationAdapter<WordCloudBinding, EnhancementFor<"wordCloud">, WordCloudViewModel>;
+export declare const tableAdapter: VisualizationAdapter<TableBinding, EnhancementFor<"table">, TableViewModel>;
+export declare const STANDARD_ADAPTERS: readonly (VisualizationAdapter<{
+    compareField?: string;
+    type: "metric";
+    datasetId: string;
+    valueField: string;
+}, {
+    metric?: {
+        showComparison?: boolean;
+        compareLabel?: string;
+        comparisonColorMode?: "meaning" | "direction";
+        compareMeaning?: "neutral" | "positive" | "negative";
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "metric";
+}, MetricViewModel> | VisualizationAdapter<{
+    seriesField?: string;
+    type: "line";
+    datasetId: string;
+    xField: string;
+    yFields: string[];
+}, {
+    line?: {
+        showLabels?: boolean;
+        smooth?: number | boolean;
+        markCategories?: (string | number)[];
+        markValues?: number[];
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "line";
+}, LineViewModel> | VisualizationAdapter<{
+    seriesField?: string;
+    type: "bar";
+    datasetId: string;
+    categoryField: string;
+    valueFields: string[];
+}, {
+    bar?: {
+        showLabels?: boolean;
+        orientation?: "vertical" | "horizontal";
+        visibleCount?: number;
+        sort?: "none" | "ascending" | "descending";
+        stacked?: boolean;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "bar";
+}, BarViewModel> | VisualizationAdapter<{
+    type: "pie";
+    datasetId: string;
+    valueField: string;
+    nameField: string;
+}, {
+    pie?: {
+        maxItems?: number;
+        othersLabel?: string;
+        donut?: boolean;
+        showLegend?: boolean;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "pie";
+}, PieViewModel> | VisualizationAdapter<{
+    type: "table";
+    datasetId: string;
+    columns: string[];
+}, {
+    table?: {
+        pageSize?: number;
+        showPagination?: boolean;
+        sortableFields?: string[];
+        filterableFields?: string[];
+        columnWidths?: {
+            [x: string]: number;
+        };
+        columnDisplays?: {
+            [x: string]: {
+                max?: number;
+                type: "progress";
+            } | {
+                positiveTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                negativeTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                zeroTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                type: "trend";
+            } | {
+                toneByValue?: {
+                    [x: string]: "neutral" | "info" | "success" | "warning" | "danger";
+                };
+                defaultTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                type: "tag";
+            };
+        };
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "table";
+}, TableViewModel> | VisualizationAdapter<{
+    semanticField?: string;
+    type: "wordCloud";
+    datasetId: string;
+    valueField: string;
+    labelFields: string[];
+}, {
+    wordCloud?: {
+        maxItems?: number;
+        minFontSize?: number;
+        maxFontSize?: number;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "wordCloud";
+}, WordCloudViewModel>)[];
+export {};
+//# sourceMappingURL=standard-adapters.d.ts.map

package/dist/core/adapter/standard-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-adapters.d.ts","sourceRoot":"","sources":["../../../src/core/adapter/standard-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAGV,WAAW,EAEX,aAAa,EAEb,UAAU,EAEV,YAAY,EAIZ,wBAAwB,EACxB,gBAAgB,EAEjB,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EACV,YAAY,EAEZ,aAAa,EACb,eAAe,EAEf,YAAY,EACZ,cAAc,EACd,kBAAkB,EAEnB,MAAM,eAAe,CAAC;AAEvB,KAAK,cAAc,CAAC,KAAK,SAAS,wBAAwB,CAAC,MAAM,CAAC,IAAI,OAAO,CAC3E,wBAAwB,EACxB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAChB,CAAC;AAoIF,eAAO,MAAM,aAAa,EAAE,oBAAoB,CAAC,aAAa,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,eAAe,CAiCxG,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,oBAAoB,CAAC,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,aAAa,CAsBhG,CAAC;AAsBF,eAAO,MAAM,UAAU,EAAE,oBAAoB,CAAC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CAuB5F,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,oBAAoB,CAAC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CA0C5F,CAAC;AASF,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,CACjD,gBAAgB,EAChB,cAAc,CAAC,WAAW,CAAC,EAC3B,kBAAkB,CAyCnB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,oBAAoB,CAAC,YAAY,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,CAmCpG,CAAC;AAOF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAO5B,CAAC"}

package/dist/core/adapter/standard-definitions.d.ts

@@ -0,0 +1,230 @@
+import type { VisualizationRendererDefinition } from "./types";
+export declare const metricRendererDefinition: VisualizationRendererDefinition;
+export declare const lineRendererDefinition: VisualizationRendererDefinition;
+export declare const barRendererDefinition: VisualizationRendererDefinition;
+export declare const pieRendererDefinition: VisualizationRendererDefinition;
+export declare const tableRendererDefinition: VisualizationRendererDefinition;
+export declare const wordCloudRendererDefinition: VisualizationRendererDefinition;
+export declare const STANDARD_RENDERER_DEFINITIONS: readonly VisualizationRendererDefinition<{
+    compareField?: string;
+    type: "metric";
+    datasetId: string;
+    valueField: string;
+} | {
+    seriesField?: string;
+    type: "line";
+    datasetId: string;
+    xField: string;
+    yFields: string[];
+} | {
+    seriesField?: string;
+    type: "bar";
+    datasetId: string;
+    categoryField: string;
+    valueFields: string[];
+} | {
+    type: "pie";
+    datasetId: string;
+    valueField: string;
+    nameField: string;
+} | {
+    type: "table";
+    datasetId: string;
+    columns: string[];
+} | {
+    semanticField?: string;
+    type: "wordCloud";
+    datasetId: string;
+    valueField: string;
+    labelFields: string[];
+} | {
+    type: "pivotTableS2";
+    datasetId: string;
+    valueFields: string[];
+    rowFields: string[];
+    columnFields: string[];
+}, {
+    metric?: {
+        showComparison?: boolean;
+        compareLabel?: string;
+        comparisonColorMode?: "meaning" | "direction";
+        compareMeaning?: "neutral" | "positive" | "negative";
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "metric";
+} | {
+    line?: {
+        showLabels?: boolean;
+        smooth?: number | boolean;
+        markCategories?: (string | number)[];
+        markValues?: number[];
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "line";
+} | {
+    bar?: {
+        showLabels?: boolean;
+        orientation?: "vertical" | "horizontal";
+        visibleCount?: number;
+        sort?: "none" | "ascending" | "descending";
+        stacked?: boolean;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "bar";
+} | {
+    pie?: {
+        maxItems?: number;
+        othersLabel?: string;
+        donut?: boolean;
+        showLegend?: boolean;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "pie";
+} | {
+    table?: {
+        pageSize?: number;
+        showPagination?: boolean;
+        sortableFields?: string[];
+        filterableFields?: string[];
+        columnWidths?: {
+            [x: string]: number;
+        };
+        columnDisplays?: {
+            [x: string]: {
+                max?: number;
+                type: "progress";
+            } | {
+                positiveTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                negativeTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                zeroTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                type: "trend";
+            } | {
+                toneByValue?: {
+                    [x: string]: "neutral" | "info" | "success" | "warning" | "danger";
+                };
+                defaultTone?: "neutral" | "info" | "success" | "warning" | "danger";
+                type: "tag";
+            };
+        };
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "table";
+} | {
+    wordCloud?: {
+        maxItems?: number;
+        minFontSize?: number;
+        maxFontSize?: number;
+    };
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "wordCloud";
+} | {
+    pivotTableS2?: {};
+    common?: {
+        formatOverrides?: {
+            [x: string]: {
+                precision?: number;
+                unit?: string;
+                emptyText?: string;
+                useGrouping?: boolean;
+                type: "number" | "integer" | "decimal" | "percent" | "currency" | "date" | "datetime";
+            };
+        };
+        presetIds?: string[];
+        interactions?: {
+            event: "dataPointClick" | "rowClick" | "legendChange";
+            actionId: string;
+        }[];
+    };
+    type: "pivotTableS2";
+}>[];
+//# sourceMappingURL=standard-definitions.d.ts.map

package/dist/core/adapter/standard-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-definitions.d.ts","sourceRoot":"","sources":["../../../src/core/adapter/standard-definitions.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAQ/D,eAAO,MAAM,wBAAwB,EAAE,+BAMrC,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,+BAMnC,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,+BAMlC,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,+BAMlC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,+BAMpC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,+BAMxC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOxC,CAAC"}

package/dist/core/adapter/types.d.ts

@@ -0,0 +1,44 @@
+import type { PanelBinding, VisualizationEnhancement } from "../config";
+import type { DatasetResult } from "../dataset";
+import type { RuntimeSchema } from "../config/runtime-schema";
+import type { DashboardContext } from "../variable";
+export interface VisualizationAdapterInput<TBinding extends PanelBinding = PanelBinding, TEnhancement extends VisualizationEnhancement = VisualizationEnhancement> {
+    dataset: DatasetResult;
+    binding: TBinding;
+    enhancement?: TEnhancement;
+    context: DashboardContext;
+}
+export interface VisualizationAdapter<TBinding extends PanelBinding = PanelBinding, TEnhancement extends VisualizationEnhancement = VisualizationEnhancement, TViewModel = unknown> {
+    id: string;
+    adapt(input: VisualizationAdapterInput<TBinding, TEnhancement>): TViewModel;
+}
+export interface RendererCapabilities {
+    responsive: boolean;
+    csv: boolean;
+    png: boolean;
+    selection: boolean;
+}
+export interface VisualizationRendererDefinition<TBinding extends PanelBinding = PanelBinding, TEnhancement extends VisualizationEnhancement = VisualizationEnhancement> {
+    id: string;
+    bindingSchema: RuntimeSchema<TBinding>;
+    enhancementSchema: RuntimeSchema<TEnhancement>;
+    defaultAdapterId: string;
+    capabilities: Readonly<RendererCapabilities>;
+}
+export interface VisualizationPreset {
+    id: string;
+    rendererId?: string;
+    apply(enhancement: VisualizationEnhancement | undefined): VisualizationEnhancement;
+}
+export type VisualizationEventType = "dataPointClick" | "rowClick" | "legendChange";
+export interface VisualizationEvent {
+    type: VisualizationEventType;
+    panelId: string;
+    datasetId: string;
+    fields: Readonly<Record<string, unknown>>;
+}
+export interface VisualizationAction {
+    id: string;
+    execute(event: VisualizationEvent, context: DashboardContext): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/adapter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/adapter/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,yBAAyB,CACxC,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,YAAY,SAAS,wBAAwB,GAAG,wBAAwB;IAExE,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,QAAQ,CAAC;IAClB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB,CACnC,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,YAAY,SAAS,wBAAwB,GAAG,wBAAwB,EACxE,UAAU,GAAG,OAAO;IAEpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,yBAAyB,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,UAAU,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B,CAC9C,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,YAAY,SAAS,wBAAwB,GAAG,wBAAwB;IAExE,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,iBAAiB,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,WAAW,EAAE,wBAAwB,GAAG,SAAS,GAAG,wBAAwB,CAAC;CACpF;AAED,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF"}

package/dist/core/adapter/view-models.d.ts

@@ -0,0 +1,101 @@
+import type { DatasetDiagnostic } from "../dataset";
+import type { TableCellDisplay, ValueFormat } from "../config";
+export interface VisualizationViewModelBase {
+    type: string;
+    empty: boolean;
+}
+export interface MetricComparisonViewModel {
+    label: string;
+    value: number;
+    direction: "up" | "down" | "flat";
+    meaning: "positive" | "negative" | "neutral";
+    colorMode: "meaning" | "direction";
+    format: ValueFormat;
+}
+export interface MetricViewModel extends VisualizationViewModelBase {
+    type: "metric";
+    label: string;
+    value: number | null;
+    format: ValueFormat;
+    unit?: string;
+    comparison?: MetricComparisonViewModel;
+}
+export interface CartesianSeriesViewModel {
+    id: string;
+    valueFieldId: string;
+    axisKey: string;
+    label: string;
+    values: ReadonlyArray<number | null>;
+    format: ValueFormat;
+    unit?: string;
+}
+export interface LineAnnotationViewModel {
+    type: "category" | "value";
+    value: string | number;
+}
+export interface LineViewModel extends VisualizationViewModelBase {
+    type: "line";
+    categories: ReadonlyArray<string | number>;
+    categoryFormat?: ValueFormat;
+    series: ReadonlyArray<CartesianSeriesViewModel>;
+    showLabels: boolean;
+    smooth: boolean | number;
+    annotations: ReadonlyArray<LineAnnotationViewModel>;
+}
+export interface BarViewModel extends VisualizationViewModelBase {
+    type: "bar";
+    categories: ReadonlyArray<string>;
+    series: ReadonlyArray<CartesianSeriesViewModel>;
+    orientation: "vertical" | "horizontal";
+    visibleCount?: number;
+    showLabels: boolean;
+    stacked: boolean;
+}
+export interface PieItemViewModel {
+    id: string;
+    label: string;
+    value: number;
+}
+export interface PieViewModel extends VisualizationViewModelBase {
+    type: "pie";
+    items: ReadonlyArray<PieItemViewModel>;
+    valueFormat: ValueFormat;
+    unit?: string;
+    donut: boolean;
+    showLegend: boolean;
+}
+export interface WordCloudWordViewModel {
+    id: string;
+    label: string;
+    value: number;
+    semantic?: string;
+}
+export interface WordCloudViewModel extends VisualizationViewModelBase {
+    type: "wordCloud";
+    words: ReadonlyArray<WordCloudWordViewModel>;
+    valueFormat: ValueFormat;
+    unit?: string;
+    minFontSize: number;
+    maxFontSize: number;
+}
+export interface TableColumnViewModel {
+    field: string;
+    label: string;
+    dataType: "string" | "number" | "boolean" | "date" | "datetime";
+    format?: ValueFormat;
+    unit?: string;
+    width?: number;
+    display?: TableCellDisplay;
+    sortable: boolean;
+    filterable: boolean;
+}
+export interface TableViewModel extends VisualizationViewModelBase {
+    type: "table";
+    columns: ReadonlyArray<TableColumnViewModel>;
+    rows: ReadonlyArray<Readonly<Record<string, unknown>>>;
+    pageSize: number;
+    showPagination: boolean;
+    diagnostics: ReadonlyArray<DatasetDiagnostic>;
+}
+export type StandardVisualizationViewModel = MetricViewModel | LineViewModel | BarViewModel | PieViewModel | TableViewModel | WordCloudViewModel;
+//# sourceMappingURL=view-models.d.ts.map

package/dist/core/adapter/view-models.d.ts.map

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

package/dist/core/config/config-validator.d.ts

@@ -0,0 +1,27 @@
+import type { CoreRegistries } from "../registry";
+import type { VisualizationTelemetrySink } from "../telemetry";
+import type { DashboardConfig } from "./dashboard-config-schema";
+export interface ConfigDiagnostic {
+    level: "error";
+    code: string;
+    message: string;
+    path: string;
+}
+export type DashboardConfigValidationResult = {
+    valid: true;
+    config: DashboardConfig;
+    diagnostics: readonly [];
+} | {
+    valid: false;
+    diagnostics: ReadonlyArray<ConfigDiagnostic>;
+};
+export interface ValidateDashboardConfigOptions {
+    telemetry?: VisualizationTelemetrySink;
+}
+export declare class DashboardConfigValidationError extends Error {
+    readonly diagnostics: ReadonlyArray<ConfigDiagnostic>;
+    constructor(diagnostics: ReadonlyArray<ConfigDiagnostic>);
+}
+export declare function validateDashboardConfig(value: unknown, registries: CoreRegistries, options?: ValidateDashboardConfigOptions): DashboardConfigValidationResult;
+export declare function assertDashboardConfig(value: unknown, registries: CoreRegistries, options?: ValidateDashboardConfigOptions): DashboardConfig;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/core/config/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAiD,MAAM,2BAA2B,CAAC;AAGhH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,+BAA+B,GACvC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,SAAS,EAAE,CAAA;CAAE,GAClE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;gBAE1C,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC;CAKzD;AAuLD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,8BAAmC,GAC3C,+BAA+B,CAyVjC;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,8BAAmC,GAC3C,eAAe,CAMjB"}