bedrock-kit 0.0.3

package/dist/internal/animation.js

@@ -0,0 +1,47 @@
+/**
+ * Represents a single animation definition loaded from a resource pack animation file.
+ * Multiple animations are defined per file; each is keyed by its full ID.
+ *
+ * @example
+ * ```ts
+ * const anim = addon.getAnimation("animation.humanoid.move");
+ * console.log(anim?.loop); // true
+ * ```
+ */
+export class Animation {
+    constructor(id, data, filePath) {
+        this.id = id;
+        this.data = data;
+        this.filePath = filePath;
+    }
+    /** Whether this animation loops. Reads the `loop` property from the animation data. */
+    get loop() { return this.data["loop"] === true; }
+}
+/**
+ * Represents a single animation controller loaded from a resource pack
+ * `animation_controllers/` file. Animation controllers manage transitions
+ * between animation states for an entity.
+ *
+ * @example
+ * ```ts
+ * const ctrl = addon.getAnimationController("controller.animation.zombie.move");
+ * console.log(ctrl?.initialState); // "default"
+ * console.log(ctrl?.states);       // ["default", "attacking"]
+ * ```
+ */
+export class AnimationController {
+    constructor(id, data, filePath) {
+        this.id = id;
+        this.data = data;
+        this.filePath = filePath;
+    }
+    /** The names of all states defined in this controller. */
+    get states() {
+        return Object.keys(this.data["states"] ?? {});
+    }
+    /** The name of the initial state this controller starts in. Null if not specified. */
+    get initialState() {
+        return this.data["initial_state"] ?? null;
+    }
+}
+//# sourceMappingURL=animation.js.map

package/dist/internal/animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.js","sourceRoot":"","sources":["../../src/internal/animation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,SAAS;IAWpB,YAAY,EAAU,EAAE,IAA6B,EAAE,QAAgB;QACrE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,uFAAuF;IACvF,IAAI,IAAI,KAAc,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IAW9B,YAAY,EAAU,EAAE,IAA6B,EAAE,QAAgB;QACrE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,0DAA0D;IAC1D,IAAI,MAAM;QACR,OAAO,MAAM,CAAC,IAAI,CAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAA6B,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,sFAAsF;IACtF,IAAI,YAAY;QACd,OAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAY,IAAI,IAAI,CAAC;IACxD,CAAC;CACF"}

package/dist/internal/attachable.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Represents an attachable definition from the resource pack's `attachables/` directory.
+ * Attachables define how items are visually rendered when held or equipped.
+ *
+ * @example
+ * ```ts
+ * const att = addon.getAttachable("minecraft:bow");
+ * console.log(att?.textures);  // { default: "textures/items/bow_standby", ... }
+ * console.log(att?.materials); // { default: "entity_alphatest", ... }
+ * ```
+ */
+export declare class Attachable {
+    /** The namespaced item identifier this attachable is for, e.g. `"minecraft:bow"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the attachable file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the attachable file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    constructor(identifier: string, data: Record<string, unknown>, filePath: string);
+    private get _description();
+    /** Map of shortname → texture path. e.g. `{ "default": "textures/items/bow_standby" }`. */
+    get textures(): Record<string, string>;
+    /** Map of shortname → material name. e.g. `{ "default": "entity_alphatest" }`. */
+    get materials(): Record<string, string>;
+    /** Map of shortname → geometry identifier. */
+    get geometry(): Record<string, string>;
+}
+//# sourceMappingURL=attachable.d.ts.map

package/dist/internal/attachable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachable.d.ts","sourceRoot":"","sources":["../../src/internal/attachable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM;IAM/E,OAAO,KAAK,YAAY,GAGvB;IAED,2FAA2F;IAC3F,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAErC;IACD,kFAAkF;IAClF,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtC;IACD,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAErC;CACF"}

package/dist/internal/attachable.js

