minecraft-inventory 0.1.4 → 0.1.6

package/src/registry/inventories.ts

@@ -127,19 +127,20 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   // generic_9x1..9x6 all use generic_54.png (the 6-row chest texture, 176×222).
   // InventoryBackground canvas-stitches rows < 6: takes the top N rows from the source
-  // then the player-inventory section (bottom 96px) and composes them into the output.
-  // Slot formula: containerRows=N → container at y=18, player at y = N*18+30.
-  // backgroundHeight = N*18 + 113  (96px player section + 17px title).
+  // (y=0..topH-1, where topH = N*18+17) then the player-inventory section starting at
+  // y=SRC_PLAYER_Y=125 and composites them.
+  // Output height formula: N*18+17 + (222-125) = N*18+17+97 = N*18+114.
+  // Slot formula: container at y=18, player at y = N*18+30  (13px frame into player section).
   generic_9x1: {
     name: 'generic_9x1',
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 131, // 1*18 + 113
+    backgroundHeight: 132, // 1*18 + 114
     containerRows: 1,
     slots: [
       ...gridSlots(9, 1, 8, 18, 'container'),
-      ...playerInv(48), // 1*18 + 30
+      ...playerInv(50), // 1*18 + 30 + 2px offset below
     ],
   },
 
@@ -148,11 +149,11 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 149, // 2*18 + 113
+    backgroundHeight: 150, // 2*18 + 114
     containerRows: 2,
     slots: [
       ...gridSlots(9, 2, 8, 18, 'container'),
-      ...playerInv(66), // 2*18 + 30
+      ...playerInv(68), // 2*18 + 30 + 2px offset below
     ],
   },
 
@@ -161,12 +162,12 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 167, // 3*18 + 113
+    backgroundHeight: 168, // 3*18 + 114
     containerRows: 3,
-    playerInventoryOffset: { x: 8, y: 84 },
+    playerInventoryOffset: { x: 8, y: 82 },
     slots: [
       ...gridSlots(9, 3, 8, 18, 'container'),
-      ...playerInv(84), // 3*18 + 30
+      ...playerInv(86), // 3*18 + 30 + 2px offset below
     ],
   },
 
@@ -175,11 +176,11 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 185, // 4*18 + 113
+    backgroundHeight: 186, // 4*18 + 114
     containerRows: 4,
     slots: [
       ...gridSlots(9, 4, 8, 18, 'container'),
-      ...playerInv(102), // 4*18 + 30
+      ...playerInv(104), // 4*18 + 30 + 2px offset below
     ],
   },
 
@@ -188,11 +189,11 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 203, // 5*18 + 113
+    backgroundHeight: 204, // 5*18 + 114
     containerRows: 5,
     slots: [
       ...gridSlots(9, 5, 8, 18, 'container'),
-      ...playerInv(120), // 5*18 + 30
+      ...playerInv(122), // 5*18 + 30 + 2px offset below
     ],
   },
 
@@ -201,8 +202,9 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     title: 'Container',
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 222, // full 6-row texture, no stitching needed
+    backgroundHeight: 222, // full 6-row texture, no stitching needed (N*18+114 = 222)
     playerInventoryOffset: { x: 8, y: 140 },
+    containerRows: 6,
     slots: [
       ...gridSlots(9, 6, 8, 18, 'container'),
       ...playerInv(140), // matches large_chest
@@ -215,7 +217,8 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
     backgroundHeight: 222,
-    playerInventoryOffset: { x: 8, y: 140 },
+    containerRows: 6,
+    playerInventoryOffset: { x: 8, y: 138 },
     slots: [
       ...gridSlots(9, 6, 8, 18, 'container'),
       ...playerInv(140),

package/src/types.ts

@@ -1,3 +1,24 @@
+/** Slice rect [x, y, width, height] in source texture pixels. */
+export type TextureSlice = [x:number, y:number, width:number, height:number]
+
+/** Block face slice for isometric block rendering. */
+export interface BlockFaceSlice {
+  slice: TextureSlice
+}
+
+/**
+ * Block-style render config. When set, ItemCanvas uses an aux canvas to composite
+ * top/left/right faces into an isometric icon instead of a single texture.
+ * Useful for blocks in mineflayer connector where block texture atlas faces differ.
+ */
+export interface BlockTextureRender {
+  /** Source texture URL or preloaded HTMLImageElement. */
+  source: string | HTMLImageElement
+  top: BlockFaceSlice
+  left: BlockFaceSlice
+  right: BlockFaceSlice
+}
+
 export interface ItemStack {
   type: number
   count: number
@@ -19,6 +40,23 @@ export interface ItemStack {
    * Example: `"item/dye_black"` or `"entity/spider/spider"`
    */
   textureKey?: string
+  /**
+   * Direct texture override. When set, bypasses getItemTextureUrl.
+   * - `string`: URL (data URL or http) used as img src.
+   * - `HTMLImageElement`: preloaded image, drawn directly.
+   */
+  texture?: string | HTMLImageElement
+  /**
+   * Block-style isometric render. When set, ItemCanvas uses a canvas pool to composite
+   * top/left/right face slices into the icon. Use in mineflayer itemMapper for blocks.
+   */
+  blockTexture?: BlockTextureRender
+  /**
+   * Arbitrary debug identifier exposed as a `data-debug` attribute on the slot element.
+   * The mineflayer connector sets this to `"<type>:<metadata>"` by default, making it easy
+   * to inspect raw item IDs in browser DevTools without touching React internals.
+   */
+  debugKey?: string
 }
 
 export interface SlotState {