tryscript 0.0.1 → 0.1.1

package/dist/index.d.cts

@@ -2,20 +2,48 @@
 import { z } from "zod";
 
 //#region src/lib/types.d.ts
+
 declare const TestConfigSchema: z.ZodObject<{
-  bin: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  sandbox: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+  fixtures: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    source: z.ZodString;
+    dest: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    source: string;
+    dest?: string | undefined;
+  }, {
+    source: string;
+    dest?: string | undefined;
+  }>]>, "many">>;
+  before: z.ZodOptional<z.ZodString>;
+  after: z.ZodOptional<z.ZodString>;
   env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   timeout: z.ZodOptional<z.ZodNumber>;
   patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>]>>>;
   tests: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-  bin?: string | undefined;
+  cwd?: string | undefined;
+  sandbox?: string | boolean | undefined;
+  fixtures?: (string | {
+    source: string;
+    dest?: string | undefined;
+  })[] | undefined;
+  before?: string | undefined;
+  after?: string | undefined;
   env?: Record<string, string> | undefined;
   timeout?: number | undefined;
   patterns?: Record<string, string | RegExp> | undefined;
   tests?: string[] | undefined;
 }, {
-  bin?: string | undefined;
+  cwd?: string | undefined;
+  sandbox?: string | boolean | undefined;
+  fixtures?: (string | {
+    source: string;
+    dest?: string | undefined;
+  })[] | undefined;
+  before?: string | undefined;
+  after?: string | undefined;
   env?: Record<string, string> | undefined;
   timeout?: number | undefined;
   patterns?: Record<string, string | RegExp> | undefined;
@@ -35,12 +63,18 @@ interface TestBlock {
   command: string;
   /** Expected output (may include elision patterns) */
   expectedOutput: string;
+  /** Expected stderr output (lines starting with ! in expected output) */
+  expectedStderr?: string;
   /** Expected exit code (default: 0) */
   expectedExitCode: number;
   /** Line number where this block starts (1-indexed, for error reporting) */
   lineNumber: number;
   /** Raw content of the block for update mode */
   rawContent: string;
+  /** Skip this test (from <!-- skip --> annotation) */
+  skip?: boolean;
+  /** Run only this test (from <!-- only --> annotation) */
+  only?: boolean;
 }
 /**
  * A parsed test file with all its blocks.
@@ -62,6 +96,10 @@ interface TestBlockResult {
   block: TestBlock;
   passed: boolean;
   actualOutput: string;
+  /** Separate stdout (when stderr is captured separately) */
+  actualStdout?: string;
+  /** Separate stderr (when stderr is captured separately) */
+  actualStderr?: string;
   actualExitCode: number;
   /** Diff if test failed (unified diff format) */
   diff?: string;
@@ -69,6 +107,8 @@ interface TestBlockResult {
   duration: number;
   /** Error message if execution failed */
   error?: string;
+  /** Test was skipped */
+  skipped?: boolean;
 }
 /**
  * Result of running all blocks in a test file.
@@ -90,14 +130,68 @@ interface TestRunSummary {
   totalBlocks: number;
   duration: number;
 }
+/**
+ * Schema for coverage configuration.
+ */
+declare const CoverageConfigSchema: z.ZodObject<{
+  /** Output directory for coverage reports (default: 'coverage-tryscript') */
+  reportsDir: z.ZodOptional<z.ZodString>;
+  /** Coverage reporters to use (default: ['text', 'html']) */
+  reporters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+  /** File patterns to include in coverage (default: ['dist/**']) */
+  include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+  /** Source directory for sourcemap mapping (default: 'src') */
+  src: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  reportsDir?: string | undefined;
+  reporters?: string[] | undefined;
+  include?: string[] | undefined;
+  src?: string | undefined;
+}, {
+  reportsDir?: string | undefined;
+  reporters?: string[] | undefined;
+  include?: string[] | undefined;
+  src?: string | undefined;
+}>;
+/**
+ * Coverage configuration options.
+ */
+type CoverageConfig = z.infer<typeof CoverageConfigSchema>;
+/**
+ * Runtime context for coverage collection during test execution.
+ */
+interface CoverageContext {
+  /** Temporary directory for V8 coverage data files */
+  tempDir: string;
+  /** Resolved coverage options with defaults applied */
+  options: Required<CoverageConfig>;
+}
 //#endregion
 //#region src/lib/config.d.ts
+/** Fixture configuration for copying files to sandbox directory */
+interface Fixture {
+  /** Source path (resolved relative to test file) */
+  source: string;
+  /** Destination path (resolved relative to sandbox dir) */
+  dest?: string;
+}
 interface TryscriptConfig {
-  bin?: string;
+  /** Working directory for commands (default: test file directory) */
+  cwd?: string;
+  /** Run in isolated sandbox: true = empty temp, path = copy to temp */
+  sandbox?: boolean | string;
+  /** Fixtures to copy to sandbox directory before tests */
+  fixtures?: (string | Fixture)[];
+  /** Script to run before first test block */
+  before?: string;
+  /** Script to run after all test blocks */
+  after?: string;
   env?: Record<string, string>;
   timeout?: number;
   patterns?: Record<string, RegExp | string>;
   tests?: string[];
+  /** Coverage configuration (used with --coverage flag) */
+  coverage?: CoverageConfig;
 }
 /**
  * Helper for typed config files.
@@ -113,24 +207,35 @@ declare function parseTestFile(content: string, filePath: string): TestFile;
 //#region src/lib/runner.d.ts
 /**
  * Execution context for a test file.
- * Created once per file, contains the temp directory.
+ * Created once per file, contains directory paths and config.
  */
 interface ExecutionContext {
   /** Temporary directory for this test file (resolved, no symlinks) */
   tempDir: string;
-  /** Directory containing the test file (for portable test commands) */
+  /** Directory containing the test file */
   testDir: string;
-  /** Resolved binary path */
-  binPath: string;
+  /** Working directory for command execution */
+  cwd: string;
+  /** Whether running in sandbox mode */
+  sandbox: boolean;
   /** Environment variables */
   env: Record<string, string>;
   /** Timeout per command */
   timeout: number;
+  /** Before hook script */
+  before?: string;
+  /** After hook script */
+  after?: string;
+  /** Whether before hook has been run */
+  beforeRan?: boolean;
 }
 /**
  * Create an execution context for a test file.
+ * @param config - Test configuration
+ * @param testFilePath - Path to the test file
+ * @param coverageEnv - Optional coverage environment variables (e.g., NODE_V8_COVERAGE)
  */
-declare function createExecutionContext(config: TryscriptConfig, testFilePath: string): Promise<ExecutionContext>;
+declare function createExecutionContext(config: TryscriptConfig, testFilePath: string, coverageEnv?: Record<string, string>): Promise<ExecutionContext>;
 /**
  * Clean up execution context (remove temp directory).
  */
@@ -161,5 +266,5 @@ declare function matchOutput(actual: string, expected: string, context: {
 //#region src/index.d.ts
 declare const VERSION: string;
 //#endregion
-export { type ExecutionContext, type TestBlock, type TestBlockResult, type TestConfig, type TestFile, type TestFileResult, type TestRunSummary, type TryscriptConfig, VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };
+export { type CoverageConfig, type CoverageContext, type ExecutionContext, type TestBlock, type TestBlockResult, type TestConfig, type TestFile, type TestFileResult, type TestRunSummary, type TryscriptConfig, VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -2,20 +2,48 @@
 import { z } from "zod";
 
 //#region src/lib/types.d.ts
+
 declare const TestConfigSchema: z.ZodObject<{
-  bin: z.ZodOptional<z.ZodString>;
+  cwd: z.ZodOptional<z.ZodString>;
+  sandbox: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+  fixtures: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    source: z.ZodString;
+    dest: z.ZodOptional<z.ZodString>;
+  }, "strip", z.ZodTypeAny, {
+    source: string;
+    dest?: string | undefined;
+  }, {
+    source: string;
+    dest?: string | undefined;
+  }>]>, "many">>;
+  before: z.ZodOptional<z.ZodString>;
+  after: z.ZodOptional<z.ZodString>;
   env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   timeout: z.ZodOptional<z.ZodNumber>;
   patterns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodType<RegExp, z.ZodTypeDef, RegExp>]>>>;
   tests: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-  bin?: string | undefined;
+  cwd?: string | undefined;
+  sandbox?: string | boolean | undefined;
+  fixtures?: (string | {
+    source: string;
+    dest?: string | undefined;
+  })[] | undefined;
+  before?: string | undefined;
+  after?: string | undefined;
   env?: Record<string, string> | undefined;
   timeout?: number | undefined;
   patterns?: Record<string, string | RegExp> | undefined;
   tests?: string[] | undefined;
 }, {
-  bin?: string | undefined;
+  cwd?: string | undefined;
+  sandbox?: string | boolean | undefined;
+  fixtures?: (string | {
+    source: string;
+    dest?: string | undefined;
+  })[] | undefined;
+  before?: string | undefined;
+  after?: string | undefined;
   env?: Record<string, string> | undefined;
   timeout?: number | undefined;
   patterns?: Record<string, string | RegExp> | undefined;
@@ -35,12 +63,18 @@ interface TestBlock {
   command: string;
   /** Expected output (may include elision patterns) */
   expectedOutput: string;
+  /** Expected stderr output (lines starting with ! in expected output) */
+  expectedStderr?: string;
   /** Expected exit code (default: 0) */
   expectedExitCode: number;
   /** Line number where this block starts (1-indexed, for error reporting) */
   lineNumber: number;
   /** Raw content of the block for update mode */
   rawContent: string;
+  /** Skip this test (from <!-- skip --> annotation) */
+  skip?: boolean;
+  /** Run only this test (from <!-- only --> annotation) */
+  only?: boolean;
 }
 /**
  * A parsed test file with all its blocks.
@@ -62,6 +96,10 @@ interface TestBlockResult {
   block: TestBlock;
   passed: boolean;
   actualOutput: string;
+  /** Separate stdout (when stderr is captured separately) */
+  actualStdout?: string;
+  /** Separate stderr (when stderr is captured separately) */
+  actualStderr?: string;
   actualExitCode: number;
   /** Diff if test failed (unified diff format) */
   diff?: string;
@@ -69,6 +107,8 @@ interface TestBlockResult {
   duration: number;
   /** Error message if execution failed */
   error?: string;
+  /** Test was skipped */
+  skipped?: boolean;
 }
 /**
  * Result of running all blocks in a test file.
@@ -90,14 +130,68 @@ interface TestRunSummary {
   totalBlocks: number;
   duration: number;
 }
+/**
+ * Schema for coverage configuration.
+ */
+declare const CoverageConfigSchema: z.ZodObject<{
+  /** Output directory for coverage reports (default: 'coverage-tryscript') */
+  reportsDir: z.ZodOptional<z.ZodString>;
+  /** Coverage reporters to use (default: ['text', 'html']) */
+  reporters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+  /** File patterns to include in coverage (default: ['dist/**']) */
+  include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+  /** Source directory for sourcemap mapping (default: 'src') */
+  src: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  reportsDir?: string | undefined;
+  reporters?: string[] | undefined;
+  include?: string[] | undefined;
+  src?: string | undefined;
+}, {
+  reportsDir?: string | undefined;
+  reporters?: string[] | undefined;
+  include?: string[] | undefined;
+  src?: string | undefined;
+}>;
+/**
+ * Coverage configuration options.
+ */
+type CoverageConfig = z.infer<typeof CoverageConfigSchema>;
+/**
+ * Runtime context for coverage collection during test execution.
+ */
+interface CoverageContext {
+  /** Temporary directory for V8 coverage data files */
+  tempDir: string;
+  /** Resolved coverage options with defaults applied */
+  options: Required<CoverageConfig>;
+}
 //#endregion
 //#region src/lib/config.d.ts
+/** Fixture configuration for copying files to sandbox directory */
+interface Fixture {
+  /** Source path (resolved relative to test file) */
+  source: string;
+  /** Destination path (resolved relative to sandbox dir) */
+  dest?: string;
+}
 interface TryscriptConfig {
-  bin?: string;
+  /** Working directory for commands (default: test file directory) */
+  cwd?: string;
+  /** Run in isolated sandbox: true = empty temp, path = copy to temp */
+  sandbox?: boolean | string;
+  /** Fixtures to copy to sandbox directory before tests */
+  fixtures?: (string | Fixture)[];
+  /** Script to run before first test block */
+  before?: string;
+  /** Script to run after all test blocks */
+  after?: string;
   env?: Record<string, string>;
   timeout?: number;
   patterns?: Record<string, RegExp | string>;
   tests?: string[];
+  /** Coverage configuration (used with --coverage flag) */
+  coverage?: CoverageConfig;
 }
 /**
  * Helper for typed config files.
@@ -113,24 +207,35 @@ declare function parseTestFile(content: string, filePath: string): TestFile;
 //#region src/lib/runner.d.ts
 /**
  * Execution context for a test file.
- * Created once per file, contains the temp directory.
+ * Created once per file, contains directory paths and config.
  */
 interface ExecutionContext {
   /** Temporary directory for this test file (resolved, no symlinks) */
   tempDir: string;
-  /** Directory containing the test file (for portable test commands) */
+  /** Directory containing the test file */
   testDir: string;
-  /** Resolved binary path */
-  binPath: string;
+  /** Working directory for command execution */
+  cwd: string;
+  /** Whether running in sandbox mode */
+  sandbox: boolean;
   /** Environment variables */
   env: Record<string, string>;
   /** Timeout per command */
   timeout: number;
+  /** Before hook script */
+  before?: string;
+  /** After hook script */
+  after?: string;
+  /** Whether before hook has been run */
+  beforeRan?: boolean;
 }
 /**
  * Create an execution context for a test file.
+ * @param config - Test configuration
+ * @param testFilePath - Path to the test file
+ * @param coverageEnv - Optional coverage environment variables (e.g., NODE_V8_COVERAGE)
  */
-declare function createExecutionContext(config: TryscriptConfig, testFilePath: string): Promise<ExecutionContext>;
+declare function createExecutionContext(config: TryscriptConfig, testFilePath: string, coverageEnv?: Record<string, string>): Promise<ExecutionContext>;
 /**
  * Clean up execution context (remove temp directory).
  */
@@ -161,5 +266,5 @@ declare function matchOutput(actual: string, expected: string, context: {
 //#region src/index.d.ts
 declare const VERSION: string;
 //#endregion
-export { type ExecutionContext, type TestBlock, type TestBlockResult, type TestConfig, type TestFile, type TestFileResult, type TestRunSummary, type TryscriptConfig, VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };
+export { type CoverageConfig, type CoverageContext, type ExecutionContext, type TestBlock, type TestBlockResult, type TestConfig, type TestFile, type TestFileResult, type TestRunSummary, type TryscriptConfig, VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
 
-import { a as createExecutionContext, c as defineConfig, i as cleanupExecutionContext, n as matchOutput, o as runBlock, r as normalizeOutput, s as parseTestFile, t as VERSION } from "./src-UjaSQrqA.mjs";
+import { a as createExecutionContext, c as parseTestFile, i as cleanupExecutionContext, l as defineConfig, n as matchOutput, r as normalizeOutput, s as runBlock, t as VERSION } from "./src-CndHSuTT.mjs";
 
 export { VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };