redscript-mc 2.0.0 → 2.1.1

package/dist/types/entity-hierarchy.d.ts

@@ -1,29 +0,0 @@
-/**
- * Entity Type Hierarchy
- *
- * Closed inheritance tree mapping to Minecraft's entity registry.
- * Used for type narrowing (is checks), selector<T> annotations,
- * and W_IMPOSSIBLE_AS warnings.
- */
-export interface EntityTypeNode {
-    name: string;
-    mcId: string | null;
-    abstract: boolean;
-    parent: string | null;
-}
-export declare const ENTITY_TYPES: EntityTypeNode[];
-/** Map from lowercase name → EntityTypeNode */
-export declare const ENTITY_TYPE_MAP: Map<string, EntityTypeNode>;
-/** Map from mcId (without namespace) → EntityTypeNode */
-export declare const ENTITY_TYPE_BY_MCID: Map<string, EntityTypeNode>;
-/** Check if typeA is a subtype of typeB (recursive ancestry) */
-export declare function isSubtype(typeA: string, typeB: string): boolean;
-/** True if one type is a subtype of the other (in either direction) */
-export declare function areCompatibleTypes(outerType: string, innerType: string): boolean;
-/** Get all non-abstract leaf types under a given node */
-export declare function getConcreteSubtypes(typeName: string): EntityTypeNode[];
-/** Parse "type=zombie" from a selector string, return the entity type name or null */
-export declare function getSelectorEntityType(selector: string): string | null;
-/** Determine the base entity type from a selector kind:
- *  @a/@p/@r → "Player", @e → "Entity" or from type filter, @s → null */
-export declare function getBaseSelectorType(selector: string): string | null;

package/dist/types/entity-hierarchy.js

