@rhost/testkit 0.1.1 → 1.3.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/validator/builtins.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAwQD,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAKpE,CAAC"}

package/dist/validator/builtins.js

@@ -0,0 +1,265 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// RhostMUSH built-in function signature database
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_FUNCTIONS = void 0;
+// minArgs, maxArgs shorthand builder
+function sig(minArgs, maxArgs, opts = {}) {
+    return { name: '', minArgs, maxArgs, ...opts };
+}
+const INF = Infinity;
+const DEFINITIONS = [
+    // -------------------------------------------------------------------------
+    // Math
+    // -------------------------------------------------------------------------
+    ['abs', 1, 1],
+    ['add', 2, INF],
+    ['sub', 2, 2],
+    ['mul', 2, INF],
+    ['div', 2, 2],
+    ['fdiv', 2, 2],
+    ['mod', 2, 2],
+    ['modulo', 2, 2],
+    ['remainder', 2, 2],
+    ['power', 2, 2],
+    ['sqrt', 1, 1],
+    ['ceil', 1, 1],
+    ['floor', 1, 1],
+    ['round', 1, 2],
+    ['trunc', 1, 1],
+    ['max', 1, INF],
+    ['min', 1, INF],
+    ['sign', 1, 1],
+    ['gt', 2, 2],
+    ['gte', 2, 2],
+    ['lt', 2, 2],
+    ['lte', 2, 2],
+    ['eq', 2, 2],
+    ['neq', 2, 2],
+    ['and', 2, INF],
+    ['or', 2, INF],
+    ['not', 1, 1],
+    ['xor', 2, 2],
+    ['nand', 2, INF],
+    ['nor', 2, INF],
+    ['band', 2, 2],
+    ['bor', 2, 2],
+    ['bxor', 2, 2],
+    ['bnot', 1, 1],
+    ['bshl', 2, 2],
+    ['bshr', 2, 2],
+    ['pi', 0, 0],
+    ['e', 0, 0],
+    ['sin', 1, 2],
+    ['cos', 1, 2],
+    ['tan', 1, 2],
+    ['asin', 1, 2],
+    ['acos', 1, 2],
+    ['atan', 1, 3],
+    ['exp', 1, 1],
+    ['ln', 1, 1],
+    ['log', 1, 2],
+    ['dist2d', 4, 4],
+    ['dist3d', 6, 6],
+    ['isnum', 1, 1],
+    ['isint', 1, 1],
+    // -------------------------------------------------------------------------
+    // String
+    // -------------------------------------------------------------------------
+    ['strlen', 1, 1],
+    ['len', 1, 1],
+    ['lcstr', 1, 1],
+    ['ucstr', 1, 1],
+    ['capstr', 1, 1],
+    ['left', 2, 2],
+    ['right', 2, 2],
+    ['mid', 3, 3],
+    ['first', 1, 2],
+    ['last', 1, 2],
+    ['rest', 1, 2],
+    ['before', 2, 2],
+    ['after', 2, 2],
+    ['cat', 1, INF],
+    ['strcat', 1, INF],
+    ['trim', 1, 3],
+    ['ltrim', 1, 2],
+    ['rtrim', 1, 2],
+    ['space', 1, 1],
+    ['ljust', 2, 3],
+    ['rjust', 2, 3],
+    ['center', 2, 3],
+    ['repeat', 2, 2],
+    ['edit', 3, INF],
+    ['replace', 3, 4],
+    ['revwords', 1, 2],
+    ['words', 1, 2],
+    ['word', 2, 3],
+    ['wordpos', 2, 3],
+    ['numwords', 1, 2],
+    ['index', 3, 4],
+    ['rindex', 3, 3],
+    ['pos', 2, 2],
+    ['lpos', 2, 3],
+    ['comp', 2, 2],
+    ['strcmp', 2, 2],
+    ['strmatch', 2, 3],
+    ['wildmatch', 2, 3],
+    ['pmatch', 1, INF],
+    ['escape', 1, 1],
+    ['decompose', 1, 1],
+    ['secure', 1, 1],
+    ['stripansi', 1, 1],
+    ['ansi', 2, 2],
+    ['soundex', 1, 1, { platforms: ['rhost', 'penn'] }],
+    ['soundslike', 2, 2],
+    ['strdistance', 2, 2, { rhostOnly: true, platforms: ['rhost'] }],
+    ['checkstr', 1, 1],
+    ['strinsert', 3, 3],
+    ['encrypt', 2, 2],
+    ['decrypt', 2, 2],
+    ['encode64', 1, 1, { rhostOnly: true, platforms: ['rhost'] }],
+    ['decode64', 1, 1, { rhostOnly: true, platforms: ['rhost'] }],
+    ['digest', 2, 2, { rhostOnly: true, platforms: ['rhost'] }],
+    ['crypt', 2, 2],
+    ['tr', 3, 3],
+    ['flip', 0, 1],
+    ['lit', 1, 1],
+    ['readable', 1, 1],
+    ['visible', 2, 2],
+    ['valid', 2, 2],
+    ['hastype', 2, 2],
+    // -------------------------------------------------------------------------
+    // List
+    // -------------------------------------------------------------------------
+    ['member', 2, 3],
+    ['elements', 2, 3],
+    ['insert', 3, 4],
+    ['remove', 2, 3],
+    ['sort', 1, 4],
+    ['lsort', 1, 4],
+    ['sortby', 2, 4],
+    ['shuffle', 1, 3],
+    ['setunion', 2, 4],
+    ['setinter', 2, 4],
+    ['setdiff', 2, 4],
+    ['setq', 2, INF],
+    ['getq', 1, 1],
+    ['r', 1, 1],
+    ['filter', 2, 4],
+    ['filterfun', 2, INF],
+    ['map', 2, 5],
+    ['fold', 2, 4],
+    ['iter', 2, 4],
+    ['parse', 2, 4],
+    ['itext', 1, 1],
+    ['inum', 1, 1],
+    ['lnum', 1, 4],
+    ['list', 2, INF],
+    ['grab', 2, 3],
+    ['graball', 2, 4],
+    ['match', 2, 3],
+    ['matchall', 2, 4],
+    ['splice', 2, 3],
+    ['unique', 1, 3],
+    ['munge', 3, 5],
+    ['step', 3, 5],
+    ['table', 1, 6],
+    // -------------------------------------------------------------------------
+    // Object / database
+    // -------------------------------------------------------------------------
+    ['name', 1, 1],
+    ['fullname', 1, 1],
+    ['alias', 1, 1],
+    ['owner', 1, 1],
+    ['loc', 1, 1],
+    ['rloc', 2, 2],
+    ['con', 1, 1],
+    ['next', 1, 1],
+    ['num', 1, 1],
+    ['dbref', 1, 1],
+    ['locate', 3, 3],
+    ['nearby', 2, 2],
+    ['flags', 1, 2],
+    ['hasflag', 2, 2],
+    ['haspower', 2, 2],
+    ['powers', 1, 1],
+    ['type', 1, 1],
+    ['istype', 2, 2],
+    ['isobject', 1, 1],
+    ['isroom', 1, 1],
+    ['isplayer', 1, 1],
+    ['isthing', 1, 1],
+    ['isexit', 1, 1],
+    ['isdbref', 1, 1],
+    ['get', 1, 1],
+    ['xget', 2, 2],
+    ['get_eval', 1, 1],
+    ['v', 1, 1],
+    ['attr', 2, 2],
+    ['lattr', 1, 2],
+    ['lattrp', 1, 2],
+    ['lcon', 1, 2],
+    ['lexits', 1, 1],
+    ['create', 1, 2],
+    ['open', 1, 2],
+    ['link', 2, 2],
+    ['zone', 1, 1],
+    ['parent', 1, 1],
+    ['children', 1, 1],
+    ['lparent', 1, 2],
+    // -------------------------------------------------------------------------
+    // Control / evaluation
+    // -------------------------------------------------------------------------
+    ['u', 1, INF],
+    ['ulocal', 1, INF],
+    ['ufun', 2, INF],
+    ['udefault', 2, INF],
+    ['ulambda', 2, INF],
+    ['default', 2, 2],
+    ['edefault', 2, 2],
+    ['switch', 3, INF],
+    ['switchall', 3, INF],
+    ['cond', 2, INF],
+    ['condall', 2, INF],
+    ['if', 2, 3],
+    ['ifelse', 3, 3],
+    ['when', 2, 2],
+    ['null', 0, INF],
+    ['nop', 0, INF],
+    ['localize', 1, 1, { platforms: ['rhost', 'penn'] }],
+    ['objeval', 2, 2],
+    ['eval', 2, 2],
+    ['apply', 2, 3],
+    ['zfun', 1, INF],
+    // -------------------------------------------------------------------------
+    // Time / random
+    // -------------------------------------------------------------------------
+    ['time', 0, 1],
+    ['secs', 0, 1],
+    ['convsecs', 1, 1],
+    ['convtime', 1, 1],
+    ['timestring', 1, 2],
+    ['rand', 1, 2],
+    ['die', 2, 2],
+    // -------------------------------------------------------------------------
+    // Registers / misc
+    // -------------------------------------------------------------------------
+    ['setvars', 2, 2],
+    ['xvars', 2, 2],
+    ['lvars', 0, 1],
+    ['execscript', 1, INF, { rhostOnly: true, platforms: ['rhost'] }],
+    ['pemit', 2, 2],
+    ['emit', 1, 1],
+    ['remit', 2, 2],
+    ['lemit', 1, 1],
+    ['zemit', 2, 2],
+    ['think', 1, 1],
+    ['select', 3, INF],
+];
+/** Pre-built map of lowercase function name → signature for O(1) lookup */
+exports.BUILTIN_FUNCTIONS = new Map(DEFINITIONS.map(([name, min, max, opts]) => [
+    name,
+    { name: name, minArgs: min, maxArgs: max, ...(opts ?? {}) },
+]));
+//# sourceMappingURL=builtins.js.map

