@sharpee/transcript-tester 0.9.61-beta

package/dist-esm/reporter.js

@@ -0,0 +1,342 @@
+/**
+ * Transcript Test Reporter
+ *
+ * Formats and displays test results with colors and diffs.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// Use chalk for colors (chalk@4 for CommonJS compatibility)
+import chalk from 'chalk';
+/**
+ * Report results of running a single transcript
+ */
+export function reportTranscript(result, options = {}) {
+    const { verbose = false } = options;
+    console.log();
+    console.log(chalk.bold(`Running: ${result.transcript.filePath}`));
+    if (result.transcript.header.title) {
+        console.log(chalk.gray(`  "${result.transcript.header.title}"`));
+    }
+    console.log();
+    for (const cmd of result.commands) {
+        reportCommand(cmd, verbose);
+    }
+    // Summary line
+    console.log();
+    reportTranscriptSummary(result);
+}
+/**
+ * Report a single command result
+ */
+function reportCommand(result, verbose) {
+    const { command, passed, expectedFailure, skipped, actualOutput, error } = result;
+    // Command input
+    const inputDisplay = chalk.cyan(`> ${command.input}`);
+    // Status indicator
+    let status;
+    if (skipped) {
+        status = chalk.yellow('SKIP');
+    }
+    else if (expectedFailure) {
+        status = chalk.magenta('EXPECTED FAIL');
+    }
+    else if (passed) {
+        status = chalk.green('PASS');
+    }
+    else {
+        status = chalk.red('FAIL');
+    }
+    // Compact format
+    console.log(`  ${inputDisplay.padEnd(50)} ${status}`);
+    // Verbose output
+    if (verbose || (!passed && !skipped && !expectedFailure)) {
+        if (error) {
+            console.log(chalk.red(`    Error: ${error}`));
+        }
+        // Show assertion details
+        for (const ar of result.assertionResults) {
+            if (!ar.passed || verbose) {
+                const icon = ar.passed ? chalk.green('✓') : chalk.red('✗');
+                const msg = formatAssertion(ar);
+                console.log(`    ${icon} ${msg}`);
+            }
+        }
+        // Always show actual output in verbose mode, or for failures
+        if (verbose || (!passed && !skipped)) {
+            console.log(chalk.gray('    ─── Output ───'));
+            for (const line of actualOutput.split('\n')) {
+                if (line.trim()) {
+                    console.log(chalk.white(`    ${line}`));
+                }
+            }
+            console.log(chalk.gray('    ─────────────'));
+            // Show events in verbose mode
+            if (verbose && result.actualEvents && result.actualEvents.length > 0) {
+                console.log(chalk.gray(`    ─── Events (${result.actualEvents.length}) ───`));
+                for (const event of result.actualEvents) {
+                    const dataStr = Object.keys(event.data).length > 0
+                        ? ` ${chalk.gray(JSON.stringify(event.data))}`
+                        : '';
+                    console.log(chalk.blue(`    • ${event.type}`) + dataStr);
+                }
+                console.log(chalk.gray('    ─────────────'));
+            }
+        }
+        // Show diff for failures with expected output
+        if (!passed && !skipped && command.expectedOutput.length > 0) {
+            console.log();
+            console.log(chalk.gray('    Expected:'));
+            for (const line of command.expectedOutput) {
+                console.log(chalk.green(`    + ${line}`));
+            }
+        }
+    }
+    // Show reason for skips and expected failures
+    if (skipped || expectedFailure) {
+        const reason = result.assertionResults[0]?.assertion.reason;
+        if (reason) {
+            console.log(chalk.gray(`      (${reason})`));
+        }
+    }
+}
+/**
+ * Format an assertion result for display
+ */
+function formatAssertion(result) {
+    const { assertion, message } = result;
+    switch (assertion.type) {
+        case 'ok':
+            return message || 'Exact match';
+        case 'ok-contains':
+            return message || `Contains "${assertion.value}"`;
+        case 'ok-not-contains':
+            return message || `Does not contain "${assertion.value}"`;
+        case 'ok-matches':
+            return message || `Matches ${assertion.pattern}`;
+        case 'fail':
+            return `Expected failure: ${assertion.reason}`;
+        case 'skip':
+            return `Skipped: ${assertion.reason || 'no reason given'}`;
+        case 'todo':
+            return `TODO: ${assertion.reason || 'not implemented'}`;
+        case 'event-count':
+            return message || `Event count: ${assertion.eventCount}`;
+        case 'event-assert': {
+            const prefix = assertion.assertTrue ? 'assertTrue' : 'assertFalse';
+            const posStr = assertion.eventPosition ? ` Event ${assertion.eventPosition}:` : '';
+            const dataStr = assertion.eventData ? ` ${JSON.stringify(assertion.eventData)}` : '';
+            return message || `${prefix}:${posStr} ${assertion.eventType}${dataStr}`;
+        }
+        case 'state-assert': {
+            const prefix = assertion.assertTrue ? 'assertTrue' : 'assertFalse';
+            return message || `${prefix}: ${assertion.stateExpression}`;
+        }
+        default:
+            return message || 'Unknown assertion';
+    }
+}
+/**
+ * Report transcript summary
+ */
+function reportTranscriptSummary(result) {
+    const { passed, failed, expectedFailures, skipped, duration } = result;
+    const parts = [];
+    if (passed > 0) {
+        parts.push(chalk.green(`${passed} passed`));
+    }
+    if (failed > 0) {
+        parts.push(chalk.red(`${failed} failed`));
+    }
+    if (expectedFailures > 0) {
+        parts.push(chalk.magenta(`${expectedFailures} expected failures`));
+    }
+    if (skipped > 0) {
+        parts.push(chalk.yellow(`${skipped} skipped`));
+    }
+    console.log(`  ${parts.join(', ')} (${duration}ms)`);
+}
+/**
+ * Report results of running multiple transcripts
+ * Note: Individual transcripts should already be reported as they run.
+ * This function only shows the aggregate summary.
+ */
+export function reportTestRun(result, options = {}) {
+    console.log();
+    console.log(chalk.bold('━'.repeat(60)));
+    console.log();
+    // Overall summary
+    const { totalPassed, totalFailed, totalExpectedFailures, totalSkipped, totalDuration } = result;
+    const total = totalPassed + totalFailed + totalExpectedFailures + totalSkipped;
+    console.log(chalk.bold(`Total: ${total} tests in ${result.transcripts.length} transcripts`));
+    const parts = [];
+    if (totalPassed > 0) {
+        parts.push(chalk.green(`${totalPassed} passed`));
+    }
+    if (totalFailed > 0) {
+        parts.push(chalk.red(`${totalFailed} failed`));
+    }
+    if (totalExpectedFailures > 0) {
+        parts.push(chalk.magenta(`${totalExpectedFailures} expected failures`));
+    }
+    if (totalSkipped > 0) {
+        parts.push(chalk.yellow(`${totalSkipped} skipped`));
+    }
+    console.log(parts.join(', '));
+    console.log(chalk.gray(`Duration: ${totalDuration}ms`));
+    console.log();
+    // Final status
+    if (totalFailed === 0) {
+        console.log(chalk.green.bold('✓ All tests passed!'));
+    }
+    else {
+        console.log(chalk.red.bold(`✗ ${totalFailed} test(s) failed`));
+    }
+}
+/**
+ * Get exit code based on results
+ */
+export function getExitCode(result) {
+    if (result.totalFailed > 0) {
+        return 1;
+    }
+    return 0;
+}
+/**
+ * Generate a timestamp string for filenames
+ */
+export function generateTimestamp() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day}_${hours}-${minutes}-${seconds}`;
+}
+/**
+ * Write test results to a JSON file
+ */
+export function writeResultsToJson(result, outputDir, timestamp) {
+    // Ensure output directory exists
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    const filename = `results_${timestamp}.json`;
+    const filepath = path.join(outputDir, filename);
+    // Write JSON with serializable data (strip non-serializable like RegExp)
+    const serializableResult = JSON.parse(JSON.stringify(result, (key, value) => {
+        if (value instanceof RegExp) {
+            return value.toString();
+        }
+        return value;
+    }));
+    fs.writeFileSync(filepath, JSON.stringify(serializableResult, null, 2));
+    return filepath;
+}
+/**
+ * Write a human-readable report to a text file
+ */
+export function writeReportToFile(result, outputDir, timestamp) {
+    // Ensure output directory exists
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    const filename = `report_${timestamp}.txt`;
+    const filepath = path.join(outputDir, filename);
+    const lines = [];
+    lines.push('='.repeat(60));
+    lines.push('TRANSCRIPT TEST REPORT');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('='.repeat(60));
+    lines.push('');
+    // Overall summary
+    const { totalPassed, totalFailed, totalExpectedFailures, totalSkipped, totalDuration } = result;
+    const total = totalPassed + totalFailed + totalExpectedFailures + totalSkipped;
+    lines.push(`Total: ${total} tests in ${result.transcripts.length} transcript(s)`);
+    lines.push(`  Passed: ${totalPassed}`);
+    lines.push(`  Failed: ${totalFailed}`);
+    lines.push(`  Expected Failures: ${totalExpectedFailures}`);
+    lines.push(`  Skipped: ${totalSkipped}`);
+    lines.push(`  Duration: ${totalDuration}ms`);
+    lines.push('');
+    // Per-transcript details
+    for (const transcript of result.transcripts) {
+        lines.push('-'.repeat(60));
+        lines.push(`Transcript: ${transcript.transcript.filePath}`);
+        if (transcript.transcript.header.title) {
+            lines.push(`  Title: ${transcript.transcript.header.title}`);
+        }
+        lines.push(`  Results: ${transcript.passed} passed, ${transcript.failed} failed, ${transcript.expectedFailures} expected failures, ${transcript.skipped} skipped`);
+        lines.push('');
+        // Command details (only show failures in summary)
+        const failedCommands = transcript.commands.filter(c => !c.passed && !c.skipped && !c.expectedFailure);
+        if (failedCommands.length > 0) {
+            lines.push('  FAILURES:');
+            for (const cmd of failedCommands) {
+                lines.push(`    Line ${cmd.command.lineNumber}: > ${cmd.command.input}`);
+                if (cmd.error) {
+                    lines.push(`      Error: ${cmd.error}`);
+                }
+                for (const ar of cmd.assertionResults) {
+                    if (!ar.passed) {
+                        lines.push(`      - ${ar.message || formatAssertionPlain(ar.assertion)}`);
+                    }
+                }
+                lines.push('      Actual output:');
+                for (const line of cmd.actualOutput.split('\n')) {
+                    if (line.trim()) {
+                        lines.push(`        ${line}`);
+                    }
+                }
+                lines.push('');
+            }
+        }
+    }
+    lines.push('='.repeat(60));
+    if (totalFailed === 0) {
+        lines.push('ALL TESTS PASSED');
+    }
+    else {
+        lines.push(`${totalFailed} TEST(S) FAILED`);
+    }
+    lines.push('='.repeat(60));
+    fs.writeFileSync(filepath, lines.join('\n'));
+    return filepath;
+}
+/**
+ * Format an assertion without chalk colors (for file output)
+ */
+function formatAssertionPlain(assertion) {
+    switch (assertion.type) {
+        case 'ok':
+            return 'Exact match';
+        case 'ok-contains':
+            return `Contains "${assertion.value}"`;
+        case 'ok-not-contains':
+            return `Does not contain "${assertion.value}"`;
+        case 'ok-matches':
+            return `Matches ${assertion.pattern}`;
+        case 'fail':
+            return `Expected failure: ${assertion.reason}`;
+        case 'skip':
+            return `Skipped: ${assertion.reason || 'no reason given'}`;
+        case 'todo':
+            return `TODO: ${assertion.reason || 'not implemented'}`;
+        case 'event-count':
+            return `Event count: ${assertion.eventCount}`;
+        case 'event-assert': {
+            const prefix = assertion.assertTrue ? 'assertTrue' : 'assertFalse';
+            const posStr = assertion.eventPosition ? ` Event ${assertion.eventPosition}:` : '';
+            const dataStr = assertion.eventData ? ` ${JSON.stringify(assertion.eventData)}` : '';
+            return `${prefix}:${posStr} ${assertion.eventType}${dataStr}`;
+        }
+        case 'state-assert': {
+            const prefix = assertion.assertTrue ? 'assertTrue' : 'assertFalse';
+            return `${prefix}: ${assertion.stateExpression}`;
+        }
+        default:
+            return 'Unknown assertion';
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist-esm/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAQ7B,4DAA4D;AAC5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,UAA2B,EAAE;IAE7B,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEpC,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAElE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,eAAe;IACf,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,MAAqB,EAAE,OAAgB;IAC5D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAElF,gBAAgB;IAChB,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAEtD,mBAAmB;IACnB,IAAI,MAAc,CAAC;IACnB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,eAAe,EAAE,CAAC;QAC3B,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAEtD,iBAAiB;IACjB,IAAI,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACzD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,KAAK,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACzC,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3D,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,IAAI,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAE7C,8BAA8B;YAC9B,IAAI,OAAO,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC;gBAC9E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;wBAChD,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE;wBAC9C,CAAC,CAAC,EAAE,CAAC;oBACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;gBAC3D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;YACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,OAAO,IAAI,eAAe,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAuB;IAC9C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEtC,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,IAAI;YACP,OAAO,OAAO,IAAI,aAAa,CAAC;QAClC,KAAK,aAAa;YAChB,OAAO,OAAO,IAAI,aAAa,SAAS,CAAC,KAAK,GAAG,CAAC;QACpD,KAAK,iBAAiB;YACpB,OAAO,OAAO,IAAI,qBAAqB,SAAS,CAAC,KAAK,GAAG,CAAC;QAC5D,KAAK,YAAY;YACf,OAAO,OAAO,IAAI,WAAW,SAAS,CAAC,OAAO,EAAE,CAAC;QACnD,KAAK,MAAM;YACT,OAAO,qBAAqB,SAAS,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,MAAM;YACT,OAAO,YAAY,SAAS,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7D,KAAK,MAAM;YACT,OAAO,SAAS,SAAS,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAC1D,KAAK,aAAa;YAChB,OAAO,OAAO,IAAI,gBAAgB,SAAS,CAAC,UAAU,EAAE,CAAC;QAC3D,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;YACnE,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,OAAO,IAAI,GAAG,MAAM,IAAI,MAAM,IAAI,SAAS,CAAC,SAAS,GAAG,OAAO,EAAE,CAAC;QAC3E,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;YACnE,OAAO,OAAO,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,eAAe,EAAE,CAAC;QAC9D,CAAC;QACD;YACE,OAAO,OAAO,IAAI,mBAAmB,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,MAAwB;IACvD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,gBAAgB,oBAAoB,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,UAA2B,EAAE;IAChF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,kBAAkB;IAClB,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAChG,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,qBAAqB,GAAG,YAAY,CAAC;IAE/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC;IAE7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,SAAS,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW,SAAS,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,qBAAqB,oBAAoB,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,YAAY,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,aAAa,IAAI,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,eAAe;IACf,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,WAAW,iBAAiB,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,SAAiB,EACjB,SAAiB;IAEjB,iCAAiC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,SAAS,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhD,yEAAyE;IACzE,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1E,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC,CAAC;IAEJ,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqB,EACrB,SAAiB,EACjB,SAAiB;IAEjB,iCAAiC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,SAAS,MAAM,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kBAAkB;IAClB,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAChG,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,qBAAqB,GAAG,YAAY,CAAC;IAE/E,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,gBAAgB,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,wBAAwB,qBAAqB,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,yBAAyB;IACzB,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,YAAY,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,gBAAgB,uBAAuB,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;QACnK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,kDAAkD;QAClD,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACtG,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,UAAU,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;gBACzE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1C,CAAC;gBACD,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;oBACtC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;wBACf,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,IAAI,oBAAoB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC5E,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;wBAChB,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,iBAAiB,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,SAAc;IAC1C,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,IAAI;YACP,OAAO,aAAa,CAAC;QACvB,KAAK,aAAa;YAChB,OAAO,aAAa,SAAS,CAAC,KAAK,GAAG,CAAC;QACzC,KAAK,iBAAiB;YACpB,OAAO,qBAAqB,SAAS,CAAC,KAAK,GAAG,CAAC;QACjD,KAAK,YAAY;YACf,OAAO,WAAW,SAAS,CAAC,OAAO,EAAE,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,qBAAqB,SAAS,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,MAAM;YACT,OAAO,YAAY,SAAS,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7D,KAAK,MAAM;YACT,OAAO,SAAS,SAAS,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAC1D,KAAK,aAAa;YAChB,OAAO,gBAAgB,SAAS,CAAC,UAAU,EAAE,CAAC;QAChD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;YACnE,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,GAAG,MAAM,IAAI,MAAM,IAAI,SAAS,CAAC,SAAS,GAAG,OAAO,EAAE,CAAC;QAChE,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;YACnE,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,eAAe,EAAE,CAAC;QACnD,CAAC;QACD;YACE,OAAO,mBAAmB,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist-esm/runner.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Transcript Runner
+ *
+ * Executes transcript commands against a loaded story and checks results.
+ */
+import { Transcript, TranscriptResult, RunnerOptions } from './types';
+/**
+ * Interface for the game engine
+ */
+interface GameEngine {
+    executeCommand(input: string): Promise<string> | string;
+    getOutput?(): string;
+    lastEvents?: Array<{
+        type: string;
+        data?: any;
+    }>;
+    world?: WorldModel;
+}
+/**
+ * Minimal interface for world model state queries
+ */
+interface WorldModel {
+    getEntityById?(id: string): any;
+    getEntity?(id: string): any;
+    findEntityByName?(name: string): any;
+    getAllEntities?(): any[];
+    getLocation?(entityId: string): string | undefined;
+    getContents?(containerId: string, options?: {
+        includeWorn?: boolean;
+    }): any[];
+    findWhere?(predicate: (entity: any) => boolean): any[];
+    findByTrait?(traitType: string): any[];
+    findPath?(fromRoomId: string, toRoomId: string): string[] | null;
+    getPlayer?(): any;
+}
+/**
+ * Run a single transcript against an engine
+ *
+ * If transcript has items (with directives), use the smart runner.
+ * Otherwise, fall back to legacy command-only execution.
+ */
+export declare function runTranscript(transcript: Transcript, engine: GameEngine, options?: RunnerOptions): Promise<TranscriptResult>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist-esm/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,UAAU,EAWV,gBAAgB,EAChB,aAAa,EAEd,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,UAAU,UAAU;IAClB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACxD,SAAS,CAAC,IAAI,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC;IAC5B,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IACrC,cAAc,CAAC,IAAI,GAAG,EAAE,CAAC;IACzB,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,GAAG,EAAE,CAAC;IAC9E,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,GAAG,EAAE,CAAC;IACvD,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;IACvC,QAAQ,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACjE,SAAS,CAAC,IAAI,GAAG,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAoC3B"}