mintwaterfall 0.8.6

package/index.d.ts

@@ -0,0 +1,149 @@
+// TypeScript definitions for MintWaterfall v0.6.0
+// Project: https://github.com/your-username/mintwaterfall
+// Definitions by: MintWaterfall Team
+
+export interface StackData {
+    value: number;
+    color: string;
+    label: string;
+}
+
+export interface ChartData {
+    label: string;
+    stacks: StackData[];
+}
+
+export interface WaterfallChart {
+    // Core configuration methods
+    width(): number;
+    width(value: number): WaterfallChart;
+    
+    height(): number;
+    height(value: number): WaterfallChart;
+    
+    margin(): { top: number; right: number; bottom: number; left: number };
+    margin(value: { top: number; right: number; bottom: number; left: number }): WaterfallChart;
+    
+    // Data and display options
+    stacked(): boolean;
+    stacked(value: boolean): WaterfallChart;
+    
+    showTotal(): boolean;
+    showTotal(value: boolean): WaterfallChart;
+    
+    totalLabel(): string;
+    totalLabel(value: string): WaterfallChart;
+    
+    totalColor(): string;
+    totalColor(value: string): WaterfallChart;
+    
+    // Animation and transitions
+    duration(): number;
+    duration(value: number): WaterfallChart;
+    
+    ease(): any; // d3.EasingFunction
+    ease(value: any): WaterfallChart;
+    
+    // Interactive Features
+    accessibility(): boolean;
+    accessibility(value: boolean): WaterfallChart;
+    
+    tooltips(): boolean;
+    tooltips(value: boolean): WaterfallChart;
+    
+    tooltipConfig(): any;
+    tooltipConfig(value: any): WaterfallChart;
+    
+    export(format?: string, options?: any): any;
+    exportConfig(): any;
+    exportConfig(value: any): WaterfallChart;
+    
+    // Enhanced features
+    enableBrush(): boolean;
+    enableBrush(value: boolean): WaterfallChart;
+    
+    staggeredAnimations(): boolean;
+    staggeredAnimations(value: boolean): WaterfallChart;
+    
+    staggerDelay(): number;
+    staggerDelay(value: number): WaterfallChart;
+    
+    scaleType(): string;
+    scaleType(value: string): WaterfallChart;
+    
+    // Zoom and pan functionality
+    zoom(): boolean;
+    zoom(value: boolean): WaterfallChart;
+    
+    zoomConfig(): any;
+    zoomConfig(value: any): WaterfallChart;
+    
+    // Event handling
+    on(event: string, handler: BarEventHandler): WaterfallChart;
+    on(event: string, handler: null): WaterfallChart;
+    
+    // Rendering
+    (selection: any): void; // d3.Selection
+}
+
+export interface BarEventHandler {
+    (event: Event, data: ChartData): void;
+}
+
+// Main chart factory function
+export declare function waterfallChart(): WaterfallChart;
+
+// Theme system
+export declare const themes: {
+    [key: string]: {
+        colors: string[];
+        totalColor: string;
+        backgroundColor?: string;
+        textColor?: string;
+    };
+};
+
+export declare function applyTheme(themeName: string): any;
+
+// Data processing utilities
+export declare const dataProcessor: {
+    processData(data: ChartData[]): any;
+    calculateTotals(data: ChartData[]): number[];
+    sortData(data: ChartData[], sortBy: string, order: 'ascending' | 'descending'): ChartData[];
+    normalizeValues(data: ChartData[], maxValue: number): ChartData[];
+    filterData(data: ChartData[], predicate: (item: ChartData) => boolean): ChartData[];
+    aggregateData(data: ChartData[], groupBy: string): ChartData[];
+};
+
+// Animation system
+export declare const animationSystem: {
+    createStaggeredAnimation(selection: any, delay: number): any;
+    createBounceAnimation(selection: any): any;
+    createElasticAnimation(selection: any): any;
+    respectsReducedMotion(): boolean;
+};
+
+// Interactive Features
+export declare function createAccessibilitySystem(): any;
+export declare function createTooltipSystem(): any;
+export declare function createExportSystem(): any;
+export declare function createZoomSystem(): any;
+
+export declare const accessibilitySystem: any;
+export declare const tooltip: any;
+export declare const exportSystem: any;
+export declare const zoomSystem: any;
+
+// Utility functions
+export declare function makeChartAccessible(chart: any, data: ChartData[]): void;
+export declare function createChartTooltip(config?: any): any;
+export declare function addExportToChart(chart: any, data: ChartData[]): void;
+export declare function createZoomControls(): any;
+export declare function addZoomToChart(chart: any, options?: any): any;
+
+// Enhanced features
+export declare const brushSystem: any;
+export declare const scaleSystem: any;
+
+// Version
+export declare const version: string;

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "mintwaterfall",
+  "version": "0.8.6",
+  "description": "A powerful, D3.js-compatible waterfall chart component with enterprise features including breakdown analysis, conditional formatting, stacking capabilities, animations, and extensive customization options",
+  "main": "dist/mintwaterfall.cjs.js",
+  "module": "dist/mintwaterfall.esm.js",
+  "browser": "dist/mintwaterfall.min.js",
+  "unpkg": "dist/mintwaterfall.min.js",
+  "jsdelivr": "dist/mintwaterfall.min.js",
+  "types": "dist/index.d.ts",
+  "typings": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/mintwaterfall.esm.js",
+      "require": "./dist/mintwaterfall.cjs.js",
+      "browser": "./dist/mintwaterfall.min.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "mintwaterfall-*.js",
+    "*.d.ts",
+    "API.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "python -m http.server 8080",
+    "dev": "python -m http.server 8080",
+    "demo": "python -m http.server 8080",
+    "demo:breakdown": "python -m http.server 8080 && echo \"Demo available at: http://localhost:8080/breakdown-feature-demo.html\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:fast": "jest --passWithNoTests --maxWorkers=4",
+    "test:core": "jest tests/core-api.test.js tests/chart.test.js tests/data.test.js",
+    "prebuild": "rimraf dist",
+    "build": "rollup -c && npm run build:types",
+    "build:fast": "rollup -c rollup.config.fast.js && npm run build:types",
+    "build:full": "npm run build:ts && rollup -c && npm run build:types",
+    "build:ts": "tsc --noEmit",
+    "build:types": "cp index.d.ts dist/index.d.ts || copy index.d.ts dist\\index.d.ts",
+    "build:watch": "rollup -c -w",
+    "build:analyze": "rollup -c --environment ANALYZE",
+    "format": "prettier --write \"src/**/*.js\" \"*.js\" \"*.md\"",
+    "format:check": "prettier --check \"src/**/*.js\" \"*.js\" \"*.md\""
+  },
+  "keywords": [
+    "d3js",
+    "d3",
+    "waterfall",
+    "chart",
+    "visualization",
+    "stacked",
+    "data-viz",
+    "svg",
+    "interactive",
+    "animation"
+  ],
+  "author": {
+    "name": "David Duarte",
+    "email": "david.duarte@outlook.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coredds/MintWaterfall.git"
+  },
+  "homepage": "https://coredds.github.io/MintWaterfall/",
+  "bugs": {
+    "url": "https://github.com/coredds/MintWaterfall/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "peerDependencies": {
+    "d3": "^7.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.3",
+    "@babel/preset-env": "^7.28.3",
+    "@babel/preset-typescript": "^7.27.1",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/d3": "^7.4.3",
+    "babel-jest": "^30.0.5",
+    "eslint": "^9.33.0",
+    "husky": "^8.0.0",
+    "jest": "^30.0.5",
+    "jest-environment-jsdom": "^30.0.5",
+    "jsdom": "^26.1.0",
+    "lint-staged": "^16.1.5",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.47.1",
+    "rollup-plugin-cleanup": "^3.2.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.2"
+  },
+  "lint-staged": {
+    "*.js": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.md": [
+      "prettier --write"
+    ]
+  },
+  "dependencies": {
+    "d3-array": "^3.2.4",
+    "d3-color": "^3.1.0",
+    "d3-drag": "^3.0.0",
+    "d3-force": "^3.0.0",
+    "d3-selection": "^3.0.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,111 @@
+// MintWaterfall - Main Entry Point
+// D3.js-compatible waterfall chart component library with enhanced features
+
+// Core chart functionality
+export { waterfallChart } from "./mintwaterfall-chart.ts";
+
+// Data processing - Core
+export { createDataProcessor, dataProcessor } from "./mintwaterfall-data.ts";
+
+// Data processing - Advanced D3.js Operations
+export {
+    // Standalone helper functions
+    createRevenueWaterfall,
+    createTemporalWaterfall,
+    createVarianceWaterfall,
+    groupWaterfallData,
+    createComparisonWaterfall,
+    transformTransactionData,
+    
+    // Financial utilities
+    financialReducers,
+    d3DataUtils
+} from "./mintwaterfall-data.ts";
+
+// Animation system
+export { createAnimationSystem } from "./mintwaterfall-animations.ts";
+
+// Themes
+export { themes, applyTheme } from "./mintwaterfall-themes.ts";
+
+// Enhanced D3.js features
+export { createScaleSystem } from "./mintwaterfall-scales.ts";
+export { createBrushSystemFactory as createBrushSystem } from "./mintwaterfall-brush.ts";
+
+// NEW: Advanced color and shape features
+export { 
+    createSequentialScale,
+    createDivergingScale, 
+    getConditionalColor,
+    createWaterfallColorScale,
+    interpolateThemeColor,
+    getAdvancedBarColor
+} from "./mintwaterfall-themes.ts";
+
+export { 
+    createShapeGenerators,
+    createWaterfallConfidenceBands,
+    createWaterfallMilestones 
+} from "./mintwaterfall-shapes.ts";
+
+// NEW: Advanced statistical analysis features
+export {
+    createStatisticalSystem,
+    analyzeWaterfallStatistics
+} from "./mintwaterfall-statistics.ts";
+
+// NEW: Advanced performance optimization features
+export {
+    createAdvancedPerformanceSystem,
+    createWaterfallSpatialIndex,
+    createVirtualWaterfallRenderer
+} from "./mintwaterfall-advanced-performance.ts";
+
+// NEW: MEDIUM PRIORITY - Advanced analytical enhancement features
+export {
+    createAdvancedDataProcessor,
+    createWaterfallSequenceAnalyzer,
+    createWaterfallTickGenerator
+} from "./mintwaterfall-advanced-data.ts";
+
+export {
+    createAdvancedInteractionSystem,
+    createWaterfallDragBehavior,
+    createWaterfallVoronoiConfig,
+    createWaterfallForceConfig
+} from "./mintwaterfall-advanced-interactions.ts";
+
+export {
+    createHierarchicalLayoutSystem,
+    createWaterfallTreemap,
+    createWaterfallSunburst,
+    createWaterfallBubbles
+} from "./mintwaterfall-hierarchical-layouts.ts";
+
+// Hierarchical Layout Features
+export { createHierarchicalLayout } from "./mintwaterfall-layouts.ts";
+
+// Performance
+export { createPerformanceManager } from "./mintwaterfall-performance.ts";
+
+// Accessibility & UX Features
+export { createAccessibilitySystem } from "./mintwaterfall-accessibility.ts";
+export { createTooltipSystem } from "./mintwaterfall-tooltip.ts";
+export { createExportSystem } from "./mintwaterfall-export.ts";
+
+// Interactivity Features  
+export { createZoomSystem } from "./mintwaterfall-zoom.ts";
+
+// Version information
+export const version = "0.8.6"; // Updated for advanced data processing features
+
+// Default exports for convenience
+import { waterfallChart } from "./mintwaterfall-chart.ts";
+
+// Export main chart as default
+export default waterfallChart;
+
+// Add to d3 namespace for compatibility
+if (typeof window !== "undefined" && window.d3) {
+    window.d3.waterfallChart = waterfallChart;
+}