package/dist/validator/builtins.js.map

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

package/dist/validator/checker.d.ts

@@ -0,0 +1,13 @@
+import { ASTNode, Diagnostic } from './types';
+/**
+ * Walk the AST and emit semantic diagnostics.
+ *
+ * Checks performed per `FunctionCallNode`:
+ *   E005 — Unknown function (warning, not error — may be a UDF)
+ *   E006 — Too few arguments
+ *   E007 — Too many arguments
+ *   W002 — Empty argument
+ *   W003 — Deprecated function
+ */
+export declare function semanticCheck(nodes: ASTNode[]): Diagnostic[];
+//# sourceMappingURL=checker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../src/validator/checker.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAoB,MAAM,SAAS,CAAC;AAOhE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAI5D"}

package/dist/validator/checker.js

@@ -0,0 +1,111 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Semantic checker: validates the AST against the built-in function database
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.semanticCheck = semanticCheck;
+const builtins_1 = require("./builtins");
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * Walk the AST and emit semantic diagnostics.
+ *
+ * Checks performed per `FunctionCallNode`:
+ *   E005 — Unknown function (warning, not error — may be a UDF)
+ *   E006 — Too few arguments
+ *   E007 — Too many arguments
+ *   W002 — Empty argument
+ *   W003 — Deprecated function
+ */
+function semanticCheck(nodes) {
+    const diagnostics = [];
+    walkNodes(nodes, diagnostics);
+    return diagnostics;
+}
+// ---------------------------------------------------------------------------
+// AST walkers
+// ---------------------------------------------------------------------------
+function walkNodes(nodes, diagnostics) {
+    for (const node of nodes) {
+        walkNode(node, diagnostics);
+    }
+}
+function walkNode(node, diagnostics) {
+    switch (node.type) {
+        case 'FunctionCall':
+            checkFunctionCall(node, diagnostics);
+            break;
+        case 'BracketEval':
+            walkNodes(node.nodes, diagnostics);
+            break;
+        case 'RawText':
+        case 'Substitution':
+            // Nothing to validate at the leaf level
+            break;
+    }
+}
+function checkFunctionCall(node, diagnostics) {
+    const key = node.name.toLowerCase();
+    const sig = builtins_1.BUILTIN_FUNCTIONS.get(key);
+    if (!sig) {
+        // Unknown function — warn rather than error because MUSHcoders heavily
+        // use user-defined @functions and inline u() attribute patterns.
+        diagnostics.push({
+            severity: 'warning',
+            code: 'W005',
+            message: `Unknown function '${node.name}' — not in built-in database (may be a UDF or @function)`,
+            offset: node.nameOffset,
+            length: node.name.length,
+        });
+    }
+    else {
+        const argCount = node.args.length;
+        if (argCount < sig.minArgs) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'E006',
+                message: argCount === 0
+                    ? `'${node.name}' requires at least ${sig.minArgs} argument${sig.minArgs !== 1 ? 's' : ''}, but got none`
+                    : `'${node.name}' requires at least ${sig.minArgs} argument${sig.minArgs !== 1 ? 's' : ''}, but got ${argCount}`,
+                offset: node.nameOffset,
+                length: node.name.length,
+            });
+        }
+        else if (isFinite(sig.maxArgs) && argCount > sig.maxArgs) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'E007',
+                message: `'${node.name}' accepts at most ${sig.maxArgs} argument${sig.maxArgs !== 1 ? 's' : ''}, but got ${argCount}`,
+                offset: node.nameOffset,
+                length: node.name.length,
+            });
+        }
+        if (sig.deprecated) {
+            diagnostics.push({
+                severity: 'warning',
+                code: 'W003',
+                message: `'${node.name}' is deprecated`,
+                offset: node.nameOffset,
+                length: node.name.length,
+            });
+        }
+    }
+    // Check for empty arguments (potential typos like `add(,3)`)
+    for (let i = 0; i < node.args.length; i++) {
+        if (node.args[i].length === 0) {
+            diagnostics.push({
+                severity: 'warning',
+                code: 'W002',
+                message: `Argument ${i + 1} of '${node.name}' is empty`,
+                offset: node.offset,
+                length: 1,
+            });
+        }
+    }
+    // Recurse into each argument's nodes
+    for (const arg of node.args) {
+        walkNodes(arg, diagnostics);
+    }
+}
+//# sourceMappingURL=checker.js.map