@@ -0,0 +1,35 @@
+/**
+ * Represents an attachable definition from the resource pack's `attachables/` directory.
+ * Attachables define how items are visually rendered when held or equipped.
+ *
+ * @example
+ * ```ts
+ * const att = addon.getAttachable("minecraft:bow");
+ * console.log(att?.textures);  // { default: "textures/items/bow_standby", ... }
+ * console.log(att?.materials); // { default: "entity_alphatest", ... }
+ * ```
+ */
+export class Attachable {
+    constructor(identifier, data, filePath) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+    }
+    get _description() {
+        const inner = this.data["minecraft:attachable"] ?? {};
+        return inner["description"] ?? {};
+    }
+    /** Map of shortname → texture path. e.g. `{ "default": "textures/items/bow_standby" }`. */
+    get textures() {
+        return this._description["textures"] ?? {};
+    }
+    /** Map of shortname → material name. e.g. `{ "default": "entity_alphatest" }`. */
+    get materials() {
+        return this._description["materials"] ?? {};
+    }
+    /** Map of shortname → geometry identifier. */
+    get geometry() {
+        return this._description["geometry"] ?? {};
+    }
+}
+//# sourceMappingURL=attachable.js.map

package/dist/internal/attachable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachable.js","sourceRoot":"","sources":["../../src/internal/attachable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAU;IAWrB,YAAY,UAAkB,EAAE,IAA6B,EAAE,QAAgB;QAC7E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAY,YAAY;QACtB,MAAM,KAAK,GAAI,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAA6B,IAAI,EAAE,CAAC;QACnF,OAAQ,KAAK,CAAC,aAAa,CAA6B,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,2FAA2F;IAC3F,IAAI,QAAQ;QACV,OAAQ,IAAI,CAAC,YAAY,CAAC,UAAU,CAA4B,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,kFAAkF;IAClF,IAAI,SAAS;QACX,OAAQ,IAAI,CAAC,YAAY,CAAC,WAAW,CAA4B,IAAI,EAAE,CAAC;IAC1E,CAAC;IACD,8CAA8C;IAC9C,IAAI,QAAQ;QACV,OAAQ,IAAI,CAAC,YAAY,CAAC,UAAU,CAA4B,IAAI,EAAE,CAAC;IACzE,CAAC;CACF"}

package/dist/internal/biome.d.ts

@@ -0,0 +1,62 @@
+import type { AddOn } from "./addon.js";
+import type { Entity } from "./entity.js";
+import type { MusicDefinition } from "./sound.js";
+/**
+ * Represents a biome definition file from the behavior pack's `biomes/` directory.
+ *
+ * @example
+ * ```ts
+ * const biome = addon.getBiome("minecraft:bamboo_jungle");
+ * console.log(biome?.climate?.temperature); // 0.95
+ * console.log(biome?.getEntities().map(e => e.identifier));
+ * ```
+ */
+export declare class Biome {
+    /** The namespaced biome identifier, e.g. `"minecraft:bamboo_jungle"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the biome file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the biome file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    private readonly _addon;
+    constructor(identifier: string, data: Record<string, unknown>, filePath: string, addon: AddOn);
+    /**
+     * The full components object from the biome definition.
+     * Keys are Bedrock component names such as `"minecraft:climate"`, `"minecraft:tags"`, etc.
+     */
+    get components(): Record<string, unknown>;
+    /**
+     * The `minecraft:climate` component, which contains properties like
+     * `temperature`, `downfall`, and `snow_accumulation`. Returns null if absent.
+     */
+    get climate(): Record<string, unknown> | null;
+    /**
+     * Returns all entities whose spawn rule references at least one tag that this biome has.
+     *
+     * @example
+     * ```ts
+     * addon.getBiome("minecraft:bamboo_jungle")
+     *   ?.getEntities()
+     *   .map(e => e.identifier);
+     * // ["minecraft:panda", "minecraft:ocelot", ...]
+     * ```
+     */
+    getEntities(): Entity[];
+    /**
+     * Returns the music definition for this biome from `sounds/music_definitions.json`.
+     *
+     * Looks up the biome's shortname (e.g. `"minecraft:bamboo_jungle"` → `"bamboo_jungle"`).
+     * Returns null if no music definition exists for this biome.
+     *
+     * @example
+     * ```ts
+     * addon.getBiome("minecraft:bamboo_jungle")?.getMusicDefinition()?.eventName;
+     * // "music.overworld.bamboo_jungle"
+     * ```
+     */
+    getMusicDefinition(): MusicDefinition | null;
+}
+//# sourceMappingURL=biome.d.ts.map