@@ -1,107 +0,0 @@
-"use strict";
-/**
- * Entity Type Hierarchy
- *
- * Closed inheritance tree mapping to Minecraft's entity registry.
- * Used for type narrowing (is checks), selector<T> annotations,
- * and W_IMPOSSIBLE_AS warnings.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENTITY_TYPE_BY_MCID = exports.ENTITY_TYPE_MAP = exports.ENTITY_TYPES = void 0;
-exports.isSubtype = isSubtype;
-exports.areCompatibleTypes = areCompatibleTypes;
-exports.getConcreteSubtypes = getConcreteSubtypes;
-exports.getSelectorEntityType = getSelectorEntityType;
-exports.getBaseSelectorType = getBaseSelectorType;
-exports.ENTITY_TYPES = [
-    // Root
-    { name: 'Entity', mcId: null, abstract: true, parent: null },
-    // Direct children of Entity
-    { name: 'Player', mcId: 'minecraft:player', abstract: false, parent: 'Entity' },
-    { name: 'ArmorStand', mcId: 'minecraft:armor_stand', abstract: false, parent: 'Entity' },
-    { name: 'Item', mcId: 'minecraft:item', abstract: false, parent: 'Entity' },
-    { name: 'Arrow', mcId: 'minecraft:arrow', abstract: false, parent: 'Entity' },
-    // Mob hierarchy
-    { name: 'Mob', mcId: null, abstract: true, parent: 'Entity' },
-    // Hostile mobs
-    { name: 'HostileMob', mcId: null, abstract: true, parent: 'Mob' },
-    { name: 'Zombie', mcId: 'minecraft:zombie', abstract: false, parent: 'HostileMob' },
-    { name: 'Skeleton', mcId: 'minecraft:skeleton', abstract: false, parent: 'HostileMob' },
-    { name: 'Creeper', mcId: 'minecraft:creeper', abstract: false, parent: 'HostileMob' },
-    { name: 'Spider', mcId: 'minecraft:spider', abstract: false, parent: 'HostileMob' },
-    { name: 'Enderman', mcId: 'minecraft:enderman', abstract: false, parent: 'HostileMob' },
-    { name: 'Blaze', mcId: 'minecraft:blaze', abstract: false, parent: 'HostileMob' },
-    { name: 'Witch', mcId: 'minecraft:witch', abstract: false, parent: 'HostileMob' },
-    { name: 'Slime', mcId: 'minecraft:slime', abstract: false, parent: 'HostileMob' },
-    { name: 'ZombieVillager', mcId: 'minecraft:zombie_villager', abstract: false, parent: 'HostileMob' },
-    { name: 'Husk', mcId: 'minecraft:husk', abstract: false, parent: 'HostileMob' },
-    { name: 'Drowned', mcId: 'minecraft:drowned', abstract: false, parent: 'HostileMob' },
-    { name: 'Stray', mcId: 'minecraft:stray', abstract: false, parent: 'HostileMob' },
-    { name: 'WitherSkeleton', mcId: 'minecraft:wither_skeleton', abstract: false, parent: 'HostileMob' },
-    { name: 'CaveSpider', mcId: 'minecraft:cave_spider', abstract: false, parent: 'HostileMob' },
-    // Passive mobs
-    { name: 'PassiveMob', mcId: null, abstract: true, parent: 'Mob' },
-    { name: 'Pig', mcId: 'minecraft:pig', abstract: false, parent: 'PassiveMob' },
-    { name: 'Cow', mcId: 'minecraft:cow', abstract: false, parent: 'PassiveMob' },
-    { name: 'Sheep', mcId: 'minecraft:sheep', abstract: false, parent: 'PassiveMob' },
-    { name: 'Chicken', mcId: 'minecraft:chicken', abstract: false, parent: 'PassiveMob' },
-    { name: 'Villager', mcId: 'minecraft:villager', abstract: false, parent: 'PassiveMob' },
-    { name: 'WanderingTrader', mcId: 'minecraft:wandering_trader', abstract: false, parent: 'PassiveMob' },
-];
-/** Map from lowercase name → EntityTypeNode */
-exports.ENTITY_TYPE_MAP = new Map(exports.ENTITY_TYPES.map(t => [t.name.toLowerCase(), t]));
-/** Map from mcId (without namespace) → EntityTypeNode */
-exports.ENTITY_TYPE_BY_MCID = new Map(exports.ENTITY_TYPES
-    .filter(t => t.mcId !== null)
-    .map(t => [t.mcId.replace('minecraft:', ''), t]));
-/** Check if typeA is a subtype of typeB (recursive ancestry) */
-function isSubtype(typeA, typeB) {
-    if (typeA === typeB)
-        return true;
-    const node = exports.ENTITY_TYPE_MAP.get(typeA.toLowerCase());
-    if (!node || !node.parent)
-        return false;
-    return isSubtype(node.parent, typeB);
-}
-/** True if one type is a subtype of the other (in either direction) */
-function areCompatibleTypes(outerType, innerType) {
-    return isSubtype(outerType, innerType) || isSubtype(innerType, outerType);
-}
-/** Get all non-abstract leaf types under a given node */
-function getConcreteSubtypes(typeName) {
-    const results = [];
-    for (const node of exports.ENTITY_TYPES) {
-        if (!node.abstract && isSubtype(node.name, typeName)) {
-            results.push(node);
-        }
-    }
-    return results;
-}
-/** Parse "type=zombie" from a selector string, return the entity type name or null */
-function getSelectorEntityType(selector) {
-    const match = selector.match(/type=(?:minecraft:)?([a-z_]+)/);
-    if (!match)
-        return null;
-    const mcId = match[1];
-    const node = exports.ENTITY_TYPE_BY_MCID.get(mcId);
-    return node ? node.name : null;
-}
-/** Determine the base entity type from a selector kind:
- *  @a/@p/@r → "Player", @e → "Entity" or from type filter, @s → null */
-function getBaseSelectorType(selector) {
-    const trimmed = selector.trim();
-    // Check for type filter first (works for any selector)
-    const typeFromFilter = getSelectorEntityType(trimmed);
-    if (trimmed.startsWith('@a') || trimmed.startsWith('@p') || trimmed.startsWith('@r')) {
-        return typeFromFilter ?? 'Player';
-    }
-    if (trimmed.startsWith('@e')) {
-        return typeFromFilter ?? 'Entity';
-    }
-    // @s — context-dependent, we don't know unless there's a type filter
-    if (trimmed.startsWith('@s')) {
-        return typeFromFilter ?? null;
-    }
-    return null;
-}
-//# sourceMappingURL=entity-hierarchy.js.map

package/examples/spiral.mcrs

