tryscript 0.0.1 → 0.1.0

package/docs/tryscript-reference.md

@@ -1,163 +1,441 @@
-# tryscript Quick Reference
+# tryscript Reference
 
-Concise syntax reference for writing tryscript test files.
+Complete reference for writing tryscript golden tests. This document covers all syntax,
+configuration, and patterns needed to write accurate CLI tests on the first try.
 
-## Test File Format
+## Overview
 
-Test files use `.tryscript.md` extension. Each file contains Markdown with console code blocks:
+Tryscript is a markdown-based CLI golden testing format. Test files are markdown documents
+with embedded console code blocks specifying commands and expected output.
 
-```markdown
-# Test: Description
+**Design Philosophy:**
+- **Shell delegation**: Commands run in a real shell with full shell features
+- **Markdown-first**: Test files are valid markdown, readable as documentation
+- **Output matching**: Patterns like `[..]` match variable output; they're not for commands
 
-\`\`\`console
-$ command
-expected output
-? exit_code
-\`\`\`
-```
+## Quick Start Example
 
-## Basic Example
+````markdown
+---
+sandbox: true
+env:
+  NO_COLOR: "1"
+---
 
-```markdown
-# Test: Echo command
+# Test: Basic echo
 
-\`\`\`console
+```console
 $ echo "hello world"
 hello world
 ? 0
-\`\`\`
 ```
 
-## Exit Codes
+# Test: Command with variable output
+
+```console
+$ date +%Y
+[..]
+? 0
+```
+````
+
+## Test File Structure
+
+```
+┌──────────────────────────────────────┐
+│ ---                                  │  YAML Frontmatter (optional)
+│ env:                                 │  - Configuration
+│   MY_VAR: value                      │  - Environment variables
+│ sandbox: true                        │  - Patterns
+│ ---                                  │
+├──────────────────────────────────────┤
+│ # Test: Description                  │  Test heading (# or ##)
+│                                      │
+│ ```console                           │  Test block
+│ $ command --flag                     │  - Command starts with $
+│ expected output                      │  - Expected stdout follows
+│ ? 0                                  │  - Exit code (optional, default 0)
+│ ```                                  │
+└──────────────────────────────────────┘
+```
+
+## Command Block Syntax
 
-Use `? N` to specify expected exit code:
+```
+$ command [arguments...]     # Command to execute (required)
+> continuation line          # Multi-line command continuation
+expected output              # Expected stdout (line by line)
+! stderr line                # Expected stderr (when separating streams)
+? exit_code                  # Expected exit code (default: 0)
+```
+
+### Examples
 
+**Simple command:**
+```console
+$ echo "hello"
+hello
+? 0
+```
+
+**Non-zero exit code:**
 ```console
 $ exit 42
 ? 42
 ```
 
+**Multi-line command:**
+```console
+$ ls -la | \
+> grep ".md" | \
+> wc -l
+5
+```
+
+**Stderr handling:**
+```console
+$ cat nonexistent 2>&1
+cat: nonexistent: No such file or directory
+? 1
+```
+
+**Separate stderr assertion:**
+```console
+$ ./script.sh
+stdout line
+! stderr line
+? 0
+```
+
 ## Elision Patterns
 
-| Pattern  | Matches                          | Example               |
-| -------- | -------------------------------- | --------------------- |
-| `[..]`   | Any characters on current line   | `Built in [..]ms`     |
-| `...`    | Zero or more complete lines      | `...\nDone`           |
-| `[EXE]`  | `.exe` on Windows, empty on Unix | `my-cli[EXE]`         |
-| `[ROOT]` | Test root directory              | `[ROOT]/output.txt`   |
-| `[CWD]`  | Current working directory        | `[CWD]/file.txt`      |
+Patterns in expected output match variable content:
 
-## YAML Frontmatter
+| Pattern | Matches | Example |
+|---------|---------|---------|
+| `[..]` | Any text on a single line | `Built in [..]ms` |
+| `...` | Zero or more complete lines | `...\nDone` |
+| `[CWD]` | Current working directory | `[CWD]/output.txt` |
+| `[ROOT]` | Test file directory | `[ROOT]/fixtures/` |
+| `[EXE]` | `.exe` on Windows, empty otherwise | `my-cli[EXE]` |
+| `[PATTERN]` | Custom pattern from config | User-defined regex |
 
-Configure test behavior at the top of the file:
+### Pattern Examples
+
+**Single-line wildcard:**
+```console
+$ date
+[..]
+? 0
+```
+
+**Multi-line wildcard:**
+```console
+$ ls -la
+total [..]
+...
+-rw-r--r-- 1 user user [..] README.md
+```
+
+**Custom pattern:**
+```yaml
+patterns:
+  VERSION: '\d+\.\d+\.\d+'
+```
+```console
+$ my-cli --version
+my-cli version [VERSION]
+```
+
+## Configuration (Frontmatter)
+
+All options are optional. Place at the top of the file:
 
 ```yaml
 ---
-bin: ./my-cli
-env:
+cwd: ./subdir              # Working directory (relative to test file)
+sandbox: true              # Run in isolated temp directory
+env:                       # Environment variables
   NO_COLOR: "1"
-timeout: 5000
-patterns:
-  VERSION: "\\d+\\.\\d+\\.\\d+"
+  MY_VAR: value
+timeout: 5000              # Command timeout in milliseconds
+patterns:                  # Custom elision patterns
+  UUID: '[0-9a-f]{8}-...'
+fixtures:                  # Files to copy to sandbox
+  - data/input.txt
+before: npm run build      # Run before first test
+after: rm -rf ./cache      # Run after all tests
 ---
 ```
 
-### Config Options
+### Config Options Reference
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `cwd` | path | `"."` | Working directory (relative to test file) |
+| `sandbox` | `boolean \| path` | `false` | Run in isolated temp directory |
+| `env` | `object` | `{}` | Environment variables passed to shell |
+| `timeout` | `number` | `30000` | Command timeout in milliseconds |
+| `patterns` | `object` | `{}` | Custom regex patterns for `[NAME]` |
+| `fixtures` | `array` | `[]` | Files to copy to sandbox |
+| `before` | `string` | - | Shell command before first test |
+| `after` | `string` | - | Shell command after all tests |
+
+## Sandbox Mode
 