package/dist/validator/checker.js.map

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

package/dist/validator/clobber.d.ts

@@ -0,0 +1,7 @@
+import { ASTNode, Diagnostic } from './types';
+/**
+ * Walk the AST and emit W006 warnings for every `setq()` call that appears
+ * inside a loop-body argument without an intervening `localize()`.
+ */
+export declare function registerClobberCheck(nodes: ASTNode[]): Diagnostic[];
+//# sourceMappingURL=clobber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clobber.d.ts","sourceRoot":"","sources":["../../src/validator/clobber.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAoB,MAAM,SAAS,CAAC;AAsBhE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAInE"}

package/dist/validator/clobber.js

@@ -0,0 +1,102 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Register clobber / re-entrancy analyzer
+//
+// Detects `setq()` calls inside loop-body arguments (iter, parse, filter,
+// map, fold, step, munge, filterfun).  Because MUSH registers (%q0–%q9) are
+// scoped per queue entry, concurrent or nested invocations of the same
+// attribute can silently overwrite each other's register values.
+//
+// Safe escape hatch: wrapping the body in `localize()` creates a fresh
+// register scope, so setq() inside localize() is not flagged.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerClobberCheck = registerClobberCheck;
+// Functions whose body argument is evaluated once per list element.
+// Value is the index of the first "body" argument (0-based).
+// All arguments at index >= bodyArgIndex are treated as body.
+const LOOP_FUNCTIONS = new Map([
+    ['iter', 1], // iter(list, BODY, ...)
+    ['parse', 1], // parse(list, BODY, ...)
+    ['filter', 0], // filter(BODY/attr, list, ...)
+    ['filterfun', 0], // filterfun(BODY/attr, list, ...)
+    ['map', 0], // map(BODY/attr, list, ...)
+    ['fold', 0], // fold(BODY/attr, base, list, ...)
+    ['step', 0], // step(BODY/attr, list, ...)
+    ['munge', 0], // munge(BODY/attr, list, ...)
+    ['matchall', 1], // matchall(list, pattern, ...) — pattern is text, not code
+    ['graball', 1], // graball(list, pattern, ...)
+    ['sortby', 0], // sortby(BODY/attr, list, ...)
+]);
+// Functions that create a new register scope — safe for setq()
+const SCOPE_WRAPPERS = new Set(['localize']);
+/**
+ * Walk the AST and emit W006 warnings for every `setq()` call that appears
+ * inside a loop-body argument without an intervening `localize()`.
+ */
+function registerClobberCheck(nodes) {
+    const diagnostics = [];
+    walkNodes(nodes, false, diagnostics);
+    return diagnostics;
+}
+// ---------------------------------------------------------------------------
+// Internal walkers
+// ---------------------------------------------------------------------------
+function walkNodes(nodes, inLoop, out) {
+    for (const node of nodes) {
+        walkNode(node, inLoop, out);
+    }
+}
+function walkNode(node, inLoop, out) {
+    switch (node.type) {
+        case 'BracketEval':
+            walkNodes(node.nodes, inLoop, out);
+            break;
+        case 'FunctionCall':
+            walkFunctionCall(node, inLoop, out);
+            break;
+        // RawText / Substitution — nothing to check
+        default:
+            break;
+    }
+}
+function walkFunctionCall(node, inLoop, out) {
+    const key = node.name.toLowerCase();
+    // localize() creates a new register scope — safe to setq() inside
+    if (SCOPE_WRAPPERS.has(key)) {
+        for (const arg of node.args) {
+            walkNodes(arg, false, out); // reset inLoop to false
+        }
+        return;
+    }
+    // setq() inside a loop body is the hazard
+    if (inLoop && key === 'setq') {
+        out.push({
+            severity: 'warning',
+            code: 'W006',
+            message: `'setq' inside a loop body risks register clobber on re-entrant calls — ` +
+                `wrap the body with localize() to create a safe register scope`,
+            offset: node.nameOffset,
+            length: node.name.length,
+        });
+        // Still recurse so nested loops / deeper setqs are also caught
+        for (const arg of node.args) {
+            walkNodes(arg, inLoop, out);
+        }
+        return;
+    }
+    const bodyArgIndex = LOOP_FUNCTIONS.get(key);
+    if (bodyArgIndex !== undefined) {
+        for (let i = 0; i < node.args.length; i++) {
+            // Arguments before the body start index are data (list, base value, etc.) — not loop body
+            const isBodyArg = i >= bodyArgIndex;
+            walkNodes(node.args[i], isBodyArg, out);
+        }
+        return;
+    }
+    // Regular function — propagate current inLoop state
+    for (const arg of node.args) {
+        walkNodes(arg, inLoop, out);
+    }
+}
+//# sourceMappingURL=clobber.js.map