package/dist/internal/biome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome.d.ts","sourceRoot":"","sources":["../../src/internal/biome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;GASG;AACH,qBAAa,KAAK;IAChB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAO7F;;;OAGG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGxC;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE5C;IAED;;;;;;;;;;OAUG;IACH,WAAW,IAAI,MAAM,EAAE;IAcvB;;;;;;;;;;;OAWG;IACH,kBAAkB,IAAI,eAAe,GAAG,IAAI;CAG7C"}

package/dist/internal/biome.js

@@ -0,0 +1,75 @@
+import { shortname } from "./utils.js";
+/**
+ * Represents a biome definition file from the behavior pack's `biomes/` directory.
+ *
+ * @example
+ * ```ts
+ * const biome = addon.getBiome("minecraft:bamboo_jungle");
+ * console.log(biome?.climate?.temperature); // 0.95
+ * console.log(biome?.getEntities().map(e => e.identifier));
+ * ```
+ */
+export class Biome {
+    constructor(identifier, data, filePath, addon) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+        this._addon = addon;
+    }
+    /**
+     * The full components object from the biome definition.
+     * Keys are Bedrock component names such as `"minecraft:climate"`, `"minecraft:tags"`, etc.
+     */
+    get components() {
+        const inner = this.data["minecraft:biome"] ?? {};
+        return inner["components"] ?? {};
+    }
+    /**
+     * The `minecraft:climate` component, which contains properties like
+     * `temperature`, `downfall`, and `snow_accumulation`. Returns null if absent.
+     */
+    get climate() {
+        return this.components["minecraft:climate"] ?? null;
+    }
+    /**
+     * Returns all entities whose spawn rule references at least one tag that this biome has.
+     *
+     * @example
+     * ```ts
+     * addon.getBiome("minecraft:bamboo_jungle")
+     *   ?.getEntities()
+     *   .map(e => e.identifier);
+     * // ["minecraft:panda", "minecraft:ocelot", ...]
+     * ```
+     */
+    getEntities() {
+        const tagsComp = this.components["minecraft:tags"];
+        const biomeTags = tagsComp
+            ? tagsComp["tags"] ?? []
+            : [];
+        if (biomeTags.length === 0)
+            return [];
+        return this._addon.getAllEntities().filter((entity) => {
+            const spawnRule = entity.getSpawnRule();
+            if (!spawnRule)
+                return false;
+            return spawnRule.getBiomeTags().some((tag) => biomeTags.includes(tag));
+        });
+    }
+    /**
+     * Returns the music definition for this biome from `sounds/music_definitions.json`.
+     *
+     * Looks up the biome's shortname (e.g. `"minecraft:bamboo_jungle"` → `"bamboo_jungle"`).
+     * Returns null if no music definition exists for this biome.
+     *
+     * @example
+     * ```ts
+     * addon.getBiome("minecraft:bamboo_jungle")?.getMusicDefinition()?.eventName;
+     * // "music.overworld.bamboo_jungle"
+     * ```
+     */
+    getMusicDefinition() {
+        return this._addon.getMusicDefinition(shortname(this.identifier));
+    }
+}
+//# sourceMappingURL=biome.js.map

