@rhost/testkit 0.1.1 → 1.3.1

package/dist/validator/formatter.js

@@ -0,0 +1,120 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Softcode Formatter — serialize an AST back to a normalized string
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = format;
+const tokenizer_1 = require("./tokenizer");
+const parser_1 = require("./parser");
+/**
+ * Format a MUSHcode expression.
+ *
+ * Compact mode (default): strips extra whitespace around `(`, `,`, `)` while
+ * preserving whitespace inside argument text.
+ *
+ * Pretty mode: additionally adds newlines + indentation at each nesting level
+ * for human readability. Not suitable for direct upload to a MUSH server.
+ */
+function format(expr, options = {}) {
+    const tokens = (0, tokenizer_1.tokenize)(expr);
+    const { nodes } = (0, parser_1.parse)(tokens);
+    const serializer = new Serializer(options);
+    const formatted = serializer.serializeNodes(nodes, 0);
+    return { formatted, changed: formatted !== expr };
+}
+// ---------------------------------------------------------------------------
+// Serializer
+// ---------------------------------------------------------------------------
+class Serializer {
+    constructor(opts) {
+        this.opts = opts;
+    }
+    serializeNodes(nodes, depth) {
+        return nodes.map(n => this.serializeNode(n, depth)).join('');
+    }
+    serializeNode(node, depth) {
+        switch (node.type) {
+            case 'FunctionCall': return this.serializeFunctionCall(node, depth);
+            case 'BracketEval': return this.serializeBracketEval(node, depth);
+            case 'Substitution': return node.raw;
+            case 'RawText': return node.value;
+        }
+    }
+    serializeFunctionCall(node, depth) {
+        const name = this.opts.lowercase ? node.name.toLowerCase() : node.name;
+        if (node.args.length === 0) {
+            return `${name}()`;
+        }
+        // Trim leading/trailing RawText whitespace from each arg
+        const trimmedArgs = node.args.map(arg => trimArgWhitespace(arg));
+        const pretty = this.opts.pretty;
+        // Pretty mode: wrap if any arg contains a function call
+        if (pretty && hasNestedCall(trimmedArgs)) {
+            const indent = '  '.repeat(depth + 1);
+            const closingIndent = '  '.repeat(depth);
+            const serializedArgs = trimmedArgs.map(arg => indent + this.serializeNodes(arg, depth + 1));
+            return `${name}(\n${serializedArgs.join(',\n')}\n${closingIndent})`;
+        }
+        const serializedArgs = trimmedArgs.map(arg => this.serializeNodes(arg, depth + 1));
+        return `${name}(${serializedArgs.join(',')})`;
+    }
+    serializeBracketEval(node, depth) {
+        return `[${this.serializeNodes(node.nodes, depth)}]`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Trim leading and trailing RawText-whitespace-only nodes from an arg list. */
+function trimArgWhitespace(arg) {
+    if (arg.length === 0)
+        return arg;
+    let start = 0;
+    let end = arg.length - 1;
+    // Trim leading whitespace-only RawText nodes
+    while (start <= end) {
+        const node = arg[start];
+        if (node.type === 'RawText' && node.value.trim() === '') {
+            start++;
+        }
+        else {
+            break;
+        }
+    }
+    // Trim trailing whitespace-only RawText nodes
+    while (end >= start) {
+        const node = arg[end];
+        if (node.type === 'RawText' && node.value.trim() === '') {
+            end--;
+        }
+        else {
+            break;
+        }
+    }
+    if (start > end)
+        return [];
+    const trimmed = arg.slice(start, end + 1);
+    // Also trim leading whitespace from the value of the first RawText node
+    // (handles cases like arg starting with a non-whitespace-only RawText that begins with spaces)
+    if (trimmed.length > 0 && trimmed[0].type === 'RawText') {
+        const first = trimmed[0];
+        const trimmedValue = first.value.trimStart();
+        if (trimmedValue !== first.value) {
+            trimmed[0] = { ...first, value: trimmedValue };
+        }
+    }
+    // And trailing whitespace from the last RawText node
+    if (trimmed.length > 0 && trimmed[trimmed.length - 1].type === 'RawText') {
+        const last = trimmed[trimmed.length - 1];
+        const trimmedValue = last.value.trimEnd();
+        if (trimmedValue !== last.value) {
+            trimmed[trimmed.length - 1] = { ...last, value: trimmedValue };
+        }
+    }
+    return trimmed;
+}
+/** Returns true if any arg list contains a FunctionCall node (for pretty indentation decisions). */
+function hasNestedCall(args) {
+    return args.some(arg => arg.some(node => node.type === 'FunctionCall' || node.type === 'BracketEval'));
+}
+//# sourceMappingURL=formatter.js.map

package/dist/validator/formatter.js.map

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

package/dist/validator/index.d.ts

@@ -0,0 +1,57 @@
+import { CompatibilityReport } from './compat';
+import { ValidationResult } from './types';
+export { ValidationResult, Diagnostic, Severity } from './types';
+export { FunctionSignature, BUILTIN_FUNCTIONS, Platform } from './builtins';
+export { CompatibilityReport, CompatibilityEntry } from './compat';
+/**
+ * Validate a RhostMUSH softcode expression without a server connection.
+ *
+ * The validator runs three stages:
+ *  1. **Tokenizer** — converts the expression to a flat token stream
+ *  2. **Parser** — builds an AST; detects structural errors (unbalanced parens/brackets)
+ *  3. **Semantic checker** — validates function names and argument counts
+ *
+ * `valid` is `true` unless at least one diagnostic has `severity: 'error'`.
+ * Warnings do not affect validity.
+ *
+ * @example
+ *   import { validate } from '@rhost/testkit/validator';
+ *
+ *   const result = validate('add(2,3)');
+ *   // { valid: true, diagnostics: [] }
+ *
+ *   const bad = validate('add(2,3');
+ *   // { valid: false, diagnostics: [{ code: 'E001', severity: 'error', ... }] }
+ *
+ * @example Catch wrong arg count
+ *   validate('abs(1,2)');
+ *   // { valid: false, diagnostics: [{ code: 'E007', ... }] }
+ *
+ * @example Unknown function (warning, still valid)
+ *   validate('myfunc(arg)');
+ *   // { valid: true, diagnostics: [{ code: 'W005', severity: 'warning', ... }] }
+ */
+export declare function validate(expr: string): ValidationResult;
+/**
+ * Analyse a softcode expression for cross-platform dialect compatibility.
+ *
+ * Returns a `CompatibilityReport` listing any functions that are not
+ * available on all MUSH platforms (PennMUSH, TinyMUX, RhostMUSH).
+ *
+ * @example
+ *   const report = compatibilityReport('encode64(hello)');
+ *   // report.portable === false
+ *   // report.restricted === [{ name: 'encode64', platforms: ['rhost'] }]
+ */
+export declare function compatibilityReport(expr: string): CompatibilityReport;
+/**
+ * Validate the softcode expression contained in a file.
+ *
+ * The entire file content is treated as a single expression.
+ * For files with multiple expressions (e.g. one per line) consider
+ * reading and validating each line individually.
+ *
+ * @throws If the file cannot be read.
+ */
+export declare function validateFile(filePath: string): ValidationResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,mBAAmB,EAAsB,MAAM,UAAU,CAAC;AACvF,OAAO,EAAc,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAwBvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAOrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAG/D"}

package/dist/validator/index.js

@@ -0,0 +1,133 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Public API for the RhostMUSH softcode offline validator
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_FUNCTIONS = void 0;
+exports.validate = validate;
+exports.compatibilityReport = compatibilityReport;
+exports.validateFile = validateFile;
+const fs = __importStar(require("fs"));
+const tokenizer_1 = require("./tokenizer");
+const parser_1 = require("./parser");
+const checker_1 = require("./checker");
+const clobber_1 = require("./clobber");
+const compat_1 = require("./compat");
+var builtins_1 = require("./builtins");
+Object.defineProperty(exports, "BUILTIN_FUNCTIONS", { enumerable: true, get: function () { return builtins_1.BUILTIN_FUNCTIONS; } });
+/**
+ * Validate a RhostMUSH softcode expression without a server connection.
+ *
+ * The validator runs three stages:
+ *  1. **Tokenizer** — converts the expression to a flat token stream
+ *  2. **Parser** — builds an AST; detects structural errors (unbalanced parens/brackets)
+ *  3. **Semantic checker** — validates function names and argument counts
+ *
+ * `valid` is `true` unless at least one diagnostic has `severity: 'error'`.
+ * Warnings do not affect validity.
+ *
+ * @example
+ *   import { validate } from '@rhost/testkit/validator';
+ *
+ *   const result = validate('add(2,3)');
+ *   // { valid: true, diagnostics: [] }
+ *
+ *   const bad = validate('add(2,3');
+ *   // { valid: false, diagnostics: [{ code: 'E001', severity: 'error', ... }] }
+ *
+ * @example Catch wrong arg count
+ *   validate('abs(1,2)');
+ *   // { valid: false, diagnostics: [{ code: 'E007', ... }] }
+ *
+ * @example Unknown function (warning, still valid)
+ *   validate('myfunc(arg)');
+ *   // { valid: true, diagnostics: [{ code: 'W005', severity: 'warning', ... }] }
+ */
+function validate(expr) {
+    // Empty expression: valid but warn
+    if (expr.trim() === '') {
+        const diagnostics = [
+            {
+                severity: 'warning',
+                code: 'W001',
+                message: 'Expression is empty',
+                offset: 0,
+                length: 0,
+            },
+        ];
+        return { valid: true, diagnostics };
+    }
+    const tokens = (0, tokenizer_1.tokenize)(expr);
+    const { nodes, diagnostics: structural } = (0, parser_1.parse)(tokens);
+    const semantic = (0, checker_1.semanticCheck)(nodes);
+    const clobber = (0, clobber_1.registerClobberCheck)(nodes);
+    const all = [...structural, ...semantic, ...clobber];
+    const valid = !all.some((d) => d.severity === 'error');
+    return { valid, diagnostics: all };
+}
+/**
+ * Analyse a softcode expression for cross-platform dialect compatibility.
+ *
+ * Returns a `CompatibilityReport` listing any functions that are not
+ * available on all MUSH platforms (PennMUSH, TinyMUX, RhostMUSH).
+ *
+ * @example
+ *   const report = compatibilityReport('encode64(hello)');
+ *   // report.portable === false
+ *   // report.restricted === [{ name: 'encode64', platforms: ['rhost'] }]
+ */
+function compatibilityReport(expr) {
+    if (expr.trim() === '') {
+        return { restricted: [], portable: true };
+    }
+    const tokens = (0, tokenizer_1.tokenize)(expr);
+    const { nodes } = (0, parser_1.parse)(tokens);
+    return (0, compat_1.compatibilityCheck)(nodes);
+}
+/**
+ * Validate the softcode expression contained in a file.
+ *
+ * The entire file content is treated as a single expression.
+ * For files with multiple expressions (e.g. one per line) consider
+ * reading and validating each line individually.
+ *
+ * @throws If the file cannot be read.
+ */
+function validateFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return validate(content);
+}
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0C9E,4BAwBC;AAaD,kDAOC;AAWD,oCAGC;AAlGD,uCAAyB;AACzB,2CAAuC;AACvC,qCAAiC;AACjC,uCAA0C;AAC1C,uCAAiD;AACjD,qCAAuF;AAIvF,uCAA4E;AAAhD,6GAAA,iBAAiB,OAAA;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,QAAQ,CAAC,IAAY;IACnC,mCAAmC;IACnC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,MAAM,WAAW,GAAiB;YAChC;gBACE,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,qBAAqB;gBAC9B,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,CAAC;aACV;SACF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAA,uBAAa,EAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,KAAK,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAEvD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,CAAC;IAChC,OAAO,IAAA,2BAAkB,EAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,QAAgB;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/dist/validator/parser.d.ts

@@ -0,0 +1,16 @@
+import { Token } from './tokenizer';
+import { ASTNode, Diagnostic } from './types';
+export interface ParseResult {
+    nodes: ASTNode[];
+    /** Structural diagnostics: unclosed parens/brackets, stray ), ], etc. */
+    diagnostics: Diagnostic[];
+}
+/**
+ * Parse a flat token stream into an AST.
+ *
+ * Structural errors (unbalanced parens/brackets) are embedded in `diagnostics`.
+ * The returned `nodes` array always contains the best-effort parse even when
+ * there are errors, enabling downstream semantic checks to still run.
+ */
+export declare function parse(tokens: Token[]): ParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/validator/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/validator/parser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAmB,UAAU,EAAmD,MAAM,SAAS,CAAC;AAEhH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AA4RD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAIlD"}

package/dist/validator/parser.js

@@ -0,0 +1,260 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// RhostMUSH softcode recursive-descent parser
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+// ---------------------------------------------------------------------------
+// Parser class
+// ---------------------------------------------------------------------------
+class Parser {
+    constructor(tokens) {
+        this.tokens = tokens;
+        this.pos = 0;
+        this.diagnostics = [];
+    }
+    peek() {
+        return this.pos < this.tokens.length ? this.tokens[this.pos] : null;
+    }
+    consume() {
+        if (this.pos >= this.tokens.length) {
+            throw new Error('Unexpected end of token stream');
+        }
+        return this.tokens[this.pos++];
+    }
+    // -------------------------------------------------------------------------
+    // Top-level entry point
+    // -------------------------------------------------------------------------
+    /**
+     * Parse the entire token stream as a top-level expression.
+     * Stray `)` and `]` at the top level are reported as errors.
+     * Top-level commas are treated as literal text.
+     */
+    parseTopLevel() {
+        const nodes = [];
+        while (this.peek() !== null) {
+            const tok = this.peek();
+            if (tok.type === 'RPAREN') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E002',
+                    message: `Unexpected ')' — no matching '(' was opened`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            if (tok.type === 'RBRACKET') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E004',
+                    message: `Unexpected ']' — no matching '[' was opened`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            if (tok.type === 'COMMA') {
+                // Top-level comma is literal text (not inside a function call)
+                nodes.push({ type: 'RawText', value: ',', offset: tok.offset });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                nodes.push(node);
+        }
+        return nodes;
+    }
+    // -------------------------------------------------------------------------
+    // Node dispatch
+    // -------------------------------------------------------------------------
+    /**
+     * Parse a single AST node.  Returns null only at EOF.
+     */
+    parseNode() {
+        const tok = this.peek();
+        if (tok === null)
+            return null;
+        if (tok.type === 'FNAME') {
+            return this.parseFunctionCall();
+        }
+        if (tok.type === 'LBRACKET') {
+            return this.parseBracketEval();
+        }
+        if (tok.type === 'SUBST') {
+            this.consume();
+            return { type: 'Substitution', raw: tok.value, offset: tok.offset };
+        }
+        // ESC, TEXT, LPAREN (bare paren not after identifier), anything else → RawText
+        this.consume();
+        return { type: 'RawText', value: tok.value, offset: tok.offset };
+    }
+    // -------------------------------------------------------------------------
+    // Function call: FNAME LPAREN [arglist] RPAREN
+    // -------------------------------------------------------------------------
+    parseFunctionCall() {
+        const nameTok = this.consume(); // FNAME
+        // Tokenizer guarantees LPAREN immediately follows FNAME
+        const lparenTok = this.consume(); // LPAREN
+        const node = {
+            type: 'FunctionCall',
+            name: nameTok.value,
+            nameOffset: nameTok.offset,
+            args: [],
+            offset: lparenTok.offset,
+        };
+        // Immediately closed: name()
+        if (this.peek()?.type === 'RPAREN') {
+            this.consume();
+            return node;
+        }
+        // EOF immediately after opening paren
+        if (this.peek() === null) {
+            this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+            return node;
+        }
+        // Parse comma-separated argument expressions
+        while (true) {
+            const arg = this.parseArgExpression(nameTok.value);
+            node.args.push(arg);
+            const next = this.peek();
+            if (next === null) {
+                // EOF without closing paren
+                this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+                break;
+            }
+            if (next.type === 'RPAREN') {
+                this.consume();
+                break;
+            }
+            if (next.type === 'COMMA') {
+                this.consume();
+                // Trailing comma — push one final empty arg and close on next RPAREN
+                if (this.peek()?.type === 'RPAREN') {
+                    node.args.push([]);
+                    this.consume();
+                    break;
+                }
+                if (this.peek() === null) {
+                    node.args.push([]);
+                    this.diagnostics.push(this.unclosedParen(nameTok.value, lparenTok.offset));
+                    break;
+                }
+                continue;
+            }
+            // Unexpected token — shouldn't happen with a well-formed token stream
+            break;
+        }
+        return node;
+    }
+    /**
+     * Parse one argument expression, stopping (without consuming) at a
+     * COMMA or RPAREN that closes the current function call.
+     * LBRACKET/RBRACKET are handled recursively by parseBracketEval, so
+     * they do NOT prematurely end an argument even if they contain commas.
+     */
+    parseArgExpression(funcName) {
+        const nodes = [];
+        while (true) {
+            const tok = this.peek();
+            if (tok === null)
+                break;
+            // These end the current argument
+            if (tok.type === 'COMMA' || tok.type === 'RPAREN')
+                break;
+            // Stray ] inside a function argument
+            if (tok.type === 'RBRACKET') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E004',
+                    message: `Unexpected ']' inside argument of '${funcName}'`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                nodes.push(node);
+        }
+        return nodes;
+    }
+    // -------------------------------------------------------------------------
+    // Bracket eval: LBRACKET expression RBRACKET
+    // -------------------------------------------------------------------------
+    parseBracketEval() {
+        const lbracketTok = this.consume(); // LBRACKET
+        const innerNodes = [];
+        while (true) {
+            const tok = this.peek();
+            if (tok === null) {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E003',
+                    message: `Unclosed '[' — missing closing ']'`,
+                    offset: lbracketTok.offset,
+                    length: 1,
+                });
+                break;
+            }
+            if (tok.type === 'RBRACKET') {
+                this.consume();
+                break;
+            }
+            // Stray ) inside a bracket eval at the bracket's top level
+            if (tok.type === 'RPAREN') {
+                this.diagnostics.push({
+                    severity: 'error',
+                    code: 'E002',
+                    message: `Unexpected ')' inside '[ ]' expression`,
+                    offset: tok.offset,
+                    length: 1,
+                });
+                this.consume();
+                continue;
+            }
+            // Top-level comma inside a bracket eval is literal text
+            if (tok.type === 'COMMA') {
+                innerNodes.push({ type: 'RawText', value: ',', offset: tok.offset });
+                this.consume();
+                continue;
+            }
+            const node = this.parseNode();
+            if (node !== null)
+                innerNodes.push(node);
+        }
+        return { type: 'BracketEval', nodes: innerNodes, offset: lbracketTok.offset };
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    unclosedParen(funcName, offset) {
+        return {
+            severity: 'error',
+            code: 'E001',
+            message: `Unclosed '(' for function '${funcName}' — missing closing ')'`,
+            offset,
+            length: 1,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * Parse a flat token stream into an AST.
+ *
+ * Structural errors (unbalanced parens/brackets) are embedded in `diagnostics`.
+ * The returned `nodes` array always contains the best-effort parse even when
+ * there are errors, enabling downstream semantic checks to still run.
+ */
+function parse(tokens) {
+    const parser = new Parser(tokens);
+    const nodes = parser.parseTopLevel();
+    return { nodes, diagnostics: parser.diagnostics };
+}
+//# sourceMappingURL=parser.js.map

package/dist/validator/parser.js.map

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

package/dist/validator/tokenizer.d.ts

@@ -0,0 +1,28 @@
+export type TokenType = 'FNAME' | 'LPAREN' | 'RPAREN' | 'COMMA' | 'LBRACKET' | 'RBRACKET' | 'SUBST' | 'ESC' | 'TEXT';
+export interface Token {
+    type: TokenType;
+    /** The raw text of this token as it appears in the source */
+    value: string;
+    /** Character offset in the original expression string */
+    offset: number;
+}
+/**
+ * Tokenize a RhostMUSH softcode expression into a flat token stream.
+ *
+ * Rules (in priority order):
+ *   1. `\X`           → ESC(X)                   — escape always wins
+ *   2. `%%`           → TEXT('%')                 — literal percent
+ *   3. `%qX` / `%iX`  → SUBST('%qX')             — 3-char register subst
+ *   4. `%X` (known)   → SUBST('%X')               — 2-char substitution
+ *   5. `%`  (unknown) → TEXT('%')                 — treat as literal
+ *   6. `[`            → LBRACKET
+ *   7. `]`            → RBRACKET
+ *   8. `)`            → RPAREN
+ *   9. `,`            → COMMA
+ *  10. `word(`        → FNAME(word) + LPAREN('(')
+ *  11. `word`         → TEXT(word)                — identifier not before (
+ *  12. `(`            → TEXT('(')                 — ( not after identifier
+ *  13. <run>          → TEXT(run)                 — anything else
+ */
+export declare function tokenize(input: string): Token[];
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/validator/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/validator/tokenizer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAoI/C"}