@kradle/challenges-sdk 0.12.0 → 0.13.0

package/dist/structures.js

@@ -0,0 +1,279 @@
+"use strict";
+// Structures: `@kradle/challenges-sdk/structures`. A template of blocks to place and to compare
+// against the world mirror, with rotations. Pure functions over the read-only context.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineStructure = defineStructure;
+exports.compareStructure = compareStructure;
+exports.placeStructure = placeStructure;
+exports.structureBox = structureBox;
+const errors_js_1 = require("./runtime/errors.js");
+const reducer_js_1 = require("./runtime/reducer.js");
+const AIR = "minecraft:air";
+// ---------------------------------------------------------------- the rotation table
+const FACING = { north: "east", east: "south", south: "west", west: "north" };
+/** A jigsaw's `orientation` (`north_up`, `up_east`, ...): each horizontal part turns, `up` and `down` stay. */
+const rotateOrientation = (v) => v
+    .split("_")
+    .map((part) => FACING[part] ?? part)
+    .join("_");
+const AXIS = { x: "z", z: "x", y: "y" };
+/** Rail shapes, one quarter turn clockwise. */
+const RAIL_SHAPE = {
+    north_south: "east_west",
+    east_west: "north_south",
+    ascending_north: "ascending_east",
+    ascending_east: "ascending_south",
+    ascending_south: "ascending_west",
+    ascending_west: "ascending_north",
+    north_east: "south_east",
+    south_east: "south_west",
+    south_west: "north_west",
+    north_west: "north_east",
+};
+/** Stair shapes: the left/right side swaps with each quarter turn keep their names, the direction is in `facing`. */
+const STAIR_SHAPE = new Set(["straight", "inner_left", "inner_right", "outer_left", "outer_right"]);
+/** The four side-connection properties of fences, walls, panes and redstone (`north=true`...). */
+const SIDES = ["north", "east", "south", "west"];
+const SIDE_NEXT = { north: "east", east: "south", south: "west", west: "north" };
+/** Rotates one block state a quarter turn clockwise, or throws for a property the table does not know. */
+function rotateState(spec) {
+    if (typeof spec === "string" || !spec.props)
+        return spec;
+    const out = {};
+    const pending = {};
+    for (const [k, v] of Object.entries(spec.props)) {
+        if (k === "facing") {
+            if (v === "up" || v === "down")
+                out[k] = v;
+            else if (FACING[v])
+                out[k] = FACING[v];
+            else
+                throw (0, errors_js_1.apiError)("bad_rotation", `facing=${v} cannot rotate`);
+        }
+        else if (k === "axis")
+            out[k] = AXIS[v] ?? v;
+        else if (k === "rotation")
+            out[k] = String((Number(v) + 4) % 16);
+        else if (k === "shape" && RAIL_SHAPE[v])
+            out[k] = RAIL_SHAPE[v];
+        else if (k === "shape" && STAIR_SHAPE.has(v))
+            out[k] = v;
+        else if (k === "orientation")
+            out[k] = rotateOrientation(v);
+        else if (SIDES.includes(k))
+            pending[SIDE_NEXT[k]] = v;
+        else
+            out[k] = v;
+    }
+    return {
+        id: spec.id,
+        props: { ...out, ...pending },
+        ...(spec.blockEntity !== undefined ? { blockEntity: spec.blockEntity } : {}),
+    };
+}
+function rotateMatch(match, times) {
+    if (match === undefined || typeof match === "function")
+        return match;
+    let spec = typeof match === "string" ? match : match.props ? { id: match.id, props: match.props } : { id: match.id };
+    for (let i = 0; i < times; i++)
+        spec = rotateState(spec);
+    return typeof spec === "string" ? spec : spec.props ? { id: spec.id, props: spec.props } : { id: spec.id };
+}
+/** The directional properties the table knows; anything else with a direction is refused at definition. */
+const KNOWN = new Set(["facing", "axis", "rotation", "shape", "orientation", ...SIDES]);
+const DIRECTIONAL_VALUES = new Set(["north", "east", "south", "west"]);
+function assertRotatable(spec, symbol) {
+    if (typeof spec === "string" || !spec.props)
+        return;
+    for (const [k, v] of Object.entries(spec.props)) {
+        if (KNOWN.has(k))
+            continue;
+        if (DIRECTIONAL_VALUES.has(v)) {
+            throw (0, errors_js_1.definitionError)("bad_rotation", `palette "${symbol}": the property ${k}=${v} is directional and the rotation table does not know it`, {
+                path: `palette.${symbol}`,
+                value: k,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------- define, compare, place
+/** A block state string (`minecraft:oak_stairs[facing=east]`) as `{ id, props }`, so its properties rotate and match one by one. */
+function normalizeSpec(spec) {
+    if (typeof spec !== "string" || !spec.includes("["))
+        return spec;
+    const { id, props } = (0, reducer_js_1.parseBlockState)(spec);
+    return { id, props: { ...props } };
+}
+/** The same for a match: a state string becomes a property match; a function stays. */
+function normalizeMatch(match) {
+    if (typeof match === "function" || typeof match !== "string" || !match.includes("["))
+        return match;
+    const { id, props } = (0, reducer_js_1.parseBlockState)(match);
+    return { id, props: { ...props } };
+}
+/**
+ * Builds a structure from text layers and a palette. Throws a definition error on an unknown symbol or a
+ * ragged layer. A block state string in the palette is read as `{ id, props }`: its properties rotate with
+ * the structure, and a cell matches when the block has those properties (more properties are fine).
+ */
+function defineStructure(decl) {
+    const air = decl.air ?? ".";
+    const ignore = decl.ignore ?? "?";
+    const cells = [];
+    let sx = 0;
+    let sz = 0;
+    decl.layers.forEach((layer, y) => {
+        layer.forEach((row, z) => {
+            if (layer[0] !== undefined && row.length !== layer[0].length) {
+                throw (0, errors_js_1.definitionError)("bad_layer", `layers[${y}]: every row needs the same length`, { path: `layers.${y}` });
+            }
+            sz = Math.max(sz, layer.length);
+            sx = Math.max(sx, row.length);
+            [...row].forEach((symbol, x) => {
+                if (symbol === ignore)
+                    return;
+                if (symbol === air) {
+                    cells.push({ x, y, z, place: AIR, match: undefined });
+                    return;
+                }
+                const entry = decl.palette[symbol];
+                if (!entry) {
+                    throw (0, errors_js_1.definitionError)("bad_symbol", `layers[${y}][${z}]: the symbol "${symbol}" is not in the palette`, {
+                        path: `layers.${y}.${z}`,
+                        value: symbol,
+                        allowed: Object.keys(decl.palette),
+                    });
+                }
+                const placeSpec = normalizeSpec(entry.place);
+                const match = entry.match !== undefined
+                    ? normalizeMatch(entry.match)
+                    : typeof placeSpec === "string"
+                        ? placeSpec
+                        : placeSpec.props
+                            ? { id: placeSpec.id, props: placeSpec.props }
+                            : { id: placeSpec.id };
+                if (decl.rotations) {
+                    assertRotatable(placeSpec, symbol);
+                    if (typeof match !== "function")
+                        assertRotatable(match, symbol);
+                }
+                cells.push({ x, y, z, place: placeSpec, match });
+            });
+        });
+    });
+    return { cells, size: { x: sx, y: decl.layers.length, z: sz }, rotations: decl.rotations === true };
+}
+/** A structure cell's world position for a rotation (clockwise seen from above); the rotated footprint keeps its minimum corner at `origin`. */
+function place(cell, origin, rotation, size) {
+    const ox = Math.floor(origin.x);
+    const oy = Math.floor(origin.y);
+    const oz = Math.floor(origin.z);
+    let x = cell.x;
+    let z = cell.z;
+    const w = size.x - 1;
+    const d = size.z - 1;
+    if (rotation === 90)
+        [x, z] = [d - z, cell.x];
+    else if (rotation === 180)
+        [x, z] = [w - cell.x, d - z];
+    else if (rotation === 270)
+        [x, z] = [z, w - cell.x];
+    return { x: ox + x, y: oy + cell.y, z: oz + z };
+}
+function matches(actual, match) {
+    if (match === undefined)
+        return actual.id === AIR;
+    if (typeof match === "function")
+        return match(actual);
+    if (typeof match === "string") {
+        const i = match.indexOf("[");
+        if (i < 0)
+            return actual.id === match;
+        return blockString(actual) === match;
+    }
+    if (actual.id !== match.id)
+        return false;
+    return Object.entries(match.props ?? {}).every(([k, v]) => actual.props[k] === v);
+}
+function blockString(state) {
+    const entries = Object.entries(state.props);
+    if (entries.length === 0)
+        return state.id;
+    return `${state.id}[${entries.map(([k, v]) => `${k}=${v}`).join(",")}]`;
+}
+function compareAt(g, s, origin, rotation) {
+    const turns = rotation / 90;
+    const mismatched = [];
+    const unknown = [];
+    let matched = 0;
+    for (const cell of s.cells) {
+        const at = place(cell, origin, rotation, s.size);
+        const actual = g.blockStateAt(at);
+        if (actual === undefined) {
+            unknown.push(at);
+            continue;
+        }
+        const match = rotateMatch(cell.match, turns);
+        if (matches(actual, match))
+            matched += 1;
+        else
+            mismatched.push({ ...at, expected: match ?? "air", actual });
+    }
+    return { complete: mismatched.length === 0 && unknown.length === 0, matched, mismatched, unknown, rotation };
+}
+/**
+ * Compares the structure with the world at `origin`. `rotation: "any"` tries 0, 90, 180 and 270 in that
+ * order and returns the first complete report, else the one with the fewest mismatches (the lowest angle on
+ * a tie). Unknown cells (an unloaded chunk) are reported, never counted as mismatches.
+ */
+function compareStructure(g, s, origin, opts = {}) {
+    const rotation = opts.rotation ?? 0;
+    if (rotation !== 0 && !s.rotations) {
+        throw (0, errors_js_1.apiError)("bad_rotation", "compareStructure: the structure was defined without rotations");
+    }
+    if (rotation !== "any")
+        return compareAt(g, s, origin, rotation);
+    let best;
+    for (const r of [0, 90, 180, 270]) {
+        const report = compareAt(g, s, origin, r);
+        if (report.complete)
+            return report;
+        if (!best || report.mismatched.length < best.mismatched.length)
+            best = report;
+    }
+    return best;
+}
+/** Queues one `setBlock` per cell of the structure at `origin`, with the rotation. Ignored cells are left alone. */
+function placeStructure(g, s, origin, opts = {}) {
+    const rotation = opts.rotation ?? 0;
+    if (rotation !== 0 && !s.rotations) {
+        throw (0, errors_js_1.apiError)("bad_rotation", "placeStructure: the structure was defined without rotations");
+    }
+    const turns = rotation / 90;
+    for (const cell of s.cells) {
+        let spec = cell.place;
+        for (let i = 0; i < turns; i++)
+            spec = rotateState(spec);
+        g.setBlock(place(cell, origin, rotation, s.size), spec);
+    }
+}
+/** The world positions of the structure's cells at `origin`, for a bounding box or a zone. */
+function structureBox(s, origin, rotation = 0) {
+    const corners = [
+        place({ x: 0, y: 0, z: 0 }, origin, rotation, s.size),
+        place({ x: s.size.x - 1, y: s.size.y - 1, z: s.size.z - 1 }, origin, rotation, s.size),
+    ];
+    return {
+        from: {
+            x: Math.min(corners[0].x, corners[1].x),
+            y: Math.min(corners[0].y, corners[1].y),
+            z: Math.min(corners[0].z, corners[1].z),
+        },
+        to: {
+            x: Math.max(corners[0].x, corners[1].x),
+            y: Math.max(corners[0].y, corners[1].y),
+            z: Math.max(corners[0].z, corners[1].z),
+        },
+    };
+}
+//# sourceMappingURL=structures.js.map

package/dist/structures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structures.js","sourceRoot":"","sources":["../src/structures.ts"],"names":[],"mappings":"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"}

package/dist/test/harness.d.ts

@@ -1,6 +1,10 @@
-import { type Action, type GameMode, type AnyChallenge, type Block, type Box, type Capability, type Duration, type Effect, type EntityType, type Event, type Json, type Marker, type PlayerSample, type Vec3 } from "../runtime/sdk.js";
-/** The state type of a challenge, as `init()` returns it. */
-export type StateOf<Ch extends AnyChallenge> = ReturnType<Ch["init"]>;
+import type { AnyChallenge } from "../runtime/builder.js";
+import type { State } from "../runtime/reducer.js";
+import { type Duration } from "../runtime/time.js";
+import type { DeepReadonly } from "../runtime/types.js";
+import { type Action, type BlockId, type Box, type Capability, type Effect, type EntityTypeId, type Event, type GameMode, type ItemId, type Json, type Marker, type PlayerSample, type SlotChange, type Vec3 } from "../runtime/wire.js";
+/** The full reducer state, as a test reads it. */
+export type ReducerState = DeepReadonly<State>;
 /** JSON with sorted keys, so key order never counts as a difference. */
 export declare const canonical: (v: unknown) => string;
 /**
@@ -15,61 +19,115 @@ export declare const canonical: (v: unknown) => string;
 export declare function sandboxed<Ch extends AnyChallenge>(challenge: Ch): Promise<Ch>;
 /** A roster entry: the role, or the role with the player's position and sample fields before the first tick. */
 export type RosterEntry = string | ({
+    /** The role id. */
     role: string;
+    /** Where the player stands at `begin`; `defaultPosition(i)` without it. */
     at?: Vec3;
 } & Partial<Omit<PlayerSample, "name" | "participant" | "pos">>);
+/** Where `begin` puts a participant without an `at`: a row along x, two blocks apart. */
+export declare const defaultPosition: (index: number) => Vec3;
+/** A fake engine around one challenge: feeds events, keeps the state, records the actions. */
 export declare class Game<Ch extends AnyChallenge> {
     readonly challenge: Ch;
-    state: StateOf<Ch>;
+    /** The whole reducer state: the SDK's fields, the players, the votes, the mirror. */
+    reducerState: State;
+    /** Every event dispatched so far. */
     log: Event[];
+    /** Every action returned so far. */
     actions: Action[];
+    /** The actions of the last dispatch. */
     last: Action[];
-    /** The harness's tick step, a test setting: server ticks arrive in steps of 4 here (the arena sends every 2 ticks by default). */
+    /** The harness's tick step, a test setting. The arena sends every server tick, so the default is 1. */
     step: number;
     private attempts;
     /** The state this game started from: `init()`, or the checkpoint of `resume`. `replay` starts here. */
     private readonly origin;
     /** Inventory slots the fake players used, per player and item, for this game only. */
     private readonly slots;
-    constructor(challenge: Ch, state?: StateOf<Ch>);
+    constructor(challenge: Ch, state?: State);
+    /** The shared challenge data (`g.state` in a rule). */
+    get state(): Record<string, unknown>;
+    /** The current phase; `null` before the first entry and without phases. */
+    get phase(): string | null;
+    /** The run's stage. */
+    get status(): State["status"];
+    /** One participant's reducer record: observations, `state`, `score`. */
+    participant(name: string): State["players"][string];
+    /** One reduction. Asserts that `reduce` did not mutate its input. */
     dispatch(event: Event): Action[];
     /** Ticks in steps of `step`, and lands exactly on `serverTick` (the last step is shorter when needed). */
     tickTo(serverTick: number): void;
+    /** Advances `n` engine steps of `step` ticks each. */
     tick(n?: number): void;
     /** Advance by a duration: "35s", "2m", or ticks. */
     after(d: Duration | number): void;
     /** Advance until `d` after game start. */
     at(d: Duration | number): void;
     /**
-     * run_started, every join, the first tick, and the setup confirmation when the
-     * challenge has a setup. A roster entry is a role (`{ alice: "climber" }`), or the
-     * role with the player's position and sample fields (`{ alice: { role: "climber",
-     * at: { x: 0, y: -60, z: 0 } } }`): the first tick then carries that sample, so
-     * `start` and the setup see the position, as they do in the arena. Without `at`
-     * the position stays null until the first `moveTo`.
+     * run_started, every join, the first tick with every participant's position, and the setup
+     * confirmations when the challenge has a setup. A roster entry is a role (`{ alice: "climber" }`),
+     * or the role with the player's position and sample fields (`{ alice: { role: "climber",
+     * at: { x: 0, y: -60, z: 0 } } }`). Without `at` a participant gets `defaultPosition(i)`, so the
+     * initializers and `start` see a position, as they do in the arena. `positions: false` sends no
+     * sample: the run stays in CONNECTING until a test moves every player.
      */
     begin(seed: number, participants: Record<string, RosterEntry>, opts?: {
+        /** The run's parameter values over the declared defaults. */
         params?: Record<string, Json>;
+        /** What the engine supplies; every capability without it. */
         capabilities?: Capability[];
+        /** `false`: the first setup batch fails. */
         setupOk?: boolean;
+        /** `false`: no position sample; the run stays in CONNECTING until a test moves every player. */
+        positions?: boolean;
+        /** The coordinates of the declared locations, by name. */
         locations?: Record<string, Vec3>;
+        /** The tagged entities the engine read before the game. */
         markers?: Marker[];
     }): this;
+    /** Answers every pending setup batch in order (each confirmation may send the next one), from the reducer state. */
+    confirmSetup(ok?: boolean): void;
+    /** Answers a named batch (`g.batch(name, ...)`): the engine ran it, with the failed effects listed. */
+    batchResult(name: string, ok: boolean, failed?: Array<{
+        /** The effect's index in the batch. */
+        index: number;
+        /** Why it failed. */
+        detail: string;
+    }>): void;
+    /** A scripted participant. */
     player(name: string): Fake<Ch>;
+    /** A custom server event, with its JSON data. */
     custom(name: string, data: Json, player?: string): Action[];
     /** Loads the chunks that cover `box` into the mirror: `block` inside the box, air around it. */
-    terrain(box: Box, block: Block, minY?: number, height?: number): Action[];
+    terrain(box: Box, block: BlockId, minY?: number, height?: number): Action[];
+    /** Loads an all-air chunk column at chunk coordinates (`cx`, `cz`). */
+    loadChunk(cx: number, cz: number, minY?: number): Action[];
+    /** The engine unloaded a chunk: its blocks and containers leave the mirror. */
+    unloadChunk(cx: number, cz: number): Action[];
     /** Blocks changed on the server, by anyone or anything. */
     setBlocks(changes: Array<Vec3 & {
-        block: Block;
+        /** The block state now. */
+        block: BlockId;
+        /** The player who did it, when one did. */
         by?: string;
+        /** What changed it (break, place, fill, ...). */
+        cause?: string;
     }>): Action[];
-    spawnEntity(id: string, type: EntityType, at: Vec3, extra?: Partial<Omit<Extract<Event, {
+    /** The engine filled a box (the plugin's own fill). */
+    fillBlocks(from: Vec3, to: Vec3, block: BlockId): Action[];
+    /** A non-player entity appeared. */
+    spawnEntity(id: string, type: EntityTypeId, at: Vec3, extra?: Partial<Omit<Extract<Event, {
         type: "entity_spawned";
     }>, "type" | "id" | "entity" | "at">>): Action[];
+    /** An entity's reported fields changed. */
+    changeEntity(id: string, fields: Omit<Extract<Event, {
+        type: "entity_changed";
+    }>, "type" | "id">): Action[];
     /** Entities moved: they arrive with the next tick, so this advances one engine step. */
     moveEntities(moves: Array<{
+        /** The entity id. */
         id: string;
+        /** The new position. */
         pos: Vec3;
     }>): Action[];
     /**
@@ -78,33 +136,51 @@ export declare class Game<Ch extends AnyChallenge> {
      * A handler that reads another player's position sees this tick for everyone.
      */
     sample(players: Array<{
+        /** The player's name. */
         name: string;
     } & Partial<Omit<PlayerSample, "name" | "participant">>>, entities?: Array<{
+        /** The entity id. */
         id: string;
+        /** The new position. */
         pos: Vec3;
     }>): Action[];
+    /** An entity left the world. */
     removeEntity(id: string, cause?: "died" | "removed", killer?: string): Action[];
     /**
-     * The contents of a declared container, as the engine reports them: `items` is the whole
-     * content (item to count), laid out one item per slot. `by` names the player who had it open;
-     * `initial` marks the first snapshot (no handler fires for it).
+     * A container's contents as the engine reports them: `items` is the whole content (item id to
+     * count), one item per slot. `by` names the player who moved the items when the engine is certain;
+     * `initial` marks the first snapshot (no handler fires); `removed` reports the block gone.
      */
     container(at: Vec3, items: Record<string, number>, opts?: {
+        /** The player who moved the items, when the engine is certain. */
         by?: string;
-        block?: Block;
+        /** The container block; a chest by default. */
+        block?: BlockId;
+        /** `true`: the first snapshot of the container. */
         initial?: boolean;
+        /** `true`: the container block is gone. */
+        removed?: boolean;
     }): Action[];
     /** A game mode change reported by the engine (the `gamemode` event). */
     setGamemode(name: string, gamemode: GameMode): Action[];
     /** A non-participant player's sample (the watcher, a spectator), with the next tick. */
     other(name: string, sample: Omit<PlayerSample, "name" | "participant">): Action[];
+    /** The engine refused one effect. */
+    effectFailed(kind: string, detail: string, effect?: Effect, batch?: {
+        /** The batch's transport id (`batch:<n>`). */
+        id: string;
+        /** The effect's position in the batch. */
+        index: number;
+    }): Action[];
     /**
      * The engine's answer to a walk: the last one requested, or the last one for
      * `player` (or with `id`) when several are in flight. A walk that was already
      * answered is skipped.
      */
     walkResult(ok: boolean, detail?: string, which?: {
+        /** The walk of this player. */
         player?: string;
+        /** The walk with this request id. */
         id?: string;
     }): void;
     /** Actions of the last reduction, by type. */
@@ -127,6 +203,16 @@ export declare class Game<Ch extends AnyChallenge> {
     announcements(to?: string): string[];
     /** Every announcement of the run, public and private. */
     said(): string[];
+    /** The `game_over` action, once the game ended. */
+    result(): Extract<Action, {
+        type: "game_over";
+    }> | undefined;
+    /** Every log line of the run. */
+    logs(): Extract<Action, {
+        type: "log";
+    }>[];
+    /** The last value of every metric, global (`""` player key) and per player. */
+    metrics(): Record<string, Record<string, number>>;
     /**
      * The same log through the same reducer instance, from the state this game
      * started with (`init()`, or the checkpoint of `resume`), gives the same final
@@ -135,8 +221,11 @@ export declare class Game<Ch extends AnyChallenge> {
      * provides. A test calls it; `dispatch` does not.
      */
     replay(): void;
+    /** The state as a JSON string; `Game.resume` continues from it. */
     checkpoint(): string;
+    /** A game that continues from a checkpoint, as the arena does after a worker restart. */
     static resume<Ch extends AnyChallenge>(challenge: Ch, json: string): Game<Ch>;
+    /** A fresh attempt id for a vote or give request. */
     nextAttempt(): string;
     /** The slot a fake player's item occupies: the one the state shows, else the next free one, for this game only. */
     slotFor(name: string, item: string): number;
@@ -146,31 +235,46 @@ export declare class Fake<Ch extends AnyChallenge> {
     private readonly g;
     readonly name: string;
     constructor(g: Game<Ch>, name: string);
+    /** One position sample, as one server tick would carry it. */
     moveTo(to: Partial<Vec3> & {
+        /** The height; `x` and `z` keep the last sample's values without them. */
         y: number;
-    }, extrema?: {
-        maxY?: number;
-        minY?: number;
     }): Action[];
-    vote(voteId: string, option: string): {
+    /** A vote request, as the arena forwards it. `round` stamps the round the arena saw; default: the current one. */
+    vote(voteId: string, option: string, round?: number): {
+        /** Whether the reducer accepted the vote. */
         accepted: boolean;
+        /** The reducer's feedback to the voter, on a refusal. */
         feedback?: string | undefined;
     };
+    /** A public chat line. */
     says(text: string): Action[];
+    /** An arm swing: a mining or attack attempt. */
     swings(animation?: "swing" | "swing_off"): Action[];
+    /** Damage taken; `attacker` names another participant. */
     hurt(amount: number, cause: string, attacker?: string): Action[];
+    /** A death; `killer` names another participant. */
     dies(cause?: string, killer?: string): Action[];
+    /** A respawn after a death. */
     respawns(): Action[];
-    picksUp(item: `minecraft:${string}`, count?: number, at?: Vec3): Action[];
+    /** The player connected. */
+    joins(): Action[];
+    /** The player disconnected. */
+    leaves(): Action[];
+    /** An item picked up from the ground. */
+    picksUp(item: ItemId, count?: number, at?: Vec3): Action[];
     /** The player's inventory now holds `count` of `item`: one slot per item name, in this game. */
-    has(item: `minecraft:${string}`, count: number): Action[];
+    setInventory(item: ItemId, count: number, meta?: Omit<SlotChange, "slot" | "item" | "count">): Action[];
     /** Walks into the declared zone (its first corner); the SDK derives the edge. */
     enters(zone: string): Action[];
     /** Walks 100 blocks under the declared zone's first corner. */
-    leaves(zone: string): Action[];
-    uses(block: `minecraft:${string}`, at: Vec3, item?: `minecraft:${string}`): Action[];
-    breaks(block: `minecraft:${string}`, at: Vec3): Action[];
-    places(block: `minecraft:${string}`, at: Vec3): Action[];
+    exits(zone: string): Action[];
+    /** A right-click on a block; `item` is what the hand held. */
+    uses(block: BlockId, at: Vec3, item?: ItemId): Action[];
+    /** Breaks the block: the engine reports the state that was there and what is there now (air by default). */
+    breaks(block: BlockId, at: Vec3, after?: BlockId): Action[];
+    /** Places the block: the engine reports the placed state and the one it replaced (air by default). */
+    places(block: BlockId, at: Vec3, replaced?: BlockId): Action[];
     private zone;
 }
 //# sourceMappingURL=harness.d.ts.map

package/dist/test/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/test/harness.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/test/harness.ts"],"names":[],"mappings":"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"}