@rhost/testkit 0.1.1 → 1.3.2

package/dist/snapshots.js

@@ -0,0 +1,230 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// SnapshotManager — persistent snapshot storage for toMatchSnapshot()
+// ---------------------------------------------------------------------------
+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.SnapshotManager = void 0;
+exports.formatSnapshotDiff = formatSnapshotDiff;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ---------------------------------------------------------------------------
+// SnapshotManager
+// ---------------------------------------------------------------------------
+/**
+ * Manages a single `.snap` JSON file on disk.
+ *
+ * Lifecycle per test run:
+ *   1. `new SnapshotManager(filePath, updateMode)` — loads existing snapshots
+ *   2. For each test: `resetCounter(testName)` at test start
+ *   3. For each assertion: `check(nextKey(testName), actual)` inside `toMatchSnapshot()`
+ *   4. `save()` after all tests complete — writes new/updated snapshots to disk
+ *   5. `stats()` — retrieve final counts for the run summary
+ *
+ * Snapshot file format:
+ *   A sorted JSON object mapping string keys → string values, e.g.:
+ *   {
+ *     "Math > add returns sum: 1": "5",
+ *     "Math > iter lnum(1,10): 1": "1 2 3 4 5 6 7 8 9 10"
+ *   }
+ *
+ * Key format: `"Suite > Sub > Test Name: N"` where N resets to 1 per test.
+ */
+class SnapshotManager {
+    constructor(filePath, updateMode) {
+        this.filePath = filePath;
+        this.updateMode = updateMode;
+        /** All key→actual values evaluated in this run */
+        this.touched = new Map();
+        /** Per-test snapshot call counter */
+        this.counters = new Map();
+        this._matched = 0;
+        this._written = 0;
+        this._updated = 0;
+        this.stored = this.load();
+    }
+    // -------------------------------------------------------------------------
+    // Key management
+    // -------------------------------------------------------------------------
+    /**
+     * Advance and return the next snapshot key for `testName`.
+     * Call `resetCounter(testName)` at the start of each test.
+     */
+    nextKey(testName) {
+        const n = (this.counters.get(testName) ?? 0) + 1;
+        this.counters.set(testName, n);
+        return `${testName}: ${n}`;
+    }
+    /** Reset the per-test counter. Call this at the start of every test. */
+    resetCounter(testName) {
+        this.counters.delete(testName);
+    }
+    // -------------------------------------------------------------------------
+    // Core assertion logic
+    // -------------------------------------------------------------------------
+    /**
+     * Check `actual` against the stored snapshot for `key`.
+     *
+     * - **No prior value**: write it (returns `'written'`, always passes)
+     * - **Update mode**: overwrite with `actual` (returns `'updated'` if changed, `'matched'` if same)
+     * - **Normal mode**: compare; returns `'matched'` or `'mismatch'`
+     */
+    check(key, actual) {
+        this.touched.set(key, actual);
+        const hasStored = Object.prototype.hasOwnProperty.call(this.stored, key);
+        if (!hasStored) {
+            this._written++;
+            return { status: 'written', expected: undefined };
+        }
+        const expected = this.stored[key];
+        if (this.updateMode) {
+            if (expected !== actual) {
+                this._updated++;
+                return { status: 'updated', expected };
+            }
+            this._matched++;
+            return { status: 'matched', expected };
+        }
+        if (expected === actual) {
+            this._matched++;
+            return { status: 'matched', expected };
+        }
+        return { status: 'mismatch', expected };
+    }
+    // -------------------------------------------------------------------------
+    // Persistence
+    // -------------------------------------------------------------------------
+    /**
+     * Flush snapshot state to disk.
+     *
+     * **Normal mode**: merges new snapshots into the existing file.
+     * Existing values are never overwritten — failed snapshots retain
+     * their previous (correct) value until the user runs `--updateSnapshot`.
+     *
+     * **Update mode**: writes only the snapshots evaluated in this run,
+     * discarding any obsolete entries that were not touched.
+     */
+    save() {
+        let toWrite;
+        if (this.updateMode) {
+            // Write only what was evaluated — trims obsolete entries automatically
+            toWrite = Object.fromEntries(this.touched);
+        }
+        else {
+            // Start from existing, add only NEW keys (never overwrite)
+            toWrite = { ...this.stored };
+            for (const [key, value] of this.touched) {
+                if (!Object.prototype.hasOwnProperty.call(toWrite, key)) {
+                    toWrite[key] = value;
+                }
+            }
+        }
+        // Sort keys for stable diffs
+        const sorted = {};
+        for (const key of Object.keys(toWrite).sort()) {
+            sorted[key] = toWrite[key];
+        }
+        // If there's nothing to write, don't create (or leave) an empty snapshot file.
+        // An empty {} file would be flagged as obsolete by Jest and cause exit code 1.
+        if (Object.keys(sorted).length === 0) {
+            if (fs.existsSync(this.filePath)) {
+                fs.unlinkSync(this.filePath);
+            }
+            return;
+        }
+        const dir = path.dirname(this.filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.filePath, JSON.stringify(sorted, null, 2) + '\n', 'utf-8');
+    }
+    // -------------------------------------------------------------------------
+    // Stats
+    // -------------------------------------------------------------------------
+    stats() {
+        const touchedKeys = new Set(this.touched.keys());
+        const obsolete = Object.keys(this.stored).filter((k) => !touchedKeys.has(k)).length;
+        return {
+            matched: this._matched,
+            written: this._written,
+            updated: this._updated,
+            obsolete,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    load() {
+        try {
+            const raw = fs.readFileSync(this.filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // File doesn't exist or is malformed — start fresh
+        }
+        return {};
+    }
+}
+exports.SnapshotManager = SnapshotManager;
+// ---------------------------------------------------------------------------
+// Snapshot diff formatter (used in error messages)
+// ---------------------------------------------------------------------------
+/**
+ * Format a human-readable diff between expected and actual snapshot values.
+ * Uses a simple line-by-line format (not a full diff algorithm — values are
+ * single-line MUSH results in most cases).
+ */
+function formatSnapshotDiff(expected, actual) {
+    const expLines = expected.split('\n');
+    const actLines = actual.split('\n');
+    const maxLines = Math.max(expLines.length, actLines.length);
+    const lines = [];
+    for (let i = 0; i < maxLines; i++) {
+        const e = expLines[i];
+        const a = actLines[i];
+        if (e !== undefined && a !== undefined && e === a) {
+            lines.push(`    ${e}`);
+        }
+        else {
+            if (e !== undefined)
+                lines.push(`  - ${e}`);
+            if (a !== undefined)
+                lines.push(`  + ${a}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/snapshots.js.map

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

package/dist/validator/builtins.d.ts

@@ -0,0 +1,18 @@
+export type Platform = 'rhost' | 'penn' | 'mux';
+export interface FunctionSignature {
+    name: string;
+    minArgs: number;
+    /** Use Infinity for variadic functions with no upper bound */
+    maxArgs: number;
+    deprecated?: boolean;
+    /** True for functions specific to RhostMUSH (not standard PennMUSH/TinyMUX) */
+    rhostOnly?: boolean;
+    /**
+     * If set, the function is only available on these platforms.
+     * Omit for functions that are universally available.
+     */
+    platforms?: Platform[];
+}
+/** Pre-built map of lowercase function name → signature for O(1) lookup */
+export declare const BUILTIN_FUNCTIONS: ReadonlyMap<string, FunctionSignature>;
+//# sourceMappingURL=builtins.d.ts.map

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