bedrock-kit 0.0.3

package/dist/internal/entity.js

@@ -0,0 +1,148 @@
+import { shortname } from "./utils.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 class Entity {
+    constructor(identifier, behaviorData, behaviorFilePath, resourceData, resourceFilePath, addon) {
+        this.identifier = identifier;
+        this.behaviorData = behaviorData;
+        this.behaviorFilePath = behaviorFilePath;
+        this.resourceData = resourceData;
+        this.resourceFilePath = resourceFilePath;
+        this._addon = addon;
+    }
+    get _rpDescription() {
+        const inner = this.resourceData?.["minecraft:client_entity"] ?? {};
+        return inner["description"] ?? {};
+    }
+    /**
+     * The shortname → full animation ID map declared in the resource entity file.
+     * @example `{ "move": "animation.humanoid.move" }`
+     */
+    get animationShortnames() {
+        return this._rpDescription["animations"] ?? {};
+    }
+    /**
+     * The shortname → full particle identifier map declared in the resource entity file.
+     * @example `{ "stun_particles": "minecraft:stunned_emitter" }`
+     */
+    get particleShortnames() {
+        return this._rpDescription["particle_effects"] ?? {};
+    }
+    /**
+     * The list of render controller IDs declared in the resource entity file.
+     */
+    get renderControllerIds() {
+        const raw = this._rpDescription["render_controllers"];
+        if (!Array.isArray(raw))
+            return [];
+        return raw.flatMap((entry) => {
+            if (typeof entry === "string")
+                return [entry];
+            if (typeof entry === "object" && entry !== null)
+                return Object.keys(entry);
+            return [];
+        });
+    }
+    /**
+     * 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() {
+        return this._rpDescription["sounds"] ?? {};
+    }
+    /**
+     * Returns all loot tables this entity can drop, by recursively searching
+     * its behavior data for `minecraft:loot` component entries.
+     */
+    getLootTables() {
+        return this._collectLootPaths(this.behaviorData).flatMap((p) => {
+            const lt = this._addon.getLootTableByPath(p);
+            return lt ? [lt] : [];
+        });
+    }
+    /** Returns this entity's spawn rule, or null if none exists. */
+    getSpawnRule() {
+        return this._addon.getSpawnRule(this.identifier);
+    }
+    /**
+     * Resolves this entity's animation shortnames into `Animation` instances.
+     * Animation controller references are excluded — use `getAnimationControllers()` for those.
+     */
+    getAnimations() {
+        return Object.entries(this.animationShortnames).flatMap(([sn, fullId]) => {
+            if (fullId.startsWith("controller."))
+                return [];
+            const animation = this._addon.getAnimation(fullId);
+            return animation ? [{ shortname: sn, animation }] : [];
+        });
+    }
+    /**
+     * Resolves this entity's animation controller shortnames into `AnimationController` instances.
+     */
+    getAnimationControllers() {
+        return Object.entries(this.animationShortnames).flatMap(([sn, fullId]) => {
+            if (!fullId.startsWith("controller.animation."))
+                return [];
+            const controller = this._addon.getAnimationController(fullId);
+            return controller ? [{ shortname: sn, controller }] : [];
+        });
+    }
+    /** Resolves this entity's render controller IDs into `RenderController` instances. */
+    getRenderControllers() {
+        return this.renderControllerIds.flatMap((id) => {
+            const rc = this._addon.getRenderController(id);
+            return rc ? [rc] : [];
+        });
+    }
+    /** Resolves this entity's particle shortnames into `Particle` instances. */
+    getParticles() {
+        return Object.entries(this.particleShortnames).flatMap(([sn, fullId]) => {
+            const particle = this._addon.getParticle(fullId);
+            return particle ? [{ shortname: sn, 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() {
+        return this._addon.getEntitySoundEvents(shortname(this.identifier));
+    }
+    _collectLootPaths(obj) {
+        if (typeof obj !== "object" || obj === null)
+            return [];
+        const paths = [];
+        for (const [key, value] of Object.entries(obj)) {
+            if (key === "minecraft:loot" && typeof value === "object" && value !== null) {
+                const table = value["table"];
+                if (typeof table === "string")
+                    paths.push(table);
+            }
+            paths.push(...this._collectLootPaths(value));
+        }
+        return [...new Set(paths)];
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/internal/entity.js.map

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

package/dist/internal/item.d.ts

@@ -0,0 +1,72 @@
+import type { AddOn } from "./addon.js";
+import type { Attachable } from "./attachable.js";
+import type { Recipe } from "./recipe.js";
+import type { Entity } from "./entity.js";
+import type { Block } from "./block.js";
+/**
+ * Represents an item definition file from the behavior pack's `items/` directory.
+ *
+ * @example
+ * ```ts
+ * const spear = addon.getItem("minecraft:copper_spear");
+ * console.log(spear?.getTexturePath()); // "textures/items/spear/copper_spear"
+ * console.log(spear?.getAttachable());  // Attachable | null
+ * console.log(spear?.getRecipes());     // Recipe[]
+ * console.log(spear?.getDroppedByEntities()); // Entity[]
+ * console.log(spear?.getDroppedByBlocks());   // Block[]
+ * ```
+ */
+export declare class Item {
+    /** The namespaced item identifier, e.g. `"minecraft:copper_spear"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the item's behavior file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the item'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 this item's display texture path by reading its `minecraft:icon` component
+     * shortname and looking it up in the resource pack's `item_texture.json`.
+     *
+     * @returns The texture file path (without extension), e.g. `"textures/items/iron_sword"`.
+     * Returns null if the item has no icon component or the shortname isn't in item_texture.json.
+     */
+    getTexturePath(): string | null;
+    /**
+     * Returns the attachable definition for this item, or null if no attachable exists.
+     */
+    getAttachable(): Attachable | null;
+    /**
+     * Returns all recipes in the addon whose result matches this item's identifier.
+     */
+    getRecipes(): Recipe[];
+    /**
+     * Returns all entities that can drop this item, by searching every entity's
+     * loot tables for entries matching this item's identifier.
+     *
+     * @example
+     * ```ts
+     * addon.getItem("minecraft:rotten_flesh")?.getDroppedByEntities();
+     * // [Entity<"minecraft:zombie">, Entity<"minecraft:drowned">, ...]
+     * ```
+     */
+    getDroppedByEntities(): Entity[];
+    /**
+     * Returns all blocks that can drop this item, by resolving each block's
+     * `minecraft:loot` component and checking if this item appears in it.
+     *
+     * @example
+     * ```ts
+     * addon.getItem("minecraft:diamond")?.getDroppedByBlocks();
+     * // [Block<"minecraft:diamond_ore">, ...]
+     * ```
+     */
+    getDroppedByBlocks(): Block[];
+    private _getComponents;
+    private _extractIcon;
+}
+//# sourceMappingURL=item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/internal/item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,qBAAa,IAAI;IACf,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,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,IAAI,MAAM,GAAG,IAAI;IAW/B;;OAEG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;;;;;OASG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;;;;;;;OASG;IACH,kBAAkB,IAAI,KAAK,EAAE;IAO7B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/internal/item.js

@@ -0,0 +1,103 @@
+/**
+ * Represents an item definition file from the behavior pack's `items/` directory.
+ *
+ * @example
+ * ```ts
+ * const spear = addon.getItem("minecraft:copper_spear");
+ * console.log(spear?.getTexturePath()); // "textures/items/spear/copper_spear"
+ * console.log(spear?.getAttachable());  // Attachable | null
+ * console.log(spear?.getRecipes());     // Recipe[]
+ * console.log(spear?.getDroppedByEntities()); // Entity[]
+ * console.log(spear?.getDroppedByBlocks());   // Block[]
+ * ```
+ */
+export class Item {
+    constructor(identifier, data, filePath, addon) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+        this._addon = addon;
+    }
+    /**
+     * Resolves this item's display texture path by reading its `minecraft:icon` component
+     * shortname and looking it up in the resource pack's `item_texture.json`.
+     *
+     * @returns The texture file path (without extension), e.g. `"textures/items/iron_sword"`.
+     * Returns null if the item has no icon component or the shortname isn't in item_texture.json.
+     */
+    getTexturePath() {
+        const textures = this._addon.itemTextures;
+        if (!textures)
+            return null;
+        const icon = this._extractIcon(this._getComponents());
+        if (!icon)
+            return null;
+        const entry = textures.texture_data[icon];
+        if (!entry)
+            return null;
+        const tex = entry.textures;
+        return Array.isArray(tex) ? (tex[0] ?? null) : tex;
+    }
+    /**
+     * Returns the attachable definition for this item, or null if no attachable exists.
+     */
+    getAttachable() {
+        return this._addon.getAttachable(this.identifier);
+    }
+    /**
+     * Returns all recipes in the addon whose result matches this item's identifier.
+     */
+    getRecipes() {
+        return this._addon.getAllRecipes().filter((r) => r.getResultStack()?.identifier === this.identifier);
+    }
+    /**
+     * Returns all entities that can drop this item, by searching every entity's
+     * loot tables for entries matching this item's identifier.
+     *
+     * @example
+     * ```ts
+     * addon.getItem("minecraft:rotten_flesh")?.getDroppedByEntities();
+     * // [Entity<"minecraft:zombie">, Entity<"minecraft:drowned">, ...]
+     * ```
+     */
+    getDroppedByEntities() {
+        return this._addon.getAllEntities().filter((entity) => entity.getLootTables().some((lt) => lt.getItemIdentifiers().includes(this.identifier)));
+    }
+    /**
+     * Returns all blocks that can drop this item, by resolving each block's
+     * `minecraft:loot` component and checking if this item appears in it.
+     *
+     * @example
+     * ```ts
+     * addon.getItem("minecraft:diamond")?.getDroppedByBlocks();
+     * // [Block<"minecraft:diamond_ore">, ...]
+     * ```
+     */
+    getDroppedByBlocks() {
+        return this._addon.getAllBlocks().filter((block) => {
+            const lt = block.getLootTable();
+            return lt !== null && lt.getItemIdentifiers().includes(this.identifier);
+        });
+    }
+    _getComponents() {
+        const itemDef = this.data["minecraft:item"] ?? {};
+        return itemDef["components"] ?? {};
+    }
+    _extractIcon(components) {
+        const iconComp = components["minecraft:icon"];
+        if (!iconComp)
+            return null;
+        if (typeof iconComp === "string")
+            return iconComp;
+        if (typeof iconComp === "object") {
+            const ic = iconComp;
+            if (typeof ic["texture"] === "string")
+                return ic["texture"];
+            const textures = ic["textures"];
+            if (textures?.default)
+                return textures.default;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=item.js.map

package/dist/internal/item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../../src/internal/item.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,IAAI;IAYf,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;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1C,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;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,UAAU,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;IACvG,CAAC;IAED;;;;;;;;;OASG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjJ,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACjD,MAAM,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc;QACpB,MAAM,OAAO,GAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAA6B,IAAI,EAAE,CAAC;QAC/E,OAAQ,OAAO,CAAC,YAAY,CAA6B,IAAI,EAAE,CAAC;IAClE,CAAC;IAEO,YAAY,CAAC,UAAmC;QACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,QAAmC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC,SAAS,CAAW,CAAC;YACtE,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAuC,CAAC;YACtE,IAAI,QAAQ,EAAE,OAAO;gBAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/internal/itemStack.d.ts

@@ -0,0 +1,27 @@
+import type { Item } from "./item.js";
+import type { AddOn } from "./addon.js";
+/**
+ * Represents a recipe output — an item definition paired with the number of
+ * items produced. Bedrock recipes can yield more than one of an item, e.g.
+ * a shaped recipe for `minecraft:stick` produces 4.
+ *
+ * `item` is null when the result identifier exists in the recipe file but has
+ * no corresponding item definition in the behavior pack.
+ *
+ * @example
+ * ```ts
+ * const stack = addon.getRecipesFor("minecraft:stick")[0]?.getResultStack();
+ * console.log(stack?.item?.identifier); // "minecraft:stick"
+ * console.log(stack?.count);            // 4
+ * ```
+ */
+export declare class ItemStack {
+    /** The resolved item definition, or null if not found in the addon. */
+    readonly item: Item | null;
+    /** The raw identifier string from the recipe file, e.g. `"minecraft:stick"`. */
+    readonly identifier: string;
+    /** How many items this recipe produces. Always at least 1. */
+    readonly count: number;
+    constructor(identifier: string, count: number, addon: AddOn);
+}
+//# sourceMappingURL=itemStack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itemStack.d.ts","sourceRoot":"","sources":["../../src/internal/itemStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS;IACpB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAK5D"}

package/dist/internal/itemStack.js

@@ -0,0 +1,23 @@
+/**
+ * Represents a recipe output — an item definition paired with the number of
+ * items produced. Bedrock recipes can yield more than one of an item, e.g.
+ * a shaped recipe for `minecraft:stick` produces 4.
+ *
+ * `item` is null when the result identifier exists in the recipe file but has
+ * no corresponding item definition in the behavior pack.
+ *
+ * @example
+ * ```ts
+ * const stack = addon.getRecipesFor("minecraft:stick")[0]?.getResultStack();
+ * console.log(stack?.item?.identifier); // "minecraft:stick"
+ * console.log(stack?.count);            // 4
+ * ```
+ */
+export class ItemStack {
+    constructor(identifier, count, addon) {
+        this.identifier = identifier;
+        this.count = count;
+        this.item = addon.getItem(identifier);
+    }
+}
+//# sourceMappingURL=itemStack.js.map

package/dist/internal/itemStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemStack.js","sourceRoot":"","sources":["../../src/internal/itemStack.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IAQpB,YAAY,UAAkB,EAAE,KAAa,EAAE,KAAY;QACzD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/internal/lootTable.d.ts

@@ -0,0 +1,38 @@
+import type { LootEntry, LootPool } from "./types.js";
+export type { LootEntry, LootPool };
+/**
+ * Represents a loot table file from the behavior pack's `loot_tables/` directory.
+ * Loot tables define what items drop from entities, blocks, or chests.
+ *
+ * @example
+ * ```ts
+ * const lt = addon.getLootTableByPath("loot_tables/entities/zombie.json");
+ * console.log(lt?.getItemIdentifiers()); // ["minecraft:rotten_flesh", ...]
+ * ```
+ */
+export declare class LootTable {
+    /** The raw parsed JSON of the loot table file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the loot table file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    /** Path relative to the behavior pack root, e.g. `"loot_tables/entities/zombie.json"`. */
+    readonly relativePath: string;
+    /** The parsed list of loot pools. Each pool rolls independently. */
+    readonly pools: LootPool[];
+    constructor(data: Record<string, unknown>, filePath: string, relativePath: string);
+    /**
+     * Returns a flat, deduplicated list of all item identifiers that can drop
+     * from this loot table. Only includes entries of type `"item"`.
+     *
+     * @example
+     * ```ts
+     * lt.getItemIdentifiers(); // ["minecraft:rotten_flesh", "minecraft:iron_ingot"]
+     * ```
+     */
+    getItemIdentifiers(): string[];
+    private _parsePools;
+}
+//# sourceMappingURL=lootTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lootTable.d.ts","sourceRoot":"","sources":["../../src/internal/lootTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAEf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAOjF;;;;;;;;OAQG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B,OAAO,CAAC,WAAW;CAoBpB"}

package/dist/internal/lootTable.js

@@ -0,0 +1,57 @@
+/**
+ * Represents a loot table file from the behavior pack's `loot_tables/` directory.
+ * Loot tables define what items drop from entities, blocks, or chests.
+ *
+ * @example
+ * ```ts
+ * const lt = addon.getLootTableByPath("loot_tables/entities/zombie.json");
+ * console.log(lt?.getItemIdentifiers()); // ["minecraft:rotten_flesh", ...]
+ * ```
+ */
+export class LootTable {
+    constructor(data, filePath, relativePath) {
+        this.data = data;
+        this.filePath = filePath;
+        this.relativePath = relativePath;
+        this.pools = this._parsePools(data);
+    }
+    /**
+     * Returns a flat, deduplicated list of all item identifiers that can drop
+     * from this loot table. Only includes entries of type `"item"`.
+     *
+     * @example
+     * ```ts
+     * lt.getItemIdentifiers(); // ["minecraft:rotten_flesh", "minecraft:iron_ingot"]
+     * ```
+     */
+    getItemIdentifiers() {
+        const ids = [];
+        for (const pool of this.pools)
+            for (const entry of pool.entries)
+                if (entry.type === "item" && entry.name)
+                    ids.push(entry.name);
+        return [...new Set(ids)];
+    }
+    _parsePools(data) {
+        const raw = data["pools"];
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map((p) => {
+            const pool = p;
+            const entries = [];
+            if (Array.isArray(pool["entries"])) {
+                for (const e of pool["entries"]) {
+                    entries.push({
+                        type: e["type"] ?? "item",
+                        name: e["name"] ?? null,
+                        weight: e["weight"] ?? 1,
+                        functions: Array.isArray(e["functions"])
+                            ? e["functions"] : [],
+                    });
+                }
+            }
+            return { rolls: pool["rolls"], entries };
+        });
+    }
+}
+//# sourceMappingURL=lootTable.js.map

package/dist/internal/lootTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lootTable.js","sourceRoot":"","sources":["../../src/internal/lootTable.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,OAAO,SAAS;IAapB,YAAY,IAA6B,EAAE,QAAgB,EAAE,YAAoB;QAC/E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;OAQG;IACH,kBAAkB;QAChB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI;oBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IAEO,WAAW,CAAC,IAA6B;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,CAA4B,CAAC;YAC1C,MAAM,OAAO,GAAgB,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAA8B,EAAE,CAAC;oBAC7D,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAG,CAAC,CAAC,MAAM,CAAY,IAAI,MAAM;wBACrC,IAAI,EAAG,CAAC,CAAC,MAAM,CAAY,IAAI,IAAI;wBACnC,MAAM,EAAG,CAAC,CAAC,QAAQ,CAAY,IAAI,CAAC;wBACpC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;4BACtC,CAAC,CAAE,CAAC,CAAC,WAAW,CAA+B,CAAC,CAAC,CAAC,EAAE;qBACvD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAsB,EAAE,OAAO,EAAE,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/internal/particle.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Represents a particle effect definition from the resource pack's `particles/` directory.
+ *
+ * @example
+ * ```ts
+ * const particle = addon.getParticle("minecraft:stunned_emitter");
+ * console.log(particle?.texturePath); // "textures/particle/particles"
+ * ```
+ */
+export declare class Particle {
+    /** The namespaced particle identifier, e.g. `"minecraft:stunned_emitter"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the particle file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the particle 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();
+    /**
+     * The texture path used by this particle effect, as defined in `basic_render_parameters.texture`.
+     * e.g. `"textures/particle/particles"`. Returns null if not specified.
+     */
+    get texturePath(): string | null;
+    /**
+     * The material used by this particle effect, as defined in `basic_render_parameters.material`.
+     * e.g. `"particles_alpha"`. Returns null if not specified.
+     */
+    get material(): string | null;
+    /** The full components object for this particle effect. */
+    get components(): Record<string, unknown>;
+}
+//# sourceMappingURL=particle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../../src/internal/particle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,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;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAG/B;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAG5B;IAED,2DAA2D;IAC3D,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGxC;CACF"}

package/dist/internal/particle.js

@@ -0,0 +1,42 @@
+/**
+ * Represents a particle effect definition from the resource pack's `particles/` directory.
+ *
+ * @example
+ * ```ts
+ * const particle = addon.getParticle("minecraft:stunned_emitter");
+ * console.log(particle?.texturePath); // "textures/particle/particles"
+ * ```
+ */
+export class Particle {
+    constructor(identifier, data, filePath) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+    }
+    get _description() {
+        const inner = this.data["particle_effect"] ?? {};
+        return inner["description"] ?? {};
+    }
+    /**
+     * The texture path used by this particle effect, as defined in `basic_render_parameters.texture`.
+     * e.g. `"textures/particle/particles"`. Returns null if not specified.
+     */
+    get texturePath() {
+        const params = this._description["basic_render_parameters"];
+        return params?.["texture"] ?? null;
+    }
+    /**
+     * The material used by this particle effect, as defined in `basic_render_parameters.material`.
+     * e.g. `"particles_alpha"`. Returns null if not specified.
+     */
+    get material() {
+        const params = this._description["basic_render_parameters"];
+        return params?.["material"] ?? null;
+    }
+    /** The full components object for this particle effect. */
+    get components() {
+        const inner = this.data["particle_effect"] ?? {};
+        return inner["components"] ?? {};
+    }
+}
+//# sourceMappingURL=particle.js.map

package/dist/internal/particle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle.js","sourceRoot":"","sources":["../../src/internal/particle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAQ;IAWnB,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,iBAAiB,CAA6B,IAAI,EAAE,CAAC;QAC9E,OAAQ,KAAK,CAAC,aAAa,CAA6B,IAAI,EAAE,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,yBAAyB,CAAwC,CAAC;QACnG,OAAQ,MAAM,EAAE,CAAC,SAAS,CAAY,IAAI,IAAI,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,yBAAyB,CAAwC,CAAC;QACnG,OAAQ,MAAM,EAAE,CAAC,UAAU,CAAY,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,2DAA2D;IAC3D,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;CACF"}