package/dist/validator/clobber.js.map

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

package/dist/validator/compat.d.ts

@@ -0,0 +1,19 @@
+import { ASTNode } from './types';
+import { Platform } from './builtins';
+export interface CompatibilityEntry {
+    name: string;
+    /** Platforms that support this function. */
+    platforms: Platform[];
+}
+export interface CompatibilityReport {
+    /** Functions that are not available on all platforms. */
+    restricted: CompatibilityEntry[];
+    /** true if every known function in the expression is universally portable. */
+    portable: boolean;
+}
+/**
+ * Walk a parsed AST and collect any platform-restricted function calls.
+ * Called internally by `compatibilityReport` in the validator index.
+ */
+export declare function compatibilityCheck(nodes: ASTNode[]): CompatibilityReport;
+//# sourceMappingURL=compat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/validator/compat.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAoB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAqB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAChC,yDAAyD;IACzD,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAYxE"}

package/dist/validator/compat.js

@@ -0,0 +1,58 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Dialect compatibility report
+//
+// Walks the AST and reports which functions are restricted to specific
+// platforms (Rhost-only, Penn+Rhost, etc.) vs. universally available.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compatibilityCheck = compatibilityCheck;
+const builtins_1 = require("./builtins");
+/**
+ * Walk a parsed AST and collect any platform-restricted function calls.
+ * Called internally by `compatibilityReport` in the validator index.
+ */
+function compatibilityCheck(nodes) {
+    const seen = new Map();
+    walkNodes(nodes, seen);
+    const restricted = Array.from(seen.entries()).map(([name, platforms]) => ({ name, platforms }));
+    return {
+        restricted,
+        portable: restricted.length === 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal walkers
+// ---------------------------------------------------------------------------
+function walkNodes(nodes, seen) {
+    for (const node of nodes) {
+        walkNode(node, seen);
+    }
+}
+function walkNode(node, seen) {
+    switch (node.type) {
+        case 'FunctionCall':
+            checkFunction(node, seen);
+            break;
+        case 'BracketEval':
+            walkNodes(node.nodes, seen);
+            break;
+        default:
+            break;
+    }
+}
+function checkFunction(node, seen) {
+    const key = node.name.toLowerCase();
+    const sig = builtins_1.BUILTIN_FUNCTIONS.get(key);
+    if (sig?.platforms && sig.platforms.length > 0) {
+        // Deduplicate — only record each restricted function once
+        if (!seen.has(key)) {
+            seen.set(key, sig.platforms);
+        }
+    }
+    // Recurse into arguments
+    for (const arg of node.args) {
+        walkNodes(arg, seen);
+    }
+}
+//# sourceMappingURL=compat.js.map

package/dist/validator/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/validator/compat.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,8EAA8E;;AAsB9E,gDAYC;AA/BD,yCAAyD;AAezD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAgB;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEvB,MAAM,UAAU,GAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CACnE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAC/C,CAAC;IAEF,OAAO;QACH,UAAU;QACV,QAAQ,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;KACpC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,SAAS,CAAC,KAAgB,EAAE,IAA6B;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa,EAAE,IAA6B;IAC1D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,cAAc;YACf,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM;QACV,KAAK,aAAa;YACd,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5B,MAAM;QACV;YACI,MAAM;IACd,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,IAAsB,EAAE,IAA6B;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,4BAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEvC,IAAI,GAAG,EAAE,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;AACL,CAAC"}

package/dist/validator/formatter.d.ts

@@ -0,0 +1,21 @@
+export interface FormatOptions {
+    /** Add newlines + indentation for human readability. Default: false. */
+    pretty?: boolean;
+    /** Lowercase all function names. Default: false. */
+    lowercase?: boolean;
+}
+export interface FormatResult {
+    formatted: string;
+    changed: boolean;
+}
+/**
+ * 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.
+ */
+export declare function format(expr: string, options?: FormatOptions): FormatResult;
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/validator/formatter.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAO9E"}