@overkill-dev/run 0.0.1 → 0.0.2

package/engine/reporter.d.ts

@@ -0,0 +1,103 @@
+import type { WallClock } from '@enormora/wall-clock';
+import type { CaseId } from './identity.ts';
+import type { RunResult, RunnerError, TestOutcome } from './run-result.ts';
+export type RunFacts = Readonly<Record<string, unknown>>;
+export type StandardOutputSinkDeclaration = {
+    readonly conflictPolicy: 'exclusive' | 'shared';
+    readonly kind: 'stderr' | 'stdout';
+};
+export type FileSinkDeclaration = {
+    readonly conflictPolicy: 'exclusive';
+    readonly kind: 'file';
+    readonly path: string;
+};
+export type DirectorySinkDeclaration = {
+    readonly conflictPolicy: 'exclusive';
+    readonly kind: 'directory';
+    readonly path: string;
+};
+export type MemorySinkDeclaration = {
+    readonly conflictPolicy: 'shared';
+    readonly kind: 'memory';
+};
+export type StreamSinkDeclaration = {
+    readonly conflictPolicy: 'exclusive';
+    readonly kind: 'stream';
+    readonly provided: WritableStream<unknown>;
+};
+type FileSystemSinkDeclaration = DirectorySinkDeclaration | FileSinkDeclaration;
+type PrivateSinkDeclaration = MemorySinkDeclaration | StreamSinkDeclaration;
+type ReporterSinkDeclaration = FileSystemSinkDeclaration | StandardOutputSinkDeclaration;
+export type SinkDeclaration = PrivateSinkDeclaration | ReporterSinkDeclaration;
+type RunStartReporterEvent = {
+    readonly facts: RunFacts;
+    readonly kind: 'run-start';
+    readonly startedAt: string;
+};
+type RunEndReporterEvent = {
+    readonly kind: 'run-end';
+    readonly result: RunResult;
+};
+type RunnerErrorReporterEvent = {
+    readonly error: RunnerError;
+    readonly kind: 'runner-error';
+};
+type SuiteStartReporterEvent = {
+    readonly kind: 'suite-start';
+    readonly suitePath: readonly string[];
+};
+type SuiteEndReporterEvent = {
+    readonly kind: 'suite-end';
+    readonly suitePath: readonly string[];
+};
+type TestStartReporterEvent = {
+    readonly attempt: number;
+    readonly case: CaseId;
+    readonly kind: 'test-start';
+};
+type TestProgressReporterEvent = {
+    readonly attempt: number;
+    readonly case: CaseId;
+    readonly kind: 'test-progress';
+    readonly note: string;
+};
+type TestEndReporterEvent = {
+    readonly attempt: number;
+    readonly case: CaseId;
+    readonly kind: 'test-end';
+    readonly outcome: TestOutcome;
+    readonly verdict: TestOutcome['kind'];
+    readonly wallTimeMs: number;
+};
+type RunReporterEvent = RunEndReporterEvent | RunnerErrorReporterEvent | RunStartReporterEvent;
+type SuiteReporterEvent = SuiteEndReporterEvent | SuiteStartReporterEvent;
+type TestReporterEvent = TestEndReporterEvent | TestProgressReporterEvent | TestStartReporterEvent;
+export type ReporterEvent = RunReporterEvent | SuiteReporterEvent | TestReporterEvent;
+export type RealTimeReporter = {
+    readonly dispose: (() => Promise<void> | void) | null;
+    readonly kind: 'real-time';
+    readonly name: string;
+    readonly sinks: readonly SinkDeclaration[];
+    readonly onEvent: (event: ReporterEvent) => Promise<void> | void;
+    readonly onFinish: ((result: RunResult) => Promise<void> | void) | null;
+};
+export type FinalResultReporter = {
+    readonly dispose: (() => Promise<void> | void) | null;
+    readonly kind: 'final-result';
+    readonly name: string;
+    readonly sinks: readonly SinkDeclaration[];
+    readonly onResult: (result: RunResult) => Promise<void> | void;
+};
+export type Reporter = FinalResultReporter | RealTimeReporter;
+export type ReporterDispatcher = {
+    readonly disposeReporters: (reporters: readonly Reporter[]) => Promise<readonly RunnerError[]>;
+    readonly reportEvent: (reporters: readonly Reporter[], event: ReporterEvent) => Promise<readonly RunnerError[]>;
+    readonly reportResult: (reporters: readonly Reporter[], result: RunResult) => Promise<readonly RunnerError[]>;
+};
+export type ReporterDispatcherDependencies = {
+    readonly wallClock: WallClock;
+};
+export declare function validateReporterSinks(reporters: readonly Reporter[]): void;
+export declare function createReporterDispatcher(dependencies: ReporterDispatcherDependencies): ReporterDispatcher;
+export {};
+//# sourceMappingURL=reporter.d.ts.map

