@phenyxhealth/data-analytics 0.1.1

package/dist/types/index.d.ts

@@ -0,0 +1,53 @@
+export type SemanticType = 'temporal' | 'nominal' | 'quantitative' | 'ordinal';
+export type AnalyticType = 'dimension' | 'measure';
+export interface DimensionDefinition {
+    fid: string;
+    semanticType: SemanticType;
+    analyticType: AnalyticType;
+    label?: string;
+}
+export type ChartType = 'bar' | 'pie' | 'line' | 'table' | 'multibar' | 'sunburst' | 'boxplot' | 'heatmap' | 'scatter' | 'scatter2' | 'histogram' | 'violin' | 'scatter3d' | 'surface3d' | 'subplot3d' | 'subplot2d' | 'parallelcoords';
+export type ViewSize = 'small' | 'standard' | 'full';
+export interface ViewConfig {
+    id: string;
+    name: string;
+    chartType: ChartType;
+    groupBy: string;
+    metric: 'count' | string;
+    colorBy?: string;
+    groupByMulti?: string[];
+    numericField?: string;
+    zField?: string;
+    subplotChartType?: ChartType;
+    subplotGroupBy?: string;
+    filters: FilterConfig[];
+    size?: ViewSize;
+}
+export interface FilterConfig {
+    field: string;
+    values: string[];
+}
+export type DataRecord = Record<string, string | number | boolean | null | undefined>;
+export type Theme = 'light' | 'dark';
+export type DiffUnit = 'days' | 'weeks' | 'months' | 'years';
+export interface DerivedDimension {
+    id: string;
+    name: string;
+    type: 'timeDiff';
+    fieldA: string;
+    fieldB: string;
+    unit: DiffUnit;
+}
+export interface Dashboard {
+    id: string;
+    name: string;
+    views: ViewConfig[];
+}
+export interface DataExplorerProps {
+    data: DataRecord[];
+    dimensions: DimensionDefinition[];
+    title?: string;
+    defaultViews?: ViewConfig[];
+    defaultDashboards?: Dashboard[];
+    theme?: Theme;
+}

package/dist/utils/data.d.ts

@@ -0,0 +1,63 @@
+import { DataRecord, FilterConfig, DerivedDimension, DimensionDefinition } from '../types/index.ts';
+export declare function getUniqueValues(data: DataRecord[], field: string): string[];
+export declare function applyFilters(data: DataRecord[], filters: FilterConfig[]): DataRecord[];
+export declare function groupAndCount(data: DataRecord[], groupBy: string, colorBy?: string): {
+    name: string;
+    count: number;
+    [key: string]: string | number;
+}[];
+export declare function getColorKeys(data: DataRecord[], colorBy: string): string[];
+export declare function groupAndCountMulti(data: DataRecord[], fields: string[], fieldLabels?: Record<string, string>): {
+    name: string;
+    _field: string;
+    [key: string]: string | number;
+}[];
+export declare function computeHeatMap(data: DataRecord[], xField: string, yField: string): {
+    entries: {
+        x: string;
+        y: string;
+        count: number;
+    }[];
+    xValues: string[];
+    yValues: string[];
+    maxCount: number;
+};
+export interface BoxPlotEntry {
+    name: string;
+    min: number;
+    q1: number;
+    median: number;
+    q3: number;
+    max: number;
+    count: number;
+    colorIndex: number;
+}
+export declare function computeBoxPlotStats(data: DataRecord[], numericField: string, groupBy: string, groupBy2?: string): BoxPlotEntry[];
+export interface HistogramBin {
+    x0: number;
+    x1: number;
+    count: number;
+    label: string;
+}
+export declare function computeHistogramBins(data: DataRecord[], numericField: string, binCount?: number): {
+    bins: HistogramBin[];
+    min: number;
+    max: number;
+};
+export interface ViolinEntry {
+    name: string;
+    points: {
+        x: number;
+        density: number;
+    }[];
+    min: number;
+    q1: number;
+    median: number;
+    q3: number;
+    max: number;
+    colorIndex: number;
+}
+export declare function computeViolinStats(data: DataRecord[], numericField: string, groupBy: string, resolution?: number): ViolinEntry[];
+export declare function getColor(index: number): string;
+export declare function applyDerivedDimensions(data: DataRecord[], derived: DerivedDimension[]): DataRecord[];
+export declare function derivedToDimensionDef(d: DerivedDimension): DimensionDefinition;

package/dist/utils/plotly.d.ts

@@ -0,0 +1,8 @@
+/** Colores resueltos para layouts de Plotly según el tema activo. */
+export declare function getPlotlyTheme(isDark: boolean): {
+    fontColor: string;
+    gridColor: string;
+    zeroColor: string;
+    textMuted: string;
+    tooltipBg: string;
+};

package/dist/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@phenyxhealth/data-analytics",
+  "private": false,
+  "version": "0.1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./style.css": "./dist/data-analytics.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib": "tsc -b && vite build --mode lib && node scripts/obfuscate.mjs",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@types/plotly.js": "^3.0.10",
+    "plotly.js-dist-min": "^3.4.0",
+    "recharts": "^3.8.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "javascript-obfuscator": "^5.4.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.48.0",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}