specprotocol 1.4.2 → 1.4.4

package/dist/chat.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Chat Component Parser
+ *
+ * Parses Minecraft's JSON chat format into plain text, styled text,
+ * and structured data. Supports colors, formatting, click/hover events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatMessage = void 0;
+// Minecraft color code map
+const COLOR_MAP = {
+    black: '#000000',
+    dark_blue: '#0000AA',
+    dark_green: '#00AA00',
+    dark_aqua: '#00AAAA',
+    dark_red: '#AA0000',
+    dark_purple: '#AA00AA',
+    gold: '#FFAA00',
+    gray: '#AAAAAA',
+    dark_gray: '#555555',
+    blue: '#5555FF',
+    green: '#55FF55',
+    aqua: '#55FFFF',
+    red: '#FF5555',
+    light_purple: '#FF55FF',
+    yellow: '#FFFF55',
+    white: '#FFFFFF',
+};
+// Section sign color codes
+const SECTION_COLORS = {
+    '0': 'black', '1': 'dark_blue', '2': 'dark_green', '3': 'dark_aqua',
+    '4': 'dark_red', '5': 'dark_purple', '6': 'gold', '7': 'gray',
+    '8': 'dark_gray', '9': 'blue', 'a': 'green', 'b': 'aqua',
+    'c': 'red', 'd': 'light_purple', 'e': 'yellow', 'f': 'white',
+};
+class ChatMessage {
+    raw;
+    constructor(component) {
+        if (typeof component === 'string') {
+            try {
+                this.raw = JSON.parse(component);
+            }
+            catch {
+                this.raw = { text: component };
+            }
+        }
+        else {
+            this.raw = component;
+        }
+    }
+    /** Convert to plain text (no formatting) */
+    toString() {
+        return this.extractText(this.raw);
+    }
+    /** Convert to ANSI colored text for terminal */
+    toAnsi() {
+        return this.extractAnsi(this.raw);
+    }
+    /** Convert to HTML */
+    toHTML() {
+        return this.extractHTML(this.raw);
+    }
+    /** Get the color of the root component */
+    get color() {
+        return this.raw.color;
+    }
+    /** Check if message contains text */
+    includes(text) {
+        return this.toString().includes(text);
+    }
+    /** Get click event if present */
+    get clickEvent() {
+        return this.raw.clickEvent;
+    }
+    /** Parse a chat message from raw JSON string or NBT-like data */
+    static parse(data) {
+        if (typeof data === 'string') {
+            return new ChatMessage(data);
+        }
+        return new ChatMessage(data);
+    }
+    /** Parse section sign (§) formatted text */
+    static fromLegacy(text) {
+        const component = { text: '', extra: [] };
+        let current = { text: '' };
+        let i = 0;
+        while (i < text.length) {
+            if (text[i] === '§' && i + 1 < text.length) {
+                // Push current segment
+                if (current.text) {
+                    component.extra.push(current);
+                    current = { text: '' };
+                }
+                const code = text[i + 1].toLowerCase();
+                if (SECTION_COLORS[code]) {
+                    current.color = SECTION_COLORS[code];
+                }
+                else if (code === 'l')
+                    current.bold = true;
+                else if (code === 'o')
+                    current.italic = true;
+                else if (code === 'n')
+                    current.underlined = true;
+                else if (code === 'm')
+                    current.strikethrough = true;
+                else if (code === 'k')
+                    current.obfuscated = true;
+                else if (code === 'r')
+                    current = { text: '' }; // Reset
+                i += 2;
+            }
+            else {
+                current.text += text[i];
+                i++;
+            }
+        }
+        if (current.text) {
+            component.extra.push(current);
+        }
+        return new ChatMessage(component);
+    }
+    extractText(comp) {
+        let text = '';
+        if (comp.text)
+            text += comp.text;
+        if (comp.translate) {
+            text += comp.translate;
+            if (comp.with) {
+                for (let i = 0; i < comp.with.length; i++) {
+                    text = text.replace(`%${i + 1}$s`, this.extractText(comp.with[i]));
+                    text = text.replace('%s', this.extractText(comp.with[i]));
+                }
+            }
+        }
+        if (comp.extra) {
+            for (const child of comp.extra) {
+                text += this.extractText(child);
+            }
+        }
+        return text;
+    }
+    extractAnsi(comp) {
+        let text = '';
+        // Apply color
+        if (comp.color && COLOR_MAP[comp.color]) {
+            text += `\x1b[38;2;${this.hexToRgb(COLOR_MAP[comp.color])}m`;
+        }
+        if (comp.bold)
+            text += '\x1b[1m';
+        if (comp.italic)
+            text += '\x1b[3m';
+        if (comp.underlined)
+            text += '\x1b[4m';
+        if (comp.strikethrough)
+            text += '\x1b[9m';
+        if (comp.text)
+            text += comp.text;
+        if (comp.translate)
+            text += comp.translate;
+        if (comp.extra) {
+            for (const child of comp.extra) {
+                text += this.extractAnsi(child);
+            }
+        }
+        text += '\x1b[0m';
+        return text;
+    }
+    extractHTML(comp) {
+        let styles = [];
+        if (comp.color && COLOR_MAP[comp.color]) {
+            styles.push(`color:${COLOR_MAP[comp.color]}`);
+        }
+        else if (comp.color && /^#[0-9a-fA-F]{6}$/.test(comp.color)) {
+            styles.push(`color:${comp.color}`);
+        }
+        if (comp.bold)
+            styles.push('font-weight:bold');
+        if (comp.italic)
+            styles.push('font-style:italic');
+        if (comp.underlined)
+            styles.push('text-decoration:underline');
+        if (comp.strikethrough)
+            styles.push('text-decoration:line-through');
+        let text = comp.text ?? '';
+        if (comp.translate)
+            text += comp.translate;
+        let html = styles.length > 0
+            ? `<span style="${styles.join(';')}">${this.escapeHtml(text)}`
+            : this.escapeHtml(text);
+        if (comp.extra) {
+            for (const child of comp.extra) {
+                html += this.extractHTML(child);
+            }
+        }
+        if (styles.length > 0)
+            html += '</span>';
+        return html;
+    }
+    hexToRgb(hex) {
+        const r = parseInt(hex.slice(1, 3), 16);
+        const g = parseInt(hex.slice(3, 5), 16);
+        const b = parseInt(hex.slice(5, 7), 16);
+        return `${r};${g};${b}`;
+    }
+    escapeHtml(text) {
+        return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    }
+}
+exports.ChatMessage = ChatMessage;
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * MCBot — A Mineflayer alternative built from scratch in TypeScript.
+ * SpecProtocol — A Minecraft bot framework built from scratch in TypeScript.
  *
  * @example
  * ```ts
- * import { createBot } from 'mcbot';
+ * import { createBot } from 'specprotocol';
  *
  * const bot = await createBot({
  *   host: 'localhost',
@@ -13,7 +13,7 @@
  * });
  *
  * bot.on('spawn', () => {
- *   bot.chat('Hello from MCBot!');
+ *   bot.chat('Hello from SpecProtocol!');
  * });
  * ```
  */
