Skip to content

gaslamp v0.22.0 Release Notes

  • Released: 2025-09-08
  • gaslamp: 61 - v0.22.0
  • pilotlamp: 18 - v0.22.0

🎉 Major Changes

📚 Complete Documentation Restructuring

Major documentation enhancement - Successfully restructured the entire documentation with a beginner-friendly learning path:

  • Hierarchical Structure: New 5-tier documentation architecture (Getting Started → Modules → Cookbooks → Advanced → API)
  • Beginner-Friendly: Clear learning progression from installation to advanced topics
  • Practical Examples: Comprehensive cookbooks with real-world scenarios and complete solutions
  • Backward Compatibility: All existing documentation preserved in Deprecated section
  • Navigation Improvement: Updated mkdocs.yml with intuitive navigation structure
Markdown
# New Documentation Structure
docs/
├── getting-started/     # Installation & first steps
├── modules/            # Basic usage (beginner-friendly)
├── cookbooks/          # Practical examples & recipes
├── troubleshooting/    # Common issues & solutions
├── advanced/           # Architecture & extensibility
└── api/               # TypeDoc-generated reference

🏗️ Enhanced DataFrame Architecture

Major DataFrame refactoring - Comprehensive code quality improvements with significant performance and maintainability enhancements:

  • Method Consolidation: Streamlined column and row access methods
  • Helper Functions: Extracted complex logic into focused, reusable helpers
  • Type Safety: Strengthened type definitions with enhanced FlameWright integration
  • Performance: Optimized data retrieval patterns and validation logic
  • Code Clarity: Improved method organization and removed unimplemented methods
TypeScript
// Enhanced DataFrame with improved architecture
const df = new gaslamp.DataFrame().fromObject(data);

// Optimized row/column access
const row = df.getRow(0);           // Uses centralized helpers
const col = df.getColumn('name');   // Consolidated access methods

// Enhanced validation
df.validateHeaders(['name', 'age']); // Consolidated validation logic

✨ GitLab Integration Enhancements

Improved development workflow - Enhanced GitLab integration with structured issue reporting:

  • Issue Templates: Added comprehensive issue templates for bug reports and feature requests
  • Workflow Integration: Better GitLab CI/CD integration patterns
  • Testing Enhancement: Improved FlameWright GAS unit tests with JestLite framework

🐛 Bug Fixes

API Documentation

  • Fixed Merge Conflicts: Resolved conflicts in API documentation structure
  • Documentation Consistency: Unified documentation format across all modules
  • Navigation Issues: Fixed broken links and cross-references in documentation

🔧 Refactoring

DataFrame Module Improvements

  • Code Organization: Consolidated 11 separate refactoring improvements
  • Helper Extraction: Complex method logic moved to focused helper functions
  • Validation Consolidation: Unified header existence and index range validation
  • Performance Optimization: Direct helper usage in getRow() and related methods
  • Type Definitions: Enhanced basic type definitions throughout DataFrame

Documentation Architecture

  • Structure Overhaul: Complete reorganization of documentation hierarchy
  • Content Migration: Systematic movement of legacy content to deprecated sections
  • Template Creation: Comprehensive documentation templates for consistent formatting

📖 Documentation

New Documentation Sections

🚀 Getting Started

📚 Modules (Basic Usage)

🍳 Cookbooks (Practical Examples)

🛠️ Advanced Topics

🧪 Testing & Quality

Test Results

  • ✅ All Tests Pass: Comprehensive test suite with JestLite integration
  • ✅ Documentation Build: MkDocs builds successfully with new structure
  • ✅ Bundle Update: Updated gaslamp.bundle.js with latest improvements
  • ✅ Pre-commit Hooks: All quality gates passing

Quality Assurance

  • ✅ Code Quality: Enhanced linting and formatting consistency
  • ✅ Conventional Commits: Proper commit message formatting maintained
  • ✅ Issue Tracking: Comprehensive GitLab issue #123 resolution

🚀 Migration Guide

For Documentation Users

Enhanced Learning Path - New users benefit from structured learning:

  1. Installation - Start here for setup
  2. First Steps - 5-minute introduction
  3. Modules - Learn basic operations
  4. Cookbooks - Apply knowledge with real examples
  5. Advanced - Master complex scenarios

For Existing Users

Backward Compatibility Maintained - All existing documentation still available:

Markdown
# Legacy documentation still accessible
- modules/dataframe.md → Deprecated section
- cookbooks/logger.md → Deprecated section
- All API references unchanged

For Developers

Enhanced Development Experience:

TypeScript
// Improved DataFrame operations
const df = new gaslamp.DataFrame()
  .fromObject(data)
  .select('name', 'price')        // Optimized column access
  .filter(row => row.price > 100)  // Enhanced validation
  .sort('name');                   // Consolidated methods

🔍 Technical Details

Issue #123 Resolution

  • Complete Restructure: All documentation reorganized with clear hierarchy
  • Content Creation: 12+ new documentation files with comprehensive examples
  • Navigation Update: mkdocs.yml fully restructured for optimal user experience
  • Quality Gates: All build, test, and documentation requirements met

Code Metrics

  • Documentation Files: 12+ new files created
  • Code Refactoring: 11 DataFrame improvements consolidated
  • Bundle Size: Maintained efficient bundle size despite feature additions
  • Test Coverage: Maintained comprehensive test coverage

🎯 What's Next

Upcoming Features (v0.23.0)

  • Enhanced Cookbooks: Additional validation and automation recipes
  • API Improvements: Further DataFrame performance optimizations
  • Documentation: Video tutorials and interactive examples
  • Integration: Enhanced Google Workspace integration patterns

👥 Contributors

  • @shotakaha - Complete documentation restructuring and DataFrame architecture improvements
  • Documentation: https://gaslamp.readthedocs.io/
  • Repository: https://gitlab.com/qumasan/gaslamp
  • Issue #123: https://gitlab.com/qumasan/gaslamp/-/issues/123 (Completed)
  • New Structure: Explore the Getting Started section!

Full Changelog: v0.21.1...v0.22.0