package/engine/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../../source/engine/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE3E,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzD,MAAM,MAAM,6BAA6B,GAAG;IACxC,QAAQ,CAAC,cAAc,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CAC9C,CAAC;AAEF,KAAK,yBAAyB,GAAG,wBAAwB,GAAG,mBAAmB,CAAC;AAChF,KAAK,sBAAsB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAC5E,KAAK,uBAAuB,GAAG,yBAAyB,GAAG,6BAA6B,CAAC;AAEzF,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAE/E,KAAK,qBAAqB,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,gBAAgB,GAAG,mBAAmB,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;AAC/F,KAAK,kBAAkB,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAC1E,KAAK,iBAAiB,GAAG,oBAAoB,GAAG,yBAAyB,GAAG,sBAAsB,CAAC;AAEnG,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,CACvB,SAAS,EAAE,SAAS,QAAQ,EAAE,KAC7B,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,CAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,KAAK,EAAE,aAAa,KACnB,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,CACnB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,MAAM,EAAE,SAAS,KAChB,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC,CAAC;AA8EF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAQ1E;AAqBD,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,8BAA8B,GAAG,kBAAkB,CAmLzG"}

package/engine/require-assertion-facade.d.ts

@@ -0,0 +1,21 @@
+import type { NarrowingCompositeAssertionReference } from '../packages/engine/assertion-protocol.entry-point.ts';
+import type { AssertionOptions, InstanceConstructor, ResolvableSourceLocation } from '../assertion-protocol/assertion-node-shape.ts';
+import { type RequireAssertionSink } from './custom-assertion-recording.ts';
+export type RequireAssertionFacade = {
+    <Actual, Narrowed extends Actual, Arguments extends readonly unknown[]>(reference: NarrowingCompositeAssertionReference<Actual, Narrowed, Arguments>, actual: Actual, ...parameters: Arguments): asserts actual is Narrowed;
+    readonly annotated: (message: string) => RequireAssertionFacade;
+    readonly array: (actual: unknown, options?: AssertionOptions) => asserts actual is readonly unknown[];
+    readonly boolean: (actual: unknown, options?: AssertionOptions) => asserts actual is boolean;
+    readonly defined: <Value>(actual: Value, options?: AssertionOptions) => asserts actual is NonNullable<Value>;
+    readonly function: (actual: unknown, options?: AssertionOptions) => asserts actual is (...parameters: readonly unknown[]) => unknown;
+    readonly hasProperty: <Key extends PropertyKey>(actual: unknown, key: Key, options?: AssertionOptions) => asserts actual is Readonly<Record<Key, unknown>>;
+    readonly instanceOf: <Constructor extends InstanceConstructor>(actual: unknown, expected: Constructor, options?: AssertionOptions) => asserts actual is InstanceType<Constructor>;
+    readonly notNull: <Value>(actual: Value, options?: AssertionOptions) => asserts actual is Exclude<Value, null>;
+    readonly null: (actual: unknown, options?: AssertionOptions) => asserts actual is null;
+    readonly number: (actual: unknown, options?: AssertionOptions) => asserts actual is number;
+    readonly object: (actual: unknown, options?: AssertionOptions) => asserts actual is Readonly<Record<PropertyKey, unknown>>;
+    readonly string: (actual: unknown, options?: AssertionOptions) => asserts actual is string;
+};
+export declare function createRecordingRequireFacadeWithLocation(sink: RequireAssertionSink, annotation: string | null, captureLocation: () => ResolvableSourceLocation): RequireAssertionFacade;
+export declare function createRecordingRequireFacade(sink: RequireAssertionSink, annotation: string | null): RequireAssertionFacade;
+//# sourceMappingURL=require-assertion-facade.d.ts.map

package/engine/require-assertion-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-assertion-facade.d.ts","sourceRoot":"","sources":["../../../../source/engine/require-assertion-facade.ts"],"names":[],"mappings":"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"}

package/engine/run-result.d.ts

@@ -0,0 +1,110 @@
+import type { InvalidDeepAssertionOperand } from '../assertion-protocol/evaluation.ts';
+import type { FailedCheck, NonEmptyReadonlyArray } from '../assertion-protocol/assertion-node-shape.ts';
+import type { CaseId } from './identity.ts';
+type RunnerErrorSubtypeByName = {
+    readonly attributionDrift: 'attribution-drift';
+    readonly crash: 'crash';
+    readonly fixture: 'fixture';
+    readonly loader: 'loader';
+    readonly permission: 'permission';
+    readonly reporter: 'reporter';
+    readonly unhandledRejection: 'unhandled-rejection';
+};
+type RunnerErrorSubtype = RunnerErrorSubtypeByName[keyof RunnerErrorSubtypeByName];
+export type PassOutcome = {
+    readonly checks?: never;
+    readonly kind: 'pass';
+    readonly reason?: never;
+};
+export type AssertionTestFailure = {
+    readonly checks: NonEmptyReadonlyArray<FailedCheck>;
+    readonly kind: 'assertion';
+};
+export type BodyErrorTestFailure = {
+    readonly error: {
+        readonly message: string;
+        readonly name: string;
+        readonly stack: string | null;
+        readonly thrown: unknown;
+    };
+    readonly kind: 'body-error';
+};
+type TestContractFailureCodeByName = {
+    readonly deadBuilderAssertion: 'dead-builder-assertion';
+    readonly invalidAssertionReference: 'invalid-assertion-reference';
+    readonly invalidCompositeResult: 'invalid-composite-result';
+    readonly invalidDeepAssertionOperand: 'invalid-deep-assertion-operand';
+    readonly invalidPlan: 'invalid-plan';
+    readonly invalidRequireReference: 'invalid-require-reference';
+    readonly noAssertions: 'no-assertions';
+    readonly pendingAsyncAssertion: 'pending-async-assertion';
+    readonly planMismatch: 'plan-mismatch';
+};
+export type TestContractFailureCode = TestContractFailureCodeByName[keyof TestContractFailureCodeByName];
+export type TestContractFailure = {
+    readonly actual: unknown;
+    readonly code: TestContractFailureCode;
+    readonly expected: string;
+    readonly kind: 'test-contract';
+    readonly summary: string;
+};
+export type TestFailure = AssertionTestFailure | BodyErrorTestFailure | TestContractFailure;
+export declare function invalidDeepAssertionOperandFailure(actual: InvalidDeepAssertionOperand): TestContractFailure;
+export type FailOutcome = {
+    readonly failures: NonEmptyReadonlyArray<TestFailure>;
+    readonly kind: 'fail';
+    readonly reason?: never;
+};
+export type SkipOutcome = {
+    readonly checks?: never;
+    readonly kind: 'skip';
+    readonly reason: string;
+};
+export type InconclusiveOutcome = {
+    readonly checks?: never;
+    readonly kind: 'inconclusive';
+    readonly reason: string;
+};
+export type TestOutcome = FailOutcome | InconclusiveOutcome | PassOutcome | SkipOutcome;
+export type RunnerError = {
+    readonly attributedTo: CaseId | null;
+    readonly cause: unknown;
+    readonly message: string;
+    readonly subtype: RunnerErrorSubtype;
+};
+export type RunSummary = {
+    readonly defined: number;
+    readonly discovered: number;
+    readonly failed: number;
+    readonly inconclusive: number;
+    readonly passed: number;
+    readonly planned: number;
+    readonly skipped: number;
+};
+export type PerTestResult = {
+    readonly id: CaseId;
+    readonly outcome: TestOutcome;
+    readonly verdict: TestOutcome['kind'];
+};
+export type SuiteRunCounts = {
+    readonly discovered: number;
+    readonly executed: number;
+    readonly planned: number;
+};
+export type OrphanedNode = {
+    readonly file: string | null;
+    readonly kind: 'suite' | 'table' | 'test';
+    readonly name: string;
+};
+export type RunResult = {
+    readonly artifacts: readonly string[];
+    readonly bySuite: Readonly<Record<string, SuiteRunCounts>>;
+    readonly orphans: readonly OrphanedNode[];
+    readonly perTest: readonly PerTestResult[];
+    readonly runnerErrors: readonly RunnerError[];
+    readonly summary: RunSummary;
+    readonly wallTimeMs: number;
+};
+export declare function verdictFromOutcome(outcome: TestOutcome): PerTestResult['verdict'];
+export {};
+//# sourceMappingURL=run-result.d.ts.map