package/dist/internal/biome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome.js","sourceRoot":"","sources":["../../src/internal/biome.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,OAAO,KAAK;IAYhB,YAAY,UAAkB,EAAE,IAA6B,EAAE,QAAgB,EAAE,KAAY;QAC3F,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,IAAI,UAAU;QACZ,MAAM,KAAK,GAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAA6B,IAAI,EAAE,CAAC;QAC9E,OAAQ,KAAK,CAAC,YAAY,CAA6B,IAAI,EAAE,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAQ,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAA6B,IAAI,IAAI,CAAC;IACnF,CAAC;IAED;;;;;;;;;;OAUG;IACH,WAAW;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAwC,CAAC;QAC1F,MAAM,SAAS,GAAa,QAAQ;YAClC,CAAC,CAAE,QAAQ,CAAC,MAAM,CAA0B,IAAI,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YACpD,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC7B,OAAO,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/internal/block.d.ts

@@ -0,0 +1,55 @@
+import type { AddOn } from "./addon.js";
+import type { LootTable } from "./lootTable.js";
+import type { SoundEvent } from "./sound.js";
+/**
+ * Represents a block definition file from the behavior pack's `blocks/` directory.
+ *
+ * @example
+ * ```ts
+ * const block = addon.getBlock("tsunami_dungeons:golem_heart");
+ * console.log(block?.getTexturePath("*")); // "textures/blocks/golem_heart"
+ * console.log(block?.getLootTable());      // LootTable | null
+ * ```
+ */
+export declare class Block {
+    /** The namespaced block identifier, e.g. `"minecraft:dirt"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the block's behavior file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the block's behavior file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    private readonly _addon;
+    constructor(identifier: string, data: Record<string, unknown>, filePath: string, addon: AddOn);
+    /**
+     * Resolves the texture path for the given face of this block by reading its
+     * `minecraft:material_instances` component and looking up the shortname in
+     * the resource pack's `terrain_texture.json`.
+     *
+     * @param face - `"up"`, `"down"`, `"side"`, or `"*"` for the wildcard/default face.
+     */
+    getTexturePath(face?: "up" | "down" | "side" | "*"): string | null;
+    /**
+     * Returns the loot table for this block by resolving the path in its
+     * `minecraft:loot` component. Returns null if absent.
+     */
+    getLootTable(): LootTable | null;
+    /**
+     * Returns the sound events for this block from `sounds/sounds.json`.
+     *
+     * Looks up the block's shortname (e.g. `"minecraft:amethyst_block"` → `"amethyst_block"`)
+     * in `block_sounds`. Returns an empty array if no sound events are defined.
+     *
+     * @example
+     * ```ts
+     * addon.getBlock("minecraft:amethyst_block")?.getSoundEvents()
+     *   .find(e => e.event === "break")?.definitionId;
+     * // "break.amethyst_block"
+     * ```
+     */
+    getSoundEvents(): SoundEvent[];
+    private _getComponents;
+}
+//# sourceMappingURL=block.d.ts.map

package/dist/internal/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/internal/block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;GASG;AACH,qBAAa,KAAK;IAChB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAO7F;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,GAAS,GAAG,MAAM,GAAG,IAAI;IAiBvE;;;OAGG;IACH,YAAY,IAAI,SAAS,GAAG,IAAI;IAMhC;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B,OAAO,CAAC,cAAc;CAIvB"}

package/dist/internal/block.js