-| Option     | Type     | Description                           |
-| ---------- | -------- | ------------------------------------- |
-| `bin`      | string   | Path to CLI binary                    |
-| `env`      | object   | Environment variables                 |
-| `timeout`  | number   | Command timeout in milliseconds       |
-| `patterns` | object   | Custom regex patterns for `[NAME]`    |
+Sandbox provides test isolation by running commands in a temporary directory:
 
-## Custom Patterns
+| Configuration | Behavior |
+|--------------|----------|
+| `sandbox: false` (default) | Commands run in `cwd` (test file dir) |
+| `sandbox: true` | Creates empty temp dir, commands run there |
+| `sandbox: ./fixtures` | Copies `./fixtures/` to temp dir, runs there |
 
-Define reusable patterns in frontmatter:
+**When sandbox is enabled:**
+- Fresh temp directory created for each test file
+- Fixtures are copied before tests run
+- `[CWD]` matches the sandbox directory
+- Files created by tests don't pollute source
+
+### Sandbox with Fixtures
 
 ```yaml
-patterns:
-  VERSION: "\\d+\\.\\d+\\.\\d+"
-  UUID: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
+---
+sandbox: true
+fixtures:
+  - data/input.txt                 # Copies to sandbox/input.txt
+  - source: config/settings.json   # Copies to sandbox/custom.json
+    dest: custom.json
+---
 ```
 
-Use in output:
+## Environment Variables
+
+Use `env` to set variables. The **shell** handles `$VAR` expansion:
+
+```yaml
+env:
+  CLI: ./dist/cli.mjs
+  DEBUG: "true"
+```
 
 ```console
-$ my-cli --version
+$ $CLI --version
+1.0.0
+```
+
+**Important:** Variables are for the shell, not for output matching.
+
+## Test Annotations
+
+Control test execution with HTML comments:
+
+```markdown
+## This test is skipped <!-- skip -->
+
+## Only run this test <!-- only -->
+```
+
+| Annotation | Effect |
+|------------|--------|
+| `<!-- skip -->` | Test is skipped, marked as passed |
+| `<!-- only -->` | Only tests with this annotation run |
+
+## Complete Example
+
+Here's a complete test file demonstrating all features:
+
+````markdown
+---
+sandbox: true
+env:
+  NO_COLOR: "1"
+  CLI: ./dist/my-cli.mjs
+timeout: 5000
+patterns:
+  VERSION: '\d+\.\d+\.\d+'
+  TIMESTAMP: '\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}'
+fixtures:
+  - test-data/config.json
+before: echo "Setup complete"
+---
+
+# CLI Golden Tests
+
+These tests validate the my-cli command-line tool.
+
+## Basic Commands
+
+# Test: Show version
+
+```console
+$ $CLI --version
 my-cli version [VERSION]
 ? 0
 ```
 
-## Multiple Commands
+# Test: Show help
 
-Multiple tests per file, each with its own heading:
+```console
+$ $CLI --help
+Usage: my-cli [options] [command]
 
-```markdown
-# Test: First test
+Options:
+  --version  Show version
+  --help     Show help
+...
+? 0
+```
+
+## Error Handling
+
+# Test: Missing required argument
+
+```console
+$ $CLI process
+Error: missing required argument 'file'
+? 1
+```
+
+# Test: File not found
+
+```console
+$ $CLI process nonexistent.txt 2>&1
+Error: file not found: nonexistent.txt
+? 1
+```
+
+## Feature Tests
+
+# Test: Process config file
 
-\`\`\`console
-$ echo one
-one
+```console
+$ $CLI process config.json
+Processing: config.json
+Done at [TIMESTAMP][..]
 ? 0
-\`\`\`
+```
 
-# Test: Second test
+# Test: Verbose output <!-- skip -->
 
-\`\`\`console
-$ echo two
-two
+```console
+$ $CLI --verbose process config.json
+[DEBUG] Loading config.json
+...
+Done
 ? 0
-\`\`\`
 ```
+````
 
 ## CLI Usage
 
 ```bash
-# Run all tests
-npx tryscript
+tryscript                    # Show help (same as --help)
+tryscript run [files...]     # Run golden tests
+tryscript docs               # Show this reference
+tryscript readme             # Show README
+```
+
+### Run Options
+
+| Option | Description |
+|--------|-------------|
+| `--update` | Update test files with actual output |
+| `--diff` / `--no-diff` | Show/hide diff on failure |
+| `--fail-fast` | Stop on first failure |
+| `--filter <pattern>` | Filter tests by name |
+| `--verbose` | Show detailed output |
+| `--quiet` | Suppress non-essential output |
 
-# Run specific files
-npx tryscript tests/foo.tryscript.md
+## Best Practices
+
+### DO: Use shell features directly
+
+```console
+$ echo "hello" | tr 'a-z' 'A-Z'
+HELLO
+
+$ cat file.txt 2>/dev/null || echo "not found"
+not found
+```
+
+### DO: Use env for CLI paths
+
+```yaml
+env:
+  BIN: ./dist/cli.mjs
+```
+```console
+$ $BIN --version
+1.0.0
+```
 
-# Update golden files
-npx tryscript --update
+### DO: Use sandbox for file operations
 
-# Filter tests by name
-npx tryscript --filter "pattern"
+```yaml
+sandbox: true
+```
+```console
+$ echo "test" > output.txt
+$ cat output.txt
+test
+```
 
-# Fail fast on first error
-npx tryscript --fail-fast
+### DON'T: Use patterns in commands
 
-# Verbose output
-npx tryscript --verbose
+```console
+# ❌ WRONG: Patterns are for output matching only
+$ cat [CWD]/file.txt
 ```
 
-## Options
+### DON'T: Rely on exact timestamps or paths
 
