ranger-compiler 2.1.70 → 3.0.4

package/CHANGELOG.md

@@ -0,0 +1,114 @@
+# Changelog
+
+All notable changes to the Ranger Compiler will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [3.0.4] - 2026-05-12
+
+### Fixed
+
+- **Installed npm package library lookup** — The published compiler now also searches `./lib` relative to the compiler binary, so locally installed `ranger-compiler` packages can resolve `stdlib.rgr` and related bundled libraries correctly
+- **Virtual compiler bundled file loading** — Bundled library files are now loaded from `./lib/` inside the packaged distribution instead of assuming a development-only `../lib/` layout
+
+### Changed
+
+- Version bumped from `3.0.3` to `3.0.4`
+
+## [3.0.3] - 2026-05-12
+
+### Fixed
+
+- **TypeScript module build path** — `npm run module` now builds through the same explicit `dist/api.ts` path that the packaged API uses, instead of generating `compiler/bin/api.ts` and relying on a stale `tsconfig` include pattern
+- **CI publish verification** — Release builds no longer depend on a globally available `tsc`; the repository now declares a local `typescript` dev dependency for consistent CI behavior
+- **TypeScript config compatibility** — Updated the TypeScript configuration to remove deprecated settings that broke newer TypeScript runners in CI
+
+### Changed
+
+- Version bumped from `3.0.2` to `3.0.3`
+
+## [3.0.2] - 2026-05-12
+
+### Fixed
+
+- **Rust and Swift string method codegen** — Added missing target templates for `startsWith`, `endsWith`, `contains`, and `replace`, so `tests/fixtures/string_methods.rgr` now generates output correctly for Rust and Swift 6
+- **Compiler test diagnostics** — Shared test helpers now report the actual compiler failure when a compilation does not produce an output file, instead of masking the root cause behind a generic generated-file-not-found error
+
+### Changed
+
+- **Release automation** — Updated the publish workflow to trigger on release publication and allow manual dispatch, making retries and release recovery less brittle
+- **Release metadata** — Version bumped from `3.0.1` to `3.0.2`
+
+## [3.0.1] - 2026-05-12
+
+### Added
+
+- **Kotlin union-case dispatch** — `case item oo:SomeClass` now emits correct Kotlin `is`/`as` pattern for class, boolean, int, double, and string variants (in `lib/stdlib.rgr` and `compiler/stdlib.rgr`)
+- **JSON.rgr ng version** — Updated `lib/JSON.rgr` and `compiler/JSON.rgr` to ng version with Kotlin and Swift 6 templates and four typed `set` overloads
+- **TypeScript README example** — Added parsing example to `modules/ts/README.md`
+
+### Fixed
+
+- **Kotlin ternary operator** — Emits `if (cond) a else b` form instead of JavaScript `? :` syntax (`compiler/Lang.rgr`)
+- **Kotlin `indexOf`** — Emits `.indexOf(x)` method call instead of invalid syntax (`compiler/Lang.rgr`)
+- **Kotlin int/int division** — Casts operands with `.toDouble()` to avoid integer truncation (`compiler/Lang.rgr`)
+- **Kotlin `open fun` warnings** — `open` modifier now only emitted when a class actually has subclasses (`compiler/ng_RangerKotlinClassWriter.rgr`)
+- **TypeScript `instanceof` with structural types** — `typeof` in `case` context no longer emits `instanceof Record<string,any>` for mapped types; collapses to `Object`/`Array` at runtime (`compiler/ng_LiveCompiler.rgr`)
+- **npm package bin path** — Changed from `bin/output.js` to `dist/rgrc.js` so the published package contains a valid binary
+
+### Changed
+
+- Version bumped from `3.0.0-beta.2` to `3.0.1`
+- `prepublishOnly` builds dist and runs tests before every publish
+
+## [3.0.0-alpha.1] - 2024-12-13
+
+### Added
+
+- **PLAN_3.md** - Comprehensive roadmap for Ranger 3.0 development
+- **Compiler Introspection API** - Position-based type queries for IDE integration
+  - `getTypeAtPosition()` - Get type information at cursor position
+  - `getClassProperties()` / `getClassMethods()` - Inspect class structures
+  - See [ai/INTROSPECTION.md](ai/INTROSPECTION.md) for documentation
+- **AI Documentation** - Enhanced documentation for GenAI assistants
+  - [ai/INTROSPECTION.md](ai/INTROSPECTION.md) - Introspection API guide
+  - Updated [ai/QUICKREF.md](ai/QUICKREF.md) with introspection examples
+
+### Changed
+
+- Version bump from 2.1.70 to 3.0.0-alpha.1
+- Updated test configuration to exclude ranger-vscode-extension tests from root
+
+### Planned for 3.0
+
+- File extension change from `.clj` to `.rgr`
+- Web-based IDE with Monaco editor
+- Simplified import system with auto-loaded standard library
+- Language Server Protocol (LSP) for VSCode extension
+- JavaScript source map generation
+- Improved language targets: Python, Rust, Swift, C++
+
+---
+
+## [2.1.70] - Previous Release
+
+### Features
+
+- Cross-language compilation to JavaScript, TypeScript, Python, Go, Rust, Swift, C++, Java, Kotlin, C#, PHP, Scala
+- Lisp-like syntax with object-oriented programming support
+- VirtualCompiler for in-browser compilation
+- VSCode extension (preliminary)
+
+---
+
+## Version History Notes
+
+Ranger has been in development since 2016. Major milestones:
+
+- **1.0** - Initial release with basic cross-compilation
+- **2.0** - Introduced VirtualCompiler and improved type system
+- **2.1** - Added more language targets and improved code generation
+- **3.0** - (Current) Modernization with web IDE, LSP, and simplified tooling