@spyglassmc/nbt 0.1.0

package/lib/parser/compound.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compound = void 0;
+const core = __importStar(require("@spyglassmc/core"));
+const entry_1 = require("./entry");
+const compound = (src, ctx) => {
+    return core.setType('nbt:compound', core.record({
+        start: '{',
+        pair: {
+            key: core.failOnEmpty(core.string({ ...core.BrigadierStringOptions, colorTokenType: 'property' })),
+            sep: ':',
+            value: entry_1.entry,
+            end: ',',
+            trailingEnd: false,
+        },
+        end: '}',
+    }))(src, ctx);
+};
+exports.compound = compound;
+//# sourceMappingURL=compound.js.map

package/lib/parser/entry.d.ts

@@ -0,0 +1,4 @@
+import * as core from '@spyglassmc/core';
+import type { NbtNode } from '../node';
+export declare const entry: core.Parser<NbtNode>;
+//# sourceMappingURL=entry.d.ts.map

package/lib/parser/entry.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entry = void 0;
+const core = __importStar(require("@spyglassmc/core"));
+const collection_1 = require("./collection");
+const compound_1 = require("./compound");
+const primitive_1 = require("./primitive");
+const entry = (src, ctx) => core.failOnEmpty(core.any([
+    primitive_1.primitive,
+    compound_1.compound,
+    collection_1.list,
+    collection_1.byteArray,
+    collection_1.intArray,
+    collection_1.longArray,
+]))(src, ctx);
+exports.entry = entry;
+//# sourceMappingURL=entry.js.map

package/lib/parser/index.d.ts

@@ -0,0 +1,6 @@
+export * from './collection';
+export * from './compound';
+export * from './entry';
+export * from './path';
+export * from './primitive';
+//# sourceMappingURL=index.d.ts.map

package/lib/parser/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./collection"), exports);
+__exportStar(require("./compound"), exports);
+__exportStar(require("./entry"), exports);
+__exportStar(require("./path"), exports);
+__exportStar(require("./primitive"), exports);
+//# sourceMappingURL=index.js.map

package/lib/parser/path.d.ts

@@ -0,0 +1,4 @@
+import * as core from '@spyglassmc/core';
+import type { NbtPathNode } from '../node';
+export declare const path: core.Parser<NbtPathNode>;
+//# sourceMappingURL=path.d.ts.map

