tryscript 0.0.1

package/dist/src-UjaSQrqA.mjs

@@ -0,0 +1,328 @@
+
+import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { parse } from "yaml";
+import { spawn } from "node:child_process";
+import { mkdtemp, realpath, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import treeKill from "tree-kill";
+import stripAnsi from "strip-ansi";
+
+//#region src/lib/config.ts
+const CONFIG_FILES = [
+	"tryscript.config.ts",
+	"tryscript.config.js",
+	"tryscript.config.mjs"
+];
+/**
+* Load config file using dynamic import.
+* Supports both TypeScript (via tsx/ts-node) and JavaScript configs.
+*/
+async function loadConfig(baseDir) {
+	for (const filename of CONFIG_FILES) {
+		const configPath = resolve(baseDir, filename);
+		if (existsSync(configPath)) {
+			const module = await import(pathToFileURL(configPath).href);
+			return module.default ?? module;
+		}
+	}
+	return {};
+}
+/**
+* Merge config with frontmatter overrides.
+* Frontmatter takes precedence over config file.
+*/
+function mergeConfig(base, frontmatter) {
+	return {
+		...base,
+		...frontmatter,
+		env: {
+			...base.env,
+			...frontmatter.env
+		},
+		patterns: {
+			...base.patterns,
+			...frontmatter.patterns
+		}
+	};
+}
+/**
+* Helper for typed config files.
+*/
+function defineConfig(config) {
+	return config;
+}
+
+//#endregion
+//#region src/lib/parser.ts
+/** Regex to match YAML frontmatter at the start of a file */
+const FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/;
+/** Regex to match fenced code blocks with console/bash info string */
+const CODE_BLOCK_REGEX = /```(console|bash)\r?\n([\s\S]*?)```/g;
+/** Regex to match markdown headings (for test names) */
+const HEADING_REGEX = /^#+\s+(?:Test:\s*)?(.+)$/m;
+/**
+* Parse a .tryscript.md file into structured test data.
+*/
+function parseTestFile(content, filePath) {
+	const rawContent = content;
+	let config = {};
+	let body = content;
+	const frontmatterMatch = FRONTMATTER_REGEX.exec(content);
+	if (frontmatterMatch) {
+		config = parse(frontmatterMatch[1] ?? "");
+		body = content.slice(frontmatterMatch[0].length);
+	}
+	const blocks = [];
+	CODE_BLOCK_REGEX.lastIndex = 0;
+	let match;
+	while ((match = CODE_BLOCK_REGEX.exec(body)) !== null) {
+		const blockContent = match[2] ?? "";
+		const blockStart = match.index;
+		const lineNumber = content.slice(0, content.indexOf(match[0])).split("\n").length;
+		const name = [...body.slice(0, blockStart).matchAll(new RegExp(HEADING_REGEX.source, "gm"))].pop()?.[1]?.trim();
+		const parsed = parseBlockContent(blockContent);
+		if (parsed) blocks.push({
+			name,
+			command: parsed.command,
+			expectedOutput: parsed.expectedOutput,
+			expectedExitCode: parsed.expectedExitCode,
+			lineNumber,
+			rawContent: match[0]
+		});
+	}
+	return {
+		path: filePath,
+		config,
+		blocks,
+		rawContent
+	};
+}
+/**
+* Parse the content of a single console block.
+*/
+function parseBlockContent(content) {
+	const lines = content.split("\n");
+	const commandLines = [];
+	const outputLines = [];
+	let expectedExitCode = 0;
+	let inCommand = false;
+	for (const line of lines) if (line.startsWith("$ ")) {
+		inCommand = true;
+		commandLines.push(line.slice(2));
+	} else if (line.startsWith("> ") && inCommand) commandLines.push(line.slice(2));
+	else if (line.startsWith("? ")) {
+		inCommand = false;
+		expectedExitCode = parseInt(line.slice(2).trim(), 10);
+	} else {
+		inCommand = false;
+		outputLines.push(line);
+	}
+	if (commandLines.length === 0) return null;
+	let command = "";
+	for (let i = 0; i < commandLines.length; i++) {
+		const line = commandLines[i] ?? "";
+		if (line.endsWith("\\")) command += line.slice(0, -1) + " ";
+		else {
+			command += line;
+			if (i < commandLines.length - 1) command += " ";
+		}
+	}
+	let expectedOutput = outputLines.join("\n");
+	expectedOutput = expectedOutput.replace(/\n+$/, "");
+	if (expectedOutput) expectedOutput += "\n";
+	return {
+		command: command.trim(),
+		expectedOutput,
+		expectedExitCode
+	};
+}
+
+//#endregion
+//#region src/lib/runner.ts
+/** Default timeout in milliseconds */
+const DEFAULT_TIMEOUT = 3e4;
+/**
+* Create an execution context for a test file.
+*/
+async function createExecutionContext(config, testFilePath) {
+	const tempDir = await realpath(await mkdtemp(join(tmpdir(), "tryscript-")));
+	const testDir = resolve(dirname(testFilePath));
+	let binPath = config.bin ?? "";
+	if (binPath && !binPath.startsWith("/")) binPath = join(testDir, binPath);
+	return {
+		tempDir,
+		testDir,
+		binPath,
+		env: {
+			...process.env,
+			...config.env,
+			NO_COLOR: config.env?.NO_COLOR ?? "1",
+			FORCE_COLOR: "0",
+			TRYSCRIPT_TEST_DIR: testDir
+		},
+		timeout: config.timeout ?? DEFAULT_TIMEOUT
+	};
+}
+/**
+* Clean up execution context (remove temp directory).
+*/
+async function cleanupExecutionContext(ctx) {
+	await rm(ctx.tempDir, {
+		recursive: true,
+		force: true
+	});
+}
+/**
+* Run a single test block and return the result.
+*/
+async function runBlock(block, ctx) {
+	const startTime = Date.now();
+	try {
+		const { output, exitCode } = await executeCommand(block.command, ctx);
+		return {
+			block,
+			passed: true,
+			actualOutput: output,
+			actualExitCode: exitCode,
+			duration: Date.now() - startTime
+		};
+	} catch (error) {
+		return {
+			block,
+			passed: false,
+			actualOutput: "",
+			actualExitCode: -1,
+			duration: Date.now() - startTime,
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Execute a command and capture output.
+*/
+async function executeCommand(command, ctx) {
+	return new Promise((resolve$1, reject) => {
+		const proc = spawn(command, {
+			shell: true,
+			cwd: ctx.tempDir,
+			env: ctx.env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		const chunks = [];
+		proc.stdout.on("data", (data) => chunks.push(data));
+		proc.stderr.on("data", (data) => chunks.push(data));
+		const timeoutId = setTimeout(() => {
+			if (proc.pid) treeKill(proc.pid, "SIGKILL");
+			reject(/* @__PURE__ */ new Error(`Command timed out after ${ctx.timeout}ms`));
+		}, ctx.timeout);
+		proc.on("close", (code) => {
+			clearTimeout(timeoutId);
+			resolve$1({
+				output: Buffer.concat(chunks).toString("utf-8"),
+				exitCode: code ?? 0
+			});
+		});
+		proc.on("error", (err) => {
+			clearTimeout(timeoutId);
+			reject(err);
+		});
+	});
+}
+
+//#endregion
+//#region src/lib/matcher.ts
+/**
+* Escape special regex characters in a string.
+*/
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const MARKER = "";
+/**
+* Convert expected output with elision patterns to a regex.
+*
+* Handles (matching trycmd):
+* - [..] — matches any characters on the same line (trycmd: [^\n]*?)
+* - ... — matches zero or more complete lines (trycmd: \n(([^\n]*\n)*)?)
+* - [EXE] — matches .exe on Windows, empty otherwise
+* - [ROOT] — replaced with test root directory (pre-processed)
+* - [CWD] — replaced with current working directory (pre-processed)
+* - Custom [NAME] patterns from config (trycmd: TestCases::insert_var)
+*/
+function patternToRegex(expected, customPatterns = {}) {
+	const replacements = /* @__PURE__ */ new Map();
+	let markerIndex = 0;
+	const getMarker = () => {
+		return `${MARKER}${markerIndex++}${MARKER}`;
+	};
+	let processed = expected;
+	const dotdotMarker = getMarker();
+	replacements.set(dotdotMarker, "[^\\n]*");
+	processed = processed.replaceAll("[..]", dotdotMarker);
+	const ellipsisMarker = getMarker();
+	replacements.set(ellipsisMarker, "(?:[^\\n]*\\n)*");
+	processed = processed.replace(/\.\.\.\n/g, ellipsisMarker);
+	const exeMarker = getMarker();
+	const exe = process.platform === "win32" ? "\\.exe" : "";
+	replacements.set(exeMarker, exe);
+	processed = processed.replaceAll("[EXE]", exeMarker);
+	for (const [name, pattern] of Object.entries(customPatterns)) {
+		const placeholder = `[${name}]`;
+		const patternStr = pattern instanceof RegExp ? pattern.source : pattern;
+		const marker = getMarker();
+		replacements.set(marker, `(${patternStr})`);
+		processed = processed.replaceAll(placeholder, marker);
+	}
+	let regex = escapeRegex(processed);
+	for (const [marker, replacement] of replacements) regex = regex.replaceAll(escapeRegex(marker), replacement);
+	return new RegExp(`^${regex}$`, "s");
+}
+/**
+* Pre-process expected output to replace path placeholders with actual paths.
+* This happens BEFORE pattern matching.
+*/
+function preprocessPaths(expected, context) {
+	let result = expected;
+	const normalizedRoot = context.root.replace(/\\/g, "/");
+	const normalizedCwd = context.cwd.replace(/\\/g, "/");
+	result = result.replaceAll("[ROOT]", normalizedRoot);
+	result = result.replaceAll("[CWD]", normalizedCwd);
+	return result;
+}
+/**
+* Normalize actual output for comparison.
+* - Remove ANSI escape codes (colors, etc.)
+* - Normalize line endings to \n
+* - Normalize paths (Windows backslashes to forward slashes)
+* - Trim trailing whitespace from lines
+* - Ensure single trailing newline
+*/
+function normalizeOutput(output) {
+	let normalized = stripAnsi(output);
+	normalized = normalized.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n").map((line) => line.trimEnd()).join("\n").replace(/\n+$/, "\n");
+	if (normalized === "\n") normalized = "";
+	return normalized;
+}
+/**
+* Check if actual output matches expected pattern.
+*/
+function matchOutput(actual, expected, context, customPatterns = {}) {
+	const normalizedActual = normalizeOutput(actual);
+	const normalizedExpected = normalizeOutput(expected);
+	if (normalizedExpected === "" && normalizedActual === "") return true;
+	return patternToRegex(preprocessPaths(normalizedExpected, context), customPatterns).test(normalizedActual);
+}
+
+//#endregion
+//#region src/index.ts
+const VERSION = "0.0.1";
+
+//#endregion
+export { createExecutionContext as a, defineConfig as c, cleanupExecutionContext as i, loadConfig as l, matchOutput as n, runBlock as o, normalizeOutput as r, parseTestFile as s, VERSION as t, mergeConfig as u };
+//# sourceMappingURL=src-UjaSQrqA.mjs.map

package/dist/src-UjaSQrqA.mjs.map

@@ -0,0 +1 @@
+{"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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"}

package/docs/tryscript-reference.md

@@ -0,0 +1,163 @@
+# tryscript Quick Reference
+
+Concise syntax reference for writing tryscript test files.
+
+## Test File Format
+
+Test files use `.tryscript.md` extension. Each file contains Markdown with console code blocks:
+
+```markdown
+# Test: Description
+
+\`\`\`console
+$ command
+expected output
+? exit_code
+\`\`\`
+```
+
+## Basic Example
+
+```markdown
+# Test: Echo command
+
+\`\`\`console
+$ echo "hello world"
+hello world
+? 0
+\`\`\`
+```
+
+## Exit Codes
+
+Use `? N` to specify expected exit code:
+
+```console
+$ exit 42
+? 42
+```
+
+## 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`      |
+
+## YAML Frontmatter
+
+Configure test behavior at the top of the file:
+
+```yaml
+---
+bin: ./my-cli
+env:
+  NO_COLOR: "1"
+timeout: 5000
+patterns:
+  VERSION: "\\d+\\.\\d+\\.\\d+"
+---
+```
+
+### Config Options
+
+| 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]`    |
+
+## Custom Patterns
+
+Define reusable patterns in frontmatter:
+
+```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}"
+```
+
+Use in output:
+
+```console
+$ my-cli --version
+my-cli version [VERSION]
+? 0
+```
+
+## Multiple Commands
+
+Multiple tests per file, each with its own heading:
+
+```markdown
+# Test: First test
+
+\`\`\`console
+$ echo one
+one
+? 0
+\`\`\`
+
+# Test: Second test
+
+\`\`\`console
+$ echo two
+two
+? 0
+\`\`\`
+```
+
+## CLI Usage
+
+```bash
+# Run all tests
+npx tryscript
+
+# Run specific files
+npx tryscript tests/foo.tryscript.md
+
+# Update golden files
+npx tryscript --update
+
+# Filter tests by name
+npx tryscript --filter "pattern"
+
+# Fail fast on first error
+npx tryscript --fail-fast
+
+# Verbose output
+npx tryscript --verbose
+```
+
+## Options
+
+| 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            |
+
+## Config File
+
+Create `tryscript.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from 'tryscript';
+
+export default defineConfig({
+  bin: './dist/cli.js',
+  env: { NO_COLOR: '1' },
+  timeout: 30000,
+  patterns: {
+    VERSION: '\\d+\\.\\d+\\.\\d+',
+  },
+});
+```

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "tryscript",
+  "version": "0.0.1",
+  "description": "Golden testing for CLI applications - TypeScript port of trycmd",
+  "license": "MIT",
+  "author": "Joshua Levy",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jlevy/tryscript.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "tryscript": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "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",
+    "diff": "^8.0.0",
+    "fast-glob": "^3.3.0",
+    "picocolors": "^1.1.0",
+    "strip-ansi": "^7.1.0",
+    "tree-kill": "^1.2.0",
+    "yaml": "^2.6.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.0.0",
+    "c8": "^10.1.3",
+    "publint": "^0.3.0",
+    "tsdown": "^0.18.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0"
+  }
+}