@kradle/challenges-sdk 0.22.0 → 0.24.0

package/dist/runtime/world.d.ts

@@ -1,4 +1,5 @@
-import type { BlockId as Block, Box, EntityTypeId as EntityType, GameMode, ItemId as Item, ItemMeta, PlayerStatus, Vec3 } from "./wire.js";
+import { type Dimension } from "./dimensions.js";
+import type { BlockId as Block, Box, EntityTypeId as EntityType, GameMode, ItemId as Item, ItemMeta, Json, PlayerStatus, Vec3 } from "./wire.js";
 /** The air block id. */
 export declare const AIR: Block;
 /** The id part of a block state string: `minecraft:oak_fence[north=true]` -> `minecraft:oak_fence`. */
@@ -35,6 +36,8 @@ export declare function applyEquipment(prev: Equipment | undefined, changes: rea
 /** A 16x16x16 section: one palette index for a uniform section, or 4096 of them (y, then z, then x). */
 export type Section = number | number[];
 export interface Chunk {
+    /** The dimension of this chunk. Absent means minecraft:overworld. */
+    dimension?: Dimension | undefined;
     x: number;
     z: number;
     /** The lowest block Y of the world (-64 in 1.20). */
@@ -54,6 +57,13 @@ export interface Entity {
     tags: string[];
     /** The custom name, when one is set. */
     name?: string | undefined;
+    /**
+     * The saved NBT, as `/data get entity` shows it: `data` holds a marker's data, `Health` a mob's health.
+     * A number has no type suffix, and a byte boolean is `0` or `1`. It leaves out the keys that the other
+     * fields carry (position, motion, rotation, uuid, custom name, tags, fire, air, passengers, effects, absorption).
+     * `undefined` until the server reports it.
+     */
+    nbt?: Readonly<Record<string, Json>> | undefined;
     /** Half-hearts, for a living entity. */
     health?: number | undefined;
     /** Dropped items: what lies there. */
@@ -143,15 +153,21 @@ export interface WorldState {
     palette: Block[];
     /** The world time of day, 0..24000, as last reported. */
     time: number;
-    /** By "cx,cz". */
+    /** Time of day by dimension. */
+    times?: Partial<Record<Dimension, number>> | undefined;
+    /** By "[<dimension>|]cx,cz"; the Overworld has no prefix. */
     chunks: Record<string, Chunk>;
     /** The non-player entities, by id. */
     entities: Record<string, Entity>;
     /** The online players who are not participants, by name. */
     others: Record<string, OtherPlayer>;
+    /** The saved NBT of the block entities, by "[<dimension>|]x,y,z"; the Overworld has no prefix. */
+    blockNbt: Record<string, Readonly<Record<string, Json>>>;
 }
 /** What the engine sends for one chunk: sections with a local palette; absent sections are air. */
 export interface ChunkMessage {
+    /** The dimension of this chunk. Absent means minecraft:overworld. */
+    dimension?: Dimension | undefined;
     /** The chunk x, in chunks (the block x divided by 16, floored). */
     x: number;
     /** The chunk z, in chunks. */
@@ -178,7 +194,7 @@ export interface ChunkMessage {
     }>;
 }
 export declare const emptyWorld: () => WorldState;
-export declare const chunkKey: (x: number, z: number) => string;
+export declare const chunkKey: (x: number, z: number, dimension?: Dimension) => string;
 /** Block coordinates of a box, both corners inclusive, ordered. */
 export declare function bounds(box: Box): {
     /** The smallest x, y and z. */
@@ -189,7 +205,7 @@ export declare function bounds(box: Box): {
 /** True when the block at `pos` (feet for a player) is inside `box`. */
 export declare function inBox(pos: Vec3, box: Box): boolean;
 export declare function applyChunk(w: WorldState, msg: ChunkMessage): WorldState;
-export declare function removeChunk(w: WorldState, x: number, z: number): WorldState;
+export declare function removeChunk(w: WorldState, x: number, z: number, dimension?: Dimension): WorldState;
 /** The full block state at `at` (`minecraft:oak_fence[north=true,...]`); undefined outside the loaded chunks. */
 export declare function blockStateAt(w: WorldState, at: Vec3): Block | undefined;
 /** The block id at `at`, without its state properties. */
@@ -231,6 +247,8 @@ export type EntityMove = {
 export declare function moveEntities(w: WorldState, moves: ReadonlyArray<EntityMove>): WorldState;
 /** Which entities `g.entities` returns; every field narrows the result. */
 export interface EntityFilter {
+    /** Only entities in this dimension. Absent includes all enabled dimensions. */
+    dimension?: Dimension | undefined;
     /** Only the entities whose position is inside the box. */
     box?: Box | undefined;
     /** Only the entities of this type. */
@@ -241,4 +259,69 @@ export interface EntityFilter {
 export declare function entitiesIn(w: WorldState, f?: EntityFilter): Entity[];
 export declare function putOther(w: WorldState, p: OtherPlayer): WorldState;
 export declare function removeOther(w: WorldState, name: string): WorldState;
+/**
+ * The NBT that changed on one server tick. The first sight of an entity or a block entity holds every key.
+ * After that, `nbt` is a delta: an object holds the changed keys, recursively, and null removes a key; a
+ * list patch `{"@len": n, "<index>": delta}` holds the changed entries of a list with n entries; any other
+ * value replaces the old one. A block entity that is gone has `nbt: null`.
+ */
+export interface NbtMessage {
+    /** The entities whose NBT changed. */
+    entities?: ReadonlyArray<{
+        id: string;
+        nbt: Record<string, Json>;
+    }> | undefined;
+    /** The block entities whose NBT changed or that are gone. */
+    blocks?: ReadonlyArray<{
+        pos: Vec3;
+        nbt: Record<string, Json> | null;
+    }> | undefined;
+}
+/** The key of a list patch that holds the list's new length. */
+export declare const NBT_LIST_LEN = "@len";
+type JsonObject = {
+    [key: string]: Json;
+};
+/** A compound delta applied to a compound (or to nothing, on the first sight). */
+export declare function mergeNbt(prev: Readonly<JsonObject> | undefined, d: Readonly<JsonObject>): Readonly<JsonObject>;
+/** The delta from `prev` to `cur`, as the engine computes it; `undefined` when they are equal. */
+export declare function nbtDelta(prev: Readonly<JsonObject>, cur: Readonly<JsonObject>): JsonObject | undefined;
+/** One entity whose NBT an `nbt` message changed: the entity before, and the delta. */
+export interface NbtEntityChange {
+    id: string;
+    was: Entity;
+    delta: Readonly<JsonObject>;
+}
+/** One block entity whose NBT an `nbt` message changed: the NBT before, and the delta (`null`: the block entity is gone). */
+export interface NbtBlockChange {
+    at: Vec3;
+    was: Readonly<JsonObject> | undefined;
+    delta: Readonly<JsonObject> | null;
+}
+/** The world after one `nbt` message, and what changed. Unknown entities and blocks outside the loaded chunks are ignored. */
+export declare function applyNbt(w: WorldState, m: NbtMessage): {
+    world: WorldState;
+    entities: NbtEntityChange[];
+    blocks: NbtBlockChange[];
+};
+/**
+ * The paths of the leaves that a delta changes, from the value before it: `nbt.data.score`, `nbt.Items[3].count`.
+ * A replaced or new value, a removed key and a removed list entry give their own path. `base` is the path of the
+ * value itself: the first sight of a value gives `base` alone.
+ */
+export declare function nbtPaths(prev: Json | undefined, d: Json, base: string, out?: string[]): string[];
+/** The names of the top-level fields that differ between two observations of an entity. */
+export declare function changedFields(was: object, now: object): string[];
+/**
+ * The value at a change path (`"nbt.Items[3].count"`, `'nbt["Paper.Delay"]'`), or `undefined` when nothing is there.
+ * Read from the object that the path starts at: the entity for `entityChanged`, the NBT for `blockNbtChanged`.
+ * The path `""` is the object itself.
+ */
+export declare function valueAt(root: unknown, path: string): unknown;
+/**
+ * Whether a change touches the value at `path`: a changed path is `path`, under it (`nbt.data.score` for `nbt.data`),
+ * or above it (`nbt` on the first sight, for `nbt.data`). A prefix test alone would match `nbt.dataX` too.
+ */
+export declare function changedUnder(changed: readonly string[], path: string): boolean;
+export {};
 //# sourceMappingURL=world.d.ts.map

package/dist/runtime/world.d.ts.map

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

package/dist/runtime/world.js

@@ -1,11 +1,6 @@
 "use strict";
-// The world mirror: the loaded chunks, the entities and the other players, as
-// the engine streams them. It lives in the challenge state, but every update
-// copies only the containers it touches (a section, the entity map), so a
-// reduction shares the rest with the state before it. Nothing here mutates
-// in place; the reducer treats the mirror as a value.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIR_STATES = exports.chunkKey = exports.emptyWorld = exports.MAX_SECTIONS = exports.AIR = void 0;
+exports.NBT_LIST_LEN = exports.AIR_STATES = exports.chunkKey = exports.emptyWorld = exports.MAX_SECTIONS = exports.AIR = void 0;
 exports.blockIdOf = blockIdOf;
 exports.freezeObservation = freezeObservation;
 exports.applyEquipment = applyEquipment;
@@ -27,6 +22,15 @@ exports.moveEntities = moveEntities;
 exports.entitiesIn = entitiesIn;
 exports.putOther = putOther;
 exports.removeOther = removeOther;
+exports.mergeNbt = mergeNbt;
+exports.nbtDelta = nbtDelta;
+exports.applyNbt = applyNbt;
+exports.nbtPaths = nbtPaths;
+exports.changedFields = changedFields;
+exports.valueAt = valueAt;
+exports.changedUnder = changedUnder;
+const dimensions_js_1 = require("./dimensions.js");
+const errors_js_1 = require("./errors.js");
 /** The air block id. */
 exports.AIR = "minecraft:air";
 /** The id part of a block state string: `minecraft:oak_fence[north=true]` -> `minecraft:oak_fence`. */
@@ -80,20 +84,32 @@ function applyEquipment(prev, changes) {
     }
     return next;
 }
-const emptyWorld = () => ({ palette: [exports.AIR], time: 0, chunks: {}, entities: {}, others: {} });
+const emptyWorld = () => ({
+    palette: [exports.AIR],
+    time: 0,
+    chunks: {},
+    entities: {},
+    others: {},
+    blockNbt: {},
+});
 exports.emptyWorld = emptyWorld;
-const chunkKey = (x, z) => `${x},${z}`;
+const chunkKey = (x, z, dimension) => `${(0, dimensions_js_1.dimensionPrefix)(dimension)}${x},${z}`;
 exports.chunkKey = chunkKey;
 const sectionIndex = (x, y, z) => ((y & 15) << 8) | ((z & 15) << 4) | (x & 15);
 /** Block coordinates of a box, both corners inclusive, ordered. */
 function bounds(box) {
+    if ((0, dimensions_js_1.dimensionOf)(box.from) !== (0, dimensions_js_1.dimensionOf)(box.to))
+        throw (0, errors_js_1.apiError)("invalid_value", "A box cannot cross dimensions", { path: "box", value: box });
+    const scope = box.from.dimension ? { dimension: box.from.dimension } : {};
     return {
         lo: {
+            ...scope,
             x: Math.floor(Math.min(box.from.x, box.to.x)),
             y: Math.floor(Math.min(box.from.y, box.to.y)),
             z: Math.floor(Math.min(box.from.z, box.to.z)),
         },
         hi: {
+            ...scope,
             x: Math.floor(Math.max(box.from.x, box.to.x)),
             y: Math.floor(Math.max(box.from.y, box.to.y)),
             z: Math.floor(Math.max(box.from.z, box.to.z)),
@@ -103,6 +119,8 @@ function bounds(box) {
 /** True when the block at `pos` (feet for a player) is inside `box`. */
 function inBox(pos, box) {
     const { lo, hi } = bounds(box);
+    if ((0, dimensions_js_1.dimensionOf)(pos) !== (0, dimensions_js_1.dimensionOf)(lo))
+        return false;
     const x = Math.floor(pos.x);
     const y = Math.floor(pos.y);
     const z = Math.floor(pos.z);
@@ -119,7 +137,7 @@ function intern(palette, block) {
 // ---------------------------------------------------------------- chunks
 function applyChunk(w, msg) {
     let palette = w.palette;
-    const count = Math.max(w.chunks[(0, exports.chunkKey)(msg.x, msg.z)]?.sections.length ?? 0, ...msg.sections.map((s) => ((s.y - msg.minY) >> 4) + 1));
+    const count = Math.max(w.chunks[(0, exports.chunkKey)(msg.x, msg.z, msg.dimension)]?.sections.length ?? 0, ...msg.sections.map((s) => ((s.y - msg.minY) >> 4) + 1));
     const sections = new Array(Math.max(count, 0)).fill(0);
     for (const s of msg.sections) {
         const sy = (s.y - msg.minY) >> 4;
@@ -144,23 +162,40 @@ function applyChunk(w, msg) {
     return {
         ...w,
         palette,
-        chunks: { ...w.chunks, [(0, exports.chunkKey)(msg.x, msg.z)]: { x: msg.x, z: msg.z, minY: msg.minY, sections } },
+        chunks: {
+            ...w.chunks,
+            [(0, exports.chunkKey)(msg.x, msg.z, msg.dimension)]: {
+                ...(msg.dimension ? { dimension: msg.dimension } : {}),
+                x: msg.x,
+                z: msg.z,
+                minY: msg.minY,
+                sections,
+            },
+        },
     };
 }
-function removeChunk(w, x, z) {
-    const key = (0, exports.chunkKey)(x, z);
+function removeChunk(w, x, z, dimension) {
+    const key = (0, exports.chunkKey)(x, z, dimension);
     if (!(key in w.chunks))
         return w;
     const chunks = { ...w.chunks };
     delete chunks[key];
-    return { ...w, chunks };
+    let blockNbt = w.blockNbt;
+    for (const k of Object.keys(blockNbt)) {
+        if (!(0, dimensions_js_1.keyInChunk)(k, x, z, dimension))
+            continue;
+        if (blockNbt === w.blockNbt)
+            blockNbt = { ...blockNbt };
+        delete blockNbt[k];
+    }
+    return { ...w, chunks, blockNbt };
 }
 /** The full block state at `at` (`minecraft:oak_fence[north=true,...]`); undefined outside the loaded chunks. */
 function blockStateAt(w, at) {
     const x = Math.floor(at.x);
     const y = Math.floor(at.y);
     const z = Math.floor(at.z);
-    const chunk = w.chunks[(0, exports.chunkKey)(x >> 4, z >> 4)];
+    const chunk = w.chunks[(0, exports.chunkKey)(x >> 4, z >> 4, at.dimension)];
     if (!chunk)
         return undefined;
     const sy = (y - chunk.minY) >> 4;
@@ -187,7 +222,7 @@ function setBlocks(w, changes) {
         const x = Math.floor(c.x);
         const y = Math.floor(c.y);
         const z = Math.floor(c.z);
-        const key = (0, exports.chunkKey)(x >> 4, z >> 4);
+        const key = (0, exports.chunkKey)(x >> 4, z >> 4, c.dimension);
         let chunk = touched.get(key);
         if (!chunk) {
             const base = w.chunks[key];
@@ -242,7 +277,7 @@ function fillBlocks(w, box, block) {
     for (let x = lo.x; x <= hi.x; x++)
         for (let y = lo.y; y <= hi.y; y++)
             for (let z = lo.z; z <= hi.z; z++)
-                changes.push({ x, y, z, block });
+                changes.push({ ...lo, x, y, z, block });
     return setBlocks(w, changes);
 }
 /** The air states the vanilla `masked` clone skips. */
@@ -264,11 +299,11 @@ function cloneBlocks(w, box, dest, mode = "replace") {
         for (let y = lo.y; y <= hi.y; y++)
             for (let z = lo.z; z <= hi.z; z++) {
                 if (mode === "move")
-                    cleared.push({ x, y, z, block: exports.AIR });
-                const block = blockStateAt(w, { x, y, z });
+                    cleared.push({ ...lo, x, y, z, block: exports.AIR });
+                const block = blockStateAt(w, { ...lo, x, y, z });
                 if (block === undefined || (mode === "masked" && exports.AIR_STATES.has(block)))
                     continue;
-                copies.push({ x: x + dx, y: y + dy, z: z + dz, block });
+                copies.push({ ...dest, x: x + dx, y: y + dy, z: z + dz, block });
             }
     return setBlocks(w, [...cleared, ...copies]);
 }
@@ -277,7 +312,7 @@ function walkBox(w, box, visit) {
     const { lo, hi } = bounds(box);
     for (let cx = lo.x >> 4; cx <= hi.x >> 4; cx++) {
         for (let cz = lo.z >> 4; cz <= hi.z >> 4; cz++) {
-            const chunk = w.chunks[(0, exports.chunkKey)(cx, cz)];
+            const chunk = w.chunks[(0, exports.chunkKey)(cx, cz, lo.dimension)];
             if (!chunk)
                 continue;
             const x1 = Math.max(lo.x, cx << 4);
@@ -324,7 +359,7 @@ function regionLoaded(w, box) {
     const { lo, hi } = bounds(box);
     for (let cx = lo.x >> 4; cx <= hi.x >> 4; cx++) {
         for (let cz = lo.z >> 4; cz <= hi.z >> 4; cz++)
-            if (!w.chunks[(0, exports.chunkKey)(cx, cz)])
+            if (!w.chunks[(0, exports.chunkKey)(cx, cz, lo.dimension)])
                 return false;
     }
     return true;
@@ -344,7 +379,7 @@ function findBlocks(w, box, match, limit = Number.MAX_SAFE_INTEGER) {
     const out = [];
     walkBox(w, box, (x, y, z, b) => {
         if (ok(b))
-            out.push({ x, y, z });
+            out.push({ ...(box.from.dimension ? { dimension: box.from.dimension } : {}), x, y, z });
         return out.length < limit;
     });
     return out;
@@ -382,8 +417,11 @@ function moveEntities(w, moves) {
     return any ? { ...w, entities } : w;
 }
 function entitiesIn(w, f = {}) {
+    if (f.box)
+        bounds(f.box);
     const prefix = f.tag?.endsWith("*") ? f.tag.slice(0, -1) : undefined;
-    return Object.values(w.entities).filter((e) => (f.type === undefined || e.type === f.type) &&
+    return Object.values(w.entities).filter((e) => (f.dimension === undefined || (0, dimensions_js_1.dimensionOf)(e.pos) === f.dimension) &&
+        (f.type === undefined || e.type === f.type) &&
         (f.box === undefined || inBox(e.pos, f.box)) &&
         (f.tag === undefined ||
             (prefix !== undefined ? e.tags.some((t) => t.startsWith(prefix)) : e.tags.includes(f.tag))));
@@ -399,4 +437,231 @@ function removeOther(w, name) {
     delete others[name];
     return { ...w, others };
 }
+/** The key of a list patch that holds the list's new length. */
+exports.NBT_LIST_LEN = "@len";
+const isObject = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+function freezeJson(v) {
+    if (v !== null && typeof v === "object" && !Object.isFrozen(v)) {
+        for (const x of Object.values(v))
+            freezeJson(x);
+        Object.freeze(v);
+    }
+    return v;
+}
+/** One delta applied to a value. The unchanged parts keep their frozen nodes. */
+function patchNbt(prev, d) {
+    if (isObject(d)) {
+        const len = d[exports.NBT_LIST_LEN];
+        if (Array.isArray(prev) && typeof len === "number") {
+            const out = prev.slice(0, len);
+            for (const [k, v] of Object.entries(d))
+                if (k !== exports.NBT_LIST_LEN)
+                    out[Number(k)] = patchNbt(out[Number(k)], v);
+            Object.freeze(out);
+            return out;
+        }
+        if (isObject(prev))
+            return mergeNbt(prev, d);
+    }
+    return freezeJson(d);
+}
+/** A compound delta applied to a compound (or to nothing, on the first sight). */
+function mergeNbt(prev, d) {
+    const out = { ...prev };
+    for (const [k, v] of Object.entries(d)) {
+        if (v === null)
+            delete out[k];
+        else
+            out[k] = patchNbt(out[k], v);
+    }
+    return Object.freeze(out);
+}
+/** The delta from `prev` to `cur`, as the engine computes it; `undefined` when they are equal. */
+function nbtDelta(prev, cur) {
+    const out = {};
+    let any = false;
+    for (const [k, v] of Object.entries(cur)) {
+        const p = prev[k];
+        if (p !== undefined && sameJson(p, v))
+            continue;
+        out[k] = p === undefined ? v : nbtValueDelta(p, v);
+        any = true;
+    }
+    for (const k of Object.keys(prev)) {
+        if (k in cur)
+            continue;
+        out[k] = null;
+        any = true;
+    }
+    return any ? out : undefined;
+}
+function nbtValueDelta(prev, cur) {
+    if (isObject(prev) && isObject(cur))
+        return nbtDelta(prev, cur) ?? {};
+    if (Array.isArray(prev) && Array.isArray(cur)) {
+        const out = { [exports.NBT_LIST_LEN]: cur.length };
+        let changed = 0;
+        cur.forEach((c, i) => {
+            const p = prev[i];
+            if (p !== undefined && sameJson(p, c))
+                return;
+            out[String(i)] = p === undefined ? c : nbtValueDelta(p, c);
+            changed++;
+        });
+        return cur.length > 2 && changed * 2 > cur.length ? cur : out;
+    }
+    return cur;
+}
+function sameJson(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || typeof a !== "object" || typeof b !== "object")
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    if (ka.length !== kb.length)
+        return false;
+    for (const k of ka) {
+        if (!(k in b))
+            return false;
+        if (!sameJson(a[k], b[k]))
+            return false;
+    }
+    return true;
+}
+/** The world after one `nbt` message, and what changed. Unknown entities and blocks outside the loaded chunks are ignored. */
+function applyNbt(w, m) {
+    let entities = w.entities;
+    let blockNbt = w.blockNbt;
+    const changedEntities = [];
+    const changedBlocks = [];
+    for (const d of m.entities ?? []) {
+        const prev = entities[d.id];
+        if (!prev)
+            continue;
+        if (entities === w.entities)
+            entities = { ...entities };
+        entities[d.id] = freezeObservation({ ...prev, nbt: mergeNbt(prev.nbt, d.nbt) });
+        changedEntities.push({ id: d.id, was: prev, delta: d.nbt });
+    }
+    for (const d of m.blocks ?? []) {
+        const x = Math.floor(d.pos.x);
+        const y = Math.floor(d.pos.y);
+        const z = Math.floor(d.pos.z);
+        // A delta for a chunk the mirror dropped would leave a partial entry.
+        if (!((0, exports.chunkKey)(x >> 4, z >> 4, d.pos.dimension) in w.chunks))
+            continue;
+        const key = (0, dimensions_js_1.positionKey)(d.pos);
+        if (blockNbt === w.blockNbt)
+            blockNbt = { ...blockNbt };
+        const was = blockNbt[key];
+        if (d.nbt === null) {
+            if (!was)
+                continue;
+            delete blockNbt[key];
+        }
+        else
+            blockNbt[key] = mergeNbt(was, d.nbt);
+        changedBlocks.push({ at: { ...d.pos, x, y, z }, was, delta: d.nbt });
+    }
+    const world = entities === w.entities && blockNbt === w.blockNbt ? w : { ...w, entities, blockNbt };
+    return { world, entities: changedEntities, blocks: changedBlocks };
+}
+// ---------------------------------------------------------------- change paths
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** `base.key`, or `base["key"]` for a key that is not a plain name (`Paper.Delay`, `minecraft:custom_data`). */
+function pathJoin(base, key) {
+    if (IDENTIFIER.test(key))
+        return base === "" ? key : `${base}.${key}`;
+    return `${base}[${JSON.stringify(key)}]`;
+}
+/**
+ * The paths of the leaves that a delta changes, from the value before it: `nbt.data.score`, `nbt.Items[3].count`.
+ * A replaced or new value, a removed key and a removed list entry give their own path. `base` is the path of the
+ * value itself: the first sight of a value gives `base` alone.
+ */
+function nbtPaths(prev, d, base, out = []) {
+    if (isObject(d)) {
+        const len = d[exports.NBT_LIST_LEN];
+        if (Array.isArray(prev) && typeof len === "number") {
+            for (const [k, v] of Object.entries(d))
+                if (k !== exports.NBT_LIST_LEN)
+                    nbtPaths(prev[Number(k)], v, `${base}[${k}]`, out);
+            for (let i = len; i < prev.length; i++)
+                out.push(`${base}[${i}]`);
+            return out;
+        }
+        if (isObject(prev)) {
+            for (const [k, v] of Object.entries(d)) {
+                if (v === null)
+                    out.push(pathJoin(base, k));
+                else
+                    nbtPaths(prev[k], v, pathJoin(base, k), out);
+            }
+            return out;
+        }
+    }
+    out.push(base);
+    return out;
+}
+/** The names of the top-level fields that differ between two observations of an entity. */
+function changedFields(was, now) {
+    const a = was;
+    const b = now;
+    const out = [];
+    for (const k of new Set([...Object.keys(a), ...Object.keys(b)]))
+        if (a[k] !== b[k])
+            out.push(k);
+    return out;
+}
+/**
+ * The value at a change path (`"nbt.Items[3].count"`, `'nbt["Paper.Delay"]'`), or `undefined` when nothing is there.
+ * Read from the object that the path starts at: the entity for `entityChanged`, the NBT for `blockNbtChanged`.
+ * The path `""` is the object itself.
+ */
+function valueAt(root, path) {
+    let v = root;
+    let i = 0;
+    const step = (key) => {
+        v = v !== null && typeof v === "object" && Object.hasOwn(v, key) ? v[key] : undefined;
+    };
+    while (i < path.length) {
+        if (v === undefined)
+            return undefined;
+        if (path[i] === "[") {
+            if (path[i + 1] === '"') {
+                let j = i + 2;
+                while (j < path.length && path[j] !== '"')
+                    j += path[j] === "\\" ? 2 : 1;
+                step(JSON.parse(path.slice(i + 1, j + 1)));
+                i = j + 2;
+            }
+            else {
+                const j = path.indexOf("]", i);
+                step(Number(path.slice(i + 1, j)));
+                i = j + 1;
+            }
+        }
+        else {
+            if (path[i] === ".")
+                i++;
+            let j = i;
+            while (j < path.length && path[j] !== "." && path[j] !== "[")
+                j++;
+            step(path.slice(i, j));
+            i = j;
+        }
+    }
+    return v;
+}
+/**
+ * Whether a change touches the value at `path`: a changed path is `path`, under it (`nbt.data.score` for `nbt.data`),
+ * or above it (`nbt` on the first sight, for `nbt.data`). A prefix test alone would match `nbt.dataX` too.
+ */
+function changedUnder(changed, path) {
+    const within = (a, b) => a === b || b === "" || a.startsWith(`${b}.`) || a.startsWith(`${b}[`);
+    return changed.some((p) => within(p, path) || within(path, p));
+}
 //# sourceMappingURL=world.js.map