-| Option             | Description                              |
-| ------------------ | ---------------------------------------- |
-| `--update`         | Update golden files with actual output   |
-| `--diff`           | Show diff on failure (default: true)     |
-| `--no-diff`        | Hide diff on failure                     |
-| `--fail-fast`      | Stop on first failure                    |
-| `--filter <regex>` | Filter tests by name pattern             |
-| `--verbose`        | Show detailed output                     |
-| `--quiet`          | Suppress non-essential output            |
+```console
+# ❌ WRONG: Exact match will fail
+$ date
+Mon Jan 3 12:34:56 UTC 2026
+
+# ✓ RIGHT: Use elision
+$ date
+[..]
+```
 
 ## Config File
 
-Create `tryscript.config.ts` in your project root:
+For project-wide settings, create `tryscript.config.ts`:
 
 ```typescript
 import { defineConfig } from 'tryscript';
 
 export default defineConfig({
-  bin: './dist/cli.js',
   env: { NO_COLOR: '1' },
   timeout: 30000,
   patterns: {
     VERSION: '\\d+\\.\\d+\\.\\d+',
+    UUID: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}',
   },
 });
 ```
+
+## Execution Model
+
+```
+Test File → Parse YAML + Blocks → Create Execution Context
+                                         │
+                    ┌────────────────────┴────────────────────┐
+                    │                                         │
+              sandbox: false                            sandbox: true
+              cwd = testDir/config.cwd                  cwd = /tmp/tryscript-xxx/
+                    │                                         │
+                    └────────────────────┬────────────────────┘
+                                         │
+                    spawn(command, { shell: true, cwd, env })
+                                         │
+                    Capture stdout + stderr → Match against expected
+```
+
+**Key points:**
+1. Commands run in a real shell (`shell: true`)
+2. Shell handles all variable expansion (`$VAR`)
+3. Patterns (`[..]`, `[CWD]`) only apply to output matching
+4. Sandbox creates isolated temp directory per test file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tryscript",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Golden testing for CLI applications - TypeScript port of trycmd",
   "license": "MIT",
   "author": "Joshua Levy",
@@ -37,20 +37,6 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:golden": "node dist/bin.mjs 'tests/**/*.tryscript.md'",
-    "test:golden:coverage": "c8 --src src --all --include 'dist/**' --reporter text --reporter html --reports-dir coverage-golden node dist/bin.mjs 'tests/**/*.tryscript.md'",
-    "test:coverage": "vitest run --coverage",
-    "test:all:coverage": "pnpm test:golden:coverage && pnpm test:coverage",
-    "publint": "publint",
-    "prepack": "pnpm build",
-    "tryscript": "tsx src/bin.ts"
-  },
   "dependencies": {
     "atomically": "^2.0.0",
     "commander": "^14.0.0",
@@ -72,5 +58,20 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "copy-docs": "cp ../../README.md . && mkdir -p docs && cp ../../docs/tryscript-reference.md docs/",
+    "build": "pnpm copy-docs && tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:self": "tsx src/bin.ts",
+    "test:golden": "node dist/bin.mjs run 'tests/**/*.tryscript.md'",
+    "test:golden:coverage": "c8 --src src --all --include 'dist/**' --reporter text --reporter html --reports-dir coverage-golden node dist/bin.mjs run 'tests/**/*.tryscript.md'",
+    "test:coverage": "vitest run --coverage",
+    "test:all:coverage": "pnpm test:golden:coverage && pnpm test:coverage",
+    "publint": "publint",
+    "tryscript": "tsx src/bin.ts"
   }
-}
+}

