bedrock-kit 0.0.3

package/dist/internal/recipe.d.ts

@@ -0,0 +1,89 @@
+import type { AddOn } from "./addon.js";
+import type { RecipeType } from "./types.js";
+import { Tag } from "./tag.js";
+import { ItemStack } from "./itemStack.js";
+import type { Item } from "./item.js";
+import type { Ingredient, ShapelessIngredient, FurnaceResolved, BrewingResolved } from "./tag.js";
+export type { RecipeType };
+/**
+ * Represents a single recipe file from the behavior pack's `recipes/` directory.
+ * Supports shaped, shapeless, furnace, and brewing recipe types.
+ *
+ * @example
+ * ```ts
+ * const recipes = addon.getRecipesFor("minecraft:copper_spear");
+ * const shaped = recipes.find(r => r.type === "shaped");
+ * const grid = shaped?.resolveShape();
+ * // grid[0][2] instanceof Item -> true
+ * ```
+ */
+export declare class Recipe {
+    /** The raw parsed JSON of the recipe file. */
+    readonly data: Record<string, unknown>;
+    /** The recipe type as detected from the root JSON key. */
+    readonly type: RecipeType;
+    /**
+     * Pattern rows for shaped recipes, e.g. `["X ", "X ", "X "]`.
+     * Null for non-shaped recipes.
+     */
+    readonly shape: string[] | null;
+    /**
+     * Raw ingredient data extracted from the recipe file.
+     * Prefer the typed resolve methods over reading this directly.
+     */
+    readonly ingredients: Record<string, string> | string[];
+    private readonly _addon;
+    constructor(data: Record<string, unknown>, addon: AddOn);
+    private _detectType;
+    private _extractIngredients;
+    private _parseResult;
+    /**
+     * Returns the output of this recipe as an `ItemStack`, or null if the recipe
+     * has no result (e.g. some brewing recipes).
+     *
+     * `ItemStack.item` is null when the result identifier has no matching item
+     * definition in the behavior pack. `ItemStack.count` reflects the exact
+     * output quantity specified in the recipe file, defaulting to 1.
+     *
+     * @example
+     * ```ts
+     * const stack = addon.getRecipesFor("minecraft:stick")[0]?.getResultStack();
+     * console.log(stack?.count);            // 4
+     * console.log(stack?.item?.identifier); // "minecraft:stick"
+     * ```
+     */
+    getResultStack(): ItemStack | null;
+    /** @deprecated Use `getResultStack()` instead. */
+    getResultItem(): Item | null;
+    /**
+     * Shaped: returns a 2D grid matching the pattern.
+     * Each cell is an Item, a Tag, or null for an empty slot.
+     * Returns null if this recipe is not shaped.
+     */
+    resolveShape(): Ingredient[][] | null;
+    /**
+     * Shapeless: returns each ingredient as an Item or Tag with its count.
+     * Returns null if this recipe is not shapeless.
+     */
+    resolveShapeless(): ShapelessIngredient[] | null;
+    /**
+     * Furnace: returns input and output as Item or Tag objects.
+     * Returns null if this recipe is not a furnace recipe.
+     */
+    resolveFurnace(): FurnaceResolved | null;
+    /**
+     * Brewing: returns input, reagent, and output as Item or Tag objects.
+     * Returns null if this recipe is not a brewing recipe.
+     */
+    resolveBrewing(): BrewingResolved | null;
+    /**
+     * Returns a flat array of all ingredients across the recipe as `Item | Tag` objects.
+     * Empty slots are excluded.
+     */
+    getAllIngredients(): Array<Item | Tag>;
+    private _resolveIngredientStr;
+    /** Returns true if this recipe uses the given item identifier as an ingredient, regardless of whether it is in the addon's item store. */
+    usesItem(identifier: string): boolean;
+    private _allIngredientStrings;
+}
+//# sourceMappingURL=recipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../src/internal/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,qBAAa,MAAM;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IAExD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK;IAUvD,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IAWpB;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI,SAAS,GAAG,IAAI;IAQlC,kDAAkD;IAClD,aAAa,IAAI,IAAI,GAAG,IAAI;IAI5B;;;;OAIG;IACH,YAAY,IAAI,UAAU,EAAE,EAAE,GAAG,IAAI;IAYrC;;;OAGG;IACH,gBAAgB,IAAI,mBAAmB,EAAE,GAAG,IAAI;IAahD;;;OAGG;IACH,cAAc,IAAI,eAAe,GAAG,IAAI;IAUxC;;;OAGG;IACH,cAAc,IAAI,eAAe,GAAG,IAAI;IAWxC;;;OAGG;IACH,iBAAiB,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;IAQtC,OAAO,CAAC,qBAAqB;IAM7B,0IAA0I;IAC1I,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,qBAAqB;CAiB9B"}

