minecraft-inventory 0.1.3 → 0.1.5

package/src/registry/inventories.ts

@@ -94,6 +94,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/inventory.png',
     backgroundWidth: 176,
     backgroundHeight: 166,
+    entityDisplay: { x: 26, y: 8, width: 49, height: 70 },
     slots: [
       // Result (0)
       { x: 154, y: 28, group: 'result', resultSlot: true },
@@ -124,15 +125,88 @@ 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
+  // (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/shulker_box.png',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
     backgroundWidth: 176,
-    backgroundHeight: 96,
+    backgroundHeight: 132, // 1*18 + 114
+    containerRows: 1,
     slots: [
       ...gridSlots(9, 1, 8, 18, 'container'),
-      ...playerInv(14),
+      ...playerInv(48), // 1*18 + 30
+    ],
+  },
+
+  generic_9x2: {
+    name: 'generic_9x2',
+    title: 'Container',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
+    backgroundWidth: 176,
+    backgroundHeight: 150, // 2*18 + 114
+    containerRows: 2,
+    slots: [
+      ...gridSlots(9, 2, 8, 18, 'container'),
+      ...playerInv(66), // 2*18 + 30
+    ],
+  },
+
+  generic_9x3: {
+    name: 'generic_9x3',
+    title: 'Container',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
+    backgroundWidth: 176,
+    backgroundHeight: 168, // 3*18 + 114
+    containerRows: 3,
+    playerInventoryOffset: { x: 8, y: 84 },
+    slots: [
+      ...gridSlots(9, 3, 8, 18, 'container'),
+      ...playerInv(84), // 3*18 + 30
+    ],
+  },
+
+  generic_9x4: {
+    name: 'generic_9x4',
+    title: 'Container',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
+    backgroundWidth: 176,
+    backgroundHeight: 186, // 4*18 + 114
+    containerRows: 4,
+    slots: [
+      ...gridSlots(9, 4, 8, 18, 'container'),
+      ...playerInv(102), // 4*18 + 30
+    ],
+  },
+
+  generic_9x5: {
+    name: 'generic_9x5',
+    title: 'Container',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
+    backgroundWidth: 176,
+    backgroundHeight: 204, // 5*18 + 114
+    containerRows: 5,
+    slots: [
+      ...gridSlots(9, 5, 8, 18, 'container'),
+      ...playerInv(120), // 5*18 + 30
+    ],
+  },
+
+  generic_9x6: {
+    name: 'generic_9x6',
+    title: 'Container',
+    backgroundTexture: '1.21.11/textures/gui/container/generic_54.png',
+    backgroundWidth: 176,
+    backgroundHeight: 222, // full 6-row texture, no stitching needed (N*18+114 = 222)
+    playerInventoryOffset: { x: 8, y: 140 },
+    slots: [
+      ...gridSlots(9, 6, 8, 18, 'container'),
+      ...playerInv(140), // matches large_chest
     ],
   },
 
@@ -321,6 +395,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/anvil.png',
     backgroundWidth: 176,
     backgroundHeight: 166,
+    titleOffset: { x: 52, y: 0 },
     properties: {
       repairCost: { dataSlot: 0, description: 'Level cost' },
     },
