redscript-mc 2.5.0 → 2.6.2

package/CHANGELOG.md

@@ -2,6 +2,86 @@
 
 All notable changes to RedScript will be documented in this file.
 
+## [Unreleased] — v3.0.0
+
+> **Status:** Active development. All stdlib modules below are merged to `main`; language features are stabilised pending final integration tests.
+
+### Added
+
+#### Language / Compiler
+- **`match` expression** — pattern-match on int / enum values; compiles to `execute if score` chains with exhaustiveness checking
+- **`for item in array` iteration** — `for x in arr { … }` syntax sugar; desugars to `while idx < arr.len() { let x = arr[idx]; idx++ }` in HIR; generates loop-header / loop-body / loop-exit mcfunction splits
+- **`arr.len()` — literal constant + dynamic runtime** — literal arrays (`[1,2,3].len()`) fold to a compile-time constant (`scoreboard players set`); function-parameter and heap arrays use the new `nbt_list_len` MIR instruction which lowers to `execute store result score … run data get storage`
+- **`state.mcrs`** — persistent entity/global state management stdlib module
+- **`dialog.mcrs`** — NPC dialog trees with choice branching and callback support
+- **`scheduler.mcrs`** — tick-budget-aware task scheduler (coroutine-compatible)
+
+#### Tests
+- **Coverage: 80% → 85%** — new unit tests for builtins, runtime, emit pipeline, and stdlib modules; arr.len() compile-time and dynamic paths fully covered
+
+#### stdlib
+- **`linalg.mcrs`** — double-precision linear algebra: `vec2_add/sub/scale/dot/length/normalize`, `vec3_cross`, `mat2x2 / mat3x3 / mat4x4` multiply, Cramer's rule solver for 2×2 and 3×3 systems
+- **`fft.mcrs`** — Discrete Fourier Transform with a `@coroutine` variant for in-game use; supports transforms up to n=64; quarter-wave symmetry test now enabled after related compiler fix
+- **`ecs.mcrs`** — Entity Component System: `register_component`, `get_component`, `has_component`; built-in Health and Velocity components; `@tick` system iteration via `foreach(entity[tag=has_<component>])`; fills the gap that Java datapacks have vs Bedrock's native component model
+- **`sort.mcrs` v2** — coroutine-based bottom-up merge sort for large arrays (n > 64); yields every 20 comparisons to stay within the 20 ms tick budget
+
+#### Language / Events
+- **`@on(EventType)` full compiler implementation** — compiler generates Minecraft function-tag JSON and wires an `events.mcrs` dispatcher automatically; supported events: `PlayerJoin`, `PlayerDeath`, `EntityKill`, `ItemUse` (each with correctly typed parameters)
+- **MC integration tests** for `@on(PlayerJoin)` and `@on(PlayerDeath)` added to the test suite
+
+#### Runtime
+- **`MCRuntime`** `storage_get_int` / `storage_set_array` builtins — allows `sin` / `cos` (which rely on NBT storage) to execute correctly in unit test environment without a running Minecraft instance
+
+### Fixed
+
+#### Compiler
+- **Dynamic array indexing on function parameters** — `arr[i]` inside a callee now resolves to the correct per-call-site monomorphized NBT path; previously the binding was shadowed and produced a wrong path
+- **`scoreboard_get` / `scoreboard_set` Player selector** — emits `@s` (not an empty string) when the Player argument resolves to the executing entity
+
+#### stdlib
+- **`linalg.mcrs`** — `double_sqrt` return-type cast corrected; prevents type mismatch in chained double-precision expressions
+
+#### Events
+- **`@on(BlockBreak)`** — constrained to `Player` parameter only; Minecraft does not expose block type at function-tag dispatch time and including it caused a compile error
+
+---
+
+## [2.6.1] - 2026-03-20
+
+### Fixed
+
+#### Compiler
+- **Dynamic array indexing on function parameters** — `arr[i]` in callee functions now correctly resolves the per-call-site monomorphized binding (regression introduced in v2.4.0 array-reference work)
+- **`scoreboard_get` / `scoreboard_set` Player param** — selector now correctly emits `@s` instead of an empty string when the Player argument is the executing entity
+
+#### stdlib
+- **`linalg.mcrs`** — `double_sqrt` return type cast fixed; avoids type error in chained double expressions
+
+#### Events
+- **`@on(BlockBreak)`** — removed block-type parameter; MC provides no runtime block type info at function-tag dispatch
+
+---
+
+## [2.6.0] - 2026-03-19
+
+### Compiler
+
+- **Parser** now emits `span.endLine` for function declarations — LSP clients receive accurate scope ranges for hovers and highlights
+- **String concatenation error:** `"string" + var` now raises a compile-time error with a hint to use f-string interpolation instead of silently producing broken output
+- **F-string MC text components:** f-string interpolation inside `tell`, `title`, `subtitle`, `actionbar`, and `announce` now emits proper Minecraft JSON text components (e.g. `["", {"score": …}, " text"]`) instead of raw concatenated strings
+- **LSP inlay hints:** the language server now shows inferred types next to unannotated `let` bindings inline in the editor
+
+### stdlib
+
+- **`mat3_mul` / `mat4_mul`** — 3×3 and 4×4 matrix multiply helpers (fixed-point ×10000 scale) in `stdlib/matrix.mcrs`
+- **`bigint_div`** — full arbitrary-precision long division returning both quotient and remainder in `stdlib/bigint.mcrs`
+- **`graph.mcrs`** — adjacency-list graph library: `graph_add_edge`, BFS, DFS, `has_path`, and `shortest_path` (Dijkstra's algorithm)
+- **`ode.mcrs`** — Runge-Kutta 4th-order ODE solver supporting exponential decay/growth and sine oscillator systems
+
+### VSCode Extension
+
+- **v1.3.17:** inlay hints for inferred `let` binding types; improved variable hover tooltips showing type and declaration site
+
 ## [2.5.0] - 2026-03-17
 
 ### Added

package/README.md

@@ -2,14 +2,14 @@
 
 <img src="./logo.png" alt="RedScript Logo" width="64" />
 
-<img src="https://img.shields.io/badge/RedScript-2.1.1-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
+<img src="https://img.shields.io/badge/RedScript-2.6.2-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
 
 **A typed scripting language that compiles to Minecraft datapacks.**
 
 Write clean game logic. RedScript handles the scoreboard spaghetti.
 
 [![CI](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-1123%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
+[![Tests](https://img.shields.io/badge/tests-1901%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
 [![npm](https://img.shields.io/npm/v/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![npm downloads](https://img.shields.io/npm/dm/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![VSCode](https://img.shields.io/badge/VSCode-Extension-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=bkmashiro.redscript-vscode)
@@ -87,21 +87,6 @@ let frame: int = 0;
 
 ---
 
-### What's New in v2.1.x
-
-- **`enum` + `match` dispatch** — zero-runtime-overhead state machines; the compiler folds enum variants to integer constants and uses `execute if score` dispatch with no heap allocation
-- **Multi-return values** — `fn divmod(a: int, b: int): (int, int)` unpacks to separate scoreboard slots; no struct wrapper needed
-- **Generics** — `fn max<T>(a: T, b: T): T` is fully monomorphized at compile time; no boxing, no indirection
-- **`Option<T>` null safety** — `Some(x)` / `None` with `if let Some(x) = opt` pattern binding; safe access to optional values without sentinel integers
-- **`@coroutine(batch=N)`** — spreads a heavy loop across multiple ticks (`batch=50` means 50 iterations/tick), avoiding `maxCommandChainLength` hits on large workloads
-- **`@schedule(ticks=N)`** — delays a function call by N game ticks; compiles to `schedule function` with automatic namespace scoping
-- **Module system** — `module math;` declares a named module; consumers `import math::sin` to tree-shake individual symbols
-- **Multi-version targets** — `--mc-version 1.20.2` switches emit strategy (macro sub-functions vs. legacy scoreboards) for the target server version
-- **Source maps** — `--source-map` emits a `.mcrs.map` sidecar that maps each `.mcfunction` line back to the original source; enables in-editor debugging
-- **LSP: hover + completion for builtins & decorators** — 50+ builtin functions and all decorators (`@tick`/`@load`/`@coroutine`/`@schedule`/`@on_trigger`) now show inline docs on hover
-
----
-
 ### Quick Start
 
 #### Option 1: Online IDE (No Install)
@@ -318,43 +303,18 @@ import "stdlib/signal"    // normal/exponential distributions, bernoulli, weight
 import "stdlib/bigint"    // 96-bit base-10000 arithmetic (add/sub/mul/div/cmp)
 import "stdlib/easing"    // 12 easing functions: quad/cubic/sine/bounce/back/smooth
 import "stdlib/noise"     // value noise, fractal Brownian motion, terrain height
+import "stdlib/calculus"  // numerical differentiation, trapezoid/Simpson integration, curve length, online statistics
+import "stdlib/matrix"    // 2D/3D rotation, Display Entity quaternion helpers
 import "stdlib/combat"    // damage, kill-check helpers
 import "stdlib/player"    // health, alive check, range
 import "stdlib/cooldown"  // per-player cooldown tracking
 ```
 
-Custom library paths can be added with `--include <dir>` so your own modules work the same way.
-
-### Standard Library
-
 All stdlib files use `module library;` — only the functions you actually call are compiled in.
 
 > Parts of the standard library are inspired by [kaer-3058/large_number](https://github.com/kaer-3058/large_number), a comprehensive math library for Minecraft datapacks.
 
-```rs
-import "stdlib/math"            // abs, sign, min, max, clamp, lerp, isqrt, sqrt_fixed,
-                                // pow_int, gcd, lcm, sin_fixed, cos_fixed, map, ceil_div,
-                                // log2_int, mulfix, divfix, smoothstep, smootherstep
-
-import "stdlib/vec"             // dot2d, cross2d, length2d_fixed, distance2d_fixed,
-                                // manhattan, chebyshev, atan2_fixed, normalize2d_x/y,
-                                // rotate2d_x/y, lerp2d_x/y, dot3d, cross3d_x/y/z,
-                                // length3d_fixed
-
-import "stdlib/advanced"        // fib, is_prime, collatz_steps, digit_sum, reverse_int,
-                                // mod_pow, hash_int, noise1d, bezier_quad,
-                                // mandelbrot_iter, julia_iter, angle_between,
-                                // clamp_circle_x/y, newton_sqrt, digital_root
-
-import "stdlib/bigint"          // bigint_init, bigint_from_int_a/b, bigint_add/sub/mul,
-                                // bigint_compare, bigint_mul_small, bigint_fib
-                                // — up to 32 decimal digits, runs on MC scoreboard
-
-import "stdlib/player"          // is_alive, in_range, get_health
-import "stdlib/timer"           // start_timer, tick_timer, has_elapsed
-import "stdlib/cooldown"        // set_cooldown, check_cooldown
-import "stdlib/mobs"            // ZOMBIE, SKELETON, CREEPER, ... (60+ constants)
-```
+Custom library paths can be added with `--include <dir>` so your own modules work the same way.
 
 **Example — computing Fibonacci(50) in-game:**
 
@@ -393,36 +353,6 @@ node dist/cli.js compile examples/coroutine-demo.mcrs -o ~/mc-server/datapacks/d
 
 ---
 
-### Further Reading
-
-| | |
-|---|---|
-| 📖 [Language Reference](docs/LANGUAGE_REFERENCE.md) | Full syntax & type system |
-| 🔧 [Builtins](https://redscript-docs.pages.dev/Builtins) | All 34+ MC builtin functions |
-| ⚡ [Optimizer](https://redscript-docs.pages.dev/Optimizer) | How the optimizer works |
-| 🧱 [Structure Target](docs/STRUCTURE_TARGET.md) | Compile to NBT command block structures |
-| 🧪 [Integration Testing](https://redscript-docs.pages.dev/Integration-Testing) | Test against a real Paper server |
-| 🏗 [Implementation Guide](docs/IMPLEMENTATION_GUIDE.md) | Compiler internals |
-
----
-
-### What's New in v1.2.27
-
-- **BigInt confirmed working in real Minecraft** (`bigint.mcrs`): arbitrary precision integers on MC scoreboard + NBT — base 10,000 × 8 limbs = up to 32 decimal digits; `bigint_add`, `bigint_sub`, `bigint_compare`, `bigint_mul`, `bigint_fib(50)` = 12,586,269,025 all verified on Paper 1.21.4
-- **`storage_set_int` macro fix**: dynamic NBT array writes now use `execute store result storage` instead of `data modify set value $(n)` — avoids a silent Minecraft macro substitution bug with integer values
-- **Full stdlib** (`math.mcrs`, `vec.mcrs`, `advanced.mcrs`, `bigint.mcrs`, `showcase.mcrs`): 18 math functions, 14 vector geometry functions, 20+ advanced number-theory and fractal functions
-- **`module library;` pragma**: tree-shaking for library files — stdlib never bloats your pack
-- **`storage_get_int` / `storage_set_int` builtins**: dynamic NBT int array read/write with runtime indices via MC 1.20.2+ macro sub-functions
-- **`@require_on_load(fn)` decorator**: declarative load-time dependency tracking for sin/cos/atan table initializers
-
-### What's New in v1.2.26
-
-- **Math stdlib** (`math.mcrs`): 18 fixed-point functions — `abs`, `sign`, `min`, `max`, `clamp`, `lerp`, `isqrt`, `sqrt_fixed`, `pow_int`, `gcd`, `lcm`, `sin_fixed`, `cos_fixed`, `map`, `ceil_div`, `log2_int`, `mulfix`, `divfix`, `smoothstep`, `smootherstep`
-- **Vector stdlib** (`vec.mcrs`): 2D and 3D geometry — dot/cross products, `length2d_fixed`, `atan2_fixed` (binary search, O(log 46)), `normalize2d`, `rotate2d`, `lerp2d`, full 3D cross product
-- **Advanced stdlib** (`advanced.mcrs`): number theory (`fib`, `is_prime`, `collatz_steps`, `gcd`, `mod_pow`), hash/noise (`hash_int` splitmix32, `noise1d`), curves (`bezier_quad`), fractals (`mandelbrot_iter`, `julia_iter`), geometry experiments
-- **BigInt** (`bigint.mcrs`): arbitrary precision integers — base 10,000 × 8 limbs = up to 32 decimal digits; `bigint_add/sub/compare/mul/fib` running on MC scoreboard + NBT storage
-- **Compiler fixes**: `isqrt` large-number convergence, optimizer copy propagation alias invalidation, cross-function variable collision, MCRuntime array-index regex
-
 ### Changelog Highlights
 
 #### v1.2.27 (2026-03-14)