redscript-mc 1.2.26 → 1.2.28

package/README.md

@@ -2,14 +2,14 @@
 
 <img src="./logo.png" alt="RedScript Logo" width="64" />
 
-<img src="https://img.shields.io/badge/RedScript-1.2-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
+<img src="https://img.shields.io/badge/RedScript-1.2.27-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-573%2B%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
+[![Tests](https://img.shields.io/badge/tests-918%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)
@@ -76,7 +76,7 @@ fn stop() {
 
 ---
 
-### What's New in v1.2
+### What's New in v1.2.25
 
 - `impl` blocks and methods for object-style APIs on structs
 - `is` type narrowing for safer entity checks
@@ -275,14 +275,48 @@ redscript validate <file>      Validate MC commands
 
 ### Standard Library
 
+All stdlib files use `module library;` — only the functions you actually call are compiled in.
+
 ```rs
-import "stdlib/math.mcrs"       // abs, min, max, clamp
+import "stdlib/math.mcrs"       // 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.mcrs"        // 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.mcrs"   // 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.mcrs"     // 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.mcrs"     // is_alive, in_range, get_health
 import "stdlib/timer.mcrs"      // start_timer, tick_timer, has_elapsed
 import "stdlib/cooldown.mcrs"   // set_cooldown, check_cooldown
 import "stdlib/mobs.mcrs"       // ZOMBIE, SKELETON, CREEPER, ... (60+ constants)
 ```
 
+**Example — computing Fibonacci(50) in-game:**
+
+```rs
+import "stdlib/bigint.mcrs"
+
+fn show_fib() {
+    bigint_fib(50);
+    // F(50) = 12,586,269,025 — too big for int32, stored across 3 limbs:
+    let l0: int = bigint_get_a(0);  // 9025
+    let l1: int = bigint_get_a(1);  // 8626
+    let l2: int = bigint_get_a(2);  // 125
+    say(f"F(50) limbs: {l2} {l1} {l0}");
+}
+```
+
 ---
 
 ### Further Reading
@@ -298,16 +332,51 @@ import "stdlib/mobs.mcrs"       // ZOMBIE, SKELETON, CREEPER, ... (60+ constants
 
 ---
 
+### 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)
+
+- **BigInt real-MC fix**: `storage_set_int` macro now uses `execute store result storage` instead of `data modify set value $(n)` — avoids a Minecraft macro substitution bug with integer values; BigInt confirmed working on Paper 1.21.4
+- **showcase**: `atan2_fixed` returns degrees (0–360), not millidegrees; fixed over-division in examples; `mod_pow` test cases use small safe-range moduli (no INT32 overflow)
+
+#### v1.2.26 (2026-03-14)
+
+- Full math/vector/advanced/bigint standard library (see above)
+- `module library;` pragma for zero-cost tree-shaking
+- `storage_get_int` / `storage_set_int` dynamic NBT array builtins
+- Compiler bug fixes: `isqrt` convergence, copy propagation, variable scoping
+
+#### v1.2.25 (2026-03-13)
+
+- Entity type hierarchy with `W_IMPOSSIBLE_AS` warnings
+- Variable name mangling (`$a`, `$b`, `$c`, ...) for minimal scoreboard footprint
+- Automated CI/CD: npm publish + VSCode extension on every push
+
 #### v1.2.0
 
-- Added `impl` blocks, methods, and static constructors
-- Added `is` type narrowing for entity-safe control flow
-- Added `@on(Event)` static events and callback scheduling builtins
-- Added runtime f-strings for output functions
+- `impl` blocks, methods, and static constructors
+- `is` type narrowing for entity-safe control flow
+- `@on(Event)` static events and callback scheduling builtins
+- Runtime f-strings for output functions
 - Expanded stdlib with Timer OOP APIs and 313 MC tag constants
-- Improved optimization with dead code elimination
+- Dead code elimination
 
 See [CHANGELOG.md](./CHANGELOG.md) for the full release notes.
 

package/README.zh.md

@@ -2,14 +2,14 @@
 
 <img src="./logo.png" alt="RedScript Logo" width="64" />
 
-<img src="https://img.shields.io/badge/RedScript-1.2-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
+<img src="https://img.shields.io/badge/RedScript-1.2.27-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
 
 **一个编译到 Minecraft Datapack 的类型化脚本语言。**
 
 写干净的游戏逻辑，把记分板的面条代码交给 RedScript 处理。
 
 [![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-573%2B%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
+[![Tests](https://img.shields.io/badge/tests-918%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-插件-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=bkmashiro.redscript-vscode)
@@ -73,7 +73,23 @@ let running: bool = false;
 
 ---
 
-### v1.2 新增内容
+### v1.2.27 新增内容
+
+- **BigInt 实机验证通过** (`bigint.mcrs`)：任意精度整数在 MC 记分板 + NBT 上完整运行 — base 10000 × 8 limbs = 最多 32 位十进制数；`bigint_fib(50)` = 12,586,269,025 在 Paper 1.21.4 实机验证正确
+- **`storage_set_int` 宏修复**：动态 NBT 数组写入改用 `execute store result storage` 而非 `data modify set value $(n)` — 规避 Minecraft 宏机制对整数值的静默替换 bug
+- **完整标准库** (`math.mcrs`、`vec.mcrs`、`advanced.mcrs`、`bigint.mcrs`、`showcase.mcrs`)：18 个数学函数、14 个向量几何函数、20+ 数论与分形函数
+- **`module library;` pragma**：库文件零成本树摇 — 标准库永远不会撑大你的数据包
+- **`@require_on_load(fn)` 装饰器**：sin/cos/atan 查找表初始化器的声明式加载依赖跟踪
+
+### v1.2.26 新增内容
+
+- **数学标准库** (`math.mcrs`)：18 个定点数函数 — `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`
+- **向量标准库** (`vec.mcrs`)：2D / 3D 几何 — 点积/叉积、`length2d_fixed`、`atan2_fixed`（二分搜索正切表，O(log 46)）、`normalize2d`、`rotate2d`、`lerp2d`、完整 3D 叉积
+- **高级标准库** (`advanced.mcrs`)：数论（`fib`、`is_prime`、`collatz_steps`、`mod_pow`）、哈希/噪声（splitmix32 `hash_int`、`noise1d`）、曲线（`bezier_quad`）、分形（`mandelbrot_iter`、`julia_iter`）、几何实验
+- **BigInt** (`bigint.mcrs`)：任意精度整数架构设计 — base 10000 × 8 limbs = 最多 32 位十进制数
+- **编译器修复**：`isqrt` 大数收敛、优化器拷贝传播别名失效、跨函数变量命名冲突、MCRuntime 数组索引正则
+
+### v1.2.25 新增内容
 
 - `impl` 块与方法，支持围绕结构体构建面向对象风格 API
 - `is` 类型收窄，实体判断更安全
@@ -268,14 +284,48 @@ redscript validate <file>      验证 MC 命令语法
 
 ### 标准库
 
+所有标准库文件都使用 `module library;` —— 只有你实际调用的函数才会编译进去。
+
 ```rs
-import "stdlib/math.mcrs"       // abs, min, max, clamp
+import "stdlib/math.mcrs"       // 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.mcrs"        // 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.mcrs"   // 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.mcrs"     // bigint_init, bigint_from_int_a/b, bigint_add/sub/mul,
+                                // bigint_compare, bigint_mul_small, bigint_fib
+                                // — 最多 32 位十进制数，纯记分板运行
+
 import "stdlib/player.mcrs"     // is_alive, in_range, get_health
 import "stdlib/timer.mcrs"      // start_timer, tick_timer, has_elapsed
 import "stdlib/cooldown.mcrs"   // set_cooldown, check_cooldown
 import "stdlib/mobs.mcrs"       // ZOMBIE, SKELETON, CREEPER ... (60+ 实体常量)
 ```
 
+**示例 — 游戏内计算斐波那契数列第 50 项：**
+
+```rs
+import "stdlib/bigint.mcrs"
+
+fn show_fib() {
+    bigint_fib(50);
+    // F(50) = 12,586,269,025 — 超过 int32，分 3 个 limb 存储：
+    let l0: int = bigint_get_a(0);  // 9025
+    let l1: int = bigint_get_a(1);  // 8626
+    let l2: int = bigint_get_a(2);  // 125
+    say(f"F(50) limbs: {l2} {l1} {l0}");
+}
+```
+
 ---
 
 ### 更多文档
@@ -293,6 +343,24 @@ import "stdlib/mobs.mcrs"       // ZOMBIE, SKELETON, CREEPER ... (60+ 实体常
 
 ### 更新日志亮点
 
+#### v1.2.27（2026-03-14）
+
+- **BigInt 实机修复**：`storage_set_int` 宏改用 `execute store result storage`，规避 MC 宏整数替换 bug；BigInt 在 Paper 1.21.4 实机验证通过
+- showcase 示例修复：`atan2_fixed` 返回度数（0–360），更正不必要的除以 1000；`mod_pow` 测试改用小 modulus 避免 INT32 溢出
+
+#### v1.2.26（2026-03-14）
+
+- 完整的数学/向量/高级/BigInt 标准库（详见上方）
+- `module library;` pragma，实现零成本树摇
+- `storage_get_int` / `storage_set_int` 动态 NBT 数组内置函数
+- 编译器修复：`isqrt` 收敛、拷贝传播、变量作用域命名
+
+#### v1.2.25（2026-03-13）
+
+- 实体类型层级与 `W_IMPOSSIBLE_AS` 警告
+- 变量名混淆（`$a`、`$b`、`$c` ...），最小化记分板占用
+- CI/CD 自动化：每次推送自动发布 npm + VSCode 插件
+
 #### v1.2.0
 
 - 新增 `impl` 块、实例方法与静态构造函数

package/dist/__tests__/cli.test.js

@@ -77,7 +77,7 @@ describe('CLI API', () => {
             const source = fs.readFileSync(mainPath, 'utf-8');
             const result = (0, index_1.compile)(source, { namespace: 'mygame', filePath: mainPath });
             const tickTimer = result.files.find(file => file.path.endsWith('/tick_timer.mcfunction'));
-            expect(tickTimer?.content).toContain('scoreboard players set #rs rs.timer_ticks 1');
+            expect(tickTimer?.content).toContain('scoreboard players set #rs mygame.timer_ticks 1');
         });
         it('adds a call-site hash for stdlib internal scoreboard objectives', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-stdlib-hash-'));
@@ -106,7 +106,7 @@ describe('CLI API', () => {
             const timerFns = result.files.filter(file => /timer_start__callsite_[0-9a-f]{4}\.mcfunction$/.test(file.path));
             expect(timerFns).toHaveLength(2);
             const objectives = timerFns
-                .flatMap(file => [...file.content.matchAll(/rs\._timer_([0-9a-f]{4})/g)].map(match => match[0]));
+                .flatMap(file => [...file.content.matchAll(/mygame\._timer_([0-9a-f]{4})/g)].map(match => match[0]));
             expect(new Set(objectives).size).toBe(2);
         });
         it('Timer::new creates timer', () => {
@@ -125,8 +125,8 @@ describe('CLI API', () => {
             const result = (0, index_1.compile)(source, { namespace: 'timernew', filePath: mainPath });
             expect(result.typeErrors).toEqual([]);
             const newFn = result.files.find(file => file.path.endsWith('/Timer_new.mcfunction'));
-            expect(newFn?.content).toContain('scoreboard players set timer_ticks rs 0');
-            expect(newFn?.content).toContain('scoreboard players set timer_active rs 0');
+            expect(newFn?.content).toContain('scoreboard players set timer_ticks timernew 0');
+            expect(newFn?.content).toContain('scoreboard players set timer_active timernew 0');
         });
         it('Timer.start/pause/reset', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-state-'));
@@ -149,9 +149,9 @@ describe('CLI API', () => {
             const startFn = result.files.find(file => file.path.endsWith('/Timer_start.mcfunction'));
             const pauseFn = result.files.find(file => file.path.endsWith('/Timer_pause.mcfunction'));
             const resetFn = result.files.find(file => file.path.endsWith('/Timer_reset.mcfunction'));
-            expect(startFn?.content).toContain('scoreboard players set timer_active rs 1');
-            expect(pauseFn?.content).toContain('scoreboard players set timer_active rs 0');
-            expect(resetFn?.content).toContain('scoreboard players set timer_ticks rs 0');
+            expect(startFn?.content).toContain('scoreboard players set timer_active timerstate 1');
+            expect(pauseFn?.content).toContain('scoreboard players set timer_active timerstate 0');
+            expect(resetFn?.content).toContain('scoreboard players set timer_ticks timerstate 0');
         });
         it('Timer.done returns bool', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-done-'));
@@ -174,9 +174,9 @@ describe('CLI API', () => {
             expect(result.typeErrors).toEqual([]);
             const doneFn = result.files.find(file => file.path.endsWith('/Timer_done.mcfunction'));
             const mainFn = result.files.find(file => file.path.endsWith('/main.mcfunction'));
-            expect(doneFn?.content).toContain('scoreboard players get timer_ticks rs');
+            expect(doneFn?.content).toContain('scoreboard players get timer_ticks timerdone');
             expect(doneFn?.content).toContain('return run scoreboard players get');
-            expect(mainFn?.content).toContain('execute if score $main_finished rs matches 1..');
+            expect(mainFn?.content).toContain('execute if score $main_finished timerdone matches 1..');
         });
         it('Timer.tick increments', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-tick-'));
@@ -199,10 +199,10 @@ describe('CLI API', () => {
                 .filter(file => file.path.includes('/Timer_tick'))
                 .map(file => file.content)
                 .join('\n');
-            expect(tickOutput).toContain('scoreboard players get timer_active rs');
-            expect(tickOutput).toContain('scoreboard players get timer_ticks rs');
-            expect(tickOutput).toContain(' += $const_1 rs');
-            expect(tickOutput).toContain('execute store result score timer_ticks rs run scoreboard players get $_');
+            expect(tickOutput).toContain('scoreboard players get timer_active timertick');
+            expect(tickOutput).toContain('scoreboard players get timer_ticks timertick');
+            expect(tickOutput).toContain(' += $const_1 timertick');
+            expect(tickOutput).toContain('execute store result score timer_ticks timertick run scoreboard players get $_');
         });
     });
     describe('compile()', () => {

package/dist/__tests__/optimizer-advanced.test.js

@@ -26,7 +26,7 @@ fn turret_tick() {
         const result = (0, index_1.compile)(source, { namespace: 'test' });
         const parent = getFileContent(result.files, 'data/test/function/turret_tick.mcfunction');
         const loopBody = getFileContent(result.files, 'data/test/function/turret_tick/foreach_0.mcfunction');
-        const hoistedRead = 'execute store result score $_0 rs run scoreboard players get config test.turret_range';
+        const hoistedRead = 'execute store result score $_0 test run scoreboard players get config test.turret_range';
         const executeCall = 'execute as @e[tag=turret] run function test:turret_tick/foreach_0';
         expect(parent).toContain(hoistedRead);
         expect(parent.indexOf(hoistedRead)).toBeLessThan(parent.indexOf(executeCall));
@@ -48,7 +48,7 @@ fn read_twice() {
         const fn = getFileContent(result.files, 'data/test/function/read_twice.mcfunction');
         const readMatches = fn.match(/scoreboard players get @s test\.coins/g) ?? [];
         expect(readMatches).toHaveLength(1);
-        expect(fn).toContain('scoreboard players operation $_1 rs = $_0 rs');
+        expect(fn).toContain('scoreboard players operation $_1 test = $_0 test');
     });
     test('reuses duplicate arithmetic sequences', () => {
         const source = `
@@ -63,9 +63,9 @@ fn math() {
 `;
         const result = (0, index_1.compile)(source, { namespace: 'test' });
         const fn = getFileContent(result.files, 'data/test/function/math.mcfunction');
-        const addMatches = fn.match(/\+= \$const_2 rs/g) ?? [];
+        const addMatches = fn.match(/\+= \$const_2 test/g) ?? [];
         expect(addMatches).toHaveLength(1);
-        expect(fn).toContain('scoreboard players operation $_1 rs = $_0 rs');
+        expect(fn).toContain('scoreboard players operation $_1 test = $_0 test');
     });
 });
 describe('setblock batching', () => {

package/dist/__tests__/stdlib-advanced.test.js

@@ -261,4 +261,118 @@ describe('julia_iter', () => {
         expect(scoreOf(rt, 'r')).toBe(0);
     });
 });
+// ─── Experiment: cross-stdlib (vec + math + advanced) ────────────────────────
+const VEC_SRC = fs.readFileSync(path.join(__dirname, '../../src/stdlib/vec.mcrs'), 'utf-8');
+function runAll(driver) {
+    const result = (0, compile_1.compile)(driver, {
+        namespace: 'exptest',
+        librarySources: [MATH_SRC, VEC_SRC, ADV_SRC],
+    });
+    if (!result.success)
+        throw new Error(result.error?.message ?? 'compile failed: ' + result.error?.message);
+    const rt = new runtime_1.MCRuntime('exptest');
+    for (const file of result.files ?? []) {
+        if (!file.path.endsWith('.mcfunction'))
+            continue;
+        const match = file.path.match(/data\/([^/]+)\/function\/(.+)\.mcfunction$/);
+        if (!match)
+            continue;
+        rt.loadFunction(`${match[1]}:${match[2]}`, file.content.split('\n'));
+    }
+    rt.load();
+    return rt;
+}
+function exp(rt, key) {
+    return rt.getScore('out', `exptest.${key}`) ?? 0;
+}
+describe('newton_sqrt', () => {
+    it('newton_sqrt(25) == 5', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", newton_sqrt(25)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(5);
+    });
+    it('newton_sqrt(100) == 10', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", newton_sqrt(100)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(10);
+    });
+    it('newton_sqrt(2) == 1', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", newton_sqrt(2)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(1);
+    });
+    it('newton_sqrt(0) == 0', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", newton_sqrt(0)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(0);
+    });
+});
+describe('digital_root', () => {
+    it('digital_root(493) == 7', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", digital_root(493)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(7);
+    });
+    it('digital_root(9) == 9', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", digital_root(9)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(9);
+    });
+    it('digital_root(0) == 0', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", digital_root(0)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(0);
+    });
+});
+describe('spiral_ring', () => {
+    it('spiral_ring(1) == 0', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", spiral_ring(1)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(0);
+    });
+    it('spiral_ring(9) == 1', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", spiral_ring(9)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(1);
+    });
+    it('spiral_ring(25) == 2', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", spiral_ring(25)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(2);
+    });
+});
+describe('clamp_circle', () => {
+    it('point inside: clamp_circle_x(3,4,10) == 3', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", clamp_circle_x(3, 4, 10)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(3);
+    });
+    it('point outside: clamp_circle_x(600,0,500) == 500', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", clamp_circle_x(600, 0, 500)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(500);
+    });
+    it('clamp_circle_y(0,600,500) == 500', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", clamp_circle_y(0, 600, 500)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(500);
+    });
+});
+describe('angle_between', () => {
+    it('perpendicular vectors: angle_between(1000,0,0,1000) == 90', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", angle_between(1000, 0, 0, 1000)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(90);
+    });
+    it('parallel vectors: angle_between(1000,0,1000,0) == 0', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", angle_between(1000, 0, 1000, 0)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(0);
+    });
+    it('opposite vectors: angle_between(1000,0,-1000,0) == 180', () => {
+        const rt = runAll(`fn test() { scoreboard_set("out", "r", angle_between(1000, 0, -1000, 0)); }`);
+        rt.execFunction('test');
+        expect(exp(rt, 'r')).toBe(180);
+    });
+});
 //# sourceMappingURL=stdlib-advanced.test.js.map

package/dist/__tests__/stdlib-bigint.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * stdlib/bigint.mcrs — runtime behavioural tests
+ *
+ * Tests basic BigInt operations (base 10000, 8 limbs = 32 decimal digits).
+ * All arithmetic validated against known values.
+ */
+export {};