exploreda 0.0.5

package/dist/ExplorEda.d.cts

@@ -0,0 +1,332 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as THREE from 'three';
+
+interface FilterBase {
+    type: string;
+    field: string;
+}
+interface ValueFilter extends FilterBase {
+    type: "value";
+    values: Array<datum$1>;
+}
+interface RangeFilter extends FilterBase {
+    type: "range";
+    min?: number;
+    max?: number;
+}
+interface TextFilter extends FilterBase {
+    type: "text";
+    operator: "contains" | "equals" | "startsWith" | "endsWith";
+    value: string;
+}
+type Filter = ValueFilter | RangeFilter | TextFilter;
+type datum$1 = string | number | boolean | undefined;
+
+interface BarChartSettings extends BaseChartSettings {
+    type: "bar";
+    binCount?: number;
+    forceString?: boolean;
+    filters: Filter[];
+}
+
+interface DataTableSettings extends BaseChartSettings {
+    type: "data-table";
+    columns: Array<{
+        id: string;
+        field: string;
+        width?: number;
+    }>;
+    pageSize: number;
+    currentPage: number;
+    sortBy?: string;
+    sortDirection: "asc" | "desc";
+    filters: Filter[];
+    globalSearch: string;
+    tableHeight: number;
+}
+
+interface MarkdownSettings extends BaseChartSettings {
+    type: "markdown";
+    content: string;
+}
+
+interface PivotTableSettings extends BaseChartSettings {
+    type: "pivot";
+    rowFields: string[];
+    columnField: string;
+    valueFields: Array<{
+        field: string;
+        aggregation: "sum" | "count" | "avg" | "min" | "max" | "median" | "mode" | "stddev" | "variance" | "countUnique" | "singleValue";
+        formula?: string;
+        label?: string;
+    }>;
+    showTotals: {
+        row: boolean;
+        column: boolean;
+        grand: boolean;
+    };
+    dateBinning?: {
+        field: string;
+        type: "day" | "month" | "year";
+    };
+}
+
+interface ScatterPlotSettings extends BaseChartSettings {
+    type: "scatter";
+    xField: string;
+    yField: string;
+    filters: Filter[];
+}
+
+interface SummaryTableSettings extends BaseChartSettings {
+    type: "summary";
+}
+
+interface ThreeDScatterSettings extends BaseChartSettings {
+    type: "3d-scatter";
+    xField: string;
+    yField: string;
+    zField: string;
+    colorField: string | undefined;
+    sizeField?: string;
+    cameraPosition: THREE.Vector3;
+    cameraTarget: THREE.Vector3;
+    pointSize: number;
+    pointOpacity: number;
+    showGrid: boolean;
+    showAxes: boolean;
+    xAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+    yAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+    zAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+}
+
+interface BoxPlotStyleSettings {
+    boxFill: string;
+    boxStroke: string;
+    boxStrokeWidth: number;
+    medianStroke: string;
+    medianStrokeWidth: number;
+    whiskerStroke: string;
+    whiskerStrokeWidth: number;
+    outlierSize: number;
+    outlierStroke: string;
+    outlierFill: string;
+}
+interface BoxPlotSettings extends BaseChartSettings {
+    type: "boxplot";
+    whiskerType: "tukey" | "minmax" | "stdDev";
+    showOutliers: boolean;
+    violinOverlay: boolean;
+    beeSwarmOverlay: boolean;
+    styles: BoxPlotStyleSettings;
+    filters: Filter[];
+    sortBy: "median" | "label";
+    violinBandwidth: number;
+    autoBandwidth: boolean;
+}
+
+interface SeriesSettings {
+    showPoints: boolean;
+    pointSize: number;
+    pointOpacity: number;
+    lineWidth: number;
+    lineOpacity: number;
+    lineColor?: string;
+    lineStyle: "solid" | "dashed" | "dotted";
+    useRightAxis: boolean;
+}
+interface LineChartSettings extends BaseChartSettings {
+    type: "line";
+    xField: string;
+    seriesField: string[];
+    seriesSettings: Record<string, SeriesSettings>;
+    styles: {
+        curveType: "linear" | "monotoneX" | "step";
+    };
+    showXGrid: boolean;
+    showYGrid: boolean;
+    showLegend: boolean;
+    legendPosition: "top" | "right" | "bottom" | "left";
+}
+
+interface ChartLayout {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface BaseFacetSettings {
+    enabled: boolean;
+    type: "grid" | "wrap";
+}
+interface GridFacetSettings extends BaseFacetSettings {
+    type: "grid";
+    rowVariable: string;
+    columnVariable: string;
+}
+interface WrapFacetSettings extends BaseFacetSettings {
+    type: "wrap";
+    rowVariable: string;
+    columnCount: number;
+}
+type FacetSettings = GridFacetSettings | WrapFacetSettings;
+interface AxisSettings {
+    title?: string;
+    scaleType?: "linear" | "log" | "time" | "band";
+    grid?: boolean;
+    min?: number;
+    max?: number;
+}
+interface MarginSettings {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+interface BaseChartSettings {
+    id: string;
+    title: string;
+    type: string;
+    field: string;
+    layout: ChartLayout;
+    colorScaleId: string | undefined;
+    colorField: string | undefined;
+    facet: FacetSettings;
+    xAxis: AxisSettings;
+    yAxis: AxisSettings;
+    margin: MarginSettings;
+    filters: Filter[];
+    xAxisLabel: string;
+    yAxisLabel: string;
+    xGridLines: number;
+    yGridLines: number;
+}
+interface RowChartSettings extends BaseChartSettings {
+    type: "row";
+    minRowHeight: number;
+    maxRowHeight: number;
+}
+type ChartSettings = RowChartSettings | BarChartSettings | ScatterPlotSettings | PivotTableSettings | ThreeDScatterSettings | SummaryTableSettings | DataTableSettings | MarkdownSettings | BoxPlotSettings | LineChartSettings;
+type datum = string | number | boolean | undefined;
+
+type AggregationType = "sum" | "count" | "min" | "max" | "average" | "countUnique" | "percentile" | "median" | "stddev" | "variance";
+interface BaseExpression {
+    id: string;
+    name: string;
+    expression: string;
+    dependencies: string[];
+    rawInput: string;
+}
+interface BasicExpression extends BaseExpression {
+    type: "basic";
+    left: Expression;
+    right: Expression;
+    operator: string;
+}
+interface FunctionExpression extends BaseExpression {
+    type: "function";
+    functionName: string;
+    arguments: Expression[];
+    functionCategory?: string;
+    returnType?: string;
+    parameterTypes?: string[];
+}
+interface GroupExpression extends BaseExpression {
+    type: "group";
+    groupBy: string[];
+    aggregation: AggregationType;
+}
+interface RankExpression extends BaseExpression {
+    type: "rank";
+    rankBy: string[];
+    isNormalized: boolean;
+    isCumulative: boolean;
+}
+interface AdvancedExpression extends BaseExpression {
+    type: "advanced";
+    algorithm: "pca" | "tsne" | "umap" | "som";
+    parameters?: Record<string, any>;
+    regressionType?: "linear" | "polynomial";
+    degree?: number;
+    predictors?: string[];
+    response?: string;
+}
+interface TernaryExpression extends BaseExpression {
+    type: "ternary";
+    condition: Expression;
+    trueBranch: Expression;
+    falseBranch: Expression;
+}
+interface UnaryExpression extends BaseExpression {
+    type: "unary";
+    operand: Expression;
+    operator: string;
+}
+interface LiteralExpression extends BaseExpression {
+    type: "literal";
+    value: any;
+}
+type Expression = BasicExpression | FunctionExpression | GroupExpression | RankExpression | AdvancedExpression | TernaryExpression | UnaryExpression | LiteralExpression;
+
+interface CalculationDefinition {
+    expression: Expression;
+    resultColumnName: string;
+}
+
+interface BaseColorScale {
+    id: string;
+    name: string;
+}
+interface NumericalColorScale extends BaseColorScale {
+    type: "numerical";
+    palette: string;
+    min: number;
+    max: number;
+}
+interface CategoricalColorScale extends BaseColorScale {
+    type: "categorical";
+    palette: string[];
+    mapping: Map<string, string>;
+}
+
+interface GridSettings {
+    columnCount: number;
+    rowHeight: number;
+    containerPadding: number;
+    showBackgroundMarkers: boolean;
+}
+interface ViewMetadata {
+    name: string;
+    version: number;
+    createdAt: string;
+    modifiedAt: string;
+}
+interface SerializedCategoricalColorScale extends Omit<CategoricalColorScale, "mapping"> {
+    type: "categorical";
+    mapping: [string, string][];
+}
+type SerializedColorScale = NumericalColorScale | SerializedCategoricalColorScale;
+interface SavedDataStructure {
+    charts: ChartSettings[];
+    calculations: CalculationDefinition[];
+    gridSettings: GridSettings;
+    metadata: ViewMetadata;
+    colorScales: SerializedColorScale[];
+}
+
+type DatumObject = {
+    [key: string]: datum;
+};
+
+declare function ExplorEda({ data, savedData, }: {
+    data: DatumObject[];
+    savedData: SavedDataStructure | undefined;
+}): react_jsx_runtime.JSX.Element;
+
+export { ExplorEda };

package/dist/ExplorEda.d.ts

@@ -0,0 +1,332 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as THREE from 'three';
+
+interface FilterBase {
+    type: string;
+    field: string;
+}
+interface ValueFilter extends FilterBase {
+    type: "value";
+    values: Array<datum$1>;
+}
+interface RangeFilter extends FilterBase {
+    type: "range";
+    min?: number;
+    max?: number;
+}
+interface TextFilter extends FilterBase {
+    type: "text";
+    operator: "contains" | "equals" | "startsWith" | "endsWith";
+    value: string;
+}
+type Filter = ValueFilter | RangeFilter | TextFilter;
+type datum$1 = string | number | boolean | undefined;
+
+interface BarChartSettings extends BaseChartSettings {
+    type: "bar";
+    binCount?: number;
+    forceString?: boolean;
+    filters: Filter[];
+}
+
+interface DataTableSettings extends BaseChartSettings {
+    type: "data-table";
+    columns: Array<{
+        id: string;
+        field: string;
+        width?: number;
+    }>;
+    pageSize: number;
+    currentPage: number;
+    sortBy?: string;
+    sortDirection: "asc" | "desc";
+    filters: Filter[];
+    globalSearch: string;
+    tableHeight: number;
+}
+
+interface MarkdownSettings extends BaseChartSettings {
+    type: "markdown";
+    content: string;
+}
+
+interface PivotTableSettings extends BaseChartSettings {
+    type: "pivot";
+    rowFields: string[];
+    columnField: string;
+    valueFields: Array<{
+        field: string;
+        aggregation: "sum" | "count" | "avg" | "min" | "max" | "median" | "mode" | "stddev" | "variance" | "countUnique" | "singleValue";
+        formula?: string;
+        label?: string;
+    }>;
+    showTotals: {
+        row: boolean;
+        column: boolean;
+        grand: boolean;
+    };
+    dateBinning?: {
+        field: string;
+        type: "day" | "month" | "year";
+    };
+}
+
+interface ScatterPlotSettings extends BaseChartSettings {
+    type: "scatter";
+    xField: string;
+    yField: string;
+    filters: Filter[];
+}
+
+interface SummaryTableSettings extends BaseChartSettings {
+    type: "summary";
+}
+
+interface ThreeDScatterSettings extends BaseChartSettings {
+    type: "3d-scatter";
+    xField: string;
+    yField: string;
+    zField: string;
+    colorField: string | undefined;
+    sizeField?: string;
+    cameraPosition: THREE.Vector3;
+    cameraTarget: THREE.Vector3;
+    pointSize: number;
+    pointOpacity: number;
+    showGrid: boolean;
+    showAxes: boolean;
+    xAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+    yAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+    zAxis: AxisSettings & {
+        zoomLevel: number;
+    };
+}
+
+interface BoxPlotStyleSettings {
+    boxFill: string;
+    boxStroke: string;
+    boxStrokeWidth: number;
+    medianStroke: string;
+    medianStrokeWidth: number;
+    whiskerStroke: string;
+    whiskerStrokeWidth: number;
+    outlierSize: number;
+    outlierStroke: string;
+    outlierFill: string;
+}
+interface BoxPlotSettings extends BaseChartSettings {
+    type: "boxplot";
+    whiskerType: "tukey" | "minmax" | "stdDev";
+    showOutliers: boolean;
+    violinOverlay: boolean;
+    beeSwarmOverlay: boolean;
+    styles: BoxPlotStyleSettings;
+    filters: Filter[];
+    sortBy: "median" | "label";
+    violinBandwidth: number;
+    autoBandwidth: boolean;
+}
+
+interface SeriesSettings {
+    showPoints: boolean;
+    pointSize: number;
+    pointOpacity: number;
+    lineWidth: number;
+    lineOpacity: number;
+    lineColor?: string;
+    lineStyle: "solid" | "dashed" | "dotted";
+    useRightAxis: boolean;
+}
+interface LineChartSettings extends BaseChartSettings {
+    type: "line";
+    xField: string;
+    seriesField: string[];
+    seriesSettings: Record<string, SeriesSettings>;
+    styles: {
+        curveType: "linear" | "monotoneX" | "step";
+    };
+    showXGrid: boolean;
+    showYGrid: boolean;
+    showLegend: boolean;
+    legendPosition: "top" | "right" | "bottom" | "left";
+}
+
+interface ChartLayout {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface BaseFacetSettings {
+    enabled: boolean;
+    type: "grid" | "wrap";
+}
+interface GridFacetSettings extends BaseFacetSettings {
+    type: "grid";
+    rowVariable: string;
+    columnVariable: string;
+}
+interface WrapFacetSettings extends BaseFacetSettings {
+    type: "wrap";
+    rowVariable: string;
+    columnCount: number;
+}
+type FacetSettings = GridFacetSettings | WrapFacetSettings;
+interface AxisSettings {
+    title?: string;
+    scaleType?: "linear" | "log" | "time" | "band";
+    grid?: boolean;
+    min?: number;
+    max?: number;
+}
+interface MarginSettings {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+interface BaseChartSettings {
+    id: string;
+    title: string;
+    type: string;
+    field: string;
+    layout: ChartLayout;
+    colorScaleId: string | undefined;
+    colorField: string | undefined;
+    facet: FacetSettings;
+    xAxis: AxisSettings;
+    yAxis: AxisSettings;
+    margin: MarginSettings;
+    filters: Filter[];
+    xAxisLabel: string;
+    yAxisLabel: string;
+    xGridLines: number;
+    yGridLines: number;
+}
+interface RowChartSettings extends BaseChartSettings {
+    type: "row";
+    minRowHeight: number;
+    maxRowHeight: number;
+}
+type ChartSettings = RowChartSettings | BarChartSettings | ScatterPlotSettings | PivotTableSettings | ThreeDScatterSettings | SummaryTableSettings | DataTableSettings | MarkdownSettings | BoxPlotSettings | LineChartSettings;
+type datum = string | number | boolean | undefined;
+
+type AggregationType = "sum" | "count" | "min" | "max" | "average" | "countUnique" | "percentile" | "median" | "stddev" | "variance";
+interface BaseExpression {
+    id: string;
+    name: string;
+    expression: string;
+    dependencies: string[];
+    rawInput: string;
+}
+interface BasicExpression extends BaseExpression {
+    type: "basic";
+    left: Expression;
+    right: Expression;
+    operator: string;
+}
+interface FunctionExpression extends BaseExpression {
+    type: "function";
+    functionName: string;
+    arguments: Expression[];
+    functionCategory?: string;
+    returnType?: string;
+    parameterTypes?: string[];
+}
+interface GroupExpression extends BaseExpression {
+    type: "group";
+    groupBy: string[];
+    aggregation: AggregationType;
+}
+interface RankExpression extends BaseExpression {
+    type: "rank";
+    rankBy: string[];
+    isNormalized: boolean;
+    isCumulative: boolean;
+}
+interface AdvancedExpression extends BaseExpression {
+    type: "advanced";
+    algorithm: "pca" | "tsne" | "umap" | "som";
+    parameters?: Record<string, any>;
+    regressionType?: "linear" | "polynomial";
+    degree?: number;
+    predictors?: string[];
+    response?: string;
+}
+interface TernaryExpression extends BaseExpression {
+    type: "ternary";
+    condition: Expression;
+    trueBranch: Expression;
+    falseBranch: Expression;
+}
+interface UnaryExpression extends BaseExpression {
+    type: "unary";
+    operand: Expression;
+    operator: string;
+}
+interface LiteralExpression extends BaseExpression {
+    type: "literal";
+    value: any;
+}
+type Expression = BasicExpression | FunctionExpression | GroupExpression | RankExpression | AdvancedExpression | TernaryExpression | UnaryExpression | LiteralExpression;
+
+interface CalculationDefinition {
+    expression: Expression;
+    resultColumnName: string;
+}
+
+interface BaseColorScale {
+    id: string;
+    name: string;
+}
+interface NumericalColorScale extends BaseColorScale {
+    type: "numerical";
+    palette: string;
+    min: number;
+    max: number;
+}
+interface CategoricalColorScale extends BaseColorScale {
+    type: "categorical";
+    palette: string[];
+    mapping: Map<string, string>;
+}
+
+interface GridSettings {
+    columnCount: number;
+    rowHeight: number;
+    containerPadding: number;
+    showBackgroundMarkers: boolean;
+}
+interface ViewMetadata {
+    name: string;
+    version: number;
+    createdAt: string;
+    modifiedAt: string;
+}
+interface SerializedCategoricalColorScale extends Omit<CategoricalColorScale, "mapping"> {
+    type: "categorical";
+    mapping: [string, string][];
+}
+type SerializedColorScale = NumericalColorScale | SerializedCategoricalColorScale;
+interface SavedDataStructure {
+    charts: ChartSettings[];
+    calculations: CalculationDefinition[];
+    gridSettings: GridSettings;
+    metadata: ViewMetadata;
+    colorScales: SerializedColorScale[];
+}
+
+type DatumObject = {
+    [key: string]: datum;
+};
+
+declare function ExplorEda({ data, savedData, }: {
+    data: DatumObject[];
+    savedData: SavedDataStructure | undefined;
+}): react_jsx_runtime.JSX.Element;
+
+export { ExplorEda };