mintwaterfall 0.8.8 → 0.8.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +89 -1
- package/CONTRIBUTING.md +11 -0
- package/README.md +408 -367
- package/dist/index.d.ts +1 -1
- package/dist/mintwaterfall.cjs.js +7857 -7857
- package/dist/mintwaterfall.esm.js +7786 -7786
- package/dist/mintwaterfall.min.js +7 -7
- package/dist/mintwaterfall.umd.js +7857 -7857
- package/index.d.ts +1 -1
- package/package.json +129 -126
- package/src/index.js +41 -41
package/CHANGELOG.md
CHANGED
|
@@ -5,9 +5,72 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.8.10] - 2026-02-09
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- **Dependencies Update**: Updated all dev dependencies to latest compatible versions
|
|
13
|
+
- `@babel/core`: 7.28.5 → 7.29.0
|
|
14
|
+
- `@babel/preset-env`: 7.28.5 → 7.29.0
|
|
15
|
+
- `eslint`: 9.39.1 → 9.39.2
|
|
16
|
+
- `prettier`: 3.7.4 → 3.8.1
|
|
17
|
+
- `rollup`: 4.53.3 → 4.57.1
|
|
18
|
+
- **GitHub Actions Modernized**: Updated all CI/CD workflows
|
|
19
|
+
- Node.js CI matrix updated from [18.x, 20.x] to [20.x, 22.x]
|
|
20
|
+
- Replaced deprecated `actions/create-release@v1` with `softprops/action-gh-release@v2`
|
|
21
|
+
- Updated `codecov/codecov-action` from v4 to v5
|
|
22
|
+
- All workflows now use Node.js 22.x and npm caching
|
|
23
|
+
- **Engine requirement**: Updated `engines.node` from `>=14.0.0` to `>=18.0.0` to reflect actual minimum
|
|
24
|
+
- **ESLint config**: Fixed flat config `ignores` so `coverage/` directory is properly excluded
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
|
|
28
|
+
- **Security**: Resolved high-severity vulnerability in `@isaacs/brace-expansion`
|
|
29
|
+
- **publish.yml**: Added missing `build` step before `npm publish`
|
|
30
|
+
- **security.yml**: Removed redundant duplicate audit step
|
|
31
|
+
- **Version mismatches**: Corrected stale fallback versions in rollup configs (0.8.7 → 0.8.10)
|
|
32
|
+
- **Copyright years**: Updated banner copyright to 2024-2026
|
|
33
|
+
- **Type definitions header**: Updated `index.d.ts` version from v0.6.0 to v0.8.10
|
|
34
|
+
- **Demo files**: Updated version references in example HTML
|
|
35
|
+
|
|
36
|
+
### Technical
|
|
37
|
+
|
|
38
|
+
- All 338 tests passing across 18 test suites
|
|
39
|
+
- Zero vulnerabilities
|
|
40
|
+
- Build and lint verified clean
|
|
41
|
+
|
|
42
|
+
## [0.8.9] - 2025-12-08
|
|
43
|
+
|
|
44
|
+
### Changed
|
|
45
|
+
|
|
46
|
+
- **Dependencies Update**: Updated all dev dependencies to latest compatible versions
|
|
47
|
+
- `@babel/core`: 7.28.4 → 7.28.5
|
|
48
|
+
- `@babel/preset-env`: 7.28.3 → 7.28.5
|
|
49
|
+
- `@babel/preset-typescript`: 7.27.1 → 7.28.5
|
|
50
|
+
- `@rollup/plugin-babel`: 6.0.4 → 6.1.0
|
|
51
|
+
- `@rollup/plugin-node-resolve`: 16.0.2 → 16.0.3
|
|
52
|
+
- `@rollup/plugin-typescript`: 12.1.4 → 12.3.0
|
|
53
|
+
- `eslint`: 9.37.0 → 9.39.1
|
|
54
|
+
- `prettier`: 3.6.2 → 3.7.4
|
|
55
|
+
- `lint-staged`: 16.2.3 → 16.2.7
|
|
56
|
+
- `rollup`: 4.52.4 → 4.53.3
|
|
57
|
+
- `rimraf`: 6.0.1 → 6.1.2
|
|
58
|
+
- `jsdom`: kept at 26.1.0 (v27 has breaking changes)
|
|
59
|
+
|
|
60
|
+
### Fixed
|
|
61
|
+
|
|
62
|
+
- Code formatting updated to comply with Prettier 3.7.4
|
|
63
|
+
|
|
64
|
+
### Technical
|
|
65
|
+
|
|
66
|
+
- All 338 tests passing across 18 test suites
|
|
67
|
+
- Zero vulnerabilities
|
|
68
|
+
- All formatting checks passing
|
|
69
|
+
|
|
8
70
|
## [0.8.8] - 2025-10-09
|
|
9
71
|
|
|
10
72
|
### Changed
|
|
73
|
+
|
|
11
74
|
- **Dependencies Update**: Updated all dev dependencies to latest compatible versions
|
|
12
75
|
- `@babel/core`: 7.28.3 → 7.28.4
|
|
13
76
|
- `@rollup/plugin-node-resolve`: 16.0.1 → 16.0.2
|
|
@@ -22,6 +85,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
22
85
|
- `jsdom`: kept at 26.1.0 (v27 has compatibility issues)
|
|
23
86
|
|
|
24
87
|
### Technical
|
|
88
|
+
|
|
25
89
|
- All 338 tests passing across 18 test suites
|
|
26
90
|
- Zero vulnerabilities
|
|
27
91
|
- Build system verified with all updated tools
|
|
@@ -30,14 +94,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
30
94
|
## [0.8.7] - 2025-09-11
|
|
31
95
|
|
|
32
96
|
### Fixed
|
|
97
|
+
|
|
33
98
|
- **🔗 Repository URL**: Updated placeholder repository URL from `https://github.com/your-username/mintwaterfall` to correct address `https://github.com/coredds/MintWaterfall` in TypeScript definition files
|
|
34
99
|
|
|
35
100
|
## [0.8.6] - 2025-09-04
|
|
36
101
|
|
|
37
102
|
### Added
|
|
103
|
+
|
|
38
104
|
- **🚀 Advanced D3.js Data Processing Features**: Complete Phase 1 implementation
|
|
39
105
|
- `d3.group()` and `d3.rollup()` multi-dimensional grouping
|
|
40
|
-
- `d3.flatRollup()` hierarchical data flattening
|
|
106
|
+
- `d3.flatRollup()` hierarchical data flattening
|
|
41
107
|
- `d3.cross()` and `d3.index()` cross-tabulation and indexing
|
|
42
108
|
- Temporal aggregation with `d3.timeMonth()` intervals
|
|
43
109
|
- Revenue waterfall analysis with breakdown capabilities
|
|
@@ -48,6 +114,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
48
114
|
- Comprehensive error handling and fallback mechanisms
|
|
49
115
|
|
|
50
116
|
### Enhanced
|
|
117
|
+
|
|
51
118
|
- **📊 Interactive Demo Section**: New advanced data processing showcase
|
|
52
119
|
- Live demonstration buttons for each D3.js function
|
|
53
120
|
- Real-time chart updates with processed data
|
|
@@ -60,6 +127,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
60
127
|
- **📚 API Documentation**: Updated with complete advanced features reference
|
|
61
128
|
|
|
62
129
|
### Technical
|
|
130
|
+
|
|
63
131
|
- **⚡ Performance Optimizations**: Efficient data processing pipelines
|
|
64
132
|
- **🔍 Debug Enhancements**: Comprehensive logging and error reporting
|
|
65
133
|
- **🧪 Type Safety**: Enhanced TypeScript interfaces for new features
|
|
@@ -67,6 +135,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
67
135
|
## [0.8.5] - 2025-01-19
|
|
68
136
|
|
|
69
137
|
### Added
|
|
138
|
+
|
|
70
139
|
- **🧪 Complete Test Suite**: Comprehensive testing with 100% pass rate
|
|
71
140
|
- 183 passing tests across 12 test suites
|
|
72
141
|
- Enhanced features testing (scales, brush, animations)
|
|
@@ -75,6 +144,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
75
144
|
- Performance-optimized test execution (4.7s)
|
|
76
145
|
|
|
77
146
|
### Changed
|
|
147
|
+
|
|
78
148
|
- **🏗️ TypeScript Migration Complete**: Full TypeScript support with type safety
|
|
79
149
|
- All core modules converted to TypeScript (.ts)
|
|
80
150
|
- Complete type definitions for all APIs
|
|
@@ -87,6 +157,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
87
157
|
- Removed obsolete console-based tests
|
|
88
158
|
|
|
89
159
|
### Fixed
|
|
160
|
+
|
|
90
161
|
- **🔧 Scale System Issues**: Fixed API mismatches and type issues
|
|
91
162
|
- Enhanced scale factory with proper TypeScript interfaces
|
|
92
163
|
- Fixed brush system with complete selection utilities
|
|
@@ -94,6 +165,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
94
165
|
- Improved chart API consistency
|
|
95
166
|
|
|
96
167
|
### Removed
|
|
168
|
+
|
|
97
169
|
- **📝 Hierarchical Layouts**: Removed unused hierarchical layout functionality
|
|
98
170
|
- Treemap, partition, pack, cluster, tree visualizations removed
|
|
99
171
|
- Focus on core waterfall chart functionality
|
|
@@ -102,6 +174,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
102
174
|
## [0.8.1] - 2025-08-30
|
|
103
175
|
|
|
104
176
|
### Added
|
|
177
|
+
|
|
105
178
|
- **🏗️ Hierarchical Layout System**: Complete D3.js layout algorithm implementation
|
|
106
179
|
- `d3.hierarchy()` support for hierarchical data structures
|
|
107
180
|
- `d3.treemap()` for space-efficient breakdown visualizations
|
|
@@ -132,6 +205,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
132
205
|
- Performance optimizations for large enterprise datasets
|
|
133
206
|
|
|
134
207
|
### Enhanced
|
|
208
|
+
|
|
135
209
|
- **Chart API**: Extended with performance configuration methods
|
|
136
210
|
- `enablePerformanceOptimization()` - Toggle performance features
|
|
137
211
|
- `performanceDashboard()` - Real-time metrics display
|
|
@@ -146,6 +220,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
146
220
|
- Enhanced error handling and fallbacks
|
|
147
221
|
|
|
148
222
|
### Performance
|
|
223
|
+
|
|
149
224
|
- **Large Dataset Support**: Handles >500K data points efficiently
|
|
150
225
|
- **Memory Management**: Automatic cleanup and garbage collection triggers
|
|
151
226
|
- **Render Optimization**: Smart sampling and virtualization strategies
|
|
@@ -153,6 +228,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
153
228
|
- **Load Time**: <2s initial render for 100K+ data points
|
|
154
229
|
|
|
155
230
|
### Documentation
|
|
231
|
+
|
|
156
232
|
- **HIERARCHICAL_LAYOUTS.md**: Comprehensive guide for new layout features
|
|
157
233
|
- **API Documentation**: Updated with all new methods and options
|
|
158
234
|
- **Performance Examples**: Interactive demos for testing optimizations
|
|
@@ -160,6 +236,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
160
236
|
## [0.6.0] - 2025-08-28
|
|
161
237
|
|
|
162
238
|
### Added
|
|
239
|
+
|
|
163
240
|
- **📈 Trend Line Overlays**: Complete trend analysis system with linear, moving average, and polynomial options
|
|
164
241
|
- **🔄 Enhanced Data Loading**: CSV, JSON, TSV format support with HTTP URL loading and automatic format detection
|
|
165
242
|
- **🖼️ High-DPI PNG Export**: 2x scaling support with enhanced image quality and comprehensive error handling
|
|
@@ -170,11 +247,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
170
247
|
- **📚 Educational Information**: Contextual explanations for each trend type with technical details
|
|
171
248
|
|
|
172
249
|
### Fixed
|
|
250
|
+
|
|
173
251
|
- **ESLint Compliance**: All linting issues resolved with modern code standards
|
|
174
252
|
- **Deprecated API**: Removed legacy accessibility detection methods in favor of W3C Forced Colors Mode standard
|
|
175
253
|
- **Code Quality**: Unused variables properly handled with appropriate ESLint disable comments for future-use functions
|
|
176
254
|
|
|
177
255
|
### Changed
|
|
256
|
+
|
|
178
257
|
- **Accessibility System**: Enhanced with automatic CSS injection for forced colors mode support
|
|
179
258
|
- **Export System**: Improved PNG generation with high-DPI support and better error handling
|
|
180
259
|
- **Demo Experience**: Consolidated trend line features into main demonstration page for unified user experience
|
|
@@ -182,6 +261,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
182
261
|
## [0.5.6] - 2025-08-22
|
|
183
262
|
|
|
184
263
|
### Added
|
|
264
|
+
|
|
185
265
|
- **Enhanced D3.js v7 compatibility**: Full scale system support for band, linear, ordinal, and time scales
|
|
186
266
|
- **Advanced interactive features**: Brush system for data filtering and selection
|
|
187
267
|
- **Staggered animations**: Enhanced visual feedback with progressive reveal animations
|
|
@@ -189,18 +269,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
189
269
|
- **Utility functions**: `getBarWidth()` and `getBarPosition()` for cross-scale compatibility
|
|
190
270
|
|
|
191
271
|
### Fixed
|
|
272
|
+
|
|
192
273
|
- **Brush system errors**: Resolved `scale.invert is not a function` for band scales
|
|
193
274
|
- **Scale bandwidth errors**: Fixed `xScale.bandwidth is not a function` when switching scale types
|
|
194
275
|
- **D3 v7 API compatibility**: Removed deprecated `cornerRadius()` and `handleSize()` brush methods
|
|
195
276
|
- **Animation toggling**: Enhanced staggered animation toggle for immediate visual feedback
|
|
196
277
|
|
|
197
278
|
### Changed
|
|
279
|
+
|
|
198
280
|
- **Test coverage**: Increased from 121 to 168 comprehensive test cases
|
|
199
281
|
- **Code organization**: Improved scale handling with dedicated utility functions
|
|
200
282
|
- **Performance**: Optimized rendering for different scale types
|
|
201
283
|
- **Documentation**: Updated API documentation with new advanced features
|
|
202
284
|
|
|
203
285
|
### Technical Details
|
|
286
|
+
|
|
204
287
|
- All 168 tests passing with 51% code coverage
|
|
205
288
|
- Zero lint issues maintained
|
|
206
289
|
- Production-ready status achieved
|
|
@@ -209,6 +292,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
209
292
|
## [0.5.5] - 2025-08-XX
|
|
210
293
|
|
|
211
294
|
### Added
|
|
295
|
+
|
|
212
296
|
- **Comprehensive testing**: 121 test cases with 57% code coverage
|
|
213
297
|
- **Enhanced functionality**: Fixed normalize/bounce buttons, improved UI/UX
|
|
214
298
|
- **Visual improvements**: 1100px wide charts, centered layouts, visual feedback system
|
|
@@ -216,12 +300,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
216
300
|
- **Documentation**: Updated README, API docs, and examples
|
|
217
301
|
|
|
218
302
|
### Changed
|
|
303
|
+
|
|
219
304
|
- **Code quality**: Achieved zero lint issues, professional codebase standards
|
|
220
305
|
- **Performance**: Optimized bundle size and rendering efficiency
|
|
221
306
|
|
|
222
307
|
## [0.5.4] - 2025-08-XX
|
|
223
308
|
|
|
224
309
|
### Added
|
|
310
|
+
|
|
225
311
|
- Initial production release
|
|
226
312
|
- Basic waterfall and stacked chart functionality
|
|
227
313
|
- D3.js integration
|
|
@@ -229,6 +315,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
229
315
|
- Theme support
|
|
230
316
|
|
|
231
317
|
### Technical
|
|
318
|
+
|
|
232
319
|
- Core chart rendering engine
|
|
233
320
|
- Data processing pipeline
|
|
234
321
|
- Event handling system
|
|
@@ -245,6 +332,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
245
332
|
## Support
|
|
246
333
|
|
|
247
334
|
For questions about specific versions or upgrade paths, please:
|
|
335
|
+
|
|
248
336
|
- Check the [API documentation](API.md)
|
|
249
337
|
- View [examples](mintwaterfall-example.html)
|
|
250
338
|
- File an [issue](https://github.com/coredds/MintWaterfall/issues)
|
package/CONTRIBUTING.md
CHANGED
|
@@ -5,17 +5,20 @@ We welcome contributions to MintWaterfall! This document provides guidelines for
|
|
|
5
5
|
## Development Setup
|
|
6
6
|
|
|
7
7
|
1. **Clone the repository**
|
|
8
|
+
|
|
8
9
|
```bash
|
|
9
10
|
git clone https://github.com/coredds/MintWaterfall.git
|
|
10
11
|
cd MintWaterfall
|
|
11
12
|
```
|
|
12
13
|
|
|
13
14
|
2. **Install dependencies**
|
|
15
|
+
|
|
14
16
|
```bash
|
|
15
17
|
npm install
|
|
16
18
|
```
|
|
17
19
|
|
|
18
20
|
3. **Start development server**
|
|
21
|
+
|
|
19
22
|
```bash
|
|
20
23
|
npm run dev
|
|
21
24
|
```
|
|
@@ -54,6 +57,7 @@ MintWaterfall/
|
|
|
54
57
|
### Commit Messages
|
|
55
58
|
|
|
56
59
|
Use conventional commit format:
|
|
60
|
+
|
|
57
61
|
- `feat:` for new features
|
|
58
62
|
- `fix:` for bug fixes
|
|
59
63
|
- `docs:` for documentation changes
|
|
@@ -62,6 +66,7 @@ Use conventional commit format:
|
|
|
62
66
|
- `test:` for test-related changes
|
|
63
67
|
|
|
64
68
|
Examples:
|
|
69
|
+
|
|
65
70
|
```
|
|
66
71
|
feat: add tooltip support for bar interactions
|
|
67
72
|
fix: resolve animation timing issues
|
|
@@ -71,17 +76,20 @@ docs: update API documentation with examples
|
|
|
71
76
|
### Pull Request Process
|
|
72
77
|
|
|
73
78
|
1. **Create feature branch**
|
|
79
|
+
|
|
74
80
|
```bash
|
|
75
81
|
git checkout -b feature/your-feature-name
|
|
76
82
|
```
|
|
77
83
|
|
|
78
84
|
2. **Make changes and commit**
|
|
85
|
+
|
|
79
86
|
```bash
|
|
80
87
|
git add .
|
|
81
88
|
git commit -m "feat: add your feature description"
|
|
82
89
|
```
|
|
83
90
|
|
|
84
91
|
3. **Push branch and create PR**
|
|
92
|
+
|
|
85
93
|
```bash
|
|
86
94
|
git push origin feature/your-feature-name
|
|
87
95
|
```
|
|
@@ -123,6 +131,7 @@ docs: update API documentation with examples
|
|
|
123
131
|
## Bug Reports
|
|
124
132
|
|
|
125
133
|
When reporting bugs, please include:
|
|
134
|
+
|
|
126
135
|
- Clear description of the issue
|
|
127
136
|
- Steps to reproduce
|
|
128
137
|
- Expected vs actual behavior
|
|
@@ -132,6 +141,7 @@ When reporting bugs, please include:
|
|
|
132
141
|
## Feature Requests
|
|
133
142
|
|
|
134
143
|
For feature requests, please:
|
|
144
|
+
|
|
135
145
|
- Check if feature already exists or is planned
|
|
136
146
|
- Describe the use case and benefit
|
|
137
147
|
- Provide examples of how it would be used
|
|
@@ -153,6 +163,7 @@ For feature requests, please:
|
|
|
153
163
|
### Browser Testing
|
|
154
164
|
|
|
155
165
|
Test in:
|
|
166
|
+
|
|
156
167
|
- Chrome (latest)
|
|
157
168
|
- Firefox (latest)
|
|
158
169
|
- Safari (latest)
|