@@ -0,0 +1,75 @@
+import { shortname } from "./utils.js";
+/**
+ * Represents a block definition file from the behavior pack's `blocks/` directory.
+ *
+ * @example
+ * ```ts
+ * const block = addon.getBlock("tsunami_dungeons:golem_heart");
+ * console.log(block?.getTexturePath("*")); // "textures/blocks/golem_heart"
+ * console.log(block?.getLootTable());      // LootTable | null
+ * ```
+ */
+export class Block {
+    constructor(identifier, data, filePath, addon) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+        this._addon = addon;
+    }
+    /**
+     * Resolves the texture path for the given face of this block by reading its
+     * `minecraft:material_instances` component and looking up the shortname in
+     * the resource pack's `terrain_texture.json`.
+     *
+     * @param face - `"up"`, `"down"`, `"side"`, or `"*"` for the wildcard/default face.
+     */
+    getTexturePath(face = "*") {
+        const textures = this._addon.terrainTextures;
+        if (!textures)
+            return null;
+        const materialInstances = this._getComponents()["minecraft:material_instances"];
+        if (!materialInstances)
+            return null;
+        const instance = materialInstances[face] ??
+            materialInstances["*"];
+        const sn = instance?.["texture"];
+        if (!sn)
+            return null;
+        const entry = textures.texture_data[sn];
+        if (!entry)
+            return null;
+        const tex = entry.textures;
+        return Array.isArray(tex) ? (tex[0] ?? null) : tex;
+    }
+    /**
+     * Returns the loot table for this block by resolving the path in its
+     * `minecraft:loot` component. Returns null if absent.
+     */
+    getLootTable() {
+        const lootPath = this._getComponents()["minecraft:loot"];
+        if (typeof lootPath !== "string")
+            return null;
+        return this._addon.getLootTableByPath(lootPath);
+    }
+    /**
+     * Returns the sound events for this block from `sounds/sounds.json`.
+     *
+     * Looks up the block's shortname (e.g. `"minecraft:amethyst_block"` → `"amethyst_block"`)
+     * in `block_sounds`. Returns an empty array if no sound events are defined.
+     *
+     * @example
+     * ```ts
+     * addon.getBlock("minecraft:amethyst_block")?.getSoundEvents()
+     *   .find(e => e.event === "break")?.definitionId;
+     * // "break.amethyst_block"
+     * ```
+     */
+    getSoundEvents() {
+        return this._addon.getBlockSoundEvents(shortname(this.identifier));
+    }
+    _getComponents() {
+        const blockDef = this.data["minecraft:block"] ?? {};
+        return blockDef["components"] ?? {};
+    }
+}
+//# sourceMappingURL=block.js.map

package/dist/internal/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/internal/block.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,OAAO,KAAK;IAYhB,YAAY,UAAkB,EAAE,IAA6B,EAAE,QAAgB,EAAE,KAAY;QAC3F,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAqC,GAAG;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,8BAA8B,CACzC,CAAC;QACtC,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,QAAQ,GACX,iBAAiB,CAAC,IAAI,CAA6B;YACnD,iBAAiB,CAAC,GAAG,CAA6B,CAAC;QACtD,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,SAAS,CAAuB,CAAC;QACvD,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACrE,CAAC;IAEO,cAAc;QACpB,MAAM,QAAQ,GAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAA6B,IAAI,EAAE,CAAC;QACjF,OAAQ,QAAQ,CAAC,YAAY,CAA6B,IAAI,EAAE,CAAC;IACnE,CAAC;CACF"}

package/dist/internal/entity.d.ts