package/lib/parser/path.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.path = void 0;
+const core = __importStar(require("@spyglassmc/core"));
+const lib_1 = require("../../../locales/lib");
+const compound_1 = require("./compound");
+const path = (src, ctx) => {
+    const ans = {
+        type: 'nbt:path',
+        children: [],
+        range: core.Range.create(src),
+    };
+    let expectedParts = ['filter', 'key'];
+    let currentPart = nextPart(src);
+    let cursor;
+    while (cursor !== src.cursor) {
+        if (!expectedParts.includes(currentPart)) {
+            ctx.err.report((0, lib_1.localize)('expected-got', (0, lib_1.arrayToMessage)(expectedParts.map(localizePart), false, 'or'), localizePart(currentPart)), src);
+        }
+        if (currentPart === 'end') {
+            break;
+        }
+        cursor = src.cursor;
+        expectedParts = PartParsers[currentPart](ans.children, src, ctx);
+        currentPart = nextPart(src);
+    }
+    ans.range.end = src.cursor;
+    return ans;
+};
+exports.path = path;
+const filter = (children, src, ctx) => {
+    children.push((0, compound_1.compound)(src, ctx));
+    return src.trySkip('.') ? ['key'] : ['end'];
+};
+const index = (children, src, ctx) => {
+    const node = {
+        type: 'nbt:path/index',
+        children: undefined,
+        range: core.Range.create(src),
+    };
+    if (!src.trySkip('[')) {
+        throw new Error(`NBT path index parser called at illegal position: “${src.peek()}” at ${src.cursor}`);
+    }
+    src.skipSpace();
+    const c = src.peek();
+    if (c === '{') {
+        node.children = [(0, compound_1.compound)(src, ctx)];
+    }
+    else if (c !== ']') {
+        node.children = [core.integer({ pattern: /^-?\d+$/ })(src, ctx)];
+    }
+    src.skipSpace();
+    if (!src.trySkip(']')) {
+        ctx.err.report((0, lib_1.localize)('expected-got', (0, lib_1.localeQuote)(']'), (0, lib_1.localeQuote)(src.peek())), src);
+    }
+    node.range.end = src.cursor;
+    children.push(node);
+    return src.trySkip('.')
+        ? ['index', 'key']
+        : ['end', 'index'];
+};
+const key = (children, src, ctx) => {
+    const node = core.string({
+        colorTokenType: 'property',
+        escapable: {},
+        // No single quotes: https://bugs.mojang.com/browse/MC-175504
+        quotes: ['"'],
+        unquotable: { blockList: new Set(['\n', '\r', '\t', ' ', '"', '[', ']', '.', '{', '}']) },
+    })(src, ctx);
+    children.push(node);
+    return src.trySkip('.')
+        ? ['index', 'key']
+        : ['end', 'filter', 'index'];
+};
+function nextPart(src) {
+    switch (src.peek()) {
+        case '':
+        case ' ':
+        case '\n':
+        case '\r':
+            return 'end';
+        case '{':
+            return 'filter';
+        case '[':
+            return 'index';
+        default:
+            return 'key';
+    }
+}
+function localizePart(part) {
+    return (0, lib_1.localize)(`nbt.node.path.${part}`);
+}
+const PartParsers = {
+    filter,
+    index,
+    key,
+};
+//# sourceMappingURL=path.js.map

package/lib/parser/primitive.d.ts

@@ -0,0 +1,5 @@
+import * as core from '@spyglassmc/core';
+import type { NbtPrimitiveNode } from '../node';
+export declare const string: core.InfallibleParser<core.StringNode>;
+export declare const primitive: core.InfallibleParser<NbtPrimitiveNode>;
+//# sourceMappingURL=primitive.d.ts.map