package/dist/src-CeUA446P.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"src-CeUA446P.cjs","names":["module","config: TestConfig","blocks: TestBlock[]","match: RegExpExecArray | null","commandLines: string[]","outputLines: string[]","chunks: Buffer[]","VERSION: string"],"sources":["../src/lib/config.ts","../src/lib/parser.ts","../src/lib/runner.ts","../src/lib/matcher.ts","../src/index.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { TestConfig } from './types.js';\n\nexport interface TryscriptConfig {\n  bin?: string;\n  env?: Record<string, string>;\n  timeout?: number;\n  patterns?: Record<string, RegExp | string>;\n  tests?: string[];\n}\n\nconst CONFIG_FILES = ['tryscript.config.ts', 'tryscript.config.js', 'tryscript.config.mjs'];\n\n/**\n * Load config file using dynamic import.\n * Supports both TypeScript (via tsx/ts-node) and JavaScript configs.\n */\nexport async function loadConfig(baseDir: string): Promise<TryscriptConfig> {\n  for (const filename of CONFIG_FILES) {\n    const configPath = resolve(baseDir, filename);\n    if (existsSync(configPath)) {\n      const configUrl = pathToFileURL(configPath).href;\n      const module = (await import(configUrl)) as { default?: TryscriptConfig } | TryscriptConfig;\n      return (module as { default?: TryscriptConfig }).default ?? (module as TryscriptConfig);\n    }\n  }\n  return {};\n}\n\n/**\n * Merge config with frontmatter overrides.\n * Frontmatter takes precedence over config file.\n */\nexport function mergeConfig(base: TryscriptConfig, frontmatter: TestConfig): TryscriptConfig {\n  return {\n    ...base,\n    ...frontmatter,\n    env: { ...base.env, ...frontmatter.env },\n    patterns: { ...base.patterns, ...frontmatter.patterns },\n  };\n}\n\n/**\n * Helper for typed config files.\n */\nexport function defineConfig(config: TryscriptConfig): TryscriptConfig {\n  return config;\n}\n","import { parse as parseYaml } from 'yaml';\nimport type { TestConfig, TestBlock, TestFile } from './types.js';\n\n/** Regex to match YAML frontmatter at the start of a file */\nconst FRONTMATTER_REGEX = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n/;\n\n/** Regex to match fenced code blocks with console/bash info string */\nconst CODE_BLOCK_REGEX = /```(console|bash)\\r?\\n([\\s\\S]*?)```/g;\n\n/** Regex to match markdown headings (for test names) */\nconst HEADING_REGEX = /^#+\\s+(?:Test:\\s*)?(.+)$/m;\n\n/**\n * Parse a .tryscript.md file into structured test data.\n */\nexport function parseTestFile(content: string, filePath: string): TestFile {\n  const rawContent = content;\n  let config: TestConfig = {};\n  let body = content;\n\n  // Extract frontmatter if present\n  const frontmatterMatch = FRONTMATTER_REGEX.exec(content);\n  if (frontmatterMatch) {\n    const yamlContent = frontmatterMatch[1] ?? '';\n    config = parseYaml(yamlContent) as TestConfig;\n    body = content.slice(frontmatterMatch[0].length);\n  }\n\n  // Parse all console blocks\n  const blocks: TestBlock[] = [];\n\n  // Reset regex lastIndex\n  CODE_BLOCK_REGEX.lastIndex = 0;\n\n  let match: RegExpExecArray | null;\n  while ((match = CODE_BLOCK_REGEX.exec(body)) !== null) {\n    const blockContent = match[2] ?? '';\n    const blockStart = match.index;\n\n    // Find the line number (1-indexed)\n    const precedingContent = content.slice(0, content.indexOf(match[0]));\n    const lineNumber = precedingContent.split('\\n').length;\n\n    // Look for a heading before this block (for test name)\n    const contentBefore = body.slice(0, blockStart);\n    const lastHeadingMatch = [\n      ...contentBefore.matchAll(new RegExp(HEADING_REGEX.source, 'gm')),\n    ].pop();\n    const name = lastHeadingMatch?.[1]?.trim();\n\n    // Parse the block content\n    const parsed = parseBlockContent(blockContent);\n    if (parsed) {\n      blocks.push({\n        name,\n        command: parsed.command,\n        expectedOutput: parsed.expectedOutput,\n        expectedExitCode: parsed.expectedExitCode,\n        lineNumber,\n        rawContent: match[0],\n      });\n    }\n  }\n\n  return { path: filePath, config, blocks, rawContent };\n}\n\n/**\n * Parse the content of a single console block.\n */\nfunction parseBlockContent(content: string): {\n  command: string;\n  expectedOutput: string;\n  expectedExitCode: number;\n} | null {\n  const lines = content.split('\\n');\n  const commandLines: string[] = [];\n  const outputLines: string[] = [];\n  let expectedExitCode = 0;\n  let inCommand = false;\n\n  for (const line of lines) {\n    if (line.startsWith('$ ')) {\n      // Start of a command\n      inCommand = true;\n      commandLines.push(line.slice(2));\n    } else if (line.startsWith('> ') && inCommand) {\n      // Continuation of a multi-line command\n      commandLines.push(line.slice(2));\n    } else if (line.startsWith('? ')) {\n      // Exit code specification\n      inCommand = false;\n      expectedExitCode = parseInt(line.slice(2).trim(), 10);\n    } else {\n      // Output line\n      inCommand = false;\n      outputLines.push(line);\n    }\n  }\n\n  if (commandLines.length === 0) {\n    return null;\n  }\n\n  // Join command lines, handling shell continuations\n  let command = '';\n  for (let i = 0; i < commandLines.length; i++) {\n    const line = commandLines[i] ?? '';\n    if (line.endsWith('\\\\')) {\n      command += line.slice(0, -1) + ' ';\n    } else {\n      command += line;\n      if (i < commandLines.length - 1) {\n        command += ' ';\n      }\n    }\n  }\n\n  // Join output lines, preserving blank lines but trimming trailing empty lines\n  let expectedOutput = outputLines.join('\\n');\n  expectedOutput = expectedOutput.replace(/\\n+$/, '');\n  if (expectedOutput) {\n    expectedOutput += '\\n';\n  }\n\n  return { command: command.trim(), expectedOutput, expectedExitCode };\n}\n","import { spawn } from 'node:child_process';\nimport { mkdtemp, realpath, rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join, dirname, resolve } from 'node:path';\nimport treeKill from 'tree-kill';\nimport type { TestBlock, TestBlockResult } from './types.js';\nimport type { TryscriptConfig } from './config.js';\n\n/** Default timeout in milliseconds */\nconst DEFAULT_TIMEOUT = 30_000;\n\n/**\n * Execution context for a test file.\n * Created once per file, contains the temp directory.\n */\nexport interface ExecutionContext {\n  /** Temporary directory for this test file (resolved, no symlinks) */\n  tempDir: string;\n  /** Directory containing the test file (for portable test commands) */\n  testDir: string;\n  /** Resolved binary path */\n  binPath: string;\n  /** Environment variables */\n  env: Record<string, string>;\n  /** Timeout per command */\n  timeout: number;\n}\n\n/**\n * Create an execution context for a test file.\n */\nexport async function createExecutionContext(\n  config: TryscriptConfig,\n  testFilePath: string,\n): Promise<ExecutionContext> {\n  // Create temp directory and resolve symlinks (e.g., /var -> /private/var on macOS)\n  // This ensures [CWD] and [ROOT] patterns match pwd output\n  const rawTempDir = await mkdtemp(join(tmpdir(), 'tryscript-'));\n  const tempDir = await realpath(rawTempDir);\n\n  // Resolve test file directory for portable test commands\n  const testDir = resolve(dirname(testFilePath));\n\n  // Resolve binary path relative to test file directory\n  let binPath = config.bin ?? '';\n  if (binPath && !binPath.startsWith('/')) {\n    binPath = join(testDir, binPath);\n  }\n\n  return {\n    tempDir,\n    testDir,\n    binPath,\n    env: {\n      ...process.env,\n      ...config.env,\n      // Disable colors by default for deterministic output\n      NO_COLOR: config.env?.NO_COLOR ?? '1',\n      FORCE_COLOR: '0',\n      // Provide test directory for portable test commands\n      TRYSCRIPT_TEST_DIR: testDir,\n    } as Record<string, string>,\n    timeout: config.timeout ?? DEFAULT_TIMEOUT,\n  };\n}\n\n/**\n * Clean up execution context (remove temp directory).\n */\nexport async function cleanupExecutionContext(ctx: ExecutionContext): Promise<void> {\n  await rm(ctx.tempDir, { recursive: true, force: true });\n}\n\n/**\n * Run a single test block and return the result.\n */\nexport async function runBlock(block: TestBlock, ctx: ExecutionContext): Promise<TestBlockResult> {\n  const startTime = Date.now();\n\n  try {\n    const { output, exitCode } = await executeCommand(block.command, ctx);\n\n    const duration = Date.now() - startTime;\n\n    return {\n      block,\n      passed: true, // Matching handled separately\n      actualOutput: output,\n      actualExitCode: exitCode,\n      duration,\n    };\n  } catch (error) {\n    const duration = Date.now() - startTime;\n    const message = error instanceof Error ? error.message : String(error);\n\n    return {\n      block,\n      passed: false,\n      actualOutput: '',\n      actualExitCode: -1,\n      duration,\n      error: message,\n    };\n  }\n}\n\n/**\n * Execute a command and capture output.\n */\nasync function executeCommand(\n  command: string,\n  ctx: ExecutionContext,\n): Promise<{ output: string; exitCode: number }> {\n  return new Promise((resolve, reject) => {\n    const proc = spawn(command, {\n      shell: true,\n      cwd: ctx.tempDir,\n      env: ctx.env as NodeJS.ProcessEnv,\n      // Pipe both to capture\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    const chunks: Buffer[] = [];\n\n    // Capture data as it comes in to preserve order\n    proc.stdout.on('data', (data: Buffer) => chunks.push(data));\n    proc.stderr.on('data', (data: Buffer) => chunks.push(data));\n\n    const timeoutId = setTimeout(() => {\n      if (proc.pid) {\n        treeKill(proc.pid, 'SIGKILL');\n      }\n      reject(new Error(`Command timed out after ${ctx.timeout}ms`));\n    }, ctx.timeout);\n\n    proc.on('close', (code) => {\n      clearTimeout(timeoutId);\n      const output = Buffer.concat(chunks).toString('utf-8');\n      resolve({\n        output,\n        exitCode: code ?? 0,\n      });\n    });\n\n    proc.on('error', (err) => {\n      clearTimeout(timeoutId);\n      reject(err);\n    });\n  });\n}\n","import stripAnsi from 'strip-ansi';\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n// Marker prefix for patterns (uses Unicode private use chars that won't appear in normal output)\nconst MARKER = '\\uE000';\n\n/**\n * Convert expected output with elision patterns to a regex.\n *\n * Handles (matching trycmd):\n * - [..] — matches any characters on the same line (trycmd: [^\\n]*?)\n * - ... — matches zero or more complete lines (trycmd: \\n(([^\\n]*\\n)*)?)\n * - [EXE] — matches .exe on Windows, empty otherwise\n * - [ROOT] — replaced with test root directory (pre-processed)\n * - [CWD] — replaced with current working directory (pre-processed)\n * - Custom [NAME] patterns from config (trycmd: TestCases::insert_var)\n */\nfunction patternToRegex(\n  expected: string,\n  customPatterns: Record<string, string | RegExp> = {},\n): RegExp {\n  // Build a map of markers to their regex replacements\n  const replacements = new Map<string, string>();\n  let markerIndex = 0;\n\n  const getMarker = (): string => {\n    return `${MARKER}${markerIndex++}${MARKER}`;\n  };\n\n  let processed = expected;\n\n  // Replace [..] with marker\n  const dotdotMarker = getMarker();\n  replacements.set(dotdotMarker, '[^\\\\n]*');\n  processed = processed.replaceAll('[..]', dotdotMarker);\n\n  // Replace ... (followed by newline) with marker\n  const ellipsisMarker = getMarker();\n  replacements.set(ellipsisMarker, '(?:[^\\\\n]*\\\\n)*');\n  processed = processed.replace(/\\.\\.\\.\\n/g, ellipsisMarker);\n\n  // Replace [EXE] with marker\n  const exeMarker = getMarker();\n  const exe = process.platform === 'win32' ? '\\\\.exe' : '';\n  replacements.set(exeMarker, exe);\n  processed = processed.replaceAll('[EXE]', exeMarker);\n\n  // Replace custom patterns with markers\n  for (const [name, pattern] of Object.entries(customPatterns)) {\n    const placeholder = `[${name}]`;\n    const patternStr = pattern instanceof RegExp ? pattern.source : pattern;\n    const marker = getMarker();\n    replacements.set(marker, `(${patternStr})`);\n    processed = processed.replaceAll(placeholder, marker);\n  }\n\n  // Escape special regex characters\n  let regex = escapeRegex(processed);\n\n  // Restore markers to their regex replacements\n  for (const [marker, replacement] of replacements) {\n    regex = regex.replaceAll(escapeRegex(marker), replacement);\n  }\n\n  // Match the entire string (dotall mode for . to match newlines if needed)\n  return new RegExp(`^${regex}$`, 's');\n}\n\n/**\n * Pre-process expected output to replace path placeholders with actual paths.\n * This happens BEFORE pattern matching.\n */\nfunction preprocessPaths(expected: string, context: { root: string; cwd: string }): string {\n  let result = expected;\n  // Normalize paths for comparison (use forward slashes)\n  const normalizedRoot = context.root.replace(/\\\\/g, '/');\n  const normalizedCwd = context.cwd.replace(/\\\\/g, '/');\n  result = result.replaceAll('[ROOT]', normalizedRoot);\n  result = result.replaceAll('[CWD]', normalizedCwd);\n  return result;\n}\n\n/**\n * Normalize actual output for comparison.\n * - Remove ANSI escape codes (colors, etc.)\n * - Normalize line endings to \\n\n * - Normalize paths (Windows backslashes to forward slashes)\n * - Trim trailing whitespace from lines\n * - Ensure single trailing newline\n */\nexport function normalizeOutput(output: string): string {\n  // Remove ANSI escape codes first\n  let normalized = stripAnsi(output);\n\n  normalized = normalized\n    .replace(/\\r\\n/g, '\\n')\n    .replace(/\\r/g, '\\n')\n    .split('\\n')\n    .map((line) => line.trimEnd())\n    .join('\\n')\n    .replace(/\\n+$/, '\\n');\n\n  // Handle empty output\n  if (normalized === '\\n') {\n    normalized = '';\n  }\n\n  return normalized;\n}\n\n/**\n * Check if actual output matches expected pattern.\n */\nexport function matchOutput(\n  actual: string,\n  expected: string,\n  context: { root: string; cwd: string },\n  customPatterns: Record<string, string | RegExp> = {},\n): boolean {\n  const normalizedActual = normalizeOutput(actual);\n  const normalizedExpected = normalizeOutput(expected);\n\n  // Empty expected matches empty actual\n  if (normalizedExpected === '' && normalizedActual === '') {\n    return true;\n  }\n\n  const preprocessed = preprocessPaths(normalizedExpected, context);\n  const regex = patternToRegex(preprocessed, customPatterns);\n  return regex.test(normalizedActual);\n}\n","// Public API exports\n\n// Version constant (injected at build time)\ndeclare const __VERSION__: string;\nexport const VERSION: string = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'development';\n\n// Config helper\nexport { defineConfig } from './lib/config.js';\nexport type { TryscriptConfig } from './lib/config.js';\n\n// Types\nexport type {\n  TestConfig,\n  TestBlock,\n  TestFile,\n  TestBlockResult,\n  TestFileResult,\n  TestRunSummary,\n} from './lib/types.js';\n\n// Core functions (for programmatic use)\nexport { parseTestFile } from './lib/parser.js';\nexport { runBlock, createExecutionContext, cleanupExecutionContext } from './lib/runner.js';\nexport type { ExecutionContext } from './lib/runner.js';\nexport { matchOutput, normalizeOutput } from './lib/matcher.js';\n"],"mappings":"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"}