@@ -0,0 +1,107 @@
+import type { AddOn } from "./addon.js";
+import type { LootTable } from "./lootTable.js";
+import type { SpawnRule } from "./spawnRule.js";
+import type { Animation, AnimationController } from "./animation.js";
+import type { RenderController } from "./renderController.js";
+import type { Particle } from "./particle.js";
+import type { SoundEvent } from "./sound.js";
+/**
+ * Represents an entity that exists across both packs — a behavior (server-side)
+ * definition and optionally a resource (client-side) definition.
+ *
+ * @example
+ * ```ts
+ * const zombie = addon.getEntity("minecraft:zombie");
+ * zombie?.getLootTables();        // LootTable[]
+ * zombie?.getSpawnRule();         // SpawnRule | null
+ * zombie?.getAnimations();        // [{ shortname, animation }]
+ * zombie?.getRenderControllers(); // RenderController[]
+ * ```
+ */
+export declare class Entity {
+    /** The namespaced entity identifier, e.g. `"minecraft:zombie"`. */
+    readonly identifier: string;
+    /** Raw parsed JSON of the behavior pack (server-side) entity file. */
+    readonly behaviorData: Record<string, unknown>;
+    /**
+     * Absolute path to the behavior file on disk.
+     * Empty string if no behavior file exists or when loaded from browser `File[]`.
+     */
+    readonly behaviorFilePath: string;
+    /** Raw parsed JSON of the resource pack (client-side) entity file. Null if not present. */
+    readonly resourceData: Record<string, unknown> | null;
+    /**
+     * Absolute path to the resource file on disk. Null if not present.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly resourceFilePath: string | null;
+    private readonly _addon;
+    constructor(identifier: string, behaviorData: Record<string, unknown>, behaviorFilePath: string, resourceData: Record<string, unknown> | null, resourceFilePath: string | null, addon: AddOn);
+    private get _rpDescription();
+    /**
+     * The shortname → full animation ID map declared in the resource entity file.
+     * @example `{ "move": "animation.humanoid.move" }`
+     */
+    get animationShortnames(): Record<string, string>;
+    /**
+     * The shortname → full particle identifier map declared in the resource entity file.
+     * @example `{ "stun_particles": "minecraft:stunned_emitter" }`
+     */
+    get particleShortnames(): Record<string, string>;
+    /**
+     * The list of render controller IDs declared in the resource entity file.
+     */
+    get renderControllerIds(): string[];
+    /**
+     * The shortname → sound event ID map declared in the resource entity file's
+     * `description.sounds`. These are per-entity sound bindings separate from
+     * the global `sounds.json` mappings.
+     *
+     * @example `{ "hurt": "mob.zombie.hurt", "step": "mob.zombie.step" }`
+     */
+    get soundShortnames(): Record<string, string>;
+    /**
+     * Returns all loot tables this entity can drop, by recursively searching
+     * its behavior data for `minecraft:loot` component entries.
+     */
+    getLootTables(): LootTable[];
+    /** Returns this entity's spawn rule, or null if none exists. */
+    getSpawnRule(): SpawnRule | null;
+    /**
+     * Resolves this entity's animation shortnames into `Animation` instances.
+     * Animation controller references are excluded — use `getAnimationControllers()` for those.
+     */
+    getAnimations(): Array<{
+        shortname: string;
+        animation: Animation;
+    }>;
+    /**
+     * Resolves this entity's animation controller shortnames into `AnimationController` instances.
+     */
+    getAnimationControllers(): Array<{
+        shortname: string;
+        controller: AnimationController;
+    }>;
+    /** Resolves this entity's render controller IDs into `RenderController` instances. */
+    getRenderControllers(): RenderController[];
+    /** Resolves this entity's particle shortnames into `Particle` instances. */
+    getParticles(): Array<{
+        shortname: string;
+        particle: Particle;
+    }>;
+    /**
+     * Returns the sound events for this entity from `sounds/sounds.json`.
+     *
+     * The entity identifier is stripped to its shortname for the lookup
+     * (e.g. `"minecraft:zombie"` → `"zombie"`).
+     *
+     * @example
+     * ```ts
+     * addon.getEntity("minecraft:zombie")?.getSoundEvents()
+     *   .map(e => `${e.event} → ${e.definitionId}`);
+     * ```
+     */
+    getSoundEvents(): SoundEvent[];
+    private _collectLootPaths;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/internal/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/internal/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;;;GAYG;AACH,qBAAa,MAAM;IACjB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAG7B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC5C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,KAAK,EAAE,KAAK;IAUd,OAAO,KAAK,cAAc,GAGzB;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhD;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/C;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,EAAE,CASlC;IAED;;;;;;OAMG;IACH,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5C;IAED;;;OAGG;IACH,aAAa,IAAI,SAAS,EAAE;IAO5B,gEAAgE;IAChE,YAAY,IAAI,SAAS,GAAG,IAAI;IAIhC;;;OAGG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IAQnE;;OAEG;IACH,uBAAuB,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAQxF,sFAAsF;IACtF,oBAAoB,IAAI,gBAAgB,EAAE;IAO1C,4EAA4E;IAC5E,YAAY,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAOhE;;;;;;;;;;;OAWG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B,OAAO,CAAC,iBAAiB;CAY1B"}