🐛 Fixed #

• Bracket/Brace Key Handling: Fixed critical issue where typing { was incorrectly producing [ characters in the raw JSON editor
• Key Event Detection: Implemented hybrid character-based and logical key detection to ensure reliable bracket and brace handling
• Auto-closing Behavior: Ensured { key properly inserts {} with cursor positioned between braces, and [ key properly inserts [] with cursor positioned between brackets

🧪 Testing #

• Regression Prevention: Added comprehensive unit tests for bracket/brace key handling to prevent future regressions
• Key Event Testing: Ensured both opening and closing bracket/brace keys work correctly across different scenarios

🐛 Fixed #

• Array Object Display Bug: Fixed critical issue where nested array objects were displaying array indices as property names instead of actual property names
• Tree View Property Names: Properties within array objects now correctly display their names (e.g., "id", "name", "role") instead of showing "0" for all properties
• Path Resolution: Improved _getDisplayName method to properly handle complex paths with array indices and object properties

🧪 Testing #

• New Test Coverage: Added comprehensive test suite for array object display functionality
• Regression Prevention: Ensured all existing functionality remains intact with 126+ passing tests

🔧 Fixed #

• pub.flutter-io.cn Compliance: Fixed package description length to meet 60-180 character requirement
• Repository URLs: Updated all repository, issue tracker, and documentation URLs to match renamed spectre_json repository
• Git Remote: Updated git remote origin to point to the correct repository

📦 Infrastructure #

• Repository Rename: Successfully migrated from spectre to spectre_json repository
• pub.flutter-io.cn Scoring: Resolved issues preventing proper package verification and scoring

🐛 Fixed #

• Debug Mode Control: Fixed issue where debug info was appearing even when debugMode was set to false
• Error Message Display: Improved error message layout to prevent covering input area in raw view
• Cursor Position Preservation: Fixed cursor jumping to end during debounced validation and formatting
• Auto-Save Behavior: Resolved issue where user changes were being overwritten during internal operations
• Button Order: Updated action button order to Clear, Format, Validate for better UX

🔧 Improved #

• Error Message Layout: Compact error messages in raw view that don't interfere with editing
• Debug Entry Management: Debug entries are only added when debug mode is enabled
• Validation Logic: Simplified validation to preserve user input without overwriting work-in-progress
• Smart Change Management: Internal operations (formatting, validation) no longer trigger unwanted parent callbacks

✨ Added #

• "Don't Ask Again" Option: Added checkbox in delete confirmation dialog to skip future confirmations
• Skip Delete Confirmation Parameter: Added skipDeleteConfirmation parameter to JsonEditor for programmatic control
• Enhanced Delete UX: Improved delete workflow with persistent user preferences

🔗 Fixed #

• Package References: Fixed pub badge URL and documentation links to correctly point to spectre_json package
• Documentation: Updated README version reference to match current package version

✨ Added #

• Cancel Button for Add Property: Added cancel button (X) when adding new properties or array items
• Delete Functionality: Added delete button for removing properties and array items with confirmation dialog
• Enhanced UX: Improved user experience with better action button layout and confirmation dialogs

🔗 Fixed #

• Package References: Fixed pub badge URL and documentation links to correctly point to spectre_json package
• Documentation: Updated README version reference to match current package version

🔗 Fixed #

• Package References: Fixed pub badge URL and documentation links to correctly point to spectre_json package
• Documentation: Updated README version reference to match current package version

🐛 Fixed #

• Data Change Expansion: Fixed issue where expansion logic wasn't re-applied when initialData changed after widget creation
• Widget Lifecycle: Added didUpdateWidget lifecycle method to JsonTreeView to handle data changes properly

✨ Added #

• Smart Expansion Control: Configurable tree view expansion modes (none, objects, arrays, objectsAndArrays, all, levels)
• maxExpansionLevel: Maximum levels to expand when using levels mode
• Debug Mode: Enable detailed logging for troubleshooting expansion issues

🎉 Initial Release #

Spectre JSON is a beautiful and feature-rich JSON editor widget for Flutter with syntax highlighting, tree view navigation, real-time validation, and customizable themes.

✨ Added #

Core Features

• Flexible View Modes: Choose between dual view (tabs), tree-only, or raw-only modes
• Syntax Highlighting: Beautiful JSON syntax highlighting with customizable themes
• Interactive Tree View: Navigate and edit JSON with an intuitive tree interface
• Real-time Validation: Live JSON validation with error highlighting
• Copy & Paste: Built-in clipboard functionality
• Customizable Themes: Multiple built-in themes and custom theme support
• Responsive Design: Works seamlessly across different screen sizes
• Performance Optimized: Efficient rendering and memory management

Advanced Features

• Smart Indentation: Context-aware indentation and auto-closing
• Advanced Controls: Format, clear, and validate JSON with action buttons
• Tree View Editing: Inline editing of values and keys
• Node Addition: Add new properties and array items with intelligent type inference
• Auto-closing: Smart auto-closing for brackets, braces, and quotes
• Line Numbers: Line numbers display in text editor mode
• Scroll Synchronization: Synchronized scrolling between line numbers and text
• Debounced Input: Optimized text input with debouncing for better performance
• Smart Expansion Control: Configurable tree view expansion modes (none, objects, arrays, objectsAndArrays, all, levels)

Theme System

• RedPandaTheme: Beautiful dark theme with red accents (default)
• JsonEditorTheme.light(): Clean light theme
• JsonEditorTheme.dark(): Modern dark theme
• JsonEditorTheme.material(context): Theme that adapts to your app's Material theme
• JsonEditorTheme.fromColors(): Factory constructor for custom themes

Widget Properties

• initialData: The initial JSON data to display
• onDataChanged: Callback function when data changes
• title: Custom title for the editor header
• readOnly: Read-only mode support
• allowCopy: Enable/disable copy functionality
• theme: Custom theme support
• isExpanded: Initial expansion state
• onExpansionChanged: Expansion state change callback
• onCollapse: Collapse event callback
• viewType: View mode selection (dual, treeOnly, rawOnly)
• expansionMode: Tree view expansion control (none, objects, arrays, objectsAndArrays, all, levels)
• maxExpansionLevel: Maximum levels to expand when using levels mode

Action Buttons

• Format: Beautify JSON with proper indentation
• Clear: Reset to empty JSON object
• Validate: Check JSON validity with visual feedback
• Copy: Copy JSON to clipboard
• Paste: Paste JSON from clipboard

🔧 Technical Features #

Performance

• Debounced text input (750ms delay)
• Efficient widget rebuilding
• Optimized tree view rendering
• Memory-efficient data handling

Error Handling

• Real-time JSON validation
• Visual error highlighting
• Comprehensive error messages
• Graceful handling of invalid input

Platform Support

• ✅ Android
• ✅ iOS
• ✅ Web
• ✅ Windows
• ✅ macOS
• ✅ Linux

🧪 Testing #

• 85+ comprehensive tests covering all major functionality
• Widget testing for all components
• Theme system testing
• Error handling and edge cases
• Tree view functionality testing
• Syntax highlighting verification
• Performance and memory testing

📚 Documentation #

• Comprehensive README with examples
• API reference with property tables
• Theme customization guide
• Usage examples for common scenarios
• Platform support documentation
• Contributing guidelines

🛠️ Development #

• Built with Flutter 3.10.0+
• Dart SDK 3.0.0+
• No external dependencies beyond Flutter core
• MIT License
• Comprehensive linting with flutter_lints
• GitHub Actions CI/CD ready

🎯 Use Cases #

Perfect for:

• Configuration editors
• Data visualization tools
• JSON manipulation in Flutter apps
• API response viewers
• Settings panels
• Development tools
• Data entry forms

🔮 Future Plans #

• Additional theme presets
• Export to different formats
• Search and replace functionality
• Keyboard shortcuts
• Plugin system for extensions
• More advanced validation rules