@@ -444,7 +519,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   beacon: {
     name: 'beacon',
-    title: 'Beacon',
+    title: '',
     backgroundTexture: '1.21.11/textures/gui/container/beacon.png',
     backgroundWidth: 230,
     backgroundHeight: 219,
@@ -460,6 +535,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/horse.png',
     backgroundWidth: 176,
     backgroundHeight: 166,
+    entityDisplay: { x: 26, y: 18, width: 52, height: 52 },
     slots: [
       { x: 8, y: 18, group: 'saddle', label: 'Saddle' },
       { x: 8, y: 36, group: 'armor', label: 'Horse Armor' },
@@ -473,6 +549,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/horse.png',
     backgroundWidth: 176,
     backgroundHeight: 166,
+    entityDisplay: { x: 26, y: 18, width: 52, height: 52 },
     slots: [
       // Saddle (0); slot 1 (horse armor) is absent for donkeys — gap is intentional
       { x: 8, y: 18, group: 'saddle', label: 'Saddle' },
@@ -488,6 +565,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundTexture: '1.21.11/textures/gui/container/horse.png',
     backgroundWidth: 176,
     backgroundHeight: 166,
+    entityDisplay: { x: 26, y: 18, width: 52, height: 52 },
     slots: [
       { x: 8, y: 18, group: 'saddle', label: 'Carpet' },
       ...gridSlots(5, 3, 80, 18, 'chest').map((s, i) => i === 0 ? { ...s, index: 2 } : s),
@@ -583,8 +661,8 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     backgroundWidth: 176,
     backgroundHeight: 166,
     slots: [
-      ...gridSlots(3, 3, 30, 17, 'crafting'),
-      { x: 124, y: 35, group: 'result', resultSlot: true },
+      ...gridSlots(3, 3, 26, 17, 'crafting'),
+      { x: 134, y: 35, group: 'result', resultSlot: true },
       ...playerInv(84),
     ],
   },
@@ -618,3 +696,18 @@ export const inventoryDefinitions = makeInventoryDefinitions({
     ],
   },
 })
+
+/**
+ * Extra mc-assets texture paths that must be bundled by `scripts/generate-texture-imports.mjs`
+ * beyond the `backgroundTexture` fields already found in `inventoryDefinitions`.
+ *
+ * Add paths here when a component uses `textures.getGuiTextureUrl(path)` for a texture
+ * that is NOT already a `backgroundTexture` in any inventory definition (e.g. UI sprites).
+ *
+ * Format: versioned mc-assets path, e.g. "1.21.11/textures/gui/sprites/container/anvil/text_field.png"
+ */
+export const registryExtraTextures: string[] = [
+  // Anvil rename input field sprites (used by AnvilInput component)
+  '1.21.11/textures/gui/sprites/container/anvil/text_field.png',
+  '1.21.11/textures/gui/sprites/container/anvil/text_field_disabled.png',
+]

package/src/styles/tokens.css

@@ -45,3 +45,9 @@
 .mc-inv-root * {
   box-sizing: border-box;
 }
+
+@keyframes mc-inv-focus-dash {
+  0% { outline-offset: -2px; }
+  50% { outline-offset: 0px; }
+  100% { outline-offset: -2px; }
+}

package/src/types.ts

@@ -10,6 +10,21 @@ export interface ItemStack {
   lore?: string[]
   durability?: number
   maxDurability?: number
+  /**
+   * Override texture lookup key. When set, this path is used instead of the item `name`
+   * to resolve the item texture. Useful for custom resource packs or items that share a
+   * type ID but have distinct textures (e.g. potions, spawn eggs, dyed armor).
+   *
+   * The value is passed directly to `TextureConfig.getItemTextureUrl`.
+   * Example: `"item/dye_black"` or `"entity/spider/spider"`
+   */
+  textureKey?: string
+  /**
+   * 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 {
@@ -106,6 +121,13 @@ export interface ProgressBar {
   getMax: (props: Record<string, number>) => number
 }
 
+export interface EntityDisplayArea {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
 export interface InventoryTypeDefinition {
   name: string
   title: string
@@ -121,6 +143,14 @@ export interface InventoryTypeDefinition {
   windowType?: number | string
   hasTitle?: boolean
   extraData?: Record<string, unknown>
+  /** Bounds for the entity preview area (e.g. player model, horse model). */
+  entityDisplay?: EntityDisplayArea
+  /**
+   * When set, InventoryBackground will canvas-stitch the background texture:
+   * top (title + N container rows) + bottom (player inventory section) from
+   * the `generic_54.png` (176×222, 6-row) source. Applies only for N < 6.
+   */
+  containerRows?: number
 }
 
 export interface RecipeGuide {

package/src/utils/isItemEqual.ts

@@ -0,0 +1,41 @@
+import type { ItemStack } from '../types'
+
+export function isItemEqual(a: ItemStack | null, b: ItemStack | null): boolean {
+  if (a === b) return true
+  if (!a || !b) return false
+  if (a.type !== b.type) return false
+  if ((a.name ?? '') !== (b.name ?? '')) return false
+  if ((a.metadata ?? 0) !== (b.metadata ?? 0)) return false
+  const aNbt = a.nbt ? JSON.stringify(a.nbt) : ''
+  const bNbt = b.nbt ? JSON.stringify(b.nbt) : ''
+  return aNbt === bNbt
+}
+
+export function getMaxStackSize(item: ItemStack): number {
+  const unstackable = [
+    'diamond_sword', 'iron_sword', 'stone_sword', 'wooden_sword', 'golden_sword', 'netherite_sword',
+    'diamond_pickaxe', 'iron_pickaxe', 'stone_pickaxe', 'wooden_pickaxe', 'golden_pickaxe', 'netherite_pickaxe',
+    'diamond_axe', 'iron_axe', 'stone_axe', 'wooden_axe', 'golden_axe', 'netherite_axe',
+    'diamond_shovel', 'iron_shovel', 'stone_shovel', 'wooden_shovel', 'golden_shovel', 'netherite_shovel',
+    'diamond_hoe', 'iron_hoe', 'stone_hoe', 'wooden_hoe', 'golden_hoe', 'netherite_hoe',
+    'bow', 'crossbow', 'trident', 'shield', 'fishing_rod', 'flint_and_steel', 'shears',
+    'diamond_helmet', 'iron_helmet', 'golden_helmet', 'leather_helmet', 'chainmail_helmet', 'netherite_helmet', 'turtle_helmet',
+    'diamond_chestplate', 'iron_chestplate', 'golden_chestplate', 'leather_chestplate', 'chainmail_chestplate', 'netherite_chestplate',
+    'diamond_leggings', 'iron_leggings', 'golden_leggings', 'leather_leggings', 'chainmail_leggings', 'netherite_leggings',
+    'diamond_boots', 'iron_boots', 'golden_boots', 'leather_boots', 'chainmail_boots', 'netherite_boots',
+    'elytra', 'totem_of_undying', 'music_disc_13', 'music_disc_cat', 'music_disc_blocks', 'music_disc_chirp',
+    'music_disc_far', 'music_disc_mall', 'music_disc_mellohi', 'music_disc_stal', 'music_disc_strad',
+    'music_disc_ward', 'music_disc_11', 'music_disc_wait', 'music_disc_pigstep', 'music_disc_otherside',
+    'music_disc_5', 'music_disc_relic',
+    'carrot_on_a_stick', 'warped_fungus_on_a_stick', 'brush', 'mace',
+  ]
+  const stackTo16 = [
+    'snowball', 'bucket', 'egg', 'ender_pearl', 'sign', 'banner', 'honey_bottle',
+    'armor_stand', 'oak_sign', 'spruce_sign', 'birch_sign', 'jungle_sign', 'acacia_sign',
+    'dark_oak_sign', 'mangrove_sign', 'cherry_sign', 'bamboo_sign', 'crimson_sign', 'warped_sign',
+  ]
+  const name = item.name ?? ''
+  if (unstackable.includes(name)) return 1
+  if (stackTo16.includes(name)) return 16
+  return 64
+}