# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-10-03

### Added
- Initial public release of TestDrive-JSUI as standalone npm package
- JavaScript-first markdown editor library
- Section-based editing with independent section management
- Interactive UI with compass-positioned control panels
- Support for edit and view modes
- Event-driven API for integration
- Auto-save functionality to localStorage
- Keyboard shortcuts (Ctrl+S to save, Escape to cancel)
- LocalStorage integration for content persistence
- Download markdown as .md file
- Table of contents generation
- Debug panel with logging system
- Status control showing document statistics
- Comprehensive test suite (68 Jest tests + 15 pytest tests)
- Full documentation (README, ARCHITECTURE, NPM_PUBLICATION_PLAN)

### Features
- **Core Library**: Pure JavaScript with marked.js as only peer dependency
- **Bundled Distribution**: Single-file UMD, ESM, and CJS builds
- **CSS Included**: Complete styling with GitHub theme
- **Peer Dependency**: Uses marked.js for markdown parsing
- **Multiple Installation Methods**: npm, CDN (jsdelivr, unpkg), direct download
- **Source Maps**: Available for all builds for debugging
- **Browser Support**: Modern browsers (Chrome 60+, Firefox 60+, Safari 12+, Edge 79+)

### Technical
- Built with Rollup bundler
- Transpiled with Babel for broad browser support
- Minified with Terser (107KB minified)
- CSS processed with PostCSS, autoprefixer, and cssnano
- 68 JavaScript tests passing (Jest)
- 15 Python integration tests passing (pytest)

### Package Details
- **UMD Build**: 217KB (browser-friendly, default)
- **Minified**: 107KB (production-ready)
- **ESM Build**: 199KB (for modern bundlers)
- **CJS Build**: 199KB (for Node.js)
- **CSS**: 6KB (minified, all styles inlined)

### Migration Notes
- Fully migrated from MarkiTect monorepo to standalone capability
- All 24 original JavaScript files consolidated
- Single source of truth in `/capabilities/testdrive-jsui/js/`
- Legacy files cleaned up from main application
- TypeScript declarations (`types/index.d.ts`)
- `exports` map: `import` (ESM), `require` (CJS), `browser`, `./style.css`

### Fixed
- CommonJS bundle is now emitted as `dist/testdrive-jsui.cjs`; `import` and `require` previously failed in Node under `"type": "module"`
- Bundled builds no longer throw `ControlBase is not defined` on load
- `js/core/debug-system.js` loads as a classic `<script>` (stray ES `export` removed)
- Accepted section edits now refresh the page even when no document controls are present
- Lockfile is in sync with `package.json` (`npm ci` works)

### Changed
- Package metadata no longer carries repository/homepage/bugs URLs until a public home is established

## [Unreleased]

Nothing yet.