bedrock-kit 0.0.3

package/dist/internal/tag.d.ts

@@ -0,0 +1,43 @@
+import type { Item } from "./item.js";
+/**
+ * Represents a Bedrock tag ingredient in a recipe (e.g. "minecraft:planks").
+ * Use instanceof Tag to distinguish from Item in resolve results.
+ */
+export declare class Tag {
+    /** The tag identifier without any prefix, e.g. "minecraft:planks". */
+    readonly id: string;
+    constructor(id: string);
+}
+/**
+ * A single ingredient slot in a recipe.
+ * - `Item` — a resolved item from the addon.
+ * - `Tag` — a tag reference (e.g. `minecraft:planks`) that may match multiple items.
+ * - `null` — an empty slot (shaped recipes only).
+ *
+ * Use `instanceof Item` or `instanceof Tag` to distinguish at runtime.
+ */
+export type Ingredient = Item | Tag | null;
+/** A single ingredient in a shapeless recipe, with its required count. */
+export interface ShapelessIngredient {
+    /** The resolved ingredient — either a specific Item or a Tag. */
+    ingredient: Item | Tag;
+    /** How many of this ingredient are required. Defaults to 1 if not specified in the file. */
+    count: number;
+}
+/** The resolved form of a furnace recipe. */
+export interface FurnaceResolved {
+    /** The item or tag to smelt. */
+    input: Item | Tag;
+    /** The item produced by smelting. */
+    output: Item | Tag;
+}
+/** The resolved form of a brewing recipe. */
+export interface BrewingResolved {
+    /** The base potion being brewed. */
+    input: Item | Tag;
+    /** The ingredient added to the brewing stand. */
+    reagent: Item | Tag;
+    /** The resulting potion. */
+    output: Item | Tag;
+}
+//# sourceMappingURL=tag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/internal/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;GAGG;AACH,qBAAa,GAAG;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBACR,EAAE,EAAE,MAAM;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,UAAU,EAAE,IAAI,GAAG,GAAG,CAAC;IACvB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC;IAClB,qCAAqC;IACrC,MAAM,EAAE,IAAI,GAAG,GAAG,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,IAAI,GAAG,GAAG,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,IAAI,GAAG,GAAG,CAAC;CACpB"}

package/dist/internal/tag.js

@@ -0,0 +1,8 @@
+/**
+ * Represents a Bedrock tag ingredient in a recipe (e.g. "minecraft:planks").
+ * Use instanceof Tag to distinguish from Item in resolve results.
+ */
+export class Tag {
+    constructor(id) { this.id = id; }
+}
+//# sourceMappingURL=tag.js.map

package/dist/internal/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/internal/tag.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,GAAG;IAGd,YAAY,EAAU,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;CAC1C"}

package/dist/internal/tradingTable.d.ts

@@ -0,0 +1,34 @@
+import type { Trade, TradeTier, TradeItem } from "./types.js";
+export type { Trade, TradeTier, TradeItem };
+/**
+ * Represents a villager trading table from the behavior pack's `trading/` directory.
+ * Trading tables define the tiers of trades available for a villager profession.
+ *
+ * @example
+ * ```ts
+ * const table = addon.getTradingTable("armorer_trades");
+ * console.log(table?.tiers[0].trades[0]);
+ * ```
+ */
+export declare class TradingTable {
+    /** The raw parsed JSON of the trading table file. */
+    readonly data: Record<string, unknown>;
+    /**
+     * Absolute path to the trading table file on disk.
+     * Empty string when loaded from browser `File[]`.
+     */
+    readonly filePath: string;
+    /** The file name without extension, used as the lookup key. e.g. `"armorer_trades"`. */
+    readonly name: string;
+    /** The ordered list of trade tiers. Players unlock higher tiers by completing trades. */
+    readonly tiers: TradeTier[];
+    constructor(data: Record<string, unknown>, filePath: string, name: string);
+    /**
+     * Returns a flat deduplicated list of every item identifier referenced
+     * across all tiers and trades, including both wanted and given items.
+     */
+    getAllItemIdentifiers(): string[];
+    private _parseTiers;
+    private _parseTradeItems;
+}
+//# sourceMappingURL=tradingTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tradingTable.d.ts","sourceRoot":"","sources":["../../src/internal/tradingTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAE5C;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;gBAEhB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAOzE;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAUjC,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/internal/tradingTable.js