package/lib/parser/primitive.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.primitive = exports.string = void 0;
+const core = __importStar(require("@spyglassmc/core"));
+const locales_1 = require("@spyglassmc/locales");
+const util_1 = require("../util");
+const FloatMaximum = (2 - (2 ** -23)) * (2 ** 127);
+const NumeralPatterns = [
+    { pattern: /^[-+]?(?:0|[1-9][0-9]*)b$/i, type: 'nbt:byte', hasSuffix: true, group: 2 /* IntegerAlike */, min: -128, max: 127 },
+    { pattern: /^[-+]?(?:0|[1-9][0-9]*)s$/i, type: 'nbt:short', hasSuffix: true, group: 2 /* IntegerAlike */, min: -32768, max: 32767 },
+    { pattern: /^[-+]?(?:0|[1-9][0-9]*)$/, type: 'nbt:int', hasSuffix: false, group: 2 /* IntegerAlike */, min: -2147483648, max: 2147483647 },
+    { pattern: /^[-+]?(?:0|[1-9][0-9]*)l$/i, type: 'nbt:long', hasSuffix: true, group: 3 /* LongAlike */, min: -9223372036854775808n, max: 9223372036854775807n },
+    { pattern: /^[-+]?(?:[0-9]+\.?|[0-9]*\.[0-9]+)(?:e[-+]?[0-9]+)?f$/i, type: 'nbt:float', hasSuffix: true, group: 1 /* FloatAlike */, min: -FloatMaximum, max: FloatMaximum },
+    { pattern: /^[-+]?(?:[0-9]+\.|[0-9]*\.[0-9]+)(?:e[-+]?[0-9]+)?$/i, type: 'nbt:double', hasSuffix: false, group: 1 /* FloatAlike */, min: -Number.MAX_VALUE, max: Number.MAX_VALUE },
+    { pattern: /^[-+]?(?:[0-9]+\.?|[0-9]*\.[0-9]+)(?:e[-+]?[0-9]+)?d$/i, type: 'nbt:double', hasSuffix: true, group: 1 /* FloatAlike */, min: -Number.MAX_VALUE, max: Number.MAX_VALUE },
+    { pattern: /^true$/i, type: 'nbt:byte', value: 1, group: 0 /* Boolean */ },
+    { pattern: /^false$/i, type: 'nbt:byte', value: 0, group: 0 /* Boolean */ },
+];
+exports.string = core.brigadierString;
+const primitive = (src, ctx) => {
+    if (core.Source.isBrigadierQuote(src.peek())) {
+        return (0, exports.string)(src, ctx);
+    }
+    const { result: unquotedResult, updateSrcAndCtx: updateUnquoted } = core.attempt(exports.string, src, ctx);
+    for (const e of NumeralPatterns) {
+        if (e.pattern.test(unquotedResult.value)) {
+            if (e.group === 0 /* Boolean */) {
+                const ans = {
+                    type: 'nbt:byte',
+                    range: unquotedResult.range,
+                    value: e.value,
+                };
+                updateUnquoted();
+                return ans;
+            }
+            let isOutOfRange = false;
+            const onOutOfRange = () => isOutOfRange = true;
+            const numeralParser = e.group === 2 /* IntegerAlike */
+                // As we already checked the format of the value with `e.pattern` in the if-block, there is no need to check
+                // it again here in the parser, therefore we just pass in a simple /./ regex.
+                ? core.integer({ pattern: /./, min: e.min, max: e.max, onOutOfRange })
+                : e.group === 3 /* LongAlike */
+                    ? core.long({ pattern: /./, min: e.min, max: e.max, onOutOfRange })
+                    : core.float({ pattern: /./, min: e.min, max: e.max, onOutOfRange });
+            const { result: numeralResult, updateSrcAndCtx: updateNumeral } = core.attempt(numeralParser, src, ctx);
+            if (isOutOfRange) {
+                ctx.err.report((0, locales_1.localize)('nbt.parser.number.out-of-range', (0, util_1.localizeTag)(e.type), (0, locales_1.localize)('nbt.node.string'), e.min, e.max), unquotedResult, 2 /* Warning */);
+                break;
+            }
+            updateNumeral();
+            if (e.hasSuffix) {
+                src.skip();
+                numeralResult.range.end++;
+            }
+            return {
+                ...numeralResult,
+                type: e.type,
+            };
+        }
+    }
+    updateUnquoted();
+    return unquotedResult;
+};
+exports.primitive = primitive;
+//# sourceMappingURL=primitive.js.map

package/lib/util.d.ts

@@ -0,0 +1,3 @@
+import type { NbtNode } from './node';
+export declare function localizeTag(type: NbtNode['type']): string;
+//# sourceMappingURL=util.d.ts.map

package/lib/util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localizeTag = void 0;
+const locales_1 = require("@spyglassmc/locales");
+function localizeTag(type) {
+    return (0, locales_1.localize)(`nbt.node.${type.replace(/^nbt:/, '')}`);
+}
+exports.localizeTag = localizeTag;
+//# sourceMappingURL=util.js.map

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@spyglassmc/nbt",
+  "version": "0.1.0",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "author": "SPGoding",
+  "license": "MIT",
+  "directories": {
+    "test": "test/"
+  },
+  "scripts": {
+    "release": "npm publish",
+    "release:dry": "npm publish --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SpyglassMC/Spyglass.git"
+  },
+  "homepage": "https://spyglassmc.com",
+  "bugs": {
+    "url": "https://github.com/SpyglassMC/Spyglass/issues"
+  },
+  "dependencies": {
+    "@spyglassmc/core": "0.1.0",
+    "@spyglassmc/locales": "0.1.0",
+    "@spyglassmc/nbtdoc": "0.1.0"
+  }
+}