tryscript 0.1.6 → 0.1.7

package/dist/index.d.mts

@@ -202,6 +202,42 @@ interface CoverageContext {
     mergeLcov?: string;
   };
 }
+/**
+ * Categories of wildcards, forming a hierarchy for expansion flags.
+ *
+ * - `unknown`: `???` (multi-line) and `[??]` (single-line) — temporary scaffolding
+ * - `generic`: `...` (multi-line) and `[..]` (single-line) — intentional omission
+ * - `named`: `[HASH]`, `[CWD]`, etc. — typed dynamic values
+ */
+type WildcardCategory = 'unknown' | 'generic' | 'named';
+/**
+ * Which wildcards each `--expand*` flag targets.
+ *
+ * - `unknown`: only `???` and `[??]`
+ * - `generic`: unknown + `...` and `[..]`
+ * - `all`: everything including named patterns
+ */
+type ExpandLevel = 'unknown' | 'generic' | 'all';
+/**
+ * A single wildcard capture from matching actual output against expected pattern.
+ */
+interface WildcardCapture {
+  category: WildcardCategory;
+  /** For named patterns, the pattern name (e.g., 'HASH') */
+  name?: string;
+  /** True for multi-line wildcards (`...`/`???`), false for single-line (`[..]`/`[??]`) */
+  multiline: boolean;
+  /** The actual text that the wildcard matched */
+  captured: string;
+}
+/**
+ * Result of expanding wildcards in expected output.
+ */
+interface ExpansionResult {
+  expandedOutput: string;
+  captures: WildcardCapture[];
+  expandedCount: number;
+}
 //#endregion
 //#region src/lib/config.d.ts
 /** Fixture configuration for copying files to sandbox directory */
@@ -304,9 +340,112 @@ declare function matchOutput(actual: string, expected: string, context: {
   root: string;
   cwd: string;
 }, customPatterns?: Record<string, string | RegExp>): boolean;
+/**
+ * Match actual output against expected pattern and return wildcard captures.
+ * Returns `null` if the output does not match.
+ */
+declare function matchAndCapture(actual: string, expected: string, context: {
+  root: string;
+  cwd: string;
+}, customPatterns?: Record<string, string | RegExp>): {
+  captures: WildcardCapture[];
+} | null;
+//#endregion
+//#region src/lib/expander.d.ts
+/**
+ * Whether a wildcard category should be expanded at the given level.
+ *
+ * The hierarchy is: unknown < generic < all.
+ */
+declare function shouldExpandCategory(category: WildcardCategory, level: ExpandLevel): boolean;
+/**
+ * Expand wildcards in expected output by replacing them with captured actual text.
+ *
+ * Only wildcards whose category is targeted by `level` are replaced; others are
+ * left intact. Returns `null` if actual output doesn't match expected pattern.
+ */
+declare function expandExpectedOutput(expected: string, actual: string, context: {
+  root: string;
+  cwd: string;
+}, level: ExpandLevel, customPatterns?: Record<string, string | RegExp>): ExpansionResult | null;
+/**
+ * Expand wildcards in a test file in place.
+ *
+ * Uses the same reverse-order strategy as `updater.ts` to maintain correct
+ * string offsets when modifying multiple blocks.
+ */
+declare function expandTestFile(file: TestFile, results: TestBlockResult[], level: ExpandLevel, context: {
+  root: string;
+  cwd: string;
+}, customPatterns?: Record<string, string | RegExp>): Promise<{
+  expanded: boolean;
+  expandedCount: number;
+  changes: string[];
+}>;
+//#endregion
+//#region src/lib/capture-log.d.ts
+interface CaptureLogBlock {
+  name: string | undefined;
+  command: string;
+  expected_exit_code: number;
+  actual_exit_code: number;
+  expected_output: string;
+  actual_output: string;
+  captures: {
+    category: string;
+    name?: string;
+    multiline: boolean;
+    matched: string;
+  }[];
+  passed: boolean;
+}
+interface CaptureLogFile {
+  path: string;
+  blocks: CaptureLogBlock[];
+}
+interface CaptureLogDoc {
+  generated: string;
+  files: CaptureLogFile[];
+}
+/**
+ * Build the capture log document structure from test results.
+ *
+ * `customPatterns` can be a static object or a per-file callback.
+ * Separated from `writeCaptureLog` for testability.
+ */
+declare function buildCaptureLogDoc(fileResults: TestFileResult[], matchContext: (file: TestFile) => {
+  root: string;
+  cwd: string;
+}, customPatterns?: Record<string, string | RegExp> | ((file: TestFile) => Record<string, string | RegExp>)): CaptureLogDoc;
+/**
+ * Write a YAML capture log file recording wildcard captures and execution metadata.
+ */
+declare function writeCaptureLog(path: string, fileResults: TestFileResult[], matchContext: (file: TestFile) => {
+  root: string;
+  cwd: string;
+}, customPatterns?: Record<string, string | RegExp> | ((file: TestFile) => Record<string, string | RegExp>)): Promise<void>;
+//#endregion
+//#region src/lib/yaml-utils.d.ts
+/**
+ * Manual key order comparator for YAML `sortMapEntries`.
+ *
+ * Keys listed in `order` appear first (in that order); unlisted keys sort
+ * to the end alphabetically. Adapted from tbd sorting patterns
+ * (`ordering.manual`).
+ */
+declare function manualKeyOrder(order: readonly string[]): (a: {
+  key: {
+    value: string;
+  };
+}, b: {
+  key: {
+    value: string;
+  };
+}) => number;
+declare function stringifyYaml(data: unknown, options?: object): string;
 //#endregion
 //#region src/index.d.ts
 declare const VERSION: string;
 //#endregion
-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 };
+export { type CoverageConfig, type CoverageContext, type ExecutionContext, type ExpandLevel, type ExpansionResult, type TestBlock, type TestBlockResult, type TestConfig, type TestFile, type TestFileResult, type TestRunSummary, type TryscriptConfig, VERSION, type WildcardCapture, type WildcardCategory, buildCaptureLogDoc, cleanupExecutionContext, createExecutionContext, defineConfig, expandExpectedOutput, expandTestFile, manualKeyOrder, matchAndCapture, matchOutput, normalizeOutput, parseTestFile, runBlock, shouldExpandCategory, stringifyYaml, writeCaptureLog };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
 
-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-Bd9-Y0qp.mjs";
+import { _ as defineConfig, a as stringifyYaml, c as shouldExpandCategory, d as normalizeOutput, f as cleanupExecutionContext, g as parseTestFile, h as runBlock, i as manualKeyOrder, l as matchAndCapture, n as buildCaptureLogDoc, o as expandExpectedOutput, p as createExecutionContext, r as writeCaptureLog, s as expandTestFile, t as VERSION, u as matchOutput } from "./src-BQxIhzgF.mjs";
 
-export { VERSION, cleanupExecutionContext, createExecutionContext, defineConfig, matchOutput, normalizeOutput, parseTestFile, runBlock };
+export { VERSION, buildCaptureLogDoc, cleanupExecutionContext, createExecutionContext, defineConfig, expandExpectedOutput, expandTestFile, manualKeyOrder, matchAndCapture, matchOutput, normalizeOutput, parseTestFile, runBlock, shouldExpandCategory, stringifyYaml, writeCaptureLog };