minecraft-inventory 0.1.4 → 0.1.6

package/src/components/JEI/JEI.tsx

@@ -96,6 +96,7 @@ export function JEI({
 
     const ro = new ResizeObserver((entries) => {
       for (const entry of entries) {
+        // console.log('got size', entry.target.className, entry.contentRect.width, entry.contentRect.height)
         if (entry.target === (root as unknown as Element)) {
           sizes.rootW = entry.contentRect.width
         } else if (entry.target === (grid as unknown as Element)) {
@@ -240,8 +241,6 @@ export function JEI({
         className="mc-inv-jei-header"
         style={{
           padding: `${padding}px`,
-          background: '#c6c6c6',
-          // border: `${scale}px solid #555555`,
           flexShrink: 0,
         }}
       >
@@ -284,7 +283,7 @@ export function JEI({
           >
             ◀
           </button>
-          <span className="mc-inv-jei-page-counter" style={{ flex: 1, textAlign: 'center', color: '#404040' }}>
+          <span className="mc-inv-jei-page-counter" style={{ flex: 1, textAlign: 'center', color: '#ffffff' }}>
             {page + 1} / {Math.max(1, totalPages)}
           </span>
           <button

package/src/components/Notes/Notes.tsx

@@ -45,6 +45,7 @@ export function Notes({
   const [notes, setNotes] = useState<Note[]>([])
   const [draft, setDraft] = useState('')
   const [loading, setLoading] = useState(true)
+  const [showInput, setShowInput] = useState(false)
 
   // Load notes on mount
   useEffect(() => {
@@ -104,6 +105,14 @@ export function Notes({
     setDraft('')
   }, [draft, notes, saveNotes])
 
+  const handleAddButtonClick = useCallback(() => {
+    if (!showInput) {
+      setShowInput(true)
+    } else {
+      addNote()
+    }
+  }, [showInput, addNote])
+
   const removeNote = useCallback((id: number) => {
     const next = notes.filter((n) => n.id !== id)
     saveNotes(next)
@@ -142,7 +151,7 @@ export function Notes({
           </div>
         ) : notes.length === 0 ? (
           <div style={{ color: '#888', fontSize: Math.round(6 * scale), textAlign: 'center', padding: `${4 * scale}px` }}>
-            No tasks yet
+            {/* No tasks yet */}
           </div>
         ) : (
           notes.map((note) => (
@@ -187,50 +196,72 @@ export function Notes({
         boxSizing: 'border-box',
         // borderTop: `${scale}px solid #555555`,
       }}>
-        <textarea
-          value={draft}
-          rows={2}
-          onChange={(e) => {
-            // Strip newlines — behave like a single-line input but with word wrap
-            setDraft(e.target.value.replace(/[\r\n]/g, ''))
-          }}
-          onKeyDown={(e) => {
-            if (e.code === 'Enter') { e.preventDefault(); addNote() }
-          }}
-          placeholder="Add task…"
-          style={{
-            flex: 1,
-            minWidth: 0,
-            resize: 'none',
-            background: '#8b8b8b',
-            border: `${scale}px solid #373737`,
-            color: '#fff',
-            fontSize: Math.round(6 * scale),
-            padding: `${scale}px`,
-            fontFamily: 'inherit',
-            outline: 'none',
-            lineHeight: 1.4,
-            boxSizing: 'border-box',
-            overflowY: 'hidden',
-          }}
-        />
-        <button
-          onClick={addNote}
-          disabled={!draft.trim()}
-          style={{
-            background: '#404040',
-            color: '#fff',
-            border: `${scale}px solid #666`,
-            cursor: draft.trim() ? 'pointer' : 'not-allowed',
-            fontSize: Math.round(6 * scale),
-            padding: `${scale}px ${2 * scale}px`,
-            fontFamily: 'inherit',
-            flexShrink: 0,
-            opacity: draft.trim() ? 1 : 0.5,
-          }}
-        >
-          +
-        </button>
+        {showInput && (
+          <textarea
+            value={draft}
+            rows={2}
+            autoFocus
+            onChange={(e) => {
+              setDraft(e.target.value.replace(/[\r\n]/g, ''))
+            }}
+            onKeyDown={(e) => {
+              if (e.code === 'Enter') { e.preventDefault(); addNote() }
+              if (e.code === 'Escape') { setShowInput(false); setDraft('') }
+            }}
+            placeholder="Add task…"
+            style={{
+              flex: 1,
+              minWidth: 0,
+              resize: 'none',
+              background: '#8b8b8b',
+              border: `${scale}px solid #373737`,
+              color: '#fff',
+              fontSize: Math.round(6 * scale),
+              padding: `${scale}px`,
+              fontFamily: 'inherit',
+              outline: 'none',
+              lineHeight: 1.4,
+              boxSizing: 'border-box',
+              overflowY: 'hidden',
+            }}
+          />
+        )}
+        <div style={{ display: 'flex', flexDirection: 'column', gap: scale, flexShrink: 0 }}>
+          {showInput && (
+            <button
+              onClick={() => { setShowInput(false); setDraft('') }}
+              title="Hide"
+              style={{
+                background: '#5a3a3a',
+                color: '#ccc',
+                border: `${scale}px solid #666`,
+                cursor: 'pointer',
+                fontSize: Math.round(6 * scale),
+                padding: `${scale}px ${2 * scale}px`,
+                fontFamily: 'inherit',
+                lineHeight: 1,
+              }}
+            >
+              ×
+            </button>
+          )}
+          <button
+            onClick={handleAddButtonClick}
+            disabled={showInput && !draft.trim()}
+            style={{
+              background: '#404040',
+              color: '#fff',
+              border: `${scale}px solid #666`,
+              cursor: showInput && !draft.trim() ? 'not-allowed' : 'pointer',
+              fontSize: Math.round(6 * scale),
+              padding: `${scale}px ${2 * scale}px`,
+              fontFamily: 'inherit',
+              opacity: showInput && !draft.trim() ? 0.5 : 1,
+            }}
+          >
+            +
+          </button>
+        </div>
       </div>
     </div>
   )

package/src/components/Slot/Slot.tsx

@@ -244,6 +244,9 @@ export function Slot({
       const touch = e.changedTouches[0]
       if (Math.abs(touch.clientX - start.x) > 10 || Math.abs(touch.clientY - start.y) > 10) return
       e.stopPropagation()
+      // Prevent the browser from firing a synthetic click after touchEnd.
+      // Without this, the click bubbles to the inventory window div which clears focusedSlot.
+      e.preventDefault()
 
       if (pKeyActive) setPKeyActive(false)
 
@@ -319,6 +322,9 @@ export function Slot({
         .filter(Boolean)
         .join(' ')}
       tabIndex={index >= 0 ? 0 : undefined}
+      data-slot={index}
+      data-debug={item?.debugKey ?? undefined}
+      data-texture={item?.textureKey ?? undefined}
       style={{
         width: renderSize,
         height: renderSize,

package/src/components/Text/MessageFormattedString.tsx

@@ -16,6 +16,7 @@ const CODE_COLORS: Record<string, string> = {
 function parseSectionCodes(text: string): MessageFormatPart[] {
   const parts: MessageFormatPart[] = []
   const regex = /§([0-9a-fk-orA-FK-OR])|([^§]+)/g
+  regex.lastIndex = 0
   let color: string | undefined
   let bold = false, italic = false, underlined = false
   let strikethrough = false, obfuscated = false

package/src/components/Tooltip/Tooltip.tsx

@@ -85,8 +85,7 @@ export function Tooltip({ item, visible }: TooltipProps) {
         fontSize: fs,
         padding: pad,
         gap: gap2,
-        minWidth: Math.round(80 * scale),
-        maxWidth: Math.round(220 * scale),
+        width: 'max-content',
         // Start invisible; applyPosition sets visibility after measuring dimensions
         visibility: 'hidden',
         pointerEvents: 'none',

package/src/connector/demo.ts

@@ -1,5 +1,6 @@
 import type { InventoryAction, InventoryWindowState, PlayerState, SlotState, ItemStack } from '../types'
 import type { InventoryConnector, ConnectorListener, ConnectorEvent } from './types'
+import { isItemEqual, getMaxStackSize } from '../utils/isItemEqual'
 
 export interface ActionLogEntry {
   id: number
@@ -154,11 +155,75 @@ export function createDemoConnector(options: DemoConnectorOptions): InventoryCon
           }
         } else if (action.mode === 'shift' && slotState?.item) {
           // Simulate shift-click: just log it
+        } else if (action.mode === 'double') {
+          // Double-click collect: pick up all matching items from other slots up to maxStack
+          const held = windowState.heldItem
+          if (held) {
+            const maxStack = getMaxStackSize(held)
+            let remaining = maxStack - held.count
+            for (let i = 0; i < slots.length && remaining > 0; i++) {
+              const s = slots[i]
+              if (!s.item || !isItemEqual(s.item, held)) continue
+              const take = Math.min(s.item.count, remaining)
+              slots[i] = { ...s, item: s.item.count - take > 0 ? { ...s.item, count: s.item.count - take } : null }
+              remaining -= take
+            }
+            windowState = { ...windowState, slots, heldItem: { ...held, count: maxStack - remaining } }
+          }
         }
 
         emit({ type: 'windowUpdate', state: windowState })
       }
 
+      // Demo: simulate drag/spread behavior
+      if (action.type === 'drag' && windowState && windowState.heldItem) {
+        const held = windowState.heldItem
+        const maxStack = getMaxStackSize(held)
+        const slots = [...windowState.slots]
+
+        if (action.button === 'left') {
+          // Vanilla left-drag: distribute perSlot items evenly, remainder stays in cursor
+          const compatibleSlots = action.slots.filter((idx) => {
+            const existing = slots.find((s) => s.index === idx)?.item
+            return !existing || isItemEqual(existing, held)
+          })
+          if (compatibleSlots.length > 0) {
+            const perSlot = Math.floor(held.count / compatibleSlots.length)
+            // If perSlot=0 (more slots than items), nothing is distributed
+            if (perSlot > 0) {
+              let totalPlaced = 0
+              for (const idx of compatibleSlots) {
+                const si = slots.findIndex((s) => s.index === idx)
+                const existingCount = si >= 0 ? (slots[si].item?.count ?? 0) : 0
+                const add = Math.min(perSlot, maxStack - existingCount)
+                totalPlaced += add
+                const newCount = existingCount + add
+                if (si >= 0) slots[si] = { ...slots[si], item: { ...held, count: newCount } }
+                else slots.push({ index: idx, item: { ...held, count: newCount } })
+              }
+              const remaining = held.count - totalPlaced
+              windowState = { ...windowState, slots, heldItem: remaining > 0 ? { ...held, count: remaining } : null }
+            }
+          }
+        } else {
+          // Place 1 item per slot (right-click drag)
+          let remaining = held.count
+          for (const idx of action.slots) {
+            if (remaining <= 0) break
+            const si = slots.findIndex((s) => s.index === idx)
+            const existing = si >= 0 ? slots[si].item : null
+            if (existing && !isItemEqual(existing, held)) continue
+            const existingCount = existing?.count ?? 0
+            const newCount = Math.min(existingCount + 1, maxStack)
+            if (si >= 0) slots[si] = { ...slots[si], item: { ...held, count: newCount } }
+            else slots.push({ index: idx, item: { ...held, count: newCount } })
+            remaining--
+          }
+          windowState = { ...windowState, slots, heldItem: remaining > 0 ? { ...held, count: remaining } : null }
+        }
+        emit({ type: 'windowUpdate', state: windowState })
+      }
+
       if (action.type === 'drop' && windowState) {
         const slots = [...windowState.slots]
         const slotState = slots.find((s) => s.index === action.slotIndex)

package/src/connector/mineflayer.ts

@@ -10,19 +10,31 @@ export interface MineflayerConnectorOptions {
   /**
    * Custom item mapper called for every slot conversion from raw mineflayer data to
    * {@link ItemStack}. Receives the raw slot data and the default-mapped stack.
-   * Return a modified stack to override fields (e.g. `name`, `textureKey`, `displayName`),
-   * or return the second argument unchanged to use the default mapping.
+   * Return a modified stack to override fields (e.g. `name`, `textureKey`, `displayName`,
+   * `texture`, `blockTexture`), or return the second argument unchanged to use the default mapping.
    *
    * @example
    * ```ts
    * createMineflayerConnector(bot, {
    *   itemMapper: (raw, mapped) => ({
    *     ...mapped,
-   *     // Override texture for specific numeric type IDs:
    *     textureKey: raw.type === 438 ? 'item/potion_water' : mapped.textureKey,
    *   }),
    * })
    * ```
+   *
+   * @example Block texture with isometric face slices
+   * ```ts
+   * itemMapper: (raw, mapped) => ({
+   *   ...mapped,
+   *   blockTexture: {
+   *     source: blockAtlasUrl,
+   *     top: { slice: [0, 0, 16, 16] },
+   *     left: { slice: [16, 0, 16, 16] },
+   *     right: { slice: [32, 0, 16, 16] },
+   *   },
+   * })
+   * ```
    */
   itemMapper?: (raw: RawSlot, mapped: ItemStack) => ItemStack
 }
@@ -35,6 +47,9 @@ function makeSlotConverter(itemMapper?: MineflayerConnectorOptions['itemMapper']
       count: slot.count,
       metadata: slot.metadata,
       nbt: slot.nbt as Record<string, unknown> | undefined,
+      // Default debug key: "<type>:<metadata>" — visible as data-debug on slot elements.
+      // Override via itemMapper if needed.
+      debugKey: slot.metadata ? `${slot.type}:${slot.metadata}` : String(slot.type),
     }
     return itemMapper ? itemMapper(slot, mapped) : mapped
   }

package/src/context/InventoryContext.tsx

@@ -137,12 +137,11 @@ export function InventoryProvider({ connector, children, noDragSpread = false }:
       })
       if (compatibleSlots.length === 0) return preview
       const perSlot = Math.floor(held.count / compatibleSlots.length)
-      let remainder = held.count % compatibleSlots.length
+      // Vanilla behavior: if perSlot=0 (more slots than items), nothing is distributed
+      if (perSlot === 0) return preview
       for (const idx of compatibleSlots) {
         const existingCount = ws?.slots.find((s) => s.index === idx)?.item?.count ?? 0
-        const add = perSlot + (remainder > 0 ? 1 : 0)
-        if (remainder > 0) remainder--
-        const total = Math.min(existingCount + add, maxStack)
+        const total = Math.min(existingCount + perSlot, maxStack)
         preview.set(idx, { count: total })
       }
     } else {
@@ -197,21 +196,26 @@ export function InventoryProvider({ connector, children, noDragSpread = false }:
           })
           if (compatibleSlots.length > 0) {
             const perSlot = Math.floor(held.count / compatibleSlots.length)
-            let remainder = held.count % compatibleSlots.length
-            for (const idx of compatibleSlots) {
-              const existingIdx = newSlots.findIndex((s) => s.index === idx)
-              const existingCount = existingIdx >= 0 ? (newSlots[existingIdx].item?.count ?? 0) : 0
-              const add = perSlot + (remainder > 0 ? 1 : 0)
-              if (remainder > 0) remainder--
-              const newCount = Math.min(existingCount + add, maxStack)
-              if (existingIdx >= 0) {
-                newSlots[existingIdx] = { index: idx, item: { ...held, count: newCount } }
-              } else {
-                newSlots.push({ index: idx, item: { ...held, count: newCount } })
+            // Vanilla behavior: if perSlot=0 (more slots than items), nothing is distributed
+            if (perSlot > 0) {
+              let totalPlaced = 0
+              for (const idx of compatibleSlots) {
+                const existingIdx = newSlots.findIndex((s) => s.index === idx)
+                const existingCount = existingIdx >= 0 ? (newSlots[existingIdx].item?.count ?? 0) : 0
+                const add = Math.min(perSlot, maxStack - existingCount)
+                totalPlaced += add
+                const newCount = existingCount + add
+                if (existingIdx >= 0) {
+                  newSlots[existingIdx] = { index: idx, item: { ...held, count: newCount } }
+                } else {
+                  newSlots.push({ index: idx, item: { ...held, count: newCount } })
+                }
               }
+              if (ws) setWindowState({ ...ws, slots: newSlots })
+              const remaining = held.count - totalPlaced
+              if (remaining > 0) setHeldItemState({ ...held, count: remaining })
+              else setHeldItemState(null)
             }
-            if (ws) setWindowState({ ...ws, slots: newSlots })
-            setHeldItemState(null)
           }
         } else {
           // Right-click drag: place 1 per slot
@@ -256,6 +260,19 @@ export function InventoryProvider({ connector, children, noDragSpread = false }:
     [windowState],
   )
 
+  // Expose state to window for easier debugging from browser DevTools.
+  // Access via: window.__mcInv
+  useEffect(() => {
+    ;(window as unknown as Record<string, unknown>).__mcInv = {
+      get windowState() { return windowStateRef.current },
+      get heldItem() { return heldItemRef.current },
+      get dragSlots() { return dragSlots },
+      get isDragging() { return isDragging },
+      get focusedSlot() { return focusedSlot },
+      get pKeyActive() { return pKeyActive },
+    }
+  })
+
   const value: InventoryContextValue = {
     windowState,
     playerState,

package/src/generated/localTextures.ts

@@ -28,6 +28,72 @@ import _gui_widgets from 'mc-assets/dist/other-textures/1.15/gui/widgets.png'
 import _gui_sprites_container_anvil_text_field from 'mc-assets/dist/other-textures/latest/gui/sprites/container/anvil/text_field.png'
 import _gui_sprites_container_anvil_text_field_disabled from 'mc-assets/dist/other-textures/latest/gui/sprites/container/anvil/text_field_disabled.png'
 
+/**
+ * Versioned texture path → bundled asset URL (or undefined for remote fallback).
+ * Keys are full mc-assets paths e.g. "1.21.11/textures/gui/container/inventory.png"
+ */
+export const bundledTextureMap: Record<string, string | undefined> = {
+  '1.21.11/textures/gui/container/inventory.png': _gui_container_inventory,
+  '1.21.11/textures/gui/container/shulker_box.png': _gui_container_shulker_box,
+  '1.21.11/textures/gui/container/generic_54.png': _gui_container_generic_54,
+  '1.21.11/textures/gui/container/crafting_table.png': _gui_container_crafting_table,
+  '1.21.11/textures/gui/container/furnace.png': _gui_container_furnace,
+  '1.21.11/textures/gui/container/blast_furnace.png': _gui_container_blast_furnace,
+  '1.21.11/textures/gui/container/smoker.png': _gui_container_smoker,
+  '1.21.11/textures/gui/container/brewing_stand.png': _gui_container_brewing_stand,
+  '1.21.11/textures/gui/container/anvil.png': _gui_container_anvil,
+  '1.21.11/textures/gui/container/grindstone.png': _gui_container_grindstone,
+  '1.21.11/textures/gui/container/enchanting_table.png': _gui_container_enchanting_table,
+  '1.21.11/textures/gui/container/smithing.png': _gui_container_smithing,
+  '1.16.4/textures/gui/container/smithing.png': _gui_container_smithing_2,
+  '1.21.11/textures/gui/container/hopper.png': _gui_container_hopper,
+  '1.21.11/textures/gui/container/dispenser.png': _gui_container_dispenser,
+  '1.21.11/textures/gui/container/beacon.png': _gui_container_beacon,
+  '1.21.11/textures/gui/container/horse.png': _gui_container_horse,
+  '1.14/textures/gui/container/villager2.png': _gui_container_villager2,
+  '1.21.11/textures/gui/container/cartography_table.png': _gui_container_cartography_table,
+  '1.21.11/textures/gui/container/loom.png': _gui_container_loom,
+  '1.21.11/textures/gui/container/stonecutter.png': _gui_container_stonecutter,
+  '1.21.11/textures/gui/container/crafter.png': _gui_container_crafter,
+  '1.21.11/textures/gui/container/creative_inventory/tab_items.png': _gui_container_creative_inventory_tab_items,
+  '1.15/textures/gui/widgets.png': _gui_widgets,
+  '1.21.11/textures/gui/sprites/container/anvil/text_field.png': _gui_sprites_container_anvil_text_field,
+  '1.21.11/textures/gui/sprites/container/anvil/text_field_disabled.png': _gui_sprites_container_anvil_text_field_disabled,
+}
+
+
+/**
+ * All texture paths without version prefix (e.g. "gui/container/inventory.png").
+ * Same set as bundledTextureMap keys with version stripped.
+ */
+export const allTexturePaths: readonly string[] = [
+  'gui/container/inventory.png',
+  'gui/container/shulker_box.png',
+  'gui/container/generic_54.png',
+  'gui/container/crafting_table.png',
+  'gui/container/furnace.png',
+  'gui/container/blast_furnace.png',
+  'gui/container/smoker.png',
+  'gui/container/brewing_stand.png',
+  'gui/container/anvil.png',
+  'gui/container/grindstone.png',
+  'gui/container/enchanting_table.png',
+  'gui/container/smithing.png',
+  'gui/container/hopper.png',
+  'gui/container/dispenser.png',
+  'gui/container/beacon.png',
+  'gui/container/horse.png',
+  'gui/container/villager2.png',
+  'gui/container/cartography_table.png',
+  'gui/container/loom.png',
+  'gui/container/stonecutter.png',
+  'gui/container/crafter.png',
+  'gui/container/creative_inventory/tab_items.png',
+  'gui/widgets.png',
+  'gui/sprites/container/anvil/text_field.png',
+  'gui/sprites/container/anvil/text_field_disabled.png',
+]
+
 /**
  * Maps each inventory type name to its texture path (version prefix stripped).
  */
@@ -68,54 +134,3 @@ export const allContainerPaths: Record<string, string> = {
   creative: 'gui/container/creative_inventory/tab_items.png',
   hotbar: 'gui/widgets.png',
 }
-
-// Internal: versioned texture key → bundled asset URL (or undefined → remote fallback)
-const _map: Record<string, string | undefined> = {
-  '1.21.11/textures/gui/container/inventory.png': _gui_container_inventory,
-  '1.21.11/textures/gui/container/shulker_box.png': _gui_container_shulker_box,
-  '1.21.11/textures/gui/container/generic_54.png': _gui_container_generic_54,
-  '1.21.11/textures/gui/container/crafting_table.png': _gui_container_crafting_table,
-  '1.21.11/textures/gui/container/furnace.png': _gui_container_furnace,
-  '1.21.11/textures/gui/container/blast_furnace.png': _gui_container_blast_furnace,
-  '1.21.11/textures/gui/container/smoker.png': _gui_container_smoker,
-  '1.21.11/textures/gui/container/brewing_stand.png': _gui_container_brewing_stand,
-  '1.21.11/textures/gui/container/anvil.png': _gui_container_anvil,
-  '1.21.11/textures/gui/container/grindstone.png': _gui_container_grindstone,
-  '1.21.11/textures/gui/container/enchanting_table.png': _gui_container_enchanting_table,
-  '1.21.11/textures/gui/container/smithing.png': _gui_container_smithing,
-  '1.16.4/textures/gui/container/smithing.png': _gui_container_smithing_2,
-  '1.21.11/textures/gui/container/hopper.png': _gui_container_hopper,
-  '1.21.11/textures/gui/container/dispenser.png': _gui_container_dispenser,
-  '1.21.11/textures/gui/container/beacon.png': _gui_container_beacon,
-  '1.21.11/textures/gui/container/horse.png': _gui_container_horse,
-  '1.14/textures/gui/container/villager2.png': _gui_container_villager2,
-  '1.21.11/textures/gui/container/cartography_table.png': _gui_container_cartography_table,
-  '1.21.11/textures/gui/container/loom.png': _gui_container_loom,
-  '1.21.11/textures/gui/container/stonecutter.png': _gui_container_stonecutter,
-  '1.21.11/textures/gui/container/crafter.png': _gui_container_crafter,
-  '1.21.11/textures/gui/container/creative_inventory/tab_items.png': _gui_container_creative_inventory_tab_items,
-  '1.15/textures/gui/widgets.png': _gui_widgets,
-  '1.21.11/textures/gui/sprites/container/anvil/text_field.png': _gui_sprites_container_anvil_text_field,
-  '1.21.11/textures/gui/sprites/container/anvil/text_field_disabled.png': _gui_sprites_container_anvil_text_field_disabled,
-}
-
-/**
- * Partial TextureConfig that resolves inventory GUI textures from locally bundled
- * mc-assets assets instead of remote GitHub URLs.
- *
- * Pass to `<TextureProvider config={localTexturesConfig}>` to use offline/bundled assets.
- *
- * Unknown paths (not bundled) fall back to the mc-assets remote URL automatically.
- */
-const _MC_ASSETS_REMOTE = "https://raw.githubusercontent.com/zardoy/mc-assets/refs/heads/gh-pages"
-export const localTexturesConfig = {
-  getGuiTextureUrl(path: string): string {
-    const local = _map[path] as string | undefined
-    if (local) return local
-    // Fall back to remote mc-assets URL for paths not in the bundle
-    if (path.endsWith('.png') && path.includes('/textures/')) {
-      return `${_MC_ASSETS_REMOTE}/${path}`
-    }
-    return path
-  },
-}

package/src/index.tsx

@@ -49,7 +49,7 @@ export type {
 export type { ActionLogEntry, DemoConnectorOptions } from './connector/demo'
 
 // Registry
-export { registerInventoryType, getInventoryType, getAllInventoryTypes } from './registry'
+export { registerInventoryType, registerTypeAlias, getInventoryType, getAllInventoryTypes } from './registry'
 export type { InventoryTypeDefinition, WindowType } from './registry'
 
 // Types
@@ -67,4 +67,22 @@ export type {
   RecipeGuide,
   RecipeNavFrame,
   EntityDisplayArea,
+  TextureSlice,
+  BlockFaceSlice,
+  BlockTextureRender,
 } from './types'
+
+// Bundled textures config
+export {
+  createBundledTexturesConfig,
+  localBundledTexturesConfig,
+  allTexturePaths,
+  allContainerPaths,
+} from './bundledTexturesConfig'
+export type {
+  BundledTexturesConfig,
+  BundledTexturesConfigOptions,
+} from './bundledTexturesConfig'
+
+// Texture cache (for resetRenderedSlots / manual invalidation)
+export { clearTextureCache } from './cache/textureCache'

package/src/registry/index.ts

@@ -5,12 +5,41 @@ 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
+}
+
 export function registerInventoryType(def: InventoryTypeDefinition): void {
   registry.set(def.name, def)
 }
 
+/**
+ * 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")
+ *  - "minecraft:" namespace prefix (e.g. "minecraft:generic_9x3" → "generic_9x3")
+ */
 export function getInventoryType(name: string): InventoryTypeDefinition | undefined {
-  return registry.get(name)
+  // 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
+  return registry.get(canonical)
+}
+
+export function registerTypeAlias(alias: string, canonical: string): void {
+  typeAliases[alias] = canonical
 }
 
 export function getAllInventoryTypes(): InventoryTypeDefinition[] {