package/engine/run-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result.d.ts","sourceRoot":"","sources":["../../../../source/engine/run-result.ts"],"names":[],"mappings":"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"}

package/engine/test-node.d.ts

@@ -0,0 +1,88 @@
+import type { AssertAssertionNode, AssertionResult } from '../assertion-protocol/assertion-node.ts';
+import type { NonEmptyReadonlyArray } from '../assertion-protocol/assertion-node-shape.ts';
+import type { AssertAssertionFacade } from './assertion-facade.ts';
+import type { RequireAssertionFacade } from './require-assertion-facade.ts';
+declare const testNodeBrand: unique symbol;
+declare const testNodeOwnerBrand: unique symbol;
+declare const testNodeOwnerIdentity: unique symbol;
+export type Metadata = Readonly<Record<string, unknown>>;
+export type TestScopeAssertContext = AssertAssertionFacade & {
+    readonly collect: () => NonEmptyReadonlyArray<AssertAssertionNode>;
+};
+export type TestScope = {
+    readonly assert: TestScopeAssertContext;
+    readonly plan: (count: number) => void;
+    readonly require: RequireAssertionFacade;
+};
+export type TestBody = (scope: TestScope) => AssertionResult | Promise<AssertionResult>;
+export type TestCase = {
+    readonly [testNodeBrand]: true;
+    readonly [testNodeOwnerBrand]: TestNodeOwner;
+    readonly body: TestBody;
+    readonly kind: 'test';
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export type Suite = {
+    readonly [testNodeBrand]: true;
+    readonly [testNodeOwnerBrand]: TestNodeOwner;
+    readonly children: readonly TestNode[];
+    readonly kind: 'suite';
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export type TableCase = {
+    readonly body: TestBody;
+    readonly metadata: Metadata;
+    readonly name: string;
+    readonly parameters: Readonly<Record<string, unknown>>;
+};
+export type Table = {
+    readonly [testNodeBrand]: true;
+    readonly [testNodeOwnerBrand]: TestNodeOwner;
+    readonly cases: readonly TableCase[];
+    readonly kind: 'table';
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export type TestNode = Suite | Table | TestCase;
+export type TestNodeOwner = {
+    readonly [testNodeOwnerIdentity]: true;
+};
+export type TestNodeFactory = {
+    readonly createSuite: (options: SuiteOptions) => Suite;
+    readonly createTable: (options: TableOptions) => Table;
+    readonly createTestCase: (options: TestCaseOptions) => TestCase;
+};
+export type TestNodeFactoryOptions = {
+    readonly owner: TestNodeOwner;
+    readonly recordConstructedNode: (node: TestNode) => void;
+};
+export type TestCaseOptions = {
+    readonly body: TestBody;
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export type SuiteOptions = {
+    readonly children: readonly unknown[];
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export type TableCaseOptions = {
+    readonly body: TestBody;
+    readonly metadata: Metadata;
+    readonly name: string;
+    readonly parameters: Readonly<Record<string, unknown>>;
+};
+export type TableOptions = {
+    readonly cases: readonly TableCaseOptions[];
+    readonly metadata: Metadata;
+    readonly name: string;
+};
+export declare function createTestNodeOwner(): TestNodeOwner;
+export declare function isTestNode(value: unknown): value is TestNode;
+export declare function ensureOwnedTestNode(value: unknown, owner: TestNodeOwner, plainObjectMessage: string, foreignNodeMessage: string): asserts value is TestNode;
+export declare function createTestNodeFactory(factoryOptions: TestNodeFactoryOptions): TestNodeFactory;
+export declare function mergeMetadata(parent: Metadata, child: Metadata): Metadata;
+export {};
+//# sourceMappingURL=test-node.d.ts.map

package/engine/test-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-node.d.ts","sourceRoot":"","sources":["../../../../source/engine/test-node.ts"],"names":[],"mappings":"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"}

package/engine/test-plan.d.ts

@@ -0,0 +1,20 @@
+import type { NonEmptyReadonlyArray } from '../assertion-protocol/assertion-node-shape.ts';
+import { type CaseId } from './identity.ts';
+import type { OrphanedNode } from './run-result.ts';
+import { type Metadata, type TestBody, type TestNode, type TestNodeOwner } from './test-node.ts';
+export type TestPlanCaseBody = TestBody;
+export type TestPlanCase = {
+    readonly id: CaseId;
+    readonly suitePath: readonly string[];
+    readonly metadata: Metadata;
+    readonly body: TestPlanCaseBody;
+};
+export type TestPlan = {
+    readonly defined: number;
+    readonly cases: NonEmptyReadonlyArray<TestPlanCase>;
+    readonly discoveredCases: NonEmptyReadonlyArray<TestPlanCase>;
+    readonly orphans: readonly OrphanedNode[];
+};
+export type TestPlanFactory = (root: TestNode) => TestPlan;
+export declare function createTestPlanFactory(owner: TestNodeOwner, constructedNodes: ReadonlySet<TestNode>): TestPlanFactory;
+//# sourceMappingURL=test-plan.d.ts.map

package/engine/test-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-plan.d.ts","sourceRoot":"","sources":["../../../../source/engine/test-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAGH,KAAK,QAAQ,EAEb,KAAK,QAAQ,EAEb,KAAK,QAAQ,EACb,KAAK,aAAa,EACrB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC;AA4I3D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,eAAe,CAqBpH"}

package/package.json

@@ -1,7 +1,34 @@
 {
-  "name": "@overkill-dev/run",
-  "version": "0.0.1",
-  "description": "Placeholder claiming the npm package name \"@overkill-dev/run\" so a trusted publisher can be configured. See https://github.com/npm/cli/issues/8544.",
-  "license": "MIT",
-  "deprecated": "Placeholder published as a workaround so a Trusted Publisher could be configured. See https://github.com/npm/cli/issues/8544."
-}
+    "author": "Christian Rackerseder <git@echooff.de>",
+    "bugs": {
+        "url": "https://github.com/enormora/overkill/issues"
+    },
+    "dependencies": {
+        "@enormora/wall-clock": "0.0.3"
+    },
+    "description": "Overkill run resolution and orchestration.",
+    "engines": {
+        "node": "^26"
+    },
+    "exports": {
+        ".": {
+            "import": "./packages/run/run.entry-point.js",
+            "types": "./packages/run/run.entry-point.d.ts"
+        }
+    },
+    "homepage": "https://github.com/enormora/overkill#readme",
+    "keywords": [
+        "tdd",
+        "test",
+        "tests"
+    ],
+    "license": "MIT",
+    "name": "@overkill-dev/run",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": false,
+    "type": "module",
+    "version": "0.0.2"
+}

package/packages/engine/assertion-protocol.entry-point.d.ts

@@ -0,0 +1,9 @@
+export type { AssertCompositeAssertionReturn, AssertionReference, AssertionReferenceRecord, AssertReferenceArguments, AssertReferenceReturn, CompositeAssertionGroup, CompositeAssertionReference, CompositeAssertionReferenceRecord, CompositeAssertionReturn, CompositeAssertionRunnerInput, CompositeAssertionSummaryContext, CompositeAssertionSummaryFormatter, NarrowingCompositeAssertionReference, NarrowingCompositeAssertionReferenceRecord, NarrowingCompositeAssertionSummaryFormatter } from '../../assertion-protocol/assertion-reference.ts';
+export { createCompositeAssertionGroup, createCompositeAssertionReferenceRecord, createNarrowingCompositeAssertionReferenceRecord, getAssertionReferenceRecord, getCompositeAssertionReferenceRecord, getNarrowingAssertionReferenceRecord, isAssertionReference, isCompositeAssertionGroup, isNarrowingAssertionReference } from '../../assertion-protocol/assertion-reference.ts';
+export type { AssertAssertionNode, BuiltInAssertAssertionNode, CompositeAssertionChildNode, CompositeAssertionNode, ForeignAssertionNode, ForeignAssertionResult, RequireAssertionNode } from '../../assertion-protocol/assertion-node.ts';
+export type { AssertionOptions, AssertionSource, DeepComparable, FailedCheck, FailedCompositeCheck, FailedForeignCheck, FailedLeafCheck, InstanceConstructor, NonEmptyReadonlyArray, ResolvableSourceLocation, SourceLocation, SourceLocationProvider } from '../../assertion-protocol/assertion-node-shape.ts';
+export type { ErrorMatcher, ExactThrownMatcher, SynchronousCallback, ThrownAssertionObservation, ThrownMatcher } from '../../assertion-protocol/thrown-matcher.ts';
+export { thrownMatcherChildren } from '../../assertion-protocol/thrown-matcher.ts';
+export type { ThrownErrorRecord } from '../../assertion-protocol/thrown-error-record.ts';
+export { createThrownErrorRecord } from '../../assertion-protocol/thrown-error-record.ts';
+//# sourceMappingURL=assertion-protocol.entry-point.d.ts.map

package/packages/engine/assertion-protocol.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-protocol.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/engine/assertion-protocol.entry-point.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,8BAA8B,EAC9B,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,EACjC,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,EAChC,kCAAkC,EAClC,oCAAoC,EACpC,0CAA0C,EAC1C,2CAA2C,EAC9C,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACH,6BAA6B,EAC7B,uCAAuC,EACvC,gDAAgD,EAChD,2BAA2B,EAC3B,oCAAoC,EACpC,oCAAoC,EACpC,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAChC,MAAM,iDAAiD,CAAC;AACzD,YAAY,EACR,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACzB,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACR,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,EAChB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC"}

package/packages/run/run.entry-point.d.ts

@@ -0,0 +1,3 @@
+export { resolveRun, run } from '../../run/run.ts';
+export type { ResolvedRun, RunDebugRequest, RunExecutionRequest, RunFacts, RunFactsDebug, RunRequest, RunSeed, RunSelection, RunShard } from '../../run/run.ts';
+//# sourceMappingURL=run.entry-point.d.ts.map

package/packages/run/run.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/run/run.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EACR,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,OAAO,EACP,YAAY,EACZ,QAAQ,EACX,MAAM,kBAAkB,CAAC"}

package/packages/run/run.entry-point.js

@@ -0,0 +1,2 @@
+export { resolveRun, run } from "../../run/run.js";
+//# sourceMappingURL=run.entry-point.js.map

package/packages/run/run.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/run/run.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/readme.md

@@ -1,7 +1,11 @@
-# @overkill-dev/run
+# `@overkill-dev/run`
 
-This version is a placeholder published only to claim the npm name `@overkill-dev/run` so a Trusted Publisher
-can subsequently be configured for it. It contains no real package content and is published already
-deprecated.
+Run orchestration package for turning caller intent into resolved Overkill runs.
 
-Workaround context: https://github.com/npm/cli/issues/8544
+Top-level API:
+
+- `RunRequest`
+- `RunFacts`
+- `ResolvedRun`
+- `resolveRun(request)`
+- `run(request)`

package/run/run.d.ts

@@ -0,0 +1,65 @@
+import type { CaseId } from '../engine/identity.ts';
+import type { Reporter } from '../engine/reporter.ts';
+import type { TestPlan } from '../engine/test-plan.ts';
+export type RunSelection = {
+    readonly kind: 'all' | 'case-id' | 'file' | 'filter' | 'last-failed' | 'name';
+    readonly value: string | null;
+};
+export type RunShard = {
+    readonly index: number;
+    readonly total: number;
+};
+export type RunExecutionRequest = {
+    readonly mode: string;
+    readonly workers: number;
+};
+export type RunSeed = {
+    readonly value: bigint | null;
+};
+export type RunDebugRequest = {
+    readonly mode: 'all' | 'off' | 'selected';
+    readonly selectors: readonly string[];
+};
+export type RunRequest = {
+    readonly paths: readonly string[];
+    readonly selection: RunSelection;
+    readonly shard: RunShard;
+    readonly profile: string;
+    readonly execution: RunExecutionRequest;
+    readonly coverage: boolean;
+    readonly capture: 'buffered' | 'live';
+    readonly seed: RunSeed;
+    readonly order: 'lexical' | 'seeded';
+    readonly debug: RunDebugRequest;
+    readonly configPath: string | null;
+};
+export type RunFacts = {
+    readonly seed: bigint;
+    readonly identities: readonly CaseId[];
+    readonly executionStrategy: string;
+    readonly capabilityProfile: string;
+    readonly baselineUpdateMode: 'apply' | 'bootstrap' | 'diff' | 'none' | 'update';
+    readonly loaderConfig: {
+        readonly stripMode: 'strip-only' | 'transform';
+        readonly sourceMaps: boolean;
+    };
+    readonly versions: {
+        readonly engine: string;
+        readonly node: string;
+        readonly packages: Readonly<Record<string, string>>;
+    };
+    readonly debug: RunFactsDebug;
+};
+export type RunFactsDebug = {
+    readonly mode: 'all' | 'off' | 'selected';
+    readonly caseIds: readonly CaseId[];
+};
+export type ResolvedRun = {
+    readonly request: RunRequest;
+    readonly facts: RunFacts;
+    readonly testPlan: TestPlan;
+    readonly reporters: readonly Reporter[];
+};
+export declare function resolveRun(request: RunRequest): Promise<ResolvedRun>;
+export declare function run(request: RunRequest): Promise<never>;
+//# sourceMappingURL=run.d.ts.map

package/run/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../source/run/run.ts"],"names":[],"mappings":"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"}

package/run/run.js

@@ -0,0 +1,12 @@
+function acceptRunRequestForFutureResolution(request) {
+    return request;
+}
+export async function resolveRun(request) {
+    acceptRunRequestForFutureResolution(request);
+    throw new Error('resolveRun() is not implemented yet.');
+}
+export async function run(request) {
+    acceptRunRequestForFutureResolution(request);
+    throw new Error('run() is not implemented yet.');
+}
+//# sourceMappingURL=run.js.map

package/run/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../source/run/run.ts"],"names":[],"mappings":"AAwEA,SAAS,mCAAmC,CAAC,OAAmB;IAC5D,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAmB;IAChD,mCAAmC,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAmB;IACzC,mCAAmC,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACrD,CAAC"}

package/sbom.cdx.json

@@ -0,0 +1,50 @@
+{
+    "$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
+    "bomFormat": "CycloneDX",
+    "specVersion": "1.6",
+    "version": 1,
+    "metadata": {
+        "tools": {
+            "components": [
+                {
+                    "type": "application",
+                    "name": "packtory",
+                    "version": "0.0.78"
+                }
+            ]
+        },
+        "component": {
+            "type": "library",
+            "name": "@overkill-dev/run",
+            "version": "0.0.2",
+            "bom-ref": "pkg:npm/@overkill-dev/run@0.0.2",
+            "purl": "pkg:npm/@overkill-dev/run@0.0.2"
+        }
+    },
+    "components": [
+        {
+            "type": "library",
+            "name": "@enormora/wall-clock",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@enormora/wall-clock@0.0.3",
+            "scope": "required",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@enormora/wall-clock@0.0.3"
+        }
+    ],
+    "dependencies": [
+        {
+            "ref": "pkg:npm/@enormora/wall-clock@0.0.3"
+        },
+        {
+            "ref": "pkg:npm/@overkill-dev/run@0.0.2",
+            "dependsOn": [
+                "pkg:npm/@enormora/wall-clock@0.0.3"
+            ]
+        }
+    ]
+}