package/dist/internal/recipe.js

@@ -0,0 +1,198 @@
+import { Tag } from "./tag.js";
+import { ItemStack } from "./itemStack.js";
+import { parseIngredient } from "./utils.js";
+/**
+ * Represents a single recipe file from the behavior pack's `recipes/` directory.
+ * Supports shaped, shapeless, furnace, and brewing recipe types.
+ *
+ * @example
+ * ```ts
+ * const recipes = addon.getRecipesFor("minecraft:copper_spear");
+ * const shaped = recipes.find(r => r.type === "shaped");
+ * const grid = shaped?.resolveShape();
+ * // grid[0][2] instanceof Item -> true
+ * ```
+ */
+export class Recipe {
+    constructor(data, addon) {
+        this.data = data;
+        this._addon = addon;
+        const recipeKey = Object.keys(data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? data[recipeKey] : {};
+        this.type = this._detectType(recipeKey ?? "");
+        this.shape = Array.isArray(inner["pattern"]) ? inner["pattern"] : null;
+        this.ingredients = this._extractIngredients(inner);
+    }
+    _detectType(key) {
+        if (key.includes("shaped"))
+            return "shaped";
+        if (key.includes("shapeless"))
+            return "shapeless";
+        if (key.includes("furnace"))
+            return "furnace";
+        if (key.includes("brewing_mix"))
+            return "brewing_mix";
+        if (key.includes("brewing_container"))
+            return "brewing_container";
+        return "unknown";
+    }
+    _extractIngredients(inner) {
+        if (inner["key"] && typeof inner["key"] === "object" && !Array.isArray(inner["key"])) {
+            const keyMap = inner["key"];
+            const result = {};
+            for (const [symbol, value] of Object.entries(keyMap))
+                result[symbol] = parseIngredient(value);
+            return result;
+        }
+        if (Array.isArray(inner["ingredients"])) {
+            return inner["ingredients"].map(parseIngredient);
+        }
+        return {};
+    }
+    _parseResult(inner) {
+        if (!inner["result"])
+            return null;
+        if (typeof inner["result"] === "string")
+            return { identifier: inner["result"], count: 1 };
+        const r = inner["result"];
+        const identifier = r["item"] ?? r["block"] ?? null;
+        if (!identifier)
+            return null;
+        const count = typeof r["count"] === "number" ? r["count"] : 1;
+        return { identifier, count };
+    }
+    /**
+     * Returns the output of this recipe as an `ItemStack`, or null if the recipe
+     * has no result (e.g. some brewing recipes).
+     *
+     * `ItemStack.item` is null when the result identifier has no matching item
+     * definition in the behavior pack. `ItemStack.count` reflects the exact
+     * output quantity specified in the recipe file, defaulting to 1.
+     *
+     * @example
+     * ```ts
+     * const stack = addon.getRecipesFor("minecraft:stick")[0]?.getResultStack();
+     * console.log(stack?.count);            // 4
+     * console.log(stack?.item?.identifier); // "minecraft:stick"
+     * ```
+     */
+    getResultStack() {
+        const recipeKey = Object.keys(this.data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? this.data[recipeKey] : {};
+        const parsed = this._parseResult(inner);
+        if (!parsed)
+            return null;
+        return new ItemStack(parsed.identifier, parsed.count, this._addon);
+    }
+    /** @deprecated Use `getResultStack()` instead. */
+    getResultItem() {
+        return this.getResultStack()?.item ?? null;
+    }
+    /**
+     * Shaped: returns a 2D grid matching the pattern.
+     * Each cell is an Item, a Tag, or null for an empty slot.
+     * Returns null if this recipe is not shaped.
+     */
+    resolveShape() {
+        if (this.type !== "shaped" || !this.shape)
+            return null;
+        const keyMap = this.ingredients;
+        return this.shape.map((row) => row.split("").map((char) => {
+            if (char === " ")
+                return null;
+            const raw = keyMap[char] ?? "";
+            return this._resolveIngredientStr(raw);
+        }));
+    }
+    /**
+     * Shapeless: returns each ingredient as an Item or Tag with its count.
+     * Returns null if this recipe is not shapeless.
+     */
+    resolveShapeless() {
+        if (this.type !== "shapeless")
+            return null;
+        const recipeKey = Object.keys(this.data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? this.data[recipeKey] : {};
+        const raw = inner["ingredients"];
+        if (!Array.isArray(raw))
+            return [];
+        return raw.flatMap((entry) => {
+            const ingredient = this._resolveIngredientStr(parseIngredient(entry));
+            if (!ingredient)
+                return [];
+            return [{ ingredient, count: entry["count"] ?? 1 }];
+        });
+    }
+    /**
+     * Furnace: returns input and output as Item or Tag objects.
+     * Returns null if this recipe is not a furnace recipe.
+     */
+    resolveFurnace() {
+        if (this.type !== "furnace")
+            return null;
+        const recipeKey = Object.keys(this.data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? this.data[recipeKey] : {};
+        const input = this._resolveIngredientStr(parseIngredient(inner["input"]));
+        const output = this._resolveIngredientStr(parseIngredient(inner["output"]));
+        if (!input || !output)
+            return null;
+        return { input, output };
+    }
+    /**
+     * Brewing: returns input, reagent, and output as Item or Tag objects.
+     * Returns null if this recipe is not a brewing recipe.
+     */
+    resolveBrewing() {
+        if (this.type !== "brewing_mix" && this.type !== "brewing_container")
+            return null;
+        const recipeKey = Object.keys(this.data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? this.data[recipeKey] : {};
+        const input = this._resolveIngredientStr(parseIngredient(inner["input"]));
+        const reagent = this._resolveIngredientStr(parseIngredient(inner["reagent"]));
+        const output = this._resolveIngredientStr(parseIngredient(inner["output"]));
+        if (!input || !reagent || !output)
+            return null;
+        return { input, reagent, output };
+    }
+    /**
+     * Returns a flat array of all ingredients across the recipe as `Item | Tag` objects.
+     * Empty slots are excluded.
+     */
+    getAllIngredients() {
+        const strs = this._allIngredientStrings();
+        return strs.flatMap((s) => {
+            const r = this._resolveIngredientStr(s);
+            return r ? [r] : [];
+        });
+    }
+    _resolveIngredientStr(raw) {
+        if (!raw)
+            return null;
+        if (raw.startsWith("tag:"))
+            return new Tag(raw.slice(4));
+        return this._addon.getItem(raw) ?? new Tag(raw);
+    }
+    /** Returns true if this recipe uses the given item identifier as an ingredient, regardless of whether it is in the addon's item store. */
+    usesItem(identifier) {
+        return this._allIngredientStrings().some((s) => s === identifier);
+    }
+    _allIngredientStrings() {
+        const recipeKey = Object.keys(this.data).find((k) => k.startsWith("minecraft:recipe_"));
+        const inner = recipeKey ? this.data[recipeKey] : {};
+        const strs = [];
+        if (inner["key"] && typeof inner["key"] === "object" && !Array.isArray(inner["key"])) {
+            for (const v of Object.values(inner["key"]))
+                strs.push(parseIngredient(v));
+        }
+        if (Array.isArray(inner["ingredients"])) {
+            for (const v of inner["ingredients"])
+                strs.push(parseIngredient(v));
+        }
+        for (const field of ["input", "reagent", "output"]) {
+            if (inner[field])
+                strs.push(parseIngredient(inner[field]));
+        }
+        return strs.filter(Boolean);
+    }
+}
+//# sourceMappingURL=recipe.js.map

package/dist/internal/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../src/internal/recipe.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAW7C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,MAAM;IAkBjB,YAAY,IAA6B,EAAE,KAAY;QACrD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QACnF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAEO,WAAW,CAAC,GAAW;QAC7B,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC5C,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,WAAW,CAAC;QAClD,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9C,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAO,aAAa,CAAC;QACtD,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAAE,OAAO,mBAAmB,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,mBAAmB,CAAC,KAA8B;QACxD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACrF,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAA4B,CAAC;YACvD,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClD,MAAM,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACxC,OAAQ,KAAK,CAAC,aAAa,CAAe,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,YAAY,CAAC,KAA8B;QACjD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACrC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAA4B,CAAC;QACrD,MAAM,UAAU,GAAI,CAAC,CAAC,MAAM,CAAY,IAAK,CAAC,CAAC,OAAO,CAAY,IAAI,IAAI,CAAC;QAC3E,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,OAAO,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,cAAc;QACZ,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,kDAAkD;IAClD,aAAa;QACX,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAqC,CAAC;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,OAAQ,GAAiC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,UAAU;gBAAE,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAG,KAAK,CAAC,OAAO,CAAY,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;YAAE,OAAO,IAAI,CAAC;QAClF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,qBAAqB,CAAC,GAAW;QACvC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,0IAA0I;IAC1I,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;IACpE,CAAC;IAEO,qBAAqB;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACrF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC;gBACpE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAc;gBAC/C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/internal/renderController.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Represents a single render controller loaded from a resource pack
+ * `render_controllers/` file. Render controllers define which geometry,
+ * materials, and textures are applied to an entity at runtime.
+ *
+ * @example
+ * ```ts
+ * const rc = addon.getRenderController("controller.render.zombie");
+ * console.log(rc?.data); // { geometry: "...", materials: [...], textures: [...] }
+ * ```
+ */
+export declare class RenderController {
+    /** The full controller ID, e.g. `"controller.render.zombie"`. */
+    readonly id: string;
+    /** The raw data for this render controller definition. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the file this controller was loaded from.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    constructor(id: string, data: Record<string, unknown>, filePath: string);
+}
+//# sourceMappingURL=renderController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderController.d.ts","sourceRoot":"","sources":["../../src/internal/renderController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM;CAKxE"}

package/dist/internal/renderController.js

@@ -0,0 +1,19 @@
+/**
+ * Represents a single render controller loaded from a resource pack
+ * `render_controllers/` file. Render controllers define which geometry,
+ * materials, and textures are applied to an entity at runtime.
+ *
+ * @example
+ * ```ts
+ * const rc = addon.getRenderController("controller.render.zombie");
+ * console.log(rc?.data); // { geometry: "...", materials: [...], textures: [...] }
+ * ```
+ */
+export class RenderController {
+    constructor(id, data, filePath) {
+        this.id = id;
+        this.data = data;
+        this.filePath = filePath;
+    }
+}
+//# sourceMappingURL=renderController.js.map

package/dist/internal/renderController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderController.js","sourceRoot":"","sources":["../../src/internal/renderController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IAW3B,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;CACF"}

package/dist/internal/sound.d.ts

@@ -0,0 +1,85 @@
+import type { SoundFile } from "./types.js";
+export type { SoundFile };
+/**
+ * Represents a single entry from `sounds/sound_definitions.json`.
+ * Each definition maps a sound event ID (e.g. `"mob.zombie.say"`) to a list of
+ * audio files and their playback properties.
+ *
+ * @example
+ * ```ts
+ * const def = addon.getSoundDefinition("mob.zombie.say");
+ * console.log(def?.category);       // "mob"
+ * console.log(def?.files[0].name);  // "sounds/mob/zombie/say1"
+ * ```
+ */
+export declare class SoundDefinition {
+    /** The sound event identifier, e.g. `"mob.zombie.say"`. */
+    readonly id: string;
+    /** The raw data for this sound definition entry. */
+    readonly data: Record<string, unknown>;
+    /**
+     * The audio category, e.g. `"ambient"`, `"block"`, `"mob"`, `"music"`, `"player"`, `"ui"`.
+     * Null if not specified.
+     */
+    readonly category: string | null;
+    /** The parsed list of audio files this definition can play. */
+    readonly files: SoundFile[];
+    constructor(id: string, data: Record<string, unknown>);
+    private _parseFiles;
+}
+/**
+ * A resolved sound event binding — the pairing of an event name with the
+ * `SoundDefinition` it maps to. Returned by `Entity.getSoundEvents()` and
+ * `Block.getSoundEvents()`.
+ *
+ * Event values in `sounds.json` can be plain strings (just a definition ID) or
+ * inline objects with overriding `sound`, `pitch`, and `volume` fields.
+ * Both forms are normalised into this shape.
+ *
+ * @example
+ * ```ts
+ * const events = addon.getEntity("minecraft:zombie")?.getSoundEvents() ?? [];
+ * for (const { event, definition } of events) {
+ *   console.log(event, "→", definition?.files[0].name);
+ * }
+ * ```
+ */
+export interface SoundEvent {
+    /** The event name, e.g. `"ambient"`, `"death"`, `"hurt"`. */
+    event: string;
+    /**
+     * The sound definition ID this event resolves to, e.g. `"mob.zombie.say"`.
+     * Empty string means the event is intentionally silent.
+     */
+    definitionId: string;
+    /** The resolved `SoundDefinition`, or null if the ID is not in `sound_definitions.json`. */
+    definition: SoundDefinition | null;
+    /** Per-event volume override from `sounds.json`. Null if not specified. */
+    volume: number | null;
+    /** Per-event pitch override from `sounds.json`. Null if not specified. */
+    pitch: number | [number, number] | null;
+}
+/**
+ * Represents a single entry from `sounds/music_definitions.json`.
+ * Maps a context key (biome shortname, `"game"`, `"menu"`, etc.) to the music
+ * event that plays there and its delay range.
+ *
+ * @example
+ * ```ts
+ * const music = addon.getMusicDefinition("bamboo_jungle");
+ * console.log(music?.eventName); // "music.overworld.bamboo_jungle"
+ * console.log(music?.minDelay);  // 60
+ * ```
+ */
+export declare class MusicDefinition {
+    /** The context key, e.g. `"bamboo_jungle"`, `"game"`, `"menu"`. */
+    readonly id: string;
+    /** The sound event ID to play, e.g. `"music.overworld.bamboo_jungle"`. */
+    readonly eventName: string;
+    /** Minimum seconds before music starts. */
+    readonly minDelay: number;
+    /** Maximum seconds before music starts. */
+    readonly maxDelay: number;
+    constructor(id: string, data: Record<string, unknown>);
+}
+//# sourceMappingURL=sound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sound.d.ts","sourceRoot":"","sources":["../../src/internal/sound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;gBAEhB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOrD,OAAO,CAAC,WAAW;CAepB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOtD"}

package/dist/internal/sound.js

@@ -0,0 +1,64 @@
+/**
+ * Represents a single entry from `sounds/sound_definitions.json`.
+ * Each definition maps a sound event ID (e.g. `"mob.zombie.say"`) to a list of
+ * audio files and their playback properties.
+ *
+ * @example
+ * ```ts
+ * const def = addon.getSoundDefinition("mob.zombie.say");
+ * console.log(def?.category);       // "mob"
+ * console.log(def?.files[0].name);  // "sounds/mob/zombie/say1"
+ * ```
+ */
+export class SoundDefinition {
+    constructor(id, data) {
+        this.id = id;
+        this.data = data;
+        this.category = data["category"] ?? null;
+        this.files = this._parseFiles(data["sounds"]);
+    }
+    _parseFiles(raw) {
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map((entry) => {
+            if (typeof entry === "string")
+                return { name: entry };
+            const e = entry;
+            const result = { name: e["name"] ?? "" };
+            if (typeof e["volume"] === "number")
+                result.volume = e["volume"];
+            if (typeof e["pitch"] === "number")
+                result.pitch = e["pitch"];
+            if (typeof e["weight"] === "number")
+                result.weight = e["weight"];
+            if (typeof e["is3D"] === "boolean")
+                result.is3D = e["is3D"];
+            if (typeof e["stream"] === "boolean")
+                result.stream = e["stream"];
+            if (typeof e["load_on_low_memory"] === "boolean")
+                result.loadOnLowMemory = e["load_on_low_memory"];
+            return result;
+        });
+    }
+}
+/**
+ * Represents a single entry from `sounds/music_definitions.json`.
+ * Maps a context key (biome shortname, `"game"`, `"menu"`, etc.) to the music
+ * event that plays there and its delay range.
+ *
+ * @example
+ * ```ts
+ * const music = addon.getMusicDefinition("bamboo_jungle");
+ * console.log(music?.eventName); // "music.overworld.bamboo_jungle"
+ * console.log(music?.minDelay);  // 60
+ * ```
+ */
+export class MusicDefinition {
+    constructor(id, data) {
+        this.id = id;
+        this.eventName = data["event_name"] ?? "";
+        this.minDelay = data["min_delay"] ?? 0;
+        this.maxDelay = data["max_delay"] ?? 0;
+    }
+}
+//# sourceMappingURL=sound.js.map

package/dist/internal/sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound.js","sourceRoot":"","sources":["../../src/internal/sound.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IAa1B,YAAY,EAAU,EAAE,IAA6B;QACnD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAI,IAAI,CAAC,UAAU,CAAY,IAAI,IAAI,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC;IAEO,WAAW,CAAC,GAAY;QAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,MAAM,MAAM,GAAc,EAAE,IAAI,EAAG,CAAC,CAAC,MAAM,CAAY,IAAI,EAAE,EAAE,CAAC;YAChE,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAW,CAAC;YAC3E,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAW,CAAC;YACxE,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAW,CAAC;YAC3E,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS;gBAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAY,CAAC;YACvE,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,SAAS;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAY,CAAC;YAC7E,IAAI,OAAO,CAAC,CAAC,oBAAoB,CAAC,KAAK,SAAS;gBAAE,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC,oBAAoB,CAAY,CAAC;YAC9G,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAmCD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IAU1B,YAAY,EAAU,EAAE,IAA6B;QACnD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAI,IAAI,CAAC,YAAY,CAAY,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAI,IAAI,CAAC,WAAW,CAAY,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAI,IAAI,CAAC,WAAW,CAAY,IAAI,CAAC,CAAC;IACrD,CAAC;CAEF"}

package/dist/internal/spawnRule.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Represents a spawn rule file from the behavior pack's `spawn_rules/` directory.
+ * Spawn rules define when and where an entity can naturally spawn in the world.
+ *
+ * @example
+ * ```ts
+ * const rule = addon.getSpawnRule("minecraft:zombie");
+ * console.log(rule?.populationControl); // "monster"
+ * console.log(rule?.getBiomeTags());    // ["monster", "overworld"]
+ * ```
+ */
+export declare class SpawnRule {
+    /** The namespaced entity identifier this spawn rule applies to, e.g. `"minecraft:zombie"`. */
+    readonly identifier: string;
+    /** The raw parsed JSON of the spawn rule file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the spawn rule file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    /**
+     * The population control group that limits how many of this entity spawn together.
+     * Common values: `"animal"`, `"monster"`, `"ambient"`, `"water_animal"`.
+     * Null if not specified.
+     */
+    readonly populationControl: string | null;
+    /** The raw condition objects from the spawn rule. Each condition defines spawn requirements. */
+    readonly conditions: Record<string, unknown>[];
+    constructor(identifier: string, data: Record<string, unknown>, filePath: string);
+    /**
+     * Extracts all biome tag values referenced in this spawn rule's `minecraft:biome_filter`
+     * conditions. Tags are used to match biomes — e.g. `"monster"`, `"savanna"`, `"mesa"`.
+     *
+     * @returns Deduplicated list of biome tag strings.
+     *
+     * @example
+     * ```ts
+     * addon.getSpawnRule("minecraft:armadillo")?.getBiomeTags(); // ["savanna", "mesa", "plateau"]
+     * ```
+     */
+    getBiomeTags(): string[];
+}
+//# sourceMappingURL=spawnRule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawnRule.d.ts","sourceRoot":"","sources":["../../src/internal/spawnRule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,8FAA8F;IAC9F,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;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;gBAEnC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM;IAW/E;;;;;;;;;;OAUG;IACH,YAAY,IAAI,MAAM,EAAE;CAqBzB"}

package/dist/internal/spawnRule.js

@@ -0,0 +1,57 @@
+/**
+ * Represents a spawn rule file from the behavior pack's `spawn_rules/` directory.
+ * Spawn rules define when and where an entity can naturally spawn in the world.
+ *
+ * @example
+ * ```ts
+ * const rule = addon.getSpawnRule("minecraft:zombie");
+ * console.log(rule?.populationControl); // "monster"
+ * console.log(rule?.getBiomeTags());    // ["monster", "overworld"]
+ * ```
+ */
+export class SpawnRule {
+    constructor(identifier, data, filePath) {
+        this.identifier = identifier;
+        this.data = data;
+        this.filePath = filePath;
+        const inner = data["minecraft:spawn_rules"] ?? {};
+        const desc = inner["description"] ?? {};
+        this.populationControl = desc["population_control"] ?? null;
+        this.conditions = Array.isArray(inner["conditions"])
+            ? inner["conditions"] : [];
+    }
+    /**
+     * Extracts all biome tag values referenced in this spawn rule's `minecraft:biome_filter`
+     * conditions. Tags are used to match biomes — e.g. `"monster"`, `"savanna"`, `"mesa"`.
+     *
+     * @returns Deduplicated list of biome tag strings.
+     *
+     * @example
+     * ```ts
+     * addon.getSpawnRule("minecraft:armadillo")?.getBiomeTags(); // ["savanna", "mesa", "plateau"]
+     * ```
+     */
+    getBiomeTags() {
+        const tags = [];
+        for (const cond of this.conditions) {
+            const filter = cond["minecraft:biome_filter"];
+            if (!filter)
+                continue;
+            const filters = Array.isArray(filter) ? filter : [filter];
+            for (const f of filters) {
+                if (f["test"] === "has_biome_tag" && typeof f["value"] === "string")
+                    tags.push(f["value"]);
+                for (const key of ["all_of", "any_of"]) {
+                    if (Array.isArray(f[key])) {
+                        for (const sub of f[key]) {
+                            if (sub["test"] === "has_biome_tag" && typeof sub["value"] === "string")
+                                tags.push(sub["value"]);
+                        }
+                    }
+                }
+            }
+        }
+        return [...new Set(tags)];
+    }
+}
+//# sourceMappingURL=spawnRule.js.map

package/dist/internal/spawnRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnRule.js","sourceRoot":"","sources":["../../src/internal/spawnRule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IAmBpB,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;QACzB,MAAM,KAAK,GAAI,IAAI,CAAC,uBAAuB,CAA6B,IAAI,EAAE,CAAC;QAC/E,MAAM,IAAI,GAAI,KAAK,CAAC,aAAa,CAA6B,IAAI,EAAE,CAAC;QACrE,IAAI,CAAC,iBAAiB,GAAI,IAAI,CAAC,oBAAoB,CAAY,IAAI,IAAI,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAClD,CAAC,CAAE,KAAK,CAAC,YAAY,CAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY;QACV,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC1D,KAAK,MAAM,CAAC,IAAI,OAAoC,EAAE,CAAC;gBACrD,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,eAAe,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ;oBACjE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAW,CAAC,CAAC;gBAClC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACvC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;wBAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAA8B,EAAE,CAAC;4BACtD,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,eAAe,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ;gCACrE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAW,CAAC,CAAC;wBACtC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF"}