minecraft-inventory 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-inventory",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "license": "MIT",
   "release": {

package/src/InventoryGUI.tsx

@@ -24,6 +24,8 @@ export interface InventoryGUIProps {
   textureBaseUrl?: string
   textureConfig?: Partial<TextureConfig>
   enableKeyboardShortcuts?: boolean
+  /** Hide empty slot labels like Head, Chest, Legs, Feet */
+  noPlaceholders?: boolean
   onClose?: () => void
   className?: string
   style?: React.CSSProperties
@@ -42,6 +44,7 @@ export function InventoryGUI({
   textureBaseUrl,
   textureConfig,
   enableKeyboardShortcuts = true,
+  noPlaceholders = false,
   onClose,
   className,
   style,
@@ -64,7 +67,7 @@ export function InventoryGUI({
   return (
     <TextureProvider baseUrl={textureBaseUrl} config={textureConfig}>
       <ScaleProvider scale={scale}>
-        <InventoryProvider connector={connector}>
+        <InventoryProvider connector={connector} noPlaceholders={noPlaceholders}>
           <div
             ref={containerRef}
             className={className}

package/src/components/InventoryOverlay/InventoryOverlay.tsx

@@ -298,7 +298,7 @@ export function InventoryOverlay({
               lineHeight: 1,
             }}
           >
-            INV 0.1.13
+            INV 0.1.15
           </a>
         )}
 

package/src/components/Slot/Slot.tsx

@@ -55,6 +55,7 @@ export function Slot({
     focusedSlot,
     setFocusedSlot,
     dragEndedRef,
+    noPlaceholders,
   } = useInventoryContext()
 
   const { contentSize } = useScale()
@@ -377,7 +378,7 @@ export function Slot({
         />
       )}
 
-      {!item && label && (
+      {!item && label && !noPlaceholders && (
         <div
           ref={labelRef}
           className={styles.emptyLabel}

package/src/context/InventoryContext.tsx

@@ -45,6 +45,8 @@ export interface InventoryContextValue {
   /** Ref set to true when a drag just ended; cleared on next mouseDown.
    *  Used by Slot to suppress spurious click events that fire after endDrag. */
   dragEndedRef: React.MutableRefObject<boolean>
+  /** When true, empty slot labels (Head, Chest, Legs, etc.) are not rendered */
+  noPlaceholders: boolean
 }
 
 const InventoryContext = createContext<InventoryContextValue | null>(null)
@@ -59,9 +61,10 @@ interface InventoryProviderProps {
   connector: InventoryConnector | null
   children: React.ReactNode
   noDragSpread?: boolean
+  noPlaceholders?: boolean
 }
 
-export function InventoryProvider({ connector, children, noDragSpread = false }: InventoryProviderProps) {
+export function InventoryProvider({ connector, children, noDragSpread = false, noPlaceholders = false }: InventoryProviderProps) {
   const [windowState, setWindowState] = useState<InventoryWindowState | null>(
     () => connector?.getWindowState() ?? null,
   )
@@ -304,6 +307,7 @@ export function InventoryProvider({ connector, children, noDragSpread = false }:
     grabOffset,
     setGrabOffset,
     noDragSpread,
+    noPlaceholders,
     pKeyActive,
     setPKeyActive,
     focusedSlot,

package/src/registry/index.ts

@@ -5,41 +5,47 @@ const registry = new Map<string, InventoryTypeDefinition>(
   Object.entries(inventoryDefinitions),
 )
 
-/**
- * Maps alternative names/aliases to canonical inventory type names.
- * Both the alias and the canonical name resolve to the same definition.
- *
- * Add entries here to support shorthand or legacy type identifiers.
- */
-const typeAliases: Record<string, string> = {
-  // Shorthand aliases
-  crafting3x3: 'crafting_table',
-  crafting: 'crafting_table',
-  chest: 'chest',               // already canonical, listed for clarity
-  // Protocol-level minecraft: prefix stripping is handled in getInventoryType
+/** Built from each definition’s `aliases` field in `inventories.ts`. */
+function buildAliasToNameMap(
+  defs: Record<string, InventoryTypeDefinition>,
+): Map<string, string> {
+  const m = new Map<string, string>()
+  for (const def of Object.values(defs)) {
+    if (def.aliases) {
+      for (const a of def.aliases) {
+        m.set(a, def.name)
+      }
+    }
+  }
+  return m
 }
 
+const aliasToName = buildAliasToNameMap(inventoryDefinitions)
+
+/** Runtime aliases from {@link registerTypeAlias} / {@link registerInventoryType}. */
+const dynamicAliasToName = new Map<string, string>()
+
 export function registerInventoryType(def: InventoryTypeDefinition): void {
   registry.set(def.name, def)
+  def.aliases?.forEach((a) => dynamicAliasToName.set(a, def.name))
 }
 
 /**
  * Resolve an inventory type name or alias to its definition.
  * Handles:
  *  - Exact matches (e.g. "crafting_table")
- *  - Aliases defined in `typeAliases` (e.g. "crafting3x3" → "crafting_table")
+ *  - `aliases` on each definition in `inventories.ts`
  *  - "minecraft:" namespace prefix (e.g. "minecraft:generic_9x3" → "generic_9x3")
  */
 export function getInventoryType(name: string): InventoryTypeDefinition | undefined {
-  // Strip "minecraft:" namespace prefix if present
   const stripped = name.startsWith('minecraft:') ? name.slice('minecraft:'.length) : name
-  // Resolve alias if defined
-  const canonical = typeAliases[stripped] ?? stripped
+  const canonical =
+    dynamicAliasToName.get(stripped) ?? aliasToName.get(stripped) ?? stripped
   return registry.get(canonical)
 }
 
 export function registerTypeAlias(alias: string, canonical: string): void {
-  typeAliases[alias] = canonical
+  dynamicAliasToName.set(alias, canonical)
 }
 
 export function getAllInventoryTypes(): InventoryTypeDefinition[] {

package/src/registry/inventories.ts

@@ -87,9 +87,14 @@ const makeInventoryDefinitions = <T extends string>(
     ]),
   ) as Record<T, InventoryTypeDefinition>
 
+/**
+ * Canonical inventory GUIs. Optional `aliases` lists protocol / prismarine-windows
+ * names that map to each `name` (see {@link getInventoryType} in `./index.ts`).
+ */
 export const inventoryDefinitions = makeInventoryDefinitions({
   player: {
     name: 'player',
+    aliases: ['inventory'],
     title: 'Inventory',
     backgroundTexture: '1.21.11/textures/gui/container/inventory.png',
     backgroundWidth: 176,
@@ -228,6 +233,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   crafting_table: {
     name: 'crafting_table',
+    aliases: ['crafting', 'crafting3x3'],
     title: 'Crafting',
     backgroundTexture: '1.21.11/textures/gui/container/crafting_table.png',
     backgroundWidth: 176,
@@ -433,6 +439,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   enchanting_table: {
     name: 'enchanting_table',
+    aliases: ['enchantment'],
     title: 'Enchant',
     backgroundTexture: '1.21.11/textures/gui/container/enchanting_table.png',
     backgroundWidth: 176,
@@ -455,6 +462,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   smithing_table: {
     name: 'smithing_table',
+    aliases: ['smithing'],
     title: 'Upgrade Gear',
     backgroundTexture: '1.21.11/textures/gui/container/smithing.png',
     backgroundWidth: 176,
@@ -505,6 +513,8 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   dispenser: {
     name: 'dispenser',
+    /** wiki `generic_3x3`; same 3×3 + player layout as dropper */
+    aliases: ['generic_3x3'],
     title: 'Dispenser',
     backgroundTexture: '1.21.11/textures/gui/container/dispenser.png',
     backgroundWidth: 176,
@@ -541,6 +551,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   horse: {
     name: 'horse',
+    aliases: ['EntityHorse'],
     title: 'Horse',
     backgroundTexture: '1.21.11/textures/gui/container/horse.png',
     backgroundWidth: 176,
@@ -587,6 +598,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   villager: {
     name: 'villager',
+    aliases: ['merchant'],
     title: 'Villager',
     backgroundTexture: '1.14/textures/gui/container/villager2.png',
     backgroundWidth: 276,
@@ -626,6 +638,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   cartography_table: {
     name: 'cartography_table',
+    aliases: ['cartography'],
     title: 'Cartography Table',
     backgroundTexture: '1.21.11/textures/gui/container/cartography_table.png',
     backgroundWidth: 176,
@@ -668,6 +681,7 @@ export const inventoryDefinitions = makeInventoryDefinitions({
 
   crafter: {
     name: 'crafter',
+    aliases: ['crafter_3x3'],
     title: 'Crafter',
     backgroundTexture: '1.21.11/textures/gui/container/crafter.png',
     backgroundWidth: 176,

package/src/types.ts

@@ -164,6 +164,11 @@ export interface EntityDisplayArea {
 
 export interface InventoryTypeDefinition {
   name: string
+  /**
+   * Alternate type strings that resolve to this definition (e.g. protocol names like `crafting` → crafting_table).
+   * Do not include `minecraft:` — that prefix is stripped before lookup.
+   */
+  aliases?: string[]
   title: string
   backgroundTexture: string
   backgroundWidth: number