@xnoxs/flux-lang 3.1.1

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to Flux Lang are documented here.
+
+The format follows [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).
+
+---
+
+## [3.1.0] — 2026-06-24
+
+### Added
+- **Multiline arrow block bodies** — `val f = x ->\n    stmt1\n    stmt2` (multi-statement lambdas)
+- **`for..of` loops** — `for item of iterable:` for iterating any JS iterable
+- **Computed property keys** — `{ [expr]: value }` in object literals
+- **Class getter / setter** — `get propName():` and `set propName(v):` (no `fn` keyword required)
+- **Labeled break / continue** — `outer: for i in 0..n:` with `break outer` / `continue outer`
+- **For-loop array destructuring** — `for [a, b] in pairs:` in `for..in` loops
+- **esbuild bundle** — `npm run build` produces `dist/flux.cjs.js`, `dist/flux.esm.js`, `dist/flux.min.js`
+- **Test suite expanded** — 81 tests across 11 test files (was 71)
+
+### Fixed
+- Expression statements starting with short identifiers (e.g. `Fs.writeFileSync()`) no longer trigger false "misspelled keyword" parse errors
+- `match` expressions used as values now emit a proper IIFE rather than a bare `switch`
+- Static class methods no longer emit a stray `method` keyword
+- `break` / `continue` now accept an optional label on the same line
+
+---
+
+## [Unreleased]
+
+### Added
+- Standard library (`src/stdlib.js`) with 28 built-in helpers: `range`, `zip`, `enumerate`, `clamp`, `sum`, `flatten`, `chunk`, `unique`, `groupBy`, `sortBy`, `pick`, `omit`, `sleep`, `retry`, `memoize`, `pipe`, `compose`, `curry`, and more
+- TypeScript definitions (`index.d.ts`) — full API types for the transpiler, formatter, lexer, parser, and bundler
+- GitHub Actions CI — tests on Node 16, 18, 20, 22 on every push
+- GitHub Actions CD — automated npm publish on version tag
+- Benchmark suite (`benchmarks/bench.js`) — measures transpiler throughput
+- VS Code extension (`vscode-flux/`) — syntax highlighting, snippets, LSP diagnostics
+- Ecosystem website — landing page, interactive playground, documentation, examples gallery
+- `flux.config.json` — project-level configuration file support
+
+---
+
+## [3.0.0] — 2025-01-01
+
+### Added
+- **Return type annotations** — `fn greet(name: String) -> String:`
+- **Union types** — `val x: Int | String | Null`
+- **Nullable shorthand** — `String?` compiles to `String | Null`
+- **Full type checker** — `flux check` catches type mismatches at compile time
+- **Interface enforcement** — `implements` keyword checks all required members
+- **Generic interfaces** — `interface Container<T>: fn get() -> T`
+- **Algebraic Data Types** — `type Result = Ok(value) | Err(msg)`
+- **ADT pattern matching** — `when Pattern(x):` binds fields
+- **Match guards** — `when Pattern if condition:`
+- **String format specs** — `"Pi: {pi:.2f}"`, `"{n:,}"`, `"{rate:.1%}"`
+- `async` / `await` — async functions and promise handling
+- `try` / `catch` / `finally` — structured error handling
+- Spread / rest (`...`) — spread arrays/objects, rest parameters
+- Optional chaining (`?.`) — safe property access
+- Nullish coalescing (`??`) — default value for null/undefined
+- Destructuring — `val { a, b } = obj` / `val [x, y] = arr`
+
+### Changed
+- CLI rewritten from scratch — colored output, better error display
+- Source maps redesigned — accurate line/column mappings
+- Parser rewritten — 2× faster on large files
+
+---
+
+## [2.0.0] — 2024-06-01
+
+### Added
+- JSX support — compile `.flux` files with JSX syntax
+- CSS-in-Flux — `css { ... }` shorthand blocks
+- Name mangling — `--mangle` flag for obfuscated output
+- Source maps — `--sourcemap` flag
+- `flux bundle` — bundle multiple files into one JS
+- `flux watch` — watch mode with auto-recompile
+- `flux fmt` — source formatter
+- `flux repl` — interactive REPL
+- `flux test` — test runner for `*.test.flux` files
+- `flux init` — scaffold new Flux projects
+- Val-immutability checker — errors on `val` reassignment
+
+### Changed
+- Arrow functions: `->` instead of `=>`
+- Template strings: `"{variable}"` instead of backtick syntax
+- `fn` keyword for all function declarations
+
+---
+
+## [1.0.0] — 2024-01-01
+
+### Added
+- Initial release
+- Lexer, Parser, Code Generator
+- Basic types: String, Int, Float, Bool, Null
+- Control flow: `if`, `else`, `for`, `while`
+- Functions: `fn`, basic arrow functions
+- Classes with `extends`
+- Module system: `import`, `export`
+- `flux compile`, `flux run` CLI commands