@@ -1,43 +0,0 @@
-// ===== Simple Particle Demo =====
-// 展示: @tick, 状态管理, f-strings, 控制命令
-
-// 状态
-let counter: int = 0;
-let running: bool = false;
-
-// ===== 主循环 =====
-@tick fn demo_tick() {
-    if (!running) { return; }
-    
-    // 每 tick 增加计数器
-    counter = counter + 1;
-    
-    // 在每个玩家位置生成粒子
-    foreach (p in @a) at @s {
-        particle("minecraft:end_rod", ~0, ~1, ~0, 0.5, 0.5, 0.5, 0.1, 5);
-    }
-    
-    // 每 20 ticks (1秒) 报告一次
-    if (counter % 20 == 0) {
-        say(f"Running for {counter} ticks");
-    }
-}
-
-// ===== 控制命令 =====
-// @keep 防止 DCE 删除
-@keep fn start() {
-    running = true;
-    counter = 0;
-    say(f"Demo started!");
-}
-
-@keep fn stop() {
-    running = false;
-    say(f"Demo stopped at {counter} ticks.");
-}
-
-@keep fn reset() {
-    running = false;
-    counter = 0;
-    say(f"Demo reset.");
-}

package/src/examples/arena.mcrs

@@ -1,44 +0,0 @@
-// PvP arena scoreboard tracker.
-// Reads the vanilla kills objective, announces the top score every 200 ticks,
-// and tells the current leader(s) directly.
-
-@tick
-fn arena_tick() {
-    let ticks: int = scoreboard_get("arena", #ticks);
-    ticks = ticks + 1;
-    scoreboard_set("arena", #ticks, ticks);
-
-    if (ticks % 200 == 0) {
-        announce_leaders();
-    }
-}
-
-fn announce_leaders() {
-    let top_kills: int = 0;
-
-    foreach (player in @a) {
-        let kills: int = scoreboard_get(player, #kills);
-        if (kills > top_kills) {
-            top_kills = kills;
-        }
-    }
-
-    if (top_kills > 0) {
-        announce("Arena update: leader check complete.");
-        title_times(@a, 10, 40, 10);
-        actionbar(@a, "Top kills updated");
-
-        foreach (player in @a) {
-            let kills: int = scoreboard_get(player, #kills);
-            if (kills == top_kills) {
-                tell(player, "You are leading the arena right now.");
-                title(player, "Arena Leader");
-                subtitle(player, "Hold the top score");
-                actionbar(player, "Stay alive to keep the lead");
-            }
-        }
-    } else {
-        announce("Arena update: no PvP kills yet.");
-        actionbar(@a, "No arena leader yet");
-    }
-}

package/src/examples/counter.mcrs

@@ -1,12 +0,0 @@
-// Tick counter that announces every 100 ticks.
-
-@tick
-fn counter_tick() {
-    let ticks = scoreboard_get("counter", #ticks);
-    ticks = ticks + 1;
-    scoreboard_set("counter", #ticks, ticks);
-
-    if (ticks % 100 == 0) {
-        say("Counter reached another 100 ticks");
-    }
-}

package/src/examples/new_features_demo.mcrs

@@ -1,193 +0,0 @@
-/**
- * RedScript New Features Demo
- * Showcasing language features added on 2026-03-12
- */
-
-// ============================================
-// 1. Type Inference
-// ============================================
-fn type_inference_demo() {
-    // No need to write `: int`, compiler infers automatically
-    let health = 100;
-    let name = "Steve";
-    let alive = true;
-    let speed = 1.5;
-    
-    // NBT suffixes can also be inferred
-    let damage = 20b;      // byte
-    let distance = 1000s;  // short
-    let bignum = 999999L;  // long
-    let precise = 3.14d;   // double
-    
-    say("Health: ${health}, Name: ${name}");
-}
-
-// ============================================
-// 2. For-Range Loops
-// ============================================
-fn for_range_demo() {
-    // Loop from 0 to 9
-    for i in 0..10 {
-        say("Count: ${i}");
-    }
-    
-    // Can be used for countdown
-    for sec in 0..5 {
-        title(@a, "Starting in ${sec}...");
-    }
-}
-
-// ============================================
-// 3. NBT Structured Params
-// ============================================
-fn nbt_params_demo() {
-    // Give item with NBT
-    give(@s, "minecraft:diamond_sword", 1, {
-        display: { Name: "Excalibur" },
-        Enchantments: [
-            { id: "minecraft:sharpness", lvl: 5 },
-            { id: "minecraft:unbreaking", lvl: 3 }
-        ]
-    });
-    
-    // Summon entity with attributes
-    summon("minecraft:zombie", @s, {
-        CustomName: "Boss Zombie",
-        Health: 100.0,
-        Attributes: [
-            { Name: "generic.max_health", Base: 100.0 }
-        ]
-    });
-}
-
-// ============================================
-// 4. Set Data Structure (Runtime Set)
-// ============================================
-fn set_demo() {
-    // Create set
-    let visited = set_new();
-    
-    // Add elements using method syntax
-    visited.add("spawn");
-    visited.add("castle");
-    visited.add("dungeon");
-    
-    // Check if exists
-    if (visited.contains("castle")) {
-        say("You've been to the castle!");
-    }
-    
-    // Remove element
-    visited.remove("spawn");
-    
-    // Clear set
-    visited.clear();
-}
-
-// ============================================
-// 5. Method Syntax Sugar
-// ============================================
-fn method_syntax_demo() {
-    let items: string[] = [];
-    
-    // obj.method(args) → method(obj, args)
-    items.push("sword");
-    items.push("shield");
-    items.push("potion");
-    
-    let count = items.len();
-    say("You have ${count} items");
-    
-    // Sets can also use method syntax
-    let tags = set_new();
-    tags.add("vip");
-    tags.add("admin");
-    
-    if (tags.contains("admin")) {
-        say("Welcome, admin!");
-    }
-}
-
-// ============================================
-// 6. #mc_name Syntax (MC Identifier Syntax)
-// ============================================
-fn mc_name_demo() {
-    // #name compiles to bare MC name (without quotes)
-    scoreboard_set(@s, #kills, 0);
-    scoreboard_add(@s, #deaths, 1);
-    
-    let score = scoreboard_get(@s, #points);
-    
-    // For tag
-    tag_add(@s, #vip);
-    
-    // For team
-    team_join(@s, #red);
-    
-    // Comparison: strings still need quotes
-    give(@s, "minecraft:diamond", 1);
-}
-
-// ============================================
-// 7. Block Comments
-// ============================================
-
-/* 
- * This is a block comment
- * Can span multiple lines
- */
-
-/**
- * This is a doc comment
- * @param player Target player
- */
-fn documented_function() {
-    say("Hello!");
-}
-
-// ============================================
-// Combined Example: Simple Game
-// ============================================
-
-struct Player {
-    score: int,
-    level: int,
-    visited: string  // set ID
-}
-
-fn init_player() {
-    let visited_set = set_new();
-    let p: Player = {
-        score: 0,
-        level: 1,
-        visited: visited_set
-    };
-    
-    // Record spawn point (using set_add since visited is a string ID)
-    set_add(p.visited, "spawn");
-    
-    scoreboard_set(@s, #score, p.score);
-    scoreboard_set(@s, #level, p.level);
-}
-
-@tick(rate=20)
-fn game_tick() {
-    // Check once per second
-    for i in 0..1 {
-        let score = scoreboard_get(@s, #score);
-        if (score >= 100) {
-            title(@s, "Level Up!");
-            scoreboard_set(@s, #level, 2);
-        }
-    }
-}
-
-fn reward_player(amount: int) {
-    // Type inference + NBT params
-    let bonus = amount * 2;
-    scoreboard_add(@s, #score, bonus);
-    
-    give(@s, "minecraft:gold_ingot", amount, {
-        display: { Name: "Reward Gold" }
-    });
-}

package/src/examples/rpg.mcrs

@@ -1,13 +0,0 @@
-import "../stdlib/math.mcrs"
-import "../stdlib/combat.mcrs"
-
-fn attack(enemy: string, base: int, bonus: int) {
-    let raw_damage = weapon_damage(base, bonus);
-    let damage = clamp(raw_damage, 1, 20);
-    apply_damage(enemy, damage);
-}
-
-@tick
-fn battle_tick() {
-    attack("goblin", 4, 2);
-}

package/src/examples/stdlib_demo.mcrs

@@ -1,181 +0,0 @@
-// Stdlib pattern demo: a simple survival loop.
-//
-// This file is standalone on purpose. Since RedScript has no import system yet,
-// copy the helpers you need from src/stdlib/ into your project file.
-
-fn abs(x: int) -> int {
-    if (x < 0) {
-        return -x;
-    } else {
-        return x;
-    }
-}
-
-fn clamp(x: int, lo: int, hi: int) -> int {
-    if (x < lo) {
-        return lo;
-    } else {
-        if (x > hi) {
-            return hi;
-        } else {
-            return x;
-        }
-    }
-}
-
-fn heal(amount: int) {
-    let health: int = scoreboard_get(@p, #health);
-    let next: int = health + amount;
-    scoreboard_set(@p, #health, next);
-}
-
-fn damage(amount: int) {
-    let health: int = scoreboard_get(@p, #health);
-    let next: int = health - amount;
-
-    if (next < 0) {
-        scoreboard_set(@p, #health, 0);
-    } else {
-        scoreboard_set(@p, #health, next);
-    }
-}
-
-fn is_op() -> int {
-    let result: int = 0;
-
-    execute if entity @p[tag=op] run {
-        result = 1;
-    }
-
-    return result;
-}
-
-fn timer_start(name: string, duration: int) {
-    scoreboard_set("demo_timer_ticks", #rs, duration);
-    scoreboard_set("demo_timer_active", #rs, 1);
-}
-
-fn timer_tick(name: string) -> int {
-    let active: int = scoreboard_get("demo_timer_active", #rs);
-    let ticks: int = scoreboard_get("demo_timer_ticks", #rs);
-
-    if (active == 0) {
-        return 0;
-    }
-
-    if (ticks > 0) {
-        let next: int = ticks - 1;
-        scoreboard_set("demo_timer_ticks", #rs, next);
-
-        if (next == 0) {
-            scoreboard_set("demo_timer_active", #rs, 0);
-        }
-
-        return next;
-    }
-
-    scoreboard_set("demo_timer_active", #rs, 0);
-    return 0;
-}
-
-fn timer_done(name: string) -> int {
-    let active: int = scoreboard_get("demo_timer_active", #rs);
-    let ticks: int = scoreboard_get("demo_timer_ticks", #rs);
-
-    if (active == 0) {
-        if (ticks <= 0) {
-            return 1;
-        }
-    }
-
-    return 0;
-}
-
-fn cooldown_start(name: string, ticks: int) {
-    scoreboard_set("demo_dash_ticks", #rs, ticks);
-    scoreboard_set("demo_dash_active", #rs, 1);
-}
-
-fn cooldown_ready(name: string) -> int {
-    let active: int = scoreboard_get("demo_dash_active", #rs);
-    let ticks_left: int = scoreboard_get("demo_dash_ticks", #rs);
-
-    if (active == 0) {
-        return 1;
-    }
-
-    if (ticks_left <= 0) {
-        return 1;
-    }
-
-    return 0;
-}
-
-fn cooldown_tick(name: string) {
-    let active: int = scoreboard_get("demo_dash_active", #rs);
-    let ticks_left: int = scoreboard_get("demo_dash_ticks", #rs);
-
-    if (active == 0) {
-        return;
-    }
-
-    if (ticks_left > 0) {
-        let next: int = ticks_left - 1;
-        scoreboard_set("demo_dash_ticks", #rs, next);
-
-        if (next == 0) {
-            scoreboard_set("demo_dash_active", #rs, 0);
-        }
-    } else {
-        scoreboard_set("demo_dash_active", #rs, 0);
-    }
-}
-
-@on_trigger("arena_start")
-fn arena_start() {
-    scoreboard_set("arena_zone_center", #rs, 0);
-    scoreboard_set(@p, #health, 20);
-    timer_start("wave", 200);
-    cooldown_start("dash", 0);
-    title(@p, "Arena started");
-}
-
-@tick
-fn arena_tick() {
-    let remaining: int = timer_tick("wave");
-    cooldown_tick("dash");
-
-    if (timer_done("wave") == 1) {
-        title(@p, "Next wave");
-        timer_start("wave", 200);
-    }
-
-    let player_x: int = data_get("entity", @p, "Pos[0]");
-    let delta: int = player_x - scoreboard_get("arena_zone_center", #rs);
-    let distance: int = abs(delta);
-    let pressure: int = clamp(distance, 0, 8);
-
-    if (pressure > 4) {
-        damage(1);
-    } else {
-        heal(1);
-    }
-
-    if (remaining <= 40) {
-        tell(@p, "Wave nearly over.");
-    }
-}
-
-@on_trigger("dash")
-fn dash_trigger() {
-    if (cooldown_ready("dash") == 1) {
-        raw("effect give @p speed 1 3 true");
-        cooldown_start("dash", 80);
-    } else {
-        tell(@p, "Dash is cooling down.");
-    }
-
-    if (is_op() == 1) {
-        tell(@p, "Operator override available.");
-    }
-}