package/dist/src-UjaSQrqA.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"src-UjaSQrqA.mjs","names":["config: TestConfig","parseYaml","blocks: TestBlock[]","match: RegExpExecArray | null","commandLines: string[]","outputLines: string[]","chunks: Buffer[]","VERSION: string"],"sources":["../src/lib/config.ts","../src/lib/parser.ts","../src/lib/runner.ts","../src/lib/matcher.ts","../src/index.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { TestConfig } from './types.js';\n\nexport interface TryscriptConfig {\n  bin?: string;\n  env?: Record<string, string>;\n  timeout?: number;\n  patterns?: Record<string, RegExp | string>;\n  tests?: string[];\n}\n\nconst CONFIG_FILES = ['tryscript.config.ts', 'tryscript.config.js', 'tryscript.config.mjs'];\n\n/**\n * Load config file using dynamic import.\n * Supports both TypeScript (via tsx/ts-node) and JavaScript configs.\n */\nexport async function loadConfig(baseDir: string): Promise<TryscriptConfig> {\n  for (const filename of CONFIG_FILES) {\n    const configPath = resolve(baseDir, filename);\n    if (existsSync(configPath)) {\n      const configUrl = pathToFileURL(configPath).href;\n      const module = (await import(configUrl)) as { default?: TryscriptConfig } | TryscriptConfig;\n      return (module as { default?: TryscriptConfig }).default ?? (module as TryscriptConfig);\n    }\n  }\n  return {};\n}\n\n/**\n * Merge config with frontmatter overrides.\n * Frontmatter takes precedence over config file.\n */\nexport function mergeConfig(base: TryscriptConfig, frontmatter: TestConfig): TryscriptConfig {\n  return {\n    ...base,\n    ...frontmatter,\n    env: { ...base.env, ...frontmatter.env },\n    patterns: { ...base.patterns, ...frontmatter.patterns },\n  };\n}\n\n/**\n * Helper for typed config files.\n */\nexport function defineConfig(config: TryscriptConfig): TryscriptConfig {\n  return config;\n}\n","import { parse as parseYaml } from 'yaml';\nimport type { TestConfig, TestBlock, TestFile } from './types.js';\n\n/** Regex to match YAML frontmatter at the start of a file */\nconst FRONTMATTER_REGEX = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n/;\n\n/** Regex to match fenced code blocks with console/bash info string */\nconst CODE_BLOCK_REGEX = /```(console|bash)\\r?\\n([\\s\\S]*?)```/g;\n\n/** Regex to match markdown headings (for test names) */\nconst HEADING_REGEX = /^#+\\s+(?:Test:\\s*)?(.+)$/m;\n\n/**\n * Parse a .tryscript.md file into structured test data.\n */\nexport function parseTestFile(content: string, filePath: string): TestFile {\n  const rawContent = content;\n  let config: TestConfig = {};\n  let body = content;\n\n  // Extract frontmatter if present\n  const frontmatterMatch = FRONTMATTER_REGEX.exec(content);\n  if (frontmatterMatch) {\n    const yamlContent = frontmatterMatch[1] ?? '';\n    config = parseYaml(yamlContent) as TestConfig;\n    body = content.slice(frontmatterMatch[0].length);\n  }\n\n  // Parse all console blocks\n  const blocks: TestBlock[] = [];\n\n  // Reset regex lastIndex\n  CODE_BLOCK_REGEX.lastIndex = 0;\n\n  let match: RegExpExecArray | null;\n  while ((match = CODE_BLOCK_REGEX.exec(body)) !== null) {\n    const blockContent = match[2] ?? '';\n    const blockStart = match.index;\n\n    // Find the line number (1-indexed)\n    const precedingContent = content.slice(0, content.indexOf(match[0]));\n    const lineNumber = precedingContent.split('\\n').length;\n\n    // Look for a heading before this block (for test name)\n    const contentBefore = body.slice(0, blockStart);\n    const lastHeadingMatch = [\n      ...contentBefore.matchAll(new RegExp(HEADING_REGEX.source, 'gm')),\n    ].pop();\n    const name = lastHeadingMatch?.[1]?.trim();\n\n    // Parse the block content\n    const parsed = parseBlockContent(blockContent);\n    if (parsed) {\n      blocks.push({\n        name,\n        command: parsed.command,\n        expectedOutput: parsed.expectedOutput,\n        expectedExitCode: parsed.expectedExitCode,\n        lineNumber,\n        rawContent: match[0],\n      });\n    }\n  }\n\n  return { path: filePath, config, blocks, rawContent };\n}\n\n/**\n * Parse the content of a single console block.\n */\nfunction parseBlockContent(content: string): {\n  command: string;\n  expectedOutput: string;\n  expectedExitCode: number;\n} | null {\n  const lines = content.split('\\n');\n  const commandLines: string[] = [];\n  const outputLines: string[] = [];\n  let expectedExitCode = 0;\n  let inCommand = false;\n\n  for (const line of lines) {\n    if (line.startsWith('$ ')) {\n      // Start of a command\n      inCommand = true;\n      commandLines.push(line.slice(2));\n    } else if (line.startsWith('> ') && inCommand) {\n      // Continuation of a multi-line command\n      commandLines.push(line.slice(2));\n    } else if (line.startsWith('? ')) {\n      // Exit code specification\n      inCommand = false;\n      expectedExitCode = parseInt(line.slice(2).trim(), 10);\n    } else {\n      // Output line\n      inCommand = false;\n      outputLines.push(line);\n    }\n  }\n\n  if (commandLines.length === 0) {\n    return null;\n  }\n\n  // Join command lines, handling shell continuations\n  let command = '';\n  for (let i = 0; i < commandLines.length; i++) {\n    const line = commandLines[i] ?? '';\n    if (line.endsWith('\\\\')) {\n      command += line.slice(0, -1) + ' ';\n    } else {\n      command += line;\n      if (i < commandLines.length - 1) {\n        command += ' ';\n      }\n    }\n  }\n\n  // Join output lines, preserving blank lines but trimming trailing empty lines\n  let expectedOutput = outputLines.join('\\n');\n  expectedOutput = expectedOutput.replace(/\\n+$/, '');\n  if (expectedOutput) {\n    expectedOutput += '\\n';\n  }\n\n  return { command: command.trim(), expectedOutput, expectedExitCode };\n}\n","import { spawn } from 'node:child_process';\nimport { mkdtemp, realpath, rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join, dirname, resolve } from 'node:path';\nimport treeKill from 'tree-kill';\nimport type { TestBlock, TestBlockResult } from './types.js';\nimport type { TryscriptConfig } from './config.js';\n\n/** Default timeout in milliseconds */\nconst DEFAULT_TIMEOUT = 30_000;\n\n/**\n * Execution context for a test file.\n * Created once per file, contains the temp directory.\n */\nexport interface ExecutionContext {\n  /** Temporary directory for this test file (resolved, no symlinks) */\n  tempDir: string;\n  /** Directory containing the test file (for portable test commands) */\n  testDir: string;\n  /** Resolved binary path */\n  binPath: string;\n  /** Environment variables */\n  env: Record<string, string>;\n  /** Timeout per command */\n  timeout: number;\n}\n\n/**\n * Create an execution context for a test file.\n */\nexport async function createExecutionContext(\n  config: TryscriptConfig,\n  testFilePath: string,\n): Promise<ExecutionContext> {\n  // Create temp directory and resolve symlinks (e.g., /var -> /private/var on macOS)\n  // This ensures [CWD] and [ROOT] patterns match pwd output\n  const rawTempDir = await mkdtemp(join(tmpdir(), 'tryscript-'));\n  const tempDir = await realpath(rawTempDir);\n\n  // Resolve test file directory for portable test commands\n  const testDir = resolve(dirname(testFilePath));\n\n  // Resolve binary path relative to test file directory\n  let binPath = config.bin ?? '';\n  if (binPath && !binPath.startsWith('/')) {\n    binPath = join(testDir, binPath);\n  }\n\n  return {\n    tempDir,\n    testDir,\n    binPath,\n    env: {\n      ...process.env,\n      ...config.env,\n      // Disable colors by default for deterministic output\n      NO_COLOR: config.env?.NO_COLOR ?? '1',\n      FORCE_COLOR: '0',\n      // Provide test directory for portable test commands\n      TRYSCRIPT_TEST_DIR: testDir,\n    } as Record<string, string>,\n    timeout: config.timeout ?? DEFAULT_TIMEOUT,\n  };\n}\n\n/**\n * Clean up execution context (remove temp directory).\n */\nexport async function cleanupExecutionContext(ctx: ExecutionContext): Promise<void> {\n  await rm(ctx.tempDir, { recursive: true, force: true });\n}\n\n/**\n * Run a single test block and return the result.\n */\nexport async function runBlock(block: TestBlock, ctx: ExecutionContext): Promise<TestBlockResult> {\n  const startTime = Date.now();\n\n  try {\n    const { output, exitCode } = await executeCommand(block.command, ctx);\n\n    const duration = Date.now() - startTime;\n\n    return {\n      block,\n      passed: true, // Matching handled separately\n      actualOutput: output,\n      actualExitCode: exitCode,\n      duration,\n    };\n  } catch (error) {\n    const duration = Date.now() - startTime;\n    const message = error instanceof Error ? error.message : String(error);\n\n    return {\n      block,\n      passed: false,\n      actualOutput: '',\n      actualExitCode: -1,\n      duration,\n      error: message,\n    };\n  }\n}\n\n/**\n * Execute a command and capture output.\n */\nasync function executeCommand(\n  command: string,\n  ctx: ExecutionContext,\n): Promise<{ output: string; exitCode: number }> {\n  return new Promise((resolve, reject) => {\n    const proc = spawn(command, {\n      shell: true,\n      cwd: ctx.tempDir,\n      env: ctx.env as NodeJS.ProcessEnv,\n      // Pipe both to capture\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    const chunks: Buffer[] = [];\n\n    // Capture data as it comes in to preserve order\n    proc.stdout.on('data', (data: Buffer) => chunks.push(data));\n    proc.stderr.on('data', (data: Buffer) => chunks.push(data));\n\n    const timeoutId = setTimeout(() => {\n      if (proc.pid) {\n        treeKill(proc.pid, 'SIGKILL');\n      }\n      reject(new Error(`Command timed out after ${ctx.timeout}ms`));\n    }, ctx.timeout);\n\n    proc.on('close', (code) => {\n      clearTimeout(timeoutId);\n      const output = Buffer.concat(chunks).toString('utf-8');\n      resolve({\n        output,\n        exitCode: code ?? 0,\n      });\n    });\n\n    proc.on('error', (err) => {\n      clearTimeout(timeoutId);\n      reject(err);\n    });\n  });\n}\n","import stripAnsi from 'strip-ansi';\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n// Marker prefix for patterns (uses Unicode private use chars that won't appear in normal output)\nconst MARKER = '\\uE000';\n\n/**\n * Convert expected output with elision patterns to a regex.\n *\n * Handles (matching trycmd):\n * - [..] — matches any characters on the same line (trycmd: [^\\n]*?)\n * - ... — matches zero or more complete lines (trycmd: \\n(([^\\n]*\\n)*)?)\n * - [EXE] — matches .exe on Windows, empty otherwise\n * - [ROOT] — replaced with test root directory (pre-processed)\n * - [CWD] — replaced with current working directory (pre-processed)\n * - Custom [NAME] patterns from config (trycmd: TestCases::insert_var)\n */\nfunction patternToRegex(\n  expected: string,\n  customPatterns: Record<string, string | RegExp> = {},\n): RegExp {\n  // Build a map of markers to their regex replacements\n  const replacements = new Map<string, string>();\n  let markerIndex = 0;\n\n  const getMarker = (): string => {\n    return `${MARKER}${markerIndex++}${MARKER}`;\n  };\n\n  let processed = expected;\n\n  // Replace [..] with marker\n  const dotdotMarker = getMarker();\n  replacements.set(dotdotMarker, '[^\\\\n]*');\n  processed = processed.replaceAll('[..]', dotdotMarker);\n\n  // Replace ... (followed by newline) with marker\n  const ellipsisMarker = getMarker();\n  replacements.set(ellipsisMarker, '(?:[^\\\\n]*\\\\n)*');\n  processed = processed.replace(/\\.\\.\\.\\n/g, ellipsisMarker);\n\n  // Replace [EXE] with marker\n  const exeMarker = getMarker();\n  const exe = process.platform === 'win32' ? '\\\\.exe' : '';\n  replacements.set(exeMarker, exe);\n  processed = processed.replaceAll('[EXE]', exeMarker);\n\n  // Replace custom patterns with markers\n  for (const [name, pattern] of Object.entries(customPatterns)) {\n    const placeholder = `[${name}]`;\n    const patternStr = pattern instanceof RegExp ? pattern.source : pattern;\n    const marker = getMarker();\n    replacements.set(marker, `(${patternStr})`);\n    processed = processed.replaceAll(placeholder, marker);\n  }\n\n  // Escape special regex characters\n  let regex = escapeRegex(processed);\n\n  // Restore markers to their regex replacements\n  for (const [marker, replacement] of replacements) {\n    regex = regex.replaceAll(escapeRegex(marker), replacement);\n  }\n\n  // Match the entire string (dotall mode for . to match newlines if needed)\n  return new RegExp(`^${regex}$`, 's');\n}\n\n/**\n * Pre-process expected output to replace path placeholders with actual paths.\n * This happens BEFORE pattern matching.\n */\nfunction preprocessPaths(expected: string, context: { root: string; cwd: string }): string {\n  let result = expected;\n  // Normalize paths for comparison (use forward slashes)\n  const normalizedRoot = context.root.replace(/\\\\/g, '/');\n  const normalizedCwd = context.cwd.replace(/\\\\/g, '/');\n  result = result.replaceAll('[ROOT]', normalizedRoot);\n  result = result.replaceAll('[CWD]', normalizedCwd);\n  return result;\n}\n\n/**\n * Normalize actual output for comparison.\n * - Remove ANSI escape codes (colors, etc.)\n * - Normalize line endings to \\n\n * - Normalize paths (Windows backslashes to forward slashes)\n * - Trim trailing whitespace from lines\n * - Ensure single trailing newline\n */\nexport function normalizeOutput(output: string): string {\n  // Remove ANSI escape codes first\n  let normalized = stripAnsi(output);\n\n  normalized = normalized\n    .replace(/\\r\\n/g, '\\n')\n    .replace(/\\r/g, '\\n')\n    .split('\\n')\n    .map((line) => line.trimEnd())\n    .join('\\n')\n    .replace(/\\n+$/, '\\n');\n\n  // Handle empty output\n  if (normalized === '\\n') {\n    normalized = '';\n  }\n\n  return normalized;\n}\n\n/**\n * Check if actual output matches expected pattern.\n */\nexport function matchOutput(\n  actual: string,\n  expected: string,\n  context: { root: string; cwd: string },\n  customPatterns: Record<string, string | RegExp> = {},\n): boolean {\n  const normalizedActual = normalizeOutput(actual);\n  const normalizedExpected = normalizeOutput(expected);\n\n  // Empty expected matches empty actual\n  if (normalizedExpected === '' && normalizedActual === '') {\n    return true;\n  }\n\n  const preprocessed = preprocessPaths(normalizedExpected, context);\n  const regex = patternToRegex(preprocessed, customPatterns);\n  return regex.test(normalizedActual);\n}\n","// Public API exports\n\n// Version constant (injected at build time)\ndeclare const __VERSION__: string;\nexport const VERSION: string = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'development';\n\n// Config helper\nexport { defineConfig } from './lib/config.js';\nexport type { TryscriptConfig } from './lib/config.js';\n\n// Types\nexport type {\n  TestConfig,\n  TestBlock,\n  TestFile,\n  TestBlockResult,\n  TestFileResult,\n  TestRunSummary,\n} from './lib/types.js';\n\n// Core functions (for programmatic use)\nexport { parseTestFile } from './lib/parser.js';\nexport { runBlock, createExecutionContext, cleanupExecutionContext } from './lib/runner.js';\nexport type { ExecutionContext } from './lib/runner.js';\nexport { matchOutput, normalizeOutput } from './lib/matcher.js';\n"],"mappings":"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"}