@rhost/testkit 1.5.1 → 1.5.2

package/node_modules/@ursamu/mushcode/mod.js

@@ -0,0 +1,44 @@
+/**
+ * @module
+ * Full-featured MUX/RhostMUSH softcode toolkit: parser, AST traversal,
+ * canonical printer, static linter, dependency analyzer, and evaluator.
+ *
+ * @example
+ * ```ts
+ * import { parse, lint, print, EvalEngine, makeContext, registerStdlib } from "@ursamu/mushcode";
+ *
+ * const ast   = parse("$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]");
+ * const diags = lint(ast);
+ * console.log(print(ast)); // "$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]"
+ *
+ * const engine = new EvalEngine({
+ *   getAttr: async (_id, _attr) => null,
+ *   resolveTarget: async (_from, expr) => expr === "me" ? "player-uuid" : null,
+ *   getName: async (_id) => "Tester",
+ *   hasFlag: async (_id, _flag) => false,
+ * });
+ * registerStdlib(engine);
+ * const result = await engine.evalString("[add(1,2)]", makeContext({ enactor: "player-uuid", executor: "player-uuid" }));
+ * console.log(result); // "3"
+ * ```
+ */ // @ursamu/mushcode — MUX/RhostMUSH softcode toolkit
+//
+// Sub-path imports are also available for tree-shaking:
+//   import { parse }     from "@ursamu/mushcode/parse"
+//   import { walk }      from "@ursamu/mushcode/traverse"
+//   import { print }     from "@ursamu/mushcode/print"
+//   import { lint }      from "@ursamu/mushcode/lint"
+//   import { extractCommands } from "@ursamu/mushcode/analyze"
+// ── Parse ─────────────────────────────────────────────────────────────────────
+export { parse, ParseError } from "./parser/mod.js";
+// ── Traverse ──────────────────────────────────────────────────────────────────
+export { walk, transform, findAll, findFirst, findFirstOrNull } from "./src/traverse/mod.js";
+// ── Print ─────────────────────────────────────────────────────────────────────
+export { print } from "./src/print/mod.js";
+// ── Lint ──────────────────────────────────────────────────────────────────────
+export { lint, RULES } from "./src/lint/mod.js";
+// ── Analyze ───────────────────────────────────────────────────────────────────
+export { extractCommands, extractDeps, extractTagRefs } from "./src/analyze/mod.js";
+// ── Eval ──────────────────────────────────────────────────────────────────────
+export { EvalEngine, makeContext, registerStdlib } from "./src/eval/mod.js";
+//# sourceMappingURL=mod.js.map

package/node_modules/@ursamu/mushcode/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sources":["./mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GACD,oDAAoD;AACpD,EAAE;AACF,wDAAwD;AACxD,uDAAuD;AACvD,0DAA0D;AAC1D,uDAAuD;AACvD,sDAAsD;AACtD,+DAA+D;AAE/D,iFAAiF;AACjF,SAAS,KAAK,EAAE,UAAU,0BAAiD;AAI3E,iFAAiF;AACjF,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,gCACoB;AAGjF,iFAAiF;AACjF,SAAS,KAAK,6BAAgE;AAG9E,iFAAiF;AACjF,SAAS,IAAI,EAAE,KAAK,4BAAyD;AAI7E,iFAAiF;AACjF,SAAS,eAAe,EAAE,WAAW,EAAE,cAAc,+BAC2B;AAGhF,iFAAiF;AACjF,SAAS,UAAU,EAAE,WAAW,EAAE,cAAc,4BAA6B"}

package/node_modules/@ursamu/mushcode/mod.ts

