minerender 2.1.0-alpha.77 → 2.1.0-alpha.78

package/dist/bundle.js

@@ -93757,6 +93757,7 @@ ${shader.fragmentShader}`.replace(
     Env: () => Env,
     FluidModelObject: () => FluidModelObject,
     Fonts: () => Fonts,
+    GUI_CONTAINER_LAYOUTS: () => GUI_CONTAINER_LAYOUTS,
     Geometries: () => Geometries,
     GuiHelper: () => GuiHelper,
     GuiLight: () => GuiLight,
@@ -97340,6 +97341,7 @@ property list uchar int vertex_index
   init_buffer2();
   init_process2();
   init_AssetKey();
+  init_ModelTextures();
 
   // src/gui/GuiText.ts
   init_dirname();
@@ -97452,7 +97454,128 @@ property list uchar int vertex_index
   }
 
   // src/gui/GuiHelper.ts
+  var GUI_CONTAINER_LAYOUTS = {
+    generic_54: {
+      texture: "minecraft:gui/container/generic_54",
+      crop: [0, 0, 176, 222],
+      slotOrigin: [8, 18],
+      slotOffset: [18, 18],
+      rowSize: 9,
+      slotCount: 54
+    },
+    crafting_table: {
+      texture: "minecraft:gui/container/crafting_table",
+      crop: [0, 0, 176, 166],
+      slotOrigin: [30, 17],
+      slotOffset: [18, 18],
+      rowSize: 3,
+      slotCount: 9,
+      resultPosition: [124, 35]
+    }
+  };
   var GuiHelper = class {
+    /**
+     * Creates a 182×5 boss bar using the active resource pack. Finite progress is clamped to 0–1.
+     * The fill crops the source image; explicit crops do not apply `.mcmeta` sprite scaling.
+     */
+    static async bossBar(options = {}) {
+      const { color: color3 = "pink", progress = 1, position = [0, 0] } = options;
+      this.validatePosition(position);
+      if (!["pink", "blue", "red", "green", "yellow", "purple", "white"].includes(color3)) {
+        throw new Error(`Unsupported boss bar color: ${color3}`);
+      }
+      if (!Number.isFinite(progress)) throw new Error("Boss bar progress must be finite");
+      const value = Math.max(0, Math.min(1, progress));
+      const width = value > 0 ? Math.floor(value * 181) + 1 : 0;
+      const texture = `minecraft:gui/sprites/boss_bar/${color3}`;
+      const layers = [{
+        name: "boss-bar-background",
+        texture: `${texture}_background`,
+        position: [...position],
+        size: [182, 5]
+      }];
+      if (width > 0) {
+        layers.push({
+          ...await this.cropTexture(`${texture}_progress`, [0, 0, width, 5], [182, 5], position),
+          name: "boss-bar-progress"
+        });
+      }
+      return layers;
+    }
+    /**
+     * Creates a 192×192 book page with optional arrows and supplied text. Buttons are hidden by default.
+     * Callers choose the page content and button states; this helper does not paginate or handle clicks.
+     */
+    static async book(options = {}) {
+      const {
+        position = [0, 0],
+        previous = "hidden",
+        next = "hidden",
+        text: text2,
+        color: color3 = 0,
+        shadow = false,
+        maxWidth = 114,
+        lineHeight = 9,
+        ...style
+      } = options;
+      this.validatePosition(position);
+      for (const state of [previous, next]) {
+        if (!["hidden", "normal", "hover"].includes(state)) throw new Error(`Unsupported book button state: ${state}`);
+      }
+      const layers = [{
+        ...await this.cropTexture("minecraft:gui/book", [0, 0, 192, 192], [256, 256], position),
+        name: "book-background"
+      }];
+      for (const [name2, direction, state, x4] of [
+        ["previous", "backward", previous, 43],
+        ["next", "forward", next, 116]
+      ]) {
+        if (state === "hidden") continue;
+        layers.push({
+          name: `book-${name2}`,
+          texture: `minecraft:gui/sprites/widget/page_${direction}${state === "hover" ? "_highlighted" : ""}`,
+          position: [position[0] + x4, position[1] + 157],
+          size: [23, 13]
+        });
+      }
+      if (text2 !== void 0) {
+        layers.push({
+          name: "book-text",
+          text: text2,
+          position: [position[0] + 36, position[1] + 30],
+          color: color3,
+          shadow,
+          maxWidth,
+          lineHeight,
+          ...style
+        });
+      }
+      return layers;
+    }
+    /** Creates a container background. Use {@link GUI_CONTAINER_LAYOUTS} with {@link inventorySlot} to place its items. */
+    static async container(type, position = [0, 0]) {
+      this.validatePosition(position);
+      if (type !== "generic_54" && type !== "crafting_table") throw new Error(`Unsupported GUI container: ${type}`);
+      const layout = GUI_CONTAINER_LAYOUTS[type];
+      return [{ ...await this.cropTexture(layout.texture, layout.crop, [256, 256], position), name: "background" }];
+    }
+    static validatePosition(position) {
+      if (!Array.isArray(position) || position.length !== 2 || !position.every(Number.isFinite)) {
+        throw new Error("GUI position must contain two finite coordinates");
+      }
+    }
+    static async cropTexture(texture, crop, referenceSize, position) {
+      const image = await ModelTextures.preload(AssetKey.parse("textures", texture));
+      if (!image) throw new Error(`Could not load GUI texture ${texture}`);
+      const [x4, y5, width, height] = crop;
+      const scaleX = image.width / referenceSize[0], scaleY = image.height / referenceSize[1];
+      return {
+        texture,
+        crop: [x4 * scaleX, y5 * scaleY, width * scaleX, height * scaleY],
+        position: [...position],
+        size: [width, height]
+      };
+    }
     /** Sizes a tooltip around supplied text; the first entry is its title. */
     static async tooltip(lines, options = {}) {
       if (!lines.length) return [];
@@ -97487,8 +97610,9 @@ property list uchar int vertex_index
     }
     /** Creates crafting-table layers for ingredients and the result; stack counts are not drawn. */
     static recipe(recipe, options = {}) {
+      const layout = GUI_CONTAINER_LAYOUTS.crafting_table;
       const layers = [
-        { name: "background", texture: "minecraft:gui/container/crafting_table", crop: [0, 0, 176, 166] }
+        { name: "background", texture: layout.texture, crop: [...layout.crop] }
       ];
       const itemKey = (ingredient) => {
         const item = typeof ingredient === "string" && !ingredient.startsWith("#") ? ingredient : typeof ingredient === "object" && "item" in ingredient ? ingredient.item : options.resolveIngredient?.(ingredient);
@@ -97503,7 +97627,7 @@ property list uchar int vertex_index
         layers.push({
           name: `ingredient-${slot}`,
           item: itemKey(ingredient),
-          position: this.inventorySlot(slot, [30, 17], [18, 18], 3)
+          position: this.inventorySlot(slot, layout.slotOrigin, layout.slotOffset, layout.rowSize)
         });
       };
       switch (recipe.type) {
@@ -97538,7 +97662,7 @@ property list uchar int vertex_index
       layers.push({
         name: "result",
         item: itemKey("id" in recipe.result ? recipe.result.id : recipe.result.item),
-        position: [124, 35]
+        position: [...layout.resultPosition]
       });
       return layers;
     }