@@ -28,6 +28,13 @@ export { PROTOCOL_VERSION } from './protocol/states/handshake.js';
 export { World } from './world/world.js';
 export { ChunkColumn, ChunkSection, type Block } from './world/block.js';
 export { Entity, PlayerEntity, EntityManager, EntityType } from './entity/entity.js';
+export { TabList, type TabListPlayer, type TabListEvents } from './tablist.js';
+export { ChatMessage, type ChatComponent } from './chat.js';
+export { Inventory, type ItemStack, type InventoryEvents } from './inventory.js';
+export { Scoreboard, type ScoreboardObjective, type ScoreboardScore, type ScoreboardTeam, type ScoreboardEvents } from './scoreboard.js';
+export { BossBarManager, type BossBar, BossBarColor, BossBarDivision, BossBarAction, type BossBarEvents } from './bossbar.js';
+export { Weather, type WeatherState, type WeatherEvents } from './weather.js';
+export { findBlocks, findBlock, type FindBlockOptions, type FoundBlock } from './block-finder.js';
 export { PluginManager, type Plugin } from './plugins/plugin-manager.js';
 export { ChatPlugin } from './plugins/built-in/chat.js';
 export { CombatPlugin } from './plugins/built-in/combat.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACH,aAAa,EACb,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACH,aAAa,EACb,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzI,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9H,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGlG,OAAO,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,10 +1,10 @@
 "use strict";
 /**
- * MCBot — A Mineflayer alternative built from scratch in TypeScript.
+ * SpecProtocol — A Minecraft bot framework built from scratch in TypeScript.
  *
  * @example
  * ```ts
- * import { createBot } from 'mcbot';
+ * import { createBot } from 'specprotocol';
  *
  * const bot = await createBot({
  *   host: 'localhost',
@@ -14,12 +14,12 @@
  * });
  *
  * bot.on('spawn', () => {
- *   bot.chat('Hello from MCBot!');
+ *   bot.chat('Hello from SpecProtocol!');
  * });
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.joinServer = exports.authenticateMicrosoft = exports.offlineUUID = exports.createOfflineProfile = exports.CombatPlugin = exports.ChatPlugin = exports.PluginManager = exports.EntityType = exports.EntityManager = exports.PlayerEntity = exports.Entity = exports.ChunkSection = exports.ChunkColumn = exports.World = exports.PROTOCOL_VERSION = exports.PacketRegistry = exports.PacketDirection = exports.ProtocolState = exports.BufferWriter = exports.BufferReader = exports.Connection = exports.TypedEventEmitter = exports.LogLevel = exports.Logger = exports.Vec3 = exports.createBot = exports.Bot = void 0;
+exports.joinServer = exports.authenticateMicrosoft = exports.offlineUUID = exports.createOfflineProfile = exports.CombatPlugin = exports.ChatPlugin = exports.PluginManager = exports.findBlock = exports.findBlocks = exports.Weather = exports.BossBarAction = exports.BossBarDivision = exports.BossBarColor = exports.BossBarManager = exports.Scoreboard = exports.Inventory = exports.ChatMessage = exports.TabList = exports.EntityType = exports.EntityManager = exports.PlayerEntity = exports.Entity = exports.ChunkSection = exports.ChunkColumn = exports.World = exports.PROTOCOL_VERSION = exports.PacketRegistry = exports.PacketDirection = exports.ProtocolState = exports.BufferWriter = exports.BufferReader = exports.Connection = exports.TypedEventEmitter = exports.LogLevel = exports.Logger = exports.Vec3 = exports.createBot = exports.Bot = void 0;
 // Main Bot
 var bot_js_1 = require("./bot.js");
 Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return bot_js_1.Bot; } });
@@ -56,11 +56,30 @@ Object.defineProperty(exports, "Entity", { enumerable: true, get: function () {
 Object.defineProperty(exports, "PlayerEntity", { enumerable: true, get: function () { return entity_js_1.PlayerEntity; } });
 Object.defineProperty(exports, "EntityManager", { enumerable: true, get: function () { return entity_js_1.EntityManager; } });
 Object.defineProperty(exports, "EntityType", { enumerable: true, get: function () { return entity_js_1.EntityType; } });
+// Core Modules
+var tablist_js_1 = require("./tablist.js");
+Object.defineProperty(exports, "TabList", { enumerable: true, get: function () { return tablist_js_1.TabList; } });
+var chat_js_1 = require("./chat.js");
+Object.defineProperty(exports, "ChatMessage", { enumerable: true, get: function () { return chat_js_1.ChatMessage; } });
+var inventory_js_1 = require("./inventory.js");
+Object.defineProperty(exports, "Inventory", { enumerable: true, get: function () { return inventory_js_1.Inventory; } });
+var scoreboard_js_1 = require("./scoreboard.js");
+Object.defineProperty(exports, "Scoreboard", { enumerable: true, get: function () { return scoreboard_js_1.Scoreboard; } });
+var bossbar_js_1 = require("./bossbar.js");
+Object.defineProperty(exports, "BossBarManager", { enumerable: true, get: function () { return bossbar_js_1.BossBarManager; } });
+Object.defineProperty(exports, "BossBarColor", { enumerable: true, get: function () { return bossbar_js_1.BossBarColor; } });
+Object.defineProperty(exports, "BossBarDivision", { enumerable: true, get: function () { return bossbar_js_1.BossBarDivision; } });
+Object.defineProperty(exports, "BossBarAction", { enumerable: true, get: function () { return bossbar_js_1.BossBarAction; } });
+var weather_js_1 = require("./weather.js");
+Object.defineProperty(exports, "Weather", { enumerable: true, get: function () { return weather_js_1.Weather; } });
+var block_finder_js_1 = require("./block-finder.js");
+Object.defineProperty(exports, "findBlocks", { enumerable: true, get: function () { return block_finder_js_1.findBlocks; } });
+Object.defineProperty(exports, "findBlock", { enumerable: true, get: function () { return block_finder_js_1.findBlock; } });
 // Plugins
 var plugin_manager_js_1 = require("./plugins/plugin-manager.js");
 Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_manager_js_1.PluginManager; } });
-var chat_js_1 = require("./plugins/built-in/chat.js");
-Object.defineProperty(exports, "ChatPlugin", { enumerable: true, get: function () { return chat_js_1.ChatPlugin; } });
+var chat_js_2 = require("./plugins/built-in/chat.js");
+Object.defineProperty(exports, "ChatPlugin", { enumerable: true, get: function () { return chat_js_2.ChatPlugin; } });
 var combat_js_1 = require("./plugins/built-in/combat.js");
 Object.defineProperty(exports, "CombatPlugin", { enumerable: true, get: function () { return combat_js_1.CombatPlugin; } });
 // Auth

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,WAAW;AACX,mCAA2E;AAAlE,6FAAA,GAAG,OAAA;AAAE,mGAAA,SAAS,OAAA;AAEvB,QAAQ;AACR,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,+CAAqD;AAA5C,mGAAA,MAAM,OAAA;AAAE,qGAAA,QAAQ,OAAA;AACzB,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAE1B,WAAW;AACX,0DAA8E;AAArE,2GAAA,UAAU,OAAA;AACnB,gDAAiE;AAAxD,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AACnC,kDAM8B;AAL1B,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AAIlB,+DAAkE;AAAzD,gHAAA,gBAAgB,OAAA;AAEzB,QAAQ;AACR,6CAAyC;AAAhC,iGAAA,KAAK,OAAA;AACd,6CAAyE;AAAhE,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAElC,SAAS;AACT,gDAAqF;AAA5E,mGAAA,MAAM,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,uGAAA,UAAU,OAAA;AAExD,UAAU;AACV,iEAAyE;AAAhE,kHAAA,aAAa,OAAA;AACtB,sDAAwD;AAA/C,qGAAA,UAAU,OAAA;AACnB,0DAA4D;AAAnD,yGAAA,YAAY,OAAA;AAErB,OAAO;AACP,gDAAsE;AAA7D,kHAAA,oBAAoB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAC1C,oDAAwE;AAA/D,qHAAA,qBAAqB,OAAA;AAAE,0GAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,WAAW;AACX,mCAA2E;AAAlE,6FAAA,GAAG,OAAA;AAAE,mGAAA,SAAS,OAAA;AAEvB,QAAQ;AACR,2CAAuC;AAA9B,+FAAA,IAAI,OAAA;AACb,+CAAqD;AAA5C,mGAAA,MAAM,OAAA;AAAE,qGAAA,QAAQ,OAAA;AACzB,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAE1B,WAAW;AACX,0DAA8E;AAArE,2GAAA,UAAU,OAAA;AACnB,gDAAiE;AAAxD,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AACnC,kDAM8B;AAL1B,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AACf,2GAAA,cAAc,OAAA;AAIlB,+DAAkE;AAAzD,gHAAA,gBAAgB,OAAA;AAEzB,QAAQ;AACR,6CAAyC;AAAhC,iGAAA,KAAK,OAAA;AACd,6CAAyE;AAAhE,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAElC,SAAS;AACT,gDAAqF;AAA5E,mGAAA,MAAM,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,uGAAA,UAAU,OAAA;AAExD,eAAe;AACf,2CAA+E;AAAtE,qGAAA,OAAO,OAAA;AAChB,qCAA4D;AAAnD,sGAAA,WAAW,OAAA;AACpB,+CAAiF;AAAxE,yGAAA,SAAS,OAAA;AAClB,iDAAyI;AAAhI,2GAAA,UAAU,OAAA;AACnB,2CAA8H;AAArH,4GAAA,cAAc,OAAA;AAAgB,0GAAA,YAAY,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,2GAAA,aAAa,OAAA;AACnF,2CAA8E;AAArE,qGAAA,OAAO,OAAA;AAChB,qDAAkG;AAAzF,6GAAA,UAAU,OAAA;AAAE,4GAAA,SAAS,OAAA;AAE9B,UAAU;AACV,iEAAyE;AAAhE,kHAAA,aAAa,OAAA;AACtB,sDAAwD;AAA/C,qGAAA,UAAU,OAAA;AACnB,0DAA4D;AAAnD,yGAAA,YAAY,OAAA;AAErB,OAAO;AACP,gDAAsE;AAA7D,kHAAA,oBAAoB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAC1C,oDAAwE;AAA/D,qHAAA,qBAAqB,OAAA;AAAE,0GAAA,UAAU,OAAA"}

package/dist/inventory.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Inventory Manager (Core)
+ *
+ * Tracks the player's inventory: 36 main slots (0-35 = hotbar 0-8 + main 9-35),
+ * armor slots (36-39), off-hand (40), and open container slots.
+ */
+import { TypedEventEmitter } from './utils/events.js';
+import { BufferReader } from './protocol/types.js';
+export interface ItemStack {
+    /** Item count (0 = empty) */
+    count: number;
+    /** Item ID (registry ID) */
+    itemId: number;
+    /** Additional components count */
+    addComponentsCount: number;
+    /** Removed components count */
+    removeComponentsCount: number;
+    /** Raw component data */
+    rawData: Buffer;
+}
+export interface InventoryEvents {
+    'slotUpdate': (slot: number, item: ItemStack | null, windowId: number) => void;
+    'inventoryUpdate': (windowId: number) => void;
+    'heldItemChange': (slot: number) => void;
+}
+export declare class Inventory extends TypedEventEmitter<InventoryEvents> {
+    /** Player inventory slots: 0-8 hotbar, 9-35 main, 36-39 armor, 40 off-hand, 41-45 crafting */
+    private slots;
+    /** Currently open container slots */
+    private containerSlots;
+    /** Current held hotbar slot (0-8) */
+    private _selectedSlot;
+    /** Current open window ID */
+    private _windowId;
+    /** State ID for click container packets */
+    private _stateId;
+    /** Carried item (cursor item) */
+    private _carriedItem;
+    constructor();
+    /** Currently selected hotbar slot (0-8) */
+    get selectedSlot(): number;
+    set selectedSlot(slot: number);
+    /** Current open window ID */
+    get windowId(): number;
+    /** State ID for container operations */
+    get stateId(): number;
+    /** Item currently on cursor */
+    get carriedItem(): ItemStack | null;
+    /** Get item in a player inventory slot (0-45) */
+    getSlot(slot: number): ItemStack | null;
+    /** Get item in currently held hotbar slot */
+    get heldItem(): ItemStack | null;
+    /** Get hotbar items (slots 0-8) */
+    get hotbar(): (ItemStack | null)[];
+    /** Get main inventory items (slots 9-35) */
+    get main(): (ItemStack | null)[];
+    /** Get armor slots: [helmet, chestplate, leggings, boots] */
+    get armor(): (ItemStack | null)[];
+    /** Get off-hand item (slot 40) */
+    get offHand(): ItemStack | null;
+    /** Get helmet (slot 36) */
+    get helmet(): ItemStack | null;
+    /** Get chestplate (slot 37) */
+    get chestplate(): ItemStack | null;
+    /** Get leggings (slot 38) */
+    get leggings(): ItemStack | null;
+    /** Get boots (slot 39) */
+    get boots(): ItemStack | null;
+    /** Get all non-null items */
+    get items(): ItemStack[];
+    /** Count of non-empty slots */
+    get usedSlots(): number;
+    /** Count of empty slots in main inventory (9-35) + hotbar (0-8) */
+    get emptySlots(): number;
+    /** Find first slot with matching item ID */
+    findItem(itemId: number): number;
+    /** Find all slots with matching item ID */
+    findAllItems(itemId: number): number[];
+    /** Count total items of a given ID across all slots */
+    countItem(itemId: number): number;
+    /** Get item in container slot */
+    getContainerSlot(slot: number): ItemStack | null;
+    /** Get all container slots */
+    get container(): (ItemStack | null)[];
+    /** Set a single slot (from server packet) */
+    setSlot(windowId: number, slot: number, item: ItemStack | null, stateId?: number): void;
+    /** Set all container contents (from server packet) */
+    setContainerContent(windowId: number, items: (ItemStack | null)[], stateId: number, carriedItem: ItemStack | null): void;
+    /** Open a new container window */
+    openWindow(windowId: number, slotCount: number): void;
+    /** Close current container */
+    closeWindow(): void;
+    /** Clear all inventory data */
+    clear(): void;
+    /** Parse an item stack from buffer data */
+    static parseItem(reader: BufferReader): ItemStack | null;
+}
+//# sourceMappingURL=inventory.d.ts.map