@@ -0,0 +1,63 @@
+/**
+ * @module
+ * Full-featured MUX/RhostMUSH softcode toolkit: parser, AST traversal,
+ * canonical printer, static linter, dependency analyzer, and evaluator.
+ *
+ * @example
+ * ```ts
+ * import { parse, lint, print, EvalEngine, makeContext, registerStdlib } from "@ursamu/mushcode";
+ *
+ * const ast   = parse("$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]");
+ * const diags = lint(ast);
+ * console.log(print(ast)); // "$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]"
+ *
+ * const engine = new EvalEngine({
+ *   getAttr: async (_id, _attr) => null,
+ *   resolveTarget: async (_from, expr) => expr === "me" ? "player-uuid" : null,
+ *   getName: async (_id) => "Tester",
+ *   hasFlag: async (_id, _flag) => false,
+ * });
+ * registerStdlib(engine);
+ * const result = await engine.evalString("[add(1,2)]", makeContext({ enactor: "player-uuid", executor: "player-uuid" }));
+ * console.log(result); // "3"
+ * ```
+ */
+// @ursamu/mushcode — MUX/RhostMUSH softcode toolkit
+//
+// Sub-path imports are also available for tree-shaking:
+//   import { parse }     from "@ursamu/mushcode/parse"
+//   import { walk }      from "@ursamu/mushcode/traverse"
+//   import { print }     from "@ursamu/mushcode/print"
+//   import { lint }      from "@ursamu/mushcode/lint"
+//   import { extractCommands } from "@ursamu/mushcode/analyze"
+
+// ── Parse ─────────────────────────────────────────────────────────────────────
+export { parse, ParseError }                        from "./parser/mod.js";
+export type { ASTNode, NodeType, StartRule,
+              SourceLocation, SourcePosition }      from "./parser/mod.js";
+
+// ── Traverse ──────────────────────────────────────────────────────────────────
+export { walk, transform, findAll, findFirst, findFirstOrNull }
+                                                    from "./src/traverse/mod.js";
+export type { Visitor, Transformer }                from "./src/traverse/mod.js";
+
+// ── Print ─────────────────────────────────────────────────────────────────────
+export { print }                                    from "./src/print/mod.js";
+export type { PrintOptions, PrintMode }             from "./src/print/mod.js";
+
+// ── Lint ──────────────────────────────────────────────────────────────────────
+export { lint, RULES }                              from "./src/lint/mod.js";
+export type { Diagnostic, Severity, LintOptions, RuleId }
+                                                    from "./src/lint/mod.js";
+
+// ── Analyze ───────────────────────────────────────────────────────────────────
+export { extractCommands, extractDeps, extractTagRefs }
+                                                    from "./src/analyze/mod.js";
+export type { PatternEntry, DepEntry }              from "./src/analyze/mod.js";
+
+// ── Eval ──────────────────────────────────────────────────────────────────────
+export { EvalEngine, makeContext, registerStdlib }  from "./src/eval/mod.js";
+export type {
+  EvalContext, EvalThunk, ObjectAccessor, IEvalEngine,
+  FunctionImpl, CommandImpl, IterFrame,
+}                                                   from "./src/eval/mod.js";

package/node_modules/@ursamu/mushcode/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@jsr/ursamu__mushcode",
+  "version": "0.3.4",
+  "homepage": "https://jsr.io/@ursamu/mushcode",
+  "type": "module",
+  "dependencies": {},
+  "exports": {
+    ".": {
+      "types": "./_dist/mod.d.ts",
+      "default": "./mod.js"
+    },
+    "./parse": {
+      "types": "./_dist/parser/mod.d.ts",
+      "default": "./parser/mod.js"
+    },
+    "./traverse": {
+      "types": "./_dist/src/traverse/mod.d.ts",
+      "default": "./src/traverse/mod.js"
+    },
+    "./print": {
+      "types": "./_dist/src/print/mod.d.ts",
+      "default": "./src/print/mod.js"
+    },
+    "./lint": {
+      "types": "./_dist/src/lint/mod.d.ts",
+      "default": "./src/lint/mod.js"
+    },
+    "./analyze": {
+      "types": "./_dist/src/analyze/mod.d.ts",
+      "default": "./src/analyze/mod.js"
+    },
+    "./eval": {
+      "types": "./_dist/src/eval/mod.d.ts",
+      "default": "./src/eval/mod.js"
+    }
+  },
+  "_jsr_revision": 11
+}

package/node_modules/@ursamu/mushcode/parser/mod.js

@@ -0,0 +1,47 @@
+/**
+ * @module
+ * Parses MUX/RhostMUSH softcode strings into an AST.
+ * Exposes `parse()`, the `ParseError` class, and all AST node types.
+ *
+ * @example
+ * ```ts
+ * import { parse } from "@ursamu/mushcode/parse";
+ *
+ * const ast = parse("$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]");
+ * console.log(ast.type); // "DollarPattern"
+ *
+ * const lock = parse("flag^WIZARD|attr^STAFF:1", "LockExpr");
+ * console.log(lock.type); // "LockOr"
+ * ```
+ */ // Thin Deno wrapper around the Peggy-generated ESM parser.
+// Generated with:  npx peggy --format es --allowed-start-rules Start,LockExpr \
+//                   -o parser/mux-softcode.mjs grammar/mux-softcode.pegjs
+import { parse as _parse, SyntaxError as _SyntaxError } from "./mux-softcode.mjs";
+/** Thrown when the parser encounters a syntax error in the softcode input. */ export class ParseError extends Error {
+  location;
+  constructor(message, location){
+    super(message), this.location = location;
+    this.name = "ParseError";
+  }
+}
+/**
+ * Parse a raw softcode string and return its AST root node.
+ *
+ * @param text      The softcode source to parse.
+ * @param startRule Grammar entry point — `"Start"` for normal softcode (default),
+ *                  `"LockExpr"` for lock-expression strings.
+ * @throws {@link ParseError} on syntax errors.
+ */ export function parse(text, startRule = "Start") {
+  try {
+    return _parse(text, {
+      startRule
+    });
+  } catch (err) {
+    if (err instanceof _SyntaxError) {
+      const loc = err.location?.start;
+      throw new ParseError(err.message, loc);
+    }
+    throw err;
+  }
+}
+//# sourceMappingURL=mod.js.map