@@ -0,0 +1,62 @@
+/**
+ * Represents a villager trading table from the behavior pack's `trading/` directory.
+ * Trading tables define the tiers of trades available for a villager profession.
+ *
+ * @example
+ * ```ts
+ * const table = addon.getTradingTable("armorer_trades");
+ * console.log(table?.tiers[0].trades[0]);
+ * ```
+ */
+export class TradingTable {
+    constructor(data, filePath, name) {
+        this.data = data;
+        this.filePath = filePath;
+        this.name = name;
+        this.tiers = this._parseTiers(data);
+    }
+    /**
+     * Returns a flat deduplicated list of every item identifier referenced
+     * across all tiers and trades, including both wanted and given items.
+     */
+    getAllItemIdentifiers() {
+        const ids = [];
+        for (const tier of this.tiers)
+            for (const trade of tier.trades) {
+                for (const w of trade.wants)
+                    ids.push(w.item);
+                for (const g of trade.gives)
+                    ids.push(g.item);
+            }
+        return [...new Set(ids)];
+    }
+    _parseTiers(data) {
+        const raw = data["tiers"];
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map((t) => {
+            const tier = t;
+            const tradeSource = Array.isArray(tier["trades"])
+                ? tier["trades"]
+                : Array.isArray(tier["groups"])
+                    ? tier["groups"].flatMap((g) => Array.isArray(g["trades"])
+                        ? g["trades"]
+                        : [])
+                    : [];
+            const trades = tradeSource.map((tr) => ({
+                wants: this._parseTradeItems(tr["wants"]),
+                gives: this._parseTradeItems(tr["gives"]),
+            }));
+            return { trades };
+        });
+    }
+    _parseTradeItems(raw) {
+        if (!Array.isArray(raw))
+            return [];
+        return raw.map((r) => ({
+            item: r["item"] ?? "",
+            quantity: r["quantity"] ?? 1,
+        }));
+    }
+}
+//# sourceMappingURL=tradingTable.js.map