package/dist/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"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"}

package/dist/inventory.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Inventory Manager (Core)
+ *
+ * Tracks the player's inventory: 36 main slots (0-35 = hotbar 0-8 + main 9-35),
+ * armor slots (36-39), off-hand (40), and open container slots.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inventory = void 0;
+const events_js_1 = require("./utils/events.js");
+class Inventory extends events_js_1.TypedEventEmitter {
+    /** Player inventory slots: 0-8 hotbar, 9-35 main, 36-39 armor, 40 off-hand, 41-45 crafting */
+    slots = new Array(46).fill(null);
+    /** Currently open container slots */
+    containerSlots = [];
+    /** Current held hotbar slot (0-8) */
+    _selectedSlot = 0;
+    /** Current open window ID */
+    _windowId = 0;
+    /** State ID for click container packets */
+    _stateId = 0;
+    /** Carried item (cursor item) */
+    _carriedItem = null;
+    constructor() {
+        super();
+    }
+    // ─── Getters ────────────────────────────
+    /** Currently selected hotbar slot (0-8) */
+    get selectedSlot() { return this._selectedSlot; }
+    set selectedSlot(slot) {
+        this._selectedSlot = slot;
+        this.emit('heldItemChange', slot);
+    }
+    /** Current open window ID */
+    get windowId() { return this._windowId; }
+    /** State ID for container operations */
+    get stateId() { return this._stateId; }
+    /** Item currently on cursor */
+    get carriedItem() { return this._carriedItem; }
+    // ─── Slot Access ────────────────────────
+    /** Get item in a player inventory slot (0-45) */
+    getSlot(slot) {
+        if (slot < 0 || slot >= this.slots.length)
+            return null;
+        return this.slots[slot] ?? null;
+    }
+    /** Get item in currently held hotbar slot */
+    get heldItem() {
+        return this.getSlot(this._selectedSlot);
+    }
+    /** Get hotbar items (slots 0-8) */
+    get hotbar() {
+        return this.slots.slice(0, 9);
+    }
+    /** Get main inventory items (slots 9-35) */
+    get main() {
+        return this.slots.slice(9, 36);
+    }
+    /** Get armor slots: [helmet, chestplate, leggings, boots] */
+    get armor() {
+        return this.slots.slice(36, 40);
+    }
+    /** Get off-hand item (slot 40) */
+    get offHand() {
+        return this.slots[40] ?? null;
+    }
+    /** Get helmet (slot 36) */
+    get helmet() { return this.slots[36] ?? null; }
+    /** Get chestplate (slot 37) */
+    get chestplate() { return this.slots[37] ?? null; }
+    /** Get leggings (slot 38) */
+    get leggings() { return this.slots[38] ?? null; }
+    /** Get boots (slot 39) */
+    get boots() { return this.slots[39] ?? null; }
+    /** Get all non-null items */
+    get items() {
+        return this.slots.filter(Boolean);
+    }
+    /** Count of non-empty slots */
+    get usedSlots() {
+        return this.items.length;
+    }
+    /** Count of empty slots in main inventory (9-35) + hotbar (0-8) */
+    get emptySlots() {
+        let count = 0;
+        for (let i = 0; i < 36; i++) {
+            if (!this.slots[i])
+                count++;
+        }
+        return count;
+    }
+    /** Find first slot with matching item ID */
+    findItem(itemId) {
+        for (let i = 0; i < this.slots.length; i++) {
+            if (this.slots[i]?.itemId === itemId)
+                return i;
+        }
+        return -1;
+    }
+    /** Find all slots with matching item ID */
+    findAllItems(itemId) {
+        const result = [];
+        for (let i = 0; i < this.slots.length; i++) {
+            if (this.slots[i]?.itemId === itemId)
+                result.push(i);
+        }
+        return result;
+    }
+    /** Count total items of a given ID across all slots */
+    countItem(itemId) {
+        let count = 0;
+        for (const slot of this.slots) {
+            if (slot?.itemId === itemId)
+                count += slot.count;
+        }
+        return count;
+    }
+    // ─── Container Slots ────────────────────
+    /** Get item in container slot */
+    getContainerSlot(slot) {
+        if (slot < 0 || slot >= this.containerSlots.length)
+            return null;
+        return this.containerSlots[slot] ?? null;
+    }
+    /** Get all container slots */
+    get container() {
+        return this.containerSlots;
+    }
+    // ─── Updates ────────────────────────────
+    /** Set a single slot (from server packet) */
+    setSlot(windowId, slot, item, stateId) {
+        if (stateId !== undefined)
+            this._stateId = stateId;
+        if (windowId === 0 || windowId === -1) {
+            // Player inventory
+            if (slot >= 0 && slot < this.slots.length) {
+                this.slots[slot] = item;
+                this.emit('slotUpdate', slot, item, windowId);
+            }
+        }
+        else {
+            // Container
+            if (slot >= 0) {
+                if (slot >= this.containerSlots.length) {
+                    this.containerSlots.length = slot + 1;
+                }
+                this.containerSlots[slot] = item;
+                this.emit('slotUpdate', slot, item, windowId);
+            }
+        }
+    }
+    /** Set all container contents (from server packet) */
+    setContainerContent(windowId, items, stateId, carriedItem) {
+        this._windowId = windowId;
+        this._stateId = stateId;
+        this._carriedItem = carriedItem;
+        if (windowId === 0) {
+            // Player inventory update
+            for (let i = 0; i < Math.min(items.length, this.slots.length); i++) {
+                this.slots[i] = items[i] ?? null;
+            }
+        }
+        else {
+            // Container
+            this.containerSlots = items;
+        }
+        this.emit('inventoryUpdate', windowId);
+    }
+    /** Open a new container window */
+    openWindow(windowId, slotCount) {
+        this._windowId = windowId;
+        this.containerSlots = new Array(slotCount).fill(null);
+    }
+    /** Close current container */
+    closeWindow() {
+        this._windowId = 0;
+        this.containerSlots = [];
+    }
+    /** Clear all inventory data */
+    clear() {
+        this.slots.fill(null);
+        this.containerSlots = [];
+        this._selectedSlot = 0;
+        this._windowId = 0;
+        this._stateId = 0;
+        this._carriedItem = null;
+    }
+    // ─── Item Parsing ───────────────────────
+    /** Parse an item stack from buffer data */
+    static parseItem(reader) {
+        const count = reader.readVarInt();
+        if (count <= 0)
+            return null;
+        const itemId = reader.readVarInt();
+        const addComponentsCount = reader.readVarInt();
+        const removeComponentsCount = reader.readVarInt();
+        // Skip component data for now (complex NBT-like structure)
+        const rawData = reader.readBytes(reader.remaining);
+        return {
+            count,
+            itemId,
+            addComponentsCount,
+            removeComponentsCount,
+            rawData,
+        };
+    }
+}
+exports.Inventory = Inventory;
+//# sourceMappingURL=inventory.js.map

package/dist/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"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"}