package/node_modules/@ursamu/mushcode/parser/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sources":["./mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD,2DAA2D;AAC3D,gFAAgF;AAChF,0EAA0E;AAE1E,SACE,SAAS,MAAM,EACf,eAAe,YAAY,QACtB,qBAAqB;AAyC5B,4EAA4E,GAC5E,OAAO,MAAM,mBAAmB;;EAC9B,YACE,OAAe,EACf,AAAgB,QAA2D,CAC3E;IACA,KAAK,CAAC,eAFU,WAAA;IAGhB,IAAI,CAAC,IAAI,GAAG;EACd;AACF;AAKA;;;;;;;CAOC,GACD,OAAO,SAAS,MAAM,IAAY,EAAE,YAAuB,OAAO;EAChE,IAAI;IACF,OAAO,OAAO,MAAM;MAAE;IAAU;EAClC,EAAE,OAAO,KAAK;IACZ,IAAI,eAAe,cAAc;MAC/B,MAAM,MAAM,AAAC,IAEV,QAAQ,EAAE;MACb,MAAM,IAAI,WAAW,AAAC,IAAc,OAAO,EAAE;IAC/C;IACA,MAAM;EACR;AACF"}

package/node_modules/@ursamu/mushcode/parser/mod.ts

@@ -0,0 +1,99 @@
+/**
+ * @module
+ * Parses MUX/RhostMUSH softcode strings into an AST.
+ * Exposes `parse()`, the `ParseError` class, and all AST node types.
+ *
+ * @example
+ * ```ts
+ * import { parse } from "@ursamu/mushcode/parse";
+ *
+ * const ast = parse("$+finger *:@pemit %#=[u(me/FN_FINGER,%0)]");
+ * console.log(ast.type); // "DollarPattern"
+ *
+ * const lock = parse("flag^WIZARD|attr^STAFF:1", "LockExpr");
+ * console.log(lock.type); // "LockOr"
+ * ```
+ */
+// Thin Deno wrapper around the Peggy-generated ESM parser.
+// Generated with:  npx peggy --format es --allowed-start-rules Start,LockExpr \
+//                   -o parser/mux-softcode.mjs grammar/mux-softcode.pegjs
+
+import {
+  parse as _parse,
+  SyntaxError as _SyntaxError,
+} from "./mux-softcode.mjs";
+
+// ── AST Types (mirrors grammar rule names) ───────────────────────────────────
+
+/** Union of every node `type` string the parser can produce. */
+export type NodeType =
+  | "Literal" | "Escape" | "Substitution" | "SpecialVar" | "Wildcard"
+  | "EvalBlock" | "BracedString" | "Text" | "Arg"
+  | "FunctionCall" | "DollarPattern" | "ListenPattern"
+  | "PatternAlts" | "Pattern"
+  | "CommandList" | "AtCommand" | "AttributeSet" | "UserCommand"
+  | "TagRef"
+  | "LockOr" | "LockAnd" | "LockNot" | "LockMe" | "LockDbref"
+  | "LockFlagCheck" | "LockTypeCheck" | "LockAttrCheck" | "LockPlayerName";
+
+/** A character offset, line number (1-based), and column (1-based) in source text. */
+export interface SourcePosition {
+  /** Zero-based byte offset from the start of the source string. */
+  offset: number;
+  /** One-based line number. */
+  line:   number;
+  /** One-based column number within the line. */
+  column: number;
+}
+
+/** The start and end {@link SourcePosition} of an AST node in the original source. */
+export interface SourceLocation {
+  /** Position of the first character of the node. */
+  start: SourcePosition;
+  /** Position one past the last character of the node. */
+  end:   SourcePosition;
+}
+
+/**
+ * A generic AST node.  Every node has a `type` discriminant string and an
+ * optional `loc` source location.  Additional properties are node-specific
+ * (e.g. `value` on Literal, `name` on FunctionCall).
+ */
+// deno-lint-ignore no-explicit-any
+export type ASTNode = { type: string; loc?: SourceLocation; [key: string]: any };
+
+/** Thrown when the parser encounters a syntax error in the softcode input. */
+export class ParseError extends Error {
+  constructor(
+    message: string,
+    public readonly location?: { line: number; column: number; offset: number },
+  ) {
+    super(message);
+    this.name = "ParseError";
+  }
+}
+
+/** Which top-level grammar rule to use as the parse entry point. */
+export type StartRule = "Start" | "LockExpr";
+
+/**
+ * Parse a raw softcode string and return its AST root node.
+ *
+ * @param text      The softcode source to parse.
+ * @param startRule Grammar entry point — `"Start"` for normal softcode (default),
+ *                  `"LockExpr"` for lock-expression strings.
+ * @throws {@link ParseError} on syntax errors.
+ */
+export function parse(text: string, startRule: StartRule = "Start"): ASTNode {
+  try {
+    return _parse(text, { startRule }) as ASTNode;
+  } catch (err) {
+    if (err instanceof _SyntaxError) {
+      const loc = (err as {
+        location?: { start: { line: number; column: number; offset: number } };
+      }).location?.start;
+      throw new ParseError((err as Error).message, loc);
+    }
+    throw err;
+  }
+}