package/dist/internal/tradingTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradingTable.js","sourceRoot":"","sources":["../../src/internal/tradingTable.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IAavB,YAAY,IAA6B,EAAE,QAAgB,EAAE,IAAY;QACvE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;QACH,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,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/C,CAAC,CAAE,IAAI,CAAC,QAAQ,CAA+B;gBAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC,CAAE,IAAI,CAAC,QAAQ,CAA+B,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,KAAK,CAAC,OAAO,CAAE,CAA6B,CAAC,QAAQ,CAAC,CAAC;wBACrD,CAAC,CAAG,CAA6B,CAAC,QAAQ,CAA+B;wBACzE,CAAC,CAAC,EAAE,CACP;oBACH,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,MAAM,GAAY,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC/C,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBACzC,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;aAC1C,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,GAAY;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,OAAQ,GAAiC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAG,CAAC,CAAC,MAAM,CAAY,IAAI,EAAE;YACjC,QAAQ,EAAG,CAAC,CAAC,UAAU,CAA2B,IAAI,CAAC;SACxD,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/internal/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The parsed structure of a resource pack's `textures/item_texture.json`.
+ * Maps shortnames (e.g. `"iron_sword"`) to texture file paths.
+ */
+export interface ItemTextureMap {
+    resource_pack_name: string;
+    texture_name: string;
+    /** Map of shortname → texture path(s). Used internally to resolve item icon paths. */
+    texture_data: Record<string, {
+        textures: string | string[];
+    }>;
+}
+/**
+ * The parsed structure of a resource pack's `textures/terrain_texture.json`.
+ * Maps shortnames to block texture file paths.
+ */
+export interface TerrainTextureMap {
+    resource_pack_name: string;
+    texture_name: string;
+    /** Map of shortname → texture path(s). Used internally to resolve block face texture paths. */
+    texture_data: Record<string, {
+        textures: string | string[];
+    }>;
+}
+/**
+ * The type of a recipe as determined by its root JSON key.
+ * - `"shaped"` — crafting table recipe with a fixed pattern grid.
+ * - `"shapeless"` — crafting table recipe with an unordered ingredient list.
+ * - `"furnace"` — smelting recipe for a furnace or blast furnace.
+ * - `"brewing_mix"` — potion brewing recipe (input potion + reagent → output potion).
+ * - `"brewing_container"` — brewing recipe that modifies the container item.
+ * - `"unknown"` — unrecognised recipe type.
+ */
+export type RecipeType = "shaped" | "shapeless" | "furnace" | "brewing_mix" | "brewing_container" | "unknown";
+/** A single entry within a loot pool, representing one possible drop. */
+export interface LootEntry {
+    /** The entry type — typically `"item"`, `"loot_table"`, or `"empty"`. */
+    type: string;
+    /** The item or nested loot table identifier. Null for `"empty"` type entries. */
+    name: string | null;
+    /** Relative drop weight. Higher values are more likely. */
+    weight: number;
+    /** Optional function modifiers such as `set_count`, `enchant_randomly`, etc. */
+    functions: Record<string, unknown>[];
+}
+/** A single roll group within a loot table. Each pool rolls independently. */
+export interface LootPool {
+    /** How many times this pool is rolled. Can be a fixed number or a min/max range. */
+    rolls: number | {
+        min: number;
+        max: number;
+    };
+    /** The possible entries for each roll. */
+    entries: LootEntry[];
+}
+/** A single item entry in a villager trade — either wanted or given. */
+export interface TradeItem {
+    /** The namespaced item identifier, e.g. `"minecraft:emerald"`. */
+    item: string;
+    /** How many of this item are required or given. Can be a fixed number or a min/max range. */
+    quantity: number | {
+        min: number;
+        max: number;
+    };
+}
+/** A single villager trade exchange. */
+export interface Trade {
+    /** Items the player must provide. */
+    wants: TradeItem[];
+    /** Items the villager gives in return. */
+    gives: TradeItem[];
+}
+/** A single unlock tier in a villager trading table. */
+export interface TradeTier {
+    trades: Trade[];
+}
+/**
+ * A single audio file entry within a sound definition.
+ * Entries in `sound_definitions.json` can be plain path strings or full objects.
+ */
+export interface SoundFile {
+    /** Path to the audio file relative to the resource pack root, no extension. */
+    name: string;
+    /** Relative playback volume. Absent means use the definition-level default. */
+    volume?: number;
+    /** Pitch multiplier. Absent means use the definition-level default. */
+    pitch?: number;
+    /** Relative selection weight. Higher = more likely to be chosen. */
+    weight?: number;
+    /** Whether this sound is positional (3D). */
+    is3D?: boolean;
+    /** Whether this sound streams from disk rather than loading into memory. */
+    stream?: boolean;
+    /** Whether this sound loads on low-memory devices. */
+    loadOnLowMemory?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC/D;AAID;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GAAG,WAAW,GAAG,SAAS,GAClC,aAAa,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAIpD,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACtC;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,oFAAoF;IACpF,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,0CAA0C;IAC1C,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAID,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,wCAAwC;AACxC,MAAM,WAAW,KAAK;IACpB,qCAAqC;IACrC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,0CAA0C;IAC1C,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/internal/types.js

@@ -0,0 +1,3 @@
+// ─── Texture maps ─────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":"AAAA,iFAAiF"}

package/dist/internal/utils.d.ts

@@ -0,0 +1,39 @@
+export declare function walkDir(dir: string, filter?: (f: string) => boolean): string[];
+export declare function readJSONFromDisk<T = Record<string, unknown>>(filePath: string): T | null;
+export declare function stripComments(raw: string): string;
+export declare function parseJSONString<T = Record<string, unknown>>(text: string): T | null;
+/**
+ * Parse a raw ingredient value from a recipe key or ingredients array entry
+ * into a prefixed identifier string.
+ *   item  → "minecraft:stick"
+ *   tag   → "tag:minecraft:planks"
+ *   empty → ""
+ */
+export declare function parseIngredient(raw: unknown): string;
+/**
+ * A parsed in-memory representation of a pack's files, keyed by their
+ * slash-normalised path relative to the pack root.
+ * e.g. `"textures/item_texture.json"` → `Record<string, unknown>`
+ *
+ * Used internally by `AddOn.fromFileList`.
+ */
+export type PackData = Map<string, Record<string, unknown>>;
+/**
+ * Read a `File[]` from a browser folder picker and return a `PackData` map.
+ * The relative path is taken from `file.webkitRelativePath`, which browsers
+ * set automatically when using `<input webkitdirectory>` or `showDirectoryPicker()`.
+ * The first path segment (the folder name itself) is stripped so all keys are
+ * relative to the pack root, matching what the disk loader produces.
+ */
+export declare function packDataFromFiles(files: File[]): Promise<PackData>;
+export type PackEntry = {
+    filePath: string;
+    relativePath: string;
+    data: Record<string, unknown>;
+};
+export declare function diskEntries(packRoot: string, subdir: string): PackEntry[];
+export declare function browserEntries(packData: PackData, subdir: string): PackEntry[];
+export declare function extractIdentifier(data: Record<string, unknown>, rootKey: string): string | null;
+/** Strips the namespace from an identifier, e.g. `"minecraft:zombie"` → `"zombie"`. */
+export declare function shortname(identifier: string): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,EAAE,CAS9E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAIxF;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyBjD;AAED,wBAAgB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAInF;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOpD;AAID;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAWxE;AAID,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAElG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAOzE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAQ9E;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/F;AAID,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/internal/utils.js

@@ -0,0 +1,137 @@
+import { join, relative } from "node:path";
+import { readdirSync, statSync, readFileSync } from "node:fs";
+// ─── Disk I/O ─────────────────────────────────────────────────────────────────
+export function walkDir(dir, filter) {
+    try {
+        statSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            results.push(...walkDir(full, filter));
+        else if (!filter || filter(full))
+            results.push(full);
+    }
+    return results;
+}
+export function readJSONFromDisk(filePath) {
+    try {
+        return JSON.parse(stripComments(readFileSync(filePath, "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+// ─── JSON parsing ─────────────────────────────────────────────────────────────
+export function stripComments(raw) {
+    let result = "";
+    let i = 0;
+    let inString = false;
+    while (i < raw.length) {
+        if (raw[i] === '"' && (i === 0 || raw[i - 1] !== "\\")) {
+            inString = !inString;
+            result += raw[i++];
+            continue;
+        }
+        if (!inString) {
+            if (raw[i] === "/" && raw[i + 1] === "/") {
+                while (i < raw.length && raw[i] !== "\n")
+                    i++;
+                continue;
+            }
+            if (raw[i] === "/" && raw[i + 1] === "*") {
+                i += 2;
+                while (i < raw.length && !(raw[i] === "*" && raw[i + 1] === "/"))
+                    i++;
+                i += 2;
+                continue;
+            }
+        }
+        result += raw[i++];
+    }
+    return result;
+}
+export function parseJSONString(text) {
+    try {
+        return JSON.parse(stripComments(text));
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Recipe ingredient parsing ────────────────────────────────────────────────
+/**
+ * Parse a raw ingredient value from a recipe key or ingredients array entry
+ * into a prefixed identifier string.
+ *   item  → "minecraft:stick"
+ *   tag   → "tag:minecraft:planks"
+ *   empty → ""
+ */
+export function parseIngredient(raw) {
+    if (!raw)
+        return "";
+    if (typeof raw === "string")
+        return raw;
+    const r = raw;
+    if (typeof r["tag"] === "string")
+        return `tag:${r["tag"]}`;
+    if (typeof r["item"] === "string")
+        return r["item"];
+    return "";
+}
+/**
+ * Read a `File[]` from a browser folder picker and return a `PackData` map.
+ * The relative path is taken from `file.webkitRelativePath`, which browsers
+ * set automatically when using `<input webkitdirectory>` or `showDirectoryPicker()`.
+ * The first path segment (the folder name itself) is stripped so all keys are
+ * relative to the pack root, matching what the disk loader produces.
+ */
+export async function packDataFromFiles(files) {
+    const map = new Map();
+    await Promise.all(files.map(async (file) => {
+        const rel = file.webkitRelativePath
+            ? file.webkitRelativePath.split("/").slice(1).join("/")
+            : file.name;
+        const text = await file.text();
+        const data = parseJSONString(text);
+        if (data)
+            map.set(rel, data);
+    }));
+    return map;
+}
+export function diskEntries(packRoot, subdir) {
+    return walkDir(join(packRoot, subdir), (f) => f.endsWith(".json")).flatMap((file) => {
+        const data = readJSONFromDisk(file);
+        if (!data)
+            return [];
+        const relativePath = relative(packRoot, file).replace(/\\/g, "/");
+        return [{ filePath: file, relativePath, data }];
+    });
+}
+export function browserEntries(packData, subdir) {
+    const prefix = subdir.endsWith("/") ? subdir : subdir + "/";
+    const out = [];
+    for (const [key, data] of packData) {
+        if (key.startsWith(prefix) && key.endsWith(".json"))
+            out.push({ filePath: "", relativePath: key, data });
+    }
+    return out;
+}
+// ─── Shared identifier extraction ────────────────────────────────────────────
+export function extractIdentifier(data, rootKey) {
+    const root = data[rootKey];
+    if (!root)
+        return null;
+    const desc = root["description"];
+    return desc?.["identifier"] ?? root["identifier"] ?? null;
+}
+// ─── Namespace stripping ──────────────────────────────────────────────────────
+/** Strips the namespace from an identifier, e.g. `"minecraft:zombie"` → `"zombie"`. */
+export function shortname(identifier) {
+    return identifier.includes(":") ? identifier.split(":")[1] : identifier;
+}
+//# sourceMappingURL=utils.js.map

package/dist/internal/utils.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "bedrock-kit",
+  "version": "0.0.3",
+  "description": "A typed API for navigating Minecraft Bedrock addon files. Works in Node.js and browsers.",
+  "type": "module",
+  "main": "./dist/bedrockKit.js",
+  "types": "./dist/bedrockKit.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/bedrockKit.js",
+      "types": "./dist/bedrockKit.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node test/bedrockKit.test.js",
+    "docs": "typedoc"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0",
+    "typedoc": "^0.28.0"
+  },
+  "keywords": [
+    "minecraft",
+    "bedrock",
+    "addon",
+    "behavior-pack",
+    "resource-pack"
+  ],
